@nexface/tools 0.1.14 → 0.1.15-alpha.1

package/dist/operation-runtime.js

@@ -4,24 +4,17 @@ export class OperationTracker {
     #unscoped = 0;
     #executions = new Map();
     #listeners = new Set();
-    #snapshot = Object.freeze({
-        operation: null,
-        executions: Object.freeze([]),
-    });
+    #snapshot = Object.freeze({ operation: null, executions: Object.freeze([]) });
     getSnapshot = () => this.#snapshot;
     subscribe = (listener) => {
         this.#listeners.add(listener);
-        return () => {
-            this.#listeners.delete(listener);
-        };
+        return () => { this.#listeners.delete(listener); };
     };
     begin(options = {}) {
         options.signal?.throwIfAborted();
         const previous = this.#operation;
-        const replacing = previous &&
-            previous.handle === options.replaceWaiting &&
-            previous.snapshot.status === "waiting" &&
-            previous.pending === 0;
+        const replacing = previous && previous.handle === options.replaceWaiting
+            && previous.snapshot.status === "waiting" && previous.pending === 0;
         if (this.#unscoped || (previous && !replacing)) {
             throw new AgentToolError("OPERATION_BUSY", "The Runtime already has an operation or outstanding tool calls.");
         }
@@ -30,22 +23,11 @@ export class OperationTracker {
             previous.resolveEnd();
         }
         let resolveEnd;
-        const endPromise = new Promise((resolve) => {
-            resolveEnd = resolve;
-        });
+        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,
-                canCancel: Boolean(options.onCancel),
-                ...(options.taskProgress ? { taskProgress: Object.freeze(options.taskProgress) } : {}),
-            }),
-            handle: undefined,
-            pending: 0,
-            resolveEnd,
+            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),
         };
@@ -60,11 +42,7 @@ export class OperationTracker {
                 if (this.#operation !== operation || operation.snapshot.status === "ending")
                     return endPromise;
                 operation.removeAbort();
-                operation.snapshot = Object.freeze({
-                    ...operation.snapshot,
-                    status: "ending",
-                    outcome: endOptions?.outcome ?? "completed",
-                });
+                operation.snapshot = Object.freeze({ ...operation.snapshot, status: "ending", outcome: endOptions?.outcome ?? "completed" });
                 this.#publish();
                 if (this.#finish(operation))
                     this.#publish();
@@ -99,11 +77,8 @@ export class OperationTracker {
     }
     requestCancel(id) {
         const operation = this.#operation;
-        if (!operation ||
-            operation.snapshot.id !== id ||
-            !operation.onCancel ||
-            operation.snapshot.status === "ending" ||
-            operation.snapshot.status === "cancelling")
+        if (!operation || operation.snapshot.id !== id || !operation.onCancel
+            || operation.snapshot.status === "ending" || operation.snapshot.status === "cancelling")
             return;
         const previous = operation.snapshot.status;
         this.#update(operation, { status: "cancelling" });
@@ -148,9 +123,7 @@ export class OperationTracker {
         if (event.status === "running") {
             this.#executions.set(event.id, event);
             const operation = this.#operation;
-            if (operation &&
-                event.operationId === operation.snapshot.id &&
-                !operation.snapshot.hasExecuted) {
+            if (operation && event.operationId === operation.snapshot.id && !operation.snapshot.hasExecuted) {
                 operation.snapshot = Object.freeze({ ...operation.snapshot, hasExecuted: true });
             }
         }
@@ -159,9 +132,7 @@ export class OperationTracker {
         this.#publish();
     }
     #finish(operation) {
-        if (operation.pending ||
-            operation.snapshot.status !== "ending" ||
-            this.#operation !== operation)
+        if (operation.pending || operation.snapshot.status !== "ending" || this.#operation !== operation)
             return false;
         this.#operation = undefined;
         operation.resolveEnd();
@@ -180,3 +151,4 @@ export class OperationTracker {
             listener();
     }
 }
+//# sourceMappingURL=operation-runtime.js.map

package/dist/operation-runtime.js.map

@@ -0,0 +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 \"./shared/errors.js\";\nimport type { ToolOperation } from \"./runtime.js\";\n\nimport type { TaskProgress } from \"./shared/runtime-controller.js\";\nexport type { TaskProgress } from \"./shared/runtime-controller.js\";\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      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  setWaitingForUser(handle: ToolOperation, waiting: boolean): void {\n    const operation = this.#operation;\n    if (operation?.handle !== handle || ![\"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\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;\n    if (operation?.snapshot.status === \"ending\") {\n      throw new AgentToolError(\"OPERATION_BUSY\", \"The Runtime operation is ending; wait for end() before submitting more calls.\");\n    }\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

@@ -1,6 +1,6 @@
 import * as React from "react";
 import { flushSync } from "react-dom";
-import { useCallback, useLayoutEffect, useRef, useState, } from "react";
+import { useCallback, useLayoutEffect, useRef, useState } from "react";
 import { useSyncExternalStore } from "use-sync-external-store/shim";
 import { PageCommandError } from "./browser/locator.js";
 import { getInternalToolRuntime } from "./runtime.js";
@@ -9,8 +9,7 @@ import { isAgentActivation } from "./browser/focus.js";
 import { OperationOverlayView } from "./operation-view.js";
 const BROWSER_TOOL_NAMES = new Set(["nxf_getSnapshot", "nxf_executeAction", "nxf_applyAction"]);
 const belongsToOperation = (event, operation) => !operation || event.operationId === operation.id;
-const canPresentInOperation = (event, operation) => belongsToOperation(event, operation) &&
-    (!operation || operation.status === "running" || operation.status === "ending");
+const canPresentInOperation = (event, operation) => belongsToOperation(event, operation) && (!operation || operation.status === "running" || operation.status === "ending");
 const surfaces = new WeakSet();
 export function AgentOperationSurface(props) {
     const element = useRef(null);
@@ -22,34 +21,28 @@ export function AgentOperationSurface(props) {
         if (surfaces.has(props.toolRuntime))
             throw new Error("Only one AgentOperationSurface is supported per Runtime.");
         surfaces.add(props.toolRuntime);
-        return () => {
-            surfaces.delete(props.toolRuntime);
-        };
+        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)
+        if (!element.current || !isOperationSurfaceLocked(element.current) || !event.nativeEvent.isTrusted)
             return;
         event.preventDefault();
         event.stopPropagation();
     }, []);
     const blockPassiveUserInput = useCallback((event) => {
-        if (!element.current ||
-            !isOperationSurfaceLocked(element.current) ||
-            !event.nativeEvent.isTrusted)
+        if (!element.current || !isOperationSurfaceLocked(element.current) || !event.nativeEvent.isTrusted)
             return;
         // Stop React's capture dispatch, but let the native event reach our non-passive
         // surface listener. React's passive root listener cannot prevent scrolling.
         event.isPropagationStopped = () => true;
     }, []);
-    return (React.createElement(React.Fragment, null,
+    return React.createElement(React.Fragment, null,
         React.createElement("div", { ref: element, className: "nexface-operation-surface", onClickCapture: blockUserInput, onDoubleClickCapture: blockUserInput, onAuxClickCapture: blockUserInput, onPointerDownCapture: blockUserInput, onPointerUpCapture: blockUserInput, onPointerMoveCapture: blockUserInput, onPointerOverCapture: blockUserInput, onPointerOutCapture: blockUserInput, onMouseDownCapture: blockUserInput, onMouseUpCapture: blockUserInput, onContextMenuCapture: blockUserInput, onMouseMoveCapture: blockUserInput, onMouseOverCapture: blockUserInput, onMouseOutCapture: blockUserInput, onWheelCapture: blockPassiveUserInput, onTouchStartCapture: blockPassiveUserInput, onTouchMoveCapture: blockPassiveUserInput, onTouchEndCapture: blockUserInput, onTouchCancelCapture: blockUserInput, onKeyDownCapture: blockUserInput, onKeyUpCapture: blockUserInput, onKeyPressCapture: blockUserInput, onBeforeInputCapture: blockUserInput, onPasteCapture: blockUserInput, onCutCapture: blockUserInput, onDropCapture: blockUserInput, onDragStartCapture: blockUserInput, onSubmitCapture: blockUserInput, onResetCapture: blockUserInput }, props.children),
-        React.createElement(OperationSurfaceContent, { ...props, element: element })));
+        React.createElement(OperationSurfaceContent, { ...props, element: element }));
 }
-function OperationSurfaceContent({ toolRuntime, element, }) {
+function OperationSurfaceContent({ toolRuntime, element }) {
     const runtime = getInternalToolRuntime(toolRuntime);
     const activity = useSyncExternalStore(runtime.subscribeActivity, runtime.getActivitySnapshot, runtime.getActivitySnapshot);
     const cycle = activity.operation;
@@ -65,24 +58,15 @@ function OperationSurfaceContent({ toolRuntime, element, }) {
     useLayoutEffect(() => runtime.setPageActionFeedback((event, feedback, signal) => {
         const operation = runtime.getActivitySnapshot().operation;
         if (signal?.aborted || !canPresentInOperation(event, operation))
-            throw new PageCommandError({
-                code: "EXECUTION_CANCELLED",
-                message: "Page action presentation was interrupted.",
-            });
+            throw new PageCommandError({ code: "EXECUTION_CANCELLED", message: "Page action presentation was interrupted." });
         const target = feedback.target;
-        if (!feedback.effect ||
-            (feedback.effect === "action" &&
-                (!target?.isConnected || !element.current?.contains(target)))) {
+        if (!feedback.effect || (feedback.effect === "action" && (!target?.isConnected || !element.current?.contains(target)))) {
             setVisual(undefined);
             return;
         }
         const next = {
-            id: crypto.randomUUID(),
-            effect: feedback.effect,
-            label: label(event),
-            centered: feedback.effect === "read",
-            persistentCursor: true,
-            requiresTarget: feedback.effect === "action",
+            id: crypto.randomUUID(), effect: feedback.effect, label: label(event),
+            centered: feedback.effect === "read", persistentCursor: true, requiresTarget: feedback.effect === "action",
             ...(target ? { target } : {}),
         };
         if (feedback.effect !== "action") {
@@ -114,61 +98,32 @@ function OperationSurfaceContent({ toolRuntime, element, }) {
             const page = BROWSER_TOOL_NAMES.has(event.name);
             if (canDisplay && event.status === "running") {
                 if (page)
-                    setVisual(event.name === "nxf_getSnapshot"
-                        ? {
-                            event,
-                            feedback: {
-                                id: event.id,
-                                effect: "read",
-                                label: label(event),
-                                centered: true,
-                            },
-                        }
-                        : undefined);
+                    setVisual(event.name === "nxf_getSnapshot" ? { event, feedback: {
+                            id: event.id, effect: "read", label: label(event), centered: true,
+                        } } : undefined);
                 else {
-                    const target = event.tool.definition.effect === "navigate"
-                        ? element.current
-                        : runtime.resolveTarget(event.tool, event.input);
+                    const target = event.tool.definition.effect === "navigate" ? element.current : runtime.resolveTarget(event.tool, event.input);
                     if (target?.isConnected && element.current?.contains(target)) {
                         const rect = target.getBoundingClientRect();
-                        setVisual({
-                            event,
-                            feedback: {
-                                id: event.id,
-                                effect: event.tool.definition.effect ?? "action",
-                                label: label(event),
-                                resolveTarget: () => event.tool.definition.effect === "navigate"
-                                    ? (element.current ?? undefined)
-                                    : runtime.resolveTarget(event.tool, event.input),
-                                position: { left: rect.left + rect.width / 2, top: rect.top + rect.height / 2 },
-                            },
-                        });
+                        setVisual({ event, feedback: { id: event.id, effect: event.tool.definition.effect ?? "action", label: label(event),
+                                resolveTarget: () => event.tool.definition.effect === "navigate" ? element.current ?? undefined : runtime.resolveTarget(event.tool, event.input),
+                                position: { left: rect.left + rect.width / 2, top: rect.top + rect.height / 2 } } });
                     }
                 }
             }
             else if (canDisplay)
                 setVisual((current) => current?.event.id === event.id && current.event.operationId === event.operationId
-                    ? page
-                        ? undefined
-                        : { ...current, event }
-                    : current);
+                    ? page ? undefined : { ...current, event } : current);
             if (page && !operation && event.status === "error")
                 setOutcome({ id: scope, status: event.cancelled ? "cancelled" : "failed" });
             setHistory((current) => {
-                if (!belongsToOperation(event, operation) ||
-                    (event.status !== "running" && current.scope !== scope))
+                if (!belongsToOperation(event, operation) || (event.status !== "running" && current.scope !== scope))
                     return current;
                 const entries = current.scope === scope ? current.entries : [];
-                const entry = {
-                    toolCallId: event.id,
-                    progressLabel: `${event.progressLabel || "正在处理你的请求"} · ${event.cancelled ? "已取消" : event.status === "running" ? "执行中" : event.status === "success" ? "已完成" : "失败"}`,
-                };
-                return {
-                    scope,
-                    entries: entries.some((item) => item.toolCallId === event.id)
-                        ? entries.map((item) => (item.toolCallId === event.id ? entry : item))
-                        : [...entries, entry],
-                };
+                const entry = { toolCallId: event.id,
+                    progressLabel: `${event.progressLabel || "正在处理你的请求"} · ${event.cancelled ? "已取消" : event.status === "running" ? "执行中" : event.status === "success" ? "已完成" : "失败"}` };
+                return { scope, entries: entries.some((item) => item.toolCallId === event.id)
+                        ? entries.map((item) => item.toolCallId === event.id ? entry : item) : [...entries, entry] };
             });
         };
         const unsubscribe = toolRuntime.on("toolexecution", onExecution);
@@ -181,57 +136,25 @@ function OperationSurfaceContent({ toolRuntime, element, }) {
     const waiting = cycle?.status === "waiting" && !executing;
     const running = executing || (activated && cycle?.status !== "waiting");
     const stopping = cycle?.status === "cancelling";
-    useLayoutEffect(() => {
-        if (!running || waiting)
-            setVisual(undefined);
-    }, [running, waiting]);
+    useLayoutEffect(() => { if (!running || waiting)
+        setVisual(undefined); }, [running, waiting]);
     const serverExecuting = cycle?.taskProgress?.phase === "tool";
     const visualExecuting = Boolean(visual && activity.executions.some((event) => event.id === visual.event.id));
-    const currentVisual = !stopping &&
-        !waiting &&
-        visual &&
-        (!serverExecuting || (BROWSER_TOOL_NAMES.has(visual.event.name) && visualExecuting)) &&
-        canPresentInOperation(visual.event, cycle) &&
-        (cycle || visualExecuting)
-        ? visual
-        : undefined;
+    const currentVisual = !stopping && !waiting && visual
+        && (!serverExecuting || (BROWSER_TOOL_NAMES.has(visual.event.name) && visualExecuting))
+        && canPresentInOperation(visual.event, cycle) && (cycle || visualExecuting) ? visual : undefined;
     const browserExecution = activity.executions.find((event) => BROWSER_TOOL_NAMES.has(event.name));
-    const progressLabel = currentVisual?.feedback.label ??
-        (waiting
-            ? "等待你完成操作"
-            : stopping
-                ? "正在终止"
-                : browserExecution
-                    ? browserExecution.progressLabel || "正在浏览网页"
-                    : cycle?.taskProgress?.phase === "tool"
-                        ? cycle.taskProgress.progressLabel || "正在执行工具"
-                        : cycle?.taskProgress
-                            ? "正在处理"
-                            : "正在处理你的请求");
-    const operation = {
-        progressLabel,
-        status: currentVisual
-            ? currentVisual.event.status === "running"
-                ? "running"
-                : currentVisual.event.status === "success"
-                    ? "completed"
-                    : "failed"
-            : running || waiting
-                ? "running"
-                : outcome?.id === history.scope
-                    ? outcome.status
-                    : "completed",
-    };
-    const feedback = currentVisual?.feedback ??
-        (serverExecuting && running && !waiting && !stopping
-            ? {
-                id: cycle.taskProgress.toolCallId,
-                effect: "read",
-                label: progressLabel,
-                centered: true,
-            }
-            : undefined);
+    const progressLabel = currentVisual?.feedback.label ?? (waiting ? "等待你完成操作" : stopping ? "正在终止"
+        : browserExecution ? browserExecution.progressLabel || "正在浏览网页"
+            : cycle?.taskProgress?.phase === "tool" ? cycle.taskProgress.progressLabel || "正在执行工具"
+                : cycle?.taskProgress ? "正在处理" : "正在处理你的请求");
+    const operation = { progressLabel, status: currentVisual
+            ? currentVisual.event.status === "running" ? "running" : currentVisual.event.status === "success" ? "completed" : "failed"
+            : running || waiting ? "running" : outcome?.id === history.scope ? outcome.status : "completed" };
+    const feedback = currentVisual?.feedback ?? (serverExecuting && running && !waiting && !stopping
+        ? { id: cycle.taskProgress.toolCallId, effect: "read", label: progressLabel, centered: true } : undefined);
     const resolveSurface = useCallback(() => element.current ?? undefined, [element]);
     const entries = !cycle || history.scope === cycle.id ? history.entries : [];
-    return activated || executing || entries.length ? (React.createElement(OperationOverlayView, { key: cycle?.id ?? history.scope, operation: operation, progressHistory: entries, running: running, humanHasControl: waiting, cancelling: stopping, ...(feedback ? { feedback } : {}), ...(cycle?.canCancel ? { onCancel: () => runtime.requestOperationCancel(cycle.id) } : {}), resolveSurface: resolveSurface })) : null;
+    return activated || executing || entries.length ? React.createElement(OperationOverlayView, { key: cycle?.id ?? history.scope, operation: operation, progressHistory: entries, running: running, humanHasControl: waiting, cancelling: stopping, ...(feedback ? { feedback } : {}), ...(cycle?.canCancel ? { onCancel: () => runtime.requestOperationCancel(cycle.id) } : {}), resolveSurface: resolveSurface }) : null;
 }
+//# sourceMappingURL=operation-surface.js.map

package/dist/operation-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-surface.js","sourceRoot":"","sources":["../src/operation-surface.tsx"],"names":[],"mappings":"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","sourcesContent":["import * as React from \"react\";\nimport { flushSync } from \"react-dom\";\nimport { useCallback, useLayoutEffect, useRef, useState, type ReactElement, type ReactNode, type RefObject, type SyntheticEvent } from \"react\";\nimport { useSyncExternalStore } from \"use-sync-external-store/shim\";\nimport { PageCommandError } from \"./browser/locator.js\";\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, OperationFeedback } from \"./operation-types.js\";\nimport type { OperationSnapshot } from \"./operation-runtime.js\";\n\nconst BROWSER_TOOL_NAMES = new Set([\"nxf_getSnapshot\", \"nxf_executeAction\", \"nxf_applyAction\"]);\n\nconst belongsToOperation = (event: AgentToolExecutionEvent, operation: OperationSnapshot | null) =>\n  !operation || event.operationId === operation.id;\nconst canPresentInOperation = (event: AgentToolExecutionEvent, operation: OperationSnapshot | null) =>\n  belongsToOperation(event, operation) && (!operation || operation.status === \"running\" || operation.status === \"ending\");\n\nexport interface AgentOperationSurfaceProps {\n  toolRuntime: ToolRuntime;\n  children: ReactNode;\n}\n\nconst surfaces = new WeakSet<ToolRuntime>();\n\nexport function AgentOperationSurface(props: AgentOperationSurfaceProps): ReactElement {\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: AgentOperation[\"status\"] }>();\n  const [visual, setVisual] = useState<{ event: AgentToolExecutionEvent; feedback: OperationFeedback }>();\n  const [history, setHistory] = useState<{ scope: string; entries: AgentOperationProgressEntry[] }>({ scope: \"\", entries: [] });\n  const label = (event: AgentToolExecutionEvent) => event.progressLabel || (BROWSER_TOOL_NAMES.has(event.name) ? \"正在操作\" : \"正在处理你的请求\");\n  useLayoutEffect(() => runtime.subscribeActivity(() => {\n    const operation = runtime.getActivitySnapshot().operation;\n    if (operation?.status === \"ending\" && operation.outcome) setOutcome({ id: operation.id, status: operation.outcome });\n  }), [runtime]);\n  useLayoutEffect(() => runtime.setPageActionFeedback((event, feedback, signal) => {\n    const operation = runtime.getActivitySnapshot().operation;\n    if (signal?.aborted || !canPresentInOperation(event, operation)) throw new PageCommandError({ code: \"EXECUTION_CANCELLED\", message: \"Page action presentation was interrupted.\" });\n    const target = feedback.target;\n    if (!feedback.effect || (feedback.effect === \"action\" && (!target?.isConnected || !element.current?.contains(target)))) {\n      setVisual(undefined);\n      return;\n    }\n    const next: OperationFeedback = {\n      id: crypto.randomUUID(), effect: feedback.effect, label: label(event),\n      centered: feedback.effect === \"read\", persistentCursor: true, requiresTarget: feedback.effect === \"action\",\n      ...(target ? { target } : {}),\n    };\n    if (feedback.effect !== \"action\") { setVisual({ event, feedback: next }); return; }\n    return new Promise<void>((resolve, reject) => {\n      let finished = false;\n      next.presentation = {\n        ...(signal ? { signal } : {}),\n        finish: (error) => {\n          if (finished) return;\n          finished = true;\n          if (error) reject(error); else resolve();\n        },\n      };\n      flushSync(() => setVisual({ event, feedback: next }));\n    });\n  }), [runtime, element]);\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 !== null && canPresentInOperation(event, operation));\n      const page = BROWSER_TOOL_NAMES.has(event.name);\n      if (canDisplay && event.status === \"running\") {\n        if (page) setVisual(event.name === \"nxf_getSnapshot\" ? { event, feedback: {\n          id: event.id, effect: \"read\", label: label(event), centered: true,\n        } } : undefined);\n        else {\n          const target = event.tool.definition.effect === \"navigate\" ? element.current : runtime.resolveTarget(event.tool, event.input);\n          if (target?.isConnected && element.current?.contains(target)) {\n            const rect = target.getBoundingClientRect();\n            setVisual({ event, feedback: { id: event.id, effect: event.tool.definition.effect ?? \"action\", label: label(event),\n              resolveTarget: () => event.tool.definition.effect === \"navigate\" ? element.current ?? undefined : runtime.resolveTarget(event.tool, event.input),\n              position: { left: rect.left + rect.width / 2, top: rect.top + rect.height / 2 } } });\n          }\n        }\n      } else if (canDisplay) setVisual((current) => current?.event.id === event.id && current.event.operationId === event.operationId\n        ? page ? undefined : { ...current, event } : current);\n      if (page && !operation && event.status === \"error\") setOutcome({ id: scope, status: event.cancelled ? \"cancelled\" : \"failed\" });\n      setHistory((current) => {\n        if (!belongsToOperation(event, operation) || (event.status !== \"running\" && current.scope !== scope)) return current;\n        const entries = current.scope === scope ? current.entries : [];\n        const entry = { toolCallId: event.id,\n          progressLabel: `${event.progressLabel || \"正在处理你的请求\"} · ${event.cancelled ? \"已取消\" : event.status === \"running\" ? \"执行中\" : event.status === \"success\" ? \"已完成\" : \"失败\"}` };\n        return { scope, entries: entries.some((item) => item.toolCallId === event.id)\n          ? entries.map((item) => item.toolCallId === event.id ? entry : item) : [...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\";\n  useLayoutEffect(() => { if (!running || waiting) setVisual(undefined); }, [running, waiting]);\n  const serverExecuting = cycle?.taskProgress?.phase === \"tool\";\n  const visualExecuting = Boolean(visual && activity.executions.some((event) => event.id === visual.event.id));\n  const currentVisual = !stopping && !waiting && visual\n    && (!serverExecuting || (BROWSER_TOOL_NAMES.has(visual.event.name) && visualExecuting))\n    && canPresentInOperation(visual.event, cycle) && (cycle || visualExecuting) ? visual : undefined;\n  const browserExecution = activity.executions.find((event) => BROWSER_TOOL_NAMES.has(event.name));\n  const progressLabel = currentVisual?.feedback.label ?? (waiting ? \"等待你完成操作\" : stopping ? \"正在终止\"\n    : browserExecution ? browserExecution.progressLabel || \"正在浏览网页\"\n    : cycle?.taskProgress?.phase === \"tool\" ? cycle.taskProgress.progressLabel || \"正在执行工具\"\n    : cycle?.taskProgress ? \"正在处理\" : \"正在处理你的请求\");\n  const operation: AgentOperation = { progressLabel, status: currentVisual\n    ? currentVisual.event.status === \"running\" ? \"running\" : currentVisual.event.status === \"success\" ? \"completed\" : \"failed\"\n    : running || waiting ? \"running\" : outcome?.id === history.scope ? outcome.status : \"completed\" };\n  const feedback = currentVisual?.feedback ?? (serverExecuting && running && !waiting && !stopping\n    ? { id: cycle.taskProgress.toolCallId, effect: \"read\" as const, label: progressLabel, centered: true } : undefined);\n  const resolveSurface = useCallback(() => element.current ?? undefined, [element]);\n  const entries = !cycle || history.scope === cycle.id ? history.entries : [];\n  return activated || executing || entries.length ? <OperationOverlayView key={cycle?.id ?? history.scope}\n    operation={operation} progressHistory={entries} running={running} humanHasControl={waiting} cancelling={stopping}\n    {...(feedback ? { feedback } : {})}\n    {...(cycle?.canCancel ? { onCancel: () => runtime.requestOperationCancel(cycle.id) } : {})}\n    resolveSurface={resolveSurface} /> : null;\n}\n"]}

package/dist/operation-types.js

@@ -1 +1,2 @@
 export {};
+//# sourceMappingURL=operation-types.js.map

package/dist/operation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-types.js","sourceRoot":"","sources":["../src/operation-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentToolEffect } from \"./types.js\";\n\nexport interface AgentOperation {\n  progressLabel: string;\n  status: \"running\" | \"completed\" | \"failed\" | \"cancelled\";\n}\n\nexport interface AgentOperationProgressEntry {\n  progressLabel: string;\n  toolCallId: string;\n}\n\nexport interface OperationFeedback {\n  id: string;\n  effect: AgentToolEffect | \"processing\";\n  label: string;\n  target?: Element;\n  resolveTarget?(): Element | undefined;\n  position?: { left: number; top: number };\n  centered?: boolean;\n  persistentCursor?: boolean;\n  requiresTarget?: boolean;\n  presentation?: {\n    signal?: AbortSignal;\n    finish(error?: Error): void;\n  };\n}\n"]}

package/dist/operation-view.d.ts

@@ -10,4 +10,4 @@ export interface OperationOverlayViewProps {
     onCancel?(): void;
     resolveSurface?(): HTMLElement | undefined;
 }
-export declare function OperationOverlayView({ operation, feedback, progressHistory, running, humanHasControl, cancelling, onCancel: cancel, resolveSurface, }: OperationOverlayViewProps): React.ReactPortal | null;
+export declare function OperationOverlayView({ operation, feedback, progressHistory, running, humanHasControl, cancelling, onCancel: cancel, resolveSurface }: OperationOverlayViewProps): React.ReactPortal | null;