groundswell 0.0.2 → 0.0.3

package/dist/__tests__/unit/cache-key.test.js

@@ -0,0 +1,145 @@
+/**
+ * Unit tests for cache key generation
+ */
+import { describe, it, expect } from 'vitest';
+import { z } from 'zod';
+import { deterministicStringify, generateCacheKey, getSchemaHash, } from '../../cache/cache-key.js';
+describe('deterministicStringify', () => {
+    it('should produce same output for same object regardless of key order', () => {
+        const obj1 = { b: 2, a: 1 };
+        const obj2 = { a: 1, b: 2 };
+        expect(deterministicStringify(obj1)).toBe(deterministicStringify(obj2));
+    });
+    it('should handle primitives correctly', () => {
+        expect(deterministicStringify(null)).toBe('null');
+        expect(deterministicStringify(undefined)).toBe('undefined');
+        expect(deterministicStringify(true)).toBe('true');
+        expect(deterministicStringify(false)).toBe('false');
+        expect(deterministicStringify(42)).toBe('42');
+        expect(deterministicStringify('hello')).toBe('"hello"');
+    });
+    it('should handle arrays correctly', () => {
+        expect(deterministicStringify([1, 2, 3])).toBe('[1,2,3]');
+        expect(deterministicStringify(['a', 'b'])).toBe('["a","b"]');
+    });
+    it('should handle nested objects with sorted keys', () => {
+        const obj = { z: { b: 2, a: 1 }, y: [3, 2, 1] };
+        const result = deterministicStringify(obj);
+        // Keys should be sorted: y before z, a before b
+        expect(result).toBe('{"y":[3,2,1],"z":{"a":1,"b":2}}');
+    });
+    it('should throw on circular references', () => {
+        const obj = { a: 1 };
+        obj.self = obj;
+        expect(() => deterministicStringify(obj)).toThrow('Converting circular structure to JSON');
+    });
+    it('should handle Date objects', () => {
+        const date = new Date('2024-01-15T10:30:00.000Z');
+        const result = deterministicStringify(date);
+        expect(result).toBe('"2024-01-15T10:30:00.000Z"');
+    });
+    it('should handle Map objects', () => {
+        const map = new Map([
+            ['z', 1],
+            ['a', 2],
+        ]);
+        const result = deterministicStringify(map);
+        // Keys should be sorted in the output
+        expect(result).toContain('Map{');
+        expect(result).toContain('"a"');
+        expect(result).toContain('"z"');
+    });
+    it('should handle Set objects', () => {
+        const set = new Set([3, 1, 2]);
+        const result = deterministicStringify(set);
+        expect(result).toContain('Set{');
+    });
+});
+describe('getSchemaHash', () => {
+    it('should produce consistent hash for same schema', () => {
+        const schema1 = z.object({ name: z.string() });
+        const schema2 = z.object({ name: z.string() });
+        expect(getSchemaHash(schema1)).toBe(getSchemaHash(schema2));
+    });
+    it('should produce different hashes for different schemas', () => {
+        const schema1 = z.object({ name: z.string() });
+        const schema2 = z.object({ age: z.number() });
+        expect(getSchemaHash(schema1)).not.toBe(getSchemaHash(schema2));
+    });
+    it('should handle undefined schema', () => {
+        expect(getSchemaHash(undefined)).toBe('no-schema');
+    });
+    it('should produce 64-character hex string', () => {
+        const schema = z.object({ value: z.number() });
+        const hash = getSchemaHash(schema);
+        expect(hash).toMatch(/^[a-f0-9]{64}$/);
+    });
+});
+describe('generateCacheKey', () => {
+    it('should produce same key for identical inputs', () => {
+        const inputs1 = {
+            user: 'Hello',
+            model: 'claude-sonnet-4-20250514',
+            data: { value: 42 },
+        };
+        const inputs2 = {
+            user: 'Hello',
+            model: 'claude-sonnet-4-20250514',
+            data: { value: 42 },
+        };
+        expect(generateCacheKey(inputs1)).toBe(generateCacheKey(inputs2));
+    });
+    it('should produce different keys for different inputs', () => {
+        const inputs1 = {
+            user: 'Hello',
+            model: 'claude-sonnet-4-20250514',
+        };
+        const inputs2 = {
+            user: 'Goodbye',
+            model: 'claude-sonnet-4-20250514',
+        };
+        expect(generateCacheKey(inputs1)).not.toBe(generateCacheKey(inputs2));
+    });
+    it('should produce 64-character hex string', () => {
+        const key = generateCacheKey({
+            user: 'Test',
+            model: 'claude-sonnet-4-20250514',
+        });
+        expect(key).toMatch(/^[a-f0-9]{64}$/);
+    });
+    it('should include tools in key generation (sorted)', () => {
+        const toolSchema = { type: 'object', properties: {}, required: [] };
+        const inputs1 = {
+            user: 'Hello',
+            model: 'claude-sonnet-4-20250514',
+            tools: [
+                { name: 'tool_b', description: 'B', input_schema: toolSchema },
+                { name: 'tool_a', description: 'A', input_schema: toolSchema },
+            ],
+        };
+        const inputs2 = {
+            user: 'Hello',
+            model: 'claude-sonnet-4-20250514',
+            tools: [
+                { name: 'tool_a', description: 'A', input_schema: toolSchema },
+                { name: 'tool_b', description: 'B', input_schema: toolSchema },
+            ],
+        };
+        // Same tools in different order should produce same key
+        expect(generateCacheKey(inputs1)).toBe(generateCacheKey(inputs2));
+    });
+    it('should include schema hash in key', () => {
+        const schema = z.object({ result: z.string() });
+        const inputs1 = {
+            user: 'Hello',
+            model: 'claude-sonnet-4-20250514',
+            responseFormat: schema,
+        };
+        const inputs2 = {
+            user: 'Hello',
+            model: 'claude-sonnet-4-20250514',
+        };
+        expect(generateCacheKey(inputs1)).not.toBe(generateCacheKey(inputs2));
+    });
+});
+//# sourceMappingURL=cache-key.test.js.map

package/dist/__tests__/unit/cache-key.test.js.map

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

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

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

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

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

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

@@ -0,0 +1,132 @@
+/**
+ * Unit tests for LLMCache
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { LLMCache } from '../../cache/cache.js';
+describe('LLMCache', () => {
+    let cache;
+    beforeEach(() => {
+        cache = new LLMCache({ maxItems: 10 });
+    });
+    describe('get/set', () => {
+        it('should store and retrieve values', async () => {
+            await cache.set('key1', { data: 'test' });
+            const result = await cache.get('key1');
+            expect(result).toEqual({ data: 'test' });
+        });
+        it('should return undefined for missing keys', async () => {
+            const result = await cache.get('nonexistent');
+            expect(result).toBeUndefined();
+        });
+        it('should update existing keys', async () => {
+            await cache.set('key1', 'first');
+            await cache.set('key1', 'second');
+            const result = await cache.get('key1');
+            expect(result).toBe('second');
+        });
+    });
+    describe('has', () => {
+        it('should return true for existing keys', async () => {
+            await cache.set('key1', 'value');
+            expect(cache.has('key1')).toBe(true);
+        });
+        it('should return false for missing keys', () => {
+            expect(cache.has('nonexistent')).toBe(false);
+        });
+    });
+    describe('bust', () => {
+        it('should remove specific key', async () => {
+            await cache.set('key1', 'value1');
+            await cache.set('key2', 'value2');
+            await cache.bust('key1');
+            expect(cache.has('key1')).toBe(false);
+            expect(cache.has('key2')).toBe(true);
+        });
+        it('should not throw for missing keys', async () => {
+            await expect(cache.bust('nonexistent')).resolves.not.toThrow();
+        });
+    });
+    describe('bustPrefix', () => {
+        it('should remove all keys with given prefix', async () => {
+            await cache.set('key1', 'value1', { prefix: 'group-a' });
+            await cache.set('key2', 'value2', { prefix: 'group-a' });
+            await cache.set('key3', 'value3', { prefix: 'group-b' });
+            await cache.bustPrefix('group-a');
+            expect(cache.has('key1')).toBe(false);
+            expect(cache.has('key2')).toBe(false);
+            expect(cache.has('key3')).toBe(true);
+        });
+        it('should not throw for nonexistent prefix', async () => {
+            await expect(cache.bustPrefix('nonexistent')).resolves.not.toThrow();
+        });
+    });
+    describe('clear', () => {
+        it('should remove all entries', async () => {
+            await cache.set('key1', 'value1');
+            await cache.set('key2', 'value2');
+            await cache.clear();
+            expect(cache.size).toBe(0);
+        });
+        it('should reset metrics', async () => {
+            await cache.set('key1', 'value1');
+            await cache.get('key1'); // hit
+            await cache.get('key2'); // miss
+            await cache.clear();
+            const metrics = cache.metrics();
+            expect(metrics.hits).toBe(0);
+            expect(metrics.misses).toBe(0);
+        });
+    });
+    describe('metrics', () => {
+        it('should track hits and misses', async () => {
+            await cache.set('key1', 'value1');
+            await cache.get('key1'); // hit
+            await cache.get('key1'); // hit
+            await cache.get('key2'); // miss
+            const metrics = cache.metrics();
+            expect(metrics.hits).toBe(2);
+            expect(metrics.misses).toBe(1);
+            expect(metrics.hitRate).toBeCloseTo(66.67, 0);
+        });
+        it('should track size', async () => {
+            await cache.set('key1', 'value1');
+            await cache.set('key2', 'value2');
+            const metrics = cache.metrics();
+            expect(metrics.size).toBe(2);
+        });
+    });
+    describe('LRU eviction', () => {
+        it('should evict least recently used items when maxItems exceeded', async () => {
+            const smallCache = new LLMCache({ maxItems: 3 });
+            await smallCache.set('key1', 'value1');
+            await smallCache.set('key2', 'value2');
+            await smallCache.set('key3', 'value3');
+            await smallCache.set('key4', 'value4');
+            // key1 should be evicted (least recently used)
+            expect(smallCache.has('key1')).toBe(false);
+            expect(smallCache.has('key4')).toBe(true);
+        });
+        it('should update LRU order on get', async () => {
+            const smallCache = new LLMCache({ maxItems: 3 });
+            await smallCache.set('key1', 'value1');
+            await smallCache.set('key2', 'value2');
+            await smallCache.set('key3', 'value3');
+            // Access key1 to make it most recently used
+            await smallCache.get('key1');
+            // Add new item, should evict key2 instead of key1
+            await smallCache.set('key4', 'value4');
+            expect(smallCache.has('key1')).toBe(true);
+            expect(smallCache.has('key2')).toBe(false);
+        });
+    });
+    describe('keys', () => {
+        it('should return iterator of all keys', async () => {
+            await cache.set('key1', 'value1');
+            await cache.set('key2', 'value2');
+            const keys = Array.from(cache.keys());
+            expect(keys).toContain('key1');
+            expect(keys).toContain('key2');
+        });
+    });
+});
+//# sourceMappingURL=cache.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,220 @@
+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 { getExecutionContext, requireExecutionContext, runInContext, runInContextSync, hasExecutionContext, createChildContext, } from '../../core/context.js';
+import { Workflow, ObservedState } from '../../index.js';
+describe('AgentExecutionContext', () => {
+    const createMockNode = (name) => ({
+        id: `node-${name}`,
+        name,
+        parent: null,
+        children: [],
+        status: 'running',
+        logs: [],
+        events: [],
+        stateSnapshot: null,
+    });
+    const createMockContext = (name) => ({
+        workflowNode: createMockNode(name),
+        emitEvent: () => { },
+        workflowId: `workflow-${name}`,
+    });
+    it('should return undefined outside of context', () => {
+        expect(getExecutionContext()).toBeUndefined();
+    });
+    it('should throw when requiring context outside of context', () => {
+        expect(() => requireExecutionContext('test operation')).toThrow('test operation called outside of workflow context');
+    });
+    it('should detect context availability', () => {
+        expect(hasExecutionContext()).toBe(false);
+    });
+    it('should provide context within runInContext', async () => {
+        const ctx = createMockContext('test');
+        await runInContext(ctx, async () => {
+            expect(hasExecutionContext()).toBe(true);
+            expect(getExecutionContext()).toBe(ctx);
+            expect(requireExecutionContext('test')).toBe(ctx);
+        });
+        // Context should be gone after run completes
+        expect(hasExecutionContext()).toBe(false);
+    });
+    it('should provide context within sync runInContextSync', () => {
+        const ctx = createMockContext('test');
+        runInContextSync(ctx, () => {
+            expect(hasExecutionContext()).toBe(true);
+            expect(getExecutionContext()).toBe(ctx);
+        });
+        expect(hasExecutionContext()).toBe(false);
+    });
+    it('should propagate context through nested async calls', async () => {
+        const ctx = createMockContext('root');
+        const nested = async () => {
+            const innerCtx = getExecutionContext();
+            return innerCtx?.workflowNode.name;
+        };
+        await runInContext(ctx, async () => {
+            const name = await nested();
+            expect(name).toBe('root');
+        });
+    });
+    it('should create child context with new node', async () => {
+        const parentCtx = createMockContext('parent');
+        const childNode = createMockNode('child');
+        await runInContext(parentCtx, async () => {
+            const childCtx = createChildContext(childNode);
+            expect(childCtx).toBeDefined();
+            expect(childCtx?.workflowNode).toBe(childNode);
+            expect(childCtx?.workflowId).toBe(parentCtx.workflowId);
+        });
+    });
+    it('should return undefined for child context when not in context', () => {
+        const childNode = createMockNode('child');
+        const childCtx = createChildContext(childNode);
+        expect(childCtx).toBeUndefined();
+    });
+    it('should allow nested contexts', async () => {
+        const outerCtx = createMockContext('outer');
+        const innerCtx = createMockContext('inner');
+        await runInContext(outerCtx, async () => {
+            expect(getExecutionContext()?.workflowNode.name).toBe('outer');
+            await runInContext(innerCtx, async () => {
+                expect(getExecutionContext()?.workflowNode.name).toBe('inner');
+            });
+            // Should restore outer context
+            expect(getExecutionContext()?.workflowNode.name).toBe('outer');
+        });
+    });
+    it('should capture emitted events', async () => {
+        const events = [];
+        const node = createMockNode('test');
+        const ctx = {
+            workflowNode: node,
+            emitEvent: (event) => events.push(event),
+            workflowId: 'wf-1',
+        };
+        await runInContext(ctx, async () => {
+            const currentCtx = requireExecutionContext('emit');
+            currentCtx.emitEvent({
+                type: 'stepStart',
+                node: currentCtx.workflowNode,
+                step: 'test-step',
+            });
+        });
+        expect(events).toHaveLength(1);
+        expect(events[0].type).toBe('stepStart');
+    });
+});
+describe('WorkflowContext', () => {
+    // Test workflow class with @ObservedState decorated fields
+    let StatefulTestWorkflow = (() => {
+        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 StatefulTestWorkflow 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);
+            }
+        };
+    })();
+    it('should capture state and logs in step() error handler', async () => {
+        // 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 executor
+        const workflow = new StatefulTestWorkflow({ name: 'StepErrorTest' }, 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 - THIS TRIGGERS WorkflowContext.step() ERROR HANDLER
+            await ctx.step('failing-step', async () => {
+                throw new Error('Test error from step');
+            });
+        });
+        // Act: Attach observer and trigger error
+        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 @ObservedState fields were captured in state
+        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);
+    });
+});
+//# sourceMappingURL=context.test.js.map

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

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

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

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

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

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