Terminology

• Organization
  • 租户边界；资源与 run 的归属单位。
• Agent
  • 稳定产品身份对象，包含 card、默认发布入口和治理元数据。
• Agent Revision
  • Agent 的不可变可执行修订版，包含执行画像、run policy、协议能力和 secret refs。
• Tool
  • 稳定工具身份对象。
• Tool Revision
  • Tool 的不可变执行契约，包含 schema、执行模式、运行画像和鉴权策略。
• MCP Server
  • 稳定的 MCP server 身份对象，可被 Agent 引用，也可作为托管 MCP session 的直接运行目标。
• MCP Server Revision
  • MCP Server 的不可变托管契约，包含 MCP capability profile、私有 tool catalog、运行画像和鉴权策略。
• Callable Grant
  • 跨组织 callable 共享与授权对象，声明哪个消费方组织可以调用哪个提供方发布入口，以及能看到哪些运行事实。
• Release Channel
  • 把稳定资源身份解析到具体 revision 的发布入口。
• Protocol Binding
  • 把某个 revision 暴露到实际 northbound endpoint、transport 和安全方案的绑定对象。
• Run
  • 一次任务执行实例；由一个资源目标与一份输入触发。
• Attempt
  • run 的一次具体执行尝试；重试会产生新 attempt。
• Run Link
  • run 之间的有类型谱系边，用于表达 delegation、handoff、follow-up、tool subrun 和 mcp session。
• Interaction Request
  • 统一的人机交互阻塞对象，用于审批、补充输入、鉴权、选择和确认。
• Thread
  • 对话或事件展示维度；同一 run 内可能只有一个主 thread，也可能包含子 thread。
• Context
  • 跨 run 的业务上下文标识。
• Runtime
  • 在 provider 环境中运行的执行代理，负责接收输入、发送输出和管理本地工具。
• Provider
  • 提供实际执行环境的后端，例如 local、sandbox、faas、worker。
• RunSpace
  • provider 侧实际承载执行的运行空间资源对象，例如 workspace、实例、隔离槽位或调用空间。
• Session
  • 平台管理的执行租约对象；绑定一个 RunSpace，表达占用、保活、续期和释放事实。
• Runtime Connection
  • runtime 与平台之间的瞬时或可重连连接上下文；绑定到某个 Session，承载 attach、heartbeat、recover、KV、config、secret 和输出桥接。v1 将其视为公开可查询资源。
• Runtime SDK
  • runtime 使用的标准逻辑 API 集合，分为 Core SDK 与 Platform SDK。
• Core SDK
  • 面向平台中立能力的 SDK 能力面，可由平台包通过 polyfill 补齐实现。
• Core Polyfill
  • 通过 register(...) 或 use(...) 装配到 Core SDK 的 polyfill 实现，用于补齐稳定的 core 逻辑契约。
• Platform SDK
  • 绑定具体运行环境的专属 SDK 能力面，例如文件系统、workspace、terminal、browser。
• Input Event
  • 平台发给 runtime 的消息、通知或取消事件。
• Output Event
  • runtime 发给平台的文本、reasoning、tool call、artifact、状态等事件。
• Event Log
  • append-only 的运行事实存储。
• Projection
  • 从事件流构建读模型的过程。
• Protocol Profile
  • revision 面向某个外部协议暴露的声明式能力面，包含能力集和展示投影。
• Protocol Adapter
  • 将 A2A、ACP、AG-UI、MCP 等外部协议请求映射到 canonical AaaS 资源与事件的边界层。
• Trace
  • 一次 runtime 内部执行链路的追踪根对象，由多个 span 组成。
• Span
  • trace 中的单个工作单元，拥有开始/结束时间、状态、父子关系和资源指标。
• Agent Tracer
  • runtime 内部的追踪控制器，负责创建 span、维护上下文、采集指标并导出 span 记录。
• Propagation Carrier
  • traceparent、tracestate、baggage 等用于跨进程传播 trace context 的载体。
• Baggage
  • 附着在 trace context 上的键值上下文，用于跨边界携带受治理的小型属性。
• Span Event
  • 归属于某个 span 的细粒度结构化事件，例如 LLM 输入输出详情。
• GenAI Operation Details
  • 面向 LLM / agent 调用的输入消息、输出消息、tool context、usage 和 provider 参数详情。
• Trace Export
  • span 结束后导出的结构化遥测记录。
• Message Record
  • 面向查询与 UI 的稳定消息视图。
• Artifact
  • run 产出物；可由输出事件增量构建。
• Checkpoint
  • 可恢复的文件系统或逻辑状态快照。
• Cursor
  • 流式消费位置标识；最常见为 (runId, sequence)。
• Idempotency Key
  • 写命令去重键。
• Trace Context
  • 当前执行上下文中的 traceId 与 spanId，用于日志相关性和父子 span 继承。
  • 在跨边界场景中还包括 traceparent、tracestate 与 baggage 等 carrier 视图。