@nxisai/agent-harness 0.2.0

package/dist/a2ui/stepper.js.map

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

package/dist/a2ui/theme.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Theme tokens for A2UI surfaces.
+ *
+ * The Lit renderer styles its components entirely through `--a2ui-*` custom
+ * properties. Those inherit across shadow boundaries, so setting them on the
+ * element containing `<a2ui-surface>` restyles everything inside it without
+ * `::part()`, a forked catalog, or a patched package.
+ *
+ * Values map onto the tokens the packaged element already declares, so surfaces
+ * follow the same palette rather than carrying a second copy of it.
+ *
+ * The rules encoded here:
+ *   - sans first: Manrope for the title, Inter for everything readable
+ *   - mono for labels only: field labels and tags, never body copy
+ *   - blue for trust and action: the primary button and focus ring
+ *   - light by default
+ */
+export declare const A2UI_THEME_CSS = "\n  .a2ui-scope {\n    /* Core roles */\n    --a2ui-color-primary: var(--blue);\n    --a2ui-color-primary-hover: var(--blue-strong);\n    --a2ui-color-primary-dark: var(--blue-strong);\n    --a2ui-color-primary-light: var(--blue-tint);\n    --a2ui-color-on-primary: #FFFFFF;\n    --a2ui-color-secondary: var(--surface);\n    --a2ui-color-secondary-hover: var(--surface-2);\n    --a2ui-color-on-secondary: var(--ink);\n    --a2ui-color-surface: var(--bg);\n    --a2ui-color-on-surface: var(--ink);\n    --a2ui-color-on-background: var(--ink);\n    --a2ui-color-border: var(--border);\n    --a2ui-color-input: var(--bg);\n    --a2ui-color-on-input: var(--ink);\n\n    /* Type \u2014 Manrope displays, Inter reads (design.md \u00A71) */\n    --a2ui-font-family-title: var(--display);\n    --a2ui-font-size-xs: 11px;   /* eyebrow / label size, matching .dc-row dt */\n    --a2ui-font-size-s: 13px;\n    --a2ui-font-size-m: 14px;\n    --a2ui-font-size-l: 18px;   /* markdown ### \u2192 .dc-title size */\n    --a2ui-font-size-xl: 22px;\n    --a2ui-font-size-2xl: 31px;\n    --a2ui-line-height-body: 1.65;\n    --a2ui-line-height-headings: 1.25;\n    --a2ui-text-color-text: var(--ink);\n    --a2ui-text-caption-color: var(--ink-3);  /* same muted label ink as .dc-row dt */\n    --a2ui-text-a-color: var(--blue);\n    --a2ui-text-a-font-weight: 600;\n\n    /* Radii \u2014 14px cards, 10px buttons, 999px pills (design.md \u00A71) */\n    --a2ui-border-radius: var(--radius-sm);\n    --a2ui-border: 1px solid var(--border);\n    --a2ui-border-width: 1px;\n\n    --a2ui-card-background: var(--bg);\n    --a2ui-card-border: 1px solid var(--border);\n    --a2ui-card-border-radius: var(--radius);\n    --a2ui-card-box-shadow: var(--shadow-sm);\n    /* 22px matches .detailcard, so an input card and a review card sitting in\n       the same thread share one rhythm rather than three inherited paddings. */\n    --a2ui-card-padding: 22px;\n    --a2ui-card-margin: 0;\n\n    /* Buttons: radius 10, weight 600, one primary per view (design.md \u00A74) */\n    --a2ui-button-border-radius: var(--radius-sm);\n    --a2ui-button-font-weight: 600;\n    --a2ui-button-padding: 11px 20px;\n    --a2ui-button-border: 1px solid var(--border-strong);\n    --a2ui-button-background: var(--bg);\n    --a2ui-button-box-shadow: none;\n    /* Buttons sit in a Row with its own gap; a margin here would double it. */\n    --a2ui-button-margin: 0;\n    /* The label is a Text child, so the button's own colour comes from the\n       secondary text token \u2014 this is what makes a default A2UI button read as\n       .btn.ghost rather than as unstyled chrome. */\n    --a2ui-color-on-secondary: var(--ink);\n    --a2ui-color-secondary-hover: var(--surface-2);\n\n    /* Inputs */\n    --a2ui-textfield-border: 1px solid var(--border);\n    --a2ui-textfield-border-radius: var(--radius-sm);\n    --a2ui-textfield-padding: 10px 12px;\n    --a2ui-textfield-color-border-focus: var(--blue);\n    --a2ui-textfield-color-error: var(--red);\n    --a2ui-textfield-label-font-size: 11px;\n    --a2ui-textfield-label-font-weight: 500;\n\n    --a2ui-checkbox-border: 1px solid var(--border-strong);\n    --a2ui-checkbox-border-radius: 6px;\n    --a2ui-checkbox-background: var(--bg);\n    --a2ui-checkbox-color-error: var(--red);\n    --a2ui-checkbox-size: 18px;\n    --a2ui-checkbox-gap: 10px;\n    --a2ui-checkbox-label-font-size: 14px;\n    --a2ui-checkbox-label-font-weight: 400;\n\n    /* Tags render as ChoicePicker chips / caption Text \u2014 pill radius */\n    --a2ui-choicepicker-chip-border-radius: var(--radius-pill);\n    --a2ui-choicepicker-chip-padding: 6px 12px;\n    --a2ui-choicepicker-label-color: var(--ink-3);\n    --a2ui-choicepicker-label-font-size: 11px;\n    --a2ui-choicepicker-label-font-weight: 500;\n\n    /* Rhythm */\n    --a2ui-spacing-xs: 4px;\n    --a2ui-spacing-s: 8px;\n    --a2ui-spacing-m: 12px;\n    --a2ui-spacing-l: 18px;\n    --a2ui-column-gap: 12px;\n    --a2ui-row-gap: 10px;\n    --a2ui-list-gap: 12px;\n    --a2ui-list-padding: 0;\n\n    font-family: var(--sans);\n    color: var(--ink);\n  }\n\n  /*\n   * Mono for labels only (design.md \u00A73.2). The renderer has no token for label\n   * *family*, only size and weight, so the eyebrow treatment is applied to the\n   * label elements directly. Scoped to .a2ui-scope so it cannot leak.\n   */\n  .a2ui-scope a2ui-surface::part(label),\n  .a2ui-scope label {\n    font-family: var(--mono);\n    letter-spacing: .14em;\n    text-transform: uppercase;\n    color: var(--ink-3);\n  }\n";
+/** Signal Blue — the one theme value A2UI itself carries on createSurface. */
+export declare const NXIS_PRIMARY = "#2563EB";
+//# sourceMappingURL=theme.d.ts.map

package/dist/a2ui/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/a2ui/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,cAAc,q8IAiH1B,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,YAAY,YAAY,CAAC"}

package/dist/a2ui/theme.js

@@ -0,0 +1,134 @@
+/**
+ * Theme tokens for A2UI surfaces.
+ *
+ * The Lit renderer styles its components entirely through `--a2ui-*` custom
+ * properties. Those inherit across shadow boundaries, so setting them on the
+ * element containing `<a2ui-surface>` restyles everything inside it without
+ * `::part()`, a forked catalog, or a patched package.
+ *
+ * Values map onto the tokens the packaged element already declares, so surfaces
+ * follow the same palette rather than carrying a second copy of it.
+ *
+ * The rules encoded here:
+ *   - sans first: Manrope for the title, Inter for everything readable
+ *   - mono for labels only: field labels and tags, never body copy
+ *   - blue for trust and action: the primary button and focus ring
+ *   - light by default
+ */
+export const A2UI_THEME_CSS = `
+  .a2ui-scope {
+    /* Core roles */
+    --a2ui-color-primary: var(--blue);
+    --a2ui-color-primary-hover: var(--blue-strong);
+    --a2ui-color-primary-dark: var(--blue-strong);
+    --a2ui-color-primary-light: var(--blue-tint);
+    --a2ui-color-on-primary: #FFFFFF;
+    --a2ui-color-secondary: var(--surface);
+    --a2ui-color-secondary-hover: var(--surface-2);
+    --a2ui-color-on-secondary: var(--ink);
+    --a2ui-color-surface: var(--bg);
+    --a2ui-color-on-surface: var(--ink);
+    --a2ui-color-on-background: var(--ink);
+    --a2ui-color-border: var(--border);
+    --a2ui-color-input: var(--bg);
+    --a2ui-color-on-input: var(--ink);
+
+    /* Type — Manrope displays, Inter reads (design.md §1) */
+    --a2ui-font-family-title: var(--display);
+    --a2ui-font-size-xs: 11px;   /* eyebrow / label size, matching .dc-row dt */
+    --a2ui-font-size-s: 13px;
+    --a2ui-font-size-m: 14px;
+    --a2ui-font-size-l: 18px;   /* markdown ### → .dc-title size */
+    --a2ui-font-size-xl: 22px;
+    --a2ui-font-size-2xl: 31px;
+    --a2ui-line-height-body: 1.65;
+    --a2ui-line-height-headings: 1.25;
+    --a2ui-text-color-text: var(--ink);
+    --a2ui-text-caption-color: var(--ink-3);  /* same muted label ink as .dc-row dt */
+    --a2ui-text-a-color: var(--blue);
+    --a2ui-text-a-font-weight: 600;
+
+    /* Radii — 14px cards, 10px buttons, 999px pills (design.md §1) */
+    --a2ui-border-radius: var(--radius-sm);
+    --a2ui-border: 1px solid var(--border);
+    --a2ui-border-width: 1px;
+
+    --a2ui-card-background: var(--bg);
+    --a2ui-card-border: 1px solid var(--border);
+    --a2ui-card-border-radius: var(--radius);
+    --a2ui-card-box-shadow: var(--shadow-sm);
+    /* 22px matches .detailcard, so an input card and a review card sitting in
+       the same thread share one rhythm rather than three inherited paddings. */
+    --a2ui-card-padding: 22px;
+    --a2ui-card-margin: 0;
+
+    /* Buttons: radius 10, weight 600, one primary per view (design.md §4) */
+    --a2ui-button-border-radius: var(--radius-sm);
+    --a2ui-button-font-weight: 600;
+    --a2ui-button-padding: 11px 20px;
+    --a2ui-button-border: 1px solid var(--border-strong);
+    --a2ui-button-background: var(--bg);
+    --a2ui-button-box-shadow: none;
+    /* Buttons sit in a Row with its own gap; a margin here would double it. */
+    --a2ui-button-margin: 0;
+    /* The label is a Text child, so the button's own colour comes from the
+       secondary text token — this is what makes a default A2UI button read as
+       .btn.ghost rather than as unstyled chrome. */
+    --a2ui-color-on-secondary: var(--ink);
+    --a2ui-color-secondary-hover: var(--surface-2);
+
+    /* Inputs */
+    --a2ui-textfield-border: 1px solid var(--border);
+    --a2ui-textfield-border-radius: var(--radius-sm);
+    --a2ui-textfield-padding: 10px 12px;
+    --a2ui-textfield-color-border-focus: var(--blue);
+    --a2ui-textfield-color-error: var(--red);
+    --a2ui-textfield-label-font-size: 11px;
+    --a2ui-textfield-label-font-weight: 500;
+
+    --a2ui-checkbox-border: 1px solid var(--border-strong);
+    --a2ui-checkbox-border-radius: 6px;
+    --a2ui-checkbox-background: var(--bg);
+    --a2ui-checkbox-color-error: var(--red);
+    --a2ui-checkbox-size: 18px;
+    --a2ui-checkbox-gap: 10px;
+    --a2ui-checkbox-label-font-size: 14px;
+    --a2ui-checkbox-label-font-weight: 400;
+
+    /* Tags render as ChoicePicker chips / caption Text — pill radius */
+    --a2ui-choicepicker-chip-border-radius: var(--radius-pill);
+    --a2ui-choicepicker-chip-padding: 6px 12px;
+    --a2ui-choicepicker-label-color: var(--ink-3);
+    --a2ui-choicepicker-label-font-size: 11px;
+    --a2ui-choicepicker-label-font-weight: 500;
+
+    /* Rhythm */
+    --a2ui-spacing-xs: 4px;
+    --a2ui-spacing-s: 8px;
+    --a2ui-spacing-m: 12px;
+    --a2ui-spacing-l: 18px;
+    --a2ui-column-gap: 12px;
+    --a2ui-row-gap: 10px;
+    --a2ui-list-gap: 12px;
+    --a2ui-list-padding: 0;
+
+    font-family: var(--sans);
+    color: var(--ink);
+  }
+
+  /*
+   * Mono for labels only (design.md §3.2). The renderer has no token for label
+   * *family*, only size and weight, so the eyebrow treatment is applied to the
+   * label elements directly. Scoped to .a2ui-scope so it cannot leak.
+   */
+  .a2ui-scope a2ui-surface::part(label),
+  .a2ui-scope label {
+    font-family: var(--mono);
+    letter-spacing: .14em;
+    text-transform: uppercase;
+    color: var(--ink-3);
+  }
+`;
+/** Signal Blue — the one theme value A2UI itself carries on createSurface. */
+export const NXIS_PRIMARY = '#2563EB';
+//# sourceMappingURL=theme.js.map

package/dist/a2ui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/a2ui/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiH7B,CAAC;AAEF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC"}

package/dist/a2ui/to-v09.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Downgrades A2UI v1.0 messages to v0.9.
+ *
+ * The emitters target v1.0, which is the documented spec and the one with
+ * published JSON Schemas, but available renderers support v0.9 and earlier, so
+ * messages are downgraded before rendering.
+ *
+ * Two mechanical differences:
+ *
+ *  1. `version` is the string "v0.9", not "v1.0".
+ *  2. v0.9's `createSurface` carries only surfaceId/catalogId: it rejects
+ *     inline `components` and `dataModel` as additional properties. They have
+ *     to follow as separate `updateComponents` / `updateDataModel` messages for
+ *     the same surfaceId. So one v1.0 message becomes up to three.
+ *
+ * No longer needed once a v1.0 renderer is available.
+ *
+ * @module
+ */
+import type { A2uiMessage } from './emit.js';
+type Msg = Record<string, any>;
+/**
+ * Downgrade v1.0 messages to v0.9.
+ *
+ * @param messages - The messages as authored by the emitters.
+ * @returns The equivalent v0.9 messages, which may be more numerous because a
+ * v1.0 surface creation splits into separate component and data updates.
+ */
+export declare function toV09(messages: A2uiMessage[]): Msg[];
+export {};
+//# sourceMappingURL=to-v09.d.ts.map

package/dist/a2ui/to-v09.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-v09.d.ts","sourceRoot":"","sources":["../../src/a2ui/to-v09.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AA0C/B;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,EAAE,CA6CpD"}

package/dist/a2ui/to-v09.js

@@ -0,0 +1,104 @@
+/**
+ * Downgrades A2UI v1.0 messages to v0.9.
+ *
+ * The emitters target v1.0, which is the documented spec and the one with
+ * published JSON Schemas, but available renderers support v0.9 and earlier, so
+ * messages are downgraded before rendering.
+ *
+ * Two mechanical differences:
+ *
+ *  1. `version` is the string "v0.9", not "v1.0".
+ *  2. v0.9's `createSurface` carries only surfaceId/catalogId: it rejects
+ *     inline `components` and `dataModel` as additional properties. They have
+ *     to follow as separate `updateComponents` / `updateDataModel` messages for
+ *     the same surfaceId. So one v1.0 message becomes up to three.
+ *
+ * No longer needed once a v1.0 renderer is available.
+ *
+ * @module
+ */
+import { NXIS_PRIMARY } from './theme.js';
+/**
+ * The catalog is versioned alongside the protocol, and the renderer looks it up
+ * by exact id, so a v1.0 id against a v0.9 catalog registry throws
+ * "Catalog not found" rather than falling back.
+ */
+const CATALOG_V1 = 'https://a2ui.org/specification/v1_0/catalogs/basic/catalog.json';
+const CATALOG_V09 = 'https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json';
+const downgradeCatalog = (id) => id === CATALOG_V1 ? CATALOG_V09 : id;
+/**
+ * v1.0 interpolates with `${expr}` inside a string. v0.9 has no interpolation
+ * at all: a dynamic value is a DataBinding object, `{ path }`. A `${title}`
+ * left as-is is not an error: it renders as the literal characters, which is
+ * how it first showed up on the verification page.
+ *
+ * Only a string that is *entirely* one expression can convert. "Hi ${name}"
+ * has no v0.9 equivalent, so it is left alone and will render literally; the
+ * emitters avoid mixed interpolation for that reason.
+ */
+const INTERPOLATION = /^\$\{([^}]+)\}$/;
+function bindStrings(value) {
+    if (typeof value === 'string') {
+        const m = INTERPOLATION.exec(value);
+        return m ? { path: m[1] } : value;
+    }
+    if (Array.isArray(value))
+        return value.map(bindStrings);
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            // Identity and structure keys are never data-bound.
+            out[k] = k === 'id' || k === 'component' || k === 'componentId' ? v : bindStrings(v);
+        }
+        return out;
+    }
+    return value;
+}
+/**
+ * Downgrade v1.0 messages to v0.9.
+ *
+ * @param messages - The messages as authored by the emitters.
+ * @returns The equivalent v0.9 messages, which may be more numerous because a
+ * v1.0 surface creation splits into separate component and data updates.
+ */
+export function toV09(messages) {
+    const out = [];
+    for (const msg of messages) {
+        if (msg.createSurface) {
+            const { surfaceId, catalogId, components, dataModel } = msg.createSurface;
+            // `theme` exists in v0.9 and was dropped in v1.0, so it is set here
+            // rather than in the emitters, which must stay v1.0-valid. The CSS
+            // custom properties do the real styling; this carries the accent for any
+            // renderer that never sees our stylesheet.
+            out.push({
+                version: 'v0.9',
+                createSurface: {
+                    surfaceId,
+                    catalogId: downgradeCatalog(catalogId),
+                    theme: { primaryColor: NXIS_PRIMARY },
+                },
+            });
+            if (components) {
+                out.push({ version: 'v0.9', updateComponents: { surfaceId, components: bindStrings(components) } });
+            }
+            // v0.9 patches one path at a time, so a whole-model seed becomes one
+            // message per top-level key rather than a single root write. The payload
+            // key is `value` and the object is additionalProperties:false, so a
+            // wrong name here is rejected outright rather than ignored.
+            if (dataModel) {
+                for (const [key, value] of Object.entries(dataModel)) {
+                    out.push({ version: 'v0.9', updateDataModel: { surfaceId, path: `/${key}`, value } });
+                }
+            }
+            continue;
+        }
+        if (msg.updateDataModel) {
+            const { surfaceId, path, value } = msg.updateDataModel;
+            out.push({ version: 'v0.9', updateDataModel: { surfaceId, path, value } });
+            continue;
+        }
+        out.push({ ...msg, version: 'v0.9' });
+    }
+    return out;
+}
+//# sourceMappingURL=to-v09.js.map

package/dist/a2ui/to-v09.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-v09.js","sourceRoot":"","sources":["../../src/a2ui/to-v09.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI1C;;;;GAIG;AACH,MAAM,UAAU,GAAG,iEAAiE,CAAC;AACrF,MAAM,WAAW,GAAG,iEAAiE,CAAC;AAEtF,MAAM,gBAAgB,GAAG,CAAC,EAAsB,EAAsB,EAAE,CACtE,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAExC,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACpC,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAAQ,EAAE,CAAC;QACpB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAY,CAAC,EAAE,CAAC;YAClD,oDAAoD;YACpD,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAAC,QAAuB;IAC3C,MAAM,GAAG,GAAU,EAAE,CAAC;IAEtB,KAAK,MAAM,GAAG,IAAI,QAA4B,EAAE,CAAC;QAC/C,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;YACtB,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,aAAa,CAAC;YAE1E,oEAAoE;YACpE,mEAAmE;YACnE,yEAAyE;YACzE,2CAA2C;YAC3C,GAAG,CAAC,IAAI,CAAC;gBACP,OAAO,EAAE,MAAM;gBACf,aAAa,EAAE;oBACb,SAAS;oBACT,SAAS,EAAE,gBAAgB,CAAC,SAAS,CAAC;oBACtC,KAAK,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE;iBACtC;aACF,CAAC,CAAC;YAEH,IAAI,UAAU,EAAE,CAAC;gBACf,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;YACtG,CAAC;YACD,qEAAqE;YACrE,yEAAyE;YACzE,oEAAoE;YACpE,4DAA4D;YAC5D,IAAI,SAAS,EAAE,CAAC;gBACd,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;oBACrD,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBACxF,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;YACxB,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,eAAe,CAAC;YACvD,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC3E,SAAS;QACX,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,209 @@
+/**
+ * The bundled model provider, plus the shared constants and helpers the UI
+ * layer draws on.
+ *
+ * {@link LocalGemmaProvider} runs Gemma 4 (E2B) in the browser through
+ * Transformers.js on WebGPU. The runtime is fetched from a CDN at first use
+ * rather than bundled, so installing this package does not pull in a model
+ * runtime, and the weights are cached by the browser after the first load.
+ *
+ * @module
+ */
+import type { ChatMessage, GenerationUsage, ModelContextToolInfo, ParsedToolCall, PreloadMode, ProgressDetail, ToolDef } from './types.js';
+import type { Completion, CompletionRequest, ModelProvider } from './providers/types.js';
+export type { ChatMessage, GenerationUsage, ParsedToolCall, PreloadMode, ProgressDetail, ToolDef, };
+export declare const TRANSFORMERS_CDN = "https://cdn.jsdelivr.net/npm/@huggingface/transformers@4.2.0";
+/** The Hugging Face repository the weights are loaded from. */
+export declare const MODEL_ID = "onnx-community/gemma-4-E2B-it-ONNX";
+/** Origin to load weights from. Empty serves them from the Hugging Face Hub. */
+export declare const MODEL_HOST = "";
+/** Path template applied under {@link MODEL_HOST}. `{model}` is substituted. */
+export declare const MODEL_PATH_TEMPLATE = "{model}/";
+/** Generations allowed per goal. One is enough unless the model must retry. */
+export declare const MAX_STEPS = 3;
+/** Default token ceiling for one generation. */
+export declare const MAX_NEW_TOKENS = 512;
+/** How long {@link WebMcpTools.waitForTools} waits for tools to register. */
+export declare const TOOLS_TIMEOUT_MS = 20000;
+/**
+ * The default instructions, used when no `systemPrompt` is supplied.
+ *
+ * Directs the model to call a tool as soon as it knows which one applies, with
+ * whatever fields it has, because the harness collects the rest.
+ */
+export declare const SYSTEM_PROMPT: string;
+/** Where the attribution badge points. */
+export declare const NXIS_SITE_URL = "https://nxis.ai";
+export declare const NXIS_LOGO_SVG = "<svg viewBox=\"0 0 39.6 30.4\" xmlns=\"http://www.w3.org/2000/svg\" aria-hidden=\"true\">\n  <defs>\n    <radialGradient id=\"nx-g1\" cx=\"20.65\" cy=\"-40.83\" fx=\"20.65\" fy=\"-40.83\" r=\"14.12\" gradientTransform=\"translate(0 -25.62) scale(1 -1)\" gradientUnits=\"userSpaceOnUse\">\n      <stop offset=\"0\" stop-color=\"#3f9cf8\"/><stop offset=\".22\" stop-color=\"#3891f6\"/><stop offset=\".59\" stop-color=\"#2675f3\"/><stop offset=\".79\" stop-color=\"#1c64f2\"/>\n    </radialGradient>\n    <radialGradient id=\"nx-g2\" cx=\"8.54\" cy=\"485.55\" fx=\"8.54\" fy=\"485.55\" r=\"11.08\" gradientTransform=\"translate(0 -294)\" href=\"#nx-g1\"/>\n    <radialGradient id=\"nx-g3\" cx=\"31.03\" cy=\"479.6\" fx=\"31.03\" fy=\"479.6\" r=\"10.02\" gradientTransform=\"translate(0 -294)\" href=\"#nx-g1\"/>\n  </defs>\n  <path fill=\"url(#nx-g1)\" d=\"M33.65.1c-1,1.7-1.9,3.2-2.7,4.7-4.8,8.3-9.6,16.6-14.4,24.9-.3.5-.5.6-1.1.6h-7.8c.2-.2.2-.4.3-.6C13.55,20,19.15,10.3,24.75.6c.2-.4.5-.6,1-.6h7.1c.3.1.4.1.8.1h0Z\"/>\n  <path fill=\"url(#nx-g2)\" d=\"M17.15.1c-1.2,2.1-2.3,4-3.5,6-1.7,2.9-3.3,5.8-5,8.6-.2.4-.3.7,0,1.2.6.9,1.1,1.8,1.6,2.7.1.2.2.5.1.6-1.3,2.3-2.7,4.7-4.1,7.1-.2-.3-.3-.4-.4-.6-1.9-3.3-3.8-6.6-5.7-9.8-.2-.4-.2-.7,0-1.1C2.85,10.1,5.55,5.4,8.25.7c.3-.4.6-.6,1.1-.6C11.85.1,14.45,0,17.15.1h0Z\"/>\n  <path fill=\"url(#nx-g3)\" d=\"M22.45,30.3c4.4-7.6,8.7-15,13-22.5.1.2.2.3.3.5,1.2,2.1,2.4,4.2,3.7,6.3.2.4.2.7,0,1-2.7,4.7-5.5,9.4-8.2,14.2-.2.4-.5.6-1,.6-2.5-.1-5.1,0-7.8-.1h0Z\"/>\n</svg>";
+/** Heroicon `check-circle`, for a success state. */
+export declare const ICON_CHECK = "<svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\" stroke=\"currentColor\" aria-hidden=\"true\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 12.75 11.25 15 15 9.75M21 12a9 9 0 1 1-18 0 9 9 0 0 1 18 0Z\"/></svg>";
+/** Heroicon `exclamation-triangle`, for an error state. */
+export declare const ICON_WARN = "<svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\" stroke=\"currentColor\" aria-hidden=\"true\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M12 9v3.75m-9.303 3.376c-.866 1.5.217 3.374 1.948 3.374h14.71c1.73 0 2.813-1.874 1.948-3.374L13.949 3.378c-.866-1.5-3.032-1.5-3.898 0L2.697 16.126ZM12 15.75h.007v.008H12v-.008Z\"/></svg>";
+/** Heroicon `arrow-long-right`, for send and submit controls. */
+export declare const ICON_ARROW = "<svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"2\" stroke=\"currentColor\" aria-hidden=\"true\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M13.5 4.5 21 12m0 0-7.5 7.5M21 12H3\"/></svg>";
+/** Heroicon `cog-6-tooth`, for settings. */
+export declare const ICON_GEAR = "<svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\" stroke=\"currentColor\" aria-hidden=\"true\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9.594 3.94c.09-.542.56-.94 1.11-.94h2.593c.55 0 1.02.398 1.11.94l.213 1.281c.063.374.313.686.645.87.074.04.147.083.22.127.324.196.72.257 1.075.124l1.217-.456a1.125 1.125 0 0 1 1.37.49l1.296 2.247a1.125 1.125 0 0 1-.26 1.431l-1.003.827c-.293.24-.438.613-.43.992a7.723 7.723 0 0 1 0 .255c-.008.378.137.75.43.991l1.004.827c.424.35.534.955.26 1.43l-1.298 2.247a1.125 1.125 0 0 1-1.369.491l-1.217-.456c-.355-.133-.75-.072-1.076.124a6.47 6.47 0 0 1-.22.128c-.331.183-.581.495-.644.869l-.213 1.281c-.09.543-.56.94-1.11.94h-2.594c-.55 0-1.019-.398-1.11-.94l-.213-1.281c-.062-.374-.312-.686-.644-.87a6.52 6.52 0 0 1-.22-.127c-.325-.196-.72-.257-1.076-.124l-1.217.456a1.125 1.125 0 0 1-1.369-.49l-1.297-2.247a1.125 1.125 0 0 1 .26-1.431l1.004-.827c.292-.24.437-.613.43-.991a6.932 6.932 0 0 1 0-.255c.007-.38-.138-.751-.43-.992l-1.004-.827a1.125 1.125 0 0 1-.26-1.43l1.297-2.247a1.125 1.125 0 0 1 1.37-.491l1.216.456c.356.133.751.072 1.076-.124.072-.044.146-.087.22-.128.332-.183.582-.495.644-.869l.214-1.281Z\"/><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M15 12a3 3 0 1 1-6 0 3 3 0 0 1 6 0Z\"/></svg>";
+/** Heroicon `plus`, for a new conversation. */
+export declare const ICON_PLUS = "<svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"2\" stroke=\"currentColor\" aria-hidden=\"true\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M12 4.5v15m7.5-7.5h-15\"/></svg>";
+/** Heroicon `bars-3`, for the conversation drawer. */
+export declare const ICON_MENU = "<svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.8\" stroke=\"currentColor\" aria-hidden=\"true\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M3.75 6.75h16.5M3.75 12h16.5M3.75 17.25h16.5\"/></svg>";
+/** Heroicon `stop`, shown on the send button while a turn can be stopped. */
+export declare const ICON_STOP = "<svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.8\" stroke=\"currentColor\" aria-hidden=\"true\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M5.25 7.5A2.25 2.25 0 0 1 7.5 5.25h9a2.25 2.25 0 0 1 2.25 2.25v9a2.25 2.25 0 0 1-2.25 2.25h-9a2.25 2.25 0 0 1-2.25-2.25v-9Z\"/></svg>";
+/** Heroicon `clipboard-document`, for copying a message. */
+export declare const ICON_COPY = "<svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\" stroke=\"currentColor\" aria-hidden=\"true\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M15.666 3.888A2.25 2.25 0 0 0 13.5 2.25h-3c-1.03 0-1.9.693-2.166 1.638m7.332 0c.055.194.084.4.084.612v0a.75.75 0 0 1-.75.75H9a.75.75 0 0 1-.75-.75v0c0-.212.03-.418.084-.612m7.332 0c.646.049 1.288.11 1.927.184 1.1.128 1.907 1.077 1.907 2.185V19.5a2.25 2.25 0 0 1-2.25 2.25H6.75A2.25 2.25 0 0 1 4.5 19.5V6.257c0-1.108.806-2.057 1.907-2.185a48.208 48.208 0 0 1 1.927-.184\"/></svg>";
+/** Heroicon `pencil-square`, for editing a message. */
+export declare const ICON_PENCIL = "<svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\" stroke=\"currentColor\" aria-hidden=\"true\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M16.862 4.487l1.687-1.688a1.875 1.875 0 1 1 2.652 2.652L10.582 16.07a4.5 4.5 0 0 1-1.897 1.13L6 18l.8-2.685a4.5 4.5 0 0 1 1.13-1.897l8.932-8.931Zm0 0L19.5 7.125M18 14v4.75A2.25 2.25 0 0 1 15.75 21H5.25A2.25 2.25 0 0 1 3 18.75V8.25A2.25 2.25 0 0 1 5.25 6H10\"/></svg>";
+/** Heroicon `arrow-path`, for sending a message again. */
+export declare const ICON_REDO = "<svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\" stroke=\"currentColor\" aria-hidden=\"true\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M16.023 9.348h4.992v-.001M2.985 19.644v-4.992m0 0h4.992m-4.993 0 3.181 3.183a8.25 8.25 0 0 0 13.803-3.7M4.031 9.865a8.25 8.25 0 0 1 13.803-3.7l3.181 3.182m0-4.991v4.99\"/></svg>";
+/** Heroicon `check`, the confirmation shown after a copy. */
+export declare const ICON_CHECK_MARK = "<svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"2\" stroke=\"currentColor\" aria-hidden=\"true\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M4.5 12.75l6 6 9-13.5\"/></svg>";
+/** Heroicon `trash`, for deleting a conversation. */
+export declare const ICON_TRASH = "<svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\" stroke=\"currentColor\" aria-hidden=\"true\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"m14.74 9-.346 9m-4.788 0L9.26 9m9.968-3.21c.342.052.682.107 1.022.166m-1.022-.165L18.16 19.673a2.25 2.25 0 0 1-2.244 2.077H8.084a2.25 2.25 0 0 1-2.244-2.077L4.772 5.79m14.456 0a48.108 48.108 0 0 0-3.478-.397m-12 .562c.34-.059.68-.114 1.022-.165m0 0a48.11 48.11 0 0 1 3.478-.397m7.5 0v-.916c0-1.18-.91-2.164-2.09-2.201a51.964 51.964 0 0 0-3.32 0c-1.18.037-2.09 1.022-2.09 2.201v.916m7.5 0a48.667 48.667 0 0 0-7.5 0\"/></svg>";
+export declare function humanize(s: unknown): string;
+/** Lower-case the first character, for a name used mid-sentence. */
+export declare function lcFirst(s: string): string;
+/** Escape `&`, `<`, `>` and `"` for interpolation into markup. */
+export declare function escapeHtml(s: unknown): string;
+/** Extract a tool call from model output, or null for a plain answer. */
+export declare function parseToolCall(text: string): ParsedToolCall | null;
+/** Strip tool-call blocks and special tokens for human-readable display. */
+export declare function stripMarkers(text: string): string;
+/** Options for {@link LocalGemmaProvider}. */
+export interface AgentEngineOptions {
+    modelHost?: string;
+    modelPathTemplate?: string;
+    /** Override the generic form-filling SYSTEM_PROMPT (e.g. a domain skill). */
+    systemPrompt?: string;
+    onStatus?: (text: string, isError?: boolean) => void;
+    onProgress?: (pct: number, detail?: ProgressDetail) => void;
+    /**
+     * Whether Transformers.js may keep model files in Cache Storage.
+     *
+     * Defaults to true, which is the difference between downloading the weights
+     * once and on every visit. Set false only where the cache itself is failing.
+     */
+    useBrowserCache?: boolean;
+}
+interface LoadedEngine {
+    tokenizer: any;
+    model: any;
+}
+/**
+ * The default provider: Gemma 4 (E2B) running on WebGPU in the browser.
+ *
+ * Owns everything model-specific, including fetching Transformers.js and the
+ * weights, applying the chat template, and parsing Gemma's tool-call markers,
+ * so that the harness sees only text and structured calls.
+ *
+ * @example
+ * ```ts
+ * const provider = new LocalGemmaProvider({ useBrowserCache: true });
+ * const harness = new AgentHarness({ renderer, provider });
+ * ```
+ */
+export declare class LocalGemmaProvider implements ModelProvider {
+    readonly name = "gemma-4-e2b";
+    readonly local = true;
+    modelHost: string;
+    modelPathTemplate: string;
+    systemPrompt: string;
+    onStatus: (text: string, isError?: boolean) => void;
+    onProgress: (pct: number, detail?: ProgressDetail) => void;
+    useBrowserCache: boolean;
+    /** True when this load dropped the cache because the last one never returned. */
+    cacheDisabledAfterCrash: boolean;
+    engine: LoadedEngine | null;
+    T: any;
+    private _enginePromise;
+    private _progress;
+    constructor(opts?: AgentEngineOptions);
+    /**
+     * Whether the weights are loaded and usable right now.
+     *
+     * Side-effect free: reading it does not start a load. Use it to distinguish a
+     * first visit, where a load takes tens of seconds, from a warm one.
+     */
+    get ready(): boolean;
+    /**
+     * Whether a load is in flight.
+     *
+     * Distinct from {@link LocalGemmaProvider.ready}: both false means nothing
+     * has been requested yet, while `loading` alone means a download is running.
+     */
+    get loading(): boolean;
+    private _status;
+    /**
+     * Begin downloading the weights in the background.
+     *
+     * @param mode - `'idle'` waits for the browser to be free, keeping the
+     * download off the critical path of the host page. `'eager'` starts at once,
+     * which spends hundreds of megabytes of a visitor's bandwidth before they
+     * have asked for anything, and suits only pages where the agent is the point.
+     */
+    schedulePreload(mode?: Exclude<PreloadMode, 'none'>): void;
+    /** Single shared promise so preload + open + send never double-download. */
+    ensureEngine(): Promise<LoadedEngine>;
+    private _loadEngine;
+    private _warmup;
+    private _trackProgress;
+    /** How many loads have started and not come back. Survives the tab dying. */
+    private _readGuard;
+    private _writeGuard;
+    /**
+     * Begin measuring a new load stage from zero.
+     *
+     * Stages are measured separately because they differ by orders of magnitude
+     * in size and the label names one at a time. Pooling them would report the
+     * tokenizer's completion as progress on the weights.
+     */
+    private _resetProgress;
+    /**
+     * Generate one completion.
+     *
+     * Gemma expresses tool calls as markers within its output, so they are parsed
+     * here and reported as {@link Completion.call}, leaving the harness with text
+     * it can render directly.
+     *
+     * @param req - The conversation, tools, abort signal and token callback.
+     * @returns The generated text with markers stripped, and the tool call it
+     * contained, if any.
+     */
+    complete(req: CompletionRequest): Promise<Completion>;
+    /** Satisfies `ModelProvider.load`; the work is in ensureEngine. */
+    load(): Promise<void>;
+    /** Satisfies `ModelProvider.preload`. */
+    preload(mode?: Exclude<PreloadMode, 'none'>): void;
+    buildToolDefs(tools: ModelContextToolInfo[]): ToolDef[];
+    /** Token count of arbitrary text via the loaded tokenizer (0 if unavailable). */
+    countTokens(text: string): Promise<number>;
+    /**
+     * Run one generation.
+     *
+     * @param messages - The conversation, including the system prompt.
+     * @param toolDefs - Tool definitions in the form the chat template expects.
+     * @param options - Streaming, usage reporting, token cap and abort signal.
+     * @returns The generated text, with protocol markers stripped.
+     * @throws `AbortError` if the signal is already aborted when called.
+     */
+    generate(messages: ChatMessage[], toolDefs: ToolDef[], { onToken, onUsage, maxNewTokens, signal, }?: {
+        onToken?: (text: string) => void;
+        onUsage?: (usage: GenerationUsage) => void;
+        /**
+         * Token ceiling, for generations that are not answers.
+         *
+         * Defaults to {@link MAX_NEW_TOKENS}. Lower it for short outputs such as
+         * a routing decision, which would otherwise run to the full answer budget.
+         */
+        maxNewTokens?: number;
+        /** Aborts the generation, which stops at the next token. */
+        signal?: AbortSignal;
+    }): Promise<string>;
+}
+/**
+ * @deprecated Use {@link LocalGemmaProvider}. The harness takes a
+ * {@link ModelProvider}, of which this is one implementation.
+ */
+export declare const AgentEngine: typeof LocalGemmaProvider;
+/** @deprecated Use {@link LocalGemmaProvider}. */
+export type AgentEngine = LocalGemmaProvider;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

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