macro-agent 0.1.1 → 0.1.3

package/src/store/__tests__/event-store.test.ts

@@ -1,1446 +0,0 @@
-/**
- * Event Store Tests
- *
- * Tests for event emission, querying, and materialized view projections
- */
-
-import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
-import { createEventStore, EventStore, parseDuration } from '../event-store.js';
-import {
-  isMessageEvent,
-  getMessagePayload,
-  getTargetAddress,
-  type Event,
-  type EventTarget,
-} from '../types/events.js';
-import * as fs from 'fs';
-import * as path from 'path';
-import * as os from 'os';
-
-describe('EventStore', () => {
-  let store: EventStore;
-
-  beforeEach(async () => {
-    // Create in-memory store for testing
-    store = await createEventStore({ inMemory: true });
-  });
-
-  afterEach(async () => {
-    await store.close();
-  });
-
-  describe('Event Emission', () => {
-    it('should emit events with auto-generated ID, version, and timestamp', () => {
-      const event = store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent_1' },
-        payload: {
-          agent_id: 'child_1',
-          session_id: 'sess_123',
-          task: 'do work',
-        },
-      });
-
-      expect(event.id).toMatch(/^evt_/);
-      expect(event.version).toBe(1);
-      expect(event.timestamp).toBeGreaterThan(0);
-      expect(event.type).toBe('spawn');
-      expect(event.payload.agent_id).toBe('child_1');
-    });
-
-    it('should store events in chronological order', async () => {
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'task 1' },
-      });
-
-      // Small delay to ensure different timestamps
-      await new Promise((resolve) => setTimeout(resolve, 10));
-
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_2', session_id: 'sess_2', task: 'task 2' },
-      });
-
-      const events = store.query();
-      expect(events.length).toBe(2);
-      expect(events[0].timestamp).toBeLessThanOrEqual(events[1].timestamp);
-    });
-  });
-
-  describe('Event Querying', () => {
-    beforeEach(() => {
-      // Emit various event types
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'task 1' },
-      });
-      store.emit({
-        type: 'status',
-        source: { agent_id: 'agent_1' },
-        payload: { status_type: 'started', summary: 'Starting work' },
-      });
-      store.emit({
-        type: 'message',
-        source: { agent_id: 'agent_1' },
-        target: { agent_id: 'parent' },
-        payload: { content: 'Hello' },
-      });
-    });
-
-    it('should query events by type', () => {
-      const statusEvents = store.query({ type: 'status' });
-      expect(statusEvents.length).toBe(1);
-      expect(statusEvents[0].type).toBe('status');
-    });
-
-    it('should query events by source agent', () => {
-      const agentEvents = store.query({ source_agent_id: 'agent_1' });
-      expect(agentEvents.length).toBe(2); // status and message
-    });
-
-    it('should query events by time range', () => {
-      const now = Date.now();
-      const events = store.query({ after: now - 10000, before: now + 10000 });
-      expect(events.length).toBe(3);
-    });
-
-    it('should return events in chronological order', () => {
-      const events = store.query();
-      for (let i = 1; i < events.length; i++) {
-        expect(events[i].timestamp).toBeGreaterThanOrEqual(events[i - 1].timestamp);
-      }
-    });
-  });
-
-  describe('Agent View Projection', () => {
-    it('should create agent on spawn event', () => {
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: {
-          agent_id: 'agent_1',
-          session_id: 'sess_123',
-          task: 'implement feature',
-          parent: 'parent',
-        },
-      });
-
-      const agent = store.getAgent('agent_1');
-      expect(agent).not.toBeNull();
-      expect(agent!.id).toBe('agent_1');
-      expect(agent!.session_id).toBe('sess_123');
-      expect(agent!.task).toBe('implement feature');
-      expect(agent!.state).toBe('spawning');
-      expect(agent!.parent).toBe('parent');
-    });
-
-    it('should update agent state on status started event', () => {
-      store.emit({
-        type: 'spawn',
-        source: {},
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work' },
-      });
-
-      store.emit({
-        type: 'status',
-        source: { agent_id: 'agent_1' },
-        payload: { status_type: 'started', summary: 'Starting' },
-      });
-
-      const agent = store.getAgent('agent_1');
-      expect(agent!.state).toBe('running');
-      expect(agent!.started_at).toBeGreaterThan(0);
-    });
-
-    it('should update agent state on terminate event', () => {
-      store.emit({
-        type: 'spawn',
-        source: {},
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work' },
-      });
-
-      store.emit({
-        type: 'status',
-        source: { agent_id: 'agent_1' },
-        payload: { status_type: 'started', summary: 'Starting' },
-      });
-
-      store.emit({
-        type: 'stop',
-        source: { agent_id: 'agent_1' },
-        payload: { reason: 'completed' },
-      });
-
-      const agent = store.getAgent('agent_1');
-      expect(agent!.state).toBe('stopped');
-      expect(agent!.stop_reason).toBe('completed');
-      expect(agent!.stopped_at).toBeGreaterThan(0);
-    });
-
-    it('should compute lineage correctly', () => {
-      // Create head manager
-      store.emit({
-        type: 'spawn',
-        source: {},
-        payload: { agent_id: 'head', session_id: 'sess_head', task: 'manage', parent: null },
-      });
-
-      // Create child
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'head' },
-        payload: { agent_id: 'child', session_id: 'sess_child', task: 'work', parent: 'head' },
-      });
-
-      // Create grandchild
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'child' },
-        payload: { agent_id: 'grandchild', session_id: 'sess_grand', task: 'subwork', parent: 'child' },
-      });
-
-      const grandchild = store.getAgent('grandchild');
-      expect(grandchild!.lineage).toEqual(['head', 'child']);
-    });
-
-    it('should list agents with filter', () => {
-      store.emit({
-        type: 'spawn',
-        source: {},
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work 1' },
-      });
-      store.emit({
-        type: 'spawn',
-        source: {},
-        payload: { agent_id: 'agent_2', session_id: 'sess_2', task: 'work 2' },
-      });
-      store.emit({
-        type: 'status',
-        source: { agent_id: 'agent_1' },
-        payload: { status_type: 'started', summary: 'Starting' },
-      });
-
-      const runningAgents = store.listAgents({ state: 'running' });
-      expect(runningAgents.length).toBe(1);
-      expect(runningAgents[0].id).toBe('agent_1');
-
-      const spawningAgents = store.listAgents({ state: 'spawning' });
-      expect(spawningAgents.length).toBe(1);
-      expect(spawningAgents[0].id).toBe('agent_2');
-    });
-  });
-
-  describe('Task View Projection', () => {
-    it('should create task on task created event', () => {
-      store.emit({
-        type: 'task',
-        source: { agent_id: 'manager' },
-        payload: {
-          task_id: 'task_1',
-          action: 'created',
-          details: { description: 'Implement auth' },
-        },
-      });
-
-      const task = store.getTask('task_1');
-      expect(task).not.toBeNull();
-      expect(task!.id).toBe('task_1');
-      expect(task!.description).toBe('Implement auth');
-      expect(task!.status).toBe('pending');
-      expect(task!.created_by).toBe('manager');
-    });
-
-    it('should update task on assigned event', () => {
-      store.emit({
-        type: 'task',
-        source: { agent_id: 'manager' },
-        payload: {
-          task_id: 'task_1',
-          action: 'created',
-          details: { description: 'Work' },
-        },
-      });
-
-      store.emit({
-        type: 'task',
-        source: { agent_id: 'manager' },
-        payload: {
-          task_id: 'task_1',
-          action: 'assigned',
-          details: { agent_id: 'worker_1' },
-        },
-      });
-
-      const task = store.getTask('task_1');
-      expect(task!.status).toBe('assigned');
-      expect(task!.assigned_agent).toBe('worker_1');
-    });
-
-    it('should update task status', () => {
-      store.emit({
-        type: 'task',
-        source: { agent_id: 'manager' },
-        payload: {
-          task_id: 'task_1',
-          action: 'created',
-          details: { description: 'Work' },
-        },
-      });
-
-      store.emit({
-        type: 'task',
-        source: { agent_id: 'worker' },
-        payload: {
-          task_id: 'task_1',
-          action: 'status_change',
-          details: { status: 'in_progress' },
-        },
-      });
-
-      const task = store.getTask('task_1');
-      expect(task!.status).toBe('in_progress');
-      expect(task!.started_at).toBeGreaterThan(0);
-    });
-
-    it('should list tasks with filter', () => {
-      store.emit({
-        type: 'task',
-        source: { agent_id: 'manager' },
-        payload: { task_id: 'task_1', action: 'created', details: { description: 'Task 1' } },
-      });
-      store.emit({
-        type: 'task',
-        source: { agent_id: 'manager' },
-        payload: { task_id: 'task_2', action: 'created', details: { description: 'Task 2' } },
-      });
-      store.emit({
-        type: 'task',
-        source: {},
-        payload: { task_id: 'task_1', action: 'status_change', details: { status: 'in_progress' } },
-      });
-
-      const inProgressTasks = store.listTasks({ status: 'in_progress' });
-      expect(inProgressTasks.length).toBe(1);
-      expect(inProgressTasks[0].id).toBe('task_1');
-    });
-  });
-
-  describe('Message Queue Projection', () => {
-    it('should add message to recipient queue', () => {
-      store.emit({
-        type: 'message',
-        source: { agent_id: 'sender' },
-        target: { agent_id: 'recipient' },
-        payload: { content: 'Hello there!' },
-      });
-
-      const messages = store.getMessages('recipient');
-      expect(messages.length).toBe(1);
-      expect(messages[0].content).toBe('Hello there!');
-      expect(messages[0].from.agent_id).toBe('sender');
-    });
-
-    it('should deliver message to topic subscribers', () => {
-      // Subscribe agents to topic
-      store.addSubscription('agent_1', { type: 'topic', target: 'updates' });
-      store.addSubscription('agent_2', { type: 'topic', target: 'updates' });
-
-      store.emit({
-        type: 'message',
-        source: { agent_id: 'broadcaster' },
-        target: { topic: 'updates' },
-        payload: { content: 'Important update' },
-      });
-
-      const messages1 = store.getMessages('agent_1');
-      const messages2 = store.getMessages('agent_2');
-
-      expect(messages1.length).toBe(1);
-      expect(messages2.length).toBe(1);
-      expect(messages1[0].content).toBe('Important update');
-    });
-
-    it('should truncate large messages', () => {
-      const longContent = 'x'.repeat(2000);
-
-      store.emit({
-        type: 'message',
-        source: { agent_id: 'sender' },
-        target: { agent_id: 'recipient' },
-        payload: { content: longContent },
-      });
-
-      const messages = store.getMessages('recipient');
-      expect(messages[0].truncated).toBe(true);
-      expect(messages[0].content.length).toBeLessThan(longContent.length);
-    });
-
-    it('should retrieve full message content', () => {
-      const longContent = 'x'.repeat(2000);
-
-      const event = store.emit({
-        type: 'message',
-        source: { agent_id: 'sender' },
-        target: { agent_id: 'recipient' },
-        payload: { content: longContent },
-      });
-
-      const fullContent = store.getFullMessage(event.id);
-      expect(fullContent).toBe(longContent);
-    });
-  });
-
-  describe('MAP Address Format (Phase 2)', () => {
-    it('should store message with MAP agent address', () => {
-      const event = store.emit({
-        type: 'message',
-        source: { agent_id: 'sender' },
-        target: {
-          agent_id: 'recipient',
-          address: { agent: 'recipient' },
-          delivered: ['recipient'],
-        },
-        payload: { content: 'Hello with MAP address' },
-      });
-
-      expect(event.target?.address).toEqual({ agent: 'recipient' });
-      expect(event.target?.delivered).toEqual(['recipient']);
-    });
-
-    it('should store message with MAP broadcast address', () => {
-      const event = store.emit({
-        type: 'message',
-        source: { agent_id: 'sender' },
-        target: {
-          address: { broadcast: true },
-          delivered: ['agent_1', 'agent_2'],
-        },
-        payload: {
-          content: 'Broadcast message',
-          priority: 'high',
-          delivery_hint: 'inject',
-        },
-      });
-
-      expect(event.target?.address).toEqual({ broadcast: true });
-      expect(event.target?.delivered).toEqual(['agent_1', 'agent_2']);
-    });
-
-    it('should store message with hierarchical address', () => {
-      const event = store.emit({
-        type: 'message',
-        source: { agent_id: 'child' },
-        target: {
-          address: { parent: true },
-          delivered: ['parent_agent'],
-        },
-        payload: { content: 'Message to parent' },
-      });
-
-      expect(event.target?.address).toEqual({ parent: true });
-      expect(event.target?.delivered).toEqual(['parent_agent']);
-    });
-
-    it('should store message with descendants address and depth', () => {
-      const event = store.emit({
-        type: 'message',
-        source: { agent_id: 'coordinator' },
-        target: {
-          address: { descendants: true, depth: 2 },
-          delivered: ['child1', 'child2', 'grandchild1'],
-        },
-        payload: { content: 'Cascade message' },
-      });
-
-      expect(event.target?.address).toEqual({ descendants: true, depth: 2 });
-      expect(event.target?.delivered).toHaveLength(3);
-    });
-
-    it('should store message with role address', () => {
-      const event = store.emit({
-        type: 'message',
-        source: { agent_id: 'coordinator' },
-        target: {
-          address: { role: 'worker', within: 'scope_123' },
-          delivered: ['worker_1', 'worker_2'],
-        },
-        payload: {
-          content: 'Work assignment',
-          priority: 'normal',
-        },
-      });
-
-      expect(event.target?.address).toEqual({ role: 'worker', within: 'scope_123' });
-    });
-
-    it('should query events and retrieve stored addresses', () => {
-      store.emit({
-        type: 'message',
-        source: { agent_id: 'sender' },
-        target: {
-          agent_id: 'recipient',
-          address: { agent: 'recipient' },
-        },
-        payload: { content: 'Test' },
-      });
-
-      const events = store.query({ type: 'message' });
-      expect(events.length).toBe(1);
-      expect(events[0].target?.address).toEqual({ agent: 'recipient' });
-    });
-
-    it('should maintain backward compatibility with legacy target format', () => {
-      // Event without MAP address (legacy format)
-      store.emit({
-        type: 'message',
-        source: { agent_id: 'sender' },
-        target: { agent_id: 'recipient' },
-        payload: { content: 'Legacy message' },
-      });
-
-      const messages = store.getMessages('recipient');
-      expect(messages.length).toBe(1);
-      expect(messages[0].content).toBe('Legacy message');
-    });
-  });
-
-  describe('Subscription Management', () => {
-    it('should add and get subscriptions', () => {
-      store.addSubscription('agent_1', { type: 'topic', target: 'errors' });
-      store.addSubscription('agent_1', { type: 'agent', target: 'agent_1' });
-
-      const subs = store.getSubscriptions('agent_1');
-      expect(subs.length).toBe(2);
-      expect(subs).toContainEqual({ type: 'topic', target: 'errors' });
-      expect(subs).toContainEqual({ type: 'agent', target: 'agent_1' });
-    });
-
-    it('should remove subscriptions', () => {
-      store.addSubscription('agent_1', { type: 'topic', target: 'errors' });
-      store.removeSubscription('agent_1', { type: 'topic', target: 'errors' });
-
-      const subs = store.getSubscriptions('agent_1');
-      expect(subs.length).toBe(0);
-    });
-
-    it('should get subscribers by subscription', () => {
-      store.addSubscription('agent_1', { type: 'topic', target: 'discoveries' });
-      store.addSubscription('agent_2', { type: 'topic', target: 'discoveries' });
-      store.addSubscription('agent_3', { type: 'topic', target: 'other' });
-
-      const subscribers = store.getSubscribers({ type: 'topic', target: 'discoveries' });
-      expect(subscribers).toContain('agent_1');
-      expect(subscribers).toContain('agent_2');
-      expect(subscribers).not.toContain('agent_3');
-    });
-  });
-
-  describe('Reactive Updates', () => {
-    it('should notify on agent changes', () => {
-      const changes: Array<{ agentId: string; state: string | undefined }> = [];
-
-      store.onAgentChange((agentId, agent) => {
-        changes.push({ agentId, state: agent?.state });
-      });
-
-      store.emit({
-        type: 'spawn',
-        source: {},
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work' },
-      });
-
-      expect(changes.length).toBe(1);
-      expect(changes[0].agentId).toBe('agent_1');
-      expect(changes[0].state).toBe('spawning');
-    });
-
-    it('should notify on specific agent changes', () => {
-      const changes: string[] = [];
-
-      store.onAgentChange('agent_1', () => {
-        changes.push('agent_1 changed');
-      });
-
-      store.emit({
-        type: 'spawn',
-        source: {},
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work' },
-      });
-
-      store.emit({
-        type: 'spawn',
-        source: {},
-        payload: { agent_id: 'agent_2', session_id: 'sess_2', task: 'other work' },
-      });
-
-      // Only agent_1 changes should be notified
-      expect(changes.length).toBe(1);
-    });
-
-    it('should notify on task changes', () => {
-      const changes: string[] = [];
-
-      store.onTaskChange((taskId) => {
-        changes.push(taskId);
-      });
-
-      store.emit({
-        type: 'task',
-        source: { agent_id: 'manager' },
-        payload: { task_id: 'task_1', action: 'created', details: { description: 'Work' } },
-      });
-
-      expect(changes).toContain('task_1');
-    });
-
-    it('should notify on message changes', () => {
-      const messages: string[] = [];
-
-      store.onMessageChange('recipient', (agentId, msgs) => {
-        messages.push(`${agentId}: ${msgs.length} messages`);
-      });
-
-      store.emit({
-        type: 'message',
-        source: { agent_id: 'sender' },
-        target: { agent_id: 'recipient' },
-        payload: { content: 'Hello' },
-      });
-
-      expect(messages.length).toBe(1);
-      expect(messages[0]).toBe('recipient: 1 messages');
-    });
-
-    it('should unsubscribe from changes', () => {
-      const changes: string[] = [];
-
-      const unsubscribe = store.onAgentChange(() => {
-        changes.push('changed');
-      });
-
-      store.emit({
-        type: 'spawn',
-        source: {},
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work' },
-      });
-
-      unsubscribe();
-
-      store.emit({
-        type: 'spawn',
-        source: {},
-        payload: { agent_id: 'agent_2', session_id: 'sess_2', task: 'more work' },
-      });
-
-      // Should only have one change (before unsubscribe)
-      expect(changes.length).toBe(1);
-    });
-  });
-});
-
-describe('parseDuration', () => {
-  it('should parse seconds', () => {
-    expect(parseDuration('30s')).toBe(30 * 1000);
-  });
-
-  it('should parse minutes', () => {
-    expect(parseDuration('60m')).toBe(60 * 60 * 1000);
-  });
-
-  it('should parse hours', () => {
-    expect(parseDuration('24h')).toBe(24 * 60 * 60 * 1000);
-  });
-
-  it('should parse days', () => {
-    expect(parseDuration('30d')).toBe(30 * 24 * 60 * 60 * 1000);
-    expect(parseDuration('7d')).toBe(7 * 24 * 60 * 60 * 1000);
-  });
-
-  it('should throw on invalid format', () => {
-    expect(() => parseDuration('30')).toThrow('Invalid duration format');
-    expect(() => parseDuration('30x')).toThrow('Invalid duration format');
-    expect(() => parseDuration('abc')).toThrow('Invalid duration format');
-  });
-});
-
-describe('Event Archival', () => {
-  let store: EventStore;
-  let testDir: string;
-
-  beforeEach(async () => {
-    // Create a temporary directory for testing
-    testDir = fs.mkdtempSync(path.join(os.tmpdir(), 'event-store-test-'));
-    store = await createEventStore({ baseDir: testDir, instanceId: 'archive-test' });
-  });
-
-  afterEach(async () => {
-    await store.close();
-    // Clean up temp directory
-    fs.rmSync(testDir, { recursive: true, force: true });
-  });
-
-  describe('archive', () => {
-    it('should archive events older than threshold', async () => {
-      // Create events with old timestamps by manipulating time
-      const now = Date.now();
-      const oldTimestamp = now - 40 * 24 * 60 * 60 * 1000; // 40 days ago
-
-      // Emit some events
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work 1' },
-      });
-
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_2', session_id: 'sess_2', task: 'work 2' },
-      });
-
-      // Archive with 'before' option to archive all current events
-      const result = await store.archive({ before: now + 10000 });
-
-      expect(result.archivedCount).toBe(2);
-      expect(result.archivePath).toContain('.json');
-
-      // Verify events are removed from active store
-      const remainingEvents = store.query();
-      expect(remainingEvents.length).toBe(0);
-    });
-
-    it('should return empty result when no events to archive', async () => {
-      // Emit recent events
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work' },
-      });
-
-      // Archive with olderThan that won't match any events
-      const result = await store.archive({ olderThan: '30d' });
-
-      expect(result.archivedCount).toBe(0);
-      expect(result.archivePath).toBe('');
-    });
-
-    it('should preserve materialized views after archive', async () => {
-      // Create agent
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work' },
-      });
-
-      store.emit({
-        type: 'status',
-        source: { agent_id: 'agent_1' },
-        payload: { status_type: 'started', summary: 'Starting' },
-      });
-
-      // Verify agent exists before archive
-      const agentBefore = store.getAgent('agent_1');
-      expect(agentBefore).not.toBeNull();
-      expect(agentBefore!.state).toBe('running');
-
-      // Archive all events
-      await store.archive({ before: Date.now() + 10000 });
-
-      // Agent view should still work (materialized views aren't affected)
-      const agentAfter = store.getAgent('agent_1');
-      expect(agentAfter).not.toBeNull();
-      expect(agentAfter!.state).toBe('running');
-    });
-  });
-
-  describe('loadArchive', () => {
-    it('should load archived events by date range', async () => {
-      // Emit events
-      const event1 = store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work 1' },
-      });
-
-      const event2 = store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_2', session_id: 'sess_2', task: 'work 2' },
-      });
-
-      // Archive all events
-      await store.archive({ before: Date.now() + 10000 });
-
-      // Load all archived events
-      const archivedEvents = await store.loadArchive();
-
-      expect(archivedEvents.length).toBe(2);
-      expect(archivedEvents[0].id).toBe(event1.id);
-      expect(archivedEvents[1].id).toBe(event2.id);
-    });
-
-    it('should filter archived events by date range', async () => {
-      // Emit events
-      const event1 = store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work 1' },
-      });
-
-      // Archive all events
-      await store.archive({ before: Date.now() + 10000 });
-
-      // Load with from filter (should return event1)
-      const archivedEvents = await store.loadArchive({
-        from: event1.timestamp - 1000,
-        to: event1.timestamp + 1000,
-      });
-
-      expect(archivedEvents.length).toBe(1);
-      expect(archivedEvents[0].id).toBe(event1.id);
-    });
-
-    it('should return empty array when no archives exist', async () => {
-      const events = await store.loadArchive();
-      expect(events).toEqual([]);
-    });
-  });
-
-  describe('getArchiveInfo', () => {
-    it('should return correct metadata about archives', async () => {
-      // Emit events
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work 1' },
-      });
-
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_2', session_id: 'sess_2', task: 'work 2' },
-      });
-
-      // Archive all events
-      await store.archive({ before: Date.now() + 10000 });
-
-      // Get archive info
-      const info = await store.getArchiveInfo();
-
-      expect(info.totalArchivedEvents).toBe(2);
-      expect(info.archives.length).toBe(1);
-      expect(info.archives[0].eventCount).toBe(2);
-      expect(info.archives[0].path).toContain('.json');
-    });
-
-    it('should return empty info when no archives exist', async () => {
-      const info = await store.getArchiveInfo();
-
-      expect(info.totalArchivedEvents).toBe(0);
-      expect(info.archives).toEqual([]);
-    });
-  });
-
-  describe('multiple archive operations', () => {
-    it('should merge events into existing archive files', async () => {
-      // First batch
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work 1' },
-      });
-
-      await store.archive({ before: Date.now() + 5000 });
-
-      // Second batch
-      store.emit({
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'agent_2', session_id: 'sess_2', task: 'work 2' },
-      });
-
-      await store.archive({ before: Date.now() + 10000 });
-
-      // Should have merged into same archive file
-      const info = await store.getArchiveInfo();
-      expect(info.totalArchivedEvents).toBe(2);
-
-      // Load and verify all events are there
-      const events = await store.loadArchive();
-      expect(events.length).toBe(2);
-    });
-  });
-
-  describe('Peer Visibility Export', () => {
-    let testDir: string;
-    let permissiveStore: EventStore;
-    let restrictiveStore: EventStore;
-
-    beforeEach(async () => {
-      testDir = path.join(
-        os.tmpdir(),
-        `macro-agent-visibility-test-${Date.now()}-${Math.random().toString(36).slice(2)}`
-      );
-      fs.mkdirSync(testDir, { recursive: true });
-
-      // Store with permissive visibility (allows spawn events from agent-1)
-      permissiveStore = await createEventStore({
-        baseDir: testDir,
-        instanceId: 'permissive-instance',
-        peerVisibility: {
-          exportEvents: true,
-          visibleEventTypes: ['spawn'],
-          visibleAgents: ['agent-1'],
-        },
-      });
-
-      // Store with default (restrictive) visibility
-      restrictiveStore = await createEventStore({
-        baseDir: testDir,
-        instanceId: 'restrictive-instance',
-      });
-
-      // Add events to both stores
-      permissiveStore.emit({
-        type: 'spawn',
-        source: { agent_id: 'agent-1' },
-        payload: { agent_id: 'child-1', session_id: 'sess-1', task: 'work' },
-      });
-      permissiveStore.emit({
-        type: 'message',
-        source: { agent_id: 'agent-1' },
-        target: { agent_id: 'agent-2' },
-        payload: { content: 'hello' },
-      });
-      permissiveStore.emit({
-        type: 'spawn',
-        source: { agent_id: 'agent-2' },
-        payload: { agent_id: 'child-2', session_id: 'sess-2', task: 'work' },
-      });
-
-      restrictiveStore.emit({
-        type: 'spawn',
-        source: { agent_id: 'agent-1' },
-        payload: { agent_id: 'child-1', session_id: 'sess-1', task: 'work' },
-      });
-    });
-
-    afterEach(async () => {
-      await permissiveStore.close();
-      await restrictiveStore.close();
-      if (fs.existsSync(testDir)) {
-        fs.rmSync(testDir, { recursive: true, force: true });
-      }
-    });
-
-    it('should export all events when forPeer is false', () => {
-      const exported = permissiveStore.exportEvents();
-      expect(exported).toHaveLength(3);
-    });
-
-    it('should filter events based on peerVisibility when forPeer is true', () => {
-      const exported = permissiveStore.exportEvents(undefined, { forPeer: true });
-      // Should only include spawn events from agent-1
-      expect(exported).toHaveLength(1);
-      expect(exported[0].type).toBe('spawn');
-      expect(exported[0].source.agent_id).toBe('agent-1');
-    });
-
-    it('should return empty array when visibility is restrictive and forPeer is true', () => {
-      const exported = restrictiveStore.exportEvents(undefined, { forPeer: true });
-      expect(exported).toHaveLength(0);
-    });
-
-    it('should export all events from restrictive store when forPeer is false', () => {
-      const exported = restrictiveStore.exportEvents();
-      expect(exported).toHaveLength(1);
-    });
-
-    it('should include sourceInstance in exported events', () => {
-      const exported = permissiveStore.exportEvents(undefined, { forPeer: true });
-      expect(exported[0].sourceInstance).toBe('permissive-instance');
-    });
-  });
-
-  describe('Deprecation Warnings', () => {
-    let testDir: string;
-    let consoleWarnSpy: ReturnType<typeof vi.spyOn>;
-
-    beforeEach(() => {
-      testDir = path.join(
-        os.tmpdir(),
-        `macro-agent-deprecation-test-${Date.now()}-${Math.random().toString(36).slice(2)}`
-      );
-      fs.mkdirSync(testDir, { recursive: true });
-      consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
-    });
-
-    afterEach(() => {
-      consoleWarnSpy.mockRestore();
-      if (fs.existsSync(testDir)) {
-        fs.rmSync(testDir, { recursive: true, force: true });
-      }
-    });
-
-    it('should throw when using removed legacy path option', async () => {
-      const legacyPath = path.join(testDir, 'legacy-store.json');
-      await expect(createEventStore({ path: legacyPath })).rejects.toThrow(
-        'The `path` option has been removed'
-      );
-    });
-
-    it('should not emit deprecation warning for new-style configuration', async () => {
-      const newStore = await createEventStore({
-        baseDir: testDir,
-        instanceId: 'test-new-instance',
-      });
-
-      expect(consoleWarnSpy).not.toHaveBeenCalled();
-
-      await newStore.close();
-    });
-
-    it('should not emit deprecation warning for in-memory stores', async () => {
-      const memStore = await createEventStore({ inMemory: true });
-
-      expect(consoleWarnSpy).not.toHaveBeenCalled();
-
-      await memStore.close();
-    });
-  });
-
-  describe('reload', () => {
-    it('should reload data from SQLite and see changes from another process', async () => {
-      // Create a store with SQLite backend
-      const store1 = await createEventStore({
-        baseDir: testDir,
-        instanceId: 'reload-test',
-      });
-
-      // Emit an event and persist
-      store1.emit({
-        type: 'spawn',
-        source: { agent_id: 'system' },
-        payload: { agent_id: 'agent_1', session_id: 'sess_1', task: 'work 1' },
-      });
-      await store1.persist();
-
-      // Create a second store instance (simulating another process)
-      const store2 = await createEventStore({
-        baseDir: testDir,
-        instanceId: 'reload-test',
-      });
-
-      // Store2 should see the agent
-      expect(store2.getAgent('agent_1')).toBeDefined();
-
-      // Now store1 emits another event and persists
-      store1.emit({
-        type: 'spawn',
-        source: { agent_id: 'system' },
-        payload: { agent_id: 'agent_2', session_id: 'sess_2', task: 'work 2' },
-      });
-      await store1.persist();
-
-      // Store2 doesn't see it yet (in-memory cache)
-      expect(store2.getAgent('agent_2')).toBeNull();
-
-      // After reload, store2 should see the new agent
-      await store2.reload();
-      expect(store2.getAgent('agent_2')).toBeDefined();
-
-      await store1.close();
-      await store2.close();
-    });
-
-    it('should preserve agent plan across reload (rebuildViews)', async () => {
-      const planStore = await createEventStore({
-        baseDir: testDir,
-        instanceId: 'plan-reload-test',
-      });
-
-      // Spawn an agent
-      planStore.emit({
-        type: 'spawn',
-        source: { agent_id: 'agent_plan' },
-        payload: {
-          agent_id: 'agent_plan',
-          session_id: 'sess_plan',
-          task: 'test plan persistence',
-        },
-      });
-
-      // Set plan via updateAgentPlan
-      const plan = [
-        { content: 'Read files', priority: 'high', status: 'completed' },
-        { content: 'Write code', priority: 'medium', status: 'in_progress' },
-      ];
-      planStore.updateAgentPlan('agent_plan' as AgentId, plan);
-
-      // Verify plan is set
-      const before = planStore.getAgent('agent_plan' as AgentId);
-      expect(before?.plan).toEqual(plan);
-
-      // Persist, then reload (simulates server restart: load from SQLite + rebuildViews)
-      await planStore.persist();
-      await planStore.reload();
-
-      // Plan should survive the reload
-      const after = planStore.getAgent('agent_plan' as AgentId);
-      expect(after).toBeDefined();
-      expect(after?.plan).toEqual(plan);
-
-      await planStore.close();
-    });
-
-    it('should update agent name via updateAgentMetadata', async () => {
-      const metaStore = await createEventStore({ inMemory: true });
-
-      metaStore.emit({
-        type: 'spawn',
-        source: { agent_id: 'agent_meta' },
-        payload: {
-          agent_id: 'agent_meta',
-          session_id: 'sess_meta',
-          task: 'test metadata',
-        },
-      });
-
-      // Name starts undefined
-      expect(metaStore.getAgent('agent_meta')?.name).toBeUndefined();
-
-      // Set name via updateAgentMetadata
-      metaStore.updateAgentMetadata('agent_meta', { name: 'MyAgent' });
-      expect(metaStore.getAgent('agent_meta')?.name).toBe('MyAgent');
-
-      await metaStore.close();
-    });
-
-    it('should update agent metadata via updateAgentMetadata', async () => {
-      const metaStore = await createEventStore({ inMemory: true });
-
-      metaStore.emit({
-        type: 'spawn',
-        source: { agent_id: 'agent_meta2' },
-        payload: {
-          agent_id: 'agent_meta2',
-          session_id: 'sess_meta2',
-          task: 'test metadata field',
-        },
-      });
-
-      // Metadata starts undefined
-      expect(metaStore.getAgent('agent_meta2')?.metadata).toBeUndefined();
-
-      // Set metadata
-      metaStore.updateAgentMetadata('agent_meta2', {
-        metadata: { color: 'blue', priority: 1 },
-      });
-      const after = metaStore.getAgent('agent_meta2');
-      expect(after?.metadata).toEqual({ color: 'blue', priority: 1 });
-
-      await metaStore.close();
-    });
-
-    it('should shallow-merge metadata with existing values', async () => {
-      const metaStore = await createEventStore({ inMemory: true });
-
-      metaStore.emit({
-        type: 'spawn',
-        source: { agent_id: 'agent_merge' },
-        payload: {
-          agent_id: 'agent_merge',
-          session_id: 'sess_merge',
-          task: 'test metadata merge',
-        },
-      });
-
-      // Set initial metadata
-      metaStore.updateAgentMetadata('agent_merge', {
-        metadata: { color: 'blue', size: 'large' },
-      });
-      expect(metaStore.getAgent('agent_merge')?.metadata).toEqual({
-        color: 'blue',
-        size: 'large',
-      });
-
-      // Merge with new metadata — existing keys preserved, new keys added
-      metaStore.updateAgentMetadata('agent_merge', {
-        metadata: { color: 'red', shape: 'circle' },
-      });
-      expect(metaStore.getAgent('agent_merge')?.metadata).toEqual({
-        color: 'red',
-        size: 'large',
-        shape: 'circle',
-      });
-
-      await metaStore.close();
-    });
-
-    it('should update multiple fields in a single updateAgentMetadata call', async () => {
-      const metaStore = await createEventStore({ inMemory: true });
-
-      metaStore.emit({
-        type: 'spawn',
-        source: { agent_id: 'agent_multi' },
-        payload: {
-          agent_id: 'agent_multi',
-          session_id: 'sess_multi',
-          task: 'test multi-field update',
-        },
-      });
-
-      const plan = [
-        { content: 'Step 1', priority: 'high', status: 'pending' },
-      ];
-
-      metaStore.updateAgentMetadata('agent_multi', {
-        name: 'MultiAgent',
-        plan,
-        metadata: { tag: 'test' },
-      });
-
-      const agent = metaStore.getAgent('agent_multi');
-      expect(agent?.name).toBe('MultiAgent');
-      expect(agent?.plan).toEqual(plan);
-      expect(agent?.metadata).toEqual({ tag: 'test' });
-
-      await metaStore.close();
-    });
-
-    it('should notify agent change listeners on metadata update', async () => {
-      const metaStore = await createEventStore({ inMemory: true });
-
-      metaStore.emit({
-        type: 'spawn',
-        source: { agent_id: 'agent_notify' },
-        payload: {
-          agent_id: 'agent_notify',
-          session_id: 'sess_notify',
-          task: 'test notify',
-        },
-      });
-
-      const changes: string[] = [];
-      metaStore.onAgentChange((agentId) => {
-        changes.push(agentId);
-      });
-
-      metaStore.updateAgentMetadata('agent_notify', { name: 'Notified' });
-      expect(changes).toContain('agent_notify');
-
-      await metaStore.close();
-    });
-
-    it('should preserve all out-of-band fields across reload', async () => {
-      const metaStore = await createEventStore({
-        baseDir: testDir,
-        instanceId: 'metadata-reload-test',
-      });
-
-      metaStore.emit({
-        type: 'spawn',
-        source: { agent_id: 'agent_reload' },
-        payload: {
-          agent_id: 'agent_reload',
-          session_id: 'sess_reload',
-          task: 'test reload persistence',
-        },
-      });
-
-      // Set all out-of-band fields
-      const plan = [
-        { content: 'Research', priority: 'high', status: 'completed' },
-      ];
-      metaStore.updateAgentMetadata('agent_reload', {
-        name: 'ReloadAgent',
-        plan,
-        metadata: { version: 2, env: 'test' },
-      });
-
-      // Verify before reload
-      const before = metaStore.getAgent('agent_reload');
-      expect(before?.name).toBe('ReloadAgent');
-      expect(before?.plan).toEqual(plan);
-      expect(before?.metadata).toEqual({ version: 2, env: 'test' });
-
-      // Persist and reload (rebuildViews)
-      await metaStore.persist();
-      await metaStore.reload();
-
-      // All fields should survive
-      const after = metaStore.getAgent('agent_reload');
-      expect(after).toBeDefined();
-      expect(after?.name).toBe('ReloadAgent');
-      expect(after?.plan).toEqual(plan);
-      expect(after?.metadata).toEqual({ version: 2, env: 'test' });
-
-      await metaStore.close();
-    });
-
-    it('should no-op when agent does not exist', async () => {
-      const metaStore = await createEventStore({ inMemory: true });
-
-      // Should not throw
-      metaStore.updateAgentMetadata('nonexistent', { name: 'Ghost' });
-      expect(metaStore.getAgent('nonexistent')).toBeNull();
-
-      await metaStore.close();
-    });
-  });
-});
-
-describe('Message Event Helper Functions', () => {
-  describe('isMessageEvent', () => {
-    it('should return true for message events', () => {
-      const event: Event = {
-        id: 'evt_1',
-        version: 1,
-        timestamp: Date.now(),
-        type: 'message',
-        source: { agent_id: 'sender' },
-        target: { agent_id: 'recipient' },
-        payload: { content: 'test' },
-      };
-      expect(isMessageEvent(event)).toBe(true);
-    });
-
-    it('should return false for non-message events', () => {
-      const event: Event = {
-        id: 'evt_1',
-        version: 1,
-        timestamp: Date.now(),
-        type: 'spawn',
-        source: { agent_id: 'parent' },
-        payload: { agent_id: 'child', session_id: 'sess_1', task: 'work' },
-      };
-      expect(isMessageEvent(event)).toBe(false);
-    });
-  });
-
-  describe('getMessagePayload', () => {
-    it('should return typed payload for message events', () => {
-      const event: Event = {
-        id: 'evt_1',
-        version: 1,
-        timestamp: Date.now(),
-        type: 'message',
-        source: { agent_id: 'sender' },
-        payload: {
-          content: 'Hello',
-          priority: 'high',
-          delivery_hint: 'inject',
-          correlation_id: 'corr_123',
-        },
-      };
-
-      const payload = getMessagePayload(event);
-      expect(payload).not.toBeUndefined();
-      expect(payload?.content).toBe('Hello');
-      expect(payload?.priority).toBe('high');
-      expect(payload?.delivery_hint).toBe('inject');
-      expect(payload?.correlation_id).toBe('corr_123');
-    });
-
-    it('should return undefined for non-message events', () => {
-      const event: Event = {
-        id: 'evt_1',
-        version: 1,
-        timestamp: Date.now(),
-        type: 'status',
-        source: { agent_id: 'agent' },
-        payload: { status_type: 'started', summary: 'Starting' },
-      };
-
-      const payload = getMessagePayload(event);
-      expect(payload).toBeUndefined();
-    });
-
-    it('should return undefined if payload is missing content', () => {
-      const event: Event = {
-        id: 'evt_1',
-        version: 1,
-        timestamp: Date.now(),
-        type: 'message',
-        source: { agent_id: 'sender' },
-        payload: { priority: 'high' }, // missing content
-      };
-
-      const payload = getMessagePayload(event);
-      expect(payload).toBeUndefined();
-    });
-  });
-
-  describe('getTargetAddress', () => {
-    it('should return MAP address when present', () => {
-      const target: EventTarget = {
-        agent_id: 'recipient',
-        address: { agent: 'recipient' },
-      };
-
-      const address = getTargetAddress(target);
-      expect(address).toEqual({ agent: 'recipient' });
-    });
-
-    it('should construct address from agent_id for legacy format', () => {
-      const target: EventTarget = {
-        agent_id: 'recipient',
-      };
-
-      const address = getTargetAddress(target);
-      expect(address).toEqual({ agent: 'recipient' });
-    });
-
-    it('should construct address from task_id for legacy format', () => {
-      const target: EventTarget = {
-        task_id: 'task_123',
-      };
-
-      const address = getTargetAddress(target);
-      expect(address).toEqual({ task: 'task_123' });
-    });
-
-    it('should construct address from topic for legacy format', () => {
-      const target: EventTarget = {
-        topic: 'updates',
-      };
-
-      const address = getTargetAddress(target);
-      expect(address).toEqual({ scope: 'updates' });
-    });
-
-    it('should construct broadcast address for scope="all"', () => {
-      const target: EventTarget = {
-        scope: 'all',
-      };
-
-      const address = getTargetAddress(target);
-      expect(address).toEqual({ broadcast: true });
-    });
-
-    it('should return undefined for empty target', () => {
-      const target: EventTarget = {};
-      const address = getTargetAddress(target);
-      expect(address).toBeUndefined();
-    });
-
-    it('should return undefined when target is undefined', () => {
-      const address = getTargetAddress(undefined);
-      expect(address).toBeUndefined();
-    });
-
-    it('should prioritize MAP address over legacy fields', () => {
-      const target: EventTarget = {
-        agent_id: 'legacy_recipient',
-        address: { broadcast: true },
-      };
-
-      const address = getTargetAddress(target);
-      expect(address).toEqual({ broadcast: true });
-    });
-  });
-});