super-agent-sdk 1.0.6 → 1.0.8

package/README.md

@@ -131,6 +131,7 @@ ready
 
 ```ts
 export interface SuperAgentSDK {
+  readonly botId: number; // 当前 Bot ID
   createSession(): Promise<string>;
   chat(options: ChatOptions): AbortController;
   listConversations(
@@ -143,7 +144,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>;
+  respondInterrupt(interruptId: string, sessionId: string, response: InterruptResponse, onMessage?: (event: ChatEvent) => void, onError?: (error: Error) => void): Promise<void>;
+  listSkills(): Promise<SkillInfo[]>;
+  stopGeneration(sessionId: string): Promise<void>;
 }
 ```
 
@@ -173,7 +176,7 @@ export interface ChatOptions {
   stream?: boolean; // 默认 true
   onMessage?: (event: ChatEvent) => void;
   onError?: (error: Error) => void;
-  onDone?: (result: { sessionId: string; content: string }) => void;
+  onDone?: (result: { sessionId: string; content: string; messageId?: string }) => void; // messageId：后端在 done 事件返回的消息标识（存在时 SDK Widget 用其启用消息反馈，若返回可据此判断该消息可 feedback）
   signal?: AbortSignal;
 }
 ```
@@ -301,26 +304,57 @@ sdk.setToken("<TOKEN>");
 
 消息反馈（赞/踩）。调用 `sdk.feedback()` 发送 `POST /chat/messages/{messageId}/feedback`；调用 `sdk.cancelFeedback()` 发送 `DELETE` 取消反馈。
 
+> **messageId 说明**：即消息历史返回的表主键 `id`（数字），不是 `messageId`（UUID）。纯 API 模式从 `getMessages()` 结果取 `UIMessage.id`。
+
 ```ts
+const messages = await sdk.getMessages(sessionId);
+const aiMsg = messages.findLast((m) => m.role === "assistant");
+
 // 点赞
-await sdk.feedback("msg_123", "like");
+await sdk.feedback(aiMsg.id, "like");
 
 // 踩（可附原因 + 备注）
-await sdk.feedback("msg_123", "dislike", {
+await sdk.feedback(aiMsg.id, "dislike", {
   reason: 1,  // 1=事实错误 2=逻辑问题 3=不相关 4=信息过时 5=冗长啰嗦 6=难以理解
   remark: "时间描述有误",
 });
 
 // 取消反馈
-await sdk.cancelFeedback("msg_123");
+await sdk.cancelFeedback(aiMsg.id);
 ```
 
 组件内置的点赞/踩按钮已自动调用 `feedback()`/`cancelFeedback()`：
 - 点击已选中的按钮 → 取消（DELETE）
 - 点击另一个按钮 → 切换（POST）
 - 点踩时弹出原因选择面板（可选填原因 + 备注后提交）
+- 流式渲染期间消息尚无后端 ID（临时占位），此时点击反馈 SDK 会自动拉取一次历史消息解析真实 ID 再发送，业务方无感知
+
+### 5.10 respondInterrupt()
+
+响应中断事件（Human-in-the-Loop），后端继续推送后续 SSE 事件：
+
+```ts
+sdk.respondInterrupt(
+  interruptId: string,
+  sessionId: string,
+  response: InterruptResponse,
+  onMessage?: (event: ChatEvent) => void,
+  onError?: (error: Error) => void
+): Promise<void>
+```
+
+Widget 内置中断卡片会自动调用此方法，纯 API 模式需手动处理（详见 [12. Human-in-the-Loop](#12-human-in-the-loop)）。
+
+### 5.11 listSkills()
 
-### 5.10 后端接口对照
+获取当前 Bot 绑定的技能列表（用于 `/` 斜杠命令选择技能）：
+
+```ts
+const skills: SkillInfo[] = await sdk.listSkills();
+// [{ code: "web-searcher", name: "web-searcher", displayName: "网页搜索", description: "..." }]
+```
+
+### 5.12 后端接口对照
 
 SDK 方法 → 后端接口的完整映射：
 
@@ -330,10 +364,13 @@ 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`                               |
+| `respondInterrupt()`  | `POST /chat/interrupt/{interruptId}/respond` | `{ sessionId, action, value? }` | SSE 流（后续事件）              |
+| `stopGeneration()`    | `POST /chat/stop`         | `{ sessionId }`                         | `{ stopped: "pending", sessionId }`             |
+| `listSkills()`        | `GET /chat/bots/{botId}/skills` | —                                 | `[{ code, name, displayName, description }]`    |
 
 ---
 
@@ -360,6 +397,7 @@ export interface MountOptions {
   title?: string; // 标题，默认 "AI Assistant"
   sidebarDefaultOpen?: boolean; // fullpage 模式：侧边栏初始展开（默认 true）
   avatar?: AvatarConfig; // 自定义头像
+  artifactPreview?: boolean; // 产物预览总开关（html/pdf/docx 预览 + 下载 + 全屏），默认 false
 }
 
 export interface WidgetInstance {
@@ -500,6 +538,7 @@ export interface Slots {
   ToolCallPart?: ComponentType<ToolCallPartProps>;
   ToolResultPart?: ComponentType<ToolResultPartProps>;
   ErrorPart?: ComponentType<ErrorPartProps>;
+  InterruptCard?: ComponentType<InterruptCardProps>;
   WelcomeScreen?: ComponentType<WelcomeScreenProps>;
 }
 ```
@@ -514,8 +553,8 @@ export interface Slots {
 | `ThreadList`     | `ThreadListProps`     | 会话列表（浮窗模式覆盖层 / 全屏模式侧边栏） |
 | `ThinkingPart`   | `ThinkingPartProps`   | 思考过程块                                  |
 | `TextPart`       | `TextPartProps`       | 文本块                                      |
-| `ToolCallPart`   | `ToolCallPartProps`   | 工具调用卡片                                |
-| `ToolResultPart` | `ToolResultPartProps` | 工具返回卡片                                |
+| `ToolCallPart`   | `ToolCallPartProps`   | 工具调用卡片（可折叠 + 展开后复制参数）    |
+| `ToolResultPart` | `ToolResultPartProps` | 工具返回卡片（pre 滚动 + 复制；`renderMode==="html"` 时 DOMPurify 清洗后直接渲染，最高 60vh 滚动） |
 | `ErrorPart`      | `ErrorPartProps`      | 错误提示块                                  |
 | `WelcomeScreen`  | `WelcomeScreenProps`  | 空会话欢迎页                                |
 
@@ -693,8 +732,8 @@ function MyComposer({ status, onSend, onStop }: ComposerProps) {
 export interface ActionBarProps {
   message: UIMessage;
   onCopy: () => void;
-  onRegenerate: () => void;
-  onFeedback?: (messageId: string, feedback: "like" | "dislike") => void;
+  onRegenerate?: () => void;
+  onFeedback?: (messageId: string, feedback: "like" | "dislike", options?: { reason?: number; remark?: string }) => void;
 }
 ```
 
@@ -728,6 +767,8 @@ export interface ThreadListProps {
   onNew: () => void;
   onDelete: (sessionId: string) => void;
   onRename: (sessionId: string, title: string) => void;
+  hasMore?: boolean;
+  onLoadMore?: () => void;
 }
 ```
 
@@ -791,6 +832,10 @@ export interface ToolResultPartProps {
   toolName: string;
   toolCallId: string;
   content: string;
+  artifacts?: Artifact[];
+  renderMode?: string;
+  html?: string;
+  artifactPreview?: boolean;
 }
 export interface ErrorPartProps {
   content: string;
@@ -1101,18 +1146,59 @@ await sdk.deleteConversation(items[0].sessionId);
 
 ### 9.2 组件内置能力
 
-- **自动加载**：挂载后自动调用 `listConversations` 拉取会话列表。
+- **自动加载**：挂载后自动调用 `listConversations` 拉取会话列表（每页 20 条）。
+- **滚动加载**：会话列表滚动到底部时自动加载下一页，支持任意数量的会话。
 - **切换**：点击会话项加载该会话历史消息并展示。
 - **新建**：点击「新会话」清空当前消息，下次发送时自动调用 `createSession()` 创建新会话。
 - **重命名**：`fullpage` 侧边栏或自定义 `ThreadList` 中调用 `renameConversation`。
 - **删除**：悬停会话项后点击删除按钮。
-- **本地持久化**：最近一次活跃会话写入 `localStorage`，键为 `sa_active_conversation`。
+- **本地持久化**：最近一次活跃会话写入 `localStorage`，键为 `sa_active_conversation_{botId}`（按 Bot 隔离，切换 Bot 后互不串扰）。
 
 ---
 
 ## 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`，可随时中断：
 
@@ -1134,11 +1220,11 @@ sdk.chat({ sessionId, message: "...", signal: ac.signal });
 ac.abort();
 ```
 
-### 10.2 会话恢复
+### 10.3 会话恢复
 
 页面刷新或组件重新挂载时，会话状态自动恢复：
 
-1. 挂载时从 `localStorage` 读取上次活跃会话 ID（键 `sa_active_conversation`）。
+1. 挂载时从 `localStorage` 读取上次活跃会话 ID（键 `sa_active_conversation_{botId}`）。
 2. 若该会话仍在列表中，自动调用 `getMessages` 拉取历史消息并渲染。
 3. 若存储的会话已不存在（被删除），则自动清空并回退到「新会话」。
 
@@ -1171,8 +1257,17 @@ export type MessagePart =
       toolName: string;
       toolCallId: string;
       content: string;
+      artifacts?: Artifact[];
+      renderMode?: string;
+      html?: string;
     }
-  | { type: "error"; content: string };
+  | { type: "error"; content: string }
+  | {
+      type: "interrupt";
+      interrupt: InterruptEvent;
+      resolved?: boolean;
+      response?: InterruptResponse;
+    };
 ```
 
 | type          | 字段                                | 说明                            |
@@ -1180,8 +1275,9 @@ export type MessagePart =
 | `text`        | `content`                           | 文本 / Markdown 内容            |
 | `thinking`    | `content`                           | 思考过程（reasoning）           |
 | `tool_call`   | `toolName`, `toolCallId`, `args`    | 工具调用，`args` 为 JSON 字符串 |
-| `tool_result` | `toolName`, `toolCallId`, `content` | 工具返回结果                    |
+| `tool_result` | `toolName`, `toolCallId`, `content`, `artifacts?`, `renderMode?`, `html?` | 工具返回结果 |
 | `error`       | `content`                           | 错误信息                        |
+| `interrupt`   | `interrupt`, `resolved?`, `response?` | 中断交互卡片（HITL）          |
 
 ### 11.3 ChatEvent（流式事件）
 
@@ -1194,12 +1290,19 @@ export interface ChatEvent {
     | "tool_call"
     | "tool_result"
     | "done"
-    | "error";
+    | "stop"
+    | "error"
+    | "interrupt";
   content: string;
   toolName?: string;
   toolCallId?: string;
   args?: string; // JSON.stringify 后的字符串
   sessionId?: string;
+  messageId?: string; // done 事件携带后端消息标识（后端返回时该消息可反馈/feedback）
+  interrupt?: InterruptEvent; // interrupt 事件携带中断详情
+  artifacts?: Artifact[]; // tool_result 事件携带的结构化产物
+  renderMode?: string; // "html" 时工具结果为富文本
+  html?: string; // renderMode==="html" 时的 HTML 内容
 }
 ```
 
@@ -1235,7 +1338,7 @@ Agent 执行中
 ### 12.3 响应中断
 
 ```ts
-await sdk.respondInterrupt(interruptId, {
+await sdk.respondInterrupt(interruptId, sessionId, {
   action: "confirm",
 });
 ```
@@ -1270,7 +1373,7 @@ sdk.chat({
     if (e.type === "interrupt" && e.interrupt) {
       // 自定义 UI 处理
       const ok = window.confirm(e.interrupt.content);
-      sdk.respondInterrupt(e.interrupt.interruptId, {
+      sdk.respondInterrupt(e.interrupt.interruptId, sessionId, {
         action: ok ? "confirm" : "cancel",
       });
     }
@@ -1298,6 +1401,8 @@ sdk.chat({
 | `date` | 日期选择 | `submit` | `"2026-08-21T14:00:00"` |
 | `location` | 位置选择 | `submit` | `{ address, lat, lng }` |
 
+> `form` 的字段定义见 `FormField`（`types.ts`）：`type` 支持 `text` / `number` / `password` / `textarea` / `select` / `multiSelect` / `date`；`options` 支持字符串数组或 `{ value, label }` 数组。已回答的历史 interrupt 以禁用态回显用户答案。
+
 > 每个 `interruptType` 的完整字段定义见 [API 文档](./API.md) 与 [HITL 设计文档](../docs/superpowers/specs/2026-08-18-human-in-the-loop-design.md)。
 
 ---
@@ -1356,6 +1461,7 @@ interface UseChatReturn {
   stop: () => void;
   regenerate: () => void;
   setMessages: (messages: UIMessage[]) => void;
+  respondToInterrupt: (interruptId: string, response: InterruptResponse) => void;
 }
 ```
 
@@ -1367,15 +1473,18 @@ export function useConversations(
 interface UseConversationsOptions {
   sdk: SuperAgentSDK;
   onConversationChange?: (sessionId: string) => void;
+  enabled?: boolean; // 默认 true，false 时不自动加载
 }
 
 interface UseConversationsReturn {
   conversations: Conversation[];
   activeConversationId: string | null;
   loading: boolean;
+  hasMore: boolean;
   loadConversations: () => Promise<void>;
+  loadMore: () => Promise<void>;
   switchConversation: (sessionId: string) => Promise<UIMessage[]>;
-  newConversation: () => void;
+  newConversation: () => Promise<void>;
   deleteConversation: (sessionId: string) => Promise<void>;
   renameConversation: (sessionId: string, title: string) => Promise<void>;
   setActiveConversationId: (id: string | null) => void;
@@ -1407,9 +1516,11 @@ function MyChat({ sdk }: { sdk: SuperAgentSDK }) {
 
 请求返回 `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({
@@ -1418,11 +1529,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,(a,n)=>n.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 a=u(o.data);return this.token=a.token,a.appId&&!this.appId&&(this.appId=a.appId),a.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 a=await fetch(o,{method:e,headers:this.headers(),body:s!=null&&s.body?JSON.stringify(s.body):void 0});if(a.status===401&&!(s!=null&&s.retry)&&await this.handleTokenRefresh())return this.request(e,t,{...s,retry:!0});if(!a.ok)throw new Error(`HTTP ${a.status}: ${a.statusText}`);const n=await a.json();if(n.code!=="200")throw new Error(n.message||`API error: ${n.code}`);return u(n.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}`,a=await fetch(o,{method:"POST",headers:this.headers(),body:JSON.stringify(t),signal:s});return a.status===401&&await this.handleTokenRefresh()?fetch(o,{method:"POST",headers:this.headers(),body:JSON.stringify(t),signal:s}):a}}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??"",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(r,e,t){if(!r.body){t(new Error("Response body is null"));return}const s=r.body.getReader(),o=new TextDecoder;let a="";try{for(;;){const{value:n,done:i}=await s.read();if(i)break;a+=o.decode(n,{stream:!0});let c;for(;(c=a.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??"",messageId:r.messageId})}).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=a.slice(0,c);a=a.slice(c+2);const l=y(d);l&&e(l)}}if(a.trim()){const n=y(a);n&&e(n)}}catch(n){(n==null?void 0:n.name)!=="AbortError"&&t(n instanceof Error?n:new Error(String(n)))}finally{try{s.releaseLock()}catch{}}}function b(r,e){const t=new AbortController,s=e.signal?p(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(a=>{var n;if(!a.ok){(n=e.onError)==null||n.call(e,new Error(`HTTP ${a.status}`));return}return m(a,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,messageId:i.messageId})):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(a=>{var n;(a==null?void 0:a.name)!=="AbortError"&&((n=e.onError)==null||n.call(e,a instanceof Error?a:new Error(String(a))))}):r.post("/chat",o).then(a=>{var n;(n=e.onDone)==null||n.call(e,{sessionId:a.sessionId,content:a.content??"",messageId:a.messageId})}).catch(a=>{var n;(n=e.onError)==null||n.call(e,a instanceof Error?a:new Error(String(a)))}),t}function p(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 T(r){return(await r.post("/chat/sessions",{botId:r.getBotId()})).sessionId}function k(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(k)}}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((n,i)=>{const c=new Date(n.createTime??0).getTime()||0,d=new Date(i.createTime??0).getTime()||0;return c!==d?c-d:(n.seq??0)-(i.seq??0)}),t=new Map;for(const n of e)n.role==="tool"&&n.toolCallId&&t.set(n.toolCallId,n.content||"");const s=new Set,o=[],a=(n,i,c)=>{const d=o[o.length-1];(d==null?void 0:d.role)==="assistant"?(d.parts.push(...n),d.id=i):o.push({id:i,role:"assistant",parts:[...n],timestamp:c})};for(const n of e){if(n.role==="system")continue;const i=String(n.id??n.messageId??`msg_${Date.now()}`),c=new Date(n.createTime??"").getTime()||Date.now();if(n.role==="human"){o.push({id:i,role:"user",parts:[{type:"text",content:n.content??""}],timestamp:c});continue}if(n.role==="ai"){const d=P(n,t,s);d.length>0&&a(d,i,c);continue}if(n.role==="tool"){if(n.toolCallId&&s.has(n.toolCallId))continue;a([v(n)],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(E(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 E(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 v(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,a){const n=await r.streamPost(`/chat/interrupt/${e}/respond`,{sessionId:t,action:s.action,value:s.value});if(!n.ok){const i=new Error(`HTTP ${n.status}`);throw a==null||a(i),i}o&&await m(n,i=>{i.type==="error"?a==null||a(new Error(i.content)):o(i)},i=>a==null?void 0:a(i))}async function D(r){return r.get(`/chat/bots/${r.getBotId()}/skills`)}async function q(r,e){await r.post("/chat/stop",{sessionId:e})}function N(r){const e=new w(r);return{botId:e.getBotId(),getToken:()=>e.fetchToken(),createSession:()=>T(e),chat:s=>b(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,a,n,i)=>x(e,s,o,a,n,i),setToken:s=>e.setToken(s),feedback:async(s,o,a)=>{const n={type:o};o==="dislike"&&((a==null?void 0:a.reason)!=null&&(n.reason=a.reason),a!=null&&a.remark&&(n.remark=a.remark)),await e.post(`/chat/messages/${s}/feedback`,n)},cancelFeedback:async s=>{await e.del(`/chat/messages/${s}/feedback`)},listSkills:()=>D(e),stopGeneration:s=>q(e,s)}}exports.createSuperAgent=N;

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;
@@ -55,11 +55,14 @@ export declare function createSuperAgent(config: SDKConfig): SuperAgentSDK;
 export declare interface FormField {
     name: string;
     label: string;
-    type: 'text' | 'number' | 'password' | 'textarea' | 'select' | 'date';
+    type: 'text' | 'number' | 'password' | 'textarea' | 'select' | 'multiSelect' | 'date';
     required?: boolean;
     placeholder?: string;
     defaultValue?: any;
-    options?: string[];
+    options?: (string | {
+        value: string;
+        label: string;
+    })[];
 }
 
 export declare interface InterruptEvent {
@@ -137,7 +140,16 @@ export declare interface SDKConfig {
     token?: string;
 }
 
+declare interface SkillInfo {
+    code: string;
+    name: string;
+    displayName: string | null;
+    description: string | null;
+}
+
 export declare interface SuperAgentSDK {
+    /** 当前 Bot ID（只读） */
+    readonly botId: number;
     /** 获取 token（调用 POST {tokenGateway}/v1/token），自动设置内部凭证 */
     getToken(): Promise<string>;
     /** 创建新会话，返回 sessionId */
@@ -157,6 +169,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 {