@graphrefly/graphrefly 0.30.0 → 0.32.0

package/dist/{index-ClgKmOHe.d.ts → index-DhlAMlm9.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-BszPheHD.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-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-DGspwCqk.js';
-import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-DnrZghBB.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-BOhEGJ6E.js';
+import { T as TopicGraph } from './index-Dbmj0iYR.js';
+import { G as GateController, a as GateOptions } from './index-eYHRkoK-.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-BbcSZCAG.js';
 import { StorageHandle, StorageTier } from './extra/storage-core.js';
+import { c as GraphSpecCatalog } from './index-zMQIQuDu.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.
  *
@@ -821,8 +824,12 @@ type FrozenContextOptions = {
      * increments via `setState(n + 1)`.
      *
      * When omitted, the frozen value is materialized exactly once (on first
-     * subscribe) and never refreshes — use this for session-start snapshots
-     * that must stay stable for the lifetime of the activation.
+     * subscribe) and never refreshes for the lifetime of the activation —
+     * use this for session-start snapshots that must stay stable. The
+     * single-shot latch IS reset on `INVALIDATE` (graph-wide flush via
+     * `graph.signal([[INVALIDATE]])`), so callers who need an "evict and
+     * re-materialize" escape hatch get one through the standard graph
+     * lifecycle without having to wire a `refreshTrigger`.
      */
     refreshTrigger?: NodeInput<unknown>;
     name?: string;
@@ -859,6 +866,22 @@ declare function frozenContext<T>(source: NodeInput<T>, opts?: FrozenContextOpti
 /**
  * `promptNode` — universal LLM transform as a reactive derived node.
  *
+ * The shape: `deps → messagesNode (derived) → switchMap → call (producer) → output`.
+ * Each upstream wave is one LLM call; superseding waves cancel the in-flight
+ * call via the abort signal threaded through `nodeSignal(opts.abort)`.
+ *
+ * The producer-shape on the inner is load-bearing: it emits exactly one DATA
+ * + COMPLETE per wave, so the outer switchMap sees one DATA per wave (matches
+ * the `HarnessExecutor` contract). A `derived([call], parse)` would have its
+ * own first-run / push-on-subscribe semantics that can leak a transient null
+ * before the real response arrives — observed and reverted in an earlier
+ * attempt; see SESSION-ai-harness-module-review.md line 3654 for context.
+ *
+ * For retry / replay-cache semantics, wrap the adapter with `withRetry` /
+ * `withReplayCache` middleware (see `patterns/ai/adapters/middleware/`). The
+ * removed `retries` / `cache` options on `promptNode` duplicated middleware
+ * that already exists at the adapter layer.
+ *
  * @module
  */
 
@@ -869,18 +892,51 @@ type PromptNodeOptions = {
     maxTokens?: number;
     /** Output format — `"json"` attempts JSON.parse on the response. Default: `"text"`. */
     format?: "text" | "json";
-    /** Number of retries on transient errors. Default: 0. */
-    retries?: number;
-    /** Cache LLM responses for identical inputs. Default: false. */
-    cache?: boolean;
+    /**
+     * Optional system prompt. Forwarded via `opts.systemPrompt` to the adapter
+     * only — never pushed as a `{role:"system"}` message (avoiding the
+     * double-send class of bug where adapters that normalize both shapes end
+     * up with two system entries).
+     */
     systemPrompt?: string;
+    /**
+     * Optional reactive abort signal. When the node emits `true`, the in-flight
+     * `adapter.invoke()` call is cancelled via `AbortController.abort()`.
+     * Threaded through `nodeSignal(abort)` — a one-shot bridge. Useful inside
+     * agent state machines where a separate `aborted` state should cancel the
+     * current LLM call without superseding via switchMap.
+     */
+    abort?: Node<boolean>;
     meta?: Record<string, unknown>;
 };
 /**
  * Universal LLM transform: wraps a prompt template + model adapter into a reactive derived node.
  * Re-invokes the LLM whenever any dep changes. Suitable for triage, QA, hypothesis, parity, etc.
  *
- * @param adapter - LLM adapter (provider-agnostic).
+ * **Topology** (visible in `describe()`):
+ * ```
+ * <deps...>          → <name>::messages   (derived, meta.ai = prompt_node)
+ * <name>::messages   → <name>::output     (switchMap product, meta.ai = prompt_node::output)
+ *   per-wave inner:  <name>::call         (producer, meta.ai = prompt_node::call)
+ * ```
+ *
+ * **No-input semantics** (matches the codebase-wide SENTINEL convention):
+ * - **Initial no-input** (no real input has ever arrived) — emits nothing.
+ *   Outer cache stays `undefined`; `subscribe` consumers see no DATA event.
+ *   Use this to keep downstream gating clean: a `withLatestFrom`-paired
+ *   trigger won't fire until the LLM has actually produced something.
+ * - **Mid-flow no-input** (input dropped to nullish after at least one
+ *   real LLM call) — emits `null` as a domain "input went away" signal.
+ *   Downstream consumers can distinguish "haven't started" from "input
+ *   gone."
+ *
+ * **Retries / caching:** stack `withRetry` / `withReplayCache` middleware on the
+ * `adapter` argument — `promptNode` no longer ships its own duplicated retry /
+ * cache loops (pre-1.0 cleanup, see review session 1).
+ *
+ * @param adapter - LLM adapter (provider-agnostic). Wrap with `withRetry` /
+ *                   `withReplayCache` middleware for transient-error tolerance
+ *                   or replay caching.
  * @param deps - Input nodes whose values feed the prompt.
  * @param prompt - Static string or template function receiving dep values.
  * @param opts - Optional configuration.
@@ -889,34 +945,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 +1002,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 +1018,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 +1036,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 +1050,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 +1079,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 +1096,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 +1109,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 +1144,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.
+ * Mounts an extractor function on a reactive accumulated-text source. Returns
+ * a derived node that emits extracted values as the text grows.
  *
- * `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.
- *
- * @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 +1227,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 +1252,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 +1285,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 +1314,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;
@@ -1296,8 +1446,6 @@ declare class AgentLoopGraph extends Graph {
     readonly toolCalls: Node<readonly ToolCall[]>;
     /** Tool-result batch (one entry per call) after reactive execution. SENTINEL. */
     readonly toolResults: Node<readonly ToolResult[]>;
-    /** @deprecated Use `turn` instead. Pre-1.0 rename — this alias will be removed. */
-    readonly turnCount: Node<number>;
     private readonly _terminalResult;
     private readonly _disposeRunWiring;
     /**
@@ -1406,6 +1554,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>;
@@ -1447,6 +1604,29 @@ interface ToolSelectorOptions {
  */
 declare function toolSelector(allTools: NodeInput<readonly ToolDefinition[]>, constraints: readonly NodeInput<(tool: ToolDefinition) => boolean>[], opts?: ToolSelectorOptions): Node<readonly ToolDefinition[]>;
 
+/** Generic per-dimension thresholds. Any dim below its threshold → reject. */
+type AdmissionThresholds<Dims extends string> = Partial<Record<Dims, number>>;
+type AdmissionScoredOptions<Dims extends string, TRaw = unknown> = {
+    /** Score function — must return a finite number for every dimension named in `thresholds`. */
+    scoreFn: (raw: TRaw) => Readonly<Record<Dims, number>>;
+    /** Per-dim minimums. Dims absent here are scored but not gated. */
+    thresholds?: AdmissionThresholds<Dims>;
+};
+/**
+ * Generic N-dimension admission filter. Rejects any input where one of the
+ * configured threshold dimensions scores below its minimum. Missing scores
+ * (`undefined` / `null`) AND non-finite values (`NaN`, `±Infinity`) are
+ * treated as below all thresholds — reject by default rather than admit.
+ *
+ * @example
+ * ```ts
+ * const filter = admissionScored({
+ *   scoreFn: (raw: Note) => ({ relevance: scoreRelevance(raw), age: ageScore(raw) }),
+ *   thresholds: { relevance: 0.4 },  // age scored but ungated
+ * });
+ * ```
+ */
+declare function admissionScored<Dims extends string, TRaw = unknown>(opts: AdmissionScoredOptions<Dims, TRaw>): (raw: TRaw) => boolean;
 /** Scores for the three admission dimensions. Each 0–1. */
 type AdmissionScores = {
     readonly persistence: number;
@@ -1454,8 +1634,8 @@ type AdmissionScores = {
     readonly personalValue: number;
 };
 type AdmissionScore3DOptions = {
-    /** Custom scoring function. Default: rule-based (all dimensions 0.5). */
-    scoreFn?: (raw: unknown) => AdmissionScores;
+    /** Custom scoring function. Required — the previous always-0.5 default was misleading. */
+    scoreFn: (raw: unknown) => AdmissionScores;
     /** Minimum persistence score to admit (default 0.3). */
     persistenceThreshold?: number;
     /** Minimum personalValue score to admit (default 0.3). */
@@ -1464,11 +1644,19 @@ type AdmissionScore3DOptions = {
     requireStructured?: boolean;
 };
 /**
- * Creates a 3D admission filter function compatible with `agentMemory`'s
- * `admissionFilter` option. Scores each candidate on persistence, structure,
- * and personalValue, then applies thresholds.
+ * 3D admission sugar — the persistence / structure / personalValue triple
+ * commonly used in agent-memory literature. Composes `admissionScored`
+ * with thresholds derived from the option fields. Use directly when those
+ * three named dimensions match your domain, or use `admissionScored` with
+ * an arbitrary dimension set instead.
+ *
+ * `requireStructured: true` rejects entries where `structure <= 0` (matches
+ * the pre-Unit-8 `requireStructured && scores.structure <= 0` check).
+ * Implemented as a final-step predicate around `admissionScored` rather
+ * than a `Number.MIN_VALUE` threshold, which would have been a footgun for
+ * future readers.
  */
-declare function admissionFilter3D(opts?: AdmissionScore3DOptions): (raw: unknown) => boolean;
+declare function admissionFilter3D(opts: AdmissionScore3DOptions): (raw: unknown) => boolean;
 
 type RetrievalQuery = {
     readonly text?: string;
@@ -1687,6 +1875,20 @@ type LLMExtractorOptions = {
     model?: string;
     temperature?: number;
     maxTokens?: number;
+    /**
+     * Cap the dedup-hint slice of `existingKeys` passed to the LLM. Larger
+     * stores ship more keys (better dedup recall) at the cost of prompt size.
+     * Default 100. Set to `Infinity` to forward every key.
+     */
+    maxExistingKeys?: number;
+    /**
+     * Optional name forwarded to the underlying `promptNode` (used as the
+     * `<name>::messages` / `<name>::call` / `<name>::output` path prefix).
+     * Defaults differ per call site (`llmExtractor` / `llmConsolidator`) so
+     * extractor + consolidator wired into the same graph don't collide on
+     * `prompt_node::output`.
+     */
+    name?: string;
 };
 /**
  * Returns an `extractFn` callback for `distill()` that invokes an LLM to
@@ -1694,6 +1896,10 @@ type LLMExtractorOptions = {
  *
  * The system prompt should instruct the LLM to return JSON matching
  * `Extraction<TMem>` shape: `{ upsert: [{ key, value }], remove?: [key] }`.
+ *
+ * Built on `promptNode({format: "json"})` — inherits markdown-fence stripping
+ * and content-preview parse errors. Stack `withRetry` on the adapter for
+ * transient-error tolerance (see `patterns/ai/adapters/middleware/retry.ts`).
  */
 declare function llmExtractor<TRaw, TMem>(systemPrompt: string, opts: LLMExtractorOptions): (raw: TRaw, existing: ReadonlyMap<string, TMem>) => NodeInput<Extraction<TMem>>;
 type LLMConsolidatorOptions = LLMExtractorOptions;
@@ -1703,6 +1909,111 @@ type LLMConsolidatorOptions = LLMExtractorOptions;
  */
 declare function llmConsolidator<TMem>(systemPrompt: string, opts: LLMConsolidatorOptions): (entries: ReadonlyMap<string, TMem>) => NodeInput<Extraction<TMem>>;
 
+type MemoryWithVectorsOptions<TMem> = {
+    /** Embedding dimension. Must match the `embedFn` output length. */
+    dimension: number;
+    /** Extract an embedding vector for a memory entry. */
+    embedFn: (mem: TMem) => readonly number[] | undefined;
+};
+/**
+ * Attach a vector index to a `DistillBundle`. Indexes every entry in the
+ * store as it changes. Returns the `VectorIndexBundle` so retrieval can read
+ * its `entries` and call `search()`.
+ *
+ * The indexer's keepalive is registered with `graph.addDisposer` so it tears
+ * down on `graph.destroy()`. The returned `dispose()` is also available for
+ * early release without destroying the parent graph.
+ */
+declare function memoryWithVectors<TMem>(graph: Graph, store: DistillBundle<TMem>, opts: MemoryWithVectorsOptions<TMem>): {
+    vectors: VectorIndexBundle<TMem>;
+    dispose: () => void;
+};
+type MemoryWithKGOptions<TMem> = {
+    /** Extract entities + relations for a memory entry. */
+    entityFn: (key: string, mem: TMem) => {
+        entities?: Array<{
+            id: string;
+            value: unknown;
+        }>;
+        relations?: Array<{
+            from: string;
+            to: string;
+            relation: string;
+            weight?: number;
+        }>;
+    } | undefined;
+};
+/**
+ * Attach a knowledge graph alongside a `DistillBundle`. Mount path defaults
+ * to the `name` arg so multiple `memoryWithKG` calls on the same graph don't
+ * collide on a hardcoded `"kg"` mount.
+ *
+ * Indexer keepalive is registered with `graph.addDisposer`; explicit
+ * `dispose()` is also available.
+ */
+declare function memoryWithKG<TMem>(graph: Graph, store: DistillBundle<TMem>, name: string, opts: MemoryWithKGOptions<TMem>): {
+    kg: KnowledgeGraphGraph<unknown, string>;
+    dispose: () => void;
+};
+type MemoryWithTiersOptions<TMem> = MemoryTiersOptions<TMem> & {
+    /** Score function — same signature as `agentMemory.score`. */
+    score: (mem: TMem, context: unknown) => number;
+    /** Optional reactive context node (passed to `score`). */
+    context?: NodeInput<unknown>;
+};
+/**
+ * Attach 3-tier storage (active / archived / permanent) to a `DistillBundle`.
+ * Wires a `tierClassifier` effect that:
+ * - Promotes entries matching `permanentFilter` into the permanent tier.
+ * - Archives entries whose decayed score falls below `archiveThreshold`.
+ * - Caps the active tier at `maxActive`, evicting lowest-scored on overflow.
+ *
+ * **Closure state caveat (Unit 7 Q3 deferred):** `permanentKeys` +
+ * `entryCreatedAtNs` are still closure-held for now; promotion to reactive
+ * nodes is tracked in `docs/optimizations.md`.
+ */
+declare function memoryWithTiers<TMem>(graph: Graph, store: DistillBundle<TMem>, opts: MemoryWithTiersOptions<TMem>): {
+    tiers: MemoryTiersBundle<TMem>;
+    dispose: () => void;
+};
+type MemoryRetrievalOptions<TMem> = {
+    /** Score function (same shape as `agentMemory.score`). */
+    score: (mem: TMem, context: unknown) => number;
+    /** Cost function for budget packing. */
+    cost: (mem: TMem) => number;
+    /** Token / cost budget. Default 2000. */
+    budget?: number;
+    /** Top-K vector candidates. Default 20. */
+    topK?: number;
+    /** KG expansion depth in hops. Default 1. */
+    graphDepth?: number;
+    /** Hierarchical-context boost weight. Default 0. */
+    contextWeight?: number;
+    /** Hierarchical-context accessor for entries. */
+    contextOf?: (mem: TMem) => readonly string[] | undefined;
+    /** Optional reactive context node (passed to `score`). */
+    context?: NodeInput<unknown>;
+};
+type MemoryRetrievalBundle<TMem> = {
+    /** State node mirroring the latest packed retrieval result. */
+    readonly retrieval: Node<ReadonlyArray<RetrievalEntry<TMem>>>;
+    /** State node mirroring the latest retrieval trace. */
+    readonly retrievalTrace: Node<RetrievalTrace<TMem> | null>;
+    /** Imperative consumer API — synchronous; reads cache at call time. */
+    readonly retrieve: (query: RetrievalQuery) => ReadonlyArray<RetrievalEntry<TMem>>;
+    /** Reactive sibling — chain into the graph. Mirrors observability state. */
+    readonly retrieveReactive: (queryInput: NodeInput<RetrievalQuery | null>) => Node<ReadonlyArray<RetrievalEntry<TMem>>>;
+};
+/**
+ * Build the retrieval pipeline (vector + KG + budget packing) over a
+ * `DistillBundle` and optional `vectors` / `kg` bundles.
+ *
+ * Both consumer surfaces (`retrieve`, `retrieveReactive`) write to the same
+ * `retrieval` + `retrievalTrace` state nodes — observers subscribed to those
+ * see ALL queries regardless of which API issued them.
+ */
+declare function memoryRetrieval<TMem>(graph: Graph, store: DistillBundle<TMem>, vectors: VectorIndexBundle<TMem> | null, kg: KnowledgeGraphGraph<unknown, string> | null, opts: MemoryRetrievalOptions<TMem>): MemoryRetrievalBundle<TMem>;
+
 type GaugesAsContextOptions = {
     /** Group gauges by `meta.tags` (default true). */
     groupByTags?: boolean;
@@ -1739,24 +2050,58 @@ 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;
+    /**
+     * Optional AbortSignal forwarded to `adapter.invoke({ signal })`. Lets
+     * callers cancel the in-flight LLM call (e.g. when the reactive variant
+     * supersedes mid-flight). When the signal aborts, the underlying call
+     * propagates the abort and `graphFromSpec` rejects with the abort reason.
+     */
+    signal?: AbortSignal;
 };
 /**
  * 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>;
+/**
+ * Reactive variant of {@link graphFromSpec}: re-invokes the LLM and
+ * recompiles the graph whenever `input` emits a new natural-language
+ * description. Useful inside the harness or refine loop when the spec text
+ * itself is a reactive value (e.g. fed by a `state(...)` knob, a memory
+ * snapshot, or an upstream `promptNode` output).
+ *
+ * **Supersede:** when the input changes mid-flight, switchMap tears the
+ * inner producer down. The producer's cleanup aborts the in-flight LLM
+ * call via an internal `AbortController` (threaded into `graphFromSpec`'s
+ * new `signal` option) AND destroys any Graph that lands after cancel —
+ * no token leak, no unreferenced compiled graphs. If the user's input
+ * already changed by the time the LLM responds, the about-to-be-discarded
+ * Graph is freed instead of orphaned.
+ *
+ * **Lifetime of the latest emitted Graph:** the caller owns each Graph
+ * that actually reaches them. If you keep multiple historical values, call
+ * `prev?.destroy()` before storing the new one.
+ *
+ * @param input - Reactive source of natural-language descriptions.
+ * @param adapter - LLM adapter for the generation call.
+ * @param opts - Model options and optional catalog for named node factories.
+ * @returns `Node<Graph | null>` — emits the latest compiled graph, or `null`
+ *           while the input is empty / unsettled.
+ */
+declare function graphFromSpecReactive(input: NodeInput<string>, adapter: LLMAdapter, opts?: GraphFromSpecOptions): Node<Graph | null>;
 
 /** OpenAI function-calling tool schema. */
 type OpenAIToolSchema = {
@@ -1836,6 +2181,13 @@ type SuggestStrategyOptions = {
     temperature?: number;
     maxTokens?: number;
     actor?: Actor;
+    /**
+     * Optional AbortSignal forwarded to `adapter.invoke({ signal })`. Lets
+     * callers cancel the in-flight LLM call (e.g. when the reactive variant
+     * supersedes mid-flight). When the signal aborts, the underlying call
+     * propagates the abort and `suggestStrategy` rejects with the abort reason.
+     */
+    signal?: AbortSignal;
 };
 /**
  * Ask an LLM to analyze a graph and suggest topology/parameter changes
@@ -1852,6 +2204,22 @@ type SuggestStrategyOptions = {
  * @throws On invalid LLM output.
  */
 declare function suggestStrategy(graph: Graph, problem: string, adapter: LLMAdapter, opts?: SuggestStrategyOptions): Promise<StrategyPlan>;
+/**
+ * Reactive variant of {@link suggestStrategy}: re-invokes the LLM whenever
+ * the `problem` source emits, sampling the latest `graph` value (via
+ * `withLatestFrom`) to describe. The graph is the *secondary* dep — only
+ * problem changes re-trigger analysis. This breaks the feedback cycle that
+ * would otherwise arise if downstream consumers wired `apply(plan)` back
+ * into the same graph node (graph mutation must not auto-fire a re-analysis).
+ *
+ * @param graph - Reactive source of graphs to analyze.
+ * @param problem - Reactive source of natural-language problem statements.
+ * @param adapter - LLM adapter for the analysis call.
+ * @param opts - Model and actor options.
+ * @returns `Node<StrategyPlan | null>` — emits the latest plan, or `null`
+ *           while inputs are unsettled.
+ */
+declare function suggestStrategyReactive(graph: Node<Graph | null>, problem: NodeInput<string>, adapter: LLMAdapter, opts?: SuggestStrategyOptions): Node<StrategyPlan | null>;
 
 /** Validation result from {@link validateGraphDef}. */
 type GraphDefValidation = {
@@ -1891,7 +2259,9 @@ declare const index_AdapterProvider: typeof AdapterProvider;
 type index_AdapterStats = AdapterStats;
 declare const index_AdapterTier: typeof AdapterTier;
 type index_AdmissionScore3DOptions = AdmissionScore3DOptions;
+type index_AdmissionScoredOptions<Dims extends string, TRaw = unknown> = AdmissionScoredOptions<Dims, TRaw>;
 type index_AdmissionScores = AdmissionScores;
+type index_AdmissionThresholds<Dims extends string> = AdmissionThresholds<Dims>;
 type index_AgentLoopGraph = AgentLoopGraph;
 declare const index_AgentLoopGraph: typeof AgentLoopGraph;
 type index_AgentLoopOptions = AgentLoopOptions;
@@ -1949,9 +2319,14 @@ declare const index_LLMResponse: typeof LLMResponse;
 type index_LLMTimeoutError = LLMTimeoutError;
 declare const index_LLMTimeoutError: typeof LLMTimeoutError;
 type index_McpToolSchema = McpToolSchema;
+type index_MemoryRetrievalBundle<TMem> = MemoryRetrievalBundle<TMem>;
+type index_MemoryRetrievalOptions<TMem> = MemoryRetrievalOptions<TMem>;
 type index_MemoryTier = MemoryTier;
 type index_MemoryTiersBundle<TMem> = MemoryTiersBundle<TMem>;
 type index_MemoryTiersOptions<TMem> = MemoryTiersOptions<TMem>;
+type index_MemoryWithKGOptions<TMem> = MemoryWithKGOptions<TMem>;
+type index_MemoryWithTiersOptions<TMem> = MemoryWithTiersOptions<TMem>;
+type index_MemoryWithVectorsOptions<TMem> = MemoryWithVectorsOptions<TMem>;
 declare const index_ModelCapabilities: typeof ModelCapabilities;
 declare const index_ModelFeatures: typeof ModelFeatures;
 declare const index_ModelLimits: typeof ModelLimits;
@@ -1975,9 +2350,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;
@@ -2000,6 +2375,7 @@ type index_WithRateLimiterOptions = WithRateLimiterOptions;
 declare const index_WithReplayCacheOptions: typeof WithReplayCacheOptions;
 type index_WithRetryOptions = WithRetryOptions;
 declare const index_admissionFilter3D: typeof admissionFilter3D;
+declare const index_admissionScored: typeof admissionScored;
 declare const index_agentLoop: typeof agentLoop;
 declare const index_agentMemory: typeof agentMemory;
 declare const index_anthropicAdapter: typeof anthropicAdapter;
@@ -2014,7 +2390,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;
@@ -2022,14 +2397,20 @@ declare const index_gatedStream: typeof gatedStream;
 declare const index_gaugesAsContext: typeof gaugesAsContext;
 declare const index_googleAdapter: typeof googleAdapter;
 declare const index_graphFromSpec: typeof graphFromSpec;
+declare const index_graphFromSpecReactive: typeof graphFromSpecReactive;
 declare const index_handoff: typeof handoff;
 declare const index_keywordFlagExtractor: typeof keywordFlagExtractor;
 declare const index_knobsAsTools: typeof knobsAsTools;
 declare const index_llmConsolidator: typeof llmConsolidator;
 declare const index_llmExtractor: typeof llmExtractor;
+declare const index_memoryRetrieval: typeof memoryRetrieval;
+declare const index_memoryWithKG: typeof memoryWithKG;
+declare const index_memoryWithTiers: typeof memoryWithTiers;
+declare const index_memoryWithVectors: typeof memoryWithVectors;
 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;
@@ -2037,7 +2418,9 @@ declare const index_resilientAdapter: typeof resilientAdapter;
 declare const index_streamExtractor: typeof streamExtractor;
 declare const index_streamingPromptNode: typeof streamingPromptNode;
 declare const index_suggestStrategy: typeof suggestStrategy;
+declare const index_suggestStrategyReactive: typeof suggestStrategyReactive;
 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 +2434,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_AdmissionScoredOptions as AdmissionScoredOptions, type index_AdmissionScores as AdmissionScores, type index_AdmissionThresholds as AdmissionThresholds, 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_MemoryRetrievalBundle as MemoryRetrievalBundle, type index_MemoryRetrievalOptions as MemoryRetrievalOptions, type index_MemoryTier as MemoryTier, type index_MemoryTiersBundle as MemoryTiersBundle, type index_MemoryTiersOptions as MemoryTiersOptions, type index_MemoryWithKGOptions as MemoryWithKGOptions, type index_MemoryWithTiersOptions as MemoryWithTiersOptions, type index_MemoryWithVectorsOptions as MemoryWithVectorsOptions, 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_admissionScored as admissionScored, 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_graphFromSpecReactive as graphFromSpecReactive, index_handoff as handoff, index_keywordFlagExtractor as keywordFlagExtractor, index_knobsAsTools as knobsAsTools, index_llmConsolidator as llmConsolidator, index_llmExtractor as llmExtractor, index_memoryRetrieval as memoryRetrieval, index_memoryWithKG as memoryWithKG, index_memoryWithTiers as memoryWithTiers, index_memoryWithVectors as memoryWithVectors, 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_suggestStrategyReactive as suggestStrategyReactive, 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 OpenAIToolSchema 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 GoogleSdkLike as H, type GraphDefValidation as I, type GraphFromSpecOptions as J, type HandoffOptions as K, type HttpErrorLike as L, type KeywordFlag as M, type KeywordFlagExtractorOptions as N, type KnobsAsToolsResult as O, type LLMConsolidatorOptions as P, type LLMExtractorOptions as Q, LLMTimeoutError as R, type McpToolSchema as S, type MemoryRetrievalBundle as T, type MemoryRetrievalOptions as U, type MemoryTier as V, type MemoryTiersBundle as W, type MemoryTiersOptions as X, type MemoryWithKGOptions as Y, type MemoryWithTiersOptions as Z, type MemoryWithVectorsOptions as _, type AdmissionScore3DOptions as a, validateGraphDef as a$, type PromptNodeOptions as a0, type RedactorOptions as a1, type ResilientAdapterBundle as a2, type ResilientAdapterOptions as a3, type RetrievalEntry as a4, type RetrievalPipelineOptions as a5, type RetrievalQuery as a6, type RetrievalTrace as a7, type StampedDelta as a8, type StrategyOperation as a9, gatedStream as aA, gaugesAsContext as aB, googleAdapter as aC, graphFromSpec as aD, graphFromSpecReactive as aE, handoff as aF, keywordFlagExtractor as aG, knobsAsTools as aH, llmConsolidator as aI, llmExtractor as aJ, memoryRetrieval as aK, memoryWithKG as aL, memoryWithTiers as aM, memoryWithVectors as aN, observableAdapter as aO, parseRateLimitFromError as aP, promptNode as aQ, redactor as aR, resilientAdapter as aS, streamExtractor as aT, streamingPromptNode as aU, suggestStrategy as aV, suggestStrategyReactive as aW, systemPromptBuilder as aX, toolCallExtractor as aY, toolRegistry as aZ, toolSelector as a_, type StrategyPlan as aa, type StreamingPromptNodeHandle as ab, type StreamingPromptNodeOptions as ac, type SuggestStrategyOptions as ad, type SystemPromptHandle as ae, ToolRegistryGraph as af, type ToolRegistryOptions as ag, type ToolResult as ah, type ToolSelectorOptions as ai, type WithBreakerOptions as aj, type WithBudgetGateOptions as ak, type WithDryRunBundle as al, type WithDryRunOptions as am, type WithRateLimiterOptions as an, type WithRetryOptions as ao, admissionFilter3D as ap, admissionScored as aq, agentLoop as ar, agentMemory as as, anthropicAdapter as at, chatStream as au, contentGate as av, costMeterExtractor as aw, dryRunAdapter as ax, fromLLM as ay, frozenContext as az, type AdmissionScoredOptions as b, withBreaker as b0, withBudgetGate as b1, withDryRun as b2, withRateLimiter as b3, withRetry as b4, withTimeout as b5, type AdmissionScores as c, type AdmissionThresholds as d, AgentLoopGraph as e, type AgentLoopOptions as f, type AgentLoopStatus as g, type AgentMemoryGraph as h, index as i, type AgentMemoryOptions as j, type AnthropicAdapterOptions as k, type AnthropicSdkLike as l, BudgetExhaustedError as m, type BudgetGateBundle as n, type BudgetTotals as o, ChatStreamGraph as p, type ChatStreamOptions as q, type ContentDecision as r, type ContentGateOptions as s, type CostMeterOptions as t, type CostMeterReading as u, type DryRunAdapterOptions as v, type FrozenContextOptions as w, type GatedStreamOptions as x, type GaugesAsContextOptions as y, type GoogleAdapterOptions as z };