@nexface/tools 0.1.15-alpha.1 → 0.1.15-alpha.10

package/dist/internal-react.d.ts

@@ -3,7 +3,7 @@ import { type ToolRuntime, type InternalToolRuntime } from "./runtime.js";
 export interface InternalToolRuntimeHostProps {
     children: ReactNode;
 }
-export declare function InternalToolRuntimeHost({ children, }: InternalToolRuntimeHostProps): ReactElement;
+export declare function InternalToolRuntimeHost({ children }: InternalToolRuntimeHostProps): ReactElement;
 export declare function InternalToolRuntimeScope({ children, runtime, }: {
     children: ReactNode;
     runtime: ToolRuntime;

package/dist/internal-react.js

@@ -1,10 +1,10 @@
 import * as React from "react";
-import { createContext, useContext, useMemo, } from "react";
+import { createContext, useContext, useMemo } from "react";
 import { createToolRuntime, getInternalToolRuntime, } from "./runtime.js";
 const InternalToolRuntimeContext = createContext(null);
-export function InternalToolRuntimeHost({ children, }) {
+export function InternalToolRuntimeHost({ children }) {
     const runtime = useMemo(() => createToolRuntime(), []);
-    return (React.createElement(InternalToolRuntimeScope, { runtime: runtime }, children));
+    return React.createElement(InternalToolRuntimeScope, { runtime: runtime }, children);
 }
 export function InternalToolRuntimeScope({ children, runtime, }) {
     const internalRuntime = getInternalToolRuntime(runtime);
@@ -20,4 +20,3 @@ export function useInternalToolRuntime() {
 export function useOptionalInternalToolRuntime() {
     return useContext(InternalToolRuntimeContext);
 }
-//# sourceMappingURL=internal-react.js.map

package/dist/internal-types.js

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

package/dist/navigation.js

@@ -37,4 +37,3 @@ export function getAgentNavigationEntries(navigation) {
     }
     return entries;
 }
-//# sourceMappingURL=navigation.js.map

package/dist/operation-lock.d.ts

@@ -1,3 +1,3 @@
 export declare function isOperationSurfaceLocked(surface: HTMLElement): boolean;
 /** Block user input inside the surface without hiding DOM from page tools. */
-export declare function lockOperationSurface(surface: HTMLElement, redirectFocus?: () => void): () => void;
+export declare function lockOperationSurface(surface: HTMLElement): () => void;

package/dist/operation-lock.js

@@ -1,36 +1,54 @@
-import { isAgentActivation, isAgentFocus } from "./browser/focus.js";
+import { isAgentActivation } from "./browser/focus.js";
 const lockedSurfaces = new WeakSet();
 export function isOperationSurfaceLocked(surface) {
     return lockedSurfaces.has(surface);
 }
 /** Block user input inside the surface without hiding DOM from page tools. */
-export function lockOperationSurface(surface, redirectFocus) {
+export function lockOperationSurface(surface) {
     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") {
-            if (isAgentFocus())
-                return;
-            event.stopImmediatePropagation();
-            if (event.target instanceof HTMLElement)
-                event.target.blur();
-            redirectFocus?.();
-            return;
-        }
-        if (event.type === "keydown" && event.key === "Tab") {
-            event.preventDefault();
-            event.stopImmediatePropagation();
-            redirectFocus?.();
-            return;
-        }
         event.preventDefault();
         event.stopImmediatePropagation();
     };
     // Wheel and touch defaults are blocked here: React delegates them passively.
-    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"];
+    const events = [
+        "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",
+    ];
     lockedSurfaces.add(surface);
     surface.setAttribute("aria-busy", "true");
     for (const name of events)
@@ -45,4 +63,3 @@ export function lockOperationSurface(surface, redirectFocus) {
             surface.setAttribute("aria-busy", previousBusy);
     };
 }
-//# sourceMappingURL=operation-lock.js.map

package/dist/operation-runtime.js

@@ -4,17 +4,24 @@ 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.");
         }
@@ -23,11 +30,22 @@ 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),
         };
@@ -42,7 +60,11 @@ 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();
@@ -77,8 +99,11 @@ 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" });
@@ -123,7 +148,9 @@ 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 });
             }
         }
@@ -132,7 +159,9 @@ 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();
@@ -151,4 +180,3 @@ export class OperationTracker {
             listener();
     }
 }
-//# sourceMappingURL=operation-runtime.js.map

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,7 +9,8 @@ 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);
@@ -21,28 +22,34 @@ 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;
@@ -58,15 +65,24 @@ 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") {
@@ -98,32 +114,61 @@ 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);
@@ -136,25 +181,57 @@ 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-types.js

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

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;