pi-harness-runtime 0.9.19 → 0.9.21

package/packages/event-bus/src/index.ts

@@ -0,0 +1,9 @@
+export { EventBus } from "./bus.js";
+export { EventBusError } from "./types.js";
+export type {
+	Topic,
+	EventPayload,
+	Subscriber,
+	Subscription,
+	BusOptions,
+} from "./types.js";

package/packages/event-bus/src/types.ts

@@ -0,0 +1,59 @@
+/**
+ * Event Bus — Types
+ */
+
+export type Topic =
+	| "session.message"
+	| "session.assistant_start"
+	| "session.assistant_end"
+	| "session.tool_start"
+	| "session.tool_end"
+	| "session.checkpoint"
+	| "session.compact"
+	| "task.assigned"
+	| "task.started"
+	| "task.completed"
+	| "task.failed"
+	| "review.requested"
+	| "review.completed"
+	| "decision.made"
+	| "approval.requested"
+	| "approval.granted"
+	| "workflow.started"
+	| "workflow.finished"
+	| "knowledge.extracted"
+	| "system.quota_exceeded"
+	| "system.checkpoint_saved"
+	| "system.error";
+
+export interface EventPayload<T = unknown> {
+	topic: string;
+	data: T;
+	timestamp: string;
+	eventId: string;
+	source: string;
+}
+
+export type Subscriber<T = unknown> = (
+	payload: EventPayload<T>,
+) => void | Promise<void>;
+
+export interface Subscription {
+	id: string;
+	topic: string;
+	subscriber: Subscriber<unknown>;
+	filter?: (data: unknown) => boolean;
+	priority: number;
+	active: boolean;
+}
+
+export interface BusOptions {
+	deliveryGuarantee?: "at_least_once" | "at_most_once" | "exactly_once";
+}
+
+export class EventBusError extends Error {
+	constructor(message: string) {
+		super(message);
+		this.name = "EventBusError";
+	}
+}

package/packages/event-bus/test/bus.test.ts

@@ -0,0 +1,88 @@
+import { describe, it } from "node:test";
+import { equal, deepEqual } from "node:assert";
+import { EventBus } from "../src/bus.js";
+
+describe("EventBus", () => {
+	const bus = new EventBus();
+
+	it("publish returns eventId", () => {
+		const id = bus.publish("test.topic", { msg: "hello" });
+		equal(typeof id, "string");
+		equal(id.length > 0, true);
+	});
+
+	it("subscriber receives event", () => {
+		let received: unknown = null;
+		bus.subscribe("test.1", (p) => {
+			received = p;
+		});
+		bus.publish("test.1", { data: "hello" });
+		equal((received as { data: string }).data, "hello");
+	});
+
+	it("multiple subscribers all called", () => {
+		const calls: number[] = [];
+		bus.subscribe("test.2", () => {
+			calls.push(1);
+		});
+		bus.subscribe("test.2", () => {
+			calls.push(2);
+		});
+		bus.publish("test.2", { x: 1 });
+		deepEqual(calls, [1, 2]);
+	});
+
+	it("unsubscribe stops notifications", () => {
+		let called = false;
+		const id = bus.subscribe("test.3", () => {
+			called = true;
+		});
+		bus.unsubscribe(id);
+		bus.publish("test.3", {});
+		equal(called, false);
+	});
+
+	it("filter predicates work", () => {
+		let called = false;
+		bus.subscribe(
+			"test.4",
+			() => {
+				called = true;
+			},
+			(d) => (d as { ok: boolean }).ok === true,
+		);
+		bus.publish("test.4", { ok: false });
+		equal(called, false);
+		bus.publish("test.4", { ok: true });
+		equal(called, true);
+	});
+
+	it("priority ordering respected", () => {
+		const order: number[] = [];
+		bus.subscribe(
+			"test.5",
+			() => {
+				order.push(1);
+			},
+			undefined,
+			1,
+		);
+		bus.subscribe(
+			"test.5",
+			() => {
+				order.push(2);
+			},
+			undefined,
+			2,
+		);
+		bus.publish("test.5", {});
+		deepEqual(order, [2, 1]); // higher priority first
+	});
+
+	it("unsubscribeAll(topic) removes all for topic", () => {
+		bus.subscribe("test.6", () => {});
+		bus.subscribe("test.6", () => {});
+		bus.unsubscribeAll("test.6");
+		equal(bus.getSubscribers("test.6").length, 0);
+	});
+});

package/packages/event-bus/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": ".",
+    "types": ["node"],
+    "lib": ["ES2022"]
+  },
+  "include": ["src/**/*"]
+}

package/packages/event-store/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { EventStore } from "./store.js";
+export type { SessionEvent, SessionEventType, EventMetadata, StoreOptions, StoreStats, WriteResult, ReadOptions, SearchOptions } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/event-store/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/packages/event-store/dist/index.js

@@ -0,0 +1,2 @@
+export { EventStore } from "./store.js";
+//# sourceMappingURL=index.js.map

package/packages/event-store/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/packages/event-store/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+export { EventStore } from "./store.js";
+export type { SessionEvent, SessionEventType, EventMetadata, StoreOptions, StoreStats, WriteResult, ReadOptions, SearchOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/event-store/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EACX,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,WAAW,EACX,WAAW,EACX,aAAa,GACb,MAAM,YAAY,CAAC"}

package/packages/event-store/dist/src/index.js

@@ -0,0 +1,2 @@
+export { EventStore } from "./store.js";
+//# sourceMappingURL=index.js.map

package/packages/event-store/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/packages/event-store/dist/src/store.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Event Store — JSONL-backed immutable event store
+ */
+import type { SessionEvent, WriteResult, ReadOptions, SearchOptions, StoreOptions, StoreStats } from "./types.js";
+export declare class EventStore {
+    private readonly sessionsDir;
+    constructor(opts?: StoreOptions);
+    getPath(sessionId: string): string;
+    append(event: Omit<SessionEvent, "id" | "timestamp">): Promise<WriteResult>;
+    read(opts?: ReadOptions): Promise<SessionEvent[]>;
+    search(opts: SearchOptions): Promise<SessionEvent[]>;
+    stats(sessionId: string): StoreStats;
+    list(): string[];
+}
+//# sourceMappingURL=store.d.ts.map

package/packages/event-store/dist/src/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,OAAO,KAAK,EACX,YAAY,EAEZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,EACV,MAAM,YAAY,CAAC;AAEpB,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,YAAY,IAAI,GAAE,YAAiB,EAKlC;IAED,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjC;IAEK,MAAM,CACX,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,WAAW,CAAC,GAC3C,OAAO,CAAC,WAAW,CAAC,CAUtB;IAEK,IAAI,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA8C1D;IAEK,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAiCzD;IAED,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAiBnC;IAED,IAAI,IAAI,MAAM,EAAE,CASf;CACD"}

package/packages/event-store/dist/src/store.js

@@ -0,0 +1,139 @@
+/**
+ * Event Store — JSONL-backed immutable event store
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, createReadStream, } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { randomUUID } from "node:crypto";
+export class EventStore {
+    sessionsDir;
+    constructor(opts = {}) {
+        this.sessionsDir = opts.sessionsDir ?? join(homedir(), ".pi", "sessions");
+        if (!existsSync(this.sessionsDir)) {
+            mkdirSync(this.sessionsDir, { recursive: true });
+        }
+    }
+    getPath(sessionId) {
+        return join(this.sessionsDir, `${sessionId}.jsonl`);
+    }
+    async append(event) {
+        const id = randomUUID();
+        const timestamp = new Date().toISOString();
+        const full = { ...event, id, timestamp };
+        const line = JSON.stringify(full) + "\n";
+        const path = this.getPath(full.sessionId);
+        const dir = dirname(path);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        appendFileSync(path, line, "utf8");
+        return { id, timestamp, bytesWritten: Buffer.byteLength(line, "utf8") };
+    }
+    async read(opts = {}) {
+        const events = [];
+        const limit = opts.limit ?? Infinity;
+        const offset = opts.offset ?? 0;
+        let skipped = 0;
+        const sessionIds = opts.sessionId ? [opts.sessionId] : this.list();
+        for (const sid of sessionIds) {
+            const path = this.getPath(sid);
+            if (!existsSync(path))
+                continue;
+            const stream = createReadStream(path, {
+                encoding: "utf8",
+                highWaterMark: 64 * 1024,
+            });
+            let buffer = "";
+            for await (const chunk of stream) {
+                buffer += chunk;
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    try {
+                        const evt = JSON.parse(line);
+                        if (opts.since && evt.timestamp <= opts.since)
+                            continue;
+                        if (opts.types && !opts.types.includes(evt.type))
+                            continue;
+                        if (skipped < offset) {
+                            skipped++;
+                            continue;
+                        }
+                        events.push(evt);
+                        if (events.length >= limit) {
+                            stream.destroy();
+                            return events;
+                        }
+                    }
+                    catch {
+                        // skip corrupt lines
+                    }
+                }
+            }
+        }
+        return events;
+    }
+    async search(opts) {
+        const events = [];
+        const limit = opts.limit ?? 100;
+        const query = opts.query.toLowerCase();
+        const sessionIds = opts.sessionId ? [opts.sessionId] : this.list();
+        for (const sid of sessionIds) {
+            const path = this.getPath(sid);
+            if (!existsSync(path))
+                continue;
+            const stream = createReadStream(path, { encoding: "utf8" });
+            for await (const chunk of stream) {
+                const lines = String(chunk).split("\n");
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    try {
+                        const evt = JSON.parse(line);
+                        if (evt.content?.toLowerCase().includes(query)) {
+                            events.push(evt);
+                            if (events.length >= limit) {
+                                stream.destroy();
+                                return events;
+                            }
+                        }
+                    }
+                    catch {
+                        // skip
+                    }
+                }
+            }
+        }
+        return events;
+    }
+    stats(sessionId) {
+        const path = this.getPath(sessionId);
+        if (!existsSync(path)) {
+            return { sessionId, totalEvents: 0, sizeBytes: 0, lastEventAt: null };
+        }
+        const st = statSync(path);
+        const events = readFileSync(path, "utf8").split("\n").filter(Boolean);
+        const last = events.length > 0
+            ? JSON.parse(events[events.length - 1]).timestamp
+            : null;
+        return {
+            sessionId,
+            totalEvents: events.length,
+            sizeBytes: st.size,
+            lastEventAt: last,
+        };
+    }
+    list() {
+        try {
+            const { readdirSync } = require("node:fs");
+            return readdirSync(this.sessionsDir)
+                .filter((f) => f.endsWith(".jsonl"))
+                .map((f) => f.replace(".jsonl", ""));
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=store.js.map

package/packages/event-store/dist/src/store.js.map

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

package/packages/event-store/dist/src/types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Event Store — Types
+ */
+export type SessionEventType = "message" | "tool_start" | "tool_end" | "tool_error" | "assistant_start" | "assistant_end" | "session_start" | "session_end" | "checkpoint" | "compact";
+export interface EventMetadata {
+    model?: string;
+    provider?: string;
+    tokens?: number;
+    durationMs?: number;
+}
+export interface SessionEvent {
+    id: string;
+    sessionId: string;
+    timestamp: string;
+    type: SessionEventType;
+    role?: "user" | "assistant" | "system";
+    content?: string;
+    tool?: string;
+    error?: string;
+    metadata?: EventMetadata;
+}
+export interface StoreOptions {
+    sessionsDir?: string;
+}
+export interface StoreStats {
+    sessionId: string;
+    totalEvents: number;
+    sizeBytes: number;
+    lastEventAt: string | null;
+}
+export interface WriteResult {
+    id: string;
+    timestamp: string;
+    bytesWritten: number;
+}
+export interface ReadOptions {
+    sessionId?: string;
+    since?: string;
+    types?: SessionEventType[];
+    limit?: number;
+    offset?: number;
+}
+export interface SearchOptions {
+    sessionId?: string;
+    query: string;
+    limit?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/event-store/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,gBAAgB,GACzB,SAAS,GACT,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,iBAAiB,GACjB,eAAe,GACf,eAAe,GACf,aAAa,GACb,YAAY,GACZ,SAAS,CAAC;AAEb,MAAM,WAAW,aAAa;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CACf"}

package/packages/event-store/dist/src/types.js

@@ -0,0 +1,5 @@
+/**
+ * Event Store — Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/event-store/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/packages/event-store/dist/store.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Event Store — JSONL-backed immutable event store
+ */
+import type { SessionEvent, WriteResult, ReadOptions, SearchOptions, StoreOptions, StoreStats } from "./types.js";
+export declare class EventStore {
+    private readonly sessionsDir;
+    constructor(opts?: StoreOptions);
+    getPath(sessionId: string): string;
+    append(event: Omit<SessionEvent, "id" | "timestamp">): Promise<WriteResult>;
+    read(opts?: ReadOptions): Promise<SessionEvent[]>;
+    search(opts: SearchOptions): Promise<SessionEvent[]>;
+    stats(sessionId: string): StoreStats;
+    list(): string[];
+}
+//# sourceMappingURL=store.d.ts.map

package/packages/event-store/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EACX,YAAY,EAEZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,EACV,MAAM,YAAY,CAAC;AAEpB,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,YAAY,IAAI,GAAE,YAAiB,EAKlC;IAED,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjC;IAEK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAUhF;IAEK,IAAI,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAwC1D;IAEK,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA8BzD;IAED,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAWnC;IAED,IAAI,IAAI,MAAM,EAAE,CASf;CACD"}

package/packages/event-store/dist/store.js

@@ -0,0 +1,131 @@
+/**
+ * Event Store — JSONL-backed immutable event store
+ */
+import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, createReadStream } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { randomUUID } from "node:crypto";
+export class EventStore {
+    sessionsDir;
+    constructor(opts = {}) {
+        this.sessionsDir = opts.sessionsDir ?? join(homedir(), ".pi", "sessions");
+        if (!existsSync(this.sessionsDir)) {
+            mkdirSync(this.sessionsDir, { recursive: true });
+        }
+    }
+    getPath(sessionId) {
+        return join(this.sessionsDir, `${sessionId}.jsonl`);
+    }
+    async append(event) {
+        const id = randomUUID();
+        const timestamp = new Date().toISOString();
+        const full = { ...event, id, timestamp };
+        const line = JSON.stringify(full) + "\n";
+        const path = this.getPath(full.sessionId);
+        const dir = dirname(path);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        appendFileSync(path, line, "utf8");
+        return { id, timestamp, bytesWritten: Buffer.byteLength(line, "utf8") };
+    }
+    async read(opts = {}) {
+        const events = [];
+        const limit = opts.limit ?? Infinity;
+        const offset = opts.offset ?? 0;
+        let skipped = 0;
+        const sessionIds = opts.sessionId ? [opts.sessionId] : this.list();
+        for (const sid of sessionIds) {
+            const path = this.getPath(sid);
+            if (!existsSync(path))
+                continue;
+            const stream = createReadStream(path, { encoding: "utf8", highWaterMark: 64 * 1024 });
+            let buffer = "";
+            for await (const chunk of stream) {
+                buffer += chunk;
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    try {
+                        const evt = JSON.parse(line);
+                        if (opts.since && evt.timestamp <= opts.since)
+                            continue;
+                        if (opts.types && !opts.types.includes(evt.type))
+                            continue;
+                        if (skipped < offset) {
+                            skipped++;
+                            continue;
+                        }
+                        events.push(evt);
+                        if (events.length >= limit) {
+                            stream.destroy();
+                            return events;
+                        }
+                    }
+                    catch {
+                        // skip corrupt lines
+                    }
+                }
+            }
+        }
+        return events;
+    }
+    async search(opts) {
+        const events = [];
+        const limit = opts.limit ?? 100;
+        const query = opts.query.toLowerCase();
+        const sessionIds = opts.sessionId ? [opts.sessionId] : this.list();
+        for (const sid of sessionIds) {
+            const path = this.getPath(sid);
+            if (!existsSync(path))
+                continue;
+            const stream = createReadStream(path, { encoding: "utf8" });
+            for await (const chunk of stream) {
+                const lines = String(chunk).split("\n");
+                for (const line of lines) {
+                    if (!line.trim())
+                        continue;
+                    try {
+                        const evt = JSON.parse(line);
+                        if (evt.content?.toLowerCase().includes(query)) {
+                            events.push(evt);
+                            if (events.length >= limit) {
+                                stream.destroy();
+                                return events;
+                            }
+                        }
+                    }
+                    catch {
+                        // skip
+                    }
+                }
+            }
+        }
+        return events;
+    }
+    stats(sessionId) {
+        const path = this.getPath(sessionId);
+        if (!existsSync(path)) {
+            return { sessionId, totalEvents: 0, sizeBytes: 0, lastEventAt: null };
+        }
+        const st = statSync(path);
+        const events = readFileSync(path, "utf8").split("\n").filter(Boolean);
+        const last = events.length > 0
+            ? JSON.parse(events[events.length - 1]).timestamp
+            : null;
+        return { sessionId, totalEvents: events.length, sizeBytes: st.size, lastEventAt: last };
+    }
+    list() {
+        try {
+            const { readdirSync } = require("node:fs");
+            return readdirSync(this.sessionsDir)
+                .filter((f) => f.endsWith(".jsonl"))
+                .map((f) => f.replace(".jsonl", ""));
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=store.js.map

package/packages/event-store/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAqB,MAAM,SAAS,CAAC;AAC7H,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAYzC,MAAM,OAAO,UAAU;IACL,WAAW,CAAS;IAErC,YAAY,IAAI,GAAiB,EAAE;QAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QAC1E,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;IACF,CAAC;IAED,OAAO,CAAC,SAAiB;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,SAAS,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAA6C;QACzD,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAiB,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACnC,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAI,GAAgB,EAAE;QAChC,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QAChC,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAEnE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,SAAS;YAEhC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;YACtF,IAAI,MAAM,GAAG,EAAE,CAAC;YAEhB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC;gBAChB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;wBAAE,SAAS;oBAC3B,IAAI,CAAC;wBACJ,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC;wBAC7C,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK;4BAAE,SAAS;wBACxD,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;4BAAE,SAAS;wBAC3D,IAAI,OAAO,GAAG,MAAM,EAAE,CAAC;4BAAC,OAAO,EAAE,CAAC;4BAAC,SAAS;wBAAC,CAAC;wBAC9C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;wBACjB,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;4BAC5B,MAAM,CAAC,OAAO,EAAE,CAAC;4BACjB,OAAO,MAAM,CAAC;wBACf,CAAC;oBACF,CAAC;oBAAC,MAAM,CAAC;wBACR,qBAAqB;oBACtB,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAmB;QAC/B,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAEvC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAEnE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,SAAS;YAEhC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5D,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAClC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;wBAAE,SAAS;oBAC3B,IAAI,CAAC;wBACJ,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC;wBAC7C,IAAI,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;4BAChD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;4BACjB,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;gCAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gCAAC,OAAO,MAAM,CAAC;4BAAC,CAAC;wBACjE,CAAC;oBACF,CAAC;oBAAC,MAAM,CAAC;wBACR,OAAO;oBACR,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;IAED,KAAK,CAAC,SAAiB;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACvE,CAAC;QACD,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC;YAC7B,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAkB,CAAC,SAAS;YACnE,CAAC,CAAC,IAAI,CAAC;QACR,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACzF,CAAC;IAED,IAAI;QACH,IAAI,CAAC;YACJ,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;YAC3C,OAAO,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC;iBAClC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;iBAC3C,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,EAAE,CAAC;QACX,CAAC;IACF,CAAC;CACD"}

package/packages/event-store/dist/test/store.test.js

@@ -0,0 +1,57 @@
+import { describe, it, beforeEach, afterEach } from "node:test";
+import { equal } from "node:assert";
+import { join } from "node:path";
+import { mkdirSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { EventStore } from "../src/store.js";
+describe("EventStore", () => {
+    const dir = join(tmpdir(), "event-store-test-" + Date.now());
+    beforeEach(() => mkdirSync(dir, { recursive: true }));
+    afterEach(() => rmSync(dir, { recursive: true, force: true }));
+    const store = new EventStore({ sessionsDir: dir });
+    it("append generates id and timestamp", async () => {
+        const result = await store.append({
+            sessionId: "test-1",
+            type: "message",
+            role: "user",
+            content: "hello",
+        });
+        equal(typeof result.id, "string");
+        equal(result.id.length > 0, true);
+        equal(typeof result.timestamp, "string");
+    });
+    it("read returns appended events", async () => {
+        await store.append({ sessionId: "s1", type: "message", role: "user", content: "hello" });
+        await store.append({ sessionId: "s1", type: "message", role: "assistant", content: "hi" });
+        const events = await store.read({ sessionId: "s1" });
+        equal(events.length, 2);
+        equal(events[0].content, "hello");
+    });
+    it("read filters by type", async () => {
+        await store.append({ sessionId: "s2", type: "message", role: "user", content: "a" });
+        await store.append({ sessionId: "s2", type: "tool_start", tool: "bash", content: "" });
+        const events = await store.read({ sessionId: "s2", types: ["message"] });
+        equal(events.length, 1);
+    });
+    it("search finds matching content", async () => {
+        await store.append({ sessionId: "s3", type: "message", role: "user", content: "fix the login bug" });
+        await store.append({ sessionId: "s3", type: "message", role: "user", content: "add dark mode" });
+        const events = await store.search({ query: "login" });
+        equal(events.length >= 1, true);
+        equal(events[0].content?.includes("login"), true);
+    });
+    it("stats returns counts", async () => {
+        await store.append({ sessionId: "s4", type: "message", role: "user", content: "a" });
+        await store.append({ sessionId: "s4", type: "message", role: "user", content: "b" });
+        const st = store.stats("s4");
+        equal(st.totalEvents, 2);
+        equal(st.sizeBytes > 0, true);
+    });
+    it("list returns session IDs", async () => {
+        await store.append({ sessionId: "alpha", type: "message", role: "user", content: "x" });
+        await store.append({ sessionId: "beta", type: "message", role: "user", content: "y" });
+        const sessions = store.list();
+        equal(sessions.includes("alpha"), true);
+        equal(sessions.includes("beta"), true);
+    });
+});