@yushaw/sanqian-sdk 0.2.1 → 0.2.3

package/dist/index.d.mts

@@ -526,4 +526,67 @@ declare class DiscoveryManager {
     isSanqianRunning(): boolean;
 }
 
-export { type AgentConfig, type AgentInfo, type AgentUpdateConfig, type ChatMessage, type ChatRequest, type ChatResponse, type ChatStreamEvent, type ConnectionInfo, type ConnectionState, Conversation, type ConversationDetail, type ConversationInfo, type ConversationMessage, DiscoveryManager, type JSONSchema, type JSONSchemaProperty, type RemoteToolDefinition, type SDKConfig, type SDKEventName, type SDKEvents, SanqianSDK, type ToolCall, type ToolDefinition };
+/**
+ * SDK Error Messages
+ *
+ * User-friendly error messages in English and Chinese.
+ * All errors guide users to sanqian.io for installation.
+ */
+declare const SANQIAN_WEBSITE = "https://sanqian.io";
+/**
+ * Error codes for SDK errors
+ */
+declare enum SDKErrorCode {
+    NOT_INSTALLED = "NOT_INSTALLED",
+    NOT_RUNNING = "NOT_RUNNING",
+    CONNECTION_TIMEOUT = "CONNECTION_TIMEOUT",
+    STARTUP_TIMEOUT = "STARTUP_TIMEOUT",
+    REGISTRATION_FAILED = "REGISTRATION_FAILED",
+    REQUEST_TIMEOUT = "REQUEST_TIMEOUT",
+    REQUEST_FAILED = "REQUEST_FAILED",
+    DISCONNECTED = "DISCONNECTED",
+    WEBSOCKET_ERROR = "WEBSOCKET_ERROR",
+    AGENT_NOT_FOUND = "AGENT_NOT_FOUND",
+    CONVERSATION_NOT_FOUND = "CONVERSATION_NOT_FOUND",
+    TOOL_NOT_FOUND = "TOOL_NOT_FOUND",
+    TOOL_EXECUTION_TIMEOUT = "TOOL_EXECUTION_TIMEOUT"
+}
+/**
+ * Bilingual error messages
+ */
+declare const ErrorMessages: Record<SDKErrorCode, {
+    en: string;
+    zh: string;
+    hint?: {
+        en: string;
+        zh: string;
+    };
+}>;
+/**
+ * Custom SDK Error with code and bilingual message
+ */
+declare class SanqianSDKError extends Error {
+    code: SDKErrorCode;
+    messageZh: string;
+    hint?: string;
+    hintZh?: string;
+    constructor(code: SDKErrorCode, details?: string);
+    /**
+     * Get full error message with hint (English)
+     */
+    getFullMessage(): string;
+    /**
+     * Get full error message with hint (Chinese)
+     */
+    getFullMessageZh(): string;
+    /**
+     * Get bilingual error message
+     */
+    getBilingualMessage(): string;
+}
+/**
+ * Create a user-friendly SDK error
+ */
+declare function createSDKError(code: SDKErrorCode, details?: string): SanqianSDKError;
+
+export { type AgentConfig, type AgentInfo, type AgentUpdateConfig, type ChatMessage, type ChatRequest, type ChatResponse, type ChatStreamEvent, type ConnectionInfo, type ConnectionState, Conversation, type ConversationDetail, type ConversationInfo, type ConversationMessage, DiscoveryManager, ErrorMessages, type JSONSchema, type JSONSchemaProperty, type RemoteToolDefinition, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, SanqianSDK, SanqianSDKError, type ToolCall, type ToolDefinition, createSDKError };

package/dist/index.d.ts

@@ -526,4 +526,67 @@ declare class DiscoveryManager {
     isSanqianRunning(): boolean;
 }
 
-export { type AgentConfig, type AgentInfo, type AgentUpdateConfig, type ChatMessage, type ChatRequest, type ChatResponse, type ChatStreamEvent, type ConnectionInfo, type ConnectionState, Conversation, type ConversationDetail, type ConversationInfo, type ConversationMessage, DiscoveryManager, type JSONSchema, type JSONSchemaProperty, type RemoteToolDefinition, type SDKConfig, type SDKEventName, type SDKEvents, SanqianSDK, type ToolCall, type ToolDefinition };
+/**
+ * SDK Error Messages
+ *
+ * User-friendly error messages in English and Chinese.
+ * All errors guide users to sanqian.io for installation.
+ */
+declare const SANQIAN_WEBSITE = "https://sanqian.io";
+/**
+ * Error codes for SDK errors
+ */
+declare enum SDKErrorCode {
+    NOT_INSTALLED = "NOT_INSTALLED",
+    NOT_RUNNING = "NOT_RUNNING",
+    CONNECTION_TIMEOUT = "CONNECTION_TIMEOUT",
+    STARTUP_TIMEOUT = "STARTUP_TIMEOUT",
+    REGISTRATION_FAILED = "REGISTRATION_FAILED",
+    REQUEST_TIMEOUT = "REQUEST_TIMEOUT",
+    REQUEST_FAILED = "REQUEST_FAILED",
+    DISCONNECTED = "DISCONNECTED",
+    WEBSOCKET_ERROR = "WEBSOCKET_ERROR",
+    AGENT_NOT_FOUND = "AGENT_NOT_FOUND",
+    CONVERSATION_NOT_FOUND = "CONVERSATION_NOT_FOUND",
+    TOOL_NOT_FOUND = "TOOL_NOT_FOUND",
+    TOOL_EXECUTION_TIMEOUT = "TOOL_EXECUTION_TIMEOUT"
+}
+/**
+ * Bilingual error messages
+ */
+declare const ErrorMessages: Record<SDKErrorCode, {
+    en: string;
+    zh: string;
+    hint?: {
+        en: string;
+        zh: string;
+    };
+}>;
+/**
+ * Custom SDK Error with code and bilingual message
+ */
+declare class SanqianSDKError extends Error {
+    code: SDKErrorCode;
+    messageZh: string;
+    hint?: string;
+    hintZh?: string;
+    constructor(code: SDKErrorCode, details?: string);
+    /**
+     * Get full error message with hint (English)
+     */
+    getFullMessage(): string;
+    /**
+     * Get full error message with hint (Chinese)
+     */
+    getFullMessageZh(): string;
+    /**
+     * Get bilingual error message
+     */
+    getBilingualMessage(): string;
+}
+/**
+ * Create a user-friendly SDK error
+ */
+declare function createSDKError(code: SDKErrorCode, details?: string): SanqianSDKError;
+
+export { type AgentConfig, type AgentInfo, type AgentUpdateConfig, type ChatMessage, type ChatRequest, type ChatResponse, type ChatStreamEvent, type ConnectionInfo, type ConnectionState, Conversation, type ConversationDetail, type ConversationInfo, type ConversationMessage, DiscoveryManager, ErrorMessages, type JSONSchema, type JSONSchemaProperty, type RemoteToolDefinition, SANQIAN_WEBSITE, type SDKConfig, SDKErrorCode, type SDKEventName, type SDKEvents, SanqianSDK, SanqianSDKError, type ToolCall, type ToolDefinition, createSDKError };

package/dist/index.js

@@ -32,7 +32,12 @@ var index_exports = {};
 __export(index_exports, {
   Conversation: () => Conversation,
   DiscoveryManager: () => DiscoveryManager,
-  SanqianSDK: () => SanqianSDK
+  ErrorMessages: () => ErrorMessages,
+  SANQIAN_WEBSITE: () => SANQIAN_WEBSITE,
+  SDKErrorCode: () => SDKErrorCode,
+  SanqianSDK: () => SanqianSDK,
+  SanqianSDKError: () => SanqianSDKError,
+  createSDKError: () => createSDKError
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -216,10 +221,12 @@ var DiscoveryManager = class {
       const programFilesX86 = process.env["PROGRAMFILES(X86)"] || "C:\\Program Files (x86)";
       const localAppData = process.env.LOCALAPPDATA || (0, import_path.join)((0, import_os.homedir)(), "AppData", "Local");
       searchPaths.push(
-        // Production: installed app
+        // Production: NSIS installer uses lowercase directory name from package.json "name"
+        (0, import_path.join)(localAppData, "Programs", "sanqian", "Sanqian.exe"),
+        // Legacy/alternative paths with uppercase
+        (0, import_path.join)(localAppData, "Programs", "Sanqian", "Sanqian.exe"),
         (0, import_path.join)(programFiles, "Sanqian", "Sanqian.exe"),
         (0, import_path.join)(programFilesX86, "Sanqian", "Sanqian.exe"),
-        (0, import_path.join)(localAppData, "Programs", "Sanqian", "Sanqian.exe"),
         // Development: electron-builder output
         (0, import_path.join)((0, import_os.homedir)(), "dev", "sanqian", "dist", "win-unpacked", "Sanqian.exe")
       );
@@ -271,7 +278,7 @@ var DiscoveryManager = class {
           "/Contents/MacOS/Sanqian",
           ""
         );
-        (0, import_child_process.spawn)("open", ["-a", appPath, "--args", "--hidden"], {
+        (0, import_child_process.spawn)("open", ["-g", "-a", appPath, "--args", "--hidden"], {
           detached: true,
           stdio: "ignore"
         }).unref();
@@ -300,6 +307,172 @@ var DiscoveryManager = class {
   }
 };
 
+// src/errors.ts
+var SANQIAN_WEBSITE = "https://sanqian.io";
+var SDKErrorCode = /* @__PURE__ */ ((SDKErrorCode2) => {
+  SDKErrorCode2["NOT_INSTALLED"] = "NOT_INSTALLED";
+  SDKErrorCode2["NOT_RUNNING"] = "NOT_RUNNING";
+  SDKErrorCode2["CONNECTION_TIMEOUT"] = "CONNECTION_TIMEOUT";
+  SDKErrorCode2["STARTUP_TIMEOUT"] = "STARTUP_TIMEOUT";
+  SDKErrorCode2["REGISTRATION_FAILED"] = "REGISTRATION_FAILED";
+  SDKErrorCode2["REQUEST_TIMEOUT"] = "REQUEST_TIMEOUT";
+  SDKErrorCode2["REQUEST_FAILED"] = "REQUEST_FAILED";
+  SDKErrorCode2["DISCONNECTED"] = "DISCONNECTED";
+  SDKErrorCode2["WEBSOCKET_ERROR"] = "WEBSOCKET_ERROR";
+  SDKErrorCode2["AGENT_NOT_FOUND"] = "AGENT_NOT_FOUND";
+  SDKErrorCode2["CONVERSATION_NOT_FOUND"] = "CONVERSATION_NOT_FOUND";
+  SDKErrorCode2["TOOL_NOT_FOUND"] = "TOOL_NOT_FOUND";
+  SDKErrorCode2["TOOL_EXECUTION_TIMEOUT"] = "TOOL_EXECUTION_TIMEOUT";
+  return SDKErrorCode2;
+})(SDKErrorCode || {});
+var ErrorMessages = {
+  ["NOT_INSTALLED" /* NOT_INSTALLED */]: {
+    en: `Sanqian is not installed on this computer.`,
+    zh: `Sanqian \u5C1A\u672A\u5B89\u88C5\u5728\u6B64\u7535\u8111\u4E0A\u3002`,
+    hint: {
+      en: `Please download and install Sanqian from ${SANQIAN_WEBSITE}`,
+      zh: `\u8BF7\u8BBF\u95EE ${SANQIAN_WEBSITE} \u4E0B\u8F7D\u5B89\u88C5 Sanqian`
+    }
+  },
+  ["NOT_RUNNING" /* NOT_RUNNING */]: {
+    en: `Sanqian is not running.`,
+    zh: `Sanqian \u672A\u5728\u8FD0\u884C\u3002`,
+    hint: {
+      en: `Please start Sanqian first, or enable autoLaunchSanqian option in SDK config.`,
+      zh: `\u8BF7\u5148\u542F\u52A8 Sanqian\uFF0C\u6216\u5728 SDK \u914D\u7F6E\u4E2D\u542F\u7528 autoLaunchSanqian \u9009\u9879\u3002`
+    }
+  },
+  ["CONNECTION_TIMEOUT" /* CONNECTION_TIMEOUT */]: {
+    en: `Failed to connect to Sanqian (connection timeout).`,
+    zh: `\u8FDE\u63A5 Sanqian \u5931\u8D25\uFF08\u8FDE\u63A5\u8D85\u65F6\uFF09\u3002`,
+    hint: {
+      en: `Please check if Sanqian is running properly. If the problem persists, try restarting Sanqian.`,
+      zh: `\u8BF7\u68C0\u67E5 Sanqian \u662F\u5426\u6B63\u5E38\u8FD0\u884C\u3002\u5982\u95EE\u9898\u6301\u7EED\uFF0C\u8BF7\u5C1D\u8BD5\u91CD\u542F Sanqian\u3002`
+    }
+  },
+  ["STARTUP_TIMEOUT" /* STARTUP_TIMEOUT */]: {
+    en: `Sanqian failed to start within 2 minutes.`,
+    zh: `Sanqian \u5728 2 \u5206\u949F\u5185\u672A\u80FD\u542F\u52A8\u3002`,
+    hint: {
+      en: `Please try starting Sanqian manually. If it fails to start, reinstall from ${SANQIAN_WEBSITE}`,
+      zh: `\u8BF7\u5C1D\u8BD5\u624B\u52A8\u542F\u52A8 Sanqian\u3002\u5982\u4ECD\u65E0\u6CD5\u542F\u52A8\uFF0C\u8BF7\u4ECE ${SANQIAN_WEBSITE} \u91CD\u65B0\u5B89\u88C5\u3002`
+    }
+  },
+  ["REGISTRATION_FAILED" /* REGISTRATION_FAILED */]: {
+    en: `Failed to register with Sanqian.`,
+    zh: `\u5411 Sanqian \u6CE8\u518C\u5931\u8D25\u3002`,
+    hint: {
+      en: `Please check your SDK configuration (appName, tools). If the problem persists, try restarting Sanqian.`,
+      zh: `\u8BF7\u68C0\u67E5 SDK \u914D\u7F6E\uFF08appName\u3001tools\uFF09\u3002\u5982\u95EE\u9898\u6301\u7EED\uFF0C\u8BF7\u5C1D\u8BD5\u91CD\u542F Sanqian\u3002`
+    }
+  },
+  ["REQUEST_TIMEOUT" /* REQUEST_TIMEOUT */]: {
+    en: `Request timed out.`,
+    zh: `\u8BF7\u6C42\u8D85\u65F6\u3002`,
+    hint: {
+      en: `The operation took too long. Please try again.`,
+      zh: `\u64CD\u4F5C\u8017\u65F6\u8FC7\u957F\uFF0C\u8BF7\u91CD\u8BD5\u3002`
+    }
+  },
+  ["REQUEST_FAILED" /* REQUEST_FAILED */]: {
+    en: `Request failed.`,
+    zh: `\u8BF7\u6C42\u5931\u8D25\u3002`,
+    hint: {
+      en: `Please check the error details and try again.`,
+      zh: `\u8BF7\u68C0\u67E5\u9519\u8BEF\u8BE6\u60C5\u540E\u91CD\u8BD5\u3002`
+    }
+  },
+  ["DISCONNECTED" /* DISCONNECTED */]: {
+    en: `Disconnected from Sanqian.`,
+    zh: `\u4E0E Sanqian \u7684\u8FDE\u63A5\u5DF2\u65AD\u5F00\u3002`,
+    hint: {
+      en: `The SDK will automatically reconnect. If problems persist, check if Sanqian is still running.`,
+      zh: `SDK \u4F1A\u81EA\u52A8\u91CD\u8FDE\u3002\u5982\u95EE\u9898\u6301\u7EED\uFF0C\u8BF7\u68C0\u67E5 Sanqian \u662F\u5426\u4ECD\u5728\u8FD0\u884C\u3002`
+    }
+  },
+  ["WEBSOCKET_ERROR" /* WEBSOCKET_ERROR */]: {
+    en: `WebSocket connection error.`,
+    zh: `WebSocket \u8FDE\u63A5\u9519\u8BEF\u3002`,
+    hint: {
+      en: `Please check your network and firewall settings. Sanqian uses local WebSocket on port shown in settings.`,
+      zh: `\u8BF7\u68C0\u67E5\u7F51\u7EDC\u548C\u9632\u706B\u5899\u8BBE\u7F6E\u3002Sanqian \u4F7F\u7528\u672C\u5730 WebSocket\uFF0C\u7AEF\u53E3\u53EF\u5728\u8BBE\u7F6E\u4E2D\u67E5\u770B\u3002`
+    }
+  },
+  ["AGENT_NOT_FOUND" /* AGENT_NOT_FOUND */]: {
+    en: `Agent not found.`,
+    zh: `\u627E\u4E0D\u5230\u8BE5 Agent\u3002`,
+    hint: {
+      en: `Please check the agent ID. Use listAgents() to see available agents.`,
+      zh: `\u8BF7\u68C0\u67E5 Agent ID\u3002\u4F7F\u7528 listAgents() \u67E5\u770B\u53EF\u7528\u7684 Agent\u3002`
+    }
+  },
+  ["CONVERSATION_NOT_FOUND" /* CONVERSATION_NOT_FOUND */]: {
+    en: `Conversation not found.`,
+    zh: `\u627E\u4E0D\u5230\u8BE5\u5BF9\u8BDD\u3002`,
+    hint: {
+      en: `The conversation may have been deleted. Start a new conversation with startConversation().`,
+      zh: `\u8BE5\u5BF9\u8BDD\u53EF\u80FD\u5DF2\u88AB\u5220\u9664\u3002\u4F7F\u7528 startConversation() \u5F00\u59CB\u65B0\u5BF9\u8BDD\u3002`
+    }
+  },
+  ["TOOL_NOT_FOUND" /* TOOL_NOT_FOUND */]: {
+    en: `Tool not found.`,
+    zh: `\u627E\u4E0D\u5230\u8BE5\u5DE5\u5177\u3002`,
+    hint: {
+      en: `Please check that the tool is registered in your SDK config.`,
+      zh: `\u8BF7\u68C0\u67E5\u8BE5\u5DE5\u5177\u662F\u5426\u5DF2\u5728 SDK \u914D\u7F6E\u4E2D\u6CE8\u518C\u3002`
+    }
+  },
+  ["TOOL_EXECUTION_TIMEOUT" /* TOOL_EXECUTION_TIMEOUT */]: {
+    en: `Tool execution timed out.`,
+    zh: `\u5DE5\u5177\u6267\u884C\u8D85\u65F6\u3002`,
+    hint: {
+      en: `The tool took too long to execute. Consider increasing toolExecutionTimeout in SDK config.`,
+      zh: `\u5DE5\u5177\u6267\u884C\u65F6\u95F4\u8FC7\u957F\u3002\u53EF\u5728 SDK \u914D\u7F6E\u4E2D\u589E\u52A0 toolExecutionTimeout\u3002`
+    }
+  }
+};
+var SanqianSDKError = class extends Error {
+  code;
+  messageZh;
+  hint;
+  hintZh;
+  constructor(code, details) {
+    const msg = ErrorMessages[code];
+    const fullMessage = details ? `${msg.en} ${details}` : msg.en;
+    super(fullMessage);
+    this.name = "SanqianSDKError";
+    this.code = code;
+    this.messageZh = details ? `${msg.zh} ${details}` : msg.zh;
+    this.hint = msg.hint?.en;
+    this.hintZh = msg.hint?.zh;
+  }
+  /**
+   * Get full error message with hint (English)
+   */
+  getFullMessage() {
+    return this.hint ? `${this.message}
+${this.hint}` : this.message;
+  }
+  /**
+   * Get full error message with hint (Chinese)
+   */
+  getFullMessageZh() {
+    return this.hintZh ? `${this.messageZh}
+${this.hintZh}` : this.messageZh;
+  }
+  /**
+   * Get bilingual error message
+   */
+  getBilingualMessage() {
+    return `${this.getFullMessage()}
+
+${this.getFullMessageZh()}`;
+  }
+};
+function createSDKError(code, details) {
+  return new SanqianSDKError(code, details);
+}
+
 // src/client.ts
 var SanqianSDK = class _SanqianSDK {
   config;
@@ -366,7 +539,7 @@ var SanqianSDK = class _SanqianSDK {
       console.log(`[SDK] Connecting to ${url}`);
       this.ws = new import_ws.default(url);
       const connectTimeout = setTimeout(() => {
-        reject(new Error("WebSocket connection timeout"));
+        reject(createSDKError("CONNECTION_TIMEOUT" /* CONNECTION_TIMEOUT */));
         this.ws?.close();
       }, 1e4);
       this.ws.on("open", async () => {
@@ -447,7 +620,7 @@ var SanqianSDK = class _SanqianSDK {
         1e4
       );
       if (!response.success) {
-        throw new Error(response.error || "Registration failed");
+        throw createSDKError("REGISTRATION_FAILED" /* REGISTRATION_FAILED */, response.error);
       }
       this.state.registering = false;
       this.state.registered = true;
@@ -579,7 +752,7 @@ var SanqianSDK = class _SanqianSDK {
     this.state.registered = false;
     this.emit("disconnected", reason);
     for (const [, pending] of this.pendingRequests) {
-      pending.reject(new Error("Disconnected"));
+      pending.reject(createSDKError("DISCONNECTED" /* DISCONNECTED */));
     }
     this.pendingRequests.clear();
     this.scheduleReconnect();
@@ -671,7 +844,7 @@ var SanqianSDK = class _SanqianSDK {
     return new Promise((resolve, reject) => {
       const timer = setTimeout(() => {
         this.pendingRequests.delete(id);
-        reject(new Error("Request timeout"));
+        reject(createSDKError("REQUEST_TIMEOUT" /* REQUEST_TIMEOUT */));
       }, timeout);
       this.pendingRequests.set(id, {
         resolve: (value) => {
@@ -750,14 +923,12 @@ var SanqianSDK = class _SanqianSDK {
         console.log("[SDK] Sanqian not running, attempting to launch...");
         const launched = this.discovery.launchSanqian(this.config.sanqianPath);
         if (!launched) {
-          throw new Error(
-            "Sanqian executable not found. Please ensure Sanqian is installed, or provide a custom path via sanqianPath config option."
-          );
+          throw createSDKError("NOT_INSTALLED" /* NOT_INSTALLED */);
         }
         console.log("[SDK] Sanqian launch initiated, waiting for startup...");
         info = await this.waitForSanqianStartup();
       } else {
-        throw new Error("Sanqian is not running. Please start it manually.");
+        throw createSDKError("NOT_RUNNING" /* NOT_RUNNING */);
       }
     }
     await this.connectWithInfo(info);
@@ -776,9 +947,7 @@ var SanqianSDK = class _SanqianSDK {
       }
       await new Promise((resolve) => setTimeout(resolve, pollInterval));
     }
-    throw new Error(
-      "Sanqian startup timeout (2 minutes). Please check if Sanqian started correctly."
-    );
+    throw createSDKError("STARTUP_TIMEOUT" /* STARTUP_TIMEOUT */);
   }
   /**
    * Update tool list dynamically
@@ -824,7 +993,7 @@ var SanqianSDK = class _SanqianSDK {
     };
     const response = await this.sendAndWait(message, msgId, 1e4);
     if (!response.success) {
-      throw new Error(response.error || "Failed to create agent");
+      throw createSDKError("AGENT_NOT_FOUND" /* AGENT_NOT_FOUND */, response.error);
     }
     if (response.agent) {
       return response.agent;
@@ -865,7 +1034,7 @@ var SanqianSDK = class _SanqianSDK {
     };
     const response = await this.sendAndWait(message, msgId, 1e4);
     if (!response.success) {
-      throw new Error(response.error || "Failed to delete agent");
+      throw createSDKError("AGENT_NOT_FOUND" /* AGENT_NOT_FOUND */, response.error);
     }
   }
   /**
@@ -887,7 +1056,7 @@ var SanqianSDK = class _SanqianSDK {
     };
     const response = await this.sendAndWait(message, msgId, 1e4);
     if (!response.success || !response.agent) {
-      throw new Error(response.error || "Failed to update agent");
+      throw createSDKError("AGENT_NOT_FOUND" /* AGENT_NOT_FOUND */, response.error);
     }
     return response.agent;
   }
@@ -932,7 +1101,7 @@ var SanqianSDK = class _SanqianSDK {
     };
     const response = await this.sendAndWait(message, msgId, 1e4);
     if (!response.success || !response.conversation) {
-      throw new Error(response.error || "Failed to get conversation");
+      throw createSDKError("CONVERSATION_NOT_FOUND" /* CONVERSATION_NOT_FOUND */, response.error);
     }
     return response.conversation;
   }
@@ -949,7 +1118,7 @@ var SanqianSDK = class _SanqianSDK {
     };
     const response = await this.sendAndWait(message, msgId, 1e4);
     if (!response.success) {
-      throw new Error(response.error || "Failed to delete conversation");
+      throw createSDKError("CONVERSATION_NOT_FOUND" /* CONVERSATION_NOT_FOUND */, response.error);
     }
   }
   // ============================================
@@ -987,7 +1156,11 @@ var SanqianSDK = class _SanqianSDK {
     };
     const response = await this.sendAndWait(message, msgId, 6e5);
     if (!response.success) {
-      throw new Error(response.error || "Chat request failed");
+      const errorLower = (response.error || "").toLowerCase();
+      if (errorLower.includes("agent") && errorLower.includes("not found")) {
+        throw createSDKError("AGENT_NOT_FOUND" /* AGENT_NOT_FOUND */, response.error);
+      }
+      throw createSDKError("REQUEST_FAILED" /* REQUEST_FAILED */, response.error);
     }
     return {
       message: response.message,
@@ -1135,7 +1308,7 @@ var SanqianSDK = class _SanqianSDK {
   }
   createTimeout(ms) {
     return new Promise((_, reject) => {
-      setTimeout(() => reject(new Error("Timeout")), ms);
+      setTimeout(() => reject(createSDKError("TOOL_EXECUTION_TIMEOUT" /* TOOL_EXECUTION_TIMEOUT */)), ms);
     });
   }
 };
@@ -1219,6 +1392,11 @@ var Conversation = class {
 0 && (module.exports = {
   Conversation,
   DiscoveryManager,
-  SanqianSDK
+  ErrorMessages,
+  SANQIAN_WEBSITE,
+  SDKErrorCode,
+  SanqianSDK,
+  SanqianSDKError,
+  createSDKError
 });
 //# sourceMappingURL=index.js.map