AgentKit Studio
参考

运行时与实体契约

`agentkit.studio.runtime/v1` 的 3 种运行时、能力矩阵、实体标识与校验错误码。

契约版本

运行时契约只有一个版本常量:agentkit.studio.runtime/v1。它同时是 Agent 表单、可移植运行包与部署的准入校验依据。

常量值说明
STUDIO_RUNTIME_CONTRACT_VERSIONagentkit.studio.runtime/v1契约版本,同时是准入校验依据
STUDIO_RUNTIME_TYPESdsh-native · harness · codex公开可路由的运行时类型
STUDIO_CANONICAL_IDENTIFIERSagentId · revision · buildId · sessionId · runId跨实体唯一的标识字段名

公开运行时共 3 种:dsh-native、harness、codex。assertStudioRuntimeType() 只接受这些值,其余一律 RUNTIME_UNSUPPORTED。新增运行时只需改 src/runtime-contract.mjs:STUDIO_RUNTIME_TYPES,本页的计数与能力矩阵随之自动更新。见运行时。

能力矩阵

每种运行时声明自己的所有者、执行模型、事件与流式契约。矩阵之外的组合不受支持。

runtime.typeownerexecutioncontractcapabilitieseventOwnerstreamOwner
dsh-nativedshnativeagentkit.studio.runtime/v1session session-events stream cancel replay persistence build-bindingdsh-sessiondsh-agent/assistant-stream
harnessksadk-harnessnative-kernelagentkit.native-dsh-turn/v1native-run durable-receipts tool-approval cancel resume child-tasksnative-run-storenative-model-port
codexstudiocodex-app-serverstudio.codex.adapter/v1session stream cancel replay build-bindingstudio-codex-adaptercodex-turn/item

实体与标识

六个实体共享同一组标识字段名。任何一层缺失都视为身份不合法。

实体字段
Agentid→agentId · revision→revision
Revisionid→revision · parent→agentId
Buildid→buildId · agent→agentId · revision→revision
Sessionid→sessionId · build→buildId · agent→agentId · revision→revision
Runid→runId · session→sessionId · build→buildId · agent→agentId · revision→revision

校验错误

错误码触发条件源码
RUNTIME_UNSUPPORTEDruntime.type 不在公开或实验列表中src/runtime-contract.mjs:67
RUN_IDENTITY_INVALIDagentId / sessionId / runId / buildId 缺失,或 revision 不是正整数src/runtime-contract.mjs:74
RUN_IDENTITY_MISMATCH运行身份与绑定的路由不一致src/runtime-contract.mjs:88

studioRunIdentity() 会先补齐字段再校验,因此空白字符串与缺字段等价;revision 会被强制转成数字。

版本与兼容性

项值说明
契约版本agentkit.studio.runtime/v1与 Studio 版本同 PR 演进
公开运行时3 种dsh-native / harness / codex
标识字段5 个改名即破坏性变更

开发者入口

内容源码位置
运行时契约src/runtime-contract.mjs
会话事件词表src/host/dsh-session-contract.mjs
原生轮次契约packages/harness/src/native/dsh-turn-contract.ts

相关测试:

测试文件位置
runtime-contract.test.mjstests/runtime-contract.test.mjs
runtime-registry.test.mjstests/runtime-registry.test.mjs

本页导航