Skip to content

Runtime Connection

角色

RuntimeConnection 是 runtime 与平台之间的可重连连接资源,承载 attach、heartbeat、recover、KV、config、secret 和输出桥接。

v1 将其作为公开可查询资源,而不是仅存在于协议会话内部。

核心字段

  • runtimeConnectionId
  • orgId
  • runId
  • attemptId
  • sessionId
  • status
  • connectionEpoch
  • effectiveSdkCapabilities
  • openedAt
  • lastHeartbeatAt

规范要求

  • 同一 Session 在时间上 MAY 先后对应多个 RuntimeConnection
  • 同一 attempt 的最新 owner MUST 是唯一有效连接
  • reconnect MUST NOT 改写既有 sdkCapabilitySnapshot
  • 公开读面 SHOULD 允许按 run、attempt、session 和 id 查询连接事实

白皮书与规范内容以仓库真源为准。