@cogitator-ai/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cogitator Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+# @cogitator-ai/core
+
+Core runtime for Cogitator AI agents. Build and run LLM-powered agents with tool calling, streaming, and multi-provider support.
+
+## Installation
+
+```bash
+pnpm add @cogitator-ai/core
+```
+
+## Quick Start
+
+```typescript
+import { Cogitator, Agent, tool } from '@cogitator-ai/core';
+import { z } from 'zod';
+
+// Create a tool
+const calculator = tool({
+  name: 'calculator',
+  description: 'Evaluate a math expression',
+  parameters: z.object({
+    expression: z.string(),
+  }),
+  execute: async ({ expression }) => {
+    return { result: eval(expression) };
+  },
+});
+
+// Create an agent
+const agent = new Agent({
+  name: 'math-assistant',
+  instructions: 'You are a helpful math assistant',
+  model: 'ollama/llama3.2:3b',
+  tools: [calculator],
+});
+
+// Run the agent
+const cog = new Cogitator();
+const result = await cog.run(agent, {
+  input: 'What is 25 * 4?',
+});
+
+console.log(result.output);
+```
+
+## Features
+
+- Multiple LLM backends (Ollama, OpenAI, Anthropic, Google)
+- Type-safe tool definitions with Zod
+- Streaming responses
+- Memory integration
+- Built-in tools (calculator, datetime, filesystem, HTTP, etc.)
+
+## LLM Backends
+
+```typescript
+// Ollama (default)
+const cog = new Cogitator({ defaultModel: 'ollama/llama3.2:3b' });
+
+// OpenAI
+const cog = new Cogitator({ defaultModel: 'openai/gpt-4o' });
+
+// Anthropic
+const cog = new Cogitator({ defaultModel: 'anthropic/claude-sonnet-4-20250514' });
+
+// Google
+const cog = new Cogitator({ defaultModel: 'google/gemini-1.5-flash' });
+```
+
+## Documentation
+
+See the [Cogitator documentation](https://github.com/eL1fe/cogitator) for full API reference.
+
+## License
+
+MIT

package/dist/__tests__/agent.test.d.ts

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

package/dist/__tests__/agent.test.d.ts.map

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

package/dist/__tests__/agent.test.js

@@ -0,0 +1,91 @@
+import { describe, it, expect } from 'vitest';
+import { z } from 'zod';
+import { Agent } from '../agent';
+import { tool } from '../tool';
+describe('Agent', () => {
+    const createBasicConfig = () => ({
+        name: 'test-agent',
+        model: 'ollama/llama3.1:8b',
+        instructions: 'You are a helpful assistant.',
+    });
+    describe('constructor', () => {
+        it('creates an agent with required config', () => {
+            const agent = new Agent(createBasicConfig());
+            expect(agent.name).toBe('test-agent');
+            expect(agent.model).toBe('ollama/llama3.1:8b');
+            expect(agent.instructions).toBe('You are a helpful assistant.');
+        });
+        it('generates a unique id', () => {
+            const agent1 = new Agent(createBasicConfig());
+            const agent2 = new Agent(createBasicConfig());
+            expect(agent1.id).toMatch(/^agent_/);
+            expect(agent2.id).toMatch(/^agent_/);
+            expect(agent1.id).not.toBe(agent2.id);
+        });
+        it('applies default values for temperature, maxIterations, timeout', () => {
+            const agent = new Agent(createBasicConfig());
+            expect(agent.config.temperature).toBe(0.7);
+            expect(agent.config.maxIterations).toBe(10);
+            expect(agent.config.timeout).toBe(120_000);
+        });
+        it('allows overriding default values', () => {
+            const agent = new Agent({
+                ...createBasicConfig(),
+                temperature: 0.9,
+                maxIterations: 5,
+                timeout: 60_000,
+            });
+            expect(agent.config.temperature).toBe(0.9);
+            expect(agent.config.maxIterations).toBe(5);
+            expect(agent.config.timeout).toBe(60_000);
+        });
+    });
+    describe('tools', () => {
+        it('returns empty array when no tools configured', () => {
+            const agent = new Agent(createBasicConfig());
+            expect(agent.tools).toEqual([]);
+        });
+        it('returns configured tools', () => {
+            const myTool = tool({
+                name: 'my-tool',
+                description: 'A test tool',
+                parameters: z.object({ x: z.string() }),
+                execute: () => Promise.resolve('result'),
+            });
+            const agent = new Agent({
+                ...createBasicConfig(),
+                tools: [myTool],
+            });
+            expect(agent.tools).toHaveLength(1);
+            expect(agent.tools[0].name).toBe('my-tool');
+        });
+    });
+    describe('clone()', () => {
+        it('creates a new agent with the same config', () => {
+            const original = new Agent({
+                ...createBasicConfig(),
+                temperature: 0.5,
+            });
+            const cloned = original.clone({});
+            expect(cloned.id).not.toBe(original.id);
+            expect(cloned.name).toBe(original.name);
+            expect(cloned.model).toBe(original.model);
+            expect(cloned.config.temperature).toBe(0.5);
+        });
+        it('applies overrides to the cloned agent', () => {
+            const original = new Agent({
+                ...createBasicConfig(),
+                temperature: 0.5,
+            });
+            const cloned = original.clone({
+                name: 'cloned-agent',
+                temperature: 0.9,
+            });
+            expect(cloned.name).toBe('cloned-agent');
+            expect(cloned.config.temperature).toBe(0.9);
+            expect(original.name).toBe('test-agent');
+            expect(original.config.temperature).toBe(0.5);
+        });
+    });
+});
+//# sourceMappingURL=agent.test.js.map

package/dist/__tests__/agent.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.test.js","sourceRoot":"","sources":["../../src/__tests__/agent.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,CAAC;QAC/B,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,oBAAoB;QAC3B,YAAY,EAAE,8BAA8B;KAC7C,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC;YAE7C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACtC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;YAC/B,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC;YAE9C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YACxE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC;YAE7C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;gBACtB,GAAG,iBAAiB,EAAE;gBACtB,WAAW,EAAE,GAAG;gBAChB,aAAa,EAAE,CAAC;gBAChB,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YAEH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,MAAM,MAAM,GAAG,IAAI,CAAC;gBAClB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,aAAa;gBAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBACvC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;aACzC,CAAS,CAAC;YAEX,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;gBACtB,GAAG,iBAAiB,EAAE;gBACtB,KAAK,EAAE,CAAC,MAAM,CAAC;aAChB,CAAC,CAAC;YAEH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC;gBACzB,GAAG,iBAAiB,EAAE;gBACtB,WAAW,EAAE,GAAG;aACjB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAElC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC;gBACzB,GAAG,iBAAiB,EAAE;gBACtB,WAAW,EAAE,GAAG;aACjB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC;gBAC5B,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,GAAG;aACjB,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/base64.test.d.ts

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

package/dist/__tests__/base64.test.d.ts.map

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

package/dist/__tests__/base64.test.js

@@ -0,0 +1,62 @@
+import { describe, it, expect } from 'vitest';
+import { base64Encode, base64Decode } from '../tools/base64';
+const mockContext = {
+    agentId: 'agent_test',
+    runId: 'run_test',
+    signal: new AbortController().signal,
+};
+describe('base64Encode tool', () => {
+    it('encodes string to base64', async () => {
+        const result = await base64Encode.execute({ data: 'Hello, World!' }, mockContext);
+        expect(result).toHaveProperty('result', 'SGVsbG8sIFdvcmxkIQ==');
+        expect(result).toHaveProperty('urlSafe', false);
+    });
+    it('encodes empty string', async () => {
+        const result = await base64Encode.execute({ data: '' }, mockContext);
+        expect(result.result).toBe('');
+    });
+    it('encodes unicode characters', async () => {
+        const result = await base64Encode.execute({ data: '🎉 Party!' }, mockContext);
+        expect(result.result).toBe('8J+OiSBQYXJ0eSE=');
+    });
+    it('produces URL-safe encoding', async () => {
+        const result = await base64Encode.execute({ data: '>>>???', urlSafe: true }, mockContext);
+        const encoded = result.result;
+        expect(encoded).not.toContain('+');
+        expect(encoded).not.toContain('/');
+        expect(encoded).not.toContain('=');
+        expect(result).toHaveProperty('urlSafe', true);
+    });
+    it('has correct metadata', () => {
+        expect(base64Encode.name).toBe('base64_encode');
+    });
+});
+describe('base64Decode tool', () => {
+    it('decodes base64 to string', async () => {
+        const result = await base64Decode.execute({ data: 'SGVsbG8sIFdvcmxkIQ==' }, mockContext);
+        expect(result).toHaveProperty('result', 'Hello, World!');
+    });
+    it('decodes empty string', async () => {
+        const result = await base64Decode.execute({ data: '' }, mockContext);
+        expect(result.result).toBe('');
+    });
+    it('decodes unicode characters', async () => {
+        const result = await base64Decode.execute({ data: '8J+OiSBQYXJ0eSE=' }, mockContext);
+        expect(result.result).toBe('🎉 Party!');
+    });
+    it('decodes URL-safe encoding', async () => {
+        const encoded = await base64Encode.execute({ data: '>>>???', urlSafe: true }, mockContext);
+        const decoded = await base64Decode.execute({ data: encoded.result, urlSafe: true }, mockContext);
+        expect(decoded.result).toBe('>>>???');
+    });
+    it('round-trips correctly', async () => {
+        const original = 'Test data with special chars: 日本語 🚀';
+        const encoded = await base64Encode.execute({ data: original }, mockContext);
+        const decoded = await base64Decode.execute({ data: encoded.result }, mockContext);
+        expect(decoded.result).toBe(original);
+    });
+    it('has correct metadata', () => {
+        expect(base64Decode.name).toBe('base64_decode');
+    });
+});
+//# sourceMappingURL=base64.test.js.map

package/dist/__tests__/base64.test.js.map

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

package/dist/__tests__/calculator.test.d.ts

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

package/dist/__tests__/calculator.test.d.ts.map

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

package/dist/__tests__/calculator.test.js

@@ -0,0 +1,146 @@
+import { describe, it, expect } from 'vitest';
+import { calculator } from '../tools/calculator';
+const mockContext = {
+    agentId: 'agent_test',
+    runId: 'run_test',
+    signal: new AbortController().signal,
+};
+describe('calculator tool', () => {
+    describe('basic arithmetic', () => {
+        it('evaluates addition', async () => {
+            const result = await calculator.execute({ expression: '2 + 3' }, mockContext);
+            expect(result).toEqual({ result: 5, expression: '2 + 3' });
+        });
+        it('evaluates subtraction', async () => {
+            const result = await calculator.execute({ expression: '10 - 4' }, mockContext);
+            expect(result).toEqual({ result: 6, expression: '10 - 4' });
+        });
+        it('evaluates multiplication', async () => {
+            const result = await calculator.execute({ expression: '6 * 7' }, mockContext);
+            expect(result).toEqual({ result: 42, expression: '6 * 7' });
+        });
+        it('evaluates division', async () => {
+            const result = await calculator.execute({ expression: '20 / 4' }, mockContext);
+            expect(result).toEqual({ result: 5, expression: '20 / 4' });
+        });
+        it('handles negative numbers', async () => {
+            const result = await calculator.execute({ expression: '-5 + 3' }, mockContext);
+            expect(result).toEqual({ result: -2, expression: '-5 + 3' });
+        });
+        it('handles decimals', async () => {
+            const result = await calculator.execute({ expression: '3.14 * 2' }, mockContext);
+            expect(result).toEqual({ result: 6.28, expression: '3.14 * 2' });
+        });
+    });
+    describe('operator precedence', () => {
+        it('respects multiplication over addition', async () => {
+            const result = await calculator.execute({ expression: '2 + 3 * 4' }, mockContext);
+            expect(result).toEqual({ result: 14, expression: '2 + 3 * 4' });
+        });
+        it('respects parentheses', async () => {
+            const result = await calculator.execute({ expression: '(2 + 3) * 4' }, mockContext);
+            expect(result).toEqual({ result: 20, expression: '(2 + 3) * 4' });
+        });
+        it('handles nested parentheses', async () => {
+            const result = await calculator.execute({ expression: '((2 + 3) * (4 - 1))' }, mockContext);
+            expect(result).toEqual({ result: 15, expression: '((2 + 3) * (4 - 1))' });
+        });
+    });
+    describe('power operator', () => {
+        it('evaluates power', async () => {
+            const result = await calculator.execute({ expression: '2^3' }, mockContext);
+            expect(result).toEqual({ result: 8, expression: '2^3' });
+        });
+        it('handles right-associative power', async () => {
+            const result = await calculator.execute({ expression: '2^2^3' }, mockContext);
+            expect(result).toEqual({ result: 256, expression: '2^2^3' });
+        });
+    });
+    describe('mathematical functions', () => {
+        it('evaluates sqrt', async () => {
+            const result = await calculator.execute({ expression: 'sqrt(16)' }, mockContext);
+            expect(result).toEqual({ result: 4, expression: 'sqrt(16)' });
+        });
+        it('evaluates abs', async () => {
+            const result = await calculator.execute({ expression: 'abs(-5)' }, mockContext);
+            expect(result).toEqual({ result: 5, expression: 'abs(-5)' });
+        });
+        it('evaluates round', async () => {
+            const result = await calculator.execute({ expression: 'round(3.7)' }, mockContext);
+            expect(result).toEqual({ result: 4, expression: 'round(3.7)' });
+        });
+        it('evaluates floor', async () => {
+            const result = await calculator.execute({ expression: 'floor(3.9)' }, mockContext);
+            expect(result).toEqual({ result: 3, expression: 'floor(3.9)' });
+        });
+        it('evaluates ceil', async () => {
+            const result = await calculator.execute({ expression: 'ceil(3.1)' }, mockContext);
+            expect(result).toEqual({ result: 4, expression: 'ceil(3.1)' });
+        });
+        it('evaluates sin', async () => {
+            const result = (await calculator.execute({ expression: 'sin(0)' }, mockContext));
+            expect(result.result).toBeCloseTo(0);
+        });
+        it('evaluates cos', async () => {
+            const result = (await calculator.execute({ expression: 'cos(0)' }, mockContext));
+            expect(result.result).toBeCloseTo(1);
+        });
+        it('evaluates log', async () => {
+            const result = (await calculator.execute({ expression: 'log(e)' }, mockContext));
+            expect(result.result).toBeCloseTo(1);
+        });
+    });
+    describe('constants', () => {
+        it('supports pi', async () => {
+            const result = (await calculator.execute({ expression: 'pi' }, mockContext));
+            expect(result.result).toBeCloseTo(Math.PI);
+        });
+        it('supports e', async () => {
+            const result = (await calculator.execute({ expression: 'e' }, mockContext));
+            expect(result.result).toBeCloseTo(Math.E);
+        });
+        it('uses pi in expressions', async () => {
+            const result = (await calculator.execute({ expression: '2 * pi' }, mockContext));
+            expect(result.result).toBeCloseTo(2 * Math.PI);
+        });
+    });
+    describe('complex expressions', () => {
+        it('evaluates compound expression', async () => {
+            const result = await calculator.execute({ expression: 'sqrt(16) + 2^3 - 4' }, mockContext);
+            expect(result).toEqual({ result: 8, expression: 'sqrt(16) + 2^3 - 4' });
+        });
+        it('handles function with expression argument', async () => {
+            const result = await calculator.execute({ expression: 'sqrt(9 + 16)' }, mockContext);
+            expect(result).toEqual({ result: 5, expression: 'sqrt(9 + 16)' });
+        });
+    });
+    describe('error handling', () => {
+        it('returns error for invalid characters', async () => {
+            const result = (await calculator.execute({ expression: '2 + x' }, mockContext));
+            expect(result.error).toContain('Unknown character');
+        });
+        it('returns error for division by zero (Infinity)', async () => {
+            const result = (await calculator.execute({ expression: '1 / 0' }, mockContext));
+            expect(result.error).toContain('not a finite number');
+        });
+        it('returns error for missing function parentheses', async () => {
+            const result = (await calculator.execute({ expression: 'sqrt 16' }, mockContext));
+            expect(result.error).toContain("Expected '(' after function");
+        });
+    });
+    describe('tool metadata', () => {
+        it('has correct name', () => {
+            expect(calculator.name).toBe('calculator');
+        });
+        it('has description', () => {
+            expect(calculator.description).toContain('mathematical expressions');
+        });
+        it('returns valid JSON schema', () => {
+            const schema = calculator.toJSON();
+            expect(schema.name).toBe('calculator');
+            expect(schema.parameters.type).toBe('object');
+            expect(schema.parameters.properties).toHaveProperty('expression');
+        });
+    });
+});
+//# sourceMappingURL=calculator.test.js.map

package/dist/__tests__/calculator.test.js.map

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

package/dist/__tests__/cogitator-memory.test.d.ts

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

package/dist/__tests__/cogitator-memory.test.d.ts.map

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

package/dist/__tests__/cogitator-memory.test.js

@@ -0,0 +1,176 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { Cogitator } from '../cogitator';
+import { Agent } from '../agent';
+const mockResponses = [];
+let responseIndex = 0;
+vi.mock('../llm/index.js', () => ({
+    createLLMBackend: () => ({
+        chat: vi.fn().mockImplementation(() => {
+            const content = mockResponses[responseIndex]?.content ?? 'Mock response';
+            responseIndex++;
+            return Promise.resolve({
+                id: 'mock-id',
+                content,
+                finishReason: 'stop',
+                usage: { inputTokens: 10, outputTokens: 10, totalTokens: 20 },
+            });
+        }),
+        chatStream: vi.fn(),
+    }),
+    parseModel: (model) => ({
+        provider: 'ollama',
+        model: model.replace('ollama/', ''),
+    }),
+}));
+describe('Cogitator with Memory', () => {
+    let cog;
+    let agent;
+    beforeEach(() => {
+        responseIndex = 0;
+        mockResponses.length = 0;
+    });
+    afterEach(async () => {
+        if (cog) {
+            await cog.close();
+        }
+    });
+    describe('without memory configured', () => {
+        it('works without memory', async () => {
+            cog = new Cogitator();
+            agent = new Agent({
+                id: 'test-agent',
+                name: 'Test Agent',
+                model: 'ollama/llama3.1:8b',
+                instructions: 'You are helpful.',
+            });
+            mockResponses.push({ role: 'assistant', content: 'Hello!' });
+            const result = await cog.run(agent, { input: 'Hi' });
+            expect(result.output).toBe('Hello!');
+            expect(result.threadId).toMatch(/^thread_/);
+        });
+    });
+    describe('with memory configured', () => {
+        const memoryConfig = {
+            memory: {
+                adapter: 'memory',
+                inMemory: { maxEntries: 1000 },
+            },
+        };
+        it('initializes memory adapter on first run', async () => {
+            cog = new Cogitator(memoryConfig);
+            agent = new Agent({
+                id: 'test-agent',
+                name: 'Test Agent',
+                model: 'ollama/llama3.1:8b',
+                instructions: 'You are helpful.',
+            });
+            mockResponses.push({ role: 'assistant', content: 'Hello!' });
+            const result = await cog.run(agent, { input: 'Hi', threadId: 'thread_test1' });
+            expect(result.output).toBe('Hello!');
+            expect(result.threadId).toBe('thread_test1');
+        });
+        it('persists messages across runs with same threadId', async () => {
+            cog = new Cogitator(memoryConfig);
+            agent = new Agent({
+                id: 'test-agent',
+                name: 'Test Agent',
+                model: 'ollama/llama3.1:8b',
+                instructions: 'You are helpful.',
+            });
+            const threadId = 'thread_persist';
+            mockResponses.push({ role: 'assistant', content: 'Nice to meet you, Alex!' });
+            await cog.run(agent, { input: 'My name is Alex', threadId });
+            mockResponses.push({ role: 'assistant', content: 'Your name is Alex!' });
+            const result2 = await cog.run(agent, { input: "What's my name?", threadId });
+            expect(result2.output).toBe('Your name is Alex!');
+            expect(result2.messages.length).toBeGreaterThan(2);
+        });
+        it('uses separate history for different threadIds', async () => {
+            cog = new Cogitator(memoryConfig);
+            agent = new Agent({
+                id: 'test-agent',
+                name: 'Test Agent',
+                model: 'ollama/llama3.1:8b',
+                instructions: 'You are helpful.',
+            });
+            mockResponses.push({ role: 'assistant', content: 'Hello Thread 1!' });
+            await cog.run(agent, { input: 'Thread 1 message', threadId: 'thread_1' });
+            mockResponses.push({ role: 'assistant', content: 'Hello Thread 2!' });
+            const result2 = await cog.run(agent, { input: 'Thread 2 message', threadId: 'thread_2' });
+            expect(result2.messages.filter((m) => m.role === 'user').length).toBe(1);
+        });
+        it('respects useMemory=false option', async () => {
+            cog = new Cogitator(memoryConfig);
+            agent = new Agent({
+                id: 'test-agent',
+                name: 'Test Agent',
+                model: 'ollama/llama3.1:8b',
+                instructions: 'You are helpful.',
+            });
+            const threadId = 'thread_nomem';
+            mockResponses.push({ role: 'assistant', content: 'First response' });
+            await cog.run(agent, { input: 'First message', threadId });
+            mockResponses.push({ role: 'assistant', content: 'Second response' });
+            const result2 = await cog.run(agent, {
+                input: 'Second message',
+                threadId,
+                useMemory: false,
+            });
+            expect(result2.messages.length).toBe(3);
+        });
+        it('respects saveHistory=false option', async () => {
+            cog = new Cogitator(memoryConfig);
+            agent = new Agent({
+                id: 'test-agent',
+                name: 'Test Agent',
+                model: 'ollama/llama3.1:8b',
+                instructions: 'You are helpful.',
+            });
+            const threadId = 'thread_nosave';
+            mockResponses.push({ role: 'assistant', content: 'Not saved' });
+            await cog.run(agent, { input: 'Temp message', threadId, saveHistory: false });
+            mockResponses.push({ role: 'assistant', content: 'Fresh start' });
+            const result2 = await cog.run(agent, { input: 'New message', threadId });
+            expect(result2.messages.length).toBe(3);
+        });
+        it('closes memory adapter properly', async () => {
+            cog = new Cogitator(memoryConfig);
+            agent = new Agent({
+                id: 'test-agent',
+                name: 'Test Agent',
+                model: 'ollama/llama3.1:8b',
+                instructions: 'You are helpful.',
+            });
+            mockResponses.push({ role: 'assistant', content: 'Test' });
+            await cog.run(agent, { input: 'Test', threadId: 'thread_close' });
+            await expect(cog.close()).resolves.not.toThrow();
+            await expect(cog.close()).resolves.not.toThrow();
+        });
+    });
+    describe('with context builder', () => {
+        const configWithBuilder = {
+            memory: {
+                adapter: 'memory',
+                inMemory: { maxEntries: 1000 },
+                contextBuilder: {
+                    maxTokens: 1000,
+                    strategy: 'recent',
+                    includeSystemPrompt: true,
+                },
+            },
+        };
+        it('uses context builder when configured', async () => {
+            cog = new Cogitator(configWithBuilder);
+            agent = new Agent({
+                id: 'test-agent',
+                name: 'Test Agent',
+                model: 'ollama/llama3.1:8b',
+                instructions: 'You are helpful.',
+            });
+            mockResponses.push({ role: 'assistant', content: 'Built with context!' });
+            const result = await cog.run(agent, { input: 'Hi', threadId: 'thread_ctx' });
+            expect(result.output).toBe('Built with context!');
+        });
+    });
+});
+//# sourceMappingURL=cogitator-memory.test.js.map