groundswell 0.0.2 → 0.0.3

package/dist/__tests__/unit/workflow-emitEvent-childDetached.test.js.map

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

package/dist/__tests__/unit/workflow-isDescendantOf.test.d.ts

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

package/dist/__tests__/unit/workflow-isDescendantOf.test.d.ts.map

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

package/dist/__tests__/unit/workflow-isDescendantOf.test.js

@@ -0,0 +1,140 @@
+import { describe, it, expect } from "vitest";
+import { Workflow } from "../../core/workflow.js";
+/**
+ * Test suite for public isDescendantOf() API.
+ *
+ * These tests verify that the isDescendantOf() method is publicly accessible
+ * without requiring (as any) type casting, following the P1.M3.T4.S2 PRP
+ * implementation for making this method public.
+ */
+describe("Workflow.isDescendantOf() - Public API", () => {
+    describe("Public API Accessibility", () => {
+        it("should be publicly accessible without casting to any", () => {
+            const root = new Workflow("root");
+            const child = new Workflow("child", root);
+            // This should work without (as any) cast - verifies public visibility
+            const result = child.isDescendantOf(root);
+            expect(result).toBe(true);
+        });
+        it("should return true for direct parent relationship", () => {
+            const root = new Workflow("root");
+            const child = new Workflow("child", root);
+            const result = child.isDescendantOf(root);
+            expect(result).toBe(true);
+        });
+        it("should return true for nested descendant relationship", () => {
+            const root = new Workflow("root");
+            const level1 = new Workflow("level1", root);
+            const level2 = new Workflow("level2", level1);
+            const level3 = new Workflow("level3", level2);
+            expect(level1.isDescendantOf(root)).toBe(true);
+            expect(level2.isDescendantOf(root)).toBe(true);
+            expect(level3.isDescendantOf(root)).toBe(true);
+            expect(level3.isDescendantOf(level1)).toBe(true);
+        });
+        it("should return false for unrelated workflows", () => {
+            const tree1 = new Workflow("tree1");
+            const tree2 = new Workflow("tree2");
+            const result = tree1.isDescendantOf(tree2);
+            expect(result).toBe(false);
+        });
+        it("should return false when checking root against descendant", () => {
+            const root = new Workflow("root");
+            const child = new Workflow("child", root);
+            const result = root.isDescendantOf(child);
+            expect(result).toBe(false);
+        });
+        it("should return false for root checking itself", () => {
+            const root = new Workflow("root");
+            const result = root.isDescendantOf(root);
+            expect(result).toBe(false);
+        });
+    });
+    describe("Use Case: Hierarchy Validation", () => {
+        it("should support validating workflow belongs to specific hierarchy", () => {
+            const productionRoot = new Workflow("production-root");
+            const stagingRoot = new Workflow("staging-root");
+            const prodWorkflow = new Workflow("prod-workflow", productionRoot);
+            const stagingWorkflow = new Workflow("staging-workflow", stagingRoot);
+            expect(prodWorkflow.isDescendantOf(productionRoot)).toBe(true);
+            expect(prodWorkflow.isDescendantOf(stagingRoot)).toBe(false);
+            expect(stagingWorkflow.isDescendantOf(stagingRoot)).toBe(true);
+            expect(stagingWorkflow.isDescendantOf(productionRoot)).toBe(false);
+        });
+    });
+    describe("Use Case: Circular Reference Prevention", () => {
+        it("should support validation before attaching to prevent circular references", () => {
+            const root = new Workflow("root");
+            const child = new Workflow("child", root);
+            const grandchild = new Workflow("grandchild", child);
+            // grandchild should NOT be attachable to root (would create cycle)
+            expect(grandchild.isDescendantOf(root)).toBe(true);
+            // Unrelated workflow should be attachable
+            const unrelated = new Workflow("unrelated");
+            expect(unrelated.isDescendantOf(root)).toBe(false);
+        });
+    });
+    describe("Use Case: Conditional Logic Based on Ancestry", () => {
+        it("should support conditional execution based on hierarchy position", () => {
+            const productionRoot = new Workflow("production-root");
+            const developmentRoot = new Workflow("development-root");
+            const prodBatch = new Workflow("prod-batch", productionRoot);
+            const devBatch = new Workflow("dev-batch", developmentRoot);
+            // Simulate conditional logic
+            const isInProduction = prodBatch.isDescendantOf(productionRoot);
+            const isProductionWorkflow = devBatch.isDescendantOf(productionRoot);
+            expect(isInProduction).toBe(true);
+            expect(isProductionWorkflow).toBe(false);
+        });
+    });
+    describe("Edge Cases", () => {
+        it("should handle workflows with no parent", () => {
+            const orphan = new Workflow("orphan");
+            const root = new Workflow("root");
+            const result = orphan.isDescendantOf(root);
+            expect(result).toBe(false);
+        });
+        it("should handle sibling relationships correctly", () => {
+            const root = new Workflow("root");
+            const sibling1 = new Workflow("sibling1", root);
+            const sibling2 = new Workflow("sibling2", root);
+            // Siblings are not descendants of each other
+            expect(sibling1.isDescendantOf(sibling2)).toBe(false);
+            expect(sibling2.isDescendantOf(sibling1)).toBe(false);
+        });
+        it("should handle complex multi-level hierarchies", () => {
+            const root = new Workflow("root");
+            const branch1 = new Workflow("branch1", root);
+            const branch2 = new Workflow("branch2", root);
+            const leaf1a = new Workflow("leaf1a", branch1);
+            const leaf1b = new Workflow("leaf1b", branch1);
+            const leaf2a = new Workflow("leaf2a", branch2);
+            // All leafs should be descendants of root
+            expect(leaf1a.isDescendantOf(root)).toBe(true);
+            expect(leaf1b.isDescendantOf(root)).toBe(true);
+            expect(leaf2a.isDescendantOf(root)).toBe(true);
+            // Leaf1a should not be descendant of branch2
+            expect(leaf1a.isDescendantOf(branch2)).toBe(false);
+            // Leaf2a should not be descendant of branch1
+            expect(leaf2a.isDescendantOf(branch1)).toBe(false);
+        });
+    });
+    describe("Edge Cases: Circular Reference Detection", () => {
+        it("should throw error when circular reference is detected", () => {
+            // Arrange: Create parent and child workflows with circular reference
+            const parent = new Workflow("Parent");
+            const child = new Workflow("Child", parent);
+            const unrelated = new Workflow("Unrelated");
+            // Act: Create circular reference manually
+            // This simulates a bug or malicious input that creates a cycle
+            // Normal attachChild() prevents this, so we bypass normal safeguards
+            parent.parent = child;
+            // Assert: isDescendantOf should throw error for circular reference
+            // We use 'unrelated' as the ancestor to force traversal through the cycle
+            // If we used 'child', the method would return true immediately before
+            // detecting the cycle (since child === child at first iteration)
+            expect(() => parent.isDescendantOf(unrelated)).toThrow("Circular parent-child relationship detected");
+        });
+    });
+});
+//# sourceMappingURL=workflow-isDescendantOf.test.js.map

package/dist/__tests__/unit/workflow-isDescendantOf.test.js.map

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

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

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

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

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

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

@@ -0,0 +1,330 @@
+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;
+};
+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;
+};
+import { describe, it, expect } from 'vitest';
+import { Workflow, ObservedState } from '../../index.js';
+class SimpleWorkflow extends Workflow {
+    async run() {
+        this.setStatus('running');
+        this.logger.info('Running simple workflow');
+        this.setStatus('completed');
+        return 'done';
+    }
+}
+describe('Workflow Name Validation', () => {
+    it('should reject empty string name', () => {
+        expect(() => new SimpleWorkflow('')).toThrow('Workflow name cannot be empty or whitespace only');
+    });
+    it('should reject whitespace-only name (spaces)', () => {
+        expect(() => new SimpleWorkflow('   ')).toThrow('Workflow name cannot be empty or whitespace only');
+    });
+    it('should reject whitespace-only name (tabs)', () => {
+        expect(() => new SimpleWorkflow('\t\t')).toThrow('Workflow name cannot be empty or whitespace only');
+    });
+    it('should reject whitespace-only name (newlines)', () => {
+        expect(() => new SimpleWorkflow('\n\n')).toThrow('Workflow name cannot be empty or whitespace only');
+    });
+    it('should reject whitespace-only name (mixed whitespace)', () => {
+        expect(() => new SimpleWorkflow('  \t\n  ')).toThrow('Workflow name cannot be empty or whitespace only');
+    });
+    it('should reject name exceeding 100 characters', () => {
+        const longName = 'a'.repeat(101);
+        expect(() => new SimpleWorkflow(longName)).toThrow('Workflow name cannot exceed 100 characters');
+    });
+    it('should accept name with exactly 100 characters', () => {
+        const exactly100 = 'a'.repeat(100);
+        const wf = new SimpleWorkflow(exactly100);
+        expect(wf.getNode().name).toBe(exactly100);
+        expect(wf.getNode().name.length).toBe(100);
+    });
+    it('should accept valid names with leading/trailing whitespace', () => {
+        const wf1 = new SimpleWorkflow('  MyWorkflow  ');
+        expect(wf1.getNode().name).toBe('  MyWorkflow  ');
+        const wf2 = new SimpleWorkflow('\tValidName\t');
+        expect(wf2.getNode().name).toBe('\tValidName\t');
+    });
+    it('should use class name when name is undefined', () => {
+        const wf = new SimpleWorkflow();
+        expect(wf.getNode().name).toBe('SimpleWorkflow');
+    });
+    it('should use class name when name is null', () => {
+        const wf = new SimpleWorkflow(null);
+        expect(wf.getNode().name).toBe('SimpleWorkflow');
+    });
+    it('should validate both constructor patterns - class-based with empty name', () => {
+        expect(() => new SimpleWorkflow('')).toThrow('Workflow name cannot be empty or whitespace only');
+    });
+    it('should validate both constructor patterns - functional with empty name', () => {
+        expect(() => new Workflow({ name: '' }, async () => { })).toThrow('Workflow name cannot be empty or whitespace only');
+    });
+    it('should validate both constructor patterns - functional with whitespace name', () => {
+        expect(() => new Workflow({ name: '   ' }, async () => { })).toThrow('Workflow name cannot be empty or whitespace only');
+    });
+    it('should validate both constructor patterns - functional with name exceeding 100 characters', () => {
+        const longName = 'a'.repeat(101);
+        expect(() => new Workflow({ name: longName }, async () => { })).toThrow('Workflow name cannot exceed 100 characters');
+    });
+    it('should accept valid name in functional pattern', () => {
+        const wf = new Workflow({ name: 'ValidFunctionalWorkflow' }, async () => 'done');
+        expect(wf.getNode().name).toBe('ValidFunctionalWorkflow');
+    });
+});
+describe('Workflow', () => {
+    it('should create with unique id', () => {
+        const wf1 = new SimpleWorkflow();
+        const wf2 = new SimpleWorkflow();
+        expect(wf1.id).not.toBe(wf2.id);
+    });
+    it('should use class name as default name', () => {
+        const wf = new SimpleWorkflow();
+        expect(wf.getNode().name).toBe('SimpleWorkflow');
+    });
+    it('should use custom name when provided', () => {
+        const wf = new SimpleWorkflow('CustomName');
+        expect(wf.getNode().name).toBe('CustomName');
+    });
+    it('should start with idle status', () => {
+        const wf = new SimpleWorkflow();
+        expect(wf.status).toBe('idle');
+        expect(wf.getNode().status).toBe('idle');
+    });
+    it('should attach child to parent', () => {
+        const parent = new SimpleWorkflow('Parent');
+        const child = new SimpleWorkflow('Child', parent);
+        expect(child.parent).toBe(parent);
+        expect(parent.children).toContain(child);
+        expect(parent.getNode().children).toContain(child.getNode());
+    });
+    it('should emit logs to observers', async () => {
+        const wf = new SimpleWorkflow();
+        const logs = [];
+        const observer = {
+            onLog: (entry) => logs.push(entry),
+            onEvent: () => { },
+            onStateUpdated: () => { },
+            onTreeChanged: () => { },
+        };
+        wf.addObserver(observer);
+        await wf.run();
+        expect(logs.length).toBeGreaterThan(0);
+        expect(logs[0].message).toBe('Running simple workflow');
+    });
+    it('should emit childAttached event', () => {
+        const parent = new SimpleWorkflow('Parent');
+        const events = [];
+        const observer = {
+            onLog: () => { },
+            onEvent: (event) => events.push(event),
+            onStateUpdated: () => { },
+            onTreeChanged: () => { },
+        };
+        parent.addObserver(observer);
+        const child = new SimpleWorkflow('Child', parent);
+        const attachEvent = events.find((e) => e.type === 'childAttached');
+        expect(attachEvent).toBeDefined();
+        expect(attachEvent?.type === 'childAttached' && attachEvent.parentId).toBe(parent.id);
+    });
+    it('should capture state and logs in functional workflow error', async () => {
+        // Arrange: Create observer to capture events
+        const events = [];
+        const observer = {
+            onLog: () => { },
+            onEvent: (event) => events.push(event),
+            onStateUpdated: () => { },
+            onTreeChanged: () => { },
+        };
+        // Arrange: Create functional workflow with a step that throws an error
+        const workflow = new Workflow({ name: 'ErrorCaptureTest' }, async (ctx) => {
+            // Execute a step that will fail
+            await ctx.step('failing-step', async () => {
+                throw new Error('Test error from step');
+            });
+        });
+        // Act: Attach observer and run workflow
+        workflow.addObserver(observer);
+        await expect(workflow.run()).rejects.toThrow('Test error from step');
+        // Assert: Verify error event was emitted
+        const errorEvents = events.filter((e) => e.type === 'error');
+        expect(errorEvents.length).toBeGreaterThanOrEqual(1);
+        // Assert: Verify error structure
+        const errorEvent = errorEvents[0];
+        expect(errorEvent.error).toBeDefined();
+        expect(errorEvent.error.message).toBe('Test error from step');
+        // Assert: Verify logs array was captured (even if empty for step errors)
+        expect(errorEvent.error.logs).toBeDefined();
+        expect(Array.isArray(errorEvent.error.logs)).toBe(true);
+        // Assert: Verify state was captured (may be empty object for pure functional workflows)
+        expect(errorEvent.error.state).toBeDefined();
+        expect(typeof errorEvent.error.state).toBe('object');
+        // Assert: Verify workflow status
+        expect(workflow.status).toBe('failed');
+        // Assert: Verify workflowId is captured
+        expect(errorEvent.error.workflowId).toBe(workflow.id);
+    });
+    it('should capture @ObservedState fields in workflow error state', async () => {
+        // Test workflow class with @ObservedState decorated fields
+        // Using functional pattern (executor) so error events are emitted via runFunctional()
+        let StatefulWorkflowClass = (() => {
+            let _classSuper = Workflow;
+            let _stepCount_decorators;
+            let _stepCount_initializers = [];
+            let _stepCount_extraInitializers = [];
+            let _apiKey_decorators;
+            let _apiKey_initializers = [];
+            let _apiKey_extraInitializers = [];
+            let _internalCounter_decorators;
+            let _internalCounter_initializers = [];
+            let _internalCounter_extraInitializers = [];
+            return class StatefulWorkflowClass extends _classSuper {
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+                    _stepCount_decorators = [ObservedState()];
+                    _apiKey_decorators = [ObservedState({ redact: true })];
+                    _internalCounter_decorators = [ObservedState({ hidden: true })];
+                    __esDecorate(null, null, _stepCount_decorators, { kind: "field", name: "stepCount", static: false, private: false, access: { has: obj => "stepCount" in obj, get: obj => obj.stepCount, set: (obj, value) => { obj.stepCount = value; } }, metadata: _metadata }, _stepCount_initializers, _stepCount_extraInitializers);
+                    __esDecorate(null, null, _apiKey_decorators, { kind: "field", name: "apiKey", static: false, private: false, access: { has: obj => "apiKey" in obj, get: obj => obj.apiKey, set: (obj, value) => { obj.apiKey = value; } }, metadata: _metadata }, _apiKey_initializers, _apiKey_extraInitializers);
+                    __esDecorate(null, null, _internalCounter_decorators, { kind: "field", name: "internalCounter", static: false, private: false, access: { has: obj => "internalCounter" in obj, get: obj => obj.internalCounter, set: (obj, value) => { obj.internalCounter = value; } }, metadata: _metadata }, _internalCounter_initializers, _internalCounter_extraInitializers);
+                    if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                }
+                stepCount = __runInitializers(this, _stepCount_initializers, 0);
+                apiKey = (__runInitializers(this, _stepCount_extraInitializers), __runInitializers(this, _apiKey_initializers, 'secret-key-123'));
+                internalCounter = (__runInitializers(this, _apiKey_extraInitializers), __runInitializers(this, _internalCounter_initializers, 42));
+                constructor() {
+                    super(...arguments);
+                    __runInitializers(this, _internalCounter_extraInitializers);
+                }
+            };
+        })();
+        // Arrange: Create observer to capture error events
+        const events = [];
+        const observer = {
+            onLog: () => { },
+            onEvent: (event) => events.push(event),
+            onStateUpdated: () => { },
+            onTreeChanged: () => { },
+        };
+        // Arrange: Create workflow with @ObservedState fields using functional pattern
+        const workflow = new StatefulWorkflowClass({ name: 'StatefulErrorTest' }, async (ctx) => {
+            // Modify @ObservedState fields on the workflow instance
+            workflow.stepCount = 5;
+            workflow.apiKey = 'updated-key';
+            workflow.internalCounter = 99;
+            // Execute a step that will fail
+            await ctx.step('failing-step', async () => {
+                throw new Error('Error after state update');
+            });
+        });
+        // Act: Attach observer and trigger error
+        workflow.addObserver(observer);
+        await expect(workflow.run()).rejects.toThrow('Error after state update');
+        // Assert: Verify error event was emitted
+        const errorEvents = events.filter((e) => e.type === 'error');
+        expect(errorEvents.length).toBeGreaterThanOrEqual(1);
+        // Assert: Verify error structure
+        const errorEvent = errorEvents[0];
+        expect(errorEvent.error).toBeDefined();
+        expect(errorEvent.error.message).toBe('Error after state update');
+        // Assert: Verify @ObservedState fields were captured
+        expect(errorEvent.error.state).toBeDefined();
+        expect(typeof errorEvent.error.state).toBe('object');
+        // Assert: Verify public field value is captured
+        expect(errorEvent.error.state.stepCount).toBe(5);
+        // Assert: Verify redacted field shows '***'
+        expect(errorEvent.error.state.apiKey).toBe('***');
+        // Assert: Verify hidden field is NOT in state
+        expect('internalCounter' in errorEvent.error.state).toBe(false);
+        // Assert: Verify logs array is present (may be empty)
+        expect(errorEvent.error.logs).toBeDefined();
+        expect(Array.isArray(errorEvent.error.logs)).toBe(true);
+        // Assert: Verify workflow status
+        expect(workflow.status).toBe('failed');
+        // Assert: Verify workflowId is captured
+        expect(errorEvent.error.workflowId).toBe(workflow.id);
+    });
+    it('should detect circular parent relationship', () => {
+        // Arrange: Create parent and child workflows
+        const parent = new SimpleWorkflow('Parent');
+        const child = new SimpleWorkflow('Child', parent);
+        // Act: Create circular reference manually
+        // This simulates a bug or malicious input that creates a cycle
+        parent.parent = child;
+        // Assert: getRoot() should throw error for circular reference
+        // Note: getRoot() is protected, so we cast to any to access it
+        expect(() => parent.getRoot()).toThrow('Circular parent-child relationship detected');
+    });
+    it('should detect circular relationship in getRootObservers', () => {
+        // Arrange: Create parent and child workflows
+        const parent = new SimpleWorkflow('Parent');
+        const child = new SimpleWorkflow('Child', parent);
+        // Act: Create circular reference manually
+        // This simulates a bug or malicious input that creates a cycle
+        parent.parent = child;
+        // Assert: getRootObservers() should throw error for circular reference
+        // Note: getRootObservers() is private, so we cast to any to access it
+        expect(() => parent.getRootObservers()).toThrow('Circular parent-child relationship detected');
+    });
+    it('should throw error when duplicate attachment attempted', () => {
+        // Arrange: Create parent and child workflows with first attachment
+        const parent = new SimpleWorkflow('Parent');
+        const child = new SimpleWorkflow('Child', parent);
+        // Act & Assert: Second attachment attempt should throw error
+        expect(() => parent.attachChild(child)).toThrow('Child already attached to this workflow');
+    });
+    it('should emit treeUpdated event when status changes', () => {
+        // Arrange: Create workflow instance
+        const wf = new SimpleWorkflow();
+        // Arrange: Create arrays to track event emissions and callback invocations
+        const events = [];
+        const treeChangedCalls = [];
+        // Arrange: Create observer with callbacks
+        const observer = {
+            onLog: () => { }, // Empty - not testing logs
+            onEvent: (event) => events.push(event), // Capture events
+            onStateUpdated: () => { }, // Empty - not testing state updates
+            onTreeChanged: (root) => treeChangedCalls.push(root), // Capture tree changes
+        };
+        // Act: Attach observer and trigger status change
+        wf.addObserver(observer);
+        wf.setStatus('running');
+        // Assert: Verify treeUpdated event was emitted
+        const treeUpdatedEvent = events.find((e) => e.type === 'treeUpdated');
+        expect(treeUpdatedEvent).toBeDefined();
+        // Assert: Verify event payload contains root node (type narrowing for discriminated union)
+        expect(treeUpdatedEvent?.type === 'treeUpdated' && treeUpdatedEvent.root).toBe(wf.getNode());
+        // Assert: Verify onTreeChanged callback was invoked with root node
+        expect(treeChangedCalls).toHaveLength(1);
+        expect(treeChangedCalls[0]).toBe(wf.getNode());
+    });
+});
+//# sourceMappingURL=workflow.test.js.map

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

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

package/dist/cache/cache-key.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Cache Key Generation - Deterministic key generation for LLM response caching
+ *
+ * Uses SHA-256 hashing with deterministic JSON serialization to ensure
+ * identical inputs always produce identical cache keys.
+ */
+import type { Tool, MCPServer, Skill } from '../types/index.js';
+import type { z } from 'zod';
+/**
+ * Inputs used to generate a cache key
+ */
+export interface CacheKeyInputs {
+    /** User message content */
+    user: string;
+    /** Data passed to the prompt */
+    data?: Record<string, unknown>;
+    /** System prompt */
+    system?: string;
+    /** Model identifier */
+    model: string;
+    /** Temperature setting */
+    temperature?: number;
+    /** Maximum tokens */
+    maxTokens?: number;
+    /** Tools available to the agent */
+    tools?: Tool[];
+    /** MCP servers */
+    mcps?: MCPServer[];
+    /** Skills */
+    skills?: Skill[];
+    /** Zod response format schema */
+    responseFormat?: z.ZodType;
+}
+/**
+ * Deterministically stringify a value with sorted object keys
+ *
+ * Unlike JSON.stringify, this function guarantees consistent output
+ * regardless of key insertion order by sorting all object keys.
+ *
+ * @param value - Value to stringify
+ * @returns Deterministic JSON string
+ * @throws TypeError if circular reference detected
+ */
+export declare function deterministicStringify(value: unknown): string;
+/**
+ * Generate a hash from a Zod schema's internal definition
+ *
+ * Zod schemas are functions that cannot be directly serialized.
+ * This extracts the schema's _def property which contains the
+ * schema structure and hashes it.
+ *
+ * @param schema - Zod schema to hash
+ * @returns SHA-256 hex digest of the schema definition
+ */
+export declare function getSchemaHash(schema: z.ZodType | undefined): string;
+/**
+ * Generate a deterministic cache key from prompt execution inputs
+ *
+ * The key is a 64-character SHA-256 hex digest that uniquely identifies
+ * a specific combination of prompt, data, configuration, and tools.
+ *
+ * @param inputs - Cache key inputs
+ * @returns 64-character hex SHA-256 digest
+ */
+export declare function generateCacheKey(inputs: CacheKeyInputs): string;
+//# sourceMappingURL=cache-key.d.ts.map

package/dist/cache/cache-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-key.d.ts","sourceRoot":"","sources":["../../src/cache/cache-key.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,kBAAkB;IAClB,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IACnB,aAAa;IACb,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,iCAAiC;IACjC,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA2D7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,MAAM,CAqBnE;AAoDD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA2C/D"}