@yushaw/sanqian-sdk 0.2.1 → 0.2.2

package/dist/index.mjs

@@ -233,7 +233,7 @@ var DiscoveryManager = class {
           "/Contents/MacOS/Sanqian",
           ""
         );
-        spawn("open", ["-a", appPath, "--args", "--hidden"], {
+        spawn("open", ["-g", "-a", appPath, "--args", "--hidden"], {
           detached: true,
           stdio: "ignore"
         }).unref();
@@ -262,6 +262,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;
@@ -328,7 +494,7 @@ var SanqianSDK = class _SanqianSDK {
       console.log(`[SDK] Connecting to ${url}`);
       this.ws = new WebSocket(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 () => {
@@ -409,7 +575,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;
@@ -541,7 +707,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();
@@ -633,7 +799,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) => {
@@ -712,14 +878,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);
@@ -738,9 +902,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
@@ -786,7 +948,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;
@@ -827,7 +989,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);
     }
   }
   /**
@@ -849,7 +1011,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;
   }
@@ -894,7 +1056,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;
   }
@@ -911,7 +1073,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);
     }
   }
   // ============================================
@@ -949,7 +1111,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,
@@ -1097,7 +1263,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);
     });
   }
 };
@@ -1180,6 +1346,11 @@ var Conversation = class {
 export {
   Conversation,
   DiscoveryManager,
-  SanqianSDK
+  ErrorMessages,
+  SANQIAN_WEBSITE,
+  SDKErrorCode,
+  SanqianSDK,
+  SanqianSDKError,
+  createSDKError
 };
 //# sourceMappingURL=index.mjs.map