systemoneprompts 0.1.0

package/dist/definition/parse.js

@@ -0,0 +1,170 @@
+import { readFile } from "node:fs/promises";
+import { parse as parseToml, TomlError } from "smol-toml";
+import { parseFactors } from "../factors/schema.js";
+import { isJsonValue, isPlainObject } from "../json.js";
+import { validateQuestions } from "../questions/schema.js";
+import { parseRequirements } from "../state/requirements.js";
+import { diagnostic, nearestMatch, SystemOnePromptsError } from "./diagnostics.js";
+import { indexSource, locate } from "./locate.js";
+import { KNOWN_TOP_LEVEL, } from "./schema.js";
+const META_KEYS = ["title", "version", "description"];
+const KNOWN_TABLES = ["requires", "questions", "factors", "data"];
+/**
+ * Parse a TOML definition into native TypeSafe objects.
+ *
+ * Throws `SystemOnePromptsError` only when the TOML itself is invalid. Structural problems
+ * (bad field types, malformed questions, unknown factor fields) are collected in
+ * `definition.diagnostics`; the offending entries are omitted from the result.
+ * Run `checkDefinition` for cross-cutting checks (references, cycles, lint).
+ */
+export function parseDefinition(source, opts = {}) {
+    const filename = opts.filename;
+    let raw;
+    try {
+        raw = parseToml(source);
+    }
+    catch (error) {
+        throw wrapTomlError(error, filename);
+    }
+    if (!isPlainObject(raw)) {
+        throw new SystemOnePromptsError(diagnostic("error", "toml-root", "definition must be a TOML table", { filename, line: 1 }));
+    }
+    const index = indexSource(source, filename);
+    const diagnostics = [];
+    const meta = Object.create(null);
+    const parsedData = parseData(raw.data, index);
+    diagnostics.push(...parsedData.diagnostics);
+    for (const key of META_KEYS) {
+        const value = raw[key];
+        if (value === undefined)
+            continue;
+        if (typeof value === "string")
+            meta[key] = value;
+        else {
+            diagnostics.push(diagnostic("error", "meta-string", `\`${key}\` must be a string`, locate(index, { key })));
+        }
+    }
+    let model;
+    if (raw.model !== undefined) {
+        if (typeof raw.model === "string" && raw.model.trim() !== "")
+            model = raw.model.trim();
+        else {
+            diagnostics.push(diagnostic("error", "model-string", "`model` must be a non-empty string", locate(index, { key: "model" })));
+        }
+    }
+    for (const [key, value] of Object.entries(raw)) {
+        if (KNOWN_TOP_LEVEL.includes(key))
+            continue;
+        if (isPlainObject(value) || Array.isArray(value)) {
+            const suggestion = nearestMatch(key, KNOWN_TABLES);
+            diagnostics.push(diagnostic("warning", "unknown-table", `unknown top-level table [${key}]`, locate(index, { table: key, key }), suggestion ? `did you mean [${suggestion}]?` : undefined));
+            continue;
+        }
+        if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+            meta[key] = value;
+        }
+    }
+    const requires = parseRequirements(raw.requires, index);
+    diagnostics.push(...requires.diagnostics);
+    const questions = validateQuestions(raw.questions, index);
+    diagnostics.push(...questions.diagnostics);
+    const factors = parseFactors(raw.factors, new Set(Object.keys(questions.questions)), index);
+    diagnostics.push(...factors.diagnostics);
+    return {
+        meta,
+        model,
+        requires: requires.requires,
+        questions: questions.questions,
+        factors: factors.factors,
+        factorDefinitions: factors.factorDefinitions,
+        data: parsedData.data,
+        diagnostics,
+        source: { filename, text: source, index },
+    };
+}
+export async function loadDefinition(path) {
+    const text = await readFile(path, "utf8");
+    return parseDefinition(text, { filename: path });
+}
+function wrapTomlError(error, filename) {
+    if (error instanceof TomlError) {
+        const line = "line" in error && typeof error.line === "number" ? error.line : undefined;
+        const column = "column" in error && typeof error.column === "number" ? error.column : undefined;
+        return new SystemOnePromptsError(diagnostic("error", "toml-syntax", error.message, { filename, line, column }));
+    }
+    const message = error instanceof Error ? error.message : "failed to parse TOML";
+    return new SystemOnePromptsError(diagnostic("error", "toml-syntax", message, { filename }));
+}
+/**
+ * Parse the application-owned data namespace. The root is deliberately a
+ * table, while all descendants are only constrained by the JSON value rules.
+ * Invalid trees are discarded as a unit so callers cannot accidentally use a
+ * partially valid application configuration.
+ */
+function parseData(raw, index) {
+    const empty = () => Object.create(null);
+    if (raw === undefined)
+        return { data: empty(), diagnostics: [] };
+    if (!isPlainObject(raw)) {
+        return {
+            data: empty(),
+            diagnostics: [
+                diagnostic("error", "data-type", "`data` must be a TOML table", locate(index, { table: "data", key: "data" })),
+            ],
+        };
+    }
+    if (isJsonValue(raw))
+        return { data: raw, diagnostics: [] };
+    const invalid = findInvalidJson(raw, ["data"]);
+    const path = invalid?.path ?? ["data"];
+    return {
+        data: empty(),
+        diagnostics: [
+            diagnostic("error", "data-json", `\`data\` contains a non-JSON-compatible value at ${formatDataPath(path)}`, locateDataPath(index, path)),
+        ],
+    };
+}
+function findInvalidJson(value, path) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return undefined;
+    if (typeof value === "number")
+        return Number.isFinite(value) ? undefined : { path };
+    if (Array.isArray(value)) {
+        for (let index = 0; index < value.length; index += 1) {
+            if (!(index in value))
+                return { path: [...path, `[${index}]`] };
+            const invalid = findInvalidJson(value[index], [...path, `[${index}]`]);
+            if (invalid)
+                return invalid;
+        }
+        return undefined;
+    }
+    if (!isPlainObject(value))
+        return { path };
+    for (const [key, child] of Object.entries(value)) {
+        const invalid = findInvalidJson(child, [...path, key]);
+        if (invalid)
+            return invalid;
+    }
+    return undefined;
+}
+function locateDataPath(index, path) {
+    const serialized = JSON.stringify(path);
+    const location = index.keyPaths?.get(serialized) ?? index.tablePaths?.get(serialized);
+    return location ?? locate(index, { table: "data", key: "data" });
+}
+function formatDataPath(path) {
+    let result = "";
+    for (const segment of path) {
+        if (segment.startsWith("["))
+            result += segment;
+        else if (result === "")
+            result = segment;
+        else if (/^[A-Za-z0-9_-]+$/.test(segment))
+            result += `.${segment}`;
+        else
+            result += `[${JSON.stringify(segment)}]`;
+    }
+    return `\`${result}\``;
+}
+//# sourceMappingURL=parse.js.map

package/dist/definition/parse.js.map

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

package/dist/definition/schema.d.ts

@@ -0,0 +1,39 @@
+import type { FactorDef, FactorTable } from "../factors/schema.js";
+import type { JsonValue, Questions } from "../native.js";
+import type { Requirements } from "../state/requirements.js";
+import type { Diagnostic } from "./diagnostics.js";
+import type { SourceIndex } from "./locate.js";
+export declare const KNOWN_TOP_LEVEL: readonly ["title", "version", "description", "model", "requires", "questions", "factors", "data"];
+/** Verbatim `[factors]` tables, keyed by factor id — the input to `createFactorEvaluator`. */
+export type FactorDefinitions = Record<string, FactorTable>;
+/** Application-owned JSON-compatible data from the optional `[data]` table. */
+export type DefinitionData = Record<string, JsonValue>;
+export interface DefinitionMeta {
+    title?: string;
+    version?: string;
+    description?: string;
+    [key: string]: string | number | boolean | undefined;
+}
+export interface DefinitionSource {
+    filename?: string;
+    text: string;
+    index: SourceIndex;
+}
+export interface Definition {
+    meta: DefinitionMeta;
+    /** TOML `model` pin; `undefined` lets the JEV default (or `TYPESAFE_DEFAULT_MODEL`) apply. */
+    model?: string;
+    requires: Requirements;
+    /** Native TypeSafe/JEV question objects. */
+    questions: Questions;
+    /** Parsed factor definitions, normalised into operator / predicate nodes. */
+    factors: Record<string, FactorDef>;
+    /** Verbatim factor tables; pass to `createFactorEvaluator`. */
+    factorDefinitions: FactorDefinitions;
+    /** Application-owned JSON-compatible data; systemoneprompts does not interpret it. */
+    data: DefinitionData;
+    /** Structural problems found while parsing (bad types, unknown fields, malformed questions). */
+    diagnostics: Diagnostic[];
+    source: DefinitionSource;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/definition/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/definition/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,eAAe,mGASlB,CAAC;AAEX,8FAA8F;AAC9F,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE5D,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACtD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,4CAA4C;IAC5C,SAAS,EAAE,SAAS,CAAC;IACrB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,+DAA+D;IAC/D,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,sFAAsF;IACtF,IAAI,EAAE,cAAc,CAAC;IACrB,gGAAgG;IAChG,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}

package/dist/definition/schema.js

@@ -0,0 +1,11 @@
+export const KNOWN_TOP_LEVEL = [
+    "title",
+    "version",
+    "description",
+    "model",
+    "requires",
+    "questions",
+    "factors",
+    "data",
+];
+//# sourceMappingURL=schema.js.map

package/dist/definition/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/definition/schema.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO;IACP,SAAS;IACT,aAAa;IACb,OAAO;IACP,UAAU;IACV,WAAW;IACX,SAAS;IACT,MAAM;CACE,CAAC"}

package/dist/dev/cache.d.ts

@@ -0,0 +1,58 @@
+import { TypeSafeClientError } from "../client.js";
+import type { Fetch } from "../native.js";
+export type CacheMode = "read-write" | "read-only" | "refresh";
+export interface CachingFetchOptions {
+    dir?: string;
+    mode?: CacheMode;
+    fetch?: Fetch;
+}
+/** Cumulative counts since the fetch was created; `keys` are the question ids of the last request. */
+export interface CacheStats {
+    requests: number;
+    hits: number;
+    misses: number;
+    keys: string[];
+}
+export interface CachedEntry {
+    hash: string;
+    requestedModel?: string;
+    reportedModel: string;
+    answer: unknown;
+}
+export interface CachingFetch extends Fetch {
+    stats(): CacheStats;
+    readonly dir: string;
+}
+/** Read-only miss. A `TypeSafeClientError` so `TypeSafeClient` surfaces it without retrying. */
+export declare class CacheMissError extends TypeSafeClientError {
+    readonly ids: string[];
+    constructor(ids: string[]);
+}
+export declare function defaultCacheDir(cwd?: string): string;
+/**
+ * A `fetch` for `new TypeSafeClient({ fetch })` that caches System One answers per
+ * `(model, id, state, question)`. `id` is required so two questions with identical
+ * bodies cannot share an entry. `state` is the request state as sent; callers that
+ * need inspect-isolation send separate requests. A request is split into cached hits
+ * and a smaller live request for the misses; the merged response reports only the
+ * tokens actually spent. Non-System-One traffic passes through.
+ */
+export declare function createCachingFetch(opts?: CachingFetchOptions): CachingFetch;
+/** Cache key: sha256 of the canonical JSON of `{ model, id, state, question }`. */
+export declare function questionHash(parts: {
+    model?: string;
+    id?: string;
+    state: unknown;
+    question: unknown;
+}): string;
+export declare function cacheStats(dir?: string): Promise<{
+    entries: number;
+    models: Record<string, number>;
+    drift: Array<{
+        requested?: string;
+        reported: string;
+        count: number;
+    }>;
+}>;
+export declare function clearCache(dir?: string): Promise<void>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/dev/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/dev/cache.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,sGAAsG;AACtG,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAa,SAAQ,KAAK;IACzC,KAAK,IAAI,UAAU,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,gGAAgG;AAChG,qBAAa,cAAe,SAAQ,mBAAmB;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;gBAEX,GAAG,EAAE,MAAM,EAAE;CAK1B;AAID,wBAAgB,eAAe,CAAC,GAAG,SAAgB,GAAG,MAAM,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,mBAAwB,GAAG,YAAY,CA2I/E;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,MAAM,CAQT;AAED,wBAAsB,UAAU,CAAC,GAAG,SAAoB,GAAG,OAAO,CAAC;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE,CAAC,CAkBD;AAED,wBAAsB,UAAU,CAAC,GAAG,SAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE"}

package/dist/dev/cache.js

@@ -0,0 +1,287 @@
+import { createHash, randomUUID } from "node:crypto";
+import { mkdir, readdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { isAnswerForQuestion, isAnswerShape } from "../answers.js";
+import { TypeSafeClientError } from "../client.js";
+import { canonicalJson, isPlainObject } from "../json.js";
+/** Read-only miss. A `TypeSafeClientError` so `TypeSafeClient` surfaces it without retrying. */
+export class CacheMissError extends TypeSafeClientError {
+    ids;
+    constructor(ids) {
+        super(`cache miss in read-only mode: ${ids.map((id) => `\`${id}\``).join(", ")}`);
+        this.name = "CacheMissError";
+        this.ids = ids;
+    }
+}
+const SYSTEMONE_PATH = "/v1/systemone";
+export function defaultCacheDir(cwd = process.cwd()) {
+    return join(cwd, ".systemoneprompts", "cache");
+}
+/**
+ * A `fetch` for `new TypeSafeClient({ fetch })` that caches System One answers per
+ * `(model, id, state, question)`. `id` is required so two questions with identical
+ * bodies cannot share an entry. `state` is the request state as sent; callers that
+ * need inspect-isolation send separate requests. A request is split into cached hits
+ * and a smaller live request for the misses; the merged response reports only the
+ * tokens actually spent. Non-System-One traffic passes through.
+ */
+export function createCachingFetch(opts = {}) {
+    const dir = opts.dir ?? defaultCacheDir();
+    const mode = opts.mode ?? "read-write";
+    const baseFetch = opts.fetch ?? globalThis.fetch;
+    const stats = { requests: 0, hits: 0, misses: 0, keys: [] };
+    const cachingFetch = (async (input, init) => {
+        if (!isSystemOneRequest(input, init) || typeof init?.body !== "string") {
+            return baseFetch(input, init);
+        }
+        let payload;
+        try {
+            const parsed = JSON.parse(init.body);
+            if (!isPlainObject(parsed))
+                return baseFetch(input, init);
+            payload = parsed;
+        }
+        catch {
+            return baseFetch(input, init);
+        }
+        if (!isPlainObject(payload.questions)) {
+            return baseFetch(input, init);
+        }
+        const model = typeof payload.model === "string" ? payload.model : undefined;
+        const state = payload.state;
+        const questions = payload.questions;
+        const ids = Object.keys(questions);
+        const hits = dictionary();
+        const misses = dictionary();
+        for (const id of ids) {
+            const question = questions[id];
+            const hash = questionHash({ model, id, state, question });
+            if (mode === "refresh") {
+                misses[id] = question;
+                continue;
+            }
+            const cached = await readEntry(dir, hash, question);
+            if (cached) {
+                hits[id] = cached;
+            }
+            else {
+                misses[id] = question;
+            }
+        }
+        const missIds = Object.keys(misses);
+        stats.requests += 1;
+        stats.hits += ids.length - missIds.length;
+        stats.misses += missIds.length;
+        stats.keys = ids;
+        if (missIds.length === 0) {
+            return jsonResponse({
+                model: firstReportedModel(hits) ?? model ?? "jev-latest",
+                answers: Object.fromEntries(ids.map((id) => [id, hits[id].answer])),
+                usage: { input_tokens: 0, output_tokens: 0 },
+            });
+        }
+        if (mode === "read-only") {
+            throw new CacheMissError(missIds);
+        }
+        const response = await baseFetch(input, {
+            ...init,
+            headers: withoutContentLength(init.headers),
+            body: JSON.stringify({ ...payload, questions: misses }),
+        });
+        // Hand errors back untouched so TypeSafeClient sees the real status, headers, and body.
+        if (!response.ok)
+            return response;
+        let result;
+        let answers;
+        try {
+            const parsed = await response.clone().json();
+            if (isPlainObject(parsed)) {
+                result = parsed;
+                if (isPlainObject(parsed.answers))
+                    answers = parsed.answers;
+            }
+        }
+        catch {
+            // A cached hit still makes it possible to return a useful merged response.
+        }
+        const validLiveAnswers = dictionary();
+        if (answers) {
+            for (const id of missIds) {
+                if (Object.hasOwn(answers, id) && isAnswerForQuestion(misses[id], answers[id])) {
+                    validLiveAnswers[id] = answers[id];
+                }
+            }
+        }
+        const allMissesValid = missIds.every((id) => Object.hasOwn(validLiveAnswers, id));
+        const hitIds = Object.keys(hits);
+        if (!allMissesValid && hitIds.length === 0)
+            return response;
+        const reportedModel = (result && typeof result.model === "string" ? result.model : undefined) ??
+            firstReportedModel(hits) ??
+            model ??
+            "jev-latest";
+        for (const id of Object.keys(validLiveAnswers)) {
+            const hash = questionHash({ model, id, state, question: misses[id] });
+            const entry = {
+                hash,
+                requestedModel: model,
+                reportedModel,
+                answer: validLiveAnswers[id],
+            };
+            await writeEntry(dir, hash, entry);
+            hits[id] = entry;
+        }
+        const usage = result && isPlainObject(result.usage) ? result.usage : { input_tokens: 0, output_tokens: 0 };
+        const mergedAnswers = dictionary();
+        for (const id of ids) {
+            if (hits[id])
+                mergedAnswers[id] = hits[id].answer;
+            else if (Object.hasOwn(validLiveAnswers, id))
+                mergedAnswers[id] = validLiveAnswers[id];
+        }
+        return jsonResponse({
+            model: reportedModel,
+            answers: mergedAnswers,
+            usage,
+        }, response.status, response.statusText, response.headers);
+    });
+    cachingFetch.stats = () => ({ ...stats, keys: [...stats.keys] });
+    Object.defineProperty(cachingFetch, "dir", { value: dir });
+    if (baseFetch.systemonepromptsCloudflare === true) {
+        cachingFetch.systemonepromptsCloudflare = true;
+    }
+    return cachingFetch;
+}
+/** Cache key: sha256 of the canonical JSON of `{ model, id, state, question }`. */
+export function questionHash(parts) {
+    const payload = {};
+    for (const [key, value] of Object.entries(parts)) {
+        if (key === "model" && value == null)
+            continue;
+        if (key === "id" && value == null)
+            continue;
+        payload[key] = value;
+    }
+    return createHash("sha256").update(canonicalJson(payload)).digest("hex");
+}
+export async function cacheStats(dir = defaultCacheDir()) {
+    const files = await listEntries(dir);
+    const models = dictionary();
+    const driftMap = new Map();
+    let entries = 0;
+    for (const file of files) {
+        const hash = basename(file, ".json");
+        const raw = await readEntryFile(file, hash);
+        if (!raw)
+            continue;
+        entries += 1;
+        const reported = raw.reportedModel;
+        models[reported] = (models[reported] ?? 0) + 1;
+        const key = JSON.stringify([raw.requestedModel ?? null, reported]);
+        const existing = driftMap.get(key) ?? { requested: raw.requestedModel, reported, count: 0 };
+        existing.count += 1;
+        driftMap.set(key, existing);
+    }
+    return { entries, models, drift: [...driftMap.values()] };
+}
+export async function clearCache(dir = defaultCacheDir()) {
+    await rm(dir, { recursive: true, force: true });
+}
+async function readEntry(dir, hash, question) {
+    return readEntryFile(entryPath(dir, hash), hash, question);
+}
+async function writeEntry(dir, hash, entry) {
+    const path = entryPath(dir, hash);
+    await mkdir(dirname(path), { recursive: true });
+    const temporaryPath = `${path}.${process.pid}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(temporaryPath, `${JSON.stringify(entry, null, 2)}\n`);
+        await rename(temporaryPath, path);
+    }
+    finally {
+        await rm(temporaryPath, { force: true }).catch(() => undefined);
+    }
+}
+function entryPath(dir, hash) {
+    return join(dir, hash.slice(0, 2), `${hash}.json`);
+}
+async function listEntries(dir) {
+    try {
+        await stat(dir);
+        const out = [];
+        const shards = await readdir(dir, { withFileTypes: true });
+        for (const shard of shards) {
+            if (!shard.isDirectory())
+                continue;
+            const files = await readdir(join(dir, shard.name));
+            for (const file of files) {
+                if (file.endsWith(".json"))
+                    out.push(join(dir, shard.name, file));
+            }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+function isSystemOneRequest(input, init) {
+    try {
+        const url = new URL(input);
+        if (!url.pathname.endsWith(SYSTEMONE_PATH))
+            return false;
+    }
+    catch {
+        if (!input.includes(SYSTEMONE_PATH))
+            return false;
+    }
+    return (init?.method ?? "GET").toUpperCase() === "POST";
+}
+function withoutContentLength(headers) {
+    const next = new Headers(headers);
+    next.delete("content-length");
+    return next;
+}
+function jsonResponse(body, status = 200, statusText = "OK", headers) {
+    const responseHeaders = new Headers(headers);
+    responseHeaders.delete("content-length");
+    responseHeaders.delete("content-encoding");
+    responseHeaders.delete("transfer-encoding");
+    if (!responseHeaders.has("content-type"))
+        responseHeaders.set("content-type", "application/json");
+    return new Response(JSON.stringify(body), {
+        status,
+        statusText,
+        headers: responseHeaders,
+    });
+}
+function firstReportedModel(hits) {
+    for (const entry of Object.values(hits)) {
+        if (entry.reportedModel)
+            return entry.reportedModel;
+    }
+    return undefined;
+}
+function dictionary() {
+    return Object.create(null);
+}
+function readEntryFile(file, hash, question) {
+    return readFile(file, "utf8")
+        .then((raw) => JSON.parse(raw))
+        .then((value) => (isCachedEntry(value, hash, question) ? value : undefined))
+        .catch(() => undefined);
+}
+function isCachedEntry(value, hash, question) {
+    if (!/^[0-9a-f]{64}$/.test(hash))
+        return false;
+    if (!isPlainObject(value) || value.hash !== hash)
+        return false;
+    if (typeof value.reportedModel !== "string" || value.reportedModel.length === 0)
+        return false;
+    if (Object.hasOwn(value, "requestedModel") && typeof value.requestedModel !== "string")
+        return false;
+    return (Object.hasOwn(value, "answer") &&
+        isAnswerShape(value.answer) &&
+        (question === undefined || isAnswerForQuestion(question, value.answer)));
+}
+//# sourceMappingURL=cache.js.map

package/dist/dev/cache.js.map

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

package/dist/dev/index.d.ts

@@ -0,0 +1,2 @@
+export { type CachedEntry, CacheMissError, type CacheMode, type CacheStats, type CachingFetch, type CachingFetchOptions, cacheStats, clearCache, createCachingFetch, defaultCacheDir, questionHash, } from "./cache.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dev/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,WAAW,EAChB,cAAc,EACd,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/dev/index.js

@@ -0,0 +1,3 @@
+// Development-only tooling. Nothing here is needed at runtime by generated code.
+export { CacheMissError, cacheStats, clearCache, createCachingFetch, defaultCacheDir, questionHash, } from "./cache.js";
+//# sourceMappingURL=index.js.map

package/dist/dev/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dev/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAEL,cAAc,EAKd,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/factors/evaluate.d.ts

@@ -0,0 +1,21 @@
+import type { Questions, SystemOneResult } from "../native.js";
+import type { Comparator, FactorTable } from "./schema.js";
+/** The `answers` object System One returns for a set of questions. */
+export type AnswersFor<Q extends Questions> = SystemOneResult<Q>["answers"];
+/** A bare Noul reference in a Boolean context means `noul >= 0.5`. Fixed by design. */
+export declare const NOUL_CUTOFF = 0.5;
+/**
+ * Compile verbatim factor tables into a pure evaluator: answers in, Booleans out.
+ * Structural problems and cycles throw here; missing answers throw at evaluation time
+ * (never silently `false`, which `not` would flip into a wrong `true`).
+ */
+export declare function createFactorEvaluator<Q extends Questions = Questions, F = Record<string, boolean>>(defs: Record<string, FactorTable>): (answers: AnswersFor<Q>) => F;
+/**
+ * Known-answer rule aligned with pi-start-smart `isKnownAnswer`:
+ * explicit `missing`, confidence 0, and a bare Noul of 0.5 are unknown.
+ * Missing answers are unknown (not an error) when the predicate asks about known-ness.
+ */
+export declare function isKnownNativeAnswer(answer: unknown): boolean;
+/** All comparators present in `cmp` must hold (they are ANDed). */
+export declare function compare(value: number, cmp: Comparator): boolean;
+//# sourceMappingURL=evaluate.d.ts.map