@graphrefly/graphrefly 0.19.0 → 0.21.0

package/dist/index.d.cts

@@ -4,10 +4,10 @@ import { i as index$b, c as cqrs } from './index-BjtlNirP.cjs';
 import { Ref, WatchSource } from 'vue';
 import { G as Graph, a as GraphOptions, b as GraphAutoCheckpointHandle, A as AutoCheckpointAdapter, c as GraphAutoCheckpointOptions, d as GraphProfileResult, e as GraphProfileOptions } from './graph-KsTe57nI.cjs';
 export { D as DescribeFilter, f as GRAPH_META_SEGMENT, g as GraphActorOptions, h as GraphCheckpointRecord, i as GraphDescribeOptions, j as GraphDescribeOutput, k as GraphDiagramDirection, l as GraphDiagramOptions, m as GraphDiffChange, n as GraphDiffResult, o as GraphDumpOptions, p as GraphFactoryContext, q as GraphNodeFactory, r as GraphObserveAll, s as GraphObserveOne, t as GraphPersistSnapshot, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, B as graphProfile, C as reachable } from './graph-KsTe57nI.cjs';
-import { N as NodeFn } from './index-BBUYZfJ1.cjs';
-export { B as BridgeOptions, D as DEFAULT_DOWN, a as DownStrategy, b as DynGet, c as DynamicNodeFn, d as DynamicNodeImpl, e as DynamicNodeOptions, P as PipeOperator, R as ResettableTimer, f as batch, g as bridge, i as core, h as derived, j as downWithBatch, k as dynamicNode, l as effect, m as isBatching, n as monotonicNs, o as node, p as partitionForBatch, q as pipe, r as producer, s as state, w as wallClockNs } from './index-BBUYZfJ1.cjs';
-import { N as NodeInput, D as DistillBundle, E as Extraction } from './index-Bjh5C1Tp.cjs';
-export { A as AdapterHandlers, a as AsyncSourceOpts, B as BackoffPreset, b as BackoffStrategy, c as BatchMessage, d as BridgeMessage, e as BufferedSinkHandle, C as CSVRow, f as CacheEvictionPolicy, g as CacheTier, h as CascadingCache, i as CascadingCacheOptions, j as CheckpointAdapter, k as CheckpointToRedisOptions, l as CheckpointToS3Options, m as CircuitBreaker, n as CircuitBreakerOptions, o as CircuitOpenError, p as CircuitState, q as ClickHouseClientLike, r as ClickHouseInsertClientLike, s as ClickHouseRow, t as CronSchedule, u as DictCheckpointAdapter, v as DistillOptions, w as DrizzleQueryLike, x as ErrorMessage, y as EventTargetLike, z as ExponentialBackoffOptions, F as FSEvent, G as FSEventType, H as FileCheckpointAdapter, I as FileWriterLike, J as FromCSVOptions, K as FromClickHouseWatchOptions, L as FromCronOptions, M as FromDrizzleOptions, O as FromFSWatchOptions, P as FromGitHookOptions, Q as FromHTTPOptions, R as FromKafkaOptions, S as FromKyselyOptions, T as FromMCPOptions, U as FromNATSOptions, V as FromNDJSONOptions, W as FromOTelOptions, X as FromPrismaOptions, Y as FromPrometheusOptions, Z as FromPulsarOptions, _ as FromRabbitMQOptions, $ as FromRedisStreamOptions, a0 as FromSqliteOptions, a1 as FromStatsDOptions, a2 as FromSyslogOptions, a3 as GitEvent, a4 as GitHookType, a5 as HTTPBundle, a6 as IndexRow, a7 as IndexedDbCheckpointSpec, a8 as InitMessage, a9 as JitterMode, aa as KafkaConsumerLike, ab as KafkaMessage, ac as KafkaProducerLike, ad as KyselyQueryLike, ae as LokiClientLike, af as LokiStream, ag as MCPClientLike, ah as MemoryCheckpointAdapter, ai as MergeMapOptions, aj as MongoCollectionLike, ak as NATSClientLike, al as NATSMessage, am as NATSSubscriptionLike, an as NS_PER_MS, ao as NS_PER_SEC, ap as OTelBundle, aq as OTelLog, ar as OTelMetric, as as OTelRegister, at as OTelSpan, au as PostgresClientLike, av as PrismaModelLike, aw as PrometheusMetric, ax as PubSubHub, ay as PulsarConsumerLike, az as PulsarMessage, aA as PulsarProducerLike, aB as RabbitMQChannelLike, aC as RabbitMQMessage, aD as ReactiveIndexBundle, aE as ReactiveIndexOptions, aF as ReactiveListBundle, aG as ReactiveListOptions, aH as ReactiveLogBundle, aI as ReactiveLogOptions, aJ as ReactiveMapBundle, aK as ReactiveMapOptions, aL as ReadyMessage, aM as RedisCheckpointClientLike, aN as RedisClientLike, aO as RedisStreamEntry, aP as RetryOptions, aQ as S3ClientLike, aR as SignalMessage, aS as SinkHandle, aT as SinkTransportError, aU as SqliteCheckpointAdapter, aV as SqliteDbLike, aW as StatsDMetric, aX as StatsDRegister, aY as StatusValue, aZ as SyslogMessage, a_ as SyslogRegister, a$ as TapObserver, b0 as TempoClientLike, b1 as ThrottleOptions, b2 as TieredStorage, b3 as TieredStorageOptions, b4 as TimeoutError, b5 as ToCSVOptions, b6 as ToClickHouseOptions, b7 as ToFileOptions, b8 as ToKafkaOptions, b9 as ToLokiOptions, ba as ToMongoOptions, bb as ToNATSOptions, bc as ToPostgresOptions, bd as ToPulsarOptions, be as ToRabbitMQOptions, bf as ToRedisStreamOptions, bg as ToS3Options, bh as ToSSEOptions, bi as ToSqliteOptions, bj as ToTempoOptions, bk as ToWebSocketOptions, bl as ToWebSocketTransportError, bm as TokenBucket, bn as ValueMessage, bo as VerifiableBundle, bp as VerifiableOptions, bq as VerifyValue, br as WatermarkController, bs as WatermarkOptions, bt as WebSocketLike, bu as WebSocketMessageEventLike, bv as WebSocketRegister, bw as WebhookRegister, bx as WithBreakerBundle, by as WithStatusBundle, bz as WorkerBridge, bA as WorkerBridgeOptions, bB as WorkerSelfHandle, bC as WorkerSelfOptions, bD as WorkerTransport, bE as audit, bF as buffer, bG as bufferCount, bH as bufferTime, bI as cache, bJ as cached, bK as cascadingCache, bL as catchError, bM as checkpointNodeValue, bN as checkpointToRedis, bO as checkpointToS3, bP as circuitBreaker, bQ as combine, bR as combineLatest, bS as concat, bT as concatMap, bU as constant, bV as createTransport, bW as createWatermarkController, bX as debounce, bY as debounceTime, bZ as decorrelatedJitter, b_ as delay, b$ as deserializeError, c0 as distill, c1 as distinctUntilChanged, c2 as elementAt, c3 as empty, c4 as escapeRegexChar, c5 as exhaustMap, c6 as exponential, c7 as extra, c8 as fallback, c9 as fibonacci, ca as filter, cb as find, cc as first, cd as firstValueFrom, ce as firstWhere, 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 logSlice, 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 reactiveLog, da as reactiveMap, db as reduce, dc as repeat, dd as replay, de as rescue, df as resolveBackoffPreset, dg as restoreGraphCheckpoint, dh as restoreGraphCheckpointIndexedDb, di as retry, dj as sample, dk as saveGraphCheckpoint, dl as saveGraphCheckpointIndexedDb, dm as scan, dn as serializeError, dp as share, dq as shareReplay, dr as signalToName, ds as skip, 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 valve, dX as verifiable, dY as window, dZ as windowCount, d_ as windowTime, d$ as withBreaker, e0 as withLatestFrom, e1 as withMaxAttempts, e2 as withStatus, e3 as workerBridge, e4 as workerSelf, e5 as zip } from './index-Bjh5C1Tp.cjs';
+import { N as NodeFn } from './index-Bc_diYYJ.cjs';
+export { B as BridgeOptions, D as DEFAULT_DOWN, a as DownStrategy, b as DynGet, c as DynamicNodeFn, d as DynamicNodeImpl, e as DynamicNodeOptions, P as PipeOperator, R as ResettableTimer, f as batch, g as bridge, i as core, h as derived, j as downWithBatch, k as dynamicNode, l as effect, m as isBatching, n as monotonicNs, o as node, p as partitionForBatch, q as pipe, r as producer, s as state, w as wallClockNs } from './index-Bc_diYYJ.cjs';
+import { N as NodeInput, D as DistillBundle, E as Extraction } from './index-SFzE_KTa.cjs';
+export { A as AdapterHandlers, a as AsyncSourceOpts, B as BackoffPreset, b as BackoffStrategy, c as BatchMessage, d as BridgeMessage, e as BufferedSinkHandle, C as CSVRow, f as CacheEvictionPolicy, g as CacheTier, h as CascadingCache, i as CascadingCacheOptions, j as CheckpointAdapter, k as CheckpointToRedisOptions, l as CheckpointToS3Options, m as CircuitBreaker, n as CircuitBreakerOptions, o as CircuitOpenError, p as CircuitState, q as ClickHouseClientLike, r as ClickHouseInsertClientLike, s as ClickHouseRow, t as CronSchedule, u as DictCheckpointAdapter, v as DistillOptions, w as DrizzleQueryLike, x as ErrorMessage, y as EventTargetLike, z as ExponentialBackoffOptions, F as FSEvent, G as FSEventType, H as FileCheckpointAdapter, I as FileWriterLike, J as FromCSVOptions, K as FromClickHouseWatchOptions, L as FromCronOptions, M as FromDrizzleOptions, O as FromFSWatchOptions, P as FromGitHookOptions, Q as FromHTTPOptions, R as FromKafkaOptions, S as FromKyselyOptions, T as FromMCPOptions, U as FromNATSOptions, V as FromNDJSONOptions, W as FromOTelOptions, X as FromPrismaOptions, Y as FromPrometheusOptions, Z as FromPulsarOptions, _ as FromRabbitMQOptions, $ as FromRedisStreamOptions, a0 as FromSqliteOptions, a1 as FromStatsDOptions, a2 as FromSyslogOptions, a3 as GitEvent, a4 as GitHookType, a5 as HTTPBundle, a6 as IndexRow, a7 as IndexedDbCheckpointSpec, a8 as InitMessage, a9 as JitterMode, aa as KafkaConsumerLike, ab as KafkaMessage, ac as KafkaProducerLike, ad as KyselyQueryLike, ae as LokiClientLike, af as LokiStream, ag as MCPClientLike, ah as MemoryCheckpointAdapter, ai as MergeMapOptions, aj as MongoCollectionLike, ak as NATSClientLike, al as NATSMessage, am as NATSSubscriptionLike, an as NS_PER_MS, ao as NS_PER_SEC, ap as OTelBundle, aq as OTelLog, ar as OTelMetric, as as OTelRegister, at as OTelSpan, au as PostgresClientLike, av as PrismaModelLike, aw as PrometheusMetric, ax as PubSubHub, ay as PulsarConsumerLike, az as PulsarMessage, aA as PulsarProducerLike, aB as RabbitMQChannelLike, aC as RabbitMQMessage, aD as ReactiveCounterBundle, aE as ReactiveIndexBundle, aF as ReactiveIndexOptions, aG as ReactiveListBundle, aH as ReactiveListOptions, aI as ReactiveLogBundle, aJ as ReactiveLogOptions, 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 firstWhere, cg as flatMap, ch as forEach, ci as fromAny, cj as fromAsyncIter, ck as fromCSV, cl as fromClickHouseWatch, cm as fromCron, cn as fromDrizzle, co as fromEvent, cp as fromFSWatch, cq as fromGitHook, cr as fromHTTP, cs as fromIDBRequest, ct as fromIDBTransaction, cu as fromIter, cv as fromKafka, cw as fromKysely, cx as fromMCP, cy as fromNATS, cz as fromNDJSON, cA as fromOTel, cB as fromPrisma, cC as fromPrometheus, cD as fromPromise, cE as fromPulsar, cF as fromRabbitMQ, cG as fromRedisStream, cH as fromSqlite, cI as fromStatsD, cJ as fromSyslog, cK as fromTimer, cL as fromWebSocket, cM as fromWebhook, cN as globToRegExp, cO as interval, cP as keepalive, cQ as last, cR as linear, cS as logSlice, cT as lru, cU as map, cV as matchesAnyPattern, cW as matchesCron, cX as merge, cY as mergeMap, cZ as nameToSignal, c_ as never, c$ as of, d0 as pairwise, d1 as parseCron, d2 as parsePrometheusText, d3 as parseStatsD, d4 as parseSyslog, d5 as pausable, d6 as pubsub, d7 as race, d8 as rateLimiter, d9 as reactiveCounter, da as reactiveIndex, db as reactiveList, dc as reactiveLog, dd as reactiveMap, de as reduce, df as repeat, dg as replay, dh as rescue, di as resolveBackoffPreset, dj as restoreGraphCheckpoint, dk as restoreGraphCheckpointIndexedDb, dl as retry, dm as sample, dn as saveGraphCheckpoint, dp as saveGraphCheckpointIndexedDb, dq as scan, dr as serializeError, ds as share, dt as shareReplay, du as signalToName, dv as skip, dw as switchMap, dx as take, dy as takeUntil, dz as takeWhile, dA as tap, dB as throttle, dC as throttleTime, dD as throwError, dE as tieredStorage, dF as timeout, dG as toArray, dH as toCSV, dI as toClickHouse, dJ as toFile, dK as toKafka, dL as toLoki, dM as toMongo, dN as toNATS, dO as toPostgres, dP as toPulsar, dQ as toRabbitMQ, dR as toRedisStream, dS as toS3, dT as toSSE, dU as toSqlite, dV as toTempo, dW as toWebSocket, dX as tokenBucket, dY as tokenTracker, dZ as valve, d_ as verifiable, d$ as window, e0 as windowCount, e1 as windowTime, e2 as withBreaker, e3 as withLatestFrom, e4 as withMaxAttempts, e5 as withStatus, e6 as workerBridge, e7 as workerSelf, e8 as zip } from './index-SFzE_KTa.cjs';
 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, s as sizeof } from './index-UudxGnzc.cjs';
 import { M as MeasurementAdapter, i as index$c } from './index-VHA43cGP.cjs';
 export { T as ToObservableOptions, t as toObservable } from './observable-C8Kx_O6k.cjs';
@@ -1127,6 +1127,54 @@ type CostMeterOptions = {
  * output exceeds budget mid-generation.
  */
 declare function costMeterExtractor(streamTopic: TopicGraph<StreamChunk>, opts?: CostMeterOptions): Node<CostMeterReading>;
+/** Options for {@link redactor}. */
+type RedactorOptions = {
+    name?: string;
+};
+/**
+ * Stream extractor that replaces matched patterns in the accumulated text.
+ *
+ * Returns a derived node emitting a sanitized `StreamChunk` on every chunk:
+ * `accumulated` and `token` have matched substrings replaced by `replaceFn`.
+ * The default `replaceFn` replaces with `"[REDACTED]"`.
+ *
+ * Compose with `contentGate` for in-flight safety pipelines.
+ *
+ * @param streamTopic - Streaming topic to monitor.
+ * @param patterns    - Array of RegExps to match against accumulated text.
+ * @param replaceFn   - Replacement producer (default: always `"[REDACTED]"`).
+ */
+declare function redactor(streamTopic: TopicGraph<StreamChunk>, patterns: RegExp[], replaceFn?: (match: string, pattern: RegExp) => string, opts?: RedactorOptions): Node<StreamChunk>;
+/** Content safety decision. */
+type ContentDecision = "allow" | "block" | "review";
+/** Options for {@link contentGate}. */
+type ContentGateOptions = {
+    /**
+     * Hard-block threshold multiplier (default 1.5).
+     * Scores above `threshold * hardMultiplier` emit `"block"`.
+     * Scores between `threshold` and that emit `"review"`.
+     */
+    hardMultiplier?: number;
+    name?: string;
+};
+/**
+ * Derived node that classifies accumulated stream text as `"allow"`,
+ * `"review"`, or `"block"` based on a classifier score.
+ *
+ * Emits a three-way decision on every new chunk:
+ * - `"allow"` — score below `threshold`
+ * - `"review"` — score in `[threshold, threshold × hardMultiplier)`
+ * - `"block"` — score at or above `threshold × hardMultiplier`
+ *
+ * Wire the output into a `valve` (automatic) or `gate` (human approval).
+ * This node does not itself control flow — it just classifies.
+ *
+ * @param streamTopic - Streaming topic to classify.
+ * @param classifier  - `(accumulated: string) => number` scoring function, or
+ *                      a `Node<number>` for live scores.
+ * @param threshold   - Score at which output becomes "review" or "block".
+ */
+declare function contentGate(streamTopic: TopicGraph<StreamChunk>, classifier: ((accumulated: string) => number) | Node<number>, threshold: number, opts?: ContentGateOptions): Node<ContentDecision>;
 type GatedStreamOptions = StreamingPromptNodeOptions & {
     /** Gate options (maxPending, startOpen). */
     gate?: Omit<GateOptions, "meta">;
@@ -1630,6 +1678,8 @@ type ai_ChatMessage = ChatMessage;
 type ai_ChatStreamGraph = ChatStreamGraph;
 declare const ai_ChatStreamGraph: typeof ChatStreamGraph;
 type ai_ChatStreamOptions = ChatStreamOptions;
+type ai_ContentDecision = ContentDecision;
+type ai_ContentGateOptions = ContentGateOptions;
 type ai_CostMeterOptions = CostMeterOptions;
 type ai_CostMeterReading = CostMeterReading;
 type ai_ExtractedToolCall = ExtractedToolCall;
@@ -1653,6 +1703,7 @@ type ai_MemoryTiersBundle<TMem> = MemoryTiersBundle<TMem>;
 type ai_MemoryTiersOptions<TMem> = MemoryTiersOptions<TMem>;
 type ai_OpenAIToolSchema = OpenAIToolSchema;
 type ai_PromptNodeOptions = PromptNodeOptions;
+type ai_RedactorOptions = RedactorOptions;
 type ai_RetrievalEntry<TMem> = RetrievalEntry<TMem>;
 type ai_RetrievalPipelineOptions<TMem> = RetrievalPipelineOptions<TMem>;
 type ai_RetrievalQuery = RetrievalQuery;
@@ -1673,6 +1724,7 @@ declare const ai_admissionFilter3D: typeof admissionFilter3D;
 declare const ai_agentLoop: typeof agentLoop;
 declare const ai_agentMemory: typeof agentMemory;
 declare const ai_chatStream: typeof chatStream;
+declare const ai_contentGate: typeof contentGate;
 declare const ai_costMeterExtractor: typeof costMeterExtractor;
 declare const ai_fromLLM: typeof fromLLM;
 declare const ai_gatedStream: typeof gatedStream;
@@ -1683,6 +1735,7 @@ 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_redactor: typeof redactor;
 declare const ai_streamExtractor: typeof streamExtractor;
 declare const ai_streamingPromptNode: typeof streamingPromptNode;
 declare const ai_suggestStrategy: typeof suggestStrategy;
@@ -1691,7 +1744,7 @@ declare const ai_toolCallExtractor: typeof toolCallExtractor;
 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_CostMeterOptions as CostMeterOptions, type ai_CostMeterReading as CostMeterReading, type ai_ExtractedToolCall as ExtractedToolCall, type ai_FromLLMOptions as FromLLMOptions, type ai_GatedStreamHandle as GatedStreamHandle, type ai_GatedStreamOptions as GatedStreamOptions, type ai_GaugesAsContextOptions as GaugesAsContextOptions, type ai_GraphDefValidation as GraphDefValidation, type ai_GraphFromSpecOptions as GraphFromSpecOptions, type ai_KeywordFlag as KeywordFlag, type ai_KeywordFlagExtractorOptions as KeywordFlagExtractorOptions, 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_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_StreamChunk as StreamChunk, type ai_StreamingPromptNodeHandle as StreamingPromptNodeHandle, type ai_StreamingPromptNodeOptions as StreamingPromptNodeOptions, 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_costMeterExtractor as costMeterExtractor, ai_fromLLM as fromLLM, ai_gatedStream as gatedStream, ai_gaugesAsContext as gaugesAsContext, ai_graphFromSpec as graphFromSpec, ai_keywordFlagExtractor as keywordFlagExtractor, ai_knobsAsTools as knobsAsTools, ai_llmConsolidator as llmConsolidator, ai_llmExtractor as llmExtractor, ai_promptNode as promptNode, ai_streamExtractor as streamExtractor, ai_streamingPromptNode as streamingPromptNode, ai_suggestStrategy as suggestStrategy, ai_systemPromptBuilder as systemPromptBuilder, ai_toolCallExtractor as toolCallExtractor, 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_ContentDecision as ContentDecision, type ai_ContentGateOptions as ContentGateOptions, type ai_CostMeterOptions as CostMeterOptions, type ai_CostMeterReading as CostMeterReading, type ai_ExtractedToolCall as ExtractedToolCall, type ai_FromLLMOptions as FromLLMOptions, type ai_GatedStreamHandle as GatedStreamHandle, type ai_GatedStreamOptions as GatedStreamOptions, type ai_GaugesAsContextOptions as GaugesAsContextOptions, type ai_GraphDefValidation as GraphDefValidation, type ai_GraphFromSpecOptions as GraphFromSpecOptions, type ai_KeywordFlag as KeywordFlag, type ai_KeywordFlagExtractorOptions as KeywordFlagExtractorOptions, 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_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_RedactorOptions as RedactorOptions, 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_StreamChunk as StreamChunk, type ai_StreamingPromptNodeHandle as StreamingPromptNodeHandle, type ai_StreamingPromptNodeOptions as StreamingPromptNodeOptions, 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_contentGate as contentGate, ai_costMeterExtractor as costMeterExtractor, ai_fromLLM as fromLLM, ai_gatedStream as gatedStream, ai_gaugesAsContext as gaugesAsContext, ai_graphFromSpec as graphFromSpec, ai_keywordFlagExtractor as keywordFlagExtractor, ai_knobsAsTools as knobsAsTools, ai_llmConsolidator as llmConsolidator, ai_llmExtractor as llmExtractor, ai_promptNode as promptNode, ai_redactor as redactor, ai_streamExtractor as streamExtractor, ai_streamingPromptNode as streamingPromptNode, ai_suggestStrategy as suggestStrategy, ai_systemPromptBuilder as systemPromptBuilder, ai_toolCallExtractor as toolCallExtractor, ai_toolRegistry as toolRegistry, ai_validateGraphDef as validateGraphDef };
 }
 
 /**
@@ -2474,14 +2527,38 @@ interface HarnessLoopOptions {
 }
 
 /**
- * Eval→intake bridge (roadmap §9.0).
+ * Harness bridge factories (roadmap §9.0).
  *
- * Effect node that parses eval results into IntakeItem[] and publishes
- * to an intake TopicGraph. Produces per-criterion findings, not per-task scores.
+ * Intake bridges, eval source wrapper, before/after comparison,
+ * affected-task filter, code-change bridge, and notification effect.
+ * All are compositions of existing primitives — no new abstractions.
  *
  * @module
  */
 
+/** Options for {@link createIntakeBridge}. */
+interface IntakeBridgeOptions {
+    /** Name for the effect node (default "intake-bridge"). */
+    name?: string;
+}
+/**
+ * Generic source→intake bridge factory.
+ *
+ * Watches a source node for new values, passes each through a user-supplied
+ * `parser` that produces zero or more `IntakeItem`s, and publishes them to
+ * the given intake topic.
+ *
+ * This is the generalized pattern behind {@link evalIntakeBridge}. Use it for
+ * CI results, test failures, Slack messages, monitoring alerts, or any domain
+ * where structured results should flow into a harness loop.
+ *
+ * @param source - Reactive node emitting domain-specific data.
+ * @param intakeTopic - TopicGraph to publish IntakeItem entries to.
+ * @param parser - Converts source data into IntakeItem[]. Return empty array to skip.
+ * @param opts - Optional configuration.
+ * @returns The effect node (for lifecycle management).
+ */
+declare function createIntakeBridge<T>(source: Node<T>, intakeTopic: TopicGraph<IntakeItem>, parser: (value: T) => IntakeItem[], opts?: IntakeBridgeOptions): Node<unknown>;
 /**
  * Minimal eval result shape accepted by the bridge.
  *
@@ -2522,6 +2599,135 @@ interface EvalIntakeBridgeOptions {
  * @returns The effect node (for lifecycle management).
  */
 declare function evalIntakeBridge(evalSource: Node<EvalResult | EvalResult[]>, intakeTopic: TopicGraph<IntakeItem>, opts?: EvalIntakeBridgeOptions): Node<unknown>;
+/**
+ * Wrap any eval runner as a reactive producer node.
+ *
+ * When `trigger` emits, calls `runner()` and emits the result downstream.
+ * Uses `switchMap` + `fromAny` — the async boundary stays in the source
+ * layer (spec §5.10). A new trigger cancels any in-flight run.
+ *
+ * ```ts
+ * const trigger = state(0);         // bump to trigger a new run
+ * const results = evalSource(trigger, () => runEvals(config));
+ * results.subscribe(msgs => { ... });
+ * trigger.down([[DATA, 1]]);         // fires the runner
+ * ```
+ *
+ * @param trigger - Any node; each new DATA emission fires the runner.
+ * @param runner  - Returns an EvalResult (or promise of one).
+ */
+declare function evalSource<T extends EvalResult>(trigger: Node<unknown>, runner: () => T | Promise<T>): Node<T>;
+/** Per-task delta produced by {@link beforeAfterCompare}. */
+interface EvalTaskDelta {
+    taskId: string;
+    before: boolean;
+    after: boolean;
+    /** Score-level diff (after − before), undefined if no scores present. */
+    scoreDiff?: number;
+}
+/** Output of {@link beforeAfterCompare}. */
+interface EvalDelta {
+    /** Task IDs that newly fail in `after` (were passing in `before`). */
+    newFailures: string[];
+    /** Task IDs that now pass in `after` (were failing in `before`). */
+    resolved: string[];
+    /** Full per-task breakdown. */
+    taskDeltas: EvalTaskDelta[];
+    /** True when net resolutions > net failures. */
+    overallImproved: boolean;
+}
+/**
+ * Derived node that computes before/after eval deltas.
+ *
+ * Pure computation: no LLM, no async. Compares per-task validity and
+ * pass counts between two `EvalResult` snapshots.
+ *
+ * @param before - Node holding the baseline eval result.
+ * @param after  - Node holding the new eval result.
+ */
+declare function beforeAfterCompare(before: Node<EvalResult>, after: Node<EvalResult>): Node<EvalDelta>;
+/**
+ * Derived node that selects which eval task IDs to re-run.
+ *
+ * Collects `affectsEvalTasks` from all triaged items, deduplicates, then
+ * optionally intersects with `fullTaskSet`. Returns a sorted array of IDs.
+ *
+ * Use this to avoid re-running the full eval suite after each fix: only the
+ * tasks that the triaged items claim to affect are returned.
+ *
+ * @param issues      - Node holding the current list of triaged items.
+ * @param fullTaskSet - Optional node (or plain array) of all known task IDs.
+ *                      When provided, output is the intersection.
+ */
+declare function affectedTaskFilter(issues: Node<readonly TriagedItem[]>, fullTaskSet?: Node<readonly string[]> | readonly string[]): Node<string[]>;
+/** A single lint error emitted by a CI tool. */
+interface LintError {
+    file: string;
+    line: number;
+    col: number;
+    rule: string;
+    message: string;
+}
+/** A single test failure emitted by a test runner. */
+interface TestFailure {
+    testId: string;
+    file: string;
+    message: string;
+}
+/** Structured code-change / CI event. */
+interface CodeChange {
+    /** Files touched by the change. */
+    files: string[];
+    lintErrors?: LintError[];
+    testFailures?: TestFailure[];
+}
+/** Options for {@link codeChangeBridge}. */
+interface CodeChangeBridgeOptions {
+    /** Name for the effect node (default "code-change-bridge"). */
+    name?: string;
+    /** Default severity for generated IntakeItems (default "high"). */
+    defaultSeverity?: Severity;
+}
+/**
+ * Intake bridge for code-change / CI events.
+ *
+ * Watches a source node for `CodeChange` events and publishes one
+ * `IntakeItem` per lint error and per test failure to the intake topic.
+ * Pass a custom `parser` to override the default mapping.
+ *
+ * @param source      - Node emitting CodeChange events.
+ * @param intakeTopic - TopicGraph to publish IntakeItem entries to.
+ * @param parser      - Optional custom parser (overrides default).
+ * @param opts        - Optional configuration.
+ */
+declare function codeChangeBridge(source: Node<CodeChange>, intakeTopic: TopicGraph<IntakeItem>, parser?: (change: CodeChange) => IntakeItem[], opts?: CodeChangeBridgeOptions): Node<unknown>;
+/** Transport function for {@link notifyEffect}. Sync or async. */
+type NotifyTransport<T> = (item: T) => void | Promise<void>;
+/** Options for {@link notifyEffect}. */
+interface NotifyEffectOptions {
+    /** Name for the effect node (default "notify-effect"). */
+    name?: string;
+}
+/**
+ * Effect node that sends each new topic entry to an external channel.
+ *
+ * The `transport` function is called for every item published to `topic`.
+ * Async transports are bridged via `fromAny` (spec §5.10 compliant).
+ *
+ * Typical use: Slack webhook, GitHub PR comment, email notification, etc.
+ * The factory provides reactive wiring; the transport supplies domain logic.
+ *
+ * ```ts
+ * notifyEffect(alertQueue, async (item) => {
+ *   await fetch(SLACK_WEBHOOK, { method: 'POST', body: JSON.stringify({ text: item.summary }) });
+ * });
+ * ```
+ *
+ * @param topic     - TopicGraph whose latest entry triggers the notification.
+ * @param transport - Called with each new item. May return a Promise.
+ * @param opts      - Optional configuration.
+ */
+declare function notifyEffect<T>(topic: TopicGraph<T>, transport: NotifyTransport<T>, opts?: NotifyEffectOptions): Node<unknown>;
 
 /**
  * Strategy model and priority scoring (roadmap §9.0).
@@ -2735,14 +2941,18 @@ declare function harnessTrace(harness: HarnessGraph, opts?: HarnessTraceOptions)
  * @module
  */
 
+type index$1_CodeChange = CodeChange;
+type index$1_CodeChangeBridgeOptions = CodeChangeBridgeOptions;
 declare const index$1_DEFAULT_DECAY_RATE: typeof DEFAULT_DECAY_RATE;
 declare const index$1_DEFAULT_QUEUE_CONFIGS: typeof DEFAULT_QUEUE_CONFIGS;
 declare const index$1_DEFAULT_SEVERITY_WEIGHTS: typeof DEFAULT_SEVERITY_WEIGHTS;
 type index$1_ErrorClass = ErrorClass;
 type index$1_ErrorClassifier = ErrorClassifier;
+type index$1_EvalDelta = EvalDelta;
 type index$1_EvalIntakeBridgeOptions = EvalIntakeBridgeOptions;
 type index$1_EvalJudgeScore = EvalJudgeScore;
 type index$1_EvalResult = EvalResult;
+type index$1_EvalTaskDelta = EvalTaskDelta;
 type index$1_EvalTaskResult = EvalTaskResult;
 type index$1_ExecuteOutput = ExecuteOutput;
 type index$1_ExecutionResult = ExecutionResult;
@@ -2752,9 +2962,13 @@ type index$1_HarnessLoopOptions = HarnessLoopOptions;
 type index$1_HarnessProfileResult = HarnessProfileResult;
 type index$1_HarnessTraceHandle = HarnessTraceHandle;
 type index$1_HarnessTraceOptions = HarnessTraceOptions;
+type index$1_IntakeBridgeOptions = IntakeBridgeOptions;
 type index$1_IntakeItem = IntakeItem;
 type index$1_IntakeSource = IntakeSource;
 type index$1_Intervention = Intervention;
+type index$1_LintError = LintError;
+type index$1_NotifyEffectOptions = NotifyEffectOptions;
+type index$1_NotifyTransport<T> = NotifyTransport<T>;
 type index$1_PrioritySignals = PrioritySignals;
 declare const index$1_QUEUE_NAMES: typeof QUEUE_NAMES;
 type index$1_QueueConfig = QueueConfig;
@@ -2765,21 +2979,28 @@ type index$1_StrategyEntry = StrategyEntry;
 type index$1_StrategyKey = StrategyKey;
 type index$1_StrategyModelBundle = StrategyModelBundle;
 type index$1_StrategySnapshot = StrategySnapshot;
+type index$1_TestFailure = TestFailure;
 type index$1_TraceDetail = TraceDetail;
 type index$1_TraceEvent = TraceEvent;
 type index$1_TraceEventType = TraceEventType;
 type index$1_TriagedItem = TriagedItem;
 type index$1_VerifyResult = VerifyResult;
+declare const index$1_affectedTaskFilter: typeof affectedTaskFilter;
+declare const index$1_beforeAfterCompare: typeof beforeAfterCompare;
+declare const index$1_codeChangeBridge: typeof codeChangeBridge;
+declare const index$1_createIntakeBridge: typeof createIntakeBridge;
 declare const index$1_defaultErrorClassifier: typeof defaultErrorClassifier;
 declare const index$1_evalIntakeBridge: typeof evalIntakeBridge;
+declare const index$1_evalSource: typeof evalSource;
 declare const index$1_harnessLoop: typeof harnessLoop;
 declare const index$1_harnessProfile: typeof harnessProfile;
 declare const index$1_harnessTrace: typeof harnessTrace;
+declare const index$1_notifyEffect: typeof notifyEffect;
 declare const index$1_priorityScore: typeof priorityScore;
 declare const index$1_strategyKey: typeof strategyKey;
 declare const index$1_strategyModel: typeof strategyModel;
 declare namespace index$1 {
-  export { index$1_DEFAULT_DECAY_RATE as DEFAULT_DECAY_RATE, index$1_DEFAULT_QUEUE_CONFIGS as DEFAULT_QUEUE_CONFIGS, index$1_DEFAULT_SEVERITY_WEIGHTS as DEFAULT_SEVERITY_WEIGHTS, type index$1_ErrorClass as ErrorClass, type index$1_ErrorClassifier as ErrorClassifier, type index$1_EvalIntakeBridgeOptions as EvalIntakeBridgeOptions, type index$1_EvalJudgeScore as EvalJudgeScore, type index$1_EvalResult as EvalResult, type index$1_EvalTaskResult as EvalTaskResult, type index$1_ExecuteOutput as ExecuteOutput, type index$1_ExecutionResult as ExecutionResult, index$1_HarnessGraph as HarnessGraph, type index$1_HarnessLoopOptions as HarnessLoopOptions, type index$1_HarnessProfileResult as HarnessProfileResult, type index$1_HarnessTraceHandle as HarnessTraceHandle, type index$1_HarnessTraceOptions as HarnessTraceOptions, type index$1_IntakeItem as IntakeItem, type index$1_IntakeSource as IntakeSource, type index$1_Intervention as Intervention, type index$1_PrioritySignals as PrioritySignals, index$1_QUEUE_NAMES as QUEUE_NAMES, type index$1_QueueConfig as QueueConfig, type index$1_QueueRoute as QueueRoute, type index$1_RootCause as RootCause, type index$1_Severity as Severity, type index$1_StrategyEntry as StrategyEntry, type index$1_StrategyKey as StrategyKey, type index$1_StrategyModelBundle as StrategyModelBundle, type index$1_StrategySnapshot as StrategySnapshot, type index$1_TraceDetail as TraceDetail, type index$1_TraceEvent as TraceEvent, type index$1_TraceEventType as TraceEventType, type index$1_TriagedItem as TriagedItem, type index$1_VerifyResult as VerifyResult, index$1_defaultErrorClassifier as defaultErrorClassifier, index$1_evalIntakeBridge as evalIntakeBridge, index$1_harnessLoop as harnessLoop, index$1_harnessProfile as harnessProfile, index$1_harnessTrace as harnessTrace, index$1_priorityScore as priorityScore, index$1_strategyKey as strategyKey, index$1_strategyModel as strategyModel };
+  export { type index$1_CodeChange as CodeChange, type index$1_CodeChangeBridgeOptions as CodeChangeBridgeOptions, index$1_DEFAULT_DECAY_RATE as DEFAULT_DECAY_RATE, index$1_DEFAULT_QUEUE_CONFIGS as DEFAULT_QUEUE_CONFIGS, index$1_DEFAULT_SEVERITY_WEIGHTS as DEFAULT_SEVERITY_WEIGHTS, type index$1_ErrorClass as ErrorClass, type index$1_ErrorClassifier as ErrorClassifier, type index$1_EvalDelta as EvalDelta, type index$1_EvalIntakeBridgeOptions as EvalIntakeBridgeOptions, type index$1_EvalJudgeScore as EvalJudgeScore, type index$1_EvalResult as EvalResult, type index$1_EvalTaskDelta as EvalTaskDelta, type index$1_EvalTaskResult as EvalTaskResult, type index$1_ExecuteOutput as ExecuteOutput, type index$1_ExecutionResult as ExecutionResult, index$1_HarnessGraph as HarnessGraph, type index$1_HarnessLoopOptions as HarnessLoopOptions, type index$1_HarnessProfileResult as HarnessProfileResult, type index$1_HarnessTraceHandle as HarnessTraceHandle, type index$1_HarnessTraceOptions as HarnessTraceOptions, type index$1_IntakeBridgeOptions as IntakeBridgeOptions, type index$1_IntakeItem as IntakeItem, type index$1_IntakeSource as IntakeSource, type index$1_Intervention as Intervention, type index$1_LintError as LintError, type index$1_NotifyEffectOptions as NotifyEffectOptions, type index$1_NotifyTransport as NotifyTransport, type index$1_PrioritySignals as PrioritySignals, index$1_QUEUE_NAMES as QUEUE_NAMES, type index$1_QueueConfig as QueueConfig, type index$1_QueueRoute as QueueRoute, type index$1_RootCause as RootCause, type index$1_Severity as Severity, type index$1_StrategyEntry as StrategyEntry, type index$1_StrategyKey as StrategyKey, type index$1_StrategyModelBundle as StrategyModelBundle, type index$1_StrategySnapshot as StrategySnapshot, type index$1_TestFailure as TestFailure, type index$1_TraceDetail as TraceDetail, type index$1_TraceEvent as TraceEvent, type index$1_TraceEventType as TraceEventType, type index$1_TriagedItem as TriagedItem, type index$1_VerifyResult as VerifyResult, index$1_affectedTaskFilter as affectedTaskFilter, index$1_beforeAfterCompare as beforeAfterCompare, index$1_codeChangeBridge as codeChangeBridge, index$1_createIntakeBridge as createIntakeBridge, index$1_defaultErrorClassifier as defaultErrorClassifier, index$1_evalIntakeBridge as evalIntakeBridge, index$1_evalSource as evalSource, index$1_harnessLoop as harnessLoop, index$1_harnessProfile as harnessProfile, index$1_harnessTrace as harnessTrace, index$1_notifyEffect as notifyEffect, index$1_priorityScore as priorityScore, index$1_strategyKey as strategyKey, index$1_strategyModel as strategyModel };
 }
 
 /**
@@ -2937,9 +3158,52 @@ type ScorerOptions = Omit<NodeOptions, "describeKind" | "name" | "meta"> & {
  * @category patterns
  */
 declare function scorer(sources: ReadonlyArray<Node<number>>, weights: ReadonlyArray<Node<number>>, opts?: ScorerOptions): Node<ScoredItem<number[]>>;
+/** A single effectiveness record for an action×context pair. */
+type EffectivenessEntry = {
+    readonly key: string;
+    readonly attempts: number;
+    readonly successes: number;
+    readonly successRate: number;
+};
+/** Snapshot shape for the effectiveness tracker node. */
+type EffectivenessSnapshot = ReadonlyMap<string, EffectivenessEntry>;
+/** Bundle returned by {@link effectivenessTracker}. */
+interface EffectivenessTrackerBundle {
+    /** Reactive node — current effectiveness map snapshot. */
+    readonly node: Node<EffectivenessSnapshot>;
+    /** Record a completed action (success or failure). */
+    record(key: string, success: boolean): void;
+    /** Look up effectiveness for a specific key. */
+    lookup(key: string): EffectivenessEntry | undefined;
+    /** Tear down internal keepalive subscriptions. */
+    dispose(): void;
+}
+/** Options for {@link effectivenessTracker}. */
+type EffectivenessTrackerOptions = {
+    /** Name for the reactive map (default "effectiveness-entries"). */
+    name?: string;
+};
+/**
+ * Generic action×context → success rate tracker.
+ *
+ * Generalized from the harness `strategyModel` pattern. Tracks attempts and
+ * successes per string key, exposes a reactive snapshot node, and provides
+ * `record()` / `lookup()` methods.
+ *
+ * Use cases: A/B testing, routing optimization, cache policy tuning, retry
+ * strategy selection — any domain that tracks effectiveness per action.
+ *
+ * @param opts - Optional configuration.
+ * @returns Bundle with reactive node, record(), lookup(), dispose().
+ */
+declare function effectivenessTracker(opts?: EffectivenessTrackerOptions): EffectivenessTrackerBundle;
 
 type reduction_BudgetConstraint<T = unknown> = BudgetConstraint<T>;
 type reduction_BudgetGateOptions = BudgetGateOptions;
+type reduction_EffectivenessEntry = EffectivenessEntry;
+type reduction_EffectivenessSnapshot = EffectivenessSnapshot;
+type reduction_EffectivenessTrackerBundle = EffectivenessTrackerBundle;
+type reduction_EffectivenessTrackerOptions = EffectivenessTrackerOptions;
 type reduction_FeedbackOptions = FeedbackOptions;
 type reduction_FunnelOptions = FunnelOptions;
 type reduction_FunnelStage = FunnelStage;
@@ -2949,12 +3213,13 @@ type reduction_StepRef = StepRef;
 type reduction_StratifyOptions = StratifyOptions;
 type reduction_StratifyRule<T> = StratifyRule<T>;
 declare const reduction_budgetGate: typeof budgetGate;
+declare const reduction_effectivenessTracker: typeof effectivenessTracker;
 declare const reduction_feedback: typeof feedback;
 declare const reduction_funnel: typeof funnel;
 declare const reduction_scorer: typeof scorer;
 declare const reduction_stratify: typeof stratify;
 declare namespace reduction {
-  export { type reduction_BudgetConstraint as BudgetConstraint, type reduction_BudgetGateOptions as BudgetGateOptions, type reduction_FeedbackOptions as FeedbackOptions, type reduction_FunnelOptions as FunnelOptions, type reduction_FunnelStage as FunnelStage, type reduction_ScoredItem as ScoredItem, type reduction_ScorerOptions as ScorerOptions, type reduction_StepRef as StepRef, type reduction_StratifyOptions as StratifyOptions, type reduction_StratifyRule as StratifyRule, reduction_budgetGate as budgetGate, reduction_feedback as feedback, reduction_funnel as funnel, reduction_scorer as scorer, reduction_stratify as stratify };
+  export { type reduction_BudgetConstraint as BudgetConstraint, type reduction_BudgetGateOptions as BudgetGateOptions, type reduction_EffectivenessEntry as EffectivenessEntry, type reduction_EffectivenessSnapshot as EffectivenessSnapshot, type reduction_EffectivenessTrackerBundle as EffectivenessTrackerBundle, type reduction_EffectivenessTrackerOptions as EffectivenessTrackerOptions, type reduction_FeedbackOptions as FeedbackOptions, type reduction_FunnelOptions as FunnelOptions, type reduction_FunnelStage as FunnelStage, type reduction_ScoredItem as ScoredItem, type reduction_ScorerOptions as ScorerOptions, type reduction_StepRef as StepRef, type reduction_StratifyOptions as StratifyOptions, type reduction_StratifyRule as StratifyRule, reduction_budgetGate as budgetGate, reduction_effectivenessTracker as effectivenessTracker, reduction_feedback as feedback, reduction_funnel as funnel, reduction_scorer as scorer, reduction_stratify as stratify };
 }
 
 /**