GoodVision TypeScript SDK

按快速开始从 npm 安装 SDK 后，以同一操作 ID 调用：

import { GoodVisionClient, discoverOperations } from "@goodvision/sdk";
import { readFile } from "node:fs/promises";

const operations = discoverOperations("user context");
const client = new GoodVisionClient({
  apiBase: process.env.GOODVISION_API_BASE!,
  getToken: async () => (await readFile(process.env.GOODVISION_TOKEN_FILE!, "utf8")).trim(),
});
const result = await client.call("resolveCustomerUserContext", { body: {} });
console.log(result.data);

Token 文件由接入方按前述私有权限保管。discoverOperations 只搜索本地生成目录；类型、参数、响应、Scope 来自 Owner，实际授权由 API 执行。事件接收可使用 consumeEvents：持久且幂等完成回调后才 ACK，回调失败不 ACK。

全局能力发现

import { capabilityOverview, discoverOperations } from "@goodvision/sdk";
const overview = capabilityOverview();
console.log(overview.products);
const operations = discoverOperations("user context");

capabilityOverview 从本地公开合同汇总产品版本、操作数量、身份、Scope 和双语文档入口，不判断目标可用性或当前授权。