Runtime Connection

状态

• disconnected
• connecting
• initialized
• recovering
• reconnect_requested
• closed

首次连接

1. runtime attach
2. 平台返回 Session 上下文、runtimeConnectionId，以及裁剪后的 SDK capability 集
3. 当前 attempt 冻结 attach 时协商得到的 sdkCapabilitySnapshot
4. runtime 进入 initialized
5. 主输入桥与输出桥建立

重连

1. 连接中断
2. runtime 重新 attach 或重建 transport
3. 重连时沿用当前 attempt 已冻结的 sdkCapabilitySnapshot
4. 重连 init 成功后进入 recovering
5. 调用 recover-connections
6. 成功则回到 initialized

规范要求

• reconnect MUST NOT 伪造新的 RUN_STARTED
• recover-connections MUST 只恢复连接与桥接，不得重放业务生命周期
• 旧连接的迟到完成 MUST 被忽略，不得破坏新 owner
• recover 失败 SHOULD 触发受控 forced reconnect，而不是直接向业务代码抛出生命周期错误
• attach 协商得到的 capability 集 MUST 进入 attempt 事实，以便审计、排障与恢复判断
• 同一 Session MAY 在一个 attempt 内先后绑定多个 RuntimeConnection；只有最新 owner MUST 被视为有效连接
• reconnect MUST NOT 在同一 attempt 内修改既有 sdkCapabilitySnapshot；如能力集已不兼容，平台 MUST 拒绝恢复并交由 orchestrator 创建新 attempt 或失败
• 读面 SHOULD 暴露 RuntimeConnection 资源查询，以支持按 run、attempt、session 和 id 复盘 owner 切换与 heartbeat 事实