协议与平台适配

REST 调用边界

REST 适配器提供与 HTTP 框架无关的执行投影：

POST /v0alpha1/capabilities/{capability}/execute

{
  "input": {},
  "preconditions": {}
}

协议元数据通过 X-Brivya-Capability-Version、X-Request-Id、X-Correlation-Id、X-Causation-Id 与 Idempotency-Key 等头传递。请求体不能声明可信身份或审批状态。

宿主 HTTP 层验证会话或认证信息，并传入可信 RestSecurityContext；适配器构造 ActionRequest 后调用 BusinessRuntime。

MCP 工具投影

能力 order.create@0.1.0 投影为工具 brivya.order.create.v0.1.0，能力输入输出 JSON Schema 被传递给 MCP SDK。

宿主 transport/auth 层提供可信 McpContextResolver，映射已验证的会话身份、委托、审批与关联信息。工具参数仅为业务输入；MCP annotations 只是提示，不是授权。

WorkBuddy 与 WeChat AI

这些是参考打包与一致性基线。生产发布仍需重新核对平台官方要求、资格与审核流程；不保证第三方字段和接口永远稳定。

适配前检查

• 投影保留输入输出 Schema、风险与权限要求。
• 高风险动作保留 canonical 审批语义。
• 幂等与审计不会被协议分支削弱。
• 客户端身份与 UI 确认不被提升为可信授权证据。

统一交互语义由 SemanticExperience 描述，再交给平台 renderer 呈现；业务动作仍绑定 canonical Capability ID。