@hourslabs/domovoi 0.1.0 → 0.2.0

package/README.md

@@ -37,32 +37,30 @@ Some decisions in software resist code. Is "SQ *COFFEE 0421" a restaurant or a g
 
 Rules and trained classifiers have tackled this for decades. Rules break on edge cases, then multiply until they collapse under their own weight. Classifiers return a confidence score and leave the handling to you. They don't know what they don't know.
 
-domovoi is a single function call at the decision point. Unlike agent frameworks or workflow engines, it doesn't restructure how you build — it drops into existing code like any other dependency. Ask it, get a typed `Verdict`, continue.
+domovoi is a single function call at the decision point. Unlike agent frameworks or workflow engines, it doesn't restructure how you build — it drops into existing code like any other dependency. Ask it, get a typed `Verdict`, and dispatch.
 
-The `Verdict` is the core idea. Not a string, not a confidence score — one of three typed states: `Classified` when confident, `Uncertain` when the top answer falls below threshold, `Unknown` when no answer is possible. Uncertainty becomes a first-class value your type system understands, not a silent wrong answer. Everything around the `Verdict` stays deterministic.
+The `Verdict` is the core idea. Rather than a string or a confidence score, domovoi returns one of three typed states: `Classified` when confident, `Uncertain` when the top answer falls below threshold, `Unknown` when no answer is possible. Uncertainty becomes a first-class value your type system understands, not a silent wrong answer. Everything around the `Verdict` stays deterministic.
 
 ```tsx
 import { domovoi, match } from "@hourslabs/domovoi";
 
-async function processTransaction(txn: Transaction) {
-  const account = await accounts.get(txn.accountId);
-  if (await fraud.isSuspicious(txn)) return holds.queue(txn);
+async function processTransaction(transaction: Transaction): Promise<void> {
+  if (await fraud.isSuspicious(transaction)) return holds.queue(transaction);
 
+  const account = await accounts.get(transaction.accountId);
   const verdict = await domovoi.classify(
-    txn.merchant,           // e.g. "NETFLIX.COM"
-    account.budget.categories  // e.g. ["shopping", "groceries", ...]
+    transaction.merchant,      // e.g. "NETFLIX.COM"
+    account.budget.categories, // e.g. ["shopping", "groceries", ...]
   );
 
   await match(verdict, {
-    classified: ({ value }) => budget.attribute(account, txn, value),
-    uncertain:  ({ top, runnerUp }) =>
-      budget.attributePending(account, txn, top, runnerUp),
-    unknown:    ({ reason }) =>
-      retryQueue.schedule(txn, { reason, delayMs: 5 * 60_000 }),
+    classified: ({ value })         => budget.attribute(account, transaction, value),
+    uncertain:  ({ top, runnerUp }) => budget.attributePending(account, transaction, top, runnerUp),
+    unknown:    ({ reason })        => transactions.markUncategorized(transaction, reason),
   });
 
-  await receipts.archive(txn);
-  events.emit("txn.processed", txn.id);
+  await receipts.archive(transaction);
+  events.emit("transaction.processed", transaction.id);
 }
 ```
 
@@ -101,14 +99,73 @@ The `AMZN MKTP` row shows why the third state exists: it could be shopping or gr
 
 ---
 
-## When to Use It
+## Where Heuristics Break Down
 
-The pattern that fits: *a decision that's obvious to a person but impossible to write rules for, with a bounded downside when you get it wrong.*
+Use domovoi for decisions that are obvious to a human, hard to encode in rules, and safe to get wrong within bounds.
 
-- **Intent routing** — refund, complaint, or question. Rules and regex can't cover the full input space.
+- **Intent routing** — refund, complaint, or question. Rule sets and regex won't cover the full input space.
 - **Content classification** — tag an article, ticket, or submission against your taxonomy. Replace brittle keyword rules with a classifier that handles edge cases.
-- **Tiered dispatch** — chain `[gpt-4o-mini, gpt-5]`. The cheap model handles the easy cases; the expensive one runs only on `Uncertain`. Cost savings are meaningful when ≥70–80% of calls resolve at the cheaper tier.
-- **Free-form validation + privacy filters** — does this description match the product? Does this profile bio violate guidelines? Does this user input contain PII or a prompt-injection attempt?
+- **Tiered dispatch** — chain models (e.g., cheap → expensive). The cheaper model handles easy cases; the stronger model runs only on `Uncertain`. Costs drop meaningfully when ~70–80% resolve at the lower tier.
+- **Free-form validation + privacy filters** — does this description match the product? Does this bio violate guidelines? Does this input contain PII or a prompt-injection attempt?
+
+This same shape shows up across mainstream libraries: [Mozilla Readability](https://github.com/mozilla/readability) and [Mercury Parser](https://github.com/postlight/parser) for DOM-based article extraction, [GitHub Linguist](https://github.com/github-linguist/linguist) for language detection, and [email-reply-parser](https://github.com/crisp-oss/email-reply-parser/blob/master/lib/regex.ts) and [Talon](https://github.com/mailgun/talon) for email fragment parsing. Under the hood, they rely on dense stacks of regex and heuristics that grow in complexity without ever fully solving the problem.
+
+Here's a paraphrased example from email-reply-parser:
+
+<table>
+<tr><th>Before</th><th>With domovoi</th></tr>
+<tr>
+<td valign="top">
+
+```ts
+const QUOTE_HEADERS = [
+  /^-*\s*(On\s.+\swrote:{0,1})\s*-*$/m,    // EN
+  /^-*\s*(Le\s.+\sécrit\s?:{0,1})\s*-*$/m, // FR
+  /^\s*(Am\s.+schrieb.+):$/m,              // DE
+  /^(在[\s\S]+写道：)$/m,                    // ZH
+  /^(20[0-9]{2}\..+\s작성:)$/m,             // KO
+  // ...25 more locale variants
+];
+
+const SIGNATURE_SEPS = [
+  /^\s*-{2,4}$/, /^\s*_{2,4}$/, /^-- $/,
+  // ...18 patterns total
+];
+
+function classify(line: string) {
+  if (QUOTE_HEADERS.some(r => r.test(line)))
+    return "quote";
+  if (SIGNATURE_SEPS.some(r => r.test(line)))
+    return "signature";
+  return "body";
+}
+
+// "-- pricing tier --" → signature.
+// Body silently dropped.
+```
+
+</td>
+<td valign="top">
+
+```ts
+const fragment = await domovoi.classify(
+  line,
+  ["quote", "signature", "body"],
+);
+
+await match(fragment, {
+  classified: ({ value }) =>
+    record(line, value),
+  uncertain:  ({ top, runnerUp }) =>
+    record(line, top, { lowConfidence: runnerUp }),
+  unknown: () =>
+    record(line, "body"),
+});
+```
+
+</td>
+</tr>
+</table>
 
 ---
 
@@ -246,6 +303,192 @@ controller.abort("budget_exceeded");
 
 ---
 
+## Scopes
+
+A `domovoi.classify` call deep in a request handler needs three things from its environment: a cost ceiling, a cancellation signal, and observability. Threading them through every layer of your stack as arguments is tedious. Scopes make them ambient.
+
+```ts
+import { domovoi } from "@hourslabs/domovoi";
+
+await domovoi.scope(
+  { budget: { tokens: 50_000 }, signal: req.signal, tracer },
+  async () => {
+    // Every classify inside this scope inherits the budget, the signal,
+    // and the tracer.
+    await processBatch(items);
+  },
+);
+```
+
+If `processBatch` calls helpers that classify, they share the same running budget. When the budget hits zero, the next classify returns `Unknown { reason: { type: "budget_exceeded", spent, limit } }` rather than spend more.
+
+### Predictable cost
+
+The failure mode that makes finance teams nervous about LLM-backed code is the runaway loop — an infinite call quietly burning through a month of budget in an afternoon. Scope budgets are the circuit breaker:
+
+```ts
+await domovoi.scope({ budget: { tokens: 10_000 } }, async () => {
+  for (const item of items) {
+    const v = await domovoi.classify(item.text, ["a", "b"]);
+    if (v.kind === "unknown" && v.reason.type === "budget_exceeded") break;
+    // ...
+  }
+});
+```
+
+Default mode is graceful: classify returns `Unknown` when the limit is hit. For hard-fail behavior, set `onExceeded: "throw"` — classify throws `BudgetExceededError` instead.
+
+### Scope-level cancellation
+
+Scope signals combine with per-call signals via `AbortSignal.any`. Either firing aborts the in-flight provider call.
+
+```ts
+const ac = new AbortController();
+setTimeout(() => ac.abort("user navigated away"), 5_000);
+
+await domovoi.scope({ signal: ac.signal }, async () => {
+  await domovoi.classify(input, space);
+});
+```
+
+### Observability
+
+Pass a `Tracer` and domovoi emits one span per provider call, following the [OpenTelemetry GenAI semantic conventions](https://opentelemetry.io/docs/specs/semconv/gen-ai/) for `gen_ai.*` fields and reserving `domovoi.*` for verdict-shaped concepts:
+
+| Attribute | Carries |
+|---|---|
+| `gen_ai.provider.name` | `"openai"`, `"anthropic"`, etc. |
+| `gen_ai.request.model` | requested model id |
+| `gen_ai.usage.input_tokens` / `output_tokens` | per-call token counts |
+| `domovoi.verdict.kind` | `"classified"` / `"uncertain"` / `"unknown"` |
+| `domovoi.verdict.value` | selected label when classified |
+| `domovoi.cache.hit` | whether the call was served from cache |
+
+A short adapter wires your existing OpenTelemetry tracer in:
+
+```ts
+import { trace } from "@opentelemetry/api";
+import type { Tracer } from "@hourslabs/domovoi";
+
+const otel = trace.getTracer("my-app");
+const tracer: Tracer = {
+  startSpan: (name, attrs) => otel.startSpan(name, { attributes: attrs }),
+};
+```
+
+Datadog, Honeycomb, Grafana Cloud, and Dynatrace populate their AI Observability views from `gen_ai.*` attributes automatically.
+
+### Resolution order
+
+Each `domovoi.classify` call resolves its budget, signal, and tracer in this order:
+
+1. Per-call option, e.g. `domovoi.classify(..., { signal })`
+2. Nearest enclosing `domovoi.scope`
+3. No enforcement, no tracing, no budget
+
+`AbortSignal` is the one exception — per-call and scope signals combine, rather than the per-call value overriding the scope.
+
+Nested scopes inherit unspecified fields from the parent. A child `budget` overrides the parent and starts a fresh counter. A child `tracer` overrides. A child `signal` combines.
+
+### Bind: scope across async boundaries
+
+Queue workers, cron jobs, and `setTimeout` callbacks run *outside* the original async context. `domovoi.bind` captures the current scope and re-applies it on later invocation:
+
+```ts
+await domovoi.scope({ budget: { tokens: 50_000 }, tracer }, async () => {
+  const job = domovoi.bind(async (item: Item) => {
+    return domovoi.classify(item.text, ["a", "b"]);
+  });
+
+  // Queue runs `job` later, in a different async context. The captured
+  // scope is re-applied: budget and tracer still flow through.
+  await queue.push(job, items);
+});
+```
+
+Mirrors Node's `AsyncLocalStorage.bind` and OpenTelemetry's `context.bind`. Outside any scope, `domovoi.bind(fn)` returns `fn` unchanged.
+
+### Backward compatibility
+
+Calls outside any scope are unchanged: no enforcement, no tracing, no budget. Existing code keeps working without changes.
+
+---
+
+## Testing
+
+Two primitives in `@hourslabs/domovoi/testing` cover the testing surface:
+
+- `mockProvider({ behavior })` — a `Provider` stub for unit-testing engine logic without hitting a real LLM.
+- `distribution(fn, { n })` — runs `n` real samples and returns Wilson-CI-backed assertions about behavior stability.
+
+### mockProvider — unit tests without an LLM
+
+Most engine and threshold logic doesn't need a real model. `mockProvider` lets you supply a deterministic Distribution per call:
+
+```ts
+import { mockProvider } from "@hourslabs/domovoi/testing";
+
+const stub = mockProvider({
+  behavior: () => ({ probs: { yes: 0.92, no: 0.08 }, coverage: 0.95 }),
+});
+
+const c = domovoi.classifier({
+  space: ["yes", "no"] as const,
+  thresholds: { high: 0.7, low: 0.3 },
+  providers: [stub],
+});
+
+const v = await c("input that the mock ignores");
+// v.kind === "classified", v.value === "yes" — deterministic, no network
+```
+
+Useful for threshold logic, provider-chain fallback, calibrator math, error-handling paths — anything that's about *engine* behavior rather than *model* behavior. Zero LLM calls; runs anywhere.
+
+### distribution — assert against AI behavior
+
+Single-sample assertions on AI behavior are meaningless: the model varies between runs. `distribution()` runs `n` real samples and turns "the classifier should reliably tag greetings" into a one-liner backed by a Wilson confidence interval:
+
+```ts
+import { distribution } from "@hourslabs/domovoi/testing";
+
+const dist = await distribution(
+  () => domovoi.classify("hello there", ["greeting", "request"] as const),
+  { n: 100 },
+);
+
+dist.coverage("greeting");           // 0.94
+dist.confidenceInterval("greeting"); // [0.88, 0.98] — 95% Wilson CI
+dist.modeKind();                      // "classified" | "uncertain" | "unknown"
+
+dist.expectStable({
+  minCoverage: 0.9,        // OR per-label: { greeting: 0.9, request: 0.5 }
+  maxUncertain: 0.05,
+  maxUnknown: 0.02,
+});
+```
+
+Default concurrency is `Math.min(n, 5)` — `n=100` finishes in ~6 seconds against a 300ms p50 provider, well under typical rate limits. Pass `concurrency: 1` to serialize when running multiple `distribution()` tests in parallel.
+
+`distribution()` makes `n` real LLM calls. At gpt-4o-mini and `n=100`, that's ~$0.005 per test — belongs in `test:e2e`, not the per-commit unit tier.
+
+---
+
+## Cost
+
+A `domovoi.classify` call on gpt-4o-mini costs about $0.00004 — roughly 1/25 of a cent. ~180 input tokens (system prompt + label space + your input) at $0.15/M, plus ~15 output tokens at $0.60/M.
+
+| Calls / month | Cost    |
+|---------------|---------|
+| 100k          | $4      |
+| 10M           | $400    |
+| 1B            | $40,000 |
+
+The default `memoryCache` deduplicates byte-exact-match inputs within a process — significant savings on workloads with repeated inputs (log severity tags, predefined enums, boilerplate replies), little impact on free-form user content where every input is unique. The `Cache` extension point lets you back domovoi with any store for cross-process or persistent caching.
+
+Reach for deterministic tools instead when: syntactic problems with stable rules (URL parsing, format validation, tokenizers), very high volume with thin margins (100B+ ad impressions / day), or hard-real-time loops where a cache miss (~300ms p50) blows the SLA.
+
+---
+
 ## Calibration
 
 Three closed-form scaling factories from `@hourslabs/domovoi/calibration`:

package/dist/budget-tracker.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Running token-budget counter held inside a `ResolvedScope`. Shared across
+ * nested `domovoi.scope({...})` calls that inherit the parent's budget,
+ * which is why this is a class rather than a closure: the "shared mutable
+ * counter" model needs to be explicit.
+ *
+ * Two-phase enforcement:
+ *   - `precheck()` before each provider call — short-circuits if already
+ *     exhausted, so a runaway loop stops on its next iteration.
+ *   - `charge(tokens)` after each provider call — accumulates real spend.
+ *
+ * Default mode is `"graceful"`: when exhausted, the engine returns
+ * `Unknown { reason: { type: "budget_exceeded", spent, limit } }` instead
+ * of throwing. Users who want hard-fail semantics opt into `"throw"` mode.
+ *
+ * Honest contract: `precheck` measures "have we already exceeded?", not
+ * "would this call exceed?" — a single in-flight call can overshoot the
+ * limit by one call's worth of tokens. Tighter pre-charge enforcement
+ * (estimate via tokenizer before call) is possible but defer; document
+ * the overshoot in the README so users know.
+ */
+export type BudgetMode = "graceful" | "throw";
+export type ScopeBudget = {
+    readonly tokens?: number;
+    readonly onExceeded?: BudgetMode;
+};
+export type BudgetSnapshot = {
+    readonly spent: number;
+    readonly limit: number;
+    readonly mode: BudgetMode;
+};
+type PrecheckResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly spent: number;
+    readonly limit: number;
+};
+export declare class BudgetTracker {
+    private readonly limit;
+    readonly mode: BudgetMode;
+    private spent;
+    constructor(limit: number, mode: BudgetMode);
+    /**
+     * Build a tracker from a public `ScopeBudget`, or return `undefined` if
+     * the budget is absent / has no `tokens` field. Used during scope merge.
+     *
+     * Throws `ConfigError` if `tokens` is non-finite or non-positive — these
+     * are construction-time validation failures, not runtime budget exhaustion.
+     */
+    static from(budget: ScopeBudget | undefined): BudgetTracker | undefined;
+    /** Check whether the budget is already exhausted. Called pre-call. */
+    precheck(): PrecheckResult;
+    /**
+     * Accumulate spend. Called post-call with the actual token cost.
+     * Negative or non-finite values are silently clamped to 0 — provider
+     * adapters occasionally return malformed token counts, and a budget
+     * tracker shouldn't panic on bad telemetry from upstream.
+     */
+    charge(tokens: number): void;
+    /**
+     * Throw `BudgetExceededError` if mode is `"throw"` and budget is exhausted.
+     * Caller invokes after `charge()` to enforce hard-fail semantics; under
+     * `"graceful"` mode this is a no-op and the next `precheck()` returns
+     * `{ ok: false, ... }` for graceful Unknown construction.
+     */
+    enforce(): void;
+    snapshot(): BudgetSnapshot;
+    private isExhausted;
+}
+export {};
+//# sourceMappingURL=budget-tracker.d.ts.map

package/dist/budget-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-tracker.d.ts","sourceRoot":"","sources":["../src/budget-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B,CAAC;AAEF,KAAK,cAAc,GACf;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,qBAAa,aAAa;IAItB,OAAO,CAAC,QAAQ,CAAC,KAAK;aACN,IAAI,EAAE,UAAU;IAJlC,OAAO,CAAC,KAAK,CAAK;gBAGC,KAAK,EAAE,MAAM,EACd,IAAI,EAAE,UAAU;IAGlC;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS;IAWvE,sEAAsE;IACtE,QAAQ,IAAI,cAAc;IAO1B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B;;;;;OAKG;IACH,OAAO,IAAI,IAAI;IAMf,QAAQ,IAAI,cAAc;IAI1B,OAAO,CAAC,WAAW;CAGpB"}

package/dist/calibration/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/errors.ts","../../src/calibration/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Error taxonomy for domovoi.\n *\n * Four classes (`DomovoiError` base + `ProviderError`, `ConfigError`,\n * `BudgetExhaustedError`) with a stable `code` field for fine-grained\n * discrimination. All accept `{ cause }` for ES2022 chaining.\n *\n * The engine canonicalizes anything thrown from `Provider.sample` that isn't\n * already a `DomovoiError` into `ProviderError({ cause })`, so callers always\n * see a known error type. Under the default `onErrorPolicy: \"fallback\"`,\n * runtime errors become `Unknown` Verdict variants rather than throw;\n * `ConfigError` always throws.\n */\n\n/**\n * Stable error codes carried in `error.code`. Discriminate on these rather\n * than on `instanceof` of removed-historical subclasses.\n */\nexport type ErrorCode =\n  // ConfigError — construction-time\n  | \"decision_space_collision\"\n  | \"decision_space_too_large\"\n  | \"missing_provider_config\"\n  | \"malformed_provider_config\"\n  | \"unknown_provider_factory\"\n  | \"missing_credential\"\n  | \"incompatible_calibrator\"\n  | \"invalid_classifier_name\"\n  | \"invalid_thresholds\"\n  | \"invalid_space\"\n  | \"empty_providers\"\n  // ProviderError — runtime\n  | \"provider_network\"\n  | \"provider_rate_limit\"\n  | \"provider_timeout\"\n  | \"provider_unauthorized\"\n  | \"provider_server_error\"\n  | \"provider_malformed_response\"\n  | \"invalid_distribution\"\n  // BudgetExhaustedError — runtime\n  | \"per_call_timeout\"\n  | \"chain_timeout\"\n  | \"max_calls\";\n\nexport class DomovoiError extends Error {\n  readonly code: string;\n\n  constructor(message: string, options?: { code?: string; cause?: unknown }) {\n    super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = \"DomovoiError\";\n    this.code = options?.code ?? \"unspecified\";\n  }\n}\n\nexport class ProviderError extends DomovoiError {\n  constructor(message: string, options?: { code?: string; cause?: unknown }) {\n    super(message, options);\n    this.name = \"ProviderError\";\n  }\n}\n\nexport class ConfigError extends DomovoiError {\n  constructor(message: string, options?: { code?: string; cause?: unknown }) {\n    super(message, options);\n    this.name = \"ConfigError\";\n  }\n}\n\nexport class BudgetExhaustedError extends DomovoiError {\n  readonly attemptedProviders: readonly string[];\n  readonly elapsedMs: number;\n  readonly scope: \"per_call_timeout\" | \"chain_timeout\" | \"max_calls\";\n\n  constructor(\n    message: string,\n    options: {\n      scope: \"per_call_timeout\" | \"chain_timeout\" | \"max_calls\";\n      attemptedProviders: readonly string[];\n      elapsedMs: number;\n      cause?: unknown;\n    },\n  ) {\n    super(message, { code: options.scope, cause: options.cause });\n    this.name = \"BudgetExhaustedError\";\n    this.scope = options.scope;\n    this.attemptedProviders = options.attemptedProviders;\n    this.elapsedMs = options.elapsedMs;\n  }\n}\n\n/**\n * Wraps any non-DomovoiError thrown value in `ProviderError({ cause })`.\n * `DomovoiError` subtypes — including `ProviderError` subclasses defined by\n * external Provider implementations — pass through unchanged.\n */\nexport function canonicalizeProviderThrow(thrown: unknown): DomovoiError {\n  if (thrown instanceof DomovoiError) return thrown;\n  if (thrown instanceof Error) {\n    return new ProviderError(thrown.message || \"Provider call failed\", {\n      code: \"provider_network\",\n      cause: thrown,\n    });\n  }\n  return new ProviderError(String(thrown), {\n    code: \"provider_network\",\n    cause: thrown,\n  });\n}\n\n/**\n * Convert an Error to the JSON-safe shape stored in\n * `Verdict.meta.providerErrors`. Cause chains are preserved recursively.\n */\nexport function serializeError(err: unknown): {\n  readonly name: string;\n  readonly message: string;\n  readonly code?: string;\n  readonly cause?: ReturnType<typeof serializeError>;\n  readonly stack?: string;\n} {\n  if (!(err instanceof Error)) {\n    return { name: \"Error\", message: String(err) };\n  }\n  const code = err instanceof DomovoiError ? err.code : undefined;\n  const cause = err.cause !== undefined ? serializeError(err.cause) : undefined;\n  return {\n    name: err.name,\n    message: err.message,\n    ...(code !== undefined ? { code } : {}),\n    ...(cause !== undefined ? { cause } : {}),\n    ...(err.stack !== undefined ? { stack: err.stack } : {}),\n  };\n}\n","/**\n * Built-in calibrator factories.\n *\n *   - `identity` — pass-through; the default.\n *   - `temperatureScaling(T)` — `p^(1/T) / Σ p_j^(1/T)`; equivalent to\n *     scaling logits before softmax.\n *   - `plattScaling({ a, b })` — sigmoid scaling; binary spaces only.\n *\n * `Calibrator.apply` must be pure and stateless. The engine runs it\n * per-caller after the Distribution is loaded from the cache, so impurity\n * would leak across callers sharing a cache row.\n */\n\nimport { ConfigError } from \"../errors.js\";\nimport type { Distribution } from \"../types.js\";\n\nexport interface Calibrator {\n  /** Identifier; `\"identity\"` is reserved and recognized by the engine. */\n  readonly kind: string;\n  apply<T extends string>(d: Distribution<T>): Distribution<T>;\n}\n\nexport const identity: Calibrator = {\n  kind: \"identity\",\n  apply<T extends string>(d: Distribution<T>): Distribution<T> {\n    return d;\n  },\n};\n\n/**\n *   - `T = 1` → identity.\n *   - `T > 1` → softens (less peaked).\n *   - `T < 1` → sharpens (more peaked).\n *\n * Operates on probabilities (not logits) and leaves `coverage` unchanged.\n * Throws `ConfigError` on `T <= 0`.\n *\n * @example\n *   calibrator: temperatureScaling(0.85)  // user-fit on held-out eval set\n */\nexport function temperatureScaling(T: number): Calibrator {\n  if (Number.isNaN(T) || T <= 0) {\n    throw new ConfigError(`temperatureScaling(T): T must be > 0; got ${T}.`, {\n      code: \"incompatible_calibrator\",\n    });\n  }\n  const inverseT = 1 / T;\n  return {\n    kind: \"temperature\",\n    apply<U extends string>(d: Distribution<U>): Distribution<U> {\n      const scaledEntries = (Object.entries(d.probs) as [string, number][]).map(\n        ([label, prob]) => [label, prob === 0 ? 0 : prob ** inverseT] as const,\n      );\n      const partitionFn = scaledEntries.reduce(\n        (running, [, scaledProb]) => running + scaledProb,\n        0,\n      );\n      // Degenerate input (every prob is 0) — return as-is rather than divide by 0.\n      if (partitionFn === 0) return d;\n      const normalizedProbs = Object.fromEntries(\n        scaledEntries.map(([label, scaledProb]) => [label, scaledProb / partitionFn] as const),\n      );\n      return {\n        probs: normalizedProbs as Distribution<U>[\"probs\"],\n        coverage: d.coverage,\n      };\n    },\n  };\n}\n\n/**\n * Platt scaling: `sigmoid(a*z + b)` where `z = logit(p_pos)`.\n *\n * Binary-only — the second label in the distribution (in user-given order)\n * is treated as the positive class. Construction-time space-size validation\n * happens in the classifier; `apply()` re-checks at runtime as a defensive\n * guard against direct misuse.\n */\nexport function plattScaling(params: { a: number; b: number }): Calibrator {\n  if (\n    Number.isNaN(params.a) ||\n    Number.isNaN(params.b) ||\n    !Number.isFinite(params.a) ||\n    !Number.isFinite(params.b)\n  ) {\n    throw new ConfigError(\n      `plattScaling({ a, b }): a and b must be finite numbers; got a=${params.a}, b=${params.b}.`,\n      { code: \"incompatible_calibrator\" },\n    );\n  }\n  return {\n    kind: \"platt\",\n    apply<U extends string>(d: Distribution<U>): Distribution<U> {\n      const labels = Object.keys(d.probs);\n      if (labels.length !== 2) {\n        throw new ConfigError(\n          `plattScaling is binary-only; got distribution with ${labels.length} labels.`,\n          { code: \"incompatible_calibrator\" },\n        );\n      }\n      const [neg, pos] = labels as [string, string];\n      const probs = d.probs as Record<string, number>;\n      const pPos = probs[pos] ?? 0;\n      // Clamp away from {0, 1} so `Math.log(p / (1 - p))` is finite.\n      const eps = 1e-9;\n      const clamped = Math.min(1 - eps, Math.max(eps, pPos));\n      const logit = Math.log(clamped / (1 - clamped));\n      const calibratedPos = sigmoid(params.a * logit + params.b);\n      return {\n        probs: {\n          [neg]: 1 - calibratedPos,\n          [pos]: calibratedPos,\n        } as Distribution<U>[\"probs\"],\n        coverage: d.coverage,\n      };\n    },\n  };\n}\n\nfunction sigmoid(x: number): number {\n  return 1 / (1 + Math.exp(-x));\n}\n\nexport function isIdentityCalibrator(c: Calibrator): boolean {\n  return c.kind === \"identity\";\n}\n"]}
+{"version":3,"sources":["../../src/errors.ts","../../src/calibration/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Error taxonomy for domovoi.\n *\n * Four classes (`DomovoiError` base + `ProviderError`, `ConfigError`,\n * `BudgetExhaustedError`) with a stable `code` field for fine-grained\n * discrimination. All accept `{ cause }` for ES2022 chaining.\n *\n * The engine canonicalizes anything thrown from `Provider.sample` that isn't\n * already a `DomovoiError` into `ProviderError({ cause })`, so callers always\n * see a known error type. Under the default `onErrorPolicy: \"fallback\"`,\n * runtime errors become `Unknown` Verdict variants rather than throw;\n * `ConfigError` always throws.\n */\n\n/**\n * Stable error codes carried in `error.code`. Discriminate on these rather\n * than on `instanceof` of removed-historical subclasses.\n */\nexport type ErrorCode =\n  // ConfigError — construction-time\n  | \"decision_space_collision\"\n  | \"decision_space_too_large\"\n  | \"missing_provider_config\"\n  | \"malformed_provider_config\"\n  | \"unknown_provider_factory\"\n  | \"missing_credential\"\n  | \"incompatible_calibrator\"\n  | \"invalid_classifier_name\"\n  | \"invalid_thresholds\"\n  | \"invalid_space\"\n  | \"empty_providers\"\n  // ProviderError — runtime\n  | \"provider_network\"\n  | \"provider_rate_limit\"\n  | \"provider_timeout\"\n  | \"provider_unauthorized\"\n  | \"provider_server_error\"\n  | \"provider_malformed_response\"\n  | \"invalid_distribution\"\n  // BudgetExhaustedError — runtime (operational: time / call-count)\n  | \"per_call_timeout\"\n  | \"chain_timeout\"\n  | \"max_calls\"\n  // BudgetExceededError — runtime (scope token budget)\n  | \"tokens_exceeded\"\n  // ConfigError — scope budget validation\n  | \"invalid_scope_budget\";\n\nexport class DomovoiError extends Error {\n  readonly code: string;\n\n  constructor(message: string, options?: { code?: string; cause?: unknown }) {\n    super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = \"DomovoiError\";\n    this.code = options?.code ?? \"unspecified\";\n  }\n}\n\nexport class ProviderError extends DomovoiError {\n  constructor(message: string, options?: { code?: string; cause?: unknown }) {\n    super(message, options);\n    this.name = \"ProviderError\";\n  }\n}\n\nexport class ConfigError extends DomovoiError {\n  constructor(message: string, options?: { code?: string; cause?: unknown }) {\n    super(message, options);\n    this.name = \"ConfigError\";\n  }\n}\n\nexport class BudgetExhaustedError extends DomovoiError {\n  readonly attemptedProviders: readonly string[];\n  readonly elapsedMs: number;\n  readonly scope: \"per_call_timeout\" | \"chain_timeout\" | \"max_calls\";\n\n  constructor(\n    message: string,\n    options: {\n      scope: \"per_call_timeout\" | \"chain_timeout\" | \"max_calls\";\n      attemptedProviders: readonly string[];\n      elapsedMs: number;\n      cause?: unknown;\n    },\n  ) {\n    super(message, { code: options.scope, cause: options.cause });\n    this.name = \"BudgetExhaustedError\";\n    this.scope = options.scope;\n    this.attemptedProviders = options.attemptedProviders;\n    this.elapsedMs = options.elapsedMs;\n  }\n}\n\n/**\n * Thrown when scope token budget is exceeded under `onExceeded: \"throw\"` mode.\n * Distinct from `BudgetExhaustedError` (operational time / call-count budgets):\n * this is the cost ceiling for a `domovoi.scope({ budget: { tokens } })` block.\n *\n * Default mode is `\"graceful\"` — classify returns\n * `Unknown { reason: { type: \"budget_exceeded\", spent, limit } }` instead.\n */\nexport class BudgetExceededError extends DomovoiError {\n  readonly spent: number;\n  readonly limit: number;\n\n  constructor(options: { spent: number; limit: number; cause?: unknown }) {\n    super(`Scope budget exceeded: ${options.spent} / ${options.limit} tokens`, {\n      code: \"tokens_exceeded\",\n      cause: options.cause,\n    });\n    this.name = \"BudgetExceededError\";\n    this.spent = options.spent;\n    this.limit = options.limit;\n  }\n}\n\n/**\n * Wraps any non-DomovoiError thrown value in `ProviderError({ cause })`.\n * `DomovoiError` subtypes — including `ProviderError` subclasses defined by\n * external Provider implementations — pass through unchanged.\n */\nexport function canonicalizeProviderThrow(thrown: unknown): DomovoiError {\n  if (thrown instanceof DomovoiError) return thrown;\n  if (thrown instanceof Error) {\n    return new ProviderError(thrown.message || \"Provider call failed\", {\n      code: \"provider_network\",\n      cause: thrown,\n    });\n  }\n  return new ProviderError(String(thrown), {\n    code: \"provider_network\",\n    cause: thrown,\n  });\n}\n\n/**\n * Convert an Error to the JSON-safe shape stored in\n * `Verdict.meta.providerErrors`. Cause chains are preserved recursively.\n */\nexport function serializeError(err: unknown): {\n  readonly name: string;\n  readonly message: string;\n  readonly code?: string;\n  readonly cause?: ReturnType<typeof serializeError>;\n  readonly stack?: string;\n} {\n  if (!(err instanceof Error)) {\n    return { name: \"Error\", message: String(err) };\n  }\n  const code = err instanceof DomovoiError ? err.code : undefined;\n  const cause = err.cause !== undefined ? serializeError(err.cause) : undefined;\n  return {\n    name: err.name,\n    message: err.message,\n    ...(code !== undefined ? { code } : {}),\n    ...(cause !== undefined ? { cause } : {}),\n    ...(err.stack !== undefined ? { stack: err.stack } : {}),\n  };\n}\n","/**\n * Built-in calibrator factories.\n *\n *   - `identity` — pass-through; the default.\n *   - `temperatureScaling(T)` — `p^(1/T) / Σ p_j^(1/T)`; equivalent to\n *     scaling logits before softmax.\n *   - `plattScaling({ a, b })` — sigmoid scaling; binary spaces only.\n *\n * `Calibrator.apply` must be pure and stateless. The engine runs it\n * per-caller after the Distribution is loaded from the cache, so impurity\n * would leak across callers sharing a cache row.\n */\n\nimport { ConfigError } from \"../errors.js\";\nimport type { Distribution } from \"../types.js\";\n\nexport interface Calibrator {\n  /** Identifier; `\"identity\"` is reserved and recognized by the engine. */\n  readonly kind: string;\n  apply<T extends string>(d: Distribution<T>): Distribution<T>;\n}\n\nexport const identity: Calibrator = {\n  kind: \"identity\",\n  apply<T extends string>(d: Distribution<T>): Distribution<T> {\n    return d;\n  },\n};\n\n/**\n *   - `T = 1` → identity.\n *   - `T > 1` → softens (less peaked).\n *   - `T < 1` → sharpens (more peaked).\n *\n * Operates on probabilities (not logits) and leaves `coverage` unchanged.\n * Throws `ConfigError` on `T <= 0`.\n *\n * @example\n *   calibrator: temperatureScaling(0.85)  // user-fit on held-out eval set\n */\nexport function temperatureScaling(T: number): Calibrator {\n  if (Number.isNaN(T) || T <= 0) {\n    throw new ConfigError(`temperatureScaling(T): T must be > 0; got ${T}.`, {\n      code: \"incompatible_calibrator\",\n    });\n  }\n  const inverseT = 1 / T;\n  return {\n    kind: \"temperature\",\n    apply<U extends string>(d: Distribution<U>): Distribution<U> {\n      const scaledEntries = (Object.entries(d.probs) as [string, number][]).map(\n        ([label, prob]) => [label, prob === 0 ? 0 : prob ** inverseT] as const,\n      );\n      const partitionFn = scaledEntries.reduce(\n        (running, [, scaledProb]) => running + scaledProb,\n        0,\n      );\n      // Degenerate input (every prob is 0) — return as-is rather than divide by 0.\n      if (partitionFn === 0) return d;\n      const normalizedProbs = Object.fromEntries(\n        scaledEntries.map(([label, scaledProb]) => [label, scaledProb / partitionFn] as const),\n      );\n      return {\n        probs: normalizedProbs as Distribution<U>[\"probs\"],\n        coverage: d.coverage,\n      };\n    },\n  };\n}\n\n/**\n * Platt scaling: `sigmoid(a*z + b)` where `z = logit(p_pos)`.\n *\n * Binary-only — the second label in the distribution (in user-given order)\n * is treated as the positive class. Construction-time space-size validation\n * happens in the classifier; `apply()` re-checks at runtime as a defensive\n * guard against direct misuse.\n */\nexport function plattScaling(params: { a: number; b: number }): Calibrator {\n  if (\n    Number.isNaN(params.a) ||\n    Number.isNaN(params.b) ||\n    !Number.isFinite(params.a) ||\n    !Number.isFinite(params.b)\n  ) {\n    throw new ConfigError(\n      `plattScaling({ a, b }): a and b must be finite numbers; got a=${params.a}, b=${params.b}.`,\n      { code: \"incompatible_calibrator\" },\n    );\n  }\n  return {\n    kind: \"platt\",\n    apply<U extends string>(d: Distribution<U>): Distribution<U> {\n      const labels = Object.keys(d.probs);\n      if (labels.length !== 2) {\n        throw new ConfigError(\n          `plattScaling is binary-only; got distribution with ${labels.length} labels.`,\n          { code: \"incompatible_calibrator\" },\n        );\n      }\n      const [neg, pos] = labels as [string, string];\n      const probs = d.probs as Record<string, number>;\n      const pPos = probs[pos] ?? 0;\n      // Clamp away from {0, 1} so `Math.log(p / (1 - p))` is finite.\n      const eps = 1e-9;\n      const clamped = Math.min(1 - eps, Math.max(eps, pPos));\n      const logit = Math.log(clamped / (1 - clamped));\n      const calibratedPos = sigmoid(params.a * logit + params.b);\n      return {\n        probs: {\n          [neg]: 1 - calibratedPos,\n          [pos]: calibratedPos,\n        } as Distribution<U>[\"probs\"],\n        coverage: d.coverage,\n      };\n    },\n  };\n}\n\nfunction sigmoid(x: number): number {\n  return 1 / (1 + Math.exp(-x));\n}\n\nexport function isIdentityCalibrator(c: Calibrator): boolean {\n  return c.kind === \"identity\";\n}\n"]}

package/dist/context-storage.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `ContextStorage<T>` — pluggable extension point for `domovoi.scope`'s
+ * ambient state. Default implementation wraps Node's
+ * `node:async_hooks.AsyncLocalStorage`, which works on Node 16+,
+ * Cloudflare Workers (with the `nodejs_compat` flag, since 2024), and
+ * Deno (native).
+ *
+ * Browser users or exotic runtimes call `configureContextStorage(custom)`
+ * at boot to swap the default. The interface mirrors `AsyncLocalStorage`
+ * minus methods domovoi doesn't need (`enterWith`, `disable`, etc.).
+ *
+ * `getContextStorage()` returns the *currently configured* storage —
+ * tests mutate it via `configureContextStorage` and reset between cases.
+ *
+ * Resolution semantics: `run` shadows nested scopes fully. There is no
+ * implicit merge — the engine's `mergeScopes()` (in `scope.ts`) builds the
+ * `ResolvedScope` value that `run` stores, so nested inheritance behavior
+ * lives in scope-merge logic, not in the context storage layer.
+ */
+import type { ResolvedScope } from "./scope.js";
+export interface ContextStorage<T> {
+    /** Run `fn` with `value` as the active store. Restored on return/throw. */
+    run<R>(value: T, fn: () => R | Promise<R>): R | Promise<R>;
+    /** Read the active store, or `undefined` if no enclosing `run()`. */
+    getStore(): T | undefined;
+}
+export declare function getContextStorage(): ContextStorage<ResolvedScope>;
+/**
+ * Replace the default `AsyncLocalStorage`-backed storage with a custom
+ * implementation. Call once at boot, before any `domovoi.scope(...)` runs.
+ *
+ * Use cases:
+ *   - browser runtimes without `node:async_hooks`
+ *   - test harnesses that need deterministic single-tenant state
+ *   - custom propagation layers (cross-process, queue handlers with their
+ *     own context system)
+ */
+export declare function configureContextStorage(custom: ContextStorage<ResolvedScope>): void;
+/**
+ * Reset to the default `AsyncLocalStorage`-backed storage. Test-only
+ * affordance — production code should not need this.
+ */
+export declare function resetContextStorage(): void;
+//# sourceMappingURL=context-storage.d.ts.map

package/dist/context-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-storage.d.ts","sourceRoot":"","sources":["../src/context-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,2EAA2E;IAC3E,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3D,qEAAqE;IACrE,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC;CAC3B;AAID,wBAAgB,iBAAiB,IAAI,cAAc,CAAC,aAAa,CAAC,CAEjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,CAAC,aAAa,CAAC,GAAG,IAAI,CAEnF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/engine/decide.d.ts

@@ -11,6 +11,15 @@
  * Errors during the chain become `Unknown` Verdicts under the default
  * `onErrorPolicy: "fallback"`; under `"throw"` they propagate as
  * `BudgetExhaustedError` / `AbortError` / `AggregateError`.
+ *
+ * v0.2 ambient context (via `domovoi.scope`):
+ *   - reads `currentScope()` at entry
+ *   - merges scope signal into per-call merged signal
+ *   - pre-checks scope budget before each provider attempt; returns
+ *     `Unknown { budget_exceeded }` (graceful) or throws
+ *     `BudgetExceededError` (mode: "throw") on exhaustion
+ *   - charges scope budget after each provider call (post-call estimate)
+ *   - emits one OTel-shaped span per provider attempt via `scope.tracer`
  */
 import type { Verdict } from "../types.js";
 import { type DecideConfig } from "./config.js";

package/dist/engine/decide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../src/engine/decide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAgD,OAAO,EAAE,MAAM,aAAa,CAAC;AAGzF,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAYrB,wBAAsB,MAAM,CAAC,CAAC,SAAS,MAAM,EAC3C,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CA8DrB"}
+{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../src/engine/decide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,OAAO,KAAK,EAAgD,OAAO,EAAE,MAAM,aAAa,CAAC;AAGzF,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAiBrB,wBAAsB,MAAM,CAAC,CAAC,SAAS,MAAM,EAC3C,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAgFrB"}

package/dist/engine/distribution.d.ts

@@ -8,7 +8,7 @@ import type { Distribution } from "../types.js";
 import { type DecideConfig } from "./config.js";
 import type { MetaBuilder } from "./meta.js";
 export declare function computeProviderCacheKey<T extends string>(provider: Provider, formattedInput: string, config: DecideConfig<T>): string;
-export declare function mergeSignals(userSignal: AbortSignal | undefined, timeoutSignal: AbortSignal): AbortSignal;
+export declare function mergeSignals(userSignal: AbortSignal | undefined, timeoutSignal: AbortSignal, scopeSignal?: AbortSignal): AbortSignal;
 export declare function loadDistribution<T extends string>(provider: Provider, formattedInput: string, config: DecideConfig<T>, meta: MetaBuilder, signal: AbortSignal, cacheKey: string): Promise<Distribution<T>>;
 /**
  * Drop the in-flight slot for a key after a failed sample so a concurrent

package/dist/engine/distribution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../src/engine/distribution.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAS7C,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EACtD,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,MAAM,CAWR;AAED,wBAAgB,YAAY,CAC1B,UAAU,EAAE,WAAW,GAAG,SAAS,EACnC,aAAa,EAAE,WAAW,GACzB,WAAW,CAIb;AAED,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EACrD,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAa1B;AAmBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAErD"}
+{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../src/engine/distribution.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAS7C,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EACtD,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,MAAM,CAWR;AAED,wBAAgB,YAAY,CAC1B,UAAU,EAAE,WAAW,GAAG,SAAS,EACnC,aAAa,EAAE,WAAW,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,WAAW,CAKb;AAED,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EACrD,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAa1B;AAmBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAErD"}

package/dist/engine/finalize.d.ts

@@ -3,10 +3,17 @@
  * chain-budget exhaustion, pre/mid-loop cancellation, and chain-exhausted
  * (every-provider-errored vs last-provider-uncertain).
  */
+import type { BudgetMode } from "../budget-tracker.js";
 import type { Distribution, Unknown, Verdict } from "../types.js";
 import type { DecideConfig } from "./config.js";
 import { type MetaBuilder } from "./meta.js";
 export declare function checkChainBudget<T extends string>(meta: MetaBuilder, chainStartMs: number, chainTimeoutMs: number, config: DecideConfig<T>): Unknown<T> | undefined;
 export declare function makeCancelledFromMeta<T extends string>(meta: MetaBuilder, reason: string): Unknown<T>;
+/**
+ * Build the terminal verdict for scope-budget exhaustion. Under
+ * `BudgetMode.graceful` returns `Unknown { budget_exceeded }`; under
+ * `"throw"` mode throws `BudgetExceededError` for the caller to handle.
+ */
+export declare function makeBudgetExceededVerdict<T extends string>(meta: MetaBuilder, spent: number, limit: number, mode: BudgetMode): Unknown<T>;
 export declare function finalizeChainExhausted<T extends string>(meta: MetaBuilder, lastCalibrated: Distribution<T> | undefined, attempts: number, config: DecideConfig<T>): Verdict<T>;
 //# sourceMappingURL=finalize.d.ts.map

package/dist/engine/finalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../src/engine/finalize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAElE,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAUxB;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACpD,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,CAAC,CAMZ;AAED,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACrD,IAAI,EAAE,WAAW,EACjB,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,EAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,CAAC,CAAC,CAqCZ"}
+{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../src/engine/finalize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAElE,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAUxB;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACpD,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,CAAC,CAMZ;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,EACxD,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,CAAC,CAAC,CASZ;AAED,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACrD,IAAI,EAAE,WAAW,EACjB,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,EAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,CAAC,CAAC,CAqCZ"}

package/dist/errors.d.ts

@@ -15,7 +15,7 @@
  * Stable error codes carried in `error.code`. Discriminate on these rather
  * than on `instanceof` of removed-historical subclasses.
  */
-export type ErrorCode = "decision_space_collision" | "decision_space_too_large" | "missing_provider_config" | "malformed_provider_config" | "unknown_provider_factory" | "missing_credential" | "incompatible_calibrator" | "invalid_classifier_name" | "invalid_thresholds" | "invalid_space" | "empty_providers" | "provider_network" | "provider_rate_limit" | "provider_timeout" | "provider_unauthorized" | "provider_server_error" | "provider_malformed_response" | "invalid_distribution" | "per_call_timeout" | "chain_timeout" | "max_calls";
+export type ErrorCode = "decision_space_collision" | "decision_space_too_large" | "missing_provider_config" | "malformed_provider_config" | "unknown_provider_factory" | "missing_credential" | "incompatible_calibrator" | "invalid_classifier_name" | "invalid_thresholds" | "invalid_space" | "empty_providers" | "provider_network" | "provider_rate_limit" | "provider_timeout" | "provider_unauthorized" | "provider_server_error" | "provider_malformed_response" | "invalid_distribution" | "per_call_timeout" | "chain_timeout" | "max_calls" | "tokens_exceeded" | "invalid_scope_budget";
 export declare class DomovoiError extends Error {
     readonly code: string;
     constructor(message: string, options?: {
@@ -46,6 +46,23 @@ export declare class BudgetExhaustedError extends DomovoiError {
         cause?: unknown;
     });
 }
+/**
+ * Thrown when scope token budget is exceeded under `onExceeded: "throw"` mode.
+ * Distinct from `BudgetExhaustedError` (operational time / call-count budgets):
+ * this is the cost ceiling for a `domovoi.scope({ budget: { tokens } })` block.
+ *
+ * Default mode is `"graceful"` — classify returns
+ * `Unknown { reason: { type: "budget_exceeded", spent, limit } }` instead.
+ */
+export declare class BudgetExceededError extends DomovoiError {
+    readonly spent: number;
+    readonly limit: number;
+    constructor(options: {
+        spent: number;
+        limit: number;
+        cause?: unknown;
+    });
+}
 /**
  * Wraps any non-DomovoiError thrown value in `ProviderError({ cause })`.
  * `DomovoiError` subtypes — including `ProviderError` subclasses defined by

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;GAGG;AACH,MAAM,MAAM,SAAS,GAEjB,0BAA0B,GAC1B,0BAA0B,GAC1B,yBAAyB,GACzB,2BAA2B,GAC3B,0BAA0B,GAC1B,oBAAoB,GACpB,yBAAyB,GACzB,yBAAyB,GACzB,oBAAoB,GACpB,eAAe,GACf,iBAAiB,GAEjB,kBAAkB,GAClB,qBAAqB,GACrB,kBAAkB,GAClB,uBAAuB,GACvB,uBAAuB,GACvB,6BAA6B,GAC7B,sBAAsB,GAEtB,kBAAkB,GAClB,eAAe,GACf,WAAW,CAAC;AAEhB,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAK1E;AAED,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI1E;AAED,qBAAa,WAAY,SAAQ,YAAY;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI1E;AAED,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,eAAe,GAAG,WAAW,CAAC;gBAGjE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,KAAK,EAAE,kBAAkB,GAAG,eAAe,GAAG,WAAW,CAAC;QAC1D,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;QACtC,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAQJ;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,CAYvE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAaA"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;GAGG;AACH,MAAM,MAAM,SAAS,GAEjB,0BAA0B,GAC1B,0BAA0B,GAC1B,yBAAyB,GACzB,2BAA2B,GAC3B,0BAA0B,GAC1B,oBAAoB,GACpB,yBAAyB,GACzB,yBAAyB,GACzB,oBAAoB,GACpB,eAAe,GACf,iBAAiB,GAEjB,kBAAkB,GAClB,qBAAqB,GACrB,kBAAkB,GAClB,uBAAuB,GACvB,uBAAuB,GACvB,6BAA6B,GAC7B,sBAAsB,GAEtB,kBAAkB,GAClB,eAAe,GACf,WAAW,GAEX,iBAAiB,GAEjB,sBAAsB,CAAC;AAE3B,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAK1E;AAED,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI1E;AAED,qBAAa,WAAY,SAAQ,YAAY;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI1E;AAED,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,eAAe,GAAG,WAAW,CAAC;gBAGjE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,KAAK,EAAE,kBAAkB,GAAG,eAAe,GAAG,WAAW,CAAC;QAC1D,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;QACtC,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAQJ;AAED;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CASvE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,CAYvE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAaA"}