@graphrefly/graphrefly 0.47.2 → 0.48.0

package/dist/presets/index.d.cts

@@ -2,7 +2,7 @@ export { A as AgentBundle, a as AgentGraph, b as AgentLoopGraph, c as AgentLoopO
 export { C as CompressionCache, a as CompressionRule, b as ContextEntry, c as ContextView, L as LlmCompress, P as PoolGCPolicy, R as RenderedEntry, d as RuleMatch, T as Tag, e as TaggedContextPoolBundle, f as TaggedContextPoolOptions, g as Tier, r as renderContextView, t as taggedContextPool, h as tierCompress } from '../index-DLAxYaN5.cjs';
 export { DebateGraph, DebateOutput, DebateParticipant, DebateStatus, DebateTermination, HeterogeneousDebateBundle, HeterogeneousDebateOptions, Turn, heterogeneousDebate } from './ai/index.cjs';
 export { ActorHandle, ActorId, ActorPoolBundle, ActorPoolOptions, ActorSpec, ActorState, ActorStatus, EvalVerifierConfig, EvalVerifierSummary, HarnessEvalPairConfig, HarnessProfileResult, HarnessTraceHandle, HarnessTraceOptions, OwnershipControllerGraph, OwnershipControllerOptions, OwnershipState, RefineExecutorConfig, RefineExecutorResult, Todo, TraceDetail, TraceEvent, TraceEventType, actorPool, evalVerifier, harnessEvalPair, harnessProfile, harnessTrace, ownershipController, refineExecutor } from './harness/index.cjs';
-export { A as AnalyzeEvent, B as BlindVariationContext, a as BlindVariationOptions, C as ConvergenceOptions, D as DatasetItem, b as DecideEvent, E as ErrorCritiqueContext, c as ErrorCritiqueOptions, d as EvalResult, e as EvaluateEvent, f as Evaluator, F as Feedback, G as GenerateEvent, H as HarnessGraph, I as Iteration, R as RefineLoopGraph, g as RefineLoopOptions, h as RefineStatus, i as RefineStrategy, S as SpawnPayload, j as SpawnRejection, k as SpawnableBundle, l as SpawnableGraph, m as SpawnableOpts, n as blindVariation, o as defaultLlmExecutor, p as defaultLlmVerifier, q as errorCritique, r as harnessLoop, s as refineLoop, t as spawnable } from '../spawnable-5mDY501F.cjs';
+export { A as AnalyzeEvent, B as BlindVariationContext, a as BlindVariationOptions, C as ConvergenceOptions, D as DatasetItem, b as DecideEvent, E as ErrorCritiqueContext, c as ErrorCritiqueOptions, d as EvalResult, e as EvaluateEvent, f as Evaluator, F as Feedback, G as GenerateEvent, H as HarnessGraph, I as Iteration, R as RefineLoopGraph, g as RefineLoopOptions, h as RefineStatus, i as RefineStrategy, S as SpawnPayload, j as SpawnRejection, k as SpawnableBundle, l as SpawnableGraph, m as SpawnableOpts, n as blindVariation, o as defaultLlmExecutor, p as defaultLlmVerifier, q as errorCritique, r as harnessLoop, s as refineLoop, t as spawnable } from '../spawnable-B2IlW60f.cjs';
 export { InspectGraph, InspectOptions, inspect } from './inspect/index.cjs';
 export { G as GuardedExecutionGraph, a as GuardedExecutionLint, b as GuardedExecutionOptions, c as GuardedScope, g as guardedExecution } from '../guarded-execution-C-3hnP6A.cjs';
 export { ResilientPipelineGraph, ResilientPipelineOptions, resilientPipeline } from './resilience/index.cjs';
@@ -24,5 +24,5 @@ import '../utils/inspect/index.cjs';
 import '../retry-DWuhjvsA.cjs';
 import '../backoff-Bnb9OoPh.cjs';
 import '../status-U-rUI79b.cjs';
-import '../rate-limiter-DpVbSYdH.cjs';
+import '../rate-limiter-DC26FM8J.cjs';
 import '../breaker-ugSdq54q.cjs';

package/dist/presets/index.d.ts

@@ -2,7 +2,7 @@ export { A as AgentBundle, a as AgentGraph, b as AgentLoopGraph, c as AgentLoopO
 export { C as CompressionCache, a as CompressionRule, b as ContextEntry, c as ContextView, L as LlmCompress, P as PoolGCPolicy, R as RenderedEntry, d as RuleMatch, T as Tag, e as TaggedContextPoolBundle, f as TaggedContextPoolOptions, g as Tier, r as renderContextView, t as taggedContextPool, h as tierCompress } from '../index-DLAxYaN5.js';
 export { DebateGraph, DebateOutput, DebateParticipant, DebateStatus, DebateTermination, HeterogeneousDebateBundle, HeterogeneousDebateOptions, Turn, heterogeneousDebate } from './ai/index.js';
 export { ActorHandle, ActorId, ActorPoolBundle, ActorPoolOptions, ActorSpec, ActorState, ActorStatus, EvalVerifierConfig, EvalVerifierSummary, HarnessEvalPairConfig, HarnessProfileResult, HarnessTraceHandle, HarnessTraceOptions, OwnershipControllerGraph, OwnershipControllerOptions, OwnershipState, RefineExecutorConfig, RefineExecutorResult, Todo, TraceDetail, TraceEvent, TraceEventType, actorPool, evalVerifier, harnessEvalPair, harnessProfile, harnessTrace, ownershipController, refineExecutor } from './harness/index.js';
-export { A as AnalyzeEvent, B as BlindVariationContext, a as BlindVariationOptions, C as ConvergenceOptions, D as DatasetItem, b as DecideEvent, E as ErrorCritiqueContext, c as ErrorCritiqueOptions, d as EvalResult, e as EvaluateEvent, f as Evaluator, F as Feedback, G as GenerateEvent, H as HarnessGraph, I as Iteration, R as RefineLoopGraph, g as RefineLoopOptions, h as RefineStatus, i as RefineStrategy, S as SpawnPayload, j as SpawnRejection, k as SpawnableBundle, l as SpawnableGraph, m as SpawnableOpts, n as blindVariation, o as defaultLlmExecutor, p as defaultLlmVerifier, q as errorCritique, r as harnessLoop, s as refineLoop, t as spawnable } from '../spawnable-D3lR0oQu.js';
+export { A as AnalyzeEvent, B as BlindVariationContext, a as BlindVariationOptions, C as ConvergenceOptions, D as DatasetItem, b as DecideEvent, E as ErrorCritiqueContext, c as ErrorCritiqueOptions, d as EvalResult, e as EvaluateEvent, f as Evaluator, F as Feedback, G as GenerateEvent, H as HarnessGraph, I as Iteration, R as RefineLoopGraph, g as RefineLoopOptions, h as RefineStatus, i as RefineStrategy, S as SpawnPayload, j as SpawnRejection, k as SpawnableBundle, l as SpawnableGraph, m as SpawnableOpts, n as blindVariation, o as defaultLlmExecutor, p as defaultLlmVerifier, q as errorCritique, r as harnessLoop, s as refineLoop, t as spawnable } from '../spawnable-tttFz2Nh.js';
 export { InspectGraph, InspectOptions, inspect } from './inspect/index.js';
 export { G as GuardedExecutionGraph, a as GuardedExecutionLint, b as GuardedExecutionOptions, c as GuardedScope, g as guardedExecution } from '../guarded-execution-BcdtxeBk.js';
 export { ResilientPipelineGraph, ResilientPipelineOptions, resilientPipeline } from './resilience/index.js';
@@ -24,5 +24,5 @@ import '../utils/inspect/index.js';
 import '../retry-BDbRZ_gx.js';
 import '../backoff-Bnb9OoPh.js';
 import '../status-U-rUI79b.js';
-import '../rate-limiter-CEALq4N1.js';
+import '../rate-limiter-DyWpwpQP.js';
 import '../breaker-C9skL3d8.js';

package/dist/presets/index.js

@@ -1,13 +1,4 @@
 import "../chunk-2LO3EL4W.js";
-import {
-  InspectGraph,
-  inspect
-} from "../chunk-LDCSZ72P.js";
-import "../chunk-KRNQ6RGQ.js";
-import {
-  DebateGraph,
-  heterogeneousDebate
-} from "../chunk-X7BA5PWG.js";
 import {
   OwnershipControllerGraph,
   actorPool,
@@ -17,25 +8,22 @@ import {
   harnessTrace,
   ownershipController,
   refineExecutor
-} from "../chunk-VNXAF2KE.js";
+} from "../chunk-TPTZZV25.js";
+import {
+  InspectGraph,
+  inspect
+} from "../chunk-6YBER5UP.js";
+import "../chunk-KRNQ6RGQ.js";
+import {
+  DebateGraph,
+  heterogeneousDebate
+} from "../chunk-X7BA5PWG.js";
 import {
   CompressionCache,
   renderContextView,
   taggedContextPool,
   tierCompress
-} from "../chunk-VP3TIUDF.js";
-import {
-  GuardedExecutionGraph,
-  guardedExecution
-} from "../chunk-FVINAAKA.js";
-import {
-  ResilientPipelineGraph,
-  resilientPipeline
-} from "../chunk-WGDEBIP4.js";
-import {
-  AgentMemoryGraph,
-  agentMemory
-} from "../chunk-R6ZCSXKX.js";
+} from "../chunk-DVTDF5OI.js";
 import {
   HarnessGraph,
   RefineLoopGraph,
@@ -47,7 +35,19 @@ import {
   harnessLoop,
   refineLoop,
   spawnable
-} from "../chunk-PTWADEH3.js";
+} from "../chunk-YBJVKMTM.js";
+import {
+  GuardedExecutionGraph,
+  guardedExecution
+} from "../chunk-NBK6QQMG.js";
+import {
+  ResilientPipelineGraph,
+  resilientPipeline
+} from "../chunk-X6ESZDR6.js";
+import {
+  AgentMemoryGraph,
+  agentMemory
+} from "../chunk-23MAWVOJ.js";
 import {
   AgentGraph,
   AgentLoopGraph,
@@ -56,34 +56,34 @@ import {
   agent,
   agentLoop,
   presetRegistry
-} from "../chunk-FQSQONOU.js";
-import "../chunk-4XCHZRUJ.js";
-import "../chunk-CEVNQ74M.js";
+} from "../chunk-65OM4XLQ.js";
+import "../chunk-D5YGR4TP.js";
 import "../chunk-OIWU3NYV.js";
-import "../chunk-PKPO3JTZ.js";
-import "../chunk-KRFGO5QH.js";
-import "../chunk-6MRSX3YK.js";
-import "../chunk-DDTS7F5O.js";
-import "../chunk-EP4WVQLX.js";
-import "../chunk-T7SP3EYR.js";
+import "../chunk-AQAKDE7F.js";
+import "../chunk-3YGXPUHW.js";
+import "../chunk-MQMTRKY3.js";
+import "../chunk-B5Y5GPD5.js";
+import "../chunk-LTSI7ULC.js";
+import "../chunk-ZW32BPXV.js";
+import "../chunk-T2U6N3FV.js";
+import "../chunk-T5URUIIY.js";
 import "../chunk-GUNIRPEJ.js";
-import "../chunk-N65E26UL.js";
-import "../chunk-QFE5BQH7.js";
-import "../chunk-MS3WPRJR.js";
-import "../chunk-7AVQIGF6.js";
-import "../chunk-NPRP3MCV.js";
-import "../chunk-QMBYUVRL.js";
-import "../chunk-FMPF42Q4.js";
-import "../chunk-BXGZFGZ4.js";
-import "../chunk-IOJDYUA7.js";
-import "../chunk-OXD5LFQP.js";
-import "../chunk-5GVURVIG.js";
-import "../chunk-N6MNJNHB.js";
+import "../chunk-XEWV254I.js";
+import "../chunk-3REMCHSS.js";
+import "../chunk-K4ZYJ4EM.js";
+import "../chunk-DHDCOOJU.js";
 import "../chunk-F7EKHR32.js";
 import "../chunk-JA67ZQG2.js";
 import "../chunk-KUFXLAEY.js";
 import "../chunk-TSBFTJKM.js";
 import "../chunk-P5LBT622.js";
+import "../chunk-QMBYUVRL.js";
+import "../chunk-FMPF42Q4.js";
+import "../chunk-C5QD5DQX.js";
+import "../chunk-V46JWFGV.js";
+import "../chunk-G7H6PN7P.js";
+import "../chunk-MMHGYX44.js";
+import "../chunk-N6MNJNHB.js";
 import "../chunk-AZDQPQ3V.js";
 export {
   AgentGraph,

package/dist/presets/inspect/index.cjs

@@ -724,7 +724,11 @@ function healthReportEqual(a, b) {
   }
   return true;
 }
-function graphLens(target) {
+function graphLens(target, opts = {}) {
+  const mutLogOpt = opts.mutations;
+  const mutationsEnabled = mutLogOpt != null;
+  const pendingFlowChanges = [];
+  let disposed = false;
   const topologyHandle = target.describe({
     reactive: true,
     detail: "standard",
@@ -767,17 +771,26 @@ function graphLens(target) {
           const path = event.path;
           if (path == null || path === "") continue;
           const prior = flowMap.get(path);
+          const count = (prior?.count ?? 0) + 1;
           flowMap.set(path, {
             path,
-            count: (prior?.count ?? 0) + 1,
+            count,
             lastUpdate_ns: c.flushedAt_ns
           });
+          if (mutationsEnabled && !disposed) {
+            pendingFlowChanges.push({ kind: "tick", path, count });
+          }
         }
       }
       if (desc != null && flowMap.size > 0) {
         const valid = new Set(Object.keys(desc.nodes));
         for (const k of [...flowMap.keys()]) {
-          if (!valid.has(k)) flowMap.delete(k);
+          if (!valid.has(k)) {
+            flowMap.delete(k);
+            if (mutationsEnabled && !disposed) {
+              pendingFlowChanges.push({ kind: "evict", path: k });
+            }
+          }
         }
       }
       actions.emit(new Map(flowMap));
@@ -788,15 +801,50 @@ function graphLens(target) {
       meta: domainMeta("lens", "flow")
     }
   );
+  let flowMutations;
+  let stopFlowMutKeep;
+  if (mutLogOpt != null) {
+    const log = (0, import_extra4.reactiveLog)(void 0, {
+      name: mutLogOpt === true ? "graphLens.flowMutations" : mutLogOpt.name ?? "graphLens.flowMutations",
+      maxSize: mutLogOpt === true ? void 0 : mutLogOpt.maxSize
+    });
+    flowMutations = log;
+    let mutVersion = 0;
+    const flowMutationsDrain = (0, import_core4.node)(
+      [flow],
+      (_batchData, _actions, _ctx) => {
+        if (pendingFlowChanges.length === 0) return;
+        const drained = pendingFlowChanges.splice(0);
+        for (const change of drained) {
+          log.append({
+            structure: "lensFlow",
+            version: ++mutVersion,
+            t_ns: (0, import_core4.wallClockNs)(),
+            lifecycle: "data",
+            change
+          });
+        }
+      },
+      {
+        name: "graphLens.flowMutationsDrain",
+        describeKind: "effect",
+        meta: domainMeta("lens", "flowMutations")
+      }
+    );
+    stopFlowMutKeep = (0, import_extra4.keepalive)(flowMutationsDrain);
+  }
   const stopFlowKeep = (0, import_extra4.keepalive)(flow);
-  let disposed = false;
   return {
     topology,
     health,
     flow,
+    ...flowMutations ? { flowMutations } : {},
     dispose() {
       if (disposed) return;
       disposed = true;
+      stopFlowMutKeep?.();
+      flowMutations?.dispose();
+      pendingFlowChanges.length = 0;
       stopFlowKeep();
       stopHealthKeep();
       topologyHandle.dispose();
@@ -1015,11 +1063,12 @@ var GuardedExecutionGraph = class extends import_graph7.Graph {
     this.addDisposer((0, import_extra5.keepalive)(this.scope));
     const scopedHandle = target.describe({
       reactive: true,
-      // F8 (Tier 5.2): `_actorNode` is `Node<Actor | null>`. The cast is
-      // safe at runtime per the `resolveActorOption` null-tolerance
-      // contract — `null` / `undefined` cache is treated as "no scoping"
-      // (full visibility). See `scopedDescribeNode` for the matching
-      // per-call site and graph.ts § "Cache-undefined semantics".
+      // F8 (resolved 2026-05-18): `GraphDescribeOptions.actor` is now
+      // `Actor | Node<Actor | null>`, so `_actorNode` (a
+      // `Node<Actor | null>`) passes without a cast. A `null`/`undefined`
+      // cache resolves to "no scoping" (full visibility) per
+      // `resolveActorOption`. See graph.ts § "Cache-undefined/null
+      // semantics".
       actor: this._actorNode,
       reactiveName: "scopedDescribe"
     });
@@ -1065,11 +1114,11 @@ var GuardedExecutionGraph = class extends import_graph7.Graph {
     const actorNode = actorOverride == null ? this._actorNode : isNode2(actorOverride) ? actorOverride : (0, import_core6.node)([], { name: "actor_override", initial: actorOverride });
     const handle = this._target.describe({
       reactive: true,
-      // `_actorNode` is `Node<Actor | null>`. The `as Node<Actor>` cast is
-      // safe at runtime: `_describeReactive` resolves the actor via
-      // `resolveActorOption`, which treats `null`/`undefined` cache as
-      // "no scoping" (full visibility). Documented in graph.ts §
-      // "Cache-undefined semantics."
+      // F8 (resolved 2026-05-18): `actor` accepts `Node<Actor | null>`
+      // directly. `actorNode` is `_actorNode` (`Node<Actor | null>`) or
+      // an override (`Node<Actor>`/`Node<Actor | null>`); both assign
+      // without a cast. `_describeReactive` resolves via
+      // `resolveActorOption` (null/undefined cache → no scoping).
       actor: actorNode,
       ...opts ?? {}
     });