super-agent-sdk 1.0.5 → 1.0.7

package/README.md

@@ -63,9 +63,8 @@ import { createSuperAgent } from "super-agent-sdk";
 import { mount } from "super-agent-sdk/widget";
 
 const sdk = createSuperAgent({
-  baseUrl: "/api/v1",
   botId: 1,
-  appId: "your_app_id",
+  tokenGateway: "/api/gateway",
 });
 // Token 自动获取，无需手动设置
 const widget = mount("#chat", { sdk });
@@ -84,39 +83,40 @@ function createSuperAgent(config: SDKConfig): SuperAgentSDK;
 
 ```ts
 export interface SDKConfig {
-  baseUrl: string; // e.g. "https://agent.example.com/api/v1"
-  botId: number; // bot ID
-  appId: string; // 应用密钥，用于换取 token
+  botId: number;          // Bot ID（必填）
+  tokenGateway: string;   // Token 网关前缀（必填，不带 host），如 "/api/gateway"；token URL = {origin}{tokenGateway}/v1/token
+  baseUrl?: string;       // 业务接口前缀（可选，默认 "/api/agent/runtime/v1"），不带 host
+  appId?: string;         // 可选，不传则从 token 接口响应自动获取
+  token?: string;         // 可选，不传则自动调 token 接口获取
 }
 ```
 
-只需提供 `baseUrl`、`botId` 与 `appId` 即可。SDK 不要求在创建时传入 `token`——组件挂载后会自动调用 `sdk.getToken()` 获取 token 并内部保存，无需手动设置。
+只需提供 `botId` 与 `tokenGateway` 即可。`baseUrl` 默认为 `/api/agent/runtime/v1`，`appId` 从 token 接口响应中自动获取。SDK 不要求在创建时传入 `token`——组件挂载后会自动调用 `sdk.getToken()` 获取 token 并内部保存，无需手动设置。
 
 ```ts
 const sdk = createSuperAgent({
-  baseUrl: "https://agent.example.com/api/v1",
   botId: 1,
-  appId: "your_app_id",
+  tokenGateway: "/api/gateway",
 });
 ```
 
 凭证获取流程：
 
 ```
-createSuperAgent({ baseUrl, botId, appId })
+createSuperAgent({ botId, tokenGateway })
         ↓
 Widget 挂载时自动调用 sdk.getToken()
         ↓
-POST /api/token（无参数）
+POST {origin}{tokenGateway}/v1/token（body: { botId }）
         ↓
-后端返回 { token }
+后端返回 { token, appId }
         ↓
-SDK 内部自动保存 token
+SDK 内部自动保存 token + appId
         ↓
 ready
 ```
 
-`appId` 用于换取访问 token，浏览器端后续请求只持有短时有效的 token。
+`tokenGateway` 用于拼接 token 接口路径，`appId` 自动从 token 响应获取（也可手动传入覆盖）。
 
 ---
 
@@ -143,6 +143,9 @@ export interface SuperAgentSDK {
   setToken(token: string): void;
   feedback(messageId: string, type: "like" | "dislike", options?: { reason?: number; remark?: string }): Promise<void>;
   cancelFeedback(messageId: string): Promise<void>;
+  respondInterrupt(interruptId: string, sessionId: string, response: InterruptResponse): Promise<void>;
+  listSkills(): Promise<SkillInfo[]>;
+  stopGeneration(sessionId: string): Promise<void>;
 }
 ```
 
@@ -275,9 +278,9 @@ sdk.getToken(): Promise<string>
 
 自动获取并保存访问 token：
 
-- SDK 调用 `POST /api/token`（固定路径，不拼接 `baseUrl`），无需请求参数
-- 后端返回 `{ token }`
-- SDK 自动将 token 保存在内部
+- SDK 调用 `POST {origin}{tokenGateway}/v1/token`，请求体 `{ botId }`
+- 后端返回 `{ token, appId }`
+- SDK 自动将 token + appId 保存在内部
 - Widget 在挂载时自动调用此方法 —— 通常无需手动调用
 
 ```ts
@@ -329,10 +332,12 @@ SDK 方法 → 后端接口的完整映射：
 | --------------------- | ------------------------- | --------------------------------------- | ----------------------------------------------- |
 | `getToken()`          | `POST {gateway}/v1/token` | `{ botId }`                             | `{ token, appId }`                              |
 | `createSession()`     | `POST /chat/sessions`     | `{ botId }`                             | `{ sessionId }`                                 |
-| `chat()`              | `POST /chat`              | `{ botId, sessionId, message, stream }` | SSE 流，`done` 事件含 `sessionId`               |
+| `chat()`              | `POST /chat`              | `{ botId, sessionId, message, stream }` | SSE 流，`done`/`stop` 事件含 `sessionId`        |
 | `listConversations()` | `GET /chat/conversations` | 查询参数 `botId`、`page`、`size`        | `{ items: [{ sessionId, botId, ... }], total }` |
 | `feedback()`          | `POST /chat/messages/{messageId}/feedback` | `{ type, reason?, remark? }` | `null`                               |
 | `cancelFeedback()`    | `DELETE /chat/messages/{messageId}/feedback` | 无 body                     | `null`                               |
+| `stopGeneration()`    | `POST /chat/stop`         | `{ sessionId }`                         | `{ stopped: "pending", sessionId }`             |
+| `listSkills()`        | `GET /chat/bots/{botId}/skills` | —                                 | `[{ code, name, displayName, description }]`    |
 
 ---
 
@@ -373,9 +378,8 @@ import { createSuperAgent } from "super-agent-sdk";
 import { mount } from "super-agent-sdk/widget";
 
 const sdk = createSuperAgent({
-  baseUrl: "/api/v1",
   botId: 1,
-  appId: "your_app_id",
+  tokenGateway: "/api/gateway",
 });
 
 const widget = mount("#chat-root", {
@@ -728,6 +732,8 @@ export interface ThreadListProps {
   onNew: () => void;
   onDelete: (sessionId: string) => void;
   onRename: (sessionId: string, title: string) => void;
+  hasMore?: boolean;
+  onLoadMore?: () => void;
 }
 ```
 
@@ -867,7 +873,7 @@ mount("#chat-root", {
 });
 ```
 
-> 点赞 / 踩的反馈回调不在 `hooks` 中，而是在 `sdk.onFeedback`（见 [5.9](#59-feedback--onfeedback)）。
+> 点赞 / 踩由内置 `ActionBar` 组件通过 `ChatState.feedback()` / `cancelFeedback()` 自动处理，无需额外配置（见 [5.9](#59-feedback--cancelfeedback)）。
 
 ### 8.5 定制示例
 
@@ -885,9 +891,8 @@ import type {
 } from "super-agent-sdk/widget";
 
 const sdk = createSuperAgent({
-  baseUrl: "/api/v1",
   botId: 1,
-  appId: "your_app_id",
+  tokenGateway: "/api/gateway",
 });
 sdk.setToken("demo_token");
 
@@ -1102,7 +1107,8 @@ await sdk.deleteConversation(items[0].sessionId);
 
 ### 9.2 组件内置能力
 
-- **自动加载**：挂载后自动调用 `listConversations` 拉取会话列表。
+- **自动加载**：挂载后自动调用 `listConversations` 拉取会话列表（每页 20 条）。
+- **滚动加载**：会话列表滚动到底部时自动加载下一页，支持任意数量的会话。
 - **切换**：点击会话项加载该会话历史消息并展示。
 - **新建**：点击「新会话」清空当前消息，下次发送时自动调用 `createSession()` 创建新会话。
 - **重命名**：`fullpage` 侧边栏或自定义 `ThreadList` 中调用 `renameConversation`。
@@ -1113,7 +1119,47 @@ await sdk.deleteConversation(items[0].sessionId);
 
 ## 10. 中断恢复
 
-### 10.1 中断请求
+### 10.1 停止生成
+
+SDK 提供双信号停止机制，确保多实例部署下也能可靠停止生成：
+
+1. **`abort()`**：断开 SSE 连接，前端即时停止接收
+2. **`POST /chat/stop`**：通过 Redis Pub/Sub 广播取消信号到实际执行的后端实例
+
+Widget 内置的停止按钮已自动执行双信号（`abort()` + `stopGeneration()`），无需手动处理。
+
+#### 纯 API 模式
+
+```ts
+const controller = sdk.chat({
+  sessionId,
+  message: "...",
+  stream: true,
+  onMessage: (event) => {
+    if (event.type === 'stop') {
+      // 用户主动停止，event.content 为已生成的半截回复全文
+      console.log("已停止，半截回复：", event.content);
+    }
+  },
+  onDone,
+});
+
+// 停止生成：双信号并发
+controller.abort();
+await sdk.stopGeneration(sessionId);
+```
+
+#### stopGeneration()
+
+```ts
+sdk.stopGeneration(sessionId: string): Promise<void>
+```
+
+调用 `POST /chat/stop`，广播取消信号。返回 `{ stopped: "pending" }` 表示已受理，实际停止异步发生。SDK 不应阻塞等待——以 SSE 流的 `stop`/`done` 事件或本地 `abort` 作为停止完成的判定。
+
+半截回复（含思考与正文）会保留：既写入数据库（刷新可回显），也写入 checkpoint（影响下一轮对话上下文）。
+
+### 10.2 中断请求
 
 `chat()` 返回 `AbortController`，可随时中断：
 
@@ -1135,7 +1181,7 @@ sdk.chat({ sessionId, message: "...", signal: ac.signal });
 ac.abort();
 ```
 
-### 10.2 会话恢复
+### 10.3 会话恢复
 
 页面刷新或组件重新挂载时，会话状态自动恢复：
 
@@ -1195,6 +1241,7 @@ export interface ChatEvent {
     | "tool_call"
     | "tool_result"
     | "done"
+    | "stop"
     | "error";
   content: string;
   toolName?: string;
@@ -1313,9 +1360,8 @@ sdk.chat({
 import { createSuperAgent } from "super-agent-sdk";
 
 const sdk = createSuperAgent({
-  baseUrl: "/api/v1",
   botId: 1,
-  appId: "your_app_id",
+  tokenGateway: "/api/gateway",
 });
 sdk.setToken("<TOKEN>");
 
@@ -1407,11 +1453,13 @@ function MyChat({ sdk }: { sdk: SuperAgentSDK }) {
 
 ### 13.3 Token 续期
 
-请求返回 `401` 时，SDK 自动重新调用 `POST /api/token` 获取新 token。
+请求返回 `401` 时，SDK 自动重新调用 `POST {tokenGateway}/v1/token` 获取新 token。
 
-### 13.4 取消请求
+### 13.4 停止与取消请求
 
-`chat()` 返回 `AbortController`；或传入外部 `AbortSignal`（SDK 会合并内部信号，任一触发即中断）：
+`chat()` 返回 `AbortController`；或传入外部 `AbortSignal`（SDK 会合并内部信号，任一触发即中断）。
+
+推荐使用双信号机制停止生成（Widget 内置停止按钮已自动处理）：
 
 ```ts
 const controller = sdk.chat({
@@ -1420,11 +1468,16 @@ const controller = sdk.chat({
   stream: true,
   onDone,
 });
-// 稍后取消
+// 双信号停止：abort 断 SSE + POST /chat/stop 广播后端取消
 controller.abort();
+await sdk.stopGeneration(sessionId);
 ```
 
+纯客户端取消（不通知后端）：
+
 ```ts
+controller.abort();
+// 或使用外部 signal
 const ac = new AbortController();
 sdk.chat({ sessionId, message: "...", signal: ac.signal });
 ac.abort();

package/dist/index.cjs

@@ -1,5 +1,5 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function f(a){if(Array.isArray(a))return a.map(e=>f(e));if(a&&typeof a=="object"&&a.constructor===Object){const e={};for(const[t,n]of Object.entries(a)){const o=t.replace(/_([a-z])/g,(r,s)=>s.toUpperCase());e[o]=f(n)}return e}return a}const w="/api/agent/runtime/v1";class I{constructor(e){this.refreshing=null;const t=e.baseUrl??w;this.baseUrl=t.replace(/\/$/,""),this.tokenGateway=e.tokenGateway.replace(/\/$/,""),this.appId=e.appId??"",this.token=e.token??"",this.botId=e.botId,this.isAbsoluteUrl=/^https?:\/\//.test(this.baseUrl),this.isAbsoluteGateway=/^https?:\/\//.test(this.tokenGateway)}getBotId(){return this.botId}getAppKey(){return this.appId}setToken(e){this.token=e}getOrigin(){return typeof window<"u"?window.location.origin:""}async fetchToken(){const t=`${this.isAbsoluteGateway?this.tokenGateway:`${this.getOrigin()}${this.tokenGateway}`}/v1/token`,n=await fetch(t,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({botId:this.botId})});if(!n.ok)throw new Error(`HTTP ${n.status}: ${n.statusText}`);const o=await n.json();if(o.code!=="200")throw new Error(o.message||`API error: ${o.code}`);const r=f(o.data);return this.token=r.token,r.appId&&!this.appId&&(this.appId=r.appId),r.token}headers(e){return{"Content-Type":"application/json","X-App-Id":this.appId,"X-Token":this.token,...e}}async handleTokenRefresh(){if(this.refreshing)return await this.refreshing,!0;try{return this.refreshing=(async()=>{await this.fetchToken()})(),await this.refreshing,!0}catch{return!1}finally{this.refreshing=null}}async request(e,t,n){if(!this.token&&!await this.handleTokenRefresh())throw new Error("SDK token not available: POST /token failed");let o=this.isAbsoluteUrl?`${this.baseUrl}${t}`:`${this.getOrigin()}${this.baseUrl}${t}`;if(n!=null&&n.params){const i=new URLSearchParams;for(const[l,d]of Object.entries(n.params))d!=null&&i.set(l,String(d));const c=i.toString();c&&(o+=`?${c}`)}const r=await fetch(o,{method:e,headers:this.headers(),body:n!=null&&n.body?JSON.stringify(n.body):void 0});if(r.status===401&&!(n!=null&&n.retry)&&await this.handleTokenRefresh())return this.request(e,t,{...n,retry:!0});if(!r.ok)throw new Error(`HTTP ${r.status}: ${r.statusText}`);const s=await r.json();if(s.code!=="200")throw new Error(s.message||`API error: ${s.code}`);return f(s.data)}get(e,t){return this.request("GET",e,{params:t})}post(e,t){return this.request("POST",e,{body:t})}patch(e,t){return this.request("PATCH",e,{body:t})}del(e){return this.request("DELETE",e)}async streamPost(e,t,n){if(!this.token&&!await this.handleTokenRefresh())throw new Error("SDK token not available: POST /token failed");const o=this.isAbsoluteUrl?`${this.baseUrl}${e}`:`${this.getOrigin()}${this.baseUrl}${e}`,r=await fetch(o,{method:"POST",headers:this.headers(),body:JSON.stringify(t),signal:n});return r.status===401&&await this.handleTokenRefresh()?fetch(o,{method:"POST",headers:this.headers(),body:JSON.stringify(t),signal:n}):r}}function y(a){const e=a.split(`
-`).map(n=>n.trim()).filter(n=>n.startsWith("data:")).map(n=>n.slice(5).trim());if(!e.length)return null;let t;try{t=JSON.parse(e.join(`
-`))}catch{return null}switch(t.type){case"user":return{type:"user",content:t.content??""};case"thinking":return{type:"thinking",content:t.content??""};case"ai":return{type:"ai",content:t.content??""};case"tool_call":return{type:"tool_call",content:t.name??"",toolName:t.name,toolCallId:t.id,args:typeof t.args=="string"?t.args:JSON.stringify(t.args??{})};case"tool_result":return{type:"tool_result",content:t.output??"",toolName:t.name,toolCallId:t.id,artifacts:Array.isArray(t.artifacts)?t.artifacts:void 0,renderMode:t.render_mode??t.renderMode,html:t.html};case"done":return{type:"done",content:t.content??"",sessionId:t.sessionId??t.session_id??"",messageId:t.messageId??t.message_id};case"error":return{type:"error",content:t.message??"Unknown error"};case"interrupt":return{type:"interrupt",content:t.content??"",interrupt:{interruptId:t.interruptId??t.interrupt_id??"",interruptType:t.interruptType??t.interrupt_type??"confirm",content:t.content??"",options:t.options,placeholder:t.placeholder,inputType:t.inputType??t.input_type,maxLength:t.maxLength??t.max_length,required:t.required,fields:t.fields,metadata:t.metadata}};default:return null}}async function m(a,e,t){if(!a.body){t(new Error("Response body is null"));return}const n=a.body.getReader(),o=new TextDecoder;let r="";try{for(;;){const{value:s,done:i}=await n.read();if(i)break;r+=o.decode(s,{stream:!0});let c;for(;(c=r.indexOf(`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function u(r){if(Array.isArray(r))return r.map(e=>u(e));if(r&&typeof r=="object"&&r.constructor===Object){const e={};for(const[t,s]of Object.entries(r)){const o=t.replace(/_([a-z])/g,(n,a)=>a.toUpperCase());e[o]=u(s)}return e}return r}const I="/api/agent/runtime/v1";class w{constructor(e){this.refreshing=null;const t=e.baseUrl??I;this.baseUrl=t.replace(/\/$/,""),this.tokenGateway=e.tokenGateway.replace(/\/$/,""),this.appId=e.appId??"",this.token=e.token??"",this.botId=e.botId,this.isAbsoluteUrl=/^https?:\/\//.test(this.baseUrl),this.isAbsoluteGateway=/^https?:\/\//.test(this.tokenGateway)}getBotId(){return this.botId}getAppKey(){return this.appId}setToken(e){this.token=e}getOrigin(){return typeof window<"u"?window.location.origin:""}async fetchToken(){const t=`${this.isAbsoluteGateway?this.tokenGateway:`${this.getOrigin()}${this.tokenGateway}`}/v1/token`,s=await fetch(t,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({botId:this.botId})});if(!s.ok)throw new Error(`HTTP ${s.status}: ${s.statusText}`);const o=await s.json();if(o.code!=="200")throw new Error(o.message||`API error: ${o.code}`);const n=u(o.data);return this.token=n.token,n.appId&&!this.appId&&(this.appId=n.appId),n.token}headers(e){return{"Content-Type":"application/json","X-App-Id":this.appId,"X-Token":this.token,...e}}async handleTokenRefresh(){if(this.refreshing)return await this.refreshing,!0;try{return this.refreshing=(async()=>{await this.fetchToken()})(),await this.refreshing,!0}catch{return!1}finally{this.refreshing=null}}async request(e,t,s){if(!this.token&&!await this.handleTokenRefresh())throw new Error("SDK token not available: POST /token failed");let o=this.isAbsoluteUrl?`${this.baseUrl}${t}`:`${this.getOrigin()}${this.baseUrl}${t}`;if(s!=null&&s.params){const i=new URLSearchParams;for(const[d,l]of Object.entries(s.params))l!=null&&i.set(d,String(l));const c=i.toString();c&&(o+=`?${c}`)}const n=await fetch(o,{method:e,headers:this.headers(),body:s!=null&&s.body?JSON.stringify(s.body):void 0});if(n.status===401&&!(s!=null&&s.retry)&&await this.handleTokenRefresh())return this.request(e,t,{...s,retry:!0});if(!n.ok)throw new Error(`HTTP ${n.status}: ${n.statusText}`);const a=await n.json();if(a.code!=="200")throw new Error(a.message||`API error: ${a.code}`);return u(a.data)}get(e,t){return this.request("GET",e,{params:t})}post(e,t){return this.request("POST",e,{body:t})}patch(e,t){return this.request("PATCH",e,{body:t})}del(e){return this.request("DELETE",e)}async streamPost(e,t,s){if(!this.token&&!await this.handleTokenRefresh())throw new Error("SDK token not available: POST /token failed");const o=this.isAbsoluteUrl?`${this.baseUrl}${e}`:`${this.getOrigin()}${this.baseUrl}${e}`,n=await fetch(o,{method:"POST",headers:this.headers(),body:JSON.stringify(t),signal:s});return n.status===401&&await this.handleTokenRefresh()?fetch(o,{method:"POST",headers:this.headers(),body:JSON.stringify(t),signal:s}):n}}function y(r){const e=r.split(`
+`).map(s=>s.trim()).filter(s=>s.startsWith("data:")).map(s=>s.slice(5).trim());if(!e.length)return null;let t;try{t=JSON.parse(e.join(`
+`))}catch{return null}switch(t.type){case"user":return{type:"user",content:t.content??""};case"thinking":return{type:"thinking",content:t.content??""};case"ai":return{type:"ai",content:t.content??""};case"tool_call":return{type:"tool_call",content:t.name??"",toolName:t.name,toolCallId:t.id,args:typeof t.args=="string"?t.args:JSON.stringify(t.args??{})};case"tool_result":return{type:"tool_result",content:t.output??"",toolName:t.name,toolCallId:t.id,artifacts:Array.isArray(t.artifacts)?t.artifacts:void 0,renderMode:t.render_mode??t.renderMode,html:t.html};case"done":return{type:"done",content:t.content??"",sessionId:t.sessionId??t.session_id??"",messageId:t.messageId??t.message_id};case"stop":return{type:"stop",content:t.content??"",sessionId:t.sessionId??t.session_id??""};case"error":return{type:"error",content:t.message??"Unknown error"};case"interrupt":return{type:"interrupt",content:t.content??"",interrupt:{interruptId:t.interruptId??t.interrupt_id??"",interruptType:t.interruptType??t.interrupt_type??"confirm",content:t.content??"",options:t.options,placeholder:t.placeholder,inputType:t.inputType??t.input_type,maxLength:t.maxLength??t.max_length,required:t.required,fields:t.fields,metadata:t.metadata}};default:return null}}async function m(r,e,t){if(!r.body){t(new Error("Response body is null"));return}const s=r.body.getReader(),o=new TextDecoder;let n="";try{for(;;){const{value:a,done:i}=await s.read();if(i)break;n+=o.decode(a,{stream:!0});let c;for(;(c=n.indexOf(`
 
-`))!==-1;){const l=r.slice(0,c);r=r.slice(c+2);const d=y(l);d&&e(d)}}if(r.trim()){const s=y(r);s&&e(s)}}catch(s){(s==null?void 0:s.name)!=="AbortError"&&t(s instanceof Error?s:new Error(String(s)))}finally{try{n.releaseLock()}catch{}}}function k(a,e){const t=new AbortController,n=e.signal?b(e.signal,t.signal):t.signal,o={botId:a.getBotId(),message:e.message,sessionId:e.sessionId,stream:e.stream!==!1};return o.stream?a.streamPost("/chat",o,n).then(r=>{var s;if(!r.ok){(s=e.onError)==null||s.call(e,new Error(`HTTP ${r.status}`));return}return m(r,i=>{var c,l,d,h;i.type==="done"&&i.sessionId?(c=e.onDone)==null||c.call(e,{sessionId:i.sessionId,content:i.content,messageId:i.messageId}):i.type==="done"?(l=e.onDone)==null||l.call(e,{sessionId:"",content:i.content,messageId:i.messageId}):i.type==="error"?(d=e.onError)==null||d.call(e,new Error(i.content)):(h=e.onMessage)==null||h.call(e,i)},i=>{var c;return(c=e.onError)==null?void 0:c.call(e,i)})}).catch(r=>{var s;(r==null?void 0:r.name)!=="AbortError"&&((s=e.onError)==null||s.call(e,r instanceof Error?r:new Error(String(r))))}):a.post("/chat",o).then(r=>{var s;(s=e.onDone)==null||s.call(e,{sessionId:r.sessionId,content:r.content??""})}).catch(r=>{var s;(s=e.onError)==null||s.call(e,r instanceof Error?r:new Error(String(r)))}),t}function b(a,e){const t=new AbortController,n=()=>t.abort();return a.addEventListener("abort",n,{once:!0}),e.addEventListener("abort",n,{once:!0}),(a.aborted||e.aborted)&&t.abort(),t.signal}async function T(a){return(await a.post("/chat/sessions",{botId:a.getBotId()})).sessionId}function S(a){return{sessionId:a.threadId??a.sessionId,botId:a.botId,title:a.title,createTime:a.createTime,updateTime:a.updateTime}}async function p(a,e){const t=await a.get("/chat/conversations",{botId:a.getBotId(),page:(e==null?void 0:e.page)??1,size:(e==null?void 0:e.size)??20});return{...t,items:t.items.map(S)}}async function $(a,e,t){await a.patch(`/chat/conversations/${e}`,{title:t})}async function A(a,e){await a.del(`/chat/conversations/${e}`)}async function C(a,e){const t=await a.get(`/chat/conversations/${e}/messages`);return O(t)}function O(a){var n,o,r;const e=[],t=[...a].sort((s,i)=>(s.seq??0)-(i.seq??0));for(const s of t){const i=s.role;if(i==="system")continue;const c=s.messageId??`msg_${s.id}`,l=new Date(s.createTime??"").getTime()||Date.now();if(i==="human")e.push({id:c,role:"user",parts:[{type:"text",content:s.content??""}],timestamp:l});else if(i==="ai"){const d=[];s.reasoning&&d.push({type:"thinking",content:s.reasoning}),s.content&&d.push({type:"text",content:s.content});const h=s.toolCalls;if(h&&Array.isArray(h))for(const u of h){let g;try{g=typeof u.args=="string"?u.args:JSON.stringify(u.args??{})}catch{g=String(u.args??"{}")}d.push({type:"tool_call",toolName:u.name??"",toolCallId:u.id??"",args:g})}e.push({id:c,role:"assistant",parts:d,timestamp:l})}else if(i==="tool"){const d=Array.isArray(s.artifacts)?s.artifacts:void 0;e.push({id:c,role:"assistant",parts:[{type:"tool_result",toolName:s.toolName??"",toolCallId:s.toolCallId??"",content:s.content??"",artifacts:d,renderMode:((n=s.metadata)==null?void 0:n.renderMode)??((o=s.metadata)==null?void 0:o.render_mode),html:(r=s.metadata)==null?void 0:r.html}],timestamp:l})}}return e}async function _(a,e,t,n,o,r){const s=await a.streamPost(`/chat/interrupt/${e}/respond`,{sessionId:t,action:n.action,value:n.value});if(!s.ok){const i=new Error(`HTTP ${s.status}`);throw r==null||r(i),i}o&&await m(s,i=>{i.type==="error"?r==null||r(new Error(i.content)):o(i)},i=>r==null?void 0:r(i))}function v(a){const e=new I(a);return{getToken:()=>e.fetchToken(),createSession:()=>T(e),chat:n=>k(e,n),listConversations:n=>p(e,n),renameConversation:(n,o)=>$(e,n,o),deleteConversation:n=>A(e,n),getMessages:n=>C(e,n),respondInterrupt:(n,o,r,s,i)=>_(e,n,o,r,s,i),setToken:n=>e.setToken(n),feedback:async(n,o,r)=>{const s={type:o};o==="dislike"&&((r==null?void 0:r.reason)!=null&&(s.reason=r.reason),r!=null&&r.remark&&(s.remark=r.remark)),await e.post(`/chat/messages/${n}/feedback`,s)},cancelFeedback:async n=>{await e.del(`/chat/messages/${n}/feedback`)}}}exports.createSuperAgent=v;
+`))!==-1;){const d=n.slice(0,c);n=n.slice(c+2);const l=y(d);l&&e(l)}}if(n.trim()){const a=y(n);a&&e(a)}}catch(a){(a==null?void 0:a.name)!=="AbortError"&&t(a instanceof Error?a:new Error(String(a)))}finally{try{s.releaseLock()}catch{}}}function p(r,e){const t=new AbortController,s=e.signal?b(e.signal,t.signal):t.signal,o={botId:r.getBotId(),message:e.message,sessionId:e.sessionId,stream:e.stream!==!1};return o.stream?r.streamPost("/chat",o,s).then(n=>{var a;if(!n.ok){(a=e.onError)==null||a.call(e,new Error(`HTTP ${n.status}`));return}return m(n,i=>{var c,d,l,h,f,g;i.type==="done"&&i.sessionId?(c=e.onDone)==null||c.call(e,{sessionId:i.sessionId,content:i.content,messageId:i.messageId}):i.type==="done"?(d=e.onDone)==null||d.call(e,{sessionId:"",content:i.content,messageId:i.messageId}):i.type==="stop"?((l=e.onMessage)==null||l.call(e,i),(h=e.onDone)==null||h.call(e,{sessionId:i.sessionId??"",content:i.content})):i.type==="error"?(f=e.onError)==null||f.call(e,new Error(i.content)):(g=e.onMessage)==null||g.call(e,i)},i=>{var c;return(c=e.onError)==null?void 0:c.call(e,i)})}).catch(n=>{var a;(n==null?void 0:n.name)!=="AbortError"&&((a=e.onError)==null||a.call(e,n instanceof Error?n:new Error(String(n))))}):r.post("/chat",o).then(n=>{var a;(a=e.onDone)==null||a.call(e,{sessionId:n.sessionId,content:n.content??"",messageId:n.messageId})}).catch(n=>{var a;(a=e.onError)==null||a.call(e,n instanceof Error?n:new Error(String(n)))}),t}function b(r,e){const t=new AbortController,s=()=>t.abort();return r.addEventListener("abort",s,{once:!0}),e.addEventListener("abort",s,{once:!0}),(r.aborted||e.aborted)&&t.abort(),t.signal}async function k(r){return(await r.post("/chat/sessions",{botId:r.getBotId()})).sessionId}function T(r){return{sessionId:r.threadId??r.sessionId,botId:r.botId,title:r.title,createTime:r.createTime,updateTime:r.updateTime}}async function S(r,e){const t=await r.get("/chat/conversations",{botId:r.getBotId(),page:(e==null?void 0:e.page)??1,size:(e==null?void 0:e.size)??20});return{...t,items:t.items.map(T)}}async function $(r,e,t){await r.patch(`/chat/conversations/${e}`,{title:t})}async function A(r,e){await r.del(`/chat/conversations/${e}`)}async function C(r,e){const t=await r.get(`/chat/conversations/${e}/messages`);return O(t)}function O(r){const e=[...r].sort((a,i)=>(a.seq??0)-(i.seq??0)),t=new Map;for(const a of e)a.role==="tool"&&a.toolCallId&&t.set(a.toolCallId,a.content||"");const s=new Set,o=[],n=(a,i,c)=>{const d=o[o.length-1];(d==null?void 0:d.role)==="assistant"?(d.parts.push(...a),d.id=i):o.push({id:i,role:"assistant",parts:[...a],timestamp:c})};for(const a of e){if(a.role==="system")continue;const i=a.messageId??`msg_${a.id}`,c=new Date(a.createTime??"").getTime()||Date.now();if(a.role==="human"){o.push({id:i,role:"user",parts:[{type:"text",content:a.content??""}],timestamp:c});continue}if(a.role==="ai"){const d=P(a,t,s);d.length>0&&n(d,i,c);continue}if(a.role==="tool"){if(a.toolCallId&&s.has(a.toolCallId))continue;n([E(a)],i,c)}}return o}function P(r,e,t){const s=[];r.reasoning&&s.push({type:"thinking",content:r.reasoning}),r.content&&s.push({type:"text",content:r.content});for(const o of r.toolCalls??[])o.is_interrupt?(t.add(o.id),s.push(_(o,e))):s.push(v(o));return s}function _(r,e){const t=e.has(r.id),s=typeof r.args=="object"?r.args:{};return{type:"interrupt",interrupt:{interruptId:r.id??"",interruptType:s.interruptType??"input",content:s.content??"",options:s.options,placeholder:s.placeholder,inputType:s.inputType,maxLength:s.maxLength,required:s.required,fields:s.fields,metadata:s.metadata},resolved:t,response:t?{action:"submit",value:U(e.get(r.id))}:void 0}}function v(r){let e;try{e=typeof r.args=="string"?r.args:JSON.stringify(r.args??{})}catch{e=String(r.args??"{}")}return{type:"tool_call",toolName:r.name??"",toolCallId:r.id??"",args:e}}function E(r){var t,s,o;const e=Array.isArray(r.artifacts)?r.artifacts:void 0;return{type:"tool_result",toolName:r.toolName??"",toolCallId:r.toolCallId??"",content:r.content??"",artifacts:e,renderMode:((t=r.metadata)==null?void 0:t.renderMode)??((s=r.metadata)==null?void 0:s.render_mode),html:(o=r.metadata)==null?void 0:o.html}}function U(r){if(r!=null)try{return JSON.parse(r)}catch{return r}}async function x(r,e,t,s,o,n){const a=await r.streamPost(`/chat/interrupt/${e}/respond`,{sessionId:t,action:s.action,value:s.value});if(!a.ok){const i=new Error(`HTTP ${a.status}`);throw n==null||n(i),i}o&&await m(a,i=>{i.type==="error"?n==null||n(new Error(i.content)):o(i)},i=>n==null?void 0:n(i))}async function q(r){return r.get(`/chat/bots/${r.getBotId()}/skills`)}async function N(r,e){await r.post("/chat/stop",{sessionId:e})}function L(r){const e=new w(r);return{getToken:()=>e.fetchToken(),createSession:()=>k(e),chat:s=>p(e,s),listConversations:s=>S(e,s),renameConversation:(s,o)=>$(e,s,o),deleteConversation:s=>A(e,s),getMessages:s=>C(e,s),respondInterrupt:(s,o,n,a,i)=>x(e,s,o,n,a,i),setToken:s=>e.setToken(s),feedback:async(s,o,n)=>{const a={type:o};o==="dislike"&&((n==null?void 0:n.reason)!=null&&(a.reason=n.reason),n!=null&&n.remark&&(a.remark=n.remark)),await e.post(`/chat/messages/${s}/feedback`,a)},cancelFeedback:async s=>{await e.del(`/chat/messages/${s}/feedback`)},listSkills:()=>q(e),stopGeneration:s=>N(e,s)}}exports.createSuperAgent=L;

package/dist/index.d.ts

@@ -15,7 +15,7 @@ export declare interface ArtifactFile {
 }
 
 export declare interface ChatEvent {
-    type: "user" | "thinking" | "ai" | "tool_call" | "tool_result" | "done" | "error" | "interrupt";
+    type: "user" | "thinking" | "ai" | "tool_call" | "tool_result" | "done" | "stop" | "error" | "interrupt";
     content: string;
     toolName?: string;
     toolCallId?: string;
@@ -137,6 +137,13 @@ export declare interface SDKConfig {
     token?: string;
 }
 
+declare interface SkillInfo {
+    code: string;
+    name: string;
+    displayName: string | null;
+    description: string | null;
+}
+
 export declare interface SuperAgentSDK {
     /** 获取 token（调用 POST {tokenGateway}/v1/token），自动设置内部凭证 */
     getToken(): Promise<string>;
@@ -157,6 +164,10 @@ export declare interface SuperAgentSDK {
     }): Promise<void>;
     /** 取消消息反馈，DELETE /chat/messages/{messageId}/feedback */
     cancelFeedback(messageId: string): Promise<void>;
+    /** 获取当前 bot 绑定的 skill 列表，GET /chat/bots/{botId}/skills */
+    listSkills(): Promise<SkillInfo[]>;
+    /** 停止生成（双信号：POST /chat/stop 广播 + abort SSE），半截回复保留 */
+    stopGeneration(sessionId: string): Promise<void>;
 }
 
 export declare interface UIMessage {