groundswell 0.0.1 → 0.0.3

package/dist/__tests__/unit/decorators.test.js

@@ -0,0 +1,162 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { describe, it, expect } from 'vitest';
+import { Workflow, Step, ObservedState, getObservedState } from '../../index.js';
+describe('@Step decorator', () => {
+    let StepTestWorkflow = (() => {
+        let _classSuper = Workflow;
+        let _instanceExtraInitializers = [];
+        let _myStep_decorators;
+        return class StepTestWorkflow extends _classSuper {
+            static {
+                const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+                _myStep_decorators = [Step({ trackTiming: true })];
+                __esDecorate(this, null, _myStep_decorators, { kind: "method", name: "myStep", static: false, private: false, access: { has: obj => "myStep" in obj, get: obj => obj.myStep }, metadata: _metadata }, null, _instanceExtraInitializers);
+                if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            }
+            stepCalled = (__runInitializers(this, _instanceExtraInitializers), false);
+            async myStep() {
+                this.stepCalled = true;
+                return 'step result';
+            }
+            async run() {
+                await this.myStep();
+            }
+        };
+    })();
+    it('should execute the original method', async () => {
+        const wf = new StepTestWorkflow();
+        await wf.run();
+        expect(wf.stepCalled).toBe(true);
+    });
+    it('should emit stepStart and stepEnd events', async () => {
+        const wf = new StepTestWorkflow();
+        const events = [];
+        wf.addObserver({
+            onLog: () => { },
+            onEvent: (e) => events.push(e),
+            onStateUpdated: () => { },
+            onTreeChanged: () => { },
+        });
+        await wf.run();
+        const startEvent = events.find((e) => e.type === 'stepStart');
+        const endEvent = events.find((e) => e.type === 'stepEnd');
+        expect(startEvent).toBeDefined();
+        expect(endEvent).toBeDefined();
+        if (endEvent?.type === 'stepEnd') {
+            expect(endEvent.duration).toBeGreaterThanOrEqual(0);
+        }
+    });
+    it('should wrap errors in WorkflowError', async () => {
+        let FailingWorkflow = (() => {
+            let _classSuper = Workflow;
+            let _instanceExtraInitializers = [];
+            let _failingStep_decorators;
+            return class FailingWorkflow extends _classSuper {
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+                    _failingStep_decorators = [Step()];
+                    __esDecorate(this, null, _failingStep_decorators, { kind: "method", name: "failingStep", static: false, private: false, access: { has: obj => "failingStep" in obj, get: obj => obj.failingStep }, metadata: _metadata }, null, _instanceExtraInitializers);
+                    if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                }
+                async failingStep() {
+                    throw new Error('Step failed');
+                }
+                async run() {
+                    await this.failingStep();
+                }
+                constructor() {
+                    super(...arguments);
+                    __runInitializers(this, _instanceExtraInitializers);
+                }
+            };
+        })();
+        const wf = new FailingWorkflow();
+        await expect(wf.run()).rejects.toMatchObject({
+            message: 'Step failed',
+            workflowId: wf.id,
+        });
+    });
+});
+describe('@ObservedState decorator', () => {
+    let StateTestWorkflow = (() => {
+        let _classSuper = Workflow;
+        let _publicField_decorators;
+        let _publicField_initializers = [];
+        let _publicField_extraInitializers = [];
+        let _secretField_decorators;
+        let _secretField_initializers = [];
+        let _secretField_extraInitializers = [];
+        let _hiddenField_decorators;
+        let _hiddenField_initializers = [];
+        let _hiddenField_extraInitializers = [];
+        return class StateTestWorkflow extends _classSuper {
+            static {
+                const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+                _publicField_decorators = [ObservedState()];
+                _secretField_decorators = [ObservedState({ redact: true })];
+                _hiddenField_decorators = [ObservedState({ hidden: true })];
+                __esDecorate(null, null, _publicField_decorators, { kind: "field", name: "publicField", static: false, private: false, access: { has: obj => "publicField" in obj, get: obj => obj.publicField, set: (obj, value) => { obj.publicField = value; } }, metadata: _metadata }, _publicField_initializers, _publicField_extraInitializers);
+                __esDecorate(null, null, _secretField_decorators, { kind: "field", name: "secretField", static: false, private: false, access: { has: obj => "secretField" in obj, get: obj => obj.secretField, set: (obj, value) => { obj.secretField = value; } }, metadata: _metadata }, _secretField_initializers, _secretField_extraInitializers);
+                __esDecorate(null, null, _hiddenField_decorators, { kind: "field", name: "hiddenField", static: false, private: false, access: { has: obj => "hiddenField" in obj, get: obj => obj.hiddenField, set: (obj, value) => { obj.hiddenField = value; } }, metadata: _metadata }, _hiddenField_initializers, _hiddenField_extraInitializers);
+                if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            }
+            publicField = __runInitializers(this, _publicField_initializers, 'public');
+            secretField = (__runInitializers(this, _publicField_extraInitializers), __runInitializers(this, _secretField_initializers, 'secret'));
+            hiddenField = (__runInitializers(this, _secretField_extraInitializers), __runInitializers(this, _hiddenField_initializers, 'hidden'));
+            async run() { }
+            constructor() {
+                super(...arguments);
+                __runInitializers(this, _hiddenField_extraInitializers);
+            }
+        };
+    })();
+    it('should include public fields in snapshot', () => {
+        const wf = new StateTestWorkflow();
+        const state = getObservedState(wf);
+        expect(state.publicField).toBe('public');
+    });
+    it('should redact secret fields', () => {
+        const wf = new StateTestWorkflow();
+        const state = getObservedState(wf);
+        expect(state.secretField).toBe('***');
+    });
+    it('should exclude hidden fields', () => {
+        const wf = new StateTestWorkflow();
+        const state = getObservedState(wf);
+        expect('hiddenField' in state).toBe(false);
+    });
+});
+//# sourceMappingURL=decorators.test.js.map

package/dist/__tests__/unit/decorators.test.js.map

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

package/dist/__tests__/unit/introspection-tools.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for introspection tools
+ */
+export {};
+//# sourceMappingURL=introspection-tools.test.d.ts.map

package/dist/__tests__/unit/introspection-tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection-tools.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/introspection-tools.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/__tests__/unit/introspection-tools.test.js

@@ -0,0 +1,191 @@
+/**
+ * Unit tests for introspection tools
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { INTROSPECTION_TOOLS, handleInspectCurrentNode, handleReadAncestorChain, handleListSiblingsChildren, handleInspectPriorOutputs, handleInspectCacheStatus, handleRequestSpawnWorkflow, executeIntrospectionTool, } from '../../tools/introspection.js';
+import { runInContext } from '../../core/context.js';
+import { defaultCache } from '../../cache/cache.js';
+describe('Introspection Tools', () => {
+    describe('INTROSPECTION_TOOLS', () => {
+        it('should export 6 tools', () => {
+            expect(INTROSPECTION_TOOLS).toHaveLength(6);
+        });
+        it('should have valid tool definitions', () => {
+            for (const tool of INTROSPECTION_TOOLS) {
+                expect(tool.name).toBeDefined();
+                expect(tool.description).toBeDefined();
+                expect(tool.input_schema).toBeDefined();
+                expect(tool.input_schema.type).toBe('object');
+            }
+        });
+        it('should include all expected tool names', () => {
+            const names = INTROSPECTION_TOOLS.map((t) => t.name);
+            expect(names).toContain('inspect_current_node');
+            expect(names).toContain('read_ancestor_chain');
+            expect(names).toContain('list_siblings_children');
+            expect(names).toContain('inspect_prior_outputs');
+            expect(names).toContain('inspect_cache_status');
+            expect(names).toContain('request_spawn_workflow');
+        });
+    });
+    describe('handlers', () => {
+        const createTestNode = (id, name, parent = null) => ({
+            id,
+            name,
+            parent,
+            children: [],
+            status: 'running',
+            logs: [],
+            events: [],
+            stateSnapshot: null,
+        });
+        const createContext = (node) => ({
+            workflowNode: node,
+            emitEvent: () => { },
+            workflowId: 'test-workflow',
+        });
+        describe('handleInspectCurrentNode', () => {
+            it('should throw when not in workflow context', async () => {
+                await expect(handleInspectCurrentNode()).rejects.toThrow('Not in workflow context');
+            });
+            it('should return current node info', async () => {
+                const parent = createTestNode('parent-1', 'Parent');
+                const node = createTestNode('child-1', 'Child', parent);
+                parent.children.push(node);
+                const result = await runInContext(createContext(node), () => handleInspectCurrentNode());
+                expect(result.id).toBe('child-1');
+                expect(result.name).toBe('Child');
+                expect(result.status).toBe('running');
+                expect(result.parentId).toBe('parent-1');
+                expect(result.parentName).toBe('Parent');
+                expect(result.depth).toBe(1);
+            });
+            it('should handle root node (no parent)', async () => {
+                const node = createTestNode('root-1', 'Root');
+                const result = await runInContext(createContext(node), () => handleInspectCurrentNode());
+                expect(result.parentId).toBeUndefined();
+                expect(result.depth).toBe(0);
+            });
+        });
+        describe('handleReadAncestorChain', () => {
+            it('should throw when not in workflow context', async () => {
+                await expect(handleReadAncestorChain({})).rejects.toThrow('Not in workflow context');
+            });
+            it('should return ancestor chain', async () => {
+                const root = createTestNode('root-1', 'Root');
+                const parent = createTestNode('parent-1', 'Parent', root);
+                root.children.push(parent);
+                const child = createTestNode('child-1', 'Child', parent);
+                parent.children.push(child);
+                const result = await runInContext(createContext(child), () => handleReadAncestorChain({}));
+                expect(result.ancestors).toHaveLength(2);
+                expect(result.ancestors[0].id).toBe('parent-1');
+                expect(result.ancestors[1].id).toBe('root-1');
+                expect(result.totalDepth).toBe(2);
+            });
+            it('should respect maxDepth limit', async () => {
+                const root = createTestNode('root-1', 'Root');
+                const parent = createTestNode('parent-1', 'Parent', root);
+                root.children.push(parent);
+                const child = createTestNode('child-1', 'Child', parent);
+                parent.children.push(child);
+                const result = await runInContext(createContext(child), () => handleReadAncestorChain({ maxDepth: 1 }));
+                expect(result.ancestors).toHaveLength(1);
+                expect(result.ancestors[0].id).toBe('parent-1');
+            });
+        });
+        describe('handleListSiblingsChildren', () => {
+            it('should throw when not in workflow context', async () => {
+                await expect(handleListSiblingsChildren({ type: 'children' })).rejects.toThrow('Not in workflow context');
+            });
+            it('should return children', async () => {
+                const parent = createTestNode('parent-1', 'Parent');
+                const child1 = createTestNode('child-1', 'Child 1', parent);
+                const child2 = createTestNode('child-2', 'Child 2', parent);
+                parent.children.push(child1, child2);
+                const result = await runInContext(createContext(parent), () => handleListSiblingsChildren({ type: 'children' }));
+                expect(result.type).toBe('children');
+                expect(result.nodes).toHaveLength(2);
+            });
+            it('should return siblings (excluding self)', async () => {
+                const parent = createTestNode('parent-1', 'Parent');
+                const child1 = createTestNode('child-1', 'Child 1', parent);
+                const child2 = createTestNode('child-2', 'Child 2', parent);
+                parent.children.push(child1, child2);
+                const result = await runInContext(createContext(child1), () => handleListSiblingsChildren({ type: 'siblings' }));
+                expect(result.type).toBe('siblings');
+                expect(result.nodes).toHaveLength(1);
+                expect(result.nodes[0].id).toBe('child-2');
+            });
+        });
+        describe('handleInspectPriorOutputs', () => {
+            it('should throw when not in workflow context', async () => {
+                await expect(handleInspectPriorOutputs({})).rejects.toThrow('Not in workflow context');
+            });
+            it('should return completed sibling outputs', async () => {
+                const parent = createTestNode('parent-1', 'Parent');
+                const completed = createTestNode('completed-1', 'Completed', parent);
+                completed.status = 'completed';
+                // Add a valid workflow event for testing
+                completed.events.push({
+                    type: 'stepEnd',
+                    node: completed,
+                    step: 'test-step',
+                    duration: 100,
+                }); // Cast to avoid strict type checking in tests
+                const current = createTestNode('current-1', 'Current', parent);
+                parent.children.push(completed, current);
+                const result = await runInContext(createContext(current), () => handleInspectPriorOutputs({}));
+                expect(result).toHaveLength(1);
+                expect(result[0].nodeId).toBe('completed-1');
+                expect(result[0].status).toBe('completed');
+            });
+        });
+        describe('handleInspectCacheStatus', () => {
+            beforeEach(async () => {
+                await defaultCache.clear();
+            });
+            it('should return false for missing cache key', async () => {
+                const result = await handleInspectCacheStatus({
+                    promptHash: 'nonexistent-key',
+                });
+                expect(result.exists).toBe(false);
+                expect(result.key).toBe('nonexistent-key');
+            });
+            it('should return true for existing cache key', async () => {
+                await defaultCache.set('test-key', { data: 'test' });
+                const result = await handleInspectCacheStatus({ promptHash: 'test-key' });
+                expect(result.exists).toBe(true);
+            });
+        });
+        describe('handleRequestSpawnWorkflow', () => {
+            it('should throw when not in workflow context', async () => {
+                await expect(handleRequestSpawnWorkflow({ name: 'Test', description: 'Test workflow' })).rejects.toThrow('Not in workflow context');
+            });
+            it('should return spawn request', async () => {
+                const node = createTestNode('node-1', 'Node');
+                const result = await runInContext(createContext(node), () => handleRequestSpawnWorkflow({
+                    name: 'NewWorkflow',
+                    description: 'A new workflow',
+                }));
+                expect(result.name).toBe('NewWorkflow');
+                expect(result.description).toBe('A new workflow');
+                expect(result.requestId).toMatch(/^spawn-/);
+                expect(result.status).toBe('pending');
+            });
+        });
+    });
+    describe('executeIntrospectionTool', () => {
+        it('should execute tool by name', async () => {
+            await defaultCache.set('cache-test', 'value');
+            const result = await executeIntrospectionTool('inspect_cache_status', {
+                promptHash: 'cache-test',
+            });
+            expect(result).toMatchObject({ exists: true, key: 'cache-test' });
+        });
+        it('should throw for unknown tool', async () => {
+            await expect(executeIntrospectionTool('unknown_tool', {})).rejects.toThrow('Unknown introspection tool');
+        });
+    });
+});
+//# sourceMappingURL=introspection-tools.test.js.map

package/dist/__tests__/unit/introspection-tools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection-tools.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/introspection-tools.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/unit/logger.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.test.d.ts.map

package/dist/__tests__/unit/logger.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/logger.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/logger.test.js

@@ -0,0 +1,241 @@
+import { describe, it, expect } from 'vitest';
+import { Workflow } from '../../core/workflow';
+describe('WorkflowLogger.child()', () => {
+    describe('with Partial<LogEntry> containing parentLogId', () => {
+        it('should create child logger with parentLogId from Partial<LogEntry>', async () => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    const childLogger = this.logger.child({ parentLogId: 'parent-123' });
+                    childLogger.info('Child message');
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            expect(workflow.node.logs.length).toBe(1);
+            expect(workflow.node.logs[0].parentLogId).toBe('parent-123');
+            expect(workflow.node.logs[0].message).toBe('Child message');
+        });
+        it('should handle parentLogId with special characters', async () => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    const childLogger = this.logger.child({ parentLogId: 'parent-with-dashes-and_underscores' });
+                    childLogger.info('Test');
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            expect(workflow.node.logs[0].parentLogId).toBe('parent-with-dashes-and_underscores');
+        });
+    });
+    describe('with Partial<LogEntry> containing id field', () => {
+        it('should not use id field as parentLogId', async () => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    // id field should NOT be used as parentLogId
+                    const childLogger = this.logger.child({ id: 'custom-id' });
+                    childLogger.info('Test message');
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            // parentLogId is undefined because implementation only checks input.parentLogId
+            expect(workflow.node.logs[0].parentLogId).toBeUndefined();
+            expect(workflow.node.logs[0].message).toBe('Test message');
+        });
+        it('should handle both id and parentLogId fields', async () => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    // parentLogId should be used, not id
+                    const childLogger = this.logger.child({ id: 'custom-id', parentLogId: 'correct-parent' });
+                    childLogger.info('Test');
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            expect(workflow.node.logs[0].parentLogId).toBe('correct-parent');
+        });
+    });
+    describe('with empty Partial<LogEntry>', () => {
+        it('should create child logger with undefined parentLogId from empty object', async () => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    const childLogger = this.logger.child({});
+                    childLogger.info('Child log with empty parent metadata');
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            expect(workflow.node.logs.length).toBe(1);
+            expect(workflow.node.logs[0].parentLogId).toBeUndefined();
+            expect(workflow.node.logs[0].message).toBe('Child log with empty parent metadata');
+        });
+    });
+    describe('with string parameter (backward compatibility)', () => {
+        it('should create child logger with parentLogId from string', async () => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    const childLogger = this.logger.child('parent-id-123');
+                    childLogger.info('Child message');
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            expect(workflow.node.logs.length).toBe(1);
+            expect(workflow.node.logs[0].parentLogId).toBe('parent-id-123');
+            expect(workflow.node.logs[0].message).toBe('Child message');
+        });
+        it('should create child logger with parentLogId from string containing parentLogId', async () => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    // String value is used directly as parentLogId
+                    const childLogger = this.logger.child('log-abc-123');
+                    childLogger.warn('Warning message');
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            expect(workflow.node.logs[0].parentLogId).toBe('log-abc-123');
+            expect(workflow.node.logs[0].level).toBe('warn');
+        });
+    });
+    describe('with empty string', () => {
+        it('should create child logger with undefined parentLogId from empty string', async () => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    const childLogger = this.logger.child('');
+                    childLogger.info('Child log with empty parent');
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            expect(workflow.node.logs.length).toBe(1);
+            // Empty string is falsy, so parentLogId becomes undefined in log entry
+            expect(workflow.node.logs[0].parentLogId).toBeUndefined();
+        });
+    });
+    describe('child logger with different log levels', () => {
+        it.each([
+            { level: 'debug', method: 'debug' },
+            { level: 'info', method: 'info' },
+            { level: 'warn', method: 'warn' },
+            { level: 'error', method: 'error' },
+        ])('should log at $level level with child logger', async ({ level, method }) => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    const childLogger = this.logger.child({ parentLogId: 'parent-123' });
+                    childLogger[method](`Test ${level} message`);
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            expect(workflow.node.logs[0].level).toBe(level);
+            expect(workflow.node.logs[0].parentLogId).toBe('parent-123');
+            expect(workflow.node.logs[0].message).toBe(`Test ${level} message`);
+        });
+        it('should support logging with data parameter at all levels', async () => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    const childLogger = this.logger.child({ parentLogId: 'parent-data' });
+                    childLogger.debug('Debug message', { debugData: true });
+                    childLogger.info('Info message', { infoData: 123 });
+                    childLogger.warn('Warn message', { warnData: 'warning' });
+                    childLogger.error('Error message', { errorData: { code: 500 } });
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            expect(workflow.node.logs.length).toBe(4);
+            expect(workflow.node.logs[0].data).toEqual({ debugData: true });
+            expect(workflow.node.logs[1].data).toEqual({ infoData: 123 });
+            expect(workflow.node.logs[2].data).toEqual({ warnData: 'warning' });
+            expect(workflow.node.logs[3].data).toEqual({ errorData: { code: 500 } });
+        });
+    });
+    describe('parent-child log hierarchy', () => {
+        it('should maintain parent-child relationship in log entries', async () => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    // Log from parent logger
+                    this.logger.info('Parent message');
+                    // Get the parent log entry ID
+                    const parentLogId = this.node.logs[0].id;
+                    // Create child logger with that ID
+                    const childLogger = this.logger.child({ parentLogId });
+                    childLogger.info('Child message');
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            // Verify hierarchy
+            expect(workflow.node.logs.length).toBe(2);
+            expect(workflow.node.logs[0].parentLogId).toBeUndefined(); // Root log
+            expect(workflow.node.logs[1].parentLogId).toBe(workflow.node.logs[0].id); // Child log
+            expect(workflow.node.logs[0].message).toBe('Parent message');
+            expect(workflow.node.logs[1].message).toBe('Child message');
+        });
+        it('should support multi-level nesting with child loggers', async () => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    // Root log
+                    this.logger.info('Root message');
+                    const rootLogId = this.node.logs[0].id;
+                    // First level child
+                    const child1 = this.logger.child({ parentLogId: rootLogId });
+                    child1.info('Level 1 child');
+                    const level1LogId = this.node.logs[1].id;
+                    // Second level child
+                    const child2 = this.logger.child({ parentLogId: level1LogId });
+                    child2.info('Level 2 child');
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            expect(workflow.node.logs.length).toBe(3);
+            expect(workflow.node.logs[0].parentLogId).toBeUndefined();
+            expect(workflow.node.logs[1].parentLogId).toBe(workflow.node.logs[0].id);
+            expect(workflow.node.logs[2].parentLogId).toBe(workflow.node.logs[1].id);
+        });
+        it('should support string-based parent-child hierarchy', async () => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    // Log from parent
+                    this.logger.info('Parent log');
+                    const parentLogId = this.node.logs[0].id;
+                    // Create child using string parentLogId (backward compatibility)
+                    const childLogger = this.logger.child(parentLogId);
+                    childLogger.info('Child log');
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            expect(workflow.node.logs.length).toBe(2);
+            expect(workflow.node.logs[0].parentLogId).toBeUndefined();
+            expect(workflow.node.logs[1].parentLogId).toBe(workflow.node.logs[0].id);
+        });
+        it('should allow multiple child loggers from same parent', async () => {
+            class TestWorkflow extends Workflow {
+                async run() {
+                    // Parent log
+                    this.logger.info('Parent');
+                    const parentLogId = this.node.logs[0].id;
+                    // Multiple children from same parent
+                    const child1 = this.logger.child({ parentLogId });
+                    child1.info('First child');
+                    const child2 = this.logger.child({ parentLogId });
+                    child2.info('Second child');
+                    const child3 = this.logger.child({ parentLogId });
+                    child3.info('Third child');
+                }
+            }
+            const workflow = new TestWorkflow();
+            await workflow.run();
+            expect(workflow.node.logs.length).toBe(4);
+            expect(workflow.node.logs[0].parentLogId).toBeUndefined();
+            // All children should have the same parent
+            expect(workflow.node.logs[1].parentLogId).toBe(workflow.node.logs[0].id);
+            expect(workflow.node.logs[2].parentLogId).toBe(workflow.node.logs[0].id);
+            expect(workflow.node.logs[3].parentLogId).toBe(workflow.node.logs[0].id);
+        });
+    });
+});
+//# sourceMappingURL=logger.test.js.map