@yushaw/sanqian-chat 0.2.27 → 0.2.30

package/dist/core/index.d.mts

@@ -74,7 +74,8 @@ interface ChatUiConfigSerializable {
     /** Font size scale: small (13px), normal (14px), large (16px), extra-large (18px) */
     fontSize?: ChatFontSize;
     accentColor?: string;
-    locale?: Locale;
+    /** Supports Locale plus BCP-47 variants (e.g. zh-CN, en-US) */
+    locale?: Locale | string;
     strings?: Partial<ChatUiStrings>;
     alwaysOnTop?: boolean;
 }

package/dist/core/index.d.ts

@@ -74,7 +74,8 @@ interface ChatUiConfigSerializable {
     /** Font size scale: small (13px), normal (14px), large (16px), extra-large (18px) */
     fontSize?: ChatFontSize;
     accentColor?: string;
-    locale?: Locale;
+    /** Supports Locale plus BCP-47 variants (e.g. zh-CN, en-US) */
+    locale?: Locale | string;
     strings?: Partial<ChatUiStrings>;
     alwaysOnTop?: boolean;
 }

package/dist/main/index.d.mts

@@ -507,7 +507,8 @@ interface ChatUiConfigSerializable {
     /** Font size scale: small (13px), normal (14px), large (16px), extra-large (18px) */
     fontSize?: ChatFontSize;
     accentColor?: string;
-    locale?: Locale;
+    /** Supports Locale plus BCP-47 variants (e.g. zh-CN, en-US) */
+    locale?: Locale | string;
     strings?: Partial<ChatUiStrings>;
     alwaysOnTop?: boolean;
 }

package/dist/main/index.d.ts

@@ -507,7 +507,8 @@ interface ChatUiConfigSerializable {
     /** Font size scale: small (13px), normal (14px), large (16px), extra-large (18px) */
     fontSize?: ChatFontSize;
     accentColor?: string;
-    locale?: Locale;
+    /** Supports Locale plus BCP-47 variants (e.g. zh-CN, en-US) */
+    locale?: Locale | string;
     strings?: Partial<ChatUiStrings>;
     alwaysOnTop?: boolean;
 }

package/dist/main/index.js

@@ -390,6 +390,39 @@ function resolveHitlRunIdFromStreams(params, activeStreams) {
   const first = activeRunIds.values().next();
   return first.done ? null : first.value;
 }
+function resolveOwnedHitlRunIdFromStreams(params, activeStreams, senderWebContentsId) {
+  if (params.streamId) {
+    const stream = activeStreams.get(params.streamId);
+    if (!stream || stream.cancelled) {
+      return null;
+    }
+    if (stream.ownerWebContentsId !== senderWebContentsId) {
+      return null;
+    }
+    return stream.runId ?? null;
+  }
+  if (params.runId) {
+    for (const stream of activeStreams.values()) {
+      if (stream.cancelled || !stream.runId) continue;
+      if (stream.ownerWebContentsId !== senderWebContentsId) continue;
+      if (stream.runId === params.runId) {
+        return params.runId;
+      }
+    }
+    return null;
+  }
+  const activeRunIds = /* @__PURE__ */ new Set();
+  for (const stream of activeStreams.values()) {
+    if (stream.cancelled || !stream.runId) continue;
+    if (stream.ownerWebContentsId !== senderWebContentsId) continue;
+    activeRunIds.add(stream.runId);
+    if (activeRunIds.size > 1) {
+      return null;
+    }
+  }
+  const first = activeRunIds.values().next();
+  return first.done ? null : first.value;
+}
 
 // src/main/FloatingWindow.ts
 var ipcHandlersRegistered = false;
@@ -425,7 +458,10 @@ var FloatingWindow = class _FloatingWindow {
       import_electron.app.whenReady().then(() => this.registerShortcut());
     }
   }
-  resolveHitlRunId(params) {
+  resolveHitlRunId(params, senderWebContentsId) {
+    if (typeof senderWebContentsId === "number") {
+      return resolveOwnedHitlRunIdFromStreams(params, this.activeStreams, senderWebContentsId);
+    }
     return resolveHitlRunIdFromStreams(params, this.activeStreams);
   }
   /**
@@ -668,7 +704,13 @@ var FloatingWindow = class _FloatingWindow {
         webContents.send("sanqian-chat:streamEvent", { streamId, event: { type: "error", error: "SDK or agent not ready" } });
         return;
       }
-      const streamState = { cancelled: false, runId: null, cancelSignalSent: false };
+      const streamState = {
+        cancelled: false,
+        runId: null,
+        cancelSignalSent: false,
+        pendingHitlResponse: null,
+        ownerWebContentsId: webContents.id
+      };
       activeInstance?.activeStreams.set(streamId, streamState);
       try {
         await sdk.ensureReady();
@@ -683,6 +725,14 @@ var FloatingWindow = class _FloatingWindow {
           if (evtWithRunId.run_id && !streamState.runId) {
             streamState.runId = evtWithRunId.run_id;
           }
+          if (streamState.pendingHitlResponse && streamState.runId) {
+            try {
+              sdk.sendHitlResponse(streamState.runId, streamState.pendingHitlResponse);
+              streamState.pendingHitlResponse = null;
+            } catch (e) {
+              console.warn("[FloatingWindow] Failed to flush queued HITL response:", e);
+            }
+          }
           if (streamState.cancelled && streamState.runId && !streamState.cancelSignalSent) {
             try {
               sdk.cancelRun(streamState.runId);
@@ -744,31 +794,50 @@ var FloatingWindow = class _FloatingWindow {
         activeInstance?.activeStreams.delete(streamId);
       }
     });
-    import_electron.ipcMain.handle("sanqian-chat:cancelStream", (_, params) => {
+    import_electron.ipcMain.handle("sanqian-chat:cancelStream", (event, params) => {
       const stream = activeInstance?.activeStreams.get(params.streamId);
-      if (stream) {
-        stream.cancelled = true;
-        if (stream.runId && !stream.cancelSignalSent) {
-          const sdk = activeInstance ? _FloatingWindow.getSdkFromOptions(activeInstance.options) : null;
-          if (sdk) {
-            try {
-              sdk.cancelRun(stream.runId);
-              stream.cancelSignalSent = true;
-            } catch (e) {
-              console.warn("[FloatingWindow] Failed to cancel run:", e);
-            }
+      if (!stream) {
+        return { success: false, error: "stream_not_found" };
+      }
+      if (stream.ownerWebContentsId !== event.sender.id) {
+        console.warn("[FloatingWindow] Rejecting cancelStream from non-owner sender");
+        return { success: false, error: "stream_not_owned_by_sender" };
+      }
+      stream.cancelled = true;
+      if (stream.runId && !stream.cancelSignalSent) {
+        const sdk = activeInstance ? _FloatingWindow.getSdkFromOptions(activeInstance.options) : null;
+        if (sdk) {
+          try {
+            sdk.cancelRun(stream.runId);
+            stream.cancelSignalSent = true;
+          } catch (e) {
+            console.warn("[FloatingWindow] Failed to cancel run:", e);
           }
         }
       }
       return { success: true };
     });
-    import_electron.ipcMain.handle("sanqian-chat:hitlResponse", (_, params) => {
+    import_electron.ipcMain.handle("sanqian-chat:hitlResponse", (event, params) => {
       const sdk = activeInstance ? _FloatingWindow.getSdkFromOptions(activeInstance.options) : null;
-      const runId = activeInstance?.resolveHitlRunId({ runId: params.runId, streamId: params.streamId }) ?? null;
+      const senderWebContentsId = event.sender.id;
+      const runId = activeInstance?.resolveHitlRunId(
+        { runId: params.runId, streamId: params.streamId },
+        senderWebContentsId
+      ) ?? null;
       if (sdk && runId) {
         sdk.sendHitlResponse(runId, params.response);
+      } else if (params.streamId) {
+        const stream = activeInstance?.activeStreams.get(params.streamId);
+        if (stream && !stream.cancelled && stream.ownerWebContentsId === senderWebContentsId) {
+          stream.pendingHitlResponse = params.response;
+          if (activeInstance?.options.devMode) {
+            console.warn("[FloatingWindow] Queued HITL response while waiting for runId");
+          }
+        } else {
+          console.warn("[FloatingWindow] HITL response dropped: stream not found/cancelled/not-owned");
+        }
       } else if (activeInstance?.options.devMode) {
-        console.warn("[FloatingWindow] HITL response dropped: missing runId");
+        console.warn("[FloatingWindow] HITL response dropped: missing or unauthorized runId");
       }
       return { success: true };
     });
@@ -1721,7 +1790,10 @@ var ChatPanel = class {
    * Resolve HITL runId with deterministic binding for concurrent streams.
    * Priority: explicit runId -> streamId-bound runId -> single active stream fallback.
    */
-  resolveHitlRunId(params) {
+  resolveHitlRunId(params, senderWebContentsId) {
+    if (typeof senderWebContentsId === "number") {
+      return resolveOwnedHitlRunIdFromStreams(params, this.activeStreams, senderWebContentsId);
+    }
     return resolveHitlRunIdFromStreams(params, this.activeStreams);
   }
   /**
@@ -1785,7 +1857,13 @@ var ChatPanel = class {
         webContents.send("sanqian-chat:streamEvent", { streamId, event: { type: "error", error: "SDK or agent not ready" } });
         return;
       }
-      const streamState = { cancelled: false, runId: null, cancelSignalSent: false };
+      const streamState = {
+        cancelled: false,
+        runId: null,
+        cancelSignalSent: false,
+        pendingHitlResponse: null,
+        ownerWebContentsId: webContents.id
+      };
       activeInstance2?.activeStreams.set(streamId, streamState);
       try {
         await sdk.ensureReady();
@@ -1805,6 +1883,14 @@ var ChatPanel = class {
           if (evtWithRunId.run_id && !streamState.runId) {
             streamState.runId = evtWithRunId.run_id;
           }
+          if (streamState.pendingHitlResponse && streamState.runId) {
+            try {
+              sdk.sendHitlResponse(streamState.runId, streamState.pendingHitlResponse);
+              streamState.pendingHitlResponse = null;
+            } catch (e) {
+              console.warn("[ChatPanel] Failed to flush queued HITL response:", e);
+            }
+          }
           if (streamState.cancelled && streamState.runId && !streamState.cancelSignalSent) {
             try {
               sdk.cancelRun(streamState.runId);
@@ -1866,31 +1952,50 @@ var ChatPanel = class {
         activeInstance2?.activeStreams.delete(streamId);
       }
     });
-    import_electron2.ipcMain.handle("sanqian-chat:cancelStream", (_, params) => {
+    import_electron2.ipcMain.handle("sanqian-chat:cancelStream", (event, params) => {
       const stream = activeInstance2?.activeStreams.get(params.streamId);
-      if (stream) {
-        stream.cancelled = true;
-        if (stream.runId && !stream.cancelSignalSent) {
-          const sdk = activeInstance2?.getSdk();
-          if (sdk) {
-            try {
-              sdk.cancelRun(stream.runId);
-              stream.cancelSignalSent = true;
-            } catch (e) {
-              console.warn("[ChatPanel] Failed to cancel run:", e);
-            }
+      if (!stream) {
+        return { success: false, error: "stream_not_found" };
+      }
+      if (stream.ownerWebContentsId !== event.sender.id) {
+        console.warn("[ChatPanel] Rejecting cancelStream from non-owner sender");
+        return { success: false, error: "stream_not_owned_by_sender" };
+      }
+      stream.cancelled = true;
+      if (stream.runId && !stream.cancelSignalSent) {
+        const sdk = activeInstance2?.getSdk();
+        if (sdk) {
+          try {
+            sdk.cancelRun(stream.runId);
+            stream.cancelSignalSent = true;
+          } catch (e) {
+            console.warn("[ChatPanel] Failed to cancel run:", e);
           }
         }
       }
       return { success: true };
     });
-    import_electron2.ipcMain.handle("sanqian-chat:hitlResponse", (_, params) => {
+    import_electron2.ipcMain.handle("sanqian-chat:hitlResponse", (event, params) => {
       const sdk = activeInstance2?.getSdk();
-      const runId = activeInstance2?.resolveHitlRunId({ runId: params.runId, streamId: params.streamId }) ?? null;
+      const senderWebContentsId = event.sender.id;
+      const runId = activeInstance2?.resolveHitlRunId(
+        { runId: params.runId, streamId: params.streamId },
+        senderWebContentsId
+      ) ?? null;
       if (sdk && runId) {
         sdk.sendHitlResponse(runId, params.response);
+      } else if (params.streamId) {
+        const stream = activeInstance2?.activeStreams.get(params.streamId);
+        if (stream && !stream.cancelled && stream.ownerWebContentsId === senderWebContentsId) {
+          stream.pendingHitlResponse = params.response;
+          if (activeInstance2?.config.devMode) {
+            console.warn("[ChatPanel] Queued HITL response while waiting for runId");
+          }
+        } else {
+          console.warn("[ChatPanel] HITL response dropped: stream not found/cancelled/not-owned");
+        }
       } else if (activeInstance2?.config.devMode) {
-        console.warn("[ChatPanel] HITL response dropped: missing runId");
+        console.warn("[ChatPanel] HITL response dropped: missing or unauthorized runId");
       }
       return { success: true };
     });

package/dist/main/index.mjs

@@ -359,6 +359,39 @@ function resolveHitlRunIdFromStreams(params, activeStreams) {
   const first = activeRunIds.values().next();
   return first.done ? null : first.value;
 }
+function resolveOwnedHitlRunIdFromStreams(params, activeStreams, senderWebContentsId) {
+  if (params.streamId) {
+    const stream = activeStreams.get(params.streamId);
+    if (!stream || stream.cancelled) {
+      return null;
+    }
+    if (stream.ownerWebContentsId !== senderWebContentsId) {
+      return null;
+    }
+    return stream.runId ?? null;
+  }
+  if (params.runId) {
+    for (const stream of activeStreams.values()) {
+      if (stream.cancelled || !stream.runId) continue;
+      if (stream.ownerWebContentsId !== senderWebContentsId) continue;
+      if (stream.runId === params.runId) {
+        return params.runId;
+      }
+    }
+    return null;
+  }
+  const activeRunIds = /* @__PURE__ */ new Set();
+  for (const stream of activeStreams.values()) {
+    if (stream.cancelled || !stream.runId) continue;
+    if (stream.ownerWebContentsId !== senderWebContentsId) continue;
+    activeRunIds.add(stream.runId);
+    if (activeRunIds.size > 1) {
+      return null;
+    }
+  }
+  const first = activeRunIds.values().next();
+  return first.done ? null : first.value;
+}
 
 // src/main/FloatingWindow.ts
 var ipcHandlersRegistered = false;
@@ -394,7 +427,10 @@ var FloatingWindow = class _FloatingWindow {
       app.whenReady().then(() => this.registerShortcut());
     }
   }
-  resolveHitlRunId(params) {
+  resolveHitlRunId(params, senderWebContentsId) {
+    if (typeof senderWebContentsId === "number") {
+      return resolveOwnedHitlRunIdFromStreams(params, this.activeStreams, senderWebContentsId);
+    }
     return resolveHitlRunIdFromStreams(params, this.activeStreams);
   }
   /**
@@ -637,7 +673,13 @@ var FloatingWindow = class _FloatingWindow {
         webContents.send("sanqian-chat:streamEvent", { streamId, event: { type: "error", error: "SDK or agent not ready" } });
         return;
       }
-      const streamState = { cancelled: false, runId: null, cancelSignalSent: false };
+      const streamState = {
+        cancelled: false,
+        runId: null,
+        cancelSignalSent: false,
+        pendingHitlResponse: null,
+        ownerWebContentsId: webContents.id
+      };
       activeInstance?.activeStreams.set(streamId, streamState);
       try {
         await sdk.ensureReady();
@@ -652,6 +694,14 @@ var FloatingWindow = class _FloatingWindow {
           if (evtWithRunId.run_id && !streamState.runId) {
             streamState.runId = evtWithRunId.run_id;
           }
+          if (streamState.pendingHitlResponse && streamState.runId) {
+            try {
+              sdk.sendHitlResponse(streamState.runId, streamState.pendingHitlResponse);
+              streamState.pendingHitlResponse = null;
+            } catch (e) {
+              console.warn("[FloatingWindow] Failed to flush queued HITL response:", e);
+            }
+          }
           if (streamState.cancelled && streamState.runId && !streamState.cancelSignalSent) {
             try {
               sdk.cancelRun(streamState.runId);
@@ -713,31 +763,50 @@ var FloatingWindow = class _FloatingWindow {
         activeInstance?.activeStreams.delete(streamId);
       }
     });
-    ipcMain.handle("sanqian-chat:cancelStream", (_, params) => {
+    ipcMain.handle("sanqian-chat:cancelStream", (event, params) => {
       const stream = activeInstance?.activeStreams.get(params.streamId);
-      if (stream) {
-        stream.cancelled = true;
-        if (stream.runId && !stream.cancelSignalSent) {
-          const sdk = activeInstance ? _FloatingWindow.getSdkFromOptions(activeInstance.options) : null;
-          if (sdk) {
-            try {
-              sdk.cancelRun(stream.runId);
-              stream.cancelSignalSent = true;
-            } catch (e) {
-              console.warn("[FloatingWindow] Failed to cancel run:", e);
-            }
+      if (!stream) {
+        return { success: false, error: "stream_not_found" };
+      }
+      if (stream.ownerWebContentsId !== event.sender.id) {
+        console.warn("[FloatingWindow] Rejecting cancelStream from non-owner sender");
+        return { success: false, error: "stream_not_owned_by_sender" };
+      }
+      stream.cancelled = true;
+      if (stream.runId && !stream.cancelSignalSent) {
+        const sdk = activeInstance ? _FloatingWindow.getSdkFromOptions(activeInstance.options) : null;
+        if (sdk) {
+          try {
+            sdk.cancelRun(stream.runId);
+            stream.cancelSignalSent = true;
+          } catch (e) {
+            console.warn("[FloatingWindow] Failed to cancel run:", e);
           }
         }
       }
       return { success: true };
     });
-    ipcMain.handle("sanqian-chat:hitlResponse", (_, params) => {
+    ipcMain.handle("sanqian-chat:hitlResponse", (event, params) => {
       const sdk = activeInstance ? _FloatingWindow.getSdkFromOptions(activeInstance.options) : null;
-      const runId = activeInstance?.resolveHitlRunId({ runId: params.runId, streamId: params.streamId }) ?? null;
+      const senderWebContentsId = event.sender.id;
+      const runId = activeInstance?.resolveHitlRunId(
+        { runId: params.runId, streamId: params.streamId },
+        senderWebContentsId
+      ) ?? null;
       if (sdk && runId) {
         sdk.sendHitlResponse(runId, params.response);
+      } else if (params.streamId) {
+        const stream = activeInstance?.activeStreams.get(params.streamId);
+        if (stream && !stream.cancelled && stream.ownerWebContentsId === senderWebContentsId) {
+          stream.pendingHitlResponse = params.response;
+          if (activeInstance?.options.devMode) {
+            console.warn("[FloatingWindow] Queued HITL response while waiting for runId");
+          }
+        } else {
+          console.warn("[FloatingWindow] HITL response dropped: stream not found/cancelled/not-owned");
+        }
       } else if (activeInstance?.options.devMode) {
-        console.warn("[FloatingWindow] HITL response dropped: missing runId");
+        console.warn("[FloatingWindow] HITL response dropped: missing or unauthorized runId");
       }
       return { success: true };
     });
@@ -1696,7 +1765,10 @@ var ChatPanel = class {
    * Resolve HITL runId with deterministic binding for concurrent streams.
    * Priority: explicit runId -> streamId-bound runId -> single active stream fallback.
    */
-  resolveHitlRunId(params) {
+  resolveHitlRunId(params, senderWebContentsId) {
+    if (typeof senderWebContentsId === "number") {
+      return resolveOwnedHitlRunIdFromStreams(params, this.activeStreams, senderWebContentsId);
+    }
     return resolveHitlRunIdFromStreams(params, this.activeStreams);
   }
   /**
@@ -1760,7 +1832,13 @@ var ChatPanel = class {
         webContents.send("sanqian-chat:streamEvent", { streamId, event: { type: "error", error: "SDK or agent not ready" } });
         return;
       }
-      const streamState = { cancelled: false, runId: null, cancelSignalSent: false };
+      const streamState = {
+        cancelled: false,
+        runId: null,
+        cancelSignalSent: false,
+        pendingHitlResponse: null,
+        ownerWebContentsId: webContents.id
+      };
       activeInstance2?.activeStreams.set(streamId, streamState);
       try {
         await sdk.ensureReady();
@@ -1780,6 +1858,14 @@ var ChatPanel = class {
           if (evtWithRunId.run_id && !streamState.runId) {
             streamState.runId = evtWithRunId.run_id;
           }
+          if (streamState.pendingHitlResponse && streamState.runId) {
+            try {
+              sdk.sendHitlResponse(streamState.runId, streamState.pendingHitlResponse);
+              streamState.pendingHitlResponse = null;
+            } catch (e) {
+              console.warn("[ChatPanel] Failed to flush queued HITL response:", e);
+            }
+          }
           if (streamState.cancelled && streamState.runId && !streamState.cancelSignalSent) {
             try {
               sdk.cancelRun(streamState.runId);
@@ -1841,31 +1927,50 @@ var ChatPanel = class {
         activeInstance2?.activeStreams.delete(streamId);
       }
     });
-    ipcMain2.handle("sanqian-chat:cancelStream", (_, params) => {
+    ipcMain2.handle("sanqian-chat:cancelStream", (event, params) => {
       const stream = activeInstance2?.activeStreams.get(params.streamId);
-      if (stream) {
-        stream.cancelled = true;
-        if (stream.runId && !stream.cancelSignalSent) {
-          const sdk = activeInstance2?.getSdk();
-          if (sdk) {
-            try {
-              sdk.cancelRun(stream.runId);
-              stream.cancelSignalSent = true;
-            } catch (e) {
-              console.warn("[ChatPanel] Failed to cancel run:", e);
-            }
+      if (!stream) {
+        return { success: false, error: "stream_not_found" };
+      }
+      if (stream.ownerWebContentsId !== event.sender.id) {
+        console.warn("[ChatPanel] Rejecting cancelStream from non-owner sender");
+        return { success: false, error: "stream_not_owned_by_sender" };
+      }
+      stream.cancelled = true;
+      if (stream.runId && !stream.cancelSignalSent) {
+        const sdk = activeInstance2?.getSdk();
+        if (sdk) {
+          try {
+            sdk.cancelRun(stream.runId);
+            stream.cancelSignalSent = true;
+          } catch (e) {
+            console.warn("[ChatPanel] Failed to cancel run:", e);
           }
         }
       }
       return { success: true };
     });
-    ipcMain2.handle("sanqian-chat:hitlResponse", (_, params) => {
+    ipcMain2.handle("sanqian-chat:hitlResponse", (event, params) => {
       const sdk = activeInstance2?.getSdk();
-      const runId = activeInstance2?.resolveHitlRunId({ runId: params.runId, streamId: params.streamId }) ?? null;
+      const senderWebContentsId = event.sender.id;
+      const runId = activeInstance2?.resolveHitlRunId(
+        { runId: params.runId, streamId: params.streamId },
+        senderWebContentsId
+      ) ?? null;
       if (sdk && runId) {
         sdk.sendHitlResponse(runId, params.response);
+      } else if (params.streamId) {
+        const stream = activeInstance2?.activeStreams.get(params.streamId);
+        if (stream && !stream.cancelled && stream.ownerWebContentsId === senderWebContentsId) {
+          stream.pendingHitlResponse = params.response;
+          if (activeInstance2?.config.devMode) {
+            console.warn("[ChatPanel] Queued HITL response while waiting for runId");
+          }
+        } else {
+          console.warn("[ChatPanel] HITL response dropped: stream not found/cancelled/not-owned");
+        }
       } else if (activeInstance2?.config.devMode) {
-        console.warn("[ChatPanel] HITL response dropped: missing runId");
+        console.warn("[ChatPanel] HITL response dropped: missing or unauthorized runId");
       }
       return { success: true };
     });

package/dist/preload/factories.d.mts

@@ -72,7 +72,8 @@ interface ChatUiConfigSerializable {
     /** Font size scale: small (13px), normal (14px), large (16px), extra-large (18px) */
     fontSize?: ChatFontSize;
     accentColor?: string;
-    locale?: Locale;
+    /** Supports Locale plus BCP-47 variants (e.g. zh-CN, en-US) */
+    locale?: Locale | string;
     strings?: Partial<ChatUiStrings>;
     alwaysOnTop?: boolean;
 }

package/dist/preload/factories.d.ts

@@ -72,7 +72,8 @@ interface ChatUiConfigSerializable {
     /** Font size scale: small (13px), normal (14px), large (16px), extra-large (18px) */
     fontSize?: ChatFontSize;
     accentColor?: string;
-    locale?: Locale;
+    /** Supports Locale plus BCP-47 variants (e.g. zh-CN, en-US) */
+    locale?: Locale | string;
     strings?: Partial<ChatUiStrings>;
     alwaysOnTop?: boolean;
 }

package/dist/renderer/index.d.mts

@@ -77,7 +77,8 @@ interface ChatUiConfigSerializable {
     /** Font size scale: small (13px), normal (14px), large (16px), extra-large (18px) */
     fontSize?: ChatFontSize;
     accentColor?: string;
-    locale?: Locale;
+    /** Supports Locale plus BCP-47 variants (e.g. zh-CN, en-US) */
+    locale?: Locale | string;
     strings?: Partial<ChatUiStrings>;
     alwaysOnTop?: boolean;
 }
@@ -1231,7 +1232,7 @@ interface HistoryModalProps {
 }
 declare const HistoryModal: react.NamedExoticComponent<HistoryModalProps>;
 
-declare function resolveChatStrings(locale?: Locale, overrides?: Partial<ChatUiStrings>): ChatUiStrings;
+declare function resolveChatStrings(locale?: Locale | string, overrides?: Partial<ChatUiStrings>): ChatUiStrings;
 
 type AlertType = 'warning' | 'error';
 interface AlertAction {

package/dist/renderer/index.d.ts

@@ -77,7 +77,8 @@ interface ChatUiConfigSerializable {
     /** Font size scale: small (13px), normal (14px), large (16px), extra-large (18px) */
     fontSize?: ChatFontSize;
     accentColor?: string;
-    locale?: Locale;
+    /** Supports Locale plus BCP-47 variants (e.g. zh-CN, en-US) */
+    locale?: Locale | string;
     strings?: Partial<ChatUiStrings>;
     alwaysOnTop?: boolean;
 }
@@ -1231,7 +1232,7 @@ interface HistoryModalProps {
 }
 declare const HistoryModal: react.NamedExoticComponent<HistoryModalProps>;
 
-declare function resolveChatStrings(locale?: Locale, overrides?: Partial<ChatUiStrings>): ChatUiStrings;
+declare function resolveChatStrings(locale?: Locale | string, overrides?: Partial<ChatUiStrings>): ChatUiStrings;
 
 type AlertType = 'warning' | 'error';
 interface AlertAction {