@graphrefly/graphrefly 0.31.0 → 0.33.0

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

@@ -1,17 +1,17 @@
-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 { 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-B2LfBvNc.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-Bg0a4VSf.js';
+import { a as Node, A as Actor } from './node-8qx0kgYt.js';
+import { R as ReactiveLogBundle } from './reactive-log-CqaBg8nf.js';
+import { a as CircuitBreakerOptions, e as CircuitBreaker, f as CircuitOpenError } from './resilience-RjDIHZNZ.js';
 import { NodeInput } from './extra/sources.js';
-import { W as WithReplayCacheOptions, F as FallbackAdapterOptions, a as FallbackFixture, b as FallbackMissError, c as FallbackMissPolicy, R as ReplayCacheKeyContext, d as ReplayCacheMissError, e as ReplayCacheMode, f as canonicalJson, g as fallbackAdapter, w as withReplayCache } from './fallback-DRjJ_ZM8.js';
-import { G as Graph, a as GraphOptions, h as GraphAttachStorageOptions } from './graph-CWeI0aHd.js';
-import { T as TopicGraph } from './index-CvS9IuTG.js';
-import { G as GateController, a as GateOptions } from './index-CFW32Dy1.js';
-import { D as DistillBundle, E as Extraction } from './composite-BY9hMxN7.js';
-import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-DnrZghBB.js';
+import { 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-mYSd8vQo.js';
+import { G as Graph, a as GraphOptions, h as GraphAttachStorageOptions } from './graph-BROUZPG9.js';
+import { T as TopicGraph } from './index-Bi4ZP6Hc.js';
+import { G as GateController, a as GateOptions } from './index-HvJ90_tX.js';
+import { D as DistillBundle, E as Extraction } from './composite-BPDU_XV1.js';
+import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-ygRFoyrN.js';
 import { StorageHandle, StorageTier } from './extra/storage-core.js';
-import { c as GraphSpecCatalog } from './index-CcS0t-l2.js';
+import { c as GraphSpecCatalog } from './index-Chi9IiHJ.js';
 
 /**
  * Observable adapter wrapper — the "inverted statistics" surface.
@@ -824,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;
@@ -862,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
  */
 
@@ -872,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.
@@ -987,8 +1040,15 @@ type GatedStreamHandle<T> = {
     deltaTopic: TopicGraph<StampedDelta>;
     /** Reactive accumulated-text view. */
     accumulatedText: Node<string>;
-    /** Gate controller — approve, reject (aborts in-flight stream), modify. */
-    gate: GateController<T | null>;
+    /**
+     * Gate controller — approve, reject (aborts in-flight stream), modify.
+     * The gate's DATA domain is `T` (not `T | null`): the pre-gate `filter`
+     * drops nulls, so the pending queue never holds a null. The controller's
+     * `node` output type stays `T | null` only because `gate.approve()` on an
+     * empty queue would surface `null` — callers should treat `null` as "no
+     * value" rather than as a modeled null signal.
+     */
+    gate: GateController<T>;
     /** Tear down the delta topic + gate keepalive. */
     dispose: () => void;
 };
@@ -1264,13 +1324,22 @@ type ToolRegistryOptions = {
 /**
  * `ToolRegistryGraph` — name-keyed registry of {@link ToolDefinition}s.
  *
+ * **Reactive-only execution.** The only execution path is
+ * {@link executeReactive}, which returns a `Node<unknown>` for the handler
+ * result. Composing factories (`toolExecution`, `agentLoop`) consume it
+ * directly inside `retrySource` / `switchMap` chains. There is intentionally
+ * no imperative `execute()` Promise method — the registry was originally a
+ * dual-boundary class (imperative + reactive) and the imperative path was
+ * the only thing in the codebase bridging through `Promise.resolve().then()`
+ * to feed `fromAny`. Removing it left every consumer on a single
+ * reactive-all-the-way path with real abort propagation.
+ *
+ * For non-reactive callers (debug scripts, one-shot tests), bridge with
+ * `awaitSettled(toolRegistry.executeReactive(name, args))`.
+ *
  * **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`.
+ * (O(1) mutations + version counter).
  */
 declare class ToolRegistryGraph extends Graph {
     readonly definitions: Node<ReadonlyMap<string, ToolDefinition>>;
@@ -1279,23 +1348,25 @@ declare class ToolRegistryGraph extends Graph {
     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.
+     * result. The returned node is a `producer` that:
+     *
+     * 1. Mints a per-call `AbortController` whose `signal` is threaded into
+     *    the handler call AND into `fromAny` (so a `fromPromise` /
+     *    `fromAsyncIter` inner abandons cleanly when the consumer
+     *    unsubscribes).
+     * 2. Runs `tool.handler(args, {signal})` inside a try/catch — a
+     *    synchronous throw surfaces as `[[ERROR, err]]` downstream instead
+     *    of escaping the producer.
+     * 3. Forwards every message from the inner `fromAny` chain to the
+     *    producer's outputs.
+     * 4. On teardown (subscriber count drops to zero, e.g. `switchMap`
+     *    supersede) calls `ac.abort()` and unsubscribes the inner.
+     *    Signal-aware handlers (e.g. `fetch(url, {signal})`) actually stop.
      *
-     * 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.
+     * Each call mints a fresh node tied to a fresh `handler(args, ...)`
+     * invocation — call `executeReactive` again for repeated invocations.
      *
      * @throws `Error` synchronously when `name` is not registered (no node is
      *   constructed — the caller gets a pre-wiring failure rather than a
@@ -1306,6 +1377,83 @@ declare class ToolRegistryGraph extends Graph {
 }
 declare function toolRegistry(name: string, opts?: ToolRegistryOptions): ToolRegistryGraph;
 
+/**
+ * `toolExecution` — reactive per-tool-call executor with retry + rescue.
+ *
+ * Lifted from the inlined `executeToolReactively` helper inside `agent-loop.ts`
+ * so it can be consumed standalone by any caller with a reactive `toolCalls`
+ * batch — not just `agentLoop`. The shape is: one input `Node<readonly
+ * ToolCall[]>` + a `ToolRegistryGraph` → one output `Node<readonly
+ * ToolResult[]>`. Each call maps to a per-call `retrySource(executeReactive)`
+ * → optional `rescue` chain that emits the handler result on success, or a
+ * JSON-wrapped `{ error }` payload on terminal failure so the LLM can see the
+ * error as tool output and decide whether to try again via another tool call.
+ *
+ * **Cancellation.** `executeReactive` mints a per-call `AbortController` and
+ * threads its signal into the handler call. When `switchMap` supersedes the
+ * inner (a fresh `toolCalls` batch arrives) or the outer graph tears down,
+ * the per-call node unsubscribes and `ac.abort()` fires. Signal-aware
+ * handlers (`fetch(url, {signal})`, child-process kill, DB cancel) actually
+ * stop in-flight work; handlers that ignore the signal still complete to
+ * their original termination, but their result is discarded.
+ *
+ * @module
+ */
+
+/** A single tool execution outcome: `{id, content}` where content is a JSON string. */
+interface ToolResult {
+    readonly id: string;
+    readonly content: string;
+}
+type ToolExecutionOptions = {
+    /**
+     * Reactive tool-call batch. Each non-empty emission triggers a fresh
+     * per-call execution fan-out; superseding emissions cancel the prior fan.
+     */
+    toolCalls: Node<readonly ToolCall[]>;
+    /** Registry that resolves tool name → handler. */
+    tools: ToolRegistryGraph;
+    /**
+     * Retry count per individual tool call. `retrySource({count: N})` retries
+     * up to N times on error (N retries = N+1 total attempts). Default: 1.
+     */
+    retryCount?: number;
+    /**
+     * How to surface a terminal error after retries are exhausted.
+     * - `"rescue"` (default): emit `{id, content: JSON.stringify({error})}`
+     *   so the LLM sees the failure as structured tool output and can decide
+     *   how to react. Sibling calls in the same batch continue to their own
+     *   completion; one call's failure does not affect the others.
+     * - `"propagate"`: let the ERROR propagate downstream. **Blast radius:**
+     *   the per-batch `derived` join auto-errors when any per-call node
+     *   terminates with ERROR, so one call's failure discards every sibling's
+     *   DATA (even ones that already settled with a valid ToolResult). Use
+     *   `"propagate"` only when a single tool failure should be fatal for the
+     *   whole batch; prefer `"rescue"` when you want the LLM to see partial
+     *   results plus per-call error markers.
+     */
+    onError?: "rescue" | "propagate";
+};
+/**
+ * Reactive executor for a batch of LLM tool calls.
+ *
+ * Each DATA emission on `toolCalls` dispatches a fresh per-call fan-out: for
+ * every call in the batch, construct a `retrySource(fromAny(tools.execute(
+ * name, args)))` node, optionally `rescue` it into a JSON error shape, and
+ * join the results via a `derived` whose first-run gate waits for every call
+ * to settle before emitting the batch. Empty batches (`calls.length === 0`)
+ * are a caller-side invariant violation (the upstream gate should emit
+ * RESOLVED for empty batches, not DATA) and trigger a loud error — callers
+ * that want to accept empty batches should upstream-filter them first.
+ *
+ * Reference-equality + content-equality dedup is applied to the output batch
+ * so duplicate re-emissions from a completing retrySource don't propagate.
+ *
+ * @param opts - `{ toolCalls, tools, retryCount?, onError? }`.
+ * @returns `Node<readonly ToolResult[]>` — one ToolResult per input ToolCall.
+ */
+declare function toolExecution(opts: ToolExecutionOptions): Node<readonly ToolResult[]>;
+
 /**
  * Reactive agent loop — autonomous multi-turn LLM agent with tool execution.
  */
@@ -1344,11 +1492,6 @@ type AgentLoopOptions = {
      */
     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.
  *
@@ -1367,11 +1510,22 @@ interface ToolResult {
  * the loop if they want a Promise.
  *
  * Public surface:
- * - `chat` / `tools` — subgraphs (imperative `append` / `execute` at boundary)
+ * - `chat` / `tools` — subgraphs (imperative `append` at boundary, reactive `executeReactive` for tool invocation)
  * - `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
+ *
+ * **Lifecycle: single-mount.** `AgentLoopGraph` instances expect to be
+ * constructed once and used until `destroy()`. The internal closure mirrors
+ * (`latestTurn` / `latestAborted` / `latestStatus` / `latestMessages` /
+ * `latestSchemas`) are wired by subscribe-and-capture at construction time;
+ * their corresponding `addDisposer`-registered subscriptions are torn down
+ * on subgraph unmount or `destroy()`. After teardown the mirrors freeze at
+ * their last value, so re-using a destroyed instance — calling `run()`
+ * again, or remounting under a new parent — would silently feed stale
+ * mirror data into `promptInput`. If you need to "reset" an agent, build a
+ * fresh `AgentLoopGraph` instance instead of recycling.
  */
 declare class AgentLoopGraph extends Graph {
     readonly chat: ChatStreamGraph;
@@ -1393,17 +1547,8 @@ 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;
-    /**
-     * 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;
     /**
@@ -1430,10 +1575,11 @@ declare class AgentLoopGraph extends Graph {
      *   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.
+     * same agent. Attempting to call `run()` while a previous `run()` is
+     * still in-flight throws a `RangeError` immediately. Stale-resolution
+     * safety is provided by `awaitSettled({skipCurrent: true})`, which
+     * ignores the cached initial DATA from any previous run and resolves
+     * only on a fresh post-subscribe emission of `_terminalResult`.
      */
     run(userMessage?: string, signal?: AbortSignal): Promise<LLMResponse | null>;
     /**
@@ -1553,6 +1699,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;
@@ -1560,8 +1729,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). */
@@ -1570,11 +1739,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;
@@ -1793,6 +1970,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
@@ -1800,6 +1991,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;
@@ -1809,6 +2004,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;
@@ -1849,6 +2149,13 @@ type GraphFromSpecOptions = {
     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.
@@ -1864,6 +2171,32 @@ type GraphFromSpecOptions = {
  * @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 = {
@@ -1943,6 +2276,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
@@ -1959,6 +2299,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 = {
@@ -1998,7 +2354,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;
@@ -2056,9 +2414,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;
@@ -2094,6 +2457,7 @@ declare const index_TieredRate: typeof TieredRate;
 declare const index_TokenUsage: typeof TokenUsage;
 declare const index_ToolCall: typeof ToolCall;
 declare const index_ToolDefinition: typeof ToolDefinition;
+type index_ToolExecutionOptions = ToolExecutionOptions;
 type index_ToolRegistryGraph = ToolRegistryGraph;
 declare const index_ToolRegistryGraph: typeof ToolRegistryGraph;
 type index_ToolRegistryOptions = ToolRegistryOptions;
@@ -2107,6 +2471,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;
@@ -2128,11 +2493,16 @@ 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;
@@ -2144,9 +2514,11 @@ 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_toolExecution: typeof toolExecution;
 declare const index_toolRegistry: typeof toolRegistry;
 declare const index_toolSelector: typeof toolSelector;
 declare const index_validateGraphDef: typeof validateGraphDef;
@@ -2159,7 +2531,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_StampedDelta as StampedDelta, type index_StrategyOperation as StrategyOperation, type index_StrategyPlan as StrategyPlan, index_StreamDelta as StreamDelta, type index_StreamingPromptNodeHandle as StreamingPromptNodeHandle, type index_StreamingPromptNodeOptions as StreamingPromptNodeOptions, type index_SuggestStrategyOptions as SuggestStrategyOptions, type index_SystemPromptHandle as SystemPromptHandle, index_TieredRate as TieredRate, index_TokenUsage as TokenUsage, index_ToolCall as ToolCall, index_ToolDefinition as ToolDefinition, index_ToolRegistryGraph as ToolRegistryGraph, type index_ToolRegistryOptions as ToolRegistryOptions, type index_ToolResult as ToolResult, type index_ToolSelectorOptions as ToolSelectorOptions, type index_WithBreakerOptions as WithBreakerOptions, type index_WithBudgetGateOptions as WithBudgetGateOptions, type index_WithDryRunBundle as WithDryRunBundle, type index_WithDryRunOptions as WithDryRunOptions, type index_WithRateLimiterOptions as WithRateLimiterOptions, index_WithReplayCacheOptions as WithReplayCacheOptions, type index_WithRetryOptions as WithRetryOptions, index_admissionFilter3D as admissionFilter3D, index_agentLoop as agentLoop, index_agentMemory as agentMemory, index_anthropicAdapter as anthropicAdapter, index_canonicalJson as canonicalJson, index_cascadingLlmAdapter as cascadingLlmAdapter, index_chatStream as chatStream, index_composePricing as composePricing, index_computePrice as computePrice, index_contentGate as contentGate, index_costMeterExtractor as costMeterExtractor, index_createAdapter as createAdapter, index_createCapabilitiesRegistry as createCapabilitiesRegistry, index_createPricingRegistry as createPricingRegistry, index_dryRunAdapter as dryRunAdapter, index_fallbackAdapter as fallbackAdapter, index_fromLLM as fromLLM, index_frozenContext as frozenContext, index_gatedStream as gatedStream, index_gaugesAsContext as gaugesAsContext, index_googleAdapter as googleAdapter, index_graphFromSpec as graphFromSpec, index_handoff as handoff, index_keywordFlagExtractor as keywordFlagExtractor, index_knobsAsTools as knobsAsTools, index_llmConsolidator as llmConsolidator, index_llmExtractor as llmExtractor, index_observableAdapter as observableAdapter, index_openAICompatAdapter as openAICompatAdapter, index_parseRateLimitFromError as parseRateLimitFromError, index_pricingFor as pricingFor, index_promptNode as promptNode, index_redactor as redactor, index_registryPricing as registryPricing, index_resilientAdapter as resilientAdapter, index_streamExtractor as streamExtractor, index_streamingPromptNode as streamingPromptNode, index_suggestStrategy as suggestStrategy, index_systemPromptBuilder as systemPromptBuilder, index_tier as tier, index_toolCallExtractor as toolCallExtractor, index_toolRegistry as toolRegistry, index_toolSelector as toolSelector, index_validateGraphDef as validateGraphDef, index_withBreaker as withBreaker, index_withBudgetGate as withBudgetGate, index_withDryRun as withDryRun, index_withRateLimiter as withRateLimiter, index_withReplayCache as withReplayCache, index_withRetry as withRetry, index_withTimeout as withTimeout, index_zeroPrice as zeroPrice };
+  export { 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, type index_ToolExecutionOptions as ToolExecutionOptions, 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_toolExecution as toolExecution, 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 StampedDelta as a1, type StrategyOperation as a2, type StrategyPlan as a3, type StreamingPromptNodeHandle as a4, type StreamingPromptNodeOptions as a5, type SuggestStrategyOptions as a6, type SystemPromptHandle as a7, ToolRegistryGraph as a8, type ToolRegistryOptions as a9, llmExtractor as aA, observableAdapter as aB, parseRateLimitFromError as aC, promptNode as aD, redactor as aE, resilientAdapter as aF, streamExtractor as aG, streamingPromptNode as aH, suggestStrategy as aI, systemPromptBuilder as aJ, toolCallExtractor as aK, toolRegistry as aL, toolSelector as aM, validateGraphDef as aN, withBreaker as aO, withBudgetGate as aP, withDryRun as aQ, withRateLimiter as aR, withRetry as aS, withTimeout as aT, type ToolResult as aa, type ToolSelectorOptions as ab, type WithBreakerOptions as ac, type WithBudgetGateOptions as ad, type WithDryRunBundle as ae, type WithDryRunOptions as af, type WithRateLimiterOptions as ag, type WithRetryOptions as ah, admissionFilter3D as ai, agentLoop as aj, agentMemory as ak, anthropicAdapter as al, chatStream as am, contentGate as an, costMeterExtractor as ao, dryRunAdapter as ap, fromLLM as aq, frozenContext as ar, gatedStream as as, gaugesAsContext as at, googleAdapter as au, graphFromSpec as av, handoff as aw, keywordFlagExtractor as ax, knobsAsTools as ay, llmConsolidator as az, type AdmissionScores as b, AgentLoopGraph as c, type AgentLoopOptions as d, type AgentLoopStatus as e, type AgentMemoryGraph as f, type AgentMemoryOptions as g, type AnthropicAdapterOptions as h, index as i, type AnthropicSdkLike as j, BudgetExhaustedError as k, type BudgetGateBundle as l, type BudgetTotals as m, ChatStreamGraph as n, type ChatStreamOptions as o, type ContentDecision as p, type ContentGateOptions as q, type CostMeterOptions as r, type CostMeterReading as s, type DryRunAdapterOptions as t, type FrozenContextOptions as u, type GatedStreamOptions as v, type GaugesAsContextOptions as w, type GoogleAdapterOptions as x, type GoogleSdkLike as y, type GraphDefValidation as z };
+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, toolRegistry 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, frozenContext as aA, gatedStream as aB, gaugesAsContext as aC, googleAdapter as aD, graphFromSpec as aE, graphFromSpecReactive as aF, handoff as aG, keywordFlagExtractor as aH, knobsAsTools as aI, llmConsolidator as aJ, llmExtractor as aK, memoryRetrieval as aL, memoryWithKG as aM, memoryWithTiers as aN, memoryWithVectors as aO, observableAdapter as aP, parseRateLimitFromError as aQ, promptNode as aR, redactor as aS, resilientAdapter as aT, streamExtractor as aU, streamingPromptNode as aV, suggestStrategy as aW, suggestStrategyReactive as aX, systemPromptBuilder as aY, toolCallExtractor as aZ, toolExecution as a_, type StrategyPlan as aa, type StreamingPromptNodeHandle as ab, type StreamingPromptNodeOptions as ac, type SuggestStrategyOptions as ad, type SystemPromptHandle as ae, type ToolExecutionOptions as af, ToolRegistryGraph as ag, type ToolRegistryOptions as ah, type ToolResult as ai, type ToolSelectorOptions as aj, type WithBreakerOptions as ak, type WithBudgetGateOptions as al, type WithDryRunBundle as am, type WithDryRunOptions as an, type WithRateLimiterOptions as ao, type WithRetryOptions as ap, admissionFilter3D as aq, admissionScored as ar, agentLoop as as, agentMemory as at, anthropicAdapter as au, chatStream as av, contentGate as aw, costMeterExtractor as ax, dryRunAdapter as ay, fromLLM as az, type AdmissionScoredOptions as b, toolSelector as b0, validateGraphDef as b1, withBreaker as b2, withBudgetGate as b3, withDryRun as b4, withRateLimiter as b5, withRetry as b6, withTimeout as b7, 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 };