@nxisai/agent-harness 0.2.0

package/dist/a2ui/emit.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Turns a parsed WebMCP action into an A2UI message stream.
+ *
+ * The model never authors A2UI: it picks a tool and fills parameters, and this
+ * deterministic code writes every envelope. Asking a small model to produce
+ * nested JSON with JSON Pointers and catalog constraints would be the least
+ * reliable part of an in-browser A2UI setup, and this avoids it.
+ *
+ * Transport is a function call, since the agent and renderer share a JavaScript
+ * context, which satisfies A2UI's ordered-delivery requirement for free.
+ *
+ * @module
+ */
+import type { NxisAction } from '../webmcp-contract.js';
+/** One A2UI protocol message, authored against the v1.0 spec. */
+export interface A2uiMessage {
+    version: 'v1.0';
+    [key: string]: unknown;
+}
+/**
+ * Build the full message stream for an action.
+ *
+ * @param action  - parsed action from nxis.js `readActions()`
+ * @param prefill - values already known (the device-local profile), keyed by valueName
+ */
+export declare function emitActionSurface(action: NxisAction, prefill?: Record<string, unknown>): A2uiMessage[];
+/**
+ * Values the agent infers mid-conversation arrive as data-model patches rather
+ * than a rebuilt surface, so the form updates under the user without losing
+ * focus or anything they have already typed.
+ */
+export declare function emitPrefill(surfaceId: string, valueName: string, value: unknown): A2uiMessage;
+//# sourceMappingURL=emit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/a2ui/emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAkC,MAAM,uBAAuB,CAAC;AAWxF,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAsDD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,WAAW,EAAE,CA0Cf;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAK7F"}

package/dist/a2ui/emit.js

@@ -0,0 +1,116 @@
+/**
+ * Turns a parsed WebMCP action into an A2UI message stream.
+ *
+ * The model never authors A2UI: it picks a tool and fills parameters, and this
+ * deterministic code writes every envelope. Asking a small model to produce
+ * nested JSON with JSON Pointers and catalog constraints would be the least
+ * reliable part of an in-browser A2UI setup, and this avoids it.
+ *
+ * Transport is a function call, since the agent and renderer share a JavaScript
+ * context, which satisfies A2UI's ordered-delivery requirement for free.
+ *
+ * @module
+ */
+const CATALOG = 'https://a2ui.org/specification/v1_0/catalogs/basic/catalog.json';
+/**
+ * A leading option that carries no label and reads as a prompt ("Select…",
+ * "Choose a service…") is the HTML `<option>` placeholder convention, not a
+ * real choice. A2UI has no placeholder slot on ChoicePicker, so it becomes the
+ * label and is dropped from `options`, since otherwise the agent can submit
+ * "Choose a service…" as a literal answer.
+ */
+function splitPlaceholder(options) {
+    const [first, ...rest] = options;
+    const looksLikePrompt = first && !first.name && /[…:]\s*$/.test(first.value);
+    return looksLikePrompt
+        ? { placeholder: first.value, rest }
+        : { rest: options };
+}
+/** Map one PropertyValueSpecification to a component, or null if it is data-only. */
+function fieldComponent(pvs) {
+    const id = `field_${pvs.valueName}`;
+    const path = { path: `/form/${pvs.valueName}` };
+    const label = pvs.description ?? pvs.valueName;
+    // A prefilled field with no description is context the form carries, not
+    // something to ask a human about. It stays in the data model and is submitted;
+    // it just gets no component. `business` is exactly this.
+    if (!pvs.description && pvs.defaultValue !== undefined)
+        return null;
+    if (pvs['nxis:valueOption']?.length) {
+        const { placeholder, rest } = splitPlaceholder(pvs['nxis:valueOption']);
+        return {
+            id,
+            component: 'ChoicePicker',
+            label: placeholder ? `${label} — ${placeholder}` : label,
+            variant: 'mutuallyExclusive',
+            options: rest.map((o) => ({ label: o.name ?? o.value, value: o.value })),
+            value: path,
+        };
+    }
+    // valueMaxLength is absent on this action, so long-text is inferred from the
+    // field name. Crude, but wrong only in that a textarea renders as one line.
+    const longText = /description|message|notes|details/.test(pvs.valueName);
+    return {
+        id,
+        component: 'TextField',
+        label,
+        variant: longText ? 'longText' : 'shortText',
+        value: path,
+    };
+}
+/**
+ * Build the full message stream for an action.
+ *
+ * @param action  - parsed action from nxis.js `readActions()`
+ * @param prefill - values already known (the device-local profile), keyed by valueName
+ */
+export function emitActionSurface(action, prefill = {}) {
+    const fields = action.input ?? [];
+    // Data model first: every field, whether or not it gets a component.
+    const dataModel = {};
+    for (const pvs of fields) {
+        dataModel[pvs.valueName] =
+            prefill[pvs.valueName] ?? pvs.defaultValue ?? '';
+    }
+    const fieldComponents = fields
+        .map(fieldComponent)
+        .filter((c) => c !== null);
+    const components = [
+        // Inline components are cards. See stepper.ts.
+        { id: 'root', component: 'Card', child: 'body' },
+        { id: 'body', component: 'Column', children: [
+                'heading', ...fieldComponents.map((c) => c.id), 'submit',
+            ] },
+        { id: 'heading', component: 'Text', text: action.description ?? action.name, variant: 'body' },
+        ...fieldComponents,
+        { id: 'submit_label', component: 'Text', text: 'Submit' },
+        {
+            id: 'submit',
+            component: 'Button',
+            child: 'submit_label',
+            variant: 'primary',
+            // The event name carries the action @id, so the handler knows which
+            // WebMCP tool to invoke without a second lookup.
+            action: { event: { name: 'nxis.submit', context: { actionId: action['@id'] } } },
+        },
+    ];
+    const surfaceId = `action_${action.name}`;
+    return [
+        {
+            version: 'v1.0',
+            createSurface: { surfaceId, catalogId: CATALOG, components, dataModel: { form: dataModel } },
+        },
+    ];
+}
+/**
+ * Values the agent infers mid-conversation arrive as data-model patches rather
+ * than a rebuilt surface, so the form updates under the user without losing
+ * focus or anything they have already typed.
+ */
+export function emitPrefill(surfaceId, valueName, value) {
+    return {
+        version: 'v1.0',
+        updateDataModel: { surfaceId, path: `/form/${valueName}`, value },
+    };
+}
+//# sourceMappingURL=emit.js.map

package/dist/a2ui/emit.js.map

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

package/dist/a2ui/form.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Builds an A2UI form from a tool's JSON Schema.
+ *
+ * The general counterpart to `emit.ts`, which starts from a WebMCP action
+ * extracted from page JSON-LD. This one starts from the schema that remote MCP
+ * tools expose and that {@link toolSchema} normalises to, producing the same
+ * output surface from a different input.
+ *
+ * @module
+ */
+import type { JsonSchema } from '../types.js';
+import type { A2uiMessage } from './emit.js';
+/**
+ * Build the form surface for a tool.
+ *
+ * Submit and Cancel dispatch action events carrying the tool name, so one
+ * handler can serve every form without tracking which surface is live.
+ */
+export declare function emitToolForm(toolName: string, description: string, schema: JsonSchema, values?: Record<string, unknown>, surfaceId?: string): A2uiMessage[];
+//# sourceMappingURL=form.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/a2ui/form.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAkD7C;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,SAAS,SAAa,GACrB,WAAW,EAAE,CA0Cf"}

package/dist/a2ui/form.js

@@ -0,0 +1,92 @@
+/**
+ * Builds an A2UI form from a tool's JSON Schema.
+ *
+ * The general counterpart to `emit.ts`, which starts from a WebMCP action
+ * extracted from page JSON-LD. This one starts from the schema that remote MCP
+ * tools expose and that {@link toolSchema} normalises to, producing the same
+ * output surface from a different input.
+ *
+ * @module
+ */
+const CATALOG = 'https://a2ui.org/specification/v1_0/catalogs/basic/catalog.json';
+const humanize = (s) => s.replace(/([a-z0-9])([A-Z])/g, '$1 $2').replace(/[_-]+/g, ' ')
+    .replace(/^\w/, c => c.toUpperCase());
+/** Enum values may be bare scalars or {const,title}-style objects. */
+function enumOptions(values) {
+    return values.map(v => {
+        if (v && typeof v === 'object') {
+            const o = v;
+            const value = String(o.const ?? o.value ?? '');
+            return { label: String(o.title ?? o.name ?? value), value };
+        }
+        return { label: humanize(String(v)), value: String(v) };
+    });
+}
+function fieldComponent(key, spec, required) {
+    const id = `f_${key}`;
+    const path = { path: `/form/${key}` };
+    // The required marker is part of the label, since the basic catalog has no
+    // requiredness of its own. Validation stays with the caller regardless.
+    const label = `${spec.description || humanize(key)}${required ? ' *' : ''}`;
+    const enumValues = spec.enum ?? spec.items?.enum;
+    if (Array.isArray(enumValues) && enumValues.length) {
+        return {
+            id, component: 'ChoicePicker', label,
+            variant: spec.type === 'array' ? 'multipleSelection' : 'mutuallyExclusive',
+            options: enumOptions(enumValues),
+            value: path,
+        };
+    }
+    if (spec.type === 'boolean')
+        return { id, component: 'CheckBox', label, value: path };
+    const variant = spec.type === 'number' || spec.type === 'integer' ? 'number'
+        : spec.format === 'password' ? 'obscured'
+            : /description|message|notes|details|body/.test(key) ? 'longText'
+                : 'shortText';
+    return { id, component: 'TextField', label, variant, value: path };
+}
+/**
+ * Build the form surface for a tool.
+ *
+ * Submit and Cancel dispatch action events carrying the tool name, so one
+ * handler can serve every form without tracking which surface is live.
+ */
+export function emitToolForm(toolName, description, schema, values = {}, surfaceId = 'toolform') {
+    const props = schema.properties ?? {};
+    const required = new Set(schema.required ?? []);
+    const fields = Object.entries(props).map(([key, spec]) => fieldComponent(key, spec ?? {}, required.has(key)));
+    // Seed by type: a CheckBox bound to '' is not merely empty, it is the wrong
+    // type for the component and does not round-trip through the data model.
+    const dataModel = {};
+    for (const [key, spec] of Object.entries(props)) {
+        const fallback = spec?.type === 'boolean' ? false
+            : spec?.type === 'number' || spec?.type === 'integer' ? null
+                : '';
+        dataModel[key] = values[key] ?? fallback;
+    }
+    const components = [
+        // Inline components are cards. See stepper.ts.
+        { id: 'root', component: 'Card', child: 'body' },
+        { id: 'body', component: 'Column',
+            children: ['eyebrow', 'title', ...(description ? ['desc'] : []), ...fields.map(f => f.id), 'actions'] },
+        { id: 'eyebrow', component: 'Text', text: 'DETAILS NEEDED', variant: 'caption' },
+        // Body, not a heading: markdown headings would pick up
+        // --a2ui-font-family-title, but only with a MarkdownRenderer in context.
+        // Without one the raw "###" is printed. See stepper.ts.
+        { id: 'title', component: 'Text', text: humanize(toolName), variant: 'body' },
+        ...(description ? [{ id: 'desc', component: 'Text', text: description, variant: 'caption' }] : []),
+        ...fields,
+        { id: 'actions', component: 'Row', children: ['cancel', 'submit'], justify: 'end' },
+        { id: 'cancel_label', component: 'Text', text: 'Cancel' },
+        { id: 'cancel', component: 'Button', child: 'cancel_label',
+            action: { event: { name: 'nxis.cancel', context: { tool: toolName } } } },
+        { id: 'submit_label', component: 'Text', text: 'Submit' },
+        { id: 'submit', component: 'Button', child: 'submit_label', variant: 'primary',
+            action: { event: { name: 'nxis.submit', context: { tool: toolName } } } },
+    ];
+    return [{
+            version: 'v1.0',
+            createSurface: { surfaceId, catalogId: CATALOG, components, dataModel: { form: dataModel } },
+        }];
+}
+//# sourceMappingURL=form.js.map

package/dist/a2ui/form.js.map

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

package/dist/a2ui/host.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Mounts A2UI messages into a container element.
+ *
+ * Wraps the emit, downgrade, process and mount sequence every A2UI surface
+ * needs, so callers deal in messages and a container rather than in message
+ * processor lifecycles.
+ *
+ * Works inside a shadow root, since `<a2ui-surface>` is a custom element and
+ * upgrades wherever it is appended.
+ *
+ * @module
+ */
+import '@a2ui/lit/v0_9';
+import type { A2uiMessage } from './emit.js';
+/** A live A2UI surface, and the handle used to tear it down. */
+export interface MountedSurface {
+    /** The processor, for reading the live data model or sending further messages. */
+    processor: any;
+    /** The mounted custom element. */
+    element: HTMLElement;
+    /** Current value of one top-level data-model key on this surface. */
+    read(key: string): unknown;
+    /** Push a v1.0 message (e.g. a prefill patch) into the live surface. */
+    send(messages: A2uiMessage[]): void;
+    dispose(): void;
+}
+/**
+ * Render `messages` into `container`.
+ *
+ * @param onAction - Called when the renderer dispatches a button action. The
+ * event carries whatever `action.event.context` the emitter attached.
+ */
+export declare function mountSurface(container: HTMLElement, messages: A2uiMessage[], onAction?: (event: any) => void): MountedSurface | null;
+//# sourceMappingURL=host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/a2ui/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,SAAS,EAAE,GAAG,CAAC;IACf,kCAAkC;IAClC,OAAO,EAAE,WAAW,CAAC;IACrB,qEAAqE;IACrE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,wEAAwE;IACxE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IACpC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,WAAW,EAAE,EACvB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAC9B,cAAc,GAAG,IAAI,CA6BvB"}

package/dist/a2ui/host.js

@@ -0,0 +1,47 @@
+/**
+ * Mounts A2UI messages into a container element.
+ *
+ * Wraps the emit, downgrade, process and mount sequence every A2UI surface
+ * needs, so callers deal in messages and a container rather than in message
+ * processor lifecycles.
+ *
+ * Works inside a shadow root, since `<a2ui-surface>` is a custom element and
+ * upgrades wherever it is appended.
+ *
+ * @module
+ */
+import { MessageProcessor } from '@a2ui/web_core/v0_9';
+import { basicCatalog } from '@a2ui/lit/v0_9';
+import '@a2ui/lit/v0_9';
+import { toV09 } from './to-v09.js';
+/**
+ * Render `messages` into `container`.
+ *
+ * @param onAction - Called when the renderer dispatches a button action. The
+ * event carries whatever `action.event.context` the emitter attached.
+ */
+export function mountSurface(container, messages, onAction) {
+    const processor = new MessageProcessor([basicCatalog], (event) => onAction?.(event));
+    processor.processMessages(toV09(messages));
+    // One surface per mount; the first is the one just created.
+    const first = processor.model.surfacesMap.entries().next();
+    if (first.done)
+        return null;
+    const [, surface] = first.value;
+    const element = document.createElement('a2ui-surface');
+    element.surface = surface;
+    container.appendChild(element);
+    return {
+        processor,
+        element,
+        // DataModel exposes get(path); reading the surface's own model avoids
+        // depending on the sendDataModel flag that getClientDataModel requires.
+        read: (key) => surface?.dataModel?.get(`/${key}`),
+        send: (msgs) => processor.processMessages(toV09(msgs)),
+        dispose: () => {
+            element.remove();
+            processor.dispose?.();
+        },
+    };
+}
+//# sourceMappingURL=host.js.map

package/dist/a2ui/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/a2ui/host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,gBAAgB,CAAC;AAGxB,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAepC;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAsB,EACtB,QAAuB,EACvB,QAA+B;IAE/B,MAAM,SAAS,GAAG,IAAI,gBAAgB,CACpC,CAAC,YAAmB,CAAC,EACrB,CAAC,KAAU,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAClC,CAAC;IAEF,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAQ,CAAC,CAAC;IAElD,4DAA4D;IAC5D,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,KAAK,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,KAA0B,CAAC;IAErD,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAQ,CAAC;IAC9D,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;IAC1B,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAE/B,OAAO;QACL,SAAS;QACT,OAAO;QACP,sEAAsE;QACtE,wEAAwE;QACxE,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAE,OAAe,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;QAClE,IAAI,EAAE,CAAC,IAAmB,EAAE,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAQ,CAAC;QAC5E,OAAO,EAAE,GAAG,EAAE;YACZ,OAAO,CAAC,MAAM,EAAE,CAAC;YAChB,SAAiB,CAAC,OAAO,EAAE,EAAE,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/a2ui/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A2UI surface emitters.
+ *
+ * Turn a tool's schema, a clarification plan, or typed-retrieval results into
+ * A2UI messages, for rendering through an A2UI renderer rather than the
+ * packaged element.
+ *
+ * Messages are authored against the v1.0 spec and downgraded by {@link toV09}
+ * before rendering, since published renderers support v0.9 and earlier.
+ *
+ * @module
+ */
+export { emitActionSurface, emitPrefill } from './emit.js';
+export type { A2uiMessage } from './emit.js';
+export { emitToolForm } from './form.js';
+export { emitAsk, emitStep, emitConfirm } from './stepper.js';
+export { emitCardsSurface, emitResultsSurface, emitAppendResult, toCardData } from './cards.js';
+export type { ResultCardData, CardRow, CardTag } from './cards.js';
+export { mountSurface } from './host.js';
+export type { MountedSurface } from './host.js';
+export { toV09 } from './to-v09.js';
+export { A2UI_THEME_CSS, NXIS_PRIMARY } from './theme.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/a2ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChG,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/a2ui/index.js

@@ -0,0 +1,20 @@
+/**
+ * A2UI surface emitters.
+ *
+ * Turn a tool's schema, a clarification plan, or typed-retrieval results into
+ * A2UI messages, for rendering through an A2UI renderer rather than the
+ * packaged element.
+ *
+ * Messages are authored against the v1.0 spec and downgraded by {@link toV09}
+ * before rendering, since published renderers support v0.9 and earlier.
+ *
+ * @module
+ */
+export { emitActionSurface, emitPrefill } from './emit.js';
+export { emitToolForm } from './form.js';
+export { emitAsk, emitStep, emitConfirm } from './stepper.js';
+export { emitCardsSurface, emitResultsSurface, emitAppendResult, toCardData } from './cards.js';
+export { mountSurface } from './host.js';
+export { toV09 } from './to-v09.js';
+export { A2UI_THEME_CSS, NXIS_PRIMARY } from './theme.js';
+//# sourceMappingURL=index.js.map

package/dist/a2ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/a2ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhG,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/a2ui/stepper.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The two prompt surfaces: asking for missing values, and confirming a write.
+ *
+ * The stepper never recreates its surface. Steps arrive as component updates
+ * against a live surface whose data model already holds every answer, so moving
+ * between steps changes the components without touching the data, and nothing
+ * already entered is lost.
+ *
+ * @module
+ */
+import type { A2uiMessage } from './emit.js';
+import type { ClarificationPlan } from '../harness/plan.js';
+import type { Slot } from '../harness/slots.js';
+/** Create the surface, showing the first step. */
+export declare function emitAsk(toolName: string, plan: ClarificationPlan, known: Record<string, unknown>, surfaceId?: string): A2uiMessage[];
+/** Move to another step: components only, so answers already typed survive. */
+export declare function emitStep(surfaceId: string, toolName: string, plan: ClarificationPlan, index: number): A2uiMessage[];
+/**
+ * The write confirmation: what is about to be sent, read-only.
+ *
+ * Not a form: nothing is missing, so there is nothing to fill in,
+ * showing inputs would imply otherwise and invite editing that was not asked
+ * for. Edit is available, as a button, for when it genuinely was.
+ */
+export declare function emitConfirm(toolName: string, slots: Slot[], surfaceId?: string): A2uiMessage[];
+//# sourceMappingURL=stepper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stepper.d.ts","sourceRoot":"","sources":["../../src/a2ui/stepper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAY,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AA2GhD,kDAAkD;AAClD,wBAAgB,OAAO,CACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,SAAQ,GAChB,WAAW,EAAE,CAqBf;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,CACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,MAAM,GACZ,WAAW,EAAE,CAMf;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,SAAY,GACpB,WAAW,EAAE,CAkCf"}

package/dist/a2ui/stepper.js

@@ -0,0 +1,162 @@
+/**
+ * The two prompt surfaces: asking for missing values, and confirming a write.
+ *
+ * The stepper never recreates its surface. Steps arrive as component updates
+ * against a live surface whose data model already holds every answer, so moving
+ * between steps changes the components without touching the data, and nothing
+ * already entered is lost.
+ *
+ * @module
+ */
+const CATALOG = 'https://a2ui.org/specification/v1_0/catalogs/basic/catalog.json';
+const humanize = (s) => s.replace(/([a-z0-9])([A-Z])/g, '$1 $2').replace(/[_-]+/g, ' ')
+    .replace(/^\w/, c => c.toUpperCase());
+function labelFor(slot) {
+    return slot.schema.description || humanize(slot.name);
+}
+function enumOptions(values) {
+    return values
+        .map(v => String(v))
+        // A leading placeholder option is a markup convention rather than a
+        // choice, and offering it would allow it to be submitted as an answer.
+        .filter(v => !/[…:]\s*$/.test(v))
+        .map(v => ({ label: humanize(v), value: v }));
+}
+/** One input bound to /form/<name>. */
+function inputFor(slot) {
+    const id = `f_${slot.name}`;
+    const value = { path: `/form/${slot.name}` };
+    const label = labelFor(slot);
+    const spec = slot.schema;
+    const values = spec.enum ?? spec.items?.enum;
+    if (Array.isArray(values) && values.length) {
+        return { id, component: 'ChoicePicker', label, variant: 'mutuallyExclusive',
+            options: enumOptions(values), value };
+    }
+    if (spec.type === 'boolean')
+        return { id, component: 'CheckBox', label, value };
+    const variant = spec.type === 'number' || spec.type === 'integer' ? 'number'
+        : /description|message|notes|details/.test(slot.name) ? 'longText'
+            : 'shortText';
+    return { id, component: 'TextField', label, variant, value };
+}
+function stepComponents(step, plan, toolName) {
+    const fields = step.slots.map(inputFor);
+    const isLast = step.index === plan.steps.length - 1;
+    const isFirst = step.index === 0;
+    const actionIds = [
+        ...(plan.stepped && !isFirst ? ['back'] : []),
+        'cancel',
+        isLast ? 'submit' : 'next',
+    ];
+    // Same header shape as the review and submitted cards: an uppercase eyebrow
+    // then the detail. Uppercased in the string itself because no CSS of
+    // ours reaches inside these components.
+    //
+    // The headline is NOT Manrope. --a2ui-font-family-title applies only to
+    // markdown headings, and Text falls back to rendering the raw string unless
+    // a MarkdownRenderer is provided through Lit context, so "### Foo" renders as
+    // literal hashes. Reaching the display face here needs @a2ui/markdown-it
+    // wired into the surface, not a formatting trick.
+    const heading = [
+        { id: 'eyebrow', component: 'Text',
+            text: plan.stepped
+                ? `STEP ${step.index + 1} OF ${plan.steps.length}`
+                : 'ONE MORE DETAIL',
+            variant: 'caption' },
+        { id: 'headline', component: 'Text', text: step.title, variant: 'body' },
+    ];
+    return [
+        // Every inline component is a card: the surface is a thing placed in the
+        // conversation, and the card edge is what separates it from the message
+        // bubbles either side. Card takes one child, so the content column sits
+        // inside it rather than being the root itself.
+        { id: 'root', component: 'Card', child: 'body' },
+        { id: 'body', component: 'Column',
+            children: [...heading.map(h => h.id), ...fields.map(f => f.id), 'actions'] },
+        ...heading,
+        ...fields,
+        { id: 'actions', component: 'Row', children: actionIds, justify: 'end' },
+        { id: 'back_label', component: 'Text', text: 'Back' },
+        { id: 'back', component: 'Button', child: 'back_label',
+            action: { event: { name: 'nxis.back', context: { tool: toolName, step: step.index } } } },
+        { id: 'cancel_label', component: 'Text', text: 'Cancel' },
+        { id: 'cancel', component: 'Button', child: 'cancel_label',
+            action: { event: { name: 'nxis.cancel', context: { tool: toolName } } } },
+        { id: 'next_label', component: 'Text', text: 'Next' },
+        { id: 'next', component: 'Button', child: 'next_label', variant: 'primary',
+            action: { event: { name: 'nxis.next', context: { tool: toolName, step: step.index } } } },
+        { id: 'submit_label', component: 'Text', text: 'Submit' },
+        { id: 'submit', component: 'Button', child: 'submit_label', variant: 'primary',
+            action: { event: { name: 'nxis.submit', context: { tool: toolName } } } },
+    ];
+}
+/** Create the surface, showing the first step. */
+export function emitAsk(toolName, plan, known, surfaceId = 'ask') {
+    // Seed every gap so its input has a value to bind to, and carry the known
+    // values along: they are submitted with the answers even though no step
+    // ever displays them.
+    const form = { ...known };
+    for (const step of plan.steps) {
+        for (const slot of step.slots) {
+            if (form[slot.name] === undefined) {
+                form[slot.name] = slot.schema.type === 'boolean' ? false : '';
+            }
+        }
+    }
+    return [{
+            version: 'v1.0',
+            createSurface: {
+                surfaceId, catalogId: CATALOG,
+                components: stepComponents(plan.steps[0], plan, toolName),
+                dataModel: { form, step: 0 },
+            },
+        }];
+}
+/** Move to another step: components only, so answers already typed survive. */
+export function emitStep(surfaceId, toolName, plan, index) {
+    return [
+        { version: 'v1.0',
+            updateComponents: { surfaceId, components: stepComponents(plan.steps[index], plan, toolName) } },
+        { version: 'v1.0', updateDataModel: { surfaceId, path: '/step', value: index } },
+    ];
+}
+/**
+ * The write confirmation: what is about to be sent, read-only.
+ *
+ * Not a form: nothing is missing, so there is nothing to fill in,
+ * showing inputs would imply otherwise and invite editing that was not asked
+ * for. Edit is available, as a button, for when it genuinely was.
+ */
+export function emitConfirm(toolName, slots, surfaceId = 'confirm') {
+    const rows = slots.map(s => ({ label: labelFor(s), value: String(s.value ?? '') }));
+    const components = [
+        // The review is a card for the same reason the inputs are: it is one
+        // reviewable object, and its edge is what says "this is what will be sent"
+        // rather than "this is more conversation".
+        { id: 'root', component: 'Card', child: 'body' },
+        { id: 'body', component: 'Column', children: ['eyebrow', 'headline', 'rows', 'actions'] },
+        { id: 'eyebrow', component: 'Text', text: 'READY TO SEND', variant: 'caption' },
+        { id: 'headline', component: 'Text', text: humanize(toolName), variant: 'body' },
+        { id: 'rows', component: 'List',
+            children: { path: '/rows', componentId: 'row_tpl' }, direction: 'vertical' },
+        { id: 'row_tpl', component: 'Row', children: ['row_label', 'row_value'] },
+        { id: 'row_label', component: 'Text', text: '${label}', variant: 'caption' },
+        { id: 'row_value', component: 'Text', text: '${value}' },
+        { id: 'actions', component: 'Row', children: ['edit', 'cancel', 'send'], justify: 'end' },
+        { id: 'edit_label', component: 'Text', text: 'Edit' },
+        { id: 'edit', component: 'Button', child: 'edit_label',
+            action: { event: { name: 'nxis.edit', context: { tool: toolName } } } },
+        { id: 'cancel_label', component: 'Text', text: 'Cancel' },
+        { id: 'cancel', component: 'Button', child: 'cancel_label',
+            action: { event: { name: 'nxis.cancel', context: { tool: toolName } } } },
+        { id: 'send_label', component: 'Text', text: 'Submit' },
+        { id: 'send', component: 'Button', child: 'send_label', variant: 'primary',
+            action: { event: { name: 'nxis.submit', context: { tool: toolName } } } },
+    ];
+    return [{
+            version: 'v1.0',
+            createSurface: { surfaceId, catalogId: CATALOG, components, dataModel: { rows } },
+        }];
+}
+//# sourceMappingURL=stepper.js.map