systemoneprompts 0.1.0

package/dist/generate/generate.js

@@ -0,0 +1,100 @@
+import { createHash } from "node:crypto";
+import { checkDefinition } from "../definition/check.js";
+import { errorsOf, SystemOnePromptsError } from "../definition/diagnostics.js";
+import { parseDefinition } from "../definition/parse.js";
+import { emitRequiredState } from "./types.js";
+/**
+ * Parse, check, and emit a `*.generated.ts` module. Throws `SystemOnePromptsError` listing every
+ * error when the definition does not check. Output is deterministic: identical TOML
+ * yields byte-identical TypeScript.
+ */
+export function generate(source, opts = {}) {
+    const filename = opts.filename;
+    const def = parseDefinition(source, { filename });
+    const errors = errorsOf(checkDefinition(def));
+    if (errors.length > 0)
+        throw new SystemOnePromptsError(errors);
+    return emitGenerated(def, opts.sourceName ?? filename ?? "definition.toml");
+}
+/** Emit TypeScript for an already-checked definition. */
+export function emitGenerated(def, sourceName) {
+    const hash = createHash("sha256").update(def.source.text).digest("hex");
+    const lines = [];
+    lines.push(`// generated by systemoneprompts — do not edit. source: ${basename(sourceName)} sha256:${hash}`);
+    lines.push(`import type { EntryType, JsonValue, Questions, SystemOneResult } from "systemoneprompts";`);
+    lines.push(`import { createStateAssert, createFactorEvaluator, type StateAssert } from "systemoneprompts";`);
+    lines.push("");
+    lines.push(`export const meta = ${emitValue(metaObject(def))} as const;`);
+    lines.push(`export const data = ${emitValue(def.data)} as const;`);
+    lines.push(def.model === undefined
+        ? "export const model: string | undefined = undefined;"
+        : `export const model = ${JSON.stringify(def.model)};`);
+    lines.push("");
+    lines.push(`export const requires = ${emitValue(def.requires)} as const;`);
+    lines.push(emitRequiredState(def.requires));
+    lines.push(Object.keys(def.requires).length === 0
+        ? "export const assertState: (state: RequiredState) => void = createStateAssert(requires);"
+        : "export const assertState: StateAssert<RequiredState> = createStateAssert(requires);");
+    lines.push("");
+    lines.push(`export const questions = ${emitValue(def.questions)} as const satisfies Questions;`);
+    lines.push("");
+    lines.push(`export type Answers = SystemOneResult<typeof questions>["answers"];`);
+    lines.push("");
+    lines.push(`export const factorDefinitions = ${emitValue(def.factorDefinitions)} as const;`);
+    lines.push(emitFactorsType(Object.keys(def.factorDefinitions)));
+    lines.push(`export const evaluateFactors = createFactorEvaluator<typeof questions, Factors>(factorDefinitions);`);
+    lines.push("");
+    return lines.join("\n");
+}
+function metaObject(def) {
+    const out = Object.create(null);
+    for (const [key, value] of Object.entries(def.meta)) {
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}
+function emitFactorsType(ids) {
+    if (ids.length === 0) {
+        return "export type Factors = Record<never, boolean>;";
+    }
+    const body = ids.map((id) => `  ${quoteKey(id)}: boolean;`).join("\n");
+    return `export interface Factors {\n${body}\n}`;
+}
+function emitValue(value, indent = 0) {
+    if (value === null)
+        return "null";
+    if (typeof value === "string")
+        return JSON.stringify(value);
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return "[]";
+        const pad = "  ".repeat(indent + 1);
+        const close = "  ".repeat(indent);
+        const items = value.map((item) => `${pad}${emitValue(item, indent + 1)},`);
+        return `[\n${items.join("\n")}\n${close}]`;
+    }
+    if (value && typeof value === "object") {
+        const entries = Object.entries(value).filter(([, v]) => v !== undefined);
+        if (entries.length === 0)
+            return "{}";
+        const pad = "  ".repeat(indent + 1);
+        const close = "  ".repeat(indent);
+        const items = entries.map(([key, item]) => `${pad}${quoteKey(key)}: ${emitValue(item, indent + 1)},`);
+        return `{\n${items.join("\n")}\n${close}}`;
+    }
+    return "undefined";
+}
+function quoteKey(name) {
+    // Object-literal __proto__ syntax changes the prototype, even when quoted.
+    if (name === "__proto__")
+        return '["__proto__"]';
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);
+}
+function basename(path) {
+    const parts = path.split(/[/\\]/);
+    return parts[parts.length - 1] ?? path;
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate/generate.js.map

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

package/dist/generate/types.d.ts

@@ -0,0 +1,10 @@
+import type { Requirements } from "../state/requirements.js";
+/**
+ * Emit `export interface RequiredState { … }` from `[requires]`. Every object level
+ * carries a `JsonValue` index signature, so the narrowed state is still a valid
+ * `EntryType` and can be passed straight to `TypeSafeClient.systemOne`. Index paths
+ * (`tickets[0].message` / `tickets[].message`) become element types; `[]` asserts
+ * every element at runtime.
+ */
+export declare function emitRequiredState(requires: Requirements): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/generate/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/generate/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,0BAA0B,CAAC;AAS9E;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAYhE"}

package/dist/generate/types.js

@@ -0,0 +1,126 @@
+import { parsePath } from "../state/paths.js";
+const jsonValue = () => ({ kind: "leaf", ts: "JsonValue" });
+/**
+ * Emit `export interface RequiredState { … }` from `[requires]`. Every object level
+ * carries a `JsonValue` index signature, so the narrowed state is still a valid
+ * `EntryType` and can be passed straight to `TypeSafeClient.systemOne`. Index paths
+ * (`tickets[0].message` / `tickets[].message`) become element types; `[]` asserts
+ * every element at runtime.
+ */
+export function emitRequiredState(requires) {
+    if (Object.keys(requires).length === 0) {
+        return "export type RequiredState = EntryType;";
+    }
+    const root = { kind: "object", props: new Map() };
+    for (const [path, type] of Object.entries(requires)) {
+        const segments = parsePath(path);
+        if (!segments)
+            continue;
+        addPath(root, segments, leafFor(type));
+    }
+    return `export interface RequiredState ${printObject(root.props, 0)}`;
+}
+function leafFor(type) {
+    switch (type) {
+        case "string":
+            return { kind: "leaf", ts: "string" };
+        case "number":
+            return { kind: "leaf", ts: "number" };
+        case "boolean":
+            return { kind: "leaf", ts: "boolean" };
+        case "null":
+            return { kind: "leaf", ts: "null" };
+        case "exists":
+            return jsonValue();
+        case "array":
+            return { kind: "array", element: jsonValue() };
+        case "object":
+            return { kind: "object", props: new Map() };
+    }
+}
+function addPath(node, segments, leaf) {
+    const head = segments[0];
+    if (!head)
+        return;
+    if (head.kind === "key") {
+        if (node.kind !== "object")
+            return;
+        if (segments.length === 1) {
+            node.props.set(head.name, merge(node.props.get(head.name), leaf));
+            return;
+        }
+        const next = segments[1];
+        const child = ensureContainer(node.props.get(head.name), next);
+        node.props.set(head.name, child);
+        addPath(child, segments.slice(1), leaf);
+        return;
+    }
+    if (node.kind !== "array")
+        return;
+    if (segments.length === 1) {
+        node.element = merge(node.element, leaf);
+        return;
+    }
+    const next = segments[1];
+    const child = ensureContainer(node.element, next);
+    node.element = child;
+    addPath(child, segments.slice(1), leaf);
+}
+function ensureContainer(existing, next) {
+    if (next.kind === "index" || next.kind === "all") {
+        return existing?.kind === "array"
+            ? existing
+            : { kind: "array", element: existing ?? jsonValue() };
+    }
+    return existing?.kind === "object" ? existing : { kind: "object", props: new Map() };
+}
+function merge(existing, incoming) {
+    if (!existing)
+        return incoming;
+    if (existing.kind === "leaf" && existing.ts === "JsonValue")
+        return incoming;
+    if (incoming.kind === "leaf" && incoming.ts === "JsonValue")
+        return existing;
+    if (existing.kind === "object" && incoming.kind === "object") {
+        const props = new Map(existing.props);
+        for (const [key, node] of incoming.props) {
+            props.set(key, merge(props.get(key), node));
+        }
+        return { kind: "object", props };
+    }
+    if (existing.kind === "array" && incoming.kind === "array") {
+        return { kind: "array", element: merge(existing.element, incoming.element) };
+    }
+    if (existing.kind === "array" && incoming.kind === "object") {
+        return { kind: "array", element: merge(existing.element, incoming) };
+    }
+    if (existing.kind === "object" && incoming.kind === "array") {
+        return { kind: "array", element: merge(existing, incoming.element) };
+    }
+    return incoming;
+}
+function printNode(node, indent) {
+    switch (node.kind) {
+        case "leaf":
+            return node.ts;
+        case "array":
+            return `${printNode(node.element, indent)}[]`;
+        case "object":
+            return printObject(node.props, indent);
+    }
+}
+function printObject(props, indent) {
+    const pad = "  ".repeat(indent + 1);
+    const close = "  ".repeat(indent);
+    const lines = [...props.entries()].map(([key, node]) => {
+        return `${pad}${quoteIdent(key)}: ${printNode(node, indent + 1)};`;
+    });
+    lines.push(`${pad}[k: string]: JsonValue;`);
+    return `{
+${lines.join("\n")}
+${close}}`;
+}
+function quoteIdent(name) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);
+}
+//# sourceMappingURL=types.js.map

package/dist/generate/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { choiceLabel, isAnswerForQuestion, isAnswerShape, noulValue, partitionAnswers, scoreValue, wireQuestions, } from "./answers.js";
+export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type SystemOneCallOptions, TypeSafeClient, TypeSafeClientError, type TypeSafeClientOptions, TypeSafeHttpError, TypeSafeRateLimitError, TypeSafeTimeoutError, } from "./client.js";
+export { CLOUDFLARE_MODEL, cloudflareRunUrl, createCloudflareFetch, } from "./cloudflare.js";
+export { checkDefinition } from "./definition/check.js";
+export { type Diagnostic, type DiagnosticSeverity, errorsOf, formatDiagnostic, formatLocation, hasErrors, type SourceLocation, SystemOnePromptsError, } from "./definition/diagnostics.js";
+export { loadDefinition, type ParseOptions, parseDefinition } from "./definition/parse.js";
+export type { Definition, DefinitionData, DefinitionMeta, DefinitionSource, FactorDefinitions, } from "./definition/schema.js";
+export { type AnswersFor, createFactorEvaluator, isKnownNativeAnswer, NOUL_CUTOFF, } from "./factors/evaluate.js";
+export type { Comparator, FactorDef, FactorTable } from "./factors/schema.js";
+export { emitGenerated, type GenerateOptions, generate } from "./generate/generate.js";
+export { DEFAULT_MODEL, readEnvModel, resolveModel } from "./model.js";
+export type { ChoiceCriteria, ChoiceQuestion, ChoiceResponse, Description, EntryType, Fetch, JsonValue, NoulQuestion, NoulResponse, Question, Questions, ResultFor, ScoreCriteria, ScoreLegend, ScoreOf, ScoreQuestion, ScoreResponse, SystemOneRequest, SystemOneResult, Usage, } from "./native.js";
+export { QUESTION_TYPES, type QuestionType } from "./questions/schema.js";
+export { createStateAssert, REQUIREMENT_TYPES, type Requirements, type RequirementType, type StateAssert, } from "./state/requirements.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,cAAc,EACd,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,KAAK,cAAc,EACnB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC3F,YAAY,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,UAAU,EACf,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvE,YAAY,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,WAAW,EACX,SAAS,EACT,KAAK,EACL,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,aAAa,EACb,WAAW,EACX,OAAO,EACP,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,KAAK,GACN,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// Parse → check → derive → generate. Everything else in the package is tooling around these.
+export { choiceLabel, isAnswerForQuestion, isAnswerShape, noulValue, partitionAnswers, scoreValue, wireQuestions, } from "./answers.js";
+export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, TypeSafeClient, TypeSafeClientError, TypeSafeHttpError, TypeSafeRateLimitError, TypeSafeTimeoutError, } from "./client.js";
+export { CLOUDFLARE_MODEL, cloudflareRunUrl, createCloudflareFetch, } from "./cloudflare.js";
+export { checkDefinition } from "./definition/check.js";
+export { errorsOf, formatDiagnostic, formatLocation, hasErrors, SystemOnePromptsError, } from "./definition/diagnostics.js";
+export { loadDefinition, parseDefinition } from "./definition/parse.js";
+export { createFactorEvaluator, isKnownNativeAnswer, NOUL_CUTOFF, } from "./factors/evaluate.js";
+export { emitGenerated, generate } from "./generate/generate.js";
+export { DEFAULT_MODEL, readEnvModel, resolveModel } from "./model.js";
+export { QUESTION_TYPES } from "./questions/schema.js";
+export { createStateAssert, REQUIREMENT_TYPES, } from "./state/requirements.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAE7F,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAElB,cAAc,EACd,mBAAmB,EAEnB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAGL,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,SAAS,EAET,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAqB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQ3F,OAAO,EAEL,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAwB,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAuBvE,OAAO,EAAE,cAAc,EAAqB,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAIlB,MAAM,yBAAyB,CAAC"}

package/dist/json.d.ts

@@ -0,0 +1,6 @@
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+export declare function isJsonValue(value: unknown): boolean;
+/** JSON with object keys sorted recursively, so equal values hash identically. */
+export declare function canonicalJson(value: unknown): string;
+export declare function typeName(value: unknown): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI9E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEnD;AAmBD,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAYD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI/C"}

package/dist/json.js

@@ -0,0 +1,52 @@
+export function isPlainObject(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+export function isJsonValue(value) {
+    return checkJsonValue(value, new WeakSet());
+}
+function checkJsonValue(value, ancestors) {
+    if (value === null)
+        return true;
+    const t = typeof value;
+    if (t === "string" || t === "boolean")
+        return true;
+    if (t === "number")
+        return Number.isFinite(value);
+    if (!Array.isArray(value) && !isPlainObject(value))
+        return false;
+    if (ancestors.has(value))
+        return false;
+    ancestors.add(value);
+    // Iteration visits sparse array slots as undefined; shared references are valid
+    // as long as they are not ancestors of the current value.
+    for (const child of Array.isArray(value) ? value : Object.values(value)) {
+        if (!checkJsonValue(child, ancestors))
+            return false;
+    }
+    ancestors.delete(value);
+    return true;
+}
+/** JSON with object keys sorted recursively, so equal values hash identically. */
+export function canonicalJson(value) {
+    return JSON.stringify(sortKeys(value));
+}
+function sortKeys(value) {
+    if (Array.isArray(value))
+        return value.map(sortKeys);
+    if (!isPlainObject(value))
+        return value;
+    return Object.fromEntries(Object.keys(value)
+        .sort()
+        .map((key) => [key, sortKeys(value[key])]));
+}
+export function typeName(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,OAAO,EAAU,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,cAAc,CAAC,KAAc,EAAE,SAA0B;IAChE,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,CAAC,GAAG,OAAO,KAAK,CAAC;IACvB,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACjE,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,gFAAgF;IAChF,0DAA0D;IAC1D,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC;YAAE,OAAO,KAAK,CAAC;IACtD,CAAC;IACD,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;SACf,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,OAAO,KAAK,CAAC;AACtB,CAAC"}

package/dist/model.d.ts

@@ -0,0 +1,9 @@
+/** TypeSafe default when neither the TOML nor the call pins a model. */
+export declare const DEFAULT_MODEL = "jev-latest";
+/**
+ * Resolve the model for a live call.
+ * Later non-empty arguments win: env/default → TOML `model` → call-site override.
+ */
+export declare function resolveModel(...candidates: Array<string | undefined | null>): string;
+export declare function readEnvModel(env?: Record<string, string | undefined>): string | undefined;
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,eAAO,MAAM,aAAa,eAAe,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,MAAM,CAQpF;AAED,wBAAgB,YAAY,CAC1B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,MAAM,GAAG,SAAS,CAGpB"}

package/dist/model.js

@@ -0,0 +1,22 @@
+/** TypeSafe default when neither the TOML nor the call pins a model. */
+export const DEFAULT_MODEL = "jev-latest";
+/**
+ * Resolve the model for a live call.
+ * Later non-empty arguments win: env/default → TOML `model` → call-site override.
+ */
+export function resolveModel(...candidates) {
+    let resolved = DEFAULT_MODEL;
+    for (const candidate of candidates) {
+        if (typeof candidate !== "string")
+            continue;
+        const trimmed = candidate.trim();
+        if (trimmed !== "")
+            resolved = trimmed;
+    }
+    return resolved;
+}
+export function readEnvModel(env = process.env) {
+    const model = env.TYPESAFE_MODEL;
+    return model?.trim() ? model : env.TYPESAFE_DEFAULT_MODEL;
+}
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAG,UAA4C;IAC1E,IAAI,QAAQ,GAAG,aAAa,CAAC;IAC7B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,SAAS;QAC5C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,OAAO,KAAK,EAAE;YAAE,QAAQ,GAAG,OAAO,CAAC;IACzC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAA0C,OAAO,CAAC,GAAG;IAErD,MAAM,KAAK,GAAG,GAAG,CAAC,cAAc,CAAC;IACjC,OAAO,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,sBAAsB,CAAC;AAC5D,CAAC"}

package/dist/native.d.ts

@@ -0,0 +1,97 @@
+/** JSON-compatible value used for state, instructions, criteria, and generated types. */
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** Text, a JSON object or array, or `null` for state, instructions, and criteria. */
+export type EntryType = string | {
+    [key: string]: JsonValue;
+} | JsonValue[] | null;
+/** A criterion description; `null` leaves the label undescribed. */
+export type Description = EntryType;
+/** A yes/no question with optional descriptions for either outcome. */
+export interface NoulQuestion {
+    type: "noul";
+    instructions?: EntryType;
+    criteria?: {
+        true?: EntryType;
+        false?: EntryType;
+    } | null;
+}
+/** Labels mapped to descriptions, or `null` for undescribed labels. */
+export type ChoiceCriteria = {
+    [label: string]: Description;
+};
+/** A question that selects between named alternatives. */
+export interface ChoiceQuestion<T extends ChoiceCriteria = ChoiceCriteria> {
+    type: "choice";
+    instructions?: EntryType;
+    criteria: T;
+}
+/** At least two descriptions indexed by score from zero; `null` leaves a score undescribed. */
+export type ScoreCriteria = readonly [EntryType, EntryType, ...EntryType[]];
+/** A question that assigns a score using an ordered rubric. */
+export interface ScoreQuestion<T extends ScoreCriteria = ScoreCriteria> {
+    type: "score";
+    instructions?: EntryType;
+    criteria: T;
+}
+/** A question identified by its `type` field. */
+export type Question = NoulQuestion | ScoreQuestion | ChoiceQuestion;
+/** Questions keyed by the names used to identify their answers. */
+export interface Questions {
+    [name: string]: Question;
+}
+/** A yes/no answer. */
+export interface NoulResponse {
+    readonly type: "noul";
+    readonly noul: number;
+}
+/** A selected label and its probabilities. */
+export interface ChoiceResponse<T extends ChoiceCriteria = ChoiceCriteria> {
+    readonly type: "choice";
+    readonly choice: keyof T & string;
+    readonly confidence: number;
+    readonly probabilities: {
+        readonly [label in keyof T]: number;
+    };
+}
+/** Score keys inferred from the rubric; a fixed-length tuple yields its indices, otherwise `number`. */
+export type ScoreOf<T extends ScoreCriteria> = number extends T["length"] ? number : Extract<keyof T, `${number}`>;
+/** Rubric descriptions keyed by score. */
+export type ScoreLegend<T extends ScoreCriteria> = {
+    readonly [score in ScoreOf<T>]: T[score];
+};
+/** An expected score with its rubric and probabilities. */
+export interface ScoreResponse<T extends ScoreCriteria = ScoreCriteria> {
+    readonly type: "score";
+    readonly score: number;
+    readonly confidence: number;
+    readonly legend: ScoreLegend<T>;
+    readonly probabilities: {
+        readonly [score in ScoreOf<T>]: number;
+    };
+}
+/** The answer type for a question, preserving its criteria keys. */
+export type ResultFor<T extends Question> = T extends NoulQuestion ? NoulResponse : T extends ScoreQuestion<infer S> ? ScoreResponse<S> : T extends ChoiceQuestion<infer E> ? ChoiceResponse<E> : never;
+/** Token usage for a request. */
+export interface Usage {
+    readonly input_tokens: number;
+    readonly output_tokens: number;
+}
+/** Answers keyed by question name, with model and usage metadata. */
+export interface SystemOneResult<Q extends Questions> {
+    readonly model: string;
+    readonly answers: {
+        readonly [K in keyof Q]: ResultFor<Q[K]>;
+    };
+    readonly usage: Usage;
+}
+/** State and named questions for `systemOne`. */
+export interface SystemOneRequest<Q extends Questions = Questions> {
+    state: unknown;
+    questions: Q;
+    model?: string;
+}
+/** HTTP fetch compatible with the global `fetch`. */
+export type Fetch = (input: string, init?: RequestInit) => Promise<Response>;
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

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

package/dist/native.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":""}

package/dist/patterns/index.d.ts

@@ -0,0 +1,3 @@
+export { type RunManyItem, type RunManyOptions, runMany, type SystemOneClient, } from "./run-many.js";
+export { type TaxonomyNode, type TaxonomyPath, type TaxonomyTree, type WalkTaxonomyOptions, walkTaxonomy, } from "./walk-taxonomy.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/patterns/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,OAAO,EACP,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,YAAY,GACb,MAAM,oBAAoB,CAAC"}

package/dist/patterns/index.js

@@ -0,0 +1,3 @@
+export { runMany, } from "./run-many.js";
+export { walkTaxonomy, } from "./walk-taxonomy.js";
+//# sourceMappingURL=index.js.map

package/dist/patterns/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/patterns/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,OAAO,GAER,MAAM,eAAe,CAAC;AACvB,OAAO,EAKL,YAAY,GACb,MAAM,oBAAoB,CAAC"}

package/dist/patterns/options.d.ts

@@ -0,0 +1,2 @@
+export declare function positiveInteger(name: string, value: number): number;
+//# sourceMappingURL=options.d.ts.map

package/dist/patterns/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/patterns/options.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnE"}

package/dist/patterns/options.js

@@ -0,0 +1,7 @@
+export function positiveInteger(name, value) {
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new RangeError(`${name} must be a positive integer`);
+    }
+    return value;
+}
+//# sourceMappingURL=options.js.map

package/dist/patterns/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/patterns/options.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAa;IACzD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,6BAA6B,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/patterns/run-many.d.ts

@@ -0,0 +1,41 @@
+import type { Questions, SystemOneResult } from "../native.js";
+/**
+ * The slice of `TypeSafeClient` the patterns need. Any object with a compatible
+ * `systemOne` works, which keeps the helpers testable without the network.
+ */
+export interface SystemOneClient {
+    systemOne(request: {
+        state: unknown;
+        questions: Questions;
+        model?: string;
+    }): Promise<SystemOneResult<Questions>>;
+}
+export interface RunManyItem<Q extends Questions = Questions> {
+    state: unknown;
+    questions: Q;
+    model?: string;
+}
+type RunManyShared<Q extends Questions> = {
+    model?: string;
+    /** Maximum in-flight requests. Default 4. */
+    concurrency?: number;
+    /** Called once as each state settles, in completion order. A thrown callback rejects the batch. */
+    onResult?: (index: number, result: SystemOneResult<Q> | Error) => void;
+};
+export type RunManyOptions<Q extends Questions> = (RunManyShared<Q> & {
+    questions: Q;
+    states: readonly unknown[];
+    items?: never;
+}) | (RunManyShared<Q> & {
+    items: readonly RunManyItem<Q>[];
+    questions?: never;
+    states?: never;
+});
+/**
+ * Ask questions about many states with bounded concurrency.
+ * Pass shared `questions` + `states`, or per-item `{ state, questions }`.
+ * Results keep input order; a failed call yields its `Error` instead of aborting the batch.
+ */
+export declare function runMany<Q extends Questions>(client: SystemOneClient, opts: RunManyOptions<Q>): Promise<Array<SystemOneResult<Q> | Error>>;
+export {};
+//# sourceMappingURL=run-many.d.ts.map

package/dist/patterns/run-many.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-many.d.ts","sourceRoot":"","sources":["../../src/patterns/run-many.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,OAAO,EAAE;QACjB,KAAK,EAAE,OAAO,CAAC;QACf,SAAS,EAAE,SAAS,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,CAAC,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,aAAa,CAAC,CAAC,SAAS,SAAS,IAAI;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mGAAmG;IACnG,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC;CACxE,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,IAC1C,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG;IAClB,SAAS,EAAE,CAAC,CAAC;IACb,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC,GACF,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG;IAClB,KAAK,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB,CAAC,CAAC;AAEP;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,CAAC,SAAS,SAAS,EAC/C,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CA2B5C"}