@nexface/tools 0.1.0

package/dist/react.js

@@ -0,0 +1,258 @@
+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 { AgentToolError, getInternalToolRuntime } from "./runtime.js";
+import { InternalToolRuntimeScope, useInternalToolRuntime, } from "./internal-react.js";
+import { connectToolRuntimeToWebMcp } from "./webmcp.js";
+function useAgentBinding(definition, execute) {
+    const runtime = useInternalToolRuntime();
+    const executeRef = useRef(execute);
+    executeRef.current = execute;
+    useLayoutEffect(() => {
+        const controller = new AbortController();
+        runtime.register(definition, (input, context) => executeRef.current(input, context), { signal: controller.signal });
+        return () => controller.abort();
+    }, [runtime, definition]);
+}
+export function useAgentTool(definition, execute) {
+    useAgentBinding(definition, execute);
+}
+export function AgentToolsProvider({ children, toolRuntime, webMcp = true, }) {
+    const runtime = getInternalToolRuntime(toolRuntime);
+    return (_jsxs(InternalToolRuntimeScope, { runtime: toolRuntime, children: [_jsx(WebMcpRuntimeBridge, { enabled: webMcp, runtime: runtime }), children] }));
+}
+function WebMcpRuntimeBridge({ enabled, runtime, }) {
+    useEffect(() => {
+        if (!enabled)
+            return undefined;
+        return connectToolRuntimeToWebMcp(runtime);
+    }, [enabled, runtime]);
+    return null;
+}
+export function useAgentContext(context) {
+    const runtime = useInternalToolRuntime();
+    const registrationRef = useRef(undefined);
+    useLayoutEffect(() => {
+        const controller = new AbortController();
+        const registration = runtime.registerContext(context, { signal: controller.signal });
+        registrationRef.current = registration;
+        return () => {
+            if (registrationRef.current === registration)
+                registrationRef.current = undefined;
+            controller.abort();
+        };
+    }, [runtime, context.name]);
+    useLayoutEffect(() => {
+        registrationRef.current?.update(context);
+    }, [runtime, context.name, context.description, context.value]);
+}
+export function AgentContext(context) {
+    useAgentContext(context);
+    return null;
+}
+function waitForActionResult(result, signal) {
+    if (signal.aborted)
+        return Promise.reject(signal.reason);
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            signal.removeEventListener("abort", onAbort);
+            reject(signal.reason);
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+        Promise.resolve(result).then((value) => {
+            signal.removeEventListener("abort", onAbort);
+            resolve(value);
+        }, (error) => {
+            signal.removeEventListener("abort", onAbort);
+            reject(error);
+        });
+    });
+}
+function setRefValue(ref, value) {
+    if (typeof ref === "function") {
+        const cleanup = ref(value);
+        return typeof cleanup === "function" ? cleanup : undefined;
+    }
+    if (ref)
+        ref.current = value;
+}
+function getElementRef(element) {
+    const props = element.props;
+    const refDescriptor = Object.getOwnPropertyDescriptor(element, "ref");
+    if (refDescriptor && "value" in refDescriptor) {
+        return refDescriptor.value;
+    }
+    return props.ref;
+}
+function isHTMLElement(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const ownerDocument = value.ownerDocument;
+    const ElementConstructor = ownerDocument?.defaultView?.HTMLElement ??
+        (typeof HTMLElement === "undefined" ? undefined : HTMLElement);
+    return ElementConstructor !== undefined && value instanceof ElementConstructor;
+}
+function warnAgentUIAction(message) {
+    if (typeof process !== "undefined" && process.env.NODE_ENV !== "production") {
+        console.warn(message);
+    }
+}
+const eventAdapters = {
+    click: {
+        invoke(target) {
+            target.click();
+        },
+    },
+};
+export function AgentUIAction({ name, description, event = "click", children, }) {
+    const runtime = useInternalToolRuntime();
+    const child = Children.only(children);
+    const isFragment = child.type === Fragment;
+    const handler = isFragment ? undefined : child.props.onClick;
+    const childDisabled = isFragment ? false : Boolean(child.props.disabled);
+    const childRef = isFragment ? undefined : getElementRef(child);
+    const [target, setTarget] = useState(null);
+    const targetRef = useRef(null);
+    const handlerRef = useRef(handler);
+    const disabledRef = useRef(childDisabled);
+    const pendingInvocationRef = useRef(null);
+    const invalidTargetRef = useRef(false);
+    const warnedTargetRef = useRef(false);
+    const warnedChildRef = useRef(null);
+    const invokingRef = useRef(false);
+    useLayoutEffect(() => {
+        handlerRef.current = handler;
+        disabledRef.current = childDisabled;
+    });
+    const mergedRef = useCallback((value) => {
+        const element = isHTMLElement(value) ? value : null;
+        const cleanupChildRef = setRefValue(childRef, value);
+        invalidTargetRef.current = value !== null && !element;
+        targetRef.current = element;
+        setTarget(element);
+        if (element)
+            warnedTargetRef.current = false;
+        if (cleanupChildRef) {
+            return () => {
+                cleanupChildRef();
+                if (targetRef.current === element) {
+                    invalidTargetRef.current = false;
+                    targetRef.current = null;
+                    setTarget(null);
+                }
+            };
+        }
+    }, [childRef]);
+    const invokeHandler = useCallback((mouseEvent) => {
+        const currentHandler = handlerRef.current;
+        const pending = pendingInvocationRef.current;
+        if (pending)
+            pendingInvocationRef.current = null;
+        if (!currentHandler) {
+            pending?.reject(new AgentToolError("ACTION_NOT_HANDLED", `AgentUIAction "${name}" does not have an onClick handler.`));
+            return undefined;
+        }
+        try {
+            const result = currentHandler(mouseEvent);
+            if (pending)
+                Promise.resolve(result).then(pending.resolve, pending.reject);
+            return result;
+        }
+        catch (error) {
+            if (pending) {
+                pending.reject(error);
+                return undefined;
+            }
+            throw error;
+        }
+    }, [name]);
+    const definition = useMemo(() => defineAgentTool({
+        name,
+        description,
+    }), [name, description]);
+    useLayoutEffect(() => {
+        if (isFragment || !handler) {
+            const warningType = isFragment ? "fragment" : "handler";
+            if (warnedChildRef.current !== warningType) {
+                warnedChildRef.current = warningType;
+                warnAgentUIAction(isFragment
+                    ? `AgentUIAction "${name}" does not support React.Fragment children.`
+                    : `AgentUIAction "${name}" needs a child with onClick.`);
+            }
+            return;
+        }
+        warnedChildRef.current = null;
+        if (!target) {
+            if (!targetRef.current && !warnedTargetRef.current) {
+                warnedTargetRef.current = true;
+                warnAgentUIAction(invalidTargetRef.current
+                    ? `AgentUIAction "${name}" needs its child ref to resolve to an HTMLElement; the Tool is not registered.`
+                    : `AgentUIAction "${name}" needs its child to forward ref to an HTMLElement; the Tool is not registered.`);
+            }
+            return;
+        }
+        const controller = new AbortController();
+        runtime.register(definition, async (_input, context) => {
+            if (invokingRef.current) {
+                throw new AgentToolError("ACTION_IN_FLIGHT", `AgentUIAction "${name}" is already being invoked.`);
+            }
+            if (disabledRef.current) {
+                throw new AgentToolError("TOOL_UNAVAILABLE", `AgentUIAction "${name}" is disabled.`);
+            }
+            const currentTarget = targetRef.current;
+            if (!currentTarget || !currentTarget.isConnected) {
+                throw new AgentToolError("ACTION_TARGET_UNAVAILABLE", `AgentUIAction "${name}" target is not available.`);
+            }
+            invokingRef.current = true;
+            let resolveInvocation;
+            let rejectInvocation;
+            const actionPromise = new Promise((resolve, reject) => {
+                resolveInvocation = resolve;
+                rejectInvocation = reject;
+            });
+            const pendingInvocation = {
+                resolve: resolveInvocation,
+                reject: rejectInvocation,
+            };
+            pendingInvocationRef.current = pendingInvocation;
+            try {
+                eventAdapters[event].invoke(currentTarget);
+            }
+            catch (error) {
+                if (pendingInvocationRef.current === pendingInvocation) {
+                    pendingInvocationRef.current = null;
+                }
+                invokingRef.current = false;
+                throw error;
+            }
+            if (pendingInvocationRef.current === pendingInvocation) {
+                pendingInvocationRef.current = null;
+                invokingRef.current = false;
+                throw new AgentToolError("ACTION_NOT_HANDLED", `AgentUIAction "${name}" click did not invoke its onClick handler.`);
+            }
+            try {
+                return await waitForActionResult(actionPromise, context.signal);
+            }
+            finally {
+                if (context.signal.aborted) {
+                    void actionPromise.then(() => {
+                        invokingRef.current = false;
+                    }, () => {
+                        invokingRef.current = false;
+                    });
+                }
+                else {
+                    invokingRef.current = false;
+                }
+            }
+        }, { signal: controller.signal });
+        return () => controller.abort();
+    }, [runtime, definition, event, handler !== undefined, isFragment, name, target]);
+    if (isFragment)
+        return child;
+    return cloneElement(child, {
+        onClick: invokeHandler,
+        ref: mergedRef,
+    });
+}
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,SAAS,EACT,eAAe,EACf,OAAO,EACP,MAAM,EACN,QAAQ,GAKT,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,SAAS,eAAe,CAItB,UAAgD,EAChD,OAA2C;IAE3C,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAC;IACzC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAC7B,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,OAAO,CAAC,QAAQ,CACd,UAAU,EACV,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EACtD,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAC9B,CAAC;QACF,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,YAAY,CAI1B,UAAgD,EAChD,OAA2C;IAE3C,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EACjC,QAAQ,EACR,WAAW,EACX,MAAM,GAAG,IAAI,GAKd;IACC,MAAM,OAAO,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACpD,OAAO,CACL,MAAC,wBAAwB,IAAC,OAAO,EAAE,WAAW,aAC5C,KAAC,mBAAmB,IAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAI,EACzD,QAAQ,IACgB,CAC5B,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,EAC3B,OAAO,EACP,OAAO,GAIR;IACC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,OAAO,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA0B;IACxD,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAC;IACzC,MAAM,eAAe,GAAG,MAAM,CAAuC,SAAS,CAAC,CAAC;IAChF,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACrF,eAAe,CAAC,OAAO,GAAG,YAAY,CAAC;QACvC,OAAO,GAAG,EAAE;YACV,IAAI,eAAe,CAAC,OAAO,KAAK,YAAY;gBAAE,eAAe,CAAC,OAAO,GAAG,SAAS,CAAC;YAClF,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5B,eAAe,CAAC,GAAG,EAAE;QACnB,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAA0B;IACrD,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAAkC,EAClC,MAAmB;IAEnB,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAC1B,CAAC,KAAK,EAAE,EAAE;YACR,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACR,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAuBD,SAAS,WAAW,CAAI,GAAuB,EAAE,KAAe;IAC9D,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,CAAC;IACD,IAAI,GAAG;QAAE,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;AAC/B,CAAC;AAED,SAAS,aAAa,CAAC,OAAqB;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAgC,CAAC;IACvD,MAAM,aAAa,GAAG,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtE,IAAI,aAAa,IAAI,OAAO,IAAI,aAAa,EAAE,CAAC;QAC9C,OAAO,aAAa,CAAC,KAAqC,CAAC;IAC7D,CAAC;IACD,OAAQ,KAAoC,CAAC,GAAG,CAAC;AACnD,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,aAAa,GAAI,KAAsC,CAAC,aAAa,CAAC;IAC5E,MAAM,kBAAkB,GACtB,aAAa,EAAE,WAAW,EAAE,WAAW;QACvC,CAAC,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACjE,OAAO,kBAAkB,KAAK,SAAS,IAAI,KAAK,YAAY,kBAAkB,CAAC;AACjF,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe;IACxC,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,aAAa,GAAsE;IACvF,KAAK,EAAE;QACL,MAAM,CAAC,MAAM;YACX,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;KACF;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAAiB,EAC5C,IAAI,EACJ,WAAW,EACX,KAAK,GAAG,OAAO,EACf,QAAQ,GACoB;IAC5B,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAmD,CAAC;IACxF,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;IAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;IAC7D,MAAM,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC/D,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IAC1C,MAAM,oBAAoB,GAAG,MAAM,CAAoC,IAAI,CAAC,CAAC;IAC7E,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,cAAc,GAAG,MAAM,CAAgC,IAAI,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAElC,eAAe,CAAC,GAAG,EAAE;QACnB,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;QAC7B,WAAW,CAAC,OAAO,GAAG,aAAa,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,KAAc,EAAE,EAAE;QACjB,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,MAAM,eAAe,GAAG,WAAW,CAAC,QAAoC,EAAE,KAAK,CAAC,CAAC;QACjF,gBAAgB,CAAC,OAAO,GAAG,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC;QACtD,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC;QAC5B,SAAS,CAAC,OAAO,CAAC,CAAC;QACnB,IAAI,OAAO;YAAE,eAAe,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7C,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,GAAG,EAAE;gBACV,eAAe,EAAE,CAAC;gBAClB,IAAI,SAAS,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;oBAClC,gBAAgB,CAAC,OAAO,GAAG,KAAK,CAAC;oBACjC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;oBACzB,SAAS,CAAC,IAAI,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC,CAAC;QACJ,CAAC;IACH,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,UAAmC,EAAE,EAAE;QACxE,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;QAC1C,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC;QAC7C,IAAI,OAAO;YAAE,oBAAoB,CAAC,OAAO,GAAG,IAAI,CAAC;QACjD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,EAAE,MAAM,CACb,IAAI,cAAc,CAChB,oBAAoB,EACpB,kBAAkB,IAAI,qCAAqC,CAC5D,CACF,CAAC;YACF,OAAO,SAAoB,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;YAC1C,IAAI,OAAO;gBAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAC3E,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtB,OAAO,SAAoB,CAAC;YAC9B,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,MAAM,UAAU,GAAG,OAAO,CACxB,GAAG,EAAE,CACH,eAAe,CAAU;QACvB,IAAI;QACJ,WAAW;KACZ,CAAC,EACJ,CAAC,IAAI,EAAE,WAAW,CAAC,CACpB,CAAC;IAEF,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,UAAU,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YACxD,IAAI,cAAc,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;gBAC3C,cAAc,CAAC,OAAO,GAAG,WAAW,CAAC;gBACrC,iBAAiB,CACf,UAAU;oBACR,CAAC,CAAC,kBAAkB,IAAI,6CAA6C;oBACrE,CAAC,CAAC,kBAAkB,IAAI,+BAA+B,CAC1D,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QACD,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;gBACnD,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC/B,iBAAiB,CACf,gBAAgB,CAAC,OAAO;oBACtB,CAAC,CAAC,kBAAkB,IAAI,iFAAiF;oBACzG,CAAC,CAAC,kBAAkB,IAAI,iFAAiF,CAC5G,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,OAAO,CAAC,QAAQ,CACd,UAAU,EACV,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YACxB,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACxB,MAAM,IAAI,cAAc,CACtB,kBAAkB,EAClB,kBAAkB,IAAI,6BAA6B,CACpD,CAAC;YACJ,CAAC;YACD,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACxB,MAAM,IAAI,cAAc,CACtB,kBAAkB,EAClB,kBAAkB,IAAI,gBAAgB,CACvC,CAAC;YACJ,CAAC;YACD,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC;YACxC,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;gBACjD,MAAM,IAAI,cAAc,CACtB,2BAA2B,EAC3B,kBAAkB,IAAI,4BAA4B,CACnD,CAAC;YACJ,CAAC;YACD,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3B,IAAI,iBAAmE,CAAC;YACxE,IAAI,gBAA6C,CAAC;YAClD,MAAM,aAAa,GAAG,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC7D,iBAAiB,GAAG,OAAO,CAAC;gBAC5B,gBAAgB,GAAG,MAAM,CAAC;YAC5B,CAAC,CAAC,CAAC;YACH,MAAM,iBAAiB,GAAG;gBACxB,OAAO,EAAE,iBAAiB;gBAC1B,MAAM,EAAE,gBAAgB;aACzB,CAAC;YACF,oBAAoB,CAAC,OAAO,GAAG,iBAAiB,CAAC;YACjD,IAAI,CAAC;gBACH,aAAa,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,oBAAoB,CAAC,OAAO,KAAK,iBAAiB,EAAE,CAAC;oBACvD,oBAAoB,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtC,CAAC;gBACD,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC;gBAC5B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,oBAAoB,CAAC,OAAO,KAAK,iBAAiB,EAAE,CAAC;gBACvD,oBAAoB,CAAC,OAAO,GAAG,IAAI,CAAC;gBACpC,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC;gBAC5B,MAAM,IAAI,cAAc,CACtB,oBAAoB,EACpB,kBAAkB,IAAI,6CAA6C,CACpE,CAAC;YACJ,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,MAAM,mBAAmB,CAAC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAClE,CAAC;oBAAS,CAAC;gBACT,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC3B,KAAK,aAAa,CAAC,IAAI,CACrB,GAAG,EAAE;wBACH,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC;oBAC9B,CAAC,EACD,GAAG,EAAE;wBACH,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC;oBAC9B,CAAC,CACF,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC,EACD,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAC9B,CAAC;QACF,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,KAAK,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAElF,IAAI,UAAU;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,YAAY,CAAC,KAAK,EAAE;QACzB,OAAO,EAAE,aAAa;QACtB,GAAG,EAAE,SAAS;KACiD,CAAC,CAAC;AACrE,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,93 @@
+import type { AgentContextEntry, AgentContextInput, AgentContextRegistration, AgentToolDefinition, AgentToolExecutor } from "./types.js";
+import { type BrowserToolsConfig } from "./browser/toolset.js";
+export interface ToolRuntimeOptions {
+    readonly browserTools?: BrowserToolsConfig;
+}
+declare const CONTEXT_ERROR_CODES: readonly ["CONTEXT_DISPOSED", "CONTEXT_NAME_MISMATCH", "DUPLICATE_CONTEXT", "INVALID_CONTEXT"];
+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", "TOOL_CANCELLED", "TOOL_REGISTRATION_TIMEOUT", "TOOL_SKIPPED", "TOOL_UNAVAILABLE", "UNKNOWN_TOOL"];
+type AgentContextErrorCode = typeof CONTEXT_ERROR_CODES[number];
+type AgentToolErrorCode = typeof TOOL_ERROR_CODES[number];
+export declare function isToolRuntimeError(error: unknown): error is {
+    readonly type: "tool_runtime_error";
+    readonly domain: "tool" | "context";
+    readonly code: string;
+    readonly message: string;
+    readonly details?: unknown;
+};
+declare const toolRuntimeBrand: unique symbol;
+export interface ToolRuntime {
+    readonly [toolRuntimeBrand]: true;
+    getTools(): readonly AgentToolDefinition[];
+    getContexts(options?: {
+        signal?: AbortSignal;
+    }): Promise<readonly AgentContextEntry[]>;
+    execute<TInput, TResult>(definition: AgentToolDefinition<TInput, TResult>, input: TInput, options?: {
+        signal?: AbortSignal;
+    }): Promise<TResult>;
+}
+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 declare class AgentContextError extends Error {
+    readonly code: AgentContextErrorCode;
+    readonly type: "tool_runtime_error";
+    readonly domain: "context";
+    constructor(code: AgentContextErrorCode, message: string);
+}
+export interface InternalToolRuntime extends ToolRuntime, EventTarget {
+    register<TInput, TResult>(definition: AgentToolDefinition<TInput, TResult>, execute: AgentToolExecutor<TInput, TResult>, options?: {
+        signal?: AbortSignal;
+    }): () => void;
+    registerContext(input: AgentContextInput, options?: {
+        signal?: AbortSignal;
+    }): AgentContextRegistration;
+    getApplicationTools(): readonly AgentToolDefinition[];
+    isRegistered(name: string): boolean;
+    executeApplicationTool(name: string, input: unknown, options?: {
+        signal?: AbortSignal;
+        expectedDefinition?: AgentToolDefinition;
+    }): Promise<unknown>;
+    waitForTool(definition: AgentToolDefinition<any, any>, options?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<void>;
+    getContextRevision(): number;
+    getContextsNow(): readonly AgentContextEntry[];
+}
+export declare function createToolRuntime(options?: ToolRuntimeOptions): ToolRuntime;
+export declare function getInternalToolRuntime(runtime: ToolRuntime): InternalToolRuntime;
+export declare class ToolRuntimeImplementation extends EventTarget implements ToolRuntime, InternalToolRuntime {
+    #private;
+    readonly [toolRuntimeBrand]: true;
+    constructor(options?: ToolRuntimeOptions);
+    register<TInput, TResult>(definition: AgentToolDefinition<TInput, TResult>, execute: AgentToolExecutor<TInput, TResult>, options?: {
+        signal?: AbortSignal;
+    }): () => void;
+    registerContext(input: AgentContextInput, options?: {
+        signal?: AbortSignal;
+    }): AgentContextRegistration;
+    getContextsNow(): readonly AgentContextEntry[];
+    getContextRevision(): number;
+    getContexts(options?: {
+        signal?: AbortSignal;
+    }): Promise<readonly AgentContextEntry[]>;
+    getApplicationTools(): readonly AgentToolDefinition[];
+    isRegistered(name: string): boolean;
+    getTools(): readonly AgentToolDefinition[];
+    waitForTool(definition: AgentToolDefinition<any, any>, options?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<void>;
+    execute<TInput, TResult>(definition: AgentToolDefinition<TInput, TResult>, input: TInput, options?: {
+        signal?: AbortSignal;
+    }): Promise<TResult>;
+    executeApplicationTool(name: string, input: unknown, options?: {
+        signal?: AbortSignal;
+        expectedDefinition?: AgentToolDefinition;
+    }): Promise<unknown>;
+}
+export {};