@graphrefly/graphrefly 0.47.1 → 0.48.0

package/dist/utils/ai/index.cjs

@@ -202,6 +202,7 @@ __export(ai_exports, {
   tier: () => tier,
   toolCallExtractor: () => toolCallExtractor,
   toolExecution: () => toolExecution,
+  toolInterceptor: () => toolInterceptor,
   toolRegistry: () => toolRegistry,
   toolSelector: () => toolSelector,
   validateGraphDef: () => validateGraphDef,
@@ -2606,9 +2607,11 @@ function _retrySource(source, opts, emitState) {
       const merged = makeMergedOptsMirror(opts);
       const getCfg = () => resolveRetryConfig(merged.current());
       const inner = _runRetryStateMachine(getCfg, () => source, a, emitState);
-      return () => {
-        inner();
-        merged.unsub();
+      return {
+        onDeactivation: () => {
+          inner();
+          merged.unsub();
+        }
       };
     },
     {
@@ -2632,9 +2635,11 @@ function _retryFactory(factory, opts, emitState) {
       const merged = makeMergedOptsMirror(opts);
       const getCfg = () => resolveRetryConfig(merged.current());
       const inner = _runRetryStateMachine(getCfg, factory, a, emitState);
-      return () => {
-        inner();
-        merged.unsub();
+      return {
+        onDeactivation: () => {
+          inner();
+          merged.unsub();
+        }
       };
     },
     {
@@ -4171,8 +4176,10 @@ function promptNode(adapter, deps, prompt, opts) {
           } catch (err) {
             done = true;
             actions.down([[import_core23.ERROR, err]]);
-            return () => {
-              abortDispose?.();
+            return {
+              onDeactivation: () => {
+                abortDispose?.();
+              }
             };
           }
           const callNode = (0, import_extra18.fromAny)(invokeResult);
@@ -4230,11 +4237,13 @@ function promptNode(adapter, deps, prompt, opts) {
               }
             }
           });
-          return () => {
-            cancelled = true;
-            sub();
-            abortDispose?.();
-            abortDispose = void 0;
+          return {
+            onDeactivation: () => {
+              cancelled = true;
+              sub();
+              abortDispose?.();
+              abortDispose = void 0;
+            }
           };
         },
         {
@@ -4747,6 +4756,10 @@ var PipelineGraph = class extends import_graph3.Graph {
       {
         name,
         describeKind: "derived",
+        // Spec §2.7 R2.7.1 (DS-2.7.A). fn must fire on
+        // upstream-COMPLETE/ERROR-only-without-DATA so the
+        // teardown-decision record + downstream terminal forward run.
+        terminalAsRealInput: true,
         meta: meta("approval_gate", opts.meta)
       }
     );
@@ -4964,6 +4977,11 @@ var PipelineGraph = class extends import_graph3.Graph {
         describeKind: "derived",
         completeWhenDepsComplete: opts.completeWhenDepsComplete ?? !(mode === "completed" || mode === "terminal"),
         errorWhenDepsError: !(mode === "errored" || mode === "terminal"),
+        // Spec §2.7 R2.7.1 (DS-2.7.A). `catch` exists to fire on a
+        // source terminal — its whole job is `recover(cause, …)` on a
+        // terminal-only wave. Without this opt-in the gate holds and
+        // the recover branch never runs.
+        terminalAsRealInput: true,
         meta: meta("catch", opts.meta)
       }
     );
@@ -5780,9 +5798,83 @@ function executeOne(call, tools, retryCount, onError) {
   }));
 }
 
-// src/utils/ai/agents/tool-registry.ts
+// src/utils/ai/agents/tool-interceptor.ts
 var import_core39 = require("@graphrefly/pure-ts/core");
 var import_extra26 = require("@graphrefly/pure-ts/extra");
+function toolInterceptor(opts = {}) {
+  return (calls) => {
+    const enabledNode = opts.enabled != null ? (0, import_extra26.fromAny)(opts.enabled) : void 0;
+    const predNodes = (opts.allow ?? []).map((p) => (0, import_extra26.fromAny)(p));
+    const deps = [calls, ...enabledNode ? [enabledNode] : [], ...predNodes];
+    return (0, import_core39.node)(
+      deps,
+      (batchData, actions, ctx) => {
+        const callsBatch = batchData[0];
+        if (callsBatch == null || callsBatch.length === 0) {
+          actions.down([[import_core39.RESOLVED]]);
+          return;
+        }
+        const data = batchData.map(
+          (batch8, i) => batch8 != null && batch8.length > 0 ? batch8.at(-1) : ctx.prevData[i]
+        );
+        const incoming = data[0] ?? [];
+        let cursor = 1;
+        if (enabledNode) {
+          const enabled = data[cursor++];
+          if (enabled === false) {
+            actions.down([[import_core39.RESOLVED]]);
+            return;
+          }
+        }
+        const preds = data.slice(cursor);
+        const kept = incoming.filter((call) => {
+          for (const pred of preds) {
+            if (pred == null) continue;
+            try {
+              if (!pred(call)) return false;
+            } catch {
+              return false;
+            }
+          }
+          return true;
+        });
+        if (kept.length === 0) {
+          actions.down([[import_core39.RESOLVED]]);
+          return;
+        }
+        actions.emit(kept);
+      },
+      {
+        name: opts.name ?? "tool-interceptor",
+        describeKind: "derived",
+        // NON-partial (no `partial: true`) — deliberate. A seeded
+        // `enabled`/predicate (with an `initial`) emits on activation,
+        // so it is honoured before any tool call flows (the contract
+        // callers must follow — see `allow` JSDoc). `partial: true`
+        // was tried and REJECTED: it un-gates the node so `calls`
+        // races ahead of a slower seeded policy dep on the activation
+        // wave and leaks denied calls fail-OPEN. A *never-seeded*
+        // (pure SENTINEL) policy has unspecified gating under either
+        // setting — callers must seed an `initial`; not relied on.
+        // Cross-ref `tool-selector.ts` (same non-partial shape).
+        meta: { ...aiMeta("tool_interceptor"), ...(0, import_core39.factoryTag)("toolInterceptor") },
+        equals: (a, b) => {
+          const la = a;
+          const lb = b;
+          if (la.length !== lb.length) return false;
+          for (let i = 0; i < la.length; i++) {
+            if (la[i] !== lb[i]) return false;
+          }
+          return true;
+        }
+      }
+    );
+  };
+}
+
+// src/utils/ai/agents/tool-registry.ts
+var import_core40 = require("@graphrefly/pure-ts/core");
+var import_extra27 = require("@graphrefly/pure-ts/extra");
 var import_graph5 = require("@graphrefly/pure-ts/graph");
 var ToolRegistryGraph = class extends import_graph5.Graph {
   definitions;
@@ -5790,12 +5882,12 @@ var ToolRegistryGraph = class extends import_graph5.Graph {
   _bundle;
   constructor(name, opts = {}) {
     super(name, opts.graph);
-    this._bundle = (0, import_extra26.reactiveMap)({
+    this._bundle = (0, import_extra27.reactiveMap)({
       name: "definitions"
     });
     this.definitions = this._bundle.entries;
     this.add(this.definitions, { name: "definitions" });
-    this.schemas = (0, import_core39.node)(
+    this.schemas = (0, import_core40.node)(
       [this.definitions],
       (batchData, actions, ctx) => {
         const data = batchData.map(
@@ -5812,7 +5904,7 @@ var ToolRegistryGraph = class extends import_graph5.Graph {
       }
     );
     this.add(this.schemas, { name: "schemas" });
-    this.addDisposer((0, import_extra26.keepalive)(this.schemas));
+    this.addDisposer((0, import_extra27.keepalive)(this.schemas));
   }
   register(tool) {
     this._bundle.set(tool.name, tool);
@@ -5847,7 +5939,7 @@ var ToolRegistryGraph = class extends import_graph5.Graph {
   executeReactive(name, args) {
     const tool = this._bundle.get(name);
     if (!tool) throw new Error(`toolRegistry: unknown tool "${name}"`);
-    return (0, import_core39.node)(
+    return (0, import_core40.node)(
       [],
       (_data, actions) => {
         const ac = new AbortController();
@@ -5856,17 +5948,21 @@ var ToolRegistryGraph = class extends import_graph5.Graph {
           const raw = tool.handler(args, { signal: ac.signal });
           inner = handlerResultToNode(raw, ac.signal);
         } catch (err) {
-          actions.down([[import_core39.ERROR, err]]);
-          return () => {
-            ac.abort();
+          actions.down([[import_core40.ERROR, err]]);
+          return {
+            onDeactivation: () => {
+              ac.abort();
+            }
           };
         }
         const unsub = inner.subscribe((batch8) => {
           actions.down(batch8);
         });
-        return () => {
-          ac.abort();
-          unsub();
+        return {
+          onDeactivation: () => {
+            ac.abort();
+            unsub();
+          }
         };
       },
       {
@@ -5888,22 +5984,22 @@ function handlerResultToNode(raw, signal) {
     return raw;
   }
   if (raw != null && typeof raw.then === "function") {
-    return (0, import_extra26.fromPromise)(raw, { signal });
+    return (0, import_extra27.fromPromise)(raw, { signal });
   }
   if (raw != null && typeof raw === "object" && Symbol.asyncIterator in raw) {
-    return (0, import_extra26.fromAsyncIter)(raw, { signal });
+    return (0, import_extra27.fromAsyncIter)(raw, { signal });
   }
-  return (0, import_extra26.fromPromise)(Promise.resolve(raw), { signal });
+  return (0, import_extra27.fromPromise)(Promise.resolve(raw), { signal });
 }
 
 // src/utils/ai/agents/tool-selector.ts
-var import_core40 = require("@graphrefly/pure-ts/core");
-var import_extra27 = require("@graphrefly/pure-ts/extra");
+var import_core41 = require("@graphrefly/pure-ts/core");
+var import_extra28 = require("@graphrefly/pure-ts/extra");
 function toolSelector(allTools, constraints, opts) {
-  const allToolsNode = (0, import_extra27.fromAny)(allTools);
-  const constraintNodes = constraints.map((c) => (0, import_extra27.fromAny)(c));
+  const allToolsNode = (0, import_extra28.fromAny)(allTools);
+  const constraintNodes = constraints.map((c) => (0, import_extra28.fromAny)(c));
   const deps = [allToolsNode, ...constraintNodes];
-  return (0, import_core40.node)(
+  return (0, import_core41.node)(
     deps,
     (batchData, actions, ctx) => {
       const data = batchData.map(
@@ -5924,7 +6020,7 @@ function toolSelector(allTools, constraints, opts) {
     {
       name: opts?.name ?? "tool-selector",
       describeKind: "derived",
-      meta: { ...aiMeta("tool_selector"), ...(0, import_core40.factoryTag)("toolSelector") },
+      meta: { ...aiMeta("tool_selector"), ...(0, import_core41.factoryTag)("toolSelector") },
       equals: (a, b) => {
         const la = a;
         const lb = b;
@@ -5971,20 +6067,20 @@ function admissionFilter3D(opts) {
 }
 
 // src/utils/ai/memory/memory-composers.ts
-var import_core44 = require("@graphrefly/pure-ts/core");
-var import_extra32 = require("@graphrefly/pure-ts/extra");
+var import_core45 = require("@graphrefly/pure-ts/core");
+var import_extra33 = require("@graphrefly/pure-ts/extra");
 var import_graph7 = require("@graphrefly/pure-ts/graph");
 
 // src/base/composition/distill.ts
-var import_core42 = require("@graphrefly/pure-ts/core");
-var import_extra30 = require("@graphrefly/pure-ts/extra");
+var import_core43 = require("@graphrefly/pure-ts/core");
+var import_extra31 = require("@graphrefly/pure-ts/extra");
 
 // src/base/sources/async.ts
-var import_core41 = require("@graphrefly/pure-ts/core");
-var import_extra28 = require("@graphrefly/pure-ts/extra");
+var import_core42 = require("@graphrefly/pure-ts/core");
 var import_extra29 = require("@graphrefly/pure-ts/extra");
+var import_extra30 = require("@graphrefly/pure-ts/extra");
 function forEach(source, fn, opts) {
-  const inner = (0, import_core41.node)(
+  const inner = (0, import_core42.node)(
     [source],
     (data, _actions) => {
       const batch0 = data[0];
@@ -6002,8 +6098,8 @@ function forEach(source, fn, opts) {
 function isNodeLike2(value) {
   return typeof value === "object" && value !== null && "cache" in value && typeof value.subscribe === "function";
 }
-function keepalive9(node38) {
-  node38.subscribe(() => void 0);
+function keepalive9(node39) {
+  node39.subscribe(() => void 0);
 }
 function mapFromSnapshot(snapshot) {
   if (snapshot instanceof Map) return snapshot;
@@ -6013,7 +6109,7 @@ function applyExtraction(store, extraction) {
   if (!Array.isArray(extraction.upsert)) {
     throw new TypeError("distill extraction requires upsert: Array<{ key, value }>");
   }
-  (0, import_core42.batch)(() => {
+  (0, import_core43.batch)(() => {
     for (const { key, value } of extraction.upsert) {
       store.set(key, value);
     }
@@ -6023,12 +6119,12 @@ function applyExtraction(store, extraction) {
   });
 }
 function distill(source, extractFn, opts) {
-  const sourceNode = (0, import_extra30.fromAny)(source);
-  const store = (0, import_extra30.reactiveMap)(opts.mapOptions ?? {});
+  const sourceNode = (0, import_extra31.fromAny)(source);
+  const store = (0, import_extra31.reactiveMap)(opts.mapOptions ?? {});
   const budget = opts.budget ?? 2e3;
   const hasContext = opts.context !== void 0 && opts.context !== null;
-  const contextNode = hasContext ? (0, import_extra30.fromAny)(opts.context) : (0, import_core42.node)([], { initial: null });
-  const extractionStream = (0, import_extra30.fromAny)(
+  const contextNode = hasContext ? (0, import_extra31.fromAny)(opts.context) : (0, import_core43.node)([], { initial: null });
+  const extractionStream = (0, import_extra31.fromAny)(
     extractFn(sourceNode, store.entries)
   );
   forEach(extractionStream, (extraction) => {
@@ -6036,7 +6132,7 @@ function distill(source, extractFn, opts) {
   });
   if (opts.evict) {
     const verdictUnsubs = /* @__PURE__ */ new Map();
-    const evictionKeys = (0, import_core42.node)(
+    const evictionKeys = (0, import_core43.node)(
       [store.entries],
       (batchData, actions, ctx) => {
         const batch0 = batchData[0];
@@ -6078,12 +6174,12 @@ function distill(source, extractFn, opts) {
   }
   const hasConsolidateTrigger = opts.consolidateTrigger !== void 0 && opts.consolidateTrigger !== null;
   if (opts.consolidate && hasConsolidateTrigger) {
-    const consolidateTriggerNode = (0, import_extra30.fromAny)(opts.consolidateTrigger);
-    const consolidatePaired = (0, import_extra30.withLatestFrom)(
+    const consolidateTriggerNode = (0, import_extra31.fromAny)(opts.consolidateTrigger);
+    const consolidatePaired = (0, import_extra31.withLatestFrom)(
       consolidateTriggerNode,
       store.entries
     );
-    const consolidationStream = (0, import_extra30.switchMap)(
+    const consolidationStream = (0, import_extra31.switchMap)(
       consolidatePaired,
       ([, entries]) => opts.consolidate(mapFromSnapshot(entries))
     );
@@ -6091,7 +6187,7 @@ function distill(source, extractFn, opts) {
       applyExtraction(store, extraction);
     });
   }
-  const compact = (0, import_core42.node)(
+  const compact = (0, import_core43.node)(
     [store.entries, contextNode],
     (batchData, actions, ctx) => {
       const data = batchData.map(
@@ -6117,9 +6213,9 @@ function distill(source, extractFn, opts) {
       }
       actions.emit(packed);
     },
-    { describeKind: "derived", meta: { ...(0, import_core42.factoryTag)("distill", { budget }) } }
+    { describeKind: "derived", meta: { ...(0, import_core43.factoryTag)("distill", { budget }) } }
   );
-  const size = (0, import_core42.node)(
+  const size = (0, import_core43.node)(
     [store.entries],
     (batchData, actions, ctx) => {
       const batch0 = batchData[0];
@@ -6144,16 +6240,16 @@ function decay(baseScore, ageSeconds2, ratePerSecond, minScore = 0) {
 }
 
 // src/utils/memory/index.ts
-var import_core43 = require("@graphrefly/pure-ts/core");
-var import_extra31 = require("@graphrefly/pure-ts/extra");
+var import_core44 = require("@graphrefly/pure-ts/core");
+var import_extra32 = require("@graphrefly/pure-ts/extra");
 var import_graph6 = require("@graphrefly/pure-ts/graph");
 var NS_PER_SEC2 = 1e9;
 function memoryMeta(kind, extra) {
   return domainMeta("memory", kind, extra);
 }
 function toNode(v, name) {
-  if (v instanceof import_core43.NodeImpl) return v;
-  return (0, import_core43.node)([], { initial: v, ...name ? { name } : void 0 });
+  if (v instanceof import_core44.NodeImpl) return v;
+  return (0, import_core44.node)([], { initial: v, ...name ? { name } : void 0 });
 }
 function ageSeconds(now, lastNs) {
   return (now - lastNs) / NS_PER_SEC2;
@@ -6207,14 +6303,14 @@ function collection(name, opts = {}) {
   }
   const scoreFnDefault = () => ranked ? 1 : 0;
   const scoreInput = opts.score ?? scoreFnDefault;
-  const scoreNode = ranked && scoreInput instanceof import_core43.NodeImpl ? scoreInput : void 0;
+  const scoreNode = ranked && scoreInput instanceof import_core44.NodeImpl ? scoreInput : void 0;
   const readScoreFn = () => {
     if (scoreNode) return scoreNode.cache ?? scoreFnDefault;
     return scoreInput;
   };
   const graph = new import_graph6.Graph(name);
-  const retentionScore = (_k, v) => ranked ? decay(v.baseScore, ageSeconds((0, import_core43.monotonicNs)(), v.lastAccessNs), decayRate, minScore) : v.lastAccessNs;
-  const items = (0, import_extra31.reactiveMap)({
+  const retentionScore = (_k, v) => ranked ? decay(v.baseScore, ageSeconds((0, import_core44.monotonicNs)(), v.lastAccessNs), decayRate, minScore) : v.lastAccessNs;
+  const items = (0, import_extra32.reactiveMap)({
     name: "items",
     ...maxSize !== void 0 ? { retention: { score: retentionScore, maxSize } } : {}
   });
@@ -6222,16 +6318,16 @@ function collection(name, opts = {}) {
   let refreshTick;
   if (ranked && decayRate > 0) {
     const intervalMs = opts.refreshIntervalMs ?? Math.max(1, 1e3 * Math.LN2 / (10 * decayRate));
-    const tickCounter = (0, import_extra31.fromTimer)(intervalMs, { period: intervalMs });
-    refreshTick = (0, import_core43.node)(
+    const tickCounter = (0, import_extra32.fromTimer)(intervalMs, { period: intervalMs });
+    refreshTick = (0, import_core44.node)(
       [tickCounter],
       (_batchData, actions) => {
-        actions.emit((0, import_core43.monotonicNs)());
+        actions.emit((0, import_core44.monotonicNs)());
       },
       {
         name: "refresh_tick_ns",
         describeKind: "derived",
-        initial: (0, import_core43.monotonicNs)(),
+        initial: (0, import_core44.monotonicNs)(),
         meta: memoryMeta("clock")
       }
     );
@@ -6242,7 +6338,7 @@ function collection(name, opts = {}) {
     const rankedDeps = [items.entries];
     if (refreshTick) rankedDeps.push(refreshTick);
     if (scoreNode) rankedDeps.push(scoreNode);
-    rankedNode = (0, import_core43.node)(
+    rankedNode = (0, import_core44.node)(
       rankedDeps,
       (batchData, actions, ctx) => {
         const values = batchData.map(
@@ -6252,9 +6348,9 @@ function collection(name, opts = {}) {
         let now;
         if (refreshTick) {
           const tickValue = values[1];
-          now = typeof tickValue === "number" ? tickValue : (0, import_core43.monotonicNs)();
+          now = typeof tickValue === "number" ? tickValue : (0, import_core44.monotonicNs)();
         } else {
-          now = (0, import_core43.monotonicNs)();
+          now = (0, import_core44.monotonicNs)();
         }
         if (!snapshot || snapshot.size === 0) {
           actions.emit([]);
@@ -6279,7 +6375,7 @@ function collection(name, opts = {}) {
     );
     graph.add(rankedNode, { name: "ranked" });
   } else {
-    rankedNode = (0, import_core43.node)([], {
+    rankedNode = (0, import_core44.node)([], {
       initial: [],
       name: "ranked",
       describeKind: "state",
@@ -6287,7 +6383,7 @@ function collection(name, opts = {}) {
     });
     graph.add(rankedNode, { name: "ranked" });
   }
-  const size = (0, import_core43.node)(
+  const size = (0, import_core44.node)(
     [items.entries],
     (batchData, actions, ctx) => {
       const data = batchData.map(
@@ -6304,7 +6400,7 @@ function collection(name, opts = {}) {
     }
   );
   graph.add(size, { name: "size" });
-  graph.addDisposer((0, import_extra31.keepalive)(size));
+  graph.addDisposer((0, import_extra32.keepalive)(size));
   const events = createAuditLog({
     name: "events",
     retainedLimit: 1024,
@@ -6312,7 +6408,7 @@ function collection(name, opts = {}) {
   });
   const seqCursor = registerCursor(graph, "seq", 0);
   const upsertImpl = (id, value, _opts) => {
-    const now = (0, import_core43.monotonicNs)();
+    const now = (0, import_core44.monotonicNs)();
     const prev = items.get(id);
     const baseScore = _opts?.score ?? readScoreFn()(value);
     items.set(id, {
@@ -6368,7 +6464,7 @@ function collection(name, opts = {}) {
   });
   function itemNode(id) {
     const idN = toNode(id, "id");
-    return (0, import_core43.node)(
+    return (0, import_core44.node)(
       [items.entries, idN],
       (batchData, actions, ctx) => {
         const data = batchData.map(
@@ -6386,7 +6482,7 @@ function collection(name, opts = {}) {
   }
   function hasNode(id) {
     const idN = toNode(id, "id");
-    return (0, import_core43.node)(
+    return (0, import_core44.node)(
       [items.entries, idN],
       (batchData, actions, ctx) => {
         const data = batchData.map(
@@ -6461,7 +6557,7 @@ function vectorIndex(opts = {}) {
     graph
   });
   const seqCursor = registerCursor(graph, "seq", 0);
-  const entries = (0, import_extra31.reactiveMap)({
+  const entries = (0, import_extra32.reactiveMap)({
     name: "entries",
     ...maxSize !== void 0 ? {
       retention: {
@@ -6473,7 +6569,7 @@ function vectorIndex(opts = {}) {
           events.append({
             action: "evict",
             id: key,
-            t_ns: (0, import_core43.wallClockNs)(),
+            t_ns: (0, import_core44.wallClockNs)(),
             seq: bumpCursor(seqCursor)
           });
         }
@@ -6481,7 +6577,7 @@ function vectorIndex(opts = {}) {
     } : {}
   });
   graph.add(entries.entries, { name: "entries" });
-  graph.addDisposer((0, import_extra31.keepalive)(entries.entries));
+  graph.addDisposer((0, import_extra32.keepalive)(entries.entries));
   if (hnsw?.dispose) {
     const disposeAdapter = hnsw.dispose.bind(hnsw);
     graph.addDisposer(() => disposeAdapter());
@@ -6498,7 +6594,7 @@ function vectorIndex(opts = {}) {
       id,
       vector: [...vector],
       ...copiedMeta !== void 0 ? { meta: copiedMeta } : {},
-      upsertedAtNs: (0, import_core43.monotonicNs)()
+      upsertedAtNs: (0, import_core44.monotonicNs)()
     };
     entries.set(id, record);
   };
@@ -6554,7 +6650,7 @@ function vectorIndex(opts = {}) {
   });
   function searchNode(query, k = 5) {
     const kN = toNode(k, "k");
-    return (0, import_core43.node)(
+    return (0, import_core44.node)(
       [entries.entries, query, kN],
       (batchData, actions, ctx) => {
         const values = batchData.map(
@@ -6660,17 +6756,17 @@ function knowledgeGraph(name, opts = {}) {
     throw new RangeError("knowledgeGraph: edgesMaxSize must be >= 1");
   }
   const graph = new import_graph6.Graph(name);
-  const entitiesMap = (0, import_extra31.reactiveMap)({
+  const entitiesMap = (0, import_extra32.reactiveMap)({
     name: "entities",
     ...opts.entitiesMaxSize !== void 0 ? { maxSize: opts.entitiesMaxSize } : {}
   });
-  const edgesMap = (0, import_extra31.reactiveMap)({
+  const edgesMap = (0, import_extra32.reactiveMap)({
     name: "edges",
     ...opts.edgesMaxSize !== void 0 ? { maxSize: opts.edgesMaxSize } : {}
   });
   graph.add(entitiesMap.entries, { name: "entities" });
   graph.add(edgesMap.entries, { name: "edges" });
-  const adjacencyOut = (0, import_core43.node)(
+  const adjacencyOut = (0, import_core44.node)(
     [edgesMap.entries],
     (batchData, actions, ctx) => {
       const data = batchData.map(
@@ -6687,7 +6783,7 @@ function knowledgeGraph(name, opts = {}) {
       meta: memoryMeta("adjacency_out")
     }
   );
-  const adjacencyIn = (0, import_core43.node)(
+  const adjacencyIn = (0, import_core44.node)(
     [edgesMap.entries],
     (batchData, actions, ctx) => {
       const data = batchData.map(
@@ -6706,9 +6802,9 @@ function knowledgeGraph(name, opts = {}) {
   );
   graph.add(adjacencyOut, { name: "adjacencyOut" });
   graph.add(adjacencyIn, { name: "adjacencyIn" });
-  graph.addDisposer((0, import_extra31.keepalive)(adjacencyOut));
-  graph.addDisposer((0, import_extra31.keepalive)(adjacencyIn));
-  const entityCount = (0, import_core43.node)(
+  graph.addDisposer((0, import_extra32.keepalive)(adjacencyOut));
+  graph.addDisposer((0, import_extra32.keepalive)(adjacencyIn));
+  const entityCount = (0, import_core44.node)(
     [entitiesMap.entries],
     (batchData, actions, ctx) => {
       const data = batchData.map(
@@ -6719,7 +6815,7 @@ function knowledgeGraph(name, opts = {}) {
     },
     { name: "entityCount", describeKind: "derived", initial: 0, meta: memoryMeta("entity_count") }
   );
-  const edgeCount = (0, import_core43.node)(
+  const edgeCount = (0, import_core44.node)(
     [edgesMap.entries],
     (batchData, actions, ctx) => {
       const data = batchData.map(
@@ -6732,8 +6828,8 @@ function knowledgeGraph(name, opts = {}) {
   );
   graph.add(entityCount, { name: "entityCount" });
   graph.add(edgeCount, { name: "edgeCount" });
-  graph.addDisposer((0, import_extra31.keepalive)(entityCount));
-  graph.addDisposer((0, import_extra31.keepalive)(edgeCount));
+  graph.addDisposer((0, import_extra32.keepalive)(entityCount));
+  graph.addDisposer((0, import_extra32.keepalive)(edgeCount));
   const events = createAuditLog({
     name: "events",
     retainedLimit: 1024,
@@ -6756,7 +6852,7 @@ function knowledgeGraph(name, opts = {}) {
       events.append({
         action: "orphanRemove",
         id: candidate,
-        t_ns: (0, import_core43.wallClockNs)(),
+        t_ns: (0, import_core44.wallClockNs)(),
         seq: bumpCursor(seqCursor)
       });
     }
@@ -6851,7 +6947,7 @@ function knowledgeGraph(name, opts = {}) {
     const idN = toNode(id, "id");
     const relN = relation !== void 0 ? toNode(relation, "relation") : void 0;
     const deps = relN ? [adjacencyOut, adjacencyIn, idN, relN] : [adjacencyOut, adjacencyIn, idN];
-    return (0, import_core43.node)(
+    return (0, import_core44.node)(
       deps,
       (batchData, actions, ctx) => {
         const values = batchData.map(
@@ -6927,7 +7023,7 @@ var MemoryWithVectorsGraph = class extends import_graph7.Graph {
     this.mount("vectorIndex", this.vectors);
     const embedFn = opts.embedFn;
     const vectorsRef = this.vectors;
-    const indexer = (0, import_core44.node)(
+    const indexer = (0, import_core45.node)(
       [opts.store.store.entries],
       (batchData, _actions, ctx) => {
         const data = batchData.map(
@@ -6942,7 +7038,7 @@ var MemoryWithVectorsGraph = class extends import_graph7.Graph {
       { name: "indexer", describeKind: "effect" }
     );
     this.add(indexer, { name: "indexer" });
-    this.addDisposer((0, import_extra32.keepalive)(indexer));
+    this.addDisposer((0, import_extra33.keepalive)(indexer));
   }
 };
 function memoryWithVectors(opts) {
@@ -6960,7 +7056,7 @@ var MemoryWithKGGraph = class extends import_graph7.Graph {
     if (!opts.entityFn) return;
     const entityFn = opts.entityFn;
     const kgRef = this.kg;
-    const indexer = (0, import_core44.node)(
+    const indexer = (0, import_core45.node)(
       [opts.store.store.entries],
       (batchData, _actions, ctx) => {
         const data = batchData.map(
@@ -6981,7 +7077,7 @@ var MemoryWithKGGraph = class extends import_graph7.Graph {
       { name: "indexer", describeKind: "effect" }
     );
     this.add(indexer, { name: "indexer" });
-    this.addDisposer((0, import_extra32.keepalive)(indexer));
+    this.addDisposer((0, import_extra33.keepalive)(indexer));
   }
 };
 function memoryWithKG(opts) {
@@ -7003,20 +7099,20 @@ var MemoryWithTiersGraph = class extends import_graph7.Graph {
     const permanentFilter = opts.permanentFilter ?? (() => false);
     this.permanent = collection("permanent", { ranked: false });
     this.mount("permanent", this.permanent);
-    this.permanentKeys = (0, import_extra32.reactiveMap)({ name: "permanentKeys" });
+    this.permanentKeys = (0, import_extra33.reactiveMap)({ name: "permanentKeys" });
     this.add(this.permanentKeys.entries, { name: "permanentKeys" });
-    this.entryCreatedAtNs = (0, import_extra32.reactiveMap)({ name: "entryCreatedAtNs" });
+    this.entryCreatedAtNs = (0, import_extra33.reactiveMap)({ name: "entryCreatedAtNs" });
     this.add(this.entryCreatedAtNs.entries, { name: "entryCreatedAtNs" });
     let contextNode;
     if (opts.context) {
-      contextNode = (0, import_extra32.fromAny)(opts.context);
+      contextNode = (0, import_extra33.fromAny)(opts.context);
     } else {
-      contextNode = (0, import_core44.node)([], { initial: null });
+      contextNode = (0, import_core45.node)([], { initial: null });
       this.add(contextNode, { name: "context" });
     }
     let latestCtx = contextNode.cache;
     const ctxUnsub = contextNode.subscribe((msgs) => {
-      for (const m of msgs) if (m[0] === import_core44.DATA) latestCtx = m[1];
+      for (const m of msgs) if (m[0] === import_core45.DATA) latestCtx = m[1];
     });
     this.addDisposer(ctxUnsub);
     const permanentKeysRef = this.permanentKeys;
@@ -7026,7 +7122,7 @@ var MemoryWithTiersGraph = class extends import_graph7.Graph {
       score: (key, value) => {
         if (permanentFilter(key, value)) return Number.POSITIVE_INFINITY;
         if (permanentKeysRef.has(key)) return Number.POSITIVE_INFINITY;
-        const nowNs = (0, import_core44.monotonicNs)();
+        const nowNs = (0, import_core45.monotonicNs)();
         const createdNs = entryCreatedAtNsRef.get(key) ?? nowNs;
         const ageSeconds2 = Number(nowNs - createdNs) / 1e9;
         return decay(score(value, latestCtx), ageSeconds2, decayRate);
@@ -7061,20 +7157,20 @@ var MemoryWithTiersGraph = class extends import_graph7.Graph {
       permanentKeysRef.set(key, true);
       permanentRef.upsert(key, value);
     };
-    const syncCreatedAt = (0, import_core44.node)(
+    const syncCreatedAt = (0, import_core45.node)(
       [this.store.store.entries],
       (batchData, _actions, ctx) => {
         const data = batchData.map(
           (b, i) => b != null && b.length > 0 ? b.at(-1) : ctx.prevData[i]
         );
         const map = data[0] ?? /* @__PURE__ */ new Map();
-        const nowNs = (0, import_core44.monotonicNs)();
+        const nowNs = (0, import_core45.monotonicNs)();
         const toAdd = [];
         for (const key of map.keys()) {
           if (!entryCreatedAtNsRef.has(key)) toAdd.push(key);
         }
         if (toAdd.length > 0) {
-          (0, import_core44.batch)(() => {
+          (0, import_core45.batch)(() => {
             for (const key of toAdd) entryCreatedAtNsRef.set(key, nowNs);
           });
         }
@@ -7082,10 +7178,10 @@ var MemoryWithTiersGraph = class extends import_graph7.Graph {
       { name: "entryCreatedAtNs/sync", describeKind: "effect" }
     );
     this.add(syncCreatedAt, { name: "entryCreatedAtNs/sync" });
-    this.addDisposer((0, import_extra32.keepalive)(syncCreatedAt));
+    this.addDisposer((0, import_extra33.keepalive)(syncCreatedAt));
     const entriesUnsub = this.store.store.entries.subscribe((msgs) => {
       for (const m of msgs) {
-        if (m[0] !== import_core44.DATA) continue;
+        if (m[0] !== import_core45.DATA) continue;
         const map = m[1];
         const created = entryCreatedAtNsRef.entries.cache;
         if (created == null) continue;
@@ -7094,14 +7190,14 @@ var MemoryWithTiersGraph = class extends import_graph7.Graph {
           if (!map.has(key)) toDelete.push(key);
         }
         if (toDelete.length > 0) {
-          (0, import_core44.batch)(() => {
+          (0, import_core45.batch)(() => {
             for (const key of toDelete) entryCreatedAtNsRef.delete(key);
           });
         }
       }
     });
     this.addDisposer(entriesUnsub);
-    const promoter = (0, import_core44.node)(
+    const promoter = (0, import_core45.node)(
       [this.store.store.entries],
       (batchData, _actions, ctx) => {
         const data = batchData.map(
@@ -7111,7 +7207,7 @@ var MemoryWithTiersGraph = class extends import_graph7.Graph {
         for (const [key, mem] of map) {
           if (permanentKeysRef.has(key)) continue;
           if (permanentFilter(key, mem)) {
-            (0, import_core44.batch)(() => {
+            (0, import_core45.batch)(() => {
               markPermanent(key, mem);
             });
           }
@@ -7120,7 +7216,7 @@ var MemoryWithTiersGraph = class extends import_graph7.Graph {
       { name: "promoter", describeKind: "effect" }
     );
     this.add(promoter, { name: "promoter" });
-    this.addDisposer((0, import_extra32.keepalive)(promoter));
+    this.addDisposer((0, import_extra33.keepalive)(promoter));
     let archiveHandle = null;
     if (opts.archiveTier) {
       archiveHandle = this.attachSnapshotStorage(
@@ -7176,7 +7272,7 @@ var MemoryRetrievalGraph = class extends import_graph7.Graph {
     this._budget = opts.budget ?? 2e3;
     this._contextWeight = opts.contextWeight ?? 0;
     if (opts.context) {
-      this._contextNode = (0, import_extra32.fromAny)(opts.context);
+      this._contextNode = (0, import_extra33.fromAny)(opts.context);
     } else {
       this._contextNode = this.state("_context", null);
     }
@@ -7322,7 +7418,7 @@ var MemoryRetrievalGraph = class extends import_graph7.Graph {
     const id = ++this._retrieveSeq;
     const segment = `retrieve_${id}`;
     const sub = new import_graph7.Graph(segment);
-    const inputNode = (0, import_extra32.fromAny)(queryInput);
+    const inputNode = (0, import_extra33.fromAny)(queryInput);
     const localContext = sub.derived(
       "context",
       [inputNode],
@@ -7367,7 +7463,7 @@ var MemoryRetrievalGraph = class extends import_graph7.Graph {
         initial: { packed: [], trace: null }
       }
     );
-    const projection = (0, import_core44.node)(
+    const projection = (0, import_core45.node)(
       [result],
       (batchData, actions, ctx) => {
         const data = batchData.map(
@@ -7407,18 +7503,18 @@ function gaugesAsContext(graph, actor, options) {
   const separator = options?.separator ?? "\n";
   const entries = [];
   const sinceVersion = options?.sinceVersion;
-  for (const [path, node38] of Object.entries(described.nodes)) {
-    const meta2 = node38.meta ?? {};
+  for (const [path, node39] of Object.entries(described.nodes)) {
+    const meta2 = node39.meta ?? {};
     const desc = meta2.description;
     const format = meta2.format;
     if (!desc && !format) continue;
-    if (sinceVersion != null && node38.v != null) {
+    if (sinceVersion != null && node39.v != null) {
       const lastSeen = sinceVersion.get(path);
-      if (lastSeen != null && lastSeen.id === node38.v.id && node38.v.version <= lastSeen.version)
+      if (lastSeen != null && lastSeen.id === node39.v.id && node39.v.version <= lastSeen.version)
         continue;
     }
     const label = desc ?? path;
-    const value = node38.value;
+    const value = node39.value;
     const unit = meta2.unit;
     let formatted;
     if (format === "currency" && typeof value === "number") {
@@ -7440,8 +7536,8 @@ function gaugesAsContext(graph, actor, options) {
     const tagGroups = /* @__PURE__ */ new Map();
     const ungrouped = [];
     for (const entry of entries) {
-      const node38 = described.nodes[entry.path];
-      const tags = node38.meta?.tags;
+      const node39 = described.nodes[entry.path];
+      const tags = node39.meta?.tags;
       if (tags && tags.length > 0) {
         const tag = tags[0];
         let group = tagGroups.get(tag);
@@ -7472,25 +7568,25 @@ function gaugesAsContext(graph, actor, options) {
 }
 
 // src/utils/ai/graph-integration/graph-from-spec.ts
-var import_core47 = require("@graphrefly/pure-ts/core");
-var import_extra35 = require("@graphrefly/pure-ts/extra");
+var import_core48 = require("@graphrefly/pure-ts/core");
+var import_extra36 = require("@graphrefly/pure-ts/extra");
 
 // src/utils/graphspec/index.ts
-var import_core46 = require("@graphrefly/pure-ts/core");
+var import_core47 = require("@graphrefly/pure-ts/core");
 var import_graph9 = require("@graphrefly/pure-ts/graph");
 
 // src/utils/reduction/index.ts
-var import_core45 = require("@graphrefly/pure-ts/core");
-var import_extra33 = require("@graphrefly/pure-ts/extra");
-var import_graph8 = require("@graphrefly/pure-ts/graph");
+var import_core46 = require("@graphrefly/pure-ts/core");
 var import_extra34 = require("@graphrefly/pure-ts/extra");
+var import_graph8 = require("@graphrefly/pure-ts/graph");
+var import_extra35 = require("@graphrefly/pure-ts/extra");
 function baseMeta(kind, meta2) {
   return domainMeta("reduction", kind, meta2);
 }
 function feedback(graph, condition, reentry, opts) {
   const maxIter = opts?.maxIterations ?? 10;
   const counterName = `__feedback_${condition}`;
-  const counter = (0, import_core45.node)([], {
+  const counter = (0, import_core46.node)([], {
     ...{
       meta: baseMeta("feedback_counter", {
         maxIterations: maxIter,
@@ -7504,27 +7600,27 @@ function feedback(graph, condition, reentry, opts) {
   const condNode = graph.resolve(condition);
   const reentryNode = graph.resolve(reentry);
   const feedbackEffectName = `__feedback_effect_${condition}`;
-  const feedbackEffect = (0, import_core45.node)(
+  const feedbackEffect = (0, import_core46.node)(
     [],
     (_data, _feedbackActions) => {
       const unsub = condNode.subscribe((msgs) => {
         for (const msg of msgs) {
           const t = msg[0];
-          if (t === import_core45.DATA) {
+          if (t === import_core46.DATA) {
             const condValue = msg[1];
             if (condValue == null) return;
-            (0, import_core45.batch)(() => {
+            (0, import_core46.batch)(() => {
               if (tryIncrementBounded(counter, maxIter)) {
                 reentryNode.emit(condValue);
               }
             });
-          } else if (t === import_core45.COMPLETE || t === import_core45.ERROR) {
-            const terminal = t === import_core45.ERROR && msg.length > 1 ? [import_core45.ERROR, msg[1]] : [t];
+          } else if (t === import_core46.COMPLETE || t === import_core46.ERROR) {
+            const terminal = t === import_core46.ERROR && msg.length > 1 ? [import_core46.ERROR, msg[1]] : [t];
             counter.down([terminal]);
           }
         }
       });
-      return () => unsub();
+      return { onDeactivation: () => unsub() };
     },
     {
       name: feedbackEffectName,
@@ -7539,23 +7635,23 @@ function feedback(graph, condition, reentry, opts) {
     }
   );
   graph.add(feedbackEffect, { name: feedbackEffectName });
-  graph.addDisposer((0, import_extra34.keepalive)(feedbackEffect));
+  graph.addDisposer((0, import_extra35.keepalive)(feedbackEffect));
   return graph;
 }
 
 // src/utils/graphspec/index.ts
-function readFactory(node38) {
-  const f = node38.meta?.factory;
+function readFactory(node39) {
+  const f = node39.meta?.factory;
   return typeof f === "string" ? f : void 0;
 }
-function readFactoryArgs(node38) {
-  const a = node38.meta?.factoryArgs;
+function readFactoryArgs(node39) {
+  const a = node39.meta?.factoryArgs;
   return a != null && typeof a === "object" ? a : {};
 }
-function readStateInitial(node38) {
-  const args = readFactoryArgs(node38);
+function readStateInitial(node39) {
+  const args = readFactoryArgs(node39);
   if ("initial" in args) return args.initial;
-  return node38.value;
+  return node39.value;
 }
 function isRichFnEntry(entry) {
   return typeof entry === "object" && entry !== null && "factory" in entry;
@@ -7575,11 +7671,11 @@ function validateSpecAgainstCatalog(spec, catalog) {
   const sourceNames = new Set(Object.keys(catalog.sources ?? {}));
   for (const [nodeName, nodeRaw] of Object.entries(spec.nodes)) {
     if (nodeRaw.type === "template") continue;
-    const node38 = nodeRaw;
-    const factoryName = readFactory(node38);
+    const node39 = nodeRaw;
+    const factoryName = readFactory(node39);
     if (factoryName == null) continue;
-    const isProducer = node38.type === "producer";
-    if (node38.type === "state" && factoryName === "state") continue;
+    const isProducer = node39.type === "producer";
+    if (node39.type === "state" && factoryName === "state") continue;
     if (isProducer) {
       const inSources = sourceNames.has(factoryName);
       const inFns = fnNames.has(factoryName);
@@ -7603,7 +7699,7 @@ function validateSpecAgainstCatalog(spec, catalog) {
         }
       }
     }
-    const factoryArgs = readFactoryArgs(node38);
+    const factoryArgs = readFactoryArgs(node39);
     if (!isProducer && catalog.fns?.[factoryName]) {
       const entry = catalog.fns[factoryName];
       if (isRichFnEntry(entry) && entry.configSchema) {
@@ -7643,11 +7739,11 @@ function validateSpecAgainstCatalog(spec, catalog) {
   }
   if (spec.templates) {
     for (const [tName, template] of Object.entries(spec.templates)) {
-      for (const [nodeName, node38] of Object.entries(template.nodes)) {
-        const factoryName = readFactory(node38);
+      for (const [nodeName, node39] of Object.entries(template.nodes)) {
+        const factoryName = readFactory(node39);
         if (factoryName == null) continue;
-        if (node38.type === "state" && factoryName === "state") continue;
-        if (node38.type === "producer") continue;
+        if (node39.type === "state" && factoryName === "state") continue;
+        if (node39.type === "producer") continue;
         if (fnNames.size > 0 && !fnNames.has(factoryName)) {
           const suggestion = findClosest(factoryName, fnNames);
           errors.push(
@@ -7915,7 +8011,7 @@ ${catalogValidation.errors.join("\n")}`
     const factoryArgs = readFactoryArgs(n);
     if (n.type === "state") {
       const initial = readStateInitial(n);
-      const nd = (0, import_core46.node)([], {
+      const nd = (0, import_core47.node)([], {
         name,
         initial,
         meta: stripFactoryMeta(n.meta)
@@ -7935,7 +8031,7 @@ ${catalogValidation.errors.join("\n")}`
         created.set(name, nd);
       } else {
         if (factoryName) recordMissing(name, "source", factoryName);
-        const nd = (0, import_core46.node)([], () => {
+        const nd = (0, import_core47.node)([], () => {
         }, {
           name,
           describeKind: "producer",
@@ -7964,11 +8060,11 @@ ${catalogValidation.errors.join("\n")}`
         nd = fnFactory(resolvedDeps, factoryArgs);
       } else if (n.type === "effect") {
         if (factoryName) recordMissing(name, "fn", factoryName);
-        nd = (0, import_core46.node)(resolvedDeps, () => {
+        nd = (0, import_core47.node)(resolvedDeps, () => {
         }, { describeKind: "effect" });
       } else {
         if (factoryName) recordMissing(name, "fn", factoryName);
-        nd = (0, import_core46.node)(
+        nd = (0, import_core47.node)(
           resolvedDeps,
           (batchData, actions, ctx) => {
             const data = batchData.map(
@@ -8008,7 +8104,7 @@ ${catalogValidation.errors.join("\n")}`
       const factoryArgs = readFactoryArgs(nSpec);
       if (nSpec.type === "state") {
         const initial = readStateInitial(nSpec);
-        const nd = (0, import_core46.node)([], {
+        const nd = (0, import_core47.node)([], {
           name: nName,
           initial,
           meta: stripFactoryMeta(nSpec.meta)
@@ -8028,7 +8124,7 @@ ${catalogValidation.errors.join("\n")}`
           subCreated.set(nName, nd);
         } else {
           if (factoryName) recordMissing(`${name}.${nName}`, "source", factoryName);
-          const nd = (0, import_core46.node)([], () => {
+          const nd = (0, import_core47.node)([], () => {
           }, {
             name: nName,
             describeKind: "producer",
@@ -8058,11 +8154,11 @@ ${catalogValidation.errors.join("\n")}`
           nd = fnFactory(resolvedDeps, factoryArgs);
         } else if (nSpec.type === "effect") {
           if (factoryName) recordMissing(`${name}.${nName}`, "fn", factoryName);
-          nd = (0, import_core46.node)(resolvedDeps, () => {
+          nd = (0, import_core47.node)(resolvedDeps, () => {
           }, { describeKind: "effect" });
         } else {
           if (factoryName) recordMissing(`${name}.${nName}`, "fn", factoryName);
-          nd = (0, import_core46.node)(
+          nd = (0, import_core47.node)(
             resolvedDeps,
             (batchData, actions, ctx) => {
               const data = batchData.map(
@@ -8183,12 +8279,12 @@ ${opts.systemPromptExtra}` : GRAPH_FROM_SPEC_SYSTEM_PROMPT;
   return compileSpec(parsed, { catalog: opts?.catalog });
 }
 function graphFromSpecReactive(input, adapter, opts) {
-  const inputNode = (0, import_extra35.fromAny)(input);
-  return (0, import_extra35.switchMap)(inputNode, (nl) => {
+  const inputNode = (0, import_extra36.fromAny)(input);
+  return (0, import_extra36.switchMap)(inputNode, (nl) => {
     if (!nl || typeof nl !== "string" || nl.trim().length === 0) {
-      return (0, import_core47.node)([], { initial: null });
+      return (0, import_core48.node)([], { initial: null });
     }
-    return (0, import_core47.node)(
+    return (0, import_core48.node)(
       (_data, actions) => {
         const controller = new AbortController();
         let cancelled = false;
@@ -8198,14 +8294,16 @@ function graphFromSpecReactive(input, adapter, opts) {
             return;
           }
           actions.emit(g);
-          actions.down([[import_core47.COMPLETE]]);
+          actions.down([[import_core48.COMPLETE]]);
         }).catch((err) => {
           if (cancelled) return;
-          actions.down([[import_core47.ERROR, err]]);
+          actions.down([[import_core48.ERROR, err]]);
         });
-        return () => {
-          cancelled = true;
-          controller.abort();
+        return {
+          onDeactivation: () => {
+            cancelled = true;
+            controller.abort();
+          }
         };
       },
       { describeKind: "producer", ...{ name: "graphFromSpec::call" } }
@@ -8252,11 +8350,11 @@ function knobsAsTools(graph, actor) {
   const openai = [];
   const mcp = [];
   const definitions = [];
-  for (const [path, node38] of Object.entries(described.nodes)) {
-    if (node38.type !== "state") continue;
+  for (const [path, node39] of Object.entries(described.nodes)) {
+    if (node39.type !== "state") continue;
     if (path.includes("::__meta__::")) continue;
-    if (node38.status === "completed" || node38.status === "errored") continue;
-    const meta2 = node38.meta ?? {};
+    if (node39.status === "completed" || node39.status === "errored") continue;
+    const meta2 = node39.meta ?? {};
     const access = meta2.access;
     if (access === "human" || access === "system") continue;
     const description = meta2.description ?? `Set the value of ${path}`;
@@ -8285,7 +8383,7 @@ function knobsAsTools(graph, actor) {
     });
     const graphRef = graph;
     const actorRef = actor;
-    const nv = node38.v;
+    const nv = node39.v;
     definitions.push({
       name: path,
       description,
@@ -8301,8 +8399,8 @@ function knobsAsTools(graph, actor) {
 }
 
 // src/utils/ai/graph-integration/suggest-strategy.ts
-var import_core48 = require("@graphrefly/pure-ts/core");
-var import_extra36 = require("@graphrefly/pure-ts/extra");
+var import_core49 = require("@graphrefly/pure-ts/core");
+var import_extra37 = require("@graphrefly/pure-ts/extra");
 var SUGGEST_STRATEGY_SYSTEM_PROMPT = `You are a reactive graph optimizer for GraphReFly.
 
 Given a graph's current structure (from describe()) and a problem statement, suggest topology and parameter changes to solve the problem.
@@ -8371,30 +8469,32 @@ async function suggestStrategy(graph, problem, adapter, opts) {
   };
 }
 function suggestStrategyReactive(graph, problem, adapter, opts) {
-  const problemNode = (0, import_extra36.fromAny)(problem);
-  const paired = (0, import_extra36.withLatestFrom)(problemNode, graph);
-  return (0, import_extra36.switchMap)(paired, (pair) => {
-    if (pair == null) return (0, import_core48.node)([], { initial: null });
+  const problemNode = (0, import_extra37.fromAny)(problem);
+  const paired = (0, import_extra37.withLatestFrom)(problemNode, graph);
+  return (0, import_extra37.switchMap)(paired, (pair) => {
+    if (pair == null) return (0, import_core49.node)([], { initial: null });
     const [pText, g] = pair;
     if (!g || !pText || typeof pText !== "string" || pText.trim().length === 0) {
-      return (0, import_core48.node)([], { initial: null });
+      return (0, import_core49.node)([], { initial: null });
     }
-    if (g.destroyed) return (0, import_core48.node)([], { initial: null });
-    return (0, import_core48.node)(
+    if (g.destroyed) return (0, import_core49.node)([], { initial: null });
+    return (0, import_core49.node)(
       (_data, actions) => {
         const controller = new AbortController();
         let cancelled = false;
         suggestStrategy(g, pText, adapter, { ...opts, signal: controller.signal }).then((plan) => {
           if (cancelled) return;
           actions.emit(plan);
-          actions.down([[import_core48.COMPLETE]]);
+          actions.down([[import_core49.COMPLETE]]);
         }).catch((err) => {
           if (cancelled) return;
-          actions.down([[import_core48.ERROR, err]]);
+          actions.down([[import_core49.ERROR, err]]);
         });
-        return () => {
-          cancelled = true;
-          controller.abort();
+        return {
+          onDeactivation: () => {
+            cancelled = true;
+            controller.abort();
+          }
         };
       },
       { describeKind: "producer", ...{ name: "suggestStrategy::call" } }
@@ -8423,14 +8523,14 @@ function validateGraphDef(def) {
       errors.push(`Node "${name}": must be an object`);
       continue;
     }
-    const node38 = raw;
-    if (typeof node38.type !== "string" || !VALID_NODE_TYPES2.has(node38.type)) {
+    const node39 = raw;
+    if (typeof node39.type !== "string" || !VALID_NODE_TYPES2.has(node39.type)) {
       errors.push(
-        `Node "${name}": invalid type "${String(node38.type)}" (expected: ${[...VALID_NODE_TYPES2].join(", ")})`
+        `Node "${name}": invalid type "${String(node39.type)}" (expected: ${[...VALID_NODE_TYPES2].join(", ")})`
       );
     }
-    if (Array.isArray(node38.deps)) {
-      for (const dep of node38.deps) {
+    if (Array.isArray(node39.deps)) {
+      for (const dep of node39.deps) {
         if (typeof dep === "string" && !nodeNames.has(dep)) {
           errors.push(`Node "${name}": dep "${dep}" does not reference an existing node`);
         }