groundswell 0.0.1 → 0.0.3

package/dist/core/event-tree.d.ts

@@ -0,0 +1,72 @@
+/**
+ * EventTreeHandle - Queryable interface for the workflow event tree
+ *
+ * Provides methods for traversing and querying the event tree
+ * that mirrors workflow execution.
+ */
+import type { EventTreeHandle, EventNode } from '../types/workflow-context.js';
+import type { WorkflowNode } from '../types/index.js';
+/**
+ * Implementation of EventTreeHandle
+ */
+export declare class EventTreeHandleImpl implements EventTreeHandle {
+    /** Root node of the tree */
+    readonly root: EventNode;
+    /** Index of nodes by ID for fast lookup */
+    private nodeIndex;
+    /**
+     * Create a new EventTreeHandle from a workflow node
+     * @param workflowNode Root workflow node
+     */
+    constructor(workflowNode: WorkflowNode);
+    /**
+     * Get a node by ID
+     * @param id Node ID to find
+     */
+    getNode(id: string): EventNode | undefined;
+    /**
+     * Get all children of a node
+     * @param id Parent node ID
+     */
+    getChildren(id: string): EventNode[];
+    /**
+     * Get all ancestors of a node (from node up to root, excluding the node itself)
+     * @param id Node ID
+     */
+    getAncestors(id: string): EventNode[];
+    /**
+     * Export tree as JSON
+     */
+    toJSON(): EventNode;
+    /**
+     * Rebuild the tree from an updated workflow node
+     * @param workflowNode Updated workflow node
+     */
+    rebuild(workflowNode: WorkflowNode): void;
+    /**
+     * Build an EventNode from a WorkflowNode
+     */
+    private buildEventNode;
+    /**
+     * Convert a WorkflowEvent to an EventNode
+     */
+    private eventToNode;
+    /**
+     * Extract metrics from a workflow node
+     */
+    private extractMetrics;
+    /**
+     * Build index of all nodes
+     */
+    private buildIndex;
+    /**
+     * Deep clone a node for JSON export
+     */
+    private cloneNode;
+}
+/**
+ * Create an EventTreeHandle from a workflow node
+ * @param workflowNode Root workflow node
+ */
+export declare function createEventTreeHandle(workflowNode: WorkflowNode): EventTreeHandle;
+//# sourceMappingURL=event-tree.d.ts.map

package/dist/core/event-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-tree.d.ts","sourceRoot":"","sources":["../../src/core/event-tree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EAEV,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,mBAAmB,CAAC;AAErE;;GAEG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,4BAA4B;IAC5B,SAAgB,IAAI,EAAE,SAAS,CAAC;IAEhC,2CAA2C;IAC3C,OAAO,CAAC,SAAS,CAAqC;IAEtD;;;OAGG;gBACS,YAAY,EAAE,YAAY;IAKtC;;;OAGG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIjD;;;OAGG;IACI,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE;IAK3C;;;OAGG;IACI,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE;IAmB5C;;OAEG;IACI,MAAM,IAAI,SAAS;IAI1B;;;OAGG;IACI,OAAO,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAchD;;OAEG;IACH,OAAO,CAAC,cAAc;IA8BtB;;OAEG;IACH,OAAO,CAAC,WAAW;IA2EnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,CAAC,SAAS;CAMlB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,GACzB,eAAe,CAEjB"}

package/dist/core/event-tree.js

@@ -0,0 +1,211 @@
+/**
+ * EventTreeHandle - Queryable interface for the workflow event tree
+ *
+ * Provides methods for traversing and querying the event tree
+ * that mirrors workflow execution.
+ */
+/**
+ * Implementation of EventTreeHandle
+ */
+export class EventTreeHandleImpl {
+    /** Root node of the tree */
+    root;
+    /** Index of nodes by ID for fast lookup */
+    nodeIndex = new Map();
+    /**
+     * Create a new EventTreeHandle from a workflow node
+     * @param workflowNode Root workflow node
+     */
+    constructor(workflowNode) {
+        this.root = this.buildEventNode(workflowNode);
+        this.buildIndex(this.root);
+    }
+    /**
+     * Get a node by ID
+     * @param id Node ID to find
+     */
+    getNode(id) {
+        return this.nodeIndex.get(id);
+    }
+    /**
+     * Get all children of a node
+     * @param id Parent node ID
+     */
+    getChildren(id) {
+        const node = this.nodeIndex.get(id);
+        return node?.children ?? [];
+    }
+    /**
+     * Get all ancestors of a node (from node up to root, excluding the node itself)
+     * @param id Node ID
+     */
+    getAncestors(id) {
+        const ancestors = [];
+        const node = this.nodeIndex.get(id);
+        if (!node || !node.parentId) {
+            return ancestors;
+        }
+        let currentId = node.parentId;
+        while (currentId) {
+            const parent = this.nodeIndex.get(currentId);
+            if (!parent)
+                break;
+            ancestors.push(parent);
+            currentId = parent.parentId ?? '';
+        }
+        return ancestors;
+    }
+    /**
+     * Export tree as JSON
+     */
+    toJSON() {
+        return this.cloneNode(this.root);
+    }
+    /**
+     * Rebuild the tree from an updated workflow node
+     * @param workflowNode Updated workflow node
+     */
+    rebuild(workflowNode) {
+        const newRoot = this.buildEventNode(workflowNode);
+        this.root.children = newRoot.children;
+        Object.assign(this.root, {
+            type: newRoot.type,
+            name: newRoot.name,
+            timestamp: newRoot.timestamp,
+            metrics: newRoot.metrics,
+        });
+        this.nodeIndex.clear();
+        this.buildIndex(this.root);
+    }
+    /**
+     * Build an EventNode from a WorkflowNode
+     */
+    buildEventNode(wfNode, parentId) {
+        const eventNode = {
+            id: wfNode.id,
+            type: 'workflow',
+            timestamp: Date.now(),
+            name: wfNode.name,
+            parentId,
+            children: [],
+            metrics: this.extractMetrics(wfNode),
+        };
+        // Add event nodes from workflow events
+        for (const event of wfNode.events) {
+            const childNode = this.eventToNode(event, wfNode.id);
+            if (childNode) {
+                eventNode.children.push(childNode);
+            }
+        }
+        // Add child workflow nodes
+        for (const child of wfNode.children) {
+            eventNode.children.push(this.buildEventNode(child, wfNode.id));
+        }
+        return eventNode;
+    }
+    /**
+     * Convert a WorkflowEvent to an EventNode
+     */
+    eventToNode(event, parentId) {
+        const baseNode = {
+            id: `${parentId}-${event.type}-${Date.now()}`,
+            timestamp: Date.now(),
+            parentId,
+            children: [],
+        };
+        switch (event.type) {
+            case 'stepStart':
+                return {
+                    ...baseNode,
+                    type: 'step',
+                    name: event.step,
+                };
+            case 'stepEnd':
+                return {
+                    ...baseNode,
+                    type: 'stepComplete',
+                    name: event.step,
+                    metrics: { duration: event.duration },
+                };
+            case 'agentPromptStart':
+                return {
+                    ...baseNode,
+                    id: `${event.agentId}-prompt-${event.promptId}`,
+                    type: 'agentPrompt',
+                    name: event.agentName,
+                    payload: { promptId: event.promptId },
+                };
+            case 'agentPromptEnd':
+                return {
+                    ...baseNode,
+                    id: `${event.agentId}-promptEnd-${event.promptId}`,
+                    type: 'agentPromptComplete',
+                    name: event.agentName,
+                    metrics: {
+                        duration: event.duration,
+                        tokenUsage: event.tokenUsage
+                            ? {
+                                input: event.tokenUsage.input_tokens,
+                                output: event.tokenUsage.output_tokens,
+                            }
+                            : undefined,
+                    },
+                };
+            case 'toolInvocation':
+                return {
+                    ...baseNode,
+                    type: 'tool',
+                    name: event.toolName,
+                    payload: { input: event.input, output: event.output },
+                    metrics: { duration: event.duration },
+                };
+            case 'error':
+                return {
+                    ...baseNode,
+                    type: 'error',
+                    name: event.error.message,
+                    payload: event.error,
+                };
+            default:
+                return null;
+        }
+    }
+    /**
+     * Extract metrics from a workflow node
+     */
+    extractMetrics(wfNode) {
+        // Calculate total duration from step events
+        const stepEndEvents = wfNode.events.filter((e) => e.type === 'stepEnd');
+        if (stepEndEvents.length === 0) {
+            return undefined;
+        }
+        const totalDuration = stepEndEvents.reduce((sum, e) => sum + e.duration, 0);
+        return { duration: totalDuration };
+    }
+    /**
+     * Build index of all nodes
+     */
+    buildIndex(node) {
+        this.nodeIndex.set(node.id, node);
+        for (const child of node.children) {
+            this.buildIndex(child);
+        }
+    }
+    /**
+     * Deep clone a node for JSON export
+     */
+    cloneNode(node) {
+        return {
+            ...node,
+            children: node.children.map((c) => this.cloneNode(c)),
+        };
+    }
+}
+/**
+ * Create an EventTreeHandle from a workflow node
+ * @param workflowNode Root workflow node
+ */
+export function createEventTreeHandle(workflowNode) {
+    return new EventTreeHandleImpl(workflowNode);
+}
+//# sourceMappingURL=event-tree.js.map

package/dist/core/event-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-tree.js","sourceRoot":"","sources":["../../src/core/event-tree.ts"],"names":[],"mappings":"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"}

package/{src/core/factory.ts → dist/core/factory.d.ts}

@@ -4,13 +4,11 @@
  * These functions provide a simple API for creating workflow components dynamically
  * at runtime, useful for metaprogramming and agent-driven workflow construction.
  */
-
 import { Workflow, type WorkflowExecutor } from './workflow.js';
 import { Agent } from './agent.js';
 import { Prompt } from './prompt.js';
 import type { WorkflowConfig } from '../types/workflow-context.js';
 import type { AgentConfig, PromptConfig } from '../types/index.js';
-
 /**
  * Create a new Workflow instance
  *
@@ -32,13 +30,7 @@ import type { AgentConfig, PromptConfig } from '../types/index.js';
  * const result = await workflow.run();
  * ```
  */
-export function createWorkflow<T>(
-  config: WorkflowConfig,
-  executor: WorkflowExecutor<T>
-): Workflow<T> {
-  return new Workflow(config, executor);
-}
-
+export declare function createWorkflow<T>(config: WorkflowConfig, executor: WorkflowExecutor<T>): Workflow<T>;
 /**
  * Create a new Agent instance
  *
@@ -57,10 +49,7 @@ export function createWorkflow<T>(
  * const result = await agent.prompt(analysisPrompt);
  * ```
  */
-export function createAgent(config: AgentConfig): Agent {
-  return new Agent(config);
-}
-
+export declare function createAgent(config: AgentConfig): Agent;
 /**
  * Create a new Prompt instance
  *
@@ -81,10 +70,7 @@ export function createAgent(config: AgentConfig): Agent {
  * const result = await agent.prompt(prompt);
  * ```
  */
-export function createPrompt<T>(config: PromptConfig<T>): Prompt<T> {
-  return new Prompt(config);
-}
-
+export declare function createPrompt<T>(config: PromptConfig<T>): Prompt<T>;
 /**
  * Create a workflow with an inline executor (shorthand)
  *
@@ -99,13 +85,7 @@ export function createPrompt<T>(config: PromptConfig<T>): Prompt<T> {
  * });
  * ```
  */
-export function quickWorkflow<T>(
-  name: string,
-  executor: WorkflowExecutor<T>
-): Workflow<T> {
-  return new Workflow({ name }, executor);
-}
-
+export declare function quickWorkflow<T>(name: string, executor: WorkflowExecutor<T>): Workflow<T>;
 /**
  * Create a simple agent with minimal configuration (shorthand)
  *
@@ -118,6 +98,5 @@ export function quickWorkflow<T>(
  * const agent = quickAgent('Helper', 'You are a helpful assistant.');
  * ```
  */
-export function quickAgent(name: string, system?: string): Agent {
-  return new Agent({ name, system });
-}
+export declare function quickAgent(name: string, system?: string): Agent;
+//# sourceMappingURL=factory.d.ts.map

package/dist/core/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/core/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,QAAQ,CAAC,CAAC,CAAC,CAEb;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAEtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAElE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,QAAQ,CAAC,CAAC,CAAC,CAEb;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAE/D"}

package/dist/core/factory.js

@@ -0,0 +1,110 @@
+/**
+ * Factory Functions - Convenience functions for dynamic workflow, agent, and prompt creation
+ *
+ * These functions provide a simple API for creating workflow components dynamically
+ * at runtime, useful for metaprogramming and agent-driven workflow construction.
+ */
+import { Workflow } from './workflow.js';
+import { Agent } from './agent.js';
+import { Prompt } from './prompt.js';
+/**
+ * Create a new Workflow instance
+ *
+ * @param config Workflow configuration
+ * @param executor Executor function that receives WorkflowContext
+ * @returns Configured Workflow instance
+ *
+ * @example
+ * ```ts
+ * const workflow = createWorkflow(
+ *   { name: 'DataPipeline', enableReflection: true },
+ *   async (ctx) => {
+ *     const data = await ctx.step('fetch', () => fetchData());
+ *     const processed = await ctx.step('process', () => processData(data));
+ *     return processed;
+ *   }
+ * );
+ *
+ * const result = await workflow.run();
+ * ```
+ */
+export function createWorkflow(config, executor) {
+    return new Workflow(config, executor);
+}
+/**
+ * Create a new Agent instance
+ *
+ * @param config Agent configuration
+ * @returns Configured Agent instance
+ *
+ * @example
+ * ```ts
+ * const agent = createAgent({
+ *   name: 'DataAnalyst',
+ *   system: 'You analyze data and provide insights.',
+ *   enableCache: true,
+ *   enableReflection: true,
+ * });
+ *
+ * const result = await agent.prompt(analysisPrompt);
+ * ```
+ */
+export function createAgent(config) {
+    return new Agent(config);
+}
+/**
+ * Create a new Prompt instance
+ *
+ * @param config Prompt configuration
+ * @returns Configured Prompt instance
+ *
+ * @example
+ * ```ts
+ * const prompt = createPrompt({
+ *   user: 'Analyze this data',
+ *   data: { values: [1, 2, 3, 4, 5] },
+ *   responseFormat: z.object({
+ *     summary: z.string(),
+ *     insights: z.array(z.string()),
+ *   }),
+ * });
+ *
+ * const result = await agent.prompt(prompt);
+ * ```
+ */
+export function createPrompt(config) {
+    return new Prompt(config);
+}
+/**
+ * Create a workflow with an inline executor (shorthand)
+ *
+ * @param name Workflow name
+ * @param executor Executor function
+ * @returns Configured Workflow instance
+ *
+ * @example
+ * ```ts
+ * const workflow = quickWorkflow('ProcessData', async (ctx) => {
+ *   return await ctx.step('process', () => processData());
+ * });
+ * ```
+ */
+export function quickWorkflow(name, executor) {
+    return new Workflow({ name }, executor);
+}
+/**
+ * Create a simple agent with minimal configuration (shorthand)
+ *
+ * @param name Agent name
+ * @param system System prompt
+ * @returns Configured Agent instance
+ *
+ * @example
+ * ```ts
+ * const agent = quickAgent('Helper', 'You are a helpful assistant.');
+ * ```
+ */
+export function quickAgent(name, system) {
+    return new Agent({ name, system });
+}
+//# sourceMappingURL=factory.js.map

package/dist/core/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/core/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAyB,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAsB,EACtB,QAA6B;IAE7B,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,YAAY,CAAI,MAAuB;IACrD,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,QAA6B;IAE7B,OAAO,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAe;IACtD,OAAO,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/{src/core/index.ts → dist/core/index.d.ts}

@@ -5,13 +5,5 @@ export { Prompt } from './prompt.js';
 export { MCPHandler, type ToolExecutor } from './mcp-handler.js';
 export { EventTreeHandleImpl, createEventTreeHandle } from './event-tree.js';
 export { WorkflowContextImpl, createWorkflowContext } from './workflow-context.js';
-export {
-  getExecutionContext,
-  requireExecutionContext,
-  runInContext,
-  runInContextSync,
-  hasExecutionContext,
-  createChildContext,
-  agentExecutionStorage,
-  type AgentExecutionContext,
-} from './context.js';
+export { getExecutionContext, requireExecutionContext, runInContext, runInContextSync, hasExecutionContext, createChildContext, agentExecutionStorage, type AgentExecutionContext, } from './context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,9 @@
+export { WorkflowLogger } from './logger.js';
+export { Workflow } from './workflow.js';
+export { Agent } from './agent.js';
+export { Prompt } from './prompt.js';
+export { MCPHandler } from './mcp-handler.js';
+export { EventTreeHandleImpl, createEventTreeHandle } from './event-tree.js';
+export { WorkflowContextImpl, createWorkflowContext } from './workflow-context.js';
+export { getExecutionContext, requireExecutionContext, runInContext, runInContextSync, hasExecutionContext, createChildContext, agentExecutionStorage, } from './context.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAyB,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAqB,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GAEtB,MAAM,cAAc,CAAC"}

package/dist/core/logger.d.ts

@@ -0,0 +1,50 @@
+import type { WorkflowNode, LogEntry, WorkflowObserver } from '../types/index.js';
+/**
+ * Logger that emits log entries to workflow node and observers
+ */
+export declare class WorkflowLogger {
+    private readonly node;
+    private readonly observers;
+    private readonly parentLogId?;
+    constructor(node: WorkflowNode, observers: WorkflowObserver[], parentLogId?: string);
+    /**
+     * Emit a log entry directly to the node without notifying observers
+     * Used to avoid infinite recursion when observer.onLog() throws
+     */
+    private emitWithoutObserverNotification;
+    /**
+     * Emit a log entry to the node and all observers
+     */
+    private emit;
+    /**
+     * Create a log entry with the given level
+     */
+    private log;
+    /**
+     * Log a debug message
+     */
+    debug(message: string, data?: unknown): void;
+    /**
+     * Log an info message
+     */
+    info(message: string, data?: unknown): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, data?: unknown): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, data?: unknown): void;
+    /**
+     * Create a child logger that includes parentLogId
+     * @param parentLogId - ID of the parent log entry (legacy API)
+     */
+    child(parentLogId: string): WorkflowLogger;
+    /**
+     * Create a child logger with metadata
+     * @param meta - Partial log entry metadata (typically { parentLogId: string })
+     */
+    child(meta: Partial<LogEntry>): WorkflowLogger;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAY,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG5F;;GAEG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;gBAGnB,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,gBAAgB,EAAE,EAC9C,WAAW,CAAC,EAAE,MAAM;IAKtB;;;OAGG;IACH,OAAO,CAAC,+BAA+B;IAIvC;;OAEG;IACH,OAAO,CAAC,IAAI;IAoBZ;;OAEG;IACH,OAAO,CAAC,GAAG;IAkBX;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C;;;OAGG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IAC1C;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,cAAc;CAK/C"}

package/dist/core/logger.js

@@ -0,0 +1,91 @@
+import { generateId } from '../utils/id.js';
+/**
+ * Logger that emits log entries to workflow node and observers
+ */
+export class WorkflowLogger {
+    node;
+    observers;
+    parentLogId;
+    constructor(node, observers, parentLogId) {
+        this.node = node;
+        this.observers = observers;
+        this.parentLogId = parentLogId;
+    }
+    /**
+     * Emit a log entry directly to the node without notifying observers
+     * Used to avoid infinite recursion when observer.onLog() throws
+     */
+    emitWithoutObserverNotification(entry) {
+        this.node.logs.push(entry);
+    }
+    /**
+     * Emit a log entry to the node and all observers
+     */
+    emit(entry) {
+        this.node.logs.push(entry);
+        for (const obs of this.observers) {
+            try {
+                obs.onLog(entry);
+            }
+            catch (err) {
+                // Create error entry and emit without observer notification to avoid infinite recursion
+                const errorEntry = {
+                    id: generateId(),
+                    workflowId: this.node.id,
+                    timestamp: Date.now(),
+                    level: 'error',
+                    message: 'Observer onLog error',
+                    data: { error: err },
+                };
+                this.emitWithoutObserverNotification(errorEntry);
+            }
+        }
+    }
+    /**
+     * Create a log entry with the given level
+     */
+    log(level, message, data) {
+        const entry = {
+            id: generateId(),
+            workflowId: this.node.id,
+            timestamp: Date.now(),
+            level,
+            message,
+            data,
+        };
+        // Add parent log ID if this is a child logger
+        if (this.parentLogId) {
+            entry.parentLogId = this.parentLogId;
+        }
+        this.emit(entry);
+    }
+    /**
+     * Log a debug message
+     */
+    debug(message, data) {
+        this.log('debug', message, data);
+    }
+    /**
+     * Log an info message
+     */
+    info(message, data) {
+        this.log('info', message, data);
+    }
+    /**
+     * Log a warning message
+     */
+    warn(message, data) {
+        this.log('warn', message, data);
+    }
+    /**
+     * Log an error message
+     */
+    error(message, data) {
+        this.log('error', message, data);
+    }
+    child(input) {
+        const parentLogId = typeof input === 'string' ? input : input.parentLogId;
+        return new WorkflowLogger(this.node, this.observers, parentLogId);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAO,cAAc;IAIN;IACA;IAJF,WAAW,CAAU;IAEtC,YACmB,IAAkB,EAClB,SAA6B,EAC9C,WAAoB;QAFH,SAAI,GAAJ,IAAI,CAAc;QAClB,cAAS,GAAT,SAAS,CAAoB;QAG9C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;OAGG;IACK,+BAA+B,CAAC,KAAe;QACrD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACK,IAAI,CAAC,KAAe;QAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,wFAAwF;gBACxF,MAAM,UAAU,GAAa;oBAC3B,EAAE,EAAE,UAAU,EAAE;oBAChB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;oBACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,KAAK,EAAE,OAAO;oBACd,OAAO,EAAE,sBAAsB;oBAC/B,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;iBACrB,CAAC;gBACF,IAAI,CAAC,+BAA+B,CAAC,UAAU,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAAc;QAC1D,MAAM,KAAK,GAAa;YACtB,EAAE,EAAE,UAAU,EAAE;YAChB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK;YACL,OAAO;YACP,IAAI;SACL,CAAC;QAEF,8CAA8C;QAC9C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAYD,KAAK,CAAC,KAAiC;QACrC,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;QAC1E,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACpE,CAAC;CACF"}