@adonis-agora/agent 0.61.0 → 0.62.0

package/dist/src/genui/registry.js

@@ -0,0 +1,151 @@
+import { Chart, DataTable } from './builtins.js';
+import { defineCatalog, defineComponent, } from './catalog.js';
+import { formatIssues, validateProps } from './schema.js';
+import { componentToText } from './text.js';
+/** Reject values JSON would silently discard/coerce, and detach from caller-owned objects. */
+export function snapshotComponentPresentation(value) {
+    const seen = new Set();
+    const check = (entry) => {
+        if (entry === null || typeof entry === 'string' || typeof entry === 'boolean')
+            return;
+        if (typeof entry === 'number' && Number.isFinite(entry))
+            return;
+        if (typeof entry !== 'object' || entry === null)
+            throw new TypeError('genui: presentation must contain only JSON values');
+        if (seen.has(entry))
+            throw new TypeError('genui: presentation must contain acyclic JSON values');
+        if (!Array.isArray(entry) &&
+            Object.getPrototypeOf(entry) !== Object.prototype &&
+            Object.getPrototypeOf(entry) !== null)
+            throw new TypeError('genui: presentation must contain plain JSON objects');
+        seen.add(entry);
+        for (const item of Object.values(entry))
+            check(item);
+        seen.delete(entry);
+    };
+    check(value);
+    return JSON.parse(JSON.stringify(value));
+}
+export function createComponent(definition, options = {}) {
+    defineComponent(definition);
+    const catalog = defineCatalog([definition], options);
+    const factory = async (props) => {
+        const result = await validateProps(definition.props, props, catalog.validator);
+        if (!result.ok)
+            throw new Error(`genui: invalid ${definition.name} props: ${formatIssues(result.issues)}`);
+        const normalized = snapshotComponentPresentation(result.value);
+        if (typeof normalized !== 'object' || normalized === null || Array.isArray(normalized))
+            throw new TypeError('genui: component props must be a JSON object');
+        const portable = await catalog.validate(definition.name, normalized);
+        if (!portable.ok ||
+            canonicalJson(snapshotComponentPresentation(portable.value)) !== canonicalJson(normalized)) {
+            throw new Error(`genui: ${definition.name} requires outputProps accepting stable normalized JSON props`);
+        }
+        return {
+            component: definition.name,
+            props: normalized,
+            version: definition.version ?? 1,
+            fallbackText: componentToText(catalog, definition.name, normalized),
+        };
+    };
+    return Object.assign(factory, { definition });
+}
+/** A registry is owned by one app/tenant; registering never mutates a shared singleton. */
+export function createComponentRegistry(options = {}) {
+    let catalog = defineCatalog([], options);
+    const channels = new Map();
+    const registry = {
+        get catalog() {
+            return catalog;
+        },
+        get manifest() {
+            return catalog.components.map((definition) => {
+                const props = catalog.jsonSchemaFor(definition.name);
+                return {
+                    name: definition.name,
+                    title: definition.title,
+                    description: definition.description,
+                    version: definition.version ?? 1,
+                    ...(props === undefined ? {} : { props: snapshotComponentPresentation(props) }),
+                };
+            });
+        },
+        register(definition, renderers) {
+            if (catalog.has(definition.name))
+                throw new Error(`genui: component "${definition.name}" is already registered`);
+            catalog = catalog.extend([definition]);
+            channels.set(definition.name, { ...renderers });
+            return this;
+        },
+        async prepare(presentation) {
+            const definition = catalog.get(presentation.component);
+            if (definition === undefined)
+                throw new Error(`genui: unknown component "${presentation.component}"`);
+            if (presentation.version !== (definition.version ?? 1))
+                throw new Error(`genui: component "${presentation.component}" version mismatch`);
+            const validated = await catalog.validate(presentation.component, presentation.props);
+            if (!validated.ok)
+                throw new Error(`genui: invalid ${presentation.component} props: ${formatIssues(validated.issues)}`);
+            const props = snapshotComponentPresentation(validated.value);
+            if (typeof props !== 'object' || props === null || Array.isArray(props))
+                throw new TypeError('genui: component props must be a JSON object');
+            return {
+                component: definition.name,
+                props,
+                version: definition.version ?? 1,
+                fallbackText: componentToText(catalog, definition.name, props),
+            };
+        },
+        async render(presentation, channel, context) {
+            const prepared = await this.prepare(presentation);
+            const mapping = channels.get(prepared.component);
+            const renderer = mapping === undefined
+                ? undefined
+                : Object.hasOwn(mapping, channel)
+                    ? mapping[channel]
+                    : Object.hasOwn(mapping, 'text')
+                        ? mapping.text
+                        : undefined;
+            return renderer === undefined
+                ? prepared.fallbackText
+                : renderer(prepared.props, context);
+        },
+    };
+    return registry;
+}
+export const table = createComponent(DataTable);
+export const chart = createComponent(Chart);
+/** Prepare all JSON emissions before any sink receives a partial batch. Factories validate schemas. */
+export function validatePresentationBatch(presentations) {
+    const batch = Array.isArray(presentations) ? presentations : [presentations];
+    return batch.map((item) => {
+        const presentation = snapshotComponentPresentation(item);
+        if (typeof presentation !== 'object' ||
+            presentation === null ||
+            typeof presentation.component !== 'string' ||
+            !/^[A-Za-z][A-Za-z0-9]{0,63}$/.test(presentation.component) ||
+            !Number.isSafeInteger(presentation.version) ||
+            presentation.version <= 0 ||
+            typeof presentation.fallbackText !== 'string' ||
+            typeof presentation.props !== 'object' ||
+            presentation.props === null ||
+            Array.isArray(presentation.props)) {
+            throw new TypeError('genui: invalid component presentation');
+        }
+        return presentation;
+    });
+}
+/** Object order is immaterial; array order remains part of the portable contract. */
+function canonicalJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(',')}]`;
+    if (typeof value === 'object' && value !== null) {
+        const record = value;
+        return `{${Object.keys(record)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${canonicalJson(record[key])}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/genui/registry.js.map

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

package/dist/src/genui/schema.d.ts

@@ -0,0 +1,71 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+/** A JSON Schema document (draft-07 / 2020-12 subset). Plain data, so a catalog can be stored and shipped. */
+export type JsonSchema = Record<string, unknown>;
+/** One problem with a value, addressed by its path from the root of the value. */
+export interface GenuiIssue {
+    path: (string | number)[];
+    message: string;
+}
+export type GenuiValidation<T = unknown> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    issues: GenuiIssue[];
+};
+/**
+ * Validates a value against a JSON Schema. The package ships {@link builtinJsonSchemaValidator} (a
+ * dependency-free subset that covers what component props use); pass {@link ajvValidator} to a
+ * catalog for full JSON Schema.
+ */
+export interface JsonSchemaValidator {
+    validate(schema: JsonSchema, value: unknown): GenuiIssue[];
+}
+/** A component's props schema: any Standard Schema (Zod, Valibot, ArkType) or a JSON Schema object. */
+export type PropsSchema = StandardSchemaV1 | JsonSchema;
+export declare function isStandardSchema(schema: unknown): schema is StandardSchemaV1;
+/**
+ * The JSON Schema a props schema presents to a model: the schema itself for a JSON Schema, the
+ * Standard JSON Schema converter's output for a Standard Schema that has one (Zod 4, Valibot,
+ * ArkType). `undefined` when neither is available (e.g. Zod 3) — the model then gets the
+ * component's description only.
+ */
+export declare function toJsonSchema(schema: PropsSchema): JsonSchema | undefined;
+/** Validate against either kind of props schema. A Standard Schema's own (possibly transformed) output wins. */
+export declare function validateProps(schema: PropsSchema, value: unknown, validator: JsonSchemaValidator): Promise<GenuiValidation>;
+/**
+ * {@link validateProps} without waiting: the verdict when it is available synchronously (always
+ * for JSON Schema, and for every Standard Schema whose `validate` does not return a promise — Zod,
+ * Valibot and ArkType all answer synchronously for synchronous schemas), `undefined` otherwise. What
+ * a renderer uses to decide on its first paint instead of flashing a placeholder.
+ */
+export declare function validatePropsSync(schema: PropsSchema, value: unknown, validator: JsonSchemaValidator): GenuiValidation | undefined;
+/** `a.b[0].c: message; …` — what a model is handed back when its props were refused. */
+export declare function formatIssues(issues: readonly GenuiIssue[]): string;
+/**
+ * Structural type of an Ajv instance, so the package never imports Ajv: `new Ajv({ allErrors: true })`
+ * satisfies it.
+ */
+export interface AjvLike {
+    compile(schema: object): ((data: unknown) => boolean | Promise<unknown>) & {
+        errors?: {
+            instancePath?: string;
+            message?: string;
+        }[] | null;
+    };
+}
+/**
+ * Full JSON Schema validation through the app's own Ajv instance. Compiled validators are cached
+ * per schema object.
+ */
+export declare function ajvValidator(ajv: AjvLike): JsonSchemaValidator;
+/**
+ * A dependency-free JSON Schema validator for the keywords component props actually use: `type`
+ * (incl. `integer`, `null`, type arrays), `enum`, `const`, `properties`, `required`,
+ * `additionalProperties`, `items`, `minItems`/`maxItems`, `minLength`/`maxLength`/`pattern`,
+ * `minimum`/`maximum`, `anyOf`/`oneOf`/`allOf`, `not`, and local `$ref`s (`#`, `#/$defs/…`,
+ * `#/definitions/…`). Unknown keywords (e.g. `format`) are ignored. Use {@link ajvValidator} when
+ * you need the rest.
+ */
+export declare const builtinJsonSchemaValidator: JsonSchemaValidator;
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/genui/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/genui/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,8GAA8G;AAC9G,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,kFAAkF;AAClF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IACnC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAExC;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,UAAU,EAAE,CAAC;CAC5D;AAED,uGAAuG;AACvG,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,UAAU,CAAC;AAExD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,gBAAgB,CAO5E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAexE;AAED,gHAAgH;AAChH,wBAAsB,aAAa,CACjC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAU1B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,mBAAmB,GAC7B,eAAe,GAAG,SAAS,CAa7B;AAaD,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAMlE;AAUD;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG;QACzE,MAAM,CAAC,EAAE;YAAE,YAAY,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,GAAG,IAAI,CAAC;KAC/D,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CAwB9D;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,EAAE,mBAMxC,CAAC"}

package/dist/src/genui/schema.js

@@ -0,0 +1,304 @@
+export function isStandardSchema(schema) {
+    return (typeof schema === 'object' &&
+        schema !== null &&
+        '~standard' in schema &&
+        typeof schema['~standard']?.validate === 'function');
+}
+/**
+ * The JSON Schema a props schema presents to a model: the schema itself for a JSON Schema, the
+ * Standard JSON Schema converter's output for a Standard Schema that has one (Zod 4, Valibot,
+ * ArkType). `undefined` when neither is available (e.g. Zod 3) — the model then gets the
+ * component's description only.
+ */
+export function toJsonSchema(schema) {
+    if (!isStandardSchema(schema)) {
+        return schema;
+    }
+    const standard = schema['~standard'];
+    const converter = standard.jsonSchema;
+    if (converter === undefined || typeof converter.input !== 'function') {
+        return undefined;
+    }
+    try {
+        return converter.input({ target: 'draft-07' });
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Validate against either kind of props schema. A Standard Schema's own (possibly transformed) output wins. */
+export async function validateProps(schema, value, validator) {
+    if (isStandardSchema(schema)) {
+        const result = await schema['~standard'].validate(value);
+        if (result.issues !== undefined) {
+            return { ok: false, issues: toGenuiIssues(result.issues) };
+        }
+        return { ok: true, value: result.value };
+    }
+    const issues = validator.validate(schema, value);
+    return issues.length > 0 ? { ok: false, issues } : { ok: true, value };
+}
+/**
+ * {@link validateProps} without waiting: the verdict when it is available synchronously (always
+ * for JSON Schema, and for every Standard Schema whose `validate` does not return a promise — Zod,
+ * Valibot and ArkType all answer synchronously for synchronous schemas), `undefined` otherwise. What
+ * a renderer uses to decide on its first paint instead of flashing a placeholder.
+ */
+export function validatePropsSync(schema, value, validator) {
+    if (!isStandardSchema(schema)) {
+        const issues = validator.validate(schema, value);
+        return issues.length > 0 ? { ok: false, issues } : { ok: true, value };
+    }
+    const result = schema['~standard'].validate(value);
+    if (result instanceof Promise) {
+        result.catch(() => undefined);
+        return undefined;
+    }
+    return result.issues !== undefined
+        ? { ok: false, issues: toGenuiIssues(result.issues) }
+        : { ok: true, value: result.value };
+}
+function toGenuiIssues(issues) {
+    return issues.map((issue) => ({
+        path: (issue.path ?? []).map((segment) => typeof segment === 'object' && segment !== null && 'key' in segment
+            ? segment.key
+            : segment),
+        message: issue.message,
+    }));
+}
+/** `a.b[0].c: message; …` — what a model is handed back when its props were refused. */
+export function formatIssues(issues) {
+    return issues
+        .map((issue) => `${issue.path.length > 0 ? formatPath(issue.path) : '(root)'}: ${issue.message}`)
+        .join('; ');
+}
+function formatPath(path) {
+    return path
+        .map((segment, index) => typeof segment === 'number' ? `[${segment}]` : index === 0 ? segment : `.${segment}`)
+        .join('');
+}
+/**
+ * Full JSON Schema validation through the app's own Ajv instance. Compiled validators are cached
+ * per schema object.
+ */
+export function ajvValidator(ajv) {
+    const compiled = new WeakMap();
+    return {
+        validate(schema, value) {
+            let fn = compiled.get(schema);
+            if (fn === undefined) {
+                fn = ajv.compile(schema);
+                compiled.set(schema, fn);
+            }
+            if (fn(value) === true) {
+                return [];
+            }
+            return (fn.errors ?? []).map((error) => ({
+                path: (error.instancePath ?? '')
+                    .split('/')
+                    .filter((segment) => segment.length > 0)
+                    .map((segment) => {
+                    const decoded = segment.replace(/~1/g, '/').replace(/~0/g, '~');
+                    return /^\d+$/.test(decoded) ? Number(decoded) : decoded;
+                }),
+                message: error.message ?? 'is invalid',
+            }));
+        },
+    };
+}
+/**
+ * A dependency-free JSON Schema validator for the keywords component props actually use: `type`
+ * (incl. `integer`, `null`, type arrays), `enum`, `const`, `properties`, `required`,
+ * `additionalProperties`, `items`, `minItems`/`maxItems`, `minLength`/`maxLength`/`pattern`,
+ * `minimum`/`maximum`, `anyOf`/`oneOf`/`allOf`, `not`, and local `$ref`s (`#`, `#/$defs/…`,
+ * `#/definitions/…`). Unknown keywords (e.g. `format`) are ignored. Use {@link ajvValidator} when
+ * you need the rest.
+ */
+export const builtinJsonSchemaValidator = {
+    validate(schema, value) {
+        const issues = [];
+        check(schema, value, [], schema, issues, 0);
+        return issues;
+    },
+};
+const MAX_DEPTH = 64;
+function typeOf(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    return typeof value;
+}
+function matchesType(type, value) {
+    switch (type) {
+        case 'integer':
+            return typeof value === 'number' && Number.isInteger(value);
+        case 'number':
+            return typeof value === 'number' && Number.isFinite(value);
+        case 'object':
+            return typeof value === 'object' && value !== null && !Array.isArray(value);
+        default:
+            return typeOf(value) === type;
+    }
+}
+function resolveRef(root, ref) {
+    if (ref === '#')
+        return root;
+    if (!ref.startsWith('#/'))
+        return undefined;
+    let current = root;
+    for (const raw of ref.slice(2).split('/')) {
+        const key = raw.replace(/~1/g, '/').replace(/~0/g, '~');
+        if (typeof current !== 'object' || current === null)
+            return undefined;
+        current = current[key];
+    }
+    return typeof current === 'object' && current !== null ? current : undefined;
+}
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null)
+        return false;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length)
+        return false;
+    return keysA.every((key) => deepEqual(a[key], b[key]));
+}
+function check(schema, value, path, root, issues, depth) {
+    if (schema === true || schema === undefined)
+        return;
+    if (schema === false) {
+        issues.push({ path, message: 'is not allowed' });
+        return;
+    }
+    if (typeof schema !== 'object' || schema === null)
+        return;
+    if (depth > MAX_DEPTH) {
+        issues.push({ path, message: 'is nested too deeply' });
+        return;
+    }
+    const s = schema;
+    if (typeof s.$ref === 'string') {
+        const target = resolveRef(root, s.$ref);
+        if (target === undefined) {
+            issues.push({ path, message: `references unknown schema ${s.$ref}` });
+            return;
+        }
+        check(target, value, path, root, issues, depth + 1);
+    }
+    if (s.type !== undefined) {
+        const types = Array.isArray(s.type) ? s.type : [s.type];
+        if (!types.some((type) => matchesType(type, value))) {
+            issues.push({ path, message: `must be ${types.join(' or ')}` });
+            return;
+        }
+    }
+    if (Array.isArray(s.enum) && !s.enum.some((option) => deepEqual(option, value))) {
+        issues.push({
+            path,
+            message: `must be one of ${s.enum.map((option) => JSON.stringify(option)).join(', ')}`,
+        });
+    }
+    if ('const' in s && !deepEqual(s.const, value)) {
+        issues.push({ path, message: `must be ${JSON.stringify(s.const)}` });
+    }
+    if (typeof value === 'string') {
+        if (typeof s.minLength === 'number' && value.length < s.minLength) {
+            issues.push({ path, message: `must be at least ${s.minLength} characters` });
+        }
+        if (typeof s.maxLength === 'number' && value.length > s.maxLength) {
+            issues.push({ path, message: `must be at most ${s.maxLength} characters` });
+        }
+        if (typeof s.pattern === 'string') {
+            let pattern;
+            try {
+                pattern = new RegExp(s.pattern, 'u');
+            }
+            catch {
+                pattern = undefined;
+            }
+            if (pattern !== undefined && !pattern.test(value)) {
+                issues.push({ path, message: `must match ${s.pattern}` });
+            }
+        }
+    }
+    if (typeof value === 'number') {
+        if (typeof s.minimum === 'number' && value < s.minimum) {
+            issues.push({ path, message: `must be >= ${s.minimum}` });
+        }
+        if (typeof s.maximum === 'number' && value > s.maximum) {
+            issues.push({ path, message: `must be <= ${s.maximum}` });
+        }
+    }
+    if (Array.isArray(value)) {
+        if (typeof s.minItems === 'number' && value.length < s.minItems) {
+            issues.push({ path, message: `must have at least ${s.minItems} items` });
+        }
+        if (typeof s.maxItems === 'number' && value.length > s.maxItems) {
+            issues.push({ path, message: `must have at most ${s.maxItems} items` });
+        }
+        if (s.items !== undefined && !Array.isArray(s.items)) {
+            value.forEach((item, index) => {
+                check(s.items, item, [...path, index], root, issues, depth + 1);
+            });
+        }
+    }
+    if (matchesType('object', value)) {
+        const record = value;
+        const properties = typeof s.properties === 'object' && s.properties !== null
+            ? s.properties
+            : {};
+        if (Array.isArray(s.required)) {
+            for (const key of s.required) {
+                if (record[key] === undefined) {
+                    issues.push({ path: [...path, key], message: 'is required' });
+                }
+            }
+        }
+        for (const [key, entry] of Object.entries(record)) {
+            if (key in properties) {
+                if (entry !== undefined) {
+                    check(properties[key], entry, [...path, key], root, issues, depth + 1);
+                }
+            }
+            else if (s.additionalProperties === false) {
+                issues.push({ path: [...path, key], message: 'is not a known property' });
+            }
+            else if (typeof s.additionalProperties === 'object' && s.additionalProperties !== null) {
+                check(s.additionalProperties, entry, [...path, key], root, issues, depth + 1);
+            }
+        }
+    }
+    if (Array.isArray(s.allOf)) {
+        for (const sub of s.allOf)
+            check(sub, value, path, root, issues, depth + 1);
+    }
+    if (Array.isArray(s.anyOf) || Array.isArray(s.oneOf)) {
+        const options = (Array.isArray(s.anyOf) ? s.anyOf : s.oneOf);
+        const passing = options.filter((sub) => {
+            const nested = [];
+            check(sub, value, path, root, nested, depth + 1);
+            return nested.length === 0;
+        }).length;
+        if (Array.isArray(s.anyOf) ? passing === 0 : passing !== 1) {
+            issues.push({
+                path,
+                message: Array.isArray(s.anyOf)
+                    ? 'does not match any allowed shape'
+                    : 'must match exactly one allowed shape',
+            });
+        }
+    }
+    if (s.not !== undefined) {
+        const nested = [];
+        check(s.not, value, path, root, nested, depth + 1);
+        if (nested.length === 0) {
+            issues.push({ path, message: 'matches a shape that is not allowed' });
+        }
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/src/genui/schema.js.map

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

package/dist/src/genui/text.d.ts

@@ -0,0 +1,35 @@
+import { type Catalog } from './catalog.js';
+import { type JsonSchema } from './schema.js';
+import { type GenuiElement } from './tree.js';
+/**
+ * Plain text (Slack mrkdwn compatible) for a pushed component: its definition's `fallbackText`, or
+ * the props as a JSON block when the catalog has no text for it. A tree frame
+ * ({@link GENUI_TREE_COMPONENT}) renders node by node. Never throws — a fallback that fails prints
+ * the JSON instead.
+ */
+export declare function componentToText(catalog: Catalog, component: string, props: Record<string, unknown>): string;
+/** Plain text for a composed tree: each node's text, depth-first, blank-line free. */
+export declare function treeToText(catalog: Catalog, root: GenuiElement): string;
+export interface CatalogTextOptions {
+    /**
+     * `per-component`: each component is its own tool (`ui__show_<snake>`), named in the text.
+     * `tree`: one tool takes a nested `{ type, props, children }` tree; the text explains the format.
+     * `show`: one tool takes `{ component, props }` (the generic show tool). Default `tree`.
+     */
+    mode?: 'per-component' | 'tree' | 'show';
+    /** Tool-name prefix for `per-component`. Default `ui__show_`. */
+    namePrefix?: string;
+}
+/**
+ * The catalog described for a model: one entry per model-facing component with its description and
+ * a compact TypeScript-like signature of its props. What a tree-mode (or show) tool puts in its
+ * description, and what a host can add to a system prompt.
+ */
+export declare function catalogToModelText(catalog: Catalog, options?: CatalogTextOptions): string;
+/** A JSON Schema as a one-line TypeScript-like type, e.g. `{ title?: string, rows: object[] }`. */
+export declare function summarizeSchema(schema: unknown, root: JsonSchema, depth: number): string;
+/** Replace `{{path}}` placeholders with prop values (objects as JSON). */
+export declare function fillTemplate(template: string, props: Record<string, unknown>): string;
+/** Read `a.b[0].c` from a value; `undefined` when any step is missing. */
+export declare function getPath(source: unknown, path: string): unknown;
+//# sourceMappingURL=text.d.ts.map

package/dist/src/genui/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/genui/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAe,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,KAAK,UAAU,EAAgB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAeR;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAmBvE;AAQD,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;IACzC,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,CA6B7F;AAED,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAuCxF;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAMrF;AAED,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAU9D"}