agentflow-core 0.1.3 → 0.1.4

package/dist/{chunk-DGLK6IBP.js → chunk-TT5DLU73.js}

@@ -224,6 +224,58 @@ function createGraphBuilder(config) {
   return builder;
 }
 
+// src/loader.ts
+function toNodesMap(raw) {
+  if (raw instanceof Map) return raw;
+  if (Array.isArray(raw)) {
+    return new Map(raw);
+  }
+  if (raw !== null && typeof raw === "object") {
+    return new Map(Object.entries(raw));
+  }
+  return /* @__PURE__ */ new Map();
+}
+function loadGraph(input) {
+  const raw = typeof input === "string" ? JSON.parse(input) : input;
+  const nodes = toNodesMap(raw.nodes);
+  return {
+    id: raw.id ?? "",
+    rootNodeId: raw.rootNodeId ?? raw.rootId ?? "",
+    nodes,
+    edges: raw.edges ?? [],
+    startTime: raw.startTime ?? 0,
+    endTime: raw.endTime ?? null,
+    status: raw.status ?? "completed",
+    trigger: raw.trigger ?? "unknown",
+    agentId: raw.agentId ?? "unknown",
+    events: raw.events ?? [],
+    traceId: raw.traceId,
+    spanId: raw.spanId,
+    parentSpanId: raw.parentSpanId
+  };
+}
+function graphToJson(graph) {
+  const nodesObj = {};
+  for (const [id, node] of graph.nodes) {
+    nodesObj[id] = node;
+  }
+  return {
+    id: graph.id,
+    rootNodeId: graph.rootNodeId,
+    nodes: nodesObj,
+    edges: graph.edges,
+    startTime: graph.startTime,
+    endTime: graph.endTime,
+    status: graph.status,
+    trigger: graph.trigger,
+    agentId: graph.agentId,
+    events: graph.events,
+    traceId: graph.traceId,
+    spanId: graph.spanId,
+    parentSpanId: graph.parentSpanId
+  };
+}
+
 // src/runner.ts
 import { spawnSync } from "child_process";
 import { existsSync, mkdirSync, readdirSync, statSync, writeFileSync } from "fs";
@@ -259,27 +311,6 @@ function deriveAgentId(command) {
 function fileTimestamp() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/:/g, "-").replace(/\.\d+Z$/, "");
 }
-function graphToJson(graph) {
-  const nodesObj = {};
-  for (const [id, node] of graph.nodes) {
-    nodesObj[id] = node;
-  }
-  return {
-    id: graph.id,
-    rootNodeId: graph.rootNodeId,
-    nodes: nodesObj,
-    edges: graph.edges,
-    startTime: graph.startTime,
-    endTime: graph.endTime,
-    status: graph.status,
-    trigger: graph.trigger,
-    agentId: graph.agentId,
-    events: graph.events,
-    traceId: graph.traceId,
-    spanId: graph.spanId,
-    parentSpanId: graph.parentSpanId
-  };
-}
 async function runTraced(config) {
   const {
     command,
@@ -398,5 +429,7 @@ async function runTraced(config) {
 
 export {
   createGraphBuilder,
+  loadGraph,
+  graphToJson,
   runTraced
 };

package/dist/cli.cjs

@@ -235,6 +235,29 @@ function createGraphBuilder(config) {
   return builder;
 }
 
+// src/loader.ts
+function graphToJson(graph) {
+  const nodesObj = {};
+  for (const [id, node] of graph.nodes) {
+    nodesObj[id] = node;
+  }
+  return {
+    id: graph.id,
+    rootNodeId: graph.rootNodeId,
+    nodes: nodesObj,
+    edges: graph.edges,
+    startTime: graph.startTime,
+    endTime: graph.endTime,
+    status: graph.status,
+    trigger: graph.trigger,
+    agentId: graph.agentId,
+    events: graph.events,
+    traceId: graph.traceId,
+    spanId: graph.spanId,
+    parentSpanId: graph.parentSpanId
+  };
+}
+
 // src/runner.ts
 function globToRegex(pattern) {
   const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
@@ -267,27 +290,6 @@ function deriveAgentId(command) {
 function fileTimestamp() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/:/g, "-").replace(/\.\d+Z$/, "");
 }
-function graphToJson(graph) {
-  const nodesObj = {};
-  for (const [id, node] of graph.nodes) {
-    nodesObj[id] = node;
-  }
-  return {
-    id: graph.id,
-    rootNodeId: graph.rootNodeId,
-    nodes: nodesObj,
-    edges: graph.edges,
-    startTime: graph.startTime,
-    endTime: graph.endTime,
-    status: graph.status,
-    trigger: graph.trigger,
-    agentId: graph.agentId,
-    events: graph.events,
-    traceId: graph.traceId,
-    spanId: graph.spanId,
-    parentSpanId: graph.parentSpanId
-  };
-}
 async function runTraced(config) {
   const {
     command,

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runTraced
-} from "./chunk-DGLK6IBP.js";
+} from "./chunk-TT5DLU73.js";
 
 // src/cli.ts
 import { basename } from "path";

package/dist/index.cjs

@@ -33,7 +33,9 @@ __export(index_exports, {
   getStats: () => getStats,
   getSubtree: () => getSubtree,
   getTraceTree: () => getTraceTree,
+  graphToJson: () => graphToJson,
   groupByTraceId: () => groupByTraceId,
+  loadGraph: () => loadGraph,
   runTraced: () => runTraced,
   stitchTrace: () => stitchTrace
 });
@@ -265,6 +267,58 @@ function createGraphBuilder(config) {
   return builder;
 }
 
+// src/loader.ts
+function toNodesMap(raw) {
+  if (raw instanceof Map) return raw;
+  if (Array.isArray(raw)) {
+    return new Map(raw);
+  }
+  if (raw !== null && typeof raw === "object") {
+    return new Map(Object.entries(raw));
+  }
+  return /* @__PURE__ */ new Map();
+}
+function loadGraph(input) {
+  const raw = typeof input === "string" ? JSON.parse(input) : input;
+  const nodes = toNodesMap(raw.nodes);
+  return {
+    id: raw.id ?? "",
+    rootNodeId: raw.rootNodeId ?? raw.rootId ?? "",
+    nodes,
+    edges: raw.edges ?? [],
+    startTime: raw.startTime ?? 0,
+    endTime: raw.endTime ?? null,
+    status: raw.status ?? "completed",
+    trigger: raw.trigger ?? "unknown",
+    agentId: raw.agentId ?? "unknown",
+    events: raw.events ?? [],
+    traceId: raw.traceId,
+    spanId: raw.spanId,
+    parentSpanId: raw.parentSpanId
+  };
+}
+function graphToJson(graph) {
+  const nodesObj = {};
+  for (const [id, node] of graph.nodes) {
+    nodesObj[id] = node;
+  }
+  return {
+    id: graph.id,
+    rootNodeId: graph.rootNodeId,
+    nodes: nodesObj,
+    edges: graph.edges,
+    startTime: graph.startTime,
+    endTime: graph.endTime,
+    status: graph.status,
+    trigger: graph.trigger,
+    agentId: graph.agentId,
+    events: graph.events,
+    traceId: graph.traceId,
+    spanId: graph.spanId,
+    parentSpanId: graph.parentSpanId
+  };
+}
+
 // src/runner.ts
 var import_node_child_process = require("child_process");
 var import_node_fs = require("fs");
@@ -300,27 +354,6 @@ function deriveAgentId(command) {
 function fileTimestamp() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/:/g, "-").replace(/\.\d+Z$/, "");
 }
-function graphToJson(graph) {
-  const nodesObj = {};
-  for (const [id, node] of graph.nodes) {
-    nodesObj[id] = node;
-  }
-  return {
-    id: graph.id,
-    rootNodeId: graph.rootNodeId,
-    nodes: nodesObj,
-    edges: graph.edges,
-    startTime: graph.startTime,
-    endTime: graph.endTime,
-    status: graph.status,
-    trigger: graph.trigger,
-    agentId: graph.agentId,
-    events: graph.events,
-    traceId: graph.traceId,
-    spanId: graph.spanId,
-    parentSpanId: graph.parentSpanId
-  };
-}
 async function runTraced(config) {
   const {
     command,
@@ -654,7 +687,9 @@ function getStats(graph) {
   getStats,
   getSubtree,
   getTraceTree,
+  graphToJson,
   groupByTraceId,
+  loadGraph,
   runTraced,
   stitchTrace
 });

package/dist/index.d.cts

@@ -276,6 +276,58 @@ interface MutableExecutionNode {
  */
 declare function createGraphBuilder(config?: AgentFlowConfig): GraphBuilder;
 
+/**
+ * Load and deserialize execution graphs from JSON.
+ *
+ * Handles all serialization formats produced by the runner, graph-builder,
+ * and third-party tools:
+ *   - `nodes` as a plain object `{ "node_001": { ... } }`  (runner.ts output)
+ *   - `nodes` as an array of `[id, node]` pairs              (Map JSON serialization)
+ *   - `nodes` already a Map                                   (in-memory passthrough)
+ *
+ * @module
+ */
+
+/**
+ * Deserialize a JSON object (or JSON string) into a valid `ExecutionGraph`.
+ *
+ * Use this whenever you read a trace file from disk or receive one over the
+ * network.  It normalizes `nodes` into a proper `Map` regardless of the
+ * serialization format.
+ *
+ * @param input - A parsed JSON object, or a JSON string to be parsed.
+ * @returns A valid `ExecutionGraph` ready for use with query functions.
+ * @throws {Error} If the input cannot be parsed or is missing required fields.
+ *
+ * @example
+ * ```ts
+ * import { readFileSync } from 'fs';
+ * import { loadGraph, getStats } from 'agentflow-core';
+ *
+ * const graph = loadGraph(readFileSync('trace.json', 'utf8'));
+ * console.log(getStats(graph));
+ * ```
+ */
+declare function loadGraph(input: string | Record<string, unknown>): ExecutionGraph;
+/**
+ * Serialize an `ExecutionGraph` to a plain JSON-safe object.
+ *
+ * The inverse of `loadGraph`.  `nodes` is written as a plain object keyed by
+ * node ID, which is the most readable format for trace files on disk.
+ *
+ * @param graph - The execution graph to serialize.
+ * @returns A plain object safe to pass to `JSON.stringify`.
+ *
+ * @example
+ * ```ts
+ * import { writeFileSync } from 'fs';
+ * import { graphToJson } from 'agentflow-core';
+ *
+ * writeFileSync('trace.json', JSON.stringify(graphToJson(graph), null, 2));
+ * ```
+ */
+declare function graphToJson(graph: ExecutionGraph): Record<string, unknown>;
+
 /**
  * CLI runner that wraps any command with automatic AgentFlow tracing.
  *
@@ -445,4 +497,4 @@ declare function getDepth(graph: ExecutionGraph): number;
  */
 declare function getStats(graph: ExecutionGraph): GraphStats;
 
-export { type Adapter, type AgentFlowConfig, type DistributedTrace, type EdgeType, type ExecutionEdge, type ExecutionGraph, type ExecutionNode, type GraphBuilder, type GraphStats, type GraphStatus, type MutableExecutionNode, type NodeStatus, type NodeType, type RunConfig, type RunResult, type StartNodeOptions, type TraceEvent, type TraceEventType, type Writer, createGraphBuilder, findWaitingOn, getChildren, getCriticalPath, getDepth, getDuration, getFailures, getHungNodes, getNode, getParent, getStats, getSubtree, getTraceTree, groupByTraceId, runTraced, stitchTrace };
+export { type Adapter, type AgentFlowConfig, type DistributedTrace, type EdgeType, type ExecutionEdge, type ExecutionGraph, type ExecutionNode, type GraphBuilder, type GraphStats, type GraphStatus, type MutableExecutionNode, type NodeStatus, type NodeType, type RunConfig, type RunResult, type StartNodeOptions, type TraceEvent, type TraceEventType, type Writer, createGraphBuilder, findWaitingOn, getChildren, getCriticalPath, getDepth, getDuration, getFailures, getHungNodes, getNode, getParent, getStats, getSubtree, getTraceTree, graphToJson, groupByTraceId, loadGraph, runTraced, stitchTrace };

package/dist/index.d.ts

@@ -276,6 +276,58 @@ interface MutableExecutionNode {
  */
 declare function createGraphBuilder(config?: AgentFlowConfig): GraphBuilder;
 
+/**
+ * Load and deserialize execution graphs from JSON.
+ *
+ * Handles all serialization formats produced by the runner, graph-builder,
+ * and third-party tools:
+ *   - `nodes` as a plain object `{ "node_001": { ... } }`  (runner.ts output)
+ *   - `nodes` as an array of `[id, node]` pairs              (Map JSON serialization)
+ *   - `nodes` already a Map                                   (in-memory passthrough)
+ *
+ * @module
+ */
+
+/**
+ * Deserialize a JSON object (or JSON string) into a valid `ExecutionGraph`.
+ *
+ * Use this whenever you read a trace file from disk or receive one over the
+ * network.  It normalizes `nodes` into a proper `Map` regardless of the
+ * serialization format.
+ *
+ * @param input - A parsed JSON object, or a JSON string to be parsed.
+ * @returns A valid `ExecutionGraph` ready for use with query functions.
+ * @throws {Error} If the input cannot be parsed or is missing required fields.
+ *
+ * @example
+ * ```ts
+ * import { readFileSync } from 'fs';
+ * import { loadGraph, getStats } from 'agentflow-core';
+ *
+ * const graph = loadGraph(readFileSync('trace.json', 'utf8'));
+ * console.log(getStats(graph));
+ * ```
+ */
+declare function loadGraph(input: string | Record<string, unknown>): ExecutionGraph;
+/**
+ * Serialize an `ExecutionGraph` to a plain JSON-safe object.
+ *
+ * The inverse of `loadGraph`.  `nodes` is written as a plain object keyed by
+ * node ID, which is the most readable format for trace files on disk.
+ *
+ * @param graph - The execution graph to serialize.
+ * @returns A plain object safe to pass to `JSON.stringify`.
+ *
+ * @example
+ * ```ts
+ * import { writeFileSync } from 'fs';
+ * import { graphToJson } from 'agentflow-core';
+ *
+ * writeFileSync('trace.json', JSON.stringify(graphToJson(graph), null, 2));
+ * ```
+ */
+declare function graphToJson(graph: ExecutionGraph): Record<string, unknown>;
+
 /**
  * CLI runner that wraps any command with automatic AgentFlow tracing.
  *
@@ -445,4 +497,4 @@ declare function getDepth(graph: ExecutionGraph): number;
  */
 declare function getStats(graph: ExecutionGraph): GraphStats;
 
-export { type Adapter, type AgentFlowConfig, type DistributedTrace, type EdgeType, type ExecutionEdge, type ExecutionGraph, type ExecutionNode, type GraphBuilder, type GraphStats, type GraphStatus, type MutableExecutionNode, type NodeStatus, type NodeType, type RunConfig, type RunResult, type StartNodeOptions, type TraceEvent, type TraceEventType, type Writer, createGraphBuilder, findWaitingOn, getChildren, getCriticalPath, getDepth, getDuration, getFailures, getHungNodes, getNode, getParent, getStats, getSubtree, getTraceTree, groupByTraceId, runTraced, stitchTrace };
+export { type Adapter, type AgentFlowConfig, type DistributedTrace, type EdgeType, type ExecutionEdge, type ExecutionGraph, type ExecutionNode, type GraphBuilder, type GraphStats, type GraphStatus, type MutableExecutionNode, type NodeStatus, type NodeType, type RunConfig, type RunResult, type StartNodeOptions, type TraceEvent, type TraceEventType, type Writer, createGraphBuilder, findWaitingOn, getChildren, getCriticalPath, getDepth, getDuration, getFailures, getHungNodes, getNode, getParent, getStats, getSubtree, getTraceTree, graphToJson, groupByTraceId, loadGraph, runTraced, stitchTrace };

package/dist/index.js

@@ -1,7 +1,9 @@
 import {
   createGraphBuilder,
+  graphToJson,
+  loadGraph,
   runTraced
-} from "./chunk-DGLK6IBP.js";
+} from "./chunk-TT5DLU73.js";
 
 // src/graph-stitch.ts
 function groupByTraceId(graphs) {
@@ -219,7 +221,9 @@ export {
   getStats,
   getSubtree,
   getTraceTree,
+  graphToJson,
   groupByTraceId,
+  loadGraph,
   runTraced,
   stitchTrace
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentflow-core",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Universal execution tracing for AI agent systems",
   "type": "module",
   "main": "./dist/index.cjs",