@nxisai/agent-harness 0.2.0

package/dist/harness/router/rules.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Pattern-based routing, used before falling back to a model classification.
+ *
+ * Matching a table of regular expressions costs microseconds, where a
+ * classification pass costs a generation. Rules run first and may abstain by
+ * returning a null route, which is what tells {@link AgentCoordinator} that a
+ * model pass is worth its cost.
+ *
+ * @module
+ */
+/** One pattern, and the agent it votes for. */
+export interface RouteRule {
+    /** The agent this rule votes for. */
+    route: string;
+    /** Tested against the goal, lower-cased. */
+    match: RegExp;
+    /**
+       * How much this rule's vote counts. Defaults to 1.
+       *
+       * Raise it so a specific phrase outscores a general one when both match.
+       */
+    weight?: number;
+    /** A note on the rule's purpose, carried through to {@link RouteDecision}. */
+    because?: string;
+}
+/** The result of scoring a goal against a rule table. */
+export interface RouteDecision {
+    /** The winning agent, or null when no rule matched or two rules tied. */
+    route: string | null;
+    /** Total score per route, highest first. Empty when nothing matched. */
+    scores: [string, number][];
+    /** Every rule that matched, in table order. */
+    matched: RouteRule[];
+}
+/**
+ * Score a goal against a rule table and return the highest-scoring agent.
+ *
+ * Ties abstain rather than picking arbitrarily, since routing to an agent that
+ * lacks the required tool is more costly than the model pass that resolves the
+ * ambiguity.
+ *
+ * @param goal - The user's message. Matched lower-cased.
+ * @param rules - The table to score against.
+ * @returns The winning route, or a null route when nothing matched or the top
+ * two scores are equal.
+ */
+export declare function matchRoute(goal: string, rules: RouteRule[]): RouteDecision;
+//# sourceMappingURL=rules.d.ts.map

package/dist/harness/router/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/harness/router/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,+CAA+C;AAC/C,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IAChB;;;;SAIK;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wEAAwE;IACxE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC3B,+CAA+C;IAC/C,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,aAAa,CAe1E"}

package/dist/harness/router/rules.js

@@ -0,0 +1,38 @@
+/**
+ * Pattern-based routing, used before falling back to a model classification.
+ *
+ * Matching a table of regular expressions costs microseconds, where a
+ * classification pass costs a generation. Rules run first and may abstain by
+ * returning a null route, which is what tells {@link AgentCoordinator} that a
+ * model pass is worth its cost.
+ *
+ * @module
+ */
+/**
+ * Score a goal against a rule table and return the highest-scoring agent.
+ *
+ * Ties abstain rather than picking arbitrarily, since routing to an agent that
+ * lacks the required tool is more costly than the model pass that resolves the
+ * ambiguity.
+ *
+ * @param goal - The user's message. Matched lower-cased.
+ * @param rules - The table to score against.
+ * @returns The winning route, or a null route when nothing matched or the top
+ * two scores are equal.
+ */
+export function matchRoute(goal, rules) {
+    const text = goal.toLowerCase();
+    const matched = rules.filter((r) => r.match.test(text));
+    const totals = new Map();
+    for (const rule of matched) {
+        totals.set(rule.route, (totals.get(rule.route) ?? 0) + (rule.weight ?? 1));
+    }
+    const scores = [...totals.entries()].sort((a, b) => b[1] - a[1]);
+    if (!scores.length)
+        return { route: null, scores, matched };
+    if (scores.length > 1 && scores[0][1] === scores[1][1]) {
+        return { route: null, scores, matched };
+    }
+    return { route: scores[0][0], scores, matched };
+}
+//# sourceMappingURL=rules.js.map

package/dist/harness/router/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/harness/router/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA4BH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAkB;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC5D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAClD,CAAC"}

package/dist/harness/slots.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Merges every known source of a tool's arguments and reports what is missing.
+ *
+ * Sources merge by precedence, most authoritative last:
+ *
+ * ```
+ * schema defaults  <  page context  <  saved profile  <  model args
+ * ```
+ *
+ * Model arguments win because they encode what the user has just asked for, so
+ * an explicit value in the request overrides a stored preference.
+ *
+ * @module
+ */
+import type { JsonSchema } from '../types.js';
+/** One argument of a tool call, with its value and where that value came from. */
+export interface Slot {
+    /** Property key in the flat, model-facing schema. */
+    name: string;
+    /** The property's JSON Schema, used for labels, types and enums. */
+    schema: JsonSchema;
+    /** Whether the tool's schema lists this property as required. */
+    required: boolean;
+    /** Which source supplied {@link Slot.value}; `'none'` when nothing did. */
+    source: 'model' | 'profile' | 'context' | 'default' | 'none';
+    /** The resolved value, or `undefined` when `source` is `'none'`. */
+    value: unknown;
+}
+/** The outcome of merging every source for one tool call. */
+export interface Resolution {
+    /** Every known value, ready to submit when `missing` is empty. */
+    values: Record<string, unknown>;
+    /** Required slots nobody supplied: the values to ask for. */
+    missing: Slot[];
+    /**
+     * Optional slots left empty. Never asked about on their own; a write
+     * confirmation may still surface them as editable extras.
+     */
+    optional: Slot[];
+    /** Every slot in the schema, resolved or not. */
+    all: Slot[];
+}
+/** The candidate values to merge, in order of increasing precedence. */
+export interface ResolveSources {
+    /** Arguments the model supplied in its tool call. */
+    modelArgs?: Record<string, unknown>;
+    /** Values saved from earlier turns, such as a name or an email address. */
+    profile?: Record<string, unknown>;
+    /** Values the host page knows, such as the current record. */
+    context?: Record<string, unknown>;
+    /** Values a human has typed into a live form. Ranks with `modelArgs`. */
+    entered?: Record<string, unknown>;
+}
+/**
+ * Resolve every property in a schema against the supplied sources.
+ *
+ * @param schema - The tool's flat input schema.
+ * @param sources - Candidate values, merged by the precedence in the module
+ * description.
+ * @returns The merged values, plus the required and optional slots still empty.
+ */
+export declare function resolveSlots(schema: JsonSchema, sources: ResolveSources): Resolution;
+/**
+ * The slots to display on a write confirmation: those with a value.
+ *
+ * Empty optional slots are omitted, since a confirmation shows what is about
+ * to be sent rather than what could have been.
+ *
+ * @param resolution - A resolution with no remaining gaps.
+ * @returns Every slot whose value came from a source.
+ */
+export declare function summarySlots(resolution: Resolution): Slot[];
+//# sourceMappingURL=slots.d.ts.map

package/dist/harness/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../src/harness/slots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,kFAAkF;AAClF,MAAM,WAAW,IAAI;IACnB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,MAAM,EAAE,UAAU,CAAC;IACnB,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC7D,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,6DAA6D;IAC7D,OAAO,EAAE,IAAI,EAAE,CAAC;IAChB;;;OAGG;IACH,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjB,iDAAiD;IACjD,GAAG,EAAE,IAAI,EAAE,CAAC;CACb;AAED,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAMD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,UAAU,CAiCpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,EAAE,CAE3D"}

package/dist/harness/slots.js

@@ -0,0 +1,68 @@
+/**
+ * Merges every known source of a tool's arguments and reports what is missing.
+ *
+ * Sources merge by precedence, most authoritative last:
+ *
+ * ```
+ * schema defaults  <  page context  <  saved profile  <  model args
+ * ```
+ *
+ * Model arguments win because they encode what the user has just asked for, so
+ * an explicit value in the request overrides a stored preference.
+ *
+ * @module
+ */
+/** Present and meaningful: not null, not undefined, not whitespace. */
+const isSet = (v) => v !== undefined && v !== null && !(typeof v === 'string' && v.trim() === '');
+/**
+ * Resolve every property in a schema against the supplied sources.
+ *
+ * @param schema - The tool's flat input schema.
+ * @param sources - Candidate values, merged by the precedence in the module
+ * description.
+ * @returns The merged values, plus the required and optional slots still empty.
+ */
+export function resolveSlots(schema, sources) {
+    const props = schema.properties ?? {};
+    const required = new Set(schema.required ?? []);
+    const all = Object.entries(props).map(([name, spec]) => {
+        const propSchema = spec ?? {};
+        // Highest precedence first; the first hit wins and records its origin.
+        const candidates = [
+            ['model', sources.entered?.[name]],
+            ['model', sources.modelArgs?.[name]],
+            ['profile', sources.profile?.[name]],
+            ['context', sources.context?.[name]],
+            ['default', propSchema.default],
+        ];
+        for (const [source, value] of candidates) {
+            if (isSet(value)) {
+                return { name, schema: propSchema, required: required.has(name), source, value };
+            }
+        }
+        return { name, schema: propSchema, required: required.has(name), source: 'none', value: undefined };
+    });
+    const values = {};
+    for (const slot of all)
+        if (isSet(slot.value))
+            values[slot.name] = slot.value;
+    return {
+        values,
+        missing: all.filter(s => s.required && s.source === 'none'),
+        optional: all.filter(s => !s.required && s.source === 'none'),
+        all,
+    };
+}
+/**
+ * The slots to display on a write confirmation: those with a value.
+ *
+ * Empty optional slots are omitted, since a confirmation shows what is about
+ * to be sent rather than what could have been.
+ *
+ * @param resolution - A resolution with no remaining gaps.
+ * @returns Every slot whose value came from a source.
+ */
+export function summarySlots(resolution) {
+    return resolution.all.filter(s => s.source !== 'none');
+}
+//# sourceMappingURL=slots.js.map

package/dist/harness/slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.js","sourceRoot":"","sources":["../../src/harness/slots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA6CH,uEAAuE;AACvE,MAAM,KAAK,GAAG,CAAC,CAAU,EAAW,EAAE,CACpC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAkB,EAAE,OAAuB;IACtE,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,GAAG,GAAW,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;QAC7D,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;QAE9B,uEAAuE;QACvE,MAAM,UAAU,GAAgC;YAC9C,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;YACpC,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;YACpC,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;YACpC,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC;SAChC,CAAC;QAEF,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;YACzC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YACnF,CAAC;QACH,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACtG,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,GAAG;QAAE,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IAE9E,OAAO;QACL,MAAM;QACN,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;QAC3D,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;QAC7D,GAAG;KACJ,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,UAAsB;IACjD,OAAO,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;AACzD,CAAC"}

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

@@ -0,0 +1,71 @@
+/**
+ * Registers a remote MCP server's tools as WebMCP tools on the page.
+ *
+ * Each registered tool proxies to the connected client's `tools/call` and maps
+ * the result back to a WebMCP response, so the agent sees one unified toolset
+ * and treats remote and on-page tools alike.
+ *
+ * Remote schemas are often deeply nested, which small on-device models fill
+ * unreliably. Known read tools are therefore registered with a flattened schema
+ * that is expanded back to the server's shape before the call. Tools without a
+ * mapping keep their native schema.
+ *
+ * @module
+ */
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { McpServerInfo, ModelContext } from '../../types.js';
+/**
+ * Convert one `{path: value}` entry into the server's filter object.
+ *
+ * Numeric values are coerced, since the comparison operators are numeric on the
+ * server while a model writes them inside a string.
+ */
+export declare function toFieldFilter(path: string, value: unknown): Record<string, unknown>;
+/**
+ * Parse a filter object however the model expressed it.
+ *
+ * Asked for `{"path": "value"}`, models produce a real object, a JSON string,
+ * or a JavaScript-like string with unquoted keys. All three mean the same
+ * thing, and rejecting any of them would silently drop the constraint and
+ * return unfiltered results.
+ *
+ * @param raw - The value the model supplied.
+ * @returns The parsed object, or null when there is nothing to read.
+ */
+export declare function parseLooseObject(input: unknown): Record<string, unknown> | null;
+/**
+ * Flatten a nested filter object into the dot-paths the schema asks for.
+ *
+ * Models mirror the shape of the data they saw in the last response, which is
+ * nested, so `{aggregateRating: {ratingValue: ">=4.5"}}` becomes
+ * `{"aggregateRating.ratingValue": ">=4.5"}`.
+ */
+export declare function flattenPaths(obj: Record<string, unknown>, prefix?: string, out?: Record<string, unknown>): Record<string, unknown>;
+/** The model's flat arguments, as the server's nested query. */
+export declare function mapQueryArgs(i: Record<string, unknown>): Record<string, unknown>;
+/** Options for {@link registerRemoteTools}. */
+export interface BridgeOptions {
+    /**
+     * Choose which of the server's tools reach the page.
+     *
+     * Rarely needed: the default excludes only {@link SERVER_ONLY_TOOLS}.
+     *
+     * @param name - The remote tool's name.
+     * @returns True to register it.
+     */
+    accept?(name: string): boolean;
+}
+/**
+ * Register every accepted remote tool into a model context.
+ *
+ * Each registered tool proxies execution to `client`, translating arguments
+ * from the flattened schema and the result back into a WebMCP response.
+ *
+ * @param client - The connected MCP client.
+ * @param mc - The registry to register into.
+ * @param info - The server's connection details.
+ * @param options - A tool filter.
+ * @returns The names of the tools registered.
+ */
+export declare function registerRemoteTools(client: Client, mc: ModelContext, info: McpServerInfo, opts?: BridgeOptions): Promise<string[]>;
+//# sourceMappingURL=bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,KAAK,EAEV,aAAa,EACb,YAAY,EAEb,MAAM,gBAAgB,CAAC;AAoGxB;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBnF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAmC/E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,MAAM,SAAK,EACX,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBhF;AA6CD,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,aAAa,EACnB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,MAAM,EAAE,CAAC,CA8BnB"}

package/dist/harness/tools/bridge.js

@@ -0,0 +1,271 @@
+const isSet = (v) => v != null && String(v).trim() !== '';
+/** Simplified surfaces for the public typed-retrieval tools. */
+const TOOL_OVERRIDES = {
+    nxis_list_types: {
+        description: "Lists the schema.org types present in this site's data (with counts). Call this first to discover what to query.",
+        inputSchema: { type: 'object', properties: {} },
+        mapArgs: () => ({}),
+        readOnly: true,
+    },
+    nxis_get: {
+        description: 'Fetches one entity by its JSON-LD @id (as returned by nxis_query). Returns the full record.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'The JSON-LD @id of the entity to fetch.' },
+            },
+            required: ['id'],
+        },
+        mapArgs: (i) => ({ id: i.id }),
+        readOnly: true,
+    },
+    nxis_query: {
+        description: "Searches the site's typed records by schema.org type, with optional natural-language text " +
+            '(use it for locations or keywords), numeric or exact filters on any field, and sorting. ' +
+            'Call nxis_list_types first to pick a valid type.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                schema_type: {
+                    type: 'string',
+                    description: "schema.org type to search, e.g. 'Electrician', 'LocalBusiness', 'Product'.",
+                },
+                text: {
+                    type: 'string',
+                    // Deliberately generic: this text reaches the model on every site
+                    // that installs the package, so a concrete example from one
+                    // deployment would bias the rest.
+                    description: 'Optional natural-language query — keywords and/or a location.',
+                },
+                filters: {
+                    type: 'object',
+                    // The server takes an array of {path, operator, value} objects,
+                    // three nested decisions per constraint. A flat object with the
+                    // comparison written into the value is a shape a small model can
+                    // reliably produce; it is expanded before the call.
+                    description: 'Optional exact or numeric filters, as {field path: value}. ' +
+                        'Prefix a number with >=, >, <= or < to compare, e.g. ' +
+                        '{"aggregateRating.ratingValue": ">=4.5"}. A plain value matches exactly, ' +
+                        'and a list matches any of its entries.',
+                },
+                sort: {
+                    type: 'string',
+                    description: 'Optional field path to sort by. Prefix with "-" for highest first, e.g. ' +
+                        '"-aggregateRating.ratingValue".',
+                },
+                limit: { type: 'integer', description: 'Maximum results to return (1-100).', default: 10 },
+            },
+            required: ['schema_type'],
+        },
+        mapArgs: (i) => mapQueryArgs(i),
+        readOnly: true,
+    },
+};
+/** Comparison prefixes the model may write into a filter value. */
+const COMPARISONS = [
+    ['>=', 'GREATER_THAN_OR_EQUAL'],
+    ['<=', 'LESS_THAN_OR_EQUAL'],
+    ['>', 'GREATER_THAN'],
+    ['<', 'LESS_THAN'],
+];
+/**
+ * Convert one `{path: value}` entry into the server's filter object.
+ *
+ * Numeric values are coerced, since the comparison operators are numeric on the
+ * server while a model writes them inside a string.
+ */
+export function toFieldFilter(path, value) {
+    if (Array.isArray(value))
+        return { path, operator: 'IN', value };
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        for (const [prefix, operator] of COMPARISONS) {
+            if (trimmed.startsWith(prefix)) {
+                const rest = trimmed.slice(prefix.length).trim();
+                const num = Number(rest);
+                return { path, operator, value: Number.isFinite(num) ? num : rest };
+            }
+        }
+        const num = Number(trimmed);
+        // An equality written as "4.5" means the number: a string would not match
+        // a numeric field.
+        return { path, operator: 'EQUALS', value: trimmed !== '' && Number.isFinite(num) ? num : trimmed };
+    }
+    return { path, operator: 'EQUALS', value };
+}
+/**
+ * Parse a filter object however the model expressed it.
+ *
+ * Asked for `{"path": "value"}`, models produce a real object, a JSON string,
+ * or a JavaScript-like string with unquoted keys. All three mean the same
+ * thing, and rejecting any of them would silently drop the constraint and
+ * return unfiltered results.
+ *
+ * @param raw - The value the model supplied.
+ * @returns The parsed object, or null when there is nothing to read.
+ */
+export function parseLooseObject(input) {
+    if (input && typeof input === 'object' && !Array.isArray(input)) {
+        return input;
+    }
+    if (typeof input !== 'string')
+        return null;
+    const text = input.trim();
+    if (!text)
+        return null;
+    // `path >= value`, written with no braces at all.
+    const bare = text.match(/^([\w.\-]+)\s*(>=|<=|>|<|=)\s*(.+)$/);
+    if (bare && !text.startsWith('{')) {
+        const [, path, op, value] = bare;
+        return { [path]: op === '=' ? value.trim() : `${op}${value.trim()}` };
+    }
+    if (!text.startsWith('{'))
+        return null;
+    const attempts = [
+        text,
+        // Quote bare keys, and normalise single quotes to double.
+        text.replace(/([{,]\s*)([A-Za-z_][\w.\-]*)\s*:/g, '$1"$2":').replace(/'/g, '"'),
+    ];
+    // Last resort: quote bare word values too, as in `{brand: Rheem}`.
+    attempts.push(attempts[1].replace(/:\s*([A-Za-z_][\w .\-]*?)\s*([,}])/g, ': "$1"$2'));
+    for (const attempt of attempts) {
+        try {
+            const parsed = JSON.parse(attempt);
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            /* try the next shape */
+        }
+    }
+    return null;
+}
+/**
+ * Flatten a nested filter object into the dot-paths the schema asks for.
+ *
+ * Models mirror the shape of the data they saw in the last response, which is
+ * nested, so `{aggregateRating: {ratingValue: ">=4.5"}}` becomes
+ * `{"aggregateRating.ratingValue": ">=4.5"}`.
+ */
+export function flattenPaths(obj, prefix = '', out = {}) {
+    for (const [key, value] of Object.entries(obj)) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            flattenPaths(value, path, out);
+        }
+        else {
+            out[path] = value;
+        }
+    }
+    return out;
+}
+/** The model's flat arguments, as the server's nested query. */
+export function mapQueryArgs(i) {
+    const filter = { schema_type: i.schema_type };
+    const filters = parseLooseObject(i.filters);
+    if (filters) {
+        const fieldFilters = Object.entries(flattenPaths(filters))
+            .filter(([path, value]) => path && value !== undefined && value !== null && value !== '')
+            .map(([path, value]) => toFieldFilter(path, value));
+        if (fieldFilters.length)
+            filter.field_filters = fieldFilters;
+    }
+    if (isSet(i.sort)) {
+        const raw = String(i.sort).trim();
+        const descending = raw.startsWith('-');
+        filter.sort_option = {
+            property: descending ? raw.slice(1) : raw,
+            order: descending ? 'DESCENDING' : 'ASCENDING',
+        };
+    }
+    const args = { filter };
+    if (isSet(i.text))
+        args.text = i.text;
+    if (i.limit != null)
+        args.limit = i.limit;
+    return args;
+}
+/**
+ * Whether a tool may run without a confirmation step.
+ *
+ * Fails closed: a tool whose server declares no `readOnlyHint` is treated as a
+ * write. The harness runs reads as soon as their arguments are satisfied, so
+ * defaulting an unannotated tool to read-only would fire it unattended. Being
+ * wrong this way costs one extra confirmation; being wrong the other way sends
+ * data on the user's behalf.
+ */
+function isReadOnly(tool, override) {
+    if (override)
+        return override.readOnly;
+    const declared = tool.annotations?.readOnlyHint;
+    return declared === true;
+}
+/**
+ * List the server's tools, falling back to the tools its card advertises when
+ * `tools/list` is unavailable.
+ */
+async function listRemoteTools(client, info) {
+    try {
+        const res = await client.listTools();
+        return res.tools;
+    }
+    catch (err) {
+        console.warn('[nxis-mcp] tools/list failed; falling back to card publicTools', err);
+        return info.publicTools.map((name) => ({ name }));
+    }
+}
+/**
+ * Tools excluded from the browser agent's toolset by default.
+ *
+ * `nxis_action` performs a site's write actions server-side, addressed by
+ * JSON-LD `@id` and authenticated with an API key. That suits an external MCP
+ * client, which has a key and no page, but duplicates the page's own action
+ * tools, which are generated from the same Schema.org actions and can show the
+ * user what is about to be submitted. Bridging both would offer two routes to
+ * the same outcome, and add the excluded tool's schema to every prompt.
+ *
+ * Override with {@link BridgeOptions.accept}.
+ */
+const SERVER_ONLY_TOOLS = new Set(['nxis_action']);
+/**
+ * Register every accepted remote tool into a model context.
+ *
+ * Each registered tool proxies execution to `client`, translating arguments
+ * from the flattened schema and the result back into a WebMCP response.
+ *
+ * @param client - The connected MCP client.
+ * @param mc - The registry to register into.
+ * @param info - The server's connection details.
+ * @param options - A tool filter.
+ * @returns The names of the tools registered.
+ */
+export async function registerRemoteTools(client, mc, info, opts = {}) {
+    const accept = opts.accept ?? ((name) => !SERVER_ONLY_TOOLS.has(name));
+    const tools = (await listRemoteTools(client, info)).filter((t) => accept(t.name));
+    const registered = [];
+    for (const tool of tools) {
+        const override = TOOL_OVERRIDES[tool.name];
+        mc.registerTool({
+            name: tool.name,
+            description: override?.description ?? tool.description ?? '',
+            // Prefer the simplified schema; otherwise pass the native one through.
+            inputSchema: override?.inputSchema ?? tool.inputSchema ?? { type: 'object' },
+            // The harness reads this to decide whether to run the tool outright, so
+            // it must not be optimistic. See isReadOnly.
+            annotations: { ...(tool.annotations ?? {}), readOnlyHint: isReadOnly(tool, override) },
+            execute: async (input) => {
+                const args = override ? override.mapArgs(input ?? {}) : (input ?? {});
+                const result = await client.callTool({ name: tool.name, arguments: args });
+                return {
+                    content: result.content ?? [],
+                    isError: result.isError,
+                    structuredContent: result.structuredContent,
+                };
+            },
+        });
+        registered.push(tool.name);
+    }
+    return registered;
+}
+//# sourceMappingURL=bridge.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * Connects an MCP client to a discovered server over Streamable HTTP.
+ *
+ * @module
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { McpServerInfo } from '../../types.js';
+/** Open an initialized MCP session to `info.endpoint`. Pass `apiKey` only for
+ * private tools. Public typed retrieval needs no credential. */
+export declare function connectMcp(info: McpServerInfo, apiKey?: string): Promise<Client>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;gEACgE;AAChE,wBAAsB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CActF"}

package/dist/harness/tools/client.js

@@ -0,0 +1,21 @@
+/**
+ * Connects an MCP client to a discovered server over Streamable HTTP.
+ *
+ * @module
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+/** Open an initialized MCP session to `info.endpoint`. Pass `apiKey` only for
+ * private tools. Public typed retrieval needs no credential. */
+export async function connectMcp(info, apiKey) {
+    const headers = {};
+    if (apiKey && info.authHeaderName)
+        headers[info.authHeaderName] = apiKey;
+    const transport = new StreamableHTTPClientTransport(new URL(info.endpoint), {
+        requestInit: { headers },
+    });
+    const client = new Client({ name: 'nxisai-browser-agent', version: '1.0.0' }, { capabilities: {} });
+    await client.connect(transport);
+    return client;
+}
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/harness/tools/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAGnG;gEACgE;AAChE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAmB,EAAE,MAAe;IACnE,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,MAAM,IAAI,IAAI,CAAC,cAAc;QAAE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC;IAEzE,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;QAC1E,WAAW,EAAE,EAAE,OAAO,EAAE;KACzB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,EAAE,EAClD,EAAE,YAAY,EAAE,EAAE,EAAE,CACrB,CAAC;IACF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC"}