@agent-scope/runtime 1.2.0 → 1.4.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { ComponentType, ComponentNode, PageReport, ConsoleEntry, CapturedError, HookState, SuspenseBoundaryInfo } from '@agent-scope/core';
-export { CapturedError, ComponentNode, PageReport, SuspenseBoundaryInfo } from '@agent-scope/core';
+import { ComponentType, ComponentNode, LightweightComponentNode, PageReport, CapturedError, SuspenseBoundaryInfo, ConsoleEntry, HookState } from '@agent-scope/core';
+export { CapturedError, ComponentNode, LightweightComponentNode, PageReport, SuspenseBoundaryInfo } from '@agent-scope/core';
 
 /**
  * devtools-hook.ts
@@ -167,6 +167,26 @@ declare function walkFiber(fiber: Fiber | null, options?: WalkOptions): Componen
  */
 declare function walkFiberRoot(fiberRoot: any, options?: WalkOptions): ComponentNode | null;
 
+/**
+ * Walk a fiber and all its descendants, producing a `LightweightComponentNode`
+ * tree.  Props, state values, context, source, renderCount and renderDuration
+ * are deliberately omitted — only structural / identification fields are
+ * included.
+ *
+ * @param fiber   - The starting fiber.
+ * @param options - Walk configuration (same as `walkFiber`).
+ * @returns The `LightweightComponentNode` for `fiber`, or `null` if it should
+ *          be skipped.
+ */
+declare function walkFiberLightweight(fiber: Fiber | null, options?: WalkOptions): LightweightComponentNode | null;
+/**
+ * Walk a fiber root (as returned by the DevTools hook) and return the root
+ * `LightweightComponentNode`, or `null` if the tree is empty.
+ *
+ * Mirrors `walkFiberRoot` but uses the lightweight walker.
+ */
+declare function walkFiberRootLightweight(fiberRoot: any, options?: WalkOptions): LightweightComponentNode | null;
+
 /**
  * capture.ts
  *
@@ -185,9 +205,29 @@ interface CaptureOptions extends WalkOptions {
      * Default: 10 000.
      */
     reactTimeout?: number;
+    /**
+     * When `true`, perform a lightweight capture that omits props, state,
+     * context, source, renderCount, and renderDuration.
+     *
+     * Produces a `LightweightCaptureResult` instead of a full `CaptureResult`.
+     * Expected size reduction: ~99% (e.g. 300 MB → ~3 MB for 2 500 nodes).
+     *
+     * Default: `false`.
+     */
+    lightweight?: boolean;
 }
-/** The fields populated by `capture()`.  The rest can be added by callers. */
+/** The fields populated by a full `capture()`. */
 type CaptureResult = Pick<PageReport, "url" | "timestamp" | "capturedIn" | "tree" | "consoleEntries" | "errors" | "suspenseBoundaries">;
+/** The fields populated by a lightweight `capture({ lightweight: true })`. */
+interface LightweightCaptureResult {
+    url: string;
+    timestamp: number;
+    capturedIn: number;
+    tree: LightweightComponentNode;
+    consoleEntries: PageReport["consoleEntries"];
+    errors: CapturedError[];
+    suspenseBoundaries: SuspenseBoundaryInfo[];
+}
 /**
  * Capture a snapshot of the current React component tree.
  *
@@ -200,11 +240,18 @@ type CaptureResult = Pick<PageReport, "url" | "timestamp" | "capturedIn" | "tree
  * Also detects error boundaries that have caught errors and Suspense
  * boundaries with their current suspension status.
  *
- * @returns A partial `PageReport` containing `url`, `timestamp`, `capturedIn`,
- *          `tree`, `consoleEntries`, `errors`, and `suspenseBoundaries`.
+ * @param options.lightweight - When `true`, returns a `LightweightCaptureResult`
+ *   with a minimal tree (no props/state/context/source/renderCount/renderDuration).
+ *
+ * @returns A `CaptureResult` (or `LightweightCaptureResult` when lightweight is
+ *          true) containing `url`, `timestamp`, `capturedIn`, `tree`,
+ *          `consoleEntries`, `errors`, and `suspenseBoundaries`.
  * @throws  If no React renderer registers within `reactTimeout` ms, or if the
  *          fiber tree is empty.
  */
+declare function capture(options: CaptureOptions & {
+    lightweight: true;
+}): Promise<LightweightCaptureResult>;
 declare function capture(options?: CaptureOptions): Promise<CaptureResult>;
 
 /**
@@ -422,4 +469,4 @@ declare class ScopeRuntime {
 /** Create and return a new ScopeRuntime instance */
 declare function createRuntime(options?: RuntimeOptions): ScopeRuntime;
 
-export { type CaptureOptions, type CaptureResult, type Fiber, type ProfilingSnapshot, type ReactRenderer, type RuntimeOptions, type ScopeDevToolsHook, ScopeRuntime, type WalkOptions, capture, classifyType, clearConsoleEntries, createRuntime, detectErrors, detectSuspenseBoundaries, extractHooks, extractName, getConsoleEntries, getHook, getProfilingData, getRenderers, installConsoleInterceptor, installHook, installProfiler, resetProfilingData, uninstallConsoleInterceptor, waitForReact, walkFiber, walkFiberRoot };
+export { type CaptureOptions, type CaptureResult, type Fiber, type LightweightCaptureResult, type ProfilingSnapshot, type ReactRenderer, type RuntimeOptions, type ScopeDevToolsHook, ScopeRuntime, type WalkOptions, capture, classifyType, clearConsoleEntries, createRuntime, detectErrors, detectSuspenseBoundaries, extractHooks, extractName, getConsoleEntries, getHook, getProfilingData, getRenderers, installConsoleInterceptor, installHook, installProfiler, resetProfilingData, uninstallConsoleInterceptor, waitForReact, walkFiber, walkFiberLightweight, walkFiberRoot, walkFiberRootLightweight };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { ComponentType, ComponentNode, PageReport, ConsoleEntry, CapturedError, HookState, SuspenseBoundaryInfo } from '@agent-scope/core';
-export { CapturedError, ComponentNode, PageReport, SuspenseBoundaryInfo } from '@agent-scope/core';
+import { ComponentType, ComponentNode, LightweightComponentNode, PageReport, CapturedError, SuspenseBoundaryInfo, ConsoleEntry, HookState } from '@agent-scope/core';
+export { CapturedError, ComponentNode, LightweightComponentNode, PageReport, SuspenseBoundaryInfo } from '@agent-scope/core';
 
 /**
  * devtools-hook.ts
@@ -167,6 +167,26 @@ declare function walkFiber(fiber: Fiber | null, options?: WalkOptions): Componen
  */
 declare function walkFiberRoot(fiberRoot: any, options?: WalkOptions): ComponentNode | null;
 
+/**
+ * Walk a fiber and all its descendants, producing a `LightweightComponentNode`
+ * tree.  Props, state values, context, source, renderCount and renderDuration
+ * are deliberately omitted — only structural / identification fields are
+ * included.
+ *
+ * @param fiber   - The starting fiber.
+ * @param options - Walk configuration (same as `walkFiber`).
+ * @returns The `LightweightComponentNode` for `fiber`, or `null` if it should
+ *          be skipped.
+ */
+declare function walkFiberLightweight(fiber: Fiber | null, options?: WalkOptions): LightweightComponentNode | null;
+/**
+ * Walk a fiber root (as returned by the DevTools hook) and return the root
+ * `LightweightComponentNode`, or `null` if the tree is empty.
+ *
+ * Mirrors `walkFiberRoot` but uses the lightweight walker.
+ */
+declare function walkFiberRootLightweight(fiberRoot: any, options?: WalkOptions): LightweightComponentNode | null;
+
 /**
  * capture.ts
  *
@@ -185,9 +205,29 @@ interface CaptureOptions extends WalkOptions {
      * Default: 10 000.
      */
     reactTimeout?: number;
+    /**
+     * When `true`, perform a lightweight capture that omits props, state,
+     * context, source, renderCount, and renderDuration.
+     *
+     * Produces a `LightweightCaptureResult` instead of a full `CaptureResult`.
+     * Expected size reduction: ~99% (e.g. 300 MB → ~3 MB for 2 500 nodes).
+     *
+     * Default: `false`.
+     */
+    lightweight?: boolean;
 }
-/** The fields populated by `capture()`.  The rest can be added by callers. */
+/** The fields populated by a full `capture()`. */
 type CaptureResult = Pick<PageReport, "url" | "timestamp" | "capturedIn" | "tree" | "consoleEntries" | "errors" | "suspenseBoundaries">;
+/** The fields populated by a lightweight `capture({ lightweight: true })`. */
+interface LightweightCaptureResult {
+    url: string;
+    timestamp: number;
+    capturedIn: number;
+    tree: LightweightComponentNode;
+    consoleEntries: PageReport["consoleEntries"];
+    errors: CapturedError[];
+    suspenseBoundaries: SuspenseBoundaryInfo[];
+}
 /**
  * Capture a snapshot of the current React component tree.
  *
@@ -200,11 +240,18 @@ type CaptureResult = Pick<PageReport, "url" | "timestamp" | "capturedIn" | "tree
  * Also detects error boundaries that have caught errors and Suspense
  * boundaries with their current suspension status.
  *
- * @returns A partial `PageReport` containing `url`, `timestamp`, `capturedIn`,
- *          `tree`, `consoleEntries`, `errors`, and `suspenseBoundaries`.
+ * @param options.lightweight - When `true`, returns a `LightweightCaptureResult`
+ *   with a minimal tree (no props/state/context/source/renderCount/renderDuration).
+ *
+ * @returns A `CaptureResult` (or `LightweightCaptureResult` when lightweight is
+ *          true) containing `url`, `timestamp`, `capturedIn`, `tree`,
+ *          `consoleEntries`, `errors`, and `suspenseBoundaries`.
  * @throws  If no React renderer registers within `reactTimeout` ms, or if the
  *          fiber tree is empty.
  */
+declare function capture(options: CaptureOptions & {
+    lightweight: true;
+}): Promise<LightweightCaptureResult>;
 declare function capture(options?: CaptureOptions): Promise<CaptureResult>;
 
 /**
@@ -422,4 +469,4 @@ declare class ScopeRuntime {
 /** Create and return a new ScopeRuntime instance */
 declare function createRuntime(options?: RuntimeOptions): ScopeRuntime;
 
-export { type CaptureOptions, type CaptureResult, type Fiber, type ProfilingSnapshot, type ReactRenderer, type RuntimeOptions, type ScopeDevToolsHook, ScopeRuntime, type WalkOptions, capture, classifyType, clearConsoleEntries, createRuntime, detectErrors, detectSuspenseBoundaries, extractHooks, extractName, getConsoleEntries, getHook, getProfilingData, getRenderers, installConsoleInterceptor, installHook, installProfiler, resetProfilingData, uninstallConsoleInterceptor, waitForReact, walkFiber, walkFiberRoot };
+export { type CaptureOptions, type CaptureResult, type Fiber, type LightweightCaptureResult, type ProfilingSnapshot, type ReactRenderer, type RuntimeOptions, type ScopeDevToolsHook, ScopeRuntime, type WalkOptions, capture, classifyType, clearConsoleEntries, createRuntime, detectErrors, detectSuspenseBoundaries, extractHooks, extractName, getConsoleEntries, getHook, getProfilingData, getRenderers, installConsoleInterceptor, installHook, installProfiler, resetProfilingData, uninstallConsoleInterceptor, waitForReact, walkFiber, walkFiberLightweight, walkFiberRoot, walkFiberRootLightweight };

package/dist/index.js

@@ -695,6 +695,131 @@ function walkFiberRoot(fiberRoot, options = {}) {
     children
   };
 }
+var HookLayout2 = 4;
+function isLightweightEffectNode(node) {
+  const ms = node.memoizedState;
+  if (ms === null || typeof ms !== "object") return false;
+  const obj = ms;
+  return typeof obj.create === "function" && "deps" in obj && typeof obj.tag === "number";
+}
+function isLightweightRefNode(node) {
+  if (node.queue != null) return false;
+  const ms = node.memoizedState;
+  if (ms === null || typeof ms !== "object" || Array.isArray(ms)) return false;
+  const keys = Object.keys(ms);
+  return keys.length === 1 && keys[0] === "current";
+}
+function isLightweightMemoTuple(node) {
+  if (node.queue != null) return false;
+  const ms = node.memoizedState;
+  if (!Array.isArray(ms) || ms.length !== 2) return false;
+  return ms[1] === null || Array.isArray(ms[1]);
+}
+function isLightweightStateOrReducer(node) {
+  return node.queue != null && typeof node.queue === "object" && typeof node.queue.dispatch === "function";
+}
+function isLightweightReducer(node) {
+  if (!isLightweightStateOrReducer(node)) return false;
+  const q = node.queue;
+  if (typeof q.reducer === "function") return true;
+  const lrr = q.lastRenderedReducer;
+  if (typeof lrr !== "function") return false;
+  const name = lrr.name ?? "";
+  return name !== "basicStateReducer" && name !== "";
+}
+function classifyHookType(node) {
+  if (isLightweightEffectNode(node)) {
+    const ms = node.memoizedState;
+    return ms.tag & HookLayout2 ? "useLayoutEffect" : "useEffect";
+  }
+  if (isLightweightRefNode(node)) return "useRef";
+  if (isLightweightMemoTuple(node)) {
+    const [val] = node.memoizedState;
+    return typeof val === "function" ? "useCallback" : "useMemo";
+  }
+  if (isLightweightStateOrReducer(node)) {
+    return isLightweightReducer(node) ? "useReducer" : "useState";
+  }
+  return "custom";
+}
+function countAndClassifyHooks(fiber) {
+  const hookTypes = [];
+  let node = fiber.memoizedState ?? null;
+  if (node === null || typeof node !== "object" || !("next" in node)) {
+    return { hookCount: 0, hookTypes: [] };
+  }
+  while (node !== null) {
+    hookTypes.push(classifyHookType(node));
+    node = node.next ?? null;
+  }
+  return { hookCount: hookTypes.length, hookTypes };
+}
+function walkFiberLightweight(fiber, options = {}) {
+  if (fiber === null || fiber === void 0) return null;
+  const includeHost = options.includeHostElements ?? false;
+  return walkFiberLightweightInner(fiber, includeHost, /* @__PURE__ */ new Set(), 0);
+}
+function walkFiberLightweightInner(fiber, includeHost, visited, depth) {
+  if (fiber === null || fiber === void 0) return null;
+  if (visited.has(fiber)) return null;
+  if (shouldSkip(fiber, includeHost)) return null;
+  visited.add(fiber);
+  const id = typeof fiber._debugID === "number" ? fiber._debugID : nextId();
+  const { hookCount, hookTypes } = countAndClassifyHooks(fiber);
+  const children = collectLightweightChildren(fiber, includeHost, visited, depth + 1);
+  const node = {
+    id,
+    name: extractName(fiber),
+    type: classifyType(fiber),
+    hookCount,
+    hookTypes,
+    childCount: children.length,
+    depth,
+    children
+  };
+  return node;
+}
+function collectLightweightChildren(fiber, includeHost, visited, childDepth) {
+  const nodes = [];
+  let current = fiber.child ?? null;
+  while (current !== null) {
+    if (visited.has(current)) {
+      current = current.sibling ?? null;
+      continue;
+    }
+    if (shouldSkip(current, includeHost)) {
+      const promoted = collectLightweightChildren(current, includeHost, visited, childDepth);
+      nodes.push(...promoted);
+    } else {
+      const node = walkFiberLightweightInner(current, includeHost, visited, childDepth);
+      if (node !== null) {
+        nodes.push(node);
+      }
+    }
+    current = current.sibling ?? null;
+  }
+  return nodes;
+}
+function walkFiberRootLightweight(fiberRoot, options = {}) {
+  if (!fiberRoot) return null;
+  const hostRootFiber = fiberRoot.current ?? null;
+  if (!hostRootFiber) return null;
+  const includeHost = options.includeHostElements ?? false;
+  const visited = /* @__PURE__ */ new Set();
+  const children = collectLightweightChildren(hostRootFiber, includeHost, visited, 0);
+  if (children.length === 0) return null;
+  if (children.length === 1) return children[0] ?? null;
+  return {
+    id: nextId(),
+    name: "Root",
+    type: "function",
+    hookCount: 0,
+    hookTypes: [],
+    childCount: children.length,
+    depth: 0,
+    children
+  };
+}
 
 // src/suspense-detector.ts
 var SuspenseComponent2 = 13;
@@ -786,18 +911,35 @@ async function capture(options = {}) {
     const walkOptions = {
       includeHostElements: options.includeHostElements ?? false
     };
-    const tree = walkFiberRoot(fiberRoot, walkOptions);
-    if (!tree) {
-      throw new Error(
-        "capture(): Fiber tree is empty. Make sure React has rendered at least one component."
-      );
-    }
     const hostRootFiber = fiberRoot.current ?? null;
     const rootChild = hostRootFiber?.child ?? null;
     const errors = detectErrors(rootChild);
     const suspenseBoundaries = detectSuspenseBoundaries(rootChild);
     const capturedIn = Date.now() - startTime;
     const consoleEntries = getConsoleEntries();
+    if (options.lightweight) {
+      const tree2 = walkFiberRootLightweight(fiberRoot, walkOptions);
+      if (!tree2) {
+        throw new Error(
+          "capture(): Fiber tree is empty. Make sure React has rendered at least one component."
+        );
+      }
+      return {
+        url,
+        timestamp: startTime,
+        capturedIn,
+        tree: tree2,
+        consoleEntries,
+        errors,
+        suspenseBoundaries
+      };
+    }
+    const tree = walkFiberRoot(fiberRoot, walkOptions);
+    if (!tree) {
+      throw new Error(
+        "capture(): Fiber tree is empty. Make sure React has rendered at least one component."
+      );
+    }
     return {
       url,
       timestamp: startTime,
@@ -852,6 +994,6 @@ function createRuntime(options) {
   return new ScopeRuntime(options);
 }
 
-export { ScopeRuntime, capture, classifyType, clearConsoleEntries, createRuntime, detectErrors, detectSuspenseBoundaries, extractHooks, extractName, getConsoleEntries, getHook, getProfilingData, getRenderers, installConsoleInterceptor, installHook, installProfiler, resetProfilingData, uninstallConsoleInterceptor, waitForReact, walkFiber, walkFiberRoot };
+export { ScopeRuntime, capture, classifyType, clearConsoleEntries, createRuntime, detectErrors, detectSuspenseBoundaries, extractHooks, extractName, getConsoleEntries, getHook, getProfilingData, getRenderers, installConsoleInterceptor, installHook, installProfiler, resetProfilingData, uninstallConsoleInterceptor, waitForReact, walkFiber, walkFiberLightweight, walkFiberRoot, walkFiberRootLightweight };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map