让 Session、Thread、Run 与事件各守其位

当应用需要跨多轮输入、网络重连或进程重启继续同一段 Agent 对话时，应使用 Session。 应用保留 Session id，并把后续输入继续发送到该 Session。不要用浏览器状态或未接收完整的 stream 重建持久历史。

先选择持久身份

Session status 可以概括应用看到的状态。执行是否真正结束、是否仍在等待输入，则由 已提交的 Thread facts 中的 Run state 决定。

静态结构

flowchart TB
    App["Application<br/>保留 Session id"] --> Edge["Protocol adapter<br/>auth · idempotency · projection"]

    subgraph SessionAggregate["Session aggregate"]
      Binding["Agent · Environment · metadata"]
      Resources["ResolvedSessionResources"]
      Lifecycle["Session lifecycle"]
    end

    subgraph RuntimeTruth["Runtime truth"]
      Thread["Thread"] --> Run["Run"] --> Facts[(已提交 facts)]
    end

    Edge --> SessionAggregate
    Edge --> Thread
    SessionAggregate -. "已冻结输入" .-> Run
    Facts --> Edge
    Edge --> Stream["event stream / replay"]

Session repository 保存不属于 transcript 的应用事实。Thread 保存 replay 与恢复需要的 执行事实。两边不会复制彼此的状态。

资源在 Session 运行前解析

Agent 默认输入与显式 Session attachment 使用同一套 input-binding contract。创建 Session 时，系统先把它们解析为一份不含 secret 的 ResolvedSessionResources， 然后才会打开执行环境。

flowchart LR
    Defaults["Agent input defaults"] --> Resolver["SessionInputResolver"]
    Attachments["显式 Session attachments"] --> Resolver
    Skills["已选择 Skill versions"] --> Resolver
    Resolver --> Manifest["已解析、不含 secret 的 manifest"]
    Manifest --> Session["Session aggregate"]
    Session --> Worker["由 Worker 精确实现"]

Manifest 只固定各类资源能够如实固定的配置。File 使用不可变 File identity；Repository 与 Memory 保留已选择的配置版本，但不会把可变内容假装成 Git commit 或 byte snapshot； Skill 保留精确 version 与 bundle hash。

当前所有权、授权、credential 有效性与 lifecycle 仍可能拒绝使用。冻结 identity 是为了 让输入选择可重现，不代表永久授权。

动态行为

sequenceDiagram
    participant A as Application
    participant S as Session service
    participant R as Runtime / Worker
    participant F as Commit authority

    A->>S: 用 Agent 与 attachments 创建 Session
    S->>S: 解析并持久化有效输入
    A->>S: 带 idempotency identity 发送用户输入
    S->>R: 在 Session Thread 上激活一个 Run
    R->>F: 提交消息、状态、工具结果、await 或终态结果
    F-->>S: 已提交的 Thread facts
    S-->>A: 投影 events
    alt 需要精确的外部输入
      R->>F: 提交 Awaiting 与 ResumeTicket
      A->>S: 提交 confirmation 或 tool result
      S->>R: 恢复同一个 Run
    end
    R->>F: 提交 Run 终态
    F-->>A: 投影 Session 终态

Live stream 用于显示进度。Replay、重连以及必须跨重启生效的决定，都读取已提交的 Thread facts。Stream 断开后，应用使用同一个 Session identity 重连，系统会重新投影 已提交历史。这种正常重连不需要修复。

如果 Session aggregate 已经持久化，而 dispatch projection 暂时不可用，lifecycle reconciler 会重试这份 projection，不会要求客户端创建第二个 Session。

把相邻规则留给各自的权威页

本页只负责 Session、Thread、Run 与 event 的心智模型。精确 event DTO、batch 限制与 Managed Agents 差异由兼容矩阵维护；MCP attachment 的精确状态与 transport 行为由 MCP protocol维护； claim takeover、commit ambiguity 与 indeterminate effect 由 生产可靠性维护。

接入应用时，继续阅读 把一个已发布 Agent 接入应用。