@nexface/tools 0.1.5 → 0.1.7

package/dist/errors.d.ts

@@ -1,4 +1,4 @@
-export declare const TOOL_ERROR_CODES: readonly ["ACTION_IN_FLIGHT", "ACTION_NOT_HANDLED", "ACTION_TARGET_UNAVAILABLE", "BROWSER_EXECUTION_FAILED", "BROWSER_SNAPSHOT_REQUIRED", "BROWSER_TOOLS_UNAVAILABLE", "CONTRACT_MISMATCH", "DUPLICATE_BINDING", "INVALID_INPUT", "INVALID_TOOL_RUNTIME", "OPERATION_BUSY", "TOOL_CANCELLED", "TOOL_CONFIRMATION_INVALIDATED", "TOOL_CONFIRMATION_REJECTED", "TOOL_ERROR", "TOOL_REGISTRATION_TIMEOUT", "TOOL_SKIPPED", "TOOL_UNAVAILABLE", "UNKNOWN_TOOL"];
+export declare const TOOL_ERROR_CODES: readonly ["EXECUTION_OUTCOME_UNKNOWN", "ACTION_IN_FLIGHT", "ACTION_NOT_HANDLED", "ACTION_TARGET_UNAVAILABLE", "BROWSER_EXECUTION_FAILED", "BROWSER_SNAPSHOT_REQUIRED", "BROWSER_TOOLS_UNAVAILABLE", "CONTRACT_MISMATCH", "DUPLICATE_BINDING", "INVALID_INPUT", "INVALID_TOOL_RUNTIME", "OPERATION_BUSY", "TOOL_CANCELLED", "TOOL_CONFIRMATION_INVALIDATED", "TOOL_CONFIRMATION_REJECTED", "TOOL_ERROR", "TOOL_REGISTRATION_TIMEOUT", "TOOL_SKIPPED", "TOOL_UNAVAILABLE", "UNKNOWN_TOOL"];
 type AgentToolErrorCode = typeof TOOL_ERROR_CODES[number];
 export declare class AgentToolError extends Error {
     readonly code: AgentToolErrorCode;

package/dist/errors.js

@@ -1,4 +1,5 @@
 export const TOOL_ERROR_CODES = [
+    "EXECUTION_OUTCOME_UNKNOWN",
     "ACTION_IN_FLIGHT",
     "ACTION_NOT_HANDLED",
     "ACTION_TARGET_UNAVAILABLE",

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,kBAAkB;IAClB,oBAAoB;IACpB,2BAA2B;IAC3B,0BAA0B;IAC1B,2BAA2B;IAC3B,2BAA2B;IAC3B,mBAAmB;IACnB,mBAAmB;IACnB,eAAe;IACf,sBAAsB;IACtB,gBAAgB;IAChB,gBAAgB;IAChB,+BAA+B;IAC/B,4BAA4B;IAC5B,YAAY;IACZ,2BAA2B;IAC3B,cAAc;IACd,kBAAkB;IAClB,cAAc;CACN,CAAC;AAIX,MAAM,OAAO,cAAe,SAAQ,KAAK;IAK5B;IAEA;IANF,IAAI,GAAG,oBAA6B,CAAC;IACrC,MAAM,GAAG,MAAe,CAAC;IAElC,YACW,IAAwB,EACjC,OAAe,EACN,OAAiB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,SAAI,GAAJ,IAAI,CAAoB;QAExB,YAAO,GAAP,OAAO,CAAU;QAG1B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF","sourcesContent":["export const TOOL_ERROR_CODES = [\n  \"ACTION_IN_FLIGHT\",\n  \"ACTION_NOT_HANDLED\",\n  \"ACTION_TARGET_UNAVAILABLE\",\n  \"BROWSER_EXECUTION_FAILED\",\n  \"BROWSER_SNAPSHOT_REQUIRED\",\n  \"BROWSER_TOOLS_UNAVAILABLE\",\n  \"CONTRACT_MISMATCH\",\n  \"DUPLICATE_BINDING\",\n  \"INVALID_INPUT\",\n  \"INVALID_TOOL_RUNTIME\",\n  \"OPERATION_BUSY\",\n  \"TOOL_CANCELLED\",\n  \"TOOL_CONFIRMATION_INVALIDATED\",\n  \"TOOL_CONFIRMATION_REJECTED\",\n  \"TOOL_ERROR\",\n  \"TOOL_REGISTRATION_TIMEOUT\",\n  \"TOOL_SKIPPED\",\n  \"TOOL_UNAVAILABLE\",\n  \"UNKNOWN_TOOL\",\n] as const;\n\ntype AgentToolErrorCode = typeof TOOL_ERROR_CODES[number];\n\nexport class AgentToolError extends Error {\n  readonly type = \"tool_runtime_error\" as const;\n  readonly domain = \"tool\" as const;\n\n  constructor(\n    readonly code: AgentToolErrorCode,\n    message: string,\n    readonly details?: unknown,\n  ) {\n    super(message);\n    this.name = \"ToolRuntimeError\";\n  }\n}\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,2BAA2B;IAC3B,kBAAkB;IAClB,oBAAoB;IACpB,2BAA2B;IAC3B,0BAA0B;IAC1B,2BAA2B;IAC3B,2BAA2B;IAC3B,mBAAmB;IACnB,mBAAmB;IACnB,eAAe;IACf,sBAAsB;IACtB,gBAAgB;IAChB,gBAAgB;IAChB,+BAA+B;IAC/B,4BAA4B;IAC5B,YAAY;IACZ,2BAA2B;IAC3B,cAAc;IACd,kBAAkB;IAClB,cAAc;CACN,CAAC;AAIX,MAAM,OAAO,cAAe,SAAQ,KAAK;IAK5B;IAEA;IANF,IAAI,GAAG,oBAA6B,CAAC;IACrC,MAAM,GAAG,MAAe,CAAC;IAElC,YACW,IAAwB,EACjC,OAAe,EACN,OAAiB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,SAAI,GAAJ,IAAI,CAAoB;QAExB,YAAO,GAAP,OAAO,CAAU;QAG1B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF","sourcesContent":["export const TOOL_ERROR_CODES = [\n  \"EXECUTION_OUTCOME_UNKNOWN\",\n  \"ACTION_IN_FLIGHT\",\n  \"ACTION_NOT_HANDLED\",\n  \"ACTION_TARGET_UNAVAILABLE\",\n  \"BROWSER_EXECUTION_FAILED\",\n  \"BROWSER_SNAPSHOT_REQUIRED\",\n  \"BROWSER_TOOLS_UNAVAILABLE\",\n  \"CONTRACT_MISMATCH\",\n  \"DUPLICATE_BINDING\",\n  \"INVALID_INPUT\",\n  \"INVALID_TOOL_RUNTIME\",\n  \"OPERATION_BUSY\",\n  \"TOOL_CANCELLED\",\n  \"TOOL_CONFIRMATION_INVALIDATED\",\n  \"TOOL_CONFIRMATION_REJECTED\",\n  \"TOOL_ERROR\",\n  \"TOOL_REGISTRATION_TIMEOUT\",\n  \"TOOL_SKIPPED\",\n  \"TOOL_UNAVAILABLE\",\n  \"UNKNOWN_TOOL\",\n] as const;\n\ntype AgentToolErrorCode = typeof TOOL_ERROR_CODES[number];\n\nexport class AgentToolError extends Error {\n  readonly type = \"tool_runtime_error\" as const;\n  readonly domain = \"tool\" as const;\n\n  constructor(\n    readonly code: AgentToolErrorCode,\n    message: string,\n    readonly details?: unknown,\n  ) {\n    super(message);\n    this.name = \"ToolRuntimeError\";\n  }\n}\n"]}

package/dist/internal.d.ts

@@ -2,7 +2,7 @@ export { AgentContextError, ToolRuntimeImplementation, ToolRuntimeImplementation
 export type { ToolRuntime as PublicToolRuntime, ToolRuntimeOptions, ToolOperation, InternalToolRuntime, } from "./runtime.js";
 export type { AgentToolExecutionEvent } from "./internal-types.js";
 export { defineSystemAgentTool } from "./definition.js";
-export { browserToolsAvailable, createBrowserToolset, executeActionTool, getSnapshotTool, startPageTransitionTracker, } from "./browser/toolset.js";
+export { browserToolsAvailable, createBrowserToolset, executeActionTool, applyActionTool, getSnapshotTool, startPageTransitionTracker, } from "./browser/toolset.js";
 export { BROWSER_TOOLS_SKILL, serializeBrowserToolsSkill, } from "./browser/prompt.js";
 export type { BrowserToolHandler, PageAutomationOptions, BrowserToolset, PageTransitionSettleResult, PageTransitionTracker, } from "./browser/toolset.js";
 export type * from "./browser/types.js";

package/dist/internal.js

@@ -1,6 +1,6 @@
 export { AgentContextError, ToolRuntimeImplementation, ToolRuntimeImplementation as ToolRuntime, AgentToolError, createToolRuntime, getInternalToolRuntime, } from "./runtime.js";
 export { defineSystemAgentTool } from "./definition.js";
-export { browserToolsAvailable, createBrowserToolset, executeActionTool, getSnapshotTool, startPageTransitionTracker, } from "./browser/toolset.js";
+export { browserToolsAvailable, createBrowserToolset, executeActionTool, applyActionTool, getSnapshotTool, startPageTransitionTracker, } from "./browser/toolset.js";
 export { BROWSER_TOOLS_SKILL, serializeBrowserToolsSkill, } from "./browser/prompt.js";
 export { assertAgentToolInputSchema, validateAgentToolInput } from "./schema.js";
 //# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,IAAI,WAAW,EACxC,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAQtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAW7B,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export {\n  AgentContextError,\n  ToolRuntimeImplementation,\n  ToolRuntimeImplementation as ToolRuntime,\n  AgentToolError,\n  createToolRuntime,\n  getInternalToolRuntime,\n} from \"./runtime.js\";\nexport type {\n  ToolRuntime as PublicToolRuntime,\n  ToolRuntimeOptions,\n  ToolOperation,\n  InternalToolRuntime,\n} from \"./runtime.js\";\nexport type { AgentToolExecutionEvent } from \"./internal-types.js\";\nexport { defineSystemAgentTool } from \"./definition.js\";\nexport {\n  browserToolsAvailable,\n  createBrowserToolset,\n  executeActionTool,\n  getSnapshotTool,\n  startPageTransitionTracker,\n} from \"./browser/toolset.js\";\nexport {\n  BROWSER_TOOLS_SKILL,\n  serializeBrowserToolsSkill,\n} from \"./browser/prompt.js\";\nexport type {\n  BrowserToolHandler,\n  PageAutomationOptions,\n  BrowserToolset,\n  PageTransitionSettleResult,\n  PageTransitionTracker,\n} from \"./browser/toolset.js\";\nexport type * from \"./browser/types.js\";\nexport type { AgentContextRegistration } from \"./types.js\";\n\nexport { assertAgentToolInputSchema, validateAgentToolInput } from \"./schema.js\";\n"]}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,IAAI,WAAW,EACxC,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAQtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAW7B,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export {\n  AgentContextError,\n  ToolRuntimeImplementation,\n  ToolRuntimeImplementation as ToolRuntime,\n  AgentToolError,\n  createToolRuntime,\n  getInternalToolRuntime,\n} from \"./runtime.js\";\nexport type {\n  ToolRuntime as PublicToolRuntime,\n  ToolRuntimeOptions,\n  ToolOperation,\n  InternalToolRuntime,\n} from \"./runtime.js\";\nexport type { AgentToolExecutionEvent } from \"./internal-types.js\";\nexport { defineSystemAgentTool } from \"./definition.js\";\nexport {\n  browserToolsAvailable,\n  createBrowserToolset,\n  executeActionTool,\n  applyActionTool,\n  getSnapshotTool,\n  startPageTransitionTracker,\n} from \"./browser/toolset.js\";\nexport {\n  BROWSER_TOOLS_SKILL,\n  serializeBrowserToolsSkill,\n} from \"./browser/prompt.js\";\nexport type {\n  BrowserToolHandler,\n  PageAutomationOptions,\n  BrowserToolset,\n  PageTransitionSettleResult,\n  PageTransitionTracker,\n} from \"./browser/toolset.js\";\nexport type * from \"./browser/types.js\";\nexport type { AgentContextRegistration } from \"./types.js\";\n\nexport { assertAgentToolInputSchema, validateAgentToolInput } from \"./schema.js\";\n"]}

package/dist/operation-lock.js

@@ -1,4 +1,4 @@
-import { isAgentFocus } from "./browser/focus.js";
+import { isAgentActivation, isAgentFocus } from "./browser/focus.js";
 const lockedSurfaces = new WeakSet();
 export function isOperationSurfaceLocked(surface) {
     return lockedSurfaces.has(surface);
@@ -7,6 +7,8 @@ export function isOperationSurfaceLocked(surface) {
 export function lockOperationSurface(surface, redirectFocus) {
     const previousBusy = surface.getAttribute("aria-busy");
     const block = (event) => {
+        if ((event.type === "submit" || event.type === "reset") && isAgentActivation())
+            return;
         if (!event.isTrusted)
             return;
         if (event.type === "focus" || event.type === "focusin") {

package/dist/operation-lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"operation-lock.js","sourceRoot":"","sources":["../src/operation-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,cAAc,GAAG,IAAI,OAAO,EAAe,CAAC;AAElD,MAAM,UAAU,wBAAwB,CAAC,OAAoB;IAC3D,OAAO,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB,CAAC,OAAoB,EAAE,aAA0B;IACnF,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,CAAC,KAAY,EAAE,EAAE;QAC7B,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,OAAO;QAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACvD,IAAI,YAAY,EAAE;gBAAE,OAAO;YAC3B,KAAK,CAAC,wBAAwB,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,MAAM,YAAY,WAAW;gBAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC7D,aAAa,EAAE,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAK,KAAuB,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;YACvE,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,KAAK,CAAC,wBAAwB,EAAE,CAAC;YACjC,aAAa,EAAE,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,KAAK,CAAC,wBAAwB,EAAE,CAAC;IACnC,CAAC,CAAC;IACF,6EAA6E;IAC7E,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChb,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,MAAM;QAAE,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACpG,OAAO,GAAG,EAAE;QACV,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,MAAM;YAAE,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1E,IAAI,YAAY,KAAK,IAAI;YAAE,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;;YAC3D,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { isAgentFocus } from \"./browser/focus.js\";\n\nconst lockedSurfaces = new WeakSet<HTMLElement>();\n\nexport function isOperationSurfaceLocked(surface: HTMLElement): boolean {\n  return lockedSurfaces.has(surface);\n}\n\n/** Block user input inside the surface without hiding DOM from page tools. */\nexport function lockOperationSurface(surface: HTMLElement, redirectFocus?: () => void): () => void {\n  const previousBusy = surface.getAttribute(\"aria-busy\");\n  const block = (event: Event) => {\n    if (!event.isTrusted) return;\n    if (event.type === \"focus\" || event.type === \"focusin\") {\n      if (isAgentFocus()) return;\n      event.stopImmediatePropagation();\n      if (event.target instanceof HTMLElement) event.target.blur();\n      redirectFocus?.();\n      return;\n    }\n    if (event.type === \"keydown\" && (event as KeyboardEvent).key === \"Tab\") {\n      event.preventDefault();\n      event.stopImmediatePropagation();\n      redirectFocus?.();\n      return;\n    }\n    event.preventDefault();\n    event.stopImmediatePropagation();\n  };\n  // Wheel and touch defaults are blocked here: React delegates them passively.\n  const events = [\"focus\", \"focusin\", \"mouseenter\", \"mouseleave\", \"pointerenter\", \"pointerleave\", \"pointerdown\", \"pointerup\", \"pointermove\", \"pointerover\", \"pointerout\", \"mousedown\", \"mouseup\", \"mousemove\", \"mouseover\", \"mouseout\", \"click\", \"dblclick\", \"auxclick\", \"contextmenu\", \"keydown\", \"keyup\", \"beforeinput\", \"paste\", \"cut\", \"drop\", \"dragstart\", \"touchstart\", \"touchmove\", \"touchend\", \"touchcancel\", \"wheel\", \"submit\", \"reset\"];\n  lockedSurfaces.add(surface);\n  surface.setAttribute(\"aria-busy\", \"true\");\n  for (const name of events) surface.addEventListener(name, block, { capture: true, passive: false });\n  return () => {\n    lockedSurfaces.delete(surface);\n    for (const name of events) surface.removeEventListener(name, block, true);\n    if (previousBusy === null) surface.removeAttribute(\"aria-busy\");\n    else surface.setAttribute(\"aria-busy\", previousBusy);\n  };\n}\n"]}
+{"version":3,"file":"operation-lock.js","sourceRoot":"","sources":["../src/operation-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErE,MAAM,cAAc,GAAG,IAAI,OAAO,EAAe,CAAC;AAElD,MAAM,UAAU,wBAAwB,CAAC,OAAoB;IAC3D,OAAO,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB,CAAC,OAAoB,EAAE,aAA0B;IACnF,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,CAAC,KAAY,EAAE,EAAE;QAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,iBAAiB,EAAE;YAAE,OAAO;QACvF,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,OAAO;QAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACvD,IAAI,YAAY,EAAE;gBAAE,OAAO;YAC3B,KAAK,CAAC,wBAAwB,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,MAAM,YAAY,WAAW;gBAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC7D,aAAa,EAAE,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAK,KAAuB,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;YACvE,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,KAAK,CAAC,wBAAwB,EAAE,CAAC;YACjC,aAAa,EAAE,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,KAAK,CAAC,wBAAwB,EAAE,CAAC;IACnC,CAAC,CAAC;IACF,6EAA6E;IAC7E,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChb,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,MAAM;QAAE,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACpG,OAAO,GAAG,EAAE;QACV,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,MAAM;YAAE,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1E,IAAI,YAAY,KAAK,IAAI;YAAE,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;;YAC3D,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { isAgentActivation, isAgentFocus } from \"./browser/focus.js\";\n\nconst lockedSurfaces = new WeakSet<HTMLElement>();\n\nexport function isOperationSurfaceLocked(surface: HTMLElement): boolean {\n  return lockedSurfaces.has(surface);\n}\n\n/** Block user input inside the surface without hiding DOM from page tools. */\nexport function lockOperationSurface(surface: HTMLElement, redirectFocus?: () => void): () => void {\n  const previousBusy = surface.getAttribute(\"aria-busy\");\n  const block = (event: Event) => {\n    if ((event.type === \"submit\" || event.type === \"reset\") && isAgentActivation()) return;\n    if (!event.isTrusted) return;\n    if (event.type === \"focus\" || event.type === \"focusin\") {\n      if (isAgentFocus()) return;\n      event.stopImmediatePropagation();\n      if (event.target instanceof HTMLElement) event.target.blur();\n      redirectFocus?.();\n      return;\n    }\n    if (event.type === \"keydown\" && (event as KeyboardEvent).key === \"Tab\") {\n      event.preventDefault();\n      event.stopImmediatePropagation();\n      redirectFocus?.();\n      return;\n    }\n    event.preventDefault();\n    event.stopImmediatePropagation();\n  };\n  // Wheel and touch defaults are blocked here: React delegates them passively.\n  const events = [\"focus\", \"focusin\", \"mouseenter\", \"mouseleave\", \"pointerenter\", \"pointerleave\", \"pointerdown\", \"pointerup\", \"pointermove\", \"pointerover\", \"pointerout\", \"mousedown\", \"mouseup\", \"mousemove\", \"mouseover\", \"mouseout\", \"click\", \"dblclick\", \"auxclick\", \"contextmenu\", \"keydown\", \"keyup\", \"beforeinput\", \"paste\", \"cut\", \"drop\", \"dragstart\", \"touchstart\", \"touchmove\", \"touchend\", \"touchcancel\", \"wheel\", \"submit\", \"reset\"];\n  lockedSurfaces.add(surface);\n  surface.setAttribute(\"aria-busy\", \"true\");\n  for (const name of events) surface.addEventListener(name, block, { capture: true, passive: false });\n  return () => {\n    lockedSurfaces.delete(surface);\n    for (const name of events) surface.removeEventListener(name, block, true);\n    if (previousBusy === null) surface.removeAttribute(\"aria-busy\");\n    else surface.setAttribute(\"aria-busy\", previousBusy);\n  };\n}\n"]}

package/dist/operation-runtime.d.ts

@@ -13,7 +13,6 @@ export interface OperationSnapshot {
     readonly source: "host" | "webmcp";
     readonly status: "running" | "waiting" | "cancelling" | "ending";
     readonly hasExecuted: boolean;
-    readonly hasStartedTool: boolean;
     readonly outcome?: "completed" | "failed" | "cancelled";
     readonly reason?: "bridge_disposed";
     readonly canCancel: boolean;

package/dist/operation-runtime.js

@@ -26,7 +26,7 @@ export class OperationTracker {
         const endPromise = new Promise((resolve) => { resolveEnd = resolve; });
         const id = globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random()}`;
         const operation = {
-            snapshot: Object.freeze({ id, source: options.source ?? "host", status: "running", hasExecuted: false, hasStartedTool: options.taskProgress?.phase === "tool", canCancel: Boolean(options.onCancel), ...(options.taskProgress ? { taskProgress: Object.freeze(options.taskProgress) } : {}) }),
+            snapshot: Object.freeze({ id, source: options.source ?? "host", status: "running", hasExecuted: false, canCancel: Boolean(options.onCancel), ...(options.taskProgress ? { taskProgress: Object.freeze(options.taskProgress) } : {}) }),
             handle: undefined, pending: 0, resolveEnd,
             ...(options.onCancel ? { onCancel: options.onCancel } : {}),
             removeAbort: () => options.signal?.removeEventListener("abort", onAbort),
@@ -66,10 +66,7 @@ export class OperationTracker {
         const operation = this.#operation;
         if (operation?.handle !== handle || operation.snapshot.status === "ending")
             return;
-        this.#update(operation, {
-            taskProgress: Object.freeze(progress),
-            hasStartedTool: operation.snapshot.hasStartedTool || progress.phase === "tool",
-        });
+        this.#update(operation, { taskProgress: Object.freeze(progress) });
     }
     disposeBridge(handle) {
         const operation = this.#operation;

package/dist/operation-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"operation-runtime.js","sourceRoot":"","sources":["../src/operation-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentToolExecutionEvent } from \"./internal-types.js\";\nimport { AgentToolError } from \"./errors.js\";\nimport type { ToolOperation } from \"./runtime.js\";\n\nexport type TaskProgress = { readonly phase: \"processing\" } | { readonly phase: \"tool\"; readonly toolCallId: string; readonly progressLabel?: string };\n\nexport interface OperationSnapshot {\n  readonly taskProgress?: TaskProgress;\n  readonly id: string;\n  readonly source: \"host\" | \"webmcp\";\n  readonly status: \"running\" | \"waiting\" | \"cancelling\" | \"ending\";\n  readonly hasExecuted: boolean;\n  readonly hasStartedTool: boolean;\n  readonly outcome?: \"completed\" | \"failed\" | \"cancelled\";\n  readonly reason?: \"bridge_disposed\";\n  readonly canCancel: boolean;\n}\n\nexport interface RuntimeActivitySnapshot {\n  readonly operation: OperationSnapshot | null;\n  readonly executions: readonly AgentToolExecutionEvent[];\n}\n\ntype Operation = {\n  snapshot: OperationSnapshot;\n  handle: ToolOperation;\n  pending: number;\n  onCancel?: () => void;\n  removeAbort(): void;\n  resolveEnd(): void;\n};\n\nexport class OperationTracker {\n  #operation: Operation | undefined;\n  #unscoped = 0;\n  #executions = new Map<string, AgentToolExecutionEvent>();\n  #listeners = new Set<() => void>();\n  #snapshot: RuntimeActivitySnapshot = Object.freeze({ operation: null, executions: Object.freeze([]) });\n\n  getSnapshot = (): RuntimeActivitySnapshot => this.#snapshot;\n  subscribe = (listener: () => void): (() => void) => {\n    this.#listeners.add(listener);\n    return () => { this.#listeners.delete(listener); };\n  };\n\n  begin(options: {\n    signal?: AbortSignal;\n    onCancel?: () => void;\n    source?: \"host\" | \"webmcp\";\n    replaceWaiting?: ToolOperation;\n    taskProgress?: TaskProgress;\n  } = {}): ToolOperation {\n    options.signal?.throwIfAborted();\n    const previous = this.#operation;\n    const replacing = previous && previous.handle === options.replaceWaiting\n      && previous.snapshot.status === \"waiting\" && previous.pending === 0;\n    if (this.#unscoped || (previous && !replacing)) {\n      throw new AgentToolError(\"OPERATION_BUSY\", \"The Runtime already has an operation or outstanding tool calls.\");\n    }\n    if (replacing) {\n      previous.removeAbort();\n      previous.resolveEnd();\n    }\n    let resolveEnd!: () => void;\n    const endPromise = new Promise<void>((resolve) => { resolveEnd = resolve; });\n    const id = globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random()}`;\n    const operation: Operation = {\n      snapshot: Object.freeze({ id, source: options.source ?? \"host\", status: \"running\", hasExecuted: false, hasStartedTool: options.taskProgress?.phase === \"tool\", canCancel: Boolean(options.onCancel), ...(options.taskProgress ? { taskProgress: Object.freeze(options.taskProgress) } : {}) }),\n      handle: undefined!, pending: 0, resolveEnd,\n      ...(options.onCancel ? { onCancel: options.onCancel } : {}),\n      removeAbort: () => options.signal?.removeEventListener(\"abort\", onAbort),\n    };\n    const onAbort = () => {\n      if (this.#operation !== operation || operation.snapshot.status === \"ending\") return;\n      this.#update(operation, { status: \"cancelling\" });\n    };\n    const handle: ToolOperation = Object.freeze({\n      id,\n      setWaitingForUser: (waiting: boolean) => {\n        if (this.#operation !== operation || ![\"running\", \"waiting\"].includes(operation.snapshot.status)) return;\n        const status = waiting ? \"waiting\" : \"running\";\n        if (status !== operation.snapshot.status) this.#update(operation, { status });\n      },\n      end: (endOptions?: { outcome?: \"completed\" | \"failed\" | \"cancelled\" }) => {\n        if (this.#operation !== operation || operation.snapshot.status === \"ending\") return endPromise;\n        operation.removeAbort();\n        operation.snapshot = Object.freeze({ ...operation.snapshot, status: \"ending\", outcome: endOptions?.outcome ?? \"completed\" });\n        this.#publish();\n        if (this.#finish(operation)) this.#publish();\n        return endPromise;\n      },\n    });\n    operation.handle = handle;\n    this.#operation = operation;\n    options.signal?.addEventListener(\"abort\", onAbort, { once: true });\n    this.#publish();\n    return handle;\n  }\n\n  setTaskProgress(handle: ToolOperation, progress: TaskProgress): void {\n    const operation = this.#operation;\n    if (operation?.handle !== handle || operation.snapshot.status === \"ending\") return;\n    this.#update(operation, {\n      taskProgress: Object.freeze(progress),\n      hasStartedTool: operation.snapshot.hasStartedTool || progress.phase === \"tool\",\n    });\n  }\n\n  disposeBridge(handle: ToolOperation): Promise<void> {\n    const operation = this.#operation;\n    if (operation?.handle === handle) operation.snapshot = Object.freeze({ ...operation.snapshot, reason: \"bridge_disposed\" });\n    return handle.end();\n  }\n\n  requestCancel(id: string): void {\n    const operation = this.#operation;\n    if (!operation || operation.snapshot.id !== id || !operation.onCancel\n      || operation.snapshot.status === \"ending\" || operation.snapshot.status === \"cancelling\") return;\n    const previous = operation.snapshot.status;\n    this.#update(operation, { status: \"cancelling\" });\n    try {\n      operation.onCancel();\n    } catch (error) {\n      if (this.#operation === operation && this.#snapshot.operation?.status === \"cancelling\") {\n        this.#update(operation, { status: previous });\n      }\n      throw error;\n    }\n  }\n\n  // Admission is captured before execution and released exactly once, including queued aborts.\n  admit(): { operationId?: string; release(): void } {\n    const operation = this.#operation?.snapshot.status === \"ending\" ? undefined : this.#operation;\n    if (operation) operation.pending += 1;\n    else this.#unscoped += 1;\n    let released = false;\n    return {\n      ...(operation ? { operationId: operation.snapshot.id } : {}),\n      release: () => {\n        if (released) return;\n        released = true;\n        if (operation) {\n          operation.pending -= 1;\n          if (this.#finish(operation)) this.#publish();\n        } else this.#unscoped -= 1;\n      },\n    };\n  }\n\n  observe(event: AgentToolExecutionEvent): void {\n    if (event.status === \"running\") {\n      this.#executions.set(event.id, event);\n      const operation = this.#operation;\n      if (operation && event.operationId === operation.snapshot.id && !operation.snapshot.hasExecuted) {\n        operation.snapshot = Object.freeze({ ...operation.snapshot, hasExecuted: true });\n      }\n    } else this.#executions.delete(event.id);\n    this.#publish();\n  }\n\n  #finish(operation: Operation): boolean {\n    if (operation.pending || operation.snapshot.status !== \"ending\" || this.#operation !== operation) return false;\n    this.#operation = undefined;\n    operation.resolveEnd();\n    return true;\n  }\n\n  #update(operation: Operation, patch: Partial<OperationSnapshot>): void {\n    operation.snapshot = Object.freeze({ ...operation.snapshot, ...patch });\n    this.#publish();\n  }\n\n  #publish(): void {\n    this.#snapshot = Object.freeze({\n      operation: this.#operation?.snapshot ?? null,\n      executions: Object.freeze([...this.#executions.values()]),\n    });\n    for (const listener of this.#listeners) listener();\n  }\n}\n"]}
+{"version":3,"file":"operation-runtime.js","sourceRoot":"","sources":["../src/operation-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentToolExecutionEvent } from \"./internal-types.js\";\nimport { AgentToolError } from \"./errors.js\";\nimport type { ToolOperation } from \"./runtime.js\";\n\nexport type TaskProgress = { readonly phase: \"processing\" } | { readonly phase: \"tool\"; readonly toolCallId: string; readonly progressLabel?: string };\n\nexport interface OperationSnapshot {\n  readonly taskProgress?: TaskProgress;\n  readonly id: string;\n  readonly source: \"host\" | \"webmcp\";\n  readonly status: \"running\" | \"waiting\" | \"cancelling\" | \"ending\";\n  readonly hasExecuted: boolean;\n  readonly outcome?: \"completed\" | \"failed\" | \"cancelled\";\n  readonly reason?: \"bridge_disposed\";\n  readonly canCancel: boolean;\n}\n\nexport interface RuntimeActivitySnapshot {\n  readonly operation: OperationSnapshot | null;\n  readonly executions: readonly AgentToolExecutionEvent[];\n}\n\ntype Operation = {\n  snapshot: OperationSnapshot;\n  handle: ToolOperation;\n  pending: number;\n  onCancel?: () => void;\n  removeAbort(): void;\n  resolveEnd(): void;\n};\n\nexport class OperationTracker {\n  #operation: Operation | undefined;\n  #unscoped = 0;\n  #executions = new Map<string, AgentToolExecutionEvent>();\n  #listeners = new Set<() => void>();\n  #snapshot: RuntimeActivitySnapshot = Object.freeze({ operation: null, executions: Object.freeze([]) });\n\n  getSnapshot = (): RuntimeActivitySnapshot => this.#snapshot;\n  subscribe = (listener: () => void): (() => void) => {\n    this.#listeners.add(listener);\n    return () => { this.#listeners.delete(listener); };\n  };\n\n  begin(options: {\n    signal?: AbortSignal;\n    onCancel?: () => void;\n    source?: \"host\" | \"webmcp\";\n    replaceWaiting?: ToolOperation;\n    taskProgress?: TaskProgress;\n  } = {}): ToolOperation {\n    options.signal?.throwIfAborted();\n    const previous = this.#operation;\n    const replacing = previous && previous.handle === options.replaceWaiting\n      && previous.snapshot.status === \"waiting\" && previous.pending === 0;\n    if (this.#unscoped || (previous && !replacing)) {\n      throw new AgentToolError(\"OPERATION_BUSY\", \"The Runtime already has an operation or outstanding tool calls.\");\n    }\n    if (replacing) {\n      previous.removeAbort();\n      previous.resolveEnd();\n    }\n    let resolveEnd!: () => void;\n    const endPromise = new Promise<void>((resolve) => { resolveEnd = resolve; });\n    const id = globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random()}`;\n    const operation: Operation = {\n      snapshot: Object.freeze({ id, source: options.source ?? \"host\", status: \"running\", hasExecuted: false, canCancel: Boolean(options.onCancel), ...(options.taskProgress ? { taskProgress: Object.freeze(options.taskProgress) } : {}) }),\n      handle: undefined!, pending: 0, resolveEnd,\n      ...(options.onCancel ? { onCancel: options.onCancel } : {}),\n      removeAbort: () => options.signal?.removeEventListener(\"abort\", onAbort),\n    };\n    const onAbort = () => {\n      if (this.#operation !== operation || operation.snapshot.status === \"ending\") return;\n      this.#update(operation, { status: \"cancelling\" });\n    };\n    const handle: ToolOperation = Object.freeze({\n      id,\n      setWaitingForUser: (waiting: boolean) => {\n        if (this.#operation !== operation || ![\"running\", \"waiting\"].includes(operation.snapshot.status)) return;\n        const status = waiting ? \"waiting\" : \"running\";\n        if (status !== operation.snapshot.status) this.#update(operation, { status });\n      },\n      end: (endOptions?: { outcome?: \"completed\" | \"failed\" | \"cancelled\" }) => {\n        if (this.#operation !== operation || operation.snapshot.status === \"ending\") return endPromise;\n        operation.removeAbort();\n        operation.snapshot = Object.freeze({ ...operation.snapshot, status: \"ending\", outcome: endOptions?.outcome ?? \"completed\" });\n        this.#publish();\n        if (this.#finish(operation)) this.#publish();\n        return endPromise;\n      },\n    });\n    operation.handle = handle;\n    this.#operation = operation;\n    options.signal?.addEventListener(\"abort\", onAbort, { once: true });\n    this.#publish();\n    return handle;\n  }\n\n  setTaskProgress(handle: ToolOperation, progress: TaskProgress): void {\n    const operation = this.#operation;\n    if (operation?.handle !== handle || operation.snapshot.status === \"ending\") return;\n    this.#update(operation, { taskProgress: Object.freeze(progress) });\n  }\n\n  disposeBridge(handle: ToolOperation): Promise<void> {\n    const operation = this.#operation;\n    if (operation?.handle === handle) operation.snapshot = Object.freeze({ ...operation.snapshot, reason: \"bridge_disposed\" });\n    return handle.end();\n  }\n\n  requestCancel(id: string): void {\n    const operation = this.#operation;\n    if (!operation || operation.snapshot.id !== id || !operation.onCancel\n      || operation.snapshot.status === \"ending\" || operation.snapshot.status === \"cancelling\") return;\n    const previous = operation.snapshot.status;\n    this.#update(operation, { status: \"cancelling\" });\n    try {\n      operation.onCancel();\n    } catch (error) {\n      if (this.#operation === operation && this.#snapshot.operation?.status === \"cancelling\") {\n        this.#update(operation, { status: previous });\n      }\n      throw error;\n    }\n  }\n\n  // Admission is captured before execution and released exactly once, including queued aborts.\n  admit(): { operationId?: string; release(): void } {\n    const operation = this.#operation?.snapshot.status === \"ending\" ? undefined : this.#operation;\n    if (operation) operation.pending += 1;\n    else this.#unscoped += 1;\n    let released = false;\n    return {\n      ...(operation ? { operationId: operation.snapshot.id } : {}),\n      release: () => {\n        if (released) return;\n        released = true;\n        if (operation) {\n          operation.pending -= 1;\n          if (this.#finish(operation)) this.#publish();\n        } else this.#unscoped -= 1;\n      },\n    };\n  }\n\n  observe(event: AgentToolExecutionEvent): void {\n    if (event.status === \"running\") {\n      this.#executions.set(event.id, event);\n      const operation = this.#operation;\n      if (operation && event.operationId === operation.snapshot.id && !operation.snapshot.hasExecuted) {\n        operation.snapshot = Object.freeze({ ...operation.snapshot, hasExecuted: true });\n      }\n    } else this.#executions.delete(event.id);\n    this.#publish();\n  }\n\n  #finish(operation: Operation): boolean {\n    if (operation.pending || operation.snapshot.status !== \"ending\" || this.#operation !== operation) return false;\n    this.#operation = undefined;\n    operation.resolveEnd();\n    return true;\n  }\n\n  #update(operation: Operation, patch: Partial<OperationSnapshot>): void {\n    operation.snapshot = Object.freeze({ ...operation.snapshot, ...patch });\n    this.#publish();\n  }\n\n  #publish(): void {\n    this.#snapshot = Object.freeze({\n      operation: this.#operation?.snapshot ?? null,\n      executions: Object.freeze([...this.#executions.values()]),\n    });\n    for (const listener of this.#listeners) listener();\n  }\n}\n"]}

package/dist/operation-surface.js

@@ -2,8 +2,9 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
 import { useCallback, useLayoutEffect, useRef, useState, useSyncExternalStore } from "react";
 import { getInternalToolRuntime } from "./runtime.js";
 import { isOperationSurfaceLocked } from "./operation-lock.js";
+import { isAgentActivation } from "./browser/focus.js";
 import { OperationOverlayView } from "./operation-view.js";
-const BROWSER_TOOL_NAMES = new Set(["nxf_getSnapshot", "nxf_executeAction"]);
+const CENTER_BROWSER_TOOL_NAMES = new Set(["nxf_getSnapshot", "nxf_executeAction"]);
 const surfaces = new WeakSet();
 export function AgentOperationSurface(props) {
     const element = useRef(null);
@@ -18,6 +19,8 @@ export function AgentOperationSurface(props) {
         return () => { surfaces.delete(props.toolRuntime); };
     }, [props.toolRuntime]);
     const blockUserInput = useCallback((event) => {
+        if ((event.type === "submit" || event.type === "reset") && isAgentActivation())
+            return;
         if (!element.current || !isOperationSurfaceLocked(element.current) || !event.nativeEvent.isTrusted)
             return;
         event.preventDefault();
@@ -49,6 +52,46 @@ function OperationSurfaceContent({ toolRuntime, element }) {
             setOutcome({ id: current.id, status: current.outcome });
     }), [runtime]);
     const [visual, setVisual] = useState();
+    const pendingPresentation = useRef(undefined);
+    useLayoutEffect(() => {
+        const dispose = runtime.setPageActionPresentation((event, signal) => {
+            const target = runtime.resolveTarget(event.tool, event.input);
+            if (!target || !element.current?.contains(target))
+                return Promise.resolve();
+            return new Promise((resolve, reject) => {
+                let finished = false;
+                const settle = (error) => {
+                    if (finished)
+                        return;
+                    finished = true;
+                    clearTimeout(timer);
+                    signal?.removeEventListener("abort", finish);
+                    if (pendingPresentation.current?.id === event.id)
+                        pendingPresentation.current = undefined;
+                    if (error)
+                        reject(error);
+                    else
+                        resolve();
+                };
+                const finish = () => settle();
+                const timer = setTimeout(finish, 750);
+                pendingPresentation.current = {
+                    id: event.id,
+                    finish,
+                    interrupt: () => settle(new Error("Page action presentation was interrupted.")),
+                };
+                if (signal?.aborted)
+                    finish();
+                else
+                    signal?.addEventListener("abort", finish, { once: true });
+            });
+        });
+        return () => { pendingPresentation.current?.interrupt(); dispose(); };
+    }, [runtime, element]);
+    const onPointerReady = useCallback((id) => {
+        if (pendingPresentation.current?.id === id)
+            pendingPresentation.current.finish();
+    }, []);
     const [history, setHistory] = useState({ scope: "", entries: [] });
     useLayoutEffect(() => {
         const onExecution = (event) => {
@@ -63,9 +106,12 @@ function OperationSurfaceContent({ toolRuntime, element }) {
                     const rect = target.getBoundingClientRect();
                     setVisual({ event, target, position: { left: rect.left + rect.width / 2, top: rect.top + rect.height / 2 } });
                 }
-                else if (BROWSER_TOOL_NAMES.has(event.name)) {
+                else if (CENTER_BROWSER_TOOL_NAMES.has(event.name)) {
                     setVisual({ event });
                 }
+                else if (event.name === "nxf_applyAction") {
+                    setVisual(undefined);
+                }
             }
             else if (canDisplay) {
                 setVisual((current) => current?.event.id === event.id && current.event.operationId === event.operationId
@@ -90,7 +136,7 @@ function OperationSurfaceContent({ toolRuntime, element }) {
             onExecution(event);
         return unsubscribe;
     }, [runtime, toolRuntime, element]);
-    const activated = Boolean(cycle && (cycle.hasStartedTool || cycle.source === "webmcp" || cycle.hasExecuted));
+    const activated = Boolean(cycle && (cycle.source === "webmcp" || cycle.hasExecuted));
     const executing = activity.executions.length > 0;
     const waiting = cycle?.status === "waiting" && !executing;
     const running = executing || (activated && cycle?.status !== "waiting");
@@ -99,7 +145,8 @@ function OperationSurfaceContent({ toolRuntime, element }) {
         if (!running || waiting)
             setVisual(undefined);
     }, [running, waiting]);
-    const currentVisual = !stopping && !waiting && visual && (cycle
+    const serverExecuting = cycle?.taskProgress?.phase === "tool";
+    const currentVisual = !serverExecuting && !stopping && !waiting && visual && (cycle
         ? cycle.status === "running" && visual.event.operationId === cycle.id
         : activity.executions.some((event) => event.id === visual.event.id)) ? visual : undefined;
     const resolveSurface = useCallback(() => element.current ?? undefined, [element]);
@@ -122,10 +169,11 @@ function OperationSurfaceContent({ toolRuntime, element }) {
     } : {
         toolCallId: cycle?.taskProgress?.phase === "tool" ? cycle.taskProgress.toolCallId : cycle?.id ?? history.scope,
         name: "agent",
+        ...(serverExecuting ? { effect: "read" } : {}),
         progressLabel: waiting ? "等待你完成操作" : cycle?.status === "cancelling" ? "正在终止" : cycle?.taskProgress?.phase === "tool" ? cycle.taskProgress.progressLabel || "正在执行工具" : cycle?.taskProgress ? "正在处理" : "正在处理你的请求",
         status: running || waiting ? "running" : outcome?.id === history.scope ? outcome.status : "completed",
     };
     const entries = !cycle || history.scope === cycle.id ? history.entries : [];
-    return activated || executing || entries.length ? _jsx(OperationOverlayView, { operation: operation, progressHistory: entries, running: running, feedbackActive: Boolean(currentVisual) && running && !waiting && !stopping, humanHasControl: waiting, ...(cycle?.canCancel ? { onCancel: () => runtime.requestOperationCancel(cycle.id) } : {}), cancelling: cycle?.status === "cancelling" || cycle?.status === "ending", ...(currentVisual?.position ? { fallbackPosition: currentVisual.position } : {}), resolveSurface: resolveSurface, resolveTarget: resolveTarget }) : null;
+    return activated || executing || entries.length ? _jsx(OperationOverlayView, { operation: operation, progressHistory: entries, running: running, feedbackActive: Boolean(currentVisual || serverExecuting) && running && !waiting && !stopping, humanHasControl: waiting, ...(cycle?.canCancel ? { onCancel: () => runtime.requestOperationCancel(cycle.id) } : {}), cancelling: cycle?.status === "cancelling" || cycle?.status === "ending", ...(currentVisual?.position ? { fallbackPosition: currentVisual.position } : {}), resolveSurface: resolveSurface, resolveTarget: resolveTarget, onPointerReady: onPointerReady }) : null;
 }
 //# sourceMappingURL=operation-surface.js.map

package/dist/operation-surface.js.map

@@ -1 +1 @@
-{"version":3,"file":"operation-surface.js","sourceRoot":"","sources":["../src/operation-surface.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useLayoutEffect, useRef, useState, useSyncExternalStore, type ReactNode, type RefObject, type SyntheticEvent } from \"react\";\nimport type { AgentToolExecutionEvent } from \"./internal-types.js\";\nimport { getInternalToolRuntime, type ToolRuntime } from \"./runtime.js\";\nimport { isOperationSurfaceLocked } from \"./operation-lock.js\";\nimport { OperationOverlayView } from \"./operation-view.js\";\nimport type { AgentOperation, AgentOperationProgressEntry } from \"./operation-types.js\";\n\nconst BROWSER_TOOL_NAMES = new Set([\"nxf_getSnapshot\", \"nxf_executeAction\"]);\n\nexport interface AgentOperationSurfaceProps {\n  toolRuntime: ToolRuntime;\n  children: ReactNode;\n}\n\nconst surfaces = new WeakSet<ToolRuntime>();\n\nexport function AgentOperationSurface(props: AgentOperationSurfaceProps) {\n  const element = useRef<HTMLDivElement>(null);\n  const initial = useRef(props.toolRuntime);\n  if (initial.current !== props.toolRuntime) {\n    throw new Error(\"AgentOperationSurface requires a stable Runtime. Remount it to change Runtime.\");\n  }\n  useLayoutEffect(() => {\n    if (surfaces.has(props.toolRuntime)) throw new Error(\"Only one AgentOperationSurface is supported per Runtime.\");\n    surfaces.add(props.toolRuntime);\n    return () => { surfaces.delete(props.toolRuntime); };\n  }, [props.toolRuntime]);\n  const blockUserInput = useCallback((event: SyntheticEvent) => {\n    if (!element.current || !isOperationSurfaceLocked(element.current) || !event.nativeEvent.isTrusted) return;\n    event.preventDefault();\n    event.stopPropagation();\n  }, []);\n  const blockPassiveUserInput = useCallback((event: SyntheticEvent) => {\n    if (!element.current || !isOperationSurfaceLocked(element.current) || !event.nativeEvent.isTrusted) return;\n    // Stop React's capture dispatch, but let the native event reach our non-passive\n    // surface listener. React's passive root listener cannot prevent scrolling.\n    event.isPropagationStopped = () => true;\n  }, []);\n  return <>\n    <div ref={element} className=\"nexface-operation-surface\"\n      onClickCapture={blockUserInput} onDoubleClickCapture={blockUserInput} onAuxClickCapture={blockUserInput}\n      onPointerDownCapture={blockUserInput} onPointerUpCapture={blockUserInput}\n      onPointerMoveCapture={blockUserInput} onPointerOverCapture={blockUserInput} onPointerOutCapture={blockUserInput}\n      onMouseDownCapture={blockUserInput} onMouseUpCapture={blockUserInput} onContextMenuCapture={blockUserInput}\n      onMouseMoveCapture={blockUserInput} onMouseOverCapture={blockUserInput} onMouseOutCapture={blockUserInput}\n      onWheelCapture={blockPassiveUserInput} onTouchStartCapture={blockPassiveUserInput} onTouchMoveCapture={blockPassiveUserInput}\n      onTouchEndCapture={blockUserInput} onTouchCancelCapture={blockUserInput}\n      onKeyDownCapture={blockUserInput} onKeyUpCapture={blockUserInput} onKeyPressCapture={blockUserInput}\n      onBeforeInputCapture={blockUserInput} onPasteCapture={blockUserInput} onCutCapture={blockUserInput}\n      onDropCapture={blockUserInput} onDragStartCapture={blockUserInput}\n      onSubmitCapture={blockUserInput} onResetCapture={blockUserInput}\n    >{props.children}</div>\n    <OperationSurfaceContent {...props} element={element} />\n  </>;\n}\n\nfunction OperationSurfaceContent({ toolRuntime, element }: AgentOperationSurfaceProps & { element: RefObject<HTMLDivElement | null> }) {\n  const runtime = getInternalToolRuntime(toolRuntime);\n  const activity = useSyncExternalStore(runtime.subscribeActivity, runtime.getActivitySnapshot, runtime.getActivitySnapshot);\n  const cycle = activity.operation;\n  const [outcome, setOutcome] = useState<{ id: string; status: \"completed\" | \"failed\" | \"cancelled\" }>();\n  useLayoutEffect(() => runtime.subscribeActivity(() => {\n    const current = runtime.getActivitySnapshot().operation;\n    // Task progress does not replace page feedback. Only lifecycle boundaries clear it.\n    setVisual((visual) => {\n      if (current) return current.status === \"running\" && visual?.event.operationId === current.id ? visual : undefined;\n      return visual && runtime.getActivitySnapshot().executions.some((event) => event.id === visual.event.id) ? visual : undefined;\n    });\n    if (current?.status === \"ending\" && current.outcome) setOutcome({ id: current.id, status: current.outcome });\n  }), [runtime]);\n  const [visual, setVisual] = useState<{ event: AgentToolExecutionEvent; target?: HTMLElement; position?: { left: number; top: number } }>();\n  const [history, setHistory] = useState<{ scope: string; entries: AgentOperationProgressEntry[] }>({ scope: \"\", entries: [] });\n  useLayoutEffect(() => {\n    const onExecution = (event: AgentToolExecutionEvent) => {\n      const scope = event.operationId ?? event.id;\n      const operation = runtime.getActivitySnapshot().operation;\n      const canDisplay = !event.operationId || (operation?.id === event.operationId && operation.status === \"running\");\n      if (canDisplay && event.status === \"running\") {\n        const target = event.tool.definition.effect === \"navigate\"\n          ? element.current\n          : runtime.resolveTarget(event.tool, event.input);\n        if (target?.isConnected && element.current?.contains(target)) {\n          const rect = target.getBoundingClientRect();\n          setVisual({ event, target, position: { left: rect.left + rect.width / 2, top: rect.top + rect.height / 2 } });\n        } else if (BROWSER_TOOL_NAMES.has(event.name)) {\n          setVisual({ event });\n        }\n      } else if (canDisplay) {\n        setVisual((current) => current?.event.id === event.id && current.event.operationId === event.operationId\n          ? { ...current, event: { ...current.event, ...event } }\n          : current);\n      }\n      setHistory((current) => {\n        if ((operation && event.operationId !== operation.id) || (event.status !== \"running\" && current.scope !== scope)) return current;\n        const entries = current.scope === scope ? current.entries : [];\n        const entry = {\n          toolCallId: event.id,\n          progressLabel: `${event.progressLabel || \"正在处理你的请求\"} · ${event.cancelled ? \"已取消\" : event.status === \"running\" ? \"执行中\" : event.status === \"success\" ? \"已完成\" : \"失败\"}`,\n        };\n        return { scope, entries: entries.some((item) => item.toolCallId === event.id)\n          ? entries.map((item) => item.toolCallId === event.id ? entry : item)\n          : [...entries, entry] };\n      });\n    };\n    const unsubscribe = toolRuntime.on(\"toolexecution\", onExecution);\n    for (const event of runtime.getActivitySnapshot().executions) onExecution(event);\n    return unsubscribe;\n  }, [runtime, toolRuntime, element]);\n  const activated = Boolean(cycle && (cycle.hasStartedTool || cycle.source === \"webmcp\" || cycle.hasExecuted));\n  const executing = activity.executions.length > 0;\n  const waiting = cycle?.status === \"waiting\" && !executing;\n  const running = executing || (activated && cycle?.status !== \"waiting\");\n  const stopping = cycle?.status === \"cancelling\" || cycle?.status === \"ending\";\n  useLayoutEffect(() => {\n    if (!running || waiting) setVisual(undefined);\n  }, [running, waiting]);\n  const currentVisual = !stopping && !waiting && visual && (cycle\n    ? cycle.status === \"running\" && visual.event.operationId === cycle.id\n    : activity.executions.some((event) => event.id === visual.event.id)) ? visual : undefined;\n  const resolveSurface = useCallback(() => element.current ?? undefined, [element]);\n  const resolveTarget = useCallback(() => {\n    if (!currentVisual) return undefined;\n    const target = currentVisual.target;\n    if (target?.isConnected && element.current?.contains(target)\n      && (currentVisual.event.tool.definition.effect === \"navigate\" || toolRuntime.getTools().includes(currentVisual.event.tool))) return { element: target };\n    return undefined;\n  }, [currentVisual, element, toolRuntime]);\n  const operation: AgentOperation = currentVisual ? {\n    toolCallId: currentVisual.event.id,\n    name: currentVisual.event.name,\n    input: currentVisual.event.input,\n    effect: currentVisual.event.tool.definition.effect,\n    progressLabel: currentVisual.event.progressLabel || \"正在处理你的请求\",\n    status: currentVisual.event.status === \"running\" ? \"running\" : currentVisual.event.status === \"success\" ? \"completed\" : \"failed\",\n  } : {\n    toolCallId: cycle?.taskProgress?.phase === \"tool\" ? cycle.taskProgress.toolCallId : cycle?.id ?? history.scope,\n    name: \"agent\",\n    progressLabel: waiting ? \"等待你完成操作\" : cycle?.status === \"cancelling\" ? \"正在终止\" : cycle?.taskProgress?.phase === \"tool\" ? cycle.taskProgress.progressLabel || \"正在执行工具\" : cycle?.taskProgress ? \"正在处理\" : \"正在处理你的请求\",\n    status: running || waiting ? \"running\" : outcome?.id === history.scope ? outcome.status : \"completed\",\n  };\n  const entries = !cycle || history.scope === cycle.id ? history.entries : [];\n  return activated || executing || entries.length ? <OperationOverlayView\n    operation={operation}\n    progressHistory={entries}\n    running={running}\n    feedbackActive={Boolean(currentVisual) && running && !waiting && !stopping}\n    humanHasControl={waiting}\n    {...(cycle?.canCancel ? { onCancel: () => runtime.requestOperationCancel(cycle.id) } : {})}\n    cancelling={cycle?.status === \"cancelling\" || cycle?.status === \"ending\"}\n    {...(currentVisual?.position ? { fallbackPosition: currentVisual.position } : {})}\n    resolveSurface={resolveSurface}\n    resolveTarget={resolveTarget}\n  /> : null;\n}\n"]}
+{"version":3,"file":"operation-surface.js","sourceRoot":"","sources":["../src/operation-surface.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useLayoutEffect, useRef, useState, useSyncExternalStore, type ReactNode, type RefObject, type SyntheticEvent } from \"react\";\nimport type { AgentToolExecutionEvent } from \"./internal-types.js\";\nimport { getInternalToolRuntime, type ToolRuntime } from \"./runtime.js\";\nimport { isOperationSurfaceLocked } from \"./operation-lock.js\";\nimport { isAgentActivation } from \"./browser/focus.js\";\nimport { OperationOverlayView } from \"./operation-view.js\";\nimport type { AgentOperation, AgentOperationProgressEntry } from \"./operation-types.js\";\n\nconst CENTER_BROWSER_TOOL_NAMES = new Set([\"nxf_getSnapshot\", \"nxf_executeAction\"]);\n\nexport interface AgentOperationSurfaceProps {\n  toolRuntime: ToolRuntime;\n  children: ReactNode;\n}\n\nconst surfaces = new WeakSet<ToolRuntime>();\n\nexport function AgentOperationSurface(props: AgentOperationSurfaceProps) {\n  const element = useRef<HTMLDivElement>(null);\n  const initial = useRef(props.toolRuntime);\n  if (initial.current !== props.toolRuntime) {\n    throw new Error(\"AgentOperationSurface requires a stable Runtime. Remount it to change Runtime.\");\n  }\n  useLayoutEffect(() => {\n    if (surfaces.has(props.toolRuntime)) throw new Error(\"Only one AgentOperationSurface is supported per Runtime.\");\n    surfaces.add(props.toolRuntime);\n    return () => { surfaces.delete(props.toolRuntime); };\n  }, [props.toolRuntime]);\n  const blockUserInput = useCallback((event: SyntheticEvent) => {\n    if ((event.type === \"submit\" || event.type === \"reset\") && isAgentActivation()) return;\n    if (!element.current || !isOperationSurfaceLocked(element.current) || !event.nativeEvent.isTrusted) return;\n    event.preventDefault();\n    event.stopPropagation();\n  }, []);\n  const blockPassiveUserInput = useCallback((event: SyntheticEvent) => {\n    if (!element.current || !isOperationSurfaceLocked(element.current) || !event.nativeEvent.isTrusted) return;\n    // Stop React's capture dispatch, but let the native event reach our non-passive\n    // surface listener. React's passive root listener cannot prevent scrolling.\n    event.isPropagationStopped = () => true;\n  }, []);\n  return <>\n    <div ref={element} className=\"nexface-operation-surface\"\n      onClickCapture={blockUserInput} onDoubleClickCapture={blockUserInput} onAuxClickCapture={blockUserInput}\n      onPointerDownCapture={blockUserInput} onPointerUpCapture={blockUserInput}\n      onPointerMoveCapture={blockUserInput} onPointerOverCapture={blockUserInput} onPointerOutCapture={blockUserInput}\n      onMouseDownCapture={blockUserInput} onMouseUpCapture={blockUserInput} onContextMenuCapture={blockUserInput}\n      onMouseMoveCapture={blockUserInput} onMouseOverCapture={blockUserInput} onMouseOutCapture={blockUserInput}\n      onWheelCapture={blockPassiveUserInput} onTouchStartCapture={blockPassiveUserInput} onTouchMoveCapture={blockPassiveUserInput}\n      onTouchEndCapture={blockUserInput} onTouchCancelCapture={blockUserInput}\n      onKeyDownCapture={blockUserInput} onKeyUpCapture={blockUserInput} onKeyPressCapture={blockUserInput}\n      onBeforeInputCapture={blockUserInput} onPasteCapture={blockUserInput} onCutCapture={blockUserInput}\n      onDropCapture={blockUserInput} onDragStartCapture={blockUserInput}\n      onSubmitCapture={blockUserInput} onResetCapture={blockUserInput}\n    >{props.children}</div>\n    <OperationSurfaceContent {...props} element={element} />\n  </>;\n}\n\nfunction OperationSurfaceContent({ toolRuntime, element }: AgentOperationSurfaceProps & { element: RefObject<HTMLDivElement | null> }) {\n  const runtime = getInternalToolRuntime(toolRuntime);\n  const activity = useSyncExternalStore(runtime.subscribeActivity, runtime.getActivitySnapshot, runtime.getActivitySnapshot);\n  const cycle = activity.operation;\n  const [outcome, setOutcome] = useState<{ id: string; status: \"completed\" | \"failed\" | \"cancelled\" }>();\n  useLayoutEffect(() => runtime.subscribeActivity(() => {\n    const current = runtime.getActivitySnapshot().operation;\n    // Task progress does not replace page feedback. Only lifecycle boundaries clear it.\n    setVisual((visual) => {\n      if (current) return current.status === \"running\" && visual?.event.operationId === current.id ? visual : undefined;\n      return visual && runtime.getActivitySnapshot().executions.some((event) => event.id === visual.event.id) ? visual : undefined;\n    });\n    if (current?.status === \"ending\" && current.outcome) setOutcome({ id: current.id, status: current.outcome });\n  }), [runtime]);\n  const [visual, setVisual] = useState<{ event: AgentToolExecutionEvent; target?: HTMLElement; position?: { left: number; top: number } }>();\n  const pendingPresentation = useRef<{ id: string; finish(): void; interrupt(): void } | undefined>(undefined);\n  useLayoutEffect(() => {\n    const dispose = runtime.setPageActionPresentation((event, signal) => {\n      const target = runtime.resolveTarget(event.tool, event.input);\n      if (!target || !element.current?.contains(target)) return Promise.resolve();\n      return new Promise<void>((resolve, reject) => {\n        let finished = false;\n        const settle = (error?: Error) => {\n          if (finished) return;\n          finished = true;\n          clearTimeout(timer);\n          signal?.removeEventListener(\"abort\", finish);\n          if (pendingPresentation.current?.id === event.id) pendingPresentation.current = undefined;\n          if (error) reject(error);\n          else resolve();\n        };\n        const finish = () => settle();\n        const timer = setTimeout(finish, 750);\n        pendingPresentation.current = {\n          id: event.id,\n          finish,\n          interrupt: () => settle(new Error(\"Page action presentation was interrupted.\")),\n        };\n        if (signal?.aborted) finish();\n        else signal?.addEventListener(\"abort\", finish, { once: true });\n      });\n    });\n    return () => { pendingPresentation.current?.interrupt(); dispose(); };\n  }, [runtime, element]);\n  const onPointerReady = useCallback((id: string) => {\n    if (pendingPresentation.current?.id === id) pendingPresentation.current.finish();\n  }, []);\n  const [history, setHistory] = useState<{ scope: string; entries: AgentOperationProgressEntry[] }>({ scope: \"\", entries: [] });\n  useLayoutEffect(() => {\n    const onExecution = (event: AgentToolExecutionEvent) => {\n      const scope = event.operationId ?? event.id;\n      const operation = runtime.getActivitySnapshot().operation;\n      const canDisplay = !event.operationId || (operation?.id === event.operationId && operation.status === \"running\");\n      if (canDisplay && event.status === \"running\") {\n        const target = event.tool.definition.effect === \"navigate\"\n          ? element.current\n          : runtime.resolveTarget(event.tool, event.input);\n        if (target?.isConnected && element.current?.contains(target)) {\n          const rect = target.getBoundingClientRect();\n          setVisual({ event, target, position: { left: rect.left + rect.width / 2, top: rect.top + rect.height / 2 } });\n        } else if (CENTER_BROWSER_TOOL_NAMES.has(event.name)) {\n          setVisual({ event });\n        } else if (event.name === \"nxf_applyAction\") {\n          setVisual(undefined);\n        }\n      } else if (canDisplay) {\n        setVisual((current) => current?.event.id === event.id && current.event.operationId === event.operationId\n          ? { ...current, event: { ...current.event, ...event } }\n          : current);\n      }\n      setHistory((current) => {\n        if ((operation && event.operationId !== operation.id) || (event.status !== \"running\" && current.scope !== scope)) return current;\n        const entries = current.scope === scope ? current.entries : [];\n        const entry = {\n          toolCallId: event.id,\n          progressLabel: `${event.progressLabel || \"正在处理你的请求\"} · ${event.cancelled ? \"已取消\" : event.status === \"running\" ? \"执行中\" : event.status === \"success\" ? \"已完成\" : \"失败\"}`,\n        };\n        return { scope, entries: entries.some((item) => item.toolCallId === event.id)\n          ? entries.map((item) => item.toolCallId === event.id ? entry : item)\n          : [...entries, entry] };\n      });\n    };\n    const unsubscribe = toolRuntime.on(\"toolexecution\", onExecution);\n    for (const event of runtime.getActivitySnapshot().executions) onExecution(event);\n    return unsubscribe;\n  }, [runtime, toolRuntime, element]);\n  const activated = Boolean(cycle && (cycle.source === \"webmcp\" || cycle.hasExecuted));\n  const executing = activity.executions.length > 0;\n  const waiting = cycle?.status === \"waiting\" && !executing;\n  const running = executing || (activated && cycle?.status !== \"waiting\");\n  const stopping = cycle?.status === \"cancelling\" || cycle?.status === \"ending\";\n  useLayoutEffect(() => {\n    if (!running || waiting) setVisual(undefined);\n  }, [running, waiting]);\n  const serverExecuting = cycle?.taskProgress?.phase === \"tool\";\n  const currentVisual = !serverExecuting && !stopping && !waiting && visual && (cycle\n    ? cycle.status === \"running\" && visual.event.operationId === cycle.id\n    : activity.executions.some((event) => event.id === visual.event.id)) ? visual : undefined;\n  const resolveSurface = useCallback(() => element.current ?? undefined, [element]);\n  const resolveTarget = useCallback(() => {\n    if (!currentVisual) return undefined;\n    const target = currentVisual.target;\n    if (target?.isConnected && element.current?.contains(target)\n      && (currentVisual.event.tool.definition.effect === \"navigate\" || toolRuntime.getTools().includes(currentVisual.event.tool))) return { element: target };\n    return undefined;\n  }, [currentVisual, element, toolRuntime]);\n  const operation: AgentOperation = currentVisual ? {\n    toolCallId: currentVisual.event.id,\n    name: currentVisual.event.name,\n    input: currentVisual.event.input,\n    effect: currentVisual.event.tool.definition.effect,\n    progressLabel: currentVisual.event.progressLabel || \"正在处理你的请求\",\n    status: currentVisual.event.status === \"running\" ? \"running\" : currentVisual.event.status === \"success\" ? \"completed\" : \"failed\",\n  } : {\n    toolCallId: cycle?.taskProgress?.phase === \"tool\" ? cycle.taskProgress.toolCallId : cycle?.id ?? history.scope,\n    name: \"agent\",\n    ...(serverExecuting ? { effect: \"read\" as const } : {}),\n    progressLabel: waiting ? \"等待你完成操作\" : cycle?.status === \"cancelling\" ? \"正在终止\" : cycle?.taskProgress?.phase === \"tool\" ? cycle.taskProgress.progressLabel || \"正在执行工具\" : cycle?.taskProgress ? \"正在处理\" : \"正在处理你的请求\",\n    status: running || waiting ? \"running\" : outcome?.id === history.scope ? outcome.status : \"completed\",\n  };\n  const entries = !cycle || history.scope === cycle.id ? history.entries : [];\n  return activated || executing || entries.length ? <OperationOverlayView\n    operation={operation}\n    progressHistory={entries}\n    running={running}\n    feedbackActive={Boolean(currentVisual || serverExecuting) && running && !waiting && !stopping}\n    humanHasControl={waiting}\n    {...(cycle?.canCancel ? { onCancel: () => runtime.requestOperationCancel(cycle.id) } : {})}\n    cancelling={cycle?.status === \"cancelling\" || cycle?.status === \"ending\"}\n    {...(currentVisual?.position ? { fallbackPosition: currentVisual.position } : {})}\n    resolveSurface={resolveSurface}\n    resolveTarget={resolveTarget}\n    onPointerReady={onPointerReady}\n  /> : null;\n}\n"]}

package/dist/operation-view.d.ts

@@ -15,6 +15,7 @@ export interface OperationOverlayViewProps {
     onCancel?(): void;
     resolveSurface?(): HTMLElement | undefined;
     resolveTarget?(operation: AgentOperation): AgentOperationTarget | undefined;
+    onPointerReady?(toolCallId: string): void;
 }
-export declare function OperationOverlayView({ operation, progressHistory, running, feedbackActive, labelActive, humanHasControl, cancelling, onCancel, resolveSurface, resolveTarget, fallbackPosition }: OperationOverlayViewProps): import("react").ReactPortal | null;
+export declare function OperationOverlayView({ operation, progressHistory, running, feedbackActive, labelActive, humanHasControl, cancelling, onCancel, resolveSurface, resolveTarget, fallbackPosition, onPointerReady }: OperationOverlayViewProps): import("react").ReactPortal | null;
 export {};