@graphrefly/graphrefly 0.33.0 → 0.35.0

package/dist/{index-Dgcd59CJ.d.cts → index-BkbawFkI.d.cts}

@@ -1,17 +1,18 @@
-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-Cp_4coR_.cjs';
-import { a as CascadeExhaustionReport, A as AdapterProvider, b as AdapterTier, d as AllTiersExhaustedError, C as CascadingLlmAdapterOptions, e as CreateAdapterOptions, O as OpenAICompatAdapterOptions, f as OpenAICompatPreset, g as OpenAISdkLike, h as cascadingLlmAdapter, c as createAdapter, o as openAICompatAdapter, t as tier } from './cascading-DKIb6Pk8.cjs';
-import { a as Node, A as Actor } from './node-8qx0kgYt.cjs';
-import { R as ReactiveLogBundle } from './reactive-log-CWC7jO4J.cjs';
-import { a as CircuitBreakerOptions, e as CircuitBreaker, f as CircuitOpenError } from './resilience-N_VtLf7W.cjs';
+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-BMSGPlpO.cjs';
+import { a as CascadeExhaustionReport, A as AdapterProvider, b as AdapterTier, d as AllTiersExhaustedError, C as CascadingLlmAdapterOptions, e as CreateAdapterOptions, O as OpenAICompatAdapterOptions, f as OpenAICompatPreset, g as OpenAISdkLike, h as cascadingLlmAdapter, c as createAdapter, o as openAICompatAdapter, t as tier } from './cascading-B25wxpRa.cjs';
+import { a as Node, A as Actor } from './node-fSc-hCv8.cjs';
+import { R as ReactiveLogBundle } from './reactive-log-CgbNqksB.cjs';
+import { a as CircuitBreakerOptions, e as CircuitBreaker, f as CircuitOpenError } from './resilience-BWP2c7Af.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-9YznPvPP.cjs';
-import { G as Graph, a as GraphOptions, h as GraphAttachStorageOptions } from './graph-DaoydJ_u.cjs';
-import { T as TopicGraph } from './index-Ccv_61jG.cjs';
-import { G as GateController, a as GateOptions } from './index-C2Dey3L-.cjs';
-import { D as DistillBundle, E as Extraction } from './composite-CmvdhTJe.cjs';
-import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-iKsmdnq6.cjs';
-import { StorageHandle, StorageTier } from './extra/storage-core.cjs';
-import { c as GraphSpecCatalog } from './index-BkfL5MXh.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-axI2cXwt.cjs';
+import { G as Graph, a as GraphOptions, i as GraphCheckpointRecord, h as GraphAttachStorageOptions } from './graph-kTltt95s.cjs';
+import { T as TopicGraph } from './index-B3Dfl5sS.cjs';
+import { G as GateController, c as GateOptions } from './pipeline-graph-B85HUrWg.cjs';
+import { D as DistillBundle, E as Extraction } from './composite-_XckYx2e.cjs';
+import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-D9qoEOj_.cjs';
+import { StorageHandle } from './extra/storage-core.cjs';
+import { SnapshotStorageTier } from './extra/storage-tiers.cjs';
+import { c as GraphSpecCatalog } from './index-BWH17rK_.cjs';
 
 /**
  * Observable adapter wrapper — the "inverted statistics" surface.
@@ -717,6 +718,12 @@ declare function dryRunAdapter(opts?: DryRunAdapterOptions): LLMAdapter;
 /**
  * GoogleAdapter — default fetch-backed, optional SDK-backed.
  *
+ * The SDK-backed path targets the `@google/genai` SDK shape:
+ * `client.models.generateContent({ model, contents, config })` — single
+ * param, with generation params and `abortSignal` under `config`. The
+ * legacy `@google/generative-ai` two-arg `(params, {signal})` shape is no
+ * longer accepted; pass a `GoogleGenAI` instance via `opts.sdk`.
+ *
  * Maps Gemini `usageMetadata`:
  * - `promptTokenCount` minus `cachedContentTokenCount` → `input.regular`
  * - `cachedContentTokenCount`                          → `input.cacheRead`
@@ -733,20 +740,47 @@ interface GoogleAdapterOptions {
     baseURL?: string;
     /** Extra headers on every request. */
     headers?: Record<string, string>;
-    /** Optional SDK instance (`@google/genai` or `@google/generative-ai` shape). */
+    /**
+     * Optional `@google/genai` SDK instance (e.g. `new GoogleGenAI({apiKey})`).
+     * When omitted, the adapter uses the fetch-backed path against the
+     * Generative Language REST API.
+     */
     sdk?: GoogleSdkLike;
     fetchImpl?: typeof fetch;
 }
+/**
+ * Duck-type matching the `@google/genai` (`GoogleGenAI`) SDK shape:
+ * single-param `generateContent({ model, contents, config })` where
+ * generation parameters and `abortSignal` live under `config`.
+ *
+ * The `@google/generative-ai` predecessor's two-arg `(params, {signal})`
+ * shape is no longer accepted.
+ */
 interface GoogleSdkLike {
     models: {
-        generateContent(params: Record<string, unknown>, opts?: {
-            signal?: AbortSignal;
-        }): Promise<GeminiResponse>;
-        generateContentStream?(params: Record<string, unknown>, opts?: {
-            signal?: AbortSignal;
-        }): AsyncIterable<GeminiResponse>;
+        generateContent(params: GoogleSdkRequestParams): Promise<GeminiResponse>;
+        generateContentStream?(params: GoogleSdkRequestParams): Promise<AsyncIterable<GeminiResponse>> | AsyncIterable<GeminiResponse>;
     };
 }
+/** Single-param request shape consumed by `@google/genai`'s `models.generateContent`. */
+interface GoogleSdkRequestParams {
+    model: string;
+    contents: unknown;
+    config?: GoogleSdkRequestConfig;
+}
+/**
+ * Generation config under the new SDK. `abortSignal` is the cancellation
+ * channel — there is no second-arg `{signal}`.
+ */
+interface GoogleSdkRequestConfig {
+    abortSignal?: AbortSignal;
+    temperature?: number;
+    maxOutputTokens?: number;
+    systemInstruction?: unknown;
+    tools?: unknown;
+    thinkingConfig?: unknown;
+    [extra: string]: unknown;
+}
 interface GeminiResponse {
     candidates?: ReadonlyArray<{
         content?: {
@@ -1825,8 +1859,8 @@ type MemoryTiersOptions<TMem> = {
     /** Predicate: true → entry belongs in permanent tier (default: never). */
     permanentFilter?: (key: string, mem: TMem) => boolean;
     /** Storage tier for the archive. Omit to disable archiving. */
-    archiveTier?: StorageTier;
-    /** Options forwarded to `graph.attachStorage` for the archive tier. */
+    archiveTier?: SnapshotStorageTier<GraphCheckpointRecord>;
+    /** Options forwarded to `graph.attachSnapshotStorage` for the archive tier. */
     archiveStorageOptions?: GraphAttachStorageOptions;
 };
 /** @internal */
@@ -1963,6 +1997,12 @@ type AgentMemoryGraph<TMem = unknown> = Graph & {
      */
     readonly retrieveReactive: ((queryInput: NodeInput<RetrievalQuery | null>) => Node<ReadonlyArray<RetrievalEntry<TMem>>>) | null;
 };
+/**
+ * Pre-wired agentic memory graph. Sugar over `distill` plus the
+ * `memoryWithVectors` / `memoryWithKG` / `memoryWithTiers` / `memoryRetrieval`
+ * composers. Power users who want a subset of capabilities can call those
+ * composers directly; this factory bundles them into one ergonomic call.
+ */
 declare function agentMemory<TMem = unknown>(name: string, source: NodeInput<unknown>, opts: AgentMemoryOptions<TMem>): AgentMemoryGraph<TMem>;
 
 type LLMExtractorOptions = {
@@ -2024,8 +2064,18 @@ declare function memoryWithVectors<TMem>(graph: Graph, store: DistillBundle<TMem
     dispose: () => void;
 };
 type MemoryWithKGOptions<TMem> = {
-    /** Extract entities + relations for a memory entry. */
-    entityFn: (key: string, mem: TMem) => {
+    /**
+     * Mount path for the KG subgraph on the parent graph. Defaults to `name`.
+     * Pass a different value when the parent graph reserves a stable mount
+     * path (e.g. `agentMemory` mounts at `"kg"` regardless of outer name).
+     */
+    mountPath?: string;
+    /**
+     * Extract entities + relations for a memory entry. Omit to mount an empty
+     * KG without an indexer effect — caller upserts entities / relations
+     * directly on the returned `kg` handle.
+     */
+    entityFn?: (key: string, mem: TMem) => {
         entities?: Array<{
             id: string;
             value: unknown;
@@ -2039,12 +2089,16 @@ type MemoryWithKGOptions<TMem> = {
     } | 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.
+ * Attach a knowledge graph alongside a `DistillBundle`. Inner graph is named
+ * `${name}-kg`; mount path defaults to `name` but can be overridden via
+ * `opts.mountPath` so a parent factory (e.g. `agentMemory`) can keep a stable
+ * mount path independent of the inner graph's identity.
+ *
+ * If `opts.entityFn` is omitted, no indexer effect is wired — the empty KG is
+ * mounted for manual `upsertEntity` / `link` use.
  *
- * Indexer keepalive is registered with `graph.addDisposer`; explicit
- * `dispose()` is also available.
+ * Indexer keepalive (when present) 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>;
@@ -2399,6 +2453,8 @@ type index_GatedStreamOptions = GatedStreamOptions;
 type index_GaugesAsContextOptions = GaugesAsContextOptions;
 type index_GoogleAdapterOptions = GoogleAdapterOptions;
 type index_GoogleSdkLike = GoogleSdkLike;
+type index_GoogleSdkRequestConfig = GoogleSdkRequestConfig;
+type index_GoogleSdkRequestParams = GoogleSdkRequestParams;
 type index_GraphDefValidation = GraphDefValidation;
 type index_GraphFromSpecOptions = GraphFromSpecOptions;
 type index_HandoffOptions = HandoffOptions;
@@ -2531,7 +2587,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_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 { 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_GoogleSdkRequestConfig as GoogleSdkRequestConfig, type index_GoogleSdkRequestParams as GoogleSdkRequestParams, 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 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 };
+export { type MemoryWithTiersOptions 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 GoogleSdkRequestConfig as I, type GoogleSdkRequestParams as J, type GraphDefValidation as K, type GraphFromSpecOptions as L, type HandoffOptions as M, type HttpErrorLike as N, type KeywordFlag as O, type KeywordFlagExtractorOptions as P, type KnobsAsToolsResult as Q, type LLMConsolidatorOptions as R, type LLMExtractorOptions as S, LLMTimeoutError as T, type McpToolSchema as U, type MemoryRetrievalBundle as V, type MemoryRetrievalOptions as W, type MemoryTier as X, type MemoryTiersBundle as Y, type MemoryTiersOptions as Z, type MemoryWithKGOptions as _, type AdmissionScore3DOptions as a, toolCallExtractor as a$, type MemoryWithVectorsOptions as a0, type OpenAIToolSchema as a1, type PromptNodeOptions as a2, type RedactorOptions as a3, type ResilientAdapterBundle as a4, type ResilientAdapterOptions as a5, type RetrievalEntry as a6, type RetrievalPipelineOptions as a7, type RetrievalQuery as a8, type RetrievalTrace as a9, dryRunAdapter as aA, fromLLM as aB, frozenContext as aC, gatedStream as aD, gaugesAsContext as aE, googleAdapter as aF, graphFromSpec as aG, graphFromSpecReactive as aH, handoff as aI, keywordFlagExtractor as aJ, knobsAsTools as aK, llmConsolidator as aL, llmExtractor as aM, memoryRetrieval as aN, memoryWithKG as aO, memoryWithTiers as aP, memoryWithVectors as aQ, observableAdapter as aR, parseRateLimitFromError as aS, promptNode as aT, redactor as aU, resilientAdapter as aV, streamExtractor as aW, streamingPromptNode as aX, suggestStrategy as aY, suggestStrategyReactive as aZ, systemPromptBuilder as a_, type StampedDelta as aa, type StrategyOperation as ab, type StrategyPlan as ac, type StreamingPromptNodeHandle as ad, type StreamingPromptNodeOptions as ae, type SuggestStrategyOptions as af, type SystemPromptHandle as ag, type ToolExecutionOptions as ah, ToolRegistryGraph as ai, type ToolRegistryOptions as aj, type ToolResult as ak, type ToolSelectorOptions as al, type WithBreakerOptions as am, type WithBudgetGateOptions as an, type WithDryRunBundle as ao, type WithDryRunOptions as ap, type WithRateLimiterOptions as aq, type WithRetryOptions as ar, admissionFilter3D as as, admissionScored as at, agentLoop as au, agentMemory as av, anthropicAdapter as aw, chatStream as ax, contentGate as ay, costMeterExtractor as az, type AdmissionScoredOptions as b, toolExecution as b0, toolRegistry as b1, toolSelector as b2, validateGraphDef as b3, withBreaker as b4, withBudgetGate as b5, withDryRun as b6, withRateLimiter as b7, withRetry as b8, withTimeout as b9, 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-RJX4snyi.d.cts → index-BlRVj-7Q.d.cts}

@@ -1,6 +1,6 @@
-import { j as CompileSpecOptions, G as GraphSpec, c as GraphSpecCatalog, C as CatalogFnEntry, a as CatalogSourceEntry, b as ConfigFieldSchema, F as FnFactory, d as GraphSpecFeedbackEdge, e as GraphSpecNode, f as GraphSpecTemplate, g as GraphSpecTemplateRef, h as GraphSpecValidation, S as SourceFactory } from './index-BkfL5MXh.cjs';
-import { G as Graph, o as GraphNodeFactory, m as GraphDiffResult } from './graph-DaoydJ_u.cjs';
-import { StorageTier } from './extra/storage-core.cjs';
+import { j as CompileSpecOptions, G as GraphSpec, c as GraphSpecCatalog, C as CatalogFnEntry, a as CatalogSourceEntry, b as ConfigFieldSchema, F as FnFactory, d as GraphSpecFeedbackEdge, e as GraphSpecNode, f as GraphSpecTemplate, g as GraphSpecTemplateRef, h as GraphSpecValidation, S as SourceFactory } from './index-BWH17rK_.cjs';
+import { G as Graph, o as GraphNodeFactory, m as GraphDiffResult } from './graph-kTltt95s.cjs';
+import { KvStorageTier } from './extra/storage-tiers.cjs';
 
 /**
  * Surface: create a graph from a {@link GraphSpec} (§9.3-core).
@@ -121,15 +121,15 @@ interface ReduceOptions {
 declare function runReduction(spec: GraphSpec, input: unknown, opts?: ReduceOptions): Promise<unknown>;
 
 /**
- * Surface: snapshot save/restore/diff/list over {@link StorageTier} (§9.3-core).
+ * Surface: snapshot save/restore/diff/list over {@link KvStorageTier} (§9.3-core).
  *
  * One-shot snapshot management for stateless callers (MCP tools, CLI
  * commands) layered on the existing multi-tier auto-checkpoint substrate.
  * A saved snapshot is a `mode: "full"` {@link GraphCheckpointRecord} with
  * `seq: 0` — byte-identical to the baseline anchor
- * {@link Graph.attachStorage} writes on its first flush. An
+ * {@link Graph.attachSnapshotStorage} writes on its first flush. An
  * auto-checkpointed graph can therefore be restored through this surface,
- * and a surface-saved snapshot can be picked up by `attachStorage({
+ * and a surface-saved snapshot can be picked up by `attachSnapshotStorage({
  * autoRestore: true })`.
  *
  * The wire envelope stays at {@link SNAPSHOT_WIRE_VERSION}; no new format.
@@ -139,7 +139,7 @@ declare function runReduction(spec: GraphSpec, input: unknown, opts?: ReduceOpti
 
 /**
  * Current envelope version. Re-exported from `graph.ts` so the one-shot
- * surface path and `Graph.attachStorage` write byte-identical
+ * surface path and `Graph.attachSnapshotStorage` write byte-identical
  * `format_version` fields — no silent wire drift.
  */
 declare const SNAPSHOT_WIRE_VERSION = 1;
@@ -157,11 +157,11 @@ interface RestoreSnapshotOptions {
  * Write a graph's current state as a one-shot `mode: "full"` record.
  *
  * Uses the same {@link GraphCheckpointRecord} envelope as
- * {@link Graph.attachStorage} so the two persistence paths interoperate.
+ * {@link Graph.attachSnapshotStorage} so the two persistence paths interoperate.
  *
  * @throws {SurfaceError} `snapshot-failed` when the tier's `save` throws.
  */
-declare function saveSnapshot(graph: Graph, snapshotId: string, tier: StorageTier): Promise<SaveSnapshotResult>;
+declare function saveSnapshot(graph: Graph, snapshotId: string, tier: KvStorageTier): Promise<SaveSnapshotResult>;
 /**
  * Load a snapshot from a tier and materialize it as a new {@link Graph}.
  *
@@ -171,18 +171,18 @@ declare function saveSnapshot(graph: Graph, snapshotId: string, tier: StorageTie
  *
  * **Requires a `mode: "full"` record.** Surface-written snapshots from
  * {@link saveSnapshot} always qualify. Records written by
- * {@link Graph.attachStorage} with `compactEvery > 1` may be
+ * {@link Graph.attachSnapshotStorage} with `compactEvery > 1` may be
  * `mode: "diff"` between compacts — those throw `restore-failed` until
  * the tier's next compact flush (or until Phase 8.7 WAL replay lands).
  * If you need interop during development, either call
  * {@link saveSnapshot} explicitly (always full) or configure
- * `attachStorage({compactEvery: 1})`.
+ * `attachSnapshotStorage({compactEvery: 1})`.
  *
  * @throws {SurfaceError} `snapshot-not-found` on miss; `restore-failed`
  *   when the payload shape doesn't match, when the record is
  *   `mode: "diff"`, or when `Graph.fromSnapshot` rejects.
  */
-declare function restoreSnapshot(snapshotId: string, tier: StorageTier, opts?: RestoreSnapshotOptions): Promise<Graph>;
+declare function restoreSnapshot(snapshotId: string, tier: KvStorageTier, opts?: RestoreSnapshotOptions): Promise<Graph>;
 /**
  * Load two snapshots and compute a {@link GraphDiffResult} via static
  * {@link Graph.diff}. Returns the audit shape (structural + value diff,
@@ -190,37 +190,37 @@ declare function restoreSnapshot(snapshotId: string, tier: StorageTier, opts?: R
  *
  * @throws {SurfaceError} `snapshot-not-found` on either miss.
  */
-declare function diffSnapshots(snapshotIdA: string, snapshotIdB: string, tier: StorageTier): Promise<GraphDiffResult>;
+declare function diffSnapshots(snapshotIdA: string, snapshotIdB: string, tier: KvStorageTier): Promise<GraphDiffResult>;
 /**
  * Enumerate snapshot ids on a tier.
  *
  * Only keys written by {@link saveSnapshot} are returned. Surface-written
  * records are stored under the `"snapshot:"` key prefix and decoded back to
  * the caller-visible id before being returned — other keys on the same tier
- * (notably `attachStorage` baseline/WAL keys written under `graph.name`) are
+ * (notably `attachSnapshotStorage` baseline/WAL keys written under `graph.name`) are
  * filtered out automatically. This lets a single tier back both the surface
- * and `attachStorage` without leaking graph names through `listSnapshots`.
+ * and `attachSnapshotStorage` without leaking graph names through `listSnapshots`.
  *
  * @param tier — the storage tier to enumerate.
  * @param opts.includeUnprefixed — when `true`, also return keys that are
  *   NOT under the namespacing prefix. Off by default; set this when reading
  *   pre-namespacing snapshot sets.
  *
- *   **Caveat:** when a tier is shared with {@link Graph.attachStorage}, its
+ *   **Caveat:** when a tier is shared with {@link Graph.attachSnapshotStorage}, its
  *   auto-checkpoint baseline + WAL keys (written under `graph.name`) are
  *   unprefixed. Calling with `includeUnprefixed: true` returns those keys
  *   alongside surface snapshots — and subsequent `restoreSnapshot` /
  *   `deleteSnapshot` will operate on them via the fallback-lookup path,
  *   potentially overwriting or deleting live auto-checkpoint state. Use
  *   `includeUnprefixed` only against tiers you know are NOT shared with
- *   `attachStorage`, or follow up with a predicate filter to separate
+ *   `attachSnapshotStorage`, or follow up with a predicate filter to separate
  *   ids you own from ones owned by other subsystems.
  *
  * @throws {SurfaceError} `tier-no-list` when the tier does not implement
  *   the optional `list()` method. Check `typeof tier.list === "function"`
  *   before calling if you want to branch on capability.
  */
-declare function listSnapshots(tier: StorageTier, opts?: {
+declare function listSnapshots(tier: KvStorageTier, opts?: {
     includeUnprefixed?: boolean;
 }): Promise<readonly string[]>;
 /**
@@ -232,7 +232,7 @@ declare function listSnapshots(tier: StorageTier, opts?: {
  * @throws {SurfaceError} `snapshot-failed` when `clear` is unsupported
  *   or throws.
  */
-declare function deleteSnapshot(snapshotId: string, tier: StorageTier): Promise<void>;
+declare function deleteSnapshot(snapshotId: string, tier: KvStorageTier): Promise<void>;
 
 /**
  * Surface layer (§9.3-core) — shared, JSON-safe operations consumed by
@@ -245,8 +245,8 @@ declare function deleteSnapshot(snapshotId: string, tier: StorageTier): Promise<
  * 1. {@link createGraph} — `compileSpec` wrapped with typed surface errors.
  * 2. {@link reduce} — one-shot `input → pipeline → output`.
  *
- * Snapshot persistence reuses the {@link StorageTier} substrate introduced
- * for `Graph.attachStorage`, so one-shot snapshots and auto-checkpoints
+ * Snapshot persistence reuses the {@link KvStorageTier} substrate introduced
+ * for `Graph.attachSnapshotStorage`, so one-shot snapshots and auto-checkpoints
  * share the {@link GraphCheckpointRecord} envelope. No new wire format.
  *
  * Errors throw as {@link SurfaceError} — wrappers map to their native

package/dist/index-BpFwRAf9.d.cts

@@ -0,0 +1,26 @@
+import { C as CatchOptions, a as ClassifyResult, D as Decision, b as DecisionAction, G as GateController, c as GateOptions, P as PipelineGraph, S as StepRef, T as TerminalCause, d as decisionKeyOf, p as pipelineGraph } from './pipeline-graph-B85HUrWg.cjs';
+
+/**
+ * Orchestration patterns (roadmap §4.1).
+ *
+ * Domain-layer helpers that build workflow shapes on top of core + extra primitives.
+ * Exported under the `patterns.orchestration` namespace to avoid collisions with
+ * Phase 2 operator names (for example `gate`, `forEach`).
+ */
+
+declare const index_CatchOptions: typeof CatchOptions;
+declare const index_ClassifyResult: typeof ClassifyResult;
+declare const index_Decision: typeof Decision;
+declare const index_DecisionAction: typeof DecisionAction;
+declare const index_GateController: typeof GateController;
+declare const index_GateOptions: typeof GateOptions;
+declare const index_PipelineGraph: typeof PipelineGraph;
+declare const index_StepRef: typeof StepRef;
+declare const index_TerminalCause: typeof TerminalCause;
+declare const index_decisionKeyOf: typeof decisionKeyOf;
+declare const index_pipelineGraph: typeof pipelineGraph;
+declare namespace index {
+  export { index_CatchOptions as CatchOptions, index_ClassifyResult as ClassifyResult, index_Decision as Decision, index_DecisionAction as DecisionAction, index_GateController as GateController, index_GateOptions as GateOptions, index_PipelineGraph as PipelineGraph, index_StepRef as StepRef, index_TerminalCause as TerminalCause, index_decisionKeyOf as decisionKeyOf, index_pipelineGraph as pipelineGraph };
+}
+
+export { index as i };

package/dist/{index-Ds3Rz9m9.d.cts → index-BsZlbHM5.d.cts}

@@ -1,6 +1,6 @@
-import { a as Node } from './node-8qx0kgYt.cjs';
-import { S as StatusValue, C as CircuitState, R as RateLimiterOptions, a as CircuitBreakerOptions, b as RetryOptions, F as FallbackInput, N as NS_PER_MS, c as NS_PER_SEC } from './resilience-N_VtLf7W.cjs';
-import { B as BudgetConstraint } from './index-yJY9thRY.cjs';
+import { a as Node } from './node-fSc-hCv8.cjs';
+import { S as StatusValue, C as CircuitState, R as RateLimiterOptions, a as CircuitBreakerOptions, b as RetryOptions, F as FallbackInput, N as NS_PER_MS, c as NS_PER_SEC } from './resilience-BWP2c7Af.cjs';
+import { B as BudgetConstraint } from './index-XxSeddWP.cjs';
 
 /**
  * Resilience composition with correct nesting order (roadmap §9.0b).

package/dist/{index-BFHpNSsV.d.ts → index-BtY2QVDf.d.cts}

@@ -1,9 +1,10 @@
-import { T as ToObservableOptions, t as toObservable } from './observable-DOniYM2B.js';
+import { T as ToObservableOptions, t as toObservable } from './observable-Cqty11jG.cjs';
 import { OnModuleInit, OnModuleDestroy, ExecutionContext, CanActivate, DynamicModule } from '@nestjs/common';
 import { ModuleRef } from '@nestjs/core';
-import { G as Graph, d as GraphPersistSnapshot } from './graph-BROUZPG9.js';
-import { A as Actor } from './node-8qx0kgYt.js';
-import { C as CqrsOptions, a as CqrsGraph, E as EventStoreAdapter } from './index-Cq7Uqgu4.js';
+import { G as Graph, b as GraphPersistSnapshot } from './graph-kTltt95s.cjs';
+import { A as Actor } from './node-fSc-hCv8.cjs';
+import { c as CqrsOptions, b as CqrsGraph, a as CqrsEvent } from './index-zK_mN1D-.cjs';
+import { AppendLogStorageTier } from './extra/storage-tiers.cjs';
 
 /** Class constructor key for decorator registries and Nest `ModuleRef.get()`. */
 type DecoratorHostConstructor = abstract new (...args: unknown[]) => unknown;
@@ -599,8 +600,8 @@ interface GraphReflyCqrsOptions {
     cqrs?: CqrsOptions;
     /** Build callback — registers commands, events, projections, sagas on the CqrsGraph. */
     build?: (graph: CqrsGraph) => void;
-    /** Event store adapter for persistence (wired via `useEventStore()`). */
-    eventStore?: EventStoreAdapter;
+    /** Append-log storage tiers for event persistence (wired via `attachEventStorage()`). */
+    eventStorage?: readonly AppendLogStorageTier<CqrsEvent>[];
     /**
      * Node paths (local to this feature) to expose as injectable providers.
      * Tokens are auto-qualified as `featureName::path`.
@@ -665,7 +666,7 @@ declare class GraphReflyModule {
      *   name: "orders",
      *   build: (g) => {
      *     g.event("orderPlaced");
-     *     g.projection("orderCount", ["orderPlaced"], (_s, evts) => evts.length, 0);
+     *     g.projection({ name: "orderCount", events: ["orderPlaced"], reducer: (_s, evts) => evts.length, initial: 0 });
      *   },
      * })
      * ```

package/dist/{index-BsxqmV6u.d.ts → index-BuMzxRO2.d.ts}

@@ -1,5 +1,5 @@
-import { a as Node } from './node-8qx0kgYt.js';
-import { a as GraphOptions, G as Graph } from './graph-BROUZPG9.js';
+import { a as Node } from './node-fSc-hCv8.js';
+import { a as GraphOptions, G as Graph } from './graph-Cv-8x0ZI.js';
 
 /**
  * Domain templates (roadmap §8.2).

package/dist/{index-C5uMGVJw.d.ts → index-BwYGLgmI.d.ts}

@@ -1,7 +1,7 @@
-import { a as Node } from './node-8qx0kgYt.js';
-import { R as ReactiveMapBundle } from './reactive-map-LjwjcFaW.js';
-import { a as GraphOptions, G as Graph, C as CausalChain } from './graph-BROUZPG9.js';
-import { w as watchTopologyTree } from './topology-tree-CAFOG5S5.js';
+import { a as Node } from './node-fSc-hCv8.js';
+import { R as ReactiveMapBundle } from './reactive-map-CHyeCf4D.js';
+import { a as GraphOptions, G as Graph, C as CausalChain } from './graph-Cv-8x0ZI.js';
+import { w as watchTopologyTree } from './topology-tree-CJsT24DP.js';
 
 /** Aggregate topology stats emitted by {@link LensGraph.stats}. */
 interface TopologyStats {