@aid-framework/runtime 0.0.0 → 0.1.39

package/dist/retrieval/types.js

@@ -0,0 +1,388 @@
+/**
+ * Shapes the retrieval runtime shares across its modules.
+ *
+ * Two families live here and the split is deliberate.
+ *
+ * * The **IR mirror** models (`SourceSpec`, `ChunkingSpec`, `IndexSpec`,
+ *   `RerankSpec`, `RefreshSpec`, `RetrieverSpec`, `EmbeddingSpec`,
+ *   `VectorStoreSpec`) reproduce the L1 IR's `retrievers` / `embeddings` /
+ *   `stores` entries field for field. The IR spells these in camelCase
+ *   (`keepMetadata`, `embedModel`, `topK`, `inputPerMTok`, ...) and so does this
+ *   file, because in TypeScript the IR's own spelling *is* the natural one: there
+ *   is no second vocabulary to translate from. Enum values are the IR's own
+ *   strings (`recursive`, `pgvector`, `cosine`) and are never re-spelled.
+ * * The **resolved** models (`PinnedEmbedding`, `RetrieverBinding`) are what
+ *   generated code binds with literals. They carry the exact embedding model id
+ *   rather than an alias, so a run is reproducible from the generated source
+ *   alone and nothing is resolved at run time.
+ */
+import { ConfigurationError, FeatureDeferredError } from '../errors.js';
+import { repr, sha256Parts } from '../internal/json.js';
+import { CostProfile } from '../types.js';
+export const DISTANCE_METRICS = ['cosine', 'dot', 'l2'];
+function requireNonEmpty(value, label) {
+    if (value.length === 0) {
+        throw new ConfigurationError(`${label} must not be empty`);
+    }
+    return value;
+}
+function requirePositiveInt(value, label) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new ConfigurationError(`${label} must be a positive integer`);
+    }
+    return value;
+}
+function requireNonNegativeInt(value, label) {
+    if (!Number.isInteger(value) || value < 0) {
+        throw new ConfigurationError(`${label} must be a non-negative integer`);
+    }
+    return value;
+}
+/** `retriever.source`. */
+export class SourceSpec {
+    kind;
+    uri;
+    glob;
+    constructor(init) {
+        this.kind = init.kind;
+        this.uri = init.uri;
+        this.glob = init.glob ?? null;
+    }
+}
+/** `retriever.chunking`. */
+export class ChunkingSpec {
+    strategy;
+    size;
+    overlap;
+    keepMetadata;
+    constructor(init) {
+        this.strategy = init.strategy;
+        this.size = requirePositiveInt(init.size, 'chunking size');
+        this.overlap = requireNonNegativeInt(init.overlap, 'chunking overlap');
+        this.keepMetadata = [...(init.keepMetadata ?? [])];
+    }
+}
+/** `retriever.index`. */
+export class IndexSpec {
+    metric;
+    hybrid;
+    params;
+    constructor(init) {
+        this.metric = init.metric;
+        this.hybrid = init.hybrid;
+        this.params = init.params ?? null;
+    }
+}
+/** `retriever.rerank`. */
+export class RerankSpec {
+    model;
+    topN;
+    constructor(init) {
+        this.model = init.model;
+        this.topN = requirePositiveInt(init.topN, 'rerank topN');
+    }
+}
+/** `retriever.refresh`. */
+export class RefreshSpec {
+    mode;
+    schedule;
+    constructor(init) {
+        this.mode = init.mode;
+        this.schedule = init.schedule ?? null;
+    }
+}
+/** One entry of the IR's `retrievers` map. */
+export class RetrieverSpec {
+    id;
+    source;
+    chunking;
+    embedModel;
+    store;
+    index;
+    topK;
+    rerank;
+    filters;
+    refresh;
+    traits;
+    constructor(init) {
+        this.id = requireNonEmpty(init.id, 'retriever id');
+        this.source = init.source;
+        this.chunking = init.chunking;
+        this.embedModel = init.embedModel;
+        this.store = init.store;
+        this.index = init.index;
+        this.topK = requirePositiveInt(init.topK, 'retriever topK');
+        this.rerank = init.rerank ?? null;
+        this.filters = init.filters === undefined || init.filters === null ? null : [...init.filters];
+        this.refresh = init.refresh;
+        this.traits = [...(init.traits ?? [])];
+    }
+}
+/**
+ * `embedding.costProfile` -- USD per **million** tokens.
+ *
+ * Not interchangeable with {@link CostProfile}, which prices per *thousand*
+ * tokens because it predates the IR. {@link pinnedEmbedding} is the single place
+ * the two are converted, so the factor of 1000 is stated once rather than assumed
+ * at every call site.
+ */
+export class EmbeddingCostProfile {
+    inputPerMTok;
+    outputPerMTok;
+    constructor(init) {
+        for (const [label, value] of [
+            ['inputPerMTok', init.inputPerMTok],
+            ['outputPerMTok', init.outputPerMTok],
+        ]) {
+            if (!Number.isFinite(value) || value < 0) {
+                throw new ConfigurationError(`${label} must be a non-negative number`);
+            }
+        }
+        this.inputPerMTok = init.inputPerMTok;
+        this.outputPerMTok = init.outputPerMTok;
+    }
+}
+/**
+ * One entry of the IR's `embeddings` map.
+ *
+ * `id` is the *alias* a retriever's `embedModel` names -- the resolution the
+ * runtime must never repeat at run time.
+ */
+export class EmbeddingSpec {
+    id;
+    provider;
+    modelId;
+    dimensions;
+    costProfile;
+    traits;
+    constructor(init) {
+        this.id = requireNonEmpty(init.id, 'embedding id');
+        this.provider = init.provider;
+        this.modelId = init.modelId;
+        this.dimensions = init.dimensions === undefined ? null : init.dimensions;
+        if (this.dimensions !== null) {
+            requirePositiveInt(this.dimensions, 'embedding dimensions');
+        }
+        this.costProfile = init.costProfile ?? null;
+        this.traits = [...(init.traits ?? [])];
+    }
+}
+/** One entry of the IR's `stores` map. */
+export class VectorStoreSpec {
+    id;
+    kind;
+    uri;
+    dimensions;
+    traits;
+    constructor(init) {
+        this.id = requireNonEmpty(init.id, 'store id');
+        this.kind = init.kind;
+        this.uri = init.uri ?? null;
+        this.dimensions = init.dimensions === undefined ? null : init.dimensions;
+        if (this.dimensions !== null) {
+            requirePositiveInt(this.dimensions, 'store dimensions');
+        }
+        this.traits = [...(init.traits ?? [])];
+    }
+}
+/** The IR's `retrieval` metric variant: `{kind, expectDocs, k}`. */
+export class RetrievalMetricSpec {
+    kind;
+    expectDocs;
+    k;
+    constructor(init) {
+        this.kind = 'retrieval';
+        this.expectDocs = [...init.expectDocs];
+        this.k = requirePositiveInt(init.k, 'retrieval metric k');
+    }
+}
+/**
+ * An `embedModel` alias already resolved to an exact embedding model.
+ *
+ * The same contract as `PinnedModel`: a baseline recorded against
+ * `text-embedding-3-small` means nothing if the alias floats to another
+ * revision, so the resolved id, the dimensions and the price are all *recorded
+ * inputs* rather than lookups a run performs.
+ */
+export class PinnedEmbedding {
+    alias;
+    provider;
+    modelId;
+    dimensions;
+    cost;
+    constructor(init) {
+        this.alias = requireNonEmpty(init.alias, 'embedding alias');
+        this.provider = requireNonEmpty(init.provider, 'embedding provider');
+        this.modelId = requireNonEmpty(init.modelId, 'embedding modelId');
+        this.dimensions = requirePositiveInt(init.dimensions, 'embedding dimensions');
+        this.cost = init.cost;
+    }
+}
+/**
+ * A retriever as generated code binds it, with every alias resolved.
+ *
+ * `embedModel` keeps the declared alias purely so cost can be attributed to the
+ * name the spec used; `embedding` is the resolved model actually called.
+ * `storeKind` is resolved from the store entry, because a run must not discover
+ * at search time which backend it wrote to.
+ *
+ * `storeUri` is deliberately kept *unresolved*: a hosted store's location is a
+ * deployment secret, which is why the IR writes `env:PGVECTOR_URL` rather than a
+ * DSN. The name is pinned in code; the value is read from the environment at run
+ * time, and an environment variable is not an alias.
+ */
+export class RetrieverBinding {
+    retrieverId;
+    source;
+    chunking;
+    embedModel;
+    embedding;
+    store;
+    storeKind;
+    storeUri;
+    index;
+    topK;
+    rerank;
+    refreshMode;
+    traits;
+    constructor(init) {
+        this.retrieverId = requireNonEmpty(init.retrieverId, 'retrieverId');
+        this.source = init.source;
+        this.chunking = init.chunking;
+        this.embedModel = requireNonEmpty(init.embedModel, 'embedModel');
+        this.embedding = init.embedding;
+        this.store = requireNonEmpty(init.store, 'store');
+        this.storeKind = init.storeKind;
+        this.storeUri = init.storeUri ?? null;
+        this.index = init.index;
+        this.topK = requirePositiveInt(init.topK, 'retriever topK');
+        this.rerank = init.rerank ?? null;
+        this.refreshMode = init.refreshMode ?? 'full';
+        this.traits = [...(init.traits ?? [])];
+    }
+}
+/**
+ * One indexed passage.
+ *
+ * `chunkId` hashes the document id, the chunk's position *and* its text. That is
+ * what makes ingest idempotent: identical input re-chunks to identical ids, so a
+ * second ingest replaces rather than duplicates. Position is part of the hash on
+ * purpose -- two byte-identical paragraphs in one document must stay two chunks
+ * instead of colliding into one.
+ */
+export class Chunk {
+    chunkId;
+    docId;
+    uri;
+    index;
+    start;
+    end;
+    text;
+    metadata;
+    constructor(init) {
+        this.chunkId = requireNonEmpty(init.chunkId, 'chunkId');
+        this.docId = requireNonEmpty(init.docId, 'docId');
+        this.uri = init.uri ?? '';
+        this.index = requireNonNegativeInt(init.index, 'chunk index');
+        this.start = requireNonNegativeInt(init.start, 'chunk start');
+        this.end = requireNonNegativeInt(init.end, 'chunk end');
+        this.text = init.text;
+        this.metadata = { ...(init.metadata ?? {}) };
+    }
+}
+/** A chunk with the score that ranked it. */
+export class ScoredChunk {
+    chunk;
+    score;
+    constructor(init) {
+        this.chunk = init.chunk;
+        this.score = init.score;
+    }
+}
+/**
+ * The content hash that identifies a chunk.
+ *
+ * Shared by every chunker so the id scheme cannot differ between strategies; a
+ * strategy that changed the id scheme would silently duplicate a corpus on
+ * re-ingest instead of replacing it.
+ */
+export function chunkIdFor(docId, index, text) {
+    return `sha256:${sha256Parts([docId, String(index), text])}`;
+}
+/**
+ * Resolve an IR embedding entry into the pinned form generated code carries.
+ *
+ * `dimensions` may be supplied when the IR entry omits it (the schema makes it
+ * optional); it is an error to have neither, because an unpinned width would let a
+ * store accept vectors a later run cannot compare against.
+ */
+export function pinnedEmbedding(spec, init) {
+    const width = init.dimensions ?? spec.dimensions;
+    if (width === null || width === undefined) {
+        throw new ConfigurationError(`embedding ${repr(spec.id)} pins no dimensions and none were supplied; the vector ` +
+            'width must be recorded with the pinned model so stores stay comparable');
+    }
+    const profile = spec.costProfile;
+    // costProfile quotes USD per MTok; CostProfile quotes USD per 1k tokens.
+    const scale = 1000.0;
+    return new PinnedEmbedding({
+        alias: init.alias,
+        provider: spec.provider,
+        modelId: spec.modelId,
+        dimensions: width,
+        cost: new CostProfile({
+            inputPer1kUsd: profile === null ? 0.0 : profile.inputPerMTok / scale,
+            outputPer1kUsd: profile === null ? 0.0 : profile.outputPerMTok / scale,
+        }),
+    });
+}
+/**
+ * Bind one IR retriever entry to the embedding and store it names.
+ *
+ * `embedModel` names an *embeddings entry id*, not a provider model, and `store`
+ * names a *stores entry id*. Both are checked here rather than trusted, because a
+ * mistyped reference in generated code would otherwise surface as an empty or
+ * mis-scored corpus far from its cause.
+ */
+export function bindingFromSpec(spec, init) {
+    const { embedding, store } = init;
+    if (spec.embedModel !== embedding.id) {
+        throw new ConfigurationError(`retriever ${repr(spec.id)} names embedModel ${repr(spec.embedModel)} but embedding ` +
+            `${repr(embedding.id)} was supplied`);
+    }
+    if (spec.store !== store.id) {
+        throw new ConfigurationError(`retriever ${repr(spec.id)} names store ${repr(spec.store)} but store ` +
+            `${repr(store.id)} was supplied`);
+    }
+    if (spec.filters !== null && spec.filters.length > 0) {
+        // The spec validator already refuses filters; the runtime checks too, because
+        // generated code is reachable without the validator having run.
+        throw new FeatureDeferredError(`retriever ${repr(spec.id)} declares filters, which spec v0.1 does not implement: a ` +
+            "filter would have to be pushed into every store adapter's query");
+    }
+    const pinned = pinnedEmbedding(embedding, {
+        alias: spec.embedModel,
+        dimensions: init.dimensions ?? null,
+    });
+    if (store.dimensions !== null && store.dimensions !== pinned.dimensions) {
+        throw new ConfigurationError(`store ${repr(store.id)} is declared ${store.dimensions}-dimensional but retriever ` +
+            `${repr(spec.id)} pins ${pinned.dimensions} dimensions via embedModel ` +
+            `${repr(spec.embedModel)}; the two must agree before anything is indexed`);
+    }
+    return new RetrieverBinding({
+        retrieverId: spec.id,
+        source: spec.source,
+        chunking: spec.chunking,
+        embedModel: spec.embedModel,
+        embedding: pinned,
+        store: spec.store,
+        storeKind: store.kind,
+        storeUri: store.uri,
+        index: spec.index,
+        topK: spec.topK,
+        rerank: spec.rerank,
+        refreshMode: spec.refresh.mode,
+        traits: spec.traits,
+    });
+}
+//# sourceMappingURL=types.js.map

package/dist/retrieval/types.js.map

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

package/dist/steps.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Leaf pipeline steps: `generate`, `retrieve`, `tool` and `emit`.
+ *
+ * `pipeline.ts` runs steps and `control.ts` composes them; this module is the third
+ * part of the family and builds the leaves a pipeline actually reaches the outside
+ * world with. Each factory returns an ordinary {@link CompositeStep}, so a leaf
+ * composes with a composite by the same rule.
+ *
+ * Why these exist at all: a generated application inlines its steps as hand-written
+ * async functions, which leaves a caller who is *not* the generator -- a test, a
+ * conformance runner, a hand-built pipeline -- with no way to drive one step kind
+ * without re-writing the primitive's call and its binding rule. That duplication is
+ * where the two disagree. A step here is the same primitive the generator calls:
+ *
+ * - `retrieve` calls {@link RetrieverSeam.retrieve} and binds the `RetrievalResult`.
+ * - `tool` calls {@link ToolExecutor.execute} and binds what the tool returned,
+ *   refusing an error outcome and parsing the content.
+ * - `generate` renders a prompt, calls {@link ModelGateway.generate}, and runs the
+ *   structured path when the caller names an output type.
+ * - `emit` projects the context into the event fields a caller names.
+ *
+ * Every factory takes its inputs **already resolved**: the query string, the argument
+ * mapping, the prompt values. Interpolating a spec template against the context is the
+ * *emitted step body's* job, and a second implementation of it here would be a second
+ * thing to keep in step with the generator's. What is not duplicated is the part that
+ * is the same for every caller: the primitive call, the error contract, the parse, and
+ * the name the result is bound under.
+ *
+ * `emit` is the one leaf whose whole behaviour is reading the context, so
+ * {@link resolveSource} lives here rather than in a caller: a field's source is a
+ * binding name, optionally followed by one attribute, which is exactly the reference
+ * path the generator derives for the same field.
+ */
+import type { CompositeStep } from './control.js';
+import type { ModelGateway } from './gateway.js';
+import type { PipelineContext } from './pipeline.js';
+import type { PromptRegistry } from './prompts.js';
+import type { RetrievalResult } from './retrieval/citations.js';
+import type { StructuredOutput } from './structured.js';
+import type { ToolExecutor } from './tools.js';
+/**
+ * The context key an `emit` step binds its projected payload under.
+ *
+ * Deliberately *not* in `RESERVED_KEYS`. That set is mirrored in the generator and
+ * pinned against the runtime by a generator test, so a seventh entry would have to be
+ * emitted as well -- and the generated applications do not compose their response
+ * through this step yet. A generated route keeps building its event object itself;
+ * adding the key here would reserve a spec name for a step the emitted apps never
+ * call. {@link emitStep} takes the key as an option so the generator can adopt it
+ * under its own name when it does.
+ */
+export declare const EMITTED_KEY = "emitted";
+/**
+ * One `emit` field's value: a binding, then at most one attribute below it.
+ *
+ * The one-segment form is the request event's or a scalar binding's whole value; the
+ * two-segment form is a struct's field. Deeper paths are not accepted, because the
+ * spec layer's reference paths stop at one field and this resolver exists to read
+ * exactly what the generator reads.
+ *
+ * A missing binding is a {@link PipelineError} naming the key -- the same refusal
+ * {@link PipelineContext.require} makes -- and a missing attribute is one naming both
+ * the source and the field, because "the field is not there" and "the binding is not
+ * there" are different mistakes and both mean the response would be wrong.
+ */
+export declare function resolveSource(context: PipelineContext, source: string): unknown;
+/**
+ * Build the event payload from the context, field by field.
+ *
+ * `fields` maps each event field to its source, in the order the caller declared
+ * them: an insertion-ordered mapping keeps the payload's own order stable, so a
+ * projection that reorders its fields is observable rather than invisible. Each source
+ * is a binding name or a `binding.attribute` path, which is the shape the generator
+ * derives for the same field via `responsePlan`.
+ *
+ * The step **binds** its payload and does not stop the pipeline. Stopping would lose
+ * it: both runtimes carry the *pre-step* context out of a stop, so a stopping step
+ * cannot bind anything. A generated route does not stop at its emit either -- it runs
+ * every step and only then builds the response object -- so a later step still runs
+ * after this one, which is the behaviour a pipeline that composed it would see.
+ */
+export declare function emitStep(fields: Readonly<Record<string, string>>, options?: {
+    readonly key?: string;
+    readonly name?: string;
+}): CompositeStep;
+/**
+ * The one method a `retrieve` step needs.
+ *
+ * `Retriever` satisfies it, which is what a generated application passes. Stated as a
+ * seam rather than as the concrete class so a caller that does not own a retriever -- a
+ * test, a conformance runner -- can drive the step without building an embedding model
+ * and a vector store it will never search. The step duplicates no part of the search:
+ * it decides the query, the ceiling and the name, and binding the result is all it adds.
+ */
+export interface RetrieverSeam {
+    retrieve(query: string, options?: {
+        readonly topK?: number | null;
+    }): Promise<RetrievalResult>;
+}
+/**
+ * Search `retriever` and bind the cited passages under `binding`.
+ *
+ * `topK` is passed through rather than resolved here, so `undefined` keeps meaning
+ * "the binding's own ceiling" exactly as `Retriever.retrieve` defines it.
+ */
+export declare function retrieveStep(retriever: RetrieverSeam, options: {
+    readonly binding: string;
+    readonly query: string;
+    readonly topK?: number;
+    readonly name?: string;
+}): CompositeStep;
+/**
+ * Call `tool` and bind what it returned, refusing an error outcome.
+ *
+ * The call id is the binding name, which makes a trace of a tool step name the value
+ * it produced. An error outcome throws rather than binding a message: a tool the model
+ * called and that failed is not a value the next step can meaningfully read, and the
+ * generator's own step throws for the same reason.
+ *
+ * `output` is the struct to parse the content into when the spec declared a named
+ * output; without one the content is bound as parsed JSON, so a tool declaring
+ * `string` binds the string it returned rather than a re-encoded copy.
+ */
+export declare function toolStep(tools: ToolExecutor, options: {
+    readonly binding: string;
+    readonly tool: string;
+    readonly arguments: Readonly<Record<string, unknown>>;
+    readonly output?: StructuredOutput<unknown>;
+    readonly name?: string;
+}): CompositeStep;
+/**
+ * Render `prompt`, ask `model` for one completion, and bind the answer.
+ *
+ * The call is built once and handed to the structured path as its `call`, so a repair
+ * round re-sends an already-rendered prompt instead of rendering again -- the same
+ * closure the generated step emits, and the reason a retry cannot silently re-read a
+ * binding that changed underneath it.
+ *
+ * `values` are the prompt's own values and are passed to the registry unrendered:
+ * {@link PromptRegistry.render} is the one place a template becomes text. With
+ * `structured` the answer is parsed into that type, and a parse failure throws after
+ * the repair rounds rather than binding a half-valid object.
+ */
+export declare function generateStep(gateway: ModelGateway, prompts: PromptRegistry, options: {
+    readonly binding: string;
+    readonly prompt: string;
+    readonly model: string;
+    readonly values?: Readonly<Record<string, unknown>>;
+    readonly version?: string;
+    readonly structured?: StructuredOutput<unknown>;
+    readonly temperature?: number;
+    readonly maxOutputTokens?: number;
+    readonly fallbacks?: readonly string[];
+    readonly name?: string;
+}): CompositeStep;
+//# sourceMappingURL=steps.d.ts.map

package/dist/steps.d.ts.map

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