@aid-framework/generator-ts-vercel 0.0.0 → 0.1.48

package/dist/emit/text.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Byte-level helpers every emitter goes through.
+ *
+ * A generated file is the banner, then the body, then exactly one trailing newline and
+ * no tabs. `normalizeText` from the SDK enforces the newline half so the determinism
+ * check and the emitters agree by construction rather than by convention.
+ */
+import { GENERATED_BANNER_MARKER, sha256Hex } from '@aid-framework/generator-sdk';
+export { GENERATED_BANNER_MARKER, sha256Hex };
+/** The `DO NOT EDIT` banner every generated file starts with. */
+export declare function banner(): string;
+/**
+ * The banner a business seed carries. It says the file is *not* owned by the generator
+ * and is never overwritten, because that sentence is the whole point of the tier.
+ */
+export declare function businessBanner(): string;
+/** Join sections with single blank lines, dropping empty ones. */
+export declare function sections(...parts: readonly string[]): string;
+/** A line fragment that may be omitted; a blank string is a real blank line. */
+export type LinePart = string | readonly string[] | false | undefined;
+/** Flatten line fragments, dropping only the omitted ones so blank lines survive. */
+export declare function lines(...parts: readonly LinePart[]): string[];
+/** A complete generated module body: banner, then sections, then one newline. */
+export declare function moduleText(...parts: readonly string[]): string;
+/** A complete business seed body. */
+export declare function seedText(...parts: readonly string[]): string;
+/**
+ * A multi-line string as the TS literal whose value is exactly that string.
+ *
+ * No re-indentation: template contents are emitted verbatim, because the value is the
+ * prompt text a model is shown and adding indentation to each line would change it.
+ */
+export declare function templateLiteral(value: string): string;
+/** Render a JSON object as TypeScript source with sorted keys. */
+export declare function jsonLiteral(value: unknown): string;
+/**
+ * The column budget. Emitted code is formatted the way the repository formatter would
+ * format it, because the example keeps its generated tree inside `biome ci` rather than
+ * excluding it: `py-fastapi` keeps its emitted tree `ruff format --check` clean, and an
+ * exemption here would be the weaker promise.
+ */
+export declare const LINE_WIDTH = 100;
+export declare function fits(indent: string, text: string): boolean;
+export type Entry = readonly [string, string];
+/** An object literal: inline when it fits, otherwise one entry per line. */
+export declare function objectLiteral(entries: readonly Entry[], indent: string): string;
+/** An array literal: inline when it fits, otherwise one item per line. */
+export declare function arrayLiteral(items: readonly string[], indent: string): string;
+/** A named object argument spread over lines when the call would not fit. */
+export declare function callOf(callee: string, entries: readonly Entry[], indent: string): string;
+/**
+ * The order the import organiser uses: natural (so `x2` sorts before `x10`),
+ * case-insensitive, with an uppercase-first tie-break on the first character whose case
+ * differs, and shorter-first when one name is a prefix of the other. That is why
+ * `RetrievalMetricSpec` sorts before `retrievalMetrics`, `ALIASES` before `aB`, and
+ * `Pipeline` before `PipelineError`. The `type` modifier is not part of the key.
+ */
+export declare function compareNames(a: string, b: string): number;
+/** A list of names sorted the way the import organisers sort them. */
+export declare function sortedNames(names: Iterable<string>): string[];
+export interface ImportName {
+    readonly name: string;
+    readonly type: boolean;
+}
+/**
+ * One import statement. Type-only members carry the inline `type` modifier, which is
+ * what the formatter wants when a statement mixes values and types; a statement that is
+ * entirely types is written `import type`.
+ */
+export declare function importStatement(from: string, names: readonly ImportName[]): string;
+/** An `export { a, b as c } from '...'` statement, expanded when it would not fit. */
+export declare function exportStatement(from: string, names: readonly Entry[]): string;
+/** An `export { a, b }` statement for names declared in the same module. */
+export declare function localExportStatement(names: readonly string[]): string;
+/**
+ * Order a group of import or export statements by their specifier, the way the
+ * import organiser does. Statements in one group have to be emitted in this order
+ * rather than in the order the IR happens to list them.
+ */
+export declare function sortStatements(statements: readonly {
+    readonly from: string;
+    readonly text: string;
+}[]): string[];
+/** Render a literal value as formatted TypeScript source, expanding what would not fit. */
+export declare function tsValue(value: unknown, indent: string): string;
+//# sourceMappingURL=text.d.ts.map

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

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

package/dist/emit/text.js

@@ -0,0 +1,242 @@
+/**
+ * Byte-level helpers every emitter goes through.
+ *
+ * A generated file is the banner, then the body, then exactly one trailing newline and
+ * no tabs. `normalizeText` from the SDK enforces the newline half so the determinism
+ * check and the emitters agree by construction rather than by convention.
+ */
+import { GENERATED_BANNER_MARKER, generatedBanner, normalizeText, sha256Hex, } from '@aid-framework/generator-sdk';
+import { GENERATOR_NAME, GENERATOR_VERSION } from '../manifest.js';
+import { propertyKey, stringLiteral } from '../names.js';
+export { GENERATED_BANNER_MARKER, sha256Hex };
+/** The `DO NOT EDIT` banner every generated file starts with. */
+export function banner() {
+    return generatedBanner({ generator: GENERATOR_NAME, version: GENERATOR_VERSION, comment: '//' });
+}
+/**
+ * The banner a business seed carries. It says the file is *not* owned by the generator
+ * and is never overwritten, because that sentence is the whole point of the tier.
+ */
+export function businessBanner() {
+    return [
+        `// Created once by AID Framework "${GENERATOR_NAME}" v${GENERATOR_VERSION}. Edit freely.`,
+        '// This file is yours: the generator seeds it on first run and never overwrites it.',
+    ].join('\n');
+}
+/**
+ * Drop leading and trailing newlines.
+ *
+ * A scan, not a regex: `/^\n+/` is linear but `/\n+$/` is unanchored on the left, so a
+ * body carrying many newlines makes it retry "one-or-more, then end of input" at every
+ * position. CodeQL reads spec-derived strings as untrusted input and was right to flag
+ * that shape (`js/polynomial-redos`); this is linear in the part's length.
+ */
+function trimBlankEdges(part) {
+    let start = 0;
+    while (start < part.length && part[start] === '\n')
+        start += 1;
+    let end = part.length;
+    while (end > start && part[end - 1] === '\n')
+        end -= 1;
+    return part.slice(start, end);
+}
+/** Join sections with single blank lines, dropping empty ones. */
+export function sections(...parts) {
+    return parts
+        .map(trimBlankEdges)
+        .filter((part) => part.length > 0)
+        .join('\n\n');
+}
+/** Flatten line fragments, dropping only the omitted ones so blank lines survive. */
+export function lines(...parts) {
+    const collected = [];
+    for (const part of parts) {
+        if (part === false || part === undefined)
+            continue;
+        if (typeof part === 'string')
+            collected.push(part);
+        else
+            collected.push(...part);
+    }
+    return collected;
+}
+/** A complete generated module body: banner, then sections, then one newline. */
+export function moduleText(...parts) {
+    return normalizeText(`${banner()}\n\n${sections(...parts)}`);
+}
+/** A complete business seed body. */
+export function seedText(...parts) {
+    return normalizeText(`${businessBanner()}\n\n${sections(...parts)}`);
+}
+/**
+ * A multi-line string as the TS literal whose value is exactly that string.
+ *
+ * No re-indentation: template contents are emitted verbatim, because the value is the
+ * prompt text a model is shown and adding indentation to each line would change it.
+ */
+export function templateLiteral(value) {
+    const escaped = value.replace(/\\/g, '\\\\').replace(/`/g, '\\`').replace(/\$\{/g, '\\${');
+    return `\`${escaped}\``;
+}
+/** Render a JSON object as TypeScript source with sorted keys. */
+export function jsonLiteral(value) {
+    const text = JSON.stringify(value, null, 2);
+    return text ?? 'null';
+}
+/**
+ * The column budget. Emitted code is formatted the way the repository formatter would
+ * format it, because the example keeps its generated tree inside `biome ci` rather than
+ * excluding it: `py-fastapi` keeps its emitted tree `ruff format --check` clean, and an
+ * exemption here would be the weaker promise.
+ */
+export const LINE_WIDTH = 100;
+export function fits(indent, text) {
+    return indent.length + text.length <= LINE_WIDTH;
+}
+/** An object literal: inline when it fits, otherwise one entry per line. */
+export function objectLiteral(entries, indent) {
+    if (entries.length === 0)
+        return '{}';
+    const inline = `{ ${entries.map(([key, value]) => `${key}: ${value}`).join(', ')} }`;
+    if (fits(indent, inline))
+        return inline;
+    const lines = entries.map(([key, value]) => `${indent}  ${key}: ${value},`);
+    return ['{', ...lines, `${indent}}`].join('\n');
+}
+/** An array literal: inline when it fits, otherwise one item per line. */
+export function arrayLiteral(items, indent) {
+    if (items.length === 0)
+        return '[]';
+    const inline = `[${items.join(', ')}]`;
+    // An array of two or more objects is always one item per line, even when the inline
+    // form fits: `biome` expands it that way, measured on both a top-level array of two
+    // inline objects and the same array as a property of a multi-line object, and keeps a
+    // one-element array inline. Emitting the inline form there is a `biome ci` failure in
+    // the consumer's project rather than a matter of taste.
+    const expandedObjects = items.length > 1 && items.every((item) => item.startsWith('{'));
+    if (!expandedObjects && fits(indent, inline))
+        return inline;
+    return ['[', ...items.map((item) => `${indent}  ${item},`), `${indent}]`].join('\n');
+}
+/** A named object argument spread over lines when the call would not fit. */
+export function callOf(callee, entries, indent) {
+    const argument = objectLiteral(entries, `${indent}  `);
+    return `${callee}(${argument})`;
+}
+function isDigit(character) {
+    return character >= '0' && character <= '9';
+}
+/**
+ * The order the import organiser uses: natural (so `x2` sorts before `x10`),
+ * case-insensitive, with an uppercase-first tie-break on the first character whose case
+ * differs, and shorter-first when one name is a prefix of the other. That is why
+ * `RetrievalMetricSpec` sorts before `retrievalMetrics`, `ALIASES` before `aB`, and
+ * `Pipeline` before `PipelineError`. The `type` modifier is not part of the key.
+ */
+export function compareNames(a, b) {
+    let left = 0;
+    let right = 0;
+    while (left < a.length && right < b.length) {
+        const leftChar = a[left];
+        const rightChar = b[right];
+        if (isDigit(leftChar) && isDigit(rightChar)) {
+            let leftEnd = left;
+            while (leftEnd < a.length && isDigit(a[leftEnd]))
+                leftEnd += 1;
+            let rightEnd = right;
+            while (rightEnd < b.length && isDigit(b[rightEnd]))
+                rightEnd += 1;
+            const leftNumber = Number(a.slice(left, leftEnd));
+            const rightNumber = Number(b.slice(right, rightEnd));
+            if (leftNumber !== rightNumber)
+                return leftNumber < rightNumber ? -1 : 1;
+            left = leftEnd;
+            right = rightEnd;
+            continue;
+        }
+        const leftLower = leftChar.toLowerCase();
+        const rightLower = rightChar.toLowerCase();
+        if (leftLower !== rightLower)
+            return leftLower < rightLower ? -1 : 1;
+        if (leftChar !== rightChar)
+            return leftChar < rightChar ? -1 : 1;
+        left += 1;
+        right += 1;
+    }
+    const leftRest = a.length - left;
+    const rightRest = b.length - right;
+    if (leftRest !== rightRest)
+        return leftRest < rightRest ? -1 : 1;
+    return 0;
+}
+/** A list of names sorted the way the import organisers sort them. */
+export function sortedNames(names) {
+    return [...names].sort(compareNames);
+}
+/**
+ * One import statement. Type-only members carry the inline `type` modifier, which is
+ * what the formatter wants when a statement mixes values and types; a statement that is
+ * entirely types is written `import type`.
+ */
+export function importStatement(from, names) {
+    const sorted = [...names].sort((a, b) => compareNames(a.name, b.name));
+    if (sorted.every((entry) => entry.type)) {
+        return `import type { ${sorted.map((entry) => entry.name).join(', ')} } from ${stringLiteral(from)};`;
+    }
+    const members = sorted.map((entry) => (entry.type ? `type ${entry.name}` : entry.name));
+    const inline = `import { ${members.join(', ')} } from ${stringLiteral(from)};`;
+    if (fits('', inline))
+        return inline;
+    return [
+        'import {',
+        ...members.map((member) => `  ${member},`),
+        `} from ${stringLiteral(from)};`,
+    ].join('\n');
+}
+/** An `export { a, b as c } from '...'` statement, expanded when it would not fit. */
+export function exportStatement(from, names) {
+    const sorted = [...names].sort((a, b) => compareNames(a[0], b[0]));
+    const members = sorted.map(([local, exported]) => local === exported ? local : `${local} as ${exported}`);
+    const inline = `export { ${members.join(', ')} } from ${stringLiteral(from)};`;
+    if (fits('', inline))
+        return inline;
+    return [
+        'export {',
+        ...members.map((member) => `  ${member},`),
+        `} from ${stringLiteral(from)};`,
+    ].join('\n');
+}
+/** An `export { a, b }` statement for names declared in the same module. */
+export function localExportStatement(names) {
+    return `export { ${sortedNames(names).join(', ')} };`;
+}
+/**
+ * Order a group of import or export statements by their specifier, the way the
+ * import organiser does. Statements in one group have to be emitted in this order
+ * rather than in the order the IR happens to list them.
+ */
+export function sortStatements(statements) {
+    return [...statements]
+        .sort((a, b) => compareNames(a.from, b.from))
+        .map((statement) => statement.text);
+}
+/** Render a literal value as formatted TypeScript source, expanding what would not fit. */
+export function tsValue(value, indent) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string')
+        return stringLiteral(value);
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? String(value) : 'null';
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    if (Array.isArray(value)) {
+        return arrayLiteral(value.map((item) => tsValue(item, `${indent}  `)), indent);
+    }
+    if (typeof value === 'object') {
+        const entries = Object.entries(value).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+        return objectLiteral(entries.map(([key, item]) => [propertyKey(key), tsValue(item, `${indent}  `)]), indent);
+    }
+    return 'null';
+}
+//# sourceMappingURL=text.js.map

package/dist/emit/text.js.map

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

package/dist/emit/tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `generated/contracts/*` and `generated/tools/*`.
+ *
+ * A tool has two halves: the contract (what an implementation must accept and return)
+ * and the adapter (the `Tool` the executor and the model see). Splitting them is what
+ * lets `business/tools/<name>.ts` be hand-written against the contract without the
+ * generator ever needing to read it back.
+ */
+import type { IR, ToolShape } from '@aid-framework/ir';
+import { type EmittedFile } from './file.js';
+export declare function emitContractsIndex(ir: IR): EmittedFile;
+export declare function emitContractModule(ir: IR, tool: ToolShape): EmittedFile;
+export declare function emitToolAdapter(ir: IR, tool: ToolShape): EmittedFile;
+export declare function emitToolsIndex(ir: IR): EmittedFile;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/emit/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAsB,MAAM,mBAAmB,CAAC;AAE3E,OAAO,EAAE,KAAK,WAAW,EAAuD,MAAM,WAAW,CAAC;AAyBlG,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,EAAE,GAAG,WAAW,CAetD;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,CAgDvE;AA+BD,wBAAgB,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,CAoDpE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,EAAE,GAAG,WAAW,CAsElD"}

package/dist/emit/tools.js

@@ -0,0 +1,225 @@
+/**
+ * `generated/contracts/*` and `generated/tools/*`.
+ *
+ * A tool has two halves: the contract (what an implementation must accept and return)
+ * and the adapter (the `Tool` the executor and the model see). Splitting them is what
+ * lets `business/tools/<name>.ts` be hand-written against the contract without the
+ * generator ever needing to read it back.
+ */
+import { className, literal, memberAccess, propertyKey, toSnakeCase } from '../names.js';
+import { generated, paths, toolAdapterPath, toolContractPath } from './file.js';
+import { fits, importStatement, lines, moduleText, sortStatements } from './text.js';
+/** The TypeScript type a `TypeRef` denotes, in a signature position. */
+function refType(ref) {
+    if (ref.kind === 'named')
+        return className(ref.name);
+    switch (ref.name) {
+        case 'string':
+            return 'string';
+        case 'number':
+        case 'integer':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        default:
+            return 'unknown';
+    }
+}
+function typeIndex(ir) {
+    const map = new Map();
+    for (const shape of ir.types)
+        map.set(shape.id, shape);
+    return map;
+}
+export function emitContractsIndex(ir) {
+    void ir;
+    const body = [
+        '/** What a tool implementation is called with, beside the request itself. */',
+        'export interface ToolContext {',
+        '  readonly name: string;',
+        '  readonly arguments: Readonly<Record<string, unknown>>;',
+        '}',
+        '',
+        '/** Build the context a business tool receives. */',
+        'export function toolContext(name: string, args: Readonly<Record<string, unknown>>): ToolContext {',
+        '  return { name, arguments: args };',
+        '}',
+    ].join('\n');
+    return generated(paths.contractsIndex, moduleText(body));
+}
+export function emitContractModule(ir, tool) {
+    const index = typeIndex(ir);
+    const input = refType(tool.input);
+    const output = refType(tool.output);
+    const handler = `${className(tool.id)}Handler`;
+    const typeImports = [];
+    if (tool.input.kind === 'named' && index.has(tool.input.name))
+        typeImports.push(className(tool.input.name));
+    if (tool.output.kind === 'named' &&
+        index.has(tool.output.name) &&
+        tool.output.name !== (tool.input.kind === 'named' ? tool.input.name : undefined)) {
+        typeImports.push(className(tool.output.name));
+    }
+    const header = typeImports.length === 0
+        ? importStatement('./index.js', [{ name: 'ToolContext', type: true }])
+        : sortStatements([
+            {
+                from: '../schemas.js',
+                text: importStatement('../schemas.js', typeImports.map((name) => ({ name, type: true }))),
+            },
+            {
+                from: './index.js',
+                text: importStatement('./index.js', [{ name: 'ToolContext', type: true }]),
+            },
+        ]).join('\n');
+    const signature = `export type ${handler} = (context: ToolContext, request: ${input}) => Promise<${output}>;`;
+    const body = [
+        `/** What \`${tool.id}\` must implement. */`,
+        ...(fits('', signature)
+            ? [signature]
+            : [
+                `export type ${handler} = (`,
+                '  context: ToolContext,',
+                `  request: ${input},`,
+                `) => Promise<${output}>;`,
+            ]),
+    ].join('\n');
+    return generated(toolContractPath(tool.id), moduleText(header, body));
+}
+/** The flat JSON-Schema the runtime's tool validator enforces. */
+function parametersFor(ir, tool) {
+    const index = typeIndex(ir);
+    const properties = [];
+    const required = [];
+    if (tool.input.kind === 'named') {
+        const shape = index.get(tool.input.name);
+        if (shape !== undefined) {
+            for (const field of shape.fields) {
+                const type = field.type.kind === 'primitive' && field.type.name === 'integer' ? 'integer' : 'string';
+                properties.push(`    ${propertyKey(field.name)}: { type: ${literal(type)} },`);
+                if (field.required)
+                    required.push(field.name);
+            }
+        }
+    }
+    const schema = [
+        'const PARAMETERS: ToolParameters = {',
+        "  type: 'object',",
+        '  additionalProperties: false,',
+        '  properties: {',
+        ...properties,
+        '  },',
+        `  required: [${required.map((name) => literal(name)).join(', ')}],`,
+        '};',
+    ].join('\n');
+    return { schema, required };
+}
+export function emitToolAdapter(ir, tool) {
+    const index = typeIndex(ir);
+    const handler = `${className(tool.id)}Handler`;
+    const factory = `as${className(tool.id)}`;
+    const inputType = refType(tool.input);
+    const inputSchema = tool.input.kind === 'named' && index.has(tool.input.name)
+        ? className(tool.input.name)
+        : undefined;
+    const { schema } = parametersFor(ir, tool);
+    const constant = `${toSnakeCase(tool.id).toUpperCase()}_NAME`;
+    const header = lines(importStatement('@aid-framework/runtime', [
+        { name: 'Tool', type: false },
+        { name: 'ToolParameters', type: true },
+    ]), importStatement('../contracts/index.js', [{ name: 'toolContext', type: false }]), importStatement(`../contracts/${tool.id}.js`, [{ name: handler, type: true }]), inputSchema !== undefined &&
+        importStatement('../schemas.js', [{ name: inputSchema, type: false }])).join('\n');
+    const body = [
+        `const ${constant} = ${literal(tool.id)};`,
+        `const DESCRIPTION = ${literal(tool.description)};`,
+        '',
+        schema,
+        '',
+        '/**',
+        ` * Bind a \`${tool.id}\` implementation to the tool the executor and the model see.`,
+        ' * The request is validated against its schema before the implementation runs, so a',
+        ' * malformed tool call is a typed error rather than a downstream surprise.',
+        ' */',
+        `export function ${factory}(implementation: ${handler}): Tool {`,
+        '  return Tool.of({',
+        `    name: ${constant},`,
+        '    description: DESCRIPTION,',
+        '    parameters: PARAMETERS,',
+        '    handler: async (args) => {',
+        inputSchema === undefined
+            ? `      return await implementation(toolContext(${constant}, args), args as ${inputType});`
+            : [
+                `      const request = ${inputSchema}.parse(args);`,
+                `      return await implementation(toolContext(${constant}, args), request);`,
+            ].join('\n'),
+        '    },',
+        '  });',
+        '}',
+    ].join('\n');
+    return generated(toolAdapterPath(tool.id), moduleText(header, body));
+}
+export function emitToolsIndex(ir) {
+    const tools = ir.tools;
+    const toolImports = tools.flatMap((tool) => [
+        { specifier: `../contracts/${tool.id}.js`, name: `${className(tool.id)}Handler`, type: true },
+        { specifier: `./${tool.id}.js`, name: `as${className(tool.id)}`, type: false },
+    ]);
+    const header = [
+        importStatement('@aid-framework/runtime', [
+            { name: 'ConfigurationError', type: false },
+            { name: 'Tool', type: true },
+            { name: 'ToolExecutor', type: false },
+        ]),
+        ...sortStatements([
+            ...toolImports.map((entry) => ({
+                from: entry.specifier,
+                text: importStatement(entry.specifier, [{ name: entry.name, type: entry.type }]),
+            })),
+            {
+                from: '../../business/tools/index.js',
+                text: importStatement('../../business/tools/index.js', [
+                    { name: 'IMPLEMENTATIONS', type: false },
+                ]),
+            },
+        ]),
+    ].join('\n');
+    const optionLines = tools.map((tool) => `  readonly ${propertyKey(tool.id)}?: ${className(tool.id)}Handler;`);
+    const args = tools.map((tool) => {
+        const local = `${className(tool.id)}Implementation`;
+        const handler = `${className(tool.id)}Handler`;
+        const assignment = `  const ${local} = options${memberAccess(tool.id)} ?? (IMPLEMENTATIONS${memberAccess(tool.id)} as ${handler} | undefined);`;
+        const broken = [
+            `  const ${local} =`,
+            `    options${memberAccess(tool.id)} ??`,
+            `    (IMPLEMENTATIONS${memberAccess(tool.id)} as ${handler} | undefined);`,
+        ].join('\n');
+        return [
+            fits('', assignment) ? assignment : broken,
+            `  if (${local} === undefined) {`,
+            `    throw new ConfigurationError(${literal(`no implementation is registered for ${tool.id}`)});`,
+            '  }',
+            `  adapters.push(as${className(tool.id)}(${local}));`,
+        ].join('\n');
+    });
+    const body = [
+        '/** The implementations a caller may override; the business tier supplies the rest. */',
+        'export interface BuildExecutorOptions {',
+        ...optionLines,
+        '}',
+        '',
+        '/** Build the adapters with every IR tool bound to an implementation. */',
+        'export function buildTools(options: BuildExecutorOptions = {}): Tool[] {',
+        '  const adapters: Tool[] = [];',
+        ...args,
+        '  return adapters;',
+        '}',
+        '',
+        '/** Build the executor over those adapters. */',
+        'export function buildExecutor(options: BuildExecutorOptions = {}): ToolExecutor {',
+        '  return new ToolExecutor(buildTools(options));',
+        '}',
+    ].join('\n');
+    const fullHeader = header;
+    return generated(paths.toolsIndex, moduleText(fullHeader, body));
+}
+//# sourceMappingURL=tools.js.map

package/dist/emit/tools.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The error a caller sees when the IR cannot be emitted for this target.
+ *
+ * Planning refuses rather than emitting a half-wired tree: a generated app that boots
+ * but silently drops a step is worse than one that never got written.
+ */
+import type { PlanProblem } from './validate.js';
+export declare class TsVercelPlanError extends Error {
+    readonly problems: readonly PlanProblem[];
+    constructor(problems: readonly PlanProblem[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAE1C,YAAY,QAAQ,EAAE,SAAS,WAAW,EAAE,EAO3C;CACF"}

package/dist/errors.js

@@ -0,0 +1,16 @@
+/**
+ * The error a caller sees when the IR cannot be emitted for this target.
+ *
+ * Planning refuses rather than emitting a half-wired tree: a generated app that boots
+ * but silently drops a step is worse than one that never got written.
+ */
+export class TsVercelPlanError extends Error {
+    problems;
+    constructor(problems) {
+        const lines = problems.map((problem) => `  - ${problem.code} at ${problem.path}: ${problem.message}`);
+        super(`cannot emit ts-vercel from this IR:\n${lines.join('\n')}`);
+        this.name = 'TsVercelPlanError';
+        this.problems = [...problems];
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,QAAQ,CAAyB;IAE1C,YAAY,QAAgC;QAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CACxB,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAC1E,CAAC;QACF,KAAK,CAAC,wCAAwC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAChC,CAAC;CACF"}