@nt-ai-lab/deterministic-agent-workflow-event-store 0.2.1 → 0.3.1

package/dist/platform/domain/sqlite-event-store.d.ts

@@ -1,4 +1,4 @@
-import type { StoredEvent } from '@nt-ai-lab/deterministic-agent-workflow-engine';
+import type { RecordReflectionInput, StoredEvent, StoredReflection } from '@nt-ai-lab/deterministic-agent-workflow-engine';
 import { type SqliteDatabase } from '../infra/external-clients/sqlite/sqlite-runtime';
 /** @riviere-role value-object */
 export type SqliteEventStore = {
@@ -6,6 +6,8 @@ export type SqliteEventStore = {
     readonly appendEvents: (sessionId: string, events: readonly StoredEvent[]) => void;
     readonly sessionExists: (sessionId: string) => boolean;
     readonly hasSessionStarted: (sessionId: string) => boolean;
+    readonly recordReflection: (sessionId: string, createdAt: string, input: RecordReflectionInput) => StoredReflection;
+    readonly listReflections: (sessionId: string) => readonly StoredReflection[];
     readonly listSessions: () => readonly string[];
     readonly db: SqliteDatabase;
 };

package/dist/platform/domain/sqlite-event-store.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { stripEnvelopeKeys, WorkflowStateError, } from '@nt-ai-lab/deterministic-agent-workflow-engine';
+import { recordReflectionInputSchema, storedReflectionSchema, stripEnvelopeKeys, WorkflowStateError, } from '@nt-ai-lab/deterministic-agent-workflow-engine';
 import { enableWalMode, openSqliteDatabase, } from '../infra/external-clients/sqlite/sqlite-runtime.js';
 const createTableSql = `
   CREATE TABLE IF NOT EXISTS events (
@@ -11,6 +11,21 @@ const createTableSql = `
     payload TEXT NOT NULL
   )
 `;
+const createReflectionsTableSql = `
+  CREATE TABLE IF NOT EXISTS reflections (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id TEXT NOT NULL,
+    created_at TEXT NOT NULL,
+    label TEXT,
+    agent_name TEXT,
+    source_state TEXT,
+    payload_json TEXT NOT NULL
+  )
+`;
+const createReflectionsIndexSql = `
+  CREATE INDEX IF NOT EXISTS idx_reflections_session_created_at
+  ON reflections (session_id, created_at DESC, id DESC)
+`;
 const eventRowSchema = z.array(z.object({
     type: z.string(),
     at: z.string(),
@@ -21,11 +36,23 @@ const rowWithSessionIdSchema = z.array(z.object({ session_id: z.string() }));
 const countFieldSchema = z.union([z.number(), z.bigint(), z.string()]);
 const countRowSchema = z.object({ count: countFieldSchema });
 const tableInfoRowSchema = z.array(z.object({ name: z.string() }));
+const reflectionIdRowSchema = z.object({ id: countFieldSchema });
+const reflectionRowsSchema = z.array(z.object({
+    id: z.number(),
+    session_id: z.string(),
+    created_at: z.string(),
+    label: z.string().nullable(),
+    agent_name: z.string().nullable(),
+    source_state: z.string().nullable(),
+    payload_json: z.string(),
+}));
 /** @riviere-role domain-service */
 export function createStore(dbPath) {
     const db = openSqliteDatabase(dbPath);
     enableWalMode(db);
     db.exec(createTableSql);
+    db.exec(createReflectionsTableSql);
+    db.exec(createReflectionsIndexSql);
     ensureStateColumn(db);
     return {
         db,
@@ -56,6 +83,47 @@ export function createStore(dbPath) {
         hasSessionStarted(sessionId) {
             return readCount(db, "SELECT COUNT(1) AS count FROM events WHERE session_id = ? AND type = 'session-started'", sessionId) > 0;
         },
+        recordReflection(sessionId, createdAt, input) {
+            const parsedInput = recordReflectionInputSchema.parse(input);
+            const insert = db.prepare('INSERT INTO reflections (session_id, created_at, label, agent_name, source_state, payload_json) VALUES (?, ?, ?, ?, ?, ?)');
+            db.exec('BEGIN IMMEDIATE');
+            try {
+                insert.run(sessionId, createdAt, parsedInput.label ?? null, parsedInput.agentName ?? null, parsedInput.sourceState ?? null, JSON.stringify(parsedInput.reflection));
+                const rawId = db.prepare('SELECT last_insert_rowid() AS id').get();
+                const parsedId = reflectionIdRowSchema.parse(rawId);
+                const id = Number(parsedId.id);
+                db.exec('COMMIT');
+                return storedReflectionSchema.parse({
+                    id,
+                    sessionId,
+                    createdAt,
+                    ...(parsedInput.label === undefined ? {} : { label: parsedInput.label }),
+                    ...(parsedInput.agentName === undefined ? {} : { agentName: parsedInput.agentName }),
+                    ...(parsedInput.sourceState === undefined ? {} : { sourceState: parsedInput.sourceState }),
+                    reflection: parsedInput.reflection,
+                });
+            }
+            catch (error) {
+                db.exec('ROLLBACK');
+                throw error;
+            }
+        },
+        listReflections(sessionId) {
+            const rawRows = db.prepare('SELECT id, session_id, created_at, label, agent_name, source_state, payload_json FROM reflections WHERE session_id = ? ORDER BY created_at DESC, id DESC').all(sessionId);
+            const rows = reflectionRowsSchema.parse(rawRows);
+            return rows.map((row) => {
+                const reflectionPayload = JSON.parse(row.payload_json);
+                return storedReflectionSchema.parse({
+                    id: row.id,
+                    sessionId: row.session_id,
+                    createdAt: row.created_at,
+                    ...(row.label === null ? {} : { label: row.label }),
+                    ...(row.agent_name === null ? {} : { agentName: row.agent_name }),
+                    ...(row.source_state === null ? {} : { sourceState: row.source_state }),
+                    reflection: reflectionPayload,
+                });
+            });
+        },
         listSessions() {
             const rawRows = db.prepare('SELECT session_id FROM events GROUP BY session_id ORDER BY MIN(seq)').all();
             return rowWithSessionIdSchema.parse(rawRows).map((row) => row.session_id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nt-ai-lab/deterministic-agent-workflow-event-store",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "private": false,
   "type": "module",
   "exports": {
@@ -12,7 +12,7 @@
   ],
   "dependencies": {
     "zod": "^3.25.76",
-    "@nt-ai-lab/deterministic-agent-workflow-engine": "0.2.1"
+    "@nt-ai-lab/deterministic-agent-workflow-engine": "0.3.1"
   },
   "publishConfig": {
     "access": "public"