@graphrefly/graphrefly 0.18.0 → 0.20.0

package/dist/graph/index.d.cts

@@ -1,3 +1,3 @@
-export { D as DeltaCheckpoint, E as EvictedSubgraphInfo, b as EvictionPolicy, c as GraphCodec, a as GraphProfileOptions, G as GraphProfileResult, J as JsonCodec, L as LazyGraphCodec, N as NodeProfile, W as WALEntry, d as createDagCborCodec, e as createDagCborZstdCodec, g as graphProfile, n as negotiateCodec, r as replayWAL, s as sizeof } from '../index-Ci_vPaVm.cjs';
-export { A as AutoCheckpointAdapter, D as DescribeFilter, d as GRAPH_META_SEGMENT, G as Graph, e as GraphActorOptions, b as GraphAutoCheckpointHandle, c as GraphAutoCheckpointOptions, f as GraphCheckpointRecord, g as GraphDescribeOptions, h as GraphDescribeOutput, i as GraphDiagramDirection, j as GraphDiagramOptions, k as GraphDiffChange, l as GraphDiffResult, m as GraphDumpOptions, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, r as GraphPersistSnapshot, O as ObserveDetail, s as ObserveEvent, t as ObserveOptions, u as ObserveResult, v as ObserveTheme, w as ObserveThemeName, R as ReachableDirection, x as ReachableOptions, T as TraceEntry, y as reachable } from '../graph-BYFlyNpX.cjs';
-import '../meta-npl5b97j.cjs';
+export { D as DeltaCheckpoint, E as EvictedSubgraphInfo, a as EvictionPolicy, G as GraphCodec, J as JsonCodec, L as LazyGraphCodec, W as WALEntry, c as createDagCborCodec, b as createDagCborZstdCodec, n as negotiateCodec, r as replayWAL, s as sizeof } from '../index-UudxGnzc.cjs';
+export { A as AutoCheckpointAdapter, D as DescribeFilter, f as GRAPH_META_SEGMENT, G as Graph, g as GraphActorOptions, b as GraphAutoCheckpointHandle, c as GraphAutoCheckpointOptions, h as GraphCheckpointRecord, i as GraphDescribeOptions, j as GraphDescribeOutput, k as GraphDiagramDirection, l as GraphDiagramOptions, m as GraphDiffChange, n as GraphDiffResult, o as GraphDumpOptions, p as GraphFactoryContext, q as GraphNodeFactory, r as GraphObserveAll, s as GraphObserveOne, a as GraphOptions, t as GraphPersistSnapshot, e as GraphProfileOptions, d as GraphProfileResult, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, B as graphProfile, C as reachable } from '../graph-KsTe57nI.cjs';
+import '../meta-BnG7XAaE.cjs';

package/dist/graph/index.d.ts

@@ -1,3 +1,3 @@
-export { D as DeltaCheckpoint, E as EvictedSubgraphInfo, b as EvictionPolicy, c as GraphCodec, a as GraphProfileOptions, G as GraphProfileResult, J as JsonCodec, L as LazyGraphCodec, N as NodeProfile, W as WALEntry, d as createDagCborCodec, e as createDagCborZstdCodec, g as graphProfile, n as negotiateCodec, r as replayWAL, s as sizeof } from '../index-DKaB2x0T.js';
-export { A as AutoCheckpointAdapter, D as DescribeFilter, d as GRAPH_META_SEGMENT, G as Graph, e as GraphActorOptions, b as GraphAutoCheckpointHandle, c as GraphAutoCheckpointOptions, f as GraphCheckpointRecord, g as GraphDescribeOptions, h as GraphDescribeOutput, i as GraphDiagramDirection, j as GraphDiagramOptions, k as GraphDiffChange, l as GraphDiffResult, m as GraphDumpOptions, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, r as GraphPersistSnapshot, O as ObserveDetail, s as ObserveEvent, t as ObserveOptions, u as ObserveResult, v as ObserveTheme, w as ObserveThemeName, R as ReachableDirection, x as ReachableOptions, T as TraceEntry, y as reachable } from '../graph-gISB9n3n.js';
-import '../meta-npl5b97j.js';
+export { D as DeltaCheckpoint, E as EvictedSubgraphInfo, a as EvictionPolicy, G as GraphCodec, J as JsonCodec, L as LazyGraphCodec, W as WALEntry, c as createDagCborCodec, b as createDagCborZstdCodec, n as negotiateCodec, r as replayWAL, s as sizeof } from '../index-B2SvPEbc.js';
+export { A as AutoCheckpointAdapter, D as DescribeFilter, f as GRAPH_META_SEGMENT, G as Graph, g as GraphActorOptions, b as GraphAutoCheckpointHandle, c as GraphAutoCheckpointOptions, h as GraphCheckpointRecord, i as GraphDescribeOptions, j as GraphDescribeOutput, k as GraphDiagramDirection, l as GraphDiagramOptions, m as GraphDiffChange, n as GraphDiffResult, o as GraphDumpOptions, p as GraphFactoryContext, q as GraphNodeFactory, r as GraphObserveAll, s as GraphObserveOne, a as GraphOptions, t as GraphPersistSnapshot, e as GraphProfileOptions, d as GraphProfileResult, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, B as graphProfile, C as reachable } from '../graph-mILUUqW8.js';
+import '../meta-BnG7XAaE.js';

package/dist/graph/index.js

@@ -2,18 +2,18 @@ import {
   JsonCodec,
   createDagCborCodec,
   createDagCborZstdCodec,
-  graphProfile,
   negotiateCodec,
-  replayWAL,
-  sizeof
-} from "../chunk-FCLROC4Q.js";
+  replayWAL
+} from "../chunk-R2LPZIY2.js";
 import {
   GRAPH_META_SEGMENT,
   Graph,
-  reachable
-} from "../chunk-LB3RYLSC.js";
-import "../chunk-J7S54G7I.js";
-import "../chunk-BV3TPSBK.js";
+  graphProfile,
+  reachable,
+  sizeof
+} from "../chunk-3N2Y6PCR.js";
+import "../chunk-2L5J6RPM.js";
+import "../chunk-XYL3GLB3.js";
 export {
   GRAPH_META_SEGMENT,
   Graph,

package/dist/{graph-gISB9n3n.d.ts → graph-KsTe57nI.d.cts}

@@ -1,4 +1,67 @@
-import { j as DescribeNodeOutput, h as DescribeDetail, i as DescribeField, N as Node, y as VersioningLevel, A as Actor, m as Messages, p as NodeSink } from './meta-npl5b97j.js';
+import { i as DescribeNodeOutput, g as DescribeDetail, h as DescribeField, N as Node, y as VersioningLevel, A as Actor, l as Messages, o as NodeSink } from './meta-BnG7XAaE.cjs';
+
+/**
+ * Graph profiling and inspection utilities.
+ *
+ * Provides per-node memory estimation, connectivity stats, and hotspot
+ * detection. Non-invasive — reads from `describe()` and node internals
+ * without modifying state.
+ *
+ * @module
+ */
+
+/** Per-node profile entry. */
+interface NodeProfile {
+    /** Qualified path within the graph. */
+    path: string;
+    /** Node type (state, derived, producer, effect). */
+    type: string;
+    /** Node status (disconnected, dirty, settled, errored, completed). */
+    status: string;
+    /** Approximate retained bytes for the node's cached value. */
+    valueSizeBytes: number;
+    /** Number of downstream subscribers (sinks). */
+    subscriberCount: number;
+    /** Number of upstream dependencies. */
+    depCount: number;
+    /** True if this is an effect node with no external subscribers (potential leak). */
+    isOrphanEffect: boolean;
+}
+/** Aggregate graph profile. */
+interface GraphProfileResult {
+    /** Total node count. */
+    nodeCount: number;
+    /** Total edge count. */
+    edgeCount: number;
+    /** Subgraph count. */
+    subgraphCount: number;
+    /** All node profiles. */
+    nodes: NodeProfile[];
+    /** Total approximate value memory across all nodes. */
+    totalValueSizeBytes: number;
+    /** Nodes sorted by valueSizeBytes descending (top N). */
+    hotspots: NodeProfile[];
+    /** Effect nodes with no external subscribers (potential leaks). */
+    orphanEffects: NodeProfile[];
+}
+/** Options for {@link graphProfile}. */
+interface GraphProfileOptions {
+    /** Limit hotspot list (default 10). */
+    topN?: number;
+    /** Include subgraph nodes recursively (default true). */
+    recursive?: boolean;
+}
+/**
+ * Profile a graph's memory and connectivity characteristics.
+ *
+ * Uses `describe({ detail: "standard" })` for node metadata and direct
+ * `NodeImpl` access for subscriber counts and cached values.
+ *
+ * @param graph - The graph to profile.
+ * @param opts - Optional configuration.
+ * @returns Aggregate profile with per-node details and hotspots.
+ */
+declare function graphProfile(graph: Graph, opts?: GraphProfileOptions): GraphProfileResult;
 
 /**
  * Reserved segment for meta companion paths: `nodeName::__meta__::metaKey` (GRAPHREFLY-SPEC §3.6).
@@ -189,10 +252,12 @@ type ObserveResult<T = unknown> = {
     readonly resolvedCount: number;
     /** All events in order. */
     readonly events: ObserveEvent[];
-    /** True if COMPLETE received without prior ERROR. */
-    readonly completedCleanly: boolean;
-    /** True if ERROR received. */
-    readonly errored: boolean;
+    /** True if any observed node sent COMPLETE without prior ERROR on that node. */
+    readonly anyCompletedCleanly: boolean;
+    /** True if any observed node sent ERROR. */
+    readonly anyErrored: boolean;
+    /** True if at least one COMPLETE received and no ERROR from any observed node. */
+    readonly completedWithoutErrors: boolean;
     /** Stop observing. */
     dispose(): void;
     /**
@@ -427,6 +492,14 @@ declare class Graph {
     describe(options?: GraphDescribeOptions): GraphDescribeOutput;
     private _collectSubgraphs;
     private _collectAllEdges;
+    /**
+     * Snapshot-based resource profile: per-node stats, orphan effect detection,
+     * memory hotspots. Zero runtime overhead — walks nodes on demand.
+     *
+     * @param opts - Optional `topN` for hotspot limit (default 10).
+     * @returns Aggregate profile with per-node details, hotspots, and orphan effects.
+     */
+    resourceProfile(opts?: GraphProfileOptions): GraphProfileResult;
     private _qualifyEdgeEndpoint;
     private _collectObserveTargets;
     private _appendMetaObserveTargets;
@@ -557,8 +630,9 @@ declare class Graph {
     /**
      * Debounced persistence wired to graph-wide observe stream (spec §3.8 auto-checkpoint).
      *
-     * Checkpoint trigger uses {@link messageTier}: only batches containing tier >= 2 messages
-     * schedule a save (`DATA`/`RESOLVED`/terminal/destruction), never pure tier-0/1 control waves.
+     * Checkpoint trigger uses {@link messageTier}: only batches containing tier >= 3 messages
+     * schedule a save (`DATA`/`RESOLVED`/terminal/destruction), never pure tier-0/1/2 control
+     * waves (`START`/`DIRTY`/`INVALIDATE`/`PAUSE`/`RESUME`).
      */
     autoCheckpoint(adapter: AutoCheckpointAdapter, options?: GraphAutoCheckpointOptions): GraphAutoCheckpointHandle;
     /**
@@ -673,4 +747,4 @@ type ReachableOptions = {
  */
 declare function reachable(described: GraphDescribeOutput, from: string, direction: ReachableDirection, options?: ReachableOptions): string[];
 
-export { type AutoCheckpointAdapter as A, type DescribeFilter as D, Graph as G, type ObserveDetail as O, type ReachableDirection as R, type TraceEntry as T, type GraphOptions as a, type GraphAutoCheckpointHandle as b, type GraphAutoCheckpointOptions as c, GRAPH_META_SEGMENT as d, type GraphActorOptions as e, type GraphCheckpointRecord as f, type GraphDescribeOptions as g, type GraphDescribeOutput as h, type GraphDiagramDirection as i, type GraphDiagramOptions as j, type GraphDiffChange as k, type GraphDiffResult as l, type GraphDumpOptions as m, type GraphFactoryContext as n, type GraphNodeFactory as o, type GraphObserveAll as p, type GraphObserveOne as q, type GraphPersistSnapshot as r, type ObserveEvent as s, type ObserveOptions as t, type ObserveResult as u, type ObserveTheme as v, type ObserveThemeName as w, type ReachableOptions as x, reachable as y };
+export { type AutoCheckpointAdapter as A, graphProfile as B, reachable as C, type DescribeFilter as D, Graph as G, type NodeProfile as N, type ObserveDetail as O, type ReachableDirection as R, type TraceEntry as T, type GraphOptions as a, type GraphAutoCheckpointHandle as b, type GraphAutoCheckpointOptions as c, type GraphProfileResult as d, type GraphProfileOptions as e, GRAPH_META_SEGMENT as f, type GraphActorOptions as g, type GraphCheckpointRecord as h, type GraphDescribeOptions as i, type GraphDescribeOutput as j, type GraphDiagramDirection as k, type GraphDiagramOptions as l, type GraphDiffChange as m, type GraphDiffResult as n, type GraphDumpOptions as o, type GraphFactoryContext as p, type GraphNodeFactory as q, type GraphObserveAll as r, type GraphObserveOne as s, type GraphPersistSnapshot as t, type ObserveEvent as u, type ObserveOptions as v, type ObserveResult as w, type ObserveTheme as x, type ObserveThemeName as y, type ReachableOptions as z };

package/dist/{graph-BYFlyNpX.d.cts → graph-mILUUqW8.d.ts}

@@ -1,4 +1,67 @@
-import { j as DescribeNodeOutput, h as DescribeDetail, i as DescribeField, N as Node, y as VersioningLevel, A as Actor, m as Messages, p as NodeSink } from './meta-npl5b97j.cjs';
+import { i as DescribeNodeOutput, g as DescribeDetail, h as DescribeField, N as Node, y as VersioningLevel, A as Actor, l as Messages, o as NodeSink } from './meta-BnG7XAaE.js';
+
+/**
+ * Graph profiling and inspection utilities.
+ *
+ * Provides per-node memory estimation, connectivity stats, and hotspot
+ * detection. Non-invasive — reads from `describe()` and node internals
+ * without modifying state.
+ *
+ * @module
+ */
+
+/** Per-node profile entry. */
+interface NodeProfile {
+    /** Qualified path within the graph. */
+    path: string;
+    /** Node type (state, derived, producer, effect). */
+    type: string;
+    /** Node status (disconnected, dirty, settled, errored, completed). */
+    status: string;
+    /** Approximate retained bytes for the node's cached value. */
+    valueSizeBytes: number;
+    /** Number of downstream subscribers (sinks). */
+    subscriberCount: number;
+    /** Number of upstream dependencies. */
+    depCount: number;
+    /** True if this is an effect node with no external subscribers (potential leak). */
+    isOrphanEffect: boolean;
+}
+/** Aggregate graph profile. */
+interface GraphProfileResult {
+    /** Total node count. */
+    nodeCount: number;
+    /** Total edge count. */
+    edgeCount: number;
+    /** Subgraph count. */
+    subgraphCount: number;
+    /** All node profiles. */
+    nodes: NodeProfile[];
+    /** Total approximate value memory across all nodes. */
+    totalValueSizeBytes: number;
+    /** Nodes sorted by valueSizeBytes descending (top N). */
+    hotspots: NodeProfile[];
+    /** Effect nodes with no external subscribers (potential leaks). */
+    orphanEffects: NodeProfile[];
+}
+/** Options for {@link graphProfile}. */
+interface GraphProfileOptions {
+    /** Limit hotspot list (default 10). */
+    topN?: number;
+    /** Include subgraph nodes recursively (default true). */
+    recursive?: boolean;
+}
+/**
+ * Profile a graph's memory and connectivity characteristics.
+ *
+ * Uses `describe({ detail: "standard" })` for node metadata and direct
+ * `NodeImpl` access for subscriber counts and cached values.
+ *
+ * @param graph - The graph to profile.
+ * @param opts - Optional configuration.
+ * @returns Aggregate profile with per-node details and hotspots.
+ */
+declare function graphProfile(graph: Graph, opts?: GraphProfileOptions): GraphProfileResult;
 
 /**
  * Reserved segment for meta companion paths: `nodeName::__meta__::metaKey` (GRAPHREFLY-SPEC §3.6).
@@ -189,10 +252,12 @@ type ObserveResult<T = unknown> = {
     readonly resolvedCount: number;
     /** All events in order. */
     readonly events: ObserveEvent[];
-    /** True if COMPLETE received without prior ERROR. */
-    readonly completedCleanly: boolean;
-    /** True if ERROR received. */
-    readonly errored: boolean;
+    /** True if any observed node sent COMPLETE without prior ERROR on that node. */
+    readonly anyCompletedCleanly: boolean;
+    /** True if any observed node sent ERROR. */
+    readonly anyErrored: boolean;
+    /** True if at least one COMPLETE received and no ERROR from any observed node. */
+    readonly completedWithoutErrors: boolean;
     /** Stop observing. */
     dispose(): void;
     /**
@@ -427,6 +492,14 @@ declare class Graph {
     describe(options?: GraphDescribeOptions): GraphDescribeOutput;
     private _collectSubgraphs;
     private _collectAllEdges;
+    /**
+     * Snapshot-based resource profile: per-node stats, orphan effect detection,
+     * memory hotspots. Zero runtime overhead — walks nodes on demand.
+     *
+     * @param opts - Optional `topN` for hotspot limit (default 10).
+     * @returns Aggregate profile with per-node details, hotspots, and orphan effects.
+     */
+    resourceProfile(opts?: GraphProfileOptions): GraphProfileResult;
     private _qualifyEdgeEndpoint;
     private _collectObserveTargets;
     private _appendMetaObserveTargets;
@@ -557,8 +630,9 @@ declare class Graph {
     /**
      * Debounced persistence wired to graph-wide observe stream (spec §3.8 auto-checkpoint).
      *
-     * Checkpoint trigger uses {@link messageTier}: only batches containing tier >= 2 messages
-     * schedule a save (`DATA`/`RESOLVED`/terminal/destruction), never pure tier-0/1 control waves.
+     * Checkpoint trigger uses {@link messageTier}: only batches containing tier >= 3 messages
+     * schedule a save (`DATA`/`RESOLVED`/terminal/destruction), never pure tier-0/1/2 control
+     * waves (`START`/`DIRTY`/`INVALIDATE`/`PAUSE`/`RESUME`).
      */
     autoCheckpoint(adapter: AutoCheckpointAdapter, options?: GraphAutoCheckpointOptions): GraphAutoCheckpointHandle;
     /**
@@ -673,4 +747,4 @@ type ReachableOptions = {
  */
 declare function reachable(described: GraphDescribeOutput, from: string, direction: ReachableDirection, options?: ReachableOptions): string[];
 
-export { type AutoCheckpointAdapter as A, type DescribeFilter as D, Graph as G, type ObserveDetail as O, type ReachableDirection as R, type TraceEntry as T, type GraphOptions as a, type GraphAutoCheckpointHandle as b, type GraphAutoCheckpointOptions as c, GRAPH_META_SEGMENT as d, type GraphActorOptions as e, type GraphCheckpointRecord as f, type GraphDescribeOptions as g, type GraphDescribeOutput as h, type GraphDiagramDirection as i, type GraphDiagramOptions as j, type GraphDiffChange as k, type GraphDiffResult as l, type GraphDumpOptions as m, type GraphFactoryContext as n, type GraphNodeFactory as o, type GraphObserveAll as p, type GraphObserveOne as q, type GraphPersistSnapshot as r, type ObserveEvent as s, type ObserveOptions as t, type ObserveResult as u, type ObserveTheme as v, type ObserveThemeName as w, type ReachableOptions as x, reachable as y };
+export { type AutoCheckpointAdapter as A, graphProfile as B, reachable as C, type DescribeFilter as D, Graph as G, type NodeProfile as N, type ObserveDetail as O, type ReachableDirection as R, type TraceEntry as T, type GraphOptions as a, type GraphAutoCheckpointHandle as b, type GraphAutoCheckpointOptions as c, type GraphProfileResult as d, type GraphProfileOptions as e, GRAPH_META_SEGMENT as f, type GraphActorOptions as g, type GraphCheckpointRecord as h, type GraphDescribeOptions as i, type GraphDescribeOutput as j, type GraphDiagramDirection as k, type GraphDiagramOptions as l, type GraphDiffChange as m, type GraphDiffResult as n, type GraphDumpOptions as o, type GraphFactoryContext as p, type GraphNodeFactory as q, type GraphObserveAll as r, type GraphObserveOne as s, type GraphPersistSnapshot as t, type ObserveEvent as u, type ObserveOptions as v, type ObserveResult as w, type ObserveTheme as x, type ObserveThemeName as y, type ReachableOptions as z };

package/dist/{index-CgKPpiu8.d.ts → index-8a605sg9.d.ts}

@@ -1,5 +1,5 @@
-import { N as Node } from './meta-npl5b97j.js';
-import { G as Graph } from './graph-gISB9n3n.js';
+import { N as Node } from './meta-BnG7XAaE.js';
+import { G as Graph } from './graph-mILUUqW8.js';
 
 /** Pluggable measurement backend. */
 interface MeasurementAdapter {

package/dist/{index-DKaB2x0T.d.ts → index-B2SvPEbc.d.ts}

@@ -1,4 +1,4 @@
-import { r as GraphPersistSnapshot, G as Graph, A as AutoCheckpointAdapter, D as DescribeFilter, d as GRAPH_META_SEGMENT, e as GraphActorOptions, b as GraphAutoCheckpointHandle, c as GraphAutoCheckpointOptions, f as GraphCheckpointRecord, g as GraphDescribeOptions, h as GraphDescribeOutput, i as GraphDiagramDirection, j as GraphDiagramOptions, k as GraphDiffChange, l as GraphDiffResult, m as GraphDumpOptions, n as GraphFactoryContext, o as GraphNodeFactory, p as GraphObserveAll, q as GraphObserveOne, a as GraphOptions, O as ObserveDetail, s as ObserveEvent, t as ObserveOptions, u as ObserveResult, v as ObserveTheme, w as ObserveThemeName, R as ReachableDirection, x as ReachableOptions, T as TraceEntry, y as reachable } from './graph-gISB9n3n.js';
+import { t as GraphPersistSnapshot, A as AutoCheckpointAdapter, D as DescribeFilter, f as GRAPH_META_SEGMENT, G as Graph, g as GraphActorOptions, b as GraphAutoCheckpointHandle, c as GraphAutoCheckpointOptions, h as GraphCheckpointRecord, i as GraphDescribeOptions, j as GraphDescribeOutput, k as GraphDiagramDirection, l as GraphDiagramOptions, m as GraphDiffChange, n as GraphDiffResult, o as GraphDumpOptions, p as GraphFactoryContext, q as GraphNodeFactory, r as GraphObserveAll, s as GraphObserveOne, a as GraphOptions, e as GraphProfileOptions, d as GraphProfileResult, N as NodeProfile, O as ObserveDetail, u as ObserveEvent, v as ObserveOptions, w as ObserveResult, x as ObserveTheme, y as ObserveThemeName, R as ReachableDirection, z as ReachableOptions, T as TraceEntry, B as graphProfile, C as reachable } from './graph-mILUUqW8.js';
 
 /**
  * GraphCodec — pluggable serialization for graph snapshots (Phase 8.6).
@@ -178,65 +178,6 @@ declare function negotiateCodec(localPreference: readonly GraphCodec[], remoteCo
  */
 declare function replayWAL(entries: readonly WALEntry[]): GraphPersistSnapshot;
 
-/**
- * Graph profiling and inspection utilities.
- *
- * Provides per-node memory estimation, connectivity stats, and hotspot
- * detection. Non-invasive — reads from `describe()` and node internals
- * without modifying state.
- *
- * @module
- */
-
-/** Per-node profile entry. */
-interface NodeProfile {
-    /** Qualified path within the graph. */
-    path: string;
-    /** Node type (state, derived, producer, effect). */
-    type: string;
-    /** Node status (disconnected, dirty, settled, errored, completed). */
-    status: string;
-    /** Approximate retained bytes for the node's cached value. */
-    valueSizeBytes: number;
-    /** Number of downstream subscribers (sinks). */
-    subscriberCount: number;
-    /** Number of upstream dependencies. */
-    depCount: number;
-}
-/** Aggregate graph profile. */
-interface GraphProfileResult {
-    /** Total node count. */
-    nodeCount: number;
-    /** Total edge count. */
-    edgeCount: number;
-    /** Subgraph count. */
-    subgraphCount: number;
-    /** All node profiles. */
-    nodes: NodeProfile[];
-    /** Total approximate value memory across all nodes. */
-    totalValueSizeBytes: number;
-    /** Nodes sorted by valueSizeBytes descending (top N). */
-    hotspots: NodeProfile[];
-}
-/** Options for {@link graphProfile}. */
-interface GraphProfileOptions {
-    /** Limit hotspot list (default 10). */
-    topN?: number;
-    /** Include subgraph nodes recursively (default true). */
-    recursive?: boolean;
-}
-/**
- * Profile a graph's memory and connectivity characteristics.
- *
- * Uses `describe({ detail: "standard" })` for node metadata and direct
- * `NodeImpl` access for subscriber counts and cached values.
- *
- * @param graph - The graph to profile.
- * @param opts - Optional configuration.
- * @returns Aggregate profile with per-node details and hotspots.
- */
-declare function graphProfile(graph: Graph, opts?: GraphProfileOptions): GraphProfileResult;
-
 /**
  * Approximate in-memory size estimation for arbitrary JS values.
  *
@@ -287,11 +228,11 @@ declare const index_GraphObserveAll: typeof GraphObserveAll;
 declare const index_GraphObserveOne: typeof GraphObserveOne;
 declare const index_GraphOptions: typeof GraphOptions;
 declare const index_GraphPersistSnapshot: typeof GraphPersistSnapshot;
-type index_GraphProfileOptions = GraphProfileOptions;
-type index_GraphProfileResult = GraphProfileResult;
+declare const index_GraphProfileOptions: typeof GraphProfileOptions;
+declare const index_GraphProfileResult: typeof GraphProfileResult;
 declare const index_JsonCodec: typeof JsonCodec;
 type index_LazyGraphCodec = LazyGraphCodec;
-type index_NodeProfile = NodeProfile;
+declare const index_NodeProfile: typeof NodeProfile;
 declare const index_ObserveDetail: typeof ObserveDetail;
 declare const index_ObserveEvent: typeof ObserveEvent;
 declare const index_ObserveOptions: typeof ObserveOptions;
@@ -310,7 +251,7 @@ declare const index_reachable: typeof reachable;
 declare const index_replayWAL: typeof replayWAL;
 declare const index_sizeof: typeof sizeof;
 declare namespace index {
-  export { index_AutoCheckpointAdapter as AutoCheckpointAdapter, type index_DeltaCheckpoint as DeltaCheckpoint, index_DescribeFilter as DescribeFilter, type index_EvictedSubgraphInfo as EvictedSubgraphInfo, type index_EvictionPolicy as EvictionPolicy, index_GRAPH_META_SEGMENT as GRAPH_META_SEGMENT, index_Graph as Graph, index_GraphActorOptions as GraphActorOptions, index_GraphAutoCheckpointHandle as GraphAutoCheckpointHandle, index_GraphAutoCheckpointOptions as GraphAutoCheckpointOptions, index_GraphCheckpointRecord as GraphCheckpointRecord, type index_GraphCodec as GraphCodec, index_GraphDescribeOptions as GraphDescribeOptions, index_GraphDescribeOutput as GraphDescribeOutput, index_GraphDiagramDirection as GraphDiagramDirection, index_GraphDiagramOptions as GraphDiagramOptions, index_GraphDiffChange as GraphDiffChange, index_GraphDiffResult as GraphDiffResult, index_GraphDumpOptions as GraphDumpOptions, index_GraphFactoryContext as GraphFactoryContext, index_GraphNodeFactory as GraphNodeFactory, index_GraphObserveAll as GraphObserveAll, index_GraphObserveOne as GraphObserveOne, index_GraphOptions as GraphOptions, index_GraphPersistSnapshot as GraphPersistSnapshot, type index_GraphProfileOptions as GraphProfileOptions, type index_GraphProfileResult as GraphProfileResult, index_JsonCodec as JsonCodec, type index_LazyGraphCodec as LazyGraphCodec, type index_NodeProfile as NodeProfile, index_ObserveDetail as ObserveDetail, index_ObserveEvent as ObserveEvent, index_ObserveOptions as ObserveOptions, index_ObserveResult as ObserveResult, index_ObserveTheme as ObserveTheme, index_ObserveThemeName as ObserveThemeName, index_ReachableDirection as ReachableDirection, index_ReachableOptions as ReachableOptions, index_TraceEntry as TraceEntry, type index_WALEntry as WALEntry, index_createDagCborCodec as createDagCborCodec, index_createDagCborZstdCodec as createDagCborZstdCodec, index_graphProfile as graphProfile, index_negotiateCodec as negotiateCodec, index_reachable as reachable, index_replayWAL as replayWAL, index_sizeof as sizeof };
+  export { index_AutoCheckpointAdapter as AutoCheckpointAdapter, type index_DeltaCheckpoint as DeltaCheckpoint, index_DescribeFilter as DescribeFilter, type index_EvictedSubgraphInfo as EvictedSubgraphInfo, type index_EvictionPolicy as EvictionPolicy, index_GRAPH_META_SEGMENT as GRAPH_META_SEGMENT, index_Graph as Graph, index_GraphActorOptions as GraphActorOptions, index_GraphAutoCheckpointHandle as GraphAutoCheckpointHandle, index_GraphAutoCheckpointOptions as GraphAutoCheckpointOptions, index_GraphCheckpointRecord as GraphCheckpointRecord, type index_GraphCodec as GraphCodec, index_GraphDescribeOptions as GraphDescribeOptions, index_GraphDescribeOutput as GraphDescribeOutput, index_GraphDiagramDirection as GraphDiagramDirection, index_GraphDiagramOptions as GraphDiagramOptions, index_GraphDiffChange as GraphDiffChange, index_GraphDiffResult as GraphDiffResult, index_GraphDumpOptions as GraphDumpOptions, index_GraphFactoryContext as GraphFactoryContext, index_GraphNodeFactory as GraphNodeFactory, index_GraphObserveAll as GraphObserveAll, index_GraphObserveOne as GraphObserveOne, index_GraphOptions as GraphOptions, index_GraphPersistSnapshot as GraphPersistSnapshot, index_GraphProfileOptions as GraphProfileOptions, index_GraphProfileResult as GraphProfileResult, index_JsonCodec as JsonCodec, type index_LazyGraphCodec as LazyGraphCodec, index_NodeProfile as NodeProfile, index_ObserveDetail as ObserveDetail, index_ObserveEvent as ObserveEvent, index_ObserveOptions as ObserveOptions, index_ObserveResult as ObserveResult, index_ObserveTheme as ObserveTheme, index_ObserveThemeName as ObserveThemeName, index_ReachableDirection as ReachableDirection, index_ReachableOptions as ReachableOptions, index_TraceEntry as TraceEntry, type index_WALEntry as WALEntry, index_createDagCborCodec as createDagCborCodec, index_createDagCborZstdCodec as createDagCborZstdCodec, index_graphProfile as graphProfile, index_negotiateCodec as negotiateCodec, index_reachable as reachable, index_replayWAL as replayWAL, index_sizeof as sizeof };
 }
 
-export { type DeltaCheckpoint as D, type EvictedSubgraphInfo as E, type GraphProfileResult as G, JsonCodec as J, type LazyGraphCodec as L, type NodeProfile as N, type WALEntry as W, type GraphProfileOptions as a, type EvictionPolicy as b, type GraphCodec as c, createDagCborCodec as d, createDagCborZstdCodec as e, graphProfile as g, index as i, negotiateCodec as n, replayWAL as r, sizeof as s };
+export { type DeltaCheckpoint as D, type EvictedSubgraphInfo as E, type GraphCodec as G, JsonCodec as J, type LazyGraphCodec as L, type WALEntry as W, type EvictionPolicy as a, createDagCborZstdCodec as b, createDagCborCodec as c, index as i, negotiateCodec as n, replayWAL as r, sizeof as s };