@adminiumjs/llm 0.1.0-rc.1

package/dist/prompt/chunker.js

@@ -0,0 +1,383 @@
+/**
+ * `chunker.ts` — token-budget map-phase chunking for huge schemas
+ * (06-llm-assist.md §4.5, acceptance criterion 7).
+ *
+ * When the assembled prompt for a whole schema would exceed the per-prompt token
+ * budget, the schema is split **by domain**: a connected-component clustering
+ * over the FK graph (declared + inferred relations + column FK mirrors) keeps
+ * related tables together, clusters are greedily packed into chunks of
+ * ≤ `chunkTokenBudget` estimated tokens, and any single cluster too large for one
+ * chunk is split by table row-count descending as a last resort.
+ *
+ * Each chunk is SELF-CONTAINED: it carries its own tables in full plus **stub
+ * entries** for every out-of-chunk FK target its tables reference, so
+ * cross-chunk relations stay inferable and every prompt validates on its own.
+ * The map phase produces one prompt per chunk; `response/merge.ts` performs the
+ * deterministic reduce.
+ *
+ * Determinism (a hard requirement — the diff UI and golden tests depend on it):
+ * every ordering here is content-derived (cluster weight, table id, row count),
+ * never insertion order or `Math.random`/`Date.now`. The same model + stats
+ * always chunk identically.
+ *
+ * Browser-safe: `parseDatabaseModel` is pure Zod (no DB driver), and only
+ * pure-TS engine TYPES are imported. This never creates an engine→llm edge.
+ */
+import { parseDatabaseModel } from '@adminium/engine';
+import { buildPrompt, normalizeSections } from './builder.js';
+import { qualifyTableRef, serializeSamplingPayload, serializeSchemaIr, serializeStats, } from './serializer.js';
+import { estimateTokens } from './token-estimate.js';
+/** Per-chunk token ceiling (§4.5: "chunks of ≤ 45,000 tokens"). */
+export const DEFAULT_CHUNK_TOKEN_BUDGET = 45_000;
+/**
+ * Slack subtracted from the per-chunk table capacity to absorb the small
+ * discrepancy between summed per-fragment token estimates (each `ceil`-ed
+ * independently) and the single `ceil` over the assembled prompt. Purely a
+ * safety cushion — the built prompt always lands under budget.
+ */
+const SAFETY_TOKENS = 512;
+/**
+ * Fraction of a split cluster's per-chunk table capacity reserved for stub
+ * entries. Stubs are column-NAME lists only (no types/flags/stats), empirically
+ * a tiny fraction of a full table's serialized size, so 20 % is very
+ * conservative and guarantees a split chunk stays under budget once its stubs
+ * are added. Whole-cluster packing needs no reserve: clusters are FK-connected
+ * components, so packing distinct clusters together never creates a cross-chunk
+ * FK (and thus no stubs).
+ */
+const SPLIT_STUB_RESERVE_RATIO = 0.2;
+// ─── FK-connectivity clustering (§4.5 "split by domain") ─────────────────────
+function ensureSet(map, id) {
+    let set = map.get(id);
+    if (set === undefined) {
+        set = new Set();
+        map.set(id, set);
+    }
+    return set;
+}
+/**
+ * Partition the model's tables into FK-connected components. The graph is
+ * undirected over declared + inferred relations (both endpoints, and the join
+ * table for m2m) and column FK mirrors. Tables touched by no relation are
+ * singleton components. Each component is returned id-sorted, and the outer list
+ * is sorted by smallest member id — fully deterministic.
+ */
+export function clusterTables(model) {
+    const adjacency = new Map();
+    for (const table of model.tables)
+        ensureSet(adjacency, table.id);
+    const link = (a, b) => {
+        if (a === b)
+            return;
+        ensureSet(adjacency, a).add(b);
+        ensureSet(adjacency, b).add(a);
+    };
+    for (const relation of model.relations) {
+        link(relation.from.tableId, relation.to.tableId);
+        if (relation.through !== null) {
+            link(relation.from.tableId, relation.through.tableId);
+            link(relation.to.tableId, relation.through.tableId);
+        }
+    }
+    for (const table of model.tables) {
+        for (const column of table.columns) {
+            if (column.references !== null)
+                link(table.id, column.references.tableId);
+        }
+    }
+    const seen = new Set();
+    const clusters = [];
+    for (const table of model.tables) {
+        if (seen.has(table.id))
+            continue;
+        const component = [table.id];
+        seen.add(table.id);
+        const stack = [table.id];
+        while (stack.length > 0) {
+            const current = stack.pop();
+            if (current === undefined)
+                break;
+            for (const neighbor of adjacency.get(current) ?? new Set()) {
+                if (seen.has(neighbor))
+                    continue;
+                seen.add(neighbor);
+                component.push(neighbor);
+                stack.push(neighbor);
+            }
+        }
+        component.sort((a, b) => a.localeCompare(b));
+        clusters.push(component);
+    }
+    clusters.sort((a, b) => (a[0] ?? '').localeCompare(b[0] ?? ''));
+    return clusters;
+}
+// ─── Per-table weights + fixed overhead ──────────────────────────────────────
+/**
+ * Estimated token contribution of each full table to a prompt: its serialized
+ * schema-IR entry + any enum-column entries + declared relations it owns + its
+ * statistics entry + (opt-in) its sampling entry. Measured off the real
+ * serializers so it tracks the actual prompt bytes; a couple of tokens per
+ * fragment cover the surrounding commas.
+ */
+export function computeTableWeights(input) {
+    const model = input.schemaIr;
+    const stats = input.stats;
+    const weights = new Map();
+    const bump = (id, tokens) => {
+        weights.set(id, (weights.get(id) ?? 0) + tokens);
+    };
+    const ir = serializeSchemaIr(model, { stats });
+    for (const table of ir.tables)
+        bump(table.table, estimateTokens(JSON.stringify(table)) + 2);
+    for (const enumColumn of ir.enumColumns)
+        bump(enumColumn.table, estimateTokens(JSON.stringify(enumColumn)) + 1);
+    for (const relation of ir.declaredRelations) {
+        bump(relation.fromTable, estimateTokens(JSON.stringify(relation)) + 1);
+    }
+    const statsBlock = serializeStats(stats, { defaultSchema: model.defaultSchema });
+    for (const table of statsBlock.tables)
+        bump(table.table, estimateTokens(JSON.stringify(table)) + 1);
+    if (input.sampling !== null) {
+        const sampling = serializeSamplingPayload(model, stats, input.sampling.maxValuesPerColumn);
+        for (const table of sampling.tables)
+            bump(table.table, estimateTokens(JSON.stringify(table)) + 1);
+    }
+    for (const table of model.tables)
+        if (!weights.has(table.id))
+            bump(table.id, 0);
+    return weights;
+}
+/** Estimated token cost of rendering a table as a names-only stub (§4.5). */
+export function computeStubWeights(model) {
+    const weights = new Map();
+    for (const table of model.tables) {
+        const stub = { table: table.id, stub: true, columns: table.columns.map((column) => column.name) };
+        weights.set(table.id, estimateTokens(JSON.stringify(stub)) + 1);
+    }
+    return weights;
+}
+/**
+ * The fixed per-chunk overhead (system section + full instruction template +
+ * allow-lists + locales + the chunk-info sentence + the empty structural JSON
+ * wrappers), measured by rendering a prompt for a table-less model. Every chunk
+ * repeats this cost regardless of how many tables it carries.
+ */
+export function computeOverheadTokens(input, options) {
+    const model = input.schemaIr;
+    const emptyModel = parseDatabaseModel({
+        dialect: model.dialect,
+        name: model.name,
+        defaultSchema: model.defaultSchema,
+        schemas: model.schemas,
+        tables: [],
+    });
+    const overhead = buildPrompt({ ...input, schemaIr: emptyModel, stats: [], chunk: { index: 1, total: 2, stubTables: [] } }, options);
+    return overhead.tokenEstimate;
+}
+// ─── Stub computation ────────────────────────────────────────────────────────
+/**
+ * The out-of-chunk FK targets a chunk's full tables reference: the `to` (and
+ * join `through`) tables of every relation the chunk owns (relation `from` side
+ * is in the chunk), plus every column FK-mirror target — restricted to tables
+ * not in the chunk. These become the chunk's stub entries so no rendered
+ * relation or `references` points at a missing table.
+ */
+export function computeStubsForChunk(model, fullTables) {
+    const stubs = new Set();
+    for (const relation of model.relations) {
+        if (!fullTables.has(relation.from.tableId))
+            continue;
+        if (!fullTables.has(relation.to.tableId))
+            stubs.add(relation.to.tableId);
+        if (relation.through !== null && !fullTables.has(relation.through.tableId)) {
+            stubs.add(relation.through.tableId);
+        }
+    }
+    for (const table of model.tables) {
+        if (!fullTables.has(table.id))
+            continue;
+        for (const column of table.columns) {
+            if (column.references !== null && !fullTables.has(column.references.tableId)) {
+                stubs.add(column.references.tableId);
+            }
+        }
+    }
+    return stubs;
+}
+// ─── Planning: cluster → chunk partition (§4.5) ──────────────────────────────
+/**
+ * Partition a schema into map-phase chunks. FFD-packs whole FK clusters into
+ * chunks of ≤ `chunkTokenBudget`; any cluster too big for one chunk is split by
+ * table row-count descending. Every chunk records the out-of-chunk FK targets it
+ * must stub. Deterministic for a given (model, stats, options).
+ */
+export function planSchemaChunks(input, options) {
+    const model = input.schemaIr;
+    const budget = options.chunkTokenBudget ?? DEFAULT_CHUNK_TOKEN_BUDGET;
+    const overhead = computeOverheadTokens(input, options);
+    const tableCapacity = budget - overhead - SAFETY_TOKENS;
+    if (tableCapacity <= 0) {
+        throw new Error(`chunker: token budget ${budget} too small for the fixed prompt overhead ${overhead} (06-llm-assist.md §4.5).`);
+    }
+    const splitCapacity = Math.max(1, Math.floor(tableCapacity * (1 - SPLIT_STUB_RESERVE_RATIO)));
+    const tableWeight = computeTableWeights(input);
+    const weightOf = (id) => tableWeight.get(id) ?? 0;
+    const clusterWeight = (cluster) => cluster.reduce((sum, id) => sum + weightOf(id), 0);
+    const modelOrder = new Map(model.tables.map((table, index) => [table.id, index]));
+    const orderOf = (id) => modelOrder.get(id) ?? Number.MAX_SAFE_INTEGER;
+    const rowCount = rowCountLookup(model, input.stats);
+    const clusters = clusterTables(model);
+    const normal = [];
+    const oversized = [];
+    for (const cluster of clusters) {
+        if (clusterWeight(cluster) <= tableCapacity)
+            normal.push(cluster);
+        else
+            oversized.push(cluster);
+    }
+    // First-fit-decreasing over whole clusters (no cross-chunk FKs possible).
+    normal.sort((a, b) => clusterWeight(b) - clusterWeight(a) || (a[0] ?? '').localeCompare(b[0] ?? ''));
+    const ffdBins = [];
+    const ffdLoads = [];
+    for (const cluster of normal) {
+        const weight = clusterWeight(cluster);
+        let placed = false;
+        for (let i = 0; i < ffdBins.length; i += 1) {
+            if ((ffdLoads[i] ?? 0) + weight <= tableCapacity) {
+                ffdBins[i]?.push(...cluster);
+                ffdLoads[i] = (ffdLoads[i] ?? 0) + weight;
+                placed = true;
+                break;
+            }
+        }
+        if (!placed) {
+            ffdBins.push([...cluster]);
+            ffdLoads.push(weight);
+        }
+    }
+    // Split each oversized cluster by row-count descending (last resort, §4.5).
+    const splitBins = [];
+    oversized.sort((a, b) => (a[0] ?? '').localeCompare(b[0] ?? ''));
+    for (const cluster of oversized) {
+        const ordered = [...cluster].sort((a, b) => rowCount(b) - rowCount(a) || a.localeCompare(b));
+        let current = [];
+        let load = 0;
+        for (const id of ordered) {
+            const weight = weightOf(id);
+            if (current.length > 0 && load + weight > splitCapacity) {
+                splitBins.push(current);
+                current = [];
+                load = 0;
+            }
+            current.push(id);
+            load += weight;
+        }
+        if (current.length > 0)
+            splitBins.push(current);
+    }
+    const bins = [...ffdBins, ...splitBins];
+    const total = bins.length;
+    return bins.map((bin, index) => {
+        const fullSet = new Set(bin);
+        const stubs = computeStubsForChunk(model, fullSet);
+        return {
+            index: index + 1,
+            total,
+            tableIds: [...bin].sort((a, b) => orderOf(a) - orderOf(b)),
+            stubTables: [...stubs].sort((a, b) => a.localeCompare(b)),
+        };
+    });
+}
+function rowCountLookup(model, stats) {
+    const counts = new Map();
+    for (const table of model.tables) {
+        if (table.rowCountEstimate !== null)
+            counts.set(table.id, table.rowCountEstimate);
+    }
+    for (const result of stats) {
+        if (result.rowCountEstimate !== null) {
+            counts.set(qualifyTableRef(result.table, model.defaultSchema), result.rowCountEstimate);
+        }
+    }
+    return (id) => counts.get(id) ?? 0;
+}
+// ─── Building the map-phase prompts ──────────────────────────────────────────
+/**
+ * Build a self-contained sub-model for one chunk: its full tables plus its stub
+ * tables (rendered names-only by the serializer via the chunk's `stubTables`
+ * set), with enums narrowed to those the full tables reference and relations
+ * narrowed to those the chunk owns (`from` in the chunk, `to`/`through` present
+ * as full or stub).
+ */
+export function subModelForChunk(model, fullTables, stubTables) {
+    const keptTables = model.tables.filter((table) => fullTables.has(table.id) || stubTables.has(table.id));
+    const referencedEnums = new Set();
+    for (const table of model.tables) {
+        if (!fullTables.has(table.id))
+            continue;
+        for (const column of table.columns) {
+            if (column.enumRef !== null)
+                referencedEnums.add(column.enumRef);
+        }
+    }
+    const keptEnums = model.enums.filter((def) => referencedEnums.has(def.id));
+    const present = (id) => fullTables.has(id) || stubTables.has(id);
+    const keptRelations = model.relations.filter((relation) => fullTables.has(relation.from.tableId) &&
+        present(relation.to.tableId) &&
+        (relation.through === null || present(relation.through.tableId)));
+    return { ...model, tables: keptTables, enums: keptEnums, relations: keptRelations };
+}
+function statsForChunk(stats, fullTables, defaultSchema) {
+    return stats.filter((result) => fullTables.has(qualifyTableRef(result.table, defaultSchema)));
+}
+/**
+ * Build the map-phase prompt(s) for a schema. Split ONLY when the assembled user
+ * section exceeds the per-prompt `tokenBudget` (default 60,000 — §4.5); a schema
+ * that fits in one prompt is returned unchunked (no stubs, no chunk-info
+ * sentence) even when it is larger than the 45,000-token per-chunk packing
+ * ceiling. When it does not fit, it is chunked per {@link planSchemaChunks}, each
+ * chunk a self-contained prompt with correct FK stubs and each within
+ * `chunkTokenBudget`.
+ */
+export function buildChunkedPrompts(input, options) {
+    const model = input.schemaIr;
+    const sections = normalizeSections(input.sections);
+    // Split decision: the 60k tokenBudget (§4.5), NOT the 45k per-chunk ceiling.
+    // `buildPrompt.overBudget` measures the assembled user section against
+    // `options.tokenBudget` (default DEFAULT_TOKEN_BUDGET = 60k) — exactly the
+    // "assembled user section exceeds budget" test §4.5 specifies.
+    const whole = buildPrompt(input, options);
+    if (!whole.overBudget) {
+        return {
+            chunked: false,
+            chunks: whole.chunks,
+            plan: [
+                {
+                    index: 1,
+                    total: 1,
+                    tableIds: model.tables.map((table) => table.id),
+                    stubTables: [],
+                },
+            ],
+            sections,
+        };
+    }
+    const plan = planSchemaChunks(input, options);
+    const chunks = plan.map((chunk) => {
+        const fullSet = new Set(chunk.tableIds);
+        const stubSet = new Set(chunk.stubTables);
+        const artifact = buildPrompt({
+            ...input,
+            schemaIr: subModelForChunk(model, fullSet, stubSet),
+            stats: statsForChunk(input.stats, fullSet, model.defaultSchema),
+            chunk: { index: chunk.index, total: chunk.total, stubTables: chunk.stubTables },
+        }, options);
+        const built = artifact.chunks[0];
+        if (built === undefined) {
+            throw new Error('chunker: buildPrompt produced no chunk artifact.');
+        }
+        return built;
+    });
+    return { chunked: true, chunks, plan, sections };
+}
+//# sourceMappingURL=chunker.js.map

package/dist/prompt/chunker.js.map

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

package/dist/prompt/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `@adminium/llm` prompt-builder barrel — 06-llm-assist.md §4, §5.
+ *
+ * `buildPrompt` is the single producer of prompt text shared by the direct-API
+ * and BYO paths. `PROMPT_VERSION` / `SCHEMA_VERSION` are intentionally NOT
+ * re-exported here — the `response/` barrel owns them.
+ */
+export * from './types.js';
+export * from './token-estimate.js';
+export * from './serializer.js';
+export * from './templates/v1.js';
+export * from './builder.js';
+export * from './chunker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompt/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/prompt/index.js

@@ -0,0 +1,14 @@
+/**
+ * `@adminium/llm` prompt-builder barrel — 06-llm-assist.md §4, §5.
+ *
+ * `buildPrompt` is the single producer of prompt text shared by the direct-API
+ * and BYO paths. `PROMPT_VERSION` / `SCHEMA_VERSION` are intentionally NOT
+ * re-exported here — the `response/` barrel owns them.
+ */
+export * from './types.js';
+export * from './token-estimate.js';
+export * from './serializer.js';
+export * from './templates/v1.js';
+export * from './builder.js';
+export * from './chunker.js';
+//# sourceMappingURL=index.js.map

package/dist/prompt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/prompt/serializer.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Schema IR + statistics serialization for the prompt (06-llm-assist.md §4.1,
+ * §4.2, §5.2).
+ *
+ * Three producers, mapping onto the three `=== INPUT: … ===` blocks of the user
+ * section:
+ *   - {@link serializeSchemaIr}  → `{{SCHEMA_IR_JSON}}`  (structure only)
+ *   - {@link serializeStats}     → `{{STATS_JSON}}`      (aggregates only)
+ *   - {@link serializeSampling}  → `{{SAMPLING_BLOCK}}`  (opt-in cell values)
+ *
+ * SAMPLE-FREE BY DEFAULT (§1 invariant 5, acceptance criterion 8): with sampling
+ * off, NO cell value from any table can appear. The schema IR carries only
+ * structure (types, flags, DECLARED enum values — which are schema, not data);
+ * the stats block carries only row counts, null fractions and distinct counts —
+ * it NEVER copies `min`/`max`/`sampleValues` off a `StatsResult`. Cell values
+ * live exclusively in the sampling block, which is empty unless the caller opts
+ * in, and even then excludes PII-suspected and secret columns.
+ *
+ * Deterministic: objects are built in a fixed key order and arrays follow input
+ * order, so `JSON.stringify` output is stable (no sorting, no timestamps).
+ */
+import type { Cardinality, DatabaseModel, Dialect, LogicalType, StatsResult, StatsScalar, TableRef, TableRole } from '@adminium/engine';
+import type { Sampling } from './types.js';
+/** Text columns with `distinctCount` at or below this are pseudo-enum candidates (§4.2). */
+export declare const PSEUDO_ENUM_MAX_DISTINCT = 24;
+/** Header line the opt-in sampling block leads with (§5.2 builder note). */
+export declare const SAMPLING_BLOCK_HEADER = "=== INPUT: SAMPLE VALUES (user opted in; PII columns excluded) ===";
+export interface SerializedColumn {
+    column: string;
+    type: LogicalType;
+    nullable: boolean;
+    primaryKey?: true;
+    unique?: true;
+    /** `EnumDef.id` when the column is enum-typed (values listed under `enumColumns`). */
+    enum?: string;
+    /** Declared FK target as `"schema.table.column"`. */
+    references?: string;
+    /** Heuristic PII suspicion — the model confirms/rejects (§4.2, decision 8). */
+    piiSuspected?: true;
+    /** Secret column — never contributes any value-touching statistic. */
+    secret?: true;
+    /** Low-cardinality non-PII text: values sent only under sampling opt-in (§4.2). */
+    pseudoEnumCandidate?: true;
+}
+export interface SerializedFullTable {
+    table: string;
+    role?: TableRole;
+    columns: SerializedColumn[];
+}
+/** Out-of-chunk FK target: names only, no suggestions requested (§4.5). */
+export interface SerializedStubTable {
+    table: string;
+    stub: true;
+    columns: string[];
+}
+export type SerializedTable = SerializedFullTable | SerializedStubTable;
+export interface SerializedEnumColumn {
+    table: string;
+    column: string;
+    values: string[];
+}
+export interface SerializedDeclaredRelation {
+    fromTable: string;
+    fromColumns: string[];
+    toTable: string;
+    toColumns: string[];
+    cardinality: Cardinality;
+}
+export interface SerializedSchemaIr {
+    database: {
+        name: string;
+        dialect: Dialect;
+        defaultSchema: string;
+    };
+    tables: SerializedTable[];
+    enumColumns: SerializedEnumColumn[];
+    declaredRelations: SerializedDeclaredRelation[];
+}
+export interface SerializedColumnStats {
+    column: string;
+    nullFraction: number | null;
+    distinctCount: number | null;
+}
+export interface SerializedTableStats {
+    table: string;
+    rowCountEstimate: number | null;
+    rowCountExact: boolean;
+    columns: SerializedColumnStats[];
+}
+export interface SerializedStats {
+    tables: SerializedTableStats[];
+}
+export interface SerializedSampleColumn {
+    column: string;
+    min?: StatsScalar;
+    max?: StatsScalar;
+    sampleValues?: StatsScalar[];
+}
+export interface SerializedSampleTable {
+    table: string;
+    columns: SerializedSampleColumn[];
+}
+export interface SerializedSampling {
+    tables: SerializedSampleTable[];
+}
+/** Compact, deterministic JSON for injection into the prompt. */
+export declare function toPromptJson(value: unknown): string;
+/** `TableRef` → the model's qualified `"schema.table"` id (mysql/sqlite have a null schema). */
+export declare function qualifyTableRef(ref: TableRef, defaultSchema: string): string;
+export interface SerializeSchemaIrOptions {
+    /** Qualified ids to render as `"stub": true` context (§4.5). */
+    stubTables?: ReadonlySet<string>;
+    /** Stats used solely to compute `pseudoEnumCandidate` (distinct-count driven). */
+    stats?: readonly StatsResult[];
+}
+export declare function serializeSchemaIr(model: DatabaseModel, options?: SerializeSchemaIrOptions): SerializedSchemaIr;
+export interface SerializeStatsOptions {
+    /** Qualified-id fallback schema for null-schema dialects. Defaults to `"public"`. */
+    defaultSchema?: string;
+}
+/**
+ * Format `StatsResult[]` into the aggregates-only stats block. Deliberately
+ * copies ONLY row counts, null fractions and distinct counts — never `min`,
+ * `max` or `sampleValues`, which are cell values and belong to the opt-in
+ * sampling block. This is what guarantees the sample-free default at the stats
+ * layer regardless of what the adapter happened to collect.
+ */
+export declare function serializeStats(stats: readonly StatsResult[], options?: SerializeStatsOptions): SerializedStats;
+/**
+ * Build the `{{SAMPLING_BLOCK}}` text. Returns `''` when `sampling` is null
+ * (sample-free default). When opted in, renders the header plus a JSON object of
+ * per-column `min`/`max`/`sampleValues` — EXCLUDING every PII-suspected or
+ * secret column (looked up from the model), and truncating each column's value
+ * list to `sampling.maxValuesPerColumn`.
+ */
+export declare function serializeSampling(model: DatabaseModel, stats: readonly StatsResult[], sampling: Sampling): string;
+export declare function serializeSamplingPayload(model: DatabaseModel, stats: readonly StatsResult[], maxValuesPerColumn: number): SerializedSampling;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/prompt/serializer.d.ts.map

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