@nexface/tools 0.1.1-alpha.4 → 0.1.1-alpha.5

package/dist/definition.js

@@ -13,6 +13,8 @@ const reservedContextNames = new Set([
 const reservedToolNames = new Set([
     ...reservedContextNames,
     "loadSkill",
+    "beginOperation",
+    "endOperation",
 ]);
 export function isValidAgentContextName(name) {
     return agentNamePattern.test(name) && !reservedContextNames.has(name);

package/dist/definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,10 @@
+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"];
+type AgentToolErrorCode = typeof TOOL_ERROR_CODES[number];
+export declare class AgentToolError extends Error {
+    readonly code: AgentToolErrorCode;
+    readonly details?: unknown | undefined;
+    readonly type: "tool_runtime_error";
+    readonly domain: "tool";
+    constructor(code: AgentToolErrorCode, message: string, details?: unknown | undefined);
+}
+export {};

package/dist/errors.js

@@ -0,0 +1,34 @@
+export const TOOL_ERROR_CODES = [
+    "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 class AgentToolError extends Error {
+    code;
+    details;
+    type = "tool_runtime_error";
+    domain = "tool";
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "ToolRuntimeError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +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"}

package/dist/index.browser.d.ts

@@ -0,0 +1,2 @@
+import "./styles.css";
+export * from "./index.js";

package/dist/index.browser.js

@@ -0,0 +1,3 @@
+import "./styles.css";
+export * from "./index.js";
+//# sourceMappingURL=index.browser.js.map

package/dist/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAC;AAEtB,cAAc,YAAY,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 export { defineAgentTool } from "./definition.js";
 export { defineAgentNavigation } from "./navigation.js";
+export { AgentOperationSurface, type AgentOperationSurfaceProps } from "./operation-surface.js";
 export { createToolRuntime, isToolRuntimeError, } from "./runtime.js";
 export { AgentContext, ToolsProvider, AgentUIAction, useAgentContext, useAgentNavigation, useAgentTool, } from "./react.js";
 export type { AgentNavigation, AgentNavigationConfig, AgentNavigationExecutors, AgentNavigationRouteConfig, } from "./navigation.js";
 export type { AgentToolBinding, AgentToolChatConfirmationConfig, AgentToolPageConfirmationConfig, AgentUIActionChildProps, AgentUIActionEvent, AgentUIActionProps, UseAgentToolDefaultOptions, UseAgentToolPageConfirmationOptions, } from "./react.js";
-export type { AgentToolConfirmationConfig, RuntimeAgentTool, ToolRuntime, ToolRuntimeOptions, ToolRuntimeToolChangeEvent, } from "./runtime.js";
+export type { AgentToolConfirmationConfig, RuntimeAgentTool, ToolRuntime, ToolOperation, ToolRuntimeOptions, ToolRuntimeToolChangeEvent, } from "./runtime.js";
 export type { AgentContextEntry, AgentContextValue, AgentToolDefinition, AgentToolEffect, AgentToolExecutionContext, AgentToolExecutor, AgentToolInputSchema, InferJsonSchema, JsonSchema, } from "./types.js";

package/dist/index.js

@@ -1,5 +1,6 @@
 export { defineAgentTool } from "./definition.js";
 export { defineAgentNavigation } from "./navigation.js";
+export { AgentOperationSurface } from "./operation-surface.js";
 export { createToolRuntime, isToolRuntimeError, } from "./runtime.js";
 export { AgentContext, ToolsProvider, AgentUIAction, useAgentContext, useAgentNavigation, useAgentTool, } from "./react.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,YAAY,GACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAmC,MAAM,wBAAwB,CAAC;AAChG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/internal-react.d.ts

@@ -1,5 +1,4 @@
 import { type ReactNode } from "react";
-export { OperationHostContext } from "./operation-host.js";
 export type { PageConfirmableAgentToolBinding } from "./react.js";
 import { type ToolRuntime, type InternalToolRuntime } from "./runtime.js";
 export interface InternalToolRuntimeHostProps {

package/dist/internal-react.js

@@ -1,6 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext, useMemo, } from "react";
-export { OperationHostContext } from "./operation-host.js";
 import { createToolRuntime, getInternalToolRuntime, } from "./runtime.js";
 const InternalToolRuntimeContext = createContext(null);
 export function InternalToolRuntimeHost({ children, }) {

package/dist/internal-react.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal-react.js","sourceRoot":"","sources":["../src/internal-react.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,aAAa,EACb,UAAU,EACV,OAAO,GAER,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GAGvB,MAAM,cAAc,CAAC;AAEtB,MAAM,0BAA0B,GAC9B,aAAa,CAA6B,IAAI,CAAC,CAAC;AAMlD,MAAM,UAAU,uBAAuB,CAAC,EACtC,QAAQ,GACqB;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO,CACL,KAAC,wBAAwB,IAAC,OAAO,EAAE,OAAO,YACvC,QAAQ,GACgB,CAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,EACvC,QAAQ,EACR,OAAO,GAIR;IACC,MAAM,eAAe,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACxD,OAAO,CACL,KAAC,0BAA0B,CAAC,QAAQ,IAAC,KAAK,EAAE,eAAe,YACxD,QAAQ,GAC2B,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,MAAM,OAAO,GAAG,UAAU,CAAC,0BAA0B,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,8BAA8B;IAG5C,OAAO,UAAU,CAAC,0BAA0B,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"internal-react.js","sourceRoot":"","sources":["../src/internal-react.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,aAAa,EACb,UAAU,EACV,OAAO,GAER,MAAM,OAAO,CAAC;AAGf,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GAGvB,MAAM,cAAc,CAAC;AAEtB,MAAM,0BAA0B,GAC9B,aAAa,CAA6B,IAAI,CAAC,CAAC;AAMlD,MAAM,UAAU,uBAAuB,CAAC,EACtC,QAAQ,GACqB;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO,CACL,KAAC,wBAAwB,IAAC,OAAO,EAAE,OAAO,YACvC,QAAQ,GACgB,CAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,EACvC,QAAQ,EACR,OAAO,GAIR;IACC,MAAM,eAAe,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACxD,OAAO,CACL,KAAC,0BAA0B,CAAC,QAAQ,IAAC,KAAK,EAAE,eAAe,YACxD,QAAQ,GAC2B,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,MAAM,OAAO,GAAG,UAAU,CAAC,0BAA0B,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,8BAA8B;IAG5C,OAAO,UAAU,CAAC,0BAA0B,CAAC,CAAC;AAChD,CAAC"}

package/dist/internal-types.d.ts

@@ -13,6 +13,7 @@ export interface AgentToolExecutionEvent {
     cancelled?: boolean;
     progressLabel?: string;
     id: string;
+    operationId?: string;
     name: string;
     status: AgentToolExecutionStatus;
     startedAt: number;

package/dist/internal.d.ts

@@ -1,5 +1,5 @@
 export { AgentContextError, ToolRuntimeImplementation, ToolRuntimeImplementation as ToolRuntime, AgentToolError, createToolRuntime, getInternalToolRuntime, } from "./runtime.js";
-export type { ToolRuntime as PublicToolRuntime, ToolRuntimeOptions, InternalToolRuntime, } from "./runtime.js";
+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, executeCodeTool, getSnapshotTool, startPageTransitionTracker, } from "./browser/toolset.js";

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;AAOtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC"}
+{"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,eAAe,EACf,eAAe,EACf,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC"}

package/dist/operation-lock.d.ts

@@ -0,0 +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;

package/dist/operation-lock.js

@@ -0,0 +1,46 @@
+import { isAgentFocus } 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) {
+    const previousBusy = surface.getAttribute("aria-busy");
+    const block = (event) => {
+        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"];
+    lockedSurfaces.add(surface);
+    surface.setAttribute("aria-busy", "true");
+    for (const name of events)
+        surface.addEventListener(name, block, { capture: true, passive: false });
+    return () => {
+        lockedSurfaces.delete(surface);
+        for (const name of events)
+            surface.removeEventListener(name, block, true);
+        if (previousBusy === null)
+            surface.removeAttribute("aria-busy");
+        else
+            surface.setAttribute("aria-busy", previousBusy);
+    };
+}
+//# sourceMappingURL=operation-lock.js.map

package/dist/operation-lock.js.map

@@ -0,0 +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"}

package/dist/operation-runtime.d.ts

@@ -0,0 +1,33 @@
+import type { AgentToolExecutionEvent } from "./internal-types.js";
+import type { ToolOperation } from "./runtime.js";
+export interface OperationSnapshot {
+    readonly id: string;
+    readonly source: "host" | "webmcp";
+    readonly status: "running" | "waiting" | "cancelling" | "ending";
+    readonly hasExecuted: boolean;
+    readonly outcome?: "completed" | "failed" | "cancelled";
+    readonly reason?: "bridge_disposed";
+    readonly canCancel: boolean;
+}
+export interface RuntimeActivitySnapshot {
+    readonly operation: OperationSnapshot | null;
+    readonly executions: readonly AgentToolExecutionEvent[];
+}
+export declare class OperationTracker {
+    #private;
+    getSnapshot: () => RuntimeActivitySnapshot;
+    subscribe: (listener: () => void) => (() => void);
+    begin(options?: {
+        signal?: AbortSignal;
+        onCancel?: () => void;
+        source?: "host" | "webmcp";
+        replaceWaiting?: ToolOperation;
+    }): ToolOperation;
+    disposeBridge(handle: ToolOperation): Promise<void>;
+    requestCancel(id: string): void;
+    admit(): {
+        operationId?: string;
+        release(): void;
+    };
+    observe(event: AgentToolExecutionEvent): void;
+}

package/dist/operation-runtime.js

@@ -0,0 +1,144 @@
+import { AgentToolError } from "./errors.js";
+export class OperationTracker {
+    #operation;
+    #unscoped = 0;
+    #executions = new Map();
+    #listeners = new Set();
+    #snapshot = Object.freeze({ operation: null, executions: Object.freeze([]) });
+    getSnapshot = () => this.#snapshot;
+    subscribe = (listener) => {
+        this.#listeners.add(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;
+        if (this.#unscoped || (previous && !replacing)) {
+            throw new AgentToolError("OPERATION_BUSY", "The Runtime already has an operation or outstanding tool calls.");
+        }
+        if (replacing) {
+            previous.removeAbort();
+            previous.resolveEnd();
+        }
+        let resolveEnd;
+        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) }),
+            handle: undefined, pending: 0, resolveEnd,
+            ...(options.onCancel ? { onCancel: options.onCancel } : {}),
+            removeAbort: () => options.signal?.removeEventListener("abort", onAbort),
+        };
+        const onAbort = () => {
+            if (this.#operation !== operation || operation.snapshot.status === "ending")
+                return;
+            this.#update(operation, { status: "cancelling" });
+        };
+        const handle = Object.freeze({
+            id,
+            setWaitingForUser: (waiting) => {
+                if (this.#operation !== operation || !["running", "waiting"].includes(operation.snapshot.status))
+                    return;
+                const status = waiting ? "waiting" : "running";
+                if (status !== operation.snapshot.status)
+                    this.#update(operation, { status });
+            },
+            end: (endOptions) => {
+                if (this.#operation !== operation || operation.snapshot.status === "ending")
+                    return endPromise;
+                operation.removeAbort();
+                operation.snapshot = Object.freeze({ ...operation.snapshot, status: "ending", outcome: endOptions?.outcome ?? "completed" });
+                this.#publish();
+                if (this.#finish(operation))
+                    this.#publish();
+                return endPromise;
+            },
+        });
+        operation.handle = handle;
+        this.#operation = operation;
+        options.signal?.addEventListener("abort", onAbort, { once: true });
+        this.#publish();
+        return handle;
+    }
+    disposeBridge(handle) {
+        const operation = this.#operation;
+        if (operation?.handle === handle)
+            operation.snapshot = Object.freeze({ ...operation.snapshot, reason: "bridge_disposed" });
+        return handle.end();
+    }
+    requestCancel(id) {
+        const operation = this.#operation;
+        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" });
+        try {
+            operation.onCancel();
+        }
+        catch (error) {
+            if (this.#operation === operation && this.#snapshot.operation?.status === "cancelling") {
+                this.#update(operation, { status: previous });
+            }
+            throw error;
+        }
+    }
+    // Admission is captured before execution and released exactly once, including queued aborts.
+    admit() {
+        const operation = this.#operation?.snapshot.status === "ending" ? undefined : this.#operation;
+        if (operation)
+            operation.pending += 1;
+        else
+            this.#unscoped += 1;
+        let released = false;
+        return {
+            ...(operation ? { operationId: operation.snapshot.id } : {}),
+            release: () => {
+                if (released)
+                    return;
+                released = true;
+                if (operation) {
+                    operation.pending -= 1;
+                    if (this.#finish(operation))
+                        this.#publish();
+                }
+                else
+                    this.#unscoped -= 1;
+            },
+        };
+    }
+    observe(event) {
+        if (event.status === "running") {
+            this.#executions.set(event.id, event);
+            const operation = this.#operation;
+            if (operation && event.operationId === operation.snapshot.id && !operation.snapshot.hasExecuted) {
+                operation.snapshot = Object.freeze({ ...operation.snapshot, hasExecuted: true });
+            }
+        }
+        else
+            this.#executions.delete(event.id);
+        this.#publish();
+    }
+    #finish(operation) {
+        if (operation.pending || operation.snapshot.status !== "ending" || this.#operation !== operation)
+            return false;
+        this.#operation = undefined;
+        operation.resolveEnd();
+        return true;
+    }
+    #update(operation, patch) {
+        operation.snapshot = Object.freeze({ ...operation.snapshot, ...patch });
+        this.#publish();
+    }
+    #publish() {
+        this.#snapshot = Object.freeze({
+            operation: this.#operation?.snapshot ?? null,
+            executions: Object.freeze([...this.#executions.values()]),
+        });
+        for (const listener of this.#listeners)
+            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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"}

package/dist/operation-surface.d.ts

@@ -4,4 +4,4 @@ export interface AgentOperationSurfaceProps {
     toolRuntime: ToolRuntime;
     children: ReactNode;
 }
-export declare function AgentOperationSurface({ toolRuntime, children }: AgentOperationSurfaceProps): import("react").JSX.Element;
+export declare function AgentOperationSurface(props: AgentOperationSurfaceProps): import("react").JSX.Element;

package/dist/operation-surface.js

@@ -1,83 +1,108 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { useCallback, useLayoutEffect, useRef, useState } from "react";
+import { useCallback, useLayoutEffect, useRef, useState, useSyncExternalStore } from "react";
 import { getInternalToolRuntime } from "./runtime.js";
-import { useOperationHost } from "./operation-host.js";
+import { isOperationSurfaceLocked } from "./operation-lock.js";
 import { OperationOverlayView } from "./operation-view.js";
-export function AgentOperationSurface({ toolRuntime, children }) {
-    const chat = useOperationHost();
-    if (chat.toolRuntime !== toolRuntime)
-        throw new Error("AgentOperationSurface requires the NexfaceProvider Runtime.");
+const surfaces = new WeakSet();
+export function AgentOperationSurface(props) {
     const element = useRef(null);
-    const owner = useRef({});
-    const [visual, setVisual] = useState();
-    const [history, setHistory] = useState([]);
-    const activeExecutions = useRef(new Set());
-    const turn = chat.turnId;
-    const running = chat.running;
-    const waiting = chat.waiting && !running;
-    useLayoutEffect(() => {
-        if (chat.operationSurface.current)
-            throw new Error("Only one AgentOperationSurface is supported per NexfaceProvider.");
-        chat.operationSurface.current = owner.current;
-        return () => { chat.operationSurface.current = null; };
-    }, [chat.operationSurface]);
+    const initial = useRef(props.toolRuntime);
+    if (initial.current !== props.toolRuntime) {
+        throw new Error("AgentOperationSurface requires a stable Runtime. Remount it to change Runtime.");
+    }
     useLayoutEffect(() => {
-        setVisual(undefined);
-        setHistory([]);
-        activeExecutions.current.clear();
-    }, [turn]);
-    useLayoutEffect(() => toolRuntime.on("toolexecution", (event) => {
-        if (event.status === "running")
-            activeExecutions.current.add(event.id);
-        else if (!activeExecutions.current.delete(event.id))
+        if (surfaces.has(props.toolRuntime))
+            throw new Error("Only one AgentOperationSurface is supported per Runtime.");
+        surfaces.add(props.toolRuntime);
+        return () => { surfaces.delete(props.toolRuntime); };
+    }, [props.toolRuntime]);
+    const blockUserInput = useCallback((event) => {
+        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)
             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 _jsxs(_Fragment, { children: [_jsx("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, children: props.children }), _jsx(OperationSurfaceContent, { ...props, element: element })] });
+}
+function OperationSurfaceContent({ toolRuntime, element }) {
+    const runtime = getInternalToolRuntime(toolRuntime);
+    const activity = useSyncExternalStore(runtime.subscribeActivity, runtime.getActivitySnapshot, runtime.getActivitySnapshot);
+    const cycle = activity.operation;
+    const activeEvent = activity.executions.at(-1);
+    const [outcome, setOutcome] = useState();
+    useLayoutEffect(() => runtime.subscribeActivity(() => {
+        const current = runtime.getActivitySnapshot().operation;
+        if (current?.status === "ending" && current.outcome)
+            setOutcome({ id: current.id, status: current.outcome });
+    }), [runtime]);
+    const [visual, setVisual] = useState();
+    const [history, setHistory] = useState({ scope: "", entries: [] });
+    useLayoutEffect(() => toolRuntime.on("toolexecution", (event) => {
+        const scope = event.operationId ?? event.id;
         if (event.status === "running") {
-            setVisual({ event, target: getInternalToolRuntime(toolRuntime).resolveTarget(event.tool, event.input) });
+            setVisual({ event, target: runtime.resolveTarget(event.tool, event.input) });
         }
         else {
             setVisual((current) => current?.event.id === event.id
-                ? event.status === "success" && !window.matchMedia?.("(prefers-reduced-motion: reduce)").matches ? { ...current, event: { ...current.event, ...event } } : undefined
+                ? event.status === "success" && !window.matchMedia?.("(prefers-reduced-motion: reduce)").matches
+                    ? { ...current, event: { ...current.event, ...event } }
+                    : undefined
                 : current);
         }
-        setHistory((entries) => {
+        setHistory((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 entries.some((item) => item.toolCallId === event.id)
-                ? entries.map((item) => item.toolCallId === event.id ? entry : item)
-                : [...entries, entry];
+            return { scope, entries: entries.some((item) => item.toolCallId === event.id)
+                    ? entries.map((item) => item.toolCallId === event.id ? entry : item)
+                    : [...entries, entry] };
         });
-    }), [toolRuntime]);
+    }), [runtime, toolRuntime]);
+    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");
     useLayoutEffect(() => {
-        if (!running) {
+        if (!running || waiting)
             setVisual(undefined);
-        }
     }, [running, waiting]);
-    const resolveSurface = useCallback(() => element.current ?? undefined, []);
+    const currentVisual = activeEvent
+        ? visual?.event.id === activeEvent.id ? visual : { event: activeEvent, target: runtime.resolveTarget(activeEvent.tool, activeEvent.input) }
+        : running && visual?.event.operationId === cycle?.id ? visual : undefined;
+    const resolveSurface = useCallback(() => element.current ?? undefined, [element]);
     const resolveTarget = useCallback(() => {
-        if (!visual)
+        if (!currentVisual)
             return undefined;
-        const target = visual.target;
-        if (target?.isConnected && element.current?.contains(target) && toolRuntime.getTools().includes(visual.event.tool))
+        const target = currentVisual.target;
+        if (target?.isConnected && element.current?.contains(target) && toolRuntime.getTools().includes(currentVisual.event.tool))
             return { element: target };
-        return visual.event.tool.definition.effect === "navigate" && element.current?.isConnected
+        return currentVisual.event.tool.definition.effect === "navigate" && element.current?.isConnected
             ? { element: element.current }
             : undefined;
-    }, [visual, toolRuntime]);
-    const operation = visual ? {
-        toolCallId: visual.event.id,
-        name: visual.event.name,
-        input: visual.event.input,
-        effect: visual.event.tool.definition.effect,
-        progressLabel: visual.event.progressLabel || "正在处理你的请求",
-        status: visual.event.status === "running" ? "running" : "completed",
+    }, [currentVisual, element, toolRuntime]);
+    const operation = currentVisual ? {
+        toolCallId: currentVisual.event.id,
+        name: currentVisual.event.name,
+        input: currentVisual.event.input,
+        effect: currentVisual.event.tool.definition.effect,
+        progressLabel: currentVisual.event.progressLabel || "正在处理你的请求",
+        status: currentVisual.event.status === "running" ? "running" : "completed",
     } : {
-        toolCallId: turn,
+        toolCallId: cycle?.id ?? history.scope,
         name: "agent",
-        progressLabel: waiting ? "等待你完成操作" : chat.failed ? "任务失败" : "正在处理你的请求",
-        status: chat.failed ? "failed" : running || waiting ? "running" : "completed",
+        progressLabel: waiting ? "等待你完成操作" : "正在处理你的请求",
+        status: running || waiting ? "running" : outcome?.id === history.scope ? outcome.status : "completed",
     };
-    return _jsxs(_Fragment, { children: [_jsx("div", { ref: element, className: "nexface-operation-surface", children: children }), _jsx(OperationOverlayView, { operation: operation, progressHistory: history, ...(chat.taskLabel ? { taskLabel: chat.taskLabel } : {}), running: running, feedbackActive: Boolean(visual) && running && !waiting, humanHasControl: waiting, onCancel: chat.cancel, resolveSurface: resolveSurface, resolveTarget: resolveTarget }, chat.sessionId)] });
+    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, humanHasControl: waiting, ...(cycle?.canCancel ? { onCancel: () => runtime.requestOperationCancel(cycle.id) } : {}), cancelling: cycle?.status === "cancelling" || cycle?.status === "ending", resolveSurface: resolveSurface, resolveTarget: resolveTarget }) : null;
 }
 //# sourceMappingURL=operation-surface.js.map