@graphrefly/graphrefly 0.19.0 → 0.20.0

package/dist/index.cjs

@@ -196,6 +196,7 @@ __export(index_exports, {
   isTerminalMessage: () => isTerminalMessage,
   isV1: () => isV1,
   jotai: () => jotai_exports,
+  keepalive: () => keepalive,
   knownMessageTypes: () => knownMessageTypes,
   last: () => last,
   layout: () => reactive_layout_exports,
@@ -238,6 +239,7 @@ __export(index_exports, {
   rateLimiter: () => rateLimiter,
   reachable: () => reachable,
   react: () => react_exports,
+  reactiveCounter: () => reactiveCounter,
   reactiveIndex: () => reactiveIndex,
   reactiveList: () => reactiveList,
   reactiveLog: () => reactiveLog,
@@ -1845,8 +1847,8 @@ function producer(fn, opts) {
 function derived(deps, fn, opts) {
   return node(deps, fn, { describeKind: "derived", ...opts });
 }
-function effect(deps, fn) {
-  return node(deps, fn, { describeKind: "effect" });
+function effect(deps, fn, opts) {
+  return node(deps, fn, { describeKind: "effect", ...opts });
 }
 function pipe(source, ...ops) {
   let current = source;
@@ -2842,6 +2844,28 @@ function firstWhere(source, predicate) {
   });
 }
 var shareReplay = replay;
+function keepalive(n) {
+  return n.subscribe(() => {
+  });
+}
+function reactiveCounter(cap) {
+  const counter = state(0);
+  return {
+    node: counter,
+    increment() {
+      const current = counter.get() ?? 0;
+      if (current >= cap) return false;
+      counter.down([[DIRTY], [DATA, current + 1]]);
+      return true;
+    },
+    get() {
+      return counter.get() ?? 0;
+    },
+    atCap() {
+      return (counter.get() ?? 0) >= cap;
+    }
+  };
+}
 
 // src/compat/nestjs/explorer.ts
 var scheduleSeq = 0;
@@ -6069,6 +6093,18 @@ function replayWAL(entries) {
   return result;
 }
 
+// src/patterns/_internal.ts
+function domainMeta(domain, kind, extra) {
+  return {
+    [domain]: true,
+    [`${domain}_type`]: kind,
+    ...extra ?? {}
+  };
+}
+function trackingKey(item) {
+  return item.relatedTo?.[0] ?? item.summary;
+}
+
 // src/patterns/cqrs.ts
 var COMMAND_GUARD = policy((allow, deny) => {
   allow("write");
@@ -6086,11 +6122,7 @@ var EVENT_GUARD = policy((allow, deny) => {
   deny("write");
 });
 function cqrsMeta(kind, extra) {
-  return { cqrs: true, cqrs_type: kind, ...extra ?? {} };
-}
-function keepalive(n) {
-  return n.subscribe(() => {
-  });
+  return domainMeta("cqrs", kind, extra);
 }
 var MemoryEventStore = class {
   _store = /* @__PURE__ */ new Map();
@@ -7150,6 +7182,7 @@ __export(extra_exports, {
   fromWebhook: () => fromWebhook,
   globToRegExp: () => globToRegExp,
   interval: () => interval,
+  keepalive: () => keepalive,
   last: () => last,
   linear: () => linear,
   logSlice: () => logSlice,
@@ -7171,6 +7204,7 @@ __export(extra_exports, {
   pubsub: () => pubsub,
   race: () => race,
   rateLimiter: () => rateLimiter,
+  reactiveCounter: () => reactiveCounter,
   reactiveIndex: () => reactiveIndex,
   reactiveList: () => reactiveList,
   reactiveLog: () => reactiveLog,
@@ -13572,16 +13606,8 @@ function requireNonNegativeInt(value, label) {
   }
   return value;
 }
-function keepalive3(n) {
-  return n.subscribe(() => {
-  });
-}
 function messagingMeta(kind, extra) {
-  return {
-    messaging: true,
-    messaging_type: kind,
-    ...extra ?? {}
-  };
+  return domainMeta("messaging", kind, extra);
 }
 var TopicGraph = class extends Graph {
   _log;
@@ -13607,7 +13633,7 @@ var TopicGraph = class extends Graph {
     );
     this.add("latest", this.latest);
     this.connect("events", "latest");
-    this.addDisposer(keepalive3(this.latest));
+    this.addDisposer(keepalive(this.latest));
   }
   publish(value) {
     this._log.append(value);
@@ -13656,8 +13682,8 @@ var SubscriptionGraph = class extends Graph {
     this.connect("topic::events", "source");
     this.connect("source", "available");
     this.connect("cursor", "available");
-    this.addDisposer(keepalive3(this.source));
-    this.addDisposer(keepalive3(this.available));
+    this.addDisposer(keepalive(this.source));
+    this.addDisposer(keepalive(this.available));
   }
   ack(count) {
     const available = this.available.get();
@@ -13699,7 +13725,7 @@ var JobQueueGraph = class extends Graph {
     });
     this.add("depth", this.depth);
     this.connect("pending", "depth");
-    this.addDisposer(keepalive3(this.depth));
+    this.addDisposer(keepalive(this.depth));
   }
   enqueue(payload, opts = {}) {
     const id = opts.id ?? `${this.name}-${++this._seq}`;
@@ -13792,7 +13818,7 @@ var JobFlowGraph = class extends Graph {
     );
     this.add("completedCount", this.completedCount);
     this.connect("completed", "completedCount");
-    this.addDisposer(keepalive3(this.completedCount));
+    this.addDisposer(keepalive(this.completedCount));
     const maxPerPump = Math.max(
       1,
       requireNonNegativeInt(opts.maxPerPump ?? DEFAULT_MAX_PER_PUMP, "job flow maxPerPump")
@@ -13832,7 +13858,7 @@ var JobFlowGraph = class extends Graph {
       );
       this.add(`pump_${stage}`, pump);
       this.connect(`${stage}::pending`, `pump_${stage}`);
-      this.addDisposer(keepalive3(pump));
+      this.addDisposer(keepalive(pump));
     }
   }
   stages() {
@@ -13897,7 +13923,7 @@ var TopicBridgeGraph = class extends Graph {
     );
     this.add("pump", pump);
     this.connect("subscription::available", "pump");
-    this.addDisposer(keepalive3(pump));
+    this.addDisposer(keepalive(pump));
   }
 };
 function topic(name, opts) {
@@ -13964,11 +13990,7 @@ function registerStep(graph, name, step, depPaths) {
   }
 }
 function baseMeta(kind, meta) {
-  return {
-    orchestration: true,
-    orchestration_type: kind,
-    ...meta ?? {}
-  };
+  return domainMeta("orchestration", kind, meta);
 }
 function coerceLoopIterations(raw) {
   const parseString = (value) => {
@@ -14414,14 +14436,7 @@ function onFailure(graph, name, source, recover, opts) {
 
 // src/patterns/ai.ts
 function aiMeta(kind, extra) {
-  return {
-    ai: true,
-    ai_type: kind,
-    ...extra ?? {}
-  };
-}
-function keepalive4(n) {
-  return n.subscribe(() => void 0);
+  return domainMeta("ai", kind, extra);
 }
 function isPromiseLike(x) {
   return x != null && typeof x.then === "function";
@@ -14555,7 +14570,7 @@ function streamingPromptNode(adapter, deps, prompt, opts) {
     }
     return fromAny(pumpAndCollect());
   });
-  const unsub = keepalive4(output);
+  const unsub = keepalive(output);
   return {
     output,
     stream: streamTopic,
@@ -14740,7 +14755,7 @@ function gatedStream(graph, name, adapter, deps, prompt, opts) {
     }
     return fromAny(pumpAndCollect());
   });
-  const unsub = keepalive4(output);
+  const unsub = keepalive(output);
   const nonNullOutput = derived(
     [output],
     ([v]) => {
@@ -14871,7 +14886,7 @@ var ChatStreamGraph = class extends Graph {
     );
     this.add("latest", this.latest);
     this.connect("messages", "latest");
-    this.addDisposer(keepalive4(this.latest));
+    this.addDisposer(keepalive(this.latest));
     this.messageCount = derived(
       [this.messages],
       ([snapshot]) => snapshot.length,
@@ -14884,7 +14899,7 @@ var ChatStreamGraph = class extends Graph {
     );
     this.add("messageCount", this.messageCount);
     this.connect("messages", "messageCount");
-    this.addDisposer(keepalive4(this.messageCount));
+    this.addDisposer(keepalive(this.messageCount));
   }
   append(role, content, extra) {
     this._log.append({ role, content, ...extra });
@@ -14925,7 +14940,7 @@ var ToolRegistryGraph = class extends Graph {
     );
     this.add("schemas", this.schemas);
     this.connect("definitions", "schemas");
-    this.addDisposer(keepalive4(this.schemas));
+    this.addDisposer(keepalive(this.schemas));
   }
   register(tool) {
     const current = this.definitions.get();
@@ -14967,7 +14982,7 @@ function systemPromptBuilder(sections, opts) {
       initial: ""
     }
   );
-  const unsub = keepalive4(prompt);
+  const unsub = keepalive(prompt);
   return Object.assign(prompt, { dispose: unsub });
 }
 function llmExtractor(systemPrompt, opts) {
@@ -16856,21 +16871,14 @@ __export(domain_templates_exports, {
 var reduction_exports = {};
 __export(reduction_exports, {
   budgetGate: () => budgetGate,
+  effectivenessTracker: () => effectivenessTracker,
   feedback: () => feedback,
   funnel: () => funnel,
   scorer: () => scorer,
   stratify: () => stratify
 });
 function baseMeta2(kind, meta) {
-  return {
-    reduction: true,
-    reduction_type: kind,
-    ...meta ?? {}
-  };
-}
-function keepalive5(n) {
-  return n.subscribe(() => {
-  });
+  return domainMeta("reduction", kind, meta);
 }
 function stratify(name, source, rules, opts) {
   const g = new Graph(name, opts);
@@ -17008,7 +17016,7 @@ function funnel(name, sources, stages, opts) {
     });
     g.add(bridgeName, br);
     g.connect(prevOutputPath, bridgeName);
-    g.addDisposer(keepalive5(br));
+    g.addDisposer(keepalive(br));
     prevOutputPath = `${stage.name}::output`;
   }
   return g;
@@ -17060,7 +17068,7 @@ function feedback(graph, condition, reentry, opts) {
   });
   graph.add(feedbackEffectName, feedbackEffect);
   graph.connect(condition, feedbackEffectName);
-  graph.addDisposer(keepalive5(feedbackEffect));
+  graph.addDisposer(keepalive(feedbackEffect));
   return graph;
 }
 function budgetGate(source, constraints, opts) {
@@ -17194,14 +17202,55 @@ function scorer(sources, weights, opts) {
     }
   );
 }
-
-// src/patterns/domain-templates.ts
-function keepalive6(n) {
-  return n.subscribe(() => {
+function effectivenessTracker(opts) {
+  const _map = reactiveMap({
+    name: opts?.name ?? "effectiveness-entries"
   });
+  const snapshot = derived(
+    [_map.entries],
+    ([mapSnap]) => {
+      return new Map(mapSnap);
+    },
+    {
+      name: `${opts?.name ?? "effectiveness"}-snapshot`,
+      equals: (a, b) => {
+        const am = a;
+        const bm = b;
+        if (am.size !== bm.size) return false;
+        for (const [k, v] of am) {
+          const bv = bm.get(k);
+          if (!bv || v.attempts !== bv.attempts || v.successes !== bv.successes) return false;
+        }
+        return true;
+      }
+    }
+  );
+  function record(key, success) {
+    const existing = _map.get(key);
+    const attempts = (existing?.attempts ?? 0) + 1;
+    const successes = (existing?.successes ?? 0) + (success ? 1 : 0);
+    _map.set(key, {
+      key,
+      attempts,
+      successes,
+      successRate: successes / attempts
+    });
+  }
+  function lookup(key) {
+    return _map.get(key);
+  }
+  const _unsub = keepalive(snapshot);
+  return {
+    node: snapshot,
+    record,
+    lookup,
+    dispose: () => _unsub()
+  };
 }
+
+// src/patterns/domain-templates.ts
 function baseMeta3(kind, extra) {
-  return { domain_template: true, template_type: kind, ...extra ?? {} };
+  return domainMeta("domain_template", kind, extra);
 }
 function observabilityGraph(name, opts) {
   const g = new Graph(name, opts);
@@ -17441,7 +17490,7 @@ function contentModerationGraph(name, opts) {
     }
   });
   g.add("__review_accumulator", reviewAccumulator);
-  g.addDisposer(keepalive6(reviewAccumulator));
+  g.addDisposer(keepalive(reviewAccumulator));
   try {
     g.connect("stratify::branch/review", "__review_accumulator");
   } catch {
@@ -17552,7 +17601,7 @@ function dataQualityGraph(name, opts) {
   });
   g.add("__baseline_updater", baselineUpdater);
   g.connect("validate", "__baseline_updater");
-  keepalive6(baselineUpdater);
+  keepalive(baselineUpdater);
   const detectDriftFn = opts.detectDrift ?? (() => ({ drift: false }));
   const driftNode = derived(
     [opts.source, baseline],
@@ -18642,6 +18691,7 @@ __export(harness_exports, {
   DEFAULT_SEVERITY_WEIGHTS: () => DEFAULT_SEVERITY_WEIGHTS,
   HarnessGraph: () => HarnessGraph,
   QUEUE_NAMES: () => QUEUE_NAMES,
+  createIntakeBridge: () => createIntakeBridge,
   defaultErrorClassifier: () => defaultErrorClassifier,
   evalIntakeBridge: () => evalIntakeBridge,
   harnessLoop: () => harnessLoop,
@@ -18653,41 +18703,58 @@ __export(harness_exports, {
 });
 
 // src/patterns/harness/bridge.ts
+function createIntakeBridge(source, intakeTopic, parser, opts) {
+  return effect(
+    [source],
+    ([value]) => {
+      if (value == null) return;
+      const items = parser(value);
+      for (const item of items) {
+        intakeTopic.publish(item);
+      }
+    },
+    { name: opts?.name ?? "intake-bridge" }
+  );
+}
 function evalIntakeBridge(evalSource, intakeTopic, opts) {
   const defaultSeverity = opts?.defaultSeverity ?? "medium";
-  return effect([evalSource], ([results]) => {
-    if (results == null) return;
-    const runs = Array.isArray(results) ? results : [results];
-    for (const run of runs) {
-      for (const task2 of run.tasks) {
-        if (task2.valid && task2.judge_scores?.every((s) => s.pass)) continue;
-        if (!task2.valid && (!task2.judge_scores || task2.judge_scores.length === 0)) {
-          intakeTopic.publish({
-            source: "eval",
-            summary: `Task ${task2.task_id} invalid (model: ${run.model})`,
-            evidence: `Run ${run.run_id}: task produced invalid output`,
-            affectsAreas: ["graphspec"],
-            affectsEvalTasks: [task2.task_id],
-            severity: defaultSeverity
-          });
-          continue;
-        }
-        if (task2.judge_scores) {
-          for (const score of task2.judge_scores) {
-            if (score.pass) continue;
+  return effect(
+    [evalSource],
+    ([results]) => {
+      if (results == null) return;
+      const runs = Array.isArray(results) ? results : [results];
+      for (const run of runs) {
+        for (const task2 of run.tasks) {
+          if (task2.valid && task2.judge_scores?.every((s) => s.pass)) continue;
+          if (!task2.valid && (!task2.judge_scores || task2.judge_scores.length === 0)) {
             intakeTopic.publish({
               source: "eval",
-              summary: `${task2.task_id}: ${score.claim} (model: ${run.model})`,
-              evidence: score.reasoning,
+              summary: `Task ${task2.task_id} invalid (model: ${run.model})`,
+              evidence: `Run ${run.run_id}: task produced invalid output`,
               affectsAreas: ["graphspec"],
               affectsEvalTasks: [task2.task_id],
               severity: defaultSeverity
             });
+            continue;
+          }
+          if (task2.judge_scores) {
+            for (const score of task2.judge_scores) {
+              if (score.pass) continue;
+              intakeTopic.publish({
+                source: "eval",
+                summary: `${task2.task_id}: ${score.claim} (model: ${run.model})`,
+                evidence: score.reasoning,
+                affectsAreas: ["graphspec"],
+                affectsEvalTasks: [task2.task_id],
+                severity: defaultSeverity
+              });
+            }
           }
         }
       }
-    }
-  });
+    },
+    { name: opts?.name ?? "eval-intake-bridge" }
+  );
 }
 
 // src/patterns/harness/types.ts
@@ -18797,9 +18864,6 @@ function priorityScore(item, strategy, lastInteractionNs, urgency, signals) {
 }
 
 // src/patterns/harness/loop.ts
-function trackingKey(item) {
-  return item.relatedTo?.[0] ?? item.summary;
-}
 var DEFAULT_TRIAGE_PROMPT = `You are a triage classifier for a reactive collaboration harness.
 
 Given an intake item, classify it and output JSON:
@@ -19806,6 +19870,7 @@ var version = "0.0.0";
   isTerminalMessage,
   isV1,
   jotai,
+  keepalive,
   knownMessageTypes,
   last,
   layout,
@@ -19848,6 +19913,7 @@ var version = "0.0.0";
   rateLimiter,
   reachable,
   react,
+  reactiveCounter,
   reactiveIndex,
   reactiveList,
   reactiveLog,