@nxisai/agent-harness 0.2.4 → 0.4.0

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

@@ -0,0 +1,92 @@
+/**
+ * Finishing, on arrival, a call that was confirmed on another page.
+ *
+ * The decisions here are the awkward ones — is there a call waiting, did the
+ * page's script ever register the form, does the live form want more than the
+ * record said — and they are worth testing without a browser. So the work is
+ * a function that returns what happened, and the caller draws it.
+ *
+ * @module
+ */
+import { type PendingAction, type PendingOptions } from './pending-action.js';
+import type { ModelContext, ModelContextToolInfo, ModelContextToolResponse } from '../../types.js';
+/** What became of the call that was waiting for this page. */
+export type ResumeOutcome = 
+/** Nothing was waiting for this page. The ordinary case. */
+{
+    status: 'none';
+}
+/** WebMCP never appeared, so the form's tool could not be reached. */
+ | {
+    status: 'no-registry';
+    pending: PendingAction;
+}
+/** The page never registered a tool for this action. */
+ | {
+    status: 'no-tool';
+    pending: PendingAction;
+}
+/** The live form requires values the record did not carry. */
+ | {
+    status: 'incomplete';
+    pending: PendingAction;
+    tool: ModelContextToolInfo;
+    missing: string[];
+}
+/** Submitted. */
+ | {
+    status: 'submitted';
+    pending: PendingAction;
+    tool: ModelContextToolInfo;
+    text: string;
+}
+/** The tool ran and reported a failure. */
+ | {
+    status: 'rejected';
+    pending: PendingAction;
+    tool: ModelContextToolInfo;
+    text: string;
+}
+/** The call threw. */
+ | {
+    status: 'failed';
+    pending: PendingAction;
+    tool: ModelContextToolInfo;
+    error: string;
+};
+/** Overrides, so this can be exercised without a page. */
+export interface ResumeOptions extends PendingOptions {
+    /** The page now open. Defaults to the browser's. */
+    href?: string;
+    /** How long to wait for the registry and the tool. */
+    timeoutMs?: number;
+    /** Wait for a WebMCP registry. */
+    registry?(timeoutMs: number): Promise<ModelContext | null>;
+    /** Wait for the page's own tool for this action. */
+    pageTool?(mc: ModelContext, ref: {
+        id: string;
+        name: string;
+    }, timeoutMs: number): Promise<ModelContextToolInfo | null>;
+    /** Run the tool. */
+    exec?(tool: ModelContextToolInfo, values: Record<string, unknown>): Promise<ModelContextToolResponse>;
+    /**
+     * Called once a waiting call is found, before the waits begin.
+     *
+     * The page has just loaded and the registry may take seconds to appear, so
+     * this is where a UI opens the conversation the call came from rather than
+     * leaving the visitor looking at an unrelated thread.
+     */
+    onStart?(pending: PendingAction): void;
+}
+/**
+ * Submit the call waiting for this page, if there is one.
+ *
+ * Runs while the page is still loading, so neither the registry nor the
+ * page's tools exist yet — the script that installs them is usually still
+ * being fetched. Both waits are needed, and in this order.
+ *
+ * @param opts - Page, timeouts, and the seams tests replace.
+ * @returns What happened, for the caller to render.
+ */
+export declare function resumePendingAction(opts?: ResumeOptions): Promise<ResumeOutcome>;
+//# sourceMappingURL=resume.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/resume.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAqB,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMjG,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAKnG,8DAA8D;AAC9D,MAAM,MAAM,aAAa;AACvB,4DAA4D;AAC1D;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE;AACpB,sEAAsE;GACpE;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE;AACnD,wDAAwD;GACtD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE;AAC/C,8DAA8D;GAC5D;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE;AACjG,iBAAiB;GACf;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC3F,2CAA2C;GACzC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC1F,sBAAsB;GACpB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F,0DAA0D;AAC1D,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,QAAQ,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC3D,oDAAoD;IACpD,QAAQ,CAAC,CACP,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EACjC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IACxC,oBAAoB;IACpB,IAAI,CAAC,CACH,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrC;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;CACxC;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAwD1F"}

package/dist/harness/tools/resume.js

@@ -0,0 +1,84 @@
+/**
+ * Finishing, on arrival, a call that was confirmed on another page.
+ *
+ * The decisions here are the awkward ones — is there a call waiting, did the
+ * page's script ever register the form, does the live form want more than the
+ * record said — and they are worth testing without a browser. So the work is
+ * a function that returns what happened, and the caller draws it.
+ *
+ * @module
+ */
+import { takePendingAction } from './pending-action.js';
+import { awaitPageTool } from './action-tools.js';
+import { extractResult, missingRequired } from './schema.js';
+import { recordStep, restoreJourney } from '../steps.js';
+import { waitForModelContext } from './source.js';
+import { WebMcpTools } from './webmcp.js';
+/** How long to wait for the registry, and then for the form's own tool. */
+const WAIT_MS = 8000;
+/**
+ * Submit the call waiting for this page, if there is one.
+ *
+ * Runs while the page is still loading, so neither the registry nor the
+ * page's tools exist yet — the script that installs them is usually still
+ * being fetched. Both waits are needed, and in this order.
+ *
+ * @param opts - Page, timeouts, and the seams tests replace.
+ * @returns What happened, for the caller to render.
+ */
+export async function resumePendingAction(opts = {}) {
+    const pending = takePendingAction(opts.href, opts);
+    if (!pending)
+        return { status: 'none' };
+    // The journey continues from where the other page left it.
+    restoreJourney(pending.steps);
+    recordStep({ id: 'navigate', label: 'Opened the page', status: 'done' });
+    recordStep({ id: 'arrive', label: 'Found the form', status: 'active' });
+    opts.onStart?.(pending);
+    const timeoutMs = opts.timeoutMs ?? WAIT_MS;
+    const waitForRegistry = opts.registry ?? ((ms) => waitForModelContext(ms));
+    const mc = await waitForRegistry(timeoutMs);
+    if (!mc) {
+        recordStep({ id: 'arrive', label: 'This page has no agent tools', status: 'failed' });
+        return { status: 'no-registry', pending };
+    }
+    const findTool = opts.pageTool ?? ((c, ref, ms) => awaitPageTool(c, ref, ms));
+    const tool = await findTool(mc, { id: pending.actionId, name: pending.pageToolName }, timeoutMs);
+    if (!tool) {
+        recordStep({ id: 'arrive', label: 'Could not find the form here', status: 'failed' });
+        return { status: 'no-tool', pending };
+    }
+    recordStep({ id: 'arrive', label: 'Found the form', status: 'done' });
+    // The record says only what the crawler recorded; the form in front of us
+    // says what it actually insists on. Now that its page is open, ask rather
+    // than submit a half-filled form on someone's behalf.
+    const missing = missingRequired(tool, pending.values);
+    if (missing.length) {
+        recordStep({
+            id: 'collect',
+            label: 'This form needs more',
+            status: 'active',
+            detail: missing.join(', '),
+        });
+        return { status: 'incomplete', pending, tool, missing };
+    }
+    recordStep({ id: 'fill', label: 'Filling the form', status: 'active' });
+    const run = opts.exec ?? ((t, values) => new WebMcpTools().execTool(t, t.name, values));
+    try {
+        const res = await run(tool, pending.values);
+        const text = extractResult(res);
+        if (res?.isError) {
+            recordStep({ id: 'submit', label: 'It did not go through', status: 'failed', detail: text });
+            return { status: 'rejected', pending, tool, text };
+        }
+        recordStep({ id: 'fill', label: 'Filled the form', status: 'done' });
+        recordStep({ id: 'submit', label: 'Submitted', status: 'done' });
+        return { status: 'submitted', pending, tool, text };
+    }
+    catch (err) {
+        const error = String(err?.message || err);
+        recordStep({ id: 'submit', label: 'It did not go through', status: 'failed', detail: error });
+        return { status: 'failed', pending, tool, error };
+    }
+}
+//# sourceMappingURL=resume.js.map

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

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

package/dist/harness/tools/schema.js

@@ -107,10 +107,10 @@ export function extractResult(res) {
     if (res == null)
         return '';
     if (typeof res === 'string')
-        return res;
+        return unwrapResponse(res);
     if (Array.isArray(res.content)) {
         return res.content
-            .map((c) => (c && c.text) || '')
+            .map((c) => unwrapResponse((c && c.text) || ''))
             .filter(Boolean)
             .join('\n');
     }
@@ -122,6 +122,33 @@ export function extractResult(res) {
     }
 }
 // ── internals ───────────────────────────────────────────────────────────────
+/**
+ * A response the registry stringified rather than passed through.
+ *
+ * A tool may answer with a response object, and a registry is free to hand
+ * that back as JSON in a single text block — which puts `{"content":[{"type":
+ * "text"…` in front of the user where a sentence belongs. Only a shape that is
+ * plainly a tool response is unwrapped; a tool whose own result happens to be
+ * JSON keeps it.
+ */
+function unwrapResponse(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith('{') || !trimmed.includes('"content"'))
+        return text;
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (!Array.isArray(parsed.content))
+            return text;
+        const inner = parsed.content
+            .map((c) => (c && c.text) || '')
+            .filter(Boolean)
+            .join('\n');
+        return inner || text;
+    }
+    catch {
+        return text;
+    }
+}
 /**
  * Give every schema node a `type`, which the chat template requires.
  *

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

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

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

@@ -0,0 +1,81 @@
+/**
+ * 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;
+/**
+ * Query every record whose `@type` contains `fragment`.
+ *
+ * `schema_type: "Action"` does not yet expand to subtypes on the server, so
+ * this matches on `@type` instead and the caller filters the results. When the
+ * server supports the type hierarchy, only this function needs to change.
+ *
+ * @param client - A connected client for the site's MCP server.
+ * @param fragment - Part of the type name: `Action`, `Page`.
+ * @returns Every matching record, across the server's result pages.
+ */
+export declare function queryTypedRecords(client: Client, fragment: string): Promise<unknown[]>;
+/** 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;AA8CD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA6B5F;AAoCD,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,314 @@
+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 record whose `@type` contains `fragment`.
+ *
+ * `schema_type: "Action"` does not yet expand to subtypes on the server, so
+ * this matches on `@type` instead and the caller filters the results. When the
+ * server supports the type hierarchy, only this function needs to change.
+ *
+ * @param client - A connected client for the site's MCP server.
+ * @param fragment - Part of the type name: `Action`, `Page`.
+ * @returns Every matching record, across the server's result pages.
+ */
+export async function queryTypedRecords(client, fragment) {
+    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: fragment }],
+                },
+                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 ${fragment} records 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 queryTypedRecords(client, 'Action')) {
+        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