@graphrefly/graphrefly 0.28.0 → 0.30.0

package/dist/{index-DEwTb_fm.d.cts → index-D6ajK8Mh.d.cts}

@@ -1,16 +1,16 @@
-import { a as Node, A as Actor } from './node-Cc1TniY8.cjs';
-import { D as DistillBundle, E as Extraction } from './composite-B-xqw4Kk.cjs';
-import { NodeInput } from './extra/sources.cjs';
-import { StorageHandle, StorageTier } from './extra/storage-core.cjs';
-import { G as Graph, a as GraphOptions, h as GraphAttachStorageOptions } from './graph-D48Qw9Cg.cjs';
-import { V as VectorIndexBundle, K as KnowledgeGraphGraph, L as LightCollectionBundle, a as VectorSearchResult } from './index-tbf2gKHd.cjs';
-import { T as TopicGraph } from './index-DyxjtScX.cjs';
-import { G as GateController, a as GateOptions } from './index-dtN7YA2x.cjs';
 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-O3GzJY2U.cjs';
-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-B-5zmAUv.cjs';
-import { R as ReactiveLogBundle } from './reactive-log-DPzuUDj5.cjs';
-import { a as CircuitBreakerOptions, e as CircuitBreaker, f as CircuitOpenError } from './resilience-Ba5-b4WD.cjs';
+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-dNCtjW8j.cjs';
+import { a as Node, A as Actor } from './node-BVV7G1bq.cjs';
+import { R as ReactiveLogBundle } from './reactive-log-5jFeNRmd.cjs';
+import { a as CircuitBreakerOptions, e as CircuitBreaker, f as CircuitOpenError } from './resilience-Q6Bt_7y0.cjs';
+import { NodeInput } from './extra/sources.cjs';
 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-BaTS7vVY.cjs';
+import { G as Graph, a as GraphOptions, h as GraphAttachStorageOptions } from './graph-C4Uxwv0T.cjs';
+import { T as TopicGraph } from './index-B-z8WaSd.cjs';
+import { G as GateController, a as GateOptions } from './index-DVNLe3pS.cjs';
+import { D as DistillBundle, E as Extraction } from './composite-nrRumJ7l.cjs';
+import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-lKuLYmHO.cjs';
+import { StorageHandle, StorageTier } from './extra/storage-core.cjs';
 
 /**
  * Observable adapter wrapper — the "inverted statistics" surface.
@@ -785,27 +785,33 @@ declare function googleAdapter(opts?: GoogleAdapterOptions): LLMAdapter;
 declare function dryRunPreset(): LLMAdapter;
 
 /**
- * AI surface patterns (roadmap §4.4).
+ * `fromLLM` — reactive LLM invocation sugar.
  *
- * Domain-layer factories for LLM-backed agents, chat, tool registries, and
- * agentic memory. Composed from core + extra + Phase 3–4.3 primitives.
+ * @module
  */
 
-type AgentLoopStatus = "idle" | "thinking" | "acting" | "done" | "error";
+type FromLLMOptions = {
+    name?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    tools?: readonly ToolDefinition[];
+    systemPrompt?: string;
+};
 /**
- * A single chunk from any streaming source (LLM tokens, WebSocket, SSE, file tail).
- * Generic enough for any streaming source, not just LLM.
+ * Reactive LLM invocation adapter. Returns a derived node that re-invokes
+ * the LLM whenever the messages dep changes.
+ *
+ * Uses `switchMap` internally — new invocations cancel stale in-flight ones.
  */
-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;
-};
+declare function fromLLM(adapter: LLMAdapter, messages: NodeInput<readonly ChatMessage[]>, opts?: FromLLMOptions): Node<LLMResponse | null>;
+
+/**
+ * `frozenContext` — prefix-cache-friendly snapshot of upstream context.
+ *
+ * @module
+ */
+
 type FrozenContextOptions = {
     /**
      * Reactive signal that triggers re-materialization. Each `DATA` emission
@@ -849,21 +855,60 @@ type FrozenContextOptions = {
  * @category patterns.ai
  */
 declare function frozenContext<T>(source: NodeInput<T>, opts?: FrozenContextOptions): Node<T | null>;
-type FromLLMOptions = {
+
+/**
+ * `promptNode` — universal LLM transform as a reactive derived node.
+ *
+ * @module
+ */
+
+type PromptNodeOptions = {
     name?: string;
     model?: string;
     temperature?: number;
     maxTokens?: number;
-    tools?: readonly ToolDefinition[];
+    /** 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;
     systemPrompt?: string;
+    meta?: Record<string, unknown>;
 };
 /**
- * Reactive LLM invocation adapter. Returns a derived node that re-invokes
- * the LLM whenever the messages dep changes.
+ * 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.
  *
- * Uses `switchMap` internally — new invocations cancel stale in-flight ones.
+ * @param adapter - LLM adapter (provider-agnostic).
+ * @param deps - Input nodes whose values feed the prompt.
+ * @param prompt - Static string or template function receiving dep values.
+ * @param opts - Optional configuration.
+ * @returns `Node` emitting LLM responses (string or parsed JSON).
  */
-declare function fromLLM(adapter: LLMAdapter, messages: NodeInput<readonly ChatMessage[]>, opts?: FromLLMOptions): Node<LLMResponse | null>;
+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.
+ *
+ * @module
+ */
+
+/**
+ * A single chunk from any streaming source (LLM tokens, WebSocket, SSE, file tail).
+ * Generic enough for any streaming source, not just LLM.
+ */
+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 StreamingPromptNodeOptions = {
     name?: string;
     model?: string;
@@ -890,38 +935,95 @@ type StreamingPromptNodeHandle<T> = {
  * 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 {@link streamExtractor}).
+ * Extractors can mount on the topic independently (see `streamExtractor`).
  * Zero overhead if nobody subscribes to the stream topic.
  *
- * The `output` node emits the final parsed result (like {@link promptNode}).
+ * The `output` node emits the final parsed result (like `promptNode`).
  * The async boundary is handled by `fromAny` (spec §5.10 compliant).
  */
 declare function streamingPromptNode<T = string>(adapter: LLMAdapter, deps: readonly Node<unknown>[], prompt: string | ((...depValues: unknown[]) => string), opts?: StreamingPromptNodeOptions): StreamingPromptNodeHandle<T>;
+type GatedStreamOptions = StreamingPromptNodeOptions & {
+    /** Gate options (maxPending, startOpen). */
+    gate?: Omit<GateOptions, "meta">;
+};
 /**
- * Mounts an extractor function on a streaming topic. Returns a derived node
- * that emits extracted values as chunks arrive.
+ * Bundle returned by {@link gatedStream}.
+ */
+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>;
+    /** Gate controller — approve, reject (aborts in-flight stream), modify. */
+    gate: GateController<T | null>;
+    /** Tear down everything. */
+    dispose: () => void;
+};
+/**
+ * Streaming LLM transform with human-in-the-loop gate integration.
  *
- * `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.
+ * Composes {@link streamingPromptNode} with `gate` so that:
+ * - `gate.reject()` discards the pending value **and** aborts the in-flight
+ *   stream (cancels the `AbortController`).
+ * - `gate.modify()` transforms the pending value before forwarding downstream.
+ * - `gate.approve()` forwards the final result as normal.
  *
- * @param streamTopic - The stream topic to extract from.
- * @param extractFn - `(accumulated: string) => T | null`.
- * @param opts - Optional name.
- * @returns Derived node emitting extracted values.
+ * 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.
  */
-declare function streamExtractor<T>(streamTopic: TopicGraph<StreamChunk>, extractFn: (accumulated: string) => T | null, opts?: {
+declare function gatedStream<T = string>(graph: Graph, name: string, adapter: LLMAdapter, deps: readonly Node<unknown>[], prompt: string | ((...depValues: unknown[]) => string), opts?: GatedStreamOptions): GatedStreamHandle<T>;
+
+/**
+ * `systemPromptBuilder` — assembles a reactive system prompt from sections.
+ *
+ * @module
+ */
+
+/**
+ * Assembles a system prompt from reactive sections. Each section is a
+ * `NodeInput<string>` — the prompt updates when any section changes.
+ */
+type SystemPromptHandle = Node<string> & {
+    dispose: () => void;
+};
+declare function systemPromptBuilder(sections: readonly NodeInput<string>[], opts?: {
+    separator?: string;
     name?: string;
-    /**
-     * Optional structural equals for the extractor output. When two
-     * consecutive chunks produce structurally-equal outputs, the framework
-     * emits `RESOLVED` instead of `DATA`, saving downstream work. Default:
-     * reference equality (`Object.is`). The library cannot know your
-     * output shape — supply this when your `extractFn` returns structured
-     * objects or arrays.
-     */
-    equals?: (a: T | null, b: T | null) => boolean;
-}): Node<T | null>;
+}): SystemPromptHandle;
+
+/**
+ * Cost meter extractor — counts chunks, characters, and estimates token usage.
+ * @module
+ */
+
+/** A cost meter reading from the stream. */
+type CostMeterReading = {
+    readonly chunkCount: number;
+    readonly charCount: number;
+    readonly estimatedTokens: number;
+};
+type CostMeterOptions = {
+    /** Characters per token approximation. Default: 4 (GPT-family). */
+    charsPerToken?: number;
+    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.
+ *
+ * Default structural equals suppresses DATA emission when two consecutive
+ * readings are identical (same chunk count + char count + token estimate).
+ */
+declare function costMeterExtractor(streamTopic: TopicGraph<StreamChunk>, opts?: CostMeterOptions): Node<CostMeterReading>;
+
+/**
+ * Keyword-flag extractor — scans accumulated stream text for configured patterns.
+ * @module
+ */
+
 /** A keyword match detected in the stream. */
 type KeywordFlag = {
     readonly label: string;
@@ -955,6 +1057,43 @@ type KeywordFlagExtractorOptions = {
  * suppresses DATA emission when no new flags were found this chunk.
  */
 declare function keywordFlagExtractor(streamTopic: TopicGraph<StreamChunk>, opts: KeywordFlagExtractorOptions): Node<readonly KeywordFlag[]>;
+
+/**
+ * Generic stream extractor — mounts an extract function on a streaming topic.
+ * @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.
+ *
+ * @param streamTopic - The stream topic to extract from.
+ * @param extractFn - `(accumulated: string) => T | null`.
+ * @param opts - Optional name.
+ * @returns Derived node emitting extracted values.
+ */
+declare function streamExtractor<T>(streamTopic: TopicGraph<StreamChunk>, extractFn: (accumulated: string) => T | null, opts?: {
+    name?: string;
+    /**
+     * Optional structural equals for the extractor output. When two
+     * consecutive chunks produce structurally-equal outputs, the framework
+     * emits `RESOLVED` instead of `DATA`, saving downstream work. Default:
+     * reference equality (`Object.is`). The library cannot know your
+     * output shape — supply this when your `extractFn` returns structured
+     * objects or arrays.
+     */
+    equals?: (a: T | null, b: T | null) => boolean;
+}): Node<T | null>;
+
+/**
+ * Tool-call extractor — scans accumulated stream text for complete JSON tool call objects.
+ * @module
+ */
+
 /** A tool call detected in the stream. */
 type ExtractedToolCall = {
     readonly name: string;
@@ -978,44 +1117,12 @@ type ExtractedToolCall = {
 declare function toolCallExtractor(streamTopic: TopicGraph<StreamChunk>, opts?: {
     name?: string;
 }): Node<readonly ExtractedToolCall[]>;
-/** A cost meter reading from the stream. */
-type CostMeterReading = {
-    readonly chunkCount: number;
-    readonly charCount: number;
-    readonly estimatedTokens: number;
-};
-type CostMeterOptions = {
-    /** Characters per token approximation. Default: 4 (GPT-family). */
-    charsPerToken?: number;
-    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.
- *
- * Default structural equals suppresses DATA emission when two consecutive
- * readings are identical (same chunk count + char count + token estimate).
- */
-declare function costMeterExtractor(streamTopic: TopicGraph<StreamChunk>, opts?: CostMeterOptions): Node<CostMeterReading>;
-/** Options for {@link redactor}. */
-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]"`.
- *
- * 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]"`).
+ * Content gate — classifies accumulated stream text as allow / review / block.
+ * @module
  */
-declare function redactor(streamTopic: TopicGraph<StreamChunk>, patterns: RegExp[], replaceFn?: (match: string, pattern: RegExp) => string, opts?: RedactorOptions): Node<StreamChunk>;
+
 /** Content safety decision. */
 type ContentDecision = "allow" | "block" | "review";
 /** Options for {@link contentGate}. */
@@ -1046,63 +1153,201 @@ type ContentGateOptions = {
  * @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>;
-type GatedStreamOptions = StreamingPromptNodeOptions & {
-    /** Gate options (maxPending, startOpen). */
-    gate?: Omit<GateOptions, "meta">;
-};
+
 /**
- * Bundle returned by {@link gatedStream}.
+ * Redactor — stream extractor that replaces matched patterns in accumulated text.
+ * @module
  */
-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>;
-    /** Gate controller — approve, reject (aborts in-flight stream), modify. */
-    gate: GateController<T | null>;
-    /** Tear down everything. */
-    dispose: () => void;
+
+/** Options for {@link redactor}. */
+type RedactorOptions = {
+    name?: string;
 };
 /**
- * Streaming LLM transform with human-in-the-loop gate integration.
+ * Stream extractor that replaces matched patterns in the accumulated text.
  *
- * Composes {@link streamingPromptNode} with {@link gate} so that:
- * - `gate.reject()` discards the pending value **and** aborts the in-flight
- *   stream (cancels the `AbortController`).
- * - `gate.modify()` transforms the pending value before forwarding downstream.
- * - `gate.approve()` forwards the final result as normal.
+ * 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]"`.
  *
- * 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.
+ * 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]"`).
  */
-declare function gatedStream<T = string>(graph: Graph, name: string, adapter: LLMAdapter, deps: readonly Node<unknown>[], prompt: string | ((...depValues: unknown[]) => string), opts?: GatedStreamOptions): GatedStreamHandle<T>;
-type PromptNodeOptions = {
-    name?: string;
+declare function redactor(streamTopic: TopicGraph<StreamChunk>, patterns: RegExp[], replaceFn?: (match: string, pattern: RegExp) => string, opts?: RedactorOptions): Node<StreamChunk>;
+
+type ChatStreamOptions = {
+    graph?: GraphOptions;
+    maxMessages?: number;
+};
+declare class ChatStreamGraph extends Graph {
+    private readonly _log;
+    readonly messages: Node<readonly ChatMessage[]>;
+    readonly latest: Node<ChatMessage | null>;
+    readonly messageCount: Node<number>;
+    constructor(name: string, opts?: ChatStreamOptions);
+    append(role: ChatMessage["role"], content: string, extra?: Partial<ChatMessage>): void;
+    appendToolResult(callId: string, content: string): void;
+    clear(): void;
+    allMessages(): readonly ChatMessage[];
+}
+declare function chatStream(name: string, opts?: ChatStreamOptions): ChatStreamGraph;
+
+type ToolRegistryOptions = {
+    graph?: GraphOptions;
+};
+declare class ToolRegistryGraph extends Graph {
+    readonly definitions: Node<ReadonlyMap<string, ToolDefinition>>;
+    readonly schemas: Node<readonly ToolDefinition[]>;
+    constructor(name: string, opts?: ToolRegistryOptions);
+    register(tool: ToolDefinition): void;
+    unregister(name: string): void;
+    execute(name: string, args: Record<string, unknown>): Promise<unknown>;
+    getDefinition(name: string): ToolDefinition | undefined;
+}
+declare function toolRegistry(name: string, opts?: ToolRegistryOptions): ToolRegistryGraph;
+
+/**
+ * Reactive agent loop — autonomous multi-turn LLM agent with tool execution.
+ */
+type AgentLoopStatus = "idle" | "thinking" | "acting" | "done" | "error";
+
+type AgentLoopOptions = {
+    graph?: GraphOptions;
+    adapter: LLMAdapter;
+    tools?: readonly ToolDefinition[];
+    systemPrompt?: string;
+    maxTurns?: number;
+    stopWhen?: (response: LLMResponse) => boolean;
+    onToolCall?: (call: ToolCall) => void;
+    maxMessages?: number;
     model?: string;
     temperature?: number;
     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;
-    systemPrompt?: string;
-    meta?: Record<string, unknown>;
+    /**
+     * Reactive tool-call splice (COMPOSITION-GUIDE §31 "interception is security").
+     * When set, the raw `toolCalls` node is piped through this transform before
+     * reaching the executor. The transform is a pure reactive composition —
+     * `(calls: Node<readonly ToolCall[]>) => Node<readonly ToolCall[]>` — so the
+     * gate is visible in `describe()` / `explain()` as a real edge (no hidden
+     * imperative wraps; §24).
+     *
+     * Typical uses:
+     * - **Filter / block** — `derived([calls, policy], ([raw, p]) => raw.filter(p))`
+     * - **Throttle / debounce** — `throttle(calls, windowMs)`
+     * - **Human-in-the-loop approval** — pipe through a `gate` controller so
+     *   calls wait for human approval before reaching the executor.
+     *
+     * The public `agent.toolCalls` node surfaces the POST-intercept stream, so
+     * audit / telemetry consumers see what the executor actually runs. The raw
+     * pre-intercept stream is not exposed — tests that need it should run
+     * without `interceptToolCalls` set (the identity case).
+     */
+    interceptToolCalls?: (calls: Node<readonly ToolCall[]>) => Node<readonly ToolCall[]>;
 };
+/** A single tool execution outcome: `{id, content}` where content is a JSON string. */
+interface ToolResult {
+    readonly id: string;
+    readonly content: string;
+}
 /**
- * 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.
+ * Reactive agent loop.
  *
- * @param adapter - LLM adapter (provider-agnostic).
- * @param deps - Input nodes whose values feed the prompt.
- * @param prompt - Static string or template function receiving dep values.
- * @param opts - Optional configuration.
- * @returns `Node` emitting LLM responses (string or parsed JSON).
+ * The loop is a reactive state machine wired entirely from graph primitives:
+ * `chat.messages` + `tools.schemas` + gating state feed a `promptInput`
+ * derived; `switchMap` turns non-null inputs into an LLM invocation via
+ * `fromAny(adapter.invoke(...))`. The LLM response drives chat writes and
+ * status transitions via effects. Tool calls flow through a reactive
+ * executor (`retrySource` + `rescue`) that retries once on error and
+ * surfaces terminal errors as JSON-shaped `ToolResult` payloads for the
+ * LLM to react to.
+ *
+ * **No imperative control flow inside the reactive layer** (spec §5.8-5.12):
+ * no `while` loops, no manual `await adapter.invoke`, no polling.
+ * `agent.run()` is a thin `awaitSettled` bridge so callers can still `await`
+ * the loop if they want a Promise.
+ *
+ * Public surface:
+ * - `chat` / `tools` — subgraphs (imperative `append` / `execute` at boundary)
+ * - `status` / `turn` / `aborted` — state nodes with explicit initials
+ * - `lastResponse` / `toolCalls` / `toolResults` — reactive outputs (SENTINEL until first emission; callers use `awaitSettled` / `subscribe`)
+ * - `run(userMessage?, signal?)` — optional user append + Promise bridge
+ * - `abort()` — imperative abort shim; flips `aborted` state
  */
-declare function promptNode<T = string>(adapter: LLMAdapter, deps: readonly Node<unknown>[], prompt: string | ((...depValues: unknown[]) => string), opts?: PromptNodeOptions): Node<T | null>;
+declare class AgentLoopGraph extends Graph {
+    readonly chat: ChatStreamGraph;
+    readonly tools: ToolRegistryGraph;
+    /** Current agent status. `initial: "idle"` — always has a real value. */
+    readonly status: Node<AgentLoopStatus>;
+    /** Turn count (completed LLM invocations this run). `initial: 0`. */
+    readonly turn: Node<number>;
+    /** Aborted flag; flipped by `abort()` or external `AbortSignal`. `initial: false`. */
+    readonly aborted: Node<boolean>;
+    /**
+     * Most recent LLM response. State-backed mirror driven by the response
+     * effect. `initial: null` — subscribers can read the cache synchronously;
+     * `awaitSettled(lastResponse)` or `firstWhere(lastResponse, v => v != null)`
+     * bridges to the first non-null value as a Promise.
+     */
+    readonly lastResponse: Node<LLMResponse | null>;
+    /** Tool-call batch emitted by the most recent LLM response. SENTINEL. */
+    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;
+    /**
+     * Per-agent monotonic run counter. Incremented at the start of every
+     * `run()` call; stamped onto `_terminalResult`'s DATA emissions so a
+     * caller's `awaitSettled` predicate resolves only on the matching run
+     * (prevents stale-resolution under re-entrant-ish composition).
+     */
+    private _runVersion;
+    /** Guards against overlapping `run()` calls. */
+    private _running;
+    /**
+     * Abort controller for the currently-running `adapter.invoke`. Minted per
+     * switchMap project; aborted when the reactive `aborted` node flips true
+     * OR when the caller's external `AbortSignal` fires. Threaded into
+     * `adapter.invoke({ signal })` AND `fromAny(promise, { signal })`, so the
+     * reactive layer sees ERROR when the wire call is cancelled.
+     */
+    private _currentAbortController;
+    constructor(name: string, opts: AgentLoopOptions);
+    /**
+     * Bridge to `Promise<LLMResponse>` over the reactive pipeline.
+     *
+     * - If `userMessage` is provided, appends it as a user message and
+     *   transitions status to `"thinking"` to kick the loop.
+     * - If `signal` is provided, binds it to the reactive `aborted` node
+     *   AND threads into `adapter.invoke({ signal })` so the wire call can
+     *   cancel mid-flight. The reactive `aborted` state + effect 3 guarantee
+     *   that even an adapter that ignores `signal` will stop emitting into
+     *   the agent graph.
+     * - Resolves when `status === "done"` with the final LLM response.
+     *   Rejects with `AbortError` when the abort signal fires pre-response.
+     *   Rejects with the stage error when `status === "error"`.
+     *
+     * **Concurrency:** `run()` refuses to overlap with a pending call on the
+     * same agent. Attempting to call `run()` while a previous `run()` is still
+     * in-flight throws a `RangeError` immediately. Each call increments an
+     * internal `_runVersion` and filters `_terminalResult` emissions by that
+     * version — belt-and-suspenders against stale resolution.
+     */
+    run(userMessage?: string, signal?: AbortSignal): Promise<LLMResponse | null>;
+    /**
+     * Flip the reactive `aborted` state. Equivalent to setting an external
+     * `AbortSignal` — the pipeline observes and transitions to `"done"`.
+     */
+    abort(): void;
+    destroy(): void;
+}
+declare function agentLoop(name: string, opts: AgentLoopOptions): AgentLoopGraph;
+
 /**
  * Options for {@link handoff}.
  */
@@ -1164,35 +1409,7 @@ type HandoffOptions = {
  * @category patterns.ai
  */
 declare function handoff<T>(from: NodeInput<T | null>, toFactory: (input: Node<T>) => Node<T | null>, opts?: HandoffOptions): Node<T | null>;
-type ChatStreamOptions = {
-    graph?: GraphOptions;
-    maxMessages?: number;
-};
-declare class ChatStreamGraph extends Graph {
-    private readonly _log;
-    readonly messages: Node<readonly ChatMessage[]>;
-    readonly latest: Node<ChatMessage | null>;
-    readonly messageCount: Node<number>;
-    constructor(name: string, opts?: ChatStreamOptions);
-    append(role: ChatMessage["role"], content: string, extra?: Partial<ChatMessage>): void;
-    appendToolResult(callId: string, content: string): void;
-    clear(): void;
-    allMessages(): readonly ChatMessage[];
-}
-declare function chatStream(name: string, opts?: ChatStreamOptions): ChatStreamGraph;
-type ToolRegistryOptions = {
-    graph?: GraphOptions;
-};
-declare class ToolRegistryGraph extends Graph {
-    readonly definitions: Node<ReadonlyMap<string, ToolDefinition>>;
-    readonly schemas: Node<readonly ToolDefinition[]>;
-    constructor(name: string, opts?: ToolRegistryOptions);
-    register(tool: ToolDefinition): void;
-    unregister(name: string): void;
-    execute(name: string, args: Record<string, unknown>): Promise<unknown>;
-    getDefinition(name: string): ToolDefinition | undefined;
-}
-declare function toolRegistry(name: string, opts?: ToolRegistryOptions): ToolRegistryGraph;
+
 /**
  * Options for {@link toolSelector}.
  */
@@ -1229,37 +1446,7 @@ interface ToolSelectorOptions {
  * ```
  */
 declare function toolSelector(allTools: NodeInput<readonly ToolDefinition[]>, constraints: readonly NodeInput<(tool: ToolDefinition) => boolean>[], opts?: ToolSelectorOptions): Node<readonly ToolDefinition[]>;
-/**
- * Assembles a system prompt from reactive sections. Each section is a
- * `NodeInput<string>` — the prompt updates when any section changes.
- */
-type SystemPromptHandle = Node<string> & {
-    dispose: () => void;
-};
-declare function systemPromptBuilder(sections: readonly NodeInput<string>[], opts?: {
-    separator?: string;
-    name?: string;
-}): SystemPromptHandle;
-type LLMExtractorOptions = {
-    adapter: LLMAdapter;
-    model?: string;
-    temperature?: number;
-    maxTokens?: number;
-};
-/**
- * Returns an `extractFn` callback for `distill()` that invokes an LLM to
- * extract structured memories from raw input.
- *
- * The system prompt should instruct the LLM to return JSON matching
- * `Extraction<TMem>` shape: `{ upsert: [{ key, value }], remove?: [key] }`.
- */
-declare function llmExtractor<TRaw, TMem>(systemPrompt: string, opts: LLMExtractorOptions): (raw: TRaw, existing: ReadonlyMap<string, TMem>) => NodeInput<Extraction<TMem>>;
-type LLMConsolidatorOptions = LLMExtractorOptions;
-/**
- * Returns a `consolidateFn` callback for `distill()` that invokes an LLM to
- * cluster and merge related memories.
- */
-declare function llmConsolidator<TMem>(systemPrompt: string, opts: LLMConsolidatorOptions): (entries: ReadonlyMap<string, TMem>) => NodeInput<Extraction<TMem>>;
+
 /** Scores for the three admission dimensions. Each 0–1. */
 type AdmissionScores = {
     readonly persistence: number;
@@ -1282,34 +1469,7 @@ type AdmissionScore3DOptions = {
  * and personalValue, then applies thresholds.
  */
 declare function admissionFilter3D(opts?: AdmissionScore3DOptions): (raw: unknown) => boolean;
-type MemoryTier = "permanent" | "active" | "archived";
-type MemoryTiersOptions<TMem> = {
-    /** Exponential decay rate per second for active tier.
-     *  Default: 7-day half-life ≈ ln(2)/(7×86400) ≈ 0.00000114. */
-    decayRate?: number;
-    /** Max entries in the active tier before archiving lowest-scored (default 1000). */
-    maxActive?: number;
-    /** Score threshold below which active entries get archived (default 0.1). */
-    archiveThreshold?: number;
-    /** Predicate: true → entry belongs in permanent tier (default: never). */
-    permanentFilter?: (key: string, mem: TMem) => boolean;
-    /** Storage tier for the archive. Omit to disable archiving. */
-    archiveTier?: StorageTier;
-    /** Options forwarded to `graph.attachStorage` for the archive tier. */
-    archiveStorageOptions?: GraphAttachStorageOptions;
-};
-type MemoryTiersBundle<TMem> = {
-    /** Permanent tier: never evicted. */
-    readonly permanent: LightCollectionBundle<TMem>;
-    /** Active entries node (reactive, holds ReadonlyMap). */
-    readonly activeEntries: Node<unknown>;
-    /** Archive storage handle (null if no tier configured). */
-    readonly archiveHandle: StorageHandle | null;
-    /** Classify a key into its current tier. */
-    tierOf: (key: string) => MemoryTier;
-    /** Move a key to the permanent tier. */
-    markPermanent: (key: string, value: TMem) => void;
-};
+
 type RetrievalQuery = {
     readonly text?: string;
     readonly vector?: readonly number[];
@@ -1369,6 +1529,38 @@ type RetrievalTrace<TMem> = {
     readonly ranked: ReadonlyArray<RetrievalEntry<TMem>>;
     readonly packed: ReadonlyArray<RetrievalEntry<TMem>>;
 };
+
+type MemoryTier = "permanent" | "active" | "archived";
+type MemoryTiersOptions<TMem> = {
+    /** Exponential decay rate per second for active tier.
+     *  Default: 7-day half-life ≈ ln(2)/(7×86400) ≈ 0.00000114. */
+    decayRate?: number;
+    /** Max entries in the active tier before archiving lowest-scored (default 1000). */
+    maxActive?: number;
+    /** Score threshold below which active entries get archived (default 0.1). */
+    archiveThreshold?: number;
+    /** Predicate: true → entry belongs in permanent tier (default: never). */
+    permanentFilter?: (key: string, mem: TMem) => boolean;
+    /** Storage tier for the archive. Omit to disable archiving. */
+    archiveTier?: StorageTier;
+    /** Options forwarded to `graph.attachStorage` for the archive tier. */
+    archiveStorageOptions?: GraphAttachStorageOptions;
+};
+/** @internal */
+declare const DEFAULT_DECAY_RATE: number;
+type MemoryTiersBundle<TMem> = {
+    /** Permanent tier: never evicted. */
+    readonly permanent: LightCollectionBundle<TMem>;
+    /** Active entries node (reactive, holds ReadonlyMap). */
+    readonly activeEntries: Node<unknown>;
+    /** Archive storage handle (null if no tier configured). */
+    readonly archiveHandle: StorageHandle | null;
+    /** Classify a key into its current tier. */
+    tierOf: (key: string) => MemoryTier;
+    /** Move a key to the permanent tier. */
+    markPermanent: (key: string, value: TMem) => void;
+};
+
 type AgentMemoryOptions<TMem = unknown> = {
     graph?: GraphOptions;
     /** LLM adapter for extraction and consolidation. */
@@ -1397,269 +1589,120 @@ type AgentMemoryOptions<TMem = unknown> = {
     vectorDimensions?: number;
     /**
      * B12: optional accessor for an entry's hierarchical context breadcrumb
-     * (e.g. `["projects", "auth", "tokens"]`). When supplied alongside
-     * `contextWeight > 0`, retrieval applies a score boost for entries whose
-     * context shares a prefix with the query's `context`. Entries without
-     * a breadcrumb are scored flatly.
-     */
-    contextOf?: (mem: TMem) => readonly string[] | undefined;
-    /**
-     * B12: hierarchical context boost multiplier. Score is scaled by
-     * `(1 + contextWeight * sharedDepth / queryDepth)` when both the query
-     * and entry supply a `context`. Default: 0.
-     */
-    contextWeight?: number;
-    /** Extract embedding vector from a memory entry (enables vector index). */
-    embedFn?: (mem: TMem) => readonly number[] | undefined;
-    /** Enable knowledge graph for entity/relation tracking. */
-    enableKnowledgeGraph?: boolean;
-    /** Extract entities and relations from 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;
-    /** 3-tier storage configuration. Omit to use single-tier (existing behavior). */
-    tiers?: MemoryTiersOptions<TMem>;
-    /** Retrieval pipeline configuration. Requires vector index or knowledge graph. */
-    retrieval?: {
-        /** Max candidates from vector search (default 20). */
-        topK?: number;
-        /** KG expansion depth in hops (default 1). */
-        graphDepth?: number;
-    };
-    /** Periodic reflection/consolidation configuration. */
-    reflection?: {
-        /** Interval in ms between consolidation runs (default 300_000 = 5 min). */
-        interval?: number;
-        /** Enable/disable periodic reflection (default true when consolidateFn is available). */
-        enabled?: boolean;
-    };
-};
-type AgentMemoryGraph<TMem = unknown> = Graph & {
-    readonly distillBundle: DistillBundle<TMem>;
-    readonly compact: Node<Array<{
-        key: string;
-        value: TMem;
-        score: number;
-    }>>;
-    readonly size: Node<number>;
-    /** Vector index bundle (null if not enabled). */
-    readonly vectors: VectorIndexBundle<TMem> | null;
-    /** Knowledge graph (null if not enabled). */
-    readonly kg: KnowledgeGraphGraph<unknown, string> | null;
-    /** Memory tiers bundle (null if not configured). */
-    readonly memoryTiers: MemoryTiersBundle<TMem> | null;
-    /** Retrieval result node (null if no retrieval pipeline configured). */
-    readonly retrieval: Node<ReadonlyArray<RetrievalEntry<TMem>>> | null;
-    /** Latest retrieval trace for observability (null if no retrieval pipeline). */
-    readonly retrievalTrace: Node<RetrievalTrace<TMem> | null> | null;
-    /**
-     * Execute a retrieval query (null if no retrieval pipeline).
-     *
-     * **Synchronous consumer API** — returns the result immediately and batch-writes
-     * `retrieval` and `retrievalTrace` state nodes for observers. Reads the store
-     * snapshot and context value **at call time** (external-boundary read).
-     *
-     * **Do not call from inside a reactive fn body** (derived fn, subscribe callback,
-     * effect body). The cache reads would become transitive protocol violations and
-     * may observe wave-progressive rather than wave-final state.
-     *
-     * **Caller-batch caveat:** if invoked inside a caller's `batch(() => ...)` alongside
-     * upstream store mutations, the store snapshot reflects what has been committed to
-     * `store.entries.cache` at call time. State-backed stores update cache synchronously
-     * so batched inserts are visible; derived-backed store transforms may defer. If you
-     * need fresh state after batched mutations, call `retrieve` after the batch returns.
-     */
-    readonly retrieve: ((query: RetrievalQuery) => ReadonlyArray<RetrievalEntry<TMem>>) | null;
-    /**
-     * Reactive sibling of {@link retrieve}. Given a reactive
-     * `RetrievalQuery | null` source, returns a `Node` emitting the packed
-     * retrieval results. Composable with graph topology — subscribe it,
-     * chain it into `promptNode`, or switchMap over a user-input node.
-     * Null when no retrieval pipeline is configured.
-     */
-    readonly retrieveReactive: ((queryInput: NodeInput<RetrievalQuery | null>) => Node<ReadonlyArray<RetrievalEntry<TMem>>>) | null;
-};
-declare function agentMemory<TMem = unknown>(name: string, source: NodeInput<unknown>, opts: AgentMemoryOptions<TMem>): AgentMemoryGraph<TMem>;
-type AgentLoopOptions = {
-    graph?: GraphOptions;
-    adapter: LLMAdapter;
-    tools?: readonly ToolDefinition[];
-    systemPrompt?: string;
-    maxTurns?: number;
-    stopWhen?: (response: LLMResponse) => boolean;
-    onToolCall?: (call: ToolCall) => void;
-    maxMessages?: number;
-    model?: string;
-    temperature?: number;
-    maxTokens?: number;
-    /**
-     * Reactive tool-call splice (COMPOSITION-GUIDE §31 "interception is security").
-     * When set, the raw `toolCalls` node is piped through this transform before
-     * reaching the executor. The transform is a pure reactive composition —
-     * `(calls: Node<readonly ToolCall[]>) => Node<readonly ToolCall[]>` — so the
-     * gate is visible in `describe()` / `explain()` as a real edge (no hidden
-     * imperative wraps; §24).
-     *
-     * Typical uses:
-     * - **Filter / block** — `derived([calls, policy], ([raw, p]) => raw.filter(p))`
-     * - **Throttle / debounce** — `throttle(calls, windowMs)`
-     * - **Human-in-the-loop approval** — pipe through a `gate` controller so
-     *   calls wait for human approval before reaching the executor.
-     *
-     * The public `agent.toolCalls` node surfaces the POST-intercept stream, so
-     * audit / telemetry consumers see what the executor actually runs. The raw
-     * pre-intercept stream is not exposed — tests that need it should run
-     * without `interceptToolCalls` set (the identity case).
-     */
-    interceptToolCalls?: (calls: Node<readonly ToolCall[]>) => Node<readonly ToolCall[]>;
-};
-/** A single tool execution outcome: `{id, content}` where content is a JSON string. */
-interface ToolResult {
-    readonly id: string;
-    readonly content: string;
-}
-/**
- * Reactive agent loop.
- *
- * The loop is a reactive state machine wired entirely from graph primitives:
- * `chat.messages` + `tools.schemas` + gating state feed a `promptInput`
- * derived; `switchMap` turns non-null inputs into an LLM invocation via
- * `fromAny(adapter.invoke(...))`. The LLM response drives chat writes and
- * status transitions via effects. Tool calls flow through a reactive
- * executor (`retrySource` + `rescue`) that retries once on error and
- * surfaces terminal errors as JSON-shaped `ToolResult` payloads for the
- * LLM to react to.
- *
- * **No imperative control flow inside the reactive layer** (spec §5.8-5.12):
- * no `while` loops, no manual `await adapter.invoke`, no polling.
- * `agent.run()` is a thin `awaitSettled` bridge so callers can still `await`
- * the loop if they want a Promise.
- *
- * Public surface:
- * - `chat` / `tools` — subgraphs (imperative `append` / `execute` at boundary)
- * - `status` / `turn` / `aborted` — state nodes with explicit initials
- * - `lastResponse` / `toolCalls` / `toolResults` — reactive outputs (SENTINEL until first emission; callers use `awaitSettled` / `subscribe`)
- * - `run(userMessage?, signal?)` — optional user append + Promise bridge
- * - `abort()` — imperative abort shim; flips `aborted` state
- */
-declare class AgentLoopGraph extends Graph {
-    readonly chat: ChatStreamGraph;
-    readonly tools: ToolRegistryGraph;
-    /** Current agent status. `initial: "idle"` — always has a real value. */
-    readonly status: Node<AgentLoopStatus>;
-    /** Turn count (completed LLM invocations this run). `initial: 0`. */
-    readonly turn: Node<number>;
-    /** Aborted flag; flipped by `abort()` or external `AbortSignal`. `initial: false`. */
-    readonly aborted: Node<boolean>;
-    /**
-     * Most recent LLM response. State-backed mirror driven by the response
-     * effect. `initial: null` — subscribers can read the cache synchronously;
-     * `awaitSettled(lastResponse)` or `firstWhere(lastResponse, v => v != null)`
-     * bridges to the first non-null value as a Promise.
-     */
-    readonly lastResponse: Node<LLMResponse | null>;
-    /** Tool-call batch emitted by the most recent LLM response. SENTINEL. */
-    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;
-    /**
-     * Per-agent monotonic run counter. Incremented at the start of every
-     * `run()` call; stamped onto `_terminalResult`'s DATA emissions so a
-     * caller's `awaitSettled` predicate resolves only on the matching run
-     * (prevents stale-resolution under re-entrant-ish composition).
+     * (e.g. `["projects", "auth", "tokens"]`). When supplied alongside
+     * `contextWeight > 0`, retrieval applies a score boost for entries whose
+     * context shares a prefix with the query's `context`. Entries without
+     * a breadcrumb are scored flatly.
      */
-    private _runVersion;
-    /** Guards against overlapping `run()` calls. */
-    private _running;
+    contextOf?: (mem: TMem) => readonly string[] | undefined;
     /**
-     * Abort controller for the currently-running `adapter.invoke`. Minted per
-     * switchMap project; aborted when the reactive `aborted` node flips true
-     * OR when the caller's external `AbortSignal` fires. Threaded into
-     * `adapter.invoke({ signal })` AND `fromAny(promise, { signal })`, so the
-     * reactive layer sees ERROR when the wire call is cancelled.
+     * B12: hierarchical context boost multiplier. Score is scaled by
+     * `(1 + contextWeight * sharedDepth / queryDepth)` when both the query
+     * and entry supply a `context`. Default: 0.
      */
-    private _currentAbortController;
-    constructor(name: string, opts: AgentLoopOptions);
+    contextWeight?: number;
+    /** Extract embedding vector from a memory entry (enables vector index). */
+    embedFn?: (mem: TMem) => readonly number[] | undefined;
+    /** Enable knowledge graph for entity/relation tracking. */
+    enableKnowledgeGraph?: boolean;
+    /** Extract entities and relations from 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;
+    /** 3-tier storage configuration. Omit to use single-tier (existing behavior). */
+    tiers?: MemoryTiersOptions<TMem>;
+    /** Retrieval pipeline configuration. Requires vector index or knowledge graph. */
+    retrieval?: {
+        /** Max candidates from vector search (default 20). */
+        topK?: number;
+        /** KG expansion depth in hops (default 1). */
+        graphDepth?: number;
+    };
+    /** Periodic reflection/consolidation configuration. */
+    reflection?: {
+        /** Interval in ms between consolidation runs (default 300_000 = 5 min). */
+        interval?: number;
+        /** Enable/disable periodic reflection (default true when consolidateFn is available). */
+        enabled?: boolean;
+    };
+};
+type AgentMemoryGraph<TMem = unknown> = Graph & {
+    readonly distillBundle: DistillBundle<TMem>;
+    readonly compact: Node<Array<{
+        key: string;
+        value: TMem;
+        score: number;
+    }>>;
+    readonly size: Node<number>;
+    /** Vector index bundle (null if not enabled). */
+    readonly vectors: VectorIndexBundle<TMem> | null;
+    /** Knowledge graph (null if not enabled). */
+    readonly kg: KnowledgeGraphGraph<unknown, string> | null;
+    /** Memory tiers bundle (null if not configured). */
+    readonly memoryTiers: MemoryTiersBundle<TMem> | null;
+    /** Retrieval result node (null if no retrieval pipeline configured). */
+    readonly retrieval: Node<ReadonlyArray<RetrievalEntry<TMem>>> | null;
+    /** Latest retrieval trace for observability (null if no retrieval pipeline). */
+    readonly retrievalTrace: Node<RetrievalTrace<TMem> | null> | null;
     /**
-     * Bridge to `Promise<LLMResponse>` over the reactive pipeline.
+     * Execute a retrieval query (null if no retrieval pipeline).
      *
-     * - If `userMessage` is provided, appends it as a user message and
-     *   transitions status to `"thinking"` to kick the loop.
-     * - If `signal` is provided, binds it to the reactive `aborted` node
-     *   AND threads into `adapter.invoke({ signal })` so the wire call can
-     *   cancel mid-flight. The reactive `aborted` state + effect 3 guarantee
-     *   that even an adapter that ignores `signal` will stop emitting into
-     *   the agent graph.
-     * - Resolves when `status === "done"` with the final LLM response.
-     *   Rejects with `AbortError` when the abort signal fires pre-response.
-     *   Rejects with the stage error when `status === "error"`.
+     * **Synchronous consumer API** — returns the result immediately and batch-writes
+     * `retrieval` and `retrievalTrace` state nodes for observers. Reads the store
+     * snapshot and context value **at call time** (external-boundary read).
      *
-     * **Concurrency:** `run()` refuses to overlap with a pending call on the
-     * same agent. Attempting to call `run()` while a previous `run()` is still
-     * in-flight throws a `RangeError` immediately. Each call increments an
-     * internal `_runVersion` and filters `_terminalResult` emissions by that
-     * version — belt-and-suspenders against stale resolution.
+     * **Do not call from inside a reactive fn body** (derived fn, subscribe callback,
+     * effect body). The cache reads would become transitive protocol violations and
+     * may observe wave-progressive rather than wave-final state.
+     *
+     * **Caller-batch caveat:** if invoked inside a caller's `batch(() => ...)` alongside
+     * upstream store mutations, the store snapshot reflects what has been committed to
+     * `store.entries.cache` at call time. State-backed stores update cache synchronously
+     * so batched inserts are visible; derived-backed store transforms may defer. If you
+     * need fresh state after batched mutations, call `retrieve` after the batch returns.
      */
-    run(userMessage?: string, signal?: AbortSignal): Promise<LLMResponse | null>;
+    readonly retrieve: ((query: RetrievalQuery) => ReadonlyArray<RetrievalEntry<TMem>>) | null;
     /**
-     * Flip the reactive `aborted` state. Equivalent to setting an external
-     * `AbortSignal` — the pipeline observes and transitions to `"done"`.
+     * Reactive sibling of {@link retrieve}. Given a reactive
+     * `RetrievalQuery | null` source, returns a `Node` emitting the packed
+     * retrieval results. Composable with graph topology — subscribe it,
+     * chain it into `promptNode`, or switchMap over a user-input node.
+     * Null when no retrieval pipeline is configured.
      */
-    abort(): void;
-    destroy(): void;
-}
-declare function agentLoop(name: string, opts: AgentLoopOptions): AgentLoopGraph;
-/** OpenAI function-calling tool schema. */
-type OpenAIToolSchema = {
-    readonly type: "function";
-    readonly function: {
-        readonly name: string;
-        readonly description: string;
-        readonly parameters: Record<string, unknown>;
-    };
-};
-/** MCP (Model Context Protocol) tool schema. */
-type McpToolSchema = {
-    readonly name: string;
-    readonly description: string;
-    readonly inputSchema: Record<string, unknown>;
+    readonly retrieveReactive: ((queryInput: NodeInput<RetrievalQuery | null>) => Node<ReadonlyArray<RetrievalEntry<TMem>>>) | null;
 };
-/** Result of {@link knobsAsTools}. */
-type KnobsAsToolsResult = {
-    /** OpenAI function-calling tool schemas. */
-    readonly openai: readonly OpenAIToolSchema[];
-    /** MCP tool schemas. */
-    readonly mcp: readonly McpToolSchema[];
-    /** GraphReFly ToolDefinitions with handlers that call `graph.set()`. */
-    readonly definitions: readonly ToolDefinition[];
+declare function agentMemory<TMem = unknown>(name: string, source: NodeInput<unknown>, opts: AgentMemoryOptions<TMem>): AgentMemoryGraph<TMem>;
+
+type LLMExtractorOptions = {
+    adapter: LLMAdapter;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
 };
 /**
- * Derive tool schemas from a graph's writable (knob) nodes.
- *
- * Knobs are state nodes whose `meta.access` is `"llm"`, `"both"`, or absent
- * (default: writable). Each knob becomes a tool that calls `graph.set()`.
- *
- * Speaks **domain language** (spec §5.4): the returned schemas use node names
- * and meta descriptions — no protocol internals exposed.
+ * Returns an `extractFn` callback for `distill()` that invokes an LLM to
+ * extract structured memories from raw input.
  *
- * @param graph - The graph to introspect.
- * @param actor - Optional actor for guard-scoped describe.
- * @returns OpenAI, MCP, and GraphReFly tool schemas.
+ * The system prompt should instruct the LLM to return JSON matching
+ * `Extraction<TMem>` shape: `{ upsert: [{ key, value }], remove?: [key] }`.
  */
-declare function knobsAsTools(graph: Graph, actor?: Actor): KnobsAsToolsResult;
+declare function llmExtractor<TRaw, TMem>(systemPrompt: string, opts: LLMExtractorOptions): (raw: TRaw, existing: ReadonlyMap<string, TMem>) => NodeInput<Extraction<TMem>>;
+type LLMConsolidatorOptions = LLMExtractorOptions;
+/**
+ * Returns a `consolidateFn` callback for `distill()` that invokes an LLM to
+ * cluster and merge related memories.
+ */
+declare function llmConsolidator<TMem>(systemPrompt: string, opts: LLMConsolidatorOptions): (entries: ReadonlyMap<string, TMem>) => NodeInput<Extraction<TMem>>;
+
 type GaugesAsContextOptions = {
     /** Group gauges by `meta.tags` (default true). */
     groupByTags?: boolean;
@@ -1691,25 +1734,7 @@ type GaugesAsContextOptions = {
  * @returns A formatted string ready for system prompt injection.
  */
 declare function gaugesAsContext(graph: Graph, actor?: Actor, options?: GaugesAsContextOptions): string;
-/** Validation result from {@link validateGraphDef}. */
-type GraphDefValidation = {
-    readonly valid: boolean;
-    readonly errors: readonly string[];
-};
-/**
- * Validate an LLM-generated graph definition before passing to
- * `Graph.fromSnapshot()`.
- *
- * Checks:
- * - Required fields: `name`, `nodes`, `edges`
- * - Node types are valid enum values
- * - Edge `from`/`to` reference existing nodes
- * - No duplicate edge entries
- *
- * @param def - The graph definition to validate (parsed JSON).
- * @returns Validation result with errors array.
- */
-declare function validateGraphDef(def: unknown): GraphDefValidation;
+
 type GraphFromSpecOptions = {
     model?: string;
     temperature?: number;
@@ -1732,6 +1757,46 @@ type GraphFromSpecOptions = {
  * @throws On invalid LLM output or validation failure.
  */
 declare function graphFromSpec(naturalLanguage: string, adapter: LLMAdapter, opts?: GraphFromSpecOptions): Promise<Graph>;
+
+/** OpenAI function-calling tool schema. */
+type OpenAIToolSchema = {
+    readonly type: "function";
+    readonly function: {
+        readonly name: string;
+        readonly description: string;
+        readonly parameters: Record<string, unknown>;
+    };
+};
+/** MCP (Model Context Protocol) tool schema. */
+type McpToolSchema = {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+};
+/** Result of {@link knobsAsTools}. */
+type KnobsAsToolsResult = {
+    /** OpenAI function-calling tool schemas. */
+    readonly openai: readonly OpenAIToolSchema[];
+    /** MCP tool schemas. */
+    readonly mcp: readonly McpToolSchema[];
+    /** GraphReFly ToolDefinitions with handlers that call `graph.set()`. */
+    readonly definitions: readonly ToolDefinition[];
+};
+/**
+ * Derive tool schemas from a graph's writable (knob) nodes.
+ *
+ * Knobs are state nodes whose `meta.access` is `"llm"`, `"both"`, or absent
+ * (default: writable). Each knob becomes a tool that calls `graph.set()`.
+ *
+ * Speaks **domain language** (spec §5.4): the returned schemas use node names
+ * and meta descriptions — no protocol internals exposed.
+ *
+ * @param graph - The graph to introspect.
+ * @param actor - Optional actor for guard-scoped describe.
+ * @returns OpenAI, MCP, and GraphReFly tool schemas.
+ */
+declare function knobsAsTools(graph: Graph, actor?: Actor): KnobsAsToolsResult;
+
 /** A single operation in a strategy plan. */
 type StrategyOperation = {
     readonly type: "add_node";
@@ -1788,6 +1853,40 @@ type SuggestStrategyOptions = {
  */
 declare function suggestStrategy(graph: Graph, problem: string, adapter: LLMAdapter, opts?: SuggestStrategyOptions): Promise<StrategyPlan>;
 
+/** Validation result from {@link validateGraphDef}. */
+type GraphDefValidation = {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+};
+/**
+ * Validate an LLM-generated graph definition before passing to
+ * `Graph.fromSnapshot()`.
+ *
+ * Checks:
+ * - Required fields: `name`, `nodes`, `edges`
+ * - Node types are valid enum values
+ * - Edge `from`/`to` reference existing nodes
+ * - No duplicate edge entries
+ *
+ * @param def - The graph definition to validate (parsed JSON).
+ * @returns Validation result with errors array.
+ */
+declare function validateGraphDef(def: unknown): GraphDefValidation;
+
+/**
+ * AI surface patterns (roadmap §4.4).
+ *
+ * Domain-layer factories for LLM-backed agents, chat, tool registries, and
+ * agentic memory. Composed from core + extra + Phase 3–4.3 primitives.
+ *
+ * This file is the public barrel — it re-exports symbols from the sibling
+ * folders (`prompts/`, `extractors/`, `safety/`, `agents/`, `memory/`,
+ * `graph-integration/`, and the existing `adapters/` tree). No implementation
+ * code lives here; see each sibling folder for the actual primitives.
+ *
+ * @module
+ */
+
 declare const index_AdapterProvider: typeof AdapterProvider;
 type index_AdapterStats = AdapterStats;
 declare const index_AdapterTier: typeof AdapterTier;
@@ -1821,6 +1920,7 @@ type index_ContentGateOptions = ContentGateOptions;
 type index_CostMeterOptions = CostMeterOptions;
 type index_CostMeterReading = CostMeterReading;
 declare const index_CreateAdapterOptions: typeof CreateAdapterOptions;
+declare const index_DEFAULT_DECAY_RATE: typeof DEFAULT_DECAY_RATE;
 type index_DryRunAdapterOptions = DryRunAdapterOptions;
 type index_ExtractedToolCall = ExtractedToolCall;
 declare const index_FallbackAdapterOptions: typeof FallbackAdapterOptions;
@@ -1951,7 +2051,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, 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_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 { type RetrievalTrace as $, type AdapterStats as A, type BudgetCaps as B, type CallStatsEvent as C, type DryRunAdapterOptions as D, type ExtractedToolCall as E, type FromLLMOptions as F, type GatedStreamHandle as G, type HandoffOptions as H, type HttpErrorLike as I, type KeywordFlagExtractorOptions as J, type KeywordFlag as K, type KnobsAsToolsResult as L, type LLMConsolidatorOptions as M, type LLMExtractorOptions as N, LLMTimeoutError as O, type McpToolSchema as P, type MemoryTier as Q, type MemoryTiersBundle as R, type MemoryTiersOptions as S, type OpenAIToolSchema as T, type PromptNodeOptions as U, type RedactorOptions as V, type ResilientAdapterBundle as W, type ResilientAdapterOptions as X, type RetrievalEntry as Y, type RetrievalPipelineOptions as Z, type RetrievalQuery as _, type AdmissionScore3DOptions as a, type StrategyOperation as a0, type StrategyPlan as a1, type StreamChunk as a2, type StreamingPromptNodeHandle as a3, type StreamingPromptNodeOptions as a4, type SuggestStrategyOptions as a5, type SystemPromptHandle as a6, ToolRegistryGraph as a7, type ToolRegistryOptions as a8, type ToolResult 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 ToolSelectorOptions as aa, type WithBreakerOptions as ab, type WithBudgetGateOptions as ac, type WithDryRunBundle as ad, type WithDryRunOptions as ae, type WithRateLimiterOptions as af, type WithRetryOptions as ag, admissionFilter3D as ah, agentLoop as ai, agentMemory as aj, anthropicAdapter as ak, chatStream as al, contentGate as am, costMeterExtractor as an, dryRunAdapter as ao, dryRunPreset 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 FrozenContextOptions as t, type GatedStreamOptions as u, type GaugesAsContextOptions as v, type GoogleAdapterOptions as w, type GoogleSdkLike as x, type GraphDefValidation as y, type GraphFromSpecOptions 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 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 };