@roj-ai/sdk 0.1.1 → 0.1.4

package/dist/core/event-sourcing.integration.test.js

@@ -0,0 +1,154 @@
+import { describe, expect, it } from 'bun:test';
+import { agentEvents } from '../core/agents/state.js';
+import { MockLLMProvider } from '../core/llm/mock.js';
+import { llmEvents } from '../core/llm/state.js';
+import { applyEvent } from '../core/sessions/apply-event.js';
+import { reconstructSessionState } from '../core/sessions/state.js';
+import { ToolCallId } from '../core/tools/schema.js';
+import { toolEvents } from '../core/tools/state.js';
+import { createTestPreset, TestHarness } from '../testing/index.js';
+describe('core: event sourcing correctness', () => {
+    it('all events from a full flow persisted in event store in correct order', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+            llmProvider: MockLLMProvider.withSequence([
+                {
+                    toolCalls: [{ id: ToolCallId('tc1'), name: 'tell_user', input: { message: 'Hi!' } }],
+                },
+                { content: 'Done', toolCalls: [] },
+            ]),
+        });
+        const session = await harness.createSession('test');
+        await session.sendAndWaitForIdle('Hello');
+        const events = await session.getEvents();
+        // Should start with session_created
+        expect(events[0].type).toBe('session_created');
+        // Extract event types in order
+        const types = events.map((e) => e.type);
+        // session_created must come first
+        expect(types.indexOf('session_created')).toBe(0);
+        // agent_spawned after session_created
+        expect(types.indexOf('agent_spawned')).toBeGreaterThan(types.indexOf('session_created'));
+        // inference_started before inference_completed
+        const inferStartIdx = types.indexOf('inference_started');
+        const inferCompleteIdx = types.indexOf('inference_completed');
+        expect(inferStartIdx).toBeGreaterThan(-1);
+        expect(inferCompleteIdx).toBeGreaterThan(inferStartIdx);
+        // tool_started before tool_completed
+        const toolStartIdx = types.indexOf('tool_started');
+        const toolCompleteIdx = types.indexOf('tool_completed');
+        expect(toolStartIdx).toBeGreaterThan(-1);
+        expect(toolCompleteIdx).toBeGreaterThan(toolStartIdx);
+        // tool events between first and second inference cycles
+        expect(toolStartIdx).toBeGreaterThan(inferCompleteIdx);
+        await harness.shutdown();
+    });
+    it('session state after replay matches live state', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+            llmProvider: MockLLMProvider.withSequence([
+                {
+                    toolCalls: [{ id: ToolCallId('tc1'), name: 'tell_user', input: { message: 'Hi!' } }],
+                },
+                { content: 'Done', toolCalls: [] },
+            ]),
+        });
+        const session = await harness.createSession('test');
+        await session.sendAndWaitForIdle('Hello');
+        const liveState = session.state;
+        const events = await session.getEvents();
+        // Replay state from events using the base reducer (core + mailbox)
+        const replayedState = reconstructSessionState(events, applyEvent);
+        expect(replayedState).not.toBeNull();
+        expect(replayedState.id).toEqual(liveState.id);
+        expect(replayedState.presetId).toBe(liveState.presetId);
+        expect(replayedState.status).toBe(liveState.status);
+        expect(replayedState.agents.size).toBe(liveState.agents.size);
+        // Verify each agent's status matches
+        for (const [agentId, liveAgent] of liveState.agents) {
+            const replayedAgent = replayedState.agents.get(agentId);
+            expect(replayedAgent).toBeDefined();
+            expect(replayedAgent.status).toBe(liveAgent.status);
+            expect(replayedAgent.definitionName).toBe(liveAgent.definitionName);
+            expect(replayedAgent.conversationHistory.length).toBe(liveAgent.conversationHistory.length);
+        }
+        await harness.shutdown();
+    });
+    it('event types include expected core events from a full flow', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+            llmProvider: MockLLMProvider.withSequence([
+                {
+                    toolCalls: [{ id: ToolCallId('tc1'), name: 'tell_user', input: { message: 'Hi!' } }],
+                },
+                { content: 'Done', toolCalls: [] },
+            ]),
+        });
+        const session = await harness.createSession('test');
+        await session.sendAndWaitForIdle('Hello');
+        const events = await session.getEvents();
+        const eventTypes = new Set(events.map((e) => e.type));
+        // Core lifecycle events
+        expect(eventTypes.has('session_created')).toBe(true);
+        expect(eventTypes.has('agent_spawned')).toBe(true);
+        // LLM events
+        expect(eventTypes.has('inference_started')).toBe(true);
+        expect(eventTypes.has('inference_completed')).toBe(true);
+        // Tool events
+        expect(eventTypes.has('tool_started')).toBe(true);
+        expect(eventTypes.has('tool_completed')).toBe(true);
+        // User chat events
+        expect(eventTypes.has('user_chat_message_received')).toBe(true);
+        await harness.shutdown();
+    });
+    it('event timestamps are monotonically increasing', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+            llmProvider: MockLLMProvider.withSequence([
+                {
+                    toolCalls: [{ id: ToolCallId('tc1'), name: 'tell_user', input: { message: 'Hi!' } }],
+                },
+                { content: 'Done', toolCalls: [] },
+            ]),
+        });
+        const session = await harness.createSession('test');
+        await session.sendAndWaitForIdle('Hello');
+        const events = await session.getEvents();
+        for (let i = 1; i < events.length; i++) {
+            expect(events[i].timestamp).toBeGreaterThanOrEqual(events[i - 1].timestamp);
+        }
+        await harness.shutdown();
+    });
+    it('events have correct agentId references', async () => {
+        const harness = new TestHarness({
+            presets: [createTestPreset()],
+            llmProvider: MockLLMProvider.withSequence([
+                {
+                    toolCalls: [{ id: ToolCallId('tc1'), name: 'tell_user', input: { message: 'Hi!' } }],
+                },
+                { content: 'Done', toolCalls: [] },
+            ]),
+        });
+        const session = await harness.createSession('test');
+        await session.sendAndWaitForIdle('Hello');
+        const entryAgentId = session.getEntryAgentId();
+        // All agent-scoped events should reference the entry agent
+        const inferenceStarted = await session.getEventsByType(llmEvents, 'inference_started');
+        const inferenceCompleted = await session.getEventsByType(llmEvents, 'inference_completed');
+        const toolStarted = await session.getEventsByType(toolEvents, 'tool_started');
+        const toolCompleted = await session.getEventsByType(toolEvents, 'tool_completed');
+        const agentScopedEvents = [...inferenceStarted, ...inferenceCompleted, ...toolStarted, ...toolCompleted];
+        expect(agentScopedEvents.length).toBeGreaterThan(0);
+        for (const event of agentScopedEvents) {
+            expect(event.agentId).toBe(entryAgentId);
+        }
+        // agent_spawned should also reference the correct agent
+        const spawnedEvents = await session.getEventsByType(agentEvents, 'agent_spawned');
+        expect(spawnedEvents.length).toBeGreaterThan(0);
+        for (const e of spawnedEvents) {
+            expect(session.state.agents.has(e.agentId)).toBe(true);
+        }
+        await harness.shutdown();
+    });
+});
+//# sourceMappingURL=event-sourcing.integration.test.js.map

package/dist/core/event-sourcing.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-sourcing.integration.test.js","sourceRoot":"","sources":["../../src/core/event-sourcing.integration.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAElE,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IACjD,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;YAC/B,OAAO,EAAE,CAAC,gBAAgB,EAAE,CAAC;YAC7B,WAAW,EAAE,eAAe,CAAC,YAAY,CAAC;gBACzC;oBACC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;iBACpF;gBACD,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;aAClC,CAAC;SACF,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QACnD,MAAM,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;QAEzC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAA;QAExC,oCAAoC;QACpC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAE9C,+BAA+B;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAEvC,kCAAkC;QAClC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAEhD,sCAAsC;QACtC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAA;QAExF,+CAA+C;QAC/C,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAA;QACxD,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAA;QAC7D,MAAM,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;QACzC,MAAM,CAAC,gBAAgB,CAAC,CAAC,eAAe,CAAC,aAAa,CAAC,CAAA;QAEvD,qCAAqC;QACrC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;QAClD,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;QACvD,MAAM,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;QACxC,MAAM,CAAC,eAAe,CAAC,CAAC,eAAe,CAAC,YAAY,CAAC,CAAA;QAErD,wDAAwD;QACxD,MAAM,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAA;QAEtD,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;IACzB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;YAC/B,OAAO,EAAE,CAAC,gBAAgB,EAAE,CAAC;YAC7B,WAAW,EAAE,eAAe,CAAC,YAAY,CAAC;gBACzC;oBACC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;iBACpF;gBACD,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;aAClC,CAAC;SACF,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QACnD,MAAM,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;QAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAA;QAC/B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAA;QAExC,mEAAmE;QACnE,MAAM,aAAa,GAAG,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;QAEjE,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QACpC,MAAM,CAAC,aAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;QAC/C,MAAM,CAAC,aAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACxD,MAAM,CAAC,aAAc,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACpD,MAAM,CAAC,aAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAE9D,qCAAqC;QACrC,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YACrD,MAAM,aAAa,GAAG,aAAc,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACxD,MAAM,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAA;YACnC,MAAM,CAAC,aAAc,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;YACpD,MAAM,CAAC,aAAc,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;YACpE,MAAM,CAAC,aAAc,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAA;QAC7F,CAAC;QAED,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;IACzB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;YAC/B,OAAO,EAAE,CAAC,gBAAgB,EAAE,CAAC;YAC7B,WAAW,EAAE,eAAe,CAAC,YAAY,CAAC;gBACzC;oBACC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;iBACpF;gBACD,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;aAClC,CAAC;SACF,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QACnD,MAAM,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;QAEzC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAA;QACxC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QAErD,wBAAwB;QACxB,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpD,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAElD,aAAa;QACb,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACtD,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAExD,cAAc;QACd,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjD,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEnD,mBAAmB;QACnB,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAE/D,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;IACzB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;YAC/B,OAAO,EAAE,CAAC,gBAAgB,EAAE,CAAC;YAC7B,WAAW,EAAE,eAAe,CAAC,YAAY,CAAC;gBACzC;oBACC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;iBACpF;gBACD,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;aAClC,CAAC;SACF,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QACnD,MAAM,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;QAEzC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAA;QAExC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QAC5E,CAAC;QAED,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;IACzB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;YAC/B,OAAO,EAAE,CAAC,gBAAgB,EAAE,CAAC;YAC7B,WAAW,EAAE,eAAe,CAAC,YAAY,CAAC;gBACzC;oBACC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;iBACpF;gBACD,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;aAClC,CAAC;SACF,CAAC,CAAA;QAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QACnD,MAAM,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;QAEzC,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,EAAG,CAAA;QAE/C,2DAA2D;QAC3D,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAA;QACtF,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAA;QAC1F,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;QAC7E,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAA;QACjF,MAAM,iBAAiB,GAAG,CAAC,GAAG,gBAAgB,EAAE,GAAG,kBAAkB,EAAE,GAAG,WAAW,EAAE,GAAG,aAAa,CAAC,CAAA;QAExG,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;QACnD,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;YACvC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QACzC,CAAC;QAED,wDAAwD;QACxD,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,WAAW,EAAE,eAAe,CAAC,CAAA;QACjF,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;QAC/C,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;YAC/B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvD,CAAC;QAED,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;IACzB,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/core/events/base-event-store.js

@@ -0,0 +1,201 @@
+import { EventStoreError } from './event-store.js';
+import { computeMetadataFromEvents, needsReconciliation } from './metadata-utils.js';
+/**
+ * Event types that must never be emitted on a closed session.
+ * See guardWriteToClosed for rationale.
+ */
+function isForbiddenOnClosed(event) {
+    return event.type === 'session_handler_started' || event.type === 'session_handler_completed';
+}
+/**
+ * Abstract base class for EventStore implementations.
+ *
+ * Provides shared logic for metadata processing, filtering/sorting/pagination,
+ * and reconciliation. Subclasses only implement storage primitives.
+ */
+export class BaseEventStore {
+    // === Public append API (with closed-session guard) ===
+    async append(sessionId, event) {
+        if (isForbiddenOnClosed(event)) {
+            await this.guardWriteToClosed(sessionId, [event]);
+        }
+        await this.doAppend(sessionId, event);
+    }
+    async appendBatch(sessionId, events) {
+        if (events.length === 0)
+            return;
+        if (events.some(isForbiddenOnClosed)) {
+            await this.guardWriteToClosed(sessionId, events);
+        }
+        await this.doAppendBatch(sessionId, events);
+    }
+    // === Shared implementations ===
+    async getMetadata(sessionId) {
+        return this.readMetadata(sessionId);
+    }
+    async updateMetadata(sessionId, update) {
+        const existing = await this.readMetadata(sessionId);
+        const metadata = {
+            ...existing,
+            ...update,
+            sessionId,
+            lastActivityAt: update.lastActivityAt ?? Date.now(),
+        };
+        await this.writeMetadata(sessionId, metadata);
+    }
+    async listSessionsWithMetadata(options) {
+        let sessions = await this.getAllSessionMetadata();
+        // Filter by status
+        if (options?.status) {
+            sessions = sessions.filter((s) => s.status === options.status);
+        }
+        // Filter by tags
+        if (options?.tags && options.tags.length > 0) {
+            sessions = sessions.filter((s) => options.tags.every((tag) => s.tags?.includes(tag)));
+        }
+        const total = sessions.length;
+        // Sort
+        const orderBy = options?.orderBy ?? 'createdAt';
+        const order = options?.order ?? 'desc';
+        sessions.sort((a, b) => {
+            const aVal = a[orderBy] ?? 0;
+            const bVal = b[orderBy] ?? 0;
+            return order === 'asc' ? aVal - bVal : bVal - aVal;
+        });
+        // Pagination
+        const offset = options?.offset ?? 0;
+        const limit = options?.limit ?? sessions.length;
+        sessions = sessions.slice(offset, offset + limit);
+        return { sessions, total };
+    }
+    async reconcileMetadata(sessionId, events) {
+        if (events.length === 0)
+            return false;
+        const computed = computeMetadataFromEvents(sessionId, events);
+        if (!computed)
+            return false;
+        const stored = await this.readMetadata(sessionId);
+        if (!needsReconciliation(stored, computed)) {
+            return false;
+        }
+        // Metadata is out of sync - update with computed values
+        // Preserve name, tags, and custom data from stored metadata
+        const reconciled = {
+            ...computed,
+            name: stored?.name,
+            tags: stored?.tags,
+            custom: stored?.custom,
+        };
+        await this.writeMetadata(sessionId, reconciled);
+        return true;
+    }
+    /**
+     * Update metadata incrementally from events.
+     * Aggregates all metric deltas and writes once.
+     */
+    async updateMetadataFromEvents(sessionId, events) {
+        if (events.length === 0)
+            return;
+        const metadata = await this.readMetadata(sessionId);
+        // Start with current metrics or defaults
+        let metrics = metadata?.metrics ?? {
+            totalEvents: 0,
+            totalAgents: 0,
+            totalTokens: 0,
+            totalLLMCalls: 0,
+            inputTokens: 0,
+            outputTokens: 0,
+            totalCost: 0,
+            totalMessages: 0,
+            totalToolCalls: 0,
+        };
+        const update = {};
+        // Process all events and aggregate metrics
+        for (const event of events) {
+            update.lastActivityAt = event.timestamp;
+            switch (event.type) {
+                case 'session_created':
+                    update.createdAt = event.timestamp;
+                    update.presetId = event.presetId;
+                    update.status = 'active';
+                    metrics = {
+                        totalEvents: 1,
+                        totalAgents: 0,
+                        totalTokens: 0,
+                        totalLLMCalls: 0,
+                        inputTokens: 0,
+                        outputTokens: 0,
+                        totalCost: 0,
+                        totalMessages: 0,
+                        totalToolCalls: 0,
+                    };
+                    break;
+                case 'session_closed':
+                    update.status = 'closed';
+                    metrics.totalEvents += 1;
+                    break;
+                case 'session_reopened':
+                    update.status = 'active';
+                    metrics.totalEvents += 1;
+                    break;
+                case 'agent_spawned':
+                    metrics.totalAgents += 1;
+                    metrics.totalEvents += 1;
+                    break;
+                case 'inference_completed':
+                    if (event.metrics) {
+                        metrics.totalTokens += event.metrics.totalTokens ?? 0;
+                        metrics.inputTokens = (metrics.inputTokens ?? 0) + (event.metrics.promptTokens ?? 0);
+                        metrics.outputTokens = (metrics.outputTokens ?? 0) + (event.metrics.completionTokens ?? 0);
+                        metrics.totalCost = (metrics.totalCost ?? 0) + (event.metrics.cost ?? 0);
+                        metrics.totalLLMCalls += 1;
+                    }
+                    metrics.totalEvents += 1;
+                    break;
+                case 'mailbox_message':
+                    metrics.totalMessages = (metrics.totalMessages ?? 0) + 1;
+                    metrics.totalEvents += 1;
+                    break;
+                case 'tool_started':
+                    metrics.totalToolCalls = (metrics.totalToolCalls ?? 0) + 1;
+                    metrics.totalEvents += 1;
+                    break;
+                default:
+                    metrics.totalEvents += 1;
+            }
+        }
+        update.metrics = metrics;
+        await this.updateMetadata(sessionId, update);
+    }
+    /**
+     * Reject session-level hook events on closed sessions.
+     *
+     * Closed sessions must be prevented from re-running session-level plugin hooks
+     * (the `session_handler_*` events) because those hooks have no place operating
+     * on an immutable artifact — and when they do, every read / restart of the closed
+     * session appends two events, which is how we observed 7866 handler_started events
+     * on a single closed session over 4.9 days in production.
+     *
+     * Other event types are deliberately allowed even after session_closed:
+     *   - in-flight agent events (inference_*, tool_*) finishing after close
+     *   - mailbox_message deliveries racing close
+     *   - service_status_changed from cleanup hooks stopping services
+     *
+     * The invariant we guard is narrow: "session-level plugin hooks never emit on
+     * closed sessions." See the loadSession / skipReadyHooks path in session-manager
+     * for the primary fix; this is the storage-boundary backup that catches any
+     * future code path that somehow slips through.
+     */
+    async guardWriteToClosed(sessionId, events) {
+        const forbidden = events.filter(isForbiddenOnClosed);
+        if (forbidden.length === 0)
+            return;
+        const metadata = await this.readMetadata(sessionId);
+        if (metadata?.status !== 'closed')
+            return;
+        const forbiddenTypes = forbidden.map((e) => e.type).join(', ');
+        throw new EventStoreError(`Refusing to append session-level hook event(s) to closed session ${sessionId} (types: ${forbiddenTypes}). `
+            + `Closed sessions must not re-run plugin session hooks — see session-manager.ts:loadSession closed branch.`, sessionId);
+    }
+}
+//# sourceMappingURL=base-event-store.js.map

package/dist/core/events/base-event-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-event-store.js","sourceRoot":"","sources":["../../../src/core/events/base-event-store.ts"],"names":[],"mappings":"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"}

package/dist/core/events/event-store.js

@@ -0,0 +1,26 @@
+/**
+ * Error types pro EventStore
+ */
+export class EventStoreError extends Error {
+    sessionId;
+    cause;
+    constructor(message, sessionId, cause) {
+        super(message);
+        this.sessionId = sessionId;
+        this.cause = cause;
+        this.name = 'EventStoreError';
+    }
+}
+export class SessionNotFoundError extends EventStoreError {
+    constructor(sessionId) {
+        super(`Session not found: ${sessionId}`, sessionId);
+        this.name = 'SessionNotFoundError';
+    }
+}
+export class EventAppendError extends EventStoreError {
+    constructor(sessionId, cause) {
+        super(`Failed to append event to session: ${sessionId}`, sessionId, cause);
+        this.name = 'EventAppendError';
+    }
+}
+//# sourceMappingURL=event-store.js.map

package/dist/core/events/event-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.js","sourceRoot":"","sources":["../../../src/core/events/event-store.ts"],"names":[],"mappings":"AAoHA;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAGxB;IACA;IAHjB,YACC,OAAe,EACC,SAAoB,EACpB,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,cAAS,GAAT,SAAS,CAAW;QACpB,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC9B,CAAC;CACD;AAED,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IACxD,YAAY,SAAoB;QAC/B,KAAK,CAAC,sBAAsB,SAAS,EAAE,EAAE,SAAS,CAAC,CAAA;QACnD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACnC,CAAC;CACD;AAED,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IACpD,YAAY,SAAoB,EAAE,KAAe;QAChD,KAAK,CAAC,sCAAsC,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAA;QAC1E,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAC/B,CAAC;CACD"}