systemoneprompts 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## Unreleased
+
+## 0.1.0
+
+- First TypeScript release for TOML decision definitions.
+- Validation, factors, clients, CLI tools, caching, and conformance checks.
+- Documented OpenRouter via `baseURL` / `TYPESAFE_BASE_URL`. Put the OpenRouter
+  key in `TYPESAFE_API_KEY`.
+- Cloudflare Workers AI via `cloudflareAccountId` / `CLOUDFLARE_ACCOUNT_ID`
+  and `CLOUDFLARE_API_TOKEN`. Exclusive with `TYPESAFE_BASE_URL`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 svilupp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,214 @@
+# systemoneprompts
+
+Define TypeSafe questions, required state, and Boolean factors in TOML.
+Generate typed TypeScript modules and call the System One API.
+
+## Quick start
+
+Requires Node 20+ or Bun. Set `TYPESAFE_API_KEY` for native TypeSafe API calls.
+OpenRouter and Cloudflare credentials are described under [Providers](#providers).
+
+```sh
+npm install systemoneprompts
+# or: bun add systemoneprompts
+```
+
+Save as `triage.toml`:
+
+```toml
+[requires]
+"ticket.message" = "string"
+
+[questions.topic]
+type = "choice"
+instructions = "Which team should handle `ticket.message`?"
+
+[questions.topic.criteria]
+billing = "Charges, invoices, refunds"
+orders = "Shipments and deliveries"
+
+[factors]
+billing = { ref = "topic", choice = "billing" }
+```
+
+```sh
+npx systemoneprompts generate triage.toml
+# or: bunx systemoneprompts generate triage.toml
+```
+
+Use the generated module in your TypeScript app:
+
+```ts
+import { TypeSafeClient } from "systemoneprompts";
+import { questions, model, assertState, evaluateFactors } from "./triage.generated.js";
+
+const state = { ticket: { message: "I was charged twice." } };
+assertState(state);
+const response = await new TypeSafeClient().systemOne({ state, questions, model });
+console.log(evaluateFactors(response.answers).billing);
+```
+
+`assertState` validates and narrows the original state. Generated types cover
+state, answers, and factors.
+
+## Definitions
+
+| Field | Purpose |
+| --- | --- |
+| `title`, `version`, `description` | Optional metadata |
+| `model` | Optional model for API calls |
+| `[requires]` | Required state paths and types |
+| `[questions]` | TypeSafe `noul`, `choice`, or `score` questions |
+| `[factors]` | Boolean results computed from answers |
+| `[data]` | Optional application data, exported as `data` |
+
+Requirements accept `string`, `number`, `boolean`, `array`, `object`, `null`,
+and `exists`. Paths support dots, indexes, and wildcards:
+`ticket.message`, `tickets[0].message`, `tickets[].message`.
+An empty array satisfies a wildcard requirement.
+
+Questions use TypeSafe's `type`, `instructions`, and `criteria` fields.
+Instructions and criteria entries can be strings, tables, or arrays.
+At least one question is required.
+
+Factors use `all`, `any`, `not`, `at_least`, or a `ref` predicate.
+Bare Noul references use a threshold of `0.5`; Choice and Score answers need
+a predicate. Missing answers raise errors, except in a `known`-only predicate.
+
+`[data]` holds JSON-compatible application data. Your code defines its schema
+and use; the package preserves it without sending it to the provider.
+
+See the [specification](docs/SPEC.html) for the full rules,
+[examples](examples/) for patterns, and the
+[agent guide](docs/skills/systemoneprompts/SKILL.md) for authoring definitions.
+
+## API
+
+Import core functions from `systemoneprompts`:
+
+| Function | Purpose |
+| --- | --- |
+| `parseDefinition(toml)` / `loadDefinition(path)` | Read a definition |
+| `checkDefinition(def)` | Collect validation errors and warnings |
+| `createStateAssert(def.requires)` | Validate state |
+| `createFactorEvaluator(def.factorDefinitions)` | Compute Boolean factors from answers |
+| `generate(toml, { filename })` | Generate TypeScript source |
+| `TypeSafeClient` | Call System One; accepts `apiKey`, `baseURL`, `cloudflareAccountId`, `fetch`, and `timeout` |
+
+Invalid TOML throws `SystemOnePromptsError`. Definition errors are returned as
+diagnostics; generation rejects definitions with errors.
+
+`systemoneprompts/dev` exports `createCachingFetch` for per-question caching.
+`systemoneprompts/patterns` exports `runMany` for batches and `walkTaxonomy`
+for Choice tree searches.
+
+## Providers
+
+The client builds System One JSON `{ state, questions, model }` (this is what
+the cache hashes). Where that JSON goes depends on how you construct
+`TypeSafeClient`. In Cloudflare mode the body is rewritten before the network.
+Cloudflare mode and `baseURL` / `TYPESAFE_BASE_URL` cannot be combined.
+
+### Native TypeSafe
+
+Default. `TYPESAFE_API_KEY` authenticates against `https://api.typesafe.ai`.
+Send TypeSafe model ids such as `jev-1.13.0` or `jev-latest`.
+
+```ts
+const client = new TypeSafeClient(); // TYPESAFE_API_KEY
+```
+
+### OpenRouter
+
+Point `baseURL` at OpenRouter's System One API and pass an OpenRouter key as
+`apiKey`. The client does not read `OPENROUTER_API_KEY`. OpenRouter accepts
+`jev-1.13` or `typesafe/jev-1.13`. Extra response fields such as `id`,
+`provider`, and `usage.cost` are left in place; Python validation strips them.
+
+```ts
+const client = new TypeSafeClient({
+  apiKey: process.env.TYPESAFE_API_KEY, // OpenRouter key
+  baseURL: "https://openrouter.ai/api",
+});
+await client.systemOne({ state, questions, model: "typesafe/jev-1.13" });
+```
+
+CLI: `TYPESAFE_BASE_URL=https://openrouter.ai/api` and put the OpenRouter key
+in `TYPESAFE_API_KEY`.
+
+### Cloudflare
+
+Set `cloudflareAccountId` (or `CLOUDFLARE_ACCOUNT_ID`). The client then treats
+`apiKey` as a Cloudflare token (`CLOUDFLARE_API_TOKEN` when `apiKey` is
+omitted), posts to
+`https://api.cloudflare.com/client/v4/accounts/{id}/ai/run` as
+`{ model: "typesafe/jev", input: { state, questions } }`, and unwraps the
+Workers AI envelope to `{ model, answers, usage }`. TOML `model` and CLI
+`--model` are not sent as the Cloudflare catalog id.
+
+```ts
+const client = new TypeSafeClient({
+  apiKey: process.env.CLOUDFLARE_API_TOKEN,
+  cloudflareAccountId: process.env.CLOUDFLARE_ACCOUNT_ID,
+});
+```
+
+CLI: set `CLOUDFLARE_ACCOUNT_ID` and `CLOUDFLARE_API_TOKEN`. Do not also set
+`TYPESAFE_BASE_URL`. The token needs Account → Workers AI → Read. For
+`--cache`, the CLI wraps Cloudflare inside `createCachingFetch` so cache keys
+stay System One JSON. If you pass your own cache as `fetch`, wrap Cloudflare
+inside it first; otherwise the client rejects the combination.
+
+| Host | Model to send |
+| --- | --- |
+| `api.typesafe.ai` | `jev-1.13.0` / `jev-latest` |
+| OpenRouter | `jev-1.13` or `typesafe/jev-1.13` |
+| Cloudflare | catalog `typesafe/jev` (set by the client) |
+
+## CLI
+
+```sh
+npx systemoneprompts check triage.toml --strict
+npx systemoneprompts generate triage.toml --check
+npx systemoneprompts run triage.toml --state state.json --cache --json
+npx systemoneprompts eval triage.toml --cases cases.jsonl --report report.json
+npx systemoneprompts cache stats
+# bunx systemoneprompts works the same way
+```
+
+`generate --check` fails if generated files are stale. `run` accepts state from
+stdin when `--state` is omitted. `--cache` reuses per-question answers from
+`.systemoneprompts/cache`.
+
+Each eval case has `state` and optional `id`, `labels`, and `factors`.
+Labels are Choice strings, Noul Booleans, or integer Score levels.
+`--sweep <factor>` compares thresholds.
+
+CLI model precedence: `--model`, TOML `model`, `TYPESAFE_MODEL`,
+`TYPESAFE_DEFAULT_MODEL`, then `jev-latest`. In Cloudflare mode `--model` does
+not change the catalog id `typesafe/jev`; the reported `response.model` is
+whatever Cloudflare returned.
+
+## Development
+
+Run from this package directory:
+
+```sh
+bun install --frozen-lockfile
+sh scripts/run-quiet.sh "Checks" -- bun run check
+sh scripts/run-quiet.sh "Release checks" -- bun run release:check
+```
+
+Checks cover types, lint, tests, examples, and public exports. Release checks
+also pack the npm archive and smoke it from npm and bun consumers under Node
+and Bun. Use `scripts/run-quiet.sh` for focused tests too; it retains full
+logs and prints failures.
+
+After editing example definitions, run `bun run examples:generate`.
+Live tests require `TYPESAFE_API_KEY`:
+
+```sh
+sh scripts/run-quiet.sh "Live tests" -- bun run test:live
+```
+
+After release checks pass, `bun run release:publish` builds and publishes to npm.

package/dist/answers.d.ts

@@ -0,0 +1,21 @@
+export declare function isAnswerForQuestion(question: unknown, answer: unknown): boolean;
+export declare function isAnswerShape(answer: unknown): answer is Record<string, unknown>;
+export declare function noulValue(answer: unknown): number | undefined;
+export declare function choiceLabel(answer: unknown): string | undefined;
+export declare function scoreValue(answer: unknown): number | undefined;
+export declare function wireQuestions(questions: Record<string, {
+    type: string;
+    instructions?: unknown;
+    criteria?: unknown;
+    [k: string]: unknown;
+}>): Record<string, {
+    type: string;
+    instructions?: unknown;
+    criteria?: unknown;
+}>;
+export declare function partitionAnswers(questions: Record<string, unknown>, answers: unknown): {
+    valid: Record<string, unknown>;
+    missing: string[];
+    malformed: string[];
+};
+//# sourceMappingURL=answers.d.ts.map

package/dist/answers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answers.d.ts","sourceRoot":"","sources":["../src/answers.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CA8B/E;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBhF;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI7D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG/D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI9D;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,CACf,MAAM,EACN;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CACnF,GACA,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAc9E;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,EAAE,OAAO,GACf;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAe5E"}

package/dist/answers.js

@@ -0,0 +1,104 @@
+import { isJsonValue, isPlainObject } from "./json.js";
+export function isAnswerForQuestion(question, answer) {
+    if (!isPlainObject(question) || !isAnswerShape(answer))
+        return false;
+    if (question.type !== answer.type)
+        return false;
+    if (question.type === "choice") {
+        if (!isPlainObject(question.criteria) || typeof answer.choice !== "string")
+            return false;
+        if (!Object.hasOwn(question.criteria, answer.choice))
+            return false;
+        const probabilities = answer.probabilities;
+        if (!isPlainObject(probabilities))
+            return false;
+        return Object.keys(question.criteria).every((label) => Object.hasOwn(probabilities, label) && isFiniteNumber(probabilities[label]));
+    }
+    if (question.type === "score") {
+        if (!Array.isArray(question.criteria))
+            return false;
+        const legend = answer.legend;
+        const probabilities = answer.probabilities;
+        if (!isPlainObject(legend) || !isPlainObject(probabilities))
+            return false;
+        return question.criteria.every((_, index) => {
+            const score = String(index);
+            return (Object.hasOwn(legend, score) &&
+                Object.hasOwn(probabilities, score) &&
+                isFiniteNumber(probabilities[score]));
+        });
+    }
+    return true;
+}
+export function isAnswerShape(answer) {
+    if (!isPlainObject(answer) || !isJsonValue(answer))
+        return false;
+    switch (answer.type) {
+        case "noul":
+            return isFiniteNumber(answer.noul);
+        case "choice":
+            return (typeof answer.choice === "string" &&
+                isFiniteNumber(answer.confidence) &&
+                isPlainObject(answer.probabilities));
+        case "score":
+            return (isFiniteNumber(answer.score) &&
+                isFiniteNumber(answer.confidence) &&
+                isPlainObject(answer.legend) &&
+                isPlainObject(answer.probabilities));
+        default:
+            return false;
+    }
+}
+export function noulValue(answer) {
+    if (!isAnswerShape(answer) || answer.type !== "noul")
+        return undefined;
+    const value = answer.noul;
+    return isFiniteNumber(value) ? value : undefined;
+}
+export function choiceLabel(answer) {
+    if (!isAnswerShape(answer) || answer.type !== "choice")
+        return undefined;
+    return typeof answer.choice === "string" ? answer.choice : undefined;
+}
+export function scoreValue(answer) {
+    if (!isAnswerShape(answer) || answer.type !== "score")
+        return undefined;
+    const value = answer.score;
+    return isFiniteNumber(value) ? value : undefined;
+}
+export function wireQuestions(questions) {
+    const wired = Object.create(null);
+    for (const [id, question] of Object.entries(questions)) {
+        const entry = {
+            type: question.type,
+        };
+        if (question.instructions !== undefined)
+            entry.instructions = question.instructions;
+        if (question.criteria !== undefined)
+            entry.criteria = question.criteria;
+        wired[id] = entry;
+    }
+    return wired;
+}
+export function partitionAnswers(questions, answers) {
+    const valid = Object.create(null);
+    const missing = [];
+    const malformed = [];
+    const answersObject = isPlainObject(answers) ? answers : undefined;
+    for (const [id, question] of Object.entries(questions)) {
+        if (answersObject === undefined || !Object.hasOwn(answersObject, id)) {
+            missing.push(id);
+        }
+        else if (!isAnswerForQuestion(question, answersObject[id])) {
+            malformed.push(id);
+        }
+        else {
+            valid[id] = answersObject[id];
+        }
+    }
+    return { valid, missing, malformed };
+}
+function isFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+//# sourceMappingURL=answers.js.map

package/dist/answers.js.map

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

package/dist/cli/cache.d.ts

@@ -0,0 +1,2 @@
+export declare function runCache(action: string | undefined): Promise<void>;
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cli/cache.ts"],"names":[],"mappings":"AAGA,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBxE"}

package/dist/cli/cache.js

@@ -0,0 +1,26 @@
+import { cacheStats, clearCache, defaultCacheDir } from "../dev/cache.js";
+import { fail } from "./io.js";
+export async function runCache(action) {
+    const dir = defaultCacheDir();
+    if (action === "clear") {
+        await clearCache(dir);
+        console.log(`cleared ${dir}`);
+        return;
+    }
+    if (action === "stats" || action == null) {
+        const stats = await cacheStats(dir);
+        console.log(`dir      ${dir}`);
+        console.log(`entries  ${stats.entries}`);
+        for (const [model, count] of Object.entries(stats.models)) {
+            console.log(`model    ${model}  ${count}`);
+        }
+        for (const row of stats.drift) {
+            if (row.requested && row.requested !== row.reported) {
+                console.log(`drift    ${row.requested} → ${row.reported}  ${row.count}`);
+            }
+        }
+        return;
+    }
+    fail("systemoneprompts cache stats | clear");
+}
+//# sourceMappingURL=cache.js.map

package/dist/cli/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/cli/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAA0B;IACvD,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,KAAK,KAAK,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACpD,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,SAAS,MAAM,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,CAAC,sCAAsC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/cli/check.d.ts

@@ -0,0 +1,2 @@
+export declare function runCheck(files: string[], strict: boolean): Promise<void>;
+//# sourceMappingURL=check.d.ts.map

package/dist/cli/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/cli/check.ts"],"names":[],"mappings":"AAKA,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB9E"}

package/dist/cli/check.js

@@ -0,0 +1,28 @@
+import { checkDefinition } from "../definition/check.js";
+import { SystemOnePromptsError } from "../definition/diagnostics.js";
+import { parseDefinition } from "../definition/parse.js";
+import { fail, printDiagnostics, readText } from "./io.js";
+export async function runCheck(files, strict) {
+    if (files.length === 0)
+        fail("systemoneprompts check <files...> [--strict]");
+    let errors = 0;
+    for (const file of files) {
+        try {
+            const source = await readText(file);
+            const def = parseDefinition(source, { filename: file });
+            errors += printDiagnostics(checkDefinition(def), strict);
+        }
+        catch (error) {
+            if (error instanceof SystemOnePromptsError) {
+                errors += printDiagnostics(error.diagnostics, strict);
+            }
+            else {
+                errors += 1;
+                console.error(`error: ${file}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    if (errors > 0)
+        process.exit(1);
+}
+//# sourceMappingURL=check.js.map

package/dist/cli/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/cli/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAe,EAAE,MAAe;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC7E,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,IAAI,gBAAgB,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;gBAC3C,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,CAAC;gBACZ,OAAO,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/cli/env.d.ts

@@ -0,0 +1,2 @@
+export declare function loadDotEnv(cwd?: string): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/cli/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/cli/env.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,CAAC,GAAG,SAAgB,GAAG,IAAI,CAuBpD"}

package/dist/cli/env.js

@@ -0,0 +1,29 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+export function loadDotEnv(cwd = process.cwd()) {
+    const path = resolve(cwd, ".env");
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch {
+        return;
+    }
+    for (const line of text.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eq = trimmed.indexOf("=");
+        if (eq <= 0)
+            continue;
+        const key = trimmed.slice(0, eq).trim();
+        let value = trimmed.slice(eq + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        if (process.env[key] === undefined)
+            process.env[key] = value;
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/cli/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/cli/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,UAAU,UAAU,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,EAAE,IAAI,CAAC;YAAE,SAAS;QACtB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,IACE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAC9C,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/cli/eval.d.ts

@@ -0,0 +1,18 @@
+/**
+ * One line of `cases.jsonl`. `labels` are expected answers keyed by question id
+ * (Choice label, Noul Boolean, or Score level); `factors` are expected factor values.
+ */
+export interface EvalCase {
+    id?: string;
+    state: unknown;
+    labels?: Record<string, unknown>;
+    factors?: Record<string, boolean>;
+}
+export declare function runEval(file: string | undefined, options: {
+    cases?: string;
+    cache?: boolean;
+    sweep?: string;
+    report?: string;
+    model?: string;
+}): Promise<void>;
+//# sourceMappingURL=eval.d.ts.map

package/dist/cli/eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../src/cli/eval.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAuBD,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5F,OAAO,CAAC,IAAI,CAAC,CAsHf"}