# Runtime 固定源码阅读索引

阅读日期：2026-09-14。公开仓库下载固定提交后仅静态阅读，没有安装或执行源码。内部函数用于解释实现，不建议应用依赖其私有 API。

| 项目 | 固定提交 | 阅读入口与问题 |
| --- | --- | --- |
| LangGraph | e539ac122f4126f6dd850581c1494948cf620e31 | StateGraph 编译、Pregel Loop/Runner、Checkpoint 与 pending writes |
| Temporal Python SDK | ab25ed693f7ec77589346e66c98db299a8c9c9fe | Workflow 激活、Activity 结果、消息分派与重放标志 |
| AgentScope Java | 7d321e2ba93f41a655650e75823e2581fb54141b | RuntimeContext、调用槽位、AgentStateStore 与版本能力 |
| DBOS Python | 83805fd84494c85ea09105443884a2786152d921 | Workflow/Step 包装、操作结果、消息等待、恢复入队 |
| A2A | 6d6640c29b102f7a8d23784901351b5d2454fe71 | 协议数据类型；正文使用稳定 1.0.0 规范 |

## LangGraph

- [StateGraph](https://github.com/langchain-ai/langgraph/blob/e539ac122f4126f6dd850581c1494948cf620e31/libs/langgraph/langgraph/graph/state.py)：状态通道与编译。
- [Pregel Loop](https://github.com/langchain-ai/langgraph/blob/e539ac122f4126f6dd850581c1494948cf620e31/libs/langgraph/langgraph/pregel/_loop.py)：阶段推进和写入。
- [Runner](https://github.com/langchain-ai/langgraph/blob/e539ac122f4126f6dd850581c1494948cf620e31/libs/langgraph/langgraph/pregel/_runner.py)：任务执行。
- [SqliteSaver](https://github.com/langchain-ai/langgraph/blob/e539ac122f4126f6dd850581c1494948cf620e31/libs/checkpoint-sqlite/langgraph/checkpoint/sqlite/__init__.py)：get_tuple、put、put_writes。
- [公开持久化文档](https://docs.langchain.com/oss/python/langgraph/persistence)。仓库读取版本：langgraph 1.2.11、SQLite saver 3.1.1。

## Temporal

- [Workflow instance](https://github.com/temporalio/sdk-python/blob/ab25ed693f7ec77589346e66c98db299a8c9c9fe/temporalio/worker/_workflow_instance.py)：activate 与 _apply。
- [Activity Worker](https://github.com/temporalio/sdk-python/blob/ab25ed693f7ec77589346e66c98db299a8c9c9fe/temporalio/worker/_activity.py)：Activity 执行生命周期。
- [Workflow 文档](https://docs.temporal.io/workflows)、[Python 消息](https://docs.temporal.io/develop/python/workflows/message-passing)。SDK 快照版本 1.32.0，不等于 Server 版本。

## AgentScope Java

- [ReActAgent](https://github.com/agentscope-ai/agentscope-java/blob/7d321e2ba93f41a655650e75823e2581fb54141b/agentscope-core/src/main/java/io/agentscope/core/ReActAgent.java)：activateSlotForContext、CallExecution。
- [AgentBase](https://github.com/agentscope-ai/agentscope-java/blob/7d321e2ba93f41a655650e75823e2581fb54141b/agentscope-core/src/main/java/io/agentscope/core/agent/AgentBase.java)：调用进入与释放。当前 acquireExecution 不执行互斥加锁，不根据旧注释推断锁保证。
- [AgentStateStore](https://github.com/agentscope-ai/agentscope-java/blob/7d321e2ba93f41a655650e75823e2581fb54141b/agentscope-core/src/main/java/io/agentscope/core/state/AgentStateStore.java)：默认无版本能力，saveIfVersion 可退化为普通保存。
- [JSON 文件后端](https://github.com/agentscope-ai/agentscope-java/blob/7d321e2ba93f41a655650e75823e2581fb54141b/agentscope-core/src/main/java/io/agentscope/core/state/JsonFileAgentStateStore.java)。配套 Java 工程仍保留原 Maven 2.0.1，不宣称快照 API 全部存在于该发布版。

## DBOS

- [公开入口](https://github.com/dbos-inc/dbos-transact-py/blob/83805fd84494c85ea09105443884a2786152d921/dbos/_dbos.py)：workflow、step、send、recv。
- [执行核心](https://github.com/dbos-inc/dbos-transact-py/blob/83805fd84494c85ea09105443884a2786152d921/dbos/_core.py)：invoke_step、check_existing_result、record_step_result。
- [恢复](https://github.com/dbos-inc/dbos-transact-py/blob/83805fd84494c85ea09105443884a2786152d921/dbos/_recovery.py)：按执行器/版本寻找待恢复任务，重新入队。
- [队列](https://github.com/dbos-inc/dbos-transact-py/blob/83805fd84494c85ea09105443884a2786152d921/dbos/_queue.py)、[系统数据库接口](https://github.com/dbos-inc/dbos-transact-py/blob/83805fd84494c85ea09105443884a2786152d921/dbos/_sys_db.py)。
- [官方教程](https://docs.dbos.dev/python/tutorials/workflow-tutorial)。示例固定 Git 提交，未声称发布版本。

## A2A

- [1.0.0 稳定规范](https://a2a-protocol.org/v1.0.0/specification/)：正文请求使用 HTTP+JSON 绑定，不混用 JSON-RPC。
- [Proto 快照](https://github.com/a2aproject/A2A/blob/6d6640c29b102f7a8d23784901351b5d2454fe71/specification/a2a.proto)：辅助查看类型。main 快照不冒充 1.0.0 发布标签。

文档网页可能后续更新；固定提交用于复核本文实现描述。所有源码结论均限所列快照，不保证跨版本一致。
