@nexface/tools 0.1.0 → 0.1.1-alpha.0

package/dist/operation-view.js

@@ -0,0 +1,376 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CursorIcon as Cursor } from "@phosphor-icons/react/Cursor";
+import { SparkleIcon as Sparkle } from "@phosphor-icons/react/Sparkle";
+import { useEffect, useId, useRef, useState } from "react";
+import { createPortal } from "react-dom";
+const BROWSER_TOOL_NAMES = new Set(["getSnapshot", "executeCode"]);
+const POINTER_EXIT_DURATION_MS = 120;
+const POINTER_CLICK_FEEDBACK_DURATION_MS = 720;
+const CONTROLLER_EXIT_DURATION_MS = 300;
+function operationProgressLabel(operation) {
+    const progressLabel = operation.progressLabel?.trim().replace(/\s+/g, " ");
+    if (progressLabel)
+        return progressLabel.slice(0, 48);
+    return BROWSER_TOOL_NAMES.has(operation.name)
+        ? "正在浏览网页"
+        : "正在处理你的请求";
+}
+function operationEffect(operation) {
+    return operation.effect ?? "action";
+}
+function normalizedLabel(label) {
+    const normalized = label?.trim().replace(/\s+/g, " ");
+    return normalized || undefined;
+}
+function operationTargetLabel(operation, target) {
+    const label = target?.label;
+    if (!label || label === operation.name)
+        return undefined;
+    const rawNamePrefix = `${operation.name} · `;
+    return label.startsWith(rawNamePrefix) ? label.slice(rawNamePrefix.length) : label;
+}
+function pointerMoveDuration(from, to) {
+    const distance = Math.hypot(to.left - from.left, to.top - from.top);
+    if (distance < 2)
+        return 0;
+    return Math.round(Math.min(360, Math.max(180, 180 + distance * 0.18)));
+}
+function pointerReachedTarget(element, target) {
+    const rect = element.getBoundingClientRect();
+    return Math.hypot(rect.left - target.left, rect.top - target.top) < 2;
+}
+function AgentPointer({ active, initialPosition, label, labelActive, operation, targetElement, targetPosition, visible }) {
+    const pointerRef = useRef(null);
+    const activeOperationRef = useRef(undefined);
+    const activeTargetRef = useRef(undefined);
+    const exitTimerRef = useRef(undefined);
+    const feedbackTimerRef = useRef(undefined);
+    const motionRevisionRef = useRef(0);
+    const latestActiveRef = useRef(active);
+    const latestOperationRef = useRef(operation);
+    const [motion, setMotion] = useState();
+    latestActiveRef.current = active;
+    latestOperationRef.current = operation;
+    const clearExitTimer = () => {
+        if (!exitTimerRef.current)
+            return;
+        clearTimeout(exitTimerRef.current);
+        exitTimerRef.current = undefined;
+    };
+    const clearFeedbackTimer = () => {
+        if (!feedbackTimerRef.current)
+            return;
+        clearTimeout(feedbackTimerRef.current);
+        feedbackTimerRef.current = undefined;
+    };
+    const scheduleResting = (revision, durationMs) => {
+        clearFeedbackTimer();
+        feedbackTimerRef.current = setTimeout(() => {
+            if (motionRevisionRef.current !== revision)
+                return;
+            setMotion((current) => current?.revision === revision
+                ? { ...current, feedback: undefined, phase: "resting" }
+                : current);
+        }, durationMs);
+    };
+    const beginFeedback = (revision, toolCallId) => {
+        const latestOperation = latestOperationRef.current;
+        if (!latestActiveRef.current
+            || motionRevisionRef.current !== revision
+            || latestOperation.toolCallId !== toolCallId)
+            return;
+        const feedback = operationEffect(latestOperation) === "action"
+            && latestOperation.status !== "failed"
+            && latestOperation.status !== "cancelled"
+            ? "click"
+            : undefined;
+        if (!feedback) {
+            setMotion((current) => current?.revision === revision
+                ? { ...current, feedback: undefined, phase: "resting" }
+                : current);
+            return;
+        }
+        setMotion((current) => current?.revision === revision
+            ? { ...current, feedback, phase: "arrived" }
+            : current);
+        scheduleResting(revision, POINTER_CLICK_FEEDBACK_DURATION_MS);
+    };
+    useEffect(() => () => {
+        clearExitTimer();
+        clearFeedbackTimer();
+    }, []);
+    useEffect(() => {
+        if (!visible || !initialPosition) {
+            if (!motion || motion.phase === "hidden")
+                return;
+            activeOperationRef.current = undefined;
+            activeTargetRef.current = undefined;
+            clearFeedbackTimer();
+            const revision = ++motionRevisionRef.current;
+            setMotion((current) => current
+                ? { ...current, durationMs: POINTER_EXIT_DURATION_MS, feedback: undefined, phase: "hidden", revision }
+                : current);
+            clearExitTimer();
+            exitTimerRef.current = setTimeout(() => {
+                if (motionRevisionRef.current === revision)
+                    setMotion(undefined);
+            }, POINTER_EXIT_DURATION_MS);
+            return;
+        }
+        clearExitTimer();
+        if (!motion) {
+            activeOperationRef.current = operation.toolCallId;
+            activeTargetRef.current = undefined;
+            const revision = ++motionRevisionRef.current;
+            setMotion({
+                durationMs: 0,
+                feedback: undefined,
+                phase: "resting",
+                position: initialPosition,
+                revision,
+                toolCallId: operation.toolCallId,
+            });
+            return;
+        }
+        if (!active) {
+            activeOperationRef.current = undefined;
+            activeTargetRef.current = undefined;
+            clearFeedbackTimer();
+            if (motion.phase !== "resting" || motion.feedback) {
+                const revision = ++motionRevisionRef.current;
+                setMotion((current) => current
+                    ? { ...current, feedback: undefined, phase: "resting", revision }
+                    : current);
+            }
+            return;
+        }
+        const operationChanged = activeOperationRef.current !== operation.toolCallId;
+        if (operationChanged) {
+            activeOperationRef.current = operation.toolCallId;
+            activeTargetRef.current = undefined;
+            clearFeedbackTimer();
+        }
+        else if (motion.phase === "hidden") {
+            setMotion((current) => current
+                ? { ...current, durationMs: 0, phase: "resting" }
+                : current);
+        }
+        if (!targetElement || !targetPosition) {
+            if (operationChanged || activeTargetRef.current) {
+                activeTargetRef.current = undefined;
+                clearFeedbackTimer();
+                const revision = ++motionRevisionRef.current;
+                const pointerRect = pointerRef.current?.getBoundingClientRect();
+                setMotion((current) => current
+                    ? {
+                        ...current,
+                        durationMs: 0,
+                        feedback: undefined,
+                        phase: "resting",
+                        position: pointerRect
+                            ? { left: pointerRect.left, top: pointerRect.top }
+                            : current.position,
+                        revision,
+                        toolCallId: operation.toolCallId,
+                    }
+                    : current);
+            }
+            return;
+        }
+        const targetChanged = operationChanged || activeTargetRef.current !== targetElement;
+        if (!targetChanged) {
+            if (motion.position.left === targetPosition.left && motion.position.top === targetPosition.top)
+                return;
+            setMotion((current) => current
+                ? { ...current, durationMs: 180, position: targetPosition }
+                : current);
+            return;
+        }
+        activeTargetRef.current = targetElement;
+        clearFeedbackTimer();
+        const revision = ++motionRevisionRef.current;
+        const pointerRect = pointerRef.current?.getBoundingClientRect();
+        const currentPosition = pointerRect
+            ? { left: pointerRect.left, top: pointerRect.top }
+            : motion.position;
+        const prefersReducedMotion = window.matchMedia?.("(prefers-reduced-motion: reduce)").matches ?? false;
+        const durationMs = prefersReducedMotion ? 0 : pointerMoveDuration(currentPosition, targetPosition);
+        setMotion((current) => current
+            ? {
+                ...current,
+                durationMs,
+                feedback: undefined,
+                phase: "moving",
+                position: targetPosition,
+                revision,
+                toolCallId: operation.toolCallId,
+            }
+            : current);
+        if (durationMs === 0)
+            beginFeedback(revision, operation.toolCallId);
+    }, [
+        active,
+        initialPosition?.left,
+        initialPosition?.top,
+        motion,
+        operation.toolCallId,
+        targetElement,
+        targetPosition?.left,
+        targetPosition?.top,
+        visible,
+    ]);
+    if (!motion)
+        return null;
+    const effect = operationEffect(operation);
+    const activeEffect = active ? effect : undefined;
+    return (_jsxs("div", { "aria-hidden": true, className: "agent-operation__pointer-effect", "data-active": active ? "true" : "false", "data-feedback": motion.feedback, "data-operation-effect": activeEffect, "data-phase": motion.phase, onTransitionEnd: (event) => {
+            if (event.currentTarget !== event.target
+                || event.propertyName !== "transform"
+                || motion.phase !== "moving"
+                || !pointerReachedTarget(event.currentTarget, motion.position))
+                return;
+            beginFeedback(motion.revision, motion.toolCallId);
+        }, ref: pointerRef, style: {
+            "--agent-operation-pointer-duration": `${motion.durationMs}ms`,
+            "--agent-operation-pointer-x": `${motion.position.left}px`,
+            "--agent-operation-pointer-y": `${motion.position.top}px`,
+            "--agent-operation-ripple-duration": `${POINTER_CLICK_FEEDBACK_DURATION_MS}ms`,
+        }, children: [motion.phase === "arrived" && motion.feedback ? (_jsx("span", { className: "agent-operation__pointer-ripple agent-operation__pointer-ripple--primary" }, `primary-${motion.revision}`)) : null, _jsx("span", { className: "agent-operation__pointer-cursor", children: visible && effect === "action" ? (_jsx(Cursor, { className: "agent-operation__pointer", size: 24, weight: "fill" })) : null }), active && motion.phase !== "hidden" && (labelActive || effect !== "action") ? (_jsxs("span", { className: labelActive ? "agent-operation__pointer-label" : "agent-operation__pointer-indicator", "data-operation-effect": activeEffect, title: labelActive ? label : undefined, children: [activeEffect === "read" ? (_jsxs("span", { className: "agent-operation__pointer-read-scan", children: [_jsx("i", {}), _jsx("i", {}), _jsx("i", {}), _jsx("i", {}), _jsx("i", {})] })) : null, activeEffect === "navigate" ? _jsx("span", { className: "agent-operation__pointer-navigation-trail" }) : null, labelActive ? _jsx("span", { className: "agent-operation__pointer-label-text", children: label }) : null] })) : null] }));
+}
+export function OperationOverlayView({ operation, progressHistory = [], running, feedbackActive = running, labelActive = feedbackActive, humanHasControl = false, taskLabel, onCancel, resolveSurface, resolveTarget }) {
+    const [, setGeometry] = useState("");
+    const [historyOpen, setHistoryOpen] = useState(false);
+    const historyId = useId();
+    const clearTimerRef = useRef(undefined);
+    const controllerTimerRef = useRef(undefined);
+    const [visibleOperation, setVisibleOperation] = useState(operation);
+    const [controllerMounted, setControllerMounted] = useState(Boolean(operation
+        && operation.status !== "cancelled"
+        && (running || humanHasControl || operation.status === "failed")));
+    const [controllerExiting, setControllerExiting] = useState(false);
+    useEffect(() => {
+        if (clearTimerRef.current)
+            clearTimeout(clearTimerRef.current);
+        if (operation)
+            setVisibleOperation(operation);
+        if (operation?.status === "cancelled") {
+            clearTimerRef.current = setTimeout(() => setVisibleOperation(undefined), 600);
+        }
+        return () => { if (clearTimerRef.current)
+            clearTimeout(clearTimerRef.current); };
+    }, [operation, running]);
+    useEffect(() => {
+        if ((!running && !feedbackActive && !humanHasControl) || !visibleOperation || visibleOperation.status === "cancelled")
+            return;
+        let frame = requestAnimationFrame(function update() {
+            const surface = resolveSurface?.();
+            const target = resolveTarget?.(visibleOperation)?.element;
+            const geometry = [surface, target].map((element) => {
+                if (!element?.isConnected)
+                    return "";
+                const rect = element.getBoundingClientRect();
+                return [rect.left, rect.top, rect.width, rect.height].join(",");
+            }).join(";");
+            setGeometry(geometry);
+            frame = requestAnimationFrame(update);
+        });
+        return () => cancelAnimationFrame(frame);
+    }, [visibleOperation?.toolCallId, visibleOperation?.status, running, feedbackActive, humanHasControl, resolveSurface, resolveTarget]);
+    useEffect(() => {
+        if (progressHistory.length === 0)
+            setHistoryOpen(false);
+    }, [progressHistory.length]);
+    const controllerShouldBeVisible = Boolean(visibleOperation
+        && visibleOperation.status !== "cancelled"
+        && (running || humanHasControl || visibleOperation.status === "failed"));
+    useEffect(() => {
+        if (controllerTimerRef.current)
+            clearTimeout(controllerTimerRef.current);
+        if (controllerShouldBeVisible) {
+            setControllerMounted(true);
+            setControllerExiting(false);
+            return;
+        }
+        if (!controllerMounted) {
+            setControllerExiting(false);
+            return;
+        }
+        setHistoryOpen(false);
+        setControllerExiting(true);
+        controllerTimerRef.current = setTimeout(() => {
+            setControllerMounted(false);
+            setControllerExiting(false);
+        }, CONTROLLER_EXIT_DURATION_MS);
+        return () => {
+            if (controllerTimerRef.current)
+                clearTimeout(controllerTimerRef.current);
+        };
+    }, [controllerMounted, controllerShouldBeVisible]);
+    useEffect(() => {
+        if (typeof document === "undefined")
+            return;
+        const surface = resolveSurface?.();
+        if (!surface)
+            return;
+        const previousInert = surface.inert;
+        const previousBusy = surface.getAttribute("aria-busy");
+        const locked = running && !humanHasControl;
+        surface.inert = locked;
+        if (locked)
+            surface.setAttribute("aria-busy", "true");
+        else
+            surface.removeAttribute("aria-busy");
+        return () => {
+            surface.inert = previousInert;
+            if (previousBusy === null)
+                surface.removeAttribute("aria-busy");
+            else
+                surface.setAttribute("aria-busy", previousBusy);
+        };
+    }, [humanHasControl, resolveSurface, running]);
+    if (!visibleOperation || typeof document === "undefined")
+        return null;
+    const resolvedTarget = resolveTarget?.(visibleOperation);
+    const surfaceElement = resolveSurface?.();
+    const target = resolvedTarget && (!surfaceElement || surfaceElement.contains(resolvedTarget.element))
+        ? resolvedTarget
+        : undefined;
+    const progressLabel = operationProgressLabel(visibleOperation);
+    const effect = operationEffect(visibleOperation);
+    const targetLabel = operationTargetLabel(visibleOperation, target);
+    const pointerLabel = normalizedLabel(visibleOperation.progressLabel) ?? targetLabel ?? progressLabel;
+    const normalizedTaskLabel = normalizedLabel(taskLabel);
+    const controllerLabel = normalizedTaskLabel ?? (humanHasControl ? undefined : progressLabel);
+    const statusLabel = humanHasControl ? "等待你完成操作" : {
+        running: "Agent 正在控制",
+        completed: running ? "Agent 正在控制" : "操作已完成",
+        failed: running ? "Agent 正在处理错误" : "操作失败",
+        cancelled: "任务已终止",
+    }[visibleOperation.status];
+    const compactStatusLabel = humanHasControl
+        ? "等待你完成操作"
+        : normalizedTaskLabel ?? progressLabel;
+    const rect = target?.element.isConnected ? target.element.getBoundingClientRect() : undefined;
+    const highlightedRect = effect === "navigate" ? undefined : rect;
+    const surfaceRect = surfaceElement?.isConnected ? surfaceElement.getBoundingClientRect() : undefined;
+    const agentControlsSurface = running && !humanHasControl;
+    const operationFeedbackActive = feedbackActive && !humanHasControl && visibleOperation.status !== "cancelled";
+    const pointerVisible = Boolean(surfaceRect) && feedbackActive && !humanHasControl && visibleOperation.status !== "cancelled";
+    const pointerPosition = rect ? {
+        left: rect.left + rect.width / 2,
+        top: rect.top + rect.height / 2,
+    } : undefined;
+    const cancel = onCancel ? () => {
+        onCancel();
+    } : undefined;
+    return createPortal(_jsxs("div", { className: "agent-operation", "data-feedback-active": feedbackActive, "data-human-control": humanHasControl, "data-operation-effect": effect, "data-run-active": running, "data-status": visibleOperation.status, children: [agentControlsSurface && surfaceRect ? _jsx("div", { "aria-hidden": true, className: "agent-operation__surface", style: {
+                    ...(highlightedRect ? {
+                        "--agent-operation-cutout-height": `${highlightedRect.height}px`,
+                        "--agent-operation-cutout-left": `${highlightedRect.left - surfaceRect.left}px`,
+                        "--agent-operation-cutout-top": `${highlightedRect.top - surfaceRect.top}px`,
+                        "--agent-operation-cutout-width": `${highlightedRect.width}px`,
+                    } : {}),
+                    height: surfaceRect.height, left: surfaceRect.left, top: surfaceRect.top, width: surfaceRect.width,
+                } }) : null, operationFeedbackActive && highlightedRect ? _jsx("div", { "aria-hidden": true, className: "agent-operation__target", "data-operation-effect": effect, style: { height: highlightedRect.height, left: highlightedRect.left, top: highlightedRect.top, width: highlightedRect.width } }) : null, _jsx(AgentPointer, { active: operationFeedbackActive, initialPosition: surfaceRect ? { left: surfaceRect.left + surfaceRect.width / 2, top: surfaceRect.top + surfaceRect.height / 2 } : undefined, label: pointerLabel, labelActive: labelActive, operation: visibleOperation, targetElement: target?.element, targetPosition: pointerPosition, visible: pointerVisible }), controllerMounted ? _jsxs("section", { "aria-live": "polite", className: "agent-operation__controller", "data-visibility": controllerExiting ? "exiting" : "visible", style: surfaceRect ? { left: surfaceRect.left + surfaceRect.width / 2, right: "auto", "--agent-operation-controller-x": "-50%", maxWidth: Math.max(0, surfaceRect.width - 32) } : undefined, children: [historyOpen ? _jsxs("aside", { "aria-label": "\u672C\u6B21\u8FD0\u884C\u7684\u64CD\u4F5C\u8BB0\u5F55", className: "agent-operation__history", id: historyId, children: [_jsxs("header", { children: [_jsx("strong", { children: "\u64CD\u4F5C\u8BB0\u5F55" }), _jsx("span", { children: progressHistory.length })] }), _jsx("ol", { children: progressHistory.map(({ progressLabel: label, toolCallId }, index) => _jsxs("li", { children: [_jsx("span", { "aria-hidden": true, children: index + 1 }), _jsx("p", { children: label })] }, toolCallId)) })] }) : null, _jsx("span", { "aria-hidden": true, className: "agent-operation__edge-flow" }), _jsxs("span", { "aria-hidden": true, className: "agent-operation__pause-mark", children: [_jsx("i", {}), _jsx("i", {})] }), _jsxs("button", { "aria-controls": historyId, "aria-expanded": historyOpen, "aria-label": "\u67E5\u770B\u672C\u6B21\u8FD0\u884C\u7684\u64CD\u4F5C\u8BB0\u5F55", className: "agent-operation__activity", "data-open": historyOpen ? "true" : "false", disabled: progressHistory.length === 0, onClick: () => setHistoryOpen((current) => !current), title: progressHistory.length === 0 ? "暂无操作记录" : "查看本次运行的操作记录", type: "button", children: [_jsx(Sparkle, { className: "agent-operation__activity-icon", size: 16, weight: "fill" }), _jsx("i", {}), _jsx("b", { children: "\u2726" })] }), _jsxs("div", { children: [_jsx("span", { className: "agent-operation__heading", children: _jsx("strong", { children: controllerLabel }) }), statusLabel ? _jsx("small", { className: "agent-operation__description", children: _jsx("span", { className: "agent-operation__status", children: statusLabel }) }) : null] }), (running || humanHasControl) && visibleOperation.status !== "cancelled" ? _jsx("span", { className: "agent-operation__compact-status", title: compactStatusLabel, children: compactStatusLabel }) : null, cancel && running && visibleOperation.status !== "cancelled" ? _jsx("button", { className: "agent-operation__stop", type: "button", onClick: cancel, children: "\u7EC8\u6B62\u4EFB\u52A1" }) : null] }) : null] }), document.body);
+}
+//# sourceMappingURL=operation-view.js.map

package/dist/operation-view.js.map

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

package/dist/react.d.ts

@@ -1,8 +1,47 @@
-import { type MouseEvent, type ReactElement, type ReactNode } from "react";
+import { type MouseEvent, type ReactElement, type ReactNode, type RefCallback } from "react";
+import { type AgentNavigation, type AgentNavigationExecutors } from "./navigation.js";
 import type { ToolRuntime } from "./runtime.js";
 import type { AgentContextEntry, AgentToolDefinition, AgentToolExecutor } from "./types.js";
-export declare function useAgentTool<TInput, TResult>(definition: AgentToolDefinition<TInput, TResult>, execute: AgentToolExecutor<TInput, TResult>): void;
-export declare function AgentToolsProvider({ children, toolRuntime, webMcp, }: {
+export interface AgentToolChatConfirmationConfig {
+    mode: "chat";
+    title?: string;
+    description?: string;
+    confirmLabel?: string;
+    rejectLabel?: string;
+}
+export interface AgentToolPageConfirmationConfig {
+    mode: "page";
+    title?: string;
+    description?: string;
+}
+export interface UseAgentToolDefaultOptions {
+    requiresConfirmation?: AgentToolChatConfirmationConfig;
+}
+export interface UseAgentToolPageConfirmationOptions {
+    requiresConfirmation: AgentToolPageConfirmationConfig;
+}
+export interface AgentToolBinding<TInput = unknown, TElement extends HTMLElement = HTMLElement> {
+    readonly toolName: string;
+    readonly ref: RefCallback<TElement>;
+    refWhen(match: (input: TInput) => boolean): RefCallback<TElement>;
+}
+declare const pageConfirmableAgentToolBindingBrand: unique symbol;
+export interface PageConfirmableAgentToolBinding<TInput = unknown, TElement extends HTMLElement = HTMLElement> extends AgentToolBinding<TInput, TElement> {
+    readonly [pageConfirmableAgentToolBindingBrand]: true;
+}
+type BindingInternals = {
+    resolveTarget(input: unknown): HTMLElement | undefined;
+    pageConfirmable: boolean;
+    getConditionalTargetRegistrations(): readonly {
+        element: HTMLElement;
+        match(input: unknown): boolean;
+    }[];
+};
+export declare function getAgentToolBindingInternals(binding: AgentToolBinding): BindingInternals;
+export declare function useAgentTool<TInput, TResult, TElement extends HTMLElement = HTMLElement>(definition: AgentToolDefinition<TInput, TResult>, execute: AgentToolExecutor<TInput, TResult>, options: UseAgentToolPageConfirmationOptions): PageConfirmableAgentToolBinding<TInput, TElement>;
+export declare function useAgentTool<TInput, TResult, TElement extends HTMLElement = HTMLElement>(definition: AgentToolDefinition<TInput, TResult>, execute: AgentToolExecutor<TInput, TResult>, options?: UseAgentToolDefaultOptions): AgentToolBinding<TInput, TElement>;
+export declare function useAgentNavigation<TNavigation extends AgentNavigation, const TExecutors extends AgentNavigationExecutors<TNavigation>>(navigation: TNavigation, executors: TExecutors & Record<Exclude<keyof TExecutors, keyof AgentNavigationExecutors<TNavigation>>, never>): void;
+export declare function ToolsProvider({ children, toolRuntime, webMcp, }: {
     children: ReactNode;
     toolRuntime: ToolRuntime;
     webMcp?: boolean;

package/dist/react.js

@@ -1,23 +1,132 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Children, Fragment, cloneElement, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, } from "react";
 import { defineAgentTool } from "./definition.js";
+import { getAgentNavigationEntries, } from "./navigation.js";
 import { AgentToolError, getInternalToolRuntime } from "./runtime.js";
 import { InternalToolRuntimeScope, useInternalToolRuntime, } from "./internal-react.js";
 import { connectToolRuntimeToWebMcp } from "./webmcp.js";
-function useAgentBinding(definition, execute) {
+const bindingInternals = new WeakMap();
+export function getAgentToolBindingInternals(binding) {
+    const internals = bindingInternals.get(binding);
+    if (!internals)
+        throw new Error("Invalid Agent Tool Binding.");
+    return internals;
+}
+function createAgentToolBinding(toolName, pageConfirmable) {
+    let fixedElement = null;
+    const conditionalElements = new Map();
+    const ref = (element) => {
+        if (element && fixedElement && fixedElement !== element) {
+            throw new Error("An Agent Tool Binding ref can only attach to one element.");
+        }
+        fixedElement = element;
+    };
+    const binding = {
+        toolName,
+        ref,
+        refWhen(match) {
+            let callback;
+            callback = (element) => {
+                if (element) {
+                    conditionalElements.set(callback, { element, match });
+                }
+                else {
+                    conditionalElements.delete(callback);
+                }
+            };
+            return callback;
+        },
+    };
+    bindingInternals.set(binding, {
+        resolveTarget(input) {
+            for (const entry of conditionalElements.values()) {
+                if (entry.element.isConnected && entry.match(input))
+                    return entry.element;
+            }
+            return fixedElement?.isConnected ? fixedElement : undefined;
+        },
+        pageConfirmable,
+        getConditionalTargetRegistrations: () => Array.from(conditionalElements.values(), ({ element, match }) => ({
+            element,
+            match: (input) => match(input),
+        })),
+    });
+    return binding;
+}
+function useAgentBinding(definition, execute, options) {
     const runtime = useInternalToolRuntime();
+    const confirmation = options.requiresConfirmation;
+    if (confirmation !== undefined
+        && (!confirmation
+            || typeof confirmation !== "object"
+            || (confirmation.mode !== "chat" && confirmation.mode !== "page"))) {
+        throw new Error("requiresConfirmation must explicitly use chat or page mode.");
+    }
     const executeRef = useRef(execute);
     executeRef.current = execute;
+    const confirmationRef = useRef(confirmation);
+    confirmationRef.current = confirmation;
+    const mode = confirmation?.mode;
+    const binding = useMemo(() => createAgentToolBinding(definition.name, mode === "page"), [runtime, definition, mode]);
     useLayoutEffect(() => {
         const controller = new AbortController();
-        runtime.register(definition, (input, context) => executeRef.current(input, context), { signal: controller.signal });
+        runtime.register(definition, (input, context) => executeRef.current(input, context), {
+            signal: controller.signal,
+            getConfirmation: () => confirmationRef.current,
+            resolveTarget: (input) => getAgentToolBindingInternals(binding).resolveTarget(input),
+        });
         return () => controller.abort();
-    }, [runtime, definition]);
+    }, [runtime, definition, mode]);
+    return binding;
+}
+export function useAgentTool(definition, execute, options = {}) {
+    return useAgentBinding(definition, execute, options);
 }
-export function useAgentTool(definition, execute) {
-    useAgentBinding(definition, execute);
+function getAgentNavigationExecutor(executors, key) {
+    if (!executors
+        || typeof executors !== "object"
+        || !Object.hasOwn(executors, key)) {
+        throw new Error(`Missing navigation executor: ${key}.`);
+    }
+    const executor = executors[key];
+    if (typeof executor !== "function") {
+        throw new Error(`Missing navigation executor: ${key}.`);
+    }
+    return executor;
+}
+export function useAgentNavigation(navigation, executors) {
+    const runtime = useInternalToolRuntime();
+    const entries = getAgentNavigationEntries(navigation);
+    for (const entry of entries) {
+        getAgentNavigationExecutor(executors, entry.key);
+    }
+    const routeKeys = new Set(entries.map((entry) => entry.key));
+    for (const key of Object.keys(executors)) {
+        if (!routeKeys.has(key)) {
+            throw new Error(`Unknown navigation executor: ${key}.`);
+        }
+    }
+    const executorsRef = useRef(executors);
+    executorsRef.current = executors;
+    useLayoutEffect(() => {
+        const controller = new AbortController();
+        try {
+            for (const entry of entries) {
+                runtime.register(entry.definition, async (input, context) => {
+                    const executor = getAgentNavigationExecutor(executorsRef.current, entry.key);
+                    await executor(input, context);
+                    return { status: "navigated" };
+                }, { signal: controller.signal });
+            }
+        }
+        catch (error) {
+            controller.abort();
+            throw error;
+        }
+        return () => controller.abort();
+    }, [runtime, navigation]);
 }
-export function AgentToolsProvider({ children, toolRuntime, webMcp = true, }) {
+export function ToolsProvider({ children, toolRuntime, webMcp = true, }) {
     const runtime = getInternalToolRuntime(toolRuntime);
     return (_jsxs(InternalToolRuntimeScope, { runtime: toolRuntime, children: [_jsx(WebMcpRuntimeBridge, { enabled: webMcp, runtime: runtime }), children] }));
 }