@graphrefly/graphrefly 0.47.1 → 0.48.0

package/dist/{chunk-K7PDZYQE.js → chunk-MQMTRKY3.js}

@@ -1,17 +1,17 @@
 import {
   compileSpec
-} from "./chunk-2OB3CEJS.js";
+} from "./chunk-B5Y5GPD5.js";
 import {
   pipelineGraph
-} from "./chunk-7ADWWI2T.js";
+} from "./chunk-ZW32BPXV.js";
 import {
   cascadingLlmAdapter
-} from "./chunk-4GYMCUDZ.js";
+} from "./chunk-T2U6N3FV.js";
 import {
   CircuitOpenError,
   adaptiveRateLimiter,
   circuitBreaker
-} from "./chunk-RJOG4IJU.js";
+} from "./chunk-T5URUIIY.js";
 import {
   adaptInvokeResult,
   adapterWrapper,
@@ -20,18 +20,18 @@ import {
   emptyUsageStub,
   withLayer,
   withReplayCache
-} from "./chunk-CXANAIZU.js";
+} from "./chunk-XEWV254I.js";
 import {
   aiMeta,
   resolveToolHandlerResult,
   stripFences
-} from "./chunk-YXCPV26R.js";
+} from "./chunk-3REMCHSS.js";
 import {
   topic
-} from "./chunk-NPRP3MCV.js";
+} from "./chunk-DHDCOOJU.js";
 import {
   firstValueFrom
-} from "./chunk-O3MT7DYI.js";
+} from "./chunk-N6MNJNHB.js";
 
 // src/utils/ai/adapters/core/capabilities.ts
 import { node } from "@graphrefly/pure-ts/core";
@@ -1971,14 +1971,88 @@ function handoff(from, toFactory, opts) {
   );
 }
 
-// src/utils/ai/agents/tool-selector.ts
-import { factoryTag as factoryTag4, node as node13 } from "@graphrefly/pure-ts/core";
+// src/utils/ai/agents/tool-interceptor.ts
+import { factoryTag as factoryTag4, node as node13, RESOLVED } from "@graphrefly/pure-ts/core";
 import { fromAny as fromAny10 } from "@graphrefly/pure-ts/extra";
+function toolInterceptor(opts = {}) {
+  return (calls) => {
+    const enabledNode = opts.enabled != null ? fromAny10(opts.enabled) : void 0;
+    const predNodes = (opts.allow ?? []).map((p) => fromAny10(p));
+    const deps = [calls, ...enabledNode ? [enabledNode] : [], ...predNodes];
+    return node13(
+      deps,
+      (batchData, actions, ctx) => {
+        const callsBatch = batchData[0];
+        if (callsBatch == null || callsBatch.length === 0) {
+          actions.down([[RESOLVED]]);
+          return;
+        }
+        const data = batchData.map(
+          (batch2, i) => batch2 != null && batch2.length > 0 ? batch2.at(-1) : ctx.prevData[i]
+        );
+        const incoming = data[0] ?? [];
+        let cursor = 1;
+        if (enabledNode) {
+          const enabled = data[cursor++];
+          if (enabled === false) {
+            actions.down([[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([[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"), ...factoryTag4("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-selector.ts
+import { factoryTag as factoryTag5, node as node14 } from "@graphrefly/pure-ts/core";
+import { fromAny as fromAny11 } from "@graphrefly/pure-ts/extra";
 function toolSelector(allTools, constraints, opts) {
-  const allToolsNode = fromAny10(allTools);
-  const constraintNodes = constraints.map((c) => fromAny10(c));
+  const allToolsNode = fromAny11(allTools);
+  const constraintNodes = constraints.map((c) => fromAny11(c));
   const deps = [allToolsNode, ...constraintNodes];
-  return node13(
+  return node14(
     deps,
     (batchData, actions, ctx) => {
       const data = batchData.map(
@@ -1999,7 +2073,7 @@ function toolSelector(allTools, constraints, opts) {
     {
       name: opts?.name ?? "tool-selector",
       describeKind: "derived",
-      meta: { ...aiMeta("tool_selector"), ...factoryTag4("toolSelector") },
+      meta: { ...aiMeta("tool_selector"), ...factoryTag5("toolSelector") },
       equals: (a, b) => {
         const la = a;
         const lb = b;
@@ -2052,18 +2126,18 @@ function gaugesAsContext(graph, actor, options) {
   const separator = options?.separator ?? "\n";
   const entries = [];
   const sinceVersion = options?.sinceVersion;
-  for (const [path, node16] of Object.entries(described.nodes)) {
-    const meta = node16.meta ?? {};
+  for (const [path, node17] of Object.entries(described.nodes)) {
+    const meta = node17.meta ?? {};
     const desc = meta.description;
     const format = meta.format;
     if (!desc && !format) continue;
-    if (sinceVersion != null && node16.v != null) {
+    if (sinceVersion != null && node17.v != null) {
       const lastSeen = sinceVersion.get(path);
-      if (lastSeen != null && lastSeen.id === node16.v.id && node16.v.version <= lastSeen.version)
+      if (lastSeen != null && lastSeen.id === node17.v.id && node17.v.version <= lastSeen.version)
         continue;
     }
     const label = desc ?? path;
-    const value = node16.value;
+    const value = node17.value;
     const unit = meta.unit;
     let formatted;
     if (format === "currency" && typeof value === "number") {
@@ -2085,8 +2159,8 @@ function gaugesAsContext(graph, actor, options) {
     const tagGroups = /* @__PURE__ */ new Map();
     const ungrouped = [];
     for (const entry of entries) {
-      const node16 = described.nodes[entry.path];
-      const tags = node16.meta?.tags;
+      const node17 = described.nodes[entry.path];
+      const tags = node17.meta?.tags;
       if (tags && tags.length > 0) {
         const tag = tags[0];
         let group = tagGroups.get(tag);
@@ -2117,8 +2191,8 @@ function gaugesAsContext(graph, actor, options) {
 }
 
 // src/utils/ai/graph-integration/graph-from-spec.ts
-import { COMPLETE, ERROR, node as node14 } from "@graphrefly/pure-ts/core";
-import { fromAny as fromAny11, switchMap as switchMap3 } from "@graphrefly/pure-ts/extra";
+import { COMPLETE, ERROR, node as node15 } from "@graphrefly/pure-ts/core";
+import { fromAny as fromAny12, switchMap as switchMap3 } from "@graphrefly/pure-ts/extra";
 var GRAPH_FROM_SPEC_SYSTEM_PROMPT = `You are a graph architect for GraphReFly, a reactive graph protocol.
 
 Given a natural-language description, produce a JSON graph specification with this structure:
@@ -2181,12 +2255,12 @@ ${opts.systemPromptExtra}` : GRAPH_FROM_SPEC_SYSTEM_PROMPT;
   return compileSpec(parsed, { catalog: opts?.catalog });
 }
 function graphFromSpecReactive(input, adapter, opts) {
-  const inputNode = fromAny11(input);
+  const inputNode = fromAny12(input);
   return switchMap3(inputNode, (nl) => {
     if (!nl || typeof nl !== "string" || nl.trim().length === 0) {
-      return node14([], { initial: null });
+      return node15([], { initial: null });
     }
-    return node14(
+    return node15(
       (_data, actions) => {
         const controller = new AbortController();
         let cancelled = false;
@@ -2201,9 +2275,11 @@ function graphFromSpecReactive(input, adapter, opts) {
           if (cancelled) return;
           actions.down([[ERROR, err]]);
         });
-        return () => {
-          cancelled = true;
-          controller.abort();
+        return {
+          onDeactivation: () => {
+            cancelled = true;
+            controller.abort();
+          }
         };
       },
       { describeKind: "producer", ...{ name: "graphFromSpec::call" } }
@@ -2250,11 +2326,11 @@ function knobsAsTools(graph, actor) {
   const openai = [];
   const mcp = [];
   const definitions = [];
-  for (const [path, node16] of Object.entries(described.nodes)) {
-    if (node16.type !== "state") continue;
+  for (const [path, node17] of Object.entries(described.nodes)) {
+    if (node17.type !== "state") continue;
     if (path.includes("::__meta__::")) continue;
-    if (node16.status === "completed" || node16.status === "errored") continue;
-    const meta = node16.meta ?? {};
+    if (node17.status === "completed" || node17.status === "errored") continue;
+    const meta = node17.meta ?? {};
     const access = meta.access;
     if (access === "human" || access === "system") continue;
     const description = meta.description ?? `Set the value of ${path}`;
@@ -2283,7 +2359,7 @@ function knobsAsTools(graph, actor) {
     });
     const graphRef = graph;
     const actorRef = actor;
-    const nv = node16.v;
+    const nv = node17.v;
     definitions.push({
       name: path,
       description,
@@ -2299,8 +2375,8 @@ function knobsAsTools(graph, actor) {
 }
 
 // src/utils/ai/graph-integration/suggest-strategy.ts
-import { COMPLETE as COMPLETE2, ERROR as ERROR2, node as node15 } from "@graphrefly/pure-ts/core";
-import { fromAny as fromAny12, switchMap as switchMap4, withLatestFrom } from "@graphrefly/pure-ts/extra";
+import { COMPLETE as COMPLETE2, ERROR as ERROR2, node as node16 } from "@graphrefly/pure-ts/core";
+import { fromAny as fromAny13, switchMap as switchMap4, withLatestFrom } from "@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.
@@ -2369,16 +2445,16 @@ async function suggestStrategy(graph, problem, adapter, opts) {
   };
 }
 function suggestStrategyReactive(graph, problem, adapter, opts) {
-  const problemNode = fromAny12(problem);
+  const problemNode = fromAny13(problem);
   const paired = withLatestFrom(problemNode, graph);
   return switchMap4(paired, (pair) => {
-    if (pair == null) return node15([], { initial: null });
+    if (pair == null) return node16([], { initial: null });
     const [pText, g] = pair;
     if (!g || !pText || typeof pText !== "string" || pText.trim().length === 0) {
-      return node15([], { initial: null });
+      return node16([], { initial: null });
     }
-    if (g.destroyed) return node15([], { initial: null });
-    return node15(
+    if (g.destroyed) return node16([], { initial: null });
+    return node16(
       (_data, actions) => {
         const controller = new AbortController();
         let cancelled = false;
@@ -2390,9 +2466,11 @@ function suggestStrategyReactive(graph, problem, adapter, opts) {
           if (cancelled) return;
           actions.down([[ERROR2, err]]);
         });
-        return () => {
-          cancelled = true;
-          controller.abort();
+        return {
+          onDeactivation: () => {
+            cancelled = true;
+            controller.abort();
+          }
         };
       },
       { describeKind: "producer", ...{ name: "suggestStrategy::call" } }
@@ -2421,14 +2499,14 @@ function validateGraphDef(def) {
       errors.push(`Node "${name}": must be an object`);
       continue;
     }
-    const node16 = raw;
-    if (typeof node16.type !== "string" || !VALID_NODE_TYPES.has(node16.type)) {
+    const node17 = raw;
+    if (typeof node17.type !== "string" || !VALID_NODE_TYPES.has(node17.type)) {
       errors.push(
-        `Node "${name}": invalid type "${String(node16.type)}" (expected: ${[...VALID_NODE_TYPES].join(", ")})`
+        `Node "${name}": invalid type "${String(node17.type)}" (expected: ${[...VALID_NODE_TYPES].join(", ")})`
       );
     }
-    if (Array.isArray(node16.deps)) {
-      for (const dep of node16.deps) {
+    if (Array.isArray(node17.deps)) {
+      for (const dep of node17.deps) {
         if (typeof dep === "string" && !nodeNames.has(dep)) {
           errors.push(`Node "${name}": dep "${dep}" does not reference an existing node`);
         }
@@ -2494,6 +2572,7 @@ export {
   contentGate,
   redactor,
   handoff,
+  toolInterceptor,
   toolSelector,
   admissionScored,
   admissionFilter3D,
@@ -2505,4 +2584,4 @@ export {
   suggestStrategyReactive,
   validateGraphDef
 };
-//# sourceMappingURL=chunk-K7PDZYQE.js.map
+//# sourceMappingURL=chunk-MQMTRKY3.js.map