@ultimat3/ai 5.0.1 → 7.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/ai",
-  "version": "5.0.1",
+  "version": "7.0.0",
   "description": "LLM gateway, versioned prompts, evals as tests, embeddings, hybrid vector search, RAG",
   "license": "MIT",
   "type": "module",
@@ -32,14 +32,14 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/action": "5.0.1",
-    "@ultimat3/cache": "5.0.1",
-    "@ultimat3/core": "5.0.1",
-    "@ultimat3/db": "5.0.1",
-    "@ultimat3/jobs": "5.0.1",
-    "@ultimat3/money": "5.0.1",
-    "@ultimat3/policy": "5.0.1",
-    "@ultimat3/schema": "5.0.1",
-    "@ultimat3/time": "5.0.1"
+    "@ultimat3/action": "7.0.0",
+    "@ultimat3/cache": "7.0.0",
+    "@ultimat3/core": "7.0.0",
+    "@ultimat3/db": "7.0.0",
+    "@ultimat3/jobs": "7.0.0",
+    "@ultimat3/money": "7.0.0",
+    "@ultimat3/policy": "7.0.0",
+    "@ultimat3/schema": "7.0.0",
+    "@ultimat3/time": "7.0.0"
   }
 }

package/src/budget.ts

@@ -4,12 +4,13 @@
 // wrong answer that looks like a real one, and the caller has no signal anything happened.
 // A thrown X_AI_BUDGET_EXCEEDED with the remaining count is strictly more useful.
 //
-// The carrier is an AsyncLocalStorage so nested calls (a RAG retrieval, a tool call that
-// generates, an eval judge) all debit the same ledger without threading it through every
-// signature. `node:async_hooks` is used directly because Bun implements it natively and the
-// framework's ALS context is established at the HTTP boundary, above this package.
+// The carrier is an async context so nested calls (a RAG retrieval, a tool call that generates,
+// an eval judge) all debit the same ledger without threading it through every signature. It opens
+// through `@ultimat3/core`'s one lazy seam rather than constructing an `AsyncLocalStorage` here: a
+// module-scope `new` threw at EVALUATION in a browser bundle, where the bundler stubs
+// `node:async_hooks` to `{}`, and took every importer of `@ultimat3/ai` with it.
 
-import { AsyncLocalStorage } from 'node:async_hooks';
+import { asyncContext } from '@ultimat3/core';
 import type { Money } from '@ultimat3/money';
 import { assertSameCurrency } from '@ultimat3/money';
 import { AiBudgetExceededError } from './errors';
@@ -307,7 +308,7 @@ function tighterMoney(a: Money | undefined, b: Money | undefined): Money | undef
   return a.minor <= b.minor ? a : b;
 }
 
-const storage = new AsyncLocalStorage<BudgetLedger>();
+const storage = asyncContext<BudgetLedger>('an AI budget');
 
 /** Run `fn` with `ledger` as the ambient budget for everything it awaits. */
 export function withBudget<T>(ledger: BudgetLedger, fn: () => Promise<T>): Promise<T> {
@@ -316,5 +317,5 @@ export function withBudget<T>(ledger: BudgetLedger, fn: () => Promise<T>): Promi
 
 /** The ambient ledger, or `undefined` outside a budget scope (spend is then unmetered). */
 export function currentBudget(): BudgetLedger | undefined {
-  return storage.getStore();
+  return storage.get();
 }

package/src/llm-stream.ts

@@ -21,7 +21,7 @@
  *     async chain — abandoning the iterator stops delivery, never the accounting.
  */
 
-import { AsyncLocalStorage } from 'node:async_hooks';
+import { asyncContext } from '@ultimat3/core';
 import { AiTransportError } from './errors';
 import type { Gateway } from './gateway';
 import type { GenerateRequest, GenerateResult } from './provider';
@@ -102,7 +102,9 @@ export class LlmSink {
   }
 }
 
-const sinks = new AsyncLocalStorage<LlmSink>();
+// Core's one lazy seam, never a construction here: a module-scope `new` threw at EVALUATION in a
+// browser bundle, where the bundler stubs `node:async_hooks` to `{}`.
+const sinks = asyncContext<LlmSink>('an LLM stream sink');
 
 /** Mark everything `fn` awaits as a streamed invocation. */
 export function withLlmSink<T>(sink: LlmSink, fn: () => Promise<T>): Promise<T> {
@@ -111,7 +113,7 @@ export function withLlmSink<T>(sink: LlmSink, fn: () => Promise<T>): Promise<T>
 
 /** The sink of the streamed invocation this call belongs to, or `undefined` for a plain one. */
 export function currentLlmSink(): LlmSink | undefined {
-  return sinks.getStore();
+  return sinks.get();
 }
 
 /**