@graphrefly/graphrefly 0.6.0 → 0.8.0

package/dist/index.js

@@ -6,10 +6,13 @@ import {
   NS_PER_MS,
   NS_PER_SEC,
   SqliteCheckpointAdapter,
+  TimeoutError,
   audit,
   buffer,
   bufferCount,
   bufferTime,
+  cache,
+  cascadingCache,
   catchError,
   checkpointNodeValue,
   checkpointToRedis,
@@ -32,6 +35,7 @@ import {
   exhaustMap,
   exponential,
   extra_exports,
+  fallback,
   fibonacci,
   filter,
   find,
@@ -39,15 +43,18 @@ import {
   flatMap,
   fromCSV,
   fromClickHouseWatch,
+  fromDrizzle,
   fromGitHook,
   fromHTTP,
   fromIDBRequest,
   fromIDBTransaction,
   fromKafka,
+  fromKysely,
   fromMCP,
   fromNATS,
   fromNDJSON,
   fromOTel,
+  fromPrisma,
   fromPrometheus,
   fromPulsar,
   fromRabbitMQ,
@@ -61,6 +68,7 @@ import {
   interval,
   last,
   linear,
+  lru,
   map,
   merge,
   mergeMap,
@@ -98,6 +106,7 @@ import {
   tap,
   throttle,
   throttleTime,
+  tieredStorage,
   timeout,
   toCSV,
   toClickHouse,
@@ -128,14 +137,14 @@ import {
   workerBridge,
   workerSelf,
   zip
-} from "./chunk-V3UACY6A.js";
+} from "./chunk-TZLX4KIT.js";
 import {
   cqrs_exports,
   nestjs_exports
-} from "./chunk-QW7H3ICI.js";
+} from "./chunk-UCW3VWMN.js";
 import {
   core_exports
-} from "./chunk-CP6MNKAA.js";
+} from "./chunk-E7OH6ZAZ.js";
 import {
   JsonCodec,
   createDagCborCodec,
@@ -143,7 +152,7 @@ import {
   graph_exports,
   negotiateCodec,
   replayWAL
-} from "./chunk-HP7OKEOE.js";
+} from "./chunk-A2AJJOSJ.js";
 import {
   cached,
   createWatermarkController,
@@ -176,19 +185,25 @@ import {
   toArray,
   toMessages$,
   toObservable
-} from "./chunk-KWXPDASV.js";
+} from "./chunk-YWTP2XRJ.js";
 import {
+  ResettableTimer
+} from "./chunk-WZ2Z2CRV.js";
+import {
+  analyzeAndMeasure,
+  computeLineBreaks,
   reactive_layout_exports
-} from "./chunk-Z4Y4FMQN.js";
+} from "./chunk-XCZPGOVP.js";
 import {
   GRAPH_META_SEGMENT,
   Graph,
   reachable
-} from "./chunk-6W5SGIGB.js";
+} from "./chunk-WYI7YW54.js";
 import {
   describeNode,
-  metaSnapshot
-} from "./chunk-O3PI7W45.js";
+  metaSnapshot,
+  resolveDescribeFields
+} from "./chunk-LR2CLSEF.js";
 import {
   COMPLETE,
   DATA,
@@ -230,7 +245,7 @@ import {
   propagatesToMeta,
   state,
   wallClockNs
-} from "./chunk-5X3LAO3B.js";
+} from "./chunk-QTZSBQGJ.js";
 
 // src/compat/index.ts
 var compat_exports = {};
@@ -1029,6 +1044,7 @@ var patterns_exports = {};
 __export(patterns_exports, {
   ai: () => ai_exports,
   cqrs: () => cqrs_exports,
+  demoShell: () => demo_shell_exports,
   layout: () => reactive_layout_exports,
   memory: () => memory_exports,
   messaging: () => messaging_exports,
@@ -2349,7 +2365,7 @@ function metaToJsonSchema(meta) {
   return schema;
 }
 function knobsAsTools(graph, actor) {
-  const described = graph.describe({ actor });
+  const described = graph.describe({ actor, detail: "full" });
   const openai = [];
   const mcp = [];
   const definitions = [];
@@ -2357,10 +2373,11 @@ function knobsAsTools(graph, actor) {
     if (node2.type !== "state") continue;
     if (path.includes("::__meta__::")) continue;
     if (node2.status === "completed" || node2.status === "errored") continue;
-    const access = node2.meta.access;
+    const meta = node2.meta ?? {};
+    const access = meta.access;
     if (access === "human" || access === "system") continue;
-    const description = node2.meta.description ?? `Set the value of ${path}`;
-    const valueSchema = metaToJsonSchema(node2.meta);
+    const description = meta.description ?? `Set the value of ${path}`;
+    const valueSchema = metaToJsonSchema(meta);
     const parameterSchema = {
       type: "object",
       required: ["value"],
@@ -2400,14 +2417,15 @@ function knobsAsTools(graph, actor) {
   return { openai, mcp, definitions };
 }
 function gaugesAsContext(graph, actor, options) {
-  const described = graph.describe({ actor });
+  const described = graph.describe({ actor, detail: "full" });
   const groupByTags = options?.groupByTags ?? true;
   const separator = options?.separator ?? "\n";
   const entries = [];
   const sinceVersion = options?.sinceVersion;
   for (const [path, node2] of Object.entries(described.nodes)) {
-    const desc = node2.meta.description;
-    const format = node2.meta.format;
+    const meta = node2.meta ?? {};
+    const desc = meta.description;
+    const format = meta.format;
     if (!desc && !format) continue;
     if (sinceVersion != null && node2.v != null) {
       const lastSeen = sinceVersion.get(path);
@@ -2416,7 +2434,7 @@ function gaugesAsContext(graph, actor, options) {
     }
     const label = desc ?? path;
     const value = node2.value;
-    const unit = node2.meta.unit;
+    const unit = meta.unit;
     let formatted;
     if (format === "currency" && typeof value === "number") {
       formatted = `$${value.toFixed(2)}`;
@@ -2438,7 +2456,7 @@ function gaugesAsContext(graph, actor, options) {
     const ungrouped = [];
     for (const entry of entries) {
       const node2 = described.nodes[entry.path];
-      const tags = node2.meta.tags;
+      const tags = (node2.meta ?? {}).tags;
       if (tags && tags.length > 0) {
         const tag = tags[0];
         let group = tagGroups.get(tag);
@@ -2626,7 +2644,7 @@ Rules:
 - Keep changes minimal \u2014 prefer the smallest set of operations that solves the problem.
 - Return ONLY valid JSON, no markdown fences or commentary.`;
 async function suggestStrategy(graph, problem, adapter, opts) {
-  const described = graph.describe({ actor: opts?.actor });
+  const { expand: _, ...described } = graph.describe({ actor: opts?.actor, detail: "standard" });
   const messages = [
     { role: "system", content: SUGGEST_STRATEGY_SYSTEM_PROMPT },
     {
@@ -2670,6 +2688,341 @@ async function suggestStrategy(graph, problem, adapter, opts) {
   };
 }
 
+// src/patterns/demo-shell.ts
+var demo_shell_exports = {};
+__export(demo_shell_exports, {
+  demoShell: () => demoShell
+});
+function clamp01(v) {
+  return Math.max(0, Math.min(1, v));
+}
+function demoShell(opts) {
+  const mainRatioInit = clamp01(opts?.mainRatio ?? 0.65);
+  const sideSplitInit = clamp01(opts?.sideSplit ?? 0.5);
+  const viewportInit = Math.max(0, opts?.viewportWidth ?? 1280);
+  const registry = opts?.nodeRegistry ?? /* @__PURE__ */ new Map();
+  const adapter = opts?.adapter ?? null;
+  const layoutFont = opts?.layoutFont ?? "14px monospace";
+  const onHighlight = opts?.onHighlight;
+  const g = new Graph("demo-shell");
+  const paneMainRatio = state(mainRatioInit, { name: "pane/main-ratio" });
+  const paneSideSplit = state(sideSplitInit, { name: "pane/side-split" });
+  const paneFullscreen = state(null, {
+    name: "pane/fullscreen"
+  });
+  const viewportWidth = state(viewportInit, { name: "viewport/width" });
+  g.add("pane/main-ratio", paneMainRatio);
+  g.add("pane/side-split", paneSideSplit);
+  g.add("pane/fullscreen", paneFullscreen);
+  g.add("viewport/width", viewportWidth);
+  const paneMainWidth = derived(
+    [paneMainRatio, viewportWidth, paneFullscreen],
+    ([ratio, vw, fs]) => {
+      const r = ratio;
+      const w = vw;
+      const fullscreen = fs;
+      if (fullscreen === "main") return w;
+      if (fullscreen === "graph" || fullscreen === "code") return 0;
+      return Math.round(w * r);
+    },
+    { name: "pane/main-width" }
+  );
+  const paneSideWidth = derived(
+    [paneMainWidth, viewportWidth, paneFullscreen],
+    ([main, vw, fs]) => {
+      const fullscreen = fs;
+      const w = vw;
+      if (fullscreen === "main") return 0;
+      if (fullscreen === "graph" || fullscreen === "code") return w;
+      return w - main;
+    },
+    { name: "pane/side-width" }
+  );
+  const paneGraphHeight = derived(
+    [paneSideSplit, paneFullscreen],
+    ([split, fs]) => {
+      const fullscreen = fs;
+      if (fullscreen === "graph") return 1;
+      if (fullscreen === "code") return 0;
+      if (fullscreen === "main") return 0;
+      return clamp01(split);
+    },
+    { name: "pane/graph-height-ratio" }
+  );
+  const paneCodeHeight = derived(
+    [paneGraphHeight, paneFullscreen],
+    ([graphH, fs]) => {
+      const fullscreen = fs;
+      if (fullscreen === "code") return 1;
+      if (fullscreen === "graph" || fullscreen === "main") return 0;
+      return 1 - graphH;
+    },
+    { name: "pane/code-height-ratio" }
+  );
+  g.add("pane/main-width", paneMainWidth);
+  g.add("pane/side-width", paneSideWidth);
+  g.add("pane/graph-height-ratio", paneGraphHeight);
+  g.add("pane/code-height-ratio", paneCodeHeight);
+  const demoGraphRef = state(null, {
+    name: "demo/graph-ref"
+  });
+  const demoGraphTick = state(0, { name: "demo/graph-tick" });
+  g.add("demo/graph-ref", demoGraphRef);
+  g.add("demo/graph-tick", demoGraphTick);
+  const graphMermaid = derived(
+    [demoGraphRef, demoGraphTick],
+    ([ref, _tick]) => {
+      const demo = ref;
+      if (!demo) return "";
+      return demo.toMermaid();
+    },
+    { name: "graph/mermaid" }
+  );
+  const graphDescribe = derived(
+    [demoGraphRef, demoGraphTick],
+    ([ref, _tick]) => {
+      const demo = ref;
+      if (!demo) return null;
+      const { expand: _, ...snapshot } = demo.describe({ detail: "standard" });
+      return snapshot;
+    },
+    { name: "graph/describe" }
+  );
+  g.add("graph/mermaid", graphMermaid);
+  g.add("graph/describe", graphDescribe);
+  const hoverTarget = state(null, { name: "hover/target" });
+  g.add("hover/target", hoverTarget);
+  const highlightCodeScroll = derived(
+    [hoverTarget],
+    ([target]) => {
+      const t = target;
+      if (!t) return null;
+      const entry = registry.get(t.id);
+      return entry ? entry.codeLine : null;
+    },
+    { name: "highlight/code-scroll" }
+  );
+  const highlightVisual = derived(
+    [hoverTarget],
+    ([target]) => {
+      const t = target;
+      if (!t) return null;
+      const entry = registry.get(t.id);
+      return entry ? entry.visualSelector : null;
+    },
+    { name: "highlight/visual" }
+  );
+  const highlightGraph = derived(
+    [hoverTarget],
+    ([target]) => {
+      const t = target;
+      if (!t) return null;
+      return t.id;
+    },
+    { name: "highlight/graph" }
+  );
+  g.add("highlight/code-scroll", highlightCodeScroll);
+  g.add("highlight/visual", highlightVisual);
+  g.add("highlight/graph", highlightGraph);
+  if (onHighlight?.codeScroll) {
+    const cb = onHighlight.codeScroll;
+    const applyCodeScroll = effect([highlightCodeScroll], ([line]) => {
+      cb(line);
+    });
+    g.add("highlight/apply-code-scroll", applyCodeScroll);
+    g.connect("highlight/code-scroll", "highlight/apply-code-scroll");
+  }
+  if (onHighlight?.visual) {
+    const cb = onHighlight.visual;
+    const applyVisual = effect([highlightVisual], ([selector]) => {
+      cb(selector);
+    });
+    g.add("highlight/apply-visual", applyVisual);
+    g.connect("highlight/visual", "highlight/apply-visual");
+  }
+  if (onHighlight?.graph) {
+    const cb = onHighlight.graph;
+    const applyGraph = effect([highlightGraph], ([nodeId]) => {
+      cb(nodeId);
+    });
+    g.add("highlight/apply-graph", applyGraph);
+    g.connect("highlight/graph", "highlight/apply-graph");
+  }
+  const inspectSelected = state(null, {
+    name: "inspect/selected-node"
+  });
+  g.add("inspect/selected-node", inspectSelected);
+  const standardFields = resolveDescribeFields("standard");
+  const inspectNodeDetail = derived(
+    [inspectSelected, demoGraphRef, demoGraphTick],
+    ([path, ref, _tick]) => {
+      const demo = ref;
+      const p = path;
+      if (!demo || !p) return null;
+      try {
+        const nd = demo.resolve(p);
+        const nodeDesc = describeNode(nd, standardFields);
+        return { path: p, ...nodeDesc, value: nd.get() };
+      } catch {
+        return null;
+      }
+    },
+    { name: "inspect/node-detail" }
+  );
+  const inspectTraceLog = derived(
+    [demoGraphRef, demoGraphTick],
+    ([ref, _tick]) => {
+      const demo = ref;
+      if (!demo) return [];
+      return demo.traceLog();
+    },
+    { name: "inspect/trace-log" }
+  );
+  g.add("inspect/node-detail", inspectNodeDetail);
+  g.add("inspect/trace-log", inspectTraceLog);
+  const metaDebug = state(false, { name: "meta/debug" });
+  g.add("meta/debug", metaDebug);
+  const metaShellMermaid = derived(
+    [metaDebug, demoGraphTick],
+    ([debug, _tick]) => {
+      if (!debug) return "";
+      return g.toMermaid();
+    },
+    { name: "meta/shell-mermaid" }
+  );
+  g.add("meta/shell-mermaid", metaShellMermaid);
+  const codeTextNode = state("", { name: "layout/code-text" });
+  g.add("layout/code-text", codeTextNode);
+  if (adapter) {
+    const measureCache = /* @__PURE__ */ new Map();
+    const graphLabels = derived(
+      [graphDescribe],
+      ([desc]) => {
+        const d = desc;
+        if (!d) return /* @__PURE__ */ new Map();
+        const result = /* @__PURE__ */ new Map();
+        for (const [name] of Object.entries(d.nodes)) {
+          const segments = analyzeAndMeasure(name, layoutFont, adapter, measureCache);
+          const lb = computeLineBreaks(segments, Infinity, adapter, layoutFont, measureCache);
+          const width = lb.lines.reduce((max, l) => Math.max(max, l.width), 0);
+          const height = lb.lineCount * 20;
+          result.set(name, { width, height });
+        }
+        return result;
+      },
+      {
+        name: "layout/graph-labels",
+        equals: (a, b) => {
+          if (a === b) return true;
+          const ma = a;
+          const mb = b;
+          if (ma.size !== mb.size) return false;
+          for (const [k, v] of ma) {
+            const bv = mb.get(k);
+            if (!bv || bv.width !== v.width || bv.height !== v.height) return false;
+          }
+          return true;
+        }
+      }
+    );
+    const codeLines = derived(
+      [codeTextNode, paneSideWidth],
+      ([text, sideW]) => {
+        const t = text;
+        if (!t) return { lineCount: 0, lines: [] };
+        const segments = analyzeAndMeasure(t, layoutFont, adapter, measureCache);
+        const maxW = sideW - 40;
+        return computeLineBreaks(segments, Math.max(100, maxW), adapter, layoutFont, measureCache);
+      },
+      { name: "layout/code-lines" }
+    );
+    const sideWidthHint = derived(
+      [graphLabels],
+      ([labels]) => {
+        const m = labels;
+        if (m.size === 0) return 200;
+        let maxW = 0;
+        for (const { width } of m.values()) {
+          if (width > maxW) maxW = width;
+        }
+        return Math.max(200, Math.round(maxW + 80));
+      },
+      { name: "layout/side-width-hint" }
+    );
+    g.add("layout/graph-labels", graphLabels);
+    g.add("layout/code-lines", codeLines);
+    g.add("layout/side-width-hint", sideWidthHint);
+    g.connect("graph/describe", "layout/graph-labels");
+    g.connect("layout/code-text", "layout/code-lines");
+    g.connect("pane/side-width", "layout/code-lines");
+    g.connect("layout/graph-labels", "layout/side-width-hint");
+  }
+  g.connect("pane/main-ratio", "pane/main-width");
+  g.connect("viewport/width", "pane/main-width");
+  g.connect("pane/fullscreen", "pane/main-width");
+  g.connect("pane/main-width", "pane/side-width");
+  g.connect("viewport/width", "pane/side-width");
+  g.connect("pane/fullscreen", "pane/side-width");
+  g.connect("pane/side-split", "pane/graph-height-ratio");
+  g.connect("pane/fullscreen", "pane/graph-height-ratio");
+  g.connect("pane/graph-height-ratio", "pane/code-height-ratio");
+  g.connect("pane/fullscreen", "pane/code-height-ratio");
+  g.connect("demo/graph-ref", "graph/mermaid");
+  g.connect("demo/graph-tick", "graph/mermaid");
+  g.connect("demo/graph-ref", "graph/describe");
+  g.connect("demo/graph-tick", "graph/describe");
+  g.connect("hover/target", "highlight/code-scroll");
+  g.connect("hover/target", "highlight/visual");
+  g.connect("hover/target", "highlight/graph");
+  g.connect("inspect/selected-node", "inspect/node-detail");
+  g.connect("demo/graph-ref", "inspect/node-detail");
+  g.connect("demo/graph-tick", "inspect/node-detail");
+  g.connect("demo/graph-ref", "inspect/trace-log");
+  g.connect("demo/graph-tick", "inspect/trace-log");
+  g.connect("meta/debug", "meta/shell-mermaid");
+  g.connect("demo/graph-tick", "meta/shell-mermaid");
+  let tickCounter = 0;
+  return {
+    graph: g,
+    setMainRatio(ratio) {
+      g.set("pane/main-ratio", clamp01(ratio));
+    },
+    setSideSplit(ratio) {
+      g.set("pane/side-split", clamp01(ratio));
+    },
+    setFullscreen(pane) {
+      g.set("pane/fullscreen", pane);
+    },
+    setViewportWidth(width) {
+      g.set("viewport/width", Math.max(0, width));
+    },
+    setHoverTarget(target) {
+      g.set("hover/target", target);
+    },
+    setDemoGraph(demo) {
+      g.set("demo/graph-ref", demo);
+    },
+    bumpGraphTick() {
+      g.set("demo/graph-tick", ++tickCounter);
+    },
+    selectNode(path) {
+      g.set("inspect/selected-node", path);
+    },
+    setMetaDebug(on) {
+      g.set("meta/debug", on);
+    },
+    setCodeText(text) {
+      g.set("layout/code-text", text);
+    },
+    batch(fn) {
+      batch(fn);
+    },
+    destroy() {
+      g.destroy();
+    }
+  };
+}
+
 // src/patterns/messaging.ts
 var messaging_exports = {};
 __export(messaging_exports, {
@@ -3472,8 +3825,10 @@ export {
   PAUSE,
   RESOLVED,
   RESUME,
+  ResettableTimer,
   SqliteCheckpointAdapter,
   TEARDOWN,
+  TimeoutError,
   accessHintForGuard,
   advanceVersion,
   ai_exports as ai,
@@ -3482,7 +3837,9 @@ export {
   buffer,
   bufferCount,
   bufferTime,
+  cache,
   cached,
+  cascadingCache,
   catchError,
   checkpointNodeValue,
   checkpointToRedis,
@@ -3506,6 +3863,7 @@ export {
   decorrelatedJitter,
   defaultHash,
   delay,
+  demo_shell_exports as demoShell,
   derived,
   describeNode,
   deserializeError,
@@ -3520,6 +3878,7 @@ export {
   exhaustMap,
   exponential,
   extra_exports as extra,
+  fallback,
   fibonacci,
   filter,
   find,
@@ -3532,6 +3891,7 @@ export {
   fromCSV,
   fromClickHouseWatch,
   fromCron,
+  fromDrizzle,
   fromEvent,
   fromFSWatch,
   fromGitHook,
@@ -3540,10 +3900,12 @@ export {
   fromIDBTransaction,
   fromIter,
   fromKafka,
+  fromKysely,
   fromMCP,
   fromNATS,
   fromNDJSON,
   fromOTel,
+  fromPrisma,
   fromPrometheus,
   fromPromise,
   fromPulsar,
@@ -3570,6 +3932,7 @@ export {
   reactive_layout_exports as layout,
   linear,
   logSlice,
+  lru,
   map,
   matchesAnyPattern,
   matchesCron,
@@ -3619,6 +3982,7 @@ export {
   replayWAL,
   rescue,
   resolveBackoffPreset,
+  resolveDescribeFields,
   restoreGraphCheckpoint,
   restoreGraphCheckpointIndexedDb,
   retry,
@@ -3644,6 +4008,7 @@ export {
   throttle,
   throttleTime,
   throwError,
+  tieredStorage,
   timeout,
   toArray,
   toCSV,