@graphrefly/graphrefly 0.31.0 → 0.32.0

package/dist/{index-CZChc85Q.d.cts → index-BuN2wGJs.d.cts}

@@ -5,13 +5,13 @@ 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 { 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-Cb3GH1O7.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 { G as Graph, a as GraphOptions, h as GraphAttachStorageOptions } from './graph-CdJeX7O7.cjs';
+import { T as TopicGraph } from './index-BDLy6CQ9.cjs';
+import { G as GateController, a as GateOptions } from './index-CCdg0JLX.cjs';
 import { D as DistillBundle, E as Extraction } from './composite-CH0S8DFn.cjs';
-import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-lKuLYmHO.cjs';
+import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-BiGeETJs.cjs';
 import { StorageHandle, StorageTier } from './extra/storage-core.cjs';
-import { c as GraphSpecCatalog } from './index-D-kHVedZ.cjs';
+import { c as GraphSpecCatalog } from './index-j33Lfb1G.cjs';
 
 /**
  * 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.
@@ -1393,8 +1446,6 @@ declare class AgentLoopGraph extends Graph {
     readonly toolCalls: Node<readonly ToolCall[]>;
     /** Tool-result batch (one entry per call) after reactive execution. SENTINEL. */
     readonly toolResults: Node<readonly ToolResult[]>;
-    /** @deprecated Use `turn` instead. Pre-1.0 rename — this alias will be removed. */
-    readonly turnCount: Node<number>;
     private readonly _terminalResult;
     private readonly _disposeRunWiring;
     /**
@@ -1553,6 +1604,29 @@ interface ToolSelectorOptions {
  */
 declare function toolSelector(allTools: NodeInput<readonly ToolDefinition[]>, constraints: readonly NodeInput<(tool: ToolDefinition) => boolean>[], opts?: ToolSelectorOptions): Node<readonly ToolDefinition[]>;
 
+/** Generic per-dimension thresholds. Any dim below its threshold → reject. */
+type AdmissionThresholds<Dims extends string> = Partial<Record<Dims, number>>;
+type AdmissionScoredOptions<Dims extends string, TRaw = unknown> = {
+    /** Score function — must return a finite number for every dimension named in `thresholds`. */
+    scoreFn: (raw: TRaw) => Readonly<Record<Dims, number>>;
+    /** Per-dim minimums. Dims absent here are scored but not gated. */
+    thresholds?: AdmissionThresholds<Dims>;
+};
+/**
+ * Generic N-dimension admission filter. Rejects any input where one of the
+ * configured threshold dimensions scores below its minimum. Missing scores
+ * (`undefined` / `null`) AND non-finite values (`NaN`, `±Infinity`) are
+ * treated as below all thresholds — reject by default rather than admit.
+ *
+ * @example
+ * ```ts
+ * const filter = admissionScored({
+ *   scoreFn: (raw: Note) => ({ relevance: scoreRelevance(raw), age: ageScore(raw) }),
+ *   thresholds: { relevance: 0.4 },  // age scored but ungated
+ * });
+ * ```
+ */
+declare function admissionScored<Dims extends string, TRaw = unknown>(opts: AdmissionScoredOptions<Dims, TRaw>): (raw: TRaw) => boolean;
 /** Scores for the three admission dimensions. Each 0–1. */
 type AdmissionScores = {
     readonly persistence: number;
@@ -1560,8 +1634,8 @@ type AdmissionScores = {
     readonly personalValue: number;
 };
 type AdmissionScore3DOptions = {
-    /** Custom scoring function. Default: rule-based (all dimensions 0.5). */
-    scoreFn?: (raw: unknown) => AdmissionScores;
+    /** Custom scoring function. Required — the previous always-0.5 default was misleading. */
+    scoreFn: (raw: unknown) => AdmissionScores;
     /** Minimum persistence score to admit (default 0.3). */
     persistenceThreshold?: number;
     /** Minimum personalValue score to admit (default 0.3). */
@@ -1570,11 +1644,19 @@ type AdmissionScore3DOptions = {
     requireStructured?: boolean;
 };
 /**
- * Creates a 3D admission filter function compatible with `agentMemory`'s
- * `admissionFilter` option. Scores each candidate on persistence, structure,
- * and personalValue, then applies thresholds.
+ * 3D admission sugar — the persistence / structure / personalValue triple
+ * commonly used in agent-memory literature. Composes `admissionScored`
+ * with thresholds derived from the option fields. Use directly when those
+ * three named dimensions match your domain, or use `admissionScored` with
+ * an arbitrary dimension set instead.
+ *
+ * `requireStructured: true` rejects entries where `structure <= 0` (matches
+ * the pre-Unit-8 `requireStructured && scores.structure <= 0` check).
+ * Implemented as a final-step predicate around `admissionScored` rather
+ * than a `Number.MIN_VALUE` threshold, which would have been a footgun for
+ * future readers.
  */
-declare function admissionFilter3D(opts?: AdmissionScore3DOptions): (raw: unknown) => boolean;
+declare function admissionFilter3D(opts: AdmissionScore3DOptions): (raw: unknown) => boolean;
 
 type RetrievalQuery = {
     readonly text?: string;
@@ -1793,6 +1875,20 @@ type LLMExtractorOptions = {
     model?: string;
     temperature?: number;
     maxTokens?: number;
+    /**
+     * Cap the dedup-hint slice of `existingKeys` passed to the LLM. Larger
+     * stores ship more keys (better dedup recall) at the cost of prompt size.
+     * Default 100. Set to `Infinity` to forward every key.
+     */
+    maxExistingKeys?: number;
+    /**
+     * Optional name forwarded to the underlying `promptNode` (used as the
+     * `<name>::messages` / `<name>::call` / `<name>::output` path prefix).
+     * Defaults differ per call site (`llmExtractor` / `llmConsolidator`) so
+     * extractor + consolidator wired into the same graph don't collide on
+     * `prompt_node::output`.
+     */
+    name?: string;
 };
 /**
  * Returns an `extractFn` callback for `distill()` that invokes an LLM to
@@ -1800,6 +1896,10 @@ type LLMExtractorOptions = {
  *
  * The system prompt should instruct the LLM to return JSON matching
  * `Extraction<TMem>` shape: `{ upsert: [{ key, value }], remove?: [key] }`.
+ *
+ * Built on `promptNode({format: "json"})` — inherits markdown-fence stripping
+ * and content-preview parse errors. Stack `withRetry` on the adapter for
+ * transient-error tolerance (see `patterns/ai/adapters/middleware/retry.ts`).
  */
 declare function llmExtractor<TRaw, TMem>(systemPrompt: string, opts: LLMExtractorOptions): (raw: TRaw, existing: ReadonlyMap<string, TMem>) => NodeInput<Extraction<TMem>>;
 type LLMConsolidatorOptions = LLMExtractorOptions;
@@ -1809,6 +1909,111 @@ type LLMConsolidatorOptions = LLMExtractorOptions;
  */
 declare function llmConsolidator<TMem>(systemPrompt: string, opts: LLMConsolidatorOptions): (entries: ReadonlyMap<string, TMem>) => NodeInput<Extraction<TMem>>;
 
+type MemoryWithVectorsOptions<TMem> = {
+    /** Embedding dimension. Must match the `embedFn` output length. */
+    dimension: number;
+    /** Extract an embedding vector for a memory entry. */
+    embedFn: (mem: TMem) => readonly number[] | undefined;
+};
+/**
+ * Attach a vector index to a `DistillBundle`. Indexes every entry in the
+ * store as it changes. Returns the `VectorIndexBundle` so retrieval can read
+ * its `entries` and call `search()`.
+ *
+ * The indexer's keepalive is registered with `graph.addDisposer` so it tears
+ * down on `graph.destroy()`. The returned `dispose()` is also available for
+ * early release without destroying the parent graph.
+ */
+declare function memoryWithVectors<TMem>(graph: Graph, store: DistillBundle<TMem>, opts: MemoryWithVectorsOptions<TMem>): {
+    vectors: VectorIndexBundle<TMem>;
+    dispose: () => void;
+};
+type MemoryWithKGOptions<TMem> = {
+    /** Extract entities + relations for a memory entry. */
+    entityFn: (key: string, mem: TMem) => {
+        entities?: Array<{
+            id: string;
+            value: unknown;
+        }>;
+        relations?: Array<{
+            from: string;
+            to: string;
+            relation: string;
+            weight?: number;
+        }>;
+    } | undefined;
+};
+/**
+ * Attach a knowledge graph alongside a `DistillBundle`. Mount path defaults
+ * to the `name` arg so multiple `memoryWithKG` calls on the same graph don't
+ * collide on a hardcoded `"kg"` mount.
+ *
+ * Indexer keepalive is registered with `graph.addDisposer`; explicit
+ * `dispose()` is also available.
+ */
+declare function memoryWithKG<TMem>(graph: Graph, store: DistillBundle<TMem>, name: string, opts: MemoryWithKGOptions<TMem>): {
+    kg: KnowledgeGraphGraph<unknown, string>;
+    dispose: () => void;
+};
+type MemoryWithTiersOptions<TMem> = MemoryTiersOptions<TMem> & {
+    /** Score function — same signature as `agentMemory.score`. */
+    score: (mem: TMem, context: unknown) => number;
+    /** Optional reactive context node (passed to `score`). */
+    context?: NodeInput<unknown>;
+};
+/**
+ * Attach 3-tier storage (active / archived / permanent) to a `DistillBundle`.
+ * Wires a `tierClassifier` effect that:
+ * - Promotes entries matching `permanentFilter` into the permanent tier.
+ * - Archives entries whose decayed score falls below `archiveThreshold`.
+ * - Caps the active tier at `maxActive`, evicting lowest-scored on overflow.
+ *
+ * **Closure state caveat (Unit 7 Q3 deferred):** `permanentKeys` +
+ * `entryCreatedAtNs` are still closure-held for now; promotion to reactive
+ * nodes is tracked in `docs/optimizations.md`.
+ */
+declare function memoryWithTiers<TMem>(graph: Graph, store: DistillBundle<TMem>, opts: MemoryWithTiersOptions<TMem>): {
+    tiers: MemoryTiersBundle<TMem>;
+    dispose: () => void;
+};
+type MemoryRetrievalOptions<TMem> = {
+    /** Score function (same shape as `agentMemory.score`). */
+    score: (mem: TMem, context: unknown) => number;
+    /** Cost function for budget packing. */
+    cost: (mem: TMem) => number;
+    /** Token / cost budget. Default 2000. */
+    budget?: number;
+    /** Top-K vector candidates. Default 20. */
+    topK?: number;
+    /** KG expansion depth in hops. Default 1. */
+    graphDepth?: number;
+    /** Hierarchical-context boost weight. Default 0. */
+    contextWeight?: number;
+    /** Hierarchical-context accessor for entries. */
+    contextOf?: (mem: TMem) => readonly string[] | undefined;
+    /** Optional reactive context node (passed to `score`). */
+    context?: NodeInput<unknown>;
+};
+type MemoryRetrievalBundle<TMem> = {
+    /** State node mirroring the latest packed retrieval result. */
+    readonly retrieval: Node<ReadonlyArray<RetrievalEntry<TMem>>>;
+    /** State node mirroring the latest retrieval trace. */
+    readonly retrievalTrace: Node<RetrievalTrace<TMem> | null>;
+    /** Imperative consumer API — synchronous; reads cache at call time. */
+    readonly retrieve: (query: RetrievalQuery) => ReadonlyArray<RetrievalEntry<TMem>>;
+    /** Reactive sibling — chain into the graph. Mirrors observability state. */
+    readonly retrieveReactive: (queryInput: NodeInput<RetrievalQuery | null>) => Node<ReadonlyArray<RetrievalEntry<TMem>>>;
+};
+/**
+ * Build the retrieval pipeline (vector + KG + budget packing) over a
+ * `DistillBundle` and optional `vectors` / `kg` bundles.
+ *
+ * Both consumer surfaces (`retrieve`, `retrieveReactive`) write to the same
+ * `retrieval` + `retrievalTrace` state nodes — observers subscribed to those
+ * see ALL queries regardless of which API issued them.
+ */
+declare function memoryRetrieval<TMem>(graph: Graph, store: DistillBundle<TMem>, vectors: VectorIndexBundle<TMem> | null, kg: KnowledgeGraphGraph<unknown, string> | null, opts: MemoryRetrievalOptions<TMem>): MemoryRetrievalBundle<TMem>;
+
 type GaugesAsContextOptions = {
     /** Group gauges by `meta.tags` (default true). */
     groupByTags?: boolean;
@@ -1849,6 +2054,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 +2076,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 +2181,13 @@ type SuggestStrategyOptions = {
     temperature?: number;
     maxTokens?: number;
     actor?: Actor;
+    /**
+     * Optional AbortSignal forwarded to `adapter.invoke({ signal })`. Lets
+     * callers cancel the in-flight LLM call (e.g. when the reactive variant
+     * supersedes mid-flight). When the signal aborts, the underlying call
+     * propagates the abort and `suggestStrategy` rejects with the abort reason.
+     */
+    signal?: AbortSignal;
 };
 /**
  * Ask an LLM to analyze a graph and suggest topology/parameter changes
@@ -1959,6 +2204,22 @@ type SuggestStrategyOptions = {
  * @throws On invalid LLM output.
  */
 declare function suggestStrategy(graph: Graph, problem: string, adapter: LLMAdapter, opts?: SuggestStrategyOptions): Promise<StrategyPlan>;
+/**
+ * Reactive variant of {@link suggestStrategy}: re-invokes the LLM whenever
+ * the `problem` source emits, sampling the latest `graph` value (via
+ * `withLatestFrom`) to describe. The graph is the *secondary* dep — only
+ * problem changes re-trigger analysis. This breaks the feedback cycle that
+ * would otherwise arise if downstream consumers wired `apply(plan)` back
+ * into the same graph node (graph mutation must not auto-fire a re-analysis).
+ *
+ * @param graph - Reactive source of graphs to analyze.
+ * @param problem - Reactive source of natural-language problem statements.
+ * @param adapter - LLM adapter for the analysis call.
+ * @param opts - Model and actor options.
+ * @returns `Node<StrategyPlan | null>` — emits the latest plan, or `null`
+ *           while inputs are unsettled.
+ */
+declare function suggestStrategyReactive(graph: Node<Graph | null>, problem: NodeInput<string>, adapter: LLMAdapter, opts?: SuggestStrategyOptions): Node<StrategyPlan | null>;
 
 /** Validation result from {@link validateGraphDef}. */
 type GraphDefValidation = {
@@ -1998,7 +2259,9 @@ declare const index_AdapterProvider: typeof AdapterProvider;
 type index_AdapterStats = AdapterStats;
 declare const index_AdapterTier: typeof AdapterTier;
 type index_AdmissionScore3DOptions = AdmissionScore3DOptions;
+type index_AdmissionScoredOptions<Dims extends string, TRaw = unknown> = AdmissionScoredOptions<Dims, TRaw>;
 type index_AdmissionScores = AdmissionScores;
+type index_AdmissionThresholds<Dims extends string> = AdmissionThresholds<Dims>;
 type index_AgentLoopGraph = AgentLoopGraph;
 declare const index_AgentLoopGraph: typeof AgentLoopGraph;
 type index_AgentLoopOptions = AgentLoopOptions;
@@ -2056,9 +2319,14 @@ declare const index_LLMResponse: typeof LLMResponse;
 type index_LLMTimeoutError = LLMTimeoutError;
 declare const index_LLMTimeoutError: typeof LLMTimeoutError;
 type index_McpToolSchema = McpToolSchema;
+type index_MemoryRetrievalBundle<TMem> = MemoryRetrievalBundle<TMem>;
+type index_MemoryRetrievalOptions<TMem> = MemoryRetrievalOptions<TMem>;
 type index_MemoryTier = MemoryTier;
 type index_MemoryTiersBundle<TMem> = MemoryTiersBundle<TMem>;
 type index_MemoryTiersOptions<TMem> = MemoryTiersOptions<TMem>;
+type index_MemoryWithKGOptions<TMem> = MemoryWithKGOptions<TMem>;
+type index_MemoryWithTiersOptions<TMem> = MemoryWithTiersOptions<TMem>;
+type index_MemoryWithVectorsOptions<TMem> = MemoryWithVectorsOptions<TMem>;
 declare const index_ModelCapabilities: typeof ModelCapabilities;
 declare const index_ModelFeatures: typeof ModelFeatures;
 declare const index_ModelLimits: typeof ModelLimits;
@@ -2107,6 +2375,7 @@ type index_WithRateLimiterOptions = WithRateLimiterOptions;
 declare const index_WithReplayCacheOptions: typeof WithReplayCacheOptions;
 type index_WithRetryOptions = WithRetryOptions;
 declare const index_admissionFilter3D: typeof admissionFilter3D;
+declare const index_admissionScored: typeof admissionScored;
 declare const index_agentLoop: typeof agentLoop;
 declare const index_agentMemory: typeof agentMemory;
 declare const index_anthropicAdapter: typeof anthropicAdapter;
@@ -2128,11 +2397,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,6 +2418,7 @@ 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;
@@ -2159,7 +2434,7 @@ declare const index_withRetry: typeof withRetry;
 declare const index_withTimeout: typeof withTimeout;
 declare const index_zeroPrice: typeof zeroPrice;
 declare namespace index {
-  export { index_AdapterProvider as AdapterProvider, type index_AdapterStats as AdapterStats, index_AdapterTier as AdapterTier, type index_AdmissionScore3DOptions as AdmissionScore3DOptions, type index_AdmissionScores as AdmissionScores, index_AgentLoopGraph as AgentLoopGraph, type index_AgentLoopOptions as AgentLoopOptions, type index_AgentLoopStatus as AgentLoopStatus, type index_AgentMemoryGraph as AgentMemoryGraph, type index_AgentMemoryOptions as AgentMemoryOptions, index_AllTiersExhaustedError as AllTiersExhaustedError, type index_AnthropicAdapterOptions as AnthropicAdapterOptions, type index_AnthropicSdkLike as AnthropicSdkLike, type index_BudgetCaps as BudgetCaps, index_BudgetExhaustedError as BudgetExhaustedError, type index_BudgetGateBundle as BudgetGateBundle, type index_BudgetTotals as BudgetTotals, type index_CallStatsEvent as CallStatsEvent, index_CapabilitiesRegistry as CapabilitiesRegistry, index_CascadeExhaustionReport as CascadeExhaustionReport, index_CascadingLlmAdapterOptions as CascadingLlmAdapterOptions, index_ChatMessage as ChatMessage, index_ChatStreamGraph as ChatStreamGraph, type index_ChatStreamOptions as ChatStreamOptions, index_CircuitOpenError as CircuitOpenError, type index_ContentDecision as ContentDecision, type index_ContentGateOptions as ContentGateOptions, type index_CostMeterOptions as CostMeterOptions, type index_CostMeterReading as CostMeterReading, index_CreateAdapterOptions as CreateAdapterOptions, index_DEFAULT_DECAY_RATE as DEFAULT_DECAY_RATE, type index_DryRunAdapterOptions as DryRunAdapterOptions, type index_ExtractedToolCall as ExtractedToolCall, index_FallbackAdapterOptions as FallbackAdapterOptions, index_FallbackFixture as FallbackFixture, index_FallbackMissError as FallbackMissError, index_FallbackMissPolicy as FallbackMissPolicy, type index_FromLLMOptions as FromLLMOptions, type index_FrozenContextOptions as FrozenContextOptions, type index_GatedStreamHandle as GatedStreamHandle, type index_GatedStreamOptions as GatedStreamOptions, type index_GaugesAsContextOptions as GaugesAsContextOptions, type index_GoogleAdapterOptions as GoogleAdapterOptions, type index_GoogleSdkLike as GoogleSdkLike, type index_GraphDefValidation as GraphDefValidation, type index_GraphFromSpecOptions as GraphFromSpecOptions, type index_HandoffOptions as HandoffOptions, type index_HttpErrorLike as HttpErrorLike, type index_KeywordFlag as KeywordFlag, type index_KeywordFlagExtractorOptions as KeywordFlagExtractorOptions, type index_KnobsAsToolsResult as KnobsAsToolsResult, index_LLMAdapter as LLMAdapter, type index_LLMConsolidatorOptions as LLMConsolidatorOptions, type index_LLMExtractorOptions as LLMExtractorOptions, index_LLMInvokeOptions as LLMInvokeOptions, index_LLMResponse as LLMResponse, index_LLMTimeoutError as LLMTimeoutError, type index_McpToolSchema as McpToolSchema, type index_MemoryTier as MemoryTier, type index_MemoryTiersBundle as MemoryTiersBundle, type index_MemoryTiersOptions as MemoryTiersOptions, index_ModelCapabilities as ModelCapabilities, index_ModelFeatures as ModelFeatures, index_ModelLimits as ModelLimits, index_ModelPricing as ModelPricing, index_OpenAICompatAdapterOptions as OpenAICompatAdapterOptions, index_OpenAICompatPreset as OpenAICompatPreset, index_OpenAISdkLike as OpenAISdkLike, type index_OpenAIToolSchema as OpenAIToolSchema, index_PriceBreakdown as PriceBreakdown, index_PricingFn as PricingFn, index_PricingRegistry as PricingRegistry, type index_PromptNodeOptions as PromptNodeOptions, index_Rate as Rate, type index_RedactorOptions as RedactorOptions, index_ReplayCacheKeyContext as ReplayCacheKeyContext, index_ReplayCacheMissError as ReplayCacheMissError, index_ReplayCacheMode as ReplayCacheMode, type index_ResilientAdapterBundle as ResilientAdapterBundle, type index_ResilientAdapterOptions as ResilientAdapterOptions, type index_RetrievalEntry as RetrievalEntry, type index_RetrievalPipelineOptions as RetrievalPipelineOptions, type index_RetrievalQuery as RetrievalQuery, type index_RetrievalTrace as RetrievalTrace, type index_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, index_ToolRegistryGraph as ToolRegistryGraph, type index_ToolRegistryOptions as ToolRegistryOptions, type index_ToolResult as ToolResult, type index_ToolSelectorOptions as ToolSelectorOptions, type index_WithBreakerOptions as WithBreakerOptions, type index_WithBudgetGateOptions as WithBudgetGateOptions, type index_WithDryRunBundle as WithDryRunBundle, type index_WithDryRunOptions as WithDryRunOptions, type index_WithRateLimiterOptions as WithRateLimiterOptions, index_WithReplayCacheOptions as WithReplayCacheOptions, type index_WithRetryOptions as WithRetryOptions, index_admissionFilter3D as admissionFilter3D, index_admissionScored as admissionScored, index_agentLoop as agentLoop, index_agentMemory as agentMemory, index_anthropicAdapter as anthropicAdapter, index_canonicalJson as canonicalJson, index_cascadingLlmAdapter as cascadingLlmAdapter, index_chatStream as chatStream, index_composePricing as composePricing, index_computePrice as computePrice, index_contentGate as contentGate, index_costMeterExtractor as costMeterExtractor, index_createAdapter as createAdapter, index_createCapabilitiesRegistry as createCapabilitiesRegistry, index_createPricingRegistry as createPricingRegistry, index_dryRunAdapter as dryRunAdapter, index_fallbackAdapter as fallbackAdapter, index_fromLLM as fromLLM, index_frozenContext as frozenContext, index_gatedStream as gatedStream, index_gaugesAsContext as gaugesAsContext, index_googleAdapter as googleAdapter, index_graphFromSpec as graphFromSpec, index_graphFromSpecReactive as graphFromSpecReactive, index_handoff as handoff, index_keywordFlagExtractor as keywordFlagExtractor, index_knobsAsTools as knobsAsTools, index_llmConsolidator as llmConsolidator, index_llmExtractor as llmExtractor, index_memoryRetrieval as memoryRetrieval, index_memoryWithKG as memoryWithKG, index_memoryWithTiers as memoryWithTiers, index_memoryWithVectors as memoryWithVectors, index_observableAdapter as observableAdapter, index_openAICompatAdapter as openAICompatAdapter, index_parseRateLimitFromError as parseRateLimitFromError, index_pricingFor as pricingFor, index_promptNode as promptNode, index_redactor as redactor, index_registryPricing as registryPricing, index_resilientAdapter as resilientAdapter, index_streamExtractor as streamExtractor, index_streamingPromptNode as streamingPromptNode, index_suggestStrategy as suggestStrategy, index_suggestStrategyReactive as suggestStrategyReactive, index_systemPromptBuilder as systemPromptBuilder, index_tier as tier, index_toolCallExtractor as toolCallExtractor, index_toolRegistry as toolRegistry, index_toolSelector as toolSelector, index_validateGraphDef as validateGraphDef, index_withBreaker as withBreaker, index_withBudgetGate as withBudgetGate, index_withDryRun as withDryRun, index_withRateLimiter as withRateLimiter, index_withReplayCache as withReplayCache, index_withRetry as withRetry, index_withTimeout as withTimeout, index_zeroPrice as zeroPrice };
 }
 
-export { type RetrievalQuery as $, type AdapterStats as A, type BudgetCaps as B, type CallStatsEvent as C, DEFAULT_DECAY_RATE as D, type ExtractedToolCall as E, type FromLLMOptions as F, type GatedStreamHandle as G, type GraphFromSpecOptions as H, type HandoffOptions as I, type HttpErrorLike as J, type KeywordFlag as K, type KeywordFlagExtractorOptions as L, type KnobsAsToolsResult as M, type LLMConsolidatorOptions as N, type LLMExtractorOptions as O, LLMTimeoutError as P, type McpToolSchema as Q, type MemoryTier as R, type MemoryTiersBundle as S, type MemoryTiersOptions as T, type OpenAIToolSchema as U, type PromptNodeOptions as V, type RedactorOptions as W, type ResilientAdapterBundle as X, type ResilientAdapterOptions as Y, type RetrievalEntry as Z, type RetrievalPipelineOptions as _, type AdmissionScore3DOptions as a, type RetrievalTrace as a0, type 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, validateGraphDef as a$, type PromptNodeOptions as a0, type RedactorOptions as a1, type ResilientAdapterBundle as a2, type ResilientAdapterOptions as a3, type RetrievalEntry as a4, type RetrievalPipelineOptions as a5, type RetrievalQuery as a6, type RetrievalTrace as a7, type StampedDelta as a8, type StrategyOperation as a9, gatedStream as aA, gaugesAsContext as aB, googleAdapter as aC, graphFromSpec as aD, graphFromSpecReactive as aE, handoff as aF, keywordFlagExtractor as aG, knobsAsTools as aH, llmConsolidator as aI, llmExtractor as aJ, memoryRetrieval as aK, memoryWithKG as aL, memoryWithTiers as aM, memoryWithVectors as aN, observableAdapter as aO, parseRateLimitFromError as aP, promptNode as aQ, redactor as aR, resilientAdapter as aS, streamExtractor as aT, streamingPromptNode as aU, suggestStrategy as aV, suggestStrategyReactive as aW, systemPromptBuilder as aX, toolCallExtractor as aY, toolRegistry as aZ, toolSelector as a_, type StrategyPlan as aa, type StreamingPromptNodeHandle as ab, type StreamingPromptNodeOptions as ac, type SuggestStrategyOptions as ad, type SystemPromptHandle as ae, ToolRegistryGraph as af, type ToolRegistryOptions as ag, type ToolResult as ah, type ToolSelectorOptions as ai, type WithBreakerOptions as aj, type WithBudgetGateOptions as ak, type WithDryRunBundle as al, type WithDryRunOptions as am, type WithRateLimiterOptions as an, type WithRetryOptions as ao, admissionFilter3D as ap, admissionScored as aq, agentLoop as ar, agentMemory as as, anthropicAdapter as at, chatStream as au, contentGate as av, costMeterExtractor as aw, dryRunAdapter as ax, fromLLM as ay, frozenContext as az, type AdmissionScoredOptions as b, withBreaker as b0, withBudgetGate as b1, withDryRun as b2, withRateLimiter as b3, withRetry as b4, withTimeout as b5, type AdmissionScores as c, type AdmissionThresholds as d, AgentLoopGraph as e, type AgentLoopOptions as f, type AgentLoopStatus as g, type AgentMemoryGraph as h, index as i, type AgentMemoryOptions as j, type AnthropicAdapterOptions as k, type AnthropicSdkLike as l, BudgetExhaustedError as m, type BudgetGateBundle as n, type BudgetTotals as o, ChatStreamGraph as p, type ChatStreamOptions as q, type ContentDecision as r, type ContentGateOptions as s, type CostMeterOptions as t, type CostMeterReading as u, type DryRunAdapterOptions as v, type FrozenContextOptions as w, type GatedStreamOptions as x, type GaugesAsContextOptions as y, type GoogleAdapterOptions as z };

package/dist/{index-Cy7eFeIX.d.cts → index-BwdPDWI4.d.cts}

@@ -1,5 +1,5 @@
 import { a as Node, N as NodeOptions } from './node-BVV7G1bq.cjs';
-import { a as GraphOptions, G as Graph } from './graph-C4Uxwv0T.cjs';
+import { a as GraphOptions, G as Graph } from './graph-CdJeX7O7.cjs';
 
 /**
  * Reduction primitives (roadmap §8.1).

package/dist/{index-DylQCKEL.d.cts → index-BzxU4yhV.d.cts}

@@ -1,7 +1,7 @@
 import { a as Node } from './node-BVV7G1bq.cjs';
 import { NodeInput } from './extra/sources.cjs';
-import { a as GraphOptions, G as Graph } from './graph-C4Uxwv0T.cjs';
-import { T as TopicGraph } from './index-B-z8WaSd.cjs';
+import { a as GraphOptions, G as Graph } from './graph-CdJeX7O7.cjs';
+import { T as TopicGraph } from './index-BDLy6CQ9.cjs';
 
 /**
  * refineLoop — universal prompt/artifact optimization loop as a reactive Graph.
@@ -97,6 +97,15 @@ interface RefineStrategy<T> {
  * reactive nodes; the evaluator's returned node IS the EVALUATE topic's source
  * (no glue). Implementers can batch-eval (e.g. `funnel` with concurrency) or
  * map per-candidate — user's code.
+ *
+ * **`EvalResult.candidateIndex` semantics.** Optional per-result field.
+ * When present, multi-candidate aggregators ({@link errorCritique}'s
+ * `pickBest`) score per index, picking the candidate with the highest
+ * mean score. When absent across all results, those aggregators fall back
+ * to positional matching against `candidates[0]` — meaning a strategy that
+ * generates >1 candidate but emits unindexed scores effectively only ever
+ * critiques the first candidate. Set `candidateIndex` whenever the
+ * evaluator's score corresponds to a specific candidate in the batch.
  */
 type Evaluator<T> = (candidates: Node<readonly T[]>, dataset: Node<readonly DatasetItem[]>) => Node<readonly EvalResult[]>;
 /**

package/dist/{index-D9Y_u6BG.d.cts → index-C-Gsh-0a.d.cts}

@@ -1,6 +1,6 @@
-import { M as MeasurementAdapter, P as PreparedSegment, L as LineBreaksResult, C as CharPosition, a as LayoutCursor, I as Interval, b as LayoutLine, c as LayoutNextLineContext, d as LayoutNextLineResult, R as ReactiveLayoutBundle, e as ReactiveLayoutOptions, S as SegmentBreakKind, f as SegmentMeasureStats, g as analyzeAndMeasure, h as carveTextLineSlots, i as computeCharPositions, j as computeLineBreaks, l as layoutNextLine, r as reactiveLayout } from './reactive-layout-5oEn8lHM.cjs';
+import { M as MeasurementAdapter, P as PreparedSegment, L as LineBreaksResult, C as CharPosition, a as LayoutCursor, I as Interval, b as LayoutLine, c as LayoutNextLineContext, d as LayoutNextLineResult, R as ReactiveLayoutBundle, e as ReactiveLayoutOptions, S as SegmentBreakKind, f as SegmentMeasureStats, g as analyzeAndMeasure, h as carveTextLineSlots, i as computeCharPositions, j as computeLineBreaks, l as layoutNextLine, r as reactiveLayout } from './reactive-layout-Dhhe54Oj.cjs';
 import { a as Node } from './node-BVV7G1bq.cjs';
-import { G as Graph } from './graph-C4Uxwv0T.cjs';
+import { G as Graph } from './graph-CdJeX7O7.cjs';
 
 /**
  * MeasurementAdapter implementations (roadmap §7.1 — pluggable backends).

package/dist/{index-DD7RhHNJ.d.cts → index-C22aTC1X.d.cts}

@@ -1,9 +1,9 @@
 import { a as Node } from './node-BVV7G1bq.cjs';
-import { T as TopicGraph } from './index-B-z8WaSd.cjs';
-import { E as Evaluator, D as DatasetItem, a as EvalResult$1, R as RefineStrategy, b as RefineStatus, c as RefineLoopOptions } from './index-DylQCKEL.cjs';
-import { G as Graph, s as GraphProfileResult, r as GraphProfileOptions } from './graph-C4Uxwv0T.cjs';
+import { T as TopicGraph } from './index-BDLy6CQ9.cjs';
+import { E as Evaluator, D as DatasetItem, a as EvalResult$1, R as RefineStrategy, b as RefineStatus, c as RefineLoopOptions } from './index-BzxU4yhV.cjs';
+import { G as Graph, s as GraphProfileResult, r as GraphProfileOptions } from './graph-CdJeX7O7.cjs';
 import { L as LLMAdapter } from './types-BgMqbc7N.cjs';
-import { G as GateController } from './index-DVNLe3pS.cjs';
+import { G as GateController } from './index-CCdg0JLX.cjs';
 
 /**
  * Harness wiring types (roadmap §9.0).

package/dist/{index-yIdWFo2b.d.cts → index-C4QTaDli.d.cts}

@@ -1,9 +1,9 @@
 import { T as ToObservableOptions, t as toObservable } from './observable-BrUAPeH_.cjs';
 import { OnModuleInit, OnModuleDestroy, ExecutionContext, CanActivate, DynamicModule } from '@nestjs/common';
 import { ModuleRef } from '@nestjs/core';
-import { G as Graph, d as GraphPersistSnapshot } from './graph-C4Uxwv0T.cjs';
+import { G as Graph, d as GraphPersistSnapshot } from './graph-CdJeX7O7.cjs';
 import { A as Actor } from './node-BVV7G1bq.cjs';
-import { C as CqrsOptions, a as CqrsGraph, E as EventStoreAdapter } from './index-SSGqF8mI.cjs';
+import { C as CqrsOptions, a as CqrsGraph, E as EventStoreAdapter } from './index-aBqZUx3B.cjs';
 
 /** Class constructor key for decorator registries and Nest `ModuleRef.get()`. */
 type DecoratorHostConstructor = abstract new (...args: unknown[]) => unknown;

package/dist/{index-CJymKyzT.d.ts → index-C7RqYbOZ.d.ts}

@@ -9,7 +9,7 @@ import { MergeMapOptions, TapObserver, ThrottleOptions, audit, buffer, bufferCou
 import { IndexBackend, IndexRow, ListBackend, NativeIndexBackend, NativeListBackend, ReactiveIndexBundle, ReactiveIndexOptions, ReactiveListBundle, ReactiveListOptions, UpsertOptions, reactiveIndex, reactiveList } from './extra/reactive.js';
 import { L as LogBackend, N as NativeLogBackend, R as ReactiveLogBundle, a as ReactiveLogOptions, r as reactiveLog } from './reactive-log-BOJDCI5x.js';
 import { M as MapBackend, N as NativeMapBackend, b as NativeMapBackendOptions, R as ReactiveMapBundle, a as ReactiveMapOptions, c as ReactiveMapRetention, r as reactiveMap } from './reactive-map-CtRaCddO.js';
-import { a as GraphOptions, G as Graph } from './graph-CWeI0aHd.js';
+import { a as GraphOptions, G as Graph } from './graph-BOhEGJ6E.js';
 
 /**
  * External-register helpers — the common `register({emit, error, complete})`

package/dist/{index-C5Ghnp5B.d.ts → index-C9qCLIN4.d.ts}

@@ -1,6 +1,6 @@
-import { M as MeasurementAdapter, P as PreparedSegment, L as LineBreaksResult, C as CharPosition, a as LayoutCursor, I as Interval, b as LayoutLine, c as LayoutNextLineContext, d as LayoutNextLineResult, R as ReactiveLayoutBundle, e as ReactiveLayoutOptions, S as SegmentBreakKind, f as SegmentMeasureStats, g as analyzeAndMeasure, h as carveTextLineSlots, i as computeCharPositions, j as computeLineBreaks, l as layoutNextLine, r as reactiveLayout } from './reactive-layout-BAr6-_o5.js';
+import { M as MeasurementAdapter, P as PreparedSegment, L as LineBreaksResult, C as CharPosition, a as LayoutCursor, I as Interval, b as LayoutLine, c as LayoutNextLineContext, d as LayoutNextLineResult, R as ReactiveLayoutBundle, e as ReactiveLayoutOptions, S as SegmentBreakKind, f as SegmentMeasureStats, g as analyzeAndMeasure, h as carveTextLineSlots, i as computeCharPositions, j as computeLineBreaks, l as layoutNextLine, r as reactiveLayout } from './reactive-layout-Bq0rA2Wb.js';
 import { a as Node } from './node-BVV7G1bq.js';
-import { G as Graph } from './graph-CWeI0aHd.js';
+import { G as Graph } from './graph-BOhEGJ6E.js';
 
 /**
  * MeasurementAdapter implementations (roadmap §7.1 — pluggable backends).

package/dist/{index-DVNLe3pS.d.cts → index-CCdg0JLX.d.cts}

@@ -1,6 +1,6 @@
 import { a as Node, N as NodeOptions, c as NodeActions } from './node-BVV7G1bq.cjs';
 import { D as DerivedFn } from './sugar-CqR6DJ7v.cjs';
-import { G as Graph, a as GraphOptions } from './graph-C4Uxwv0T.cjs';
+import { G as Graph, a as GraphOptions } from './graph-CdJeX7O7.cjs';
 
 /**
  * Orchestration patterns (roadmap §4.1).

package/dist/{index-B5iVOD7w.d.ts → index-CEoU-r-g.d.ts}

@@ -1,5 +1,5 @@
-import { G as Graph } from './graph-CWeI0aHd.js';
-import { M as MeasurementAdapter } from './reactive-layout-BAr6-_o5.js';
+import { G as Graph } from './graph-BOhEGJ6E.js';
+import { M as MeasurementAdapter } from './reactive-layout-Bq0rA2Wb.js';
 
 /**
  * Three-pane demo shell (roadmap §7.2).