chatablex-web-sdk 1.0.32 → 1.0.36

package/dist/index.d.mts

@@ -127,6 +127,8 @@ interface ChatableXInitConfig {
      * calls reject with a clear error.
      */
     apiBaseUrl?: string;
+    /** Agent lock configuration — blocks user input during tool execution. */
+    agentLock?: AgentLockConfig;
 }
 interface ChatableXAI {
     chat(message: string, options?: ChatOptions): Promise<ChatResponse>;
@@ -261,6 +263,55 @@ interface ChatableXCloud {
     /** Read the account's storage usage / quota. */
     usage(): Promise<CloudUsage>;
 }
+interface AgentLockConfig {
+    /** Enable the agent lock feature (default: true). */
+    enabled?: boolean;
+    /**
+     * `"overlay"` — SDK renders a built-in transparent overlay (default).
+     * `"events-only"` — SDK only emits lock/unlock events; no overlay injected.
+     */
+    mode?: 'overlay' | 'events-only';
+    /** URL of the logo displayed in the overlay centre. Defaults to built-in Chatablex SVG. */
+    logoUrl?: string;
+    /** Message shown below the logo (default: "Agent 正在操作，请稍候…"). */
+    message?: string;
+    /** Show a cancel button on the overlay (default: true). */
+    allowCancel?: boolean;
+    /** Overlay background opacity, 0–1 (default: 0.3). */
+    opacity?: number;
+    /** Auto-unlock timeout for a single tool execution, in ms (default: 30000). 0 disables. */
+    timeout?: number;
+    /**
+     * Safety auto-unlock timeout for a whole agent turn, in ms (default: 0 =
+     * disabled, rely on the host's turn-end signal). When the host drives a
+     * turn-level lock (the lock spans the entire agent response, not just one
+     * tool), this acts purely as a fallback in case the turn-end signal is lost.
+     */
+    turnTimeout?: number;
+    /** Delay before actually removing the overlay after unlock, to avoid flicker between consecutive tools (default: 200ms). */
+    debounceUnlock?: number;
+}
+type AgentLockEventType = 'lock' | 'unlock' | 'cancel' | 'timeout';
+interface AgentLockEventData {
+    requestId?: string;
+    timestamp: number;
+}
+type AgentLockEventHandler = (data: AgentLockEventData) => void;
+interface ChatableXAgentLock {
+    /** Manually lock user interaction with an optional custom message / timeout. */
+    lock(opts?: {
+        message?: string;
+        timeout?: number;
+    }): void;
+    /** Manually unlock. Safe to call when already unlocked. */
+    unlock(): void;
+    /** Whether the overlay is currently active. */
+    isLocked(): boolean;
+    /** Subscribe to lock lifecycle events. Returns an unsubscribe function. */
+    on(event: AgentLockEventType, handler: AgentLockEventHandler): () => void;
+    /** Remove a previously registered handler. */
+    off(event: AgentLockEventType, handler: AgentLockEventHandler): void;
+}
 interface ChatableXSDK {
     ai: ChatableXAI;
     tools: ChatableXTools;
@@ -271,6 +322,7 @@ interface ChatableXSDK {
     platform: ChatableXPlatform;
     auth: ChatableXAuth;
     cloud: ChatableXCloud;
+    agentLock: ChatableXAgentLock;
 }
 declare global {
     interface Window {
@@ -386,4 +438,4 @@ declare const ChatableX: {
     version: string;
 };
 
-export { type AiResponseEventData, type AuthTokenData, Bridge, type ChatOptions, type ChatResponse, ChatableX, type ChatableXAI, type ChatableXAuth, type ChatableXCloud, type ChatableXEvents, type ChatableXInitConfig, type ChatableXPlatform, type ChatableXSDK, type ChatableXStorage, type ChatableXToolModule, type ChatableXTools, type ChatableXUI, type CloseEventData, CloudAuthRequiredError, CloudError, type CloudFileInfo, type CloudListOptions, CloudQuotaExceededError, CloudSubscriptionRequiredError, type CloudUploadData, type CloudUploadOptions, type CloudUploadResult, type CloudUsage, type EventCallbackMap, type EventType, type FilePickerOptions, type Message, type NotificationType, SDK_VERSION, type SessionContext, type StateUpdate, type StreamingContentEventData, type TabConfig, type ToolCall, type ToolExecuteHandler, type ToolExecutionEventData, type ToolInfo, type ToolParameter, type ToolResult, type Unsubscribe, type UserMessageEventData };
+export { type AgentLockConfig, type AgentLockEventData, type AgentLockEventHandler, type AgentLockEventType, type AiResponseEventData, type AuthTokenData, Bridge, type ChatOptions, type ChatResponse, ChatableX, type ChatableXAI, type ChatableXAgentLock, type ChatableXAuth, type ChatableXCloud, type ChatableXEvents, type ChatableXInitConfig, type ChatableXPlatform, type ChatableXSDK, type ChatableXStorage, type ChatableXToolModule, type ChatableXTools, type ChatableXUI, type CloseEventData, CloudAuthRequiredError, CloudError, type CloudFileInfo, type CloudListOptions, CloudQuotaExceededError, CloudSubscriptionRequiredError, type CloudUploadData, type CloudUploadOptions, type CloudUploadResult, type CloudUsage, type EventCallbackMap, type EventType, type FilePickerOptions, type Message, type NotificationType, SDK_VERSION, type SessionContext, type StateUpdate, type StreamingContentEventData, type TabConfig, type ToolCall, type ToolExecuteHandler, type ToolExecutionEventData, type ToolInfo, type ToolParameter, type ToolResult, type Unsubscribe, type UserMessageEventData };

package/dist/index.d.ts

@@ -127,6 +127,8 @@ interface ChatableXInitConfig {
      * calls reject with a clear error.
      */
     apiBaseUrl?: string;
+    /** Agent lock configuration — blocks user input during tool execution. */
+    agentLock?: AgentLockConfig;
 }
 interface ChatableXAI {
     chat(message: string, options?: ChatOptions): Promise<ChatResponse>;
@@ -261,6 +263,55 @@ interface ChatableXCloud {
     /** Read the account's storage usage / quota. */
     usage(): Promise<CloudUsage>;
 }
+interface AgentLockConfig {
+    /** Enable the agent lock feature (default: true). */
+    enabled?: boolean;
+    /**
+     * `"overlay"` — SDK renders a built-in transparent overlay (default).
+     * `"events-only"` — SDK only emits lock/unlock events; no overlay injected.
+     */
+    mode?: 'overlay' | 'events-only';
+    /** URL of the logo displayed in the overlay centre. Defaults to built-in Chatablex SVG. */
+    logoUrl?: string;
+    /** Message shown below the logo (default: "Agent 正在操作，请稍候…"). */
+    message?: string;
+    /** Show a cancel button on the overlay (default: true). */
+    allowCancel?: boolean;
+    /** Overlay background opacity, 0–1 (default: 0.3). */
+    opacity?: number;
+    /** Auto-unlock timeout for a single tool execution, in ms (default: 30000). 0 disables. */
+    timeout?: number;
+    /**
+     * Safety auto-unlock timeout for a whole agent turn, in ms (default: 0 =
+     * disabled, rely on the host's turn-end signal). When the host drives a
+     * turn-level lock (the lock spans the entire agent response, not just one
+     * tool), this acts purely as a fallback in case the turn-end signal is lost.
+     */
+    turnTimeout?: number;
+    /** Delay before actually removing the overlay after unlock, to avoid flicker between consecutive tools (default: 200ms). */
+    debounceUnlock?: number;
+}
+type AgentLockEventType = 'lock' | 'unlock' | 'cancel' | 'timeout';
+interface AgentLockEventData {
+    requestId?: string;
+    timestamp: number;
+}
+type AgentLockEventHandler = (data: AgentLockEventData) => void;
+interface ChatableXAgentLock {
+    /** Manually lock user interaction with an optional custom message / timeout. */
+    lock(opts?: {
+        message?: string;
+        timeout?: number;
+    }): void;
+    /** Manually unlock. Safe to call when already unlocked. */
+    unlock(): void;
+    /** Whether the overlay is currently active. */
+    isLocked(): boolean;
+    /** Subscribe to lock lifecycle events. Returns an unsubscribe function. */
+    on(event: AgentLockEventType, handler: AgentLockEventHandler): () => void;
+    /** Remove a previously registered handler. */
+    off(event: AgentLockEventType, handler: AgentLockEventHandler): void;
+}
 interface ChatableXSDK {
     ai: ChatableXAI;
     tools: ChatableXTools;
@@ -271,6 +322,7 @@ interface ChatableXSDK {
     platform: ChatableXPlatform;
     auth: ChatableXAuth;
     cloud: ChatableXCloud;
+    agentLock: ChatableXAgentLock;
 }
 declare global {
     interface Window {
@@ -386,4 +438,4 @@ declare const ChatableX: {
     version: string;
 };
 
-export { type AiResponseEventData, type AuthTokenData, Bridge, type ChatOptions, type ChatResponse, ChatableX, type ChatableXAI, type ChatableXAuth, type ChatableXCloud, type ChatableXEvents, type ChatableXInitConfig, type ChatableXPlatform, type ChatableXSDK, type ChatableXStorage, type ChatableXToolModule, type ChatableXTools, type ChatableXUI, type CloseEventData, CloudAuthRequiredError, CloudError, type CloudFileInfo, type CloudListOptions, CloudQuotaExceededError, CloudSubscriptionRequiredError, type CloudUploadData, type CloudUploadOptions, type CloudUploadResult, type CloudUsage, type EventCallbackMap, type EventType, type FilePickerOptions, type Message, type NotificationType, SDK_VERSION, type SessionContext, type StateUpdate, type StreamingContentEventData, type TabConfig, type ToolCall, type ToolExecuteHandler, type ToolExecutionEventData, type ToolInfo, type ToolParameter, type ToolResult, type Unsubscribe, type UserMessageEventData };
+export { type AgentLockConfig, type AgentLockEventData, type AgentLockEventHandler, type AgentLockEventType, type AiResponseEventData, type AuthTokenData, Bridge, type ChatOptions, type ChatResponse, ChatableX, type ChatableXAI, type ChatableXAgentLock, type ChatableXAuth, type ChatableXCloud, type ChatableXEvents, type ChatableXInitConfig, type ChatableXPlatform, type ChatableXSDK, type ChatableXStorage, type ChatableXToolModule, type ChatableXTools, type ChatableXUI, type CloseEventData, CloudAuthRequiredError, CloudError, type CloudFileInfo, type CloudListOptions, CloudQuotaExceededError, CloudSubscriptionRequiredError, type CloudUploadData, type CloudUploadOptions, type CloudUploadResult, type CloudUsage, type EventCallbackMap, type EventType, type FilePickerOptions, type Message, type NotificationType, SDK_VERSION, type SessionContext, type StateUpdate, type StreamingContentEventData, type TabConfig, type ToolCall, type ToolExecuteHandler, type ToolExecutionEventData, type ToolInfo, type ToolParameter, type ToolResult, type Unsubscribe, type UserMessageEventData };

package/dist/index.js

@@ -164,7 +164,7 @@ var Bridge = class {
 };
 
 // src/modules/tool.ts
-function createToolModule(bridge, appId) {
+function createToolModule(bridge, appId, agentLock) {
   let _info = { id: appId, name: appId, version: "1.0.0", description: "" };
   let _handler = null;
   const dispatch = async (params) => {
@@ -182,6 +182,7 @@ function createToolModule(bridge, appId) {
   bridge.addEventListener("toolExecution", async (data) => {
     const params = data;
     const requestId = params._requestId;
+    if (requestId && agentLock) agentLock._autoLock(requestId);
     const result = await dispatch(params);
     if (requestId && window.ChatableXBridge) {
       window.ChatableXBridge.postMessage(JSON.stringify({
@@ -189,6 +190,7 @@ function createToolModule(bridge, appId) {
         params: { _requestId: requestId, ...result }
       }));
     }
+    if (requestId && agentLock) agentLock._autoUnlock(requestId);
   });
   return {
     getInfo() {
@@ -539,10 +541,252 @@ function createCloudModule(bridge, deps) {
   };
 }
 
+// src/assets/bee.png
+var bee_default = "data:image/png;base64,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";
+
+// src/modules/agentLock.ts
+var DEFAULT_CONFIG = {
+  enabled: true,
+  mode: "overlay",
+  logoUrl: "",
+  message: "Agent \u6B63\u5728\u64CD\u4F5C\uFF0C\u8BF7\u7A0D\u5019\u2026",
+  allowCancel: true,
+  opacity: 0.3,
+  timeout: 3e4,
+  turnTimeout: 0,
+  debounceUnlock: 200
+};
+var TURN_EVENT = "agentLock";
+var OVERLAY_ID = "__chatablex_agent_lock_overlay__";
+var BLOCKED_EVENTS = [
+  "mousedown",
+  "mouseup",
+  "click",
+  "dblclick",
+  "contextmenu",
+  "keydown",
+  "keyup",
+  "keypress",
+  "touchstart",
+  "touchmove",
+  "touchend",
+  "wheel",
+  "scroll",
+  "pointerdown",
+  "pointerup"
+];
+var CANCEL_BTN_ID = "__ctx_agent_lock_cancel__";
+function blockEvent(e) {
+  const target = e.target;
+  if (target?.id === CANCEL_BTN_ID) return;
+  e.stopPropagation();
+  e.preventDefault();
+}
+function createAgentLockModule(bridge, userConfig = {}) {
+  const cfg = { ...DEFAULT_CONFIG, ...userConfig };
+  const logoSrc = cfg.logoUrl || bee_default;
+  const listeners = /* @__PURE__ */ new Map();
+  let overlayEl = null;
+  let locked = false;
+  let lockCount = 0;
+  let turnActive = false;
+  let timeoutTimer = null;
+  let debounceTimer = null;
+  let currentMessage = cfg.message;
+  function emit(event, data = {}) {
+    const payload = { timestamp: Date.now(), ...data };
+    const handlers = listeners.get(event);
+    if (handlers) {
+      for (const fn of handlers) {
+        try {
+          fn(payload);
+        } catch (e) {
+          console.error("[ChatableX AgentLock] event handler error:", e);
+        }
+      }
+    }
+  }
+  function injectOverlay(message) {
+    if (typeof document === "undefined") return;
+    if (document.getElementById(OVERLAY_ID)) return;
+    const el = document.createElement("div");
+    el.id = OVERLAY_ID;
+    el.setAttribute("aria-hidden", "true");
+    el.style.cssText = [
+      "position:fixed",
+      "inset:0",
+      `z-index:2147483646`,
+      `background:rgba(255,255,255,${cfg.opacity})`,
+      "display:flex",
+      "flex-direction:column",
+      "align-items:center",
+      "justify-content:center",
+      "pointer-events:all",
+      "user-select:none",
+      "backdrop-filter:blur(1px)",
+      "-webkit-backdrop-filter:blur(1px)"
+    ].join(";");
+    el.innerHTML = `
+      <img src="${logoSrc}" alt="" style="width:48px;height:48px;animation:__ctx_spin 1.5s linear infinite;" />
+      <p style="margin:12px 0 0;font:14px/1.4 -apple-system,BlinkMacSystemFont,sans-serif;color:#666;">${message}</p>
+      ${cfg.allowCancel ? '<button id="__ctx_agent_lock_cancel__" style="margin-top:16px;background:none;border:none;color:#6366f1;font:13px -apple-system,BlinkMacSystemFont,sans-serif;cursor:pointer;text-decoration:underline;padding:4px 8px;">\u53D6\u6D88</button>' : ""}
+    `;
+    if (!document.getElementById("__ctx_agent_lock_style__")) {
+      const style = document.createElement("style");
+      style.id = "__ctx_agent_lock_style__";
+      style.textContent = "@keyframes __ctx_spin{from{transform:rotate(0deg)}to{transform:rotate(360deg)}}";
+      document.head.appendChild(style);
+    }
+    for (const evt of BLOCKED_EVENTS) {
+      el.addEventListener(evt, blockEvent, { capture: true, passive: false });
+    }
+    if (cfg.allowCancel) {
+      queueMicrotask(() => {
+        const btn = el.querySelector("#__ctx_agent_lock_cancel__");
+        if (btn) {
+          btn.addEventListener("click", (e) => {
+            e.stopPropagation();
+            handleCancel();
+          });
+        }
+      });
+    }
+    document.body.appendChild(el);
+    overlayEl = el;
+  }
+  function removeOverlay() {
+    if (overlayEl) {
+      for (const evt of BLOCKED_EVENTS) {
+        overlayEl.removeEventListener(evt, blockEvent, { capture: true });
+      }
+      overlayEl.remove();
+      overlayEl = null;
+    }
+    const style = typeof document !== "undefined" ? document.getElementById("__ctx_agent_lock_style__") : null;
+    if (style) style.remove();
+  }
+  function startTimeout(ms, requestId) {
+    clearTimeoutTimer();
+    if (ms <= 0) return;
+    timeoutTimer = setTimeout(() => {
+      console.warn("[ChatableX] Agent lock timeout \u2014 auto-unlocking");
+      forceUnlock();
+      emit("timeout", { requestId });
+    }, ms);
+  }
+  function clearTimeoutTimer() {
+    if (timeoutTimer !== null) {
+      clearTimeout(timeoutTimer);
+      timeoutTimer = null;
+    }
+  }
+  function clearDebounceTimer() {
+    if (debounceTimer !== null) {
+      clearTimeout(debounceTimer);
+      debounceTimer = null;
+    }
+  }
+  function doLock(message, timeout, requestId) {
+    if (locked) return;
+    locked = true;
+    currentMessage = message;
+    if (cfg.mode === "overlay") {
+      injectOverlay(currentMessage);
+    }
+    startTimeout(timeout, requestId);
+    emit("lock", { requestId });
+  }
+  function forceUnlock(requestId) {
+    if (!locked) return;
+    locked = false;
+    lockCount = 0;
+    turnActive = false;
+    clearTimeoutTimer();
+    clearDebounceTimer();
+    if (cfg.mode === "overlay") {
+      removeOverlay();
+    }
+    emit("unlock", { requestId });
+  }
+  function maybeUnlock(requestId) {
+    if (turnActive || lockCount > 0) return;
+    forceUnlock(requestId);
+  }
+  function scheduleDebouncedUnlock(requestId) {
+    clearDebounceTimer();
+    debounceTimer = setTimeout(() => maybeUnlock(requestId), cfg.debounceUnlock);
+  }
+  function handleCancel() {
+    const rid = void 0;
+    forceUnlock(rid);
+    emit("cancel", { requestId: rid });
+  }
+  function setTurn(active) {
+    if (!cfg.enabled) return;
+    if (active) {
+      turnActive = true;
+      clearDebounceTimer();
+      if (!locked) {
+        doLock(cfg.message, cfg.turnTimeout);
+      } else {
+        startTimeout(cfg.turnTimeout);
+      }
+    } else {
+      turnActive = false;
+      if (lockCount === 0) scheduleDebouncedUnlock();
+    }
+  }
+  function lock(opts) {
+    if (!cfg.enabled) return;
+    const msg = opts?.message ?? cfg.message;
+    const timeout = opts?.timeout ?? cfg.timeout;
+    doLock(msg, timeout);
+  }
+  function unlock() {
+    forceUnlock();
+  }
+  function isLocked() {
+    return locked;
+  }
+  function on(event, handler) {
+    if (!listeners.has(event)) listeners.set(event, /* @__PURE__ */ new Set());
+    listeners.get(event).add(handler);
+    return () => off(event, handler);
+  }
+  function off(event, handler) {
+    listeners.get(event)?.delete(handler);
+  }
+  function _autoLock(requestId) {
+    if (!cfg.enabled) return;
+    clearDebounceTimer();
+    lockCount++;
+    if (!locked) {
+      doLock(cfg.message, turnActive ? cfg.turnTimeout : cfg.timeout, requestId);
+    }
+  }
+  function _autoUnlock(requestId) {
+    if (!cfg.enabled) return;
+    lockCount = Math.max(0, lockCount - 1);
+    if (lockCount === 0) {
+      scheduleDebouncedUnlock(requestId);
+    }
+  }
+  function _destroy() {
+    if (removeTurnListener) removeTurnListener();
+    forceUnlock();
+    listeners.clear();
+  }
+  const removeTurnListener = bridge.addEventListener(TURN_EVENT, (data) => {
+    const active = !!data?.active;
+    setTurn(active);
+  });
+  return { lock, unlock, isLocked, on, off, _autoLock, _autoUnlock, _destroy };
+}
+
 // package.json
 var package_default = {
   name: "chatablex-web-sdk",
-  version: "1.0.32",
+  version: "1.0.36",
   description: "ChatableX Web SDK for AI App WebUI development. Provides bridge communication with the ChatableX Flutter client.",
   main: "dist/index.js",
   module: "dist/index.mjs",
@@ -561,8 +805,8 @@ var package_default = {
     "README.zh-CN.md"
   ],
   scripts: {
-    build: "tsup src/index.ts --format cjs,esm --dts --clean",
-    dev: "tsup src/index.ts --format cjs,esm --dts --watch",
+    build: "tsup",
+    dev: "tsup --watch",
     typecheck: "tsc --noEmit",
     test: "vitest run",
     "test:watch": "vitest",
@@ -632,7 +876,8 @@ var ChatableX = {
     } catch {
       if (debug) console.warn("[ChatableX] sdk_init handshake failed, continuing with defaults");
     }
-    const toolModule = createToolModule(bridge, config.appId);
+    const agentLockModule = createAgentLockModule(bridge, config.agentLock);
+    const toolModule = createToolModule(bridge, config.appId, agentLockModule);
     if (toolConfig) toolModule._setInfo(toolConfig);
     const authModule = createAuthModule(bridge);
     const sdk = {
@@ -648,7 +893,8 @@ var ChatableX = {
         appId: config.appId,
         auth: authModule,
         apiBaseUrl: config.apiBaseUrl
-      })
+      }),
+      agentLock: agentLockModule
     };
     window.ChatableX = sdk;
     _instance = sdk;

package/dist/index.mjs

@@ -132,7 +132,7 @@ var Bridge = class {
 };
 
 // src/modules/tool.ts
-function createToolModule(bridge, appId) {
+function createToolModule(bridge, appId, agentLock) {
   let _info = { id: appId, name: appId, version: "1.0.0", description: "" };
   let _handler = null;
   const dispatch = async (params) => {
@@ -150,6 +150,7 @@ function createToolModule(bridge, appId) {
   bridge.addEventListener("toolExecution", async (data) => {
     const params = data;
     const requestId = params._requestId;
+    if (requestId && agentLock) agentLock._autoLock(requestId);
     const result = await dispatch(params);
     if (requestId && window.ChatableXBridge) {
       window.ChatableXBridge.postMessage(JSON.stringify({
@@ -157,6 +158,7 @@ function createToolModule(bridge, appId) {
         params: { _requestId: requestId, ...result }
       }));
     }
+    if (requestId && agentLock) agentLock._autoUnlock(requestId);
   });
   return {
     getInfo() {
@@ -507,10 +509,252 @@ function createCloudModule(bridge, deps) {
   };
 }
 
+// src/assets/bee.png
+var bee_default = "data:image/png;base64,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";
+
+// src/modules/agentLock.ts
+var DEFAULT_CONFIG = {
+  enabled: true,
+  mode: "overlay",
+  logoUrl: "",
+  message: "Agent \u6B63\u5728\u64CD\u4F5C\uFF0C\u8BF7\u7A0D\u5019\u2026",
+  allowCancel: true,
+  opacity: 0.3,
+  timeout: 3e4,
+  turnTimeout: 0,
+  debounceUnlock: 200
+};
+var TURN_EVENT = "agentLock";
+var OVERLAY_ID = "__chatablex_agent_lock_overlay__";
+var BLOCKED_EVENTS = [
+  "mousedown",
+  "mouseup",
+  "click",
+  "dblclick",
+  "contextmenu",
+  "keydown",
+  "keyup",
+  "keypress",
+  "touchstart",
+  "touchmove",
+  "touchend",
+  "wheel",
+  "scroll",
+  "pointerdown",
+  "pointerup"
+];
+var CANCEL_BTN_ID = "__ctx_agent_lock_cancel__";
+function blockEvent(e) {
+  const target = e.target;
+  if (target?.id === CANCEL_BTN_ID) return;
+  e.stopPropagation();
+  e.preventDefault();
+}
+function createAgentLockModule(bridge, userConfig = {}) {
+  const cfg = { ...DEFAULT_CONFIG, ...userConfig };
+  const logoSrc = cfg.logoUrl || bee_default;
+  const listeners = /* @__PURE__ */ new Map();
+  let overlayEl = null;
+  let locked = false;
+  let lockCount = 0;
+  let turnActive = false;
+  let timeoutTimer = null;
+  let debounceTimer = null;
+  let currentMessage = cfg.message;
+  function emit(event, data = {}) {
+    const payload = { timestamp: Date.now(), ...data };
+    const handlers = listeners.get(event);
+    if (handlers) {
+      for (const fn of handlers) {
+        try {
+          fn(payload);
+        } catch (e) {
+          console.error("[ChatableX AgentLock] event handler error:", e);
+        }
+      }
+    }
+  }
+  function injectOverlay(message) {
+    if (typeof document === "undefined") return;
+    if (document.getElementById(OVERLAY_ID)) return;
+    const el = document.createElement("div");
+    el.id = OVERLAY_ID;
+    el.setAttribute("aria-hidden", "true");
+    el.style.cssText = [
+      "position:fixed",
+      "inset:0",
+      `z-index:2147483646`,
+      `background:rgba(255,255,255,${cfg.opacity})`,
+      "display:flex",
+      "flex-direction:column",
+      "align-items:center",
+      "justify-content:center",
+      "pointer-events:all",
+      "user-select:none",
+      "backdrop-filter:blur(1px)",
+      "-webkit-backdrop-filter:blur(1px)"
+    ].join(";");
+    el.innerHTML = `
+      <img src="${logoSrc}" alt="" style="width:48px;height:48px;animation:__ctx_spin 1.5s linear infinite;" />
+      <p style="margin:12px 0 0;font:14px/1.4 -apple-system,BlinkMacSystemFont,sans-serif;color:#666;">${message}</p>
+      ${cfg.allowCancel ? '<button id="__ctx_agent_lock_cancel__" style="margin-top:16px;background:none;border:none;color:#6366f1;font:13px -apple-system,BlinkMacSystemFont,sans-serif;cursor:pointer;text-decoration:underline;padding:4px 8px;">\u53D6\u6D88</button>' : ""}
+    `;
+    if (!document.getElementById("__ctx_agent_lock_style__")) {
+      const style = document.createElement("style");
+      style.id = "__ctx_agent_lock_style__";
+      style.textContent = "@keyframes __ctx_spin{from{transform:rotate(0deg)}to{transform:rotate(360deg)}}";
+      document.head.appendChild(style);
+    }
+    for (const evt of BLOCKED_EVENTS) {
+      el.addEventListener(evt, blockEvent, { capture: true, passive: false });
+    }
+    if (cfg.allowCancel) {
+      queueMicrotask(() => {
+        const btn = el.querySelector("#__ctx_agent_lock_cancel__");
+        if (btn) {
+          btn.addEventListener("click", (e) => {
+            e.stopPropagation();
+            handleCancel();
+          });
+        }
+      });
+    }
+    document.body.appendChild(el);
+    overlayEl = el;
+  }
+  function removeOverlay() {
+    if (overlayEl) {
+      for (const evt of BLOCKED_EVENTS) {
+        overlayEl.removeEventListener(evt, blockEvent, { capture: true });
+      }
+      overlayEl.remove();
+      overlayEl = null;
+    }
+    const style = typeof document !== "undefined" ? document.getElementById("__ctx_agent_lock_style__") : null;
+    if (style) style.remove();
+  }
+  function startTimeout(ms, requestId) {
+    clearTimeoutTimer();
+    if (ms <= 0) return;
+    timeoutTimer = setTimeout(() => {
+      console.warn("[ChatableX] Agent lock timeout \u2014 auto-unlocking");
+      forceUnlock();
+      emit("timeout", { requestId });
+    }, ms);
+  }
+  function clearTimeoutTimer() {
+    if (timeoutTimer !== null) {
+      clearTimeout(timeoutTimer);
+      timeoutTimer = null;
+    }
+  }
+  function clearDebounceTimer() {
+    if (debounceTimer !== null) {
+      clearTimeout(debounceTimer);
+      debounceTimer = null;
+    }
+  }
+  function doLock(message, timeout, requestId) {
+    if (locked) return;
+    locked = true;
+    currentMessage = message;
+    if (cfg.mode === "overlay") {
+      injectOverlay(currentMessage);
+    }
+    startTimeout(timeout, requestId);
+    emit("lock", { requestId });
+  }
+  function forceUnlock(requestId) {
+    if (!locked) return;
+    locked = false;
+    lockCount = 0;
+    turnActive = false;
+    clearTimeoutTimer();
+    clearDebounceTimer();
+    if (cfg.mode === "overlay") {
+      removeOverlay();
+    }
+    emit("unlock", { requestId });
+  }
+  function maybeUnlock(requestId) {
+    if (turnActive || lockCount > 0) return;
+    forceUnlock(requestId);
+  }
+  function scheduleDebouncedUnlock(requestId) {
+    clearDebounceTimer();
+    debounceTimer = setTimeout(() => maybeUnlock(requestId), cfg.debounceUnlock);
+  }
+  function handleCancel() {
+    const rid = void 0;
+    forceUnlock(rid);
+    emit("cancel", { requestId: rid });
+  }
+  function setTurn(active) {
+    if (!cfg.enabled) return;
+    if (active) {
+      turnActive = true;
+      clearDebounceTimer();
+      if (!locked) {
+        doLock(cfg.message, cfg.turnTimeout);
+      } else {
+        startTimeout(cfg.turnTimeout);
+      }
+    } else {
+      turnActive = false;
+      if (lockCount === 0) scheduleDebouncedUnlock();
+    }
+  }
+  function lock(opts) {
+    if (!cfg.enabled) return;
+    const msg = opts?.message ?? cfg.message;
+    const timeout = opts?.timeout ?? cfg.timeout;
+    doLock(msg, timeout);
+  }
+  function unlock() {
+    forceUnlock();
+  }
+  function isLocked() {
+    return locked;
+  }
+  function on(event, handler) {
+    if (!listeners.has(event)) listeners.set(event, /* @__PURE__ */ new Set());
+    listeners.get(event).add(handler);
+    return () => off(event, handler);
+  }
+  function off(event, handler) {
+    listeners.get(event)?.delete(handler);
+  }
+  function _autoLock(requestId) {
+    if (!cfg.enabled) return;
+    clearDebounceTimer();
+    lockCount++;
+    if (!locked) {
+      doLock(cfg.message, turnActive ? cfg.turnTimeout : cfg.timeout, requestId);
+    }
+  }
+  function _autoUnlock(requestId) {
+    if (!cfg.enabled) return;
+    lockCount = Math.max(0, lockCount - 1);
+    if (lockCount === 0) {
+      scheduleDebouncedUnlock(requestId);
+    }
+  }
+  function _destroy() {
+    if (removeTurnListener) removeTurnListener();
+    forceUnlock();
+    listeners.clear();
+  }
+  const removeTurnListener = bridge.addEventListener(TURN_EVENT, (data) => {
+    const active = !!data?.active;
+    setTurn(active);
+  });
+  return { lock, unlock, isLocked, on, off, _autoLock, _autoUnlock, _destroy };
+}
+
 // package.json
 var package_default = {
   name: "chatablex-web-sdk",
-  version: "1.0.32",
+  version: "1.0.36",
   description: "ChatableX Web SDK for AI App WebUI development. Provides bridge communication with the ChatableX Flutter client.",
   main: "dist/index.js",
   module: "dist/index.mjs",
@@ -529,8 +773,8 @@ var package_default = {
     "README.zh-CN.md"
   ],
   scripts: {
-    build: "tsup src/index.ts --format cjs,esm --dts --clean",
-    dev: "tsup src/index.ts --format cjs,esm --dts --watch",
+    build: "tsup",
+    dev: "tsup --watch",
     typecheck: "tsc --noEmit",
     test: "vitest run",
     "test:watch": "vitest",
@@ -600,7 +844,8 @@ var ChatableX = {
     } catch {
       if (debug) console.warn("[ChatableX] sdk_init handshake failed, continuing with defaults");
     }
-    const toolModule = createToolModule(bridge, config.appId);
+    const agentLockModule = createAgentLockModule(bridge, config.agentLock);
+    const toolModule = createToolModule(bridge, config.appId, agentLockModule);
     if (toolConfig) toolModule._setInfo(toolConfig);
     const authModule = createAuthModule(bridge);
     const sdk = {
@@ -616,7 +861,8 @@ var ChatableX = {
         appId: config.appId,
         auth: authModule,
         apiBaseUrl: config.apiBaseUrl
-      })
+      }),
+      agentLock: agentLockModule
     };
     window.ChatableX = sdk;
     _instance = sdk;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatablex-web-sdk",
-  "version": "1.0.32",
+  "version": "1.0.36",
   "description": "ChatableX Web SDK for AI App WebUI development. Provides bridge communication with the ChatableX Flutter client.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -19,8 +19,8 @@
     "README.zh-CN.md"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "build": "tsup",
+    "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",

package/src/assets.d.ts

@@ -0,0 +1,4 @@
+declare module '*.png' {
+  const dataUrl: string;
+  export default dataUrl;
+}

package/src/index.ts

@@ -28,6 +28,7 @@ import { createToolsModule } from './modules/tools';
 import { createPlatformModule } from './modules/platform';
 import { createAuthModule } from './modules/auth';
 import { createCloudModule } from './modules/cloud';
+import { createAgentLockModule } from './modules/agentLock';
 import type { ChatableXSDK, ChatableXInitConfig, ToolInfo } from './types';
 import pkg from '../package.json';
 
@@ -77,7 +78,9 @@ export const ChatableX = {
     }
 
     // 4. Create modules
-    const toolModule = createToolModule(bridge, config.appId);
+    const agentLockModule = createAgentLockModule(bridge, config.agentLock);
+
+    const toolModule = createToolModule(bridge, config.appId, agentLockModule);
     if (toolConfig) toolModule._setInfo(toolConfig);
 
     const authModule = createAuthModule(bridge);
@@ -96,6 +99,7 @@ export const ChatableX = {
         auth: authModule,
         apiBaseUrl: config.apiBaseUrl,
       }),
+      agentLock: agentLockModule,
     };
 
     // Expose on window for debugging / Flutter interop

package/src/modules/agentLock.ts

@@ -0,0 +1,313 @@
+import type { Bridge } from '../bridge';
+import type {
+  AgentLockConfig,
+  AgentLockEventType,
+  AgentLockEventData,
+  AgentLockEventHandler,
+  ChatableXAgentLock,
+} from '../types';
+import beeLogo from '../assets/bee.png';
+
+const DEFAULT_CONFIG: Required<AgentLockConfig> = {
+  enabled: true,
+  mode: 'overlay',
+  logoUrl: '',
+  message: 'Agent 正在操作，请稍候…',
+  allowCancel: true,
+  opacity: 0.3,
+  timeout: 30_000,
+  turnTimeout: 0,
+  debounceUnlock: 200,
+};
+
+/**
+ * Bridge event pushed by the Flutter host to lock the UI for the *entire* agent
+ * turn (from the moment the agent starts responding until the turn ends),
+ * rather than only during each individual tool execution. Payload: `{ active }`.
+ */
+const TURN_EVENT = 'agentLock';
+
+const OVERLAY_ID = '__chatablex_agent_lock_overlay__';
+
+/**
+ * Blocked event types — we intercept these on the overlay to prevent user
+ * interaction from reaching the app underneath.
+ */
+const BLOCKED_EVENTS: string[] = [
+  'mousedown', 'mouseup', 'click', 'dblclick', 'contextmenu',
+  'keydown', 'keyup', 'keypress',
+  'touchstart', 'touchmove', 'touchend',
+  'wheel', 'scroll',
+  'pointerdown', 'pointerup',
+];
+
+const CANCEL_BTN_ID = '__ctx_agent_lock_cancel__';
+
+function blockEvent(e: Event): void {
+  const target = e.target as HTMLElement | null;
+  if (target?.id === CANCEL_BTN_ID) return;
+  e.stopPropagation();
+  e.preventDefault();
+}
+
+export interface AgentLockModule extends ChatableXAgentLock {
+  /**
+   * @internal — called by tool module to lock before dispatch and schedule
+   * unlock after result. Uses ref-counting to support consecutive tools.
+   */
+  _autoLock(requestId: string): void;
+  /** @internal */
+  _autoUnlock(requestId: string): void;
+  /** @internal */
+  _destroy(): void;
+}
+
+export function createAgentLockModule(
+  bridge: Bridge,
+  userConfig: AgentLockConfig = {},
+): AgentLockModule {
+  const cfg: Required<AgentLockConfig> = { ...DEFAULT_CONFIG, ...userConfig };
+  const logoSrc = cfg.logoUrl || beeLogo;
+
+  const listeners = new Map<AgentLockEventType, Set<AgentLockEventHandler>>();
+  let overlayEl: HTMLDivElement | null = null;
+  let locked = false;
+  let lockCount = 0;
+  /**
+   * True while an agent *turn* is in progress (driven by the host's
+   * {@link TURN_EVENT}). Keeps the overlay up across the whole response — and
+   * across the gaps between individual tool calls — until the turn ends.
+   */
+  let turnActive = false;
+  let timeoutTimer: ReturnType<typeof setTimeout> | null = null;
+  let debounceTimer: ReturnType<typeof setTimeout> | null = null;
+  let currentMessage = cfg.message;
+
+  function emit(event: AgentLockEventType, data: Partial<AgentLockEventData> = {}): void {
+    const payload: AgentLockEventData = { timestamp: Date.now(), ...data };
+    const handlers = listeners.get(event);
+    if (handlers) {
+      for (const fn of handlers) {
+        try { fn(payload); } catch (e) { console.error('[ChatableX AgentLock] event handler error:', e); }
+      }
+    }
+  }
+
+  function injectOverlay(message: string): void {
+    if (typeof document === 'undefined') return;
+    if (document.getElementById(OVERLAY_ID)) return;
+
+    const el = document.createElement('div');
+    el.id = OVERLAY_ID;
+    el.setAttribute('aria-hidden', 'true');
+    el.style.cssText = [
+      'position:fixed', 'inset:0', `z-index:2147483646`,
+      `background:rgba(255,255,255,${cfg.opacity})`,
+      'display:flex', 'flex-direction:column',
+      'align-items:center', 'justify-content:center',
+      'pointer-events:all', 'user-select:none',
+      'backdrop-filter:blur(1px)', '-webkit-backdrop-filter:blur(1px)',
+    ].join(';');
+
+    el.innerHTML = `
+      <img src="${logoSrc}" alt="" style="width:48px;height:48px;animation:__ctx_spin 1.5s linear infinite;" />
+      <p style="margin:12px 0 0;font:14px/1.4 -apple-system,BlinkMacSystemFont,sans-serif;color:#666;">${message}</p>
+      ${cfg.allowCancel ? '<button id="__ctx_agent_lock_cancel__" style="margin-top:16px;background:none;border:none;color:#6366f1;font:13px -apple-system,BlinkMacSystemFont,sans-serif;cursor:pointer;text-decoration:underline;padding:4px 8px;">取消</button>' : ''}
+    `;
+
+    if (!document.getElementById('__ctx_agent_lock_style__')) {
+      const style = document.createElement('style');
+      style.id = '__ctx_agent_lock_style__';
+      style.textContent = '@keyframes __ctx_spin{from{transform:rotate(0deg)}to{transform:rotate(360deg)}}';
+      document.head.appendChild(style);
+    }
+
+    for (const evt of BLOCKED_EVENTS) {
+      el.addEventListener(evt, blockEvent, { capture: true, passive: false });
+    }
+
+    if (cfg.allowCancel) {
+      // Defer binding so the DOM is ready
+      queueMicrotask(() => {
+        const btn = el.querySelector('#__ctx_agent_lock_cancel__');
+        if (btn) {
+          btn.addEventListener('click', (e) => {
+            e.stopPropagation();
+            handleCancel();
+          });
+        }
+      });
+    }
+
+    document.body.appendChild(el);
+    overlayEl = el;
+  }
+
+  function removeOverlay(): void {
+    if (overlayEl) {
+      for (const evt of BLOCKED_EVENTS) {
+        overlayEl.removeEventListener(evt, blockEvent, { capture: true } as EventListenerOptions);
+      }
+      overlayEl.remove();
+      overlayEl = null;
+    }
+    const style = typeof document !== 'undefined' ? document.getElementById('__ctx_agent_lock_style__') : null;
+    if (style) style.remove();
+  }
+
+  function startTimeout(ms: number, requestId?: string): void {
+    clearTimeoutTimer();
+    if (ms <= 0) return;
+    timeoutTimer = setTimeout(() => {
+      console.warn('[ChatableX] Agent lock timeout — auto-unlocking');
+      forceUnlock();
+      emit('timeout', { requestId });
+    }, ms);
+  }
+
+  function clearTimeoutTimer(): void {
+    if (timeoutTimer !== null) {
+      clearTimeout(timeoutTimer);
+      timeoutTimer = null;
+    }
+  }
+
+  function clearDebounceTimer(): void {
+    if (debounceTimer !== null) {
+      clearTimeout(debounceTimer);
+      debounceTimer = null;
+    }
+  }
+
+  function doLock(message: string, timeout: number, requestId?: string): void {
+    if (locked) return;
+    locked = true;
+    currentMessage = message;
+
+    if (cfg.mode === 'overlay') {
+      injectOverlay(currentMessage);
+    }
+    startTimeout(timeout, requestId);
+    emit('lock', { requestId });
+  }
+
+  function forceUnlock(requestId?: string): void {
+    if (!locked) return;
+    locked = false;
+    lockCount = 0;
+    turnActive = false;
+    clearTimeoutTimer();
+    clearDebounceTimer();
+    if (cfg.mode === 'overlay') {
+      removeOverlay();
+    }
+    emit('unlock', { requestId });
+  }
+
+  /**
+   * Release the lock only when nothing is still holding it — i.e. no agent turn
+   * is in progress and no tool execution is outstanding. This is what keeps the
+   * overlay from flickering off between tools or mid-turn.
+   */
+  function maybeUnlock(requestId?: string): void {
+    if (turnActive || lockCount > 0) return;
+    forceUnlock(requestId);
+  }
+
+  function scheduleDebouncedUnlock(requestId?: string): void {
+    clearDebounceTimer();
+    debounceTimer = setTimeout(() => maybeUnlock(requestId), cfg.debounceUnlock);
+  }
+
+  function handleCancel(): void {
+    const rid = undefined; // auto mode tracks this externally
+    // Explicit user cancel wins over any in-progress turn/tool tracking.
+    forceUnlock(rid);
+    emit('cancel', { requestId: rid });
+  }
+
+  /**
+   * Turn-level lock driven by the host (see {@link TURN_EVENT}). Holds the
+   * overlay for the entire agent response; tool-level auto lock/unlock nests
+   * inside without tearing the overlay down.
+   */
+  function setTurn(active: boolean): void {
+    if (!cfg.enabled) return;
+    if (active) {
+      turnActive = true;
+      clearDebounceTimer();
+      if (!locked) {
+        doLock(cfg.message, cfg.turnTimeout);
+      } else {
+        // Already locked by a tool — extend its timeout to the (longer) turn
+        // budget so a 30s tool timeout can't drop the overlay mid-turn.
+        startTimeout(cfg.turnTimeout);
+      }
+    } else {
+      turnActive = false;
+      if (lockCount === 0) scheduleDebouncedUnlock();
+    }
+  }
+
+  // Public API -----------------------------------------------------------------
+
+  function lock(opts?: { message?: string; timeout?: number }): void {
+    if (!cfg.enabled) return;
+    const msg = opts?.message ?? cfg.message;
+    const timeout = opts?.timeout ?? cfg.timeout;
+    doLock(msg, timeout);
+  }
+
+  function unlock(): void {
+    forceUnlock();
+  }
+
+  function isLocked(): boolean {
+    return locked;
+  }
+
+  function on(event: AgentLockEventType, handler: AgentLockEventHandler): () => void {
+    if (!listeners.has(event)) listeners.set(event, new Set());
+    listeners.get(event)!.add(handler);
+    return () => off(event, handler);
+  }
+
+  function off(event: AgentLockEventType, handler: AgentLockEventHandler): void {
+    listeners.get(event)?.delete(handler);
+  }
+
+  // Internal auto-mode API (called by tool module) ----------------------------
+
+  function _autoLock(requestId: string): void {
+    if (!cfg.enabled) return;
+    clearDebounceTimer();
+    lockCount++;
+    if (!locked) {
+      // Inside a turn the (longer) turn budget governs; standalone tool calls
+      // keep the per-tool timeout.
+      doLock(cfg.message, turnActive ? cfg.turnTimeout : cfg.timeout, requestId);
+    }
+  }
+
+  function _autoUnlock(requestId: string): void {
+    if (!cfg.enabled) return;
+    lockCount = Math.max(0, lockCount - 1);
+    if (lockCount === 0) {
+      scheduleDebouncedUnlock(requestId);
+    }
+  }
+
+  function _destroy(): void {
+    if (removeTurnListener) removeTurnListener();
+    forceUnlock();
+    listeners.clear();
+  }
+
+  // Listen for host-driven turn lock/unlock. Payload shape: `{ active: boolean }`.
+  const removeTurnListener = bridge.addEventListener(TURN_EVENT, (data) => {
+    const active = !!(data as { active?: unknown } | undefined)?.active;
+    setTurn(active);
+  });
+
+  return { lock, unlock, isLocked, on, off, _autoLock, _autoUnlock, _destroy };
+}

package/src/modules/tool.ts

@@ -1,11 +1,16 @@
 import type { Bridge } from '../bridge';
 import type { ToolInfo, ToolExecuteHandler, ChatableXToolModule } from '../types';
+import type { AgentLockModule } from './agentLock';
 
 /**
  * Creates the `sdk.tool` module — the primary interface for LLM-driven
  * tool execution in a ChatableX WebUI app.
  */
-export function createToolModule(bridge: Bridge, appId: string): ChatableXToolModule & { _setInfo(info: Partial<ToolInfo>): void } {
+export function createToolModule(
+  bridge: Bridge,
+  appId: string,
+  agentLock?: AgentLockModule,
+): ChatableXToolModule & { _setInfo(info: Partial<ToolInfo>): void } {
   let _info: ToolInfo = { id: appId, name: appId, version: '1.0.0', description: '' };
   let _handler: ToolExecuteHandler | null = null;
 
@@ -30,13 +35,19 @@ export function createToolModule(bridge: Bridge, appId: string): ChatableXToolMo
   bridge.addEventListener('toolExecution', async (data) => {
     const params = data as Record<string, unknown>;
     const requestId = params._requestId as string | undefined;
+
+    if (requestId && agentLock) agentLock._autoLock(requestId);
+
     const result = await dispatch(params);
+
     if (requestId && window.ChatableXBridge) {
       window.ChatableXBridge.postMessage(JSON.stringify({
         method: 'tool.executeResult',
         params: { _requestId: requestId, ...result },
       }));
     }
+
+    if (requestId && agentLock) agentLock._autoUnlock(requestId);
   });
 
   return {

package/src/types.ts

@@ -169,6 +169,8 @@ export interface ChatableXInitConfig {
    * calls reject with a clear error.
    */
   apiBaseUrl?: string;
+  /** Agent lock configuration — blocks user input during tool execution. */
+  agentLock?: AgentLockConfig;
 }
 
 // ---------------------------------------------------------------------------
@@ -332,6 +334,61 @@ export interface ChatableXCloud {
   usage(): Promise<CloudUsage>;
 }
 
+// ---------------------------------------------------------------------------
+// Agent Lock
+// ---------------------------------------------------------------------------
+
+export interface AgentLockConfig {
+  /** Enable the agent lock feature (default: true). */
+  enabled?: boolean;
+  /**
+   * `"overlay"` — SDK renders a built-in transparent overlay (default).
+   * `"events-only"` — SDK only emits lock/unlock events; no overlay injected.
+   */
+  mode?: 'overlay' | 'events-only';
+  /** URL of the logo displayed in the overlay centre. Defaults to built-in Chatablex SVG. */
+  logoUrl?: string;
+  /** Message shown below the logo (default: "Agent 正在操作，请稍候…"). */
+  message?: string;
+  /** Show a cancel button on the overlay (default: true). */
+  allowCancel?: boolean;
+  /** Overlay background opacity, 0–1 (default: 0.3). */
+  opacity?: number;
+  /** Auto-unlock timeout for a single tool execution, in ms (default: 30000). 0 disables. */
+  timeout?: number;
+  /**
+   * Safety auto-unlock timeout for a whole agent turn, in ms (default: 0 =
+   * disabled, rely on the host's turn-end signal). When the host drives a
+   * turn-level lock (the lock spans the entire agent response, not just one
+   * tool), this acts purely as a fallback in case the turn-end signal is lost.
+   */
+  turnTimeout?: number;
+  /** Delay before actually removing the overlay after unlock, to avoid flicker between consecutive tools (default: 200ms). */
+  debounceUnlock?: number;
+}
+
+export type AgentLockEventType = 'lock' | 'unlock' | 'cancel' | 'timeout';
+
+export interface AgentLockEventData {
+  requestId?: string;
+  timestamp: number;
+}
+
+export type AgentLockEventHandler = (data: AgentLockEventData) => void;
+
+export interface ChatableXAgentLock {
+  /** Manually lock user interaction with an optional custom message / timeout. */
+  lock(opts?: { message?: string; timeout?: number }): void;
+  /** Manually unlock. Safe to call when already unlocked. */
+  unlock(): void;
+  /** Whether the overlay is currently active. */
+  isLocked(): boolean;
+  /** Subscribe to lock lifecycle events. Returns an unsubscribe function. */
+  on(event: AgentLockEventType, handler: AgentLockEventHandler): () => void;
+  /** Remove a previously registered handler. */
+  off(event: AgentLockEventType, handler: AgentLockEventHandler): void;
+}
+
 export interface ChatableXSDK {
   ai: ChatableXAI;
   tools: ChatableXTools;
@@ -342,6 +399,7 @@ export interface ChatableXSDK {
   platform: ChatableXPlatform;
   auth: ChatableXAuth;
   cloud: ChatableXCloud;
+  agentLock: ChatableXAgentLock;
 }
 
 // ---------------------------------------------------------------------------