@elastic/isomer-sdk 0.0.0 → 0.1.0

package/dist/testing/registration.js

@@ -0,0 +1,103 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+// Node-only, and reached only through the `./testing` entry: this reads the
+// filesystem, which no rendering path may do.
+import { readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+const ENTRY_FILES = ['index.tsx', 'index.ts'];
+/** Duck-typed so a definition from a different copy of the sdk still matches. */
+const isPrimitiveDefinition = (value) => {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const { type, catalog, schema, renderers } = value;
+    return (typeof type === 'string' &&
+        typeof catalog === 'object' &&
+        catalog !== null &&
+        typeof schema === 'object' &&
+        schema !== null &&
+        typeof renderers === 'object' &&
+        renderers !== null);
+};
+const entryFileIn = (dir) => {
+    for (const name of ENTRY_FILES) {
+        const candidate = join(dir, name);
+        try {
+            if (statSync(candidate).isFile()) {
+                return candidate;
+            }
+        }
+        catch {
+            // Not this name; try the next.
+        }
+    }
+    return undefined;
+};
+const subdirectoriesOf = (root, ignore) => readdirSync(root, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory() && !ignore.includes(entry.name))
+    .map((entry) => entry.name)
+    .sort();
+/**
+ * Fails when the primitives directory and the pack's registry disagree: a
+ * subdirectory with no entry file or no exported definition, a defined type
+ * nothing registers, or a registered type no directory defines. Each problem
+ * line carries its fix.
+ *
+ * A pack keeps two hand-written lists, the registry array and the body-node
+ * union, and nothing in the type system relates either to the directory they
+ * describe. A primitive absent from both lists leaves them agreeing with each
+ * other, so it compiles and every other test passes while the primitive is
+ * unreachable. This is the check that notices.
+ *
+ * @example
+ * ```ts
+ * await assertPackRegistrationComplete({
+ *   primitivesDir: new URL('./primitives/', import.meta.url),
+ *   registered: slideDeckPrimitives,
+ * });
+ * ```
+ */
+export const assertPackRegistrationComplete = async ({ primitivesDir, registered, ignore = [], }) => {
+    const root = typeof primitivesDir === 'string'
+        ? primitivesDir
+        : fileURLToPath(primitivesDir);
+    const registeredTypes = new Set(registered.map(({ type }) => type));
+    const problems = [];
+    const foundTypes = new Set();
+    for (const folder of subdirectoriesOf(root, ignore)) {
+        const entry = entryFileIn(join(root, folder));
+        if (!entry) {
+            problems.push(`${folder}/ has no ${ENTRY_FILES.join(' or ')}; add one or pass it in \`ignore\`.`);
+            continue;
+        }
+        const module = (await import(pathToFileURL(entry).href));
+        const exported = Object.entries(module).filter(([, value]) => isPrimitiveDefinition(value));
+        if (exported.length === 0) {
+            problems.push(`${folder}/ exports no primitive definition; add one or pass it in \`ignore\`.`);
+            continue;
+        }
+        for (const [exportName, definition] of exported) {
+            foundTypes.add(definition.type);
+            if (registeredTypes.has(definition.type)) {
+                continue;
+            }
+            problems.push(`${folder}/ defines "${definition.type}" but nothing registers it.\n` +
+                `  Import \`${exportName}\` from './${folder}' and add it to the registry array,\n` +
+                `  then add its node type to the pack's body-node union.`);
+        }
+    }
+    for (const { type } of registered) {
+        if (!foundTypes.has(type)) {
+            problems.push(`"${type}" is registered but no directory under ${root} defines it.`);
+        }
+    }
+    if (problems.length > 0) {
+        throw new Error(`Pack registration is incomplete:\n${problems.map((line) => `- ${line}`).join('\n')}`);
+    }
+};
+//# sourceMappingURL=registration.js.map

package/dist/testing/registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../src/testing/registration.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n// Node-only, and reached only through the `./testing` entry: this reads the\n// filesystem, which no rendering path may do.\n\nimport { readdirSync, statSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\n\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\n/** What {@link assertPackRegistrationComplete} needs to compare a pack against its directory. */\nexport interface PackRegistrationOptions {\n  /** Directory whose subdirectories are one primitive each. A `URL` is resolved with `fileURLToPath`. */\n  primitivesDir: URL | string;\n  /** The pack's registry array, as passed to `definePrimitivePack`. */\n  registered: readonly AnyPrimitiveDefinition[];\n  /** Subdirectory names that hold no primitive. */\n  ignore?: readonly string[];\n}\n\nconst ENTRY_FILES = ['index.tsx', 'index.ts'] as const;\n\n/** Duck-typed so a definition from a different copy of the sdk still matches. */\nconst isPrimitiveDefinition = (\n  value: unknown\n): value is AnyPrimitiveDefinition => {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n  const { type, catalog, schema, renderers } = value as Record<string, unknown>;\n  return (\n    typeof type === 'string' &&\n    typeof catalog === 'object' &&\n    catalog !== null &&\n    typeof schema === 'object' &&\n    schema !== null &&\n    typeof renderers === 'object' &&\n    renderers !== null\n  );\n};\n\nconst entryFileIn = (dir: string): string | undefined => {\n  for (const name of ENTRY_FILES) {\n    const candidate = join(dir, name);\n    try {\n      if (statSync(candidate).isFile()) {\n        return candidate;\n      }\n    } catch {\n      // Not this name; try the next.\n    }\n  }\n  return undefined;\n};\n\nconst subdirectoriesOf = (root: string, ignore: readonly string[]): string[] =>\n  readdirSync(root, { withFileTypes: true })\n    .filter((entry) => entry.isDirectory() && !ignore.includes(entry.name))\n    .map((entry) => entry.name)\n    .sort();\n\n/**\n * Fails when the primitives directory and the pack's registry disagree: a\n * subdirectory with no entry file or no exported definition, a defined type\n * nothing registers, or a registered type no directory defines. Each problem\n * line carries its fix.\n *\n * A pack keeps two hand-written lists, the registry array and the body-node\n * union, and nothing in the type system relates either to the directory they\n * describe. A primitive absent from both lists leaves them agreeing with each\n * other, so it compiles and every other test passes while the primitive is\n * unreachable. This is the check that notices.\n *\n * @example\n * ```ts\n * await assertPackRegistrationComplete({\n *   primitivesDir: new URL('./primitives/', import.meta.url),\n *   registered: slideDeckPrimitives,\n * });\n * ```\n */\nexport const assertPackRegistrationComplete = async ({\n  primitivesDir,\n  registered,\n  ignore = [],\n}: PackRegistrationOptions): Promise<void> => {\n  const root =\n    typeof primitivesDir === 'string'\n      ? primitivesDir\n      : fileURLToPath(primitivesDir);\n  const registeredTypes = new Set(registered.map(({ type }) => type));\n  const problems: string[] = [];\n  const foundTypes = new Set<string>();\n\n  for (const folder of subdirectoriesOf(root, ignore)) {\n    const entry = entryFileIn(join(root, folder));\n    if (!entry) {\n      problems.push(\n        `${folder}/ has no ${ENTRY_FILES.join(' or ')}; add one or pass it in \\`ignore\\`.`\n      );\n      continue;\n    }\n\n    const module = (await import(pathToFileURL(entry).href)) as Record<\n      string,\n      unknown\n    >;\n    const exported = Object.entries(module).filter(([, value]) =>\n      isPrimitiveDefinition(value)\n    ) as Array<[string, AnyPrimitiveDefinition]>;\n\n    if (exported.length === 0) {\n      problems.push(\n        `${folder}/ exports no primitive definition; add one or pass it in \\`ignore\\`.`\n      );\n      continue;\n    }\n\n    for (const [exportName, definition] of exported) {\n      foundTypes.add(definition.type);\n      if (registeredTypes.has(definition.type)) {\n        continue;\n      }\n      problems.push(\n        `${folder}/ defines \"${definition.type}\" but nothing registers it.\\n` +\n          `  Import \\`${exportName}\\` from './${folder}' and add it to the registry array,\\n` +\n          `  then add its node type to the pack's body-node union.`\n      );\n    }\n  }\n\n  for (const { type } of registered) {\n    if (!foundTypes.has(type)) {\n      problems.push(\n        `\"${type}\" is registered but no directory under ${root} defines it.`\n      );\n    }\n  }\n\n  if (problems.length > 0) {\n    throw new Error(\n      `Pack registration is incomplete:\\n${problems.map((line) => `- ${line}`).join('\\n')}`\n    );\n  }\n};\n"]}

package/dist/validate/authoring_schema.d.ts

@@ -0,0 +1,27 @@
+import type { AnyPrimitiveDefinition } from '../define/primitive_module.js';
+import { type CompositionJsonSchemaOptions } from './json_schema.js';
+type JsonSchema = Record<string, unknown>;
+/** Options for {@link buildAuthoringJsonSchema}. */
+export interface AuthoringJsonSchemaOptions extends CompositionJsonSchemaOptions {
+    /** `$def` id to `description`. Survives `z.toJSONSchema` dropping `.refine` text. */
+    describe?: Readonly<Record<string, string>>;
+    /** `$defId.property` paths to drop, e.g. `'kpi.delta'`. */
+    omitProperties?: readonly string[];
+}
+/**
+ * Projects a composition to the JSON Schema an agent reads.
+ *
+ * {@link buildCompositionJsonSchema} stays the validator projection. This walk
+ * names shared SDK defs, inlines scalar leaves, and drops host-only fields.
+ */
+export declare const buildAuthoringJsonSchema: (definitions: readonly AnyPrimitiveDefinition[], options?: AuthoringJsonSchemaOptions) => JsonSchema;
+/**
+ * The `$defs` that `types` reach in a schema from {@link buildAuthoringJsonSchema},
+ * keyed as `schema` keys them, with the body-node union stubbed so a container
+ * does not pull in every primitive.
+ */
+export declare const authoringSchemaSubset: (schema: JsonSchema, types: readonly string[]) => {
+    $defs: Record<string, unknown>;
+};
+export {};
+//# sourceMappingURL=authoring_schema.d.ts.map

package/dist/validate/authoring_schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring_schema.d.ts","sourceRoot":"","sources":["../../src/validate/authoring_schema.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,eAAe,CAAC;AAQvB,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAc1C,oDAAoD;AACpD,MAAM,WAAW,0BAA2B,SAAQ,4BAA4B;IAC9E,qFAAqF;IACrF,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,2DAA2D;IAC3D,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AA6RD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,aAAa,SAAS,sBAAsB,EAAE,EAC9C,UAAS,0BAA+B,KACvC,UAUF,CAAC;AAOF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,OAAO,SAAS,MAAM,EAAE,KACvB;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAwBlC,CAAC"}

package/dist/validate/authoring_schema.js

@@ -0,0 +1,291 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { buildCompositionJsonSchema, } from './json_schema.js';
+import { displayValueSchema, namedColorSchema, renderThemeSchema, structuredValueSchema, } from './value_schemas.js';
+const DEF_PREFIX = '#/$defs/';
+const BODY_NODE_ID = 'bodyNode';
+const SAFE_INTEGER_MAX = Number.MAX_SAFE_INTEGER;
+const SCALAR_TYPES = new Set(['string', 'number', 'integer', 'boolean']);
+const DEFAULT_EXTRA_DEFS = [
+    { schema: namedColorSchema, id: 'tone' },
+    { schema: displayValueSchema, id: 'displayValue' },
+    { schema: structuredValueSchema, id: 'structuredValue' },
+    { schema: renderThemeSchema, id: 'renderTheme' },
+];
+const isJsonObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const cloneJson = (value) => JSON.parse(JSON.stringify(value));
+const ownDef = (defs, id) => Object.hasOwn(defs, id) ? defs[id] : undefined;
+const parseDefRef = (ref) => {
+    if (typeof ref !== 'string' || !ref.startsWith(DEF_PREFIX)) {
+        return undefined;
+    }
+    return ref.slice(DEF_PREFIX.length);
+};
+const walkJson = (node, visit) => {
+    if (Array.isArray(node)) {
+        for (const item of node) {
+            walkJson(item, visit);
+        }
+        return;
+    }
+    if (!isJsonObject(node)) {
+        return;
+    }
+    visit(node);
+    for (const value of Object.values(node)) {
+        walkJson(value, visit);
+    }
+};
+const mapJson = (node, visit) => {
+    if (Array.isArray(node)) {
+        return node.map((item) => mapJson(item, visit));
+    }
+    if (!isJsonObject(node)) {
+        return node;
+    }
+    return Object.fromEntries(Object.entries(visit(node)).map(([key, value]) => [
+        key,
+        mapJson(value, visit),
+    ]));
+};
+const rewriteDefRefs = (schema, rewrite) => mapJson(schema, (node) => {
+    const id = parseDefRef(node.$ref);
+    if (id === undefined) {
+        return node;
+    }
+    const replacement = rewrite(id);
+    if (replacement === undefined) {
+        return node;
+    }
+    if (typeof replacement === 'string') {
+        return { ...node, $ref: `${DEF_PREFIX}${replacement}` };
+    }
+    const rest = { ...node };
+    delete rest.$ref;
+    return Object.keys(rest).length === 0
+        ? cloneJson(replacement)
+        : { ...cloneJson(replacement), ...rest };
+});
+const isRefOnlyDef = (def) => isJsonObject(def) &&
+    Object.keys(def).length === 1 &&
+    typeof def.$ref === 'string';
+const isBareScalarDef = (def) => {
+    if (!isJsonObject(def)) {
+        return false;
+    }
+    const { type } = def;
+    if (typeof type !== 'string' || !SCALAR_TYPES.has(type)) {
+        return false;
+    }
+    return !['enum', 'const', '$ref', 'properties'].some((key) => Object.hasOwn(def, key));
+};
+const defsOf = (schema) => isJsonObject(schema.$defs) ? schema.$defs : {};
+const withDefs = (schema, defs) => ({ ...schema, $defs: defs });
+const dropSafeIntegerMaxima = (schema) => {
+    walkJson(schema, (node) => {
+        if (node.maximum === SAFE_INTEGER_MAX) {
+            delete node.maximum;
+        }
+        if (node.minimum === -SAFE_INTEGER_MAX) {
+            delete node.minimum;
+        }
+    });
+};
+const dropNodeIdAndSurfaces = (schema) => {
+    for (const def of Object.values(defsOf(schema))) {
+        if (!isJsonObject(def) || !isJsonObject(def.properties)) {
+            continue;
+        }
+        const typeProp = def.properties.type;
+        if (!isJsonObject(typeProp) || typeof typeProp.const !== 'string') {
+            continue;
+        }
+        delete def.properties.id;
+        delete def.properties.surfaces;
+        if (Array.isArray(def.required)) {
+            def.required = def.required.filter((key) => key !== 'id' && key !== 'surfaces');
+        }
+    }
+};
+const omitListedProperties = (schema, paths) => {
+    const defs = defsOf(schema);
+    for (const path of paths) {
+        const dot = path.indexOf('.');
+        if (dot <= 0) {
+            continue;
+        }
+        const defId = path.slice(0, dot);
+        const property = path.slice(dot + 1);
+        const def = ownDef(defs, defId);
+        if (!isJsonObject(def) || !isJsonObject(def.properties)) {
+            continue;
+        }
+        delete def.properties[property];
+        if (Array.isArray(def.required)) {
+            def.required = def.required.filter((key) => key !== property);
+        }
+    }
+};
+const applyDescriptions = (schema, describe) => {
+    const defs = defsOf(schema);
+    for (const [id, description] of Object.entries(describe)) {
+        const def = ownDef(defs, id);
+        if (isJsonObject(def)) {
+            def.description = description;
+        }
+    }
+};
+const flattenRefOnlyDefs = (schema) => {
+    const defs = defsOf(schema);
+    const aliases = new Map();
+    for (const [id, def] of Object.entries(defs)) {
+        if (id === BODY_NODE_ID || !isRefOnlyDef(def)) {
+            continue;
+        }
+        const target = parseDefRef(def.$ref);
+        if (target === undefined || target === id) {
+            continue;
+        }
+        aliases.set(id, target);
+    }
+    if (aliases.size === 0) {
+        return schema;
+    }
+    const resolve = (id) => {
+        const seen = new Set();
+        let current = id;
+        while (aliases.has(current) && !seen.has(current)) {
+            seen.add(current);
+            current = aliases.get(current) ?? current;
+        }
+        return current;
+    };
+    const rewritten = rewriteDefRefs(schema, (id) => aliases.has(id) ? resolve(id) : undefined);
+    const nextDefs = { ...defsOf(rewritten) };
+    for (const id of aliases.keys()) {
+        delete nextDefs[id];
+    }
+    return withDefs(rewritten, nextDefs);
+};
+const inlineScalarDefs = (schema) => {
+    const defs = defsOf(schema);
+    const scalars = new Map();
+    for (const [id, def] of Object.entries(defs)) {
+        if (id === BODY_NODE_ID || !isBareScalarDef(def)) {
+            continue;
+        }
+        scalars.set(id, def);
+    }
+    if (scalars.size === 0) {
+        return schema;
+    }
+    const rewritten = rewriteDefRefs(schema, (id) => scalars.get(id));
+    const nextDefs = { ...defsOf(rewritten) };
+    for (const id of scalars.keys()) {
+        delete nextDefs[id];
+    }
+    return withDefs(rewritten, nextDefs);
+};
+const pruneUnreferencedDefs = (schema) => {
+    const defs = defsOf(schema);
+    if (Object.keys(defs).length === 0) {
+        return schema;
+    }
+    const referenced = new Set();
+    const visit = (node) => {
+        walkJson(node, (value) => {
+            const id = parseDefRef(value.$ref);
+            if (id === undefined || referenced.has(id)) {
+                return;
+            }
+            referenced.add(id);
+            visit(ownDef(defs, id));
+        });
+    };
+    const root = { ...schema };
+    delete root.$defs;
+    visit(root);
+    referenced.add(BODY_NODE_ID);
+    visit(defs[BODY_NODE_ID]);
+    return withDefs(schema, Object.fromEntries(Object.entries(defs).filter(([id]) => referenced.has(id))));
+};
+const mergeExtraDefs = (extras) => {
+    const bySchema = new Map();
+    for (const item of DEFAULT_EXTRA_DEFS) {
+        bySchema.set(item.schema, item);
+    }
+    for (const item of extras ?? []) {
+        bySchema.set(item.schema, item);
+    }
+    const byId = new Map();
+    for (const item of bySchema.values()) {
+        byId.set(item.id, item);
+    }
+    return [...byId.values()];
+};
+const slimAuthoringSchema = (schema, options) => {
+    const next = cloneJson(schema);
+    dropSafeIntegerMaxima(next);
+    dropNodeIdAndSurfaces(next);
+    omitListedProperties(next, options.omitProperties ?? []);
+    const flattened = flattenRefOnlyDefs(next);
+    const inlined = inlineScalarDefs(flattened);
+    const pruned = pruneUnreferencedDefs(inlined);
+    applyDescriptions(pruned, options.describe ?? {});
+    return pruned;
+};
+/**
+ * Projects a composition to the JSON Schema an agent reads.
+ *
+ * {@link buildCompositionJsonSchema} stays the validator projection. This walk
+ * names shared SDK defs, inlines scalar leaves, and drops host-only fields.
+ */
+export const buildAuthoringJsonSchema = (definitions, options = {}) => {
+    const { describe, omitProperties, extraDefs, ...rest } = options;
+    const projected = buildCompositionJsonSchema(definitions, {
+        ...rest,
+        extraDefs: mergeExtraDefs(extraDefs),
+    });
+    return slimAuthoringSchema(projected, {
+        ...(describe === undefined ? {} : { describe }),
+        ...(omitProperties === undefined ? {} : { omitProperties }),
+    });
+};
+const BODY_NODE_STUB = {
+    description: 'Any primitive in the catalog, as its own object with its `type`.',
+};
+/**
+ * The `$defs` that `types` reach in a schema from {@link buildAuthoringJsonSchema},
+ * keyed as `schema` keys them, with the body-node union stubbed so a container
+ * does not pull in every primitive.
+ */
+export const authoringSchemaSubset = (schema, types) => {
+    const defs = defsOf(schema);
+    // A `Map`, so an id such as `constructor` is never an inherited key.
+    const kept = new Map();
+    const visit = (id) => {
+        if (kept.has(id) || !Object.hasOwn(defs, id)) {
+            return;
+        }
+        if (id === BODY_NODE_ID) {
+            kept.set(id, BODY_NODE_STUB);
+            return;
+        }
+        kept.set(id, defs[id]);
+        walkJson(defs[id], (value) => {
+            const ref = parseDefRef(value.$ref);
+            if (ref !== undefined) {
+                visit(ref);
+            }
+        });
+    };
+    for (const type of types) {
+        visit(type);
+    }
+    return { $defs: Object.fromEntries(kept) };
+};
+//# sourceMappingURL=authoring_schema.js.map

package/dist/validate/authoring_schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring_schema.js","sourceRoot":"","sources":["../../src/validate/authoring_schema.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport type { ZodType } from 'zod';\n\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\nimport {\n  buildCompositionJsonSchema,\n  type CompositionJsonSchemaOptions,\n} from './json_schema';\nimport {\n  displayValueSchema,\n  namedColorSchema,\n  renderThemeSchema,\n  structuredValueSchema,\n} from './value_schemas';\n\ntype JsonSchema = Record<string, unknown>;\n\nconst DEF_PREFIX = '#/$defs/';\nconst BODY_NODE_ID = 'bodyNode';\nconst SAFE_INTEGER_MAX = Number.MAX_SAFE_INTEGER;\nconst SCALAR_TYPES = new Set(['string', 'number', 'integer', 'boolean']);\n\nconst DEFAULT_EXTRA_DEFS: readonly { schema: ZodType; id: string }[] = [\n  { schema: namedColorSchema, id: 'tone' },\n  { schema: displayValueSchema, id: 'displayValue' },\n  { schema: structuredValueSchema, id: 'structuredValue' },\n  { schema: renderThemeSchema, id: 'renderTheme' },\n];\n\n/** Options for {@link buildAuthoringJsonSchema}. */\nexport interface AuthoringJsonSchemaOptions extends CompositionJsonSchemaOptions {\n  /** `$def` id to `description`. Survives `z.toJSONSchema` dropping `.refine` text. */\n  describe?: Readonly<Record<string, string>>;\n  /** `$defId.property` paths to drop, e.g. `'kpi.delta'`. */\n  omitProperties?: readonly string[];\n}\n\nconst isJsonObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst cloneJson = <T>(value: T): T => JSON.parse(JSON.stringify(value)) as T;\n\nconst ownDef = (defs: Record<string, unknown>, id: string): unknown =>\n  Object.hasOwn(defs, id) ? defs[id] : undefined;\n\nconst parseDefRef = (ref: unknown): string | undefined => {\n  if (typeof ref !== 'string' || !ref.startsWith(DEF_PREFIX)) {\n    return undefined;\n  }\n  return ref.slice(DEF_PREFIX.length);\n};\n\nconst walkJson = (\n  node: unknown,\n  visit: (value: Record<string, unknown>) => void\n): void => {\n  if (Array.isArray(node)) {\n    for (const item of node) {\n      walkJson(item, visit);\n    }\n    return;\n  }\n  if (!isJsonObject(node)) {\n    return;\n  }\n  visit(node);\n  for (const value of Object.values(node)) {\n    walkJson(value, visit);\n  }\n};\n\nconst mapJson = (\n  node: unknown,\n  visit: (value: Record<string, unknown>) => Record<string, unknown>\n): unknown => {\n  if (Array.isArray(node)) {\n    return node.map((item) => mapJson(item, visit));\n  }\n  if (!isJsonObject(node)) {\n    return node;\n  }\n  return Object.fromEntries(\n    Object.entries(visit(node)).map(([key, value]) => [\n      key,\n      mapJson(value, visit),\n    ])\n  );\n};\n\nconst rewriteDefRefs = (\n  schema: JsonSchema,\n  rewrite: (id: string) => string | JsonSchema | undefined\n): JsonSchema =>\n  mapJson(schema, (node) => {\n    const id = parseDefRef(node.$ref);\n    if (id === undefined) {\n      return node;\n    }\n    const replacement = rewrite(id);\n    if (replacement === undefined) {\n      return node;\n    }\n    if (typeof replacement === 'string') {\n      return { ...node, $ref: `${DEF_PREFIX}${replacement}` };\n    }\n    const rest = { ...node };\n    delete rest.$ref;\n    return Object.keys(rest).length === 0\n      ? cloneJson(replacement)\n      : { ...cloneJson(replacement), ...rest };\n  }) as JsonSchema;\n\nconst isRefOnlyDef = (def: unknown): def is { $ref: string } =>\n  isJsonObject(def) &&\n  Object.keys(def).length === 1 &&\n  typeof def.$ref === 'string';\n\nconst isBareScalarDef = (def: unknown): def is Record<string, unknown> => {\n  if (!isJsonObject(def)) {\n    return false;\n  }\n  const { type } = def;\n  if (typeof type !== 'string' || !SCALAR_TYPES.has(type)) {\n    return false;\n  }\n  return !['enum', 'const', '$ref', 'properties'].some((key) =>\n    Object.hasOwn(def, key)\n  );\n};\n\nconst defsOf = (schema: JsonSchema): Record<string, unknown> =>\n  isJsonObject(schema.$defs) ? schema.$defs : {};\n\nconst withDefs = (\n  schema: JsonSchema,\n  defs: Record<string, unknown>\n): JsonSchema => ({ ...schema, $defs: defs });\n\nconst dropSafeIntegerMaxima = (schema: JsonSchema): void => {\n  walkJson(schema, (node) => {\n    if (node.maximum === SAFE_INTEGER_MAX) {\n      delete node.maximum;\n    }\n    if (node.minimum === -SAFE_INTEGER_MAX) {\n      delete node.minimum;\n    }\n  });\n};\n\nconst dropNodeIdAndSurfaces = (schema: JsonSchema): void => {\n  for (const def of Object.values(defsOf(schema))) {\n    if (!isJsonObject(def) || !isJsonObject(def.properties)) {\n      continue;\n    }\n    const typeProp = def.properties.type;\n    if (!isJsonObject(typeProp) || typeof typeProp.const !== 'string') {\n      continue;\n    }\n    delete def.properties.id;\n    delete def.properties.surfaces;\n    if (Array.isArray(def.required)) {\n      def.required = def.required.filter(\n        (key) => key !== 'id' && key !== 'surfaces'\n      );\n    }\n  }\n};\n\nconst omitListedProperties = (\n  schema: JsonSchema,\n  paths: readonly string[]\n): void => {\n  const defs = defsOf(schema);\n  for (const path of paths) {\n    const dot = path.indexOf('.');\n    if (dot <= 0) {\n      continue;\n    }\n    const defId = path.slice(0, dot);\n    const property = path.slice(dot + 1);\n    const def = ownDef(defs, defId);\n    if (!isJsonObject(def) || !isJsonObject(def.properties)) {\n      continue;\n    }\n    delete def.properties[property];\n    if (Array.isArray(def.required)) {\n      def.required = def.required.filter((key) => key !== property);\n    }\n  }\n};\n\nconst applyDescriptions = (\n  schema: JsonSchema,\n  describe: Readonly<Record<string, string>>\n): void => {\n  const defs = defsOf(schema);\n  for (const [id, description] of Object.entries(describe)) {\n    const def = ownDef(defs, id);\n    if (isJsonObject(def)) {\n      def.description = description;\n    }\n  }\n};\n\nconst flattenRefOnlyDefs = (schema: JsonSchema): JsonSchema => {\n  const defs = defsOf(schema);\n  const aliases = new Map<string, string>();\n  for (const [id, def] of Object.entries(defs)) {\n    if (id === BODY_NODE_ID || !isRefOnlyDef(def)) {\n      continue;\n    }\n    const target = parseDefRef(def.$ref);\n    if (target === undefined || target === id) {\n      continue;\n    }\n    aliases.set(id, target);\n  }\n  if (aliases.size === 0) {\n    return schema;\n  }\n  const resolve = (id: string): string => {\n    const seen = new Set<string>();\n    let current = id;\n    while (aliases.has(current) && !seen.has(current)) {\n      seen.add(current);\n      current = aliases.get(current) ?? current;\n    }\n    return current;\n  };\n  const rewritten = rewriteDefRefs(schema, (id) =>\n    aliases.has(id) ? resolve(id) : undefined\n  );\n  const nextDefs = { ...defsOf(rewritten) };\n  for (const id of aliases.keys()) {\n    delete nextDefs[id];\n  }\n  return withDefs(rewritten, nextDefs);\n};\n\nconst inlineScalarDefs = (schema: JsonSchema): JsonSchema => {\n  const defs = defsOf(schema);\n  const scalars = new Map<string, Record<string, unknown>>();\n  for (const [id, def] of Object.entries(defs)) {\n    if (id === BODY_NODE_ID || !isBareScalarDef(def)) {\n      continue;\n    }\n    scalars.set(id, def);\n  }\n  if (scalars.size === 0) {\n    return schema;\n  }\n  const rewritten = rewriteDefRefs(schema, (id) => scalars.get(id));\n  const nextDefs = { ...defsOf(rewritten) };\n  for (const id of scalars.keys()) {\n    delete nextDefs[id];\n  }\n  return withDefs(rewritten, nextDefs);\n};\n\nconst pruneUnreferencedDefs = (schema: JsonSchema): JsonSchema => {\n  const defs = defsOf(schema);\n  if (Object.keys(defs).length === 0) {\n    return schema;\n  }\n  const referenced = new Set<string>();\n  const visit = (node: unknown): void => {\n    walkJson(node, (value) => {\n      const id = parseDefRef(value.$ref);\n      if (id === undefined || referenced.has(id)) {\n        return;\n      }\n      referenced.add(id);\n      visit(ownDef(defs, id));\n    });\n  };\n  const root: JsonSchema = { ...schema };\n  delete root.$defs;\n  visit(root);\n  referenced.add(BODY_NODE_ID);\n  visit(defs[BODY_NODE_ID]);\n  return withDefs(\n    schema,\n    Object.fromEntries(\n      Object.entries(defs).filter(([id]) => referenced.has(id))\n    )\n  );\n};\n\nconst mergeExtraDefs = (\n  extras: CompositionJsonSchemaOptions['extraDefs']\n): { schema: ZodType; id: string }[] => {\n  const bySchema = new Map<ZodType, { schema: ZodType; id: string }>();\n  for (const item of DEFAULT_EXTRA_DEFS) {\n    bySchema.set(item.schema, item);\n  }\n  for (const item of extras ?? []) {\n    bySchema.set(item.schema, item);\n  }\n  const byId = new Map<string, { schema: ZodType; id: string }>();\n  for (const item of bySchema.values()) {\n    byId.set(item.id, item);\n  }\n  return [...byId.values()];\n};\n\nconst slimAuthoringSchema = (\n  schema: JsonSchema,\n  options: AuthoringJsonSchemaOptions\n): JsonSchema => {\n  const next = cloneJson(schema);\n  dropSafeIntegerMaxima(next);\n  dropNodeIdAndSurfaces(next);\n  omitListedProperties(next, options.omitProperties ?? []);\n  const flattened = flattenRefOnlyDefs(next);\n  const inlined = inlineScalarDefs(flattened);\n  const pruned = pruneUnreferencedDefs(inlined);\n  applyDescriptions(pruned, options.describe ?? {});\n  return pruned;\n};\n\n/**\n * Projects a composition to the JSON Schema an agent reads.\n *\n * {@link buildCompositionJsonSchema} stays the validator projection. This walk\n * names shared SDK defs, inlines scalar leaves, and drops host-only fields.\n */\nexport const buildAuthoringJsonSchema = (\n  definitions: readonly AnyPrimitiveDefinition[],\n  options: AuthoringJsonSchemaOptions = {}\n): JsonSchema => {\n  const { describe, omitProperties, extraDefs, ...rest } = options;\n  const projected = buildCompositionJsonSchema(definitions, {\n    ...rest,\n    extraDefs: mergeExtraDefs(extraDefs),\n  });\n  return slimAuthoringSchema(projected, {\n    ...(describe === undefined ? {} : { describe }),\n    ...(omitProperties === undefined ? {} : { omitProperties }),\n  });\n};\n\nconst BODY_NODE_STUB = {\n  description:\n    'Any primitive in the catalog, as its own object with its `type`.',\n};\n\n/**\n * The `$defs` that `types` reach in a schema from {@link buildAuthoringJsonSchema},\n * keyed as `schema` keys them, with the body-node union stubbed so a container\n * does not pull in every primitive.\n */\nexport const authoringSchemaSubset = (\n  schema: JsonSchema,\n  types: readonly string[]\n): { $defs: Record<string, unknown> } => {\n  const defs = defsOf(schema);\n  // A `Map`, so an id such as `constructor` is never an inherited key.\n  const kept = new Map<string, unknown>();\n  const visit = (id: string): void => {\n    if (kept.has(id) || !Object.hasOwn(defs, id)) {\n      return;\n    }\n    if (id === BODY_NODE_ID) {\n      kept.set(id, BODY_NODE_STUB);\n      return;\n    }\n    kept.set(id, defs[id]);\n    walkJson(defs[id], (value) => {\n      const ref = parseDefRef(value.$ref);\n      if (ref !== undefined) {\n        visit(ref);\n      }\n    });\n  };\n  for (const type of types) {\n    visit(type);\n  }\n  return { $defs: Object.fromEntries(kept) };\n};\n"]}

package/dist/validate/composition_schema.d.ts

@@ -0,0 +1,80 @@
+import { z, type ZodObject, type ZodType } from 'zod';
+import type { AnyPrimitiveDefinition } from '../define/primitive_module.js';
+/** `Composition.meta`: provenance and freshness, every field optional. */
+export declare const metaSchema: z.ZodObject<{
+    source: z.ZodOptional<z.ZodString>;
+    generatedAt: z.ZodOptional<z.ZodString>;
+    ariaLabel: z.ZodOptional<z.ZodString>;
+    provenance: z.ZodOptional<z.ZodObject<{
+        source: z.ZodOptional<z.ZodString>;
+        query: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    freshness: z.ZodOptional<z.ZodObject<{
+        asOf: z.ZodOptional<z.ZodString>;
+        stale: z.ZodOptional<z.ZodBoolean>;
+        ttlSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    partialFailure: z.ZodOptional<z.ZodObject<{
+        degraded: z.ZodOptional<z.ZodBoolean>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Options for the `Composition` envelope schema a body-node union is wrapped in. */
+export interface CompositionSchemaOptions {
+    /** The union the envelope's `body` array holds, as {@link resolveVocabulary} builds it. */
+    bodyNodeSchema: ZodType<unknown>;
+}
+/**
+ * Wraps a body-node union in the `Composition` envelope.
+ *
+ * `.strict()`, so an unknown root key is an error rather than silently carried:
+ * the format crosses vendor boundaries, and a typo'd field that validates is
+ * worse than one that fails. Most callers want
+ * {@link getCompositionSchemaForDefinitions} instead, which memoizes.
+ */
+export declare const buildCompositionSchema: ({ bodyNodeSchema, }: CompositionSchemaOptions) => ZodObject;
+/**
+ * One set of definitions resolved into a body-node union, with the schema
+ * instance that actually landed in it per primitive type.
+ *
+ * The members matter to callers because a container's schema in the union is
+ * built by `schemaFor` and is therefore *not* `definition.schema`. Anything
+ * keyed on identity — the JSON Schema id registry, which names `$defs` — has to
+ * be given these, or a container's projection silently loses its name.
+ */
+export interface ResolvedVocabulary {
+    /** The discriminated union over every primitive type in this vocabulary. */
+    bodyNodeSchema: ZodType<unknown>;
+    /** Keyed by node type. A container's value comes from `schemaFor`, not `definition.schema`. */
+    members: ReadonlyMap<string, ZodObject>;
+}
+/**
+ * Builds a body-node union whose containers reference *this* union.
+ *
+ * The `z.lazy` closing the recursion is created here and discarded with the
+ * vocabulary: it memoizes its getter after the first resolution, so one shared
+ * across vocabularies would freeze on whichever union parsed first.
+ */
+export declare const resolveVocabulary: (definitions: readonly AnyPrimitiveDefinition[]) => ResolvedVocabulary;
+/**
+ * {@link resolveVocabulary}, discarding the member instances.
+ *
+ * Only for a caller with no id registry to name; anything projecting to JSON
+ * Schema needs the members and should use {@link resolveVocabulary}.
+ */
+export declare const buildBodyNodeSchemaFromDefinitions: (definitions: readonly AnyPrimitiveDefinition[]) => ZodType<unknown>;
+/**
+ * A fresh `Composition` schema over `definitions`.
+ *
+ * Builds a new union per call. Prefer
+ * {@link getCompositionSchemaForDefinitions} unless a fresh instance is
+ * required.
+ */
+export declare const buildCompositionSchemaFromDefinitions: (definitions: readonly AnyPrimitiveDefinition[]) => ZodObject;
+/**
+ * {@link buildCompositionSchemaFromDefinitions}, memoized per definition array.
+ * Prefer this whenever the caller does not need a fresh schema instance.
+ */
+export declare const getCompositionSchemaForDefinitions: (definitions: readonly AnyPrimitiveDefinition[]) => ZodObject;
+//# sourceMappingURL=composition_schema.d.ts.map

package/dist/validate/composition_schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition_schema.d.ts","sourceRoot":"","sources":["../../src/validate/composition_schema.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAGtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAIzE,0EAA0E;AAC1E,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;iBAwBrB,CAAC;AAEH,qFAAqF;AACrF,MAAM,WAAW,wBAAwB;IACvC,2FAA2F;IAC3F,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,qBAEpC,wBAAwB,KAAG,SAajB,CAAC;AAEd;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,+FAA+F;IAC/F,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACzC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,aAAa,SAAS,sBAAsB,EAAE,KAC7C,kBAmCF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC,GAC7C,aAAa,SAAS,sBAAsB,EAAE,KAC7C,OAAO,CAAC,OAAO,CAAkD,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,qCAAqC,GAChD,aAAa,SAAS,sBAAsB,EAAE,KAC7C,SAGC,CAAC;AAgCL;;;GAGG;AACH,eAAO,MAAM,kCAAkC,GAC7C,aAAa,SAAS,sBAAsB,EAAE,KAC7C,SAA0C,CAAC"}