npm - @nexface/tools - Versions diffs - 0.1.15-alpha.0 → 0.1.15-alpha.1 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/dist/index.d.ts +1 -1
package/dist/index.js +1 -1
package/dist/index.js.map +1 -1
package/dist/react.js +3 -3
package/dist/react.js.map +1 -1
package/dist/registration.d.ts +3 -6
package/dist/registration.js +5 -25
package/dist/registration.js.map +1 -1
package/dist/runtime.d.ts +15 -2
package/dist/runtime.js +15 -2
package/dist/runtime.js.map +1 -1
package/package.json +1 -1
package/dist/shared/tool-registry.d.ts +0 -6
package/dist/shared/tool-registry.js +0 -10
package/dist/shared/tool-registry.js.map +0 -1

package/dist/index.d.ts CHANGED Viewed

@@ -7,4 +7,4 @@ export type { AgentNavigation, AgentNavigationConfig, AgentNavigationExecutors,
 export type { AgentToolBinding, AgentToolChatConfirmationConfig, AgentToolPageConfirmationConfig, AgentUIActionChildProps, AgentUIActionEvent, AgentUIActionProps, UseAgentToolDefaultOptions, UseAgentToolPageConfirmationOptions, } from "./react.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";
-export { createAgentToolRegistry, registerAgentTool, type RegisteredAgentTool } from "./registration.js";
+export { registerAgentTool, type RegisteredAgentTool } from "./registration.js";

package/dist/index.js CHANGED Viewed

@@ -3,5 +3,5 @@ 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";
-export { createAgentToolRegistry, registerAgentTool } from "./registration.js";
+export { registerAgentTool } from "./registration.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +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,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;AAqCpB,OAAO,EAAE,~~uBAAuB,EAAE,~~iBAAiB,EAA4B,MAAM,mBAAmB,CAAC","sourcesContent":["export { defineAgentTool } from \"./definition.js\";\nexport { defineAgentNavigation } from \"./navigation.js\";\nexport { AgentOperationSurface, type AgentOperationSurfaceProps } from \"./operation-surface.js\";\nexport {\n createToolRuntime,\n isToolRuntimeError,\n} from \"./runtime.js\";\nexport {\n AgentContext,\n ToolsProvider,\n AgentUIAction,\n useAgentContext,\n useAgentNavigation,\n useAgentTool,\n} from \"./react.js\";\nexport type {\n AgentNavigation,\n AgentNavigationConfig,\n AgentNavigationExecutors,\n AgentNavigationRouteConfig,\n} from \"./navigation.js\";\nexport type {\n AgentToolBinding,\n AgentToolChatConfirmationConfig,\n AgentToolPageConfirmationConfig,\n AgentUIActionChildProps,\n AgentUIActionEvent,\n AgentUIActionProps,\n UseAgentToolDefaultOptions,\n UseAgentToolPageConfirmationOptions,\n} from \"./react.js\";\nexport type {\n AgentToolConfirmationConfig,\n RuntimeAgentTool,\n ToolRuntime,\n ToolOperation,\n ToolRuntimeOptions,\n ToolRuntimeToolChangeEvent,\n} from \"./runtime.js\";\nexport type {\n AgentContextEntry,\n AgentContextValue,\n AgentToolDefinition,\n AgentToolEffect,\n AgentToolExecutionContext,\n AgentToolExecutor,\n AgentToolInputSchema,\n InferJsonSchema,\n JsonSchema,\n} from \"./types.js\";\n\nexport { ~~createAgentToolRegistry,~~ registerAgentTool, type RegisteredAgentTool } from \"./registration.js\";\n"]}
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,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;AAqCpB,OAAO,EAAE,iBAAiB,EAA4B,MAAM,mBAAmB,CAAC","sourcesContent":["export { defineAgentTool } from \"./definition.js\";\nexport { defineAgentNavigation } from \"./navigation.js\";\nexport { AgentOperationSurface, type AgentOperationSurfaceProps } from \"./operation-surface.js\";\nexport {\n createToolRuntime,\n isToolRuntimeError,\n} from \"./runtime.js\";\nexport {\n AgentContext,\n ToolsProvider,\n AgentUIAction,\n useAgentContext,\n useAgentNavigation,\n useAgentTool,\n} from \"./react.js\";\nexport type {\n AgentNavigation,\n AgentNavigationConfig,\n AgentNavigationExecutors,\n AgentNavigationRouteConfig,\n} from \"./navigation.js\";\nexport type {\n AgentToolBinding,\n AgentToolChatConfirmationConfig,\n AgentToolPageConfirmationConfig,\n AgentUIActionChildProps,\n AgentUIActionEvent,\n AgentUIActionProps,\n UseAgentToolDefaultOptions,\n UseAgentToolPageConfirmationOptions,\n} from \"./react.js\";\nexport type {\n AgentToolConfirmationConfig,\n RuntimeAgentTool,\n ToolRuntime,\n ToolOperation,\n ToolRuntimeOptions,\n ToolRuntimeToolChangeEvent,\n} from \"./runtime.js\";\nexport type {\n AgentContextEntry,\n AgentContextValue,\n AgentToolDefinition,\n AgentToolEffect,\n AgentToolExecutionContext,\n AgentToolExecutor,\n AgentToolInputSchema,\n InferJsonSchema,\n JsonSchema,\n} from \"./types.js\";\n\nexport { registerAgentTool, type RegisteredAgentTool } from \"./registration.js\";\n"]}

package/dist/react.js CHANGED Viewed

@@ -69,7 +69,7 @@ function useAgentBinding(definition, execute, options) {
     const binding = useMemo(() => createAgentToolBinding(definition.name), [runtime, definition, mode]);
     useLayoutEffect(() => {
         const controller = new AbortController();
-        runtime.register(definition, (input, context) => executeRef.current(input, context), {
+        runtime.bindTool(definition, (input, context) => executeRef.current(input, context), {
             signal: controller.signal,
             getConfirmation: () => confirmationRef.current,
             resolveTarget: (input) => getAgentToolBindingInternals(binding).resolveTarget(input),
@@ -111,7 +111,7 @@ export function useAgentNavigation(navigation, executors) {
         const controller = new AbortController();
         try {
             for (const entry of entries) {
-                runtime.register(entry.definition, async (input, context) => {
+                runtime.bindTool(entry.definition, async (input, context) => {
                     const executor = getAgentNavigationExecutor(executorsRef.current, entry.key);
                     await executor(input, context);
                     return { status: "navigated" };
@@ -302,7 +302,7 @@ export function AgentUIAction({ name, description, event = "click", children, })
             return;
         }
         const controller = new AbortController();
-        runtime.register(definition, async (_input, context) => {
+        runtime.bindTool(definition, async (_input, context) => {
             if (invokingRef.current) {
                 throw new AgentToolError("ACTION_IN_FLIGHT", `AgentUIAction "${name}" is already being invoked.`);
             }

package/dist/react.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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","sourcesContent":["import * as React from \"react\";\nimport {\n Children,\n Fragment,\n cloneElement,\n useCallback,\n useEffect,\n useLayoutEffect,\n useMemo,\n useRef,\n useState,\n type MouseEvent,\n type JSXElementConstructor,\n type Ref,\n type ReactElement,\n type ReactNode,\n type RefCallback,\n} from \"react\";\n\nimport { defineAgentTool } from \"./definition.js\";\nimport {\n getAgentNavigationEntries,\n type AgentNavigation,\n type AgentNavigationExecutors,\n type AgentNavigationResult,\n} from \"./navigation.js\";\nimport { AgentToolError, getInternalToolRuntime } from \"./runtime.js\";\nimport {\n InternalToolRuntimeScope,\n useInternalToolRuntime,\n} from \"./internal-react.js\";\nimport type { ToolRuntime } from \"./runtime.js\";\nimport type {\n AgentContextEntry,\n AgentContextRegistration,\n AgentToolDefinition,\n AgentToolExecutor,\n} from \"./types.js\";\nimport type { AgentToolConfirmationConfig } from \"./runtime.js\";\nimport { connectToolRuntimeToWebMcp } from \"./webmcp.js\";\n\n/*\n @experimental Human-in-the-loop Chat confirmation configuration.\n * @beta\n /\nexport interface AgentToolChatConfirmationConfig {\n mode: \"chat\";\n title?: string;\n description?: string;\n confirmLabel?: string;\n rejectLabel?: string;\n}\n\n/\n @experimental Human-in-the-loop Page confirmation configuration.\n * @beta\n /\nexport interface AgentToolPageConfirmationConfig {\n mode: \"page\";\n title?: string;\n description?: string;\n}\n\nexport interface UseAgentToolDefaultOptions {\n /\n @experimental Enables human-in-the-loop Chat confirmation.\n * @beta\n /\n requiresConfirmation?: AgentToolChatConfirmationConfig;\n}\n\n/\n @experimental Enables human-in-the-loop Page confirmation.\n * @beta\n /\nexport interface UseAgentToolPageConfirmationOptions {\n requiresConfirmation: AgentToolPageConfirmationConfig;\n}\n\nexport interface AgentToolBinding<\n TInput = unknown,\n TElement extends HTMLElement = HTMLElement,\n> {\n readonly toolName: string;\n readonly ref: RefCallback<TElement>;\n refWhen(match: (input: TInput) => boolean): RefCallback<TElement>;\n}\n\ntype BindingInternals = {\n resolveTarget(input: unknown): HTMLElement \| undefined;\n getConditionalTargetRegistrations(): readonly {\n element: HTMLElement;\n match(input: unknown): boolean;\n }[];\n};\n\nconst bindingInternals = new WeakMap<object, BindingInternals>();\n\nexport function getAgentToolBindingInternals(\n binding: AgentToolBinding,\n): BindingInternals {\n const internals = bindingInternals.get(binding);\n if (!internals) throw new Error(\"Invalid Agent Tool Binding.\");\n return internals;\n}\n\nfunction createAgentToolBinding<TInput, TElement extends HTMLElement>(\n toolName: string,\n): AgentToolBinding<TInput, TElement> {\n let fixedElement: TElement \| null = null;\n const conditionalElements = new Map<\n RefCallback<TElement>,\n { element: TElement; match: (input: TInput) => boolean }\n >();\n const ref: RefCallback<TElement> = (element) => {\n if (element && fixedElement && fixedElement !== element) {\n throw new Error(\"An Agent Tool Binding ref can only attach to one element.\");\n }\n fixedElement = element;\n };\n const binding: AgentToolBinding<TInput, TElement> = {\n toolName,\n ref,\n refWhen(match) {\n let callback: RefCallback<TElement>;\n callback = (element) => {\n if (element) {\n conditionalElements.set(callback, { element, match });\n } else {\n conditionalElements.delete(callback);\n }\n };\n return callback;\n },\n };\n bindingInternals.set(binding, {\n resolveTarget(input) {\n for (const entry of conditionalElements.values()) {\n if (entry.element.isConnected && entry.match(input as TInput)) return entry.element;\n }\n return fixedElement?.isConnected ? fixedElement : undefined;\n },\n getConditionalTargetRegistrations: () =>\n Array.from(conditionalElements.values(), ({ element, match }) => ({\n element,\n match: (input: unknown) => match(input as TInput),\n })),\n });\n return binding;\n}\n\nfunction useAgentBinding<\n TInput,\n TResult,\n TElement extends HTMLElement,\n>(\n definition: AgentToolDefinition<TInput, TResult>,\n execute: AgentToolExecutor<TInput, TResult>,\n options: UseAgentToolDefaultOptions \| UseAgentToolPageConfirmationOptions,\n): AgentToolBinding<TInput, TElement> {\n const runtime = useInternalToolRuntime();\n const confirmation = options.requiresConfirmation;\n if (\n confirmation !== undefined\n && (\n !confirmation\n \|\| typeof confirmation !== \"object\"\n \|\| (confirmation.mode !== \"chat\" && confirmation.mode !== \"page\")\n )\n ) {\n throw new Error(\n \"requiresConfirmation must explicitly use chat or page mode.\",\n );\n }\n const executeRef = useRef(execute);\n executeRef.current = execute;\n const confirmationRef = useRef<AgentToolConfirmationConfig \| undefined>(\n confirmation,\n );\n confirmationRef.current = confirmation;\n const mode = confirmation?.mode;\n const binding = useMemo(\n () => createAgentToolBinding<TInput, TElement>(\n definition.name,\n ),\n [runtime, definition, mode],\n );\n useLayoutEffect(() => {\n const controller = new AbortController();\n runtime.register(\n definition,\n (input, context) => executeRef.current(input, context),\n {\n signal: controller.signal,\n getConfirmation: () => confirmationRef.current,\n resolveTarget: (input) => getAgentToolBindingInternals(binding).resolveTarget(input),\n },\n );\n return () => controller.abort();\n }, [runtime, definition, mode]);\n return binding;\n}\n\n/\n @experimental The Page confirmation overload is experimental.\n * @beta\n */\nexport function useAgentTool<\n TInput,\n TResult,\n TElement extends HTMLElement = HTMLElement,\n>(\n definition: AgentToolDefinition<TInput, TResult>,\n execute: AgentToolExecutor<TInput, TResult>,\n options: UseAgentToolPageConfirmationOptions,\n): AgentToolBinding<TInput, TElement>;\nexport function useAgentTool<\n TInput,\n TResult,\n TElement extends HTMLElement = HTMLElement,\n>(\n definition: AgentToolDefinition<TInput, TResult>,\n execute: AgentToolExecutor<TInput, TResult>,\n options?: UseAgentToolDefaultOptions,\n): AgentToolBinding<TInput, TElement>;\nexport function useAgentTool<\n TInput,\n TResult,\n TElement extends HTMLElement = HTMLElement,\n>(\n definition: AgentToolDefinition<TInput, TResult>,\n execute: AgentToolExecutor<TInput, TResult>,\n options: UseAgentToolDefaultOptions \| UseAgentToolPageConfirmationOptions = {},\n): AgentToolBinding<TInput, TElement> {\n return useAgentBinding(definition, execute, options);\n}\n\nfunction getAgentNavigationExecutor(\n executors: unknown,\n key: string,\n): AgentToolExecutor<any, void> {\n if (\n !executors\n \|\| typeof executors !== \"object\"\n \|\| !Object.hasOwn(executors, key)\n ) {\n throw new Error(`Missing navigation executor: ${key}.`);\n }\n const executor = (executors as Record<string, unknown>)[key];\n if (typeof executor !== \"function\") {\n throw new Error(`Missing navigation executor: ${key}.`);\n }\n return executor as AgentToolExecutor<any, void>;\n}\n\nexport function useAgentNavigation<\n TNavigation extends AgentNavigation,\n const TExecutors extends AgentNavigationExecutors<TNavigation>,\n>(\n navigation: TNavigation,\n executors: TExecutors & Record<\n Exclude<\n keyof TExecutors,\n keyof AgentNavigationExecutors<TNavigation>\n >,\n never\n >,\n): void {\n const runtime = useInternalToolRuntime();\n const entries = getAgentNavigationEntries(navigation);\n for (const entry of entries) {\n getAgentNavigationExecutor(executors, entry.key);\n }\n const routeKeys = new Set(entries.map((entry) => entry.key));\n for (const key of Object.keys(executors)) {\n if (!routeKeys.has(key)) {\n throw new Error(`Unknown navigation executor: ${key}.`);\n }\n }\n const executorsRef = useRef(executors);\n executorsRef.current = executors;\n\n useLayoutEffect(() => {\n const controller = new AbortController();\n try {\n for (const entry of entries) {\n runtime.register(\n entry.definition,\n async (input, context): Promise<AgentNavigationResult> => {\n const executor = getAgentNavigationExecutor(\n executorsRef.current,\n entry.key,\n );\n await executor(input, context);\n return { status: \"navigated\" };\n },\n { signal: controller.signal },\n );\n }\n } catch (error) {\n controller.abort();\n throw error;\n }\n return () => controller.abort();\n }, [runtime, navigation]);\n}\n\nexport function ToolsProvider({\n children,\n toolRuntime,\n webMcp = true,\n}: {\n children: ReactNode;\n toolRuntime: ToolRuntime;\n webMcp?: boolean;\n}): ReactElement {\n const runtime = getInternalToolRuntime(toolRuntime);\n return (\n <InternalToolRuntimeScope runtime={toolRuntime}>\n <WebMcpRuntimeBridge enabled={webMcp} runtime={runtime} />\n {children}\n </InternalToolRuntimeScope>\n );\n}\n\nfunction WebMcpRuntimeBridge({\n enabled,\n runtime,\n}: {\n enabled: boolean;\n runtime: ReturnType<typeof getInternalToolRuntime>;\n}) {\n useEffect(() => {\n if (!enabled) return undefined;\n return connectToolRuntimeToWebMcp(runtime);\n }, [enabled, runtime]);\n return null;\n}\n\nexport function useAgentContext(context: AgentContextEntry): void {\n const runtime = useInternalToolRuntime();\n const registrationRef = useRef<AgentContextRegistration \| undefined>(undefined);\n useLayoutEffect(() => {\n const controller = new AbortController();\n const registration = runtime.registerContext(context, { signal: controller.signal });\n registrationRef.current = registration;\n return () => {\n if (registrationRef.current === registration) registrationRef.current = undefined;\n controller.abort();\n };\n }, [runtime, context.name]);\n useLayoutEffect(() => {\n registrationRef.current?.update(context);\n }, [runtime, context.name, context.description, context.value]);\n}\n\nexport function AgentContext(context: AgentContextEntry): null {\n useAgentContext(context);\n return null;\n}\n\nfunction waitForActionResult<TResult>(\n result: TResult \| Promise<TResult>,\n signal: AbortSignal,\n): Promise<TResult> {\n if (signal.aborted) return Promise.reject(signal.reason);\n return new Promise((resolve, reject) => {\n const onAbort = () => {\n signal.removeEventListener(\"abort\", onAbort);\n reject(signal.reason);\n };\n signal.addEventListener(\"abort\", onAbort, { once: true });\n Promise.resolve(result).then(\n (value) => {\n signal.removeEventListener(\"abort\", onAbort);\n resolve(value);\n },\n (error) => {\n signal.removeEventListener(\"abort\", onAbort);\n reject(error);\n },\n );\n });\n}\n\nexport type AgentUIActionEvent = \"click\";\n\ntype Awaitable<TResult> = TResult \| Promise<TResult>;\n\nexport interface AgentUIActionChildProps<TResult = void> {\n onClick: (event: MouseEvent<HTMLElement>) => Awaitable<TResult>;\n disabled?: boolean;\n}\n\nexport interface AgentUIActionProps<TResult = void> {\n name: string;\n description: string;\n event?: AgentUIActionEvent;\n children: ReactElement<AgentUIActionChildProps<TResult>>;\n}\n\ntype PendingInvocation<TResult> = {\n resolve: (value: TResult \| PromiseLike<TResult>) => void;\n reject: (reason?: unknown) => void;\n};\n\nfunction setRefValue<T>(ref: Ref<T> \| undefined, value: T \| null): (() => void) \| undefined {\n if (typeof ref === \"function\") {\n const cleanup = ref(value);\n return typeof cleanup === \"function\" ? cleanup : undefined;\n }\n if (ref) (ref as { current: T \| null }).current = value;\n}\n\nfunction getElementRef(element: ReactElement): Ref<HTMLElement> \| undefined {\n const props = element.props as Record<string, unknown>;\n const refDescriptor = Object.getOwnPropertyDescriptor(element, \"ref\");\n if (refDescriptor && \"value\" in refDescriptor) {\n return refDescriptor.value as Ref<HTMLElement> \| undefined;\n }\n return (props as { ref?: Ref<HTMLElement> }).ref;\n}\n\nfunction isHTMLElement(value: unknown): value is HTMLElement {\n if (!value \|\| typeof value !== \"object\") return false;\n const ownerDocument = (value as { ownerDocument?: Document }).ownerDocument;\n const ElementConstructor =\n ownerDocument?.defaultView?.HTMLElement ??\n (typeof HTMLElement === \"undefined\" ? undefined : HTMLElement);\n return ElementConstructor !== undefined && value instanceof ElementConstructor;\n}\n\nfunction warnAgentUIAction(message: string): void {\n if (typeof process !== \"undefined\" && process.env.NODE_ENV !== \"production\") {\n console.warn(message);\n }\n}\n\nconst eventAdapters: Record<AgentUIActionEvent, { invoke(target: HTMLElement): void }> = {\n click: {\n invoke(target) {\n target.click();\n },\n },\n};\n\nexport function AgentUIAction<TResult = void>({\n name,\n description,\n event = \"click\",\n children,\n}: AgentUIActionProps<TResult>): ReactElement<AgentUIActionChildProps<TResult>, string \| JSXElementConstructor<any>> {\n const runtime = useInternalToolRuntime();\n const child = Children.only(children) as ReactElement<AgentUIActionChildProps<TResult>>;\n const isFragment = child.type === Fragment;\n const handler = isFragment ? undefined : child.props.onClick;\n const childDisabled = isFragment ? false : Boolean(child.props.disabled);\n const childRef = isFragment ? undefined : getElementRef(child);\n const [target, setTarget] = useState<HTMLElement \| null>(null);\n const targetRef = useRef<HTMLElement \| null>(null);\n const handlerRef = useRef(handler);\n const disabledRef = useRef(childDisabled);\n const pendingInvocationRef = useRef<PendingInvocation<TResult> \| null>(null);\n const invalidTargetRef = useRef(false);\n const warnedTargetRef = useRef(false);\n const warnedChildRef = useRef<\"fragment\" \| \"handler\" \| null>(null);\n const invokingRef = useRef(false);\n\n useLayoutEffect(() => {\n handlerRef.current = handler;\n disabledRef.current = childDisabled;\n });\n\n const mergedRef = useCallback(\n (value: unknown) => {\n const element = isHTMLElement(value) ? value : null;\n const cleanupChildRef = setRefValue(childRef as Ref<unknown> \| undefined, value);\n invalidTargetRef.current = value !== null && !element;\n targetRef.current = element;\n setTarget(element);\n if (element) warnedTargetRef.current = false;\n if (cleanupChildRef) {\n return () => {\n cleanupChildRef();\n if (targetRef.current === element) {\n invalidTargetRef.current = false;\n targetRef.current = null;\n setTarget(null);\n }\n };\n }\n },\n [childRef],\n );\n\n const invokeHandler = useCallback((mouseEvent: MouseEvent<HTMLElement>) => {\n const currentHandler = handlerRef.current;\n const pending = pendingInvocationRef.current;\n if (pending) pendingInvocationRef.current = null;\n if (!currentHandler) {\n pending?.reject(\n new AgentToolError(\n \"ACTION_NOT_HANDLED\",\n `AgentUIAction \"${name}\" does not have an onClick handler.`,\n ),\n );\n return undefined as TResult;\n }\n try {\n const result = currentHandler(mouseEvent);\n if (pending) Promise.resolve(result).then(pending.resolve, pending.reject);\n return result;\n } catch (error) {\n if (pending) {\n pending.reject(error);\n return undefined as TResult;\n }\n throw error;\n }\n }, [name]);\n\n const definition = useMemo(\n () =>\n defineAgentTool<TResult>({\n name,\n description,\n }),\n [name, description],\n );\n\n useLayoutEffect(() => {\n if (isFragment \|\| !handler) {\n const warningType = isFragment ? \"fragment\" : \"handler\";\n if (warnedChildRef.current !== warningType) {\n warnedChildRef.current = warningType;\n warnAgentUIAction(\n isFragment\n ? `AgentUIAction \"${name}\" does not support React.Fragment children.`\n : `AgentUIAction \"${name}\" needs a child with onClick.`,\n );\n }\n return;\n }\n warnedChildRef.current = null;\n if (!target) {\n if (!targetRef.current && !warnedTargetRef.current) {\n warnedTargetRef.current = true;\n warnAgentUIAction(\n invalidTargetRef.current\n ? `AgentUIAction \"${name}\" needs its child ref to resolve to an HTMLElement; the Tool is not registered.`\n : `AgentUIAction \"${name}\" needs its child to forward ref to an HTMLElement; the Tool is not registered.`,\n );\n }\n return;\n }\n\n const controller = new AbortController();\n runtime.register(\n definition,\n async (_input, context) => {\n if (invokingRef.current) {\n throw new AgentToolError(\n \"ACTION_IN_FLIGHT\",\n `AgentUIAction \"${name}\" is already being invoked.`,\n );\n }\n if (disabledRef.current) {\n throw new AgentToolError(\n \"TOOL_UNAVAILABLE\",\n `AgentUIAction \"${name}\" is disabled.`,\n );\n }\n const currentTarget = targetRef.current;\n if (!currentTarget \|\| !currentTarget.isConnected) {\n throw new AgentToolError(\n \"ACTION_TARGET_UNAVAILABLE\",\n `AgentUIAction \"${name}\" target is not available.`,\n );\n }\n invokingRef.current = true;\n let resolveInvocation!: (value: TResult \| PromiseLike<TResult>) => void;\n let rejectInvocation!: (reason?: unknown) => void;\n const actionPromise = new Promise<TResult>((resolve, reject) => {\n resolveInvocation = resolve;\n rejectInvocation = reject;\n });\n const pendingInvocation = {\n resolve: resolveInvocation,\n reject: rejectInvocation,\n };\n pendingInvocationRef.current = pendingInvocation;\n try {\n eventAdapters[event].invoke(currentTarget);\n } catch (error) {\n if (pendingInvocationRef.current === pendingInvocation) {\n pendingInvocationRef.current = null;\n }\n invokingRef.current = false;\n throw error;\n }\n if (pendingInvocationRef.current === pendingInvocation) {\n pendingInvocationRef.current = null;\n invokingRef.current = false;\n throw new AgentToolError(\n \"ACTION_NOT_HANDLED\",\n `AgentUIAction \"${name}\" click did not invoke its onClick handler.`,\n );\n }\n try {\n return await waitForActionResult(actionPromise, context.signal);\n } finally {\n if (context.signal.aborted) {\n void actionPromise.then(\n () => {\n invokingRef.current = false;\n },\n () => {\n invokingRef.current = false;\n },\n );\n } else {\n invokingRef.current = false;\n }\n }\n },\n { signal: controller.signal },\n );\n return () => controller.abort();\n }, [runtime, definition, event, handler !== undefined, isFragment, name, target]);\n\n if (isFragment) return child;\n return cloneElement(child, {\n onClick: invokeHandler,\n ref: mergedRef,\n } as AgentUIActionChildProps<TResult> & { ref: Ref<HTMLElement> });\n}\n\nexport type {\n AgentContextValue,\n AgentToolDefinition,\n AgentToolExecutor,\n} from \"./types.js\";\n"]}
1	+ {"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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","sourcesContent":["import * as React from \"react\";\nimport {\n Children,\n Fragment,\n cloneElement,\n useCallback,\n useEffect,\n useLayoutEffect,\n useMemo,\n useRef,\n useState,\n type MouseEvent,\n type JSXElementConstructor,\n type Ref,\n type ReactElement,\n type ReactNode,\n type RefCallback,\n} from \"react\";\n\nimport { defineAgentTool } from \"./definition.js\";\nimport {\n getAgentNavigationEntries,\n type AgentNavigation,\n type AgentNavigationExecutors,\n type AgentNavigationResult,\n} from \"./navigation.js\";\nimport { AgentToolError, getInternalToolRuntime } from \"./runtime.js\";\nimport {\n InternalToolRuntimeScope,\n useInternalToolRuntime,\n} from \"./internal-react.js\";\nimport type { ToolRuntime } from \"./runtime.js\";\nimport type {\n AgentContextEntry,\n AgentContextRegistration,\n AgentToolDefinition,\n AgentToolExecutor,\n} from \"./types.js\";\nimport type { AgentToolConfirmationConfig } from \"./runtime.js\";\nimport { connectToolRuntimeToWebMcp } from \"./webmcp.js\";\n\n/*\n @experimental Human-in-the-loop Chat confirmation configuration.\n * @beta\n /\nexport interface AgentToolChatConfirmationConfig {\n mode: \"chat\";\n title?: string;\n description?: string;\n confirmLabel?: string;\n rejectLabel?: string;\n}\n\n/\n @experimental Human-in-the-loop Page confirmation configuration.\n * @beta\n /\nexport interface AgentToolPageConfirmationConfig {\n mode: \"page\";\n title?: string;\n description?: string;\n}\n\nexport interface UseAgentToolDefaultOptions {\n /\n @experimental Enables human-in-the-loop Chat confirmation.\n * @beta\n /\n requiresConfirmation?: AgentToolChatConfirmationConfig;\n}\n\n/\n @experimental Enables human-in-the-loop Page confirmation.\n * @beta\n /\nexport interface UseAgentToolPageConfirmationOptions {\n requiresConfirmation: AgentToolPageConfirmationConfig;\n}\n\nexport interface AgentToolBinding<\n TInput = unknown,\n TElement extends HTMLElement = HTMLElement,\n> {\n readonly toolName: string;\n readonly ref: RefCallback<TElement>;\n refWhen(match: (input: TInput) => boolean): RefCallback<TElement>;\n}\n\ntype BindingInternals = {\n resolveTarget(input: unknown): HTMLElement \| undefined;\n getConditionalTargetRegistrations(): readonly {\n element: HTMLElement;\n match(input: unknown): boolean;\n }[];\n};\n\nconst bindingInternals = new WeakMap<object, BindingInternals>();\n\nexport function getAgentToolBindingInternals(\n binding: AgentToolBinding,\n): BindingInternals {\n const internals = bindingInternals.get(binding);\n if (!internals) throw new Error(\"Invalid Agent Tool Binding.\");\n return internals;\n}\n\nfunction createAgentToolBinding<TInput, TElement extends HTMLElement>(\n toolName: string,\n): AgentToolBinding<TInput, TElement> {\n let fixedElement: TElement \| null = null;\n const conditionalElements = new Map<\n RefCallback<TElement>,\n { element: TElement; match: (input: TInput) => boolean }\n >();\n const ref: RefCallback<TElement> = (element) => {\n if (element && fixedElement && fixedElement !== element) {\n throw new Error(\"An Agent Tool Binding ref can only attach to one element.\");\n }\n fixedElement = element;\n };\n const binding: AgentToolBinding<TInput, TElement> = {\n toolName,\n ref,\n refWhen(match) {\n let callback: RefCallback<TElement>;\n callback = (element) => {\n if (element) {\n conditionalElements.set(callback, { element, match });\n } else {\n conditionalElements.delete(callback);\n }\n };\n return callback;\n },\n };\n bindingInternals.set(binding, {\n resolveTarget(input) {\n for (const entry of conditionalElements.values()) {\n if (entry.element.isConnected && entry.match(input as TInput)) return entry.element;\n }\n return fixedElement?.isConnected ? fixedElement : undefined;\n },\n getConditionalTargetRegistrations: () =>\n Array.from(conditionalElements.values(), ({ element, match }) => ({\n element,\n match: (input: unknown) => match(input as TInput),\n })),\n });\n return binding;\n}\n\nfunction useAgentBinding<\n TInput,\n TResult,\n TElement extends HTMLElement,\n>(\n definition: AgentToolDefinition<TInput, TResult>,\n execute: AgentToolExecutor<TInput, TResult>,\n options: UseAgentToolDefaultOptions \| UseAgentToolPageConfirmationOptions,\n): AgentToolBinding<TInput, TElement> {\n const runtime = useInternalToolRuntime();\n const confirmation = options.requiresConfirmation;\n if (\n confirmation !== undefined\n && (\n !confirmation\n \|\| typeof confirmation !== \"object\"\n \|\| (confirmation.mode !== \"chat\" && confirmation.mode !== \"page\")\n )\n ) {\n throw new Error(\n \"requiresConfirmation must explicitly use chat or page mode.\",\n );\n }\n const executeRef = useRef(execute);\n executeRef.current = execute;\n const confirmationRef = useRef<AgentToolConfirmationConfig \| undefined>(\n confirmation,\n );\n confirmationRef.current = confirmation;\n const mode = confirmation?.mode;\n const binding = useMemo(\n () => createAgentToolBinding<TInput, TElement>(\n definition.name,\n ),\n [runtime, definition, mode],\n );\n useLayoutEffect(() => {\n const controller = new AbortController();\n runtime.bindTool(\n definition,\n (input, context) => executeRef.current(input, context),\n {\n signal: controller.signal,\n getConfirmation: () => confirmationRef.current,\n resolveTarget: (input) => getAgentToolBindingInternals(binding).resolveTarget(input),\n },\n );\n return () => controller.abort();\n }, [runtime, definition, mode]);\n return binding;\n}\n\n/\n @experimental The Page confirmation overload is experimental.\n * @beta\n */\nexport function useAgentTool<\n TInput,\n TResult,\n TElement extends HTMLElement = HTMLElement,\n>(\n definition: AgentToolDefinition<TInput, TResult>,\n execute: AgentToolExecutor<TInput, TResult>,\n options: UseAgentToolPageConfirmationOptions,\n): AgentToolBinding<TInput, TElement>;\nexport function useAgentTool<\n TInput,\n TResult,\n TElement extends HTMLElement = HTMLElement,\n>(\n definition: AgentToolDefinition<TInput, TResult>,\n execute: AgentToolExecutor<TInput, TResult>,\n options?: UseAgentToolDefaultOptions,\n): AgentToolBinding<TInput, TElement>;\nexport function useAgentTool<\n TInput,\n TResult,\n TElement extends HTMLElement = HTMLElement,\n>(\n definition: AgentToolDefinition<TInput, TResult>,\n execute: AgentToolExecutor<TInput, TResult>,\n options: UseAgentToolDefaultOptions \| UseAgentToolPageConfirmationOptions = {},\n): AgentToolBinding<TInput, TElement> {\n return useAgentBinding(definition, execute, options);\n}\n\nfunction getAgentNavigationExecutor(\n executors: unknown,\n key: string,\n): AgentToolExecutor<any, void> {\n if (\n !executors\n \|\| typeof executors !== \"object\"\n \|\| !Object.hasOwn(executors, key)\n ) {\n throw new Error(`Missing navigation executor: ${key}.`);\n }\n const executor = (executors as Record<string, unknown>)[key];\n if (typeof executor !== \"function\") {\n throw new Error(`Missing navigation executor: ${key}.`);\n }\n return executor as AgentToolExecutor<any, void>;\n}\n\nexport function useAgentNavigation<\n TNavigation extends AgentNavigation,\n const TExecutors extends AgentNavigationExecutors<TNavigation>,\n>(\n navigation: TNavigation,\n executors: TExecutors & Record<\n Exclude<\n keyof TExecutors,\n keyof AgentNavigationExecutors<TNavigation>\n >,\n never\n >,\n): void {\n const runtime = useInternalToolRuntime();\n const entries = getAgentNavigationEntries(navigation);\n for (const entry of entries) {\n getAgentNavigationExecutor(executors, entry.key);\n }\n const routeKeys = new Set(entries.map((entry) => entry.key));\n for (const key of Object.keys(executors)) {\n if (!routeKeys.has(key)) {\n throw new Error(`Unknown navigation executor: ${key}.`);\n }\n }\n const executorsRef = useRef(executors);\n executorsRef.current = executors;\n\n useLayoutEffect(() => {\n const controller = new AbortController();\n try {\n for (const entry of entries) {\n runtime.bindTool(\n entry.definition,\n async (input, context): Promise<AgentNavigationResult> => {\n const executor = getAgentNavigationExecutor(\n executorsRef.current,\n entry.key,\n );\n await executor(input, context);\n return { status: \"navigated\" };\n },\n { signal: controller.signal },\n );\n }\n } catch (error) {\n controller.abort();\n throw error;\n }\n return () => controller.abort();\n }, [runtime, navigation]);\n}\n\nexport function ToolsProvider({\n children,\n toolRuntime,\n webMcp = true,\n}: {\n children: ReactNode;\n toolRuntime: ToolRuntime;\n webMcp?: boolean;\n}): ReactElement {\n const runtime = getInternalToolRuntime(toolRuntime);\n return (\n <InternalToolRuntimeScope runtime={toolRuntime}>\n <WebMcpRuntimeBridge enabled={webMcp} runtime={runtime} />\n {children}\n </InternalToolRuntimeScope>\n );\n}\n\nfunction WebMcpRuntimeBridge({\n enabled,\n runtime,\n}: {\n enabled: boolean;\n runtime: ReturnType<typeof getInternalToolRuntime>;\n}) {\n useEffect(() => {\n if (!enabled) return undefined;\n return connectToolRuntimeToWebMcp(runtime);\n }, [enabled, runtime]);\n return null;\n}\n\nexport function useAgentContext(context: AgentContextEntry): void {\n const runtime = useInternalToolRuntime();\n const registrationRef = useRef<AgentContextRegistration \| undefined>(undefined);\n useLayoutEffect(() => {\n const controller = new AbortController();\n const registration = runtime.registerContext(context, { signal: controller.signal });\n registrationRef.current = registration;\n return () => {\n if (registrationRef.current === registration) registrationRef.current = undefined;\n controller.abort();\n };\n }, [runtime, context.name]);\n useLayoutEffect(() => {\n registrationRef.current?.update(context);\n }, [runtime, context.name, context.description, context.value]);\n}\n\nexport function AgentContext(context: AgentContextEntry): null {\n useAgentContext(context);\n return null;\n}\n\nfunction waitForActionResult<TResult>(\n result: TResult \| Promise<TResult>,\n signal: AbortSignal,\n): Promise<TResult> {\n if (signal.aborted) return Promise.reject(signal.reason);\n return new Promise((resolve, reject) => {\n const onAbort = () => {\n signal.removeEventListener(\"abort\", onAbort);\n reject(signal.reason);\n };\n signal.addEventListener(\"abort\", onAbort, { once: true });\n Promise.resolve(result).then(\n (value) => {\n signal.removeEventListener(\"abort\", onAbort);\n resolve(value);\n },\n (error) => {\n signal.removeEventListener(\"abort\", onAbort);\n reject(error);\n },\n );\n });\n}\n\nexport type AgentUIActionEvent = \"click\";\n\ntype Awaitable<TResult> = TResult \| Promise<TResult>;\n\nexport interface AgentUIActionChildProps<TResult = void> {\n onClick: (event: MouseEvent<HTMLElement>) => Awaitable<TResult>;\n disabled?: boolean;\n}\n\nexport interface AgentUIActionProps<TResult = void> {\n name: string;\n description: string;\n event?: AgentUIActionEvent;\n children: ReactElement<AgentUIActionChildProps<TResult>>;\n}\n\ntype PendingInvocation<TResult> = {\n resolve: (value: TResult \| PromiseLike<TResult>) => void;\n reject: (reason?: unknown) => void;\n};\n\nfunction setRefValue<T>(ref: Ref<T> \| undefined, value: T \| null): (() => void) \| undefined {\n if (typeof ref === \"function\") {\n const cleanup = ref(value);\n return typeof cleanup === \"function\" ? cleanup : undefined;\n }\n if (ref) (ref as { current: T \| null }).current = value;\n}\n\nfunction getElementRef(element: ReactElement): Ref<HTMLElement> \| undefined {\n const props = element.props as Record<string, unknown>;\n const refDescriptor = Object.getOwnPropertyDescriptor(element, \"ref\");\n if (refDescriptor && \"value\" in refDescriptor) {\n return refDescriptor.value as Ref<HTMLElement> \| undefined;\n }\n return (props as { ref?: Ref<HTMLElement> }).ref;\n}\n\nfunction isHTMLElement(value: unknown): value is HTMLElement {\n if (!value \|\| typeof value !== \"object\") return false;\n const ownerDocument = (value as { ownerDocument?: Document }).ownerDocument;\n const ElementConstructor =\n ownerDocument?.defaultView?.HTMLElement ??\n (typeof HTMLElement === \"undefined\" ? undefined : HTMLElement);\n return ElementConstructor !== undefined && value instanceof ElementConstructor;\n}\n\nfunction warnAgentUIAction(message: string): void {\n if (typeof process !== \"undefined\" && process.env.NODE_ENV !== \"production\") {\n console.warn(message);\n }\n}\n\nconst eventAdapters: Record<AgentUIActionEvent, { invoke(target: HTMLElement): void }> = {\n click: {\n invoke(target) {\n target.click();\n },\n },\n};\n\nexport function AgentUIAction<TResult = void>({\n name,\n description,\n event = \"click\",\n children,\n}: AgentUIActionProps<TResult>): ReactElement<AgentUIActionChildProps<TResult>, string \| JSXElementConstructor<any>> {\n const runtime = useInternalToolRuntime();\n const child = Children.only(children) as ReactElement<AgentUIActionChildProps<TResult>>;\n const isFragment = child.type === Fragment;\n const handler = isFragment ? undefined : child.props.onClick;\n const childDisabled = isFragment ? false : Boolean(child.props.disabled);\n const childRef = isFragment ? undefined : getElementRef(child);\n const [target, setTarget] = useState<HTMLElement \| null>(null);\n const targetRef = useRef<HTMLElement \| null>(null);\n const handlerRef = useRef(handler);\n const disabledRef = useRef(childDisabled);\n const pendingInvocationRef = useRef<PendingInvocation<TResult> \| null>(null);\n const invalidTargetRef = useRef(false);\n const warnedTargetRef = useRef(false);\n const warnedChildRef = useRef<\"fragment\" \| \"handler\" \| null>(null);\n const invokingRef = useRef(false);\n\n useLayoutEffect(() => {\n handlerRef.current = handler;\n disabledRef.current = childDisabled;\n });\n\n const mergedRef = useCallback(\n (value: unknown) => {\n const element = isHTMLElement(value) ? value : null;\n const cleanupChildRef = setRefValue(childRef as Ref<unknown> \| undefined, value);\n invalidTargetRef.current = value !== null && !element;\n targetRef.current = element;\n setTarget(element);\n if (element) warnedTargetRef.current = false;\n if (cleanupChildRef) {\n return () => {\n cleanupChildRef();\n if (targetRef.current === element) {\n invalidTargetRef.current = false;\n targetRef.current = null;\n setTarget(null);\n }\n };\n }\n },\n [childRef],\n );\n\n const invokeHandler = useCallback((mouseEvent: MouseEvent<HTMLElement>) => {\n const currentHandler = handlerRef.current;\n const pending = pendingInvocationRef.current;\n if (pending) pendingInvocationRef.current = null;\n if (!currentHandler) {\n pending?.reject(\n new AgentToolError(\n \"ACTION_NOT_HANDLED\",\n `AgentUIAction \"${name}\" does not have an onClick handler.`,\n ),\n );\n return undefined as TResult;\n }\n try {\n const result = currentHandler(mouseEvent);\n if (pending) Promise.resolve(result).then(pending.resolve, pending.reject);\n return result;\n } catch (error) {\n if (pending) {\n pending.reject(error);\n return undefined as TResult;\n }\n throw error;\n }\n }, [name]);\n\n const definition = useMemo(\n () =>\n defineAgentTool<TResult>({\n name,\n description,\n }),\n [name, description],\n );\n\n useLayoutEffect(() => {\n if (isFragment \|\| !handler) {\n const warningType = isFragment ? \"fragment\" : \"handler\";\n if (warnedChildRef.current !== warningType) {\n warnedChildRef.current = warningType;\n warnAgentUIAction(\n isFragment\n ? `AgentUIAction \"${name}\" does not support React.Fragment children.`\n : `AgentUIAction \"${name}\" needs a child with onClick.`,\n );\n }\n return;\n }\n warnedChildRef.current = null;\n if (!target) {\n if (!targetRef.current && !warnedTargetRef.current) {\n warnedTargetRef.current = true;\n warnAgentUIAction(\n invalidTargetRef.current\n ? `AgentUIAction \"${name}\" needs its child ref to resolve to an HTMLElement; the Tool is not registered.`\n : `AgentUIAction \"${name}\" needs its child to forward ref to an HTMLElement; the Tool is not registered.`,\n );\n }\n return;\n }\n\n const controller = new AbortController();\n runtime.bindTool(\n definition,\n async (_input, context) => {\n if (invokingRef.current) {\n throw new AgentToolError(\n \"ACTION_IN_FLIGHT\",\n `AgentUIAction \"${name}\" is already being invoked.`,\n );\n }\n if (disabledRef.current) {\n throw new AgentToolError(\n \"TOOL_UNAVAILABLE\",\n `AgentUIAction \"${name}\" is disabled.`,\n );\n }\n const currentTarget = targetRef.current;\n if (!currentTarget \|\| !currentTarget.isConnected) {\n throw new AgentToolError(\n \"ACTION_TARGET_UNAVAILABLE\",\n `AgentUIAction \"${name}\" target is not available.`,\n );\n }\n invokingRef.current = true;\n let resolveInvocation!: (value: TResult \| PromiseLike<TResult>) => void;\n let rejectInvocation!: (reason?: unknown) => void;\n const actionPromise = new Promise<TResult>((resolve, reject) => {\n resolveInvocation = resolve;\n rejectInvocation = reject;\n });\n const pendingInvocation = {\n resolve: resolveInvocation,\n reject: rejectInvocation,\n };\n pendingInvocationRef.current = pendingInvocation;\n try {\n eventAdapters[event].invoke(currentTarget);\n } catch (error) {\n if (pendingInvocationRef.current === pendingInvocation) {\n pendingInvocationRef.current = null;\n }\n invokingRef.current = false;\n throw error;\n }\n if (pendingInvocationRef.current === pendingInvocation) {\n pendingInvocationRef.current = null;\n invokingRef.current = false;\n throw new AgentToolError(\n \"ACTION_NOT_HANDLED\",\n `AgentUIAction \"${name}\" click did not invoke its onClick handler.`,\n );\n }\n try {\n return await waitForActionResult(actionPromise, context.signal);\n } finally {\n if (context.signal.aborted) {\n void actionPromise.then(\n () => {\n invokingRef.current = false;\n },\n () => {\n invokingRef.current = false;\n },\n );\n } else {\n invokingRef.current = false;\n }\n }\n },\n { signal: controller.signal },\n );\n return () => controller.abort();\n }, [runtime, definition, event, handler !== undefined, isFragment, name, target]);\n\n if (isFragment) return child;\n return cloneElement(child, {\n onClick: invokeHandler,\n ref: mergedRef,\n } as AgentUIActionChildProps<TResult> & { ref: Ref<HTMLElement> });\n}\n\nexport type {\n AgentContextValue,\n AgentToolDefinition,\n AgentToolExecutor,\n} from \"./types.js\";\n"]}

package/dist/registration.d.ts CHANGED Viewed

@@ -9,9 +9,6 @@ export declare function registerAgentTool<TInput, TResult>(definition: AgentTool
     execute: RegisteredAgentTool<TInput, TResult>["execute"];
     requiresConfirmation?: never;
 }): RegisteredAgentTool<TInput, TResult>;
-export declare function createAgentToolRegistry(): {
-    register<TInput, TResult>(definition: AgentToolDefinition<TInput, TResult>, options: {
-        execute: RegisteredAgentTool<TInput, TResult>["execute"];
-        requiresConfirmation?: never;
-    }): () => void;
-};
+export declare function assertAgentToolRegistration(definition: AgentToolDefinition<any, any>, options: {
+    execute: unknown;
+}): void;

package/dist/registration.js CHANGED Viewed

@@ -1,35 +1,15 @@
-import { defineAgentTool } from "./definition.js";
-import { toolRegistrySymbol } from "./shared/tool-registry.js";
 import { assertAgentToolInputSchema } from "./shared/schema.js";
 export function registerAgentTool(definition, options) {
+    assertAgentToolRegistration(definition, options);
+    assertAgentToolInputSchema(definition.inputSchema, `Tool "${definition.name}".inputSchema`);
+    return Object.freeze({ definition, execute: options.execute });
+}
+export function assertAgentToolRegistration(definition, options) {
     if (!definition || typeof definition.name !== "string" || typeof options?.execute !== "function") {
         throw new TypeError("registerAgentTool requires a definition and execute function.");
     }
     if ("requiresConfirmation" in options) {
         throw new TypeError("Registered Agent tools do not support requiresConfirmation.");
     }
-    assertAgentToolInputSchema(definition.inputSchema, `Tool "${definition.name}".inputSchema`);
-    return Object.freeze({ definition, execute: options.execute });
-}
-export function createAgentToolRegistry() {
-    const tools = new Map();
-    const registry = {
-        register(definition, options) {
-            const validated = registerAgentTool(definition, options);
-            if (tools.has(definition.name))
-                throw new TypeError(`Tool "${definition.name}" is already registered.`);
-            const copied = defineAgentTool(validated.definition);
-            const tool = Object.freeze({ definition: copied, execute: validated.execute });
-            tools.set(copied.name, tool);
-            return () => {
-                if (tools.get(copied.name) === tool)
-                    tools.delete(copied.name);
-            };
-        },
-    };
-    Object.defineProperty(registry, toolRegistrySymbol, {
-        value: Object.freeze({ getTools: () => [...tools.values()] }),
-    });
-    return Object.freeze(registry);
 }
 //# sourceMappingURL=registration.js.map

package/dist/registration.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"registration.js","sourceRoot":"","sources":["../src/registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,~~eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,~~0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAQhE,MAAM,UAAU,iBAAiB,CAC/B,UAAgD,EAChD,OAAmG;IAEnG,~~IAAI~~,CAAC,UAAU,~~IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,OAAO,~~EAAE,OAAO,~~KAAK,UAAU,EAAE,~~CAAC~~;QACjG~~,~~MAAM,IAAI,SAAS,~~CAAC~~,+DAA+D,CAAC,CAAC~~;~~IACvF~~,~~CAAC;IACD,IAAI,sBAAsB,IAAI,OAAO,EAAE,CAAC;QACtC,MAAM,IAAI,SAAS,CAAC,6DAA6D,CAAC,CAAC;IACrF,CAAC;IACD,~~0BAA0B,CAAC,UAAU,CAAC,WAAW,EAAE,SAAS,UAAU,CAAC,IAAI,eAAe,CAAC,CAAC;IAC5F,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,~~uBAAuB;IAMrC~~,~~MAAM~~,~~KAAK~~,~~GAAG~~,~~IAAI,GAAG,EAA+B,CAAC~~;~~IACrD~~,~~MAAM~~,~~QAAQ,GAAG;QACf,QAAQ,CACN,UAAgD,EAChD,OAAmG;YAEnG,MAAM,SAAS,GAAG,iBAAiB,~~CAAC,UAAU,~~EAAE~~,OAAO,~~CAAC~~,CAAC~~;YACzD~~,IAAI,KAAK,~~CAAC~~,~~GAAG,CAAC,UAAU,CAAC,~~IAAI,~~CAAC;gBAAE~~,~~MAAM~~,~~IAAI~~,~~SAAS~~,~~CAAC~~,~~SAAS,~~UAAU,~~CAAC~~,~~IAAI,0BAA0B,~~CAAC~~,CAAC~~;~~YACxG~~,MAAM,~~MAAM~~,~~GAAG,eAAe,CAAkB,~~SAAS,CAAC,~~UAAU,~~CAAC,CAAC;~~YACtE~~,~~MAAM,IAAI,GAAG,MAAM,~~CAAC~~,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC~~;~~YAC/E~~,~~KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,~~IAAI,~~EAAE~~,IAAI,~~CAAC,CAAC;YAC7B,~~OAAO,~~GAAG,~~EAAE~~;gBACV~~,~~IAAI,KAAK,~~CAAC~~,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI~~;~~oBAAE~~,~~KAAK,CAAC,~~MAAM,~~CAAC,MAAM,CAAC,~~IAAI,~~CAAC~~,CAAC~~;YACjE~~,~~CAAC~~,CAAC~~;QACJ~~,CAAC;~~KACF~~,CAAC;~~IACF~~,~~MAAM,~~CAAC,cAAc,CAAC,QAAQ,EAAE,kBAAkB,EAAE;QAClD,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;KAC9D,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC","sourcesContent":["import { ~~defineAgentTool } from \"./definition.js\";\nimport { toolRegistrySymbol } from \"./shared/tool-registry.js\";\nimport {~~ assertAgentToolInputSchema } from \"./shared/schema.js\";\nimport type { AgentToolDefinition } from \"./types.js\";\n\nexport interface RegisteredAgentTool<TInput = any, TResult = any> {\n readonly definition: AgentToolDefinition<TInput, TResult>;\n readonly execute: (input: TInput, context: { signal: AbortSignal }) => TResult \| Promise<TResult>;\n}\n\nexport function registerAgentTool<TInput, TResult>(\n definition: AgentToolDefinition<TInput, TResult>,\n options: { execute: RegisteredAgentTool<TInput, TResult>[\"execute\"]; requiresConfirmation?: never },\n): RegisteredAgentTool<TInput, TResult> {\n if (!definition ~~\|\| typeof definition.name !== \"string\" \|\| typeof~~ options~~?.execute !== \"function\"~~) ~~{\n throw new TypeError(\"registerAgentTool requires a definition and execute function.\")~~;\n ~~}\n if (\"requiresConfirmation\" in options) {\n throw new TypeError(\"Registered Agent tools do not support requiresConfirmation.\");\n }\n~~ assertAgentToolInputSchema(definition.inputSchema, `Tool \"${definition.name}\".inputSchema`);\n return Object.freeze({ definition, execute: options.execute });\n}\n\nexport function ~~createAgentToolRegistry~~(~~): {~~\n ~~register<TInput, TResult>(\n~~ definition: AgentToolDefinition<~~TInput~~, ~~TResult~~>,\n options: { execute: ~~RegisteredAgentTool<TInput,~~ ~~TResult>[\"execute\"]; requiresConfirmation?: never~~ },\n ): ~~() =>~~ void~~;\n}~~ {\n ~~const~~ ~~tools~~ = ~~new~~ ~~Map<string,~~ ~~RegisteredAgentTool>();\n const~~ ~~registry = {~~\~~n register<TInput, TResult>(~~\~~n definition:~~ ~~AgentToolDefinition<TInput,~~ ~~TResult>,\n~~ options~~: {~~ execute: ~~RegisteredAgentTool<TInput,~~ ~~TResult>[~~\"~~execute~~\"~~]; requiresConfirmation?: never },\n~~ ): ~~() => void~~ {\n ~~const validated = registerAgentTool(definition, options);\n if (tools.has(definition.name))~~ throw new TypeError(~~`Tool~~ \"~~${definition.name}\"~~ is ~~already~~ ~~registered.`);\n const copied = defineAgentTool<TInput, TResult>(validated.~~definition~~);\n const~~ ~~tool~~ ~~= Object.freeze({ definition: copied,~~ execute: ~~validated.execute }~~);\n ~~tools.set(copied.name, tool);\n return () => {~~\n if (~~tools.get(copied.name)~~ ~~===~~ ~~tool~~) ~~tools.delete(copied.name);\n };\n },\n };\n Object.defineProperty(registry, toolRegistrySymbol,~~ {\n ~~value:~~ ~~Object.freeze({~~ ~~getTools:~~ () => ~~[...~~tools~~.values()]~~ }),\n }~~);\~~n ~~return Object.freeze(registry);\n~~}\n"]}
1	+ {"version":3,"file":"registration.js","sourceRoot":"","sources":["../src/registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAQhE,MAAM,UAAU,iBAAiB,CAC/B,UAAgD,EAChD,OAAmG;IAEnG,2BAA2B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,0BAA0B,CAAC,UAAU,CAAC,WAAW,EAAE,SAAS,UAAU,CAAC,IAAI,eAAe,CAAC,CAAC;IAC5F,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,UAAyC,EACzC,OAA6B;IAE7B,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,OAAO,EAAE,OAAO,KAAK,UAAU,EAAE,CAAC;QACjG,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,sBAAsB,IAAI,OAAO,EAAE,CAAC;QACtC,MAAM,IAAI,SAAS,CAAC,6DAA6D,CAAC,CAAC;IACrF,CAAC;AACH,CAAC","sourcesContent":["import { assertAgentToolInputSchema } from \"./shared/schema.js\";\nimport type { AgentToolDefinition } from \"./types.js\";\n\nexport interface RegisteredAgentTool<TInput = any, TResult = any> {\n readonly definition: AgentToolDefinition<TInput, TResult>;\n readonly execute: (input: TInput, context: { signal: AbortSignal }) => TResult \| Promise<TResult>;\n}\n\nexport function registerAgentTool<TInput, TResult>(\n definition: AgentToolDefinition<TInput, TResult>,\n options: { execute: RegisteredAgentTool<TInput, TResult>[\"execute\"]; requiresConfirmation?: never },\n): RegisteredAgentTool<TInput, TResult> {\n assertAgentToolRegistration(definition, options);\n assertAgentToolInputSchema(definition.inputSchema, `Tool \"${definition.name}\".inputSchema`);\n return Object.freeze({ definition, execute: options.execute });\n}\n\nexport function assertAgentToolRegistration(\n definition: AgentToolDefinition<any, any>,\n options: { execute: unknown },\n): void {\n if (!definition \|\| typeof definition.name !== \"string\" \|\| typeof options?.execute !== \"function\") {\n throw new TypeError(\"registerAgentTool requires a definition and execute function.\");\n }\n if (\"requiresConfirmation\" in options) {\n throw new TypeError(\"Registered Agent tools do not support requiresConfirmation.\");\n }\n}\n"]}

package/dist/runtime.d.ts CHANGED Viewed

@@ -2,6 +2,7 @@ import { type InternalExecutionOptions } from "./shared/runtime-execution.js";
 import type { PageActionFeedback } from "./browser/feedback.js";
 import { type TaskProgress } from "./shared/runtime-controller.js";
 export { AgentToolError } from "./shared/errors.js";
+import { type RegisteredAgentTool } from "./registration.js";
 import { OperationTracker, type RuntimeActivitySnapshot } from "./operation-runtime.js";
 import type { AgentContextEntry, AgentContextInput, AgentContextRegistration, AgentToolDefinition, AgentToolExecutor } from "./types.js";
 import type { AgentToolExecutionEvent } from "./internal-types.js";
@@ -51,6 +52,14 @@ export interface ToolRuntime {
     beginOperation(options?: {
         onCancel?: () => void;
     }): ToolOperation;
+    /**
+     * Register a business tool outside React and return an idempotent unregister function.
+     * @remarks Copies the definition. Unregistration invalidates unstarted calls; running calls use their execution signal.
+     */
+    register<TInput, TResult>(definition: AgentToolDefinition<TInput, TResult>, options: {
+        execute: RegisteredAgentTool<TInput, TResult>["execute"];
+        requiresConfirmation?: never;
+    }): () => void;
     getTools(): readonly RuntimeAgentTool[];
     getContexts(options?: {
         signal?: AbortSignal;
@@ -121,7 +130,7 @@ export interface InternalToolRuntime extends ToolRuntime, EventTarget {
     requestOperationCancel(id: string): void;
     resolveTarget(tool: RuntimeAgentTool, input: unknown): HTMLElement | undefined;
     setPageActionFeedback(listener: (event: AgentToolExecutionEvent, feedback: PageActionFeedback, signal?: AbortSignal) => void | Promise<void>): () => void;
-    register<TInput, TResult>(definition: AgentToolDefinition<TInput, TResult>, execute: AgentToolExecutor<TInput, TResult>, options?: {
+    bindTool<TInput, TResult>(definition: AgentToolDefinition<TInput, TResult>, execute: AgentToolExecutor<TInput, TResult>, options?: {
         signal?: AbortSignal;
         getConfirmation?: () => AgentToolConfirmationConfig | undefined;
         resolveTarget?: (input: unknown) => HTMLElement | undefined;
@@ -157,7 +166,11 @@ export declare class ToolRuntimeImplementation extends EventTarget implements To
     constructor(options?: ToolRuntimeOptions);
     on(eventName: "toolchange", listener: (event: ToolRuntimeToolChangeEvent) => void): () => void;
     on(eventName: "toolexecution", listener: (event: AgentToolExecutionEvent) => void): () => void;
-    register<TInput, TResult>(definition: AgentToolDefinition<TInput, TResult>, execute: AgentToolExecutor<TInput, TResult>, options?: {
+    register<TInput, TResult>(definition: AgentToolDefinition<TInput, TResult>, options: {
+        execute: RegisteredAgentTool<TInput, TResult>["execute"];
+        requiresConfirmation?: never;
+    }): () => void;
+    bindTool<TInput, TResult>(definition: AgentToolDefinition<TInput, TResult>, execute: AgentToolExecutor<TInput, TResult>, options?: {
         signal?: AbortSignal;
         getConfirmation?: () => AgentToolConfirmationConfig | undefined;
         resolveTarget?: (input: unknown) => HTMLElement | undefined;

package/dist/runtime.js CHANGED Viewed

@@ -4,8 +4,9 @@ import { measurePagePhase } from "./browser/diagnostics.js";
 import { runtimeControllerSymbol } from "./shared/runtime-controller.js";
 import { AgentToolError, TOOL_ERROR_CODES } from "./shared/errors.js";
 export { AgentToolError } from "./shared/errors.js";
+import { assertAgentToolRegistration } from "./registration.js";
 import { OperationTracker } from "./operation-runtime.js";
-import { isValidAgentContextName } from "./definition.js";
+import { defineAgentTool, isValidAgentContextName } from "./definition.js";
 import { assertAgentToolInputSchema, validateAgentToolInput } from "./shared/schema.js";
 import { createBrowserToolset, } from "./browser/toolset.js";
 const CONTEXT_ERROR_CODES = [
@@ -186,8 +187,20 @@ export class ToolRuntimeImplementation extends EventTarget {
             this.removeEventListener(eventName, handleEvent);
         };
     }
-    register(definition, execute, options = {}) {
+    register(definition, options) {
+        assertAgentToolRegistration(definition, options);
+        const execute = options.execute;
+        if (definition.inputSchema?.type !== "object") {
+            throw new TypeError(`Tool "${definition.name}".inputSchema root type must be object.`);
+        }
+        const copied = defineAgentTool(definition);
+        return this.#bindTool(copied, (input, { signal }) => execute(input, { signal }));
+    }
+    bindTool(definition, execute, options = {}) {
         assertAgentToolInputSchema(definition.inputSchema, `Tool "${definition.name}".inputSchema`);
+        return this.#bindTool(definition, execute, options);
+    }
+    #bindTool(definition, execute, options = {}) {
         if (this.#bindings.has(definition.name)) {
             throw new AgentToolError("DUPLICATE_BINDING", `Tool "${definition.name}" already has an active binding.`);
         }

package/dist/runtime.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { pageDecisionSymbol, type InternalExecutionOptions } from \"./shared/runtime-execution.js\";\nimport { PageCommandError } from \"./browser/locator.js\";\nimport { measurePagePhase } from \"./browser/diagnostics.js\";\nimport type { PageActionFeedback, PageFeedbackListener } from \"./browser/feedback.js\";\nimport { runtimeControllerSymbol, type RuntimeController, type TaskProgress } from \"./shared/runtime-controller.js\";\nimport { AgentToolError, TOOL_ERROR_CODES } from \"./shared/errors.js\";\nexport { AgentToolError } from \"./shared/errors.js\";\nimport { OperationTracker, type RuntimeActivitySnapshot } from \"./operation-runtime.js\";\nimport { isValidAgentContextName } from \"./definition.js\";\nimport { assertAgentToolInputSchema, validateAgentToolInput } from \"./shared/schema.js\";\nimport type {\n AgentContextEntry,\n AgentContextInput,\n AgentContextRegistration,\n AgentToolDefinition,\n AgentToolExecutor,\n} from \"./types.js\";\nimport type { AgentToolExecutionEvent } from \"./internal-types.js\";\nimport {\n createBrowserToolset,\n type BrowserToolset,\n} from \"./browser/toolset.js\";\n\nexport interface ToolRuntimeOptions {\n readonly pageAutomation?: boolean;\n}\n\nexport interface ToolRuntimeToolChangeEvent {\n readonly toolName: string;\n readonly change: \"registered\" \| \"unregistered\";\n}\n\nconst CONTEXT_ERROR_CODES = [\n \"CONTEXT_DISPOSED\",\n \"CONTEXT_NAME_MISMATCH\",\n \"DUPLICATE_CONTEXT\",\n \"INVALID_CONTEXT\",\n] as const;\n\ntype AgentContextErrorCode = typeof CONTEXT_ERROR_CODES[number];\n\nconst CONTEXT_ERROR_CODE_SET = new Set<string>(CONTEXT_ERROR_CODES);\nconst TOOL_ERROR_CODE_SET = new Set<string>(TOOL_ERROR_CODES);\n\nexport function isToolRuntimeError(error: unknown): error is {\n readonly type: \"tool_runtime_error\";\n readonly domain: \"tool\" \| \"context\";\n readonly code: string;\n readonly message: string;\n readonly details?: unknown;\n} {\n if (!error \|\| typeof error !== \"object\") return false;\n const candidate = error as Record<string, unknown>;\n if (\n candidate.type !== \"tool_runtime_error\"\n \|\| typeof candidate.message !== \"string\"\n \|\| typeof candidate.code !== \"string\"\n ) {\n return false;\n }\n if (candidate.domain === \"tool\") {\n return TOOL_ERROR_CODE_SET.has(candidate.code);\n }\n if (candidate.domain === \"context\") {\n return CONTEXT_ERROR_CODE_SET.has(candidate.code);\n }\n return false;\n}\n\nconst toolRuntimeBrand = Symbol.for(\"@nexface/tools/ToolRuntime\");\n\n/*\n @experimental A logical operation spanning tool calls and human interaction.\n * @beta\n /\nexport interface ToolOperation {\n readonly id: string;\n /\n @experimental End the operation and wait for its admitted tool calls to settle.\n * @beta\n * @param options - Final outcome; defaults to completed. Does not cancel execution.\n * @returns A promise that resolves when outstanding calls have settled and the operation is released.\n /\n end(options?: { outcome?: \"completed\" \| \"failed\" \| \"cancelled\" }): Promise<void>;\n}\n\nexport interface ToolRuntime {\n readonly [toolRuntimeBrand]: true;\n\n /\n @experimental Begin a logical operation spanning one complete host-managed task.\n * @beta\n * @param options - Optional callback for cancellation requested from the operation UI.\n * @returns A handle that the host must end on completion, failure, or cancellation.\n * @throws An OPERATION_BUSY error if another operation or unscoped tool call is outstanding.\n * @remarks The host owns cancellation. Pass its signal to execute and external requests, then end the operation.\n /\n beginOperation(options?: { onCancel?: () => void }): ToolOperation;\n getTools(): readonly RuntimeAgentTool[];\n getContexts(options?: {\n signal?: AbortSignal;\n }): Promise<readonly AgentContextEntry[]>;\n /\n @experimental Execute a current Runtime Tool through the Runtime queue.\n * @beta\n * @param tool - The current tool object returned by this Runtime's getTools method.\n * @param input - Arguments matching the tool's input schema.\n * @param options - Optional cancellation signal and display-only progress label.\n * @returns The tool result, or a rejected promise when execution fails.\n * @remarks Joins the operation active when submitted. Rejects with OPERATION_BUSY while ending. Does not trigger user confirmation.\n /\n execute<TInput, TResult>(\n tool: RuntimeAgentTool<TInput, TResult>,\n input: TInput,\n options?: { signal?: AbortSignal; progressLabel?: string },\n ): Promise<TResult>;\n on(\n eventName: \"toolchange\",\n listener: (event: ToolRuntimeToolChangeEvent) => void,\n ): () => void;\n /\n @experimental Tool execution notifications may change in future releases.\n * @beta\n /\n on(\n eventName: \"toolexecution\",\n listener: (event: AgentToolExecutionEvent) => void,\n ): () => void;\n}\n\ntype RuntimeBinding = {\n resolveTarget?: (input: unknown) => HTMLElement \| undefined;\n definition: AgentToolDefinition<any, any>;\n runtimeTool: RuntimeAgentTool<any, any>;\n execute: AgentToolExecutor<any, any>;\n getConfirmation?: () => AgentToolConfirmationConfig \| undefined;\n lifecycleController: AbortController;\n};\n\n/\n @experimental Human-in-the-loop confirmation configuration.\n * @beta\n /\nexport type AgentToolConfirmationConfig =\n \| {\n readonly mode: \"chat\";\n readonly title?: string;\n readonly description?: string;\n readonly confirmLabel?: string;\n readonly rejectLabel?: string;\n }\n \| {\n readonly mode: \"page\";\n readonly title?: string;\n readonly description?: string;\n };\n\nexport interface RuntimeAgentTool<TInput = unknown, TResult = unknown> {\n readonly definition: AgentToolDefinition<TInput, TResult>;\n /\n @experimental Human-in-the-loop confirmation metadata.\n * @beta\n */\n readonly confirmation?: AgentToolConfirmationConfig \| undefined;\n readonly lifecycleSignal: AbortSignal;\n}\n\nfunction compareStrings(left: string, right: string): number {\n return left < right ? -1 : left > right ? 1 : 0;\n}\n\nfunction assertContextName(name: string): void {\n if (!isValidAgentContextName(name)) {\n throw new AgentContextError(\n \"INVALID_CONTEXT\",\n `Invalid or reserved context name: ${name}.`,\n );\n }\n}\n\nfunction normalizeContextValue(\n value: unknown,\n path = \"value\",\n seen = new WeakSet<object>(),\n): AgentContextEntry[\"value\"] {\n if (\n value === null\n \|\| typeof value === \"string\"\n \|\| typeof value === \"boolean\"\n ) {\n return value;\n }\n if (typeof value === \"number\") {\n if (!Number.isFinite(value)) {\n throw new AgentContextError(\n \"INVALID_CONTEXT\",\n `${path} must contain only finite numbers.`,\n );\n }\n return value;\n }\n if (!value \|\| typeof value !== \"object\") {\n throw new AgentContextError(\n \"INVALID_CONTEXT\",\n `${path} must be JSON serializable.`,\n );\n }\n if (seen.has(value)) {\n throw new AgentContextError(\n \"INVALID_CONTEXT\",\n `${path} contains a circular reference.`,\n );\n }\n seen.add(value);\n try {\n if (Array.isArray(value)) {\n return value.map((item, index) =>\n normalizeContextValue(item, `${path}[${index}]`, seen));\n }\n const prototype = Object.getPrototypeOf(value);\n if (prototype !== Object.prototype && prototype !== null) {\n throw new AgentContextError(\n \"INVALID_CONTEXT\",\n `${path} must contain only plain objects.`,\n );\n }\n return Object.fromEntries(\n Object.keys(value)\n .sort(compareStrings)\n .map((key) => [\n key,\n normalizeContextValue(\n (value as Record<string, unknown>)[key],\n `${path}.${key}`,\n seen,\n ),\n ]),\n );\n } finally {\n seen.delete(value);\n }\n}\n\nfunction normalizeContext(context: AgentContextInput): AgentContextEntry {\n assertContextName(context.name);\n if (context.description !== undefined\n && (typeof context.description !== \"string\" \|\| !context.description.trim())) {\n throw new AgentContextError(\n \"INVALID_CONTEXT\",\n \"Context description must be a non-empty string when provided.\",\n );\n }\n return {\n name: context.name,\n ...(context.description === undefined ? {} : { description: context.description }),\n value: normalizeContextValue(context.value),\n };\n}\n\nclass DetailEvent<T> extends Event {\n constructor(type: string, readonly detail: T) {\n super(type);\n }\n}\n\nexport class AgentContextError extends Error {\n readonly type = \"tool_runtime_error\" as const;\n readonly domain = \"context\" as const;\n\n constructor(\n readonly code: AgentContextErrorCode,\n message: string,\n ) {\n super(message);\n this.name = \"ToolRuntimeError\";\n }\n}\n\nexport interface InternalToolRuntime extends ToolRuntime, EventTarget {\n beginInternalOperation(options?: { signal?: AbortSignal; onCancel?: () => void; source?: \"host\" \| \"webmcp\"; replaceWaiting?: ToolOperation; taskProgress?: TaskProgress }): ToolOperation;\n endBridgeOperation(handle: ToolOperation): Promise<void>;\n setTaskProgress(handle: ToolOperation, progress: TaskProgress): void;\n setOperationWaiting(handle: ToolOperation, waiting: boolean): void;\n getActivitySnapshot(): RuntimeActivitySnapshot;\n subscribeActivity(listener: () => void): () => void;\n requestOperationCancel(id: string): void;\n resolveTarget(tool: RuntimeAgentTool, input: unknown): HTMLElement \| undefined;\n setPageActionFeedback(listener: (event: AgentToolExecutionEvent, feedback: PageActionFeedback, signal?: AbortSignal) => void \| Promise<void>): () => void;\n register<TInput, TResult>(\n definition: AgentToolDefinition<TInput, TResult>,\n execute: AgentToolExecutor<TInput, TResult>,\n options?: {\n signal?: AbortSignal;\n getConfirmation?: () => AgentToolConfirmationConfig \| undefined;\n resolveTarget?: (input: unknown) => HTMLElement \| undefined;\n },\n ): () => void;\n registerContext(\n input: AgentContextInput,\n options?: { signal?: AbortSignal },\n ): AgentContextRegistration;\n getWebMcpTools(): readonly RuntimeAgentTool[];\n isRegistered(name: string): boolean;\n waitForTool(\n definition: AgentToolDefinition<any, any>,\n options?: { signal?: AbortSignal; timeoutMs?: number },\n ): Promise<void>;\n getContextRevision(): number;\n getContextsNow(): readonly AgentContextEntry[];\n}\n\nconst runtimeInternals = new WeakMap<\n ToolRuntime,\n ToolRuntimeImplementation\n>();\n\nexport function createToolRuntime(\n options: ToolRuntimeOptions = {},\n): ToolRuntime {\n return new ToolRuntimeImplementation(options);\n}\n\nexport function getInternalToolRuntime(\n runtime: ToolRuntime,\n): InternalToolRuntime {\n const internal = runtimeInternals.get(runtime);\n if (!internal) {\n throw new AgentToolError(\n \"INVALID_TOOL_RUNTIME\",\n \"ToolRuntime must be created by createToolRuntime().\",\n );\n }\n return internal;\n}\n\nexport class ToolRuntimeImplementation\n extends EventTarget\n implements ToolRuntime, InternalToolRuntime\n{\n readonly [toolRuntimeBrand] = true as const;\n\n readonly #bindings = new Map<string, RuntimeBinding>();\n readonly #contexts = new Map<string, AgentContextEntry>();\n #contextRevision = 0;\n readonly #browserToolset: BrowserToolset \| undefined;\n readonly #browserRuntimeTools = new WeakMap<\n object,\n RuntimeAgentTool<any, any>\n >();\n #executionTail: Promise<void> \| undefined;\n #pageActionFeedback: ((event: AgentToolExecutionEvent, feedback: PageActionFeedback, signal?: AbortSignal) => void \| Promise<void>) \| undefined;\n readonly #operations = new OperationTracker();\n\n beginOperation(options: { onCancel?: () => void } = {}): ToolOperation {\n return this.#operations.begin(options.onCancel ? { onCancel: options.onCancel } : {});\n }\n beginInternalOperation(options: Parameters<OperationTracker[\"begin\"]>[0] = {}): ToolOperation {\n return this.#operations.begin(options);\n }\n endBridgeOperation(handle: ToolOperation): Promise<void> { return this.#operations.disposeBridge(handle); }\n setTaskProgress = (handle: ToolOperation, progress: TaskProgress): void => this.#operations.setTaskProgress(handle, progress);\n setOperationWaiting = (handle: ToolOperation, waiting: boolean): void => this.#operations.setWaitingForUser(handle, waiting);\n getActivitySnapshot = (): RuntimeActivitySnapshot => this.#operations.getSnapshot();\n subscribeActivity = (listener: () => void): (() => void) => this.#operations.subscribe(listener);\n requestOperationCancel(id: string): void { this.#operations.requestCancel(id); }\n\n setPageActionFeedback(listener: (event: AgentToolExecutionEvent, feedback: PageActionFeedback, signal?: AbortSignal) => void \| Promise<void>): () => void {\n this.#pageActionFeedback = listener;\n return () => { if (this.#pageActionFeedback === listener) this.#pageActionFeedback = undefined; };\n }\n\n #emitExecution(event: AgentToolExecutionEvent): void {\n this.#operations.observe(event);\n this.dispatchEvent(new DetailEvent(\"toolexecution\", event));\n }\n\n constructor(options: ToolRuntimeOptions = {}) {\n super();\n if (\n options.pageAutomation !== undefined &&\n typeof options.pageAutomation !== \"boolean\"\n ) {\n throw new AgentToolError(\"INVALID_INPUT\", \"pageAutomation must be a boolean.\");\n }\n this.#browserToolset = options.pageAutomation ? createBrowserToolset() : undefined;\n runtimeInternals.set(this, this);\n const controller = Object.freeze<RuntimeController>({\n beginInternalOperation: (options) => this.beginInternalOperation(options),\n setOperationWaiting: this.setOperationWaiting,\n setTaskProgress: this.setTaskProgress,\n getOperationSnapshot: () => this.getActivitySnapshot().operation,\n subscribeOperation: this.subscribeActivity,\n });\n Object.defineProperty(this, runtimeControllerSymbol, { value: controller });\n }\n\n on(\n eventName: \"toolchange\",\n listener: (event: ToolRuntimeToolChangeEvent) => void,\n ): () => void;\n on(\n eventName: \"toolexecution\",\n listener: (event: AgentToolExecutionEvent) => void,\n ): () => void;\n on(\n eventName: \"toolchange\" \| \"toolexecution\",\n listener: ((event: ToolRuntimeToolChangeEvent) => void) \| ((event: AgentToolExecutionEvent) => void),\n ): () => void {\n const handleEvent = (event: Event) => {\n if (eventName === \"toolchange\") {\n (listener as (event: ToolRuntimeToolChangeEvent) => void)(\n (event as Event & { detail: ToolRuntimeToolChangeEvent }).detail,\n );\n } else {\n (listener as (event: AgentToolExecutionEvent) => void)(\n (event as Event & { detail: AgentToolExecutionEvent }).detail,\n );\n }\n };\n this.addEventListener(eventName, handleEvent);\n let subscribed = true;\n return () => {\n if (!subscribed) return;\n subscribed = false;\n this.removeEventListener(eventName, handleEvent);\n };\n }\n\n register<TInput, TResult>(\n definition: AgentToolDefinition<TInput, TResult>,\n execute: AgentToolExecutor<TInput, TResult>,\n options: {\n signal?: AbortSignal;\n getConfirmation?: () => AgentToolConfirmationConfig \| undefined;\n resolveTarget?: (input: unknown) => HTMLElement \| undefined;\n } = {},\n ): () => void {\n assertAgentToolInputSchema(definition.inputSchema, `Tool \"${definition.name}\".inputSchema`);\n if (this.#bindings.has(definition.name)) {\n throw new AgentToolError(\n \"DUPLICATE_BINDING\",\n `Tool \"${definition.name}\" already has an active binding.`,\n );\n }\n const lifecycleController = new AbortController();\n const runtimeTool = Object.freeze({\n definition,\n get confirmation() {\n const confirmation = options.getConfirmation?.();\n return confirmation === undefined\n ? undefined\n : Object.freeze({ ...confirmation });\n },\n lifecycleSignal: lifecycleController.signal,\n }) satisfies RuntimeAgentTool<TInput, TResult>;\n const binding: RuntimeBinding = {\n ...(options.resolveTarget ? { resolveTarget: options.resolveTarget } : {}),\n definition,\n runtimeTool,\n execute,\n ...(options.getConfirmation\n ? { getConfirmation: options.getConfirmation }\n : {}),\n lifecycleController,\n };\n this.#bindings.set(definition.name, binding);\n this.dispatchEvent(\n new DetailEvent(\"toolchange\", Object.freeze({\n toolName: definition.name,\n change: \"registered\" as const,\n })),\n );\n\n let disposed = false;\n const dispose = () => {\n if (disposed \|\| this.#bindings.get(definition.name) !== binding) return;\n disposed = true;\n options.signal?.removeEventListener(\"abort\", dispose);\n this.#bindings.delete(definition.name);\n lifecycleController.abort();\n this.dispatchEvent(\n new DetailEvent(\"toolchange\", Object.freeze({\n toolName: definition.name,\n change: \"unregistered\" as const,\n })),\n );\n };\n if (options.signal?.aborted) dispose();\n else options.signal?.addEventListener(\"abort\", dispose, { once: true });\n return dispose;\n }\n\n registerContext(\n input: AgentContextInput,\n options: { signal?: AbortSignal } = {},\n ): AgentContextRegistration {\n const initial = normalizeContext(input);\n if (this.#contexts.has(initial.name)) {\n throw new AgentContextError(\n \"DUPLICATE_CONTEXT\",\n `Context \"${initial.name}\" already has an active registration.`,\n );\n }\n this.#contexts.set(initial.name, initial);\n this.#notifyContextChange(initial.name, \"registered\");\n\n let disposed = false;\n const dispose = () => {\n if (disposed) return;\n disposed = true;\n options.signal?.removeEventListener(\"abort\", dispose);\n if (this.#contexts.delete(initial.name)) {\n this.#notifyContextChange(initial.name, \"disposed\");\n }\n };\n const update = (nextInput: AgentContextInput) => {\n if (disposed) {\n throw new AgentContextError(\n \"CONTEXT_DISPOSED\",\n `Context \"${initial.name}\" registration has been disposed.`,\n );\n }\n const next = normalizeContext(nextInput);\n if (next.name !== initial.name) {\n throw new AgentContextError(\n \"CONTEXT_NAME_MISMATCH\",\n `Context registration \"${initial.name}\" cannot be updated to \"${next.name}\".`,\n );\n }\n if (JSON.stringify(this.#contexts.get(initial.name)) === JSON.stringify(next)) return;\n this.#contexts.set(initial.name, next);\n this.#notifyContextChange(initial.name, \"updated\");\n };\n if (options.signal?.aborted) dispose();\n else options.signal?.addEventListener(\"abort\", dispose, { once: true });\n return { update, dispose };\n }\n\n getContextsNow(): readonly AgentContextEntry[] {\n return [...this.#contexts.values()]\n .sort((left, right) => compareStrings(left.name, right.name))\n .map(normalizeContext);\n }\n\n getContextRevision(): number {\n return this.#contextRevision;\n }\n\n async getContexts(\n options: { signal?: AbortSignal } = {},\n ): Promise<readonly AgentContextEntry[]> {\n options.signal?.throwIfAborted();\n await Promise.resolve();\n await new Promise<void>((resolve, reject) => {\n let settled = false;\n let frameId: number \| undefined;\n let timeoutId: ReturnType<typeof setTimeout> \| undefined;\n const cleanup = () => {\n options.signal?.removeEventListener(\"abort\", onAbort);\n if (frameId !== undefined && typeof cancelAnimationFrame === \"function\") {\n cancelAnimationFrame(frameId);\n }\n if (timeoutId !== undefined) clearTimeout(timeoutId);\n };\n const settle = () => {\n if (settled) return;\n settled = true;\n cleanup();\n resolve();\n };\n const onAbort = () => {\n if (settled) return;\n settled = true;\n cleanup();\n reject(options.signal?.reason);\n };\n const afterTask = () => {\n timeoutId = undefined;\n if (typeof requestAnimationFrame !== \"function\") {\n settle();\n return;\n }\n frameId = requestAnimationFrame(settle);\n timeoutId = setTimeout(settle, 50);\n };\n options.signal?.addEventListener(\"abort\", onAbort, { once: true });\n if (options.signal?.aborted) {\n onAbort();\n return;\n }\n timeoutId = setTimeout(afterTask, 0);\n });\n await Promise.resolve();\n options.signal?.throwIfAborted();\n return this.getContextsNow();\n }\n\n #notifyContextChange(\n name: string,\n change: \"registered\" \| \"updated\" \| \"disposed\",\n ): void {\n this.#contextRevision += 1;\n this.dispatchEvent(new DetailEvent(\"contextchange\", {\n name,\n change,\n revision: this.#contextRevision,\n }));\n }\n\n getWebMcpTools(): readonly RuntimeAgentTool[] {\n return [...this.#bindings.values()]\n .map(({ runtimeTool }) => runtimeTool)\n .sort((left, right) => compareStrings(\n left.definition.name,\n right.definition.name,\n ));\n }\n\n isRegistered(name: string): boolean {\n return this.#bindings.has(name);\n }\n\n getTools(): readonly RuntimeAgentTool[] {\n const applicationTools = [...this.#bindings.values()]\n .map(({ runtimeTool }) => runtimeTool);\n const browserTools = (this.#browserToolset?.definitions ?? [])\n .map((definition) => this.#getBrowserRuntimeTool(definition));\n return [...applicationTools, ...browserTools]\n .sort((left, right) => compareStrings(\n left.definition.name,\n right.definition.name,\n ));\n }\n\n waitForTool(\n definition: AgentToolDefinition<any, any>,\n options: { signal?: AbortSignal; timeoutMs?: number } = {},\n ): Promise<void> {\n const isTargetRegistered = () => this.#bindings.has(definition.name);\n if (isTargetRegistered()) return Promise.resolve();\n const timeoutMs = Math.max(1, options.timeoutMs ?? 5_000);\n return new Promise((resolve, reject) => {\n let settled = false;\n const cleanup = () => {\n this.removeEventListener(\"toolchange\", onToolChange);\n options.signal?.removeEventListener(\"abort\", onAbort);\n clearTimeout(timeoutId);\n };\n const settle = (callback: () => void) => {\n if (settled) return;\n settled = true;\n cleanup();\n callback();\n };\n const onToolChange = (event: Event) => {\n const detail = (event as Event & {\n detail?: ToolRuntimeToolChangeEvent;\n }).detail;\n if (\n detail?.toolName !== definition.name\n \|\| detail.change !== \"registered\"\n ) return;\n if (isTargetRegistered()) settle(resolve);\n };\n const onAbort = () => settle(() => reject(options.signal?.reason));\n const timeoutId = setTimeout(() => {\n settle(() =>\n reject(\n new AgentToolError(\n \"TOOL_REGISTRATION_TIMEOUT\",\n `Tool \"${definition.name}\" did not register within ${timeoutMs}ms.`,\n {\n toolName: definition.name,\n timeoutMs,\n retryable: false,\n browserFallbackAllowed: true,\n toolExecuted: false,\n },\n ),\n ));\n }, timeoutMs);\n this.addEventListener(\"toolchange\", onToolChange);\n if (options.signal?.aborted) onAbort();\n else options.signal?.addEventListener(\"abort\", onAbort, { once: true });\n if (isTargetRegistered()) settle(resolve);\n });\n }\n\n execute<TInput, TResult>(\n tool: RuntimeAgentTool<TInput, TResult>,\n input: TInput,\n options: InternalExecutionOptions = {},\n ): Promise<TResult> {\n const label = options.progressLabel?.trim().replace(/\\s+/g, \" \").slice(0, 48);\n options = { ...(options.signal ? { signal: options.signal } : {}), ...(label ? { progressLabel: label } : {}), ...(options[pageDecisionSymbol] ? { [pageDecisionSymbol]: true } : {}) };\n const definition = tool.definition;\n const name = definition.name;\n const binding = this.#bindings.get(name);\n if (binding) {\n if (binding.runtimeTool !== tool) {\n return Promise.reject(\n new AgentToolError(\n \"CONTRACT_MISMATCH\",\n `Tool \"${name}\" is registered with a different Runtime Tool.`,\n ),\n );\n }\n return this.#enqueue(\n (operationId) => this.#executeApplication(name, input, options, binding, operationId),\n options.signal,\n ) as Promise<TResult>;\n }\n try {\n const browserToolset = this.#browserToolset;\n const browserHandler = browserToolset?.handlers.get(name);\n if (!browserHandler) {\n return Promise.reject(\n new AgentToolError(\"UNKNOWN_TOOL\", `Unknown tool: ${name}.`),\n );\n }\n if (\n !browserToolset?.definitions.some((candidate) => candidate === definition)\n \|\| this.#getBrowserRuntimeTool(definition) !== tool\n ) {\n return Promise.reject(\n new AgentToolError(\n \"CONTRACT_MISMATCH\",\n `Tool \"${name}\" is registered with a different Definition.`,\n ),\n );\n }\n return this.#enqueue((operationId) => this.#observeExecution(tool, input, options.signal, async (onFeedback, assertActive) => {\n const signal = options.signal ?? new AbortController().signal;\n signal.throwIfAborted();\n return browserHandler.execute(input as Record<string, unknown>, {\n signal,\n ...(onFeedback ? { onFeedback } : {}),\n ...(assertActive ? { assertActive } : {}),\n ...(options[pageDecisionSymbol] ? { pageDecision: true } : {}),\n });\n }, options.progressLabel, operationId), options.signal) as Promise<TResult>;\n } catch (error) {\n return Promise.reject(error);\n }\n }\n\n #enqueue<TResult>(\n execute: (operationId?: string) => Promise<TResult>,\n signal?: AbortSignal,\n ): Promise<TResult> {\n if (signal?.aborted) return Promise.reject(signal.reason);\n let admission: ReturnType<OperationTracker[\"admit\"]>;\n try { admission = this.#operations.admit(); }\n catch (error) { return Promise.reject(error); }\n const previous = this.#executionTail;\n let removeQueuedAbort = () => {};\n const start = async () => {\n removeQueuedAbort();\n try {\n signal?.throwIfAborted();\n return await execute(admission.operationId);\n } finally { admission.release(); }\n };\n // Reserve the tail before invoking executors or notifying synchronous listeners.\n let settleTail!: () => void;\n const tail = new Promise<void>((resolve) => { settleTail = resolve; });\n this.#executionTail = tail;\n const queuedExecution = previous ? previous.then(start) : start();\n let execution = queuedExecution;\n if (previous && signal) {\n execution = new Promise((resolve, reject) => {\n const onAbort = () => {\n removeQueuedAbort();\n admission.release();\n reject(signal.reason);\n };\n removeQueuedAbort = () => signal.removeEventListener(\"abort\", onAbort);\n queuedExecution.then(resolve, reject);\n if (signal.aborted) onAbort();\n else signal.addEventListener(\"abort\", onAbort, { once: true });\n });\n }\n void queuedExecution.then(settleTail, settleTail);\n void tail.then(() => {\n if (this.#executionTail === tail) this.#executionTail = undefined;\n });\n return execution;\n }\n\n resolveTarget(tool: RuntimeAgentTool, input: unknown): HTMLElement \| undefined {\n const binding = this.#bindings.get(tool.definition.name);\n if (binding?.runtimeTool === tool) {\n const target = binding.resolveTarget?.(input);\n return target?.isConnected ? target : undefined;\n }\n if (this.#browserRuntimeTools.get(tool.definition) !== tool \|\| !input \|\| typeof input !== \"object\") return undefined;\n return this.#browserToolset?.handlers.get(tool.definition.name)?.resolveTarget?.(input as Record<string, unknown>);\n }\n\n async #observeExecution(\n tool: RuntimeAgentTool<any, any>,\n input: unknown,\n signal: AbortSignal \| undefined,\n execute: (onFeedback?: PageFeedbackListener, assertActive?: () => void) => Promise<unknown>,\n progressLabel?: string,\n operationId?: string,\n ): Promise<unknown> {\n const running: AgentToolExecutionEvent = {\n ...(operationId ? { operationId } : {}),\n id: globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random()}`,\n name: tool.definition.name,\n tool,\n status: \"running\",\n startedAt: Date.now(),\n input,\n ...(progressLabel ? { progressLabel } : {}),\n };\n const presentation = this.#pageActionFeedback;\n const assertActive = () => {\n signal?.throwIfAborted();\n if (presentation && this.#pageActionFeedback !== presentation) {\n throw new PageCommandError({ code: \"EXECUTION_CANCELLED\", message: \"Page action presentation was detached.\" });\n }\n };\n this.#emitExecution(running);\n try {\n assertActive();\n const result = await execute(async (feedback) => {\n assertActive();\n if (presentation) await measurePagePhase(\"presentation\", async () => { await presentation(running, feedback, signal); });\n assertActive();\n }, assertActive);\n signal?.throwIfAborted();\n this.#emitExecution({\n ...running, status: \"success\", finishedAt: Date.now(), result,\n } satisfies AgentToolExecutionEvent);\n return result;\n } catch (error) {\n this.#emitExecution({\n ...running, status: \"error\", cancelled: signal?.aborted === true,\n finishedAt: Date.now(), error,\n } satisfies AgentToolExecutionEvent);\n throw error;\n }\n }\n\n async #executeApplication(\n name: string,\n input: unknown,\n options: { signal?: AbortSignal; progressLabel?: string },\n binding: RuntimeBinding,\n operationId?: string,\n ): Promise<unknown> {\n const id = globalThis.crypto?.randomUUID?.()\n ?? `${Date.now()}-${Math.random()}`;\n const startedAt = Date.now();\n const running: AgentToolExecutionEvent = {\n ...(operationId ? { operationId } : {}),\n id,\n name,\n tool: binding.runtimeTool,\n ...(options.progressLabel ? { progressLabel: options.progressLabel } : {}),\n status: \"running\",\n startedAt,\n input,\n };\n this.#emitExecution(running);\n try {\n if (this.#bindings.get(name) !== binding) {\n throw new AgentToolError(\n \"UNKNOWN_TOOL\",\n `Tool \"${name}\" is no longer registered for this call.`,\n );\n }\n const errors = validateAgentToolInput(binding.definition.inputSchema, input);\n if (errors.length) {\n throw new AgentToolError(\"INVALID_INPUT\", errors.join(\" \"), { errors });\n }\n const signal = options.signal ?? new AbortController().signal;\n signal.throwIfAborted();\n const result = await binding.execute(input, {\n signal,\n waitForTool: (definition, waitOptions = {}) =>\n this.waitForTool(definition, { signal, ...waitOptions }),\n });\n signal.throwIfAborted();\n this.#emitExecution({\n ...running,\n status: \"success\",\n finishedAt: Date.now(),\n result,\n } satisfies AgentToolExecutionEvent);\n return result;\n } catch (error) {\n this.#emitExecution({\n ...running,\n status: \"error\",\n cancelled: options.signal?.aborted === true,\n finishedAt: Date.now(),\n error,\n } satisfies AgentToolExecutionEvent);\n throw error;\n }\n }\n\n #getBrowserRuntimeTool<TInput, TResult>(\n definition: AgentToolDefinition<TInput, TResult>,\n ): RuntimeAgentTool<TInput, TResult> {\n const existing = this.#browserRuntimeTools.get(definition);\n if (existing) return existing as RuntimeAgentTool<TInput, TResult>;\n const runtimeTool = Object.freeze({\n definition,\n confirmation: undefined,\n lifecycleSignal: new AbortController().signal,\n }) satisfies RuntimeAgentTool<TInput, TResult>;\n this.#browserRuntimeTools.set(definition, runtimeTool);\n return runtimeTool;\n }\n\n}\n"]}
1	+ {"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAiC,MAAM,+BAA+B,CAAC;AAClG,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,uBAAuB,EAA6C,MAAM,gCAAgC,CAAC;AACpH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAA4B,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAgC,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AASxF,OAAO,EACL,oBAAoB,GAErB,MAAM,sBAAsB,CAAC;AAW9B,MAAM,mBAAmB,GAAG;IAC1B,kBAAkB;IAClB,uBAAuB;IACvB,mBAAmB;IACnB,iBAAiB;CACT,CAAC;AAIX,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAS,mBAAmB,CAAC,CAAC;AACpE,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS,gBAAgB,CAAC,CAAC;AAE9D,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAO/C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,IACE,SAAS,CAAC,IAAI,KAAK,oBAAoB;WACpC,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ;WACrC,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,EACrC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAChC,OAAO,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AA0GlE,SAAS,cAAc,CAAC,IAAY,EAAE,KAAa;IACjD,OAAO,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY;IACrC,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,iBAAiB,CACzB,iBAAiB,EACjB,qCAAqC,IAAI,GAAG,CAC7C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc,EACd,IAAI,GAAG,OAAO,EACd,OAAO,IAAI,OAAO,EAAU;IAE5B,IACE,KAAK,KAAK,IAAI;WACX,OAAO,KAAK,KAAK,QAAQ;WACzB,OAAO,KAAK,KAAK,SAAS,EAC7B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,iBAAiB,CACzB,iBAAiB,EACjB,GAAG,IAAI,oCAAoC,CAC5C,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,iBAAiB,CACzB,iBAAiB,EACjB,GAAG,IAAI,6BAA6B,CACrC,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,iBAAiB,CACzB,iBAAiB,EACjB,GAAG,IAAI,iCAAiC,CACzC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChB,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC/B,qBAAqB,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACzD,MAAM,IAAI,iBAAiB,CACzB,iBAAiB,EACjB,GAAG,IAAI,mCAAmC,CAC3C,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;aACf,IAAI,CAAC,cAAc,CAAC;aACpB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;YACZ,GAAG;YACH,qBAAqB,CAClB,KAAiC,CAAC,GAAG,CAAC,EACvC,GAAG,IAAI,IAAI,GAAG,EAAE,EAChB,IAAI,CACL;SACF,CAAC,CACL,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAA0B;IAClD,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;WAChC,CAAC,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,iBAAiB,CACzB,iBAAiB,EACjB,+DAA+D,CAChE,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QAClF,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,KAAK,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,WAAe,SAAQ,KAAK;IACG;IAAnC,YAAY,IAAY,EAAW,MAAS;QAC1C,KAAK,CAAC,IAAI,CAAC,CAAC;QADqB,WAAM,GAAN,MAAM,CAAG;IAE5C,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAK/B;IAJF,IAAI,GAAG,oBAA6B,CAAC;IACrC,MAAM,GAAG,SAAkB,CAAC;IAErC,YACW,IAA2B,EACpC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAAuB;QAIpC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAmCD,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAGjC,CAAC;AAEJ,MAAM,UAAU,iBAAiB,CAC/B,UAA8B,EAAE;IAEhC,OAAO,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAoB;IAEpB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,cAAc,CACtB,sBAAsB,EACtB,qDAAqD,CACtD,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,yBACX,SAAQ,WAAW;IAGV,CAAC,gBAAgB,CAAC,GAAG,IAAa,CAAC;IAEnC,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC9C,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC1D,gBAAgB,GAAG,CAAC,CAAC;IACZ,eAAe,CAA6B;IAC5C,oBAAoB,GAAG,IAAI,OAAO,EAGxC,CAAC;IACJ,cAAc,CAA4B;IAC1C,mBAAmB,CAA6H;IACvI,WAAW,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAE9C,cAAc,CAAC,UAAqC,EAAE;QACpD,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,sBAAsB,CAAC,UAAoD,EAAE;QAC3E,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,kBAAkB,CAAC,MAAqB,IAAmB,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3G,eAAe,GAAG,CAAC,MAAqB,EAAE,QAAsB,EAAQ,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9H,mBAAmB,GAAG,CAAC,MAAqB,EAAE,OAAgB,EAAQ,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7H,mBAAmB,GAAG,GAA4B,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;IACpF,iBAAiB,GAAG,CAAC,QAAoB,EAAgB,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACjG,sBAAsB,CAAC,EAAU,IAAU,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEhF,qBAAqB,CAAC,QAAsH;QAC1I,IAAI,CAAC,mBAAmB,GAAG,QAAQ,CAAC;QACpC,OAAO,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,mBAAmB,KAAK,QAAQ;YAAE,IAAI,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IACpG,CAAC;IAED,cAAc,CAAC,KAA8B;QAC3C,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,YAAY,UAA8B,EAAE;QAC1C,KAAK,EAAE,CAAC;QACR,IACE,OAAO,CAAC,cAAc,KAAK,SAAS;YACpC,OAAO,OAAO,CAAC,cAAc,KAAK,SAAS,EAC3C,CAAC;YACD,MAAM,IAAI,cAAc,CAAC,eAAe,EAAE,mCAAmC,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAoB;YAClD,sBAAsB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC;YACzE,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;YAC7C,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,oBAAoB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,SAAS;YAChE,kBAAkB,EAAE,IAAI,CAAC,iBAAiB;SAC3C,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,uBAAuB,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAC9E,CAAC;IAUD,EAAE,CACA,SAAyC,EACzC,QAAoG;QAEpG,MAAM,WAAW,GAAG,CAAC,KAAY,EAAE,EAAE;YACnC,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;gBAC9B,QAAwD,CACtD,KAAwD,CAAC,MAAM,CACjE,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACL,QAAqD,CACnD,KAAqD,CAAC,MAAM,CAC9D,CAAC;YACJ,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAC9C,IAAI,UAAU,GAAG,IAAI,CAAC;QACtB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,UAAU;gBAAE,OAAO;YACxB,UAAU,GAAG,KAAK,CAAC;YACnB,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACnD,CAAC,CAAC;IACJ,CAAC;IAED,QAAQ,CACN,UAAgD,EAChD,OAAmG;QAEnG,2BAA2B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,UAAU,CAAC,WAAW,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,SAAS,CAAC,SAAS,UAAU,CAAC,IAAI,yCAAyC,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,CAAyC,CAAC;QACnF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,QAAQ,CACN,UAAgD,EAChD,OAA2C,EAC3C,UAII,EAAE;QAEN,0BAA0B,CAAC,UAAU,CAAC,WAAW,EAAE,SAAS,UAAU,CAAC,IAAI,eAAe,CAAC,CAAC;QAC5F,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,SAAS,CACP,UAAgD,EAChD,OAA2C,EAC3C,UAAuE,EAAE;QAEzE,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,cAAc,CACtB,mBAAmB,EACnB,SAAS,UAAU,CAAC,IAAI,kCAAkC,CAC3D,CAAC;QACJ,CAAC;QACD,MAAM,mBAAmB,GAAG,IAAI,eAAe,EAAE,CAAC;QAClD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;YAChC,UAAU;YACV,IAAI,YAAY;gBACd,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;gBACjD,OAAO,YAAY,KAAK,SAAS;oBAC/B,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC;YACzC,CAAC;YACD,eAAe,EAAE,mBAAmB,CAAC,MAAM;SAC5C,CAA6C,CAAC;QAC/C,MAAM,OAAO,GAAmB;YAC9B,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,UAAU;YACV,WAAW;YACX,OAAO;YACP,GAAG,CAAC,OAAO,CAAC,eAAe;gBACzB,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE;gBAC9C,CAAC,CAAC,EAAE,CAAC;YACP,mBAAmB;SACpB,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,aAAa,CAChB,IAAI,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;YAC1C,QAAQ,EAAE,UAAU,CAAC,IAAI;YACzB,MAAM,EAAE,YAAqB;SAC9B,CAAC,CAAC,CACJ,CAAC;QAEF,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,IAAI,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,OAAO;gBAAE,OAAO;YACxE,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACtD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACvC,mBAAmB,CAAC,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,aAAa,CAChB,IAAI,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;gBAC1C,QAAQ,EAAE,UAAU,CAAC,IAAI;gBACzB,MAAM,EAAE,cAAuB;aAChC,CAAC,CAAC,CACJ,CAAC;QACJ,CAAC,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;YAAE,OAAO,EAAE,CAAC;;YAClC,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,eAAe,CACb,KAAwB,EACxB,UAAoC,EAAE;QAEtC,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,iBAAiB,CACzB,mBAAmB,EACnB,YAAY,OAAO,CAAC,IAAI,uCAAuC,CAChE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAEtD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACtD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,CAAC,SAA4B,EAAE,EAAE;YAC9C,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,iBAAiB,CACzB,kBAAkB,EAClB,YAAY,OAAO,CAAC,IAAI,mCAAmC,CAC5D,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC/B,MAAM,IAAI,iBAAiB,CACzB,uBAAuB,EACvB,yBAAyB,OAAO,CAAC,IAAI,2BAA2B,IAAI,CAAC,IAAI,IAAI,CAC9E,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAAE,OAAO;YACtF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACrD,CAAC,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;YAAE,OAAO,EAAE,CAAC;;YAClC,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;aAChC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;aAC5D,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC3B,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,WAAW,CACf,UAAoC,EAAE;QAEtC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,OAA2B,CAAC;YAChC,IAAI,SAAoD,CAAC;YACzD,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACtD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,oBAAoB,KAAK,UAAU,EAAE,CAAC;oBACxE,oBAAoB,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;gBACD,IAAI,SAAS,KAAK,SAAS;oBAAE,YAAY,CAAC,SAAS,CAAC,CAAC;YACvD,CAAC,CAAC;YACF,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACjC,CAAC,CAAC;YACF,MAAM,SAAS,GAAG,GAAG,EAAE;gBACrB,SAAS,GAAG,SAAS,CAAC;gBACtB,IAAI,OAAO,qBAAqB,KAAK,UAAU,EAAE,CAAC;oBAChD,MAAM,EAAE,CAAC;oBACT,OAAO;gBACT,CAAC;gBACD,OAAO,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;gBACxC,SAAS,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACrC,CAAC,CAAC;YACF,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC5B,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,SAAS,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC;IAC/B,CAAC;IAED,oBAAoB,CAClB,IAAY,EACZ,MAA6C;QAE7C,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,eAAe,EAAE;YAClD,IAAI;YACJ,MAAM;YACN,QAAQ,EAAE,IAAI,CAAC,gBAAgB;SAChC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;aAChC,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC;aACrC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,cAAc,CACnC,IAAI,CAAC,UAAU,CAAC,IAAI,EACpB,KAAK,CAAC,UAAU,CAAC,IAAI,CACtB,CAAC,CAAC;IACP,CAAC;IAED,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,QAAQ;QACN,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;aAClD,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,WAAW,IAAI,EAAE,CAAC;aAC3D,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,gBAAgB,EAAE,GAAG,YAAY,CAAC;aAC1C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,cAAc,CACnC,IAAI,CAAC,UAAU,CAAC,IAAI,EACpB,KAAK,CAAC,UAAU,CAAC,IAAI,CACtB,CAAC,CAAC;IACP,CAAC;IAED,WAAW,CACT,UAAyC,EACzC,UAAwD,EAAE;QAE1D,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,kBAAkB,EAAE;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC;QAC1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,IAAI,CAAC,mBAAmB,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;gBACrD,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACtD,YAAY,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC,CAAC;YACF,MAAM,MAAM,GAAG,CAAC,QAAoB,EAAE,EAAE;gBACtC,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,QAAQ,EAAE,CAAC;YACb,CAAC,CAAC;YACF,MAAM,YAAY,GAAG,CAAC,KAAY,EAAE,EAAE;gBACpC,MAAM,MAAM,GAAI,KAEd,CAAC,MAAM,CAAC;gBACV,IACE,MAAM,EAAE,QAAQ,KAAK,UAAU,CAAC,IAAI;uBACjC,MAAM,CAAC,MAAM,KAAK,YAAY;oBACjC,OAAO;gBACT,IAAI,kBAAkB,EAAE;oBAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5C,CAAC,CAAC;YACF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YACnE,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,MAAM,CAAC,GAAG,EAAE,CACV,MAAM,CACJ,IAAI,cAAc,CAChB,2BAA2B,EAC3B,SAAS,UAAU,CAAC,IAAI,6BAA6B,SAAS,KAAK,EACnE;oBACE,QAAQ,EAAE,UAAU,CAAC,IAAI;oBACzB,SAAS;oBACT,SAAS,EAAE,KAAK;oBAChB,sBAAsB,EAAE,IAAI;oBAC5B,YAAY,EAAE,KAAK;iBACpB,CACF,CACF,CAAC,CAAC;YACP,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;YAClD,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;gBAAE,OAAO,EAAE,CAAC;;gBAClC,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACxE,IAAI,kBAAkB,EAAE;gBAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CACL,IAAuC,EACvC,KAAa,EACb,UAAoC,EAAE;QAEtC,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9E,OAAO,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACxL,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACnC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBACjC,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,cAAc,CAChB,mBAAmB,EACnB,SAAS,IAAI,gDAAgD,CAC9D,CACF,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC,QAAQ,CAClB,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EACrF,OAAO,CAAC,MAAM,CACK,CAAC;QACxB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC;YAC5C,MAAM,cAAc,GAAG,cAAc,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC1D,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,cAAc,CAAC,cAAc,EAAE,iBAAiB,IAAI,GAAG,CAAC,CAC7D,CAAC;YACJ,CAAC;YACD,IACE,CAAC,cAAc,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,UAAU,CAAC;mBACvE,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,KAAK,IAAI,EACnD,CAAC;gBACD,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,cAAc,CAChB,mBAAmB,EACnB,SAAS,IAAI,8CAA8C,CAC5D,CACF,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE;gBAC3H,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC;gBAC9D,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,OAAO,cAAc,CAAC,OAAO,CAAC,KAAgC,EAAE;oBAC9D,MAAM;oBACN,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzC,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/D,CAAC,CAAC;YACL,CAAC,EAAE,OAAO,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAqB,CAAC;QAC9E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,QAAQ,CACN,OAAmD,EACnD,MAAoB;QAEpB,IAAI,MAAM,EAAE,OAAO;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,SAAgD,CAAC;QACrD,IAAI,CAAC;YAAC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QAC7C,OAAO,KAAK,EAAE,CAAC;YAAC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC;QACrC,IAAI,iBAAiB,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;YACvB,iBAAiB,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,EAAE,cAAc,EAAE,CAAC;gBACzB,OAAO,MAAM,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAC9C,CAAC;oBAAS,CAAC;gBAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YAAC,CAAC;QACpC,CAAC,CAAC;QACF,iFAAiF;QACjF,IAAI,UAAuB,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,GAAG,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,MAAM,eAAe,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QAClE,IAAI,SAAS,GAAG,eAAe,CAAC;QAChC,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YACvB,SAAS,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,MAAM,OAAO,GAAG,GAAG,EAAE;oBACnB,iBAAiB,EAAE,CAAC;oBACpB,SAAS,CAAC,OAAO,EAAE,CAAC;oBACpB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACxB,CAAC,CAAC;gBACF,iBAAiB,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACvE,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACtC,IAAI,MAAM,CAAC,OAAO;oBAAE,OAAO,EAAE,CAAC;;oBACzB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAClD,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;YAClB,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI;gBAAE,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QACpE,CAAC,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,aAAa,CAAC,IAAsB,EAAE,KAAc;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,OAAO,EAAE,WAAW,KAAK,IAAI,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,CAAC;YAC9C,OAAO,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAClD,CAAC;QACD,IAAI,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACrH,OAAO,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC,KAAgC,CAAC,CAAC;IACrH,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,IAAgC,EAChC,KAAc,EACd,MAA+B,EAC/B,OAA2F,EAC3F,aAAsB,EACtB,WAAoB;QAEpB,MAAM,OAAO,GAA4B;YACvC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,EAAE,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE;YACzE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;YAC1B,IAAI;YACJ,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK;YACL,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,CAAC;QACF,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,CAAC;QAC9C,MAAM,YAAY,GAAG,GAAG,EAAE;YACxB,MAAM,EAAE,cAAc,EAAE,CAAC;YACzB,IAAI,YAAY,IAAI,IAAI,CAAC,mBAAmB,KAAK,YAAY,EAAE,CAAC;gBAC9D,MAAM,IAAI,gBAAgB,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC,CAAC;YACjH,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC;YACH,YAAY,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC9C,YAAY,EAAE,CAAC;gBACf,IAAI,YAAY;oBAAE,MAAM,gBAAgB,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzH,YAAY,EAAE,CAAC;YACjB,CAAC,EAAE,YAAY,CAAC,CAAC;YACjB,MAAM,EAAE,cAAc,EAAE,CAAC;YACzB,IAAI,CAAC,cAAc,CAAC;gBAClB,GAAG,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM;aAC5B,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,cAAc,CAAC;gBAClB,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI;gBAChE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK;aACI,CAAC,CAAC;YACrC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,IAAY,EACZ,KAAc,EACd,OAAyD,EACzD,OAAuB,EACvB,WAAoB;QAEpB,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;eACvC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,OAAO,GAA4B;YACvC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,EAAE;YACF,IAAI;YACJ,IAAI,EAAE,OAAO,CAAC,WAAW;YACzB,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,MAAM,EAAE,SAAS;YACjB,SAAS;YACT,KAAK;SACN,CAAC;QACF,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;gBACzC,MAAM,IAAI,cAAc,CACtB,cAAc,EACd,SAAS,IAAI,0CAA0C,CACxD,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC7E,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,MAAM,IAAI,cAAc,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1E,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC;YAC9D,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE;gBAC1C,MAAM;gBACN,WAAW,EAAE,CAAC,UAAU,EAAE,WAAW,GAAG,EAAE,EAAE,EAAE,CAC5C,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;aAC3D,CAAC,CAAC;YACH,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,cAAc,CAAC;gBAChB,GAAG,OAAO;gBACV,MAAM,EAAE,SAAS;gBACjB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;gBACtB,MAAM;aAC2B,CAAC,CAAC;YACvC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,cAAc,CAAC;gBAChB,GAAG,OAAO;gBACV,MAAM,EAAE,OAAO;gBACf,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI;gBAC3C,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;gBACtB,KAAK;aAC4B,CAAC,CAAC;YACvC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,sBAAsB,CACpB,UAAgD;QAEhD,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,QAAQ;YAAE,OAAO,QAA6C,CAAC;QACnE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;YAChC,UAAU;YACV,YAAY,EAAE,SAAS;YACvB,eAAe,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;SAC9C,CAA6C,CAAC;QAC/C,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACvD,OAAO,WAAW,CAAC;IACrB,CAAC;CAEF","sourcesContent":["import { pageDecisionSymbol, type InternalExecutionOptions } from \"./shared/runtime-execution.js\";\nimport { PageCommandError } from \"./browser/locator.js\";\nimport { measurePagePhase } from \"./browser/diagnostics.js\";\nimport type { PageActionFeedback, PageFeedbackListener } from \"./browser/feedback.js\";\nimport { runtimeControllerSymbol, type RuntimeController, type TaskProgress } from \"./shared/runtime-controller.js\";\nimport { AgentToolError, TOOL_ERROR_CODES } from \"./shared/errors.js\";\nexport { AgentToolError } from \"./shared/errors.js\";\nimport { assertAgentToolRegistration, type RegisteredAgentTool } from \"./registration.js\";\nimport { OperationTracker, type RuntimeActivitySnapshot } from \"./operation-runtime.js\";\nimport { defineAgentTool, isValidAgentContextName } from \"./definition.js\";\nimport { assertAgentToolInputSchema, validateAgentToolInput } from \"./shared/schema.js\";\nimport type {\n AgentContextEntry,\n AgentContextInput,\n AgentContextRegistration,\n AgentToolDefinition,\n AgentToolExecutor,\n} from \"./types.js\";\nimport type { AgentToolExecutionEvent } from \"./internal-types.js\";\nimport {\n createBrowserToolset,\n type BrowserToolset,\n} from \"./browser/toolset.js\";\n\nexport interface ToolRuntimeOptions {\n readonly pageAutomation?: boolean;\n}\n\nexport interface ToolRuntimeToolChangeEvent {\n readonly toolName: string;\n readonly change: \"registered\" \| \"unregistered\";\n}\n\nconst CONTEXT_ERROR_CODES = [\n \"CONTEXT_DISPOSED\",\n \"CONTEXT_NAME_MISMATCH\",\n \"DUPLICATE_CONTEXT\",\n \"INVALID_CONTEXT\",\n] as const;\n\ntype AgentContextErrorCode = typeof CONTEXT_ERROR_CODES[number];\n\nconst CONTEXT_ERROR_CODE_SET = new Set<string>(CONTEXT_ERROR_CODES);\nconst TOOL_ERROR_CODE_SET = new Set<string>(TOOL_ERROR_CODES);\n\nexport function isToolRuntimeError(error: unknown): error is {\n readonly type: \"tool_runtime_error\";\n readonly domain: \"tool\" \| \"context\";\n readonly code: string;\n readonly message: string;\n readonly details?: unknown;\n} {\n if (!error \|\| typeof error !== \"object\") return false;\n const candidate = error as Record<string, unknown>;\n if (\n candidate.type !== \"tool_runtime_error\"\n \|\| typeof candidate.message !== \"string\"\n \|\| typeof candidate.code !== \"string\"\n ) {\n return false;\n }\n if (candidate.domain === \"tool\") {\n return TOOL_ERROR_CODE_SET.has(candidate.code);\n }\n if (candidate.domain === \"context\") {\n return CONTEXT_ERROR_CODE_SET.has(candidate.code);\n }\n return false;\n}\n\nconst toolRuntimeBrand = Symbol.for(\"@nexface/tools/ToolRuntime\");\n\n/*\n @experimental A logical operation spanning tool calls and human interaction.\n * @beta\n /\nexport interface ToolOperation {\n readonly id: string;\n /\n @experimental End the operation and wait for its admitted tool calls to settle.\n * @beta\n * @param options - Final outcome; defaults to completed. Does not cancel execution.\n * @returns A promise that resolves when outstanding calls have settled and the operation is released.\n /\n end(options?: { outcome?: \"completed\" \| \"failed\" \| \"cancelled\" }): Promise<void>;\n}\n\nexport interface ToolRuntime {\n readonly [toolRuntimeBrand]: true;\n\n /\n @experimental Begin a logical operation spanning one complete host-managed task.\n * @beta\n * @param options - Optional callback for cancellation requested from the operation UI.\n * @returns A handle that the host must end on completion, failure, or cancellation.\n * @throws An OPERATION_BUSY error if another operation or unscoped tool call is outstanding.\n * @remarks The host owns cancellation. Pass its signal to execute and external requests, then end the operation.\n /\n beginOperation(options?: { onCancel?: () => void }): ToolOperation;\n /\n Register a business tool outside React and return an idempotent unregister function.\n * @remarks Copies the definition. Unregistration invalidates unstarted calls; running calls use their execution signal.\n /\n register<TInput, TResult>(\n definition: AgentToolDefinition<TInput, TResult>,\n options: { execute: RegisteredAgentTool<TInput, TResult>[\"execute\"]; requiresConfirmation?: never },\n ): () => void;\n getTools(): readonly RuntimeAgentTool[];\n getContexts(options?: {\n signal?: AbortSignal;\n }): Promise<readonly AgentContextEntry[]>;\n /\n @experimental Execute a current Runtime Tool through the Runtime queue.\n * @beta\n * @param tool - The current tool object returned by this Runtime's getTools method.\n * @param input - Arguments matching the tool's input schema.\n * @param options - Optional cancellation signal and display-only progress label.\n * @returns The tool result, or a rejected promise when execution fails.\n * @remarks Joins the operation active when submitted. Rejects with OPERATION_BUSY while ending. Does not trigger user confirmation.\n /\n execute<TInput, TResult>(\n tool: RuntimeAgentTool<TInput, TResult>,\n input: TInput,\n options?: { signal?: AbortSignal; progressLabel?: string },\n ): Promise<TResult>;\n on(\n eventName: \"toolchange\",\n listener: (event: ToolRuntimeToolChangeEvent) => void,\n ): () => void;\n /\n @experimental Tool execution notifications may change in future releases.\n * @beta\n /\n on(\n eventName: \"toolexecution\",\n listener: (event: AgentToolExecutionEvent) => void,\n ): () => void;\n}\n\ntype RuntimeBinding = {\n resolveTarget?: (input: unknown) => HTMLElement \| undefined;\n definition: AgentToolDefinition<any, any>;\n runtimeTool: RuntimeAgentTool<any, any>;\n execute: AgentToolExecutor<any, any>;\n getConfirmation?: () => AgentToolConfirmationConfig \| undefined;\n lifecycleController: AbortController;\n};\n\n/\n @experimental Human-in-the-loop confirmation configuration.\n * @beta\n /\nexport type AgentToolConfirmationConfig =\n \| {\n readonly mode: \"chat\";\n readonly title?: string;\n readonly description?: string;\n readonly confirmLabel?: string;\n readonly rejectLabel?: string;\n }\n \| {\n readonly mode: \"page\";\n readonly title?: string;\n readonly description?: string;\n };\n\nexport interface RuntimeAgentTool<TInput = unknown, TResult = unknown> {\n readonly definition: AgentToolDefinition<TInput, TResult>;\n /\n @experimental Human-in-the-loop confirmation metadata.\n * @beta\n */\n readonly confirmation?: AgentToolConfirmationConfig \| undefined;\n readonly lifecycleSignal: AbortSignal;\n}\n\nfunction compareStrings(left: string, right: string): number {\n return left < right ? -1 : left > right ? 1 : 0;\n}\n\nfunction assertContextName(name: string): void {\n if (!isValidAgentContextName(name)) {\n throw new AgentContextError(\n \"INVALID_CONTEXT\",\n `Invalid or reserved context name: ${name}.`,\n );\n }\n}\n\nfunction normalizeContextValue(\n value: unknown,\n path = \"value\",\n seen = new WeakSet<object>(),\n): AgentContextEntry[\"value\"] {\n if (\n value === null\n \|\| typeof value === \"string\"\n \|\| typeof value === \"boolean\"\n ) {\n return value;\n }\n if (typeof value === \"number\") {\n if (!Number.isFinite(value)) {\n throw new AgentContextError(\n \"INVALID_CONTEXT\",\n `${path} must contain only finite numbers.`,\n );\n }\n return value;\n }\n if (!value \|\| typeof value !== \"object\") {\n throw new AgentContextError(\n \"INVALID_CONTEXT\",\n `${path} must be JSON serializable.`,\n );\n }\n if (seen.has(value)) {\n throw new AgentContextError(\n \"INVALID_CONTEXT\",\n `${path} contains a circular reference.`,\n );\n }\n seen.add(value);\n try {\n if (Array.isArray(value)) {\n return value.map((item, index) =>\n normalizeContextValue(item, `${path}[${index}]`, seen));\n }\n const prototype = Object.getPrototypeOf(value);\n if (prototype !== Object.prototype && prototype !== null) {\n throw new AgentContextError(\n \"INVALID_CONTEXT\",\n `${path} must contain only plain objects.`,\n );\n }\n return Object.fromEntries(\n Object.keys(value)\n .sort(compareStrings)\n .map((key) => [\n key,\n normalizeContextValue(\n (value as Record<string, unknown>)[key],\n `${path}.${key}`,\n seen,\n ),\n ]),\n );\n } finally {\n seen.delete(value);\n }\n}\n\nfunction normalizeContext(context: AgentContextInput): AgentContextEntry {\n assertContextName(context.name);\n if (context.description !== undefined\n && (typeof context.description !== \"string\" \|\| !context.description.trim())) {\n throw new AgentContextError(\n \"INVALID_CONTEXT\",\n \"Context description must be a non-empty string when provided.\",\n );\n }\n return {\n name: context.name,\n ...(context.description === undefined ? {} : { description: context.description }),\n value: normalizeContextValue(context.value),\n };\n}\n\nclass DetailEvent<T> extends Event {\n constructor(type: string, readonly detail: T) {\n super(type);\n }\n}\n\nexport class AgentContextError extends Error {\n readonly type = \"tool_runtime_error\" as const;\n readonly domain = \"context\" as const;\n\n constructor(\n readonly code: AgentContextErrorCode,\n message: string,\n ) {\n super(message);\n this.name = \"ToolRuntimeError\";\n }\n}\n\nexport interface InternalToolRuntime extends ToolRuntime, EventTarget {\n beginInternalOperation(options?: { signal?: AbortSignal; onCancel?: () => void; source?: \"host\" \| \"webmcp\"; replaceWaiting?: ToolOperation; taskProgress?: TaskProgress }): ToolOperation;\n endBridgeOperation(handle: ToolOperation): Promise<void>;\n setTaskProgress(handle: ToolOperation, progress: TaskProgress): void;\n setOperationWaiting(handle: ToolOperation, waiting: boolean): void;\n getActivitySnapshot(): RuntimeActivitySnapshot;\n subscribeActivity(listener: () => void): () => void;\n requestOperationCancel(id: string): void;\n resolveTarget(tool: RuntimeAgentTool, input: unknown): HTMLElement \| undefined;\n setPageActionFeedback(listener: (event: AgentToolExecutionEvent, feedback: PageActionFeedback, signal?: AbortSignal) => void \| Promise<void>): () => void;\n bindTool<TInput, TResult>(\n definition: AgentToolDefinition<TInput, TResult>,\n execute: AgentToolExecutor<TInput, TResult>,\n options?: {\n signal?: AbortSignal;\n getConfirmation?: () => AgentToolConfirmationConfig \| undefined;\n resolveTarget?: (input: unknown) => HTMLElement \| undefined;\n },\n ): () => void;\n registerContext(\n input: AgentContextInput,\n options?: { signal?: AbortSignal },\n ): AgentContextRegistration;\n getWebMcpTools(): readonly RuntimeAgentTool[];\n isRegistered(name: string): boolean;\n waitForTool(\n definition: AgentToolDefinition<any, any>,\n options?: { signal?: AbortSignal; timeoutMs?: number },\n ): Promise<void>;\n getContextRevision(): number;\n getContextsNow(): readonly AgentContextEntry[];\n}\n\nconst runtimeInternals = new WeakMap<\n ToolRuntime,\n ToolRuntimeImplementation\n>();\n\nexport function createToolRuntime(\n options: ToolRuntimeOptions = {},\n): ToolRuntime {\n return new ToolRuntimeImplementation(options);\n}\n\nexport function getInternalToolRuntime(\n runtime: ToolRuntime,\n): InternalToolRuntime {\n const internal = runtimeInternals.get(runtime);\n if (!internal) {\n throw new AgentToolError(\n \"INVALID_TOOL_RUNTIME\",\n \"ToolRuntime must be created by createToolRuntime().\",\n );\n }\n return internal;\n}\n\nexport class ToolRuntimeImplementation\n extends EventTarget\n implements ToolRuntime, InternalToolRuntime\n{\n readonly [toolRuntimeBrand] = true as const;\n\n readonly #bindings = new Map<string, RuntimeBinding>();\n readonly #contexts = new Map<string, AgentContextEntry>();\n #contextRevision = 0;\n readonly #browserToolset: BrowserToolset \| undefined;\n readonly #browserRuntimeTools = new WeakMap<\n object,\n RuntimeAgentTool<any, any>\n >();\n #executionTail: Promise<void> \| undefined;\n #pageActionFeedback: ((event: AgentToolExecutionEvent, feedback: PageActionFeedback, signal?: AbortSignal) => void \| Promise<void>) \| undefined;\n readonly #operations = new OperationTracker();\n\n beginOperation(options: { onCancel?: () => void } = {}): ToolOperation {\n return this.#operations.begin(options.onCancel ? { onCancel: options.onCancel } : {});\n }\n beginInternalOperation(options: Parameters<OperationTracker[\"begin\"]>[0] = {}): ToolOperation {\n return this.#operations.begin(options);\n }\n endBridgeOperation(handle: ToolOperation): Promise<void> { return this.#operations.disposeBridge(handle); }\n setTaskProgress = (handle: ToolOperation, progress: TaskProgress): void => this.#operations.setTaskProgress(handle, progress);\n setOperationWaiting = (handle: ToolOperation, waiting: boolean): void => this.#operations.setWaitingForUser(handle, waiting);\n getActivitySnapshot = (): RuntimeActivitySnapshot => this.#operations.getSnapshot();\n subscribeActivity = (listener: () => void): (() => void) => this.#operations.subscribe(listener);\n requestOperationCancel(id: string): void { this.#operations.requestCancel(id); }\n\n setPageActionFeedback(listener: (event: AgentToolExecutionEvent, feedback: PageActionFeedback, signal?: AbortSignal) => void \| Promise<void>): () => void {\n this.#pageActionFeedback = listener;\n return () => { if (this.#pageActionFeedback === listener) this.#pageActionFeedback = undefined; };\n }\n\n #emitExecution(event: AgentToolExecutionEvent): void {\n this.#operations.observe(event);\n this.dispatchEvent(new DetailEvent(\"toolexecution\", event));\n }\n\n constructor(options: ToolRuntimeOptions = {}) {\n super();\n if (\n options.pageAutomation !== undefined &&\n typeof options.pageAutomation !== \"boolean\"\n ) {\n throw new AgentToolError(\"INVALID_INPUT\", \"pageAutomation must be a boolean.\");\n }\n this.#browserToolset = options.pageAutomation ? createBrowserToolset() : undefined;\n runtimeInternals.set(this, this);\n const controller = Object.freeze<RuntimeController>({\n beginInternalOperation: (options) => this.beginInternalOperation(options),\n setOperationWaiting: this.setOperationWaiting,\n setTaskProgress: this.setTaskProgress,\n getOperationSnapshot: () => this.getActivitySnapshot().operation,\n subscribeOperation: this.subscribeActivity,\n });\n Object.defineProperty(this, runtimeControllerSymbol, { value: controller });\n }\n\n on(\n eventName: \"toolchange\",\n listener: (event: ToolRuntimeToolChangeEvent) => void,\n ): () => void;\n on(\n eventName: \"toolexecution\",\n listener: (event: AgentToolExecutionEvent) => void,\n ): () => void;\n on(\n eventName: \"toolchange\" \| \"toolexecution\",\n listener: ((event: ToolRuntimeToolChangeEvent) => void) \| ((event: AgentToolExecutionEvent) => void),\n ): () => void {\n const handleEvent = (event: Event) => {\n if (eventName === \"toolchange\") {\n (listener as (event: ToolRuntimeToolChangeEvent) => void)(\n (event as Event & { detail: ToolRuntimeToolChangeEvent }).detail,\n );\n } else {\n (listener as (event: AgentToolExecutionEvent) => void)(\n (event as Event & { detail: AgentToolExecutionEvent }).detail,\n );\n }\n };\n this.addEventListener(eventName, handleEvent);\n let subscribed = true;\n return () => {\n if (!subscribed) return;\n subscribed = false;\n this.removeEventListener(eventName, handleEvent);\n };\n }\n\n register<TInput, TResult>(\n definition: AgentToolDefinition<TInput, TResult>,\n options: { execute: RegisteredAgentTool<TInput, TResult>[\"execute\"]; requiresConfirmation?: never },\n ): () => void {\n assertAgentToolRegistration(definition, options);\n const execute = options.execute;\n if (definition.inputSchema?.type !== \"object\") {\n throw new TypeError(`Tool \"${definition.name}\".inputSchema root type must be object.`);\n }\n const copied = defineAgentTool(definition) as AgentToolDefinition<TInput, TResult>;\n return this.#bindTool(copied, (input, { signal }) => execute(input, { signal }));\n }\n\n bindTool<TInput, TResult>(\n definition: AgentToolDefinition<TInput, TResult>,\n execute: AgentToolExecutor<TInput, TResult>,\n options: {\n signal?: AbortSignal;\n getConfirmation?: () => AgentToolConfirmationConfig \| undefined;\n resolveTarget?: (input: unknown) => HTMLElement \| undefined;\n } = {},\n ): () => void {\n assertAgentToolInputSchema(definition.inputSchema, `Tool \"${definition.name}\".inputSchema`);\n return this.#bindTool(definition, execute, options);\n }\n\n #bindTool<TInput, TResult>(\n definition: AgentToolDefinition<TInput, TResult>,\n execute: AgentToolExecutor<TInput, TResult>,\n options: NonNullable<Parameters<InternalToolRuntime[\"bindTool\"]>[2]> = {},\n ): () => void {\n if (this.#bindings.has(definition.name)) {\n throw new AgentToolError(\n \"DUPLICATE_BINDING\",\n `Tool \"${definition.name}\" already has an active binding.`,\n );\n }\n const lifecycleController = new AbortController();\n const runtimeTool = Object.freeze({\n definition,\n get confirmation() {\n const confirmation = options.getConfirmation?.();\n return confirmation === undefined\n ? undefined\n : Object.freeze({ ...confirmation });\n },\n lifecycleSignal: lifecycleController.signal,\n }) satisfies RuntimeAgentTool<TInput, TResult>;\n const binding: RuntimeBinding = {\n ...(options.resolveTarget ? { resolveTarget: options.resolveTarget } : {}),\n definition,\n runtimeTool,\n execute,\n ...(options.getConfirmation\n ? { getConfirmation: options.getConfirmation }\n : {}),\n lifecycleController,\n };\n this.#bindings.set(definition.name, binding);\n this.dispatchEvent(\n new DetailEvent(\"toolchange\", Object.freeze({\n toolName: definition.name,\n change: \"registered\" as const,\n })),\n );\n\n let disposed = false;\n const dispose = () => {\n if (disposed \|\| this.#bindings.get(definition.name) !== binding) return;\n disposed = true;\n options.signal?.removeEventListener(\"abort\", dispose);\n this.#bindings.delete(definition.name);\n lifecycleController.abort();\n this.dispatchEvent(\n new DetailEvent(\"toolchange\", Object.freeze({\n toolName: definition.name,\n change: \"unregistered\" as const,\n })),\n );\n };\n if (options.signal?.aborted) dispose();\n else options.signal?.addEventListener(\"abort\", dispose, { once: true });\n return dispose;\n }\n\n registerContext(\n input: AgentContextInput,\n options: { signal?: AbortSignal } = {},\n ): AgentContextRegistration {\n const initial = normalizeContext(input);\n if (this.#contexts.has(initial.name)) {\n throw new AgentContextError(\n \"DUPLICATE_CONTEXT\",\n `Context \"${initial.name}\" already has an active registration.`,\n );\n }\n this.#contexts.set(initial.name, initial);\n this.#notifyContextChange(initial.name, \"registered\");\n\n let disposed = false;\n const dispose = () => {\n if (disposed) return;\n disposed = true;\n options.signal?.removeEventListener(\"abort\", dispose);\n if (this.#contexts.delete(initial.name)) {\n this.#notifyContextChange(initial.name, \"disposed\");\n }\n };\n const update = (nextInput: AgentContextInput) => {\n if (disposed) {\n throw new AgentContextError(\n \"CONTEXT_DISPOSED\",\n `Context \"${initial.name}\" registration has been disposed.`,\n );\n }\n const next = normalizeContext(nextInput);\n if (next.name !== initial.name) {\n throw new AgentContextError(\n \"CONTEXT_NAME_MISMATCH\",\n `Context registration \"${initial.name}\" cannot be updated to \"${next.name}\".`,\n );\n }\n if (JSON.stringify(this.#contexts.get(initial.name)) === JSON.stringify(next)) return;\n this.#contexts.set(initial.name, next);\n this.#notifyContextChange(initial.name, \"updated\");\n };\n if (options.signal?.aborted) dispose();\n else options.signal?.addEventListener(\"abort\", dispose, { once: true });\n return { update, dispose };\n }\n\n getContextsNow(): readonly AgentContextEntry[] {\n return [...this.#contexts.values()]\n .sort((left, right) => compareStrings(left.name, right.name))\n .map(normalizeContext);\n }\n\n getContextRevision(): number {\n return this.#contextRevision;\n }\n\n async getContexts(\n options: { signal?: AbortSignal } = {},\n ): Promise<readonly AgentContextEntry[]> {\n options.signal?.throwIfAborted();\n await Promise.resolve();\n await new Promise<void>((resolve, reject) => {\n let settled = false;\n let frameId: number \| undefined;\n let timeoutId: ReturnType<typeof setTimeout> \| undefined;\n const cleanup = () => {\n options.signal?.removeEventListener(\"abort\", onAbort);\n if (frameId !== undefined && typeof cancelAnimationFrame === \"function\") {\n cancelAnimationFrame(frameId);\n }\n if (timeoutId !== undefined) clearTimeout(timeoutId);\n };\n const settle = () => {\n if (settled) return;\n settled = true;\n cleanup();\n resolve();\n };\n const onAbort = () => {\n if (settled) return;\n settled = true;\n cleanup();\n reject(options.signal?.reason);\n };\n const afterTask = () => {\n timeoutId = undefined;\n if (typeof requestAnimationFrame !== \"function\") {\n settle();\n return;\n }\n frameId = requestAnimationFrame(settle);\n timeoutId = setTimeout(settle, 50);\n };\n options.signal?.addEventListener(\"abort\", onAbort, { once: true });\n if (options.signal?.aborted) {\n onAbort();\n return;\n }\n timeoutId = setTimeout(afterTask, 0);\n });\n await Promise.resolve();\n options.signal?.throwIfAborted();\n return this.getContextsNow();\n }\n\n #notifyContextChange(\n name: string,\n change: \"registered\" \| \"updated\" \| \"disposed\",\n ): void {\n this.#contextRevision += 1;\n this.dispatchEvent(new DetailEvent(\"contextchange\", {\n name,\n change,\n revision: this.#contextRevision,\n }));\n }\n\n getWebMcpTools(): readonly RuntimeAgentTool[] {\n return [...this.#bindings.values()]\n .map(({ runtimeTool }) => runtimeTool)\n .sort((left, right) => compareStrings(\n left.definition.name,\n right.definition.name,\n ));\n }\n\n isRegistered(name: string): boolean {\n return this.#bindings.has(name);\n }\n\n getTools(): readonly RuntimeAgentTool[] {\n const applicationTools = [...this.#bindings.values()]\n .map(({ runtimeTool }) => runtimeTool);\n const browserTools = (this.#browserToolset?.definitions ?? [])\n .map((definition) => this.#getBrowserRuntimeTool(definition));\n return [...applicationTools, ...browserTools]\n .sort((left, right) => compareStrings(\n left.definition.name,\n right.definition.name,\n ));\n }\n\n waitForTool(\n definition: AgentToolDefinition<any, any>,\n options: { signal?: AbortSignal; timeoutMs?: number } = {},\n ): Promise<void> {\n const isTargetRegistered = () => this.#bindings.has(definition.name);\n if (isTargetRegistered()) return Promise.resolve();\n const timeoutMs = Math.max(1, options.timeoutMs ?? 5_000);\n return new Promise((resolve, reject) => {\n let settled = false;\n const cleanup = () => {\n this.removeEventListener(\"toolchange\", onToolChange);\n options.signal?.removeEventListener(\"abort\", onAbort);\n clearTimeout(timeoutId);\n };\n const settle = (callback: () => void) => {\n if (settled) return;\n settled = true;\n cleanup();\n callback();\n };\n const onToolChange = (event: Event) => {\n const detail = (event as Event & {\n detail?: ToolRuntimeToolChangeEvent;\n }).detail;\n if (\n detail?.toolName !== definition.name\n \|\| detail.change !== \"registered\"\n ) return;\n if (isTargetRegistered()) settle(resolve);\n };\n const onAbort = () => settle(() => reject(options.signal?.reason));\n const timeoutId = setTimeout(() => {\n settle(() =>\n reject(\n new AgentToolError(\n \"TOOL_REGISTRATION_TIMEOUT\",\n `Tool \"${definition.name}\" did not register within ${timeoutMs}ms.`,\n {\n toolName: definition.name,\n timeoutMs,\n retryable: false,\n browserFallbackAllowed: true,\n toolExecuted: false,\n },\n ),\n ));\n }, timeoutMs);\n this.addEventListener(\"toolchange\", onToolChange);\n if (options.signal?.aborted) onAbort();\n else options.signal?.addEventListener(\"abort\", onAbort, { once: true });\n if (isTargetRegistered()) settle(resolve);\n });\n }\n\n execute<TInput, TResult>(\n tool: RuntimeAgentTool<TInput, TResult>,\n input: TInput,\n options: InternalExecutionOptions = {},\n ): Promise<TResult> {\n const label = options.progressLabel?.trim().replace(/\\s+/g, \" \").slice(0, 48);\n options = { ...(options.signal ? { signal: options.signal } : {}), ...(label ? { progressLabel: label } : {}), ...(options[pageDecisionSymbol] ? { [pageDecisionSymbol]: true } : {}) };\n const definition = tool.definition;\n const name = definition.name;\n const binding = this.#bindings.get(name);\n if (binding) {\n if (binding.runtimeTool !== tool) {\n return Promise.reject(\n new AgentToolError(\n \"CONTRACT_MISMATCH\",\n `Tool \"${name}\" is registered with a different Runtime Tool.`,\n ),\n );\n }\n return this.#enqueue(\n (operationId) => this.#executeApplication(name, input, options, binding, operationId),\n options.signal,\n ) as Promise<TResult>;\n }\n try {\n const browserToolset = this.#browserToolset;\n const browserHandler = browserToolset?.handlers.get(name);\n if (!browserHandler) {\n return Promise.reject(\n new AgentToolError(\"UNKNOWN_TOOL\", `Unknown tool: ${name}.`),\n );\n }\n if (\n !browserToolset?.definitions.some((candidate) => candidate === definition)\n \|\| this.#getBrowserRuntimeTool(definition) !== tool\n ) {\n return Promise.reject(\n new AgentToolError(\n \"CONTRACT_MISMATCH\",\n `Tool \"${name}\" is registered with a different Definition.`,\n ),\n );\n }\n return this.#enqueue((operationId) => this.#observeExecution(tool, input, options.signal, async (onFeedback, assertActive) => {\n const signal = options.signal ?? new AbortController().signal;\n signal.throwIfAborted();\n return browserHandler.execute(input as Record<string, unknown>, {\n signal,\n ...(onFeedback ? { onFeedback } : {}),\n ...(assertActive ? { assertActive } : {}),\n ...(options[pageDecisionSymbol] ? { pageDecision: true } : {}),\n });\n }, options.progressLabel, operationId), options.signal) as Promise<TResult>;\n } catch (error) {\n return Promise.reject(error);\n }\n }\n\n #enqueue<TResult>(\n execute: (operationId?: string) => Promise<TResult>,\n signal?: AbortSignal,\n ): Promise<TResult> {\n if (signal?.aborted) return Promise.reject(signal.reason);\n let admission: ReturnType<OperationTracker[\"admit\"]>;\n try { admission = this.#operations.admit(); }\n catch (error) { return Promise.reject(error); }\n const previous = this.#executionTail;\n let removeQueuedAbort = () => {};\n const start = async () => {\n removeQueuedAbort();\n try {\n signal?.throwIfAborted();\n return await execute(admission.operationId);\n } finally { admission.release(); }\n };\n // Reserve the tail before invoking executors or notifying synchronous listeners.\n let settleTail!: () => void;\n const tail = new Promise<void>((resolve) => { settleTail = resolve; });\n this.#executionTail = tail;\n const queuedExecution = previous ? previous.then(start) : start();\n let execution = queuedExecution;\n if (previous && signal) {\n execution = new Promise((resolve, reject) => {\n const onAbort = () => {\n removeQueuedAbort();\n admission.release();\n reject(signal.reason);\n };\n removeQueuedAbort = () => signal.removeEventListener(\"abort\", onAbort);\n queuedExecution.then(resolve, reject);\n if (signal.aborted) onAbort();\n else signal.addEventListener(\"abort\", onAbort, { once: true });\n });\n }\n void queuedExecution.then(settleTail, settleTail);\n void tail.then(() => {\n if (this.#executionTail === tail) this.#executionTail = undefined;\n });\n return execution;\n }\n\n resolveTarget(tool: RuntimeAgentTool, input: unknown): HTMLElement \| undefined {\n const binding = this.#bindings.get(tool.definition.name);\n if (binding?.runtimeTool === tool) {\n const target = binding.resolveTarget?.(input);\n return target?.isConnected ? target : undefined;\n }\n if (this.#browserRuntimeTools.get(tool.definition) !== tool \|\| !input \|\| typeof input !== \"object\") return undefined;\n return this.#browserToolset?.handlers.get(tool.definition.name)?.resolveTarget?.(input as Record<string, unknown>);\n }\n\n async #observeExecution(\n tool: RuntimeAgentTool<any, any>,\n input: unknown,\n signal: AbortSignal \| undefined,\n execute: (onFeedback?: PageFeedbackListener, assertActive?: () => void) => Promise<unknown>,\n progressLabel?: string,\n operationId?: string,\n ): Promise<unknown> {\n const running: AgentToolExecutionEvent = {\n ...(operationId ? { operationId } : {}),\n id: globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random()}`,\n name: tool.definition.name,\n tool,\n status: \"running\",\n startedAt: Date.now(),\n input,\n ...(progressLabel ? { progressLabel } : {}),\n };\n const presentation = this.#pageActionFeedback;\n const assertActive = () => {\n signal?.throwIfAborted();\n if (presentation && this.#pageActionFeedback !== presentation) {\n throw new PageCommandError({ code: \"EXECUTION_CANCELLED\", message: \"Page action presentation was detached.\" });\n }\n };\n this.#emitExecution(running);\n try {\n assertActive();\n const result = await execute(async (feedback) => {\n assertActive();\n if (presentation) await measurePagePhase(\"presentation\", async () => { await presentation(running, feedback, signal); });\n assertActive();\n }, assertActive);\n signal?.throwIfAborted();\n this.#emitExecution({\n ...running, status: \"success\", finishedAt: Date.now(), result,\n } satisfies AgentToolExecutionEvent);\n return result;\n } catch (error) {\n this.#emitExecution({\n ...running, status: \"error\", cancelled: signal?.aborted === true,\n finishedAt: Date.now(), error,\n } satisfies AgentToolExecutionEvent);\n throw error;\n }\n }\n\n async #executeApplication(\n name: string,\n input: unknown,\n options: { signal?: AbortSignal; progressLabel?: string },\n binding: RuntimeBinding,\n operationId?: string,\n ): Promise<unknown> {\n const id = globalThis.crypto?.randomUUID?.()\n ?? `${Date.now()}-${Math.random()}`;\n const startedAt = Date.now();\n const running: AgentToolExecutionEvent = {\n ...(operationId ? { operationId } : {}),\n id,\n name,\n tool: binding.runtimeTool,\n ...(options.progressLabel ? { progressLabel: options.progressLabel } : {}),\n status: \"running\",\n startedAt,\n input,\n };\n this.#emitExecution(running);\n try {\n if (this.#bindings.get(name) !== binding) {\n throw new AgentToolError(\n \"UNKNOWN_TOOL\",\n `Tool \"${name}\" is no longer registered for this call.`,\n );\n }\n const errors = validateAgentToolInput(binding.definition.inputSchema, input);\n if (errors.length) {\n throw new AgentToolError(\"INVALID_INPUT\", errors.join(\" \"), { errors });\n }\n const signal = options.signal ?? new AbortController().signal;\n signal.throwIfAborted();\n const result = await binding.execute(input, {\n signal,\n waitForTool: (definition, waitOptions = {}) =>\n this.waitForTool(definition, { signal, ...waitOptions }),\n });\n signal.throwIfAborted();\n this.#emitExecution({\n ...running,\n status: \"success\",\n finishedAt: Date.now(),\n result,\n } satisfies AgentToolExecutionEvent);\n return result;\n } catch (error) {\n this.#emitExecution({\n ...running,\n status: \"error\",\n cancelled: options.signal?.aborted === true,\n finishedAt: Date.now(),\n error,\n } satisfies AgentToolExecutionEvent);\n throw error;\n }\n }\n\n #getBrowserRuntimeTool<TInput, TResult>(\n definition: AgentToolDefinition<TInput, TResult>,\n ): RuntimeAgentTool<TInput, TResult> {\n const existing = this.#browserRuntimeTools.get(definition);\n if (existing) return existing as RuntimeAgentTool<TInput, TResult>;\n const runtimeTool = Object.freeze({\n definition,\n confirmation: undefined,\n lifecycleSignal: new AbortController().signal,\n }) satisfies RuntimeAgentTool<TInput, TResult>;\n this.#browserRuntimeTools.set(definition, runtimeTool);\n return runtimeTool;\n }\n\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@nexface/tools",
-  "version": "0.1.15-alpha.0",
+  "version": "0.1.15-alpha.1",
   "type": "module",
   "exports": {
     ".": {

package/dist/shared/tool-registry.d.ts DELETED Viewed

@@ -1,6 +0,0 @@
-import type { createAgentToolRegistry, RegisteredAgentTool } from "../registration.js";
-export declare const toolRegistrySymbol: unique symbol;
-export interface ToolRegistryController {
-    getTools(): readonly RegisteredAgentTool[];
-}
-export declare function getToolRegistryController(registry: ReturnType<typeof createAgentToolRegistry>): ToolRegistryController;

package/dist/shared/tool-registry.js DELETED Viewed

@@ -1,10 +0,0 @@
-// Generated from shared/tool-registry.ts. Do not edit manually.
-export const toolRegistrySymbol = Symbol.for("@nexface/tools/tool-registry");
-export function getToolRegistryController(registry) {
-    const controller = registry?.[toolRegistrySymbol];
-    if (!controller || typeof controller.getTools !== "function") {
-        throw new TypeError("toolRegistry must be created by createAgentToolRegistry(). Use matching Nexface package versions.");
-    }
-    return controller;
-}
-//# sourceMappingURL=tool-registry.js.map

package/dist/shared/tool-registry.js.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../src/shared/tool-registry.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAIhE,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AAM7E,MAAM,UAAU,yBAAyB,CAAC,QAAoD;IAC5F,MAAM,UAAU,GAAI,QAAgF,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAC3H,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC7D,MAAM,IAAI,SAAS,CAAC,mGAAmG,CAAC,CAAC;IAC3H,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["// Generated from shared/tool-registry.ts. Do not edit manually.\n\nimport type { createAgentToolRegistry, RegisteredAgentTool } from \"../registration.js\";\n\nexport const toolRegistrySymbol = Symbol.for(\"@nexface/tools/tool-registry\");\n\nexport interface ToolRegistryController {\n getTools(): readonly RegisteredAgentTool[];\n}\n\nexport function getToolRegistryController(registry: ReturnType<typeof createAgentToolRegistry>): ToolRegistryController {\n const controller = (registry as typeof registry & { [toolRegistrySymbol]?: ToolRegistryController })?.[toolRegistrySymbol];\n if (!controller || typeof controller.getTools !== \"function\") {\n throw new TypeError(\"toolRegistry must be created by createAgentToolRegistry(). Use matching Nexface package versions.\");\n }\n return controller;\n}\n"]}