import { createAgentSdk } from 'linksoul-agentsdk';

const sdk = createAgentSdk(appId, {
  authProvider: async () => {
    // 向同源服务端换取已签名的代理 URL
    const res = await fetch('/api/ws-auth', { method: 'POST', /* ... */ });
    const { url } = await res.json();
    return { url };
  },
});
await sdk.connect();

┌──────────────────────────────────────────────────────────────┐
│                       灵心平台                                 │
├──────────────────────────────────────────────────────────────┤
│  机器人 ──音频/视频/文本──→ LinkskyGateway ──→ SDK回调        │  被动交互
│  机器人 ←──ASR/LLM/TTS──── LinkskyGateway ←── SDK响应         │
│                                                              │
│  SDK主动请求 ──→ LinkskyGateway ──→ 机器人                    │  主动交互
│  SDK接收结果 ←── LinkskyGateway ←── 机器人                    │
│                                                              │
│  浏览器操作员音频 ─(经服务端代理)→ LinkskyGateway ──→ 机器人   │  超视距遥操（v1.5.0）
│  操作员 ←──enter/exit ack── LinkskyGateway ←── 机器人         │
│                                                              │
│  SDK query/invoke ──→ LinkskyGateway ──→ 机器人扩展技能        │  扩展技能（v1.5.0）
│  SDK ←── queryResult/invokeResult ── LinkskyGateway ←── 机器人│
└──────────────────────────────────────────────────────────────┘

# npm / pnpm / yarn 三选一
npm install linksoul-agentsdk

import { createAgentSdk, AgentEventType } from 'linksoul-agentsdk';

# 本地安装（也可写进 package.json 的 file: 依赖）
npm install ./linksoul-agentsdk-1.5.0.tgz