@graphrefly/graphrefly 0.38.0 → 0.39.0

package/dist/{index-CrlHFsiT.d.ts → index-89FczVZ_.d.ts}

@@ -1,18 +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-CidcBDuk.js';
-import { a as CascadeExhaustionReport, A as AdapterProvider, b as AdapterTier, d as AllTiersExhaustedError, C as CascadingLlmAdapterOptions, e as CreateAdapterOptions, O as OpenAICompatAdapterOptions, f as OpenAICompatPreset, g as OpenAISdkLike, h as cascadingLlmAdapter, c as createAdapter, o as openAICompatAdapter, t as tier } from './cascading-BsJ4GbnS.js';
-import { a as Node, A as Actor } from './node-fSc-hCv8.js';
-import { R as ReactiveLogBundle } from './reactive-log-BgWSA1fg.js';
-import { a as CircuitBreakerOptions, e as CircuitBreaker, f as CircuitOpenError } from './resilience-Bys63Cpd.js';
+import { T as TokenUsage, L as LLMAdapter, P as PricingFn, C as ChatMessage, a as LLMInvokeOptions, d as ToolDefinition, b as LLMResponse, S as StreamDelta, c as ToolCall, e as CapabilitiesRegistry, M as ModelCapabilities, f as ModelFeatures, g as ModelLimits, h as ModelPricing, i as PriceBreakdown, j as PricingRegistry, R as Rate, k as TieredRate, l as composePricing, m as computePrice, n as createCapabilitiesRegistry, o as createPricingRegistry, p as pricingFor, r as registryPricing, z as zeroPrice } from './types-39jk0kaV.js';
+import { a as CascadeExhaustionReport, A as AdapterProvider, b as AdapterTier, d as AllTiersExhaustedError, C as CascadingLlmAdapterOptions, e as CreateAdapterOptions, O as OpenAICompatAdapterOptions, f as OpenAICompatPreset, g as OpenAISdkLike, h as cascadingLlmAdapter, c as createAdapter, o as openAICompatAdapter, t as tier } from './cascading-g2_rhhaM.js';
+import { N as Node, A as Actor } from './node-BYInONRr.js';
+import { a as ReactiveLogBundle } from './reactive-log-BlAsPLl2.js';
+import { a as CircuitBreakerOptions, e as CircuitBreaker, f as CircuitOpenError } from './index-CmqiJZKM.js';
 import { NodeInput } from './extra/sources.js';
-import { W as WithReplayCacheOptions, F as FallbackAdapterOptions, a as FallbackFixture, b as FallbackMissError, c as FallbackMissPolicy, R as ReplayCacheKeyContext, d as ReplayCacheMissError, e as ReplayCacheMode, f as canonicalJson, g as fallbackAdapter, w as withReplayCache } from './fallback-DuEXfA4F.js';
-import { G as Graph, a as GraphOptions, k as GraphCheckpointRecord, j as GraphAttachStorageOptions } from './graph-BjW1taJl.js';
-import { T as TopicGraph } from './index-BUFCHvOR.js';
-import { G as GateController, c as GateOptions } from './pipeline-graph-9JBbmRxA.js';
-import { D as DistillBundle, E as Extraction } from './composite-DTOlDuch.js';
-import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexGraph, K as KnowledgeGraph } from './index-Di7OdwlO.js';
+import { W as WithReplayCacheOptions, F as FallbackAdapterOptions, a as FallbackFixture, b as FallbackMissError, c as FallbackMissPolicy, R as ReplayCacheKeyContext, d as ReplayCacheMissError, e as ReplayCacheMode, f as canonicalJson, g as fallbackAdapter, w as withReplayCache } from './fallback-CMZl39L5.js';
+import { G as Graph, a as GraphOptions, k as GraphCheckpointRecord, j as GraphAttachStorageOptions } from './graph-30XSgtVX.js';
+import { T as TopicGraph } from './index-DszPlZzK.js';
+import { G as GateController, c as GateOptions } from './pipeline-graph-D8vKcO_p.js';
+import { D as DistillBundle, E as Extraction } from './composite-DGatA-JK.js';
+import { V as VectorSearchResult, C as CollectionGraph, a as VectorIndexGraph, K as KnowledgeGraph } from './index-DQUVq1_d.js';
 import { StorageHandle } from './extra/storage-core.js';
 import { SnapshotStorageTier } from './extra/storage-tiers.js';
-import { c as GraphSpecCatalog } from './index-DTDVDzhA.js';
+import { c as GraphSpecCatalog } from './index-BKMdnYnk.js';
 
 /**
  * Observable adapter wrapper — the "inverted statistics" surface.
@@ -821,28 +821,6 @@ interface GeminiUsage {
 }
 declare function googleAdapter(opts?: GoogleAdapterOptions): LLMAdapter;
 
-/**
- * `fromLLM` — reactive LLM invocation sugar.
- *
- * @module
- */
-
-type FromLLMOptions = {
-    name?: string;
-    model?: string;
-    temperature?: number;
-    maxTokens?: number;
-    tools?: readonly ToolDefinition[];
-    systemPrompt?: string;
-};
-/**
- * Reactive LLM invocation adapter. Returns a derived node that re-invokes
- * the LLM whenever the messages dep changes.
- *
- * Uses `switchMap` internally — new invocations cancel stale in-flight ones.
- */
-declare function fromLLM(adapter: LLMAdapter, messages: NodeInput<readonly ChatMessage[]>, opts?: FromLLMOptions): Node<LLMResponse | null>;
-
 /**
  * `frozenContext` — prefix-cache-friendly snapshot of upstream context.
  *
@@ -897,55 +875,26 @@ type FrozenContextOptions = {
  */
 declare function frozenContext<T>(source: NodeInput<T>, opts?: FrozenContextOptions): Node<T | null>;
 
-/**
- * `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.
- * Locked as path (b) producer-based by Session C (2026-04-27).
- *
- * **Retry / replay-cache.** Stack middleware on the adapter:
- *
- * ```ts
- * import { withRetry, withReplayCache } from "@graphrefly/graphrefly/patterns/ai";
- *
- * const adapter = withRetry(
- *   withReplayCache(baseAdapter, { keyFn: (ctx) => ctx.messages[0].content }),
- *   { count: 3, backoff: 200 },
- * );
- * const result = promptNode(adapter, [input], (q) => q);
- * ```
- *
- * `promptNode` no longer ships `retries` / `cache` options — they duplicated
- * middleware already at the adapter layer.
- *
- * **Cross-wave cache (COMPOSITION-GUIDE §32).** The switchMap output cache
- * survives across new outer DATAs — `promptNode`'s cached value persists
- * until the next wave fully resolves. Consumers that need to distinguish
- * "fresh value for THIS session" from "stale cache from a prior session"
- * (e.g. `agentLoop` resetting on new `run()`) must add a `state()` mirror
- * at their session boundary and depend on the mirror, not the `promptNode`
- * output directly. `promptNode` itself stays primitive — it does not
- * embed a state-mirror.
- *
- * @module
- */
-
 type PromptNodeOptions = {
     name?: string;
     model?: string;
     temperature?: number;
     maxTokens?: number;
-    /** Output format — `"json"` attempts JSON.parse on the response. Default: `"text"`. */
-    format?: "text" | "json";
+    /**
+     * Output format:
+     * - `"text"` (default) — emit the response content as a string.
+     * - `"json"` — `JSON.parse` the content (markdown fences stripped).
+     * - `"raw"` — emit the full {@link LLMResponse} object (subsumes the
+     *   pre-Tier-2.3 `fromLLM` shape; use this when you need `usage` /
+     *   `toolCalls` / `finishReason` alongside `content`).
+     */
+    format?: "text" | "json" | "raw";
+    /**
+     * Optional tool definitions forwarded to the adapter. Pair with
+     * `format: "raw"` (or read `toolCalls` from a downstream parser) when
+     * tool-calling is in scope.
+     */
+    tools?: readonly ToolDefinition[];
     /**
      * Optional system prompt. Forwarded via `opts.systemPrompt` to the adapter
      * only — never pushed as a `{role:"system"}` message (avoiding the
@@ -996,7 +945,12 @@ type PromptNodeOptions = {
  * @param opts - Optional configuration.
  * @returns `Node` emitting LLM responses (string or parsed JSON).
  */
-declare function promptNode<T = string>(adapter: LLMAdapter, deps: readonly Node<unknown>[], prompt: string | ((...depValues: unknown[]) => string), opts?: PromptNodeOptions): Node<T | null>;
+declare function promptNode(adapter: LLMAdapter, deps: readonly Node<unknown>[], prompt: string | ((...depValues: unknown[]) => string), opts: PromptNodeOptions & {
+    format: "raw";
+}): Node<LLMResponse | null>;
+declare function promptNode<T = string>(adapter: LLMAdapter, deps: readonly Node<unknown>[], prompt: string | ((...depValues: unknown[]) => string), opts?: Omit<PromptNodeOptions, "format"> & {
+    format?: "text" | "json";
+}): Node<T | null>;
 
 /**
  * `streamingPromptNode` + `gatedStream` — streaming LLM transforms.
@@ -1886,8 +1840,12 @@ type MemoryTiersOptions<TMem> = {
 /** @internal */
 declare const DEFAULT_DECAY_RATE: number;
 type MemoryTiersBundle<TMem> = {
-    /** Permanent tier: never evicted. */
-    readonly permanent: LightCollectionBundle<TMem>;
+    /**
+     * Permanent tier: never evicted. Backed by a `collection({ranked:false})`
+     * Graph (Tier 2.3 — was previously a `LightCollectionBundle`; the no-Graph
+     * bundle shape was folded into the unified `CollectionGraph`).
+     */
+    readonly permanent: CollectionGraph<TMem>;
     /** Active entries node (reactive, holds ReadonlyMap). */
     readonly activeEntries: Node<unknown>;
     /** Archive storage handle (null if no tier configured). */
@@ -2466,7 +2424,6 @@ declare const index_FallbackAdapterOptions: typeof FallbackAdapterOptions;
 declare const index_FallbackFixture: typeof FallbackFixture;
 declare const index_FallbackMissError: typeof FallbackMissError;
 declare const index_FallbackMissPolicy: typeof FallbackMissPolicy;
-type index_FromLLMOptions = FromLLMOptions;
 type index_FrozenContextOptions = FrozenContextOptions;
 type index_GatedStreamHandle<T> = GatedStreamHandle<T>;
 type index_GatedStreamOptions = GatedStreamOptions;
@@ -2563,7 +2520,6 @@ declare const index_createCapabilitiesRegistry: typeof createCapabilitiesRegistr
 declare const index_createPricingRegistry: typeof createPricingRegistry;
 declare const index_dryRunAdapter: typeof dryRunAdapter;
 declare const index_fallbackAdapter: typeof fallbackAdapter;
-declare const index_fromLLM: typeof fromLLM;
 declare const index_frozenContext: typeof frozenContext;
 declare const index_gatedStream: typeof gatedStream;
 declare const index_gaugesAsContext: typeof gaugesAsContext;
@@ -2607,7 +2563,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_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 { 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_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_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 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 };
+export { type MemoryWithVectorsOptions as $, type AdapterStats as A, type BudgetCaps as B, type CallStatsEvent as C, DEFAULT_DECAY_RATE as D, type ExtractedToolCall as E, type FrozenContextOptions as F, type GatedStreamHandle as G, type GoogleSdkRequestConfig as H, type GoogleSdkRequestParams as I, type GraphDefValidation as J, type GraphFromSpecOptions as K, type HandoffOptions as L, type HttpErrorLike as M, type KeywordFlag as N, type KeywordFlagExtractorOptions as O, type KnobsAsToolsResult as P, type LLMConsolidatorOptions as Q, type LLMExtractorOptions as R, LLMTimeoutError as S, type McpToolSchema as T, type MemoryRetrievalBundle as U, type MemoryRetrievalOptions as V, type MemoryTier as W, type MemoryTiersBundle as X, type MemoryTiersOptions as Y, type MemoryWithKGOptions as Z, type MemoryWithTiersOptions as _, type AdmissionScore3DOptions as a, toolRegistry as a$, type OpenAIToolSchema as a0, type PromptNodeOptions as a1, type RedactorOptions as a2, type ResilientAdapterBundle as a3, type ResilientAdapterOptions as a4, type RetrievalEntry as a5, type RetrievalPipelineOptions as a6, type RetrievalQuery as a7, type RetrievalTrace as a8, type StampedDelta 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 StrategyOperation as aa, type StrategyPlan as ab, type StreamingPromptNodeHandle as ac, type StreamingPromptNodeOptions as ad, type SuggestStrategyOptions as ae, type SystemPromptHandle as af, type ToolExecutionOptions as ag, ToolRegistryGraph as ah, type ToolRegistryOptions as ai, type ToolResult as aj, type ToolSelectorOptions as ak, type WithBreakerOptions as al, type WithBudgetGateOptions as am, type WithDryRunBundle as an, type WithDryRunOptions as ao, type WithRateLimiterOptions as ap, type WithRetryOptions as aq, admissionFilter3D as ar, admissionScored as as, agentLoop as at, agentMemory as au, anthropicAdapter as av, chatStream as aw, contentGate as ax, costMeterExtractor as ay, dryRunAdapter 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 GatedStreamOptions as w, type GaugesAsContextOptions as x, type GoogleAdapterOptions as y, type GoogleSdkLike as z };

package/dist/{index-CM-i58FY.d.cts → index-8R1vzNOx.d.cts}

@@ -1,12 +1,12 @@
-import { i as index$2 } from './index-D_QQ_dTD.cjs';
-import { i as index$3 } from './index-B3D_z0Z6.cjs';
-import { i as index$4 } from './index-CAV-3RpJ.cjs';
-import { i as index$5 } from './index-BFuVcqL8.cjs';
-import { a as Node } from './node-fSc-hCv8.cjs';
-import { i as index$6 } from './index-9xhIaM-w.cjs';
-import { i as index$7 } from './index-CpZKtdMw.cjs';
-import { i as index$8 } from './index-CqSJ25A9.cjs';
-import { i as index$9 } from './index-CAbHN_rP.cjs';
+import { i as index$2 } from './index-DYTBbF8T.cjs';
+import { i as index$3 } from './index-CL7oilfm.cjs';
+import { i as index$4 } from './index-FVoPvhAu.cjs';
+import { i as index$5 } from './index-D3ayz3hy.cjs';
+import { N as Node } from './node-BYInONRr.cjs';
+import { i as index$6 } from './index-DOBLxOti.cjs';
+import { i as index$7 } from './index-PgwvGWa1.cjs';
+import { i as index$8 } from './index-z8WFPVI8.cjs';
+import { i as index$9 } from './index-DIHcMLr6.cjs';
 
 /**
  * Options for creating signals.

package/dist/{index-CDvC1m5p.d.ts → index-B2RUoIUz.d.ts}

@@ -1,4 +1,4 @@
-import { a as Node } from './node-fSc-hCv8.js';
+import { N as Node } from './node-BYInONRr.js';
 
 /** Solid accessor function — returns current value when called. */
 type Accessor<T> = () => T;

package/dist/{index-BFaALJxR.d.ts → index-B41Asm7D.d.ts}

@@ -1,8 +1,8 @@
-import { a as Node } from './node-fSc-hCv8.js';
-import { R as ReactiveLogBundle } from './reactive-log-BgWSA1fg.js';
+import { N as Node } from './node-BYInONRr.js';
+import { B as BaseAuditRecord } from './index-CusEP3Sv.js';
+import { a as ReactiveLogBundle } from './reactive-log-BlAsPLl2.js';
 import { AppendLogStorageTier } from './extra/storage-tiers.js';
-import { a as GraphOptions, G as Graph } from './graph-BjW1taJl.js';
-import { B as BaseAuditRecord } from './imperative-audit-ahAE65a9.js';
+import { a as GraphOptions, G as Graph } from './graph-30XSgtVX.js';
 
 /**
  * CQRS patterns (roadmap §4.5).
@@ -64,13 +64,14 @@ declare const cqrsEventKeyOf: (e: CqrsEvent) => string;
 interface DispatchRecord<T = unknown> extends BaseAuditRecord {
     readonly commandName: string;
     readonly payload: T;
-    readonly status: "success" | "failed";
+    /** Action result. Tier 1.6.2 canonical enum (renamed from `status`). */
+    readonly outcome: "success" | "failure";
     readonly error?: unknown;
     readonly errorType?: string;
     /**
      * Event names emitted by the handler.
-     * - `status: "success"`: events that persisted in the event log.
-     * - `status: "failed"`: events the handler ATTEMPTED to emit before throwing;
+     * - `outcome: "success"`: events that persisted in the event log.
+     * - `outcome: "failure"`: events the handler ATTEMPTED to emit before throwing;
      *   they were rolled back and did NOT persist. Documents the failed attempt's
      *   intentions for debugging handler logic. The actual event log shows only
      *   what's durable.
@@ -80,7 +81,8 @@ interface DispatchRecord<T = unknown> extends BaseAuditRecord {
 declare const dispatchKeyOf: <T>(r: DispatchRecord<T>) => string;
 interface SagaInvocation<T = unknown> extends BaseAuditRecord {
     readonly eventType: string;
-    readonly status: "success" | "failed";
+    /** Action result. Tier 1.6.2 canonical enum (renamed from `status`). */
+    readonly outcome: "success" | "failure";
     readonly error?: unknown;
     readonly errorType?: string;
     readonly aggregateId?: string;

package/dist/{index-D-HZ7sP4.d.ts → index-B9fmw5n2.d.ts}

@@ -1,6 +1,6 @@
-import { p as GraphReFlyConfig } from './node-fSc-hCv8.js';
-import { b as GraphPersistSnapshot, k as GraphCheckpointRecord, G as Graph, C as CausalChain, e as CausalStep, D as DescribeFilter, E as ExplainPathOptions, h as GRAPH_META_SEGMENT, i as GraphActorOptions, j as GraphAttachStorageOptions, c as GraphDescribeOptions, d as GraphDescribeOutput, l as GraphDiagramDirection, m as GraphDiagramOptions, n as GraphDiffChange, o as GraphDiffResult, p as GraphFactoryContext, q as GraphNodeFactory, r as GraphObserveAll, s as GraphObserveOne, a as GraphOptions, t as GraphProfileOptions, u as GraphProfileResult, v as GraphVersionChange, w as GraphWALDiff, N as NodeProfile, O as ObserveDetail, x as ObserveEvent, y as ObserveOptions, z as ObserveResult, A as ObserveTheme, B as ObserveThemeName, R as ReachableDirection, F as ReachableOptions, S as SNAPSHOT_VERSION, T as TopologyEvent, H as TraceEntry, I as diffForWAL, J as explainPath, K as graphProfile, L as mermaidLiveUrl, P as reachable } from './graph-BjW1taJl.js';
-import { w as watchTopologyTree } from './topology-tree-D47-nI6Z.js';
+import { o as GraphReFlyConfig } from './node-BYInONRr.js';
+import { c as GraphPersistSnapshot, k as GraphCheckpointRecord, G as Graph, C as CausalChain, e as CausalStep, D as DescribeFilter, E as ExplainPathOptions, h as GRAPH_META_SEGMENT, i as GraphActorOptions, j as GraphAttachStorageOptions, d as GraphDescribeOptions, b as GraphDescribeOutput, l as GraphDiagramDirection, m as GraphDiffChange, n as GraphDiffResult, o as GraphFactoryContext, p as GraphNodeFactory, q as GraphObserveAll, r as GraphObserveOne, a as GraphOptions, s as GraphProfileOptions, t as GraphProfileResult, u as GraphVersionChange, v as GraphWALDiff, N as NodeProfile, O as ObserveDetail, w as ObserveEvent, x as ObserveOptions, y as ObserveResult, z as ObserveTheme, A as ObserveThemeName, R as ReachableDirection, B as ReachableOptions, S as SNAPSHOT_VERSION, T as TopologyEvent, F as TraceEntry, H as diffForWAL, I as explainPath, J as graphProfile, K as reachable } from './graph-30XSgtVX.js';
+import { w as watchTopologyTree } from './topology-tree-BtvbgMXJ.js';
 
 /**
  * Approximate in-memory size estimation for arbitrary JS values.
@@ -418,7 +418,6 @@ type index_GraphCodec = GraphCodec;
 declare const index_GraphDescribeOptions: typeof GraphDescribeOptions;
 declare const index_GraphDescribeOutput: typeof GraphDescribeOutput;
 declare const index_GraphDiagramDirection: typeof GraphDiagramDirection;
-declare const index_GraphDiagramOptions: typeof GraphDiagramOptions;
 declare const index_GraphDiffChange: typeof GraphDiffChange;
 declare const index_GraphDiffResult: typeof GraphDiffResult;
 declare const index_GraphFactoryContext: typeof GraphFactoryContext;
@@ -458,7 +457,6 @@ declare const index_diffForWAL: typeof diffForWAL;
 declare const index_encodeEnvelope: typeof encodeEnvelope;
 declare const index_explainPath: typeof explainPath;
 declare const index_graphProfile: typeof graphProfile;
-declare const index_mermaidLiveUrl: typeof mermaidLiveUrl;
 declare const index_reachable: typeof reachable;
 declare const index_registerBuiltinCodecs: typeof registerBuiltinCodecs;
 declare const index_replayWAL: typeof replayWAL;
@@ -466,7 +464,7 @@ declare const index_sizeof: typeof sizeof;
 declare const index_validateGraphObservability: typeof validateGraphObservability;
 declare const index_watchTopologyTree: typeof watchTopologyTree;
 declare namespace index {
-  export { index_CausalChain as CausalChain, index_CausalStep as CausalStep, index_DescribeFilter as DescribeFilter, index_ENVELOPE_VERSION as ENVELOPE_VERSION, type index_EvictedSubgraphInfo as EvictedSubgraphInfo, type index_EvictionPolicy as EvictionPolicy, index_ExplainPathOptions as ExplainPathOptions, index_GRAPH_META_SEGMENT as GRAPH_META_SEGMENT, index_Graph as Graph, index_GraphActorOptions as GraphActorOptions, index_GraphAttachStorageOptions as GraphAttachStorageOptions, index_GraphCheckpointRecord as GraphCheckpointRecord, type index_GraphCodec as GraphCodec, index_GraphDescribeOptions as GraphDescribeOptions, index_GraphDescribeOutput as GraphDescribeOutput, index_GraphDiagramDirection as GraphDiagramDirection, index_GraphDiagramOptions as GraphDiagramOptions, index_GraphDiffChange as GraphDiffChange, index_GraphDiffResult as GraphDiffResult, index_GraphFactoryContext as GraphFactoryContext, index_GraphNodeFactory as GraphNodeFactory, index_GraphObserveAll as GraphObserveAll, index_GraphObserveOne as GraphObserveOne, index_GraphOptions as GraphOptions, index_GraphPersistSnapshot as GraphPersistSnapshot, index_GraphProfileOptions as GraphProfileOptions, index_GraphProfileResult as GraphProfileResult, index_GraphVersionChange as GraphVersionChange, index_GraphWALDiff as GraphWALDiff, index_JsonCodec as JsonCodec, type index_LazyGraphCodec as LazyGraphCodec, index_NodeProfile as NodeProfile, type index_ObservabilityCheck as ObservabilityCheck, type index_ObservabilityDescribeFormat as ObservabilityDescribeFormat, index_ObserveDetail as ObserveDetail, index_ObserveEvent as ObserveEvent, index_ObserveOptions as ObserveOptions, index_ObserveResult as ObserveResult, index_ObserveTheme as ObserveTheme, index_ObserveThemeName as ObserveThemeName, index_ReachableDirection as ReachableDirection, index_ReachableOptions as ReachableOptions, OVERHEAD as SIZEOF_OVERHEAD, index_SIZEOF_SYMBOL as SIZEOF_SYMBOL, index_SNAPSHOT_VERSION as SNAPSHOT_VERSION, index_TopologyEvent as TopologyEvent, index_TraceEntry as TraceEntry, type index_ValidateObservabilityOptions as ValidateObservabilityOptions, type index_ValidateObservabilityResult as ValidateObservabilityResult, type index_WALEntry as WALEntry, index_createDagCborCodec as createDagCborCodec, index_createDagCborZstdCodec as createDagCborZstdCodec, index_decodeEnvelope as decodeEnvelope, index_diffForWAL as diffForWAL, index_encodeEnvelope as encodeEnvelope, index_explainPath as explainPath, index_graphProfile as graphProfile, index_mermaidLiveUrl as mermaidLiveUrl, index_reachable as reachable, index_registerBuiltinCodecs as registerBuiltinCodecs, index_replayWAL as replayWAL, index_sizeof as sizeof, index_validateGraphObservability as validateGraphObservability, index_watchTopologyTree as watchTopologyTree };
+  export { index_CausalChain as CausalChain, index_CausalStep as CausalStep, index_DescribeFilter as DescribeFilter, index_ENVELOPE_VERSION as ENVELOPE_VERSION, type index_EvictedSubgraphInfo as EvictedSubgraphInfo, type index_EvictionPolicy as EvictionPolicy, index_ExplainPathOptions as ExplainPathOptions, index_GRAPH_META_SEGMENT as GRAPH_META_SEGMENT, index_Graph as Graph, index_GraphActorOptions as GraphActorOptions, index_GraphAttachStorageOptions as GraphAttachStorageOptions, index_GraphCheckpointRecord as GraphCheckpointRecord, type index_GraphCodec as GraphCodec, index_GraphDescribeOptions as GraphDescribeOptions, index_GraphDescribeOutput as GraphDescribeOutput, index_GraphDiagramDirection as GraphDiagramDirection, index_GraphDiffChange as GraphDiffChange, index_GraphDiffResult as GraphDiffResult, index_GraphFactoryContext as GraphFactoryContext, index_GraphNodeFactory as GraphNodeFactory, index_GraphObserveAll as GraphObserveAll, index_GraphObserveOne as GraphObserveOne, index_GraphOptions as GraphOptions, index_GraphPersistSnapshot as GraphPersistSnapshot, index_GraphProfileOptions as GraphProfileOptions, index_GraphProfileResult as GraphProfileResult, index_GraphVersionChange as GraphVersionChange, index_GraphWALDiff as GraphWALDiff, index_JsonCodec as JsonCodec, type index_LazyGraphCodec as LazyGraphCodec, index_NodeProfile as NodeProfile, type index_ObservabilityCheck as ObservabilityCheck, type index_ObservabilityDescribeFormat as ObservabilityDescribeFormat, index_ObserveDetail as ObserveDetail, index_ObserveEvent as ObserveEvent, index_ObserveOptions as ObserveOptions, index_ObserveResult as ObserveResult, index_ObserveTheme as ObserveTheme, index_ObserveThemeName as ObserveThemeName, index_ReachableDirection as ReachableDirection, index_ReachableOptions as ReachableOptions, OVERHEAD as SIZEOF_OVERHEAD, index_SIZEOF_SYMBOL as SIZEOF_SYMBOL, index_SNAPSHOT_VERSION as SNAPSHOT_VERSION, index_TopologyEvent as TopologyEvent, index_TraceEntry as TraceEntry, type index_ValidateObservabilityOptions as ValidateObservabilityOptions, type index_ValidateObservabilityResult as ValidateObservabilityResult, type index_WALEntry as WALEntry, index_createDagCborCodec as createDagCborCodec, index_createDagCborZstdCodec as createDagCborZstdCodec, index_decodeEnvelope as decodeEnvelope, index_diffForWAL as diffForWAL, index_encodeEnvelope as encodeEnvelope, index_explainPath as explainPath, index_graphProfile as graphProfile, index_reachable as reachable, index_registerBuiltinCodecs as registerBuiltinCodecs, index_replayWAL as replayWAL, index_sizeof as sizeof, index_validateGraphObservability as validateGraphObservability, index_watchTopologyTree as watchTopologyTree };
 }
 
 export { ENVELOPE_VERSION as E, type GraphCodec as G, JsonCodec as J, type LazyGraphCodec as L, type ObservabilityCheck as O, SIZEOF_SYMBOL as S, type ValidateObservabilityOptions as V, type WALEntry as W, type EvictedSubgraphInfo as a, type EvictionPolicy as b, type ObservabilityDescribeFormat as c, OVERHEAD as d, type ValidateObservabilityResult as e, createDagCborCodec as f, createDagCborZstdCodec as g, decodeEnvelope as h, encodeEnvelope as i, index as j, replayWAL as k, registerBuiltinCodecs as r, sizeof as s, validateGraphObservability as v };

package/dist/{index-Bn0uZEL4.d.ts → index-BAlaVimV.d.ts}

@@ -1,12 +1,12 @@
-import { i as index$2 } from './index-JYtN9uqM.js';
-import { i as index$3 } from './index-8OxXae3g.js';
-import { i as index$4 } from './index-B-ORMr3k.js';
-import { i as index$5 } from './index-CIcu6fIR.js';
-import { a as Node } from './node-fSc-hCv8.js';
-import { i as index$6 } from './index-CDvC1m5p.js';
-import { i as index$7 } from './index-BjWZARLy.js';
-import { i as index$8 } from './index-BiomL7AW.js';
-import { i as index$9 } from './index-ML6vHKXK.js';
+import { i as index$2 } from './index-CoM4rzyB.js';
+import { i as index$3 } from './index-yLt-aPMp.js';
+import { i as index$4 } from './index-C7VV_qOs.js';
+import { i as index$5 } from './index-2n8Eai6M.js';
+import { N as Node } from './node-BYInONRr.js';
+import { i as index$6 } from './index-B2RUoIUz.js';
+import { i as index$7 } from './index-Ctb7_2sG.js';
+import { i as index$8 } from './index-BJSZxSFX.js';
+import { i as index$9 } from './index-CPhBvRJU.js';
 
 /**
  * Options for creating signals.

package/dist/{index-DJVQ-t07.d.ts → index-BC9VybQs.d.ts}

@@ -1,6 +1,6 @@
-import { A as Actor, a as Node, P as PolicyRuleData, G as GuardAction } from './node-fSc-hCv8.js';
-import { G as Graph, a as GraphOptions, b as GraphPersistSnapshot, C as CausalChain } from './graph-BjW1taJl.js';
-import { T as TopicGraph } from './index-BUFCHvOR.js';
+import { A as Actor, N as Node, P as PolicyRuleData, G as GuardAction } from './node-BYInONRr.js';
+import { G as Graph, a as GraphOptions, c as GraphPersistSnapshot } from './graph-30XSgtVX.js';
+import { T as TopicGraph } from './index-DszPlZzK.js';
 
 /**
  * Audit, policy enforcement, and compliance export (roadmap §9.2).
@@ -10,9 +10,10 @@ import { T as TopicGraph } from './index-BUFCHvOR.js';
  *
  * - {@link auditTrail} — reactive mutation log with by-node/by-actor/by-time
  *   queries.
- * - {@link policyEnforcer} — reactive ABAC enforcement; in `"audit"` mode
- *   records would-be denials, in `"enforce"` mode pushes guards onto target
- *   nodes so subsequent writes throw {@link GuardDenied}.
+ * - {@link policyGate} — reactive ABAC gate (Tier 2.3 rename of
+ *   `policyEnforcer`); in `"audit"` mode records would-be denials, in
+ *   `"enforce"` mode pushes guards onto target nodes so subsequent writes
+ *   throw {@link GuardDenied}.
  * - {@link complianceSnapshot} — point-in-time export of graph state +
  *   audit trail + policies for regulatory archival.
  *
@@ -88,7 +89,7 @@ declare class AuditTrailGraph extends Graph {
  * snapshot synchronously.
  */
 declare function auditTrail(target: Graph, opts?: AuditTrailOptions): AuditTrailGraph;
-/** A single policy denial recorded by {@link PolicyEnforcerGraph}. */
+/** A single policy denial recorded by {@link PolicyGateGraph}. */
 interface PolicyViolation {
     timestamp_ns: number;
     wall_clock_ns: number;
@@ -99,8 +100,8 @@ interface PolicyViolation {
     /** `"observed"` (audit mode after-the-fact) or `"blocked"` (enforce mode pre-write). */
     result: "observed" | "blocked";
 }
-/** Options for {@link policyEnforcer}. */
-interface PolicyEnforcerOptions {
+/** Options for {@link policyGate}. */
+interface PolicyGateOptions {
     name?: string;
     graph?: GraphOptions;
     /**
@@ -122,14 +123,28 @@ interface PolicyEnforcerOptions {
      * `target` OR any transitively-mounted subgraph after construction are
      * guarded automatically (enforce mode only).
      *
+     * Accepts a static `readonly string[]` or a reactive
+     * `Node<readonly string[]>` (Tier 3.4 — F.9 reactive primitive carve-out).
+     * When a `Node` is passed, the enforcer rebinds the guarded path set on
+     * every emission: paths added to the new set get wrapped, paths removed
+     * from the new set get released, and the audit-mode allow-list filter
+     * uses the latest cached value. Static-array callers retain the current
+     * "caller owns the path set" semantics.
+     *
      * **Cost:** unrestricted mode runs `describe({detail:"minimal"})` once
      * at construction (O(N) over the graph tree) plus one topology
      * subscription per graph instance in the mount tree. Restricted mode
-     * skips both and disables dynamic coverage — callers providing
-     * `paths` must re-create on subgraph changes.
+     * (static or reactive) skips both and disables `watchTopologyTree`
+     * dynamic coverage — for reactive callers, the path-set Node is the
+     * single source of truth for which paths are guarded.
+     */
+    paths?: readonly string[] | Node<readonly string[]>;
+    /**
+     * Ring-buffer cap for the violations topic. Default: 1000. Static
+     * number only — reactive form is deferred pending TopicGraph reactive
+     * `retainedLimit` support (see Tier 10.8 design follow-up in
+     * `docs/optimizations.md`).
      */
-    paths?: readonly string[];
-    /** Ring-buffer cap for the violations topic. Default: 1000. */
     violationsLimit?: number;
 }
 /**
@@ -138,14 +153,14 @@ interface PolicyEnforcerOptions {
  * to update them at runtime; the enforcer rebinds its internal
  * {@link NodeGuard} on every push.
  */
-declare class PolicyEnforcerGraph extends Graph {
+declare class PolicyGateGraph extends Graph {
     readonly policies: Node<readonly PolicyRuleData[]>;
     readonly violations: TopicGraph<PolicyViolation>;
     readonly violationCount: Node<number>;
     private readonly _target;
     private readonly _mode;
     private _currentGuard;
-    constructor(target: Graph, policies: readonly PolicyRuleData[] | Node<readonly PolicyRuleData[]>, opts: PolicyEnforcerOptions);
+    constructor(target: Graph, policies: readonly PolicyRuleData[] | Node<readonly PolicyRuleData[]>, opts: PolicyGateOptions);
     private _publishViolation;
     /** Snapshot of recorded violations. */
     all(): readonly PolicyViolation[];
@@ -157,37 +172,16 @@ declare class PolicyEnforcerGraph extends Graph {
  * static rule list or a {@link Node} of rules (LLM-updatable). Records
  * `PolicyViolation` entries to `violations` topic; in `"enforce"` mode also
  * pushes guards onto target nodes so disallowed writes throw.
- */
-declare function policyEnforcer(target: Graph, policies: readonly PolicyRuleData[] | Node<readonly PolicyRuleData[]>, opts?: PolicyEnforcerOptions): PolicyEnforcerGraph;
-/**
- * Reactive {@link CausalChain} that recomputes whenever the audited graph
- * changes. Returns a `Node<CausalChain>` suitable for subscription, mounting,
- * or composition (e.g. inside `graphLens.why(node)`).
  *
- * **How it stays live:** an internal `version` state is bumped by an observer
- * attached to `target.observe()`; the derived chain depends on `version`, so
- * each mutation triggers a recompute. To avoid stalling on no-op events, only
- * `data`, `error`, `complete`, and `teardown` bump the version (matching the
- * audit defaults).
- */
-/**
- * @deprecated Use `graph.explain(from, to, { reactive: true, ... })` directly.
- *   This free-function wrapper now dispatches to the consolidated
- *   {@link Graph.explain} overload for mental-model consistency with
- *   `describe` / `observe`. Will be removed pre-1.0.
+ * Self-tags via `g.tagFactory("policyGate", placeholderArgs(opts))` so
+ * `graph.describe()` surfaces `factory: "policyGate"` provenance (Phase 2.5
+ * DT5 ride-along, locked with the Tier 2.3 rename).
  */
-declare function reactiveExplainPath(target: Graph, from: string, to: string, opts?: {
-    maxDepth?: number;
-    name?: string;
-    findCycle?: boolean;
-}): {
-    node: Node<CausalChain>;
-    dispose: () => void;
-};
+declare function policyGate(target: Graph, policies: readonly PolicyRuleData[] | Node<readonly PolicyRuleData[]>, opts?: PolicyGateOptions): PolicyGateGraph;
 /** Options for {@link complianceSnapshot}. */
 interface ComplianceSnapshotOptions {
     audit?: AuditTrailGraph;
-    policies?: PolicyEnforcerGraph;
+    policies?: PolicyGateGraph;
     /** Actor recorded as the snapshot taker. */
     actor?: Actor;
 }
@@ -236,16 +230,15 @@ declare const index_AuditTrailGraph: typeof AuditTrailGraph;
 type index_AuditTrailOptions = AuditTrailOptions;
 type index_ComplianceSnapshotOptions = ComplianceSnapshotOptions;
 type index_ComplianceSnapshotResult = ComplianceSnapshotResult;
-type index_PolicyEnforcerGraph = PolicyEnforcerGraph;
-declare const index_PolicyEnforcerGraph: typeof PolicyEnforcerGraph;
-type index_PolicyEnforcerOptions = PolicyEnforcerOptions;
+type index_PolicyGateGraph = PolicyGateGraph;
+declare const index_PolicyGateGraph: typeof PolicyGateGraph;
+type index_PolicyGateOptions = PolicyGateOptions;
 type index_PolicyViolation = PolicyViolation;
 declare const index_auditTrail: typeof auditTrail;
 declare const index_complianceSnapshot: typeof complianceSnapshot;
-declare const index_policyEnforcer: typeof policyEnforcer;
-declare const index_reactiveExplainPath: typeof reactiveExplainPath;
+declare const index_policyGate: typeof policyGate;
 declare namespace index {
-  export { type index_AuditEntry as AuditEntry, index_AuditTrailGraph as AuditTrailGraph, type index_AuditTrailOptions as AuditTrailOptions, type index_ComplianceSnapshotOptions as ComplianceSnapshotOptions, type index_ComplianceSnapshotResult as ComplianceSnapshotResult, index_PolicyEnforcerGraph as PolicyEnforcerGraph, type index_PolicyEnforcerOptions as PolicyEnforcerOptions, type index_PolicyViolation as PolicyViolation, index_auditTrail as auditTrail, index_complianceSnapshot as complianceSnapshot, index_policyEnforcer as policyEnforcer, index_reactiveExplainPath as reactiveExplainPath };
+  export { type index_AuditEntry as AuditEntry, index_AuditTrailGraph as AuditTrailGraph, type index_AuditTrailOptions as AuditTrailOptions, type index_ComplianceSnapshotOptions as ComplianceSnapshotOptions, type index_ComplianceSnapshotResult as ComplianceSnapshotResult, index_PolicyGateGraph as PolicyGateGraph, type index_PolicyGateOptions as PolicyGateOptions, type index_PolicyViolation as PolicyViolation, index_auditTrail as auditTrail, index_complianceSnapshot as complianceSnapshot, index_policyGate as policyGate };
 }
 
-export { type AuditEntry as A, type ComplianceSnapshotOptions as C, PolicyEnforcerGraph as P, type PolicyViolation as a, AuditTrailGraph as b, type AuditTrailOptions as c, type ComplianceSnapshotResult as d, type PolicyEnforcerOptions as e, auditTrail as f, complianceSnapshot as g, index as i, policyEnforcer as p, reactiveExplainPath as r };
+export { type AuditEntry as A, type ComplianceSnapshotOptions as C, PolicyGateGraph as P, type PolicyViolation as a, AuditTrailGraph as b, type AuditTrailOptions as c, type ComplianceSnapshotResult as d, type PolicyGateOptions as e, auditTrail as f, complianceSnapshot as g, index as i, policyGate as p };

package/dist/{index-5dNRlW7J.d.ts → index-BEHmxORq.d.ts}

@@ -1,16 +1,16 @@
-import { P as PolicyRuleData, a as Node, A as Actor } from './node-fSc-hCv8.js';
-import { G as Graph, a as GraphOptions, c as GraphDescribeOptions, d as GraphDescribeOutput, D as DescribeFilter } from './graph-BjW1taJl.js';
-import { P as PolicyEnforcerGraph, a as PolicyViolation } from './index-DJVQ-t07.js';
-import { T as TopicGraph } from './index-BUFCHvOR.js';
+import { P as PolicyRuleData, N as Node, A as Actor } from './node-BYInONRr.js';
+import { G as Graph, a as GraphOptions, d as GraphDescribeOptions, b as GraphDescribeOutput, D as DescribeFilter } from './graph-30XSgtVX.js';
+import { P as PolicyGateGraph, a as PolicyViolation } from './index-BC9VybQs.js';
+import { T as TopicGraph } from './index-DszPlZzK.js';
 
 /**
  * Composable safety layer (roadmap §9.0b).
  *
  * {@link guardedExecution} wraps any {@link Graph} with:
  *
- * - {@link policyEnforcer} — reactive ABAC, policies stored as a `Node` so
- *   LLMs / humans can update them at runtime. Now with full transitive
- *   dynamic coverage via `watchTopologyTree`.
+ * - {@link policyGate} — reactive ABAC (Tier 2.3 rename of `policyEnforcer`),
+ *   policies stored as a `Node` so LLMs / humans can update them at runtime.
+ *   Now with full transitive dynamic coverage via `watchTopologyTree`.
  * - Scoped {@link GuardedExecutionGraph.scopedDescribe} — delegates to
  *   `target.describe({actor})` so callers see only what the actor is
  *   allowed to see.
@@ -53,7 +53,7 @@ interface GuardedExecutionOptions {
      * blocking writes.
      */
     mode?: "audit" | "enforce";
-    /** Ring-buffer cap for the `violations` topic. Default 1000 (inherited from policyEnforcer). */
+    /** Ring-buffer cap for the `violations` topic. Default 1000 (inherited from policyGate). */
     violationsLimit?: number;
     /** Wrapper graph name. Default `${target.name}_guarded`. */
     name?: string;
@@ -62,12 +62,12 @@ interface GuardedExecutionOptions {
 }
 /**
  * Wrapper over a target {@link Graph} providing reactive ABAC + scoped
- * describe. Mounts a {@link PolicyEnforcerGraph} under `enforcer`.
+ * describe. Mounts a {@link PolicyGateGraph} under `enforcer`.
  *
  * @category patterns
  */
 declare class GuardedExecutionGraph extends Graph {
-    readonly enforcer: PolicyEnforcerGraph;
+    readonly enforcer: PolicyGateGraph;
     readonly violations: TopicGraph<PolicyViolation>;
     private readonly _target;
     private readonly _defaultActor;
@@ -97,7 +97,7 @@ declare class GuardedExecutionGraph extends Graph {
     get target(): Graph;
 }
 /**
- * Wrap a {@link Graph} with {@link policyEnforcer} plus a scoped describe
+ * Wrap a {@link Graph} with {@link policyGate} plus a scoped describe
  * lens. Returns a {@link GuardedExecutionGraph} that can be mounted, diffed,
  * or composed with {@link graphLens}.
  *