@graphrefly/graphrefly 0.33.0 → 0.35.0

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

@@ -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-B2LfBvNc.js';
-import { a as CascadeExhaustionReport, A as AdapterProvider, b as AdapterTier, d as AllTiersExhaustedError, C as CascadingLlmAdapterOptions, e as CreateAdapterOptions, O as OpenAICompatAdapterOptions, f as OpenAICompatPreset, g as OpenAISdkLike, h as cascadingLlmAdapter, c as createAdapter, o as openAICompatAdapter, t as tier } from './cascading-Bg0a4VSf.js';
-import { a as Node, A as Actor } from './node-8qx0kgYt.js';
-import { R as ReactiveLogBundle } from './reactive-log-CqaBg8nf.js';
-import { a as CircuitBreakerOptions, e as CircuitBreaker, f as CircuitOpenError } from './resilience-RjDIHZNZ.js';
+import { 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-ByBb8g6A.js';
+import { a as CircuitBreakerOptions, e as CircuitBreaker, f as CircuitOpenError } from './resilience-Bys63Cpd.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-mYSd8vQo.js';
-import { G as Graph, a as GraphOptions, h as GraphAttachStorageOptions } from './graph-BROUZPG9.js';
-import { T as TopicGraph } from './index-Bi4ZP6Hc.js';
-import { G as GateController, a as GateOptions } from './index-HvJ90_tX.js';
-import { D as DistillBundle, E as Extraction } from './composite-BPDU_XV1.js';
-import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-ygRFoyrN.js';
-import { StorageHandle, StorageTier } from './extra/storage-core.js';
-import { c as GraphSpecCatalog } from './index-Chi9IiHJ.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, i as GraphCheckpointRecord, h as GraphAttachStorageOptions } from './graph-Cv-8x0ZI.js';
+import { T as TopicGraph } from './index-C9xF16gc.js';
+import { G as GateController, c as GateOptions } from './pipeline-graph-HOTU4UG0.js';
+import { D as DistillBundle, E as Extraction } from './composite-CT_mApQD.js';
+import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-CI_yjtua.js';
+import { StorageHandle } from './extra/storage-core.js';
+import { SnapshotStorageTier } from './extra/storage-tiers.js';
+import { c as GraphSpecCatalog } from './index-DlccEIi3.js';
 
 /**
  * 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-b4a6Sg0R.d.ts → index-DwNNufVa.d.ts}

@@ -1,7 +1,7 @@
-import { P as PolicyRuleData, a as Node, A as Actor } from './node-8qx0kgYt.js';
-import { G as Graph, a as GraphOptions, b as GraphDescribeOptions, c as GraphDescribeOutput, D as DescribeFilter } from './graph-BROUZPG9.js';
-import { P as PolicyEnforcerGraph, a as PolicyViolation } from './index-CNxdDb2e.js';
-import { T as TopicGraph } from './index-Bi4ZP6Hc.js';
+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-Cv-8x0ZI.js';
+import { P as PolicyEnforcerGraph, a as PolicyViolation } from './index-Bilohojo.js';
+import { T as TopicGraph } from './index-C9xF16gc.js';
 
 /**
  * Composable safety layer (roadmap §9.0b).

package/dist/{index-D80nGRb9.d.ts → index-DzYTXMBz.d.ts}

@@ -1,6 +1,6 @@
-import { a as Node } from './node-8qx0kgYt.js';
-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-RjDIHZNZ.js';
-import { B as BudgetConstraint } from './index-DheNs40A.js';
+import { a as Node } from './node-fSc-hCv8.js';
+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-Bys63Cpd.js';
+import { B as BudgetConstraint } from './index-DXSLMoma.js';
 
 /**
  * Resilience composition with correct nesting order (roadmap §9.0b).

package/dist/index-DzgS5uYi.d.ts

@@ -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-HOTU4UG0.js';
+
+/**
+ * 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-B-KCkW4M.d.cts → index-GaW6Welt.d.cts}

@@ -1,7 +1,7 @@
-import { a as Node } from './node-8qx0kgYt.cjs';
-import { R as ReactiveMapBundle } from './reactive-map-Cm89Hk0c.cjs';
-import { a as GraphOptions, G as Graph, C as CausalChain } from './graph-DaoydJ_u.cjs';
-import { w as watchTopologyTree } from './topology-tree-BB6oJxMz.cjs';
+import { a as Node } from './node-fSc-hCv8.cjs';
+import { R as ReactiveMapBundle } from './reactive-map-DmgeADH8.cjs';
+import { a as GraphOptions, G as Graph, C as CausalChain } from './graph-kTltt95s.cjs';
+import { w as watchTopologyTree } from './topology-tree-C50l9ARE.cjs';
 
 /** Aggregate topology stats emitted by {@link LensGraph.stats}. */
 interface TopologyStats {

package/dist/{index-DupIl9wI.d.ts → index-JYtN9uqM.d.ts}

@@ -1,4 +1,4 @@
-import { a as Node } from './node-8qx0kgYt.js';
+import { a as Node } from './node-fSc-hCv8.js';
 
 /**
  * Options for creating an atom.

package/dist/{index-Ced0dphF.d.ts → index-KNAMYngu.d.ts}

@@ -1,12 +1,12 @@
-import { i as index$2 } from './index-DupIl9wI.js';
-import { i as index$3 } from './index-CI5fULSz.js';
-import { i as index$4 } from './index-BFHpNSsV.js';
-import { i as index$5 } from './index-DxEcY7Om.js';
-import { a as Node } from './node-8qx0kgYt.js';
-import { i as index$6 } from './index-BRisOxlx.js';
-import { i as index$7 } from './index-BWiX5foT.js';
-import { i as index$8 } from './index-zA1uVtk0.js';
-import { i as index$9 } from './index-nP13Qe6T.js';
+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-DSD6xnbT.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-DFe2Pk2u.js';
 
 /**
  * Options for creating signals.

package/dist/{index-BpjQanLs.d.cts → index-PluovH45.d.cts}

@@ -1,5 +1,5 @@
-import { G as Graph } from './graph-DaoydJ_u.cjs';
-import { M as MeasurementAdapter } from './reactive-layout-Dk9AOQb_.cjs';
+import { G as Graph } from './graph-kTltt95s.cjs';
+import { M as MeasurementAdapter } from './reactive-layout-D9zqqaqK.cjs';
 
 /**
  * Three-pane demo shell (roadmap §7.2).

package/dist/index-Qq-G9B6g.d.cts

@@ -0,0 +1,171 @@
+import { a as Node } from './node-fSc-hCv8.cjs';
+import { R as ReactiveLogBundle } from './reactive-log-CgbNqksB.cjs';
+import { NodeInput } from './extra/sources.cjs';
+import { AppendLogStorageTier } from './extra/storage-tiers.cjs';
+import { G as Graph, a as GraphOptions } from './graph-kTltt95s.cjs';
+import { B as BaseAuditRecord } from './imperative-audit-ahAE65a9.cjs';
+
+/**
+ * Job queue patterns (roadmap §4.2).
+ *
+ * Queue / flow primitives modeled as graph factories:
+ * - `jobQueue()` — claim/ack/nack workflow with reactive depth.
+ * - `jobFlow()` — multi-stage queue chain.
+ *
+ * Topic / subscription / hub primitives live in `patterns/messaging`.
+ */
+
+type JobState = "queued" | "inflight";
+type JobEnvelope<T> = {
+    id: string;
+    payload: T;
+    attempts: number;
+    metadata: Readonly<Record<string, unknown>>;
+    state: JobState;
+};
+/** Audit record for a job-queue mutation (Audit 2 cross-cutting). */
+type JobEventAction = "enqueue" | "claim" | "ack" | "nack" | "remove";
+interface JobEvent<T = unknown> extends BaseAuditRecord {
+    readonly action: JobEventAction;
+    readonly id: string;
+    readonly attempts?: number;
+    readonly payload?: T;
+}
+/** Recommended `keyOf` for keyed-storage adapters (Audit 2 #7). */
+declare const jobEventKeyOf: <T>(e: JobEvent<T>) => string;
+type JobQueueOptions = {
+    graph?: GraphOptions;
+};
+declare class JobQueueGraph<T> extends Graph {
+    private readonly _pending;
+    private readonly _jobs;
+    private readonly _seqCursor;
+    readonly pending: Node<readonly string[]>;
+    readonly jobs: Node<ReadonlyMap<string, JobEnvelope<T>>>;
+    readonly depth: Node<number>;
+    /** Audit log of every queue mutation (Audit 2). */
+    readonly events: ReactiveLogBundle<JobEvent<T>>;
+    /** Alias for {@link JobQueueGraph.events} — Audit 2 `.audit` duplication. */
+    readonly audit: ReactiveLogBundle<JobEvent<T>>;
+    constructor(name: string, opts?: JobQueueOptions);
+    private _bumpSeq;
+    /**
+     * Wire append-log storage tiers (Audit 4). Returns a disposer.
+     *
+     * Named `attachEventStorage` to avoid colliding with {@link Graph.attachSnapshotStorage}.
+     */
+    attachEventStorage(tiers: readonly AppendLogStorageTier<JobEvent<T>>[]): () => void;
+    enqueue(payload: T, opts?: {
+        id?: string;
+        metadata?: Record<string, unknown>;
+    }): string;
+    claim(limit?: number): readonly JobEnvelope<T>[];
+    ack(id: string): boolean;
+    nack(id: string, opts?: {
+        requeue?: boolean;
+    }): boolean;
+    /**
+     * Remove a job by id regardless of its current state. Returns `true` if
+     * the job existed and was removed, `false` if no job has this id.
+     *
+     * `ack` only works on inflight; `nack` only works on inflight.
+     * `removeById` is the state-agnostic escape hatch — useful for
+     * audit/observability layers that enqueue but never claim, and need to
+     * finalize a job when an external decision (e.g. harness verify
+     * outcome) resolves it. Distinct name from the inherited
+     * {@link Graph.remove}, which removes a mounted child subgraph by path.
+     *
+     * When the job is in `queued` state, its id is also pulled from the
+     * `pending` list — depth + pending snapshot stay consistent.
+     */
+    removeById(id: string): boolean;
+    /**
+     * Subscribe to a Node and enqueue each DATA payload into this queue.
+     * Returns a disposer that stops consuming when called.
+     *
+     * Used internally by {@link JobFlowGraph} for stage-to-stage wiring but
+     * also useful for users wiring an external source into a job queue.
+     *
+     * @param source - Node whose DATA values are enqueued.
+     * @param opts - Optional enqueue options (id generator, metadata prefix).
+     */
+    consumeFrom(source: Node<T>, opts?: {
+        metadata?: Record<string, unknown>;
+    }): () => void;
+}
+/**
+ * Work function for a job flow stage. Receives the full job envelope,
+ * returns a `NodeInput<T>` — raw value (sync), Promise (async), or Node
+ * (composed pipeline). `fromAny` coerces any of these shapes.
+ *
+ * On error / rejection: the stage nacks the job (no requeue by default).
+ */
+type WorkFn<T> = (job: JobEnvelope<T>) => NodeInput<T>;
+/**
+ * Stage definition for {@link JobFlowGraph}. Either a bare name string
+ * (no work hook, pure pass-through) or a full definition object.
+ */
+type StageDef<T> = string | {
+    name: string;
+    work?: WorkFn<T>;
+    handlerVersion?: {
+        id: string;
+        version: string | number;
+    };
+};
+type JobFlowOptions<T = unknown> = {
+    graph?: GraphOptions;
+    /**
+     * Stage definitions. Each stage is either a bare name string (pure
+     * pass-through) or a `{ name, work?, handlerVersion? }` object.
+     *
+     * For back-compat, `string[]` values behave as stages with no work hook.
+     */
+    stages?: readonly StageDef<T>[];
+    maxPerPump?: number;
+};
+declare class JobFlowGraph<T> extends Graph {
+    private readonly _stageNames;
+    private readonly _stageWorkFns;
+    private readonly _queues;
+    private readonly _completed;
+    readonly completed: Node<readonly JobEnvelope<T>[]>;
+    readonly completedCount: Node<number>;
+    constructor(name: string, opts?: JobFlowOptions<T>);
+    stages(): readonly string[];
+    queue(stage: string): JobQueueGraph<T>;
+    enqueue(payload: T, opts?: {
+        id?: string;
+        metadata?: Record<string, unknown>;
+    }): string;
+    retainedCompleted(): readonly JobEnvelope<T>[];
+}
+/**
+ * Creates a Pulsar-inspired job queue graph with claim/ack/nack workflow.
+ */
+declare function jobQueue<T>(name: string, opts?: JobQueueOptions): JobQueueGraph<T>;
+/**
+ * Creates an autonomous multi-stage queue chain graph.
+ */
+declare function jobFlow<T>(name: string, opts?: JobFlowOptions<T>): JobFlowGraph<T>;
+
+type index_JobEnvelope<T> = JobEnvelope<T>;
+type index_JobEvent<T = unknown> = JobEvent<T>;
+type index_JobEventAction = JobEventAction;
+type index_JobFlowGraph<T> = JobFlowGraph<T>;
+declare const index_JobFlowGraph: typeof JobFlowGraph;
+type index_JobFlowOptions<T = unknown> = JobFlowOptions<T>;
+type index_JobQueueGraph<T> = JobQueueGraph<T>;
+declare const index_JobQueueGraph: typeof JobQueueGraph;
+type index_JobQueueOptions = JobQueueOptions;
+type index_JobState = JobState;
+type index_StageDef<T> = StageDef<T>;
+type index_WorkFn<T> = WorkFn<T>;
+declare const index_jobEventKeyOf: typeof jobEventKeyOf;
+declare const index_jobFlow: typeof jobFlow;
+declare const index_jobQueue: typeof jobQueue;
+declare namespace index {
+  export { type index_JobEnvelope as JobEnvelope, type index_JobEvent as JobEvent, type index_JobEventAction as JobEventAction, index_JobFlowGraph as JobFlowGraph, type index_JobFlowOptions as JobFlowOptions, index_JobQueueGraph as JobQueueGraph, type index_JobQueueOptions as JobQueueOptions, type index_JobState as JobState, type index_StageDef as StageDef, type index_WorkFn as WorkFn, index_jobEventKeyOf as jobEventKeyOf, index_jobFlow as jobFlow, index_jobQueue as jobQueue };
+}
+
+export { JobQueueGraph as J, type StageDef as S, type WorkFn as W, type JobEnvelope as a, type JobEvent as b, type JobEventAction as c, JobFlowGraph as d, type JobFlowOptions as e, type JobQueueOptions as f, type JobState as g, jobFlow as h, index as i, jobEventKeyOf as j, jobQueue as k };

package/dist/{index-yJY9thRY.d.cts → index-XxSeddWP.d.cts}

@@ -1,5 +1,5 @@
-import { a as Node, N as NodeOptions } from './node-8qx0kgYt.cjs';
-import { a as GraphOptions, G as Graph } from './graph-DaoydJ_u.cjs';
+import { a as Node, N as NodeOptions } from './node-fSc-hCv8.cjs';
+import { a as GraphOptions, G as Graph } from './graph-kTltt95s.cjs';
 
 /**
  * Reduction primitives (roadmap §8.1).

package/dist/{index-C8_bnDBZ.d.cts → index-ZhKyR8co.d.cts}

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