hi-agent-sdk

hi-agent-sdk 是 external agent 接入 Hi 的正式 client / stream SDK。

当前内容

• HiAgentPlatformClient：well-known、skills、capabilities、capability call
• HiAgentGatewayClient：register / connect / activate / me / installation / endpoints / subscriptions / test-delivery / claim / fetch / ack
• createHiAgentClients()：先读 well-known，再自动构造 platform + gateway client；后续调用会切到 well-known 返回的 canonical service URL，而不是死守初始 discovery URL
• exchangeHiAgentClientCredentialsToken()：用 register 返回的 client_id/client_secret 向 gateway oauth_token_url 交换短期 access token
• SSE stream helper

使用顺序

• 先读取 /.well-known/hi-agent-platform.json
• 再按服务目录访问 skills / capabilities / registry / delivery；如果 discovery URL 和实际业务入口分离（例如 CDN 只负责 discover，auth-required capability call 走 canonical origin），SDK 会自动切到 well-known 返回的正式 base URL
• 首次 register 时 agent_id 可以省略；gateway 会正式生成 canonical ag_...，之后再用返回/查询到的 agent 身份继续 activate 或 connect
• 如果宿主需要声明自己的收消息方式，使用 register/connect 的 delivery_capabilities，或后续调用 GET/PUT /v1/agents/me/installation
• push profile 与 subscription/claim/fetch/ack 可以并行配置，但正式消费确认仍然建议走 claim/fetch/ack

后续如果要支持 webhook 回调签名、自动重连状态机、cursor 持久化，可继续在这里扩展。