@nxisai/agent-harness 0.2.3 → 0.3.0

package/dist/harness/tools/site-actions.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Fetches every Schema.org Action on the site through typed retrieval.
+ *
+ * The page's own script registers tools only for the actions in the current
+ * page's JSON-LD. The site's MCP server holds them all, so an agent opened on
+ * any page can learn what the rest of the site offers. This module fetches and
+ * normalises that list; turning it into tools is a separate step.
+ *
+ * Records arrive with expanded IRI keys (`https://schema.org/name`) where a
+ * page carries compact ones (`name`), so both spellings are read, as the
+ * page's script does.
+ *
+ * @module
+ */
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { McpServerInfo } from '../../types.js';
+import type { NxisAction } from '../../webmcp-contract.js';
+/**
+ * Read one typed-retrieval record as an action.
+ *
+ * @param raw - A record as returned by `nxis_query`.
+ * @returns The action with bare types and compact keys, or null when the record
+ * is not an Action or lacks an `@id`, a name, or a target with an HTTP method.
+ */
+export declare function parseAction(raw: unknown): NxisAction | null;
+/**
+ * Whether two URLs name the same page, ignoring the query and fragment.
+ *
+ * A form is the same form whether it was reached with tracking parameters or
+ * without.
+ */
+export declare function samePage(a: string | undefined, b: string | undefined): boolean;
+/**
+ * Whether an action's form is on the page currently open.
+ *
+ * @param action - The action to place.
+ * @param href - The current page. Defaults to the browser's.
+ */
+export declare function sameActionPage(action: NxisAction, href?: string): boolean;
+/** Options for {@link loadSiteActions}. */
+export interface SiteActionsOptions {
+    /**
+     * The origin actions must belong to. Defaults to the page's own.
+     *
+     * An action whose page is on any other origin is dropped.
+     */
+    origin?: string;
+    /** Where the list is cached between page loads. Defaults to `sessionStorage`; null disables. */
+    storage?: Storage | null;
+    /** How long a cached list is reused, in milliseconds. Defaults to ten minutes. */
+    ttlMs?: number;
+    /** The clock, for tests. */
+    now?: () => number;
+}
+/**
+ * Every Action on the site that can be carried out from this origin.
+ *
+ * Reuses a list fetched in the same tab within the last ten minutes, so moving
+ * between pages costs one request per session rather than one per page.
+ *
+ * @param client - A connected client for the site's MCP server. The query is a
+ * public read and needs no key.
+ * @param info - The server's details; its endpoint keys the cache.
+ * @param opts - Origin, cache and clock overrides.
+ * @returns The actions, each once, in the order the server returned them.
+ * @throws When the query itself fails. The caller decides whether that matters.
+ */
+export declare function loadSiteActions(client: Client, info: Pick<McpServerInfo, 'endpoint'>, opts?: SiteActionsOptions): Promise<NxisAction[]>;
+//# sourceMappingURL=site-actions.d.ts.map

package/dist/harness/tools/site-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-actions.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/site-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EACV,UAAU,EAKX,MAAM,0BAA0B,CAAC;AA8BlC;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAyB3D;AA2DD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAS9E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAGzE;AAsHD,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EACrC,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,UAAU,EAAE,CAAC,CA8BvB"}

package/dist/harness/tools/site-actions.js

@@ -0,0 +1,310 @@
+const SCHEMA_NS = 'https://schema.org/';
+const NXIS_NS = 'https://nxis.ai/ns#';
+/** The server caps a page of results at this many. */
+const PAGE_LIMIT = 100;
+/** A guard against a server that keeps returning page tokens. */
+const MAX_PAGES = 10;
+/** How long a fetched list is reused across page loads in the same tab. */
+const CACHE_TTL_MS = 10 * 60 * 1000;
+const CACHE_PREFIX = 'nxis:site-actions:v1:';
+const VALUE_TYPES = ['string', 'number', 'integer', 'boolean', 'date', 'file'];
+const isObj = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+/** A schema.org property, by compact term or expanded IRI. */
+const schemaValue = (o, prop) => o[prop] ?? o[SCHEMA_NS + prop];
+/** An nxis extension property, by compact term or expanded IRI. */
+const nxisValue = (o, prop) => o[`nxis:${prop}`] ?? o[NXIS_NS + prop];
+const str = (v) => (typeof v === 'string' ? v : undefined);
+const num = (v) => (typeof v === 'number' ? v : undefined);
+/** `https://schema.org/InteractAction` → `InteractAction`. */
+const bareType = (t) => t.replace(/^.*[/#]/, '');
+/**
+ * Read one typed-retrieval record as an action.
+ *
+ * @param raw - A record as returned by `nxis_query`.
+ * @returns The action with bare types and compact keys, or null when the record
+ * is not an Action or lacks an `@id`, a name, or a target with an HTTP method.
+ */
+export function parseAction(raw) {
+    if (!isObj(raw))
+        return null;
+    const rawType = str(raw['@type']);
+    if (!rawType)
+        return null;
+    const type = bareType(rawType);
+    if (!type.endsWith('Action'))
+        return null;
+    const id = str(raw['@id']);
+    const name = str(schemaValue(raw, 'name'));
+    const target = parseEntryPoint(schemaValue(raw, 'target'));
+    if (!id || !name || !target)
+        return null;
+    // Inputs live under `nxis:input`: schema.org has no `input` on Action.
+    const rawInput = nxisValue(raw, 'input');
+    const input = (Array.isArray(rawInput) ? rawInput : [])
+        .map(parseInput)
+        .filter((i) => i !== null);
+    const action = { '@type': type, '@id': id, name, target };
+    const description = str(schemaValue(raw, 'description'));
+    if (description)
+        action.description = description;
+    if (input.length)
+        action.input = input;
+    const extractedAt = str(nxisValue(raw, 'extractedAt'));
+    if (extractedAt)
+        action['nxis:extractedAt'] = extractedAt;
+    return action;
+}
+function parseEntryPoint(raw) {
+    if (!isObj(raw))
+        return null;
+    const httpMethod = str(schemaValue(raw, 'httpMethod'))?.toUpperCase();
+    if (!httpMethod)
+        return null;
+    const target = { '@type': 'EntryPoint', httpMethod };
+    const urlTemplate = str(schemaValue(raw, 'urlTemplate'));
+    if (urlTemplate)
+        target.urlTemplate = urlTemplate;
+    const encodingType = str(schemaValue(raw, 'encodingType'));
+    if (encodingType)
+        target.encodingType = encodingType;
+    const kind = nxisValue(raw, 'targetKind');
+    if (kind === 'selfPage' || kind === 'clientSide')
+        target['nxis:targetKind'] = kind;
+    const pageUrl = str(nxisValue(raw, 'pageUrl'));
+    if (pageUrl)
+        target['nxis:pageUrl'] = pageUrl;
+    if (nxisValue(raw, 'jsHandled') === true)
+        target['nxis:jsHandled'] = true;
+    return target;
+}
+function parseInput(raw) {
+    if (!isObj(raw))
+        return null;
+    const valueName = str(schemaValue(raw, 'valueName'));
+    if (!valueName)
+        return null;
+    const declared = str(nxisValue(raw, 'valueType'));
+    const spec = {
+        '@type': 'PropertyValueSpecification',
+        valueName,
+        'nxis:valueType': declared && VALUE_TYPES.includes(declared) ? declared : 'string',
+    };
+    const description = str(schemaValue(raw, 'description'));
+    if (description)
+        spec.description = description;
+    if (schemaValue(raw, 'valueRequired') === true)
+        spec.valueRequired = true;
+    const defaultValue = str(schemaValue(raw, 'defaultValue'));
+    if (defaultValue !== undefined)
+        spec.defaultValue = defaultValue;
+    for (const key of ['valueMinLength', 'valueMaxLength', 'minValue', 'maxValue', 'stepValue']) {
+        const v = num(schemaValue(raw, key));
+        if (v !== undefined)
+            spec[key] = v;
+    }
+    const valuePattern = str(schemaValue(raw, 'valuePattern'));
+    if (valuePattern)
+        spec.valuePattern = valuePattern;
+    if (schemaValue(raw, 'multipleValues') === true)
+        spec.multipleValues = true;
+    if (schemaValue(raw, 'readonlyValue') === true)
+        spec.readonlyValue = true;
+    const rawOptions = nxisValue(raw, 'valueOption');
+    const options = [];
+    for (const o of Array.isArray(rawOptions) ? rawOptions : []) {
+        if (!isObj(o))
+            continue;
+        const value = str(schemaValue(o, 'value'));
+        if (value === undefined)
+            continue;
+        const label = str(schemaValue(o, 'name'));
+        options.push(label ? { '@type': 'nxis:ValueOption', value, name: label } : { '@type': 'nxis:ValueOption', value });
+    }
+    if (options.length)
+        spec['nxis:valueOption'] = options;
+    return spec;
+}
+/**
+ * Whether two URLs name the same page, ignoring the query and fragment.
+ *
+ * A form is the same form whether it was reached with tracking parameters or
+ * without.
+ */
+export function samePage(a, b) {
+    if (!a || !b)
+        return false;
+    try {
+        const x = new URL(a, b);
+        const y = new URL(b, a);
+        return x.origin === y.origin && x.pathname === y.pathname;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Whether an action's form is on the page currently open.
+ *
+ * @param action - The action to place.
+ * @param href - The current page. Defaults to the browser's.
+ */
+export function sameActionPage(action, href) {
+    const here = href ?? (typeof location === 'undefined' ? undefined : location.href);
+    return samePage(action.target['nxis:pageUrl'], here);
+}
+/**
+ * Whether an action can be carried out from this site.
+ *
+ * Actions run by filling the form on their own page, so the harness may later
+ * navigate to `nxis:pageUrl`. A record naming another origin, whether stale or
+ * tampered with, must never send the visitor there.
+ */
+function onOrigin(action, origin) {
+    const pageUrl = action.target['nxis:pageUrl'];
+    if (!pageUrl)
+        return false;
+    try {
+        return new URL(pageUrl, origin).origin === origin;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The records in a tool result, whether structured or JSON text.
+ *
+ * Typed loosely because the SDK's result type also admits the legacy
+ * `{ toolResult }` shape, which carries neither.
+ */
+function readResults(result) {
+    const text = (Array.isArray(result.content) ? result.content : [])
+        .map((c) => (isObj(c) && typeof c.text === 'string' ? c.text : ''))
+        .join('');
+    if (result.isError)
+        throw new Error(text || 'nxis_query failed');
+    let body = result.structuredContent;
+    if (!isObj(body)) {
+        try {
+            body = JSON.parse(text);
+        }
+        catch {
+            throw new Error('nxis_query returned a response that is not JSON');
+        }
+    }
+    const b = body;
+    return {
+        results: Array.isArray(b.results) ? b.results : [],
+        nextPageToken: str(b.next_page_token) || undefined,
+        total: num(b.total),
+    };
+}
+/**
+ * Query every Action record on the server.
+ *
+ * `schema_type: "Action"` does not yet expand to subtypes on the server, so
+ * this matches on `@type` instead and filters the results here. When the server
+ * supports the Action hierarchy, only this function needs to change.
+ */
+async function queryActionRecords(client) {
+    const records = [];
+    let pageToken;
+    let total;
+    for (let page = 0; page < MAX_PAGES; page++) {
+        const result = await client.callTool({
+            name: 'nxis_query',
+            arguments: {
+                filter: {
+                    schema_type: '',
+                    field_filters: [{ path: '@type', operator: 'CONTAINS', value: 'Action' }],
+                },
+                limit: PAGE_LIMIT,
+                ...(pageToken ? { page_token: pageToken } : {}),
+            },
+        });
+        const read = readResults(result);
+        records.push(...read.results);
+        total = read.total ?? total;
+        pageToken = read.nextPageToken;
+        if (!pageToken)
+            break;
+    }
+    if (total !== undefined && records.length < total) {
+        console.warn(`[nxis-mcp] site actions truncated: fetched ${records.length} of ${total} — ` +
+            'the server returned no further pages');
+    }
+    return records;
+}
+/** The tab's session storage, or null where it is unavailable or blocked. */
+function defaultStorage() {
+    try {
+        return typeof sessionStorage === 'undefined' ? null : sessionStorage;
+    }
+    catch {
+        return null;
+    }
+}
+function readCache(storage, key, now, ttl) {
+    if (!storage)
+        return null;
+    try {
+        const entry = JSON.parse(storage.getItem(key) || 'null');
+        if (!entry || !Array.isArray(entry.actions) || typeof entry.fetchedAt !== 'number')
+            return null;
+        if (now - entry.fetchedAt > ttl || entry.fetchedAt > now)
+            return null;
+        return entry.actions;
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(storage, key, entry) {
+    try {
+        storage?.setItem(key, JSON.stringify(entry));
+    }
+    catch {
+        // Full or blocked storage costs a refetch on the next page, nothing more.
+    }
+}
+/**
+ * Every Action on the site that can be carried out from this origin.
+ *
+ * Reuses a list fetched in the same tab within the last ten minutes, so moving
+ * between pages costs one request per session rather than one per page.
+ *
+ * @param client - A connected client for the site's MCP server. The query is a
+ * public read and needs no key.
+ * @param info - The server's details; its endpoint keys the cache.
+ * @param opts - Origin, cache and clock overrides.
+ * @returns The actions, each once, in the order the server returned them.
+ * @throws When the query itself fails. The caller decides whether that matters.
+ */
+export async function loadSiteActions(client, info, opts = {}) {
+    const origin = opts.origin ?? location.origin;
+    const storage = opts.storage === undefined ? defaultStorage() : opts.storage;
+    const now = (opts.now ?? Date.now)();
+    const key = CACHE_PREFIX + info.endpoint;
+    const cached = readCache(storage, key, now, opts.ttlMs ?? CACHE_TTL_MS);
+    if (cached)
+        return cached;
+    const seen = new Set();
+    const actions = [];
+    let offOrigin = 0;
+    for (const record of await queryActionRecords(client)) {
+        const action = parseAction(record);
+        if (!action || seen.has(action['@id']))
+            continue;
+        seen.add(action['@id']);
+        if (!onOrigin(action, origin)) {
+            offOrigin++;
+            continue;
+        }
+        actions.push(action);
+    }
+    if (offOrigin) {
+        console.warn(`[nxis-mcp] ignored ${offOrigin} site action(s) whose page is not on ${origin}`);
+    }
+    writeCache(storage, key, { fetchedAt: now, actions });
+    return actions;
+}
+//# sourceMappingURL=site-actions.js.map

package/dist/harness/tools/site-actions.js.map

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

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

@@ -15,14 +15,30 @@
 import { registerRemoteTools, type BridgeOptions } from './bridge.js';
 import { connectMcp } from './client.js';
 import { discoverMcpServer } from './discovery.js';
+import { loadSiteActions, type SiteActionsOptions } from './site-actions.js';
 import type { ModelContext } from '../../types.js';
+import type { NxisAction } from '../../webmcp-contract.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. */
+    /**
+     * Every Action on the site, from any page, that belongs to this origin.
+     *
+     * Empty when discovery failed, the query failed, or it was turned off with
+     * {@link ConnectOptions.siteActions}.
+     */
+    siteActions: NxisAction[];
+    /**
+     * The tools registered for {@link siteActions}.
+     *
+     * Fewer than the actions: those that share a name and a set of fields become
+     * one tool that chooses between them.
+     */
+    siteTools: string[];
+    /** Why remote tools or site actions are absent, when they are. Never fatal. */
     warning?: string;
 }
 /**
@@ -45,6 +61,13 @@ export interface ConnectOptions {
     fallback?: boolean;
     /** Override which of the server's tools are bridged in. */
     accept?: BridgeOptions['accept'];
+    /**
+     * Fetch the site's Actions from every page, not only this one.
+     *
+     * Defaults to true. Pass false to skip the query, or an options object to
+     * override the origin check or the cache.
+     */
+    siteActions?: boolean | SiteActionsOptions;
 }
 /**
  * Wait for a tool registry, then bridge in a remote MCP server's tools.
@@ -54,12 +77,28 @@ export interface ConnectOptions {
  * 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.
+ * Connects each registry once. A second call for the same registry, such as a
+ * page script and the element both connecting, returns the first call's result
+ * rather than registering the same tools again, which a native `modelContext`
+ * rejects as a duplicate.
+ *
+ * @param apiKey - Key for the remote server's private tools. Public tools need
+ * none, and the element never supplies one: a key readable in the page is a
+ * published key. Pass one only where it is short-lived and scoped, such as a
+ * token your backend mints per session.
+ * @param opts - Timeout, local-registry fallback, and a tool filter. Only the
+ * first call's options apply to a registry.
  * @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 { discoverMcpServer, connectMcp, registerRemoteTools, loadSiteActions };
+export { registerSiteActionTools, buildSiteActionTools, withoutShadowedTools, handoffFor, findPageTool, awaitPageTool, pageToolRef, siteToolName, selectSiteTools, } from './action-tools.js';
+export { resumePendingAction } from './resume.js';
+export type { ResumeOutcome, ResumeOptions } from './resume.js';
+export type { SiteActionTool, Handoff, PageToolRef } from './action-tools.js';
+export { savePendingAction, takePendingAction, clearPendingAction, } from './pending-action.js';
+export type { PendingAction } from './pending-action.js';
+export { parseAction, samePage, sameActionPage } from './site-actions.js';
+export type { SiteActionsOptions } from './site-actions.js';
 export { ensureModelContext, LocalModelContext } from './local-context.js';
 //# sourceMappingURL=source.d.ts.map

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

@@ -1 +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"}
+{"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,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAK3D,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,gFAAgF;IAChF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;OAKG;IACH,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B;;;;;OAKG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,+EAA+E;IAC/E,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;IACjC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,YAAY,CAChC,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,aAAa,CAAC,CAmBxB;AAgDD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,mBAAmB,EAAE,eAAe,EAAE,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/harness/tools/source.js

@@ -16,6 +16,8 @@ import { registerRemoteTools } from './bridge.js';
 import { ensureModelContext } from './local-context.js';
 import { connectMcp } from './client.js';
 import { discoverMcpServer } from './discovery.js';
+import { loadSiteActions } from './site-actions.js';
+import { registerSiteActionTools } from './action-tools.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. */
@@ -55,9 +57,17 @@ export function waitForModelContext(timeout = READY_TIMEOUT_MS) {
  * 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.
+ * Connects each registry once. A second call for the same registry, such as a
+ * page script and the element both connecting, returns the first call's result
+ * rather than registering the same tools again, which a native `modelContext`
+ * rejects as a duplicate.
+ *
+ * @param apiKey - Key for the remote server's private tools. Public tools need
+ * none, and the element never supplies one: a key readable in the page is a
+ * published key. Pass one only where it is short-lived and scoped, such as a
+ * token your backend mints per session.
+ * @param opts - Timeout, local-registry fallback, and a tool filter. Only the
+ * first call's options apply to a registry.
  * @returns The registry, the remote tools bridged in, and any warning.
  */
 export async function connectTools(apiKey, opts = {}) {
@@ -67,23 +77,62 @@ export async function connectTools(apiKey, opts = {}) {
         return {
             modelContext: null,
             remoteTools: [],
+            siteActions: [],
+            siteTools: [],
             warning: 'WebMCP (document.modelContext) unavailable — no tools registered.',
         };
     }
+    let connection = connections.get(mc);
+    if (!connection) {
+        connection = connectRegistry(mc, apiKey, opts);
+        connections.set(mc, connection);
+    }
+    return connection;
+}
+/** One connection per registry, shared by every caller. */
+const connections = new WeakMap();
+async function connectRegistry(mc, apiKey, opts) {
+    let info;
+    let client;
+    let remoteTools;
     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 };
+        info = await discoverMcpServer();
+        client = await connectMcp(info, apiKey);
+        remoteTools = await registerRemoteTools(client, mc, info, { accept: opts.accept });
     }
     catch (err) {
         return {
             modelContext: mc,
             remoteTools: [],
-            warning: `remote tool bootstrap failed — on-page tools still work: ${String(err?.message || err)}`,
+            siteActions: [],
+            siteTools: [],
+            warning: `remote tool bootstrap failed — on-page tools still work: ${errorText(err)}`,
+        };
+    }
+    if (opts.siteActions === false) {
+        return { modelContext: mc, remoteTools, siteActions: [], siteTools: [] };
+    }
+    try {
+        const siteOpts = typeof opts.siteActions === 'object' ? opts.siteActions : {};
+        const siteActions = await loadSiteActions(client, info, siteOpts);
+        const siteTools = await registerSiteActionTools(mc, siteActions);
+        return { modelContext: mc, remoteTools, siteActions, siteTools };
+    }
+    catch (err) {
+        return {
+            modelContext: mc,
+            remoteTools,
+            siteActions: [],
+            siteTools: [],
+            warning: `site actions unavailable — this page's own actions still work: ${errorText(err)}`,
         };
     }
 }
-export { discoverMcpServer, connectMcp, registerRemoteTools };
+const errorText = (err) => String(err?.message || err);
+export { discoverMcpServer, connectMcp, registerRemoteTools, loadSiteActions };
+export { registerSiteActionTools, buildSiteActionTools, withoutShadowedTools, handoffFor, findPageTool, awaitPageTool, pageToolRef, siteToolName, selectSiteTools, } from './action-tools.js';
+export { resumePendingAction } from './resume.js';
+export { savePendingAction, takePendingAction, clearPendingAction, } from './pending-action.js';
+export { parseAction, samePage, sameActionPage } from './site-actions.js';
 export { ensureModelContext, LocalModelContext } from './local-context.js';
 //# sourceMappingURL=source.js.map

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

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

package/dist/index.d.ts

@@ -46,7 +46,16 @@ export { parseToolCall, stripMarkers, humanize, lcFirst, escapeHtml, MODEL_ID, M
 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 { buildSiteActionTools, registerSiteActionTools, withoutShadowedTools, handoffFor, findPageTool, awaitPageTool, pageToolRef, siteToolName, sanitizeToolName, selectSiteTools, DEFAULT_SITE_TOOL_LIMIT, } from './harness/tools/action-tools.js';
+export { beginJourney, currentJourney, journeySteps, onJourneyChange, recordStep, restoreJourney, } from './harness/steps.js';
+export type { AgentStep, AgentStepId, AgentStepStatus } from './harness/steps.js';
+export { resumePendingAction } from './harness/tools/resume.js';
+export type { ResumeOutcome, ResumeOptions } from './harness/tools/resume.js';
+export type { SiteActionTool, Handoff, PageToolRef } from './harness/tools/action-tools.js';
+export { savePendingAction, takePendingAction, clearPendingAction, PENDING_TTL_MS, } from './harness/tools/pending-action.js';
+export type { PendingAction } from './harness/tools/pending-action.js';
+export { loadSiteActions, parseAction } from './harness/tools/site-actions.js';
+export type { ConnectResult, ConnectOptions, SiteActionsOptions } 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';

package/dist/index.d.ts.map

@@ -1 +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,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC5F,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}