@yushaw/sanqian-sdk 0.3.18 → 0.3.19

package/dist/index.browser.d.mts

@@ -261,6 +261,14 @@ interface ChatResponse {
         total_tokens: number;
     };
 }
+/** Mention/load item types for dynamic capability/context activation */
+type LoadItemType = "tool" | "skill" | "subagent" | "context";
+type LoadItemAction = "load" | "unload";
+interface LoadItem {
+    type: LoadItemType;
+    id: string;
+    action?: LoadItemAction;
+}
 interface ChatStreamEvent {
     type: "start" | "text" | "thinking" | "tool_call" | "tool_args_chunk" | "tool_args" | "tool_result" | "done" | "error" | "interrupt" | "cancelled";
     /** Text content (for "text" and "thinking" events) */
@@ -289,7 +297,7 @@ interface ChatStreamEvent {
     interrupt_type?: HitlInterruptType;
     /** Interrupt payload (for "interrupt" event) - HITL */
     interrupt_payload?: HitlInterruptPayload;
-    /** Run ID (for "interrupt" event) - needed to send HITL response */
+    /** Run ID (for "start"/"interrupt"/"cancelled" events) */
     run_id?: string;
 }
 /**
@@ -741,9 +749,14 @@ declare class SanqianSDK {
     private sessionResources;
     private contextProviders;
     private runIdToMsgId;
-    private pendingStreamMsgId;
+    private pendingStreamRequests;
+    private pendingCancelMsgIds;
+    private static readonly VALID_SECURITY_LEVELS;
     private log;
     private warn;
+    private normalizeRequestedSecurityLevel;
+    private sendRunCancel;
+    private requestStreamCancel;
     constructor(config: SDKConfig);
     /**
      * Build WebSocket URL from connection info
@@ -824,11 +837,7 @@ declare class SanqianSDK {
         autoDiscoverSubagents?: boolean;
         persistHistory?: boolean;
         filePaths?: string[];
-        loadItems?: Array<{
-            type: string;
-            id: string;
-            action?: string;
-        }>;
+        loadItems?: LoadItem[];
         mentionedTools?: string[];
     }): Promise<ChatResponse>;
     chatStream(agentId: string, messages: ChatMessage[], options?: {
@@ -842,12 +851,9 @@ declare class SanqianSDK {
         attachedResources?: string[];
         sessionResources?: string[];
         filePaths?: string[];
-        loadItems?: Array<{
-            type: string;
-            id: string;
-            action?: string;
-        }>;
+        loadItems?: LoadItem[];
         mentionedTools?: string[];
+        signal?: AbortSignal;
     }): AsyncGenerator<ChatStreamEvent>;
     /**
      * Send HITL (Human-in-the-Loop) response to resume after interrupt
@@ -972,6 +978,7 @@ declare const SANQIAN_WEBSITE = "https://sanqian.io";
  * Error codes for SDK errors
  */
 declare enum SDKErrorCode {
+    INVALID_CONFIG = "INVALID_CONFIG",
     NOT_INSTALLED = "NOT_INSTALLED",
     NOT_RUNNING = "NOT_RUNNING",
     CONNECTION_TIMEOUT = "CONNECTION_TIMEOUT",
@@ -1024,4 +1031,4 @@ declare class SanqianSDKError extends Error {
  */
 declare function createSDKError(code: SDKErrorCode, details?: string): SanqianSDKError;
 
-export { type AgentCapability, type AgentConfig, type AgentInfo, type AgentUpdateConfig, type Capability, type CapabilitySearchResult, type CapabilityType, type ChatMessage, type ChatRequest, type ChatResponse, type ChatStreamEvent, type ConnectionInfo, type ConnectionState, type ContextData, type ContextListItem, type ContextProvider, Conversation, type ConversationDetail, type ConversationInfo, type ConversationMessage, type EmbeddingConfigResult, ErrorMessages, type HitlInterruptPayload, type HitlInterruptType, type HitlResponse, type HitlRiskLevel, type JSONSchema, type JSONSchemaProperty, type ListCapabilitiesOptions, type RemoteToolDefinition, type RerankConfigResult, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SessionResource, type SkillCapability, type StoredSessionResource, type ToolCall, type ToolCapability, type ToolDefinition, createSDKError };
+export { type AgentCapability, type AgentConfig, type AgentInfo, type AgentUpdateConfig, type Capability, type CapabilitySearchResult, type CapabilityType, type ChatMessage, type ChatRequest, type ChatResponse, type ChatStreamEvent, type ConnectionInfo, type ConnectionState, type ContextData, type ContextListItem, type ContextProvider, Conversation, type ConversationDetail, type ConversationInfo, type ConversationMessage, type EmbeddingConfigResult, ErrorMessages, type HitlInterruptPayload, type HitlInterruptType, type HitlResponse, type HitlRiskLevel, type JSONSchema, type JSONSchemaProperty, type ListCapabilitiesOptions, type LoadItem, type LoadItemAction, type LoadItemType, type RemoteToolDefinition, type RerankConfigResult, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SessionResource, type SkillCapability, type StoredSessionResource, type ToolCall, type ToolCapability, type ToolDefinition, createSDKError };

package/dist/index.browser.d.ts

@@ -261,6 +261,14 @@ interface ChatResponse {
         total_tokens: number;
     };
 }
+/** Mention/load item types for dynamic capability/context activation */
+type LoadItemType = "tool" | "skill" | "subagent" | "context";
+type LoadItemAction = "load" | "unload";
+interface LoadItem {
+    type: LoadItemType;
+    id: string;
+    action?: LoadItemAction;
+}
 interface ChatStreamEvent {
     type: "start" | "text" | "thinking" | "tool_call" | "tool_args_chunk" | "tool_args" | "tool_result" | "done" | "error" | "interrupt" | "cancelled";
     /** Text content (for "text" and "thinking" events) */
@@ -289,7 +297,7 @@ interface ChatStreamEvent {
     interrupt_type?: HitlInterruptType;
     /** Interrupt payload (for "interrupt" event) - HITL */
     interrupt_payload?: HitlInterruptPayload;
-    /** Run ID (for "interrupt" event) - needed to send HITL response */
+    /** Run ID (for "start"/"interrupt"/"cancelled" events) */
     run_id?: string;
 }
 /**
@@ -741,9 +749,14 @@ declare class SanqianSDK {
     private sessionResources;
     private contextProviders;
     private runIdToMsgId;
-    private pendingStreamMsgId;
+    private pendingStreamRequests;
+    private pendingCancelMsgIds;
+    private static readonly VALID_SECURITY_LEVELS;
     private log;
     private warn;
+    private normalizeRequestedSecurityLevel;
+    private sendRunCancel;
+    private requestStreamCancel;
     constructor(config: SDKConfig);
     /**
      * Build WebSocket URL from connection info
@@ -824,11 +837,7 @@ declare class SanqianSDK {
         autoDiscoverSubagents?: boolean;
         persistHistory?: boolean;
         filePaths?: string[];
-        loadItems?: Array<{
-            type: string;
-            id: string;
-            action?: string;
-        }>;
+        loadItems?: LoadItem[];
         mentionedTools?: string[];
     }): Promise<ChatResponse>;
     chatStream(agentId: string, messages: ChatMessage[], options?: {
@@ -842,12 +851,9 @@ declare class SanqianSDK {
         attachedResources?: string[];
         sessionResources?: string[];
         filePaths?: string[];
-        loadItems?: Array<{
-            type: string;
-            id: string;
-            action?: string;
-        }>;
+        loadItems?: LoadItem[];
         mentionedTools?: string[];
+        signal?: AbortSignal;
     }): AsyncGenerator<ChatStreamEvent>;
     /**
      * Send HITL (Human-in-the-Loop) response to resume after interrupt
@@ -972,6 +978,7 @@ declare const SANQIAN_WEBSITE = "https://sanqian.io";
  * Error codes for SDK errors
  */
 declare enum SDKErrorCode {
+    INVALID_CONFIG = "INVALID_CONFIG",
     NOT_INSTALLED = "NOT_INSTALLED",
     NOT_RUNNING = "NOT_RUNNING",
     CONNECTION_TIMEOUT = "CONNECTION_TIMEOUT",
@@ -1024,4 +1031,4 @@ declare class SanqianSDKError extends Error {
  */
 declare function createSDKError(code: SDKErrorCode, details?: string): SanqianSDKError;
 
-export { type AgentCapability, type AgentConfig, type AgentInfo, type AgentUpdateConfig, type Capability, type CapabilitySearchResult, type CapabilityType, type ChatMessage, type ChatRequest, type ChatResponse, type ChatStreamEvent, type ConnectionInfo, type ConnectionState, type ContextData, type ContextListItem, type ContextProvider, Conversation, type ConversationDetail, type ConversationInfo, type ConversationMessage, type EmbeddingConfigResult, ErrorMessages, type HitlInterruptPayload, type HitlInterruptType, type HitlResponse, type HitlRiskLevel, type JSONSchema, type JSONSchemaProperty, type ListCapabilitiesOptions, type RemoteToolDefinition, type RerankConfigResult, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SessionResource, type SkillCapability, type StoredSessionResource, type ToolCall, type ToolCapability, type ToolDefinition, createSDKError };
+export { type AgentCapability, type AgentConfig, type AgentInfo, type AgentUpdateConfig, type Capability, type CapabilitySearchResult, type CapabilityType, type ChatMessage, type ChatRequest, type ChatResponse, type ChatStreamEvent, type ConnectionInfo, type ConnectionState, type ContextData, type ContextListItem, type ContextProvider, Conversation, type ConversationDetail, type ConversationInfo, type ConversationMessage, type EmbeddingConfigResult, ErrorMessages, type HitlInterruptPayload, type HitlInterruptType, type HitlResponse, type HitlRiskLevel, type JSONSchema, type JSONSchemaProperty, type ListCapabilitiesOptions, type LoadItem, type LoadItemAction, type LoadItemType, type RemoteToolDefinition, type RerankConfigResult, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, SanqianSDK, SanqianSDKError, type SearchCapabilitiesOptions, type SessionResource, type SkillCapability, type StoredSessionResource, type ToolCall, type ToolCapability, type ToolDefinition, createSDKError };

package/dist/index.browser.js

@@ -33,6 +33,7 @@ module.exports = __toCommonJS(index_browser_exports);
 // src/errors.ts
 var SANQIAN_WEBSITE = "https://sanqian.io";
 var SDKErrorCode = /* @__PURE__ */ ((SDKErrorCode2) => {
+  SDKErrorCode2["INVALID_CONFIG"] = "INVALID_CONFIG";
   SDKErrorCode2["NOT_INSTALLED"] = "NOT_INSTALLED";
   SDKErrorCode2["NOT_RUNNING"] = "NOT_RUNNING";
   SDKErrorCode2["CONNECTION_TIMEOUT"] = "CONNECTION_TIMEOUT";
@@ -49,6 +50,14 @@ var SDKErrorCode = /* @__PURE__ */ ((SDKErrorCode2) => {
   return SDKErrorCode2;
 })(SDKErrorCode || {});
 var ErrorMessages = {
+  ["INVALID_CONFIG" /* INVALID_CONFIG */]: {
+    en: `SDK configuration is invalid.`,
+    zh: `SDK \u914D\u7F6E\u65E0\u6548\u3002`,
+    hint: {
+      en: `Please check required fields and option values in your SDK config.`,
+      zh: `\u8BF7\u68C0\u67E5 SDK \u914D\u7F6E\u4E2D\u7684\u5FC5\u586B\u5B57\u6BB5\u548C\u9009\u9879\u53D6\u503C\u3002`
+    }
+  },
   ["NOT_INSTALLED" /* NOT_INSTALLED */]: {
     en: `Sanqian is not installed on this computer.`,
     zh: `Sanqian \u5C1A\u672A\u5B89\u88C5\u5728\u6B64\u7535\u8111\u4E0A\u3002`,
@@ -229,8 +238,15 @@ var SanqianSDK = class _SanqianSDK {
   contextProviders = /* @__PURE__ */ new Map();
   // Map run_id -> msgId for routing backend messages to correct handler
   runIdToMsgId = /* @__PURE__ */ new Map();
-  // Track the most recent pending msgId (for start message routing)
-  pendingStreamMsgId = null;
+  // Queue pending stream requests for backend-native "start" routing (which has no msgId)
+  pendingStreamRequests = [];
+  // Streams requested to cancel before run_id is available
+  pendingCancelMsgIds = /* @__PURE__ */ new Set();
+  static VALID_SECURITY_LEVELS = /* @__PURE__ */ new Set([
+    "standard",
+    "elevated",
+    "unrestricted"
+  ]);
   // ============================================
   // Debug Logging
   // ============================================
@@ -244,6 +260,34 @@ var SanqianSDK = class _SanqianSDK {
       console.warn("[SDK]", ...args);
     }
   }
+  normalizeRequestedSecurityLevel(level) {
+    if (level === void 0 || level === null) {
+      return void 0;
+    }
+    if (typeof level === "string" && _SanqianSDK.VALID_SECURITY_LEVELS.has(level)) {
+      return level;
+    }
+    throw createSDKError(
+      "INVALID_CONFIG" /* INVALID_CONFIG */,
+      "requestedSecurityLevel must be one of: standard, elevated, unrestricted"
+    );
+  }
+  sendRunCancel(runId) {
+    const message = {
+      type: "cancel",
+      run_id: runId
+    };
+    this.send(message);
+    this.log(`Sent cancel for run ${runId}`);
+  }
+  requestStreamCancel(msgId, runId) {
+    if (runId) {
+      this.pendingCancelMsgIds.delete(msgId);
+      this.sendRunCancel(runId);
+      return;
+    }
+    this.pendingCancelMsgIds.add(msgId);
+  }
   constructor(config) {
     if (!config.connectionInfo) {
       throw new SanqianSDKError(
@@ -251,6 +295,9 @@ var SanqianSDK = class _SanqianSDK {
         "Browser build requires connectionInfo in config. Use the Node.js build for auto-discovery, or provide connectionInfo manually."
       );
     }
+    const requestedSecurityLevel = this.normalizeRequestedSecurityLevel(
+      config.requestedSecurityLevel
+    );
     this.config = {
       reconnectInterval: 5e3,
       heartbeatInterval: 3e4,
@@ -258,7 +305,8 @@ var SanqianSDK = class _SanqianSDK {
       debug: false,
       autoLaunchSanqian: false,
       // Not supported in browser
-      ...config
+      ...config,
+      requestedSecurityLevel
     };
     for (const tool of config.tools) {
       this.toolHandlers.set(tool.name, tool.handler);
@@ -537,18 +585,36 @@ var SanqianSDK = class _SanqianSDK {
       this.warn("Received start message without run_id");
       return;
     }
-    if (this.pendingStreamMsgId) {
-      this.runIdToMsgId.set(runId, this.pendingStreamMsgId);
-      const handler = this.streamHandlers.get(this.pendingStreamMsgId);
-      if (handler) {
-        handler.onEvent({
-          type: "start",
-          run_id: runId,
-          conversationId: message.payload?.session_id || ""
-        });
-      }
-    } else {
+    const sessionId = message.payload?.session_id;
+    let pendingIndex = -1;
+    if (sessionId) {
+      pendingIndex = this.pendingStreamRequests.findIndex((item) => item.conversationId === sessionId);
+    }
+    if (pendingIndex < 0) {
+      pendingIndex = 0;
+    }
+    const pending = this.pendingStreamRequests[pendingIndex];
+    if (!pending) {
       this.warn("Received start message but no pending stream handler");
+      return;
+    }
+    this.pendingStreamRequests.splice(pendingIndex, 1);
+    const pendingMsgId = pending.msgId;
+    this.runIdToMsgId.set(runId, pendingMsgId);
+    const handler = this.streamHandlers.get(pendingMsgId);
+    if (handler) {
+      handler.onEvent({
+        type: "start",
+        run_id: runId,
+        conversationId: message.payload?.session_id || ""
+      });
+    }
+    if (this.pendingCancelMsgIds.has(pendingMsgId)) {
+      try {
+        this.requestStreamCancel(pendingMsgId, runId);
+      } catch (e) {
+        this.warn("Failed to send queued cancel for run", runId, e);
+      }
     }
   }
   handleBackendStream(message) {
@@ -696,6 +762,14 @@ var SanqianSDK = class _SanqianSDK {
       pending.reject(createSDKError("DISCONNECTED" /* DISCONNECTED */));
     }
     this.pendingRequests.clear();
+    const disconnectError = createSDKError("DISCONNECTED" /* DISCONNECTED */, reason);
+    for (const [, handler] of this.streamHandlers) {
+      handler.onError(disconnectError);
+    }
+    this.streamHandlers.clear();
+    this.runIdToMsgId.clear();
+    this.pendingStreamRequests = [];
+    this.pendingCancelMsgIds.clear();
     if (reason === "Client disconnect") {
       this.log("Client disconnected intentionally, skipping auto-reconnect");
       return;
@@ -1144,9 +1218,39 @@ var SanqianSDK = class _SanqianSDK {
     let done = false;
     let error = null;
     let resolveNext = null;
+    let activeRunId;
+    if (options?.signal?.aborted) {
+      throw createSDKError(
+        "REQUEST_FAILED" /* REQUEST_FAILED */,
+        "Chat stream aborted before request was sent"
+      );
+    }
+    const handleAbort = () => {
+      try {
+        this.requestStreamCancel(msgId, activeRunId);
+      } catch (e) {
+        error = e instanceof Error ? e : new Error(String(e));
+        resolveNext?.();
+      }
+    };
+    options?.signal?.addEventListener("abort", handleAbort, { once: true });
     this.streamHandlers.set(msgId, {
       onEvent: (event) => {
         eventQueue.push(event);
+        if (event.type === "start") {
+          activeRunId = event.run_id;
+          this.pendingStreamRequests = this.pendingStreamRequests.filter((item) => item.msgId !== msgId);
+          if (this.pendingCancelMsgIds.has(msgId)) {
+            try {
+              this.requestStreamCancel(msgId, activeRunId);
+            } catch (e) {
+              error = e instanceof Error ? e : new Error(String(e));
+            }
+          }
+        }
+        if (event.type === "cancelled") {
+          done = true;
+        }
         resolveNext?.();
       },
       onDone: (response) => {
@@ -1164,7 +1268,10 @@ var SanqianSDK = class _SanqianSDK {
       }
     });
     try {
-      this.pendingStreamMsgId = msgId;
+      this.pendingStreamRequests.push({
+        msgId,
+        conversationId: options?.conversationId
+      });
       this.send(message);
       while (!done && !error) {
         if (eventQueue.length > 0) {
@@ -1183,12 +1290,13 @@ var SanqianSDK = class _SanqianSDK {
         throw error;
       }
     } finally {
+      options?.signal?.removeEventListener("abort", handleAbort);
       this.streamHandlers.delete(msgId);
-      this.pendingStreamMsgId = null;
+      this.pendingStreamRequests = this.pendingStreamRequests.filter((item) => item.msgId !== msgId);
+      this.pendingCancelMsgIds.delete(msgId);
       for (const [runId, id] of this.runIdToMsgId) {
         if (id === msgId) {
           this.runIdToMsgId.delete(runId);
-          break;
         }
       }
     }
@@ -1222,12 +1330,7 @@ var SanqianSDK = class _SanqianSDK {
     if (!this.state.connected) {
       throw createSDKError("DISCONNECTED" /* DISCONNECTED */, "Not connected to Sanqian");
     }
-    const message = {
-      type: "cancel",
-      run_id: runId
-    };
-    this.send(message);
-    this.log(`Sent cancel for run ${runId}`);
+    this.sendRunCancel(runId);
   }
   startConversation(agentId) {
     return new Conversation(this, agentId);