@nxisai/agent-harness 0.4.1 → 0.6.0

package/dist/harness/tools/discovery.d.ts

@@ -8,7 +8,18 @@
  *
  * @module
  */
-import type { McpServerInfo } from '../../types.js';
+import type { CatalogEntry, CatalogFile, McpServerInfo } from '../../types.js';
+/**
+ * The catalog entry for the MCP server card.
+ *
+ * A catalog can list more than the MCP server: an A2A Agent Card for a
+ * handoff target, say. An entry typed as an MCP server card wins; an entry
+ * typed as anything else is never taken for one; an untyped entry is taken
+ * only when nothing is typed, as older catalogs have no types at all.
+ *
+ * @returns The entry, or undefined when the catalog lists no MCP server.
+ */
+export declare function mcpCatalogEntry(catalog: CatalogFile): CatalogEntry | undefined;
 /** Discover the remote MCP server: card URL → endpoint, auth, public tools. */
 export declare function discoverMcpServer(): Promise<McpServerInfo>;
 //# sourceMappingURL=discovery.d.ts.map

package/dist/harness/tools/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAe,aAAa,EAAc,MAAM,gBAAgB,CAAC;AAuB7E,+EAA+E;AAC/E,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC,CAoBhE"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAc,MAAM,gBAAgB,CAAC;AAQ3F;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,GAAG,SAAS,CAM9E;AAiBD,+EAA+E;AAC/E,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC,CAoBhE"}

package/dist/harness/tools/discovery.js

@@ -4,13 +4,31 @@ async function fetchJson(url) {
         throw new Error(`GET ${url} → ${res.status}`);
     return (await res.json());
 }
+/**
+ * The catalog entry for the MCP server card.
+ *
+ * A catalog can list more than the MCP server: an A2A Agent Card for a
+ * handoff target, say. An entry typed as an MCP server card wins; an entry
+ * typed as anything else is never taken for one; an untyped entry is taken
+ * only when nothing is typed, as older catalogs have no types at all.
+ *
+ * @returns The entry, or undefined when the catalog lists no MCP server.
+ */
+export function mcpCatalogEntry(catalog) {
+    const entries = (catalog.entries ?? []).filter((e) => !!e.url);
+    const typeOf = (e) => (e.type ?? e.mediaType ?? '').toLowerCase();
+    const typed = entries.find((e) => /\bmcp\b|mcp-server/.test(typeOf(e)));
+    if (typed)
+        return typed;
+    return entries.find((e) => !typeOf(e));
+}
 /** Find the server-card URL by reading the well-known catalogs in order. */
 async function resolveServerCardUrl() {
     const catalogs = ['/.well-known/ai-catalog.json', '/.well-known/mcp/catalog.json'];
     for (const path of catalogs) {
         try {
             const catalog = await fetchJson(path);
-            const entry = catalog.entries?.find((e) => !!e.url);
+            const entry = mcpCatalogEntry(catalog);
             if (entry?.url)
                 return entry.url;
         }

package/dist/harness/tools/discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/harness/tools/discovery.ts"],"names":[],"mappings":"AAYA,KAAK,UAAU,SAAS,CAAI,GAAW;IACrC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC1E,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;AACjC,CAAC;AAED,4EAA4E;AAC5E,KAAK,UAAU,oBAAoB;IACjC,MAAM,QAAQ,GAAG,CAAC,8BAA8B,EAAE,+BAA+B,CAAC,CAAC;IACnF,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,SAAS,CAAc,IAAI,CAAC,CAAC;YACnD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACpD,IAAI,KAAK,EAAE,GAAG;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;AAC1E,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,OAAO,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,SAAS,CAAa,OAAO,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5F,IAAI,CAAC,MAAM,EAAE,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,6BAA6B,CAAC,CAAC;IAE1F,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC9B,MAAM,WAAW,GAAI,IAAI,CAAC,qBAAqB,CAA0B,IAAI,EAAE,CAAC;IAEhF,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,GAAG;QACpB,cAAc,EAAE,UAAU,EAAE,IAAI;QAChC,YAAY,EAAE,UAAU,EAAE,UAAU,IAAI,KAAK;QAC7C,WAAW;QACX,gBAAgB,EAAE,MAAM,CAAC,yBAAyB,IAAI,EAAE;QACxD,OAAO;QACP,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/harness/tools/discovery.ts"],"names":[],"mappings":"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"}

package/dist/harness/tools/local-context.d.ts

@@ -1,21 +1,44 @@
 /**
- * A minimal WebMCP registry, for pages that have none of their own.
+ * A WebMCP registry for pages that have none of their own.
  *
- * `document.modelContext` is normally installed by a page script or a browser
- * extension. Where neither is present, discovered remote tools would have
+ * `document.modelContext` is normally installed by the browser, a page script
+ * or an extension. Where none is present, discovered remote tools would have
  * nowhere to be registered, and a site with a working MCP server would still
  * offer the agent no tools.
  *
- * Implements only register, list and execute. It does not expose the page's own
- * forms, which come from the page's own script.
+ * '''It is built to the WebMCP spec''' (https://webmachinelearning.github.io/webmcp/),
+ * step for step, as `@nxisai/webmcp` is, and `npm run conformance` there checks
+ * both against it. A registry kinder than the spec lets code pass every test
+ * here and fail in a browser that follows it — which is how an answer in words
+ * once reached visitors as an empty "No results found." card. In short:
+ *
+ * - `registerTool` never throws; every failure rejects. A missing `name`,
+ *   `description` or `execute`, or an `inputSchema` that is not an object, is a
+ *   `TypeError`; a duplicate name, one outside 1–128 of `[A-Za-z0-9_.-]`, or an
+ *   empty description is an `InvalidStateError`. It resolves after `toolchange`.
+ * - `getTools` lists tools sorted by name, with `title` (`""` when absent),
+ *   `origin` and `window`; `inputSchema` and `annotations` only when given, the
+ *   annotations as the spec's four hints.
+ * - `executeTool` takes a tool as `getTools` reports it and an input object —
+ *   required. The tool gets a copy of the input through JSON, and `{ signal }`.
+ *   The result comes back serialized as JSON, so a string arrives quoted; a
+ *   tool that throws, or returns what JSON cannot hold (`undefined`), rejects
+ *   with `UnknownError`. Input is not checked against the schema.
+ * - `toolactivated` fires as a tool starts, `toolcancel` when a caller aborts it.
+ *
+ * Browsers are not there yet: Chrome 155 returns strings unquoted, `"undefined"`
+ * for nothing, accepts an omitted input and fires neither new event; Chrome 153
+ * wants the input as a JSON string. {@link executeRegistered} and
+ * {@link asResponse} take all of them.
  *
  * @module
  */
 import type { ModelContext, ModelContextTool, ModelContextToolInfo, ModelContextToolResponse } from '../../types.js';
 /** Set on the instance so a later, real provider can be told apart from ours. */
 export declare const LOCAL_CONTEXT_FLAG = "__nxisLocalModelContext";
+type Handler = ((event: Event) => unknown) | null;
 /**
- * A minimal in-memory tool registry implementing {@link ModelContext}.
+ * An in-memory tool registry built to the WebMCP spec.
  *
  * Installed by {@link ensureModelContext} on pages that have no registry of
  * their own, so that discovered remote tools have somewhere to live.
@@ -23,9 +46,25 @@ export declare const LOCAL_CONTEXT_FLAG = "__nxisLocalModelContext";
 export declare class LocalModelContext extends EventTarget implements ModelContext {
     readonly [LOCAL_CONTEXT_FLAG] = true;
     private readonly _tools;
-    registerTool(tool: ModelContextTool): void;
-    getTools(): Promise<ModelContextToolInfo[]>;
-    executeTool(nameOrTool: string | object, input?: string | Record<string, unknown> | null): Promise<ModelContextToolResponse>;
+    private readonly _pending;
+    private readonly _handlers;
+    private readonly _listeners;
+    get ontoolchange(): Handler;
+    set ontoolchange(handler: Handler);
+    get ontoolactivated(): Handler;
+    set ontoolactivated(handler: Handler);
+    get ontoolcancel(): Handler;
+    set ontoolcancel(handler: Handler);
+    registerTool(tool: ModelContextTool, options?: unknown): Promise<void>;
+    getTools(options?: unknown): Promise<ModelContextToolInfo[]>;
+    executeTool(tool: string | object, inputObject?: unknown, options?: unknown): Promise<ModelContextToolResponse>;
+    /** The spec's tool execute steps, then its imperative execute steps. */
+    private _runTool;
+    /** The spec's "cancel a pending tool execution". */
+    private _cancel;
+    private _notifyToolChange;
+    /** An event handler attribute: one listener, kept in its place however often the handler changes. */
+    private _setHandler;
 }
 /**
  * Install a {@link LocalModelContext} on `document` if the page has no registry.
@@ -35,4 +74,5 @@ export declare class LocalModelContext extends EventTarget implements ModelConte
  * @returns The page's registry, whether pre-existing or newly installed.
  */
 export declare function ensureModelContext(): ModelContext;
+export {};
 //# sourceMappingURL=local-context.d.ts.map

package/dist/harness/tools/local-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-context.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/local-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,gBAAgB,CAAC;AAExB,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAE5D;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,WAAY,YAAW,YAAY;IACxE,QAAQ,CAAC,CAAC,kBAAkB,CAAC,QAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAE9D,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAM1C,QAAQ,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAWrC,WAAW,CACf,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC9C,OAAO,CAAC,wBAAwB,CAAC;CAUrC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAMjD"}
+{"version":3,"file":"local-context.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/local-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,gBAAgB,CAAC;AAExB,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAmH5D,KAAK,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;AAYlD;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,WAAY,YAAW,YAAY;IACxE,QAAQ,CAAC,CAAC,kBAAkB,CAAC,QAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;IAEhE,IAAI,YAAY,IAAI,OAAO,CAE1B;IACD,IAAI,YAAY,CAAC,OAAO,EAAE,OAAO,EAEhC;IACD,IAAI,eAAe,IAAI,OAAO,CAE7B;IACD,IAAI,eAAe,CAAC,OAAO,EAAE,OAAO,EAEnC;IACD,IAAI,YAAY,IAAI,OAAO,CAE1B;IACD,IAAI,YAAY,CAAC,OAAO,EAAE,OAAO,EAEhC;IAED,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,GAAE,OAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA4E1E,QAAQ,CAAC,OAAO,GAAE,OAAY,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA4BhE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,OAAY,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAmFnH,wEAAwE;IACxE,OAAO,CAAC,QAAQ;IA0ChB,oDAAoD;IACpD,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,iBAAiB;IAIzB,qGAAqG;IACrG,OAAO,CAAC,WAAW;CAcpB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAMjD"}

package/dist/harness/tools/local-context.js

@@ -1,8 +1,101 @@
 var _a;
 /** Set on the instance so a later, real provider can be told apart from ours. */
 export const LOCAL_CONTEXT_FLAG = '__nxisLocalModelContext';
+const TOOL_NAME = /^[A-Za-z0-9_.-]{1,128}$/;
+function domException(message, name) {
+    if (typeof DOMException === 'function')
+        return new DOMException(message, name);
+    return Object.assign(new Error(message), { name });
+}
+/** "Queue a global task": after the current task and its microtasks. */
+const queueTask = (steps) => void setTimeout(steps, 0);
+const isObject = (value) => (typeof value === 'object' && value !== null) || typeof value === 'function';
+/** `JSON.stringify`, with a `TypeError` where it yields nothing, as Infra's serializer has it. */
+function serializeJSON(value) {
+    const json = JSON.stringify(value);
+    if (json === undefined)
+        throw new TypeError('The value cannot be serialized as JSON.');
+    return json;
+}
+function dictionary(value, type) {
+    if (value === undefined || value === null)
+        return {};
+    if (!isObject(value))
+        throw new TypeError(`The provided value is not of type '${type}'.`);
+    return value;
+}
+function required(dict, member, type) {
+    if (dict[member] === undefined) {
+        throw new TypeError(`Failed to read the '${member}' property from '${type}': Required member is undefined.`);
+    }
+    return dict[member];
+}
+function toHints(value) {
+    const dict = dictionary(value, 'ToolAnnotations');
+    const hint = (key) => (dict[key] === undefined ? false : Boolean(dict[key]));
+    return {
+        consequentialHint: hint('consequentialHint'),
+        debugging: hint('debugging'),
+        readOnlyHint: hint('readOnlyHint'),
+        untrustedContentHint: hint('untrustedContentHint'),
+    };
+}
+function toSignal(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof AbortSignal === 'function' && !(value instanceof AbortSignal)) {
+        throw new TypeError("Failed to read the 'signal' property: The provided value is not of type 'AbortSignal'.");
+    }
+    return value;
+}
+const ownWindow = () => (typeof window !== 'undefined' ? window : globalThis);
+const isWindow = (value) => typeof window === 'undefined' ? value === globalThis : isObject(value) && value.window === value;
+/** Outside a browser `http://localhost` stands in: an opaque origin would refuse every call. */
+const ownOrigin = () => (typeof location !== 'undefined' ? location.origin : 'http://localhost');
+function isTrustworthy(url) {
+    if (url.origin === 'null')
+        return false;
+    if (url.protocol === 'https:' || url.protocol === 'wss:')
+        return true;
+    const host = url.hostname;
+    return host === 'localhost' || host.endsWith('.localhost') || /^127(?:\.\d{1,3}){3}$/.test(host) || host === '[::1]';
+}
+/** `SecurityError` for an origin that doesn't parse or isn't potentially trustworthy. */
+function checkOrigins(origins, member) {
+    if (origins === undefined)
+        return;
+    if (!isObject(origins) || typeof origins[Symbol.iterator] !== 'function') {
+        throw new TypeError(`Failed to read the '${member}' property: The provided value cannot be converted to a sequence.`);
+    }
+    for (const origin of origins) {
+        let url;
+        try {
+            url = new URL(`${origin}`);
+        }
+        catch {
+            throw domException(`"${origin}" is not a valid origin.`, 'SecurityError');
+        }
+        if (!isTrustworthy(url))
+            throw domException(`"${origin}" is not a potentially trustworthy origin.`, 'SecurityError');
+    }
+}
+/** The spec's opening checks: an origin-keyed agent cluster, unless the page is a `file:` one. */
+function accessError() {
+    const keyed = globalThis.originAgentCluster;
+    const scheme = typeof location !== 'undefined' ? location.protocol : '';
+    return keyed === false && scheme !== 'file:'
+        ? domException("This page's agent cluster is not origin-keyed.", 'SecurityError')
+        : null;
+}
+/** An event carrying the name of the tool it concerns: `toolactivated`, `toolcancel`. */
+class ToolEvent extends Event {
+    constructor(type, toolName) {
+        super(type);
+        this.toolName = toolName;
+    }
+}
 /**
- * A minimal in-memory tool registry implementing {@link ModelContext}.
+ * An in-memory tool registry built to the WebMCP spec.
  *
  * Installed by {@link ensureModelContext} on pages that have no registry of
  * their own, so that discovered remote tools have somewhere to live.
@@ -12,28 +105,290 @@ export class LocalModelContext extends EventTarget {
         super(...arguments);
         this[_a] = true;
         this._tools = new Map();
+        this._pending = new Map();
+        this._handlers = {};
+        this._listeners = {};
+    }
+    get ontoolchange() {
+        return this._handlers.toolchange ?? null;
+    }
+    set ontoolchange(handler) {
+        this._setHandler('toolchange', handler);
+    }
+    get ontoolactivated() {
+        return this._handlers.toolactivated ?? null;
+    }
+    set ontoolactivated(handler) {
+        this._setHandler('toolactivated', handler);
+    }
+    get ontoolcancel() {
+        return this._handlers.toolcancel ?? null;
+    }
+    set ontoolcancel(handler) {
+        this._setHandler('toolcancel', handler);
+    }
+    registerTool(tool, options = {}) {
+        const type = 'ModelContextTool';
+        let definition;
+        let signal;
+        let schema;
+        let exposedTo;
+        try {
+            // Members in lexicographic order, as WebIDL converts a dictionary.
+            const dict = dictionary(tool, type);
+            const annotations = dict.annotations === undefined ? null : toHints(dict.annotations);
+            const description = `${required(dict, 'description', type)}`;
+            const execute = required(dict, 'execute', type);
+            if (typeof execute !== 'function') {
+                throw new TypeError(`Failed to read the 'execute' property from '${type}': The provided value is not a function.`);
+            }
+            schema = dict.inputSchema;
+            if (schema !== undefined && !isObject(schema)) {
+                throw new TypeError(`Failed to read the 'inputSchema' property from '${type}': The provided value is not of type 'object'.`);
+            }
+            const name = `${required(dict, 'name', type)}`;
+            const title = dict.title === undefined ? null : `${dict.title}`;
+            definition = { name, title, description, inputSchema: '', annotations, execute: execute };
+            const opts = dictionary(options, 'ModelContextRegisterToolOptions');
+            exposedTo = opts.exposedTo;
+            signal = toSignal(opts.signal);
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        const denied = accessError();
+        if (denied)
+            return Promise.reject(denied);
+        const { name } = definition;
+        if (this._tools.has(name)) {
+            return Promise.reject(domException(`A tool named "${name}" is already registered.`, 'InvalidStateError'));
+        }
+        if (!TOOL_NAME.test(name)) {
+            return Promise.reject(domException(`"${name}" is not a valid tool name: 1 to 128 ASCII letters, digits, "_", "-" or ".".`, 'InvalidStateError'));
+        }
+        if (definition.description === '') {
+            return Promise.reject(domException("A tool's description must not be empty.", 'InvalidStateError'));
+        }
+        if (schema !== undefined) {
+            try {
+                definition.inputSchema = serializeJSON(schema);
+            }
+            catch (error) {
+                return Promise.reject(error);
+            }
+        }
+        if (signal?.aborted)
+            return Promise.reject(signal.reason);
+        try {
+            checkOrigins(exposedTo, 'exposedTo');
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        let settle;
+        const promise = new Promise((resolve, reject) => (settle = { resolve, reject }));
+        if (signal) {
+            const s = signal;
+            s.addEventListener('abort', () => {
+                if (this._tools.delete(name))
+                    this._notifyToolChange();
+                settle.reject(s.reason);
+            }, { once: true });
+        }
+        this._tools.set(name, definition);
+        this._notifyToolChange();
+        queueTask(() => settle.resolve());
+        return promise;
+    }
+    getTools(options = {}) {
+        try {
+            checkOrigins(dictionary(options, 'ModelContextGetToolOptions').fromOrigins, 'fromOrigins');
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        const denied = accessError();
+        if (denied)
+            return Promise.reject(denied);
+        return new Promise((resolve) => {
+            const origin = ownOrigin();
+            const win = ownWindow();
+            const tools = [...this._tools.values()].map((t) => {
+                // Members in lexicographic order, as WebIDL creates a dictionary; absent ones are left out.
+                const info = {};
+                if (t.annotations)
+                    info.annotations = { ...t.annotations };
+                info.description = t.description;
+                if (t.inputSchema !== '')
+                    info.inputSchema = JSON.parse(t.inputSchema);
+                info.name = t.name;
+                info.origin = origin;
+                info.title = t.title ?? '';
+                info.window = win;
+                return info;
+            });
+            tools.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+            queueTask(() => resolve(tools));
+        });
     }
-    registerTool(tool) {
-        this._tools.set(tool.name, tool);
-        // Tool discovery listens for this rather than polling to its timeout.
-        this.dispatchEvent(new Event('toolchange'));
-    }
-    getTools() {
-        return Promise.resolve([...this._tools.values()].map((t) => ({
-            name: t.name,
-            description: t.description,
-            inputSchema: t.inputSchema,
-            annotations: t.annotations,
-        })));
-    }
-    async executeTool(nameOrTool, input) {
-        const name = typeof nameOrTool === 'string' ? nameOrTool : nameOrTool.name;
-        const tool = this._tools.get(name);
-        if (!tool) {
-            return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
-        }
-        const args = typeof input === 'string' ? JSON.parse(input || '{}') : input ?? {};
-        return tool.execute(args);
+    executeTool(tool, inputObject, options = {}) {
+        const type = 'RegisteredTool';
+        let name;
+        let origin;
+        let win;
+        let signal;
+        try {
+            const dict = dictionary(tool, type);
+            if (dict.annotations !== undefined)
+                toHints(dict.annotations);
+            required(dict, 'description', type);
+            if (dict.inputSchema !== undefined && !isObject(dict.inputSchema)) {
+                throw new TypeError(`Failed to read the 'inputSchema' property from '${type}': The provided value is not of type 'object'.`);
+            }
+            name = `${required(dict, 'name', type)}`;
+            origin = `${required(dict, 'origin', type)}`;
+            win = required(dict, 'window', type);
+            if (!isWindow(win)) {
+                throw new TypeError(`Failed to read the 'window' property from '${type}': The provided value is not of type 'Window'.`);
+            }
+            signal = toSignal(dictionary(options, 'ModelContextExecuteToolOptions').signal);
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        const denied = accessError();
+        if (denied)
+            return Promise.reject(denied);
+        let expectedOrigin;
+        try {
+            expectedOrigin = new URL(origin).origin;
+        }
+        catch {
+            return Promise.reject(domException(`"${origin}" is not a valid origin.`, 'NotSupportedError'));
+        }
+        if (expectedOrigin === 'null')
+            return Promise.reject(domException("A tool's origin must not be opaque.", 'NotSupportedError'));
+        if (!isObject(inputObject)) {
+            return Promise.reject(new TypeError("Failed to execute 'executeTool' on 'ModelContext': The input is not an object."));
+        }
+        let inputArguments;
+        try {
+            inputArguments = serializeJSON(inputObject);
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+        let settle;
+        const promise = new Promise((resolve, reject) => (settle = { resolve, reject }));
+        const uuid = Symbol('tool execution');
+        if (signal) {
+            if (signal.aborted)
+                return Promise.reject(signal.reason);
+            const s = signal;
+            s.addEventListener('abort', () => {
+                settle.reject(s.reason);
+                queueTask(() => this._cancel(uuid));
+            }, { once: true });
+        }
+        const fail = () => queueTask(() => settle.reject(domException('The tool could not be executed.', 'UnknownError')));
+        queueTask(() => {
+            if (win !== ownWindow() || ownOrigin() !== expectedOrigin || !this._tools.has(name))
+                return fail();
+            const execution = {
+                toolName: name,
+                controller: new AbortController(),
+                started: false,
+                complete: (result, success) => {
+                    if (!this._pending.delete(uuid))
+                        return;
+                    queueTask(() => success
+                        ? settle.resolve(result)
+                        : settle.reject(domException("The tool's execution failed.", 'UnknownError')));
+                },
+            };
+            this._pending.set(uuid, execution);
+            queueTask(() => this._runTool(name, inputArguments, execution));
+        });
+        // A string, as the spec resolves it. Typed as a response for the callers that read it through
+        // `asResponse` in webmcp.ts.
+        return promise;
+    }
+    /** The spec's tool execute steps, then its imperative execute steps. */
+    _runTool(name, inputArguments, execution) {
+        const definition = this._tools.get(name);
+        if (!definition)
+            return execution.complete(null, false);
+        let input;
+        try {
+            input = JSON.parse(inputArguments);
+        }
+        catch {
+            return execution.complete(null, false);
+        }
+        if (!isObject(input))
+            return execution.complete(null, false);
+        this.dispatchEvent(new ToolEvent('toolactivated', name));
+        execution.started = true;
+        let toolPromise;
+        try {
+            // A WebIDL callback: `this` undefined, and a synchronous throw is a rejection.
+            toolPromise = Promise.resolve(definition.execute.call(undefined, input, { signal: execution.controller.signal }));
+        }
+        catch (error) {
+            toolPromise = Promise.reject(error);
+        }
+        toolPromise.then((value) => {
+            if (!execution.started)
+                return; // cancelled before the tool settled
+            execution.started = false;
+            let serialized;
+            try {
+                serialized = serializeJSON(value);
+            }
+            catch {
+                return execution.complete(null, false);
+            }
+            execution.complete(serialized, true);
+        }, () => {
+            if (!execution.started)
+                return;
+            execution.started = false;
+            execution.complete(null, false);
+        });
+    }
+    /** The spec's "cancel a pending tool execution". */
+    _cancel(uuid) {
+        const execution = this._pending.get(uuid);
+        if (!execution)
+            return;
+        this._pending.delete(uuid);
+        queueTask(() => {
+            if (!execution.started)
+                return;
+            execution.started = false;
+            execution.controller.abort();
+            this.dispatchEvent(new ToolEvent('toolcancel', execution.toolName));
+        });
+    }
+    _notifyToolChange() {
+        queueTask(() => this.dispatchEvent(new Event('toolchange')));
+    }
+    /** An event handler attribute: one listener, kept in its place however often the handler changes. */
+    _setHandler(type, handler) {
+        const value = typeof handler === 'function' ? handler : null;
+        this._handlers[type] = value;
+        if (value && !this._listeners[type]) {
+            const listener = (event) => {
+                if (this._handlers[type]?.call(this, event) === false)
+                    event.preventDefault();
+            };
+            this._listeners[type] = listener;
+            this.addEventListener(type, listener);
+        }
+        else if (!value && this._listeners[type]) {
+            this.removeEventListener(type, this._listeners[type]);
+            delete this._listeners[type];
+        }
     }
 }
 _a = LOCAL_CONTEXT_FLAG;

package/dist/harness/tools/local-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-context.js","sourceRoot":"","sources":["../../../src/harness/tools/local-context.ts"],"names":[],"mappings":";AAoBA,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAAlD;;QACW,QAAoB,GAAG,IAAI,CAAC;QACpB,WAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IAgChE,CAAC;IA9BC,YAAY,CAAC,IAAsB;QACjC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,sEAAsE;QACtE,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,QAAQ;QACN,OAAO,OAAO,CAAC,OAAO,CACpB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CACf,UAA2B,EAC3B,KAA+C;QAE/C,MAAM,IAAI,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAE,UAA+B,CAAC,IAAI,CAAC;QACjG,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACvF,CAAC;QACD,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAA6B,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACnG,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF;KAjCW,kBAAkB;AAmC9B;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,IAAI,SAAS,CAAC,YAAY,IAAI,IAAI,CAAC;IACzE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,GAAG,KAAK,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"local-context.js","sourceRoot":"","sources":["../../../src/harness/tools/local-context.ts"],"names":[],"mappings":"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"}

package/dist/harness/tools/open-page.d.ts

@@ -1,4 +1,5 @@
 import { type SitePage } from './site-pages.js';
+import { type SiteNav } from './site-nav.js';
 import type { ModelContext, ModelContextTool, ModelContextToolInfo } from '../../types.js';
 /** The tool's registered name. */
 export declare const OPEN_PAGE_TOOL = "open_page";
@@ -18,6 +19,21 @@ export interface OpenPageOptions {
     referrer?: () => string;
     /** The conversation to continue on arrival. Read when the tool runs. */
     conversationId?: () => string | undefined;
+    /**
+     * The site's graph, from its breadcrumb trails and page links.
+     *
+     * What makes "up a level" and "the section above" mean something, and what
+     * keeps the tool's list of destinations to the pages near this one rather
+     * than every page on the site.
+     */
+    nav?: SiteNav;
+    /**
+     * Fetch the trails the graph is missing, if they have not been fetched yet.
+     *
+     * Awaited when the tool runs, not at connect: the fetch is a read, and a
+     * site's rate limit counts reads. Going somewhere is what makes it worth one.
+     */
+    loadNav?: () => Promise<SiteNav>;
 }
 /** Where a request to open a page resolves: a page, and whether it is reached by going back. */
 export type Destination = {