@nxisai/agent-harness 0.2.0

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

@@ -0,0 +1,13 @@
+/**
+ * Resolves a site's MCP server from its `.well-known` catalogs.
+ *
+ * Reads `/.well-known/ai-catalog.json` (falling back to `catalog.json`),
+ * follows an entry's URL to the server card, and extracts the Streamable HTTP
+ * endpoint, its auth header, and the tools available without a key.
+ *
+ * @module
+ */
+import type { McpServerInfo } from '../../types.js';
+/** 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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAe,aAAa,EAAc,MAAM,gBAAgB,CAAC;AAuB7E,+EAA+E;AAC/E,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC,CAoBhE"}

package/dist/harness/tools/discovery.js

@@ -0,0 +1,43 @@
+async function fetchJson(url) {
+    const res = await fetch(url, { headers: { Accept: 'application/json' } });
+    if (!res.ok)
+        throw new Error(`GET ${url} → ${res.status}`);
+    return (await res.json());
+}
+/** 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/catalog.json'];
+    for (const path of catalogs) {
+        try {
+            const catalog = await fetchJson(path);
+            const entry = catalog.entries?.find((e) => !!e.url);
+            if (entry?.url)
+                return entry.url;
+        }
+        catch {
+            /* try the next catalog */
+        }
+    }
+    throw new Error('No MCP server-card URL found in .well-known catalogs');
+}
+/** Discover the remote MCP server: card URL → endpoint, auth, public tools. */
+export async function discoverMcpServer() {
+    const cardUrl = await resolveServerCardUrl();
+    const card = await fetchJson(cardUrl);
+    const remote = card.remotes?.find((r) => r.type === 'streamable-http') ?? card.remotes?.[0];
+    if (!remote?.url)
+        throw new Error(`Server card at ${cardUrl} has no remote endpoint URL`);
+    const authHeader = remote.headers?.[0];
+    const meta = card._meta ?? {};
+    const publicTools = meta['ai.nxis/publicTools'] ?? [];
+    return {
+        endpoint: remote.url,
+        authHeaderName: authHeader?.name,
+        authRequired: authHeader?.isRequired ?? false,
+        publicTools,
+        protocolVersions: remote.supportedProtocolVersions ?? [],
+        cardUrl,
+        title: card.title,
+    };
+}
+//# sourceMappingURL=discovery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/harness/tools/discovery.ts"],"names":[],"mappings":"AAWA,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,2BAA2B,CAAC,CAAC;IAC/E,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"}

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

@@ -0,0 +1,38 @@
+/**
+ * A minimal 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
+ * 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.
+ *
+ * @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";
+/**
+ * A minimal in-memory tool registry implementing {@link ModelContext}.
+ *
+ * Installed by {@link ensureModelContext} on pages that have no registry of
+ * their own, so that discovered remote tools have somewhere to live.
+ */
+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>;
+}
+/**
+ * Install a {@link LocalModelContext} on `document` if the page has no registry.
+ *
+ * Never replaces an existing provider, which owns the page's own action tools.
+ *
+ * @returns The page's registry, whether pre-existing or newly installed.
+ */
+export declare function ensureModelContext(): ModelContext;
+//# sourceMappingURL=local-context.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,55 @@
+var _a;
+/** Set on the instance so a later, real provider can be told apart from ours. */
+export const LOCAL_CONTEXT_FLAG = '__nxisLocalModelContext';
+/**
+ * A minimal in-memory tool registry implementing {@link ModelContext}.
+ *
+ * Installed by {@link ensureModelContext} on pages that have no registry of
+ * their own, so that discovered remote tools have somewhere to live.
+ */
+export class LocalModelContext extends EventTarget {
+    constructor() {
+        super(...arguments);
+        this[_a] = true;
+        this._tools = new Map();
+    }
+    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);
+    }
+}
+_a = LOCAL_CONTEXT_FLAG;
+/**
+ * Install a {@link LocalModelContext} on `document` if the page has no registry.
+ *
+ * Never replaces an existing provider, which owns the page's own action tools.
+ *
+ * @returns The page's registry, whether pre-existing or newly installed.
+ */
+export function ensureModelContext() {
+    const existing = document.modelContext ?? navigator.modelContext ?? null;
+    if (existing)
+        return existing;
+    const local = new LocalModelContext();
+    document.modelContext = local;
+    return local;
+}
+//# sourceMappingURL=local-context.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,52 @@
+/**
+ * Reading a tool's JSON Schema, and reconciling model output against it.
+ *
+ * Model-agnostic: these helpers work the same whichever provider produced the
+ * arguments, so they sit with the harness rather than behind
+ * {@link ModelProvider}.
+ *
+ * @module
+ */
+import type { JsonSchema, ModelContextToolInfo, ModelContextToolResponse } from '../../types.js';
+/**
+ * Read a tool's input schema, whichever key and form it arrives in.
+ *
+ * Accepts every alias on {@link ModelContextToolInfo}, parses a schema supplied
+ * as a JSON string, merges in any required fields the page's own markup
+ * declares, and gives every node a `type` so a chat template that formats types
+ * cannot fail on an untyped one.
+ *
+ * @param tool - The tool as reported by discovery.
+ * @returns The normalised schema, or an empty object when there is none.
+ */
+export declare function toolSchema(tool: ModelContextToolInfo): JsonSchema;
+/**
+ * Which of a tool's required fields have no usable value.
+ *
+ * @param tool - The tool whose schema declares the requirements.
+ * @param args - The arguments so far.
+ * @returns Required field names that are absent, null, or blank.
+ */
+export declare function missingRequired(tool: ModelContextToolInfo, args: Record<string, unknown> | undefined): string[];
+/**
+ * Map a model's argument keys onto the schema's real property names.
+ *
+ * Models paraphrase field names. Keys are matched exactly first, then
+ * case- and punctuation-insensitively, then by prefix, then by shared word.
+ * Values matching an enum are snapped to the enum's own casing. A key with no
+ * plausible match is passed through unchanged.
+ *
+ * @param args - The arguments the model supplied.
+ * @param schema - The tool's normalised schema.
+ * @returns The arguments rekeyed to schema property names.
+ */
+export declare function reconcileArgs(args: Record<string, unknown> | undefined, schema: JsonSchema): Record<string, unknown>;
+/**
+ * Flatten a tool response to text.
+ *
+ * @param res - The response, a plain string, or nothing.
+ * @returns The response's text blocks joined, or its JSON form when it carries
+ * no text. Empty for a null or undefined response.
+ */
+export declare function extractResult(res: ModelContextToolResponse | string | null | undefined): string;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,oBAAoB,GAAG,UAAU,CAsBjE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,EAAE,CAM/G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACzC,MAAM,EAAE,UAAU,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCzB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,wBAAwB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAc/F"}

package/dist/harness/tools/schema.js

@@ -0,0 +1,175 @@
+/**
+ * Read a tool's input schema, whichever key and form it arrives in.
+ *
+ * Accepts every alias on {@link ModelContextToolInfo}, parses a schema supplied
+ * as a JSON string, merges in any required fields the page's own markup
+ * declares, and gives every node a `type` so a chat template that formats types
+ * cannot fail on an untyped one.
+ *
+ * @param tool - The tool as reported by discovery.
+ * @returns The normalised schema, or an empty object when there is none.
+ */
+export function toolSchema(tool) {
+    let raw = tool && (tool.inputSchema ?? tool.input_schema ?? tool.parameters ?? tool.schema);
+    if (typeof raw === 'string') {
+        try {
+            raw = JSON.parse(raw);
+        }
+        catch {
+            raw = undefined;
+        }
+    }
+    const schema = raw && typeof raw === 'object' ? raw : {};
+    // The page's own markup is authoritative about what is required: a backend
+    // schema may omit fields the rendered form still demands.
+    const props = schema.properties ? Object.keys(schema.properties) : [];
+    if (props.length) {
+        const domReq = _domRequired(props);
+        if (domReq.length)
+            schema.required = [...new Set([...(schema.required || []), ...domReq])];
+    }
+    // Some schemas declare properties with no `type`. Gemma's tool chat template
+    // applies `| upper` to each parameter type and throws on an undefined one, so
+    // every node is given a type before prompt building.
+    return _normalizeSchema(schema, true);
+}
+/**
+ * Which of a tool's required fields have no usable value.
+ *
+ * @param tool - The tool whose schema declares the requirements.
+ * @param args - The arguments so far.
+ * @returns Required field names that are absent, null, or blank.
+ */
+export function missingRequired(tool, args) {
+    const required = toolSchema(tool).required || [];
+    return required.filter((k) => {
+        const v = args ? args[k] : undefined;
+        return v === undefined || v === null || (typeof v === 'string' && v.trim() === '');
+    });
+}
+/**
+ * Map a model's argument keys onto the schema's real property names.
+ *
+ * Models paraphrase field names. Keys are matched exactly first, then
+ * case- and punctuation-insensitively, then by prefix, then by shared word.
+ * Values matching an enum are snapped to the enum's own casing. A key with no
+ * plausible match is passed through unchanged.
+ *
+ * @param args - The arguments the model supplied.
+ * @param schema - The tool's normalised schema.
+ * @returns The arguments rekeyed to schema property names.
+ */
+export function reconcileArgs(args, schema) {
+    const props = schema && schema.properties ? Object.keys(schema.properties) : [];
+    if (!props.length || !args)
+        return args || {};
+    const norm = (s) => String(s).toLowerCase().replace(/[^a-z0-9]/g, '');
+    const toks = (s) => String(s)
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter(Boolean);
+    const out = {};
+    for (const [key, value] of Object.entries(args)) {
+        if (props.includes(key)) {
+            out[key] = _snapEnum(value, schema.properties[key]);
+            continue;
+        }
+        const nk = norm(key);
+        let best = props.find((p) => norm(p) === nk);
+        if (!best)
+            best = props.find((p) => nk.startsWith(norm(p)) || norm(p).startsWith(nk));
+        if (!best) {
+            const ktoks = new Set(toks(key));
+            let bestScore = 0;
+            for (const p of props) {
+                const score = toks(p).filter((t) => ktoks.has(t)).length;
+                if (score > bestScore) {
+                    bestScore = score;
+                    best = p;
+                }
+            }
+            if (bestScore === 0)
+                best = undefined;
+        }
+        const targetKey = best || key;
+        out[targetKey] = _snapEnum(value, schema.properties[targetKey]);
+    }
+    return out;
+}
+/**
+ * Flatten a tool response to text.
+ *
+ * @param res - The response, a plain string, or nothing.
+ * @returns The response's text blocks joined, or its JSON form when it carries
+ * no text. Empty for a null or undefined response.
+ */
+export function extractResult(res) {
+    if (res == null)
+        return '';
+    if (typeof res === 'string')
+        return res;
+    if (Array.isArray(res.content)) {
+        return res.content
+            .map((c) => (c && c.text) || '')
+            .filter(Boolean)
+            .join('\n');
+    }
+    try {
+        return JSON.stringify(res);
+    }
+    catch {
+        return String(res);
+    }
+}
+// ── internals ───────────────────────────────────────────────────────────────
+/**
+ * Give every schema node a `type`, which the chat template requires.
+ *
+ * Nodes with properties become `object`, nodes with items become `array`, and
+ * remaining leaves become `string`. Mutates and returns the schema.
+ */
+function _normalizeSchema(schema, isRoot = false) {
+    if (!schema || typeof schema !== 'object')
+        return schema;
+    if (schema.properties && typeof schema.properties === 'object') {
+        if (!schema.type)
+            schema.type = 'object';
+        for (const key of Object.keys(schema.properties))
+            _normalizeSchema(schema.properties[key]);
+    }
+    if (schema.items && typeof schema.items === 'object') {
+        if (!schema.type)
+            schema.type = 'array';
+        _normalizeSchema(schema.items);
+    }
+    if (!schema.type)
+        schema.type = isRoot ? 'object' : 'string';
+    if (isRoot && schema.type === 'object' && !schema.properties)
+        schema.properties = {};
+    return schema;
+}
+/** Which of these property names the page's own markup marks required. */
+function _domRequired(propNames) {
+    const out = [];
+    for (const name of propNames) {
+        let el = null;
+        try {
+            el = document.querySelector(`[name="${CSS.escape(name)}"]`);
+        }
+        catch {
+            // Not a usable selector.
+        }
+        if (el && (el.required || el.hasAttribute('data-required')))
+            out.push(name);
+    }
+    return out;
+}
+/** Correct a value's casing to match its schema's enum, when one matches. */
+function _snapEnum(value, propSchema) {
+    const enumVals = propSchema && (propSchema.enum || (propSchema.items && propSchema.items.enum));
+    if (!enumVals || typeof value !== 'string' || enumVals.includes(value))
+        return value;
+    const ci = enumVals.find((e) => String(e).toLowerCase() === value.toLowerCase());
+    return ci !== undefined ? ci : value;
+}
+//# sourceMappingURL=schema.js.map

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * Assembles the page's toolset from both of its sources.
+ *
+ * Tools come from two places: those registered on the page itself, and those
+ * from a remote MCP server discovered through `.well-known` and bridged in.
+ * Both end up in `document.modelContext`, so the harness discovers them with a
+ * single call and treats them alike, distinguishing only read from write via
+ * each tool's annotations.
+ *
+ * {@link connectTools} is awaited rather than run as a load-time side effect,
+ * so a caller knows when the toolset is complete.
+ *
+ * @module
+ */
+import { registerRemoteTools, type BridgeOptions } from './bridge.js';
+import { connectMcp } from './client.js';
+import { discoverMcpServer } from './discovery.js';
+import type { ModelContext } from '../../types.js';
+/** The outcome of {@link connectTools}. */
+export interface ConnectResult {
+    /** The registry the tools were registered into, or null if none was found. */
+    modelContext: ModelContext | null;
+    /** Remote tool names bridged in. Empty when discovery failed or was skipped. */
+    remoteTools: string[];
+    /** Why remote tools are absent, when they are. Never fatal. */
+    warning?: string;
+}
+/**
+ * Wait for a WebMCP provider to appear on the page.
+ *
+ * @param timeout - How long to wait, in milliseconds.
+ * @returns The model context, or null if none appears in time.
+ */
+export declare function waitForModelContext(timeout?: number): Promise<ModelContext | null>;
+/** Options for {@link connectTools}. */
+export interface ConnectOptions {
+    /** How long to wait for a WebMCP provider before falling back. */
+    timeout?: number;
+    /**
+     * Register into a local registry when the page has no WebMCP provider.
+     *
+     * Defaults to true, so a working MCP server still yields tools on a page with
+     * no WebMCP implementation. Pass false to require a real provider.
+     */
+    fallback?: boolean;
+    /** Override which of the server's tools are bridged in. */
+    accept?: BridgeOptions['accept'];
+}
+/**
+ * Wait for a tool registry, then bridge in a remote MCP server's tools.
+ *
+ * Every remote failure is caught and reported as
+ * {@link ConnectResult.warning}: discovery, CORS and network problems leave the
+ * page's own tools working, and a site with no MCP server is an ordinary case
+ * rather than an error.
+ *
+ * @param apiKey - Key for the remote server's private tools. Falls back to
+ * `window.__NXIS_CONFIG__.mcp_api_key`. Public tools need none.
+ * @param opts - Timeout, local-registry fallback, and a tool filter.
+ * @returns The registry, the remote tools bridged in, and any warning.
+ */
+export declare function connectTools(apiKey?: string, opts?: ConnectOptions): Promise<ConnectResult>;
+export { discoverMcpServer, connectMcp, registerRemoteTools };
+export { ensureModelContext, LocalModelContext } from './local-context.js';
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,gFAAgF;IAChF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAOD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,SAAmB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAgB5F;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,aAAa,CAAC,CAyBxB;AAED,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,mBAAmB,EAAE,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/harness/tools/source.js

@@ -0,0 +1,89 @@
+/**
+ * Assembles the page's toolset from both of its sources.
+ *
+ * Tools come from two places: those registered on the page itself, and those
+ * from a remote MCP server discovered through `.well-known` and bridged in.
+ * Both end up in `document.modelContext`, so the harness discovers them with a
+ * single call and treats them alike, distinguishing only read from write via
+ * each tool's annotations.
+ *
+ * {@link connectTools} is awaited rather than run as a load-time side effect,
+ * so a caller knows when the toolset is complete.
+ *
+ * @module
+ */
+import { registerRemoteTools } from './bridge.js';
+import { ensureModelContext } from './local-context.js';
+import { connectMcp } from './client.js';
+import { discoverMcpServer } from './discovery.js';
+const READY_TIMEOUT_MS = 20000;
+const POLL_INTERVAL_MS = 200;
+/** The page's model context, from either of the two places it may appear. */
+function getModelContext() {
+    return document.modelContext ?? navigator.modelContext ?? null;
+}
+/**
+ * Wait for a WebMCP provider to appear on the page.
+ *
+ * @param timeout - How long to wait, in milliseconds.
+ * @returns The model context, or null if none appears in time.
+ */
+export function waitForModelContext(timeout = READY_TIMEOUT_MS) {
+    const immediate = getModelContext();
+    if (immediate)
+        return Promise.resolve(immediate);
+    return new Promise((resolve) => {
+        const started = Date.now();
+        const iv = setInterval(() => {
+            const mc = getModelContext();
+            if (mc) {
+                clearInterval(iv);
+                resolve(mc);
+            }
+            else if (Date.now() - started > timeout) {
+                clearInterval(iv);
+                resolve(null);
+            }
+        }, POLL_INTERVAL_MS);
+    });
+}
+/**
+ * Wait for a tool registry, then bridge in a remote MCP server's tools.
+ *
+ * Every remote failure is caught and reported as
+ * {@link ConnectResult.warning}: discovery, CORS and network problems leave the
+ * page's own tools working, and a site with no MCP server is an ordinary case
+ * rather than an error.
+ *
+ * @param apiKey - Key for the remote server's private tools. Falls back to
+ * `window.__NXIS_CONFIG__.mcp_api_key`. Public tools need none.
+ * @param opts - Timeout, local-registry fallback, and a tool filter.
+ * @returns The registry, the remote tools bridged in, and any warning.
+ */
+export async function connectTools(apiKey, opts = {}) {
+    const waited = await waitForModelContext(opts.timeout ?? READY_TIMEOUT_MS);
+    const mc = waited ?? (opts.fallback === false ? null : ensureModelContext());
+    if (!mc) {
+        return {
+            modelContext: null,
+            remoteTools: [],
+            warning: 'WebMCP (document.modelContext) unavailable — no tools registered.',
+        };
+    }
+    try {
+        const info = await discoverMcpServer();
+        const client = await connectMcp(info, apiKey ?? window.__NXIS_CONFIG__?.mcp_api_key);
+        const remoteTools = await registerRemoteTools(client, mc, info, { accept: opts.accept });
+        return { modelContext: mc, remoteTools };
+    }
+    catch (err) {
+        return {
+            modelContext: mc,
+            remoteTools: [],
+            warning: `remote tool bootstrap failed — on-page tools still work: ${String(err?.message || err)}`,
+        };
+    }
+}
+export { discoverMcpServer, connectMcp, registerRemoteTools };
+export { ensureModelContext, LocalModelContext } from './local-context.js';
+//# sourceMappingURL=source.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/harness/tools/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,mBAAmB,EAAsB,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAC/B,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAY7B,6EAA6E;AAC7E,SAAS,eAAe;IACtB,OAAO,QAAQ,CAAC,YAAY,IAAI,SAAS,CAAC,YAAY,IAAI,IAAI,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAO,GAAG,gBAAgB;IAC5D,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IACpC,IAAI,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE;YAC1B,MAAM,EAAE,GAAG,eAAe,EAAE,CAAC;YAC7B,IAAI,EAAE,EAAE,CAAC;gBACP,aAAa,CAAC,EAAE,CAAC,CAAC;gBAClB,OAAO,CAAC,EAAE,CAAC,CAAC;YACd,CAAC;iBAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,OAAO,EAAE,CAAC;gBAC1C,aAAa,CAAC,EAAE,CAAC,CAAC;gBAClB,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC;AAiBD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAe,EACf,OAAuB,EAAE;IAEzB,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC;IAC3E,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO;YACL,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,EAAE;YACf,OAAO,EAAE,mEAAmE;SAC7E,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,iBAAiB,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,MAAM,IAAI,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;QACrF,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACzF,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,YAAY,EAAE,EAAE;YAChB,WAAW,EAAE,EAAE;YACf,OAAO,EAAE,4DAA4D,MAAM,CACxE,GAAa,EAAE,OAAO,IAAI,GAAG,CAC/B,EAAE;SACJ,CAAC;IACJ,CAAC;AACH,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,mBAAmB,EAAE,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,50 @@
+import type { ModelContext, ModelContextToolInfo, ModelContextToolResponse } from '../../types.js';
+/**
+ * The default tool source, backed by the page's `document.modelContext`.
+ *
+ * Supply an instance as {@link HarnessOptions.toolSource}, or substitute any
+ * object with the same shape to draw tools from somewhere else.
+ */
+export declare class WebMcpTools {
+    /**
+     * The page's model context.
+     *
+     * @returns The context, or null on a page where WebMCP is not present.
+     */
+    modelContext(): ModelContext | null;
+    /**
+     * Wait for tools to appear on a model context.
+     *
+     * Tools register asynchronously, so a context can be present but empty for a
+     * short time after page load. Polls, and also listens for `toolchange`.
+     *
+     * @param mc - The context to watch.
+     * @param signal - Abort to stop waiting early. Resolves empty when aborted.
+     * @returns The registered tools, or an empty array if none appear within
+     * {@link TOOLS_TIMEOUT_MS}.
+     */
+    waitForTools(mc: ModelContext, signal?: AbortSignal): Promise<ModelContextToolInfo[]>;
+    /**
+     * Every tool registered on the page.
+     *
+     * @param signal - Abort to stop waiting for tools to appear.
+     * @returns The registered tools, or an empty array when WebMCP is absent,
+     * discovery fails, or the wait is aborted.
+     */
+    discoverTools(signal?: AbortSignal): Promise<ModelContextToolInfo[]>;
+    /**
+     * Call a tool.
+     *
+     * Handles both the native calling convention (a registered tool object and a
+     * JSON string) and the polyfill's (a name and an object), trying the native
+     * form first and falling back when the context rejects it.
+     *
+     * @param toolObj - The tool as reported by discovery, or null to call by name.
+     * @param name - The tool's name, used for the fallback call.
+     * @param args - The arguments to send.
+     * @returns The tool's response.
+     * @throws If WebMCP is not available, or the tool itself throws.
+     */
+    execTool(toolObj: ModelContextToolInfo | null, name: string, args: Record<string, unknown>): Promise<ModelContextToolResponse>;
+}
+//# sourceMappingURL=webmcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/webmcp.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,qBAAa,WAAW;IACtB;;;;OAIG;IACH,YAAY,IAAI,YAAY,GAAG,IAAI;IAInC;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA2BrF;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAU1E;;;;;;;;;;;;OAYG;IACG,QAAQ,CACZ,OAAO,EAAE,oBAAoB,GAAG,IAAI,EACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,wBAAwB,CAAC;CAcrC"}