super-agent-sdk 1.0.0

package/dist/index.cjs

@@ -0,0 +1,5 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function h(s){if(Array.isArray(s))return s.map(e=>h(e));if(s&&typeof s=="object"&&s.constructor===Object){const e={};for(const[r,t]of Object.entries(s)){const o=r.replace(/_([a-z])/g,(n,a)=>a.toUpperCase());e[o]=h(t)}return e}return s}class g{constructor(e){this.refreshing=null,this.baseUrl=e.baseUrl.replace(/\/$/,""),this.appId=e.appId??"",this.token=e.token??"",this.botId=e.botId}getBotId(){return this.botId}setToken(e,r){this.appId=e,this.token=r}async postPublic(e,r){const t=`${this.baseUrl}${e}`,o=await fetch(t,{method:"POST",headers:{"Content-Type":"application/json"},body:r?JSON.stringify(r):void 0});if(!o.ok)throw new Error(`HTTP ${o.status}: ${o.statusText}`);const n=await o.json();if(n.code!=="200")throw new Error(n.message||`API error: ${n.code}`);return h(n.data)}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()=>{const e=await this.postPublic("/token",{botId:this.botId});this.appId=e.appId,this.token=e.token})(),await this.refreshing,!0}catch{return!1}finally{this.refreshing=null}}async request(e,r,t){if((!this.appId||!this.token)&&!await this.handleTokenRefresh())throw new Error("SDK token not available: POST /token failed");let o=`${this.baseUrl}${r}`;if(t!=null&&t.params){const c=new URLSearchParams;for(const[l,d]of Object.entries(t.params))d!=null&&c.set(l,String(d));const i=c.toString();i&&(o+=`?${i}`)}const n=await fetch(o,{method:e,headers:this.headers(),body:t!=null&&t.body?JSON.stringify(t.body):void 0});if(n.status===401&&!(t!=null&&t.retry)&&await this.handleTokenRefresh())return this.request(e,r,{...t,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 h(a.data)}get(e,r){return this.request("GET",e,{params:r})}post(e,r){return this.request("POST",e,{body:r})}patch(e,r){return this.request("PATCH",e,{body:r})}del(e){return this.request("DELETE",e)}async streamPost(e,r,t){if((!this.appId||!this.token)&&!await this.handleTokenRefresh())throw new Error("SDK token not available: POST /token failed");const o=`${this.baseUrl}${e}`,n=await fetch(o,{method:"POST",headers:this.headers(),body:JSON.stringify(r),signal:t});return n.status===401&&await this.handleTokenRefresh()?fetch(o,{method:"POST",headers:this.headers(),body:JSON.stringify(r),signal:t}):n}}function f(s){const e=s.split(`
+`).map(t=>t.trim()).filter(t=>t.startsWith("data:")).map(t=>t.slice(5).trim());if(!e.length)return null;let r;try{r=JSON.parse(e.join(`
+`))}catch{return null}switch(r.type){case"user":return{type:"user",content:r.content??""};case"thinking":return{type:"thinking",content:r.content??""};case"ai":return{type:"ai",content:r.content??""};case"tool_call":return{type:"tool_call",content:r.name??"",toolName:r.name,toolCallId:r.id,args:typeof r.args=="string"?r.args:JSON.stringify(r.args??{})};case"tool_result":return{type:"tool_result",content:r.output??"",toolName:r.name,toolCallId:r.id};case"done":return{type:"done",content:r.content??"",sessionId:r.sessionId??r.session_id??""};case"error":return{type:"error",content:r.message??"Unknown error"};default:return null}}async function y(s,e,r){if(!s.body){r(new Error("Response body is null"));return}const t=s.body.getReader(),o=new TextDecoder;let n="";try{for(;;){const{value:a,done:c}=await t.read();if(c)break;n+=o.decode(a,{stream:!0});let i;for(;(i=n.indexOf(`
+
+`))!==-1;){const l=n.slice(0,i);n=n.slice(i+2);const d=f(l);d&&e(d)}}if(n.trim()){const a=f(n);a&&e(a)}}catch(a){(a==null?void 0:a.name)!=="AbortError"&&r(a instanceof Error?a:new Error(String(a)))}finally{try{t.releaseLock()}catch{}}}function m(s,e){const r=new AbortController,t=e.signal?I(e.signal,r.signal):r.signal,o={botId:s.getBotId(),message:e.message,sessionId:e.sessionId,stream:e.stream!==!1};return o.stream?s.streamPost("/chat",o,t).then(n=>{var a;if(!n.ok){(a=e.onError)==null||a.call(e,new Error(`HTTP ${n.status}`));return}return y(n,c=>{var i,l,d,u;c.type==="done"&&c.sessionId?(i=e.onDone)==null||i.call(e,{sessionId:c.sessionId,content:c.content}):c.type==="done"?(l=e.onDone)==null||l.call(e,{sessionId:"",content:c.content}):c.type==="error"?(d=e.onError)==null||d.call(e,new Error(c.content)):(u=e.onMessage)==null||u.call(e,c)},c=>{var i;return(i=e.onError)==null?void 0:i.call(e,c)})}).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))))}):s.post("/chat",o).then(n=>{var a;(a=e.onDone)==null||a.call(e,{sessionId:n.sessionId,content:n.content??""})}).catch(n=>{var a;(a=e.onError)==null||a.call(e,n instanceof Error?n:new Error(String(n)))}),r}function I(s,e){const r=new AbortController,t=()=>r.abort();return s.addEventListener("abort",t,{once:!0}),e.addEventListener("abort",t,{once:!0}),(s.aborted||e.aborted)&&r.abort(),r.signal}async function b(s){return(await s.post("/chat/sessions",{botId:s.getBotId()})).sessionId}function w(s){return{sessionId:s.threadId??s.sessionId,botId:s.botId,title:s.title,createTime:s.createTime,updateTime:s.updateTime}}async function k(s,e){const r=await s.get("/chat/conversations",{botId:s.getBotId(),page:(e==null?void 0:e.page)??1,size:(e==null?void 0:e.size)??20});return{...r,items:r.items.map(w)}}async function T(s,e,r){await s.patch(`/chat/conversations/${e}`,{title:r})}async function S(s,e){await s.del(`/chat/conversations/${e}`)}async function E(s,e){const r=await s.get(`/chat/conversations/${e}/messages`);return C(r)}function C(s){const e=[],r=[...s].sort((t,o)=>(t.seq??0)-(o.seq??0));for(const t of r){const o=t.role;if(o==="system")continue;const n=t.messageId??`msg_${t.id}`,a=new Date(t.createTime??"").getTime()||Date.now();if(o==="human")e.push({id:n,role:"user",parts:[{type:"text",content:t.content??""}],timestamp:a});else if(o==="ai"){const c=[];t.reasoning&&c.push({type:"thinking",content:t.reasoning}),t.content&&c.push({type:"text",content:t.content});const i=t.toolCalls;if(i&&Array.isArray(i))for(const l of i){let d;try{d=typeof l.args=="string"?l.args:JSON.stringify(l.args??{})}catch{d=String(l.args??"{}")}c.push({type:"tool_call",toolName:l.name??"",toolCallId:l.id??"",args:d})}e.push({id:n,role:"assistant",parts:c,timestamp:a})}else o==="tool"&&e.push({id:n,role:"assistant",parts:[{type:"tool_result",toolName:t.toolName??"",toolCallId:t.toolCallId??"",content:t.content??""}],timestamp:a})}return e}function P(s){const e=new g(s),r={getToken:async()=>{const t=await e.postPublic("/token",{botId:e.getBotId()});return e.setToken(t.appId,t.token),t},createSession:()=>b(e),chat:t=>m(e,t),listConversations:t=>k(e,t),renameConversation:(t,o)=>T(e,t,o),deleteConversation:t=>S(e,t),getMessages:t=>E(e,t),setToken:(t,o)=>e.setToken(t,o),feedback:(t,o)=>{var n;(n=r.onFeedback)==null||n.call(r,t,o)}};return r}exports.createSuperAgent=P;

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+export declare interface ChatEvent {
+    type: "user" | "thinking" | "ai" | "tool_call" | "tool_result" | "done" | "error";
+    content: string;
+    toolName?: string;
+    toolCallId?: string;
+    args?: string;
+    sessionId?: string;
+}
+
+export declare interface ChatOptions {
+    sessionId: string;
+    message: string;
+    stream?: boolean;
+    onMessage?: (event: ChatEvent) => void;
+    onError?: (error: Error) => void;
+    onDone?: (result: {
+        sessionId: string;
+        content: string;
+    }) => void;
+    signal?: AbortSignal;
+}
+
+export declare interface Conversation {
+    sessionId: string;
+    botId: number;
+    title: string | null;
+    createTime: string;
+    updateTime: string;
+}
+
+export declare function createSuperAgent(config: SDKConfig): SuperAgentSDK;
+
+export declare interface ListConversationsParams {
+    page?: number;
+    size?: number;
+}
+
+export declare interface ListConversationsResult {
+    items: Conversation[];
+    total: number;
+}
+
+export declare type MessagePart = {
+    type: "text";
+    content: string;
+} | {
+    type: "thinking";
+    content: string;
+} | {
+    type: "tool_call";
+    toolName: string;
+    toolCallId: string;
+    args: string;
+} | {
+    type: "tool_result";
+    toolName: string;
+    toolCallId: string;
+    content: string;
+} | {
+    type: "error";
+    content: string;
+};
+
+export declare interface SDKConfig {
+    baseUrl: string;
+    botId: number;
+    appId?: string;
+    token?: string;
+}
+
+export declare interface SuperAgentSDK {
+    /** 获取 token（调用 POST /token），自动设置内部凭证 */
+    getToken(): Promise<{
+        appId: string;
+        token: string;
+    }>;
+    /** 创建新会话，返回 sessionId */
+    createSession(): Promise<string>;
+    chat(options: ChatOptions): AbortController;
+    listConversations(params?: ListConversationsParams): Promise<ListConversationsResult>;
+    renameConversation(sessionId: string, title: string): Promise<void>;
+    deleteConversation(sessionId: string): Promise<void>;
+    getMessages(sessionId: string): Promise<UIMessage[]>;
+    setToken(appId: string, token: string): void;
+    feedback(sessionId: string, type: "like" | "dislike"): void;
+    onFeedback?: (sessionId: string, type: "like" | "dislike") => void;
+}
+
+export declare interface UIMessage {
+    id: string;
+    role: "user" | "assistant";
+    parts: MessagePart[];
+    timestamp: number;
+}
+
+export { }

package/dist/index.mjs

@@ -0,0 +1,345 @@
+function h(s) {
+  if (Array.isArray(s)) return s.map((e) => h(e));
+  if (s && typeof s == "object" && s.constructor === Object) {
+    const e = {};
+    for (const [r, t] of Object.entries(s)) {
+      const o = r.replace(/_([a-z])/g, (n, a) => a.toUpperCase());
+      e[o] = h(t);
+    }
+    return e;
+  }
+  return s;
+}
+class g {
+  constructor(e) {
+    this.refreshing = null, this.baseUrl = e.baseUrl.replace(/\/$/, ""), this.appId = e.appId ?? "", this.token = e.token ?? "", this.botId = e.botId;
+  }
+  getBotId() {
+    return this.botId;
+  }
+  setToken(e, r) {
+    this.appId = e, this.token = r;
+  }
+  /** POST without auth headers (for /token endpoint) */
+  async postPublic(e, r) {
+    const t = `${this.baseUrl}${e}`, o = await fetch(t, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: r ? JSON.stringify(r) : void 0
+    });
+    if (!o.ok)
+      throw new Error(`HTTP ${o.status}: ${o.statusText}`);
+    const n = await o.json();
+    if (n.code !== "200")
+      throw new Error(n.message || `API error: ${n.code}`);
+    return h(n.data);
+  }
+  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 () => {
+        const e = await this.postPublic("/token", { botId: this.botId });
+        this.appId = e.appId, this.token = e.token;
+      })(), await this.refreshing, !0;
+    } catch {
+      return !1;
+    } finally {
+      this.refreshing = null;
+    }
+  }
+  async request(e, r, t) {
+    if ((!this.appId || !this.token) && !await this.handleTokenRefresh())
+      throw new Error("SDK token not available: POST /token failed");
+    let o = `${this.baseUrl}${r}`;
+    if (t != null && t.params) {
+      const c = new URLSearchParams();
+      for (const [l, d] of Object.entries(t.params))
+        d != null && c.set(l, String(d));
+      const i = c.toString();
+      i && (o += `?${i}`);
+    }
+    const n = await fetch(o, {
+      method: e,
+      headers: this.headers(),
+      body: t != null && t.body ? JSON.stringify(t.body) : void 0
+    });
+    if (n.status === 401 && !(t != null && t.retry) && await this.handleTokenRefresh())
+      return this.request(e, r, { ...t, 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 h(a.data);
+  }
+  get(e, r) {
+    return this.request("GET", e, { params: r });
+  }
+  post(e, r) {
+    return this.request("POST", e, { body: r });
+  }
+  patch(e, r) {
+    return this.request("PATCH", e, { body: r });
+  }
+  del(e) {
+    return this.request("DELETE", e);
+  }
+  /** For SSE streaming — returns raw Response (no envelope unwrap) */
+  async streamPost(e, r, t) {
+    if ((!this.appId || !this.token) && !await this.handleTokenRefresh())
+      throw new Error("SDK token not available: POST /token failed");
+    const o = `${this.baseUrl}${e}`, n = await fetch(o, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify(r),
+      signal: t
+    });
+    return n.status === 401 && await this.handleTokenRefresh() ? fetch(o, {
+      method: "POST",
+      headers: this.headers(),
+      body: JSON.stringify(r),
+      signal: t
+    }) : n;
+  }
+}
+function f(s) {
+  const e = s.split(`
+`).map((t) => t.trim()).filter((t) => t.startsWith("data:")).map((t) => t.slice(5).trim());
+  if (!e.length) return null;
+  let r;
+  try {
+    r = JSON.parse(e.join(`
+`));
+  } catch {
+    return null;
+  }
+  switch (r.type) {
+    case "user":
+      return { type: "user", content: r.content ?? "" };
+    case "thinking":
+      return { type: "thinking", content: r.content ?? "" };
+    case "ai":
+      return { type: "ai", content: r.content ?? "" };
+    case "tool_call":
+      return {
+        type: "tool_call",
+        content: r.name ?? "",
+        toolName: r.name,
+        toolCallId: r.id,
+        args: typeof r.args == "string" ? r.args : JSON.stringify(r.args ?? {})
+      };
+    case "tool_result":
+      return {
+        type: "tool_result",
+        content: r.output ?? "",
+        toolName: r.name,
+        toolCallId: r.id
+      };
+    case "done":
+      return {
+        type: "done",
+        content: r.content ?? "",
+        // 后端 SSE 返回 session_id (snake_case)，此处统一映射为 sessionId
+        sessionId: r.sessionId ?? r.session_id ?? ""
+      };
+    case "error":
+      return { type: "error", content: r.message ?? "Unknown error" };
+    default:
+      return null;
+  }
+}
+async function y(s, e, r) {
+  if (!s.body) {
+    r(new Error("Response body is null"));
+    return;
+  }
+  const t = s.body.getReader(), o = new TextDecoder();
+  let n = "";
+  try {
+    for (; ; ) {
+      const { value: a, done: c } = await t.read();
+      if (c) break;
+      n += o.decode(a, { stream: !0 });
+      let i;
+      for (; (i = n.indexOf(`
+
+`)) !== -1; ) {
+        const l = n.slice(0, i);
+        n = n.slice(i + 2);
+        const d = f(l);
+        d && e(d);
+      }
+    }
+    if (n.trim()) {
+      const a = f(n);
+      a && e(a);
+    }
+  } catch (a) {
+    (a == null ? void 0 : a.name) !== "AbortError" && r(a instanceof Error ? a : new Error(String(a)));
+  } finally {
+    try {
+      t.releaseLock();
+    } catch {
+    }
+  }
+}
+function m(s, e) {
+  const r = new AbortController(), t = e.signal ? I(e.signal, r.signal) : r.signal, o = {
+    botId: s.getBotId(),
+    message: e.message,
+    sessionId: e.sessionId,
+    stream: e.stream !== !1
+  };
+  return o.stream ? s.streamPost("/chat", o, t).then((n) => {
+    var a;
+    if (!n.ok) {
+      (a = e.onError) == null || a.call(e, new Error(`HTTP ${n.status}`));
+      return;
+    }
+    return y(
+      n,
+      (c) => {
+        var i, l, d, u;
+        c.type === "done" && c.sessionId ? (i = e.onDone) == null || i.call(e, { sessionId: c.sessionId, content: c.content }) : c.type === "done" ? (l = e.onDone) == null || l.call(e, { sessionId: "", content: c.content }) : c.type === "error" ? (d = e.onError) == null || d.call(e, new Error(c.content)) : (u = e.onMessage) == null || u.call(e, c);
+      },
+      (c) => {
+        var i;
+        return (i = e.onError) == null ? void 0 : i.call(e, c);
+      }
+    );
+  }).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))));
+  }) : s.post("/chat", o).then((n) => {
+    var a;
+    (a = e.onDone) == null || a.call(e, {
+      sessionId: n.sessionId,
+      content: n.content ?? ""
+    });
+  }).catch((n) => {
+    var a;
+    (a = e.onError) == null || a.call(e, n instanceof Error ? n : new Error(String(n)));
+  }), r;
+}
+function I(s, e) {
+  const r = new AbortController(), t = () => r.abort();
+  return s.addEventListener("abort", t, { once: !0 }), e.addEventListener("abort", t, { once: !0 }), (s.aborted || e.aborted) && r.abort(), r.signal;
+}
+async function w(s) {
+  return (await s.post("/chat/sessions", {
+    botId: s.getBotId()
+  })).sessionId;
+}
+function b(s) {
+  return {
+    // 后端返回 thread_id，toCamelCase 转为 threadId，映射为 sessionId
+    sessionId: s.threadId ?? s.sessionId,
+    botId: s.botId,
+    title: s.title,
+    createTime: s.createTime,
+    updateTime: s.updateTime
+  };
+}
+async function k(s, e) {
+  const r = await s.get("/chat/conversations", {
+    botId: s.getBotId(),
+    page: (e == null ? void 0 : e.page) ?? 1,
+    size: (e == null ? void 0 : e.size) ?? 20
+  });
+  return {
+    ...r,
+    items: r.items.map(b)
+  };
+}
+async function T(s, e, r) {
+  await s.patch(`/chat/conversations/${e}`, { title: r });
+}
+async function S(s, e) {
+  await s.del(`/chat/conversations/${e}`);
+}
+async function E(s, e) {
+  const r = await s.get(`/chat/conversations/${e}/messages`);
+  return C(r);
+}
+function C(s) {
+  const e = [], r = [...s].sort((t, o) => (t.seq ?? 0) - (o.seq ?? 0));
+  for (const t of r) {
+    const o = t.role;
+    if (o === "system") continue;
+    const n = t.messageId ?? `msg_${t.id}`, a = new Date(t.createTime ?? "").getTime() || Date.now();
+    if (o === "human")
+      e.push({
+        id: n,
+        role: "user",
+        parts: [{ type: "text", content: t.content ?? "" }],
+        timestamp: a
+      });
+    else if (o === "ai") {
+      const c = [];
+      t.reasoning && c.push({ type: "thinking", content: t.reasoning }), t.content && c.push({ type: "text", content: t.content });
+      const i = t.toolCalls;
+      if (i && Array.isArray(i))
+        for (const l of i) {
+          let d;
+          try {
+            d = typeof l.args == "string" ? l.args : JSON.stringify(l.args ?? {});
+          } catch {
+            d = String(l.args ?? "{}");
+          }
+          c.push({
+            type: "tool_call",
+            toolName: l.name ?? "",
+            toolCallId: l.id ?? "",
+            args: d
+          });
+        }
+      e.push({ id: n, role: "assistant", parts: c, timestamp: a });
+    } else o === "tool" && e.push({
+      id: n,
+      role: "assistant",
+      parts: [{
+        type: "tool_result",
+        toolName: t.toolName ?? "",
+        toolCallId: t.toolCallId ?? "",
+        content: t.content ?? ""
+      }],
+      timestamp: a
+    });
+  }
+  return e;
+}
+function $(s) {
+  const e = new g(s), r = {
+    getToken: async () => {
+      const t = await e.postPublic(
+        "/token",
+        { botId: e.getBotId() }
+      );
+      return e.setToken(t.appId, t.token), t;
+    },
+    createSession: () => w(e),
+    chat: (t) => m(e, t),
+    listConversations: (t) => k(e, t),
+    renameConversation: (t, o) => T(e, t, o),
+    deleteConversation: (t) => S(e, t),
+    getMessages: (t) => E(e, t),
+    setToken: (t, o) => e.setToken(t, o),
+    feedback: (t, o) => {
+      var n;
+      (n = r.onFeedback) == null || n.call(r, t, o);
+    }
+  };
+  return r;
+}
+export {
+  $ as createSuperAgent
+};