jevascript 0.1.0 → 0.1.1

package/README.md

@@ -16,11 +16,14 @@ if (urgency > 80) {
 
 The model supplies the judgement. Your code decides the consequence.
 
+**[Website](https://jevascript.org/)** · **[Documentation](https://jevascript.org/docs)** ·
+**[Changelog](CHANGELOG.md)**
+
 ## Status
 
-Working MVP. The package is verified end to end against the live
-TypeSafe API. Several items from the design doc are deliberately not built yet — see
-[Not yet built](#not-yet-built).
+Working MVP, 0.x: the API may still change before 1.0. The package is verified end to end
+against the live TypeSafe API. Several planned features are deliberately not built yet — see
+the [roadmap](#roadmap).
 
 ## Install
 
@@ -109,6 +112,11 @@ const analysis = await semantic(ticket).batch({
 })
 ```
 
+A question means the same thing in a batch as on its own: `threshold`, `allowUnknown`,
+`minConfidence` with `fallback`, and `detailed` all apply, and the result types follow the
+options — `is("…", { allowUnknown: true })` is typed `boolean | "unknown"`, never a bare
+`boolean` that would let a truthy `"unknown"` through an `if`.
+
 `Promise.all([...])` on the same context batches identically. **Sequential `await`s cannot**
 — the second question doesn't exist until the first resolves — so the runtime warns once
 when a context issues a second request.
@@ -168,7 +176,9 @@ const risk = await semantic(order).score("fraud risk", {
 Without `minConfidence` or `samples`, `detailed: true` returns `probability` and leaves
 `confidence` undefined rather than filling it with a number that means nothing. Sampling a
 question does not multiply the cost of its neighbours: the extra rounds carry only the
-questions that asked for them.
+questions that asked for them. The rounds run concurrently, so sampling costs requests, not
+latency. A `minConfidence` set in `defaults` implies sampling just as one set on the call
+does, and a cached answer keeps the confidence it was measured with.
 
 `choose()` and rubric-backed `score()` get a real confidence from the provider — the
 concentration of the distribution — so they need no sampling.
@@ -190,7 +200,19 @@ switch (await semantic(tx).is("This is fraud", { allowUnknown: true })) {
 await semantic(doc).score("quality", { cache: "1h" })
 ```
 
-Caching is a consistency tool here as much as a cost one.
+Caching is a consistency tool here as much as a cost one. Cache keys are SHA-256 over exactly
+what the provider is sent (`Date`s included), so two states can only share an answer if the
+model would have seen the same thing.
+
+## Timeouts and failures
+
+Every evaluation runs under one deadline — 10 s unless `defaults.timeoutMs` or the call's
+`timeoutMs` says otherwise, `0` for none. Retries on 429/5xx spend from that deadline rather
+than each getting a fresh one, and a timeout or a caller's `AbortSignal` is never retried.
+A timeout throws `SemanticTimeoutError`; any other provider failure throws `ProviderError`
+with the HTTP `status` and the API's own message. Answers are validated on the way in: a
+choice that is not one of your options, or a probability outside [0, 1], is an error rather
+than a value.
 
 ## Declare a schema once, apply it to data
 
@@ -266,6 +288,14 @@ if (await churnRisk(customer) > 80) startRetentionFlow()
 
 `churnRisk.question()` composes into `batch()`, so a defined metric still shares a request.
 
+`defineRule` is the boolean counterpart. Whether a rule may answer `"unknown"` is part of its
+definition, and its type says so:
+
+```ts
+const fraud = defineRule({ name: "fraud", condition: "This order is fraudulent.", defaults: { allowUnknown: true } })
+const verdict = await fraud(order)   // boolean | "unknown"
+```
+
 Bump `version` whenever the wording changes. There is no fine-tuning: the prompt, the
 criteria and the pinned model version are a single artefact, and evaluations are only
 comparable within one.
@@ -278,7 +308,8 @@ Call cost differs by an order of magnitude, so it is worth knowing which you are
 |---|---|
 | `semantic.find(items, condition)` | **1** |
 | `semantic.compare(a, b, { by })` | **1** |
-| `semantic.filter` / `some` / `every` | N |
+| `semantic.filter` | N |
+| `semantic.some` / `every` | 1 to N — they stop as soon as the answer is decided |
 | `semantic(query).rank(items, { by })` | N |
 
 `find` puts the items themselves into one choice — and pairs it with an existence check,
@@ -370,9 +401,9 @@ Counting, arithmetic, and date comparison — a decision model reads dates as te
 ordered values. Extract the parts with a `choose`, then compare in code. Keep irrelevant
 fields out of the state; they measurably degrade accuracy.
 
-## Not yet built
+## Roadmap
 
-From the design document, deliberately out of scope for this MVP:
+Planned, and deliberately out of scope for this MVP:
 
 - `evidence` — the provider generates no text, so this has to be *extractive*: tag the state's
   lines with ids, run a choice over the ids plus an existence check, and cite the winning
@@ -430,7 +461,8 @@ npm run example examples/agent-guardrail.ts
 
 ```bash
 npm install
-npm test                                        # build + typecheck + 53 tests, no network
+npm test                                        # build + typecheck + 89 tests, no network
+npm run test:live                               # 10 contract tests against the live API, needs .env
 npm run example examples/support-ticket.ts      # live, needs JEV_API_KEY
 npm run example examples/batching-benchmark.ts
 ```
@@ -441,7 +473,15 @@ npm run example examples/batching-benchmark.ts
 src/              the runtime: context, batching, primitives, cache, definitions, collections
 src/providers/    provider adapters (jev.ts today)
 src/testing.ts    mock provider, exported as "jevascript/testing"
-test/             offline tests against the mock provider
+test/             offline tests against the mock provider and a scripted fetch
+test/live/        contract tests against the live API (npm run test:live)
 examples/         live end-to-end scripts (quick/, launch/, app/)
-docs/             landing page spec
 ```
+
+## Security
+
+Found a vulnerability? Please report it privately — see [SECURITY.md](SECURITY.md).
+
+## License
+
+[MIT](LICENSE)

package/dist/cache.d.ts

@@ -5,11 +5,14 @@ export interface SemanticCache {
 }
 /** Parses "5m", "1h", "30s", "250ms", or a raw millisecond number. */
 export declare function parseTtl(ttl: string | number): number;
-/** FNV-1a, 128-bit-ish via two independent lanes. Adequate for cache keys. */
+/**
+ * SHA-256, hex. A collision would silently serve one state's answer for
+ * another's, and states are often user-authored, so the key has to hold up
+ * against inputs chosen on purpose — not just against accidents.
+ */
 export declare function hashKey(input: string): string;
 export declare class MemoryCache implements SemanticCache {
     #private;
-    private readonly maxEntries;
     constructor(maxEntries?: number);
     get(key: string): SemanticAnswer | undefined;
     set(key: string, value: SemanticAnswer, ttlMs: number): void;

package/dist/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,GAAG,cAAc,GAAG,SAAS,CAAA;IAClF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC7E;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAQrD;AAED,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS7C;AAOD,qBAAa,WAAY,YAAW,aAAa;;IAGnC,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,SAAQ;IAE/C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAa5C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAU5D,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,GAAG,cAAc,GAAG,SAAS,CAAA;IAClF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC7E;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAQrD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C;AAOD,qBAAa,WAAY,YAAW,aAAa;;gBAInC,UAAU,SAAQ;IAI9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAa5C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAU5D,KAAK,IAAI,IAAI;CAGd"}

package/dist/cache.js

@@ -1,3 +1,4 @@
+import { createHash } from "node:crypto";
 /** Parses "5m", "1h", "30s", "250ms", or a raw millisecond number. */
 export function parseTtl(ttl) {
     if (typeof ttl === "number")
@@ -10,22 +11,19 @@ export function parseTtl(ttl) {
     const scale = { ms: 1, s: 1000, m: 60_000, h: 3_600_000, d: 86_400_000 }[unit];
     return value * scale;
 }
-/** FNV-1a, 128-bit-ish via two independent lanes. Adequate for cache keys. */
+/**
+ * SHA-256, hex. A collision would silently serve one state's answer for
+ * another's, and states are often user-authored, so the key has to hold up
+ * against inputs chosen on purpose — not just against accidents.
+ */
 export function hashKey(input) {
-    let a = 0x811c9dc5;
-    let b = 0x01000193;
-    for (let i = 0; i < input.length; i++) {
-        const c = input.charCodeAt(i);
-        a = Math.imul(a ^ c, 0x01000193) >>> 0;
-        b = Math.imul(b ^ (c + i), 0x85ebca6b) >>> 0;
-    }
-    return a.toString(36) + b.toString(36);
+    return createHash("sha256").update(input).digest("hex");
 }
 export class MemoryCache {
-    maxEntries;
     #entries = new Map();
+    #maxEntries;
     constructor(maxEntries = 5_000) {
-        this.maxEntries = maxEntries;
+        this.#maxEntries = maxEntries;
     }
     get(key) {
         const entry = this.#entries.get(key);
@@ -44,7 +42,7 @@ export class MemoryCache {
         if (ttlMs <= 0)
             return;
         this.#entries.set(key, { value, expiresAt: Date.now() + ttlMs });
-        while (this.#entries.size > this.maxEntries) {
+        while (this.#entries.size > this.#maxEntries) {
             const oldest = this.#entries.keys().next();
             if (oldest.done)
                 break;

package/dist/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAQxC,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CAAC,GAAoB;IAC3C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA;IACvC,MAAM,KAAK,GAAG,+BAA+B,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;IAC9D,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAA;IACvG,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAiC,CAAA;IACrD,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,IAAI,CAAC,CAAA;IAC9E,OAAO,KAAK,GAAG,KAAK,CAAA;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACzD,CAAC;AAOD,MAAM,OAAO,WAAW;IACtB,QAAQ,GAAG,IAAI,GAAG,EAAiB,CAAA;IAC1B,WAAW,CAAQ;IAE5B,YAAY,UAAU,GAAG,KAAK;QAC5B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAA;IAC/B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAA;QAC5B,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACzB,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,8CAA8C;QAC9C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACzB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC7B,OAAO,KAAK,CAAC,KAAK,CAAA;IACpB,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAqB,EAAE,KAAa;QACnD,IAAI,KAAK,IAAI,CAAC;YAAE,OAAM;QACtB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;QAChE,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAA;YAC1C,IAAI,MAAM,CAAC,IAAI;gBAAE,MAAK;YACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;IACvB,CAAC;CACF"}

package/dist/collections.d.ts.map

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

package/dist/collections.js

@@ -1,4 +1,4 @@
-import { BUILTIN_DEFAULTS, globalRuntime } from "./config.js";
+import { BUILTIN_DEFAULTS, globalRuntime, resolveTimeout } from "./config.js";
 import { emit as emitEvent, runPlan as runPlanRaw } from "./runner.js";
 import { parseTtlOrUndefined } from "./internal.js";
 function render(item, index, label) {
@@ -8,13 +8,30 @@ function render(item, index, label) {
         return item;
     return JSON.stringify(item);
 }
-async function mapLimited(items, limit, fn) {
+/**
+ * Runs `fn` over `items` with at most `limit` in flight.
+ *
+ * Stops handing out new items as soon as one fails or `stop()` returns true,
+ * so a failing provider or an already-decided `some()` does not keep spending
+ * requests. Items never started are left `undefined`.
+ */
+async function mapLimited(items, limit, fn, stop = () => false) {
     const results = new Array(items.length);
     let cursor = 0;
-    const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
-        while (cursor < items.length) {
+    let halted = false;
+    const workers = Array.from({ length: Math.max(1, Math.min(limit, items.length)) }, async () => {
+        while (!halted && cursor < items.length) {
             const index = cursor++;
-            results[index] = await fn(items[index], index);
+            try {
+                const result = await fn(items[index], index);
+                results[index] = result;
+                if (stop(result))
+                    halted = true;
+            }
+            catch (error) {
+                halted = true;
+                throw error;
+            }
         }
     });
     await Promise.all(workers);
@@ -26,16 +43,24 @@ export function bindCollections(runtime) {
     const resolveProvider = (override) => runtime.provider(override);
     const emit = (event) => emitEvent(event, runtime.config);
     const runPlan = (provider, state, planned, options = {}) => runPlanRaw(provider, state, planned, { ...options, store: runtime.store });
+    const thresholdOf = (options) => options.threshold ?? getConfig().defaults?.threshold ?? BUILTIN_DEFAULTS.threshold;
+    const timeoutOf = (options) => {
+        const timeoutMs = resolveTimeout(options.timeoutMs, getConfig());
+        return timeoutMs !== undefined ? { timeoutMs } : {};
+    };
     /**
-     * Scores every item independently against one proposition.
+     * Scores items independently against one proposition.
      *
      * This is N requests, not one: each item is a different state, and a request
      * carries a single state. Prefer `find` when you only need the best item.
+     * `stopWhen` ends the walk early once the answer is decided.
      */
-    async function scoreEach(items, condition, options, operation) {
+    async function scoreEach(items, condition, options, operation, stopWhen) {
         const provider = resolveProvider(options.provider);
         const ttl = parseTtlOrUndefined(options.cache ?? getConfig().defaults?.cache);
+        const samples = options.samples ?? 1;
         const started = Date.now();
+        const totals = { requests: 0, cached: 0, inputTokens: 0, outputTokens: 0 };
         const scores = await mapLimited(items, options.concurrency ?? 8, async (item, index) => {
             const rendered = render(item, index, options.label);
             const shared = options.context;
@@ -49,23 +74,29 @@ export function bindCollections(runtime) {
                         ...(options.trueWhen !== undefined ? { trueWhen: options.trueWhen } : {}),
                         ...(options.falseWhen !== undefined ? { falseWhen: options.falseWhen } : {}),
                     },
-                    samples: options.samples ?? 1,
+                    samples,
                     ...(ttl !== undefined ? { cacheTtlMs: ttl } : {}),
                 },
-            ], options.timeoutMs !== undefined ? { timeoutMs: options.timeoutMs } : {});
+            ], timeoutOf(options));
+            totals.requests += result.requestCount;
+            totals.cached += result.cachedKeys.size;
+            totals.inputTokens += result.usage.inputTokens ?? 0;
+            totals.outputTokens += result.usage.outputTokens ?? 0;
             return result.answers["match"].probability;
-        });
+        }, stopWhen);
+        const evaluated = scores.filter((s) => s !== undefined).length;
         emit({
             operation,
             keys: ["match"],
             provider: provider.name,
             model: provider.model,
             latencyMs: Date.now() - started,
-            cached: false,
+            cached: evaluated > 0 && totals.cached === evaluated,
             batched: false,
-            questionCount: items.length,
-            requestCount: items.length * (options.samples ?? 1),
-            samples: options.samples ?? 1,
+            questionCount: evaluated,
+            requestCount: totals.requests,
+            samples,
+            usage: { inputTokens: totals.inputTokens, outputTokens: totals.outputTokens },
         });
         return scores;
     }
@@ -73,16 +104,24 @@ export function bindCollections(runtime) {
         if (items.length === 0)
             return [];
         const scores = await scoreEach(items, condition, { ...options, by: condition }, "filter");
-        const threshold = options.threshold ?? getConfig().defaults?.threshold ?? BUILTIN_DEFAULTS.threshold;
+        const threshold = thresholdOf(options);
         return items.filter((_, index) => scores[index] > threshold);
     }
+    /** Stops at the first match: at best one request, at worst N. */
     async function some(items, condition, options = {}) {
-        return (await filter(items, condition, options)).length > 0;
+        if (items.length === 0)
+            return false;
+        const threshold = thresholdOf(options);
+        const scores = await scoreEach(items, condition, { ...options, by: condition }, "filter", (p) => p > threshold);
+        return scores.some((p) => p !== undefined && p > threshold);
     }
+    /** Stops at the first item that fails. */
     async function every(items, condition, options = {}) {
         if (items.length === 0)
             return true;
-        return (await filter(items, condition, options)).length === items.length;
+        const threshold = thresholdOf(options);
+        const scores = await scoreEach(items, condition, { ...options, by: condition }, "filter", (p) => p <= threshold);
+        return scores.every((p) => p !== undefined && p > threshold);
     }
     async function rank(items, options) {
         if (items.length === 0)
@@ -105,26 +144,27 @@ export function bindCollections(runtime) {
             return undefined;
         const provider = resolveProvider(options.provider);
         const capacity = provider.capabilities.maxChoiceOptions;
+        const threshold = thresholdOf(options);
         if (items.length > capacity) {
             const ranked = await rank(items, { ...options, by: condition });
             const best = ranked[0];
-            const threshold = options.threshold ?? getConfig().defaults?.threshold ?? BUILTIN_DEFAULTS.threshold;
             return best && best.score > threshold ? best.item : undefined;
         }
+        // Measured against the live API: the candidates belong both in the state
+        // (the existence check reads them there) and as the option descriptions
+        // (bare ids lose accuracy). Moving the text out of either costs correctness
+        // and saves almost no tokens.
         const ids = items.map((_, index) => `i${index}`);
-        const optionMap = {};
         const candidates = {};
         items.forEach((item, index) => {
-            const text = render(item, index, options.label);
-            optionMap[ids[index]] = text;
-            candidates[ids[index]] = text;
+            candidates[ids[index]] = render(item, index, options.label);
         });
         const ttl = parseTtlOrUndefined(options.cache ?? getConfig().defaults?.cache);
         const started = Date.now();
         const result = await runPlan(provider, { candidates }, [
             {
                 key: "pick",
-                question: { kind: "choice", instructions: condition, options: optionMap },
+                question: { kind: "choice", instructions: condition, options: candidates },
                 samples: options.samples ?? 1,
                 ...(ttl !== undefined ? { cacheTtlMs: ttl } : {}),
             },
@@ -138,7 +178,7 @@ export function bindCollections(runtime) {
                 samples: options.samples ?? 1,
                 ...(ttl !== undefined ? { cacheTtlMs: ttl } : {}),
             },
-        ], options.timeoutMs !== undefined ? { timeoutMs: options.timeoutMs } : {});
+        ], timeoutOf(options));
         emit({
             operation: "find",
             keys: ["pick", "exists"],
@@ -152,7 +192,6 @@ export function bindCollections(runtime) {
             samples: options.samples ?? 1,
             usage: result.usage,
         });
-        const threshold = options.threshold ?? getConfig().defaults?.threshold ?? BUILTIN_DEFAULTS.threshold;
         if (result.answers["exists"].probability <= threshold)
             return undefined;
         const picked = result.answers["pick"].choice;
@@ -163,6 +202,7 @@ export function bindCollections(runtime) {
     async function compare(left, right, options) {
         const provider = resolveProvider(options.provider);
         const toText = (item) => (options.label ? options.label(item) : typeof item === "string" ? item : JSON.stringify(item));
+        const ttl = parseTtlOrUndefined(options.cache ?? getConfig().defaults?.cache);
         const started = Date.now();
         const result = await runPlan(provider, { left: toText(left), right: toText(right) }, [
             {
@@ -177,15 +217,16 @@ export function bindCollections(runtime) {
                     },
                 },
                 samples: options.samples ?? 1,
+                ...(ttl !== undefined ? { cacheTtlMs: ttl } : {}),
             },
-        ], options.timeoutMs !== undefined ? { timeoutMs: options.timeoutMs } : {});
+        ], timeoutOf(options));
         emit({
             operation: "compare",
             keys: ["winner"],
             provider: provider.name,
             model: provider.model,
             latencyMs: Date.now() - started,
-            cached: false,
+            cached: result.cachedKeys.size === 1,
             batched: false,
             questionCount: 1,
             requestCount: result.requestCount,

package/dist/collections.js.map

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

package/dist/config.d.ts

@@ -1,6 +1,10 @@
 import { type SemanticCache } from "./cache.ts";
 import type { Observability, SemanticProvider } from "./types.ts";
 export interface SemanticDefaults {
+    /**
+     * Deadline for one evaluation, retries included. Defaults to 10 000. Pass `0`
+     * or `Infinity` to wait indefinitely.
+     */
     timeoutMs?: number;
     minConfidence?: number;
     cache?: string | number;
@@ -54,4 +58,6 @@ export declare function getConfig(): SemanticConfig;
 export declare function getCacheStore(): SemanticCache;
 export declare function resolveProvider(override?: SemanticProvider): SemanticProvider;
 export declare function shouldWarnUnbatched(config?: SemanticConfig): boolean;
+/** The deadline a call runs under: its own, else the configured default, else the built-in one. */
+export declare function resolveTimeout(explicit: number | undefined, config: SemanticConfig): number | undefined;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AAG5D,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3C,qFAAqF;IACrF,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAA;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,UAAU,CAAC,EAAE,aAAa,CAAA;IAC1B,uGAAuG;IACvG,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,eAAO,MAAM,gBAAgB;;;;IAI3B,8EAA8E;;CAEpD,CAAA;AAE5B;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAAA;IACvD,4FAA4F;IAC5F,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;CACxC;AAaD,wBAAgB,aAAa,CAAC,MAAM,GAAE,cAAmB,GAAG,OAAO,CAgBlE;AAKD,6FAA6F;AAC7F,eAAO,MAAM,aAAa,EAAE,OAS3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAG9D;AAED,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED,wBAAgB,SAAS,IAAI,cAAc,CAE1C;AAED,wBAAgB,aAAa,IAAI,aAAa,CAE7C;AAED,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAE7E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,cAAwB,GAAG,OAAO,CAE7E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AAI5D,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEjE,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3C,qFAAqF;IACrF,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAA;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,UAAU,CAAC,EAAE,aAAa,CAAA;IAC1B,uGAAuG;IACvG,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,eAAO,MAAM,gBAAgB;;;;IAI3B,8EAA8E;;CAEpD,CAAA;AAE5B;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAAA;IACvD,4FAA4F;IAC5F,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;CACxC;AAaD,wBAAgB,aAAa,CAAC,MAAM,GAAE,cAAmB,GAAG,OAAO,CAgBlE;AAKD,6FAA6F;AAC7F,eAAO,MAAM,aAAa,EAAE,OAS3B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAG9D;AAED,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED,wBAAgB,SAAS,IAAI,cAAc,CAE1C;AAED,wBAAgB,aAAa,IAAI,aAAa,CAE7C;AAED,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAE7E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,cAAwB,GAAG,OAAO,CAE7E;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAGvG"}

package/dist/config.js

@@ -1,5 +1,6 @@
 import { MemoryCache } from "./cache.js";
 import { NotConfiguredError } from "./errors.js";
+import { env } from "./env.js";
 import { jev } from "./providers/jev.js";
 export const BUILTIN_DEFAULTS = {
     timeoutMs: 10_000,
@@ -14,7 +15,7 @@ function resolveProviderIn(config, override) {
     if (config.provider)
         return config.provider;
     // Zero-config path: an API key in the environment is enough to start.
-    if (process.env["JEV_API_KEY"]) {
+    if (env("JEV_API_KEY")) {
         config.provider = jev();
         return config.provider;
     }
@@ -70,6 +71,11 @@ export function resolveProvider(override) {
     return globalRuntime.provider(override);
 }
 export function shouldWarnUnbatched(config = current) {
-    return config.warnUnbatched ?? process.env["NODE_ENV"] !== "production";
+    return config.warnUnbatched ?? env("NODE_ENV") !== "production";
+}
+/** The deadline a call runs under: its own, else the configured default, else the built-in one. */
+export function resolveTimeout(explicit, config) {
+    const timeoutMs = explicit ?? config.defaults?.timeoutMs ?? BUILTIN_DEFAULTS.timeoutMs;
+    return timeoutMs > 0 && Number.isFinite(timeoutMs) ? timeoutMs : undefined;
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context.d.ts

@@ -1,57 +1,22 @@
 import { type Runtime } from "./config.ts";
 import { type Ranked, type RankOptions } from "./collections.ts";
-import { type ChooseOptions, type IsOptions, type QuestionSpec, type ScoreOptions } from "./questions.ts";
-import type { ChoiceOptionSpec, State } from "./types.ts";
-export interface DetailedTruth {
-    value: boolean;
-    /** The calibrated signal. For truth-backed answers this *is* the uncertainty. */
-    probability: number;
-    /** Measured across sample rounds. Undefined unless `samples`/`minConfidence` was set. */
-    confidence?: number;
-}
-export interface DetailedScore {
-    value: number;
-    probability?: number;
-    /** Rubric position, 1-indexed. Present only for `levels`-backed scores. */
-    level?: number;
-    confidence?: number;
-}
-export interface DetailedChoice<T extends string> {
-    value: T;
-    confidence: number;
-    probabilities: Record<string, number>;
-}
+import { type ChoiceInput, type ChoiceKey, type ChooseOptions, type ChooseResult, type IsOptions, type IsResult, type QuestionSpec, type ScoreOptions, type ScoreResult } from "./questions.ts";
+import type { State } from "./types.ts";
+export type { DetailedChoice, DetailedScore, DetailedTruth } from "./questions.ts";
 export declare class SemanticContext {
     #private;
     constructor(state: State, runtime?: Runtime);
-    is(condition: string, options?: IsOptions & {
-        detailed?: false;
-        allowUnknown?: false;
-    }): Promise<boolean>;
-    is(condition: string, options: IsOptions & {
-        detailed: true;
-    }): Promise<DetailedTruth>;
-    is(condition: string, options: IsOptions & {
-        allowUnknown: true;
-    }): Promise<boolean | "unknown">;
-    score(criterion: string, options?: ScoreOptions & {
-        detailed?: false;
-    }): Promise<number>;
-    score(criterion: string, options: ScoreOptions & {
-        detailed: true;
-    }): Promise<DetailedScore>;
-    choose<const T extends readonly string[]>(options: T, extra?: ChooseOptions & {
-        detailed?: false;
-    }): Promise<T[number]>;
-    choose<const T extends readonly string[]>(options: T, extra: ChooseOptions & {
-        detailed: true;
-    }): Promise<DetailedChoice<T[number]>>;
-    choose<const T extends Readonly<Record<string, string | ChoiceOptionSpec>>>(options: T, extra?: ChooseOptions & {
-        detailed?: false;
-    }): Promise<keyof T & string>;
-    choose<const T extends Readonly<Record<string, string | ChoiceOptionSpec>>>(options: T, extra: ChooseOptions & {
-        detailed: true;
-    }): Promise<DetailedChoice<keyof T & string>>;
+    /**
+     * P(condition) thresholded into a boolean.
+     *
+     * `allowUnknown: true` widens the result to `boolean | "unknown"`, and
+     * `detailed: true` returns the probability alongside — the types follow.
+     */
+    is<O extends IsOptions = {}>(condition: string, options?: O): Promise<IsResult<O>>;
+    /** A probability- or rubric-backed number on `range` (0–100 by default). */
+    score<O extends ScoreOptions = {}>(criterion: string, options?: O): Promise<ScoreResult<O>>;
+    /** Exactly one of the options. The literal union is inferred without `as const`. */
+    choose<const T extends ChoiceInput, O extends ChooseOptions = {}>(options: T, extra?: O): Promise<ChooseResult<ChoiceKey<T>, O>>;
     /**
      * Orders items by how well they fit this state.
      *
@@ -64,7 +29,9 @@ export declare class SemanticContext {
      * Evaluates every question against this state in a single request.
      *
      * Equivalent to creating the same questions in one turn and awaiting them
-     * together; this form just makes the intent explicit and names the results.
+     * together — including every option: thresholds, `allowUnknown`,
+     * `minConfidence` and `fallback`, `detailed`. This form just makes the
+     * intent explicit and names the results.
      */
     batch<S extends Record<string, QuestionSpec>>(spec: S): Promise<{
         [K in keyof S]: S[K] extends QuestionSpec<infer V> ? V : never;