TypeScript SDK

安装

npm install @brivya/sdk@0.1.0-alpha.1

SDK 是 Core、Manifest、Policy 与 Runtime 的公开接口门面，不创建第二套授权或运行时真相。

解析和校验 Manifest

以下示例读取由 CLI init 生成的 Manifest，并运行同一 canonical 解析与校验逻辑：

import { readFileSync } from "node:fs";
import { loadBusinessAgentManifest } from "@brivya/sdk";

const source = readFileSync("business.agent.yaml", "utf8");
const agent = loadBusinessAgentManifest(source);
console.log(agent.metadata.id);

解析或校验失败时应处理错误，不要将无效 Manifest 继续用于业务执行。

运行时与类型

import {
  BusinessRuntime,
  CapabilityRegistry,
  runtime,
  type ActionRequest,
  type CapabilityContract,
  type Principal,
  type Delegation,
} from "@brivya/sdk";

BusinessRuntime 和 CapabilityRegistry 指向 canonical 实现。实际配置需要能力注册、Connector、授权上下文和相关运行时依赖；仅导入 SDK 不会创建可执行业务服务。

应用集成顺序

1. 定义能力输入、输出与业务安全要求。
2. 通过 CapabilityRegistry 注册能力契约。
3. 提供真实业务 Connector 与所需的策略、审批、幂等和审计实现。
4. 由可信服务端构造身份与委托上下文。
5. 使用 BusinessRuntime 执行，或通过 REST / MCP 适配器调用同一运行时。

参考 Restaurant 示例 学习注册能力和执行测试；参考 适配器指南 连接协议入口。