@graphrefly/graphrefly 0.26.0 → 0.28.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@graphrefly/graphrefly",
-	"version": "0.26.0",
+	"version": "0.28.0",
 	"packageManager": "pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319",
 	"description": "Reactive harness layer for agent workflows. Describe automations in plain language, trace every decision, enforce policies, persist checkpoints. Zero dependencies.",
 	"repository": {
@@ -47,6 +47,26 @@
 				"default": "./dist/extra/index.cjs"
 			}
 		},
+		"./extra/node": {
+			"import": {
+				"types": "./dist/extra/node.d.ts",
+				"default": "./dist/extra/node.js"
+			},
+			"require": {
+				"types": "./dist/extra/node.d.cts",
+				"default": "./dist/extra/node.cjs"
+			}
+		},
+		"./extra/browser": {
+			"import": {
+				"types": "./dist/extra/browser.d.ts",
+				"default": "./dist/extra/browser.js"
+			},
+			"require": {
+				"types": "./dist/extra/browser.d.cts",
+				"default": "./dist/extra/browser.cjs"
+			}
+		},
 		"./extra/sources": {
 			"import": {
 				"types": "./dist/extra/sources.d.ts",
@@ -57,6 +77,56 @@
 				"default": "./dist/extra/sources.cjs"
 			}
 		},
+		"./extra/operators": {
+			"import": {
+				"types": "./dist/extra/operators.d.ts",
+				"default": "./dist/extra/operators.js"
+			},
+			"require": {
+				"types": "./dist/extra/operators.d.cts",
+				"default": "./dist/extra/operators.cjs"
+			}
+		},
+		"./extra/reactive": {
+			"import": {
+				"types": "./dist/extra/reactive.d.ts",
+				"default": "./dist/extra/reactive.js"
+			},
+			"require": {
+				"types": "./dist/extra/reactive.d.cts",
+				"default": "./dist/extra/reactive.cjs"
+			}
+		},
+		"./extra/storage-core": {
+			"import": {
+				"types": "./dist/extra/storage-core.d.ts",
+				"default": "./dist/extra/storage-core.js"
+			},
+			"require": {
+				"types": "./dist/extra/storage-core.d.cts",
+				"default": "./dist/extra/storage-core.cjs"
+			}
+		},
+		"./extra/storage-node": {
+			"import": {
+				"types": "./dist/extra/storage-node.d.ts",
+				"default": "./dist/extra/storage-node.js"
+			},
+			"require": {
+				"types": "./dist/extra/storage-node.d.cts",
+				"default": "./dist/extra/storage-node.cjs"
+			}
+		},
+		"./extra/storage-browser": {
+			"import": {
+				"types": "./dist/extra/storage-browser.d.ts",
+				"default": "./dist/extra/storage-browser.js"
+			},
+			"require": {
+				"types": "./dist/extra/storage-browser.d.cts",
+				"default": "./dist/extra/storage-browser.cjs"
+			}
+		},
 		"./graph": {
 			"import": {
 				"types": "./dist/graph/index.d.ts",
@@ -157,6 +227,166 @@
 				"default": "./dist/compat/nestjs/index.cjs"
 			}
 		},
+		"./patterns/ai": {
+			"import": {
+				"types": "./dist/patterns/ai/index.d.ts",
+				"default": "./dist/patterns/ai/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/ai/index.d.cts",
+				"default": "./dist/patterns/ai/index.cjs"
+			}
+		},
+		"./patterns/ai/node": {
+			"import": {
+				"types": "./dist/patterns/ai/node.d.ts",
+				"default": "./dist/patterns/ai/node.js"
+			},
+			"require": {
+				"types": "./dist/patterns/ai/node.d.cts",
+				"default": "./dist/patterns/ai/node.cjs"
+			}
+		},
+		"./patterns/ai/browser": {
+			"browser": {
+				"import": {
+					"types": "./dist/patterns/ai/browser.d.ts",
+					"default": "./dist/patterns/ai/browser.js"
+				},
+				"require": {
+					"types": "./dist/patterns/ai/browser.d.cts",
+					"default": "./dist/patterns/ai/browser.cjs"
+				}
+			},
+			"import": {
+				"types": "./dist/patterns/ai/browser.d.ts",
+				"default": "./dist/patterns/ai/browser.js"
+			},
+			"require": {
+				"types": "./dist/patterns/ai/browser.d.cts",
+				"default": "./dist/patterns/ai/browser.cjs"
+			}
+		},
+		"./patterns/audit": {
+			"import": {
+				"types": "./dist/patterns/audit/index.d.ts",
+				"default": "./dist/patterns/audit/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/audit/index.d.cts",
+				"default": "./dist/patterns/audit/index.cjs"
+			}
+		},
+		"./patterns/cqrs": {
+			"import": {
+				"types": "./dist/patterns/cqrs/index.d.ts",
+				"default": "./dist/patterns/cqrs/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/cqrs/index.d.cts",
+				"default": "./dist/patterns/cqrs/index.cjs"
+			}
+		},
+		"./patterns/demo-shell": {
+			"import": {
+				"types": "./dist/patterns/demo-shell/index.d.ts",
+				"default": "./dist/patterns/demo-shell/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/demo-shell/index.d.cts",
+				"default": "./dist/patterns/demo-shell/index.cjs"
+			}
+		},
+		"./patterns/domain-templates": {
+			"import": {
+				"types": "./dist/patterns/domain-templates/index.d.ts",
+				"default": "./dist/patterns/domain-templates/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/domain-templates/index.d.cts",
+				"default": "./dist/patterns/domain-templates/index.cjs"
+			}
+		},
+		"./patterns/graphspec": {
+			"import": {
+				"types": "./dist/patterns/graphspec/index.d.ts",
+				"default": "./dist/patterns/graphspec/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/graphspec/index.d.cts",
+				"default": "./dist/patterns/graphspec/index.cjs"
+			}
+		},
+		"./patterns/guarded-execution": {
+			"import": {
+				"types": "./dist/patterns/guarded-execution/index.d.ts",
+				"default": "./dist/patterns/guarded-execution/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/guarded-execution/index.d.cts",
+				"default": "./dist/patterns/guarded-execution/index.cjs"
+			}
+		},
+		"./patterns/harness": {
+			"import": {
+				"types": "./dist/patterns/harness/index.d.ts",
+				"default": "./dist/patterns/harness/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/harness/index.d.cts",
+				"default": "./dist/patterns/harness/index.cjs"
+			}
+		},
+		"./patterns/job-queue": {
+			"import": {
+				"types": "./dist/patterns/job-queue/index.d.ts",
+				"default": "./dist/patterns/job-queue/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/job-queue/index.d.cts",
+				"default": "./dist/patterns/job-queue/index.cjs"
+			}
+		},
+		"./patterns/lens": {
+			"import": {
+				"types": "./dist/patterns/lens/index.d.ts",
+				"default": "./dist/patterns/lens/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/lens/index.d.cts",
+				"default": "./dist/patterns/lens/index.cjs"
+			}
+		},
+		"./patterns/memory": {
+			"import": {
+				"types": "./dist/patterns/memory/index.d.ts",
+				"default": "./dist/patterns/memory/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/memory/index.d.cts",
+				"default": "./dist/patterns/memory/index.cjs"
+			}
+		},
+		"./patterns/messaging": {
+			"import": {
+				"types": "./dist/patterns/messaging/index.d.ts",
+				"default": "./dist/patterns/messaging/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/messaging/index.d.cts",
+				"default": "./dist/patterns/messaging/index.cjs"
+			}
+		},
+		"./patterns/orchestration": {
+			"import": {
+				"types": "./dist/patterns/orchestration/index.d.ts",
+				"default": "./dist/patterns/orchestration/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/orchestration/index.d.cts",
+				"default": "./dist/patterns/orchestration/index.cjs"
+			}
+		},
 		"./patterns/reactive-layout": {
 			"import": {
 				"types": "./dist/patterns/reactive-layout/index.d.ts",
@@ -167,14 +397,44 @@
 				"default": "./dist/patterns/reactive-layout/index.cjs"
 			}
 		},
-		"./patterns/demo-shell": {
+		"./patterns/reduction": {
+			"import": {
+				"types": "./dist/patterns/reduction/index.d.ts",
+				"default": "./dist/patterns/reduction/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/reduction/index.d.cts",
+				"default": "./dist/patterns/reduction/index.cjs"
+			}
+		},
+		"./patterns/refine-loop": {
+			"import": {
+				"types": "./dist/patterns/refine-loop/index.d.ts",
+				"default": "./dist/patterns/refine-loop/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/refine-loop/index.d.cts",
+				"default": "./dist/patterns/refine-loop/index.cjs"
+			}
+		},
+		"./patterns/resilient-pipeline": {
+			"import": {
+				"types": "./dist/patterns/resilient-pipeline/index.d.ts",
+				"default": "./dist/patterns/resilient-pipeline/index.js"
+			},
+			"require": {
+				"types": "./dist/patterns/resilient-pipeline/index.d.cts",
+				"default": "./dist/patterns/resilient-pipeline/index.cjs"
+			}
+		},
+		"./patterns/surface": {
 			"import": {
-				"types": "./dist/patterns/demo-shell.d.ts",
-				"default": "./dist/patterns/demo-shell.js"
+				"types": "./dist/patterns/surface/index.d.ts",
+				"default": "./dist/patterns/surface/index.js"
 			},
 			"require": {
-				"types": "./dist/patterns/demo-shell.d.cts",
-				"default": "./dist/patterns/demo-shell.cjs"
+				"types": "./dist/patterns/surface/index.d.cts",
+				"default": "./dist/patterns/surface/index.cjs"
 			}
 		}
 	},
@@ -187,7 +447,7 @@
 	},
 	"scripts": {
 		"docs:dev": "pnpm --dir website dev",
-		"docs:build": "pnpm --dir website build && pnpm --dir demos/compat-matrix build && pnpm --dir demos/reactive-layout build && cp -r demos/compat-matrix/dist/. website/dist/demos/compat-matrix/ && cp -r demos/reactive-layout/dist/. website/dist/demos/reactive-layout/",
+		"docs:build": "pnpm build && pnpm --dir website build && pnpm --dir demos/compat-matrix build && pnpm --dir demos/reactive-layout build && pnpm --dir demos/knowledge-graph build && pnpm --dir demos/pagerduty-triage build && cp -r demos/compat-matrix/dist/. website/dist/demos/compat-matrix/ && cp -r demos/reactive-layout/dist/. website/dist/demos/reactive-layout/ && cp -r demos/knowledge-graph/dist/. website/dist/demos/knowledge-graph/ && cp -r demos/pagerduty-triage/dist/. website/dist/demos/pagerduty-triage/",
 		"docs:preview": "pnpm --dir website preview",
 		"build": "tsup",
 		"test": "vitest run",

package/dist/chunk-3ZWCKRHX.js

@@ -1,117 +0,0 @@
-import {
-  resolveDescribeFields
-} from "./chunk-VYPWMZ6H.js";
-import {
-  DEFAULT_ACTOR,
-  GraphReFlyConfig,
-  GuardDenied,
-  NodeImpl,
-  accessHintForGuard,
-  advanceVersion,
-  autoTrackNode,
-  batch,
-  configure,
-  createVersioning,
-  defaultConfig,
-  defaultHash,
-  derived,
-  downWithBatch,
-  dynamicNode,
-  effect,
-  isBatching,
-  isV1,
-  monotonicNs,
-  node,
-  normalizeActor,
-  pipe,
-  policy,
-  policyFromRules,
-  producer,
-  registerBuiltins,
-  state,
-  wallClockNs
-} from "./chunk-PHOUUNK7.js";
-import {
-  COMPLETE,
-  COMPLETE_MSG,
-  COMPLETE_ONLY_BATCH,
-  DATA,
-  DIRTY,
-  DIRTY_MSG,
-  DIRTY_ONLY_BATCH,
-  ERROR,
-  INVALIDATE,
-  INVALIDATE_MSG,
-  INVALIDATE_ONLY_BATCH,
-  PAUSE,
-  RESOLVED,
-  RESOLVED_MSG,
-  RESOLVED_ONLY_BATCH,
-  RESUME,
-  START,
-  START_MSG,
-  TEARDOWN,
-  TEARDOWN_MSG,
-  TEARDOWN_ONLY_BATCH,
-  __export
-} from "./chunk-SX52TAR4.js";
-
-// src/core/index.ts
-var core_exports = {};
-__export(core_exports, {
-  COMPLETE: () => COMPLETE,
-  COMPLETE_MSG: () => COMPLETE_MSG,
-  COMPLETE_ONLY_BATCH: () => COMPLETE_ONLY_BATCH,
-  DATA: () => DATA,
-  DEFAULT_ACTOR: () => DEFAULT_ACTOR,
-  DIRTY: () => DIRTY,
-  DIRTY_MSG: () => DIRTY_MSG,
-  DIRTY_ONLY_BATCH: () => DIRTY_ONLY_BATCH,
-  ERROR: () => ERROR,
-  GraphReFlyConfig: () => GraphReFlyConfig,
-  GuardDenied: () => GuardDenied,
-  INVALIDATE: () => INVALIDATE,
-  INVALIDATE_MSG: () => INVALIDATE_MSG,
-  INVALIDATE_ONLY_BATCH: () => INVALIDATE_ONLY_BATCH,
-  NodeImpl: () => NodeImpl,
-  PAUSE: () => PAUSE,
-  RESOLVED: () => RESOLVED,
-  RESOLVED_MSG: () => RESOLVED_MSG,
-  RESOLVED_ONLY_BATCH: () => RESOLVED_ONLY_BATCH,
-  RESUME: () => RESUME,
-  START: () => START,
-  START_MSG: () => START_MSG,
-  TEARDOWN: () => TEARDOWN,
-  TEARDOWN_MSG: () => TEARDOWN_MSG,
-  TEARDOWN_ONLY_BATCH: () => TEARDOWN_ONLY_BATCH,
-  accessHintForGuard: () => accessHintForGuard,
-  advanceVersion: () => advanceVersion,
-  autoTrackNode: () => autoTrackNode,
-  batch: () => batch,
-  configure: () => configure,
-  createVersioning: () => createVersioning,
-  defaultConfig: () => defaultConfig,
-  defaultHash: () => defaultHash,
-  derived: () => derived,
-  downWithBatch: () => downWithBatch,
-  dynamicNode: () => dynamicNode,
-  effect: () => effect,
-  isBatching: () => isBatching,
-  isV1: () => isV1,
-  monotonicNs: () => monotonicNs,
-  node: () => node,
-  normalizeActor: () => normalizeActor,
-  pipe: () => pipe,
-  policy: () => policy,
-  policyFromRules: () => policyFromRules,
-  producer: () => producer,
-  registerBuiltins: () => registerBuiltins,
-  resolveDescribeFields: () => resolveDescribeFields,
-  state: () => state,
-  wallClockNs: () => wallClockNs
-});
-
-export {
-  core_exports
-};
-//# sourceMappingURL=chunk-3ZWCKRHX.js.map

package/dist/chunk-3ZWCKRHX.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/index.ts"],"sourcesContent":["/**\n * Core layer: message protocol, node primitive, lifecycle (Phase 0).\n */\nexport * from \"./actor.js\";\nexport { batch, downWithBatch, isBatching } from \"./batch.js\";\nexport { monotonicNs, wallClockNs } from \"./clock.js\";\nexport {\n\ttype GlobalInspectorEvent,\n\ttype GlobalInspectorHook,\n\tGraphReFlyConfig,\n\ttype MessageContext,\n\ttype NodeActions,\n\ttype NodeCtx,\n\ttype OnMessageHandler,\n\ttype OnSubscribeHandler,\n\tregisterBuiltins,\n\ttype SubscribeContext,\n} from \"./config.js\";\nexport * from \"./guard.js\";\nexport {\n\tCOMPLETE,\n\tCOMPLETE_MSG,\n\tCOMPLETE_ONLY_BATCH,\n\tDATA,\n\tDIRTY,\n\tDIRTY_MSG,\n\tDIRTY_ONLY_BATCH,\n\tERROR,\n\tINVALIDATE,\n\tINVALIDATE_MSG,\n\tINVALIDATE_ONLY_BATCH,\n\ttype Message,\n\ttype Messages,\n\ttype MessageTypeRegistration,\n\ttype MessageTypeRegistrationInput,\n\tPAUSE,\n\tRESOLVED,\n\tRESOLVED_MSG,\n\tRESOLVED_ONLY_BATCH,\n\tRESUME,\n\tSTART,\n\tSTART_MSG,\n\tTEARDOWN,\n\tTEARDOWN_MSG,\n\tTEARDOWN_ONLY_BATCH,\n} from \"./messages.js\";\nexport {\n\ttype DescribeDetail,\n\ttype DescribeField,\n\ttype DescribeNodeOutput,\n\tresolveDescribeFields,\n} from \"./meta.js\";\nexport {\n\tconfigure,\n\ttype DepRecord,\n\tdefaultConfig,\n\ttype FnCtx,\n\ttype Node,\n\ttype NodeDescribeKind,\n\ttype NodeFn,\n\ttype NodeFnCleanup,\n\tNodeImpl,\n\ttype NodeInspectorHook,\n\ttype NodeInspectorHookEvent,\n\ttype NodeOptions,\n\ttype NodeSink,\n\ttype NodeStatus,\n\ttype NodeTransportOptions,\n\tnode,\n} from \"./node.js\";\nexport {\n\ttype AutoTrackOptions,\n\tautoTrackNode,\n\ttype DerivedFn,\n\ttype DynamicFn,\n\tderived,\n\tdynamicNode,\n\ttype EffectFn,\n\teffect,\n\ttype PipeOperator,\n\ttype ProducerFn,\n\tpipe,\n\tproducer,\n\tstate,\n\ttype TrackFn,\n} from \"./sugar.js\";\nexport {\n\tadvanceVersion,\n\tcreateVersioning,\n\tdefaultHash,\n\ttype HashFn,\n\tisV1,\n\ttype NodeVersionInfo,\n\ttype V0,\n\ttype V1,\n\ttype VersioningLevel,\n\ttype VersioningOptions,\n} from \"./versioning.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;","names":[]}

package/dist/chunk-6LDQFTYS.js

@@ -1,102 +0,0 @@
-import {
-  GRAPH_META_SEGMENT,
-  Graph,
-  OVERHEAD,
-  SIZEOF_SYMBOL,
-  SNAPSHOT_VERSION,
-  diffForWAL,
-  explainPath,
-  graphProfile,
-  reachable,
-  sizeof
-} from "./chunk-THTWHNU4.js";
-import {
-  ENVELOPE_VERSION,
-  JsonCodec,
-  createDagCborCodec,
-  createDagCborZstdCodec,
-  decodeEnvelope,
-  encodeEnvelope,
-  registerBuiltinCodecs,
-  replayWAL
-} from "./chunk-PHOUUNK7.js";
-import {
-  DATA,
-  __export
-} from "./chunk-SX52TAR4.js";
-
-// src/graph/index.ts
-var graph_exports = {};
-__export(graph_exports, {
-  ENVELOPE_VERSION: () => ENVELOPE_VERSION,
-  GRAPH_META_SEGMENT: () => GRAPH_META_SEGMENT,
-  Graph: () => Graph,
-  JsonCodec: () => JsonCodec,
-  SIZEOF_OVERHEAD: () => OVERHEAD,
-  SIZEOF_SYMBOL: () => SIZEOF_SYMBOL,
-  SNAPSHOT_VERSION: () => SNAPSHOT_VERSION,
-  createDagCborCodec: () => createDagCborCodec,
-  createDagCborZstdCodec: () => createDagCborZstdCodec,
-  decodeEnvelope: () => decodeEnvelope,
-  diffForWAL: () => diffForWAL,
-  encodeEnvelope: () => encodeEnvelope,
-  explainPath: () => explainPath,
-  graphProfile: () => graphProfile,
-  reachable: () => reachable,
-  registerBuiltinCodecs: () => registerBuiltinCodecs,
-  replayWAL: () => replayWAL,
-  sizeof: () => sizeof,
-  watchTopologyTree: () => watchTopologyTree
-});
-
-// src/graph/topology-tree.ts
-function watchTopologyTree(graph, cb) {
-  const subs = /* @__PURE__ */ new Map();
-  const wire = (g, prefix) => {
-    if (subs.has(g)) return;
-    const placeholder = { off: () => {
-    }, prefix };
-    subs.set(g, placeholder);
-    const off = g.topology.subscribe((msgs) => {
-      for (const m of msgs) {
-        if (m[0] !== DATA) continue;
-        const event = m[1];
-        cb(event, g, prefix);
-        if (event.kind === "added" && event.nodeKind === "mount") {
-          const child = g._mounts.get(event.name);
-          if (child instanceof Graph) {
-            const childPrefix = `${prefix}${event.name}::`;
-            wire(child, childPrefix);
-          }
-        } else if (event.kind === "removed" && event.nodeKind === "mount") {
-          const removedPrefix = `${prefix}${event.name}::`;
-          for (const [trackedGraph, trackedEntry] of Array.from(subs.entries())) {
-            if (trackedGraph === graph) continue;
-            if (trackedEntry.prefix.startsWith(removedPrefix)) {
-              trackedEntry.off();
-              subs.delete(trackedGraph);
-            }
-          }
-        }
-      }
-    });
-    placeholder.off = off;
-    for (const [mountName, child] of g._mounts) {
-      if (child instanceof Graph) {
-        const childPrefix = `${prefix}${mountName}::`;
-        wire(child, childPrefix);
-      }
-    }
-  };
-  wire(graph, "");
-  return () => {
-    for (const entry of subs.values()) entry.off();
-    subs.clear();
-  };
-}
-
-export {
-  watchTopologyTree,
-  graph_exports
-};
-//# sourceMappingURL=chunk-6LDQFTYS.js.map

package/dist/chunk-6LDQFTYS.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/graph/index.ts","../src/graph/topology-tree.ts"],"sourcesContent":["/**\n * Graph container: registry, wiring, introspection (Phase 1).\n */\n\nexport { OVERHEAD as SIZEOF_OVERHEAD, SIZEOF_SYMBOL, sizeof } from \"../extra/utils/sizeof.js\";\nexport {\n\tcreateDagCborCodec,\n\tcreateDagCborZstdCodec,\n\tdecodeEnvelope,\n\tENVELOPE_VERSION,\n\ttype EvictedSubgraphInfo,\n\ttype EvictionPolicy,\n\tencodeEnvelope,\n\ttype GraphCodec,\n\tJsonCodec,\n\ttype LazyGraphCodec,\n\tregisterBuiltinCodecs,\n\treplayWAL,\n\ttype WALEntry,\n} from \"./codec.js\";\nexport {\n\ttype CausalChain,\n\ttype CausalStep,\n\ttype ExplainPathOptions,\n\texplainPath,\n} from \"./explain.js\";\nexport {\n\ttype DescribeFilter,\n\tdiffForWAL,\n\tGRAPH_META_SEGMENT,\n\tGraph,\n\ttype GraphActorOptions,\n\ttype GraphAttachStorageOptions,\n\ttype GraphCheckpointRecord,\n\ttype GraphDescribeOptions,\n\ttype GraphDescribeOutput,\n\ttype GraphDiagramDirection,\n\ttype GraphDiagramOptions,\n\ttype GraphDiffChange,\n\ttype GraphDiffResult,\n\ttype GraphFactoryContext,\n\ttype GraphNodeFactory,\n\ttype GraphObserveAll,\n\ttype GraphObserveOne,\n\ttype GraphOptions,\n\ttype GraphPersistSnapshot,\n\ttype GraphVersionChange,\n\ttype GraphWALDiff,\n\ttype ObserveDetail,\n\ttype ObserveEvent,\n\ttype ObserveOptions,\n\ttype ObserveResult,\n\ttype ObserveTheme,\n\ttype ObserveThemeName,\n\ttype ReachableDirection,\n\ttype ReachableOptions,\n\treachable,\n\tSNAPSHOT_VERSION,\n\ttype TopologyEvent,\n\ttype TraceEntry,\n} from \"./graph.js\";\nexport {\n\ttype GraphProfileOptions,\n\ttype GraphProfileResult,\n\tgraphProfile,\n\ttype NodeProfile,\n} from \"./profile.js\";\nexport { watchTopologyTree } from \"./topology-tree.js\";\n","/**\n * Transitive structural-change subscription helper.\n *\n * Subscribes to a graph's {@link Graph.topology} event stream AND recurses\n * into every mounted subgraph, auto-wiring new mounts when they appear\n * (via parent `added: mount` events) and tearing down subscriptions for\n * unmounted subgraphs (via `removed: mount` events + the audit record).\n *\n * Lives in `graph/` rather than `patterns/` because it depends only on\n * the `Graph` primitive and the `TopologyEvent` type — no domain-layer\n * factories. Consumers that need full-tree dynamic coverage (e.g.\n * `policyEnforcer`, `graphLens`) import from here to avoid circular\n * references between audit/lens modules.\n *\n * @module\n */\nimport { DATA } from \"../core/messages.js\";\nimport type { TopologyEvent } from \"./graph.js\";\nimport { Graph } from \"./graph.js\";\n\n/**\n * Subscribe to structural changes across `graph` and every transitively\n * mounted subgraph. `cb` fires on every {@link TopologyEvent} from any\n * graph in the tree. Newly-mounted subgraphs are auto-wired when their\n * parent emits `{kind: \"added\", nodeKind: \"mount\"}`; newly-unmounted\n * subgraphs' subscriptions are disposed via the parent's\n * `{kind: \"removed\", nodeKind: \"mount\"}` event plus the returned\n * `GraphRemoveAudit`.\n *\n * The callback receives a third argument `prefix`: the `::`-delimited\n * path from the root watched graph to the emitter, ending with `\"::\"`\n * (empty string when the event comes from the root itself). Compute\n * a qualified path for an added/removed entry as `prefix + event.name`.\n *\n * @param graph - Root graph to watch.\n * @param cb - Receives `(event, emitterGraph, prefix)`.\n * @returns Dispose function — tears down every active subscription.\n *\n * @category observability\n */\nexport function watchTopologyTree(\n\tgraph: Graph,\n\tcb: (event: TopologyEvent, emitter: Graph, prefix: string) => void,\n): () => void {\n\t// Tracks every wired graph with its qualified prefix (path from root).\n\t// Prefix is used for both qualified-path emission to `cb` AND prefix-match\n\t// disposal when a mount is removed — more robust than relying on\n\t// `_parent == null` which only nulls on the direct child, not on\n\t// grandchildren within an unmounted subtree.\n\ttype Entry = { off: () => void; prefix: string };\n\tconst subs = new Map<Graph, Entry>();\n\n\tconst wire = (g: Graph, prefix: string): void => {\n\t\tif (subs.has(g)) return;\n\t\t// Placeholder entry set BEFORE subscribe so any synchronous reentry\n\t\t// (e.g. a mount-added handler firing during subscribe's initial push)\n\t\t// sees this graph as already wired and skips rewiring.\n\t\tconst placeholder: Entry = { off: () => {}, prefix };\n\t\tsubs.set(g, placeholder);\n\t\tconst off = g.topology.subscribe((msgs) => {\n\t\t\tfor (const m of msgs) {\n\t\t\t\tif (m[0] !== DATA) continue;\n\t\t\t\tconst event = m[1] as TopologyEvent;\n\t\t\t\tcb(event, g, prefix);\n\t\t\t\tif (event.kind === \"added\" && event.nodeKind === \"mount\") {\n\t\t\t\t\tconst child = g._mounts.get(event.name);\n\t\t\t\t\tif (child instanceof Graph) {\n\t\t\t\t\t\tconst childPrefix = `${prefix}${event.name}::`;\n\t\t\t\t\t\twire(child, childPrefix);\n\t\t\t\t\t}\n\t\t\t\t} else if (event.kind === \"removed\" && event.nodeKind === \"mount\") {\n\t\t\t\t\t// Dispose every tracked sub whose prefix is under the removed\n\t\t\t\t\t// mount. Matches on qualified-prefix rather than `_parent`\n\t\t\t\t\t// so deep descendants are released even when their parent\n\t\t\t\t\t// pointers haven't been nulled.\n\t\t\t\t\tconst removedPrefix = `${prefix}${event.name}::`;\n\t\t\t\t\tfor (const [trackedGraph, trackedEntry] of Array.from(subs.entries())) {\n\t\t\t\t\t\tif (trackedGraph === graph) continue;\n\t\t\t\t\t\tif (trackedEntry.prefix.startsWith(removedPrefix)) {\n\t\t\t\t\t\t\ttrackedEntry.off();\n\t\t\t\t\t\t\tsubs.delete(trackedGraph);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t\tplaceholder.off = off;\n\t\t// Recursively wire any children already mounted when this call runs.\n\t\tfor (const [mountName, child] of g._mounts) {\n\t\t\tif (child instanceof Graph) {\n\t\t\t\tconst childPrefix = `${prefix}${mountName}::`;\n\t\t\t\twire(child, childPrefix);\n\t\t\t}\n\t\t}\n\t};\n\n\twire(graph, \"\");\n\n\treturn () => {\n\t\tfor (const entry of subs.values()) entry.off();\n\t\tsubs.clear();\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACwCO,SAAS,kBACf,OACA,IACa;AAOb,QAAM,OAAO,oBAAI,IAAkB;AAEnC,QAAM,OAAO,CAAC,GAAU,WAAyB;AAChD,QAAI,KAAK,IAAI,CAAC,EAAG;AAIjB,UAAM,cAAqB,EAAE,KAAK,MAAM;AAAA,IAAC,GAAG,OAAO;AACnD,SAAK,IAAI,GAAG,WAAW;AACvB,UAAM,MAAM,EAAE,SAAS,UAAU,CAAC,SAAS;AAC1C,iBAAW,KAAK,MAAM;AACrB,YAAI,EAAE,CAAC,MAAM,KAAM;AACnB,cAAM,QAAQ,EAAE,CAAC;AACjB,WAAG,OAAO,GAAG,MAAM;AACnB,YAAI,MAAM,SAAS,WAAW,MAAM,aAAa,SAAS;AACzD,gBAAM,QAAQ,EAAE,QAAQ,IAAI,MAAM,IAAI;AACtC,cAAI,iBAAiB,OAAO;AAC3B,kBAAM,cAAc,GAAG,MAAM,GAAG,MAAM,IAAI;AAC1C,iBAAK,OAAO,WAAW;AAAA,UACxB;AAAA,QACD,WAAW,MAAM,SAAS,aAAa,MAAM,aAAa,SAAS;AAKlE,gBAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,IAAI;AAC5C,qBAAW,CAAC,cAAc,YAAY,KAAK,MAAM,KAAK,KAAK,QAAQ,CAAC,GAAG;AACtE,gBAAI,iBAAiB,MAAO;AAC5B,gBAAI,aAAa,OAAO,WAAW,aAAa,GAAG;AAClD,2BAAa,IAAI;AACjB,mBAAK,OAAO,YAAY;AAAA,YACzB;AAAA,UACD;AAAA,QACD;AAAA,MACD;AAAA,IACD,CAAC;AACD,gBAAY,MAAM;AAElB,eAAW,CAAC,WAAW,KAAK,KAAK,EAAE,SAAS;AAC3C,UAAI,iBAAiB,OAAO;AAC3B,cAAM,cAAc,GAAG,MAAM,GAAG,SAAS;AACzC,aAAK,OAAO,WAAW;AAAA,MACxB;AAAA,IACD;AAAA,EACD;AAEA,OAAK,OAAO,EAAE;AAEd,SAAO,MAAM;AACZ,eAAW,SAAS,KAAK,OAAO,EAAG,OAAM,IAAI;AAC7C,SAAK,MAAM;AAAA,EACZ;AACD;","names":[]}

package/dist/chunk-7TAQJHQV.js

@@ -1,103 +0,0 @@
-// src/extra/timer.ts
-var ResettableTimer = class {
-  _timer;
-  _gen = 0;
-  /** Schedule callback after delayMs. Cancels any pending timer. */
-  start(delayMs, callback) {
-    this.cancel();
-    this._gen += 1;
-    const gen = this._gen;
-    this._timer = setTimeout(() => {
-      this._timer = void 0;
-      if (gen !== this._gen) return;
-      callback();
-    }, delayMs);
-  }
-  /** Cancel the pending timer (if any). */
-  cancel() {
-    if (this._timer !== void 0) {
-      clearTimeout(this._timer);
-      this._timer = void 0;
-    }
-  }
-  /** Whether a timer is currently pending. */
-  get pending() {
-    return this._timer !== void 0;
-  }
-};
-
-// src/extra/utils/ring-buffer.ts
-var RingBuffer = class {
-  constructor(capacity) {
-    this.capacity = capacity;
-    if (!Number.isInteger(capacity) || capacity <= 0) {
-      throw new Error(`RingBuffer capacity must be a positive integer (got ${capacity})`);
-    }
-    this.buf = new Array(capacity);
-  }
-  buf;
-  head = 0;
-  _size = 0;
-  /** Current number of stored entries. */
-  get size() {
-    return this._size;
-  }
-  /** Configured maximum before drop-oldest eviction fires. */
-  get maxSize() {
-    return this.capacity;
-  }
-  /**
-   * Append an item. If size equals capacity, drops the oldest entry and
-   * advances the head pointer.
-   */
-  push(item) {
-    const idx = (this.head + this._size) % this.capacity;
-    this.buf[idx] = item;
-    if (this._size < this.capacity) this._size++;
-    else this.head = (this.head + 1) % this.capacity;
-  }
-  /** Remove and return the oldest entry; `undefined` when empty. */
-  shift() {
-    if (this._size === 0) return void 0;
-    const item = this.buf[this.head];
-    this.buf[this.head] = void 0;
-    this.head = (this.head + 1) % this.capacity;
-    this._size--;
-    return item;
-  }
-  /**
-   * O(1) index lookup. Negative indices count from the tail (Python-style).
-   * Returns `undefined` for out-of-range.
-   */
-  at(i) {
-    if (this._size === 0) return void 0;
-    const n = i < 0 ? this._size + i : i;
-    if (n < 0 || n >= this._size) return void 0;
-    return this.buf[(this.head + n) % this.capacity];
-  }
-  /**
-   * Materialize the contents in insertion order (oldest → newest).
-   * Returns a new array each call.
-   */
-  toArray() {
-    const result = new Array(this._size);
-    for (let i = 0; i < this._size; i++) {
-      result[i] = this.buf[(this.head + i) % this.capacity];
-    }
-    return result;
-  }
-  /** Reset to empty. Storage slots are released so held refs can GC. */
-  clear() {
-    for (let i = 0; i < this._size; i++) {
-      this.buf[(this.head + i) % this.capacity] = void 0;
-    }
-    this.head = 0;
-    this._size = 0;
-  }
-};
-
-export {
-  ResettableTimer,
-  RingBuffer
-};
-//# sourceMappingURL=chunk-7TAQJHQV.js.map

package/dist/chunk-7TAQJHQV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/extra/timer.ts","../src/extra/utils/ring-buffer.ts"],"sourcesContent":["/**\n * Creates a resettable deadline timer for internal timeout, retry, and rate-limiting use.\n *\n * @remarks **Centralised primitive:** wraps `setTimeout`/`clearTimeout` with a generation guard\n * so that stale callbacks never fire after `cancel()` or a new `start()`.\n *\n * @remarks **Spec §5.10 exception:** resilience operators (`timeout`, `retry`, `rateLimiter`)\n * need raw timers — `fromTimer` creates a new Node per reset, which is too heavy here.\n * Lives in `src/extra/` (not `src/core/`) because it is a documented escape hatch from\n * the protocol-pure core layer.\n *\n * @example\n * ```ts\n * import { ResettableTimer } from \"@graphrefly/graphrefly-ts\";\n *\n * const timer = new ResettableTimer();\n * timer.start(1000, () => console.log(\"fired\"));\n * timer.cancel();          // cancels before firing\n * timer.start(500, () => console.log(\"new deadline\"));\n * console.log(timer.pending); // true\n * ```\n *\n * @category extra\n */\nexport class ResettableTimer {\n\tprivate _timer: ReturnType<typeof setTimeout> | undefined;\n\tprivate _gen = 0;\n\n\t/** Schedule callback after delayMs. Cancels any pending timer. */\n\tstart(delayMs: number, callback: () => void): void {\n\t\tthis.cancel();\n\t\tthis._gen += 1;\n\t\tconst gen = this._gen;\n\t\tthis._timer = setTimeout(() => {\n\t\t\tthis._timer = undefined;\n\t\t\tif (gen !== this._gen) return;\n\t\t\tcallback();\n\t\t}, delayMs);\n\t}\n\n\t/** Cancel the pending timer (if any). */\n\tcancel(): void {\n\t\tif (this._timer !== undefined) {\n\t\t\tclearTimeout(this._timer);\n\t\t\tthis._timer = undefined;\n\t\t}\n\t}\n\n\t/** Whether a timer is currently pending. */\n\tget pending(): boolean {\n\t\treturn this._timer !== undefined;\n\t}\n}\n","/**\n * Fixed-capacity ring buffer — O(1) push and drop-oldest eviction.\n *\n * Used by `Graph._traceRing` (reasoning trace), `reactiveLog` (append-only\n * log backend), and `reactiveSink` (drop-oldest backpressure buffer). One\n * implementation, three use sites.\n *\n * @module\n * @internal\n */\n\n/**\n * Fixed-capacity ring buffer. Once `capacity` entries are stored, subsequent\n * `push` calls evict the oldest entry (drop-oldest / FIFO eviction).\n *\n * Operations:\n * - `push(item)` — O(1).\n * - `shift()` — O(1) remove oldest (returns `undefined` when empty).\n * - `at(i)` — O(1) index lookup, with Python-style negative indexing.\n * - `toArray()` — O(n) materialize in insertion order.\n * - `clear()` — O(1) reset to empty.\n *\n * Not thread-safe; JS semantics assumed (single-threaded within a sync call).\n */\nexport class RingBuffer<T> {\n\tprivate buf: (T | undefined)[];\n\tprivate head = 0;\n\tprivate _size = 0;\n\n\tconstructor(private capacity: number) {\n\t\tif (!Number.isInteger(capacity) || capacity <= 0) {\n\t\t\tthrow new Error(`RingBuffer capacity must be a positive integer (got ${capacity})`);\n\t\t}\n\t\tthis.buf = new Array(capacity);\n\t}\n\n\t/** Current number of stored entries. */\n\tget size(): number {\n\t\treturn this._size;\n\t}\n\n\t/** Configured maximum before drop-oldest eviction fires. */\n\tget maxSize(): number {\n\t\treturn this.capacity;\n\t}\n\n\t/**\n\t * Append an item. If size equals capacity, drops the oldest entry and\n\t * advances the head pointer.\n\t */\n\tpush(item: T): void {\n\t\tconst idx = (this.head + this._size) % this.capacity;\n\t\tthis.buf[idx] = item;\n\t\tif (this._size < this.capacity) this._size++;\n\t\telse this.head = (this.head + 1) % this.capacity;\n\t}\n\n\t/** Remove and return the oldest entry; `undefined` when empty. */\n\tshift(): T | undefined {\n\t\tif (this._size === 0) return undefined;\n\t\tconst item = this.buf[this.head];\n\t\tthis.buf[this.head] = undefined;\n\t\tthis.head = (this.head + 1) % this.capacity;\n\t\tthis._size--;\n\t\treturn item;\n\t}\n\n\t/**\n\t * O(1) index lookup. Negative indices count from the tail (Python-style).\n\t * Returns `undefined` for out-of-range.\n\t */\n\tat(i: number): T | undefined {\n\t\tif (this._size === 0) return undefined;\n\t\tconst n = i < 0 ? this._size + i : i;\n\t\tif (n < 0 || n >= this._size) return undefined;\n\t\treturn this.buf[(this.head + n) % this.capacity];\n\t}\n\n\t/**\n\t * Materialize the contents in insertion order (oldest → newest).\n\t * Returns a new array each call.\n\t */\n\ttoArray(): T[] {\n\t\tconst result: T[] = new Array(this._size);\n\t\tfor (let i = 0; i < this._size; i++) {\n\t\t\tresult[i] = this.buf[(this.head + i) % this.capacity]!;\n\t\t}\n\t\treturn result;\n\t}\n\n\t/** Reset to empty. Storage slots are released so held refs can GC. */\n\tclear(): void {\n\t\tfor (let i = 0; i < this._size; i++) {\n\t\t\tthis.buf[(this.head + i) % this.capacity] = undefined;\n\t\t}\n\t\tthis.head = 0;\n\t\tthis._size = 0;\n\t}\n}\n"],"mappings":";AAwBO,IAAM,kBAAN,MAAsB;AAAA,EACpB;AAAA,EACA,OAAO;AAAA;AAAA,EAGf,MAAM,SAAiB,UAA4B;AAClD,SAAK,OAAO;AACZ,SAAK,QAAQ;AACb,UAAM,MAAM,KAAK;AACjB,SAAK,SAAS,WAAW,MAAM;AAC9B,WAAK,SAAS;AACd,UAAI,QAAQ,KAAK,KAAM;AACvB,eAAS;AAAA,IACV,GAAG,OAAO;AAAA,EACX;AAAA;AAAA,EAGA,SAAe;AACd,QAAI,KAAK,WAAW,QAAW;AAC9B,mBAAa,KAAK,MAAM;AACxB,WAAK,SAAS;AAAA,IACf;AAAA,EACD;AAAA;AAAA,EAGA,IAAI,UAAmB;AACtB,WAAO,KAAK,WAAW;AAAA,EACxB;AACD;;;AC5BO,IAAM,aAAN,MAAoB;AAAA,EAK1B,YAAoB,UAAkB;AAAlB;AACnB,QAAI,CAAC,OAAO,UAAU,QAAQ,KAAK,YAAY,GAAG;AACjD,YAAM,IAAI,MAAM,uDAAuD,QAAQ,GAAG;AAAA,IACnF;AACA,SAAK,MAAM,IAAI,MAAM,QAAQ;AAAA,EAC9B;AAAA,EATQ;AAAA,EACA,OAAO;AAAA,EACP,QAAQ;AAAA;AAAA,EAUhB,IAAI,OAAe;AAClB,WAAO,KAAK;AAAA,EACb;AAAA;AAAA,EAGA,IAAI,UAAkB;AACrB,WAAO,KAAK;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,KAAK,MAAe;AACnB,UAAM,OAAO,KAAK,OAAO,KAAK,SAAS,KAAK;AAC5C,SAAK,IAAI,GAAG,IAAI;AAChB,QAAI,KAAK,QAAQ,KAAK,SAAU,MAAK;AAAA,QAChC,MAAK,QAAQ,KAAK,OAAO,KAAK,KAAK;AAAA,EACzC;AAAA;AAAA,EAGA,QAAuB;AACtB,QAAI,KAAK,UAAU,EAAG,QAAO;AAC7B,UAAM,OAAO,KAAK,IAAI,KAAK,IAAI;AAC/B,SAAK,IAAI,KAAK,IAAI,IAAI;AACtB,SAAK,QAAQ,KAAK,OAAO,KAAK,KAAK;AACnC,SAAK;AACL,WAAO;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,GAAG,GAA0B;AAC5B,QAAI,KAAK,UAAU,EAAG,QAAO;AAC7B,UAAM,IAAI,IAAI,IAAI,KAAK,QAAQ,IAAI;AACnC,QAAI,IAAI,KAAK,KAAK,KAAK,MAAO,QAAO;AACrC,WAAO,KAAK,KAAK,KAAK,OAAO,KAAK,KAAK,QAAQ;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAe;AACd,UAAM,SAAc,IAAI,MAAM,KAAK,KAAK;AACxC,aAAS,IAAI,GAAG,IAAI,KAAK,OAAO,KAAK;AACpC,aAAO,CAAC,IAAI,KAAK,KAAK,KAAK,OAAO,KAAK,KAAK,QAAQ;AAAA,IACrD;AACA,WAAO;AAAA,EACR;AAAA;AAAA,EAGA,QAAc;AACb,aAAS,IAAI,GAAG,IAAI,KAAK,OAAO,KAAK;AACpC,WAAK,KAAK,KAAK,OAAO,KAAK,KAAK,QAAQ,IAAI;AAAA,IAC7C;AACA,SAAK,OAAO;AACZ,SAAK,QAAQ;AAAA,EACd;AACD;","names":[]}