npm - @nexface/tools - Versions diffs - 0.1.1-alpha.8 → 0.1.1 - Mend

@nexface/tools 0.1.1-alpha.8 → 0.1.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 (27) hide show

package/dist/browser/toolset.d.ts +10 -4
package/dist/browser/toolset.js +15 -4
package/dist/browser/toolset.js.map +1 -1
package/dist/definition.js +8 -5
package/dist/definition.js.map +1 -1
package/dist/internal.d.ts +2 -2
package/dist/internal.js +1 -1
package/dist/internal.js.map +1 -1
package/dist/operation-runtime.d.ts +1 -0
package/dist/operation-runtime.js +5 -2
package/dist/operation-runtime.js.map +1 -1
package/dist/operation-surface.js +1 -1
package/dist/operation-surface.js.map +1 -1
package/dist/registration.d.ts +0 -1
package/dist/registration.js +2 -0
package/dist/registration.js.map +1 -1
package/dist/runtime.d.ts +1 -2
package/dist/runtime.js +14 -25
package/dist/runtime.js.map +1 -1
package/dist/schema.d.ts +1 -0
package/dist/schema.js +185 -32
package/dist/schema.js.map +1 -1
package/dist/types.d.ts +11 -1
package/dist/types.js.map +1 -1
package/dist/webmcp.js +50 -9
package/dist/webmcp.js.map +1 -1
package/package.json +1 -1

package/dist/runtime.js CHANGED Viewed

@@ -2,7 +2,7 @@ import { AgentToolError, TOOL_ERROR_CODES } from "./errors.js";
 export { AgentToolError } from "./errors.js";
 import { OperationTracker } from "./operation-runtime.js";
 import { isValidAgentContextName } from "./definition.js";
-import { validateAgentToolInput } from "./schema.js";
+import { assertAgentToolInputSchema, validateAgentToolInput } from "./schema.js";
 import { createBrowserToolset, } from "./browser/toolset.js";
 const CONTEXT_ERROR_CODES = [
     "CONTEXT_DISPOSED",
@@ -30,19 +30,6 @@ export function isToolRuntimeError(error) {
     return false;
 }
 const toolRuntimeBrand = Symbol.for("@nexface/tools/ToolRuntime");
-function copyPageAutomationConfig(config) {
-    if (config === undefined)
-        return false;
-    if (typeof config === "boolean")
-        return config;
-    return {
-        ...config,
-        ...(config.limits ? { limits: { ...config.limits } } : {}),
-        ...(config.snapshotLimits
-            ? { snapshotLimits: { ...config.snapshotLimits } }
-            : {}),
-    };
-}
 function compareStrings(left, right) {
     return left < right ? -1 : left > right ? 1 : 0;
 }
@@ -91,12 +78,13 @@ function normalizeContextValue(value, path = "value", seen = new WeakSet()) {
 }
 function normalizeContext(context) {
     assertContextName(context.name);
-    if (!context.description.trim()) {
-        throw new AgentContextError("INVALID_CONTEXT", "Context description is required.");
+    if (context.description !== undefined
+        && (typeof context.description !== "string" || !context.description.trim())) {
+        throw new AgentContextError("INVALID_CONTEXT", "Context description must be a non-empty string when provided.");
     }
     return {
         name: context.name,
-        description: context.description,
+        ...(context.description === undefined ? {} : { description: context.description }),
         value: normalizeContextValue(context.value),
     };
 }
@@ -130,7 +118,7 @@ export function getInternalToolRuntime(runtime) {
 }
 export class ToolRuntimeImplementation extends EventTarget {
     [toolRuntimeBrand] = true;
-    #pageAutomationConfig;
+    #pageAutomationEnabled;
     #bindings = new Map();
     #contexts = new Map();
     #contextRevision = 0;
@@ -155,7 +143,11 @@ export class ToolRuntimeImplementation extends EventTarget {
     }
     constructor(options = {}) {
         super();
-        this.#pageAutomationConfig = copyPageAutomationConfig(options.pageAutomation);
+        if (options.pageAutomation !== undefined &&
+            typeof options.pageAutomation !== "boolean") {
+            throw new AgentToolError("INVALID_INPUT", "pageAutomation must be a boolean.");
+        }
+        this.#pageAutomationEnabled = options.pageAutomation ?? false;
         runtimeInternals.set(this, this);
     }
     on(eventName, listener) {
@@ -177,6 +169,7 @@ export class ToolRuntimeImplementation extends EventTarget {
         };
     }
     register(definition, execute, options = {}) {
+        assertAgentToolInputSchema(definition.inputSchema, `Tool "${definition.name}".inputSchema`);
         if (this.#bindings.has(definition.name)) {
             throw new AgentToolError("DUPLICATE_BINDING", `Tool "${definition.name}" already has an active binding.`);
         }
@@ -333,7 +326,6 @@ export class ToolRuntimeImplementation extends EventTarget {
     }
     getWebMcpTools() {
         return [...this.#bindings.values()]
-            .filter((binding) => !binding.getConfirmation?.())
             .map(({ runtimeTool }) => runtimeTool)
             .sort((left, right) => compareStrings(left.definition.name, right.definition.name));
     }
@@ -589,13 +581,10 @@ export class ToolRuntimeImplementation extends EventTarget {
         return runtimeTool;
     }
     #getBrowserToolset() {
-        if (this.#pageAutomationConfig === false)
+        if (!this.#pageAutomationEnabled)
             return undefined;
         if (!this.#browserToolset) {
-            const options = this.#pageAutomationConfig === true
-                ? {}
-                : this.#pageAutomationConfig;
-            this.#browserToolset = createBrowserToolset(options);
+            this.#browserToolset = createBrowserToolset();
         }
         return this.#browserToolset;
     }

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 type { TaskProgress } from \"./operation-runtime.js\";\nimport { AgentToolError, TOOL_ERROR_CODES } from \"./errors.js\";\nexport { AgentToolError } from \"./errors.js\";\nimport { OperationTracker, type RuntimeActivitySnapshot } from \"./operation-runtime.js\";\nimport { isValidAgentContextName } from \"./definition.js\";\nimport { validateAgentToolInput } from \"./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 PageAutomationConfig,\n type BrowserToolset,\n} from \"./browser/toolset.js\";\n\nexport interface ToolRuntimeOptions {\n readonly pageAutomation?: PageAutomationConfig;\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 setWaitingForUser(waiting: boolean): void;\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; throws OPERATION_BUSY while occupied.\n * @beta\n /\n beginOperation(options?: { signal?: AbortSignal; onCancel?: () => void }): ToolOperation;\n getTools(): readonly RuntimeAgentTool[];\n getContexts(options?: {\n signal?: AbortSignal;\n }): Promise<readonly AgentContextEntry[]>;\n execute<TInput, TResult>(\n tool: RuntimeAgentTool<TInput, TResult>,\n input: TInput,\n options?: { signal?: AbortSignal },\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 copyPageAutomationConfig(\n config: PageAutomationConfig \| undefined,\n): PageAutomationConfig {\n if (config === undefined) return false;\n if (typeof config === \"boolean\") return config;\n return {\n ...config,\n ...(config.limits ? { limits: { ...config.limits } } : {}),\n ...(config.snapshotLimits\n ? { snapshotLimits: { ...config.snapshotLimits } }\n : {}),\n };\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.trim()) {\n throw new AgentContextError(\n \"INVALID_CONTEXT\",\n \"Context description is required.\",\n );\n }\n return {\n name: context.name,\n 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 getActivitySnapshot(): RuntimeActivitySnapshot;\n subscribeActivity(listener: () => void): () => void;\n requestOperationCancel(id: string): void;\n resolveTarget(tool: RuntimeAgentTool, input: unknown): HTMLElement \| undefined;\n executeWithProgress<TInput, TResult>(\n tool: RuntimeAgentTool<TInput, TResult>,\n input: TInput,\n options: { signal?: AbortSignal; progressLabel?: string },\n ): Promise<TResult>;\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 getApplicationTools(): readonly AgentToolDefinition[];\n getWebMcpTools(): readonly RuntimeAgentTool[];\n isRegistered(name: string): boolean;\n executeApplicationTool(\n name: string,\n input: unknown,\n options?: {\n signal?: AbortSignal;\n expectedDefinition?: AgentToolDefinition;\n },\n ): Promise<unknown>;\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 #pageAutomationConfig: PageAutomationConfig;\n readonly #bindings = new Map<string, RuntimeBinding>();\n readonly #contexts = new Map<string, AgentContextEntry>();\n #contextRevision = 0;\n #browserToolset: BrowserToolset \| undefined;\n readonly #browserRuntimeTools = new WeakMap<\n object,\n RuntimeAgentTool<any, any>\n >();\n #executionTail: Promise<void> \| undefined;\n readonly #operations = new OperationTracker();\n\n beginOperation(options: { signal?: AbortSignal; onCancel?: () => void } = {}): ToolOperation {\n return this.#operations.begin(options);\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 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 #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 this.#pageAutomationConfig = copyPageAutomationConfig(options.pageAutomation);\n runtimeInternals.set(this, this);\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 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 getApplicationTools(): readonly AgentToolDefinition[] {\n return [...this.#bindings.values()]\n .map(({ definition }) => definition)\n .sort((left, right) => compareStrings(left.name, right.name));\n }\n\n getWebMcpTools(): readonly RuntimeAgentTool[] {\n return [...this.#bindings.values()]\n .filter((binding) => !binding.getConfirmation?.())\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.#getBrowserToolset()?.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: { signal?: AbortSignal } = {},\n ): Promise<TResult> {\n return this.executeWithProgress(tool, input, options.signal ? { signal: options.signal } : {});\n }\n\n executeWithProgress<TInput, TResult>(\n tool: RuntimeAgentTool<TInput, TResult>,\n input: TInput,\n options: { signal?: AbortSignal; progressLabel?: string } = {},\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 } : {}) };\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.#getBrowserToolset();\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 () => {\n const signal = options.signal ?? new AbortController().signal;\n signal.throwIfAborted();\n return browserHandler.execute(input as Record<string, unknown>, {\n signal,\n });\n }, options.progressLabel, operationId), options.signal) as Promise<TResult>;\n } catch (error) {\n return Promise.reject(error);\n }\n }\n\n executeApplicationTool(\n name: string,\n input: unknown,\n options: {\n signal?: AbortSignal;\n expectedDefinition?: AgentToolDefinition;\n } = {},\n ): Promise<unknown> {\n const binding = this.#bindings.get(name);\n if (!binding) {\n return Promise.reject(\n new AgentToolError(\"UNKNOWN_TOOL\", `Unknown tool: ${name}.`),\n );\n }\n return this.#enqueue(\n (operationId) => {\n const activeBinding = this.#bindings.get(name);\n if (!activeBinding) {\n throw new AgentToolError(\"UNKNOWN_TOOL\", `Unknown tool: ${name}.`);\n }\n if (\n options.expectedDefinition\n && activeBinding.definition !== options.expectedDefinition\n ) {\n throw new AgentToolError(\n \"CONTRACT_MISMATCH\",\n `Tool \"${name}\" changed after the model request was sent.`,\n );\n }\n return this.#executeApplication(name, input, options, activeBinding, operationId);\n },\n options.signal,\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 const admission = this.#operations.admit();\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) return undefined;\n const target = binding.resolveTarget?.(input);\n return target?.isConnected ? target : undefined;\n }\n\n async #observeExecution(\n tool: RuntimeAgentTool<any, any>,\n input: unknown,\n signal: AbortSignal \| undefined,\n execute: () => 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 this.#emitExecution(running);\n try {\n const result = await execute();\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 #getBrowserToolset(): BrowserToolset \| undefined {\n if (this.#pageAutomationConfig === false) return undefined;\n if (!this.#browserToolset) {\n const options = this.#pageAutomationConfig === true\n ? {}\n : this.#pageAutomationConfig;\n this.#browserToolset = createBrowserToolset(options);\n }\n return this.#browserToolset;\n }\n}\n"]}
1	+ {"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAgC,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AASjF,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;AAgFlE,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;AA+CD,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,sBAAsB,CAAU;IAChC,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC9C,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC1D,gBAAgB,GAAG,CAAC,CAAC;IACrB,eAAe,CAA6B;IACnC,oBAAoB,GAAG,IAAI,OAAO,EAGxC,CAAC;IACJ,cAAc,CAA4B;IACjC,WAAW,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAE9C,cAAc,CAAC,UAA2D,EAAE;QAC1E,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,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,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,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,sBAAsB,GAAG,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;QAC9D,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,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,OAA2C,EAC3C,UAII,EAAE;QAEN,0BAA0B,CAAC,UAAU,CAAC,WAAW,EAAE,SAAS,UAAU,CAAC,IAAI,eAAe,CAAC,CAAC;QAC5F,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,mBAAmB;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;aAChC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC;aACnC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,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,kBAAkB,EAAE,EAAE,WAAW,IAAI,EAAE,CAAC;aAChE,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,OAAO,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,mBAAmB,CACjB,IAAuC,EACvC,KAAa,EACb,UAA4D,EAAE;QAE9D,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,CAAC;QAChH,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,kBAAkB,EAAE,CAAC;YACjD,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,IAAI,EAAE;gBACnG,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;iBACP,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,sBAAsB,CACpB,IAAY,EACZ,KAAc,EACd,UAGI,EAAE;QAEN,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,cAAc,CAAC,cAAc,EAAE,iBAAiB,IAAI,GAAG,CAAC,CAC7D,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAClB,CAAC,WAAW,EAAE,EAAE;YACd,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,MAAM,IAAI,cAAc,CAAC,cAAc,EAAE,iBAAiB,IAAI,GAAG,CAAC,CAAC;YACrE,CAAC;YACD,IACE,OAAO,CAAC,kBAAkB;mBACvB,aAAa,CAAC,UAAU,KAAK,OAAO,CAAC,kBAAkB,EAC1D,CAAC;gBACD,MAAM,IAAI,cAAc,CACtB,mBAAmB,EACnB,SAAS,IAAI,6CAA6C,CAC3D,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;QACpF,CAAC,EACD,OAAO,CAAC,MAAM,CACf,CAAC;IACJ,CAAC;IAED,QAAQ,CACN,OAAmD,EACnD,MAAoB;QAEpB,IAAI,MAAM,EAAE,OAAO;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAC3C,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;YAAE,OAAO,SAAS,CAAC;QACpD,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,IAAgC,EAChC,KAAc,EACd,MAA+B,EAC/B,OAA+B,EAC/B,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,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;YAC/B,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;IAED,kBAAkB;QAChB,IAAI,CAAC,IAAI,CAAC,sBAAsB;YAAE,OAAO,SAAS,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,IAAI,CAAC,eAAe,GAAG,oBAAoB,EAAE,CAAC;QAChD,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;CACF","sourcesContent":["import type { TaskProgress } from \"./operation-runtime.js\";\nimport { AgentToolError, TOOL_ERROR_CODES } from \"./errors.js\";\nexport { AgentToolError } from \"./errors.js\";\nimport { OperationTracker, type RuntimeActivitySnapshot } from \"./operation-runtime.js\";\nimport { isValidAgentContextName } from \"./definition.js\";\nimport { assertAgentToolInputSchema, validateAgentToolInput } from \"./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 setWaitingForUser(waiting: boolean): void;\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; throws OPERATION_BUSY while occupied.\n * @beta\n /\n beginOperation(options?: { signal?: AbortSignal; onCancel?: () => void }): ToolOperation;\n getTools(): readonly RuntimeAgentTool[];\n getContexts(options?: {\n signal?: AbortSignal;\n }): Promise<readonly AgentContextEntry[]>;\n execute<TInput, TResult>(\n tool: RuntimeAgentTool<TInput, TResult>,\n input: TInput,\n options?: { signal?: AbortSignal },\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 getActivitySnapshot(): RuntimeActivitySnapshot;\n subscribeActivity(listener: () => void): () => void;\n requestOperationCancel(id: string): void;\n resolveTarget(tool: RuntimeAgentTool, input: unknown): HTMLElement \| undefined;\n executeWithProgress<TInput, TResult>(\n tool: RuntimeAgentTool<TInput, TResult>,\n input: TInput,\n options: { signal?: AbortSignal; progressLabel?: string },\n ): Promise<TResult>;\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 getApplicationTools(): readonly AgentToolDefinition[];\n getWebMcpTools(): readonly RuntimeAgentTool[];\n isRegistered(name: string): boolean;\n executeApplicationTool(\n name: string,\n input: unknown,\n options?: {\n signal?: AbortSignal;\n expectedDefinition?: AgentToolDefinition;\n },\n ): Promise<unknown>;\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 #pageAutomationEnabled: boolean;\n readonly #bindings = new Map<string, RuntimeBinding>();\n readonly #contexts = new Map<string, AgentContextEntry>();\n #contextRevision = 0;\n #browserToolset: BrowserToolset \| undefined;\n readonly #browserRuntimeTools = new WeakMap<\n object,\n RuntimeAgentTool<any, any>\n >();\n #executionTail: Promise<void> \| undefined;\n readonly #operations = new OperationTracker();\n\n beginOperation(options: { signal?: AbortSignal; onCancel?: () => void } = {}): ToolOperation {\n return this.#operations.begin(options);\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 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 #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.#pageAutomationEnabled = options.pageAutomation ?? false;\n runtimeInternals.set(this, this);\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 getApplicationTools(): readonly AgentToolDefinition[] {\n return [...this.#bindings.values()]\n .map(({ definition }) => definition)\n .sort((left, right) => compareStrings(left.name, right.name));\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.#getBrowserToolset()?.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: { signal?: AbortSignal } = {},\n ): Promise<TResult> {\n return this.executeWithProgress(tool, input, options.signal ? { signal: options.signal } : {});\n }\n\n executeWithProgress<TInput, TResult>(\n tool: RuntimeAgentTool<TInput, TResult>,\n input: TInput,\n options: { signal?: AbortSignal; progressLabel?: string } = {},\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 } : {}) };\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.#getBrowserToolset();\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 () => {\n const signal = options.signal ?? new AbortController().signal;\n signal.throwIfAborted();\n return browserHandler.execute(input as Record<string, unknown>, {\n signal,\n });\n }, options.progressLabel, operationId), options.signal) as Promise<TResult>;\n } catch (error) {\n return Promise.reject(error);\n }\n }\n\n executeApplicationTool(\n name: string,\n input: unknown,\n options: {\n signal?: AbortSignal;\n expectedDefinition?: AgentToolDefinition;\n } = {},\n ): Promise<unknown> {\n const binding = this.#bindings.get(name);\n if (!binding) {\n return Promise.reject(\n new AgentToolError(\"UNKNOWN_TOOL\", `Unknown tool: ${name}.`),\n );\n }\n return this.#enqueue(\n (operationId) => {\n const activeBinding = this.#bindings.get(name);\n if (!activeBinding) {\n throw new AgentToolError(\"UNKNOWN_TOOL\", `Unknown tool: ${name}.`);\n }\n if (\n options.expectedDefinition\n && activeBinding.definition !== options.expectedDefinition\n ) {\n throw new AgentToolError(\n \"CONTRACT_MISMATCH\",\n `Tool \"${name}\" changed after the model request was sent.`,\n );\n }\n return this.#executeApplication(name, input, options, activeBinding, operationId);\n },\n options.signal,\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 const admission = this.#operations.admit();\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) return undefined;\n const target = binding.resolveTarget?.(input);\n return target?.isConnected ? target : undefined;\n }\n\n async #observeExecution(\n tool: RuntimeAgentTool<any, any>,\n input: unknown,\n signal: AbortSignal \| undefined,\n execute: () => 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 this.#emitExecution(running);\n try {\n const result = await execute();\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 #getBrowserToolset(): BrowserToolset \| undefined {\n if (!this.#pageAutomationEnabled) return undefined;\n if (!this.#browserToolset) {\n this.#browserToolset = createBrowserToolset();\n }\n return this.#browserToolset;\n }\n}\n"]}

package/dist/schema.d.ts CHANGED Viewed

@@ -1,2 +1,3 @@
 import type { JsonSchema } from "./types.js";
+export declare function assertAgentToolInputSchema(value: unknown, path?: string): void;
 export declare function validateAgentToolInput(schema: JsonSchema, value: unknown, path?: string): string[];

package/dist/schema.js CHANGED Viewed

@@ -1,44 +1,197 @@
+const types = new Set(["object", "array", "string", "number", "integer", "boolean", "null"]);
+const counts = ["minLength", "maxLength", "minItems", "maxItems"];
+const bounds = ["minimum", "maximum", "exclusiveMinimum", "exclusiveMaximum"];
+const keywords = new Set([
+    "type", "description", "properties", "required", "items", "enum", "additionalProperties",
+    ...counts, ...bounds, "pattern", "uniqueItems",
+]);
+const checkedSchemas = new WeakSet();
+const patterns = new WeakMap();
+function invalid(path, message) {
+    throw new TypeError(`${path} ${message}`);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+// Only deeply frozen, JSON-compatible values can safely share validation results.
+function assertJson(value, path, ancestors = new Set()) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return true;
+    if (typeof value === "number" && Number.isFinite(value))
+        return true;
+    if (typeof value !== "object" || value === null)
+        invalid(path, "must be JSON-compatible.");
+    if (ancestors.has(value))
+        invalid(path, "must not contain circular references.");
+    if (!Array.isArray(value) && Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) {
+        invalid(path, "must be a plain JSON object.");
+    }
+    if (Object.getOwnPropertySymbols(value).length)
+        invalid(path, "must not contain symbol properties.");
+    for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(value))) {
+        if (!descriptor.enumerable && !(Array.isArray(value) && key === "length"))
+            invalid(`${path}.${key}`, "must be enumerable.");
+        if (descriptor.get || descriptor.set)
+            invalid(`${path}.${key}`, "must be a data property.");
+    }
+    if (Array.isArray(value)) {
+        for (let index = 0; index < value.length; index++) {
+            if (!Object.hasOwn(value, index))
+                invalid(`${path}[${index}]`, "must not be a sparse array slot.");
+        }
+    }
+    ancestors.add(value);
+    let frozen = Object.isFrozen(value);
+    for (const [key, child] of Object.entries(value)) {
+        const childFrozen = assertJson(child, `${path}.${key}`, ancestors);
+        frozen = frozen && childFrozen;
+    }
+    ancestors.delete(value);
+    return frozen;
+}
+function patternFor(schema, path) {
+    const source = schema.pattern;
+    const cached = patterns.get(schema);
+    if (cached?.source === source)
+        return cached.regex;
+    let regex;
+    try {
+        regex = new RegExp(source, "u");
+    }
+    catch {
+        invalid(`${path}.pattern`, "must be a valid Unicode regular expression.");
+    }
+    patterns.set(schema, { source, regex });
+    return regex;
+}
+function assertSchema(value, path) {
+    if (!isRecord(value))
+        invalid(path, "must be an object.");
+    const unexpected = Object.keys(value).filter((key) => !keywords.has(key));
+    if (unexpected.length)
+        invalid(path, `has unsupported fields: ${unexpected.join(", ")}.`);
+    if (value.type !== undefined && (typeof value.type !== "string" || !types.has(value.type)))
+        invalid(`${path}.type`, "is not supported.");
+    if (value.description !== undefined && typeof value.description !== "string")
+        invalid(`${path}.description`, "must be a string.");
+    for (const key of ["additionalProperties", "uniqueItems"]) {
+        if (value[key] !== undefined && typeof value[key] !== "boolean")
+            invalid(`${path}.${key}`, "must be a boolean.");
+    }
+    for (const key of counts) {
+        const count = value[key];
+        if (count !== undefined && (typeof count !== "number" || !Number.isInteger(count) || count < 0))
+            invalid(`${path}.${key}`, "must be a non-negative integer.");
+    }
+    for (const key of bounds) {
+        if (value[key] !== undefined && (typeof value[key] !== "number" || !Number.isFinite(value[key])))
+            invalid(`${path}.${key}`, "must be a finite number.");
+    }
+    if (value.pattern !== undefined) {
+        if (typeof value.pattern !== "string")
+            invalid(`${path}.pattern`, "must be a string.");
+        patternFor(value, path);
+    }
+    if (value.enum !== undefined && (!Array.isArray(value.enum) || value.enum.length === 0))
+        invalid(`${path}.enum`, "must be a non-empty array.");
+    if (Array.isArray(value.enum) && value.enum.some((item, index, entries) => entries.slice(0, index).some((other) => jsonEqual(item, other))))
+        invalid(`${path}.enum`, "must contain unique values.");
+    if (value.properties !== undefined) {
+        if (value.type !== "object" || !isRecord(value.properties))
+            invalid(`${path}.properties`, "requires an object schema.");
+        for (const [name, property] of Object.entries(value.properties))
+            assertSchema(property, `${path}.properties.${name}`);
+    }
+    if (value.required !== undefined) {
+        if (value.type !== "object" || !Array.isArray(value.required) || value.required.some((name) => typeof name !== "string") || new Set(value.required).size !== value.required.length)
+            invalid(`${path}.required`, "must contain unique property names.");
+        const properties = value.properties;
+        if (value.required.some((name) => !properties || !Object.hasOwn(properties, name)))
+            invalid(`${path}.required`, "must reference declared properties.");
+    }
+    if (value.items !== undefined) {
+        if (value.type !== "array")
+            invalid(`${path}.items`, "requires an array schema.");
+        assertSchema(value.items, `${path}.items`);
+    }
+}
+export function assertAgentToolInputSchema(value, path = "inputSchema") {
+    if (!isRecord(value) || value.type !== "object")
+        invalid(path, 'root type must be object.');
+    if (checkedSchemas.has(value))
+        return;
+    const frozen = assertJson(value, path);
+    assertSchema(value, path);
+    if (frozen)
+        checkedSchemas.add(value);
+}
+function jsonEqual(left, right) {
+    if (left === right)
+        return true;
+    if (Array.isArray(left) && Array.isArray(right))
+        return left.length === right.length && left.every((item, index) => jsonEqual(item, right[index]));
+    if (!isRecord(left) || !isRecord(right))
+        return false;
+    const keys = Object.keys(left);
+    return keys.length === Object.keys(right).length && keys.every((key) => Object.hasOwn(right, key) && jsonEqual(left[key], right[key]));
+}
 function typeMatches(schema, value) {
     switch (schema.type) {
-        case undefined:
-            return true;
-        case "null":
-            return value === null;
-        case "array":
-            return Array.isArray(value);
-        case "object":
-            return value !== null && typeof value === "object" && !Array.isArray(value);
-        case "integer":
-            return typeof value === "number" && Number.isInteger(value);
-        default:
-            return typeof value === schema.type;
+        case undefined: return true;
+        case "null": return value === null;
+        case "array": return Array.isArray(value);
+        case "object": return isRecord(value);
+        case "integer": return typeof value === "number" && Number.isInteger(value);
+        case "number": return typeof value === "number" && Number.isFinite(value);
+        default: return typeof value === schema.type;
     }
 }
 export function validateAgentToolInput(schema, value, path = "input") {
-    if (!typeMatches(schema, value)) {
+    if (!typeMatches(schema, value))
         return [`${path} must be ${schema.type}.`];
+    const errors = [];
+    if (schema.enum && !schema.enum.some((item) => jsonEqual(item, value)))
+        errors.push(`${path} must be one of the declared enum values.`);
+    if (typeof value === "string") {
+        const length = Array.from(value).length;
+        if (schema.minLength !== undefined && length < schema.minLength)
+            errors.push(`${path} must have at least ${schema.minLength} characters.`);
+        if (schema.maxLength !== undefined && length > schema.maxLength)
+            errors.push(`${path} must have at most ${schema.maxLength} characters.`);
+        if (schema.pattern !== undefined && !patternFor(schema, path).test(value))
+            errors.push(`${path} must match pattern ${schema.pattern}.`);
     }
-    if (schema.enum && !schema.enum.some((item) => Object.is(item, value))) {
-        return [`${path} must be one of the declared enum values.`];
-    }
-    if (schema.type === "array" && Array.isArray(value) && schema.items) {
-        return value.flatMap((item, index) => validateAgentToolInput(schema.items, item, `${path}[${index}]`));
+    if (typeof value === "number") {
+        if (schema.minimum !== undefined && value < schema.minimum)
+            errors.push(`${path} must be >= ${schema.minimum}.`);
+        if (schema.maximum !== undefined && value > schema.maximum)
+            errors.push(`${path} must be <= ${schema.maximum}.`);
+        if (schema.exclusiveMinimum !== undefined && value <= schema.exclusiveMinimum)
+            errors.push(`${path} must be > ${schema.exclusiveMinimum}.`);
+        if (schema.exclusiveMaximum !== undefined && value >= schema.exclusiveMaximum)
+            errors.push(`${path} must be < ${schema.exclusiveMaximum}.`);
     }
-    if (schema.type !== "object" || value === null || typeof value !== "object") {
-        return [];
+    if (Array.isArray(value)) {
+        if (schema.minItems !== undefined && value.length < schema.minItems)
+            errors.push(`${path} must have at least ${schema.minItems} items.`);
+        if (schema.maxItems !== undefined && value.length > schema.maxItems)
+            errors.push(`${path} must have at most ${schema.maxItems} items.`);
+        if (schema.uniqueItems && value.some((item, index) => value.slice(0, index).some((other) => jsonEqual(item, other))))
+            errors.push(`${path} must contain unique items.`);
+        if (schema.items)
+            value.forEach((item, index) => errors.push(...validateAgentToolInput(schema.items, item, `${path}[${index}]`)));
     }
-    const record = value;
-    const errors = [];
-    for (const key of schema.required ?? []) {
-        if (!(key in record))
-            errors.push(`${path}.${key} is required.`);
-    }
-    for (const [key, item] of Object.entries(record)) {
-        const property = schema.properties?.[key];
-        if (property)
-            errors.push(...validateAgentToolInput(property, item, `${path}.${key}`));
-        else if (schema.additionalProperties === false) {
-            errors.push(`${path}.${key} is not allowed.`);
+    if (isRecord(value)) {
+        for (const key of schema.required ?? []) {
+            if (!Object.hasOwn(value, key))
+                errors.push(`${path}.${key} is required.`);
+        }
+        for (const [key, item] of Object.entries(value)) {
+            const property = schema.properties && Object.hasOwn(schema.properties, key) ? schema.properties[key] : undefined;
+            if (property)
+                errors.push(...validateAgentToolInput(property, item, `${path}.${key}`));
+            else if (schema.additionalProperties === false)
+                errors.push(`${path}.${key} is not allowed.`);
         }
     }
     return errors;