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

package/dist/emit/infrastructure.js

@@ -0,0 +1,238 @@
+/**
+ * `generated/gateway/models.ts`, `generated/gateway/index.ts`, `generated/deps.ts` and
+ * `generated/observability.ts`.
+ *
+ * The gateway is the seam every generated app is testable through: `deps.ts` resolves a
+ * singleton that a test (or the example's fake gateway) replaces wholesale, and the
+ * model table is plain data so a cost or capability change is a one-line diff.
+ */
+import { literal, modelCapabilities, propertyKey, providerAdapter, stringLiteral, } from '../names.js';
+import { hasAgents } from './agents.js';
+import { generated, paths } from './file.js';
+import { importStatement, lines, localExportStatement, moduleText, objectLiteral, tsValue, } from './text.js';
+const RUNTIME = '@aid-framework/runtime';
+function costExpression(model) {
+    const profile = model.costProfile;
+    const input = profile === undefined ? 0 : profile.inputPerMTok / 1000;
+    const output = profile === undefined ? 0 : profile.outputPerMTok / 1000;
+    return `new CostProfile({ inputPer1kUsd: ${literal(input)}, outputPer1kUsd: ${literal(output)} })`;
+}
+function modelExpression(model) {
+    const { advertised } = modelCapabilities(model.capabilities);
+    const capabilities = advertised.length === 0
+        ? '[]'
+        : `[${advertised.map((capability) => stringLiteral(capability)).join(', ')}] as const`;
+    const fields = [
+        ['name', stringLiteral(model.modelId)],
+        ['provider', stringLiteral(model.provider)],
+        ['cost', costExpression(model)],
+        ['contextWindow', literal(model.limits.contextTokens)],
+        ['maxOutputTokens', literal(model.limits.maxOutputTokens ?? model.params.maxTokens ?? 1024)],
+        ['capabilities', capabilities],
+    ];
+    return `new ModelSpec(${objectLiteral(fields, '  ')})`;
+}
+export function emitGatewayModels(ir) {
+    const aliases = ir.models
+        .map((model) => `  ${propertyKey(model.id)}: ${modelExpression(model)},`)
+        .join('\n');
+    const fallbacks = ir.models
+        .filter((model) => model.fallbacks.length > 0)
+        .map((model) => `  ${propertyKey(model.id)}: [${model.fallbacks.map(stringLiteral).join(', ')}],`)
+        .join('\n');
+    const providers = ir.models
+        .filter((model) => providerAdapter(model.provider) !== undefined)
+        .map((model) => {
+        const adapter = providerAdapter(model.provider);
+        if (adapter === 'FakeProvider')
+            return `    fake: new FakeProvider(),`;
+        const apiKey = model.apiKeyEnv;
+        if (apiKey === undefined) {
+            return `    ${propertyKey(model.provider)}: new OpenAICompatibleProvider({ name: ${stringLiteral(model.provider)} }),`;
+        }
+        return `    ${propertyKey(model.provider)}: keyedProvider(${stringLiteral(model.provider)}, ${stringLiteral(apiKey)}),`;
+    });
+    const header = importStatement(RUNTIME, [
+        { name: 'CostProfile', type: false },
+        { name: 'FakeProvider', type: false },
+        { name: 'ModelSpec', type: false },
+        { name: 'OpenAICompatibleProvider', type: false },
+        { name: 'Provider', type: true },
+    ]);
+    const needsKeyed = providers.some((line) => line.includes('keyedProvider('));
+    const body = [
+        ...(needsKeyed
+            ? [
+                '/**',
+                ' * An adapter whose credential comes from the environment variable the spec named.',
+                ' * The option is omitted rather than set to `undefined` when the variable is unset,',
+                ' * so the provider fails at call time with its own message instead of at import time.',
+                ' */',
+                'function keyedProvider(name: string, apiKeyEnv: string): OpenAICompatibleProvider {',
+                '  const apiKey = process.env[apiKeyEnv];',
+                '  return new OpenAICompatibleProvider(apiKey === undefined ? { name } : { name, apiKey });',
+                '}',
+                '',
+            ]
+            : []),
+        '/** Every model alias the IR declares, resolved to a runtime model specification. */',
+        'export const ALIASES: Readonly<Record<string, ModelSpec>> = {',
+        aliases,
+        '};',
+        '',
+        'export const FALLBACKS: Readonly<Record<string, readonly string[]>> = {',
+        fallbacks.length === 0 ? '};' : `${fallbacks}\n};`,
+        '',
+        '/**',
+        ' * The provider adapters a generated app talks to by default. Each one reads its',
+        ' * credential from the environment variable the spec named, never from a literal.',
+        ' */',
+        'export function defaultProviders(): Readonly<Record<string, Provider>> {',
+        '  return {',
+        ...dedupe(providers),
+        '  };',
+        '}',
+    ]
+        .filter((line) => line.length > 0)
+        .join('\n');
+    return generated(paths.gatewayModels, moduleText(header, body));
+}
+function dedupe(lines) {
+    const seen = new Set();
+    const result = [];
+    for (const line of lines) {
+        if (seen.has(line))
+            continue;
+        seen.add(line);
+        result.push(line);
+    }
+    return result;
+}
+export function emitGatewayIndex(ir) {
+    void ir;
+    const header = [
+        importStatement(RUNTIME, [
+            { name: 'ModelGateway', type: false },
+            { name: 'Provider', type: true },
+        ]),
+        importStatement('./models.js', [
+            { name: 'ALIASES', type: false },
+            { name: 'FALLBACKS', type: false },
+            { name: 'defaultProviders', type: false },
+        ]),
+    ].join('\n');
+    const body = [
+        localExportStatement(['ALIASES', 'FALLBACKS', 'defaultProviders']),
+        '',
+        'export interface BuildGatewayOptions {',
+        '  readonly providers?: Readonly<Record<string, Provider>>;',
+        '}',
+        '',
+        '/** Build the gateway every generated call goes through. */',
+        'export function buildGateway(options: BuildGatewayOptions = {}): ModelGateway {',
+        '  return new ModelGateway({',
+        '    providers: options.providers ?? defaultProviders(),',
+        '    aliases: ALIASES,',
+        '  });',
+        '}',
+    ].join('\n');
+    return generated(paths.gatewayIndex, moduleText(header, body));
+}
+export function emitDeps(ir) {
+    const hasRetrieval = ir.retrievers.length > 0;
+    const withAgents = hasAgents(ir);
+    const runtimeImports = [
+        { name: 'ConfigurationError', type: false },
+        { name: 'ModelGateway', type: true },
+        { name: 'PromptRegistry', type: true },
+        { name: 'Retriever', type: true },
+        // The agent loop takes `Tool` objects, not the executor, so when this app declares an
+        // agent the executor is built *from* the list rather than beside it: one adapter set
+        // with two views, so an agent and a `tool` step cannot execute different objects.
+        { name: 'ToolExecutor', type: !withAgents },
+    ];
+    if (withAgents)
+        runtimeImports.push({ name: 'Tool', type: true });
+    const header = [
+        importStatement(RUNTIME, runtimeImports),
+        importStatement('./gateway/index.js', [{ name: 'buildGateway', type: false }]),
+        importStatement('./prompts/index.js', [{ name: 'buildPrompts', type: false }]),
+    ];
+    if (hasRetrieval) {
+        header.push(importStatement('./retrieval/index.js', [{ name: 'buildRetrievers', type: false }]));
+    }
+    header.push(importStatement('./tools/index.js', [
+        withAgents ? { name: 'buildTools', type: false } : { name: 'buildExecutor', type: false },
+    ]));
+    const body = lines('export interface BuildDepsOptions {', '  readonly gateway?: ModelGateway;', '  readonly prompts?: PromptRegistry;', '  readonly tools?: ToolExecutor;', withAgents && '  /** The same adapters `tools` wraps; the agent loop needs them by value. */', withAgents && '  readonly toolList?: readonly Tool[];', hasRetrieval && '  readonly retrievers?: ReadonlyMap<string, Retriever>;', '}', '', '/**', ' * The wiring a generated pipeline needs. Everything a test wants to replace is a', ' * constructor argument, so no module-level singleton has to be monkey-patched.', ' */', 'export class Deps {', '  readonly gateway: ModelGateway;', '  readonly prompts: PromptRegistry;', '  readonly tools: ToolExecutor;', withAgents && '  readonly toolList: readonly Tool[];', hasRetrieval && '  private readonly _retrievers: ReadonlyMap<string, Retriever>;', '', '  constructor(init: Required<BuildDepsOptions>) {', '    this.gateway = init.gateway;', '    this.prompts = init.prompts;', '    this.tools = init.tools;', withAgents && '    this.toolList = init.toolList;', hasRetrieval && '    this._retrievers = init.retrievers;', '  }', hasRetrieval && [
+        '',
+        '  /** One bound retriever, or a configuration error naming the missing id. */',
+        '  retriever(id: string): Retriever {',
+        '    const found = this._retrievers.get(id);',
+        '    if (found === undefined) {',
+        // biome-ignore lint/suspicious/noTemplateCurlyInString: this is emitted source, not interpolation
+        '      throw new ConfigurationError(`no retriever ${JSON.stringify(id)} is bound`);',
+        '    }',
+        '    return found;',
+        '  }',
+    ], '}', '', 'let singleton: Deps | undefined;', '', '/** Build a fresh `Deps`; every seam defaults to the generated wiring. */', 'export function buildDeps(options: BuildDepsOptions = {}): Deps {', withAgents && '  const toolList = options.toolList ?? buildTools();', '  return new Deps({', '    gateway: options.gateway ?? buildGateway(),', '    prompts: options.prompts ?? buildPrompts(),', withAgents
+        ? '    tools: options.tools ?? new ToolExecutor(toolList),'
+        : '    tools: options.tools ?? buildExecutor(),', withAgents && '    toolList,', hasRetrieval && '    retrievers: options.retrievers ?? buildRetrievers(),', '  });', '}', '', '/** The process-wide wiring, built once. */', 'export function getDeps(): Deps {', '  singleton ??= buildDeps();', '  return singleton;', '}', '', '/**', ' * Replace the process-wide wiring, or clear it with `undefined` so the next', ' * `getDeps()` rebuilds from the environment. This is the seam a host or a test uses', ' * to run a generated pipeline against a fake provider; nothing in production calls it.', ' */', 'export function setDeps(deps: Deps | undefined): void {', '  singleton = deps;', '}')
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n');
+    return generated(paths.deps, moduleText(header.join('\n'), body));
+}
+export function emitObservability(ir) {
+    const declared = ir.models
+        .map((model) => model)
+        .flatMap((model) => model.capabilities)
+        .filter((capability, index, all) => all.indexOf(capability) === index);
+    const modelWired = {};
+    const unrepresentable = {};
+    for (const model of ir.models) {
+        const { advertised, dropped } = modelCapabilities(model.capabilities);
+        modelWired[model.id] = [...advertised];
+        if (dropped.length > 0)
+            unrepresentable[model.id] = dropped;
+    }
+    const payload = {
+        capabilities: {
+            declared: [...declared].sort(),
+            modelWired,
+            targetWired: [...TARGET_WIRED],
+            unwired: [...declared].filter((capability) => !wireable(capability)),
+        },
+        emitsAgainst: { structuredOutput: 'zod', tracing: 'otel-genai' },
+        generator: '@aid-framework/generator-ts-vercel',
+        irVersion: ir.irVersion,
+        models: { advertised: modelWired, unrepresentable },
+        observability: { redact: [...ir.observability.redact], trace: ir.observability.trace },
+        target: 'ts-vercel',
+    };
+    const body = [
+        '/**',
+        ' * What this app was generated from and which capabilities it actually wires. A',
+        ' * capability listed under `unwired` is one no emitter binds: it is reported rather',
+        ' * than silently dropped.',
+        ' */',
+        'export function generatedCapabilities(): Record<string, unknown> {',
+        `  return ${tsValue(payload, '  ')};`,
+        '}',
+    ].join('\n');
+    return generated(paths.observability, moduleText(body));
+}
+const TARGET_WIRED = [
+    'http-trigger',
+    'json-schema',
+    'tool-calling',
+    'otel',
+    'embeddings',
+    'rerank',
+    'guardrails',
+    'agents',
+    'cursor-memory',
+];
+function wireable(capability) {
+    return TARGET_WIRED.includes(capability);
+}
+//# sourceMappingURL=infrastructure.js.map

package/dist/emit/infrastructure.js.map

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

package/dist/emit/pipelines.d.ts

@@ -0,0 +1,46 @@
+/**
+ * `generated/pipelines/*` and `generated/routes/*`.
+ *
+ * A pipeline is plain sequential async code, because that is what Phase 1 emits: no
+ * graph engine, no scheduler. Each step is a named `Step` that returns a new
+ * `PipelineContext`, so the step names survive into tracing and the values each step
+ * binds are readable in a diff.
+ *
+ * A route is deliberately *not* a Next.js module. It is a small
+ * `(request) => { status, body }` function, and the example's hand-written
+ * `app/api/<path>/route.ts` is the adapter that turns it into what Next serves. That
+ * split is forced by the ownership model: a path under `app/api` has no owner, so
+ * emitting it would break `validatePlan` and the next `aid gen`. See the README.
+ */
+import type { IR, PipelineShape, TypeField } from '@aid-framework/ir';
+import { type EmittedFile } from './file.js';
+/**
+ * Turn an IR interpolation template into a TypeScript template literal.
+ *
+ * `{{ event.subject }}` becomes `${event.subject}`. The two forms use different
+ * delimiters on purpose: the IR's spelling is language-neutral, and rewriting it at
+ * emit time is the whole job of the target.
+ *
+ * `resolve` decides what a reference becomes. A prompt's template names its *variables*,
+ * which `generateStepModule` binds as object-literal keys, so the default is a bare
+ * identifier. A guard step's, a rerank step's and an agent step's template name pipeline
+ * *bindings* instead, and those are read back through `context.require` -- see
+ * `contextTemplate`.
+ */
+export declare function templateToTs(template: string, resolve?: (path: readonly string[]) => string): string;
+/**
+ * The same rendering for a template that names pipeline bindings.
+ *
+ * `{{ handbook }}` becomes `${context.require('handbook')}`, matching what
+ * `valueExpression` does for a `reference` StepInputValue. `event` stays a bare local
+ * because it is the one binding every emitted step receives as an argument.
+ */
+export declare function contextTemplate(template: string, types?: ReadonlyMap<string, string>): string;
+/** The first binding a template names, which is how a `retrieval` guard finds its input. */
+export declare function firstReference(template: string): string | undefined;
+export declare function emitPipelineModule(ir: IR, pipeline: PipelineShape): EmittedFile;
+export declare function emitPipelinesIndex(ir: IR): EmittedFile;
+export declare function emitRouteModule(ir: IR, pipeline: PipelineShape): EmittedFile;
+export declare function emitRoutesIndex(ir: IR): EmittedFile;
+export type { TypeField };
+//# sourceMappingURL=pipelines.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipelines.d.ts","sourceRoot":"","sources":["../../src/emit/pipelines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAKV,EAAE,EAGF,aAAa,EAOb,SAAS,EACV,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAE,KAAK,WAAW,EAA6C,MAAM,WAAW,CAAC;AAiDxF;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAkD,GACvF,MAAM,CAwBR;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAM7F;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUnE;AAqxBD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,aAAa,GAAG,WAAW,CA2F/E;AA4CD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,EAAE,GAAG,WAAW,CAOtD;AAkDD,wBAAgB,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,aAAa,GAAG,WAAW,CA8F5E;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,EAAE,GAAG,WAAW,CAQnD;AAED,YAAY,EAAE,SAAS,EAAE,CAAC"}