@agent-scope/core 1.2.0 → 1.3.0

package/dist/index.d.cts

@@ -630,4 +630,58 @@ interface SerializeOptions {
  */
 declare function serialize(value: unknown, options?: SerializeOptions): SerializedValue;
 
-export { COMPONENT_TYPES, CONSOLE_LEVELS, type CapturedError, type ComponentNode, type ComponentType, type ConsoleEntry, type ConsoleLevel, type ContextConsumption, HOOK_TYPES, type HookState, type HookType, type PageReport, type RouteInfo, SCHEMA_VERSION, SERIALIZED_VALUE_TYPES, type SerializeOptions, type SerializedValue, type SerializedValueType, type SourceLocation, type SuspenseBoundaryInfo, isCapturedError, isComponentNode, isComponentNodeDeep, isConsoleEntry, isContextConsumption, isHookState, isPageReport, isPageReportDeep, isRouteInfo, isSerializedValue, isSourceLocation, isSuspenseBoundaryInfo, serialize };
+/**
+ * A lightweight node in the captured React component tree.
+ *
+ * Used when `__SCOPE_CAPTURE__({ lightweight: true })` is called.
+ * Omits expensive fields (props, state, context, source, renderCount,
+ * renderDuration) to produce a ~99% smaller payload suitable for large trees.
+ *
+ * Each `LightweightComponentNode` corresponds to a single React fiber at the
+ * time of capture.
+ */
+interface LightweightComponentNode {
+    /**
+     * The React fiber's internal numeric ID.  Stable for the lifetime of a
+     * mounted component; reused after unmount.
+     */
+    id: number;
+    /**
+     * The resolved display name of the component.
+     */
+    name: string;
+    /**
+     * Implementation strategy of the component.
+     * @see {@link ComponentType}
+     */
+    type: ComponentType;
+    /**
+     * Total number of hooks used by this component.
+     * Derived by counting the fiber's memoizedState linked list without
+     * serializing hook values.
+     */
+    hookCount: number;
+    /**
+     * Ordered list of hook types used by this component.
+     * Ordered by hook call-order (first `use*` call = index 0).
+     * Empty for class components and host elements.
+     */
+    hookTypes: HookType[];
+    /**
+     * Number of direct children of this node.
+     * Equals `children.length`.
+     */
+    childCount: number;
+    /**
+     * Depth of this node in the tree.  Root node = 0, incremented per level.
+     */
+    depth: number;
+    /**
+     * Ordered list of child component nodes.
+     *
+     * Depth-first; an empty array means the component is a leaf node.
+     */
+    children: LightweightComponentNode[];
+}
+
+export { COMPONENT_TYPES, CONSOLE_LEVELS, type CapturedError, type ComponentNode, type ComponentType, type ConsoleEntry, type ConsoleLevel, type ContextConsumption, HOOK_TYPES, type HookState, type HookType, type LightweightComponentNode, type PageReport, type RouteInfo, SCHEMA_VERSION, SERIALIZED_VALUE_TYPES, type SerializeOptions, type SerializedValue, type SerializedValueType, type SourceLocation, type SuspenseBoundaryInfo, isCapturedError, isComponentNode, isComponentNodeDeep, isConsoleEntry, isContextConsumption, isHookState, isPageReport, isPageReportDeep, isRouteInfo, isSerializedValue, isSourceLocation, isSuspenseBoundaryInfo, serialize };

package/dist/index.d.ts

@@ -630,4 +630,58 @@ interface SerializeOptions {
  */
 declare function serialize(value: unknown, options?: SerializeOptions): SerializedValue;
 
-export { COMPONENT_TYPES, CONSOLE_LEVELS, type CapturedError, type ComponentNode, type ComponentType, type ConsoleEntry, type ConsoleLevel, type ContextConsumption, HOOK_TYPES, type HookState, type HookType, type PageReport, type RouteInfo, SCHEMA_VERSION, SERIALIZED_VALUE_TYPES, type SerializeOptions, type SerializedValue, type SerializedValueType, type SourceLocation, type SuspenseBoundaryInfo, isCapturedError, isComponentNode, isComponentNodeDeep, isConsoleEntry, isContextConsumption, isHookState, isPageReport, isPageReportDeep, isRouteInfo, isSerializedValue, isSourceLocation, isSuspenseBoundaryInfo, serialize };
+/**
+ * A lightweight node in the captured React component tree.
+ *
+ * Used when `__SCOPE_CAPTURE__({ lightweight: true })` is called.
+ * Omits expensive fields (props, state, context, source, renderCount,
+ * renderDuration) to produce a ~99% smaller payload suitable for large trees.
+ *
+ * Each `LightweightComponentNode` corresponds to a single React fiber at the
+ * time of capture.
+ */
+interface LightweightComponentNode {
+    /**
+     * The React fiber's internal numeric ID.  Stable for the lifetime of a
+     * mounted component; reused after unmount.
+     */
+    id: number;
+    /**
+     * The resolved display name of the component.
+     */
+    name: string;
+    /**
+     * Implementation strategy of the component.
+     * @see {@link ComponentType}
+     */
+    type: ComponentType;
+    /**
+     * Total number of hooks used by this component.
+     * Derived by counting the fiber's memoizedState linked list without
+     * serializing hook values.
+     */
+    hookCount: number;
+    /**
+     * Ordered list of hook types used by this component.
+     * Ordered by hook call-order (first `use*` call = index 0).
+     * Empty for class components and host elements.
+     */
+    hookTypes: HookType[];
+    /**
+     * Number of direct children of this node.
+     * Equals `children.length`.
+     */
+    childCount: number;
+    /**
+     * Depth of this node in the tree.  Root node = 0, incremented per level.
+     */
+    depth: number;
+    /**
+     * Ordered list of child component nodes.
+     *
+     * Depth-first; an empty array means the component is a leaf node.
+     */
+    children: LightweightComponentNode[];
+}
+
+export { COMPONENT_TYPES, CONSOLE_LEVELS, type CapturedError, type ComponentNode, type ComponentType, type ConsoleEntry, type ConsoleLevel, type ContextConsumption, HOOK_TYPES, type HookState, type HookType, type LightweightComponentNode, type PageReport, type RouteInfo, SCHEMA_VERSION, SERIALIZED_VALUE_TYPES, type SerializeOptions, type SerializedValue, type SerializedValueType, type SourceLocation, type SuspenseBoundaryInfo, isCapturedError, isComponentNode, isComponentNodeDeep, isConsoleEntry, isContextConsumption, isHookState, isPageReport, isPageReportDeep, isRouteInfo, isSerializedValue, isSourceLocation, isSuspenseBoundaryInfo, serialize };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-scope/core",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Core types, schemas, and serialization for Scope — zero dependencies",
   "license": "MIT",
   "type": "module",