@graphrefly/graphrefly 0.29.0 → 0.31.0

package/dist/{index-BqZ6vB2A.d.ts → index-Bd6oFZqO.d.ts}

@@ -1,25 +1,24 @@
-import { T as TokenUsage, L as LLMAdapter, P as PricingFn, C as ChatMessage, a as LLMInvokeOptions, d as ToolDefinition, b as LLMResponse, c as ToolCall, e as CapabilitiesRegistry, M as ModelCapabilities, f as ModelFeatures, g as ModelLimits, h as ModelPricing, i as PriceBreakdown, j as PricingRegistry, R as Rate, S as StreamDelta, k as TieredRate, l as composePricing, m as computePrice, n as createCapabilitiesRegistry, o as createPricingRegistry, r as registryPricing, z as zeroPrice } from './types-u64Ose53.js';
-import { a as CascadeExhaustionReport, A as AdapterProvider, b as AdapterTier, d as AllTiersExhaustedError, C as CascadingLlmAdapterOptions, e as CreateAdapterOptions, O as OpenAICompatAdapterOptions, f as OpenAICompatPreset, g as OpenAISdkLike, h as cascadingLlmAdapter, c as createAdapter, o as openAICompatAdapter } from './cascading-Bp99ckMJ.js';
-import { a as Node, A as Actor } from './node-Dd6wHSib.js';
-import { R as ReactiveLogBundle } from './reactive-log-1QTyx10a.js';
-import { a as CircuitBreakerOptions, e as CircuitBreaker, f as CircuitOpenError } from './resilience-CBfYJW5C.js';
+import { T as TokenUsage, L as LLMAdapter, P as PricingFn, C as ChatMessage, a as LLMInvokeOptions, d as ToolDefinition, b as LLMResponse, S as StreamDelta, c as ToolCall, e as CapabilitiesRegistry, M as ModelCapabilities, f as ModelFeatures, g as ModelLimits, h as ModelPricing, i as PriceBreakdown, j as PricingRegistry, R as Rate, k as TieredRate, l as composePricing, m as computePrice, n as createCapabilitiesRegistry, o as createPricingRegistry, p as pricingFor, r as registryPricing, z as zeroPrice } from './types-CdfO2QTt.js';
+import { a as CascadeExhaustionReport, A as AdapterProvider, b as AdapterTier, d as AllTiersExhaustedError, C as CascadingLlmAdapterOptions, e as CreateAdapterOptions, O as OpenAICompatAdapterOptions, f as OpenAICompatPreset, g as OpenAISdkLike, h as cascadingLlmAdapter, c as createAdapter, o as openAICompatAdapter, t as tier } from './cascading-D3sapjue.js';
+import { a as Node, A as Actor } from './node-BVV7G1bq.js';
+import { R as ReactiveLogBundle } from './reactive-log-BOJDCI5x.js';
+import { a as CircuitBreakerOptions, e as CircuitBreaker, f as CircuitOpenError } from './resilience-CludlzcP.js';
 import { NodeInput } from './extra/sources.js';
-import { F as FallbackAdapterOptions, a as FallbackFixture, b as FallbackMissError, c as FallbackMissPolicy, R as ReplayCacheKeyContext, d as ReplayCacheMissError, e as ReplayCacheMode, W as WithReplayCacheOptions, f as canonicalJson, g as fallbackAdapter, w as withReplayCache } from './fallback-eOm3LNxP.js';
-import { G as Graph, a as GraphOptions, h as GraphAttachStorageOptions } from './graph-Qjg9gWHI.js';
-import { T as TopicGraph } from './index-DuB5aO4-.js';
-import { G as GateController, a as GateOptions } from './index-DJ5oNBc8.js';
-import { D as DistillBundle, E as Extraction } from './composite-BL-llbnE.js';
-import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-DCeTyFlB.js';
+import { W as WithReplayCacheOptions, F as FallbackAdapterOptions, a as FallbackFixture, b as FallbackMissError, c as FallbackMissPolicy, R as ReplayCacheKeyContext, d as ReplayCacheMissError, e as ReplayCacheMode, f as canonicalJson, g as fallbackAdapter, w as withReplayCache } from './fallback-DRjJ_ZM8.js';
+import { G as Graph, a as GraphOptions, h as GraphAttachStorageOptions } from './graph-CWeI0aHd.js';
+import { T as TopicGraph } from './index-CvS9IuTG.js';
+import { G as GateController, a as GateOptions } from './index-CFW32Dy1.js';
+import { D as DistillBundle, E as Extraction } from './composite-BY9hMxN7.js';
+import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-DnrZghBB.js';
 import { StorageHandle, StorageTier } from './extra/storage-core.js';
+import { c as GraphSpecCatalog } from './index-CcS0t-l2.js';
 
 /**
  * Observable adapter wrapper — the "inverted statistics" surface.
  *
  * The library emits structured facts (token counts, latency, timestamps)
  * as reactive nodes. Users compose interpretation (pricing, dashboards,
- * telemetry, budget breakers) as derived layers on top. Rationale lives in
- * `archive/docs/SESSION-rigor-infrastructure-plan.md` §"v2: reactive LLM
- * statistics + pluggable pricing".
+ * telemetry, budget breakers) as derived layers on top.
  */
 
 /** One call's structured statistics — emitted after `invoke()` / `stream()` settles. */
@@ -58,20 +57,28 @@ interface AdapterStats {
     readonly totalOutputTokens: Node<number>;
     /** Reset all counters + clear the log. */
     reset(): void;
+    /**
+     * Release the internal keepalive subscriptions on the three counter
+     * derives (`totalCalls` / `totalInputTokens` / `totalOutputTokens`) so the
+     * bundle can be GC'd when the caller discards it. Idempotent. Long-lived
+     * adapter bundles (module-level singletons) can ignore; transient bundles
+     * (per-request / per-user) should call on teardown.
+     */
+    dispose(): void;
 }
 /**
  * Wrap any {@link LLMAdapter} with a reactive stats bundle.
  *
- * Implementation:
- * - `stats.lastCall` is a `state<CallStatsEvent | undefined>` exposed via a
- *   null-filtering derived so consumers see a typed `Node<CallStatsEvent>`.
+ * Implementation (Unit 10 B):
+ * - `stats.lastCall` is a `state<CallStatsEvent | null>`.
  * - Counters (`totalCalls` / `totalInputTokens` / `totalOutputTokens`) are
- *   plain state nodes updated via `.emit()`.
+ *   **derived views** over `allCalls.entries` — self-maintaining, no manual
+ *   `.cache + 1 + emit` pattern, visible topology in `describe()`.
  * - `stats.allCalls` is a `reactiveLog<CallStatsEvent>` — bounded, supports
  *   `tail(n)` / `slice(start, stop)` for dashboard views.
- * - The wrapped adapter passes DATA through via a `derived` tap that writes
- *   to the stats nodes as a side-effect. No pricing — users compose pricing
- *   as a derived on top of `stats.lastCall`.
+ * - The wrapped adapter passes DATA through via `adaptInvokeResult`, which
+ *   uses `onFirstData` internally to guard against re-subscription double-fire
+ *   and wires `.catch` for Promise-path error recording (Unit 10 A).
  */
 declare function observableAdapter(inner: LLMAdapter, opts?: {
     logMax?: number;
@@ -115,6 +122,11 @@ declare function withBreaker(inner: LLMAdapter, opts?: WithBreakerOptions): {
  * throws `BudgetExhaustedError` without hitting the wrapped adapter. On
  * success, the call's usage is appended to the log AND debits the running
  * totals in a single synchronous update.
+ *
+ * Wave A Unit 11 Q4: rejected-Promise path now wires `.catch` (via
+ * `adaptInvokeResult.onError`) so failed invoke calls record a CallStatsEvent
+ * with `error` populated. Prior code silently dropped rejection from the
+ * `totals` / `log` surface.
  */
 
 declare class BudgetExhaustedError extends Error {
@@ -489,6 +501,14 @@ interface ResilientAdapterOptions {
      * is set. Threaded directly to the inner {@link cascadingLlmAdapter}.
      */
     onExhausted?: (report: CascadeExhaustionReport) => void;
+    /**
+     * Content-addressed replay cache wrapped OUTERMOST — a cache HIT short-
+     * circuits the entire stack (rate-limit / budget / breaker / retry /
+     * fallback), saving money and latency. Cache MISSes flow through the
+     * normal stack; the successful result is stored on success. See
+     * {@link withReplayCache}.
+     */
+    cache?: WithReplayCacheOptions;
 }
 /** Output bundle of {@link resilientAdapter}. */
 interface ResilientAdapterBundle {
@@ -767,23 +787,6 @@ interface GeminiUsage {
 }
 declare function googleAdapter(opts?: GoogleAdapterOptions): LLMAdapter;
 
-/**
- * Curated `cascadingLlmAdapter` presets — Node/browser-safe subset.
- *
- * Thin compositions over `cascadingLlmAdapter` + `createAdapter`. No new
- * logic — just convenient defaults. Users needing finer control call
- * `cascadingLlmAdapter` directly.
- *
- * Presets that depend on browser-only adapters (WebLLM, Chrome Nano) have
- * been split out to [`./browser-presets.ts`](./browser-presets.ts) and are
- * exported from the `@graphrefly/graphrefly/patterns/ai/browser`
- * subpath so they don't leak into Node bundles.
- *
- * @module
- */
-
-declare function dryRunPreset(): LLMAdapter;
-
 /**
  * `fromLLM` — reactive LLM invocation sugar.
  *
@@ -889,34 +892,56 @@ type PromptNodeOptions = {
 declare function promptNode<T = string>(adapter: LLMAdapter, deps: readonly Node<unknown>[], prompt: string | ((...depValues: unknown[]) => string), opts?: PromptNodeOptions): Node<T | null>;
 
 /**
- * `streamingPromptNode` + `gatedStream` — streaming LLM transforms, plus the
- * shared `StreamChunk` shape.
+ * `streamingPromptNode` + `gatedStream` — streaming LLM transforms.
+ *
+ * **Wave A Unit 2 rewrite:**
+ * - `StreamChunk` retired. The live stream surface is now `deltaTopic:
+ *   TopicGraph<StreamDelta & {seq, ts}>` — every adapter delta (token,
+ *   thinking, tool-call, usage, finish) is published in order. The previous
+ *   shape retained the accumulated text per-chunk, producing O(N²) memory;
+ *   the new shape stores only per-delta payloads (O(N)).
+ * - New `accumulatedText: Node<string>` on the bundle — lazy-built via
+ *   `ctx.store` over token-type deltas. Text-only extractors (`streamExtractor`,
+ *   `keywordFlagExtractor`, `toolCallExtractor`) consume this node.
+ * - `retainedLimit?: number` option exposed for the delta topic (no default —
+ *   session scale is domain-specific per Unit 2 Q2).
+ * - Unconditional `keepalive(output)` removed — callers subscribe as needed.
+ * - System-prompt double-send fixed (matches promptNode Unit 1 fix).
+ * - `format: "json"` throws on parse error with a content-preview diagnostic
+ *   (parity with `promptNode`).
+ * - Shared body between `streamingPromptNode` and `gatedStream` extracted
+ *   into `streamingInvoke` per Unit 2 locked scope.
  *
  * @module
  */
 
 /**
- * A single chunk from any streaming source (LLM tokens, WebSocket, SSE, file tail).
- * Generic enough for any streaming source, not just LLM.
+ * A single delta published to the `deltaTopic`. Every adapter emission is
+ * forwarded — not just token deltas — so consumers see the full event log
+ * (thinking, tool-call-delta, usage, finish).
  */
-type StreamChunk = {
-    /** Identifier for the stream source (adapter name, URL, etc.). */
-    readonly source: string;
-    /** This chunk's content. */
-    readonly token: string;
-    /** Full accumulated text so far. */
-    readonly accumulated: string;
-    /** 0-based chunk counter. */
-    readonly index: number;
+type StampedDelta = StreamDelta & {
+    /** Monotonic per-stream counter starting at 0. */
+    readonly seq: number;
+    /** Wall-clock nanoseconds at publish time (spec §5.11 central timer). */
+    readonly ts: number;
 };
 type StreamingPromptNodeOptions = {
     name?: string;
     model?: string;
     temperature?: number;
     maxTokens?: number;
-    /** Output format — `"json"` attempts JSON.parse on the final accumulated text. Default: `"text"`. */
+    /** Output format — `"json"` attempts JSON.parse on accumulated text. Throws on parse failure. Default: `"text"`. */
     format?: "text" | "json";
     systemPrompt?: string;
+    meta?: Record<string, unknown>;
+    /**
+     * Optional retention cap on the delta topic. Omit for unbounded retention
+     * (the topic grows until `dispose()`). Recommended values: `8_192` for
+     * single-shot 8K-token responses, `1_000_000` for persistent session
+     * topics, or explicit `dispose()` for worker-pool patterns.
+     */
+    retainedLimit?: number;
 };
 /**
  * Bundle returned by {@link streamingPromptNode}.
@@ -924,9 +949,15 @@ type StreamingPromptNodeOptions = {
 type StreamingPromptNodeHandle<T> = {
     /** Final parsed result (emits once per invocation, after stream completes). */
     output: Node<T | null>;
-    /** Live stream topic — subscribe to `stream.latest` or `stream.events` for chunks. */
-    stream: TopicGraph<StreamChunk>;
-    /** Tear down the keepalive subscription and release resources. */
+    /** Live delta topic — every adapter delta in order, stamped with `seq` + `ts`. */
+    deltaTopic: TopicGraph<StampedDelta>;
+    /**
+     * Reactive accumulated-text view — lazy-built over `deltaTopic.latest`
+     * filtered on `type === "token"`. Text-only extractors compose on this.
+     * Emits the empty string before any token arrives.
+     */
+    accumulatedText: Node<string>;
+    /** Tear down the delta topic and release resources. */
     dispose: () => void;
 };
 /**
@@ -934,12 +965,12 @@ type StreamingPromptNodeHandle<T> = {
  * streaming pipeline. Re-invokes the LLM whenever any dep changes; the
  * previous in-flight stream is canceled automatically via `switchMap`.
  *
- * Each token chunk is published to a {@link TopicGraph} as a {@link StreamChunk}.
- * Extractors can mount on the topic independently (see `streamExtractor`).
- * Zero overhead if nobody subscribes to the stream topic.
+ * Every adapter delta is published to `deltaTopic` stamped with `seq` + `ts`.
+ * Text consumers subscribe to `accumulatedText` (auto-maintained). Delta-
+ * specific consumers (`costMeterExtractor` on `usage` deltas) subscribe to
+ * `deltaTopic` directly and filter by `delta.type`.
  *
- * The `output` node emits the final parsed result (like `promptNode`).
- * The async boundary is handled by `fromAny` (spec §5.10 compliant).
+ * The async boundary is handled by `fromAny(asyncGenerator)` (spec §5.10).
  */
 declare function streamingPromptNode<T = string>(adapter: LLMAdapter, deps: readonly Node<unknown>[], prompt: string | ((...depValues: unknown[]) => string), opts?: StreamingPromptNodeOptions): StreamingPromptNodeHandle<T>;
 type GatedStreamOptions = StreamingPromptNodeOptions & {
@@ -952,11 +983,13 @@ type GatedStreamOptions = StreamingPromptNodeOptions & {
 type GatedStreamHandle<T> = {
     /** Final parsed result (after gate approval). */
     output: Node<T | null>;
-    /** Live stream topic — subscribe to `stream.latest` for chunks. */
-    stream: TopicGraph<StreamChunk>;
+    /** Live delta topic — every adapter delta in order, stamped with `seq` + `ts`. */
+    deltaTopic: TopicGraph<StampedDelta>;
+    /** Reactive accumulated-text view. */
+    accumulatedText: Node<string>;
     /** Gate controller — approve, reject (aborts in-flight stream), modify. */
     gate: GateController<T | null>;
-    /** Tear down everything. */
+    /** Tear down the delta topic + gate keepalive. */
     dispose: () => void;
 };
 /**
@@ -964,14 +997,13 @@ type GatedStreamHandle<T> = {
  *
  * Composes {@link streamingPromptNode} with `gate` so that:
  * - `gate.reject()` discards the pending value **and** aborts the in-flight
- *   stream (cancels the `AbortController`).
+ *   stream (toggles an internal cancel signal → switchMap restart → abort).
  * - `gate.modify()` transforms the pending value before forwarding downstream.
  * - `gate.approve()` forwards the final result as normal.
  *
- * The abort-on-reject works by toggling an internal cancel signal that causes
- * the `switchMap` inside `streamingPromptNode` to restart with an empty message
- * list, which triggers the `AbortController.abort()` in the async generator's
- * `finally` block.
+ * Wave A Unit 2 defers full `gatedStream` review to Wave B Unit 17 (the
+ * `gate()` primitive itself is reviewed there). This implementation retains
+ * the existing gate API while adopting the Unit 2 delta-topic shape.
  */
 declare function gatedStream<T = string>(graph: Graph, name: string, adapter: LLMAdapter, deps: readonly Node<unknown>[], prompt: string | ((...depValues: unknown[]) => string), opts?: GatedStreamOptions): GatedStreamHandle<T>;
 
@@ -994,7 +1026,15 @@ declare function systemPromptBuilder(sections: readonly NodeInput<string>[], opt
 }): SystemPromptHandle;
 
 /**
- * Cost meter extractor — counts chunks, characters, and estimates token usage.
+ * Cost meter extractor — derives live cost readings from the delta topic.
+ *
+ * **Wave A Unit 3 rewrite:** signature takes `deltaTopic: TopicGraph<StampedDelta>`
+ * instead of the old `TopicGraph<StreamChunk>`. The meter prefers real
+ * `usage` deltas from the adapter; when no `usage` has been seen yet it
+ * falls back to a char-based estimate over token deltas and stamps
+ * `estimated: true` on the reading. Chunk count is the count of
+ * token-type deltas seen (was `chunk.index + 1`).
+ *
  * @module
  */
 
@@ -1003,6 +1043,12 @@ type CostMeterReading = {
     readonly chunkCount: number;
     readonly charCount: number;
     readonly estimatedTokens: number;
+    /**
+     * `true` when no adapter `usage` delta has been observed yet —
+     * `estimatedTokens` is a char-based heuristic and should be treated as an
+     * approximation. Flips to `false` once a real `usage` delta arrives.
+     */
+    readonly estimated: boolean;
 };
 type CostMeterOptions = {
     /** Characters per token approximation. Default: 4 (GPT-family). */
@@ -1010,14 +1056,14 @@ type CostMeterOptions = {
     name?: string;
 };
 /**
- * Mounts a cost meter on a streaming topic. Counts chunks, characters, and
- * estimates token count. Compose with `budgetGate` for hard-stop when LLM
- * output exceeds budget mid-generation.
+ * Mounts a cost meter on the delta topic. Prefers real `usage` deltas from
+ * the provider; falls back to char-based estimation on token deltas alone
+ * (with `meta.estimated: true` on the reading).
  *
  * Default structural equals suppresses DATA emission when two consecutive
- * readings are identical (same chunk count + char count + token estimate).
+ * readings are identical.
  */
-declare function costMeterExtractor(streamTopic: TopicGraph<StreamChunk>, opts?: CostMeterOptions): Node<CostMeterReading>;
+declare function costMeterExtractor(deltaTopic: TopicGraph<StampedDelta>, opts?: CostMeterOptions): Node<CostMeterReading>;
 
 /**
  * Keyword-flag extractor — scans accumulated stream text for configured patterns.
@@ -1045,38 +1091,52 @@ type KeywordFlagExtractorOptions = {
     maxPatternLength?: number;
 };
 /**
- * Mounts a keyword-flag extractor on a streaming topic. Scans accumulated text
- * for all configured patterns and emits an array of matches.
+ * Mounts a keyword-flag extractor on accumulated text. Scans for all
+ * configured patterns and emits an array of matches.
+ *
+ * **Wave A Unit 3 rewrite:** signature takes `accumulatedText: Node<string>`
+ * instead of the old `TopicGraph<StreamChunk>`. Patterns are compiled once
+ * at factory time (was per-chunk). `maxPatternLength` is validated at
+ * factory time — any pattern whose source exceeds the window throws
+ * immediately.
  *
  * Use cases: design invariant violations (`setTimeout`, `EventEmitter`), PII
  * detection (SSN, email, phone), toxicity keywords, off-track reasoning.
  *
- * **Streaming optimization.** Maintains a cursor across chunks in `ctx.store`
- * so each chunk scans only the delta region `accumulated.slice(scannedTo -
- * maxPatternLength)` — not the full string. Default structural equals
- * suppresses DATA emission when no new flags were found this chunk.
+ * **Streaming optimization.** Maintains a cursor across waves in `ctx.store`
+ * so each emission scans only the delta region `accumulated.slice(scannedTo -
+ * maxPatternLength)` — not the full string. Reactivation clears `ctx.store`
+ * and resumes from offset 0 (COMPOSITION-GUIDE §20 RAM semantics).
+ *
+ * Default structural equals suppresses DATA emission when no new flags were
+ * found this wave.
  */
-declare function keywordFlagExtractor(streamTopic: TopicGraph<StreamChunk>, opts: KeywordFlagExtractorOptions): Node<readonly KeywordFlag[]>;
+declare function keywordFlagExtractor(accumulatedText: Node<string>, opts: KeywordFlagExtractorOptions): Node<readonly KeywordFlag[]>;
 
 /**
- * Generic stream extractor — mounts an extract function on a streaming topic.
+ * Generic stream extractor — mounts an extract function on accumulated text.
+ *
+ * **Wave A Unit 3 rewrite:** signature changed from
+ * `streamExtractor(topic: TopicGraph<StreamChunk>, fn)` to
+ * `streamExtractor(accumulatedText: Node<string>, fn)`. The Unit 2 delta-
+ * topic redesign removed the per-chunk `accumulated` field; callers pass
+ * `streamingPromptNode(...).accumulatedText` (or any other `Node<string>`
+ * source of accumulated text). Source-agnostic — the extractor doesn't care
+ * whether the text came from an LLM, WebSocket, SSE tail, or file reader.
+ *
  * @module
  */
 
 /**
- * Mounts an extractor function on a streaming topic. Returns a derived node
- * that emits extracted values as chunks arrive.
- *
- * `extractFn` receives the accumulated text from the latest chunk and returns
- * the extracted value, or `null` if nothing detected yet. This is the building
- * block for keyword flags, tool call detection, cost metering, etc.
+ * Mounts an extractor function on a reactive accumulated-text source. Returns
+ * a derived node that emits extracted values as the text grows.
  *
- * @param streamTopic - The stream topic to extract from.
+ * @param accumulatedText - Reactive `Node<string>` of accumulated text.
  * @param extractFn - `(accumulated: string) => T | null`.
- * @param opts - Optional name.
+ * @param opts - Optional name + structural equals.
  * @returns Derived node emitting extracted values.
  */
-declare function streamExtractor<T>(streamTopic: TopicGraph<StreamChunk>, extractFn: (accumulated: string) => T | null, opts?: {
+declare function streamExtractor<T>(accumulatedText: Node<string>, extractFn: (accumulated: string) => T | null, opts?: {
     name?: string;
     /**
      * Optional structural equals for the extractor output. When two
@@ -1114,7 +1174,7 @@ type ExtractedToolCall = {
  * are not re-parsed. Default structural equals suppresses DATA emission when
  * no new tool call completed this chunk.
  */
-declare function toolCallExtractor(streamTopic: TopicGraph<StreamChunk>, opts?: {
+declare function toolCallExtractor(accumulatedText: Node<string>, opts?: {
     name?: string;
 }): Node<readonly ExtractedToolCall[]>;
 
@@ -1139,23 +1199,31 @@ type ContentGateOptions = {
  * Derived node that classifies accumulated stream text as `"allow"`,
  * `"review"`, or `"block"` based on a classifier score.
  *
- * Emits a three-way decision on every new chunk:
+ * **Wave A Unit 3 rewrite:** signature now takes `accumulatedText: Node<string>`
+ * instead of a `TopicGraph<StreamChunk>` (the `StreamChunk` shape was retired
+ * when the delta topic replaced the per-chunk accumulated-text shape).
+ *
+ * Emits a three-way decision on every text change:
  * - `"allow"` — score below `threshold`
  * - `"review"` — score in `[threshold, threshold × hardMultiplier)`
  * - `"block"` — score at or above `threshold × hardMultiplier`
  *
- * Wire the output into a `valve` (automatic) or `gate` (human approval).
- * This node does not itself control flow — it just classifies.
- *
- * @param streamTopic - Streaming topic to classify.
- * @param classifier  - `(accumulated: string) => number` scoring function, or
- *                      a `Node<number>` for live scores.
- * @param threshold   - Score at which output becomes "review" or "block".
+ * @param accumulatedText - Reactive accumulated-text source
+ *                          (`streamingPromptNode(...).accumulatedText`).
+ * @param classifier - `(accumulated: string) => number` scoring function, or
+ *                     a `Node<number>` for live scores.
+ * @param threshold - Score at which output becomes `"review"` or `"block"`.
  */
-declare function contentGate(streamTopic: TopicGraph<StreamChunk>, classifier: ((accumulated: string) => number) | Node<number>, threshold: number, opts?: ContentGateOptions): Node<ContentDecision>;
+declare function contentGate(accumulatedText: Node<string>, classifier: ((accumulated: string) => number) | Node<number>, threshold: number, opts?: ContentGateOptions): Node<ContentDecision>;
 
 /**
  * Redactor — stream extractor that replaces matched patterns in accumulated text.
+ *
+ * **Wave A Unit 3 rewrite:** signature now takes `accumulatedText: Node<string>`
+ * instead of the retired `TopicGraph<StreamChunk>`. The output is a
+ * `Node<string>` carrying the sanitized accumulated text — compose with
+ * `contentGate` or downstream UI directly.
+ *
  * @module
  */
 
@@ -1164,19 +1232,14 @@ type RedactorOptions = {
     name?: string;
 };
 /**
- * Stream extractor that replaces matched patterns in the accumulated text.
- *
- * Returns a derived node emitting a sanitized `StreamChunk` on every chunk:
- * `accumulated` and `token` have matched substrings replaced by `replaceFn`.
- * The default `replaceFn` replaces with `"[REDACTED]"`.
+ * Derived node that replaces matched patterns in accumulated text.
  *
- * Compose with `contentGate` for in-flight safety pipelines.
- *
- * @param streamTopic - Streaming topic to monitor.
- * @param patterns    - Array of RegExps to match against accumulated text.
- * @param replaceFn   - Replacement producer (default: always `"[REDACTED]"`).
+ * @param accumulatedText - Reactive accumulated-text source.
+ * @param patterns - Array of RegExps to match against the text.
+ * @param replaceFn - Replacement producer (default: always `"[REDACTED]"`).
+ * @returns `Node<string>` emitting the sanitized accumulated text.
  */
-declare function redactor(streamTopic: TopicGraph<StreamChunk>, patterns: RegExp[], replaceFn?: (match: string, pattern: RegExp) => string, opts?: RedactorOptions): Node<StreamChunk>;
+declare function redactor(accumulatedText: Node<string>, patterns: RegExp[], replaceFn?: (match: string, pattern: RegExp) => string, opts?: RedactorOptions): Node<string>;
 
 type ChatStreamOptions = {
     graph?: GraphOptions;
@@ -1198,13 +1261,47 @@ declare function chatStream(name: string, opts?: ChatStreamOptions): ChatStreamG
 type ToolRegistryOptions = {
     graph?: GraphOptions;
 };
+/**
+ * `ToolRegistryGraph` — name-keyed registry of {@link ToolDefinition}s.
+ *
+ * **Wave A Unit 6 refactor:** internal storage migrated from `state<Map>`
+ * (O(N) Map-copy per mutation) to `ReactiveMapBundle<string, ToolDefinition>`
+ * (O(1) mutations + version counter). Public API unchanged for existing
+ * consumers. Adds a new reactive `executeReactive(name, args): Node<unknown>`
+ * alongside the imperative `execute(name, args): Promise<unknown>` so
+ * composing factories (`toolExecution`, `agentLoop`) can consume the tool
+ * handler as a reactive source without bridging through `firstDataFromNode`.
+ */
 declare class ToolRegistryGraph extends Graph {
     readonly definitions: Node<ReadonlyMap<string, ToolDefinition>>;
     readonly schemas: Node<readonly ToolDefinition[]>;
+    private readonly _bundle;
     constructor(name: string, opts?: ToolRegistryOptions);
     register(tool: ToolDefinition): void;
     unregister(name: string): void;
+    /**
+     * Imperative boundary: await the handler result as a Promise. Safe for
+     * non-reactive callers; reactive consumers prefer {@link executeReactive}.
+     */
     execute(name: string, args: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Reactive execution — returns a `Node<unknown>` that emits the handler
+     * result. Uses `fromAny` to bridge Promise / Node / AsyncIterable handler
+     * return shapes uniformly. Composes cleanly inside `switchMap` /
+     * `retrySource` / `rescue` chains where the legacy imperative `execute()`
+     * would force a `firstDataFromNode` round-trip.
+     *
+     * The returned node is a one-shot: it emits the first DATA from the
+     * handler result (or ERROR on handler throw) and then relies on the
+     * caller's switchMap / subscription chain for teardown. For repeated
+     * invocations, call `executeReactive` again — each call mints a fresh
+     * node tied to a fresh `handler(args)` invocation.
+     *
+     * @throws `Error` synchronously when `name` is not registered (no node is
+     *   constructed — the caller gets a pre-wiring failure rather than a
+     *   silent ERROR wave on an empty graph).
+     */
+    executeReactive(name: string, args: Record<string, unknown>): Node<unknown>;
     getDefinition(name: string): ToolDefinition | undefined;
 }
 declare function toolRegistry(name: string, opts?: ToolRegistryOptions): ToolRegistryGraph;
@@ -1406,6 +1503,15 @@ type HandoffOptions = {
  * @returns Node emitting the specialist's output when the gate is open, or
  *   `from`'s value when the gate is closed. Null when `from` is null.
  *
+ * **Performance caveat (Wave A Unit 5):** the specialist is mounted per
+ * source emission — each `v != null` DATA on `from` allocates a fresh
+ * `state<T>(v)` + invokes `toFactory`, and switchMap cancels the prior
+ * branch. For per-turn routing (≤1 emit/sec) this is negligible. For
+ * high-frequency sources (per-token routing, tight event loops), batch
+ * upstream (e.g. via `audit`, `throttle`, or `distinctUntilChanged`) before
+ * handing off — each mount/unmount cycle spins up full subgraphs
+ * (`messagesNode` + adapter bridge + output for a `promptNode` specialist).
+ *
  * @category patterns.ai
  */
 declare function handoff<T>(from: NodeInput<T | null>, toFactory: (input: Node<T>) => Node<T | null>, opts?: HandoffOptions): Node<T | null>;
@@ -1739,22 +1845,23 @@ type GraphFromSpecOptions = {
     model?: string;
     temperature?: number;
     maxTokens?: number;
-    /** Callback to construct topology before values are applied (passed to `Graph.fromSnapshot`). */
-    build?: (g: Graph) => void;
+    /** Fn/source catalog for resolving named node factories from the LLM-generated spec. */
+    catalog?: GraphSpecCatalog;
     /** Extra instructions appended to the system prompt. */
     systemPromptExtra?: string;
 };
 /**
  * Ask an LLM to compose a Graph from a natural-language description.
  *
- * The LLM returns a JSON graph definition which is validated and then
- * constructed via `Graph.fromSnapshot()`.
+ * The LLM returns a JSON {@link GraphSpec} which is validated, catalog-expanded,
+ * and instantiated via {@link compileSpec} (gains catalog validation, template
+ * expansion, and feedback wiring that `Graph.fromSnapshot` bypasses).
  *
  * @param naturalLanguage - The problem/use-case description.
  * @param adapter - LLM adapter for the generation call.
- * @param opts - Model options and optional `build` callback for node factories.
+ * @param opts - Model options and optional catalog for named node factories.
  * @returns A constructed Graph.
- * @throws On invalid LLM output or validation failure.
+ * @throws On invalid LLM output, validation failure, or unresolvable deps.
  */
 declare function graphFromSpec(naturalLanguage: string, adapter: LLMAdapter, opts?: GraphFromSpecOptions): Promise<Graph>;
 
@@ -1975,9 +2082,9 @@ type index_RetrievalEntry<TMem> = RetrievalEntry<TMem>;
 type index_RetrievalPipelineOptions<TMem> = RetrievalPipelineOptions<TMem>;
 type index_RetrievalQuery = RetrievalQuery;
 type index_RetrievalTrace<TMem> = RetrievalTrace<TMem>;
+type index_StampedDelta = StampedDelta;
 type index_StrategyOperation = StrategyOperation;
 type index_StrategyPlan = StrategyPlan;
-type index_StreamChunk = StreamChunk;
 declare const index_StreamDelta: typeof StreamDelta;
 type index_StreamingPromptNodeHandle<T> = StreamingPromptNodeHandle<T>;
 type index_StreamingPromptNodeOptions = StreamingPromptNodeOptions;
@@ -2014,7 +2121,6 @@ declare const index_createAdapter: typeof createAdapter;
 declare const index_createCapabilitiesRegistry: typeof createCapabilitiesRegistry;
 declare const index_createPricingRegistry: typeof createPricingRegistry;
 declare const index_dryRunAdapter: typeof dryRunAdapter;
-declare const index_dryRunPreset: typeof dryRunPreset;
 declare const index_fallbackAdapter: typeof fallbackAdapter;
 declare const index_fromLLM: typeof fromLLM;
 declare const index_frozenContext: typeof frozenContext;
@@ -2030,6 +2136,7 @@ declare const index_llmExtractor: typeof llmExtractor;
 declare const index_observableAdapter: typeof observableAdapter;
 declare const index_openAICompatAdapter: typeof openAICompatAdapter;
 declare const index_parseRateLimitFromError: typeof parseRateLimitFromError;
+declare const index_pricingFor: typeof pricingFor;
 declare const index_promptNode: typeof promptNode;
 declare const index_redactor: typeof redactor;
 declare const index_registryPricing: typeof registryPricing;
@@ -2038,6 +2145,7 @@ declare const index_streamExtractor: typeof streamExtractor;
 declare const index_streamingPromptNode: typeof streamingPromptNode;
 declare const index_suggestStrategy: typeof suggestStrategy;
 declare const index_systemPromptBuilder: typeof systemPromptBuilder;
+declare const index_tier: typeof tier;
 declare const index_toolCallExtractor: typeof toolCallExtractor;
 declare const index_toolRegistry: typeof toolRegistry;
 declare const index_toolSelector: typeof toolSelector;
@@ -2051,7 +2159,7 @@ declare const index_withRetry: typeof withRetry;
 declare const index_withTimeout: typeof withTimeout;
 declare const index_zeroPrice: typeof zeroPrice;
 declare namespace index {
-  export { index_AdapterProvider as AdapterProvider, type index_AdapterStats as AdapterStats, index_AdapterTier as AdapterTier, type index_AdmissionScore3DOptions as AdmissionScore3DOptions, type index_AdmissionScores as AdmissionScores, index_AgentLoopGraph as AgentLoopGraph, type index_AgentLoopOptions as AgentLoopOptions, type index_AgentLoopStatus as AgentLoopStatus, type index_AgentMemoryGraph as AgentMemoryGraph, type index_AgentMemoryOptions as AgentMemoryOptions, index_AllTiersExhaustedError as AllTiersExhaustedError, type index_AnthropicAdapterOptions as AnthropicAdapterOptions, type index_AnthropicSdkLike as AnthropicSdkLike, type index_BudgetCaps as BudgetCaps, index_BudgetExhaustedError as BudgetExhaustedError, type index_BudgetGateBundle as BudgetGateBundle, type index_BudgetTotals as BudgetTotals, type index_CallStatsEvent as CallStatsEvent, index_CapabilitiesRegistry as CapabilitiesRegistry, index_CascadeExhaustionReport as CascadeExhaustionReport, index_CascadingLlmAdapterOptions as CascadingLlmAdapterOptions, index_ChatMessage as ChatMessage, index_ChatStreamGraph as ChatStreamGraph, type index_ChatStreamOptions as ChatStreamOptions, index_CircuitOpenError as CircuitOpenError, type index_ContentDecision as ContentDecision, type index_ContentGateOptions as ContentGateOptions, type index_CostMeterOptions as CostMeterOptions, type index_CostMeterReading as CostMeterReading, index_CreateAdapterOptions as CreateAdapterOptions, index_DEFAULT_DECAY_RATE as DEFAULT_DECAY_RATE, type index_DryRunAdapterOptions as DryRunAdapterOptions, type index_ExtractedToolCall as ExtractedToolCall, index_FallbackAdapterOptions as FallbackAdapterOptions, index_FallbackFixture as FallbackFixture, index_FallbackMissError as FallbackMissError, index_FallbackMissPolicy as FallbackMissPolicy, type index_FromLLMOptions as FromLLMOptions, type index_FrozenContextOptions as FrozenContextOptions, type index_GatedStreamHandle as GatedStreamHandle, type index_GatedStreamOptions as GatedStreamOptions, type index_GaugesAsContextOptions as GaugesAsContextOptions, type index_GoogleAdapterOptions as GoogleAdapterOptions, type index_GoogleSdkLike as GoogleSdkLike, type index_GraphDefValidation as GraphDefValidation, type index_GraphFromSpecOptions as GraphFromSpecOptions, type index_HandoffOptions as HandoffOptions, type index_HttpErrorLike as HttpErrorLike, type index_KeywordFlag as KeywordFlag, type index_KeywordFlagExtractorOptions as KeywordFlagExtractorOptions, type index_KnobsAsToolsResult as KnobsAsToolsResult, index_LLMAdapter as LLMAdapter, type index_LLMConsolidatorOptions as LLMConsolidatorOptions, type index_LLMExtractorOptions as LLMExtractorOptions, index_LLMInvokeOptions as LLMInvokeOptions, index_LLMResponse as LLMResponse, index_LLMTimeoutError as LLMTimeoutError, type index_McpToolSchema as McpToolSchema, type index_MemoryTier as MemoryTier, type index_MemoryTiersBundle as MemoryTiersBundle, type index_MemoryTiersOptions as MemoryTiersOptions, index_ModelCapabilities as ModelCapabilities, index_ModelFeatures as ModelFeatures, index_ModelLimits as ModelLimits, index_ModelPricing as ModelPricing, index_OpenAICompatAdapterOptions as OpenAICompatAdapterOptions, index_OpenAICompatPreset as OpenAICompatPreset, index_OpenAISdkLike as OpenAISdkLike, type index_OpenAIToolSchema as OpenAIToolSchema, index_PriceBreakdown as PriceBreakdown, index_PricingFn as PricingFn, index_PricingRegistry as PricingRegistry, type index_PromptNodeOptions as PromptNodeOptions, index_Rate as Rate, type index_RedactorOptions as RedactorOptions, index_ReplayCacheKeyContext as ReplayCacheKeyContext, index_ReplayCacheMissError as ReplayCacheMissError, index_ReplayCacheMode as ReplayCacheMode, type index_ResilientAdapterBundle as ResilientAdapterBundle, type index_ResilientAdapterOptions as ResilientAdapterOptions, type index_RetrievalEntry as RetrievalEntry, type index_RetrievalPipelineOptions as RetrievalPipelineOptions, type index_RetrievalQuery as RetrievalQuery, type index_RetrievalTrace as RetrievalTrace, type index_StrategyOperation as StrategyOperation, type index_StrategyPlan as StrategyPlan, type index_StreamChunk as StreamChunk, index_StreamDelta as StreamDelta, type index_StreamingPromptNodeHandle as StreamingPromptNodeHandle, type index_StreamingPromptNodeOptions as StreamingPromptNodeOptions, type index_SuggestStrategyOptions as SuggestStrategyOptions, type index_SystemPromptHandle as SystemPromptHandle, index_TieredRate as TieredRate, index_TokenUsage as TokenUsage, index_ToolCall as ToolCall, index_ToolDefinition as ToolDefinition, index_ToolRegistryGraph as ToolRegistryGraph, type index_ToolRegistryOptions as ToolRegistryOptions, type index_ToolResult as ToolResult, type index_ToolSelectorOptions as ToolSelectorOptions, type index_WithBreakerOptions as WithBreakerOptions, type index_WithBudgetGateOptions as WithBudgetGateOptions, type index_WithDryRunBundle as WithDryRunBundle, type index_WithDryRunOptions as WithDryRunOptions, type index_WithRateLimiterOptions as WithRateLimiterOptions, index_WithReplayCacheOptions as WithReplayCacheOptions, type index_WithRetryOptions as WithRetryOptions, index_admissionFilter3D as admissionFilter3D, index_agentLoop as agentLoop, index_agentMemory as agentMemory, index_anthropicAdapter as anthropicAdapter, index_canonicalJson as canonicalJson, index_cascadingLlmAdapter as cascadingLlmAdapter, index_chatStream as chatStream, index_composePricing as composePricing, index_computePrice as computePrice, index_contentGate as contentGate, index_costMeterExtractor as costMeterExtractor, index_createAdapter as createAdapter, index_createCapabilitiesRegistry as createCapabilitiesRegistry, index_createPricingRegistry as createPricingRegistry, index_dryRunAdapter as dryRunAdapter, index_dryRunPreset as dryRunPreset, index_fallbackAdapter as fallbackAdapter, index_fromLLM as fromLLM, index_frozenContext as frozenContext, index_gatedStream as gatedStream, index_gaugesAsContext as gaugesAsContext, index_googleAdapter as googleAdapter, index_graphFromSpec as graphFromSpec, index_handoff as handoff, index_keywordFlagExtractor as keywordFlagExtractor, index_knobsAsTools as knobsAsTools, index_llmConsolidator as llmConsolidator, index_llmExtractor as llmExtractor, index_observableAdapter as observableAdapter, index_openAICompatAdapter as openAICompatAdapter, index_parseRateLimitFromError as parseRateLimitFromError, index_promptNode as promptNode, index_redactor as redactor, index_registryPricing as registryPricing, index_resilientAdapter as resilientAdapter, index_streamExtractor as streamExtractor, index_streamingPromptNode as streamingPromptNode, index_suggestStrategy as suggestStrategy, index_systemPromptBuilder as systemPromptBuilder, index_toolCallExtractor as toolCallExtractor, index_toolRegistry as toolRegistry, index_toolSelector as toolSelector, index_validateGraphDef as validateGraphDef, index_withBreaker as withBreaker, index_withBudgetGate as withBudgetGate, index_withDryRun as withDryRun, index_withRateLimiter as withRateLimiter, index_withReplayCache as withReplayCache, index_withRetry as withRetry, index_withTimeout as withTimeout, index_zeroPrice as zeroPrice };
+  export { index_AdapterProvider as AdapterProvider, type index_AdapterStats as AdapterStats, index_AdapterTier as AdapterTier, type index_AdmissionScore3DOptions as AdmissionScore3DOptions, type index_AdmissionScores as AdmissionScores, index_AgentLoopGraph as AgentLoopGraph, type index_AgentLoopOptions as AgentLoopOptions, type index_AgentLoopStatus as AgentLoopStatus, type index_AgentMemoryGraph as AgentMemoryGraph, type index_AgentMemoryOptions as AgentMemoryOptions, index_AllTiersExhaustedError as AllTiersExhaustedError, type index_AnthropicAdapterOptions as AnthropicAdapterOptions, type index_AnthropicSdkLike as AnthropicSdkLike, type index_BudgetCaps as BudgetCaps, index_BudgetExhaustedError as BudgetExhaustedError, type index_BudgetGateBundle as BudgetGateBundle, type index_BudgetTotals as BudgetTotals, type index_CallStatsEvent as CallStatsEvent, index_CapabilitiesRegistry as CapabilitiesRegistry, index_CascadeExhaustionReport as CascadeExhaustionReport, index_CascadingLlmAdapterOptions as CascadingLlmAdapterOptions, index_ChatMessage as ChatMessage, index_ChatStreamGraph as ChatStreamGraph, type index_ChatStreamOptions as ChatStreamOptions, index_CircuitOpenError as CircuitOpenError, type index_ContentDecision as ContentDecision, type index_ContentGateOptions as ContentGateOptions, type index_CostMeterOptions as CostMeterOptions, type index_CostMeterReading as CostMeterReading, index_CreateAdapterOptions as CreateAdapterOptions, index_DEFAULT_DECAY_RATE as DEFAULT_DECAY_RATE, type index_DryRunAdapterOptions as DryRunAdapterOptions, type index_ExtractedToolCall as ExtractedToolCall, index_FallbackAdapterOptions as FallbackAdapterOptions, index_FallbackFixture as FallbackFixture, index_FallbackMissError as FallbackMissError, index_FallbackMissPolicy as FallbackMissPolicy, type index_FromLLMOptions as FromLLMOptions, type index_FrozenContextOptions as FrozenContextOptions, type index_GatedStreamHandle as GatedStreamHandle, type index_GatedStreamOptions as GatedStreamOptions, type index_GaugesAsContextOptions as GaugesAsContextOptions, type index_GoogleAdapterOptions as GoogleAdapterOptions, type index_GoogleSdkLike as GoogleSdkLike, type index_GraphDefValidation as GraphDefValidation, type index_GraphFromSpecOptions as GraphFromSpecOptions, type index_HandoffOptions as HandoffOptions, type index_HttpErrorLike as HttpErrorLike, type index_KeywordFlag as KeywordFlag, type index_KeywordFlagExtractorOptions as KeywordFlagExtractorOptions, type index_KnobsAsToolsResult as KnobsAsToolsResult, index_LLMAdapter as LLMAdapter, type index_LLMConsolidatorOptions as LLMConsolidatorOptions, type index_LLMExtractorOptions as LLMExtractorOptions, index_LLMInvokeOptions as LLMInvokeOptions, index_LLMResponse as LLMResponse, index_LLMTimeoutError as LLMTimeoutError, type index_McpToolSchema as McpToolSchema, type index_MemoryTier as MemoryTier, type index_MemoryTiersBundle as MemoryTiersBundle, type index_MemoryTiersOptions as MemoryTiersOptions, index_ModelCapabilities as ModelCapabilities, index_ModelFeatures as ModelFeatures, index_ModelLimits as ModelLimits, index_ModelPricing as ModelPricing, index_OpenAICompatAdapterOptions as OpenAICompatAdapterOptions, index_OpenAICompatPreset as OpenAICompatPreset, index_OpenAISdkLike as OpenAISdkLike, type index_OpenAIToolSchema as OpenAIToolSchema, index_PriceBreakdown as PriceBreakdown, index_PricingFn as PricingFn, index_PricingRegistry as PricingRegistry, type index_PromptNodeOptions as PromptNodeOptions, index_Rate as Rate, type index_RedactorOptions as RedactorOptions, index_ReplayCacheKeyContext as ReplayCacheKeyContext, index_ReplayCacheMissError as ReplayCacheMissError, index_ReplayCacheMode as ReplayCacheMode, type index_ResilientAdapterBundle as ResilientAdapterBundle, type index_ResilientAdapterOptions as ResilientAdapterOptions, type index_RetrievalEntry as RetrievalEntry, type index_RetrievalPipelineOptions as RetrievalPipelineOptions, type index_RetrievalQuery as RetrievalQuery, type index_RetrievalTrace as RetrievalTrace, type index_StampedDelta as StampedDelta, type index_StrategyOperation as StrategyOperation, type index_StrategyPlan as StrategyPlan, index_StreamDelta as StreamDelta, type index_StreamingPromptNodeHandle as StreamingPromptNodeHandle, type index_StreamingPromptNodeOptions as StreamingPromptNodeOptions, type index_SuggestStrategyOptions as SuggestStrategyOptions, type index_SystemPromptHandle as SystemPromptHandle, index_TieredRate as TieredRate, index_TokenUsage as TokenUsage, index_ToolCall as ToolCall, index_ToolDefinition as ToolDefinition, index_ToolRegistryGraph as ToolRegistryGraph, type index_ToolRegistryOptions as ToolRegistryOptions, type index_ToolResult as ToolResult, type index_ToolSelectorOptions as ToolSelectorOptions, type index_WithBreakerOptions as WithBreakerOptions, type index_WithBudgetGateOptions as WithBudgetGateOptions, type index_WithDryRunBundle as WithDryRunBundle, type index_WithDryRunOptions as WithDryRunOptions, type index_WithRateLimiterOptions as WithRateLimiterOptions, index_WithReplayCacheOptions as WithReplayCacheOptions, type index_WithRetryOptions as WithRetryOptions, index_admissionFilter3D as admissionFilter3D, index_agentLoop as agentLoop, index_agentMemory as agentMemory, index_anthropicAdapter as anthropicAdapter, index_canonicalJson as canonicalJson, index_cascadingLlmAdapter as cascadingLlmAdapter, index_chatStream as chatStream, index_composePricing as composePricing, index_computePrice as computePrice, index_contentGate as contentGate, index_costMeterExtractor as costMeterExtractor, index_createAdapter as createAdapter, index_createCapabilitiesRegistry as createCapabilitiesRegistry, index_createPricingRegistry as createPricingRegistry, index_dryRunAdapter as dryRunAdapter, index_fallbackAdapter as fallbackAdapter, index_fromLLM as fromLLM, index_frozenContext as frozenContext, index_gatedStream as gatedStream, index_gaugesAsContext as gaugesAsContext, index_googleAdapter as googleAdapter, index_graphFromSpec as graphFromSpec, index_handoff as handoff, index_keywordFlagExtractor as keywordFlagExtractor, index_knobsAsTools as knobsAsTools, index_llmConsolidator as llmConsolidator, index_llmExtractor as llmExtractor, index_observableAdapter as observableAdapter, index_openAICompatAdapter as openAICompatAdapter, index_parseRateLimitFromError as parseRateLimitFromError, index_pricingFor as pricingFor, index_promptNode as promptNode, index_redactor as redactor, index_registryPricing as registryPricing, index_resilientAdapter as resilientAdapter, index_streamExtractor as streamExtractor, index_streamingPromptNode as streamingPromptNode, index_suggestStrategy as suggestStrategy, index_systemPromptBuilder as systemPromptBuilder, index_tier as tier, index_toolCallExtractor as toolCallExtractor, index_toolRegistry as toolRegistry, index_toolSelector as toolSelector, index_validateGraphDef as validateGraphDef, index_withBreaker as withBreaker, index_withBudgetGate as withBudgetGate, index_withDryRun as withDryRun, index_withRateLimiter as withRateLimiter, index_withReplayCache as withReplayCache, index_withRetry as withRetry, index_withTimeout as withTimeout, index_zeroPrice as zeroPrice };
 }
 
-export { type RetrievalQuery as $, type AdapterStats as A, type BudgetCaps as B, type CallStatsEvent as C, DEFAULT_DECAY_RATE as D, type ExtractedToolCall as E, type FromLLMOptions as F, type GatedStreamHandle as G, type GraphFromSpecOptions as H, type HandoffOptions as I, type HttpErrorLike as J, type KeywordFlag as K, type KeywordFlagExtractorOptions as L, type KnobsAsToolsResult as M, type LLMConsolidatorOptions as N, type LLMExtractorOptions as O, LLMTimeoutError as P, type McpToolSchema as Q, type MemoryTier as R, type MemoryTiersBundle as S, type MemoryTiersOptions as T, type OpenAIToolSchema as U, type PromptNodeOptions as V, type RedactorOptions as W, type ResilientAdapterBundle as X, type ResilientAdapterOptions as Y, type RetrievalEntry as Z, type RetrievalPipelineOptions as _, type AdmissionScore3DOptions as a, type RetrievalTrace as a0, type StrategyOperation as a1, type StrategyPlan as a2, type StreamChunk as a3, type StreamingPromptNodeHandle as a4, type StreamingPromptNodeOptions as a5, type SuggestStrategyOptions as a6, type SystemPromptHandle as a7, ToolRegistryGraph as a8, type ToolRegistryOptions as a9, llmConsolidator as aA, llmExtractor as aB, observableAdapter as aC, parseRateLimitFromError as aD, promptNode as aE, redactor as aF, resilientAdapter as aG, streamExtractor as aH, streamingPromptNode as aI, suggestStrategy as aJ, systemPromptBuilder as aK, toolCallExtractor as aL, toolRegistry as aM, toolSelector as aN, validateGraphDef as aO, withBreaker as aP, withBudgetGate as aQ, withDryRun as aR, withRateLimiter as aS, withRetry as aT, withTimeout as aU, type ToolResult as aa, type ToolSelectorOptions as ab, type WithBreakerOptions as ac, type WithBudgetGateOptions as ad, type WithDryRunBundle as ae, type WithDryRunOptions as af, type WithRateLimiterOptions as ag, type WithRetryOptions as ah, admissionFilter3D as ai, agentLoop as aj, agentMemory as ak, anthropicAdapter as al, chatStream as am, contentGate as an, costMeterExtractor as ao, dryRunAdapter as ap, dryRunPreset as aq, fromLLM as ar, frozenContext as as, gatedStream as at, gaugesAsContext as au, googleAdapter as av, graphFromSpec as aw, handoff as ax, keywordFlagExtractor as ay, knobsAsTools as az, type AdmissionScores as b, AgentLoopGraph as c, type AgentLoopOptions as d, type AgentLoopStatus as e, type AgentMemoryGraph as f, type AgentMemoryOptions as g, type AnthropicAdapterOptions as h, index as i, type AnthropicSdkLike as j, BudgetExhaustedError as k, type BudgetGateBundle as l, type BudgetTotals as m, ChatStreamGraph as n, type ChatStreamOptions as o, type ContentDecision as p, type ContentGateOptions as q, type CostMeterOptions as r, type CostMeterReading as s, type DryRunAdapterOptions as t, type FrozenContextOptions as u, type GatedStreamOptions as v, type GaugesAsContextOptions as w, type GoogleAdapterOptions as x, type GoogleSdkLike as y, type GraphDefValidation as z };
+export { type RetrievalQuery as $, type AdapterStats as A, type BudgetCaps as B, type CallStatsEvent as C, DEFAULT_DECAY_RATE as D, type ExtractedToolCall as E, type FromLLMOptions as F, type GatedStreamHandle as G, type GraphFromSpecOptions as H, type HandoffOptions as I, type HttpErrorLike as J, type KeywordFlag as K, type KeywordFlagExtractorOptions as L, type KnobsAsToolsResult as M, type LLMConsolidatorOptions as N, type LLMExtractorOptions as O, LLMTimeoutError as P, type McpToolSchema as Q, type MemoryTier as R, type MemoryTiersBundle as S, type MemoryTiersOptions as T, type OpenAIToolSchema as U, type PromptNodeOptions as V, type RedactorOptions as W, type ResilientAdapterBundle as X, type ResilientAdapterOptions as Y, type RetrievalEntry as Z, type RetrievalPipelineOptions as _, type AdmissionScore3DOptions as a, type RetrievalTrace as a0, type StampedDelta as a1, type StrategyOperation as a2, type StrategyPlan as a3, type StreamingPromptNodeHandle as a4, type StreamingPromptNodeOptions as a5, type SuggestStrategyOptions as a6, type SystemPromptHandle as a7, ToolRegistryGraph as a8, type ToolRegistryOptions as a9, llmExtractor as aA, observableAdapter as aB, parseRateLimitFromError as aC, promptNode as aD, redactor as aE, resilientAdapter as aF, streamExtractor as aG, streamingPromptNode as aH, suggestStrategy as aI, systemPromptBuilder as aJ, toolCallExtractor as aK, toolRegistry as aL, toolSelector as aM, validateGraphDef as aN, withBreaker as aO, withBudgetGate as aP, withDryRun as aQ, withRateLimiter as aR, withRetry as aS, withTimeout as aT, type ToolResult as aa, type ToolSelectorOptions as ab, type WithBreakerOptions as ac, type WithBudgetGateOptions as ad, type WithDryRunBundle as ae, type WithDryRunOptions as af, type WithRateLimiterOptions as ag, type WithRetryOptions as ah, admissionFilter3D as ai, agentLoop as aj, agentMemory as ak, anthropicAdapter as al, chatStream as am, contentGate as an, costMeterExtractor as ao, dryRunAdapter as ap, fromLLM as aq, frozenContext as ar, gatedStream as as, gaugesAsContext as at, googleAdapter as au, graphFromSpec as av, handoff as aw, keywordFlagExtractor as ax, knobsAsTools as ay, llmConsolidator as az, type AdmissionScores as b, AgentLoopGraph as c, type AgentLoopOptions as d, type AgentLoopStatus as e, type AgentMemoryGraph as f, type AgentMemoryOptions as g, type AnthropicAdapterOptions as h, index as i, type AnthropicSdkLike as j, BudgetExhaustedError as k, type BudgetGateBundle as l, type BudgetTotals as m, ChatStreamGraph as n, type ChatStreamOptions as o, type ContentDecision as p, type ContentGateOptions as q, type CostMeterOptions as r, type CostMeterReading as s, type DryRunAdapterOptions as t, type FrozenContextOptions as u, type GatedStreamOptions as v, type GaugesAsContextOptions as w, type GoogleAdapterOptions as x, type GoogleSdkLike as y, type GraphDefValidation as z };