@appinternalleads/ui 0.2.0 → 0.4.0

package/dist/esm/agent/spec.d.ts

@@ -0,0 +1,44 @@
+import type { CopySpec, FieldSpec, RenderIssue, Section } from './types';
+/**
+ * **Field specs, and the one checker that reads them.** A manifest declares each setting with these
+ * builders; `checkSection` holds a request's section to them — unknown keys, kinds, required,
+ * ranges, formats, enums, uniqueness — and `checkRefs` to the values they must name.
+ */
+type Opts<T> = Omit<Extract<FieldSpec, {
+    type: T;
+}>, 'type' | 'description'>;
+export declare const text: (description: string, o?: Opts<"text">) => FieldSpec;
+export declare const num: (description: string, o?: Opts<"number">) => FieldSpec;
+export declare const bool: (description: string, o?: Opts<"boolean">) => FieldSpec;
+export declare const list: (description: string, item: FieldSpec, o?: Omit<Opts<"list">, "item">) => FieldSpec;
+export declare const obj: (description: string, fields: Record<string, FieldSpec>, o?: Omit<Opts<"object">, "fields">) => FieldSpec;
+export declare const map: (description: string, value: FieldSpec, o?: Omit<Opts<"map">, "value">) => FieldSpec;
+export declare const json: (description: string, o?: Opts<"json">) => FieldSpec;
+/** A real calendar date: `2026-02-30` is not one. */
+export declare function isRealDate(s: string): boolean;
+type Ctx = {
+    section: Section;
+    issues: RenderIssue[];
+};
+/** One value against its spec. `path` is the request path. */
+export declare function checkValue(spec: FieldSpec, v: unknown, path: string, c: Ctx): void;
+/** An object's keys: unknown ones are errors, required ones must be present. */
+export declare function checkFields(fields: Record<string, FieldSpec>, v: Record<string, unknown>, path: string, c: Ctx): void;
+/** A section's settings the agent may not send (`owners` without `agent`). */
+export declare function checkOwners(fields: Record<string, FieldSpec>, v: Record<string, unknown>, path: string, c: Ctx): void;
+/** Every value at a reference path, in a resolved request: `data.items[].id` → the ids. */
+export declare function valuesAt(root: Record<string, unknown>, ref: string): unknown[];
+/** Every `ref` in `fields` (recursively), checked against `root`. */
+export declare function checkRefs(fields: Record<string, FieldSpec>, v: Record<string, unknown>, path: string, root: Record<string, unknown>, c: Ctx): void;
+/** Fill in each field's `default` where the value is missing — never for required ones. */
+export declare function withDefaults(fields: Record<string, FieldSpec>, v?: Record<string, unknown>): Record<string, unknown>;
+export declare const placeholdersOf: (s: string) => string[];
+/**
+ * A copy spec from a default and every case study's value: the placeholders the default uses are
+ * required; any a case uses are allowed too.
+ */
+export declare function copySpecFrom(key: string, base: unknown, variants: unknown[], extra?: Partial<CopySpec>): CopySpec;
+/** A request's `copy` against the capability's copy specs. */
+export declare function checkCopy(specs: Record<string, CopySpec>, copy: Record<string, unknown>, c: Ctx): void;
+export {};
+//# sourceMappingURL=spec.d.ts.map

package/dist/esm/agent/spec.d.ts.map

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

package/dist/esm/agent/spec.js

@@ -0,0 +1,284 @@
+export const text = (description, o = {}) => ({ type: 'text', description, ...o });
+export const num = (description, o = {}) => ({ type: 'number', description, ...o });
+export const bool = (description, o = {}) => ({ type: 'boolean', description, ...o });
+export const list = (description, item, o = {}) => ({ type: 'list', description, item, ...o });
+export const obj = (description, fields, o = {}) => ({ type: 'object', description, fields, ...o });
+export const map = (description, value, o = {}) => ({ type: 'map', description, value, ...o });
+export const json = (description, o = {}) => ({ type: 'json', description, ...o });
+const ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+/** A real calendar date: `2026-02-30` is not one. */
+export function isRealDate(s) {
+    const m = ISO_DATE.exec(s);
+    if (!m)
+        return false;
+    const d = new Date(Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3])));
+    return d.getUTCFullYear() === Number(m[1]) && d.getUTCMonth() === Number(m[2]) - 1 && d.getUTCDate() === Number(m[3]);
+}
+const kindOf = (v) => (v === null ? 'null' : Array.isArray(v) ? 'list' : typeof v === 'object' ? 'object' : typeof v);
+const WANT = { text: 'text', number: 'a number', boolean: 'true or false', list: 'a list', object: 'an object', map: 'an object', json: 'any JSON value' };
+const push = (c, path, code, layer, message, expected) => c.issues.push({ path, code, layer, section: c.section, message, ...(expected !== undefined ? { expected } : {}) });
+/** One value against its spec. `path` is the request path. */
+export function checkValue(spec, v, path, c) {
+    if (v === undefined)
+        return;
+    if (v === null) {
+        if (!spec.nullable)
+            push(c, path, 'TYPE', 'shape', `${path} must be ${WANT[spec.type]}, not null.`, WANT[spec.type]);
+        return;
+    }
+    switch (spec.type) {
+        case 'json': return;
+        case 'text': {
+            if (typeof v !== 'string') {
+                push(c, path, 'TYPE', 'shape', `${path} must be text (got ${kindOf(v)}).`, 'text');
+                return;
+            }
+            const layer = c.section === 'data' ? 'data' : 'configuration';
+            if (spec.required && !v.trim())
+                push(c, path, 'REQUIRED', layer, `${path} must not be empty.`);
+            if (spec.minLength !== undefined && v.trim().length < spec.minLength)
+                push(c, path, 'MIN_LENGTH', layer, `${path} needs at least ${spec.minLength} characters.`);
+            if (spec.maxLength !== undefined && v.trim().length > spec.maxLength)
+                push(c, path, 'MAX_LENGTH', layer, `${path} is ${v.trim().length} characters; at most ${spec.maxLength} fit.`, `≤ ${spec.maxLength} characters`);
+            if (spec.format === 'date' && v && !isRealDate(v))
+                push(c, path, 'FORMAT', layer, `${path} must be a real date, YYYY-MM-DD (got "${v}").`, 'YYYY-MM-DD');
+            if (spec.pattern && v && !new RegExp(spec.pattern).test(v))
+                push(c, path, 'PATTERN', layer, `${path} ${spec.patternHint ?? `must match ${spec.pattern}`} (got "${v}").`, spec.pattern);
+            if (spec.enum && !spec.enum.includes(v))
+                push(c, path, 'ENUM', layer, `${path} must be one of the allowed values (got "${v}").`, [...spec.enum]);
+            return;
+        }
+        case 'number': {
+            if (typeof v !== 'number' || !Number.isFinite(v)) {
+                push(c, path, 'TYPE', 'shape', `${path} must be a finite number (got ${kindOf(v)}).`, 'number');
+                return;
+            }
+            const layer = c.section === 'data' ? 'data' : 'configuration';
+            if (spec.integer && !Number.isInteger(v))
+                push(c, path, 'INTEGER', layer, `${path} must be a whole number (got ${v}).`);
+            if (spec.min !== undefined && v < spec.min)
+                push(c, path, 'MIN', layer, `${path} must be at least ${spec.min} (got ${v}).`, `≥ ${spec.min}`);
+            if (spec.exclusiveMin !== undefined && v <= spec.exclusiveMin)
+                push(c, path, 'MIN', layer, `${path} must be more than ${spec.exclusiveMin} (got ${v}).`, `> ${spec.exclusiveMin}`);
+            if (spec.max !== undefined && v > spec.max)
+                push(c, path, 'MAX', layer, `${path} must be at most ${spec.max} (got ${v}).`, `≤ ${spec.max}`);
+            return;
+        }
+        case 'boolean':
+            if (typeof v !== 'boolean')
+                push(c, path, 'TYPE', 'shape', `${path} must be true or false (got ${kindOf(v)}).`, 'boolean');
+            return;
+        case 'list': {
+            if (!Array.isArray(v)) {
+                push(c, path, 'TYPE', 'shape', `${path} must be a list (got ${kindOf(v)}).`, 'list');
+                return;
+            }
+            const layer = c.section === 'data' ? 'data' : 'configuration';
+            if (spec.minItems !== undefined && v.length < spec.minItems)
+                push(c, path, 'MIN_ITEMS', layer, `${path} needs at least ${spec.minItems} (has ${v.length}).`, `≥ ${spec.minItems} items`);
+            if (spec.maxItems !== undefined && v.length > spec.maxItems)
+                push(c, path, 'MAX_ITEMS', layer, `${path} holds at most ${spec.maxItems} (has ${v.length}).`, `≤ ${spec.maxItems} items`);
+            v.forEach((x, i) => checkValue(spec.item, x, `${path}[${i}]`, c));
+            /* A unique field inside the items: ids, keys. */
+            if (spec.item.type === 'object') {
+                for (const [k, f] of Object.entries(spec.item.fields)) {
+                    if (f.type !== 'text' || !f.unique)
+                        continue;
+                    const seen = new Set();
+                    v.forEach((x, i) => {
+                        const val = x?.[k];
+                        if (typeof val !== 'string')
+                            return;
+                        if (seen.has(val))
+                            push(c, `${path}[${i}].${k}`, 'DUPLICATE', layer, `${path}[${i}].${k} "${val}" is used twice.`);
+                        seen.add(val);
+                    });
+                }
+            }
+            return;
+        }
+        case 'object': {
+            if (kindOf(v) !== 'object') {
+                push(c, path, 'TYPE', 'shape', `${path} must be an object (got ${kindOf(v)}).`, 'object');
+                return;
+            }
+            checkFields(spec.fields, v, path, c);
+            return;
+        }
+        case 'map': {
+            if (kindOf(v) !== 'object') {
+                push(c, path, 'TYPE', 'shape', `${path} must be an object (got ${kindOf(v)}).`, 'object');
+                return;
+            }
+            for (const [k, x] of Object.entries(v))
+                checkValue(spec.value, x, `${path}.${k}`, c);
+            return;
+        }
+    }
+}
+/** An object's keys: unknown ones are errors, required ones must be present. */
+export function checkFields(fields, v, path, c) {
+    const expected = Object.keys(fields);
+    for (const k of Object.keys(v)) {
+        if (!(k in fields))
+            push(c, `${path}.${k}`, 'UNKNOWN_KEY', 'schema', `${path} has no "${k}". It takes: ${expected.join(', ') || 'nothing'}.`, expected);
+    }
+    for (const [k, f] of Object.entries(fields)) {
+        if (f.required && v[k] === undefined)
+            push(c, `${path}.${k}`, 'REQUIRED', c.section === 'data' ? 'data' : 'configuration', `${path}.${k} is required: ${f.description}`);
+        else
+            checkValue(f, v[k], `${path}.${k}`, c);
+    }
+}
+/** A section's settings the agent may not send (`owners` without `agent`). */
+export function checkOwners(fields, v, path, c) {
+    for (const [k, f] of Object.entries(fields)) {
+        if (v[k] !== undefined && f.owners && !f.owners.includes('agent')) {
+            push(c, `${path}.${k}`, 'NOT_ALLOWED', 'configuration', `${path}.${k} is set by the ${f.owners.join(' or ')}, not by an agent.`, f.owners);
+        }
+    }
+}
+/* ── References: `data.items[].id` ─────────────────────────────────────────────────────────── */
+/** Every value at a reference path, in a resolved request: `data.items[].id` → the ids. */
+export function valuesAt(root, ref) {
+    let cur = [root];
+    for (const part of ref.split('.')) {
+        const many = part.endsWith('[]');
+        const key = many ? part.slice(0, -2) : part;
+        cur = cur.flatMap(x => {
+            const v = x && typeof x === 'object' ? x[key] : undefined;
+            return many ? (Array.isArray(v) ? v : []) : v === undefined ? [] : [v];
+        });
+    }
+    return cur;
+}
+/** Every `ref` in `fields` (recursively), checked against `root`. */
+export function checkRefs(fields, v, path, root, c) {
+    for (const [k, f] of Object.entries(fields))
+        visitRef(f, v?.[k], `${path}.${k}`, root, c);
+}
+function visitRef(f, v, path, root, c) {
+    if (v === undefined || v === null)
+        return;
+    if (f.ref && (typeof v === 'string' || typeof v === 'number')) {
+        const allowed = valuesAt(root, f.ref).filter(x => typeof x === 'string' || typeof x === 'number');
+        if (!allowed.includes(v)) {
+            push(c, path, 'REFERENCE', c.section === 'data' ? 'data' : 'configuration', `${path} must name one of ${f.ref} (got "${v}").`, allowed.map(String));
+        }
+    }
+    if (f.type === 'list' && Array.isArray(v))
+        v.forEach((x, i) => visitRef(f.item, x, `${path}[${i}]`, root, c));
+    if (f.type === 'object' && v && typeof v === 'object')
+        for (const [k, g] of Object.entries(f.fields))
+            visitRef(g, v[k], `${path}.${k}`, root, c);
+}
+/** Fill in each field's `default` where the value is missing — never for required ones. */
+export function withDefaults(fields, v = {}) {
+    const out = { ...v };
+    for (const [k, f] of Object.entries(fields))
+        if (out[k] === undefined && f.default !== undefined)
+            out[k] = structuredClone(f.default);
+    return out;
+}
+/* ── Copy ─────────────────────────────────────────────────────────────────────────────────── */
+const PLACEHOLDER = /\{(\w+)\}/g;
+export const placeholdersOf = (s) => [...new Set([...s.matchAll(PLACEHOLDER)].map(m => m[1]))];
+/**
+ * A copy spec from a default and every case study's value: the placeholders the default uses are
+ * required; any a case uses are allowed too.
+ */
+export function copySpecFrom(key, base, variants, extra = {}) {
+    const owners = ['agent', 'builder', 'developer'];
+    if (typeof base === 'string') {
+        const all = [base, ...variants.filter((x) => typeof x === 'string')];
+        const required = placeholdersOf(base);
+        const allowed = [...new Set(all.flatMap(placeholdersOf))];
+        return { type: 'text', description: `Words: ${key}.`, default: base, ...(allowed.length ? { placeholders: { required, allowed } } : {}), owners, ...extra };
+    }
+    if (Array.isArray(base))
+        return { type: 'text-list', description: `Words: ${key}, one per entry.`, default: base, length: base.length, owners, ...extra };
+    const entries = base;
+    const entryPlaceholders = {};
+    for (const [k, s] of Object.entries(entries)) {
+        const vs = variants.map(x => (x && typeof x === 'object' ? x[k] : undefined)).filter((x) => typeof x === 'string');
+        const allowed = [...new Set([s, ...vs].flatMap(placeholdersOf))];
+        if (allowed.length)
+            entryPlaceholders[k] = { required: placeholdersOf(s), allowed };
+    }
+    return { type: 'text-map', description: `Words: ${key}, by entry.`, default: entries, partial: true, ...(Object.keys(entryPlaceholders).length ? { entryPlaceholders } : {}), owners, ...extra };
+}
+function checkTemplate(s, p, path, c) {
+    if (!p) {
+        const extra = placeholdersOf(s);
+        if (extra.length)
+            push(c, path, 'PLACEHOLDER_UNKNOWN', 'copy', `${path} has {${extra.join('}, {')}}, which nothing fills — it would show as written.`, []);
+        return;
+    }
+    const have = placeholdersOf(s);
+    const missing = p.required.filter(x => !have.includes(x));
+    const unknown = have.filter(x => !p.allowed.includes(x));
+    if (missing.length)
+        push(c, path, 'PLACEHOLDER_MISSING', 'copy', `${path} must keep {${missing.join('}, {')}} — the component fills it in.`, p.required.map(x => `{${x}}`));
+    if (unknown.length)
+        push(c, path, 'PLACEHOLDER_UNKNOWN', 'copy', `${path} has {${unknown.join('}, {')}}, which nothing fills — use ${p.allowed.map(x => `{${x}}`).join(', ')}.`, p.allowed.map(x => `{${x}}`));
+}
+/** A request's `copy` against the capability's copy specs. */
+export function checkCopy(specs, copy, c) {
+    const expected = Object.keys(specs);
+    for (const [k, s] of Object.entries(specs)) {
+        if (s.required && copy[k] === undefined)
+            push(c, `copy.${k}`, 'REQUIRED', 'copy', `copy.${k} is required: ${s.description}`);
+    }
+    for (const [k, v] of Object.entries(copy)) {
+        const s = specs[k];
+        const path = `copy.${k}`;
+        if (!s) {
+            push(c, path, 'UNKNOWN_KEY', 'schema', `copy has no "${k}". It takes: ${expected.join(', ')}.`, expected);
+            continue;
+        }
+        if (s.type === 'text') {
+            if (typeof v !== 'string') {
+                push(c, path, 'TYPE', 'shape', `${path} must be text (got ${kindOf(v)}).`, 'text');
+                continue;
+            }
+            if (!v.trim())
+                push(c, path, 'REQUIRED', 'copy', `${path} must not be empty — leave it out to keep "${s.default}".`);
+            if (s.maxLength !== undefined && v.length > s.maxLength)
+                push(c, path, 'MAX_LENGTH', 'copy', `${path} is ${v.length} characters; at most ${s.maxLength} fit.`, `≤ ${s.maxLength} characters`);
+            checkTemplate(v, s.placeholders, path, c);
+        }
+        else if (s.type === 'text-list') {
+            if (!Array.isArray(v) || !v.every(x => typeof x === 'string')) {
+                push(c, path, 'TYPE', 'shape', `${path} must be a list of text.`, 'list of text');
+                continue;
+            }
+            if (s.length !== undefined && v.length !== s.length)
+                push(c, path, 'LENGTH', 'copy', `${path} must have exactly ${s.length} entries (has ${v.length}).`, `${s.length} entries`);
+            v.forEach((x, i) => { if (!x.trim())
+                push(c, `${path}[${i}]`, 'REQUIRED', 'copy', `${path}[${i}] must not be empty.`); });
+        }
+        else {
+            if (kindOf(v) !== 'object') {
+                push(c, path, 'TYPE', 'shape', `${path} must be an object of text (got ${kindOf(v)}).`, 'object');
+                continue;
+            }
+            const keys = Object.keys(s.default);
+            for (const [ek, ev] of Object.entries(v)) {
+                const ep = `${path}.${ek}`;
+                if (!keys.includes(ek) && !s.open) {
+                    push(c, ep, 'UNKNOWN_KEY', 'schema', `${path} has no "${ek}".`, keys);
+                    continue;
+                }
+                if (typeof ev !== 'string') {
+                    push(c, ep, 'TYPE', 'shape', `${ep} must be text.`, 'text');
+                    continue;
+                }
+                if (!ev.trim())
+                    push(c, ep, 'REQUIRED', 'copy', `${ep} must not be empty.`);
+                if (keys.includes(ek))
+                    checkTemplate(ev, s.entryPlaceholders?.[ek], ep, c);
+            }
+        }
+    }
+}
+//# sourceMappingURL=spec.js.map

package/dist/esm/agent/spec.js.map

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

package/dist/esm/agent/types.d.ts

@@ -0,0 +1,234 @@
+/**
+ * **The agent component contract — its types.** Pure: no React, no component code.
+ *
+ * An agent reasons about a *capability* (`AgentCapability`), sends a *render request* (`render/1`),
+ * and gets back *results* (`result/1`). None of the three names a React component, a prop, a hook,
+ * a file or an animation: the package maps them onto its components (`resolveRenderRequest`,
+ * `AgentComponent`), and that mapping may change without the contract changing.
+ * See `docs/AGENT-COMPONENT-CONTRACT.md`.
+ */
+export declare const RENDER_SCHEMA: "render/1";
+export declare const RESULT_SCHEMA: "result/1";
+export declare const CAPABILITY_SCHEMA: "capability/1";
+/**
+ * What the host should expect once it renders the component.
+ * - `output` — shows what it is given; the person may look around (open a row, switch a tab) but produces nothing.
+ * - `interactive-output` — shows what it is given and the person acts on it (a vote, Copy, a period); results are events.
+ * - `input-output` — a form whose submission produces the output (Receipt Printer: fill in, Print, receipt).
+ * - `interactive` — the person does work in it (allocate, tick, edit stages); results are the changed data.
+ */
+export type CapabilityKind = 'output' | 'interactive-output' | 'input-output' | 'interactive';
+/** The four sections of a render request, and who may write each setting. */
+export type Section = 'data' | 'copy' | 'behavior' | 'presentation';
+export type Owner = 'agent' | 'builder' | 'developer' | 'system' | 'runtime-user';
+/** Where a data value must come from. `invent` — the agent may write it; `user` — ask the person; `external` — a real source (a tool, a sheet, an API), never made up; `derived` — computed from other values. */
+export type DataOrigin = 'user' | 'external' | 'invent' | 'derived';
+type Base = {
+    description: string;
+    /** Required in the request. A missing required value is an error — nothing is filled in from demo data. */
+    required?: boolean;
+    /** `null` is accepted and means "none". */
+    nullable?: boolean;
+    /** The value used when the request leaves this out (behaviour, presentation, optional data). Never demo content. */
+    default?: unknown;
+    /** Who may set it. The agent may send a setting only if this includes `agent`. */
+    owners?: Owner[];
+    /** Data only: where the value must come from. */
+    origin?: DataOrigin;
+    /** Must equal a value found elsewhere in the request: `data.items[].id`, `behavior.currencies[].code`. */
+    ref?: string;
+};
+export type FieldSpec = Base & {
+    type: 'text';
+    maxLength?: number;
+    minLength?: number;
+    pattern?: string;
+    patternHint?: string;
+    format?: 'date';
+    enum?: readonly string[];
+    unique?: boolean;
+} | Base & {
+    type: 'number';
+    integer?: boolean;
+    min?: number;
+    max?: number;
+    exclusiveMin?: number;
+} | Base & {
+    type: 'boolean';
+} | Base & {
+    type: 'list';
+    item: FieldSpec;
+    minItems?: number;
+    maxItems?: number;
+} | Base & {
+    type: 'object';
+    fields: Record<string, FieldSpec>;
+} | Base & {
+    type: 'map';
+    value: FieldSpec;
+} | Base & {
+    type: 'json';
+};
+/**
+ * One piece of copy. `placeholders` are the `{names}` the component fills in: `required` ones must
+ * stay (removing `{count}` from "{count} free" loses the number), and none outside `allowed` may be
+ * added (it would show as literal braces).
+ */
+export type CopySpec = {
+    type: 'text' | 'text-list' | 'text-map';
+    description: string;
+    default: string | string[] | Record<string, string>;
+    placeholders?: {
+        required: string[];
+        allowed: string[];
+    };
+    /** For `text-map`: the placeholders of each entry, by key. */
+    entryPlaceholders?: Record<string, {
+        required: string[];
+        allowed: string[];
+    }>;
+    maxLength?: number;
+    /** Must be sent — there is no default worth showing (a flow's title). */
+    required?: boolean;
+    /** `text-list`: exactly this many. */
+    length?: number;
+    /** `text-map`: send only the entries you change — the rest keep their defaults. */
+    partial?: boolean;
+    /** `text-map`: keys are not a fixed set (names for the data's own keys, say). */
+    open?: boolean;
+    owners: Owner[];
+};
+/** Something the person can do, and what the host hears when they do. */
+export type CapabilityAction = {
+    id: string;
+    description: string;
+    hostOperation?: boolean;
+};
+/** A `result/1` event the component emits, and what its `data` holds. */
+export type CapabilityEvent = {
+    event: string;
+    description: string;
+    data: string;
+};
+/** The semantic card — what `search_components` returns. Small on purpose. */
+export type CapabilityCard = {
+    component: string;
+    name: string;
+    kind: CapabilityKind;
+    purpose: string;
+    signals: string[];
+};
+/**
+ * **One component, as an agent sees it.** Serialisable — everything here is data. `describeComponent`
+ * returns it; the builder's panel and the HTTP API read the same object.
+ */
+export type AgentCapability = CapabilityCard & {
+    schema: typeof CAPABILITY_SCHEMA;
+    agentEditable: true;
+    useWhen: string[];
+    avoidWhen: string[];
+    /** Components an agent might confuse this with, and how to tell them apart. */
+    related: {
+        component: string;
+        distinction: string;
+    }[];
+    states: {
+        state: string;
+        description: string;
+    }[];
+    actions: CapabilityAction[];
+    events: CapabilityEvent[];
+    /** What the person has to do before there is a result: nothing, look, fill in a form, or work in it. */
+    requiresInput: boolean;
+    /** Case studies whose copy (and presentation) a request may start from: `preset`. Their data is never used. */
+    presets: {
+        preset: string;
+        title: string;
+        scenario: string;
+    }[];
+    data: Record<string, FieldSpec>;
+    copy: Record<string, CopySpec>;
+    behavior: Record<string, FieldSpec>;
+    presentation: Record<string, FieldSpec>;
+    /** Button ids a request's `actions` may name. */
+    actionButtons: string[];
+    /** Plain-words rules that span fields — the ones a schema cannot say. */
+    rules: string[];
+    /** Questions to ask the person when required data is missing, by data key. */
+    askFor: Record<string, string>;
+};
+/** Actions an agent may attach to a button: no URLs — a webhook or a link is the host's to configure. */
+export type AgentButtonAction = {
+    type: 'post-message';
+} | {
+    type: 'succeed';
+} | {
+    type: 'fail';
+    message?: string;
+};
+/** **`render/1`** — what an agent sends. Serialisable, versioned, and validated by `validateRenderRequest`. */
+export type RenderRequest = {
+    schema: typeof RENDER_SCHEMA;
+    component: string;
+    /** Start the copy and presentation from a case study (a translated one, say). Its data is never used. */
+    preset?: string;
+    /** The runtime data. Every required key must be here — nothing falls back to demo content. */
+    data: Record<string, unknown>;
+    copy?: Record<string, unknown>;
+    behavior?: Record<string, unknown>;
+    presentation?: Record<string, unknown>;
+    actions?: Record<string, AgentButtonAction>;
+};
+export type IssueLayer = 
+/** The request envelope: `schema`, `component`, unknown sections, unknown keys. */
+'schema'
+/** A value of the wrong kind. */
+ | 'shape'
+/** Runtime data breaks a rule: required, range, format, enum, reference. */
+ | 'data'
+/** Copy breaks a rule: placeholders, length, list length. */
+ | 'copy'
+/** A setting the agent may not set, a bad action. */
+ | 'configuration'
+/** The component's own validator refused the resolved component. */
+ | 'semantic'
+/** The component would render, but its submit would be refused (Receipt Printer's Print). */
+ | 'interaction';
+export type IssueCode = 'UNKNOWN_KEY' | 'UNKNOWN_COMPONENT' | 'UNKNOWN_PRESET' | 'BAD_SCHEMA' | 'TYPE' | 'REQUIRED' | 'MIN' | 'MAX' | 'MIN_LENGTH' | 'MAX_LENGTH' | 'MIN_ITEMS' | 'MAX_ITEMS' | 'LENGTH' | 'ENUM' | 'FORMAT' | 'PATTERN' | 'INTEGER' | 'REFERENCE' | 'DUPLICATE' | 'PLACEHOLDER_MISSING' | 'PLACEHOLDER_UNKNOWN' | 'NOT_ALLOWED' | 'INVALID_ACTION' | 'SEMANTIC' | 'INTERACTION';
+export type RenderIssue = {
+    /** Where, in the request: `data.items[0].amount`, `copy.totalLabel`. */
+    path: string;
+    code: IssueCode;
+    layer: IssueLayer;
+    /** Which section of the request to fix. */
+    section: Section | 'actions' | 'request';
+    message: string;
+    /** What would have been accepted — keys, choices, a range. */
+    expected?: string | string[];
+};
+/** What the person would see, in words: headings, labels, the data, the printed lines. */
+export type RenderPreview = {
+    component: string;
+    visibleText: string[];
+};
+export type RenderCheck = {
+    valid: true;
+    issues: [];
+    request: RenderRequest;
+    preview: RenderPreview;
+} | {
+    valid: false;
+    issues: RenderIssue[];
+};
+/** **`result/1`** — what the component reports back, as data. */
+export type RenderResult = {
+    schema: typeof RESULT_SCHEMA;
+    component: string;
+    instanceId: string;
+    /** Counts up per instance, so a host can order and de-duplicate. */
+    sequence: number;
+    event: string;
+    data: Record<string, unknown>;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/agent/types.d.ts.map

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

package/dist/esm/agent/types.js

@@ -0,0 +1,13 @@
+/**
+ * **The agent component contract — its types.** Pure: no React, no component code.
+ *
+ * An agent reasons about a *capability* (`AgentCapability`), sends a *render request* (`render/1`),
+ * and gets back *results* (`result/1`). None of the three names a React component, a prop, a hook,
+ * a file or an animation: the package maps them onto its components (`resolveRenderRequest`,
+ * `AgentComponent`), and that mapping may change without the contract changing.
+ * See `docs/AGENT-COMPONENT-CONTRACT.md`.
+ */
+export const RENDER_SCHEMA = 'render/1';
+export const RESULT_SCHEMA = 'result/1';
+export const CAPABILITY_SCHEMA = 'capability/1';
+//# sourceMappingURL=types.js.map

package/dist/esm/agent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,UAAmB,CAAC;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG,UAAmB,CAAC;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAuB,CAAC"}