@graphrefly/graphrefly 0.10.0 → 0.12.0

package/dist/index.d.ts

@@ -1,16 +1,16 @@
-import { N as Node, A as Actor, a as NodeOptions, b as NodeActions, c as NodeFn } from './meta-BJEU8fYz.js';
-export { C as COMPLETE, D as DATA, d as DEFAULT_ACTOR, e as DIRTY, f as DescribeDetail, g as DescribeField, h as DescribeNodeOutput, E as ERROR, G as GuardAction, i as GuardDenied, j as GuardDeniedDetails, H as HashFn, I as INVALIDATE, M as Message, k as Messages, l as NodeDescribeKind, m as NodeGuard, n as NodeSink, o as NodeStatus, p as NodeTransportOptions, q as NodeVersionInfo, O as OnMessageHandler, P as PAUSE, r as PolicyAllow, s as PolicyDeny, t as PolicyRuleData, R as RESOLVED, u as RESUME, S as SubscribeHints, T as TEARDOWN, V as V0, v as V1, w as VersioningLevel, x as VersioningOptions, y as accessHintForGuard, z as advanceVersion, B as createVersioning, F as defaultHash, J as describeNode, K as isKnownMessageType, L as isPhase2Message, Q as isTerminalMessage, U as isV1, W as knownMessageTypes, X as messageTier, Y as metaSnapshot, Z as node, _ as normalizeActor, $ as policy, a0 as policyFromRules, a1 as propagatesToMeta, a2 as resolveDescribeFields } from './meta-BJEU8fYz.js';
-import { i as index$a, c as cqrs } from './index-DLO8wnYU.js';
+import { N as Node, A as Actor, a as NodeOptions, b as NodeActions, c as NodeFn } from './meta-BcuDhtwu.js';
+export { C as CLEANUP_RESULT, d as COMPLETE, e as CleanupResult, D as DATA, f as DEFAULT_ACTOR, g as DIRTY, h as DescribeDetail, i as DescribeField, j as DescribeNodeOutput, E as ERROR, G as GuardAction, k as GuardDenied, l as GuardDeniedDetails, H as HashFn, I as INVALIDATE, M as Message, m as Messages, n as NodeDescribeKind, o as NodeGuard, p as NodeSink, q as NodeStatus, r as NodeTransportOptions, s as NodeVersionInfo, O as OnMessageHandler, P as PAUSE, t as PolicyAllow, u as PolicyDeny, v as PolicyRuleData, R as RESOLVED, w as RESUME, S as SubscribeHints, T as TEARDOWN, V as V0, x as V1, y as VersioningLevel, z as VersioningOptions, B as accessHintForGuard, F as advanceVersion, J as cleanupResult, K as createVersioning, L as defaultHash, Q as describeNode, U as isKnownMessageType, W as isPhase2Message, X as isTerminalMessage, Y as isV1, Z as knownMessageTypes, _ as messageTier, $ as metaSnapshot, a0 as node, a1 as normalizeActor, a2 as policy, a3 as policyFromRules, a4 as propagatesToMeta, a5 as resolveDescribeFields } from './meta-BcuDhtwu.js';
+import { i as index$a, c as cqrs } from './index-53cDGX7F.js';
 import { Ref, WatchSource } from 'vue';
-import { G as Graph, a as GraphOptions, b as GraphAutoCheckpointHandle, A as AutoCheckpointAdapter, c as GraphAutoCheckpointOptions } from './graph-X9uwnD_z.js';
-export { D as DescribeFilter, d as GRAPH_META_SEGMENT, e as GraphActorOptions, f as GraphCheckpointRecord, g as GraphDescribeOptions, h as GraphDescribeOutput, i as GraphDiagramDirection, j as GraphDiagramOptions, k as GraphDiffChange, l as GraphDiffResult, m as GraphDumpOptions, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, r as GraphPersistSnapshot, s as GraphSpyHandle, t as GraphSpyOptions, u as GraphSpyTheme, v as GraphSpyThemeName, O as ObserveDetail, w as ObserveEvent, x as ObserveOptions, y as ObserveResult, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, B as reachable } from './graph-X9uwnD_z.js';
-export { D as DynGet, a as DynamicNodeFn, b as DynamicNodeImpl, c as DynamicNodeOptions, P as PipeOperator, R as ResettableTimer, d as batch, i as core, e as derived, f as dynamicNode, g as effect, h as emitWithBatch, j as isBatching, m as monotonicNs, p as partitionForBatch, k as pipe, l as producer, s as state, w as wallClockNs } from './index-BVG5pjin.js';
-import { N as NodeInput, D as DistillBundle, E as Extraction, R as ReactiveListSnapshot, a as ReactiveMapSnapshot } from './index-a5gHmH5b.js';
-export { A as AdapterHandlers, b as AsyncSourceOpts, B as BackoffPreset, c as BackoffStrategy, d as BatchMessage, e as BridgeMessage, f as BufferedSinkHandle, C as CSVRow, g as CacheEvictionPolicy, h as CacheTier, i as CascadingCache, j as CascadingCacheOptions, k as CheckpointAdapter, l as CheckpointToRedisOptions, m as CheckpointToS3Options, n as CircuitBreaker, o as CircuitBreakerOptions, p as CircuitOpenError, q as CircuitState, r as ClickHouseClientLike, s as ClickHouseInsertClientLike, t as ClickHouseRow, u as CronSchedule, v as DictCheckpointAdapter, w as DistillOptions, x as DrizzleQueryLike, y as ErrorMessage, z as EventTargetLike, F as ExponentialBackoffOptions, G as FSEvent, H as FSEventType, I as FileCheckpointAdapter, J as FileWriterLike, K as FromCSVOptions, L as FromClickHouseWatchOptions, M as FromCronOptions, O as FromDrizzleOptions, P as FromFSWatchOptions, Q as FromGitHookOptions, S as FromHTTPOptions, T as FromKafkaOptions, U as FromKyselyOptions, V as FromMCPOptions, W as FromNATSOptions, X as FromNDJSONOptions, Y as FromOTelOptions, Z as FromPrismaOptions, _ as FromPrometheusOptions, $ as FromPulsarOptions, a0 as FromRabbitMQOptions, a1 as FromRedisStreamOptions, a2 as FromSqliteOptions, a3 as FromStatsDOptions, a4 as FromSyslogOptions, a5 as GitEvent, a6 as GitHookType, a7 as HTTPBundle, a8 as IndexRow, a9 as IndexedDbCheckpointSpec, aa as InitMessage, ab as JitterMode, ac as KafkaConsumerLike, ad as KafkaMessage, ae as KafkaProducerLike, af as KyselyQueryLike, ag as LokiClientLike, ah as LokiStream, ai as MCPClientLike, aj as MemoryCheckpointAdapter, ak as MergeMapOptions, al as MongoCollectionLike, am as NATSClientLike, an as NATSMessage, ao as NATSSubscriptionLike, ap as NS_PER_MS, aq as NS_PER_SEC, ar as OTelBundle, as as OTelLog, at as OTelMetric, au as OTelRegister, av as OTelSpan, aw as PostgresClientLike, ax as PrismaModelLike, ay as PrometheusMetric, az as PubSubHub, aA as PulsarConsumerLike, aB as PulsarMessage, aC as PulsarProducerLike, aD as RabbitMQChannelLike, aE as RabbitMQMessage, aF as ReactiveIndexBundle, aG as ReactiveIndexOptions, aH as ReactiveIndexSnapshot, aI as ReactiveListBundle, aJ as ReactiveListOptions, aK as ReactiveMapBundle, aL as ReactiveMapOptions, aM as ReadyMessage, aN as RedisCheckpointClientLike, aO as RedisClientLike, aP as RedisStreamEntry, aQ as RetryOptions, aR as S3ClientLike, aS as SignalMessage, aT as SinkHandle, aU as SinkTransportError, aV as SqliteCheckpointAdapter, aW as SqliteDbLike, aX as StatsDMetric, aY as StatsDRegister, aZ as StatusValue, a_ as SyslogMessage, a$ as SyslogRegister, b0 as TapObserver, b1 as TempoClientLike, b2 as ThrottleOptions, b3 as TieredStorage, b4 as TieredStorageOptions, b5 as TimeoutError, b6 as ToCSVOptions, b7 as ToClickHouseOptions, b8 as ToFileOptions, b9 as ToKafkaOptions, ba as ToLokiOptions, bb as ToMongoOptions, bc as ToNATSOptions, bd as ToPostgresOptions, be as ToPulsarOptions, bf as ToRabbitMQOptions, bg as ToRedisStreamOptions, bh as ToS3Options, bi as ToSSEOptions, bj as ToSqliteOptions, bk as ToTempoOptions, bl as ToWebSocketOptions, bm as ToWebSocketTransportError, bn as TokenBucket, bo as ValueMessage, bp as VerifiableBundle, bq as VerifiableOptions, br as VerifyValue, bs as WatermarkController, bt as WatermarkOptions, bu as WebSocketLike, bv as WebSocketMessageEventLike, bw as WebSocketRegister, bx as WebhookRegister, by as WithBreakerBundle, bz as WithStatusBundle, bA as WorkerBridge, bB as WorkerBridgeOptions, bC as WorkerSelfHandle, bD as WorkerSelfOptions, bE as WorkerTransport, bF as audit, bG as buffer, bH as bufferCount, bI as bufferTime, bJ as cache, bK as cached, bL as cascadingCache, bM as catchError, bN as checkpointNodeValue, bO as checkpointToRedis, bP as checkpointToS3, bQ as circuitBreaker, bR as combine, bS as combineLatest, bT as concat, bU as concatMap, bV as constant, bW as createTransport, bX as createWatermarkController, bY as debounce, bZ as debounceTime, b_ as decorrelatedJitter, b$ as delay, c0 as deserializeError, c1 as distill, c2 as distinctUntilChanged, c3 as elementAt, c4 as empty, c5 as escapeRegexChar, c6 as exhaustMap, c7 as exponential, c8 as extra, c9 as fallback, ca as fibonacci, cb as filter, cc as find, cd as first, ce as firstValueFrom, cf as flatMap, cg as forEach, ch as fromAny, ci as fromAsyncIter, cj as fromCSV, ck as fromClickHouseWatch, cl as fromCron, cm as fromDrizzle, cn as fromEvent, co as fromFSWatch, cp as fromGitHook, cq as fromHTTP, cr as fromIDBRequest, cs as fromIDBTransaction, ct as fromIter, cu as fromKafka, cv as fromKysely, cw as fromMCP, cx as fromNATS, cy as fromNDJSON, cz as fromOTel, cA as fromPrisma, cB as fromPrometheus, cC as fromPromise, cD as fromPulsar, cE as fromRabbitMQ, cF as fromRedisStream, cG as fromSqlite, cH as fromStatsD, cI as fromSyslog, cJ as fromTimer, cK as fromWebSocket, cL as fromWebhook, cM as gate, cN as globToRegExp, cO as interval, cP as last, cQ as linear, cR as lru, cS as map, cT as matchesAnyPattern, cU as matchesCron, cV as merge, cW as mergeMap, cX as nameToSignal, cY as never, cZ as of, c_ as pairwise, c$ as parseCron, d0 as parsePrometheusText, d1 as parseStatsD, d2 as parseSyslog, d3 as pausable, d4 as pubsub, d5 as race, d6 as rateLimiter, d7 as reactiveIndex, d8 as reactiveList, d9 as reactiveMap, da as reduce, db as repeat, dc as replay, dd as rescue, de as resolveBackoffPreset, df as restoreGraphCheckpoint, dg as restoreGraphCheckpointIndexedDb, dh as retry, di as sample, dj as saveGraphCheckpoint, dk as saveGraphCheckpointIndexedDb, dl as scan, dm as serializeError, dn as share, dp as shareReplay, dq as signalToName, dr as skip, ds as startWith, dt as switchMap, du as take, dv as takeUntil, dw as takeWhile, dx as tap, dy as throttle, dz as throttleTime, dA as throwError, dB as tieredStorage, dC as timeout, dD as toArray, dE as toCSV, dF as toClickHouse, dG as toFile, dH as toKafka, dI as toLoki, dJ as toMongo, dK as toNATS, dL as toPostgres, dM as toPulsar, dN as toRabbitMQ, dO as toRedisStream, dP as toS3, dQ as toSSE, dR as toSqlite, dS as toTempo, dT as toWebSocket, dU as tokenBucket, dV as tokenTracker, dW as verifiable, dX as window, dY as windowCount, dZ as windowTime, d_ as withBreaker, d$ as withLatestFrom, e0 as withMaxAttempts, e1 as withStatus, e2 as workerBridge, e3 as workerSelf, e4 as zip } from './index-a5gHmH5b.js';
-export { D as DeltaCheckpoint, E as EvictedSubgraphInfo, a as EvictionPolicy, G as GraphCodec, J as JsonCodec, L as LazyGraphCodec, W as WALEntry, c as createDagCborCodec, b as createDagCborZstdCodec, i as graph, n as negotiateCodec, r as replayWAL } from './index-BPCeYDS4.js';
-import { R as ReactiveLogSnapshot } from './reactive-log-RhgIog2Z.js';
-export { a as ReactiveLogBundle, b as ReactiveLogOptions, l as logSlice, o as observeGraph$, c as observeNode$, r as reactiveLog, t as toMessages$, d as toObservable } from './reactive-log-RhgIog2Z.js';
-import { M as MeasurementAdapter, i as index$b } from './index-DMv1Etbi.js';
+import { G as Graph, a as GraphOptions, b as GraphAutoCheckpointHandle, A as AutoCheckpointAdapter, c as GraphAutoCheckpointOptions } from './graph-DXT95WZ3.js';
+export { D as DescribeFilter, d as GRAPH_META_SEGMENT, e as GraphActorOptions, f as GraphCheckpointRecord, g as GraphDescribeOptions, h as GraphDescribeOutput, i as GraphDiagramDirection, j as GraphDiagramOptions, k as GraphDiffChange, l as GraphDiffResult, m as GraphDumpOptions, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, r as GraphPersistSnapshot, s as GraphSpyHandle, t as GraphSpyOptions, u as GraphSpyTheme, v as GraphSpyThemeName, O as ObserveDetail, w as ObserveEvent, x as ObserveOptions, y as ObserveResult, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, B as reachable } from './graph-DXT95WZ3.js';
+export { B as BridgeOptions, D as DEFAULT_DOWN, a as DynGet, b as DynamicNodeFn, c as DynamicNodeImpl, d as DynamicNodeOptions, P as PipeOperator, R as ResettableTimer, e as batch, f as bridge, i as core, g as derived, h as dynamicNode, j as effect, k as emitWithBatch, l as isBatching, m as monotonicNs, p as partitionForBatch, n as pipe, o as producer, s as state, w as wallClockNs } from './index-Dzdm20sx.js';
+import { N as NodeInput, D as DistillBundle, E as Extraction, R as ReactiveListSnapshot, a as ReactiveMapSnapshot } from './index-CiAqgfFg.js';
+export { A as AdapterHandlers, b as AsyncSourceOpts, B as BackoffPreset, c as BackoffStrategy, d as BatchMessage, e as BridgeMessage, f as BufferedSinkHandle, C as CSVRow, g as CacheEvictionPolicy, h as CacheTier, i as CascadingCache, j as CascadingCacheOptions, k as CheckpointAdapter, l as CheckpointToRedisOptions, m as CheckpointToS3Options, n as CircuitBreaker, o as CircuitBreakerOptions, p as CircuitOpenError, q as CircuitState, r as ClickHouseClientLike, s as ClickHouseInsertClientLike, t as ClickHouseRow, u as CronSchedule, v as DictCheckpointAdapter, w as DistillOptions, x as DrizzleQueryLike, y as ErrorMessage, z as EventTargetLike, F as ExponentialBackoffOptions, G as FSEvent, H as FSEventType, I as FileCheckpointAdapter, J as FileWriterLike, K as FromCSVOptions, L as FromClickHouseWatchOptions, M as FromCronOptions, O as FromDrizzleOptions, P as FromFSWatchOptions, Q as FromGitHookOptions, S as FromHTTPOptions, T as FromKafkaOptions, U as FromKyselyOptions, V as FromMCPOptions, W as FromNATSOptions, X as FromNDJSONOptions, Y as FromOTelOptions, Z as FromPrismaOptions, _ as FromPrometheusOptions, $ as FromPulsarOptions, a0 as FromRabbitMQOptions, a1 as FromRedisStreamOptions, a2 as FromSqliteOptions, a3 as FromStatsDOptions, a4 as FromSyslogOptions, a5 as GitEvent, a6 as GitHookType, a7 as HTTPBundle, a8 as IndexRow, a9 as IndexedDbCheckpointSpec, aa as InitMessage, ab as JitterMode, ac as KafkaConsumerLike, ad as KafkaMessage, ae as KafkaProducerLike, af as KyselyQueryLike, ag as LokiClientLike, ah as LokiStream, ai as MCPClientLike, aj as MemoryCheckpointAdapter, ak as MergeMapOptions, al as MongoCollectionLike, am as NATSClientLike, an as NATSMessage, ao as NATSSubscriptionLike, ap as NS_PER_MS, aq as NS_PER_SEC, ar as OTelBundle, as as OTelLog, at as OTelMetric, au as OTelRegister, av as OTelSpan, aw as PostgresClientLike, ax as PrismaModelLike, ay as PrometheusMetric, az as PubSubHub, aA as PulsarConsumerLike, aB as PulsarMessage, aC as PulsarProducerLike, aD as RabbitMQChannelLike, aE as RabbitMQMessage, aF as ReactiveIndexBundle, aG as ReactiveIndexOptions, aH as ReactiveIndexSnapshot, aI as ReactiveListBundle, aJ as ReactiveListOptions, aK as ReactiveMapBundle, aL as ReactiveMapOptions, aM as ReadyMessage, aN as RedisCheckpointClientLike, aO as RedisClientLike, aP as RedisStreamEntry, aQ as RetryOptions, aR as S3ClientLike, aS as SignalMessage, aT as SinkHandle, aU as SinkTransportError, aV as SqliteCheckpointAdapter, aW as SqliteDbLike, aX as StatsDMetric, aY as StatsDRegister, aZ as StatusValue, a_ as SyslogMessage, a$ as SyslogRegister, b0 as TapObserver, b1 as TempoClientLike, b2 as ThrottleOptions, b3 as TieredStorage, b4 as TieredStorageOptions, b5 as TimeoutError, b6 as ToCSVOptions, b7 as ToClickHouseOptions, b8 as ToFileOptions, b9 as ToKafkaOptions, ba as ToLokiOptions, bb as ToMongoOptions, bc as ToNATSOptions, bd as ToPostgresOptions, be as ToPulsarOptions, bf as ToRabbitMQOptions, bg as ToRedisStreamOptions, bh as ToS3Options, bi as ToSSEOptions, bj as ToSqliteOptions, bk as ToTempoOptions, bl as ToWebSocketOptions, bm as ToWebSocketTransportError, bn as TokenBucket, bo as ValueMessage, bp as VerifiableBundle, bq as VerifiableOptions, br as VerifyValue, bs as WatermarkController, bt as WatermarkOptions, bu as WebSocketLike, bv as WebSocketMessageEventLike, bw as WebSocketRegister, bx as WebhookRegister, by as WithBreakerBundle, bz as WithStatusBundle, bA as WorkerBridge, bB as WorkerBridgeOptions, bC as WorkerSelfHandle, bD as WorkerSelfOptions, bE as WorkerTransport, bF as audit, bG as buffer, bH as bufferCount, bI as bufferTime, bJ as cache, bK as cached, bL as cascadingCache, bM as catchError, bN as checkpointNodeValue, bO as checkpointToRedis, bP as checkpointToS3, bQ as circuitBreaker, bR as combine, bS as combineLatest, bT as concat, bU as concatMap, bV as constant, bW as createTransport, bX as createWatermarkController, bY as debounce, bZ as debounceTime, b_ as decorrelatedJitter, b$ as delay, c0 as deserializeError, c1 as distill, c2 as distinctUntilChanged, c3 as elementAt, c4 as empty, c5 as escapeRegexChar, c6 as exhaustMap, c7 as exponential, c8 as extra, c9 as fallback, ca as fibonacci, cb as filter, cc as find, cd as first, ce as firstValueFrom, cf as flatMap, cg as forEach, ch as fromAny, ci as fromAsyncIter, cj as fromCSV, ck as fromClickHouseWatch, cl as fromCron, cm as fromDrizzle, cn as fromEvent, co as fromFSWatch, cp as fromGitHook, cq as fromHTTP, cr as fromIDBRequest, cs as fromIDBTransaction, ct as fromIter, cu as fromKafka, cv as fromKysely, cw as fromMCP, cx as fromNATS, cy as fromNDJSON, cz as fromOTel, cA as fromPrisma, cB as fromPrometheus, cC as fromPromise, cD as fromPulsar, cE as fromRabbitMQ, cF as fromRedisStream, cG as fromSqlite, cH as fromStatsD, cI as fromSyslog, cJ as fromTimer, cK as fromWebSocket, cL as fromWebhook, cM as globToRegExp, cN as interval, cO as last, cP as linear, cQ as lru, cR as map, cS as matchesAnyPattern, cT as matchesCron, cU as merge, cV as mergeMap, cW as nameToSignal, cX as never, cY as of, cZ as pairwise, c_ as parseCron, c$ as parsePrometheusText, d0 as parseStatsD, d1 as parseSyslog, d2 as pausable, d3 as pubsub, d4 as race, d5 as rateLimiter, d6 as reactiveIndex, d7 as reactiveList, d8 as reactiveMap, d9 as reduce, da as repeat, db as replay, dc as rescue, dd as resolveBackoffPreset, de as restoreGraphCheckpoint, df as restoreGraphCheckpointIndexedDb, dg as retry, dh as sample, di as saveGraphCheckpoint, dj as saveGraphCheckpointIndexedDb, dk as scan, dl as serializeError, dm as share, dn as shareReplay, dp as signalToName, dq as skip, dr as startWith, ds as switchMap, dt as take, du as takeUntil, dv as takeWhile, dw as tap, dx as throttle, dy as throttleTime, dz as throwError, dA as tieredStorage, dB as timeout, dC as toArray, dD as toCSV, dE as toClickHouse, dF as toFile, dG as toKafka, dH as toLoki, dI as toMongo, dJ as toNATS, dK as toPostgres, dL as toPulsar, dM as toRabbitMQ, dN as toRedisStream, dO as toS3, dP as toSSE, dQ as toSqlite, dR as toTempo, dS as toWebSocket, dT as tokenBucket, dU as tokenTracker, dV as valve, dW as verifiable, dX as window, dY as windowCount, dZ as windowTime, d_ as withBreaker, d$ as withLatestFrom, e0 as withMaxAttempts, e1 as withStatus, e2 as workerBridge, e3 as workerSelf, e4 as zip } from './index-CiAqgfFg.js';
+export { D as DeltaCheckpoint, E as EvictedSubgraphInfo, a as EvictionPolicy, G as GraphCodec, J as JsonCodec, L as LazyGraphCodec, W as WALEntry, c as createDagCborCodec, b as createDagCborZstdCodec, i as graph, n as negotiateCodec, r as replayWAL } from './index-C0_7g9sj.js';
+import { R as ReactiveLogSnapshot } from './reactive-log-Cu0VdqkT.js';
+export { a as ReactiveLogBundle, b as ReactiveLogOptions, l as logSlice, o as observeGraph$, c as observeNode$, r as reactiveLog, t as toMessages$, d as toObservable } from './reactive-log-Cu0VdqkT.js';
+import { M as MeasurementAdapter, i as index$b } from './index-B10Q0sQB.js';
 import '@nestjs/common';
 import '@nestjs/core';
 import 'rxjs';
@@ -732,6 +732,31 @@ type LLMStreamHandle = {
  * tear down the effect and release resources.
  */
 declare function fromLLMStream(adapter: LLMAdapter, messages: NodeInput<readonly ChatMessage[]>, opts?: FromLLMStreamOptions): LLMStreamHandle;
+type PromptNodeOptions = {
+    name?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    /** Output format — `"json"` attempts JSON.parse on the response. Default: `"text"`. */
+    format?: "text" | "json";
+    /** Number of retries on transient errors. Default: 0. */
+    retries?: number;
+    /** Cache LLM responses for identical inputs. Default: false. */
+    cache?: boolean;
+    systemPrompt?: string;
+    meta?: Record<string, unknown>;
+};
+/**
+ * Universal LLM transform: wraps a prompt template + model adapter into a reactive derived node.
+ * Re-invokes the LLM whenever any dep changes. Suitable for triage, QA, hypothesis, parity, etc.
+ *
+ * @param adapter - LLM adapter (provider-agnostic).
+ * @param deps - Input nodes whose values feed the prompt.
+ * @param prompt - Static string or template function receiving dep values.
+ * @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>;
 type ChatStreamOptions = {
     graph?: GraphOptions;
     maxMessages?: number;
@@ -1199,6 +1224,7 @@ type ai_MemoryTier = MemoryTier;
 type ai_MemoryTiersBundle<TMem> = MemoryTiersBundle<TMem>;
 type ai_MemoryTiersOptions<TMem> = MemoryTiersOptions<TMem>;
 type ai_OpenAIToolSchema = OpenAIToolSchema;
+type ai_PromptNodeOptions = PromptNodeOptions;
 type ai_RetrievalEntry<TMem> = RetrievalEntry<TMem>;
 type ai_RetrievalPipelineOptions<TMem> = RetrievalPipelineOptions<TMem>;
 type ai_RetrievalQuery = RetrievalQuery;
@@ -1223,12 +1249,13 @@ declare const ai_graphFromSpec: typeof graphFromSpec;
 declare const ai_knobsAsTools: typeof knobsAsTools;
 declare const ai_llmConsolidator: typeof llmConsolidator;
 declare const ai_llmExtractor: typeof llmExtractor;
+declare const ai_promptNode: typeof promptNode;
 declare const ai_suggestStrategy: typeof suggestStrategy;
 declare const ai_systemPromptBuilder: typeof systemPromptBuilder;
 declare const ai_toolRegistry: typeof toolRegistry;
 declare const ai_validateGraphDef: typeof validateGraphDef;
 declare namespace ai {
-  export { type ai_AdmissionScore3DOptions as AdmissionScore3DOptions, type ai_AdmissionScores as AdmissionScores, ai_AgentLoopGraph as AgentLoopGraph, type ai_AgentLoopOptions as AgentLoopOptions, type ai_AgentLoopStatus as AgentLoopStatus, type ai_AgentMemoryGraph as AgentMemoryGraph, type ai_AgentMemoryOptions as AgentMemoryOptions, type ai_ChatMessage as ChatMessage, ai_ChatStreamGraph as ChatStreamGraph, type ai_ChatStreamOptions as ChatStreamOptions, type ai_FromLLMOptions as FromLLMOptions, type ai_FromLLMStreamOptions as FromLLMStreamOptions, type ai_GaugesAsContextOptions as GaugesAsContextOptions, type ai_GraphDefValidation as GraphDefValidation, type ai_GraphFromSpecOptions as GraphFromSpecOptions, type ai_KnobsAsToolsResult as KnobsAsToolsResult, type ai_LLMAdapter as LLMAdapter, type ai_LLMConsolidatorOptions as LLMConsolidatorOptions, type ai_LLMExtractorOptions as LLMExtractorOptions, type ai_LLMInvokeOptions as LLMInvokeOptions, type ai_LLMResponse as LLMResponse, type ai_LLMStreamHandle as LLMStreamHandle, type ai_McpToolSchema as McpToolSchema, type ai_MemoryTier as MemoryTier, type ai_MemoryTiersBundle as MemoryTiersBundle, type ai_MemoryTiersOptions as MemoryTiersOptions, type ai_OpenAIToolSchema as OpenAIToolSchema, type ai_RetrievalEntry as RetrievalEntry, type ai_RetrievalPipelineOptions as RetrievalPipelineOptions, type ai_RetrievalQuery as RetrievalQuery, type ai_RetrievalTrace as RetrievalTrace, type ai_StrategyOperation as StrategyOperation, type ai_StrategyPlan as StrategyPlan, type ai_SuggestStrategyOptions as SuggestStrategyOptions, type ai_SystemPromptHandle as SystemPromptHandle, type ai_ToolCall as ToolCall, type ai_ToolDefinition as ToolDefinition, ai_ToolRegistryGraph as ToolRegistryGraph, type ai_ToolRegistryOptions as ToolRegistryOptions, ai_admissionFilter3D as admissionFilter3D, ai_agentLoop as agentLoop, ai_agentMemory as agentMemory, ai_chatStream as chatStream, ai_fromLLM as fromLLM, ai_fromLLMStream as fromLLMStream, ai_gaugesAsContext as gaugesAsContext, ai_graphFromSpec as graphFromSpec, ai_knobsAsTools as knobsAsTools, ai_llmConsolidator as llmConsolidator, ai_llmExtractor as llmExtractor, ai_suggestStrategy as suggestStrategy, ai_systemPromptBuilder as systemPromptBuilder, ai_toolRegistry as toolRegistry, ai_validateGraphDef as validateGraphDef };
+  export { type ai_AdmissionScore3DOptions as AdmissionScore3DOptions, type ai_AdmissionScores as AdmissionScores, ai_AgentLoopGraph as AgentLoopGraph, type ai_AgentLoopOptions as AgentLoopOptions, type ai_AgentLoopStatus as AgentLoopStatus, type ai_AgentMemoryGraph as AgentMemoryGraph, type ai_AgentMemoryOptions as AgentMemoryOptions, type ai_ChatMessage as ChatMessage, ai_ChatStreamGraph as ChatStreamGraph, type ai_ChatStreamOptions as ChatStreamOptions, type ai_FromLLMOptions as FromLLMOptions, type ai_FromLLMStreamOptions as FromLLMStreamOptions, type ai_GaugesAsContextOptions as GaugesAsContextOptions, type ai_GraphDefValidation as GraphDefValidation, type ai_GraphFromSpecOptions as GraphFromSpecOptions, type ai_KnobsAsToolsResult as KnobsAsToolsResult, type ai_LLMAdapter as LLMAdapter, type ai_LLMConsolidatorOptions as LLMConsolidatorOptions, type ai_LLMExtractorOptions as LLMExtractorOptions, type ai_LLMInvokeOptions as LLMInvokeOptions, type ai_LLMResponse as LLMResponse, type ai_LLMStreamHandle as LLMStreamHandle, type ai_McpToolSchema as McpToolSchema, type ai_MemoryTier as MemoryTier, type ai_MemoryTiersBundle as MemoryTiersBundle, type ai_MemoryTiersOptions as MemoryTiersOptions, type ai_OpenAIToolSchema as OpenAIToolSchema, type ai_PromptNodeOptions as PromptNodeOptions, type ai_RetrievalEntry as RetrievalEntry, type ai_RetrievalPipelineOptions as RetrievalPipelineOptions, type ai_RetrievalQuery as RetrievalQuery, type ai_RetrievalTrace as RetrievalTrace, type ai_StrategyOperation as StrategyOperation, type ai_StrategyPlan as StrategyPlan, type ai_SuggestStrategyOptions as SuggestStrategyOptions, type ai_SystemPromptHandle as SystemPromptHandle, type ai_ToolCall as ToolCall, type ai_ToolDefinition as ToolDefinition, ai_ToolRegistryGraph as ToolRegistryGraph, type ai_ToolRegistryOptions as ToolRegistryOptions, ai_admissionFilter3D as admissionFilter3D, ai_agentLoop as agentLoop, ai_agentMemory as agentMemory, ai_chatStream as chatStream, ai_fromLLM as fromLLM, ai_fromLLMStream as fromLLMStream, ai_gaugesAsContext as gaugesAsContext, ai_graphFromSpec as graphFromSpec, ai_knobsAsTools as knobsAsTools, ai_llmConsolidator as llmConsolidator, ai_llmExtractor as llmExtractor, ai_promptNode as promptNode, ai_suggestStrategy as suggestStrategy, ai_systemPromptBuilder as systemPromptBuilder, ai_toolRegistry as toolRegistry, ai_validateGraphDef as validateGraphDef };
 }
 
 /**
@@ -1329,6 +1356,233 @@ declare namespace demoShell$1 {
   export { type demoShell$1_DemoShellHandle as DemoShellHandle, type demoShell$1_DemoShellOptions as DemoShellOptions, type demoShell$1_FullscreenPane as FullscreenPane, type demoShell$1_GraphLabelSize as GraphLabelSize, type demoShell$1_HighlightCallbacks as HighlightCallbacks, type demoShell$1_HoverPaneType as HoverPaneType, type demoShell$1_HoverTarget as HoverTarget, type demoShell$1_NodeRegistry as NodeRegistry, demoShell$1_demoShell as demoShell };
 }
 
+/**
+ * Domain templates (roadmap §8.2).
+ *
+ * Opinionated Graph factories for common "info → action" domains.
+ * Each template wires up §8.1 reduction primitives (stratify, funnel, feedback,
+ * budgetGate, scorer) with domain-specific stages. Users fork/extend by
+ * accessing named nodes and swapping stages.
+ *
+ * **Source injection (option B):** templates accept a `source` node, not a
+ * hardcoded adapter. Pass `fromOTel(...)`, `fromGitHook(...)`, or a test
+ * `state()` — the topology is the same.
+ *
+ * @module
+ */
+
+/** Stratification branch config for observability signals. */
+type ObservabilityBranch = {
+    name: string;
+    classify: (value: unknown) => boolean;
+};
+/** Options for {@link observabilityGraph}. */
+type ObservabilityGraphOptions = GraphOptions & {
+    /** Ingested signal source (e.g. fromOTel(...) or test state). */
+    source: Node<unknown>;
+    /**
+     * Classification rules for signal stratification.
+     * Default: errors / traces / metrics branches.
+     */
+    branches?: ObservabilityBranch[];
+    /**
+     * Correlation function: receives stratified branch values and produces
+     * correlated insights. Default: identity pass-through.
+     */
+    correlate?: (values: unknown[]) => unknown;
+    /**
+     * SLO verification function: returns a verification result for a
+     * correlated insight. Default: always passes.
+     */
+    sloCheck?: (value: unknown) => unknown;
+    /**
+     * Scorer weights for alert prioritization. One per branch.
+     * Default: equal weights [1, 1, 1].
+     */
+    weights?: number[];
+    /** Max feedback iterations for false-positive learning. Default: 5. */
+    maxFeedbackIterations?: number;
+};
+/**
+ * OTel ingest → stratified reduction → correlation → SLO verification →
+ * alert prioritization → output.
+ *
+ * Well-known node names:
+ * - `"source"` — injected signal source
+ * - `"stratify::branch/<name>"` — per-branch classification
+ * - `"correlate"` — cross-branch correlation
+ * - `"slo_value"`, `"slo_verified"` — SLO verification pair
+ * - `"alerts"` — scored, prioritized output
+ * - `"output"` — final output (alias for alerts)
+ *
+ * @category patterns
+ */
+declare function observabilityGraph(name: string, opts: ObservabilityGraphOptions): Graph;
+/** A structured issue extracted from raw findings. */
+type ExtractedIssue = {
+    id: string;
+    title: string;
+    severity: number;
+    source: string;
+    raw: unknown;
+};
+/** Options for {@link issueTrackerGraph}. */
+type IssueTrackerGraphOptions = GraphOptions & {
+    /** Findings source (e.g. fromGitHook(...), fromFSWatch(...)). */
+    source: Node<unknown>;
+    /**
+     * Extract structured issues from raw findings.
+     * Default: wraps raw value as a single issue.
+     */
+    extract?: (raw: unknown) => ExtractedIssue;
+    /**
+     * Verify an extracted issue (assertion check).
+     * Default: always valid.
+     */
+    verify?: (issue: ExtractedIssue) => unknown;
+    /**
+     * Detect regression by comparing against known patterns.
+     * Receives (current issue, known patterns).
+     * Default: no regression detected.
+     */
+    detectRegression?: (issue: ExtractedIssue, known: unknown) => unknown;
+    /** Max feedback iterations for re-scanning. Default: 3. */
+    maxFeedbackIterations?: number;
+};
+/**
+ * Findings ingest → extraction → verification → regression detection →
+ * distillation → prioritized queue.
+ *
+ * Well-known node names:
+ * - `"source"` — injected findings source
+ * - `"extract"` — structured issue extraction
+ * - `"verify"` — issue verification
+ * - `"known_patterns"` — accumulated known issue patterns (state)
+ * - `"regression"` — regression detection
+ * - `"priority"` — severity-based prioritization
+ * - `"output"` — final prioritized output
+ *
+ * @category patterns
+ */
+declare function issueTrackerGraph(name: string, opts: IssueTrackerGraphOptions): Graph;
+/** Classification result from LLM moderation. */
+type ModerationResult = {
+    label: "safe" | "review" | "block";
+    confidence: number;
+    reason?: string;
+    original: unknown;
+};
+/** Options for {@link contentModerationGraph}. */
+type ContentModerationGraphOptions = GraphOptions & {
+    /** Content source (text/multimedia ingest). */
+    source: Node<unknown>;
+    /**
+     * Classification function: returns a ModerationResult.
+     * Default: labels everything "review" with confidence 0.5.
+     */
+    classify?: (content: unknown) => ModerationResult;
+    /** System prompt for LLM classification. */
+    systemPrompt?: string;
+    /** Scorer weights: [safe, review, block]. Default: [0.1, 1, 2]. */
+    weights?: [number, number, number];
+    /** Max feedback iterations for policy refinement. Default: 5. */
+    maxFeedbackIterations?: number;
+    /** Max review queue size. When set, oldest entries are trimmed on overflow. */
+    maxQueueSize?: number;
+};
+/**
+ * Content ingest → LLM/rule classification → stratified routing (safe/review/block) →
+ * human review queue → scorer → feedback (false positives → policy refinement) → output.
+ *
+ * Well-known node names:
+ * - `"source"` — content ingest
+ * - `"classify"` — LLM or rule-based classification
+ * - `"stratify::branch/safe"`, `"stratify::branch/review"`, `"stratify::branch/block"` — routed branches
+ * - `"review_queue"` — state node for human review items
+ * - `"priority"` — scored priority output
+ * - `"policy"` — writable state for policy refinement
+ * - `"output"` — final moderation output
+ *
+ * @category patterns
+ */
+declare function contentModerationGraph(name: string, opts: ContentModerationGraphOptions): Graph;
+/** Schema validation result. */
+type ValidationResult = {
+    valid: boolean;
+    errors: string[];
+    record: unknown;
+};
+/** Anomaly detection result. */
+type AnomalyResult = {
+    anomaly: boolean;
+    score: number;
+    detail?: string;
+    record: unknown;
+};
+/** Options for {@link dataQualityGraph}. */
+type DataQualityGraphOptions = GraphOptions & {
+    /** Data source (e.g. fromPrisma(...), fromKysely(...)). */
+    source: Node<unknown>;
+    /**
+     * Schema validation function.
+     * Default: always valid.
+     */
+    validate?: (record: unknown) => ValidationResult;
+    /**
+     * Anomaly detection function.
+     * Default: no anomaly.
+     */
+    detectAnomaly?: (record: unknown) => AnomalyResult;
+    /**
+     * Drift detection: compares current record against baseline.
+     * Default: no drift.
+     */
+    detectDrift?: (record: unknown, baseline: unknown) => unknown;
+    /**
+     * Remediation suggestion function.
+     * Default: no suggestion.
+     */
+    suggest?: (result: {
+        validation: ValidationResult;
+        anomaly: AnomalyResult;
+    }) => unknown;
+    /** Max feedback iterations for rule refinement. Default: 3. */
+    maxFeedbackIterations?: number;
+};
+/**
+ * Data ingest → schema validation → anomaly detection → drift alerting →
+ * auto-remediation suggestions → output.
+ *
+ * Well-known node names:
+ * - `"source"` — data ingest
+ * - `"validate"` — schema validation
+ * - `"anomaly"` — anomaly detection
+ * - `"baseline"` — rolling baseline state
+ * - `"drift"` — drift detection
+ * - `"remediate"` — auto-remediation suggestions
+ * - `"output"` — combined quality report
+ *
+ * @category patterns
+ */
+declare function dataQualityGraph(name: string, opts: DataQualityGraphOptions): Graph;
+
+type domainTemplates_AnomalyResult = AnomalyResult;
+type domainTemplates_ContentModerationGraphOptions = ContentModerationGraphOptions;
+type domainTemplates_DataQualityGraphOptions = DataQualityGraphOptions;
+type domainTemplates_ExtractedIssue = ExtractedIssue;
+type domainTemplates_IssueTrackerGraphOptions = IssueTrackerGraphOptions;
+type domainTemplates_ModerationResult = ModerationResult;
+type domainTemplates_ObservabilityBranch = ObservabilityBranch;
+type domainTemplates_ObservabilityGraphOptions = ObservabilityGraphOptions;
+type domainTemplates_ValidationResult = ValidationResult;
+declare const domainTemplates_contentModerationGraph: typeof contentModerationGraph;
+declare const domainTemplates_dataQualityGraph: typeof dataQualityGraph;
+declare const domainTemplates_issueTrackerGraph: typeof issueTrackerGraph;
+declare const domainTemplates_observabilityGraph: typeof observabilityGraph;
+declare namespace domainTemplates {
+  export { type domainTemplates_AnomalyResult as AnomalyResult, type domainTemplates_ContentModerationGraphOptions as ContentModerationGraphOptions, type domainTemplates_DataQualityGraphOptions as DataQualityGraphOptions, type domainTemplates_ExtractedIssue as ExtractedIssue, type domainTemplates_IssueTrackerGraphOptions as IssueTrackerGraphOptions, type domainTemplates_ModerationResult as ModerationResult, type domainTemplates_ObservabilityBranch as ObservabilityBranch, type domainTemplates_ObservabilityGraphOptions as ObservabilityGraphOptions, type domainTemplates_ValidationResult as ValidationResult, domainTemplates_contentModerationGraph as contentModerationGraph, domainTemplates_dataQualityGraph as dataQualityGraph, domainTemplates_issueTrackerGraph as issueTrackerGraph, domainTemplates_observabilityGraph as observabilityGraph };
+}
+
 /**
  * LLM graph composition (roadmap §8.3).
  *
@@ -1404,11 +1658,88 @@ type FnFactory = (deps: Node<unknown>[], config: Record<string, unknown>) => Nod
  * Receives the config from the spec.
  */
 type SourceFactory = (config: Record<string, unknown>) => Node<unknown>;
-/** Fn/source lookup table passed to compileSpec. */
+/** Simple config field descriptor for LLM prompt generation and validation. */
+type ConfigFieldSchema = {
+    /** Human-readable type: "string", "number", "boolean", "string[]", etc. */
+    type: string;
+    /** Whether this field is required (default: true). */
+    required?: boolean;
+    /** Allowed values (enum constraint). */
+    enum?: readonly (string | number | boolean)[];
+    /** Human-readable description for LLM context. */
+    description?: string;
+    /** Default value if omitted. */
+    default?: unknown;
+};
+/**
+ * Rich catalog entry: bundles a runtime factory with LLM-facing metadata.
+ *
+ * The metadata is used to:
+ * 1. Auto-generate prompt text for {@link llmCompose} (replaces manual `catalogDescription`)
+ * 2. Validate LLM output in {@link validateSpec} (catch wrong fn names, invalid config)
+ * 3. Provide actionable error messages for {@link llmRefine} feedback loops
+ *
+ * Developers register ONE object; the library handles prompt generation and validation.
+ */
+type CatalogFnEntry = {
+    /** Runtime factory. */
+    factory: FnFactory;
+    /** One-line description for LLM prompt (what it does, not how). */
+    description: string;
+    /** Config field schemas. Keys are config field names. */
+    configSchema?: Record<string, ConfigFieldSchema>;
+    /** Example config objects (shown in prompt for complex fns). */
+    examples?: Record<string, unknown>[];
+    /** Category tags for grouping in prompt (e.g., "resilience", "reduction", "ai"). */
+    tags?: string[];
+};
+/** Rich catalog entry for producer sources. */
+type CatalogSourceEntry = {
+    /** Runtime factory. */
+    factory: SourceFactory;
+    /** One-line description for LLM prompt. */
+    description: string;
+    /** Config field schemas. */
+    configSchema?: Record<string, ConfigFieldSchema>;
+    /** Example config objects. */
+    examples?: Record<string, unknown>[];
+    /** Category tags. */
+    tags?: string[];
+};
+/**
+ * Fn/source lookup table passed to compileSpec and llmCompose.
+ *
+ * Accepts both bare factories (backward-compatible) and rich {@link CatalogFnEntry}
+ * / {@link CatalogSourceEntry} objects. When rich entries are provided, the library
+ * auto-generates LLM prompts and validates LLM output against the catalog.
+ */
 type GraphSpecCatalog = {
-    fns?: Record<string, FnFactory>;
-    sources?: Record<string, SourceFactory>;
+    fns?: Record<string, FnFactory | CatalogFnEntry>;
+    sources?: Record<string, SourceFactory | CatalogSourceEntry>;
 };
+/** Type guard: is this a rich catalog fn entry (vs bare factory)? */
+declare function isRichFnEntry(entry: FnFactory | CatalogFnEntry): entry is CatalogFnEntry;
+/** Type guard: is this a rich catalog source entry (vs bare factory)? */
+declare function isRichSourceEntry(entry: SourceFactory | CatalogSourceEntry): entry is CatalogSourceEntry;
+/** Extract the runtime factory from a catalog entry (rich or bare). */
+declare function extractFnFactory(entry: FnFactory | CatalogFnEntry): FnFactory;
+/** Extract the runtime factory from a catalog source entry (rich or bare). */
+declare function extractSourceFactory(entry: SourceFactory | CatalogSourceEntry): SourceFactory;
+/**
+ * Auto-generate catalog prompt text from rich catalog entries.
+ *
+ * Groups fns by tag, formats each as `- name: description. Config: { ... }`.
+ * Falls back to listing names only for bare factories.
+ */
+declare function generateCatalogPrompt(catalog: GraphSpecCatalog): string;
+/**
+ * Validate a GraphSpec against a catalog.
+ *
+ * Checks that fn/source names reference actual catalog entries, and validates
+ * config fields against configSchema when rich entries are available.
+ * Returns additional errors beyond structural {@link validateSpec} checks.
+ */
+declare function validateSpecAgainstCatalog(spec: GraphSpec, catalog: GraphSpecCatalog): GraphSpecValidation;
 /** Validation result from {@link validateSpec}. */
 type GraphSpecValidation = {
     valid: boolean;
@@ -1485,8 +1816,24 @@ type LLMComposeOptions = {
     maxTokens?: number;
     /** Extra instructions appended to the system prompt. */
     systemPromptExtra?: string;
-    /** Available fn/source catalog names for the LLM to reference. */
+    /**
+     * Available fn/source catalog names for the LLM to reference.
+     * When omitted and `catalog` contains rich {@link CatalogFnEntry} entries,
+     * the prompt is auto-generated via {@link generateCatalogPrompt}.
+     */
     catalogDescription?: string;
+    /**
+     * Catalog for auto-prompt generation and catalog-aware validation.
+     * When rich entries are provided, the catalog prompt is auto-generated
+     * and LLM output is validated against fn/source names and config schemas.
+     */
+    catalog?: GraphSpecCatalog;
+    /**
+     * Max auto-refine attempts when the LLM output fails catalog validation.
+     * Each attempt feeds the validation errors back to the LLM via llmRefine.
+     * Default: 0 (no auto-refine). Set to 2-3 for production use.
+     */
+    maxAutoRefine?: number;
 };
 /**
  * Ask an LLM to compose a GraphSpec from a natural-language problem description.
@@ -1519,7 +1866,10 @@ type LLMRefineOptions = LLMComposeOptions;
  */
 declare function llmRefine(currentSpec: GraphSpec, feedback: string, adapter: LLMAdapter, opts?: LLMRefineOptions): Promise<GraphSpec>;
 
+type graphspec_CatalogFnEntry = CatalogFnEntry;
+type graphspec_CatalogSourceEntry = CatalogSourceEntry;
 type graphspec_CompileSpecOptions = CompileSpecOptions;
+type graphspec_ConfigFieldSchema = ConfigFieldSchema;
 type graphspec_FnFactory = FnFactory;
 type graphspec_GraphSpec = GraphSpec;
 type graphspec_GraphSpecCatalog = GraphSpecCatalog;
@@ -1535,12 +1885,18 @@ type graphspec_SpecDiffEntry = SpecDiffEntry;
 type graphspec_SpecDiffResult = SpecDiffResult;
 declare const graphspec_compileSpec: typeof compileSpec;
 declare const graphspec_decompileGraph: typeof decompileGraph;
+declare const graphspec_extractFnFactory: typeof extractFnFactory;
+declare const graphspec_extractSourceFactory: typeof extractSourceFactory;
+declare const graphspec_generateCatalogPrompt: typeof generateCatalogPrompt;
+declare const graphspec_isRichFnEntry: typeof isRichFnEntry;
+declare const graphspec_isRichSourceEntry: typeof isRichSourceEntry;
 declare const graphspec_llmCompose: typeof llmCompose;
 declare const graphspec_llmRefine: typeof llmRefine;
 declare const graphspec_specDiff: typeof specDiff;
 declare const graphspec_validateSpec: typeof validateSpec;
+declare const graphspec_validateSpecAgainstCatalog: typeof validateSpecAgainstCatalog;
 declare namespace graphspec {
-  export { type graphspec_CompileSpecOptions as CompileSpecOptions, type graphspec_FnFactory as FnFactory, type graphspec_GraphSpec as GraphSpec, type graphspec_GraphSpecCatalog as GraphSpecCatalog, type graphspec_GraphSpecFeedbackEdge as GraphSpecFeedbackEdge, type graphspec_GraphSpecNode as GraphSpecNode, type graphspec_GraphSpecTemplate as GraphSpecTemplate, type graphspec_GraphSpecTemplateRef as GraphSpecTemplateRef, type graphspec_GraphSpecValidation as GraphSpecValidation, type graphspec_LLMComposeOptions as LLMComposeOptions, type graphspec_LLMRefineOptions as LLMRefineOptions, type graphspec_SourceFactory as SourceFactory, type graphspec_SpecDiffEntry as SpecDiffEntry, type graphspec_SpecDiffResult as SpecDiffResult, graphspec_compileSpec as compileSpec, graphspec_decompileGraph as decompileGraph, graphspec_llmCompose as llmCompose, graphspec_llmRefine as llmRefine, graphspec_specDiff as specDiff, graphspec_validateSpec as validateSpec };
+  export { type graphspec_CatalogFnEntry as CatalogFnEntry, type graphspec_CatalogSourceEntry as CatalogSourceEntry, type graphspec_CompileSpecOptions as CompileSpecOptions, type graphspec_ConfigFieldSchema as ConfigFieldSchema, type graphspec_FnFactory as FnFactory, type graphspec_GraphSpec as GraphSpec, type graphspec_GraphSpecCatalog as GraphSpecCatalog, type graphspec_GraphSpecFeedbackEdge as GraphSpecFeedbackEdge, type graphspec_GraphSpecNode as GraphSpecNode, type graphspec_GraphSpecTemplate as GraphSpecTemplate, type graphspec_GraphSpecTemplateRef as GraphSpecTemplateRef, type graphspec_GraphSpecValidation as GraphSpecValidation, type graphspec_LLMComposeOptions as LLMComposeOptions, type graphspec_LLMRefineOptions as LLMRefineOptions, type graphspec_SourceFactory as SourceFactory, type graphspec_SpecDiffEntry as SpecDiffEntry, type graphspec_SpecDiffResult as SpecDiffResult, graphspec_compileSpec as compileSpec, graphspec_decompileGraph as decompileGraph, graphspec_extractFnFactory as extractFnFactory, graphspec_extractSourceFactory as extractSourceFactory, graphspec_generateCatalogPrompt as generateCatalogPrompt, graphspec_isRichFnEntry as isRichFnEntry, graphspec_isRichSourceEntry as isRichSourceEntry, graphspec_llmCompose as llmCompose, graphspec_llmRefine as llmRefine, graphspec_specDiff as specDiff, graphspec_validateSpec as validateSpec, graphspec_validateSpecAgainstCatalog as validateSpecAgainstCatalog };
 }
 
 /**
@@ -1743,7 +2099,7 @@ declare function branch<T>(graph: Graph, name: string, source: StepRef$1, predic
 /**
  * Forwards source values only while `control` is truthy.
  */
-declare function gate<T>(graph: Graph, name: string, source: StepRef$1, control: StepRef$1, opts?: Omit<OrchestrationStepOptions, "deps">): Node<T>;
+declare function valve<T>(graph: Graph, name: string, source: StepRef$1, control: StepRef$1, opts?: Omit<OrchestrationStepOptions, "deps">): Node<T>;
 type ApprovalOptions = Omit<OrchestrationStepOptions, "deps"> & {
     isApproved?: (value: unknown) => boolean;
 };
@@ -1751,6 +2107,46 @@ type ApprovalOptions = Omit<OrchestrationStepOptions, "deps"> & {
  * Human/LLM approval gate over a source value.
  */
 declare function approval<T>(graph: Graph, name: string, source: StepRef$1, approver: StepRef$1, opts?: ApprovalOptions): Node<T>;
+interface GateOptions {
+    /** Maximum queue size. Oldest values are FIFO-dropped when exceeded. Default: Infinity. */
+    maxPending?: number;
+    /** Start in open mode (auto-approve). Default: false. */
+    startOpen?: boolean;
+    meta?: Record<string, unknown>;
+}
+/** Control surface returned by {@link gate}. */
+interface GateController<T> {
+    /** The output node registered in the graph (subscribe to receive approved values). */
+    node: Node<T>;
+    /** Reactive queue of values waiting for approval. */
+    pending: Node<T[]>;
+    /** Derived count of pending items. */
+    count: Node<number>;
+    /** Whether the gate is currently open (auto-approving). */
+    isOpen: Node<boolean>;
+    /** Approve and forward the next `count` pending values (default: 1). */
+    approve(count?: number): void;
+    /** Reject (discard) the next `count` pending values (default: 1). */
+    reject(count?: number): void;
+    /**
+     * Transform and forward `count` pending values (default: 1).
+     * `fn` receives `(value, index, pending)` — Array.map-style.
+     */
+    modify(fn: (value: T, index: number, pending: readonly T[]) => T, count?: number): void;
+    /** Flush all pending values and auto-approve future values. */
+    open(): void;
+    /** Re-enable manual gating (stop auto-approving). */
+    close(): void;
+}
+/**
+ * Human-in-the-loop gate: queues incoming values from `source` and lets an external
+ * controller {@link GateController.approve approve}, {@link GateController.reject reject},
+ * or {@link GateController.modify modify} them before forwarding downstream.
+ *
+ * Observable surfaces (`pending`, `count`, `isOpen`) are reactive nodes registered in
+ * the graph. The gate output node is also registered.
+ */
+declare function gate<T>(graph: Graph, name: string, source: StepRef$1, opts?: GateOptions): GateController<T>;
 /**
  * Registers a workflow side-effect step. The step remains graph-observable and forwards messages.
  */
@@ -1786,6 +2182,8 @@ declare function onFailure<T>(graph: Graph, name: string, source: StepRef$1, rec
 
 type orchestration_ApprovalOptions = ApprovalOptions;
 type orchestration_BranchResult<T> = BranchResult<T>;
+type orchestration_GateController<T> = GateController<T>;
+type orchestration_GateOptions = GateOptions;
 type orchestration_LoopOptions = LoopOptions;
 type orchestration_OrchestrationStepOptions = OrchestrationStepOptions;
 type orchestration_SensorControls<T> = SensorControls<T>;
@@ -1802,9 +2200,10 @@ declare const orchestration_pipeline: typeof pipeline;
 declare const orchestration_sensor: typeof sensor;
 declare const orchestration_subPipeline: typeof subPipeline;
 declare const orchestration_task: typeof task;
+declare const orchestration_valve: typeof valve;
 declare const orchestration_wait: typeof wait;
 declare namespace orchestration {
-  export { type orchestration_ApprovalOptions as ApprovalOptions, type orchestration_BranchResult as BranchResult, type orchestration_LoopOptions as LoopOptions, type orchestration_OrchestrationStepOptions as OrchestrationStepOptions, type orchestration_SensorControls as SensorControls, type StepRef$1 as StepRef, type orchestration_SubPipelineBuilder as SubPipelineBuilder, type orchestration_WaitOptions as WaitOptions, orchestration_approval as approval, orchestration_branch as branch, orchestration_forEach as forEach, orchestration_gate as gate, orchestration_join as join, orchestration_loop as loop, orchestration_onFailure as onFailure, orchestration_pipeline as pipeline, orchestration_sensor as sensor, orchestration_subPipeline as subPipeline, orchestration_task as task, orchestration_wait as wait };
+  export { type orchestration_ApprovalOptions as ApprovalOptions, type orchestration_BranchResult as BranchResult, type orchestration_GateController as GateController, type orchestration_GateOptions as GateOptions, type orchestration_LoopOptions as LoopOptions, type orchestration_OrchestrationStepOptions as OrchestrationStepOptions, type orchestration_SensorControls as SensorControls, type StepRef$1 as StepRef, type orchestration_SubPipelineBuilder as SubPipelineBuilder, type orchestration_WaitOptions as WaitOptions, orchestration_approval as approval, orchestration_branch as branch, orchestration_forEach as forEach, orchestration_gate as gate, orchestration_join as join, orchestration_loop as loop, orchestration_onFailure as onFailure, orchestration_pipeline as pipeline, orchestration_sensor as sensor, orchestration_subPipeline as subPipeline, orchestration_task as task, orchestration_valve as valve, orchestration_wait as wait };
 }
 
 /**
@@ -1988,13 +2387,14 @@ declare namespace reduction {
 
 declare const index_ai: typeof ai;
 declare const index_cqrs: typeof cqrs;
+declare const index_domainTemplates: typeof domainTemplates;
 declare const index_graphspec: typeof graphspec;
 declare const index_memory: typeof memory;
 declare const index_messaging: typeof messaging;
 declare const index_orchestration: typeof orchestration;
 declare const index_reduction: typeof reduction;
 declare namespace index {
-  export { index_ai as ai, index_cqrs as cqrs, demoShell$1 as demoShell, index_graphspec as graphspec, index$b as layout, index_memory as memory, index_messaging as messaging, index_orchestration as orchestration, index_reduction as reduction };
+  export { index_ai as ai, index_cqrs as cqrs, demoShell$1 as demoShell, index_domainTemplates as domainTemplates, index_graphspec as graphspec, index$b as layout, index_memory as memory, index_messaging as messaging, index_orchestration as orchestration, index_reduction as reduction };
 }
 
 /**
@@ -2002,4 +2402,4 @@ declare namespace index {
  */
 declare const version = "0.0.0";
 
-export { Actor, AutoCheckpointAdapter, DistillBundle, Extraction, Graph, GraphAutoCheckpointHandle, GraphAutoCheckpointOptions, GraphOptions, Node, NodeActions, NodeFn, NodeInput, NodeOptions, ReactiveListSnapshot, ReactiveLogSnapshot, ReactiveMapSnapshot, ai, index$1 as compat, cqrs, demoShell$1 as demoShell, graphspec, index$9 as jotai, index$b as layout, memory, messaging, index$8 as nanostores, index$a as nestjs, orchestration, index as patterns, index$7 as react, reduction, index$6 as signals, index$5 as solid, index$4 as svelte, version, index$3 as vue, index$2 as zustand };
+export { Actor, AutoCheckpointAdapter, DistillBundle, Extraction, Graph, GraphAutoCheckpointHandle, GraphAutoCheckpointOptions, GraphOptions, Node, NodeActions, NodeFn, NodeInput, NodeOptions, ReactiveListSnapshot, ReactiveLogSnapshot, ReactiveMapSnapshot, ai, index$1 as compat, cqrs, demoShell$1 as demoShell, domainTemplates, graphspec, index$9 as jotai, index$b as layout, memory, messaging, index$8 as nanostores, index$a as nestjs, orchestration, index as patterns, index$7 as react, reduction, index$6 as signals, index$5 as solid, index$4 as svelte, version, index$3 as vue, index$2 as zustand };