@nxisai/agent-harness 0.2.0

package/dist/harness/tools/webmcp.js

@@ -0,0 +1,114 @@
+/**
+ * Tool discovery and execution over WebMCP.
+ *
+ * Discovery and execution work the same way whichever model is answering, so
+ * they sit with the harness rather than behind {@link ModelProvider}.
+ *
+ * @module
+ */
+import { TOOLS_TIMEOUT_MS } from '../../engine.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 class WebMcpTools {
+    /**
+     * The page's model context.
+     *
+     * @returns The context, or null on a page where WebMCP is not present.
+     */
+    modelContext() {
+        return document.modelContext || navigator.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, signal) {
+        return new Promise((resolve) => {
+            let done = false;
+            const finish = async (tools) => {
+                if (done)
+                    return;
+                done = true;
+                clearInterval(iv);
+                clearTimeout(to);
+                mc.removeEventListener('toolchange', onChange);
+                signal?.removeEventListener('abort', onAbort);
+                resolve(tools || (await mc.getTools()));
+            };
+            const onAbort = () => finish([]);
+            if (signal?.aborted)
+                return finish([]);
+            signal?.addEventListener('abort', onAbort, { once: true });
+            const check = async () => {
+                const tools = await mc.getTools();
+                if (tools && tools.length)
+                    finish(tools);
+            };
+            const onChange = () => check();
+            mc.addEventListener('toolchange', onChange);
+            const iv = setInterval(check, 800);
+            const to = setTimeout(() => finish(), TOOLS_TIMEOUT_MS);
+            check();
+        });
+    }
+    /**
+     * 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.
+     */
+    async discoverTools(signal) {
+        const mc = this.modelContext();
+        if (!mc)
+            return [];
+        try {
+            return await this.waitForTools(mc, signal);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * 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.
+     */
+    async execTool(toolObj, name, args) {
+        const mc = this.modelContext();
+        if (!mc)
+            throw new Error('WebMCP is not available on this page.');
+        const json = JSON.stringify(args ?? {});
+        if (toolObj) {
+            try {
+                return await mc.executeTool(toolObj, json);
+            }
+            catch (e) {
+                const msg = String(e?.message || e);
+                if (!/RegisteredTool|not of type|No tool registered|NotFound/i.test(msg))
+                    throw e;
+            }
+        }
+        return await mc.executeTool(name, args);
+    }
+}
+//# sourceMappingURL=webmcp.js.map

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

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

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Headless entry point for `@nxisai/agent-harness`.
+ *
+ * Everything exported here runs without a UI. For the packaged chat element,
+ * import `@nxisai/agent-harness/ui`; to keep this decision logic behind an
+ * interface of your own, implement {@link HarnessRenderer}.
+ *
+ * @example
+ * ```ts
+ * import { AgentHarness } from '@nxisai/agent-harness';
+ *
+ * const harness = new AgentHarness({ renderer });
+ * await harness.turn('book me in for Thursday', messages);
+ * ```
+ *
+ * @module
+ */
+export { AgentHarness } from './harness/harness.js';
+export { LocalGemmaProvider, AgentEngine } from './engine.js';
+export type { ModelProvider, CompletionRequest, Completion, CacheHint, } from './providers/types.js';
+export { WebMcpTools } from './harness/tools/webmcp.js';
+export { toolSchema, missingRequired, reconcileArgs, extractResult, } from './harness/tools/schema.js';
+export type { HarnessOptions, TurnResult } from './harness/harness.js';
+export { policyFor, decide } from './harness/policy.js';
+export type { ToolPolicy, Decision } from './harness/policy.js';
+export { resolveSlots, summarySlots } from './harness/slots.js';
+export type { Slot, Resolution, ResolveSources } from './harness/slots.js';
+export { buildPlan } from './harness/plan.js';
+export { AgentCoordinator } from './harness/router/coordinator.js';
+export type { CoordinatorOptions, RoutedTurn, RouteSource } from './harness/router/coordinator.js';
+export { matchRoute } from './harness/router/rules.js';
+export type { RouteRule, RouteDecision } from './harness/router/rules.js';
+export type { ClarificationPlan, PlanStep } from './harness/plan.js';
+export type { HarnessRenderer, AskRequest, ConfirmRequest, StreamingBubble, } from './harness/renderer.js';
+export { parseToolCall, stripMarkers, humanize, lcFirst, escapeHtml, MODEL_ID, MODEL_HOST, MODEL_PATH_TEMPLATE, SYSTEM_PROMPT, MAX_STEPS, MAX_NEW_TOKENS, TOOLS_TIMEOUT_MS, } from './engine.js';
+/**
+ * Brand marks and icons used by the packaged UI.
+ *
+ * Exported for custom renderers. Inline SVG using `currentColor`, so each icon
+ * takes the surrounding text colour.
+ */
+export { NXIS_LOGO_SVG, ICON_CHECK, ICON_WARN, ICON_ARROW, ICON_PLUS, ICON_MENU, ICON_TRASH, ICON_STOP, ICON_COPY, ICON_PENCIL, ICON_REDO, ICON_CHECK_MARK, } from './engine.js';
+export type { AgentEngineOptions, ChatMessage, ToolDef, GenerationUsage, ParsedToolCall, ProgressDetail, PreloadMode, } from './engine.js';
+export { connectTools, waitForModelContext } from './harness/tools/source.js';
+export type { ConnectResult, ConnectOptions } from './harness/tools/source.js';
+export type { BridgeOptions } from './harness/tools/bridge.js';
+export type { JsonSchema, ModelContext, ModelContextTool, ModelContextToolInfo, ModelContextToolResponse, McpServerInfo, NxisConfig, } from './types.js';
+export type { NxisAction, NxisEntryPoint, NxisPropertyValueSpecification, NxisValueOption, } from './webmcp-contract.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,SAAS,GACV,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACL,UAAU,EACV,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnG,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAErE,YAAY,EACV,eAAe,EACf,UAAU,EACV,cAAc,EACd,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,UAAU,EACV,QAAQ,EACR,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,cAAc,EACd,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,OAAO,EACL,aAAa,EACb,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,OAAO,EACP,eAAe,EACf,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,YAAY,EACV,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,aAAa,EACb,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,UAAU,EACV,cAAc,EACd,8BAA8B,EAC9B,eAAe,GAChB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,38 @@
+/**
+ * Headless entry point for `@nxisai/agent-harness`.
+ *
+ * Everything exported here runs without a UI. For the packaged chat element,
+ * import `@nxisai/agent-harness/ui`; to keep this decision logic behind an
+ * interface of your own, implement {@link HarnessRenderer}.
+ *
+ * @example
+ * ```ts
+ * import { AgentHarness } from '@nxisai/agent-harness';
+ *
+ * const harness = new AgentHarness({ renderer });
+ * await harness.turn('book me in for Thursday', messages);
+ * ```
+ *
+ * @module
+ */
+export { AgentHarness } from './harness/harness.js';
+// ── Model providers ──────────────────────────────────────────────────────────
+export { LocalGemmaProvider, AgentEngine } from './engine.js';
+// ── Tools, as the harness sees them ──────────────────────────────────────────
+export { WebMcpTools } from './harness/tools/webmcp.js';
+export { toolSchema, missingRequired, reconcileArgs, extractResult, } from './harness/tools/schema.js';
+export { policyFor, decide } from './harness/policy.js';
+export { resolveSlots, summarySlots } from './harness/slots.js';
+export { buildPlan } from './harness/plan.js';
+export { AgentCoordinator } from './harness/router/coordinator.js';
+export { matchRoute } from './harness/router/rules.js';
+export { parseToolCall, stripMarkers, humanize, lcFirst, escapeHtml, MODEL_ID, MODEL_HOST, MODEL_PATH_TEMPLATE, SYSTEM_PROMPT, MAX_STEPS, MAX_NEW_TOKENS, TOOLS_TIMEOUT_MS, } from './engine.js';
+/**
+ * Brand marks and icons used by the packaged UI.
+ *
+ * Exported for custom renderers. Inline SVG using `currentColor`, so each icon
+ * takes the surrounding text colour.
+ */
+export { NXIS_LOGO_SVG, ICON_CHECK, ICON_WARN, ICON_ARROW, ICON_PLUS, ICON_MENU, ICON_TRASH, ICON_STOP, ICON_COPY, ICON_PENCIL, ICON_REDO, ICON_CHECK_MARK, } from './engine.js';
+export { connectTools, waitForModelContext } from './harness/tools/source.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,gFAAgF;AAChF,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ9D,gFAAgF;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACL,UAAU,EACV,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGhE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAWvD,OAAO,EACL,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,UAAU,EACV,QAAQ,EACR,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,cAAc,EACd,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,OAAO,EACL,aAAa,EACb,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,eAAe,GAChB,MAAM,aAAa,CAAC;AAWrB,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/providers/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * The model provider interface.
+ *
+ * A provider supplies one completion at a time. Everything else the harness
+ * does (discovering tools, reading their schemas, deciding whether to ask,
+ * confirm or run) is the same whichever model answers.
+ *
+ * Completions are structured rather than plain text: a provider reports a tool
+ * call as {@link Completion.call}, whether its model expresses that as a native
+ * tool-use block or as markers in the text it generates.
+ *
+ * @see The bundled {@link LocalGemmaProvider}, and `docs/remote-providers.md`
+ * for a worked remote implementation.
+ *
+ * @module
+ */
+import type { ChatMessage, GenerationUsage, ModelContextToolInfo, ParsedToolCall, PreloadMode } from '../types.js';
+/**
+ * What the harness knows about which parts of a request will repeat.
+ *
+ * Advisory. The harness caches nothing itself; acting on the hint is a
+ * provider's decision, and only worthwhile where the backend supports prompt
+ * caching. Both fields go false when a handoff between agents changes the
+ * system prompt and the tool set.
+ */
+export interface CacheHint {
+    /** How many leading messages will be identical on the next request. */
+    stableMessages: number;
+    /** Whether the tool definitions are unchanged since the previous request. */
+    toolsStable: boolean;
+}
+/** One request for a completion. */
+export interface CompletionRequest {
+    /** The conversation so far, including the system prompt. */
+    messages: ChatMessage[];
+    /**
+     * The tools available for this turn, as raw WebMCP entries.
+     *
+     * Providers translate these into whatever their model expects.
+     */
+    tools: ModelContextToolInfo[];
+    /** Ceiling on generated tokens. Providers may apply their own default. */
+    maxTokens?: number;
+    /**
+     * Aborts when the user stops the turn, closes the panel, or starts another.
+     *
+     * Honour it: pass it to `fetch`, or interrupt local generation. Rejecting
+     * with an `AbortError` is correct, and the harness treats it as a
+     * cancellation rather than a failure.
+     */
+    signal?: AbortSignal;
+    /**
+     * Called as text arrives, with the whole answer so far rather than the newest
+     * fragment. Optional: a provider that does not stream simply omits it.
+     */
+    onToken?(textSoFar: string): void;
+    /** What the harness knows about reuse. Advisory; see {@link CacheHint}. */
+    cache?: CacheHint;
+}
+/** What a provider returns for one request. */
+export interface Completion {
+    /**
+     * Text to show the user, rendered verbatim. Strip any protocol markers in the
+     * provider: the harness does no parsing of its own.
+     */
+    text: string;
+    /**
+     * The tool the model asked for, if any. At most one per completion; a model
+     * that returns several calls should report the first and drop the rest.
+     */
+    call?: ParsedToolCall;
+    /** Token counts, when the provider can report them. */
+    usage?: GenerationUsage;
+}
+/**
+ * A source of model completions.
+ *
+ * Implement `complete` and the four readonly fields; everything else is
+ * optional. See `docs/remote-providers.md` for a worked example.
+ */
+export interface ModelProvider {
+    /** Identifies the provider in logs and debug output, not to end users. */
+    readonly name: string;
+    /**
+     * Whether inference happens on the user's device.
+     *
+     * Surfaced in the UI, so that a page sending conversations to a remote
+     * service says so.
+     */
+    readonly local: boolean;
+    /** Whether the provider can answer a request right now. */
+    readonly ready: boolean;
+    /** Whether a load is in flight. Always false when there is nothing to load. */
+    readonly loading: boolean;
+    /**
+     * Prepare the model, resolving once it is ready.
+     *
+     * Omit it entirely when there is nothing to prepare: its absence is what
+     * tells the UI to skip the download progress treatment.
+     */
+    load?(): Promise<void>;
+    /**
+     * Begin loading ahead of the first turn.
+     *
+     * @param mode - How eagerly to load, from the element's `preload` attribute.
+     */
+    preload?(mode: Exclude<PreloadMode, 'none'>): void;
+    /**
+     * Produce one completion.
+     *
+     * @param req - The conversation, the available tools, and the abort signal.
+     * @returns The generated text and the tool call it implies, if any.
+     */
+    complete(req: CompletionRequest): Promise<Completion>;
+    /**
+     * Count tokens in a string.
+     *
+     * Optional. A provider that cannot count causes token metrics to be hidden
+     * rather than estimated.
+     */
+    countTokens?(text: string): Promise<number>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB;;;;OAIG;IACH,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,uDAAuD;IACvD,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;OAIG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAEnD;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtD;;;;;OAKG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C"}

package/dist/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Shared types: the WebMCP surface (`document.modelContext`), MCP discovery
+ * (catalogs and server cards), and the model and tool-call shapes.
+ *
+ * @module
+ */
+/** A JSON Schema fragment, as carried by a tool's input schema. */
+export interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    enum?: unknown[];
+    items?: JsonSchema;
+    format?: string;
+    description?: string;
+    default?: unknown;
+    [key: string]: unknown;
+}
+/** Behavioural hints a tool declares about itself. */
+export interface ModelContextToolAnnotations {
+    /** True when calling the tool has no side effects. Drives {@link policyFor}. */
+    readOnlyHint?: boolean;
+    [key: string]: unknown;
+}
+/** One block of a tool response. */
+export interface ModelContextContent {
+    /** The block's kind, commonly `'text'`. */
+    type: string;
+    /** The block's text, when it has one. */
+    text?: string;
+    [key: string]: unknown;
+}
+/** What a tool returns. */
+export interface ModelContextToolResponse {
+    /** The response blocks, in order. */
+    content: ModelContextContent[];
+    /** True when the tool reports a failure. */
+    isError?: boolean;
+    /** A parsed form of the response, preferred over the text when present. */
+    structuredContent?: Record<string, unknown>;
+}
+/**
+ * A tool as reported by `getTools()`.
+ *
+ * Implementations differ over where the schema lives and whether it arrives
+ * parsed or as a JSON string, so several keys are accepted. Use
+ * {@link toolSchema} to read it rather than these fields directly.
+ */
+export interface ModelContextToolInfo {
+    /** The tool's unique name, as used to call it. */
+    name: string;
+    /** What the tool does, shown to the model. */
+    description?: string;
+    /** The input schema. See also the aliases below. */
+    inputSchema?: JsonSchema | string;
+    /** Alias for {@link ModelContextToolInfo.inputSchema}. */
+    input_schema?: JsonSchema | string;
+    /** Alias for {@link ModelContextToolInfo.inputSchema}. */
+    parameters?: JsonSchema | string;
+    /** Alias for {@link ModelContextToolInfo.inputSchema}. */
+    schema?: JsonSchema | string;
+    /** Behavioural hints, notably `readOnlyHint`. */
+    annotations?: ModelContextToolAnnotations;
+    /** Where the tool came from, when the registry records it. */
+    origin?: string;
+}
+/** A tool as passed to `registerTool()`. */
+export interface ModelContextTool {
+    /** The tool's unique name. */
+    name: string;
+    /** What the tool does, shown to the model. */
+    description?: string;
+    /** The parsed input schema. */
+    inputSchema?: JsonSchema;
+    /** Behavioural hints, notably `readOnlyHint`. */
+    annotations?: ModelContextToolAnnotations;
+    /** Called to run the tool. */
+    execute(input: Record<string, unknown>, context?: unknown): ModelContextToolResponse | Promise<ModelContextToolResponse>;
+}
+/**
+ * The page's model context, per the W3C draft ModelContext API.
+ *
+ * Emits `toolchange` when the set of registered tools changes.
+ */
+export interface ModelContext extends EventTarget {
+    /** Add a tool to the page's registry. */
+    registerTool(tool: ModelContextTool, options?: unknown): void;
+    /** Supply page context to the registry, where the implementation supports it. */
+    provideContext?(context?: unknown): void;
+    /** Call a tool, by registered object or by name. */
+    executeTool(nameOrTool: string | object, input?: string | Record<string, unknown> | null, options?: unknown): Promise<ModelContextToolResponse>;
+    /** Every tool currently registered on the page. */
+    getTools(options?: unknown): Promise<ModelContextToolInfo[]>;
+}
+/** One entry in a discovery catalog. */
+export interface CatalogEntry {
+    identifier?: string;
+    displayName?: string;
+    mediaType?: string;
+    type?: string;
+    url?: string;
+}
+/** A `.well-known` discovery catalog. */
+export interface CatalogFile {
+    /** The catalog spec version the file claims. */
+    specVersion?: string;
+    /** The catalog's entries. */
+    entries?: CatalogEntry[];
+}
+/** A header a remote expects on each request, such as an API key. */
+export interface ServerCardRemoteHeader {
+    name: string;
+    description?: string;
+    isSecret?: boolean;
+    isRequired?: boolean;
+    format?: string;
+}
+/** One way of reaching an MCP server. */
+export interface ServerCardRemote {
+    type?: string;
+    url?: string;
+    headers?: ServerCardRemoteHeader[];
+    supportedProtocolVersions?: string[];
+}
+/** An MCP server's published description. */
+export interface ServerCard {
+    name?: string;
+    title?: string;
+    description?: string;
+    websiteUrl?: string;
+    remotes?: ServerCardRemote[];
+    _meta?: Record<string, unknown>;
+}
+/** The connection details an MCP client needs, distilled from a server card. */
+export interface McpServerInfo {
+    /** The server's Streamable HTTP endpoint. */
+    endpoint: string;
+    /** Header carrying the API key, when one is required. */
+    authHeaderName?: string;
+    /** Whether calls need an API key. */
+    authRequired: boolean;
+    /** Tools callable without authentication. */
+    publicTools: string[];
+    /** Protocol versions the server accepts. */
+    protocolVersions: string[];
+    /** Where the card was fetched from. */
+    cardUrl: string;
+    /** The server's display title. */
+    title?: string;
+}
+/** The `window.__NXIS_CONFIG__` global, when the host page defines one. */
+export interface NxisConfig {
+    /** Organisation identifier. */
+    org_id?: string;
+    /** Site identifier. */
+    site_id?: string;
+    /** Subscription identifier. */
+    sub_id?: string;
+    /** WebMCP settings for the page. */
+    webmcp?: {
+        mode?: string;
+    };
+    /** Optional MCP API key for private tools; public typed-retrieval needs none. */
+    mcp_api_key?: string;
+}
+declare global {
+    interface Document {
+        modelContext?: ModelContext;
+    }
+    interface Navigator {
+        modelContext?: ModelContext;
+    }
+    interface Window {
+        __NXIS_CONFIG__?: NxisConfig;
+    }
+}
+/** One message in a conversation. */
+export interface ChatMessage {
+    /** Who produced the message. */
+    role: 'system' | 'user' | 'assistant';
+    /** The message text. */
+    content: string;
+}
+/** A tool definition in the form a chat template expects. */
+export interface ToolDef {
+    /** Always `'function'`. */
+    type: 'function';
+    /** The callable's name, description and parameter schema. */
+    function: {
+        name: string;
+        description?: string;
+        parameters: JsonSchema;
+    };
+}
+/** A tool call the model asked for. */
+export interface ParsedToolCall {
+    /** The tool's name. */
+    name: string;
+    /** The arguments, as supplied by the model. */
+    args: Record<string, unknown>;
+}
+/** Token counts for one generation. */
+export interface GenerationUsage {
+    /** Tokens in the prompt, including tools and history. */
+    promptTokens: number;
+    /** Tokens generated. */
+    outputTokens: number;
+}
+/**
+ * Byte counts behind a load percentage.
+ *
+ * `total` covers only the files announced so far and grows as further shards
+ * register, which is why progress is reported per stage and left unclamped.
+ */
+export interface ProgressDetail {
+    /** Bytes received so far in this stage. */
+    loaded: number;
+    /** Bytes expected, across the files announced so far. */
+    total: number;
+}
+/** How eagerly to fetch model weights. */
+export type PreloadMode = 'eager' | 'idle' | 'none';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,2BAA2B;IAC1C,gFAAgF;IAChF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,oCAAoC;AACpC,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,2BAA2B;AAC3B,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,WAAW,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAClC,0DAA0D;IAC1D,YAAY,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IACnC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IACjC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAC7B,iDAAiD;IACjD,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAC1C,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,iDAAiD;IACjD,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAC1C,8BAA8B;IAC9B,OAAO,CACL,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,OAAO,GAChB,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACjE;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,yCAAyC;IACzC,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9D,iFAAiF;IACjF,cAAc,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,oDAAoD;IACpD,WAAW,CACT,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAC/C,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrC,mDAAmD;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;CAC9D;AAID,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACnC,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAC;CACtC;AAED,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,QAAQ;QAChB,YAAY,CAAC,EAAE,YAAY,CAAC;KAC7B;IACD,UAAU,SAAS;QACjB,YAAY,CAAC,EAAE,YAAY,CAAC;KAC7B;IACD,UAAU,MAAM;QACd,eAAe,CAAC,EAAE,UAAU,CAAC;KAC9B;CACF;AAKD,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6DAA6D;AAC7D,MAAM,WAAW,OAAO;IACtB,2BAA2B;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE,CAAC;CAC1E;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0CAA0C;AAC1C,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Shared types: the WebMCP surface (`document.modelContext`), MCP discovery
+ * (catalogs and server cards), and the model and tool-call shapes.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/ui/agent-fullscreen.d.ts

@@ -0,0 +1,41 @@
+import type { ModelContextToolInfo } from '../types.js';
+/**
+ * Stored values the agent reuses across turns, exposed as `element.preferences`.
+ *
+ * The host page supplies what it already knows about the visitor, and the agent
+ * uses it to fill forms and to answer in context.
+ */
+export interface AgentPreferences {
+    /** All values, or one by key. */
+    get(): Record<string, string>;
+    get(key: string): string | undefined;
+    /** Set one key, or merge an object. An empty value clears the key. */
+    set(key: string, value: string): void;
+    set(values: Record<string, string>): void;
+    /** Forget one key, or everything. */
+    clear(key?: string): void;
+    /** Keys the agent can map onto form fields. */
+    keys(): string[];
+    /** Survive reloads. Off by default — see the `preferences` getter. */
+    persist: boolean;
+}
+/**
+ * One specialist agent, as declared by the host page.
+ *
+ * The prompt and the tool filter are what specialise it. The description is
+ * read only when the model is asked to route a turn.
+ */
+export interface AgentDefinition {
+    systemPrompt?: string;
+    tools?(tool: ModelContextToolInfo): boolean;
+    description?: string;
+    /**
+     * What this agent says when its tools are not on the page.
+     *
+     * Worth writing: the useful sentence names what cannot be done and where it
+     * can be, and it is the difference between an agent that admits a limit and
+     * one that answers a booking request by searching the site.
+     */
+    unavailable?: string;
+}
+//# sourceMappingURL=agent-fullscreen.d.ts.map

package/dist/ui/agent-fullscreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-fullscreen.d.ts","sourceRoot":"","sources":["../../src/ui/agent-fullscreen.ts"],"names":[],"mappings":"AA6EA,OAAO,KAAK,EAAc,oBAAoB,EAA4B,MAAM,aAAa,CAAC;AAuE9F;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,sEAAsE;IACtE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC1C,qCAAqC;IACrC,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,+CAA+C;IAC/C,IAAI,IAAI,MAAM,EAAE,CAAC;IACjB,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;CAClB;AA4DD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}