@producible/cereworker-core 26.520.1

package/LICENSE

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

package/dist/abort.d.ts

@@ -0,0 +1,5 @@
+export declare function createAbortError(message: string): Error;
+export declare function isAbortError(error: unknown): boolean;
+export declare function throwIfAborted(abortSignal: AbortSignal | null | undefined, message: string): void;
+export declare function raceWithAbort<T>(promise: Promise<T>, abortSignal: AbortSignal, message: string): Promise<T>;
+//# sourceMappingURL=abort.d.ts.map

package/dist/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAIvD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD;AAED,wBAAgB,cAAc,CAC5B,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EAC3C,OAAO,EAAE,MAAM,GACd,IAAI,CAIN;AAED,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC,CA4BZ"}

package/dist/abort.js

@@ -0,0 +1,36 @@
+export function createAbortError(message) {
+    const error = new Error(message);
+    error.name = 'AbortError';
+    return error;
+}
+export function isAbortError(error) {
+    return error instanceof Error && error.name === 'AbortError';
+}
+export function throwIfAborted(abortSignal, message) {
+    if (abortSignal?.aborted) {
+        throw createAbortError(message);
+    }
+}
+export function raceWithAbort(promise, abortSignal, message) {
+    if (abortSignal.aborted) {
+        return Promise.reject(createAbortError(message));
+    }
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            cleanup();
+            reject(createAbortError(message));
+        };
+        const cleanup = () => {
+            abortSignal.removeEventListener('abort', onAbort);
+        };
+        abortSignal.addEventListener('abort', onAbort, { once: true });
+        promise.then((value) => {
+            cleanup();
+            resolve(value);
+        }, (error) => {
+            cleanup();
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=abort.js.map

package/dist/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC;IAC1B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,WAA2C,EAC3C,OAAe;IAEf,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;QACzB,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,OAAmB,EACnB,WAAwB,EACxB,OAAe;IAEf,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,WAAW,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC,CAAC;QAEF,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,OAAO,CAAC,IAAI,CACV,CAAC,KAAK,EAAE,EAAE;YACR,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACR,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,20 @@
+import type { Message } from './types.js';
+/**
+ * Estimate token count using chars/4 heuristic with a 1.2x safety margin.
+ * Avoids bringing in a tokenizer dependency for lightweight compaction checks.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Estimate total tokens across an array of messages.
+ */
+export declare function estimateMessageTokens(messages: Message[]): number;
+/**
+ * Check if the conversation should be compacted.
+ * Returns true when estimated tokens exceed threshold * contextWindow.
+ */
+export declare function shouldCompact(messages: Message[], contextWindow: number, threshold?: number): boolean;
+/**
+ * Build the compacted message array: a system summary + the most recent messages.
+ */
+export declare function buildCompactionMessages(messages: Message[], summary: string, keepRecent: number): Message[];
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAQjE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,EAAE,EACnB,aAAa,EAAE,MAAM,EACrB,SAAS,SAAM,GACd,OAAO,CAIT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,EAAE,CAYX"}

package/dist/context.js

@@ -0,0 +1,45 @@
+const SAFETY_MARGIN = 1.2;
+/**
+ * Estimate token count using chars/4 heuristic with a 1.2x safety margin.
+ * Avoids bringing in a tokenizer dependency for lightweight compaction checks.
+ */
+export function estimateTokens(text) {
+    return Math.ceil((text.length / 4) * SAFETY_MARGIN);
+}
+/**
+ * Estimate total tokens across an array of messages.
+ */
+export function estimateMessageTokens(messages) {
+    let total = 0;
+    for (const msg of messages) {
+        total += estimateTokens(msg.content);
+        // Account for role/metadata overhead (~4 tokens per message)
+        total += 4;
+    }
+    return total;
+}
+/**
+ * Check if the conversation should be compacted.
+ * Returns true when estimated tokens exceed threshold * contextWindow.
+ */
+export function shouldCompact(messages, contextWindow, threshold = 0.8) {
+    if (messages.length <= 1)
+        return false;
+    const tokens = estimateMessageTokens(messages);
+    return tokens > contextWindow * threshold;
+}
+/**
+ * Build the compacted message array: a system summary + the most recent messages.
+ */
+export function buildCompactionMessages(messages, summary, keepRecent) {
+    const recentStart = Math.max(0, messages.length - keepRecent);
+    const recentMessages = messages.slice(recentStart);
+    const summaryMessage = {
+        id: 'compaction-summary',
+        role: 'system',
+        content: `[Previous conversation summary]\n${summary}`,
+        timestamp: recentMessages[0]?.timestamp ?? Date.now(),
+    };
+    return [summaryMessage, ...recentMessages];
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAmB;IACvD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,KAAK,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,6DAA6D;QAC7D,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAmB,EACnB,aAAqB,EACrB,SAAS,GAAG,GAAG;IAEf,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAmB,EACnB,OAAe,EACf,UAAkB;IAElB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAEnD,MAAM,cAAc,GAAY;QAC9B,EAAE,EAAE,oBAAoB;QACxB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,oCAAoC,OAAO,EAAE;QACtD,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;KACtD,CAAC;IAEF,OAAO,CAAC,cAAc,EAAE,GAAG,cAAc,CAAC,CAAC;AAC7C,CAAC"}

package/dist/conversation.d.ts

@@ -0,0 +1,48 @@
+import type { Conversation, Message, MessageRole, QuerySession, SessionEvent, TurnJournalEntry } from './types.js';
+export interface TurnJournalRetentionPolicy {
+    maxDays: number;
+    maxFilesPerConversation: number;
+}
+export declare class ConversationStore {
+    private readonly inMemory;
+    private readonly baseDir;
+    private readonly conversationsDir;
+    private readonly memoryConversations;
+    private readonly memorySessions;
+    constructor(dbPath?: string);
+    private migrateLegacyDatabase;
+    create(): Conversation;
+    get(id: string): Conversation | undefined;
+    list(): Conversation[];
+    appendMessage(conversationId: string, role: MessageRole, content: string, extra?: Partial<Message>): Message;
+    getMessages(conversationId: string): Message[];
+    appendTurnJournalEntry(conversationId: string, turnId: string, entry: TurnJournalEntry): void;
+    getTurnJournal(conversationId: string, turnId: string): TurnJournalEntry[];
+    appendSessionEvent(conversationId: string, sessionId: string, event: SessionEvent): void;
+    getSessionEvents(conversationId: string, sessionId: string): SessionEvent[];
+    saveQuerySession(conversationId: string, session: QuerySession): void;
+    getQuerySession(conversationId: string, sessionId: string): QuerySession | undefined;
+    pruneTurnJournals(conversationId: string, policy: TurnJournalRetentionPolicy): {
+        prunedByAge: number;
+        prunedByCount: number;
+        remaining: number;
+    };
+    deleteMessages(conversationId: string, messageIds: string[]): number;
+    delete(id: string): boolean;
+    getPreview(conversationId: string): string | null;
+    close(): void;
+    private getConversationDir;
+    private getMetaPath;
+    private getMessagesPath;
+    private getTurnsDir;
+    private getTurnJournalPath;
+    private getSessionsDir;
+    private getSessionLedgerPath;
+    private getSessionSnapshotPath;
+    private listTurnJournalFiles;
+    private readConversationMeta;
+    private writeConversationMeta;
+    private readConversationMessages;
+    private writeConversationMessages;
+}
+//# sourceMappingURL=conversation.d.ts.map

package/dist/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../src/conversation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAwBpB,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAQD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAmC;IACvE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgD;gBAEnE,MAAM,CAAC,EAAE,MAAM;IAe3B,OAAO,CAAC,qBAAqB;IAqD7B,MAAM,IAAI,YAAY;IAsBtB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAczC,IAAI,IAAI,YAAY,EAAE;IA0BtB,aAAa,CACX,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GACvB,OAAO;IA+BV,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,EAAE;IAO9C,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAY7F,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAK1E,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAYxF,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE;IAK3E,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAoBrE,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAUpF,iBAAiB,CACf,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,0BAA0B,GACjC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAqDpE,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM;IAyBpE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAiB3B,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKjD,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,yBAAyB;CAIlC"}

package/dist/conversation.js

@@ -0,0 +1,358 @@
+import { nanoid } from 'nanoid';
+import { existsSync, readdirSync, rmSync, statSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+import { createLogger } from './logger.js';
+import { appendJsonLine, ensureDir, readJsonFile, readJsonLines, resolveStoreBasePath, withTextStoreLock, writeJsonFileAtomic, writeJsonLines, } from './text-store.js';
+import { markLegacySectionMigrated, readLegacySection } from './legacy-sqlite.js';
+const log = createLogger('conversation');
+const DEFAULT_DB_PATH = join(homedir(), '.cereworker', 'conversations.db');
+export class ConversationStore {
+    inMemory;
+    baseDir;
+    conversationsDir;
+    memoryConversations = new Map();
+    memorySessions = new Map();
+    constructor(dbPath) {
+        this.inMemory = dbPath === ':memory:';
+        this.baseDir = this.inMemory ? null : resolveStoreBasePath(dbPath ?? DEFAULT_DB_PATH);
+        this.conversationsDir = this.baseDir ? join(this.baseDir, 'conversations') : null;
+        const legacyDbPath = dbPath ?? DEFAULT_DB_PATH;
+        if (this.conversationsDir) {
+            ensureDir(this.conversationsDir);
+            if (!existsSync(legacyDbPath) || !statSync(legacyDbPath).isDirectory()) {
+                this.migrateLegacyDatabase(legacyDbPath);
+            }
+            log.info('Opened conversation store', { path: this.conversationsDir });
+        }
+    }
+    migrateLegacyDatabase(dbPath) {
+        if (this.inMemory || !this.conversationsDir)
+            return;
+        const rows = readLegacySection(dbPath, 'conversations', 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        (db) => {
+            const conversations = db
+                .prepare('SELECT id, createdAt, updatedAt FROM conversations ORDER BY createdAt ASC')
+                .all();
+            return conversations.map((conversation) => {
+                const messages = db
+                    .prepare(`SELECT id, role, content, timestamp, toolCalls, toolResult, metadata
+               FROM messages WHERE conversationId = ? ORDER BY timestamp, rowid`)
+                    .all(conversation.id);
+                return {
+                    conversation,
+                    messages: messages.map((message) => ({
+                        id: message.id,
+                        role: message.role,
+                        content: message.content,
+                        timestamp: message.timestamp,
+                        ...(message.toolCalls ? { toolCalls: JSON.parse(message.toolCalls) } : {}),
+                        ...(message.toolResult ? { toolResult: JSON.parse(message.toolResult) } : {}),
+                        ...(message.metadata ? { metadata: JSON.parse(message.metadata) } : {}),
+                    })),
+                };
+            });
+        });
+        if (!rows)
+            return;
+        for (const row of rows) {
+            if (existsSync(this.getConversationDir(row.conversation.id)))
+                continue;
+            this.writeConversationMeta(row.conversation.id, row.conversation);
+            this.writeConversationMessages(row.conversation.id, row.messages);
+        }
+        markLegacySectionMigrated(dbPath, 'conversations');
+    }
+    create() {
+        const now = Date.now();
+        const conversation = {
+            id: nanoid(),
+            messages: [],
+            createdAt: now,
+            updatedAt: now,
+        };
+        if (this.inMemory) {
+            this.memoryConversations.set(conversation.id, conversation);
+        }
+        else {
+            withTextStoreLock(this.conversationsDir, () => {
+                this.writeConversationMeta(conversation.id, conversation);
+                this.writeConversationMessages(conversation.id, []);
+            });
+        }
+        log.debug('Created conversation', { id: conversation.id });
+        return conversation;
+    }
+    get(id) {
+        if (this.inMemory) {
+            const conversation = this.memoryConversations.get(id);
+            return conversation ? { ...conversation, messages: [...conversation.messages] } : undefined;
+        }
+        const meta = this.readConversationMeta(id);
+        if (!meta)
+            return undefined;
+        return {
+            ...meta,
+            messages: this.readConversationMessages(id),
+        };
+    }
+    list() {
+        if (this.inMemory) {
+            return Array.from(this.memoryConversations.values())
+                .sort((a, b) => b.updatedAt - a.updatedAt)
+                .map((conversation) => ({
+                id: conversation.id,
+                messages: [],
+                createdAt: conversation.createdAt,
+                updatedAt: conversation.updatedAt,
+            }));
+        }
+        if (!this.conversationsDir || !existsSync(this.conversationsDir))
+            return [];
+        return readdirSync(this.conversationsDir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => this.readConversationMeta(entry.name))
+            .filter((meta) => meta !== undefined)
+            .sort((a, b) => b.updatedAt - a.updatedAt)
+            .map((meta) => ({
+            id: meta.id,
+            messages: [],
+            createdAt: meta.createdAt,
+            updatedAt: meta.updatedAt,
+        }));
+    }
+    appendMessage(conversationId, role, content, extra) {
+        const message = {
+            id: nanoid(),
+            role,
+            content,
+            timestamp: Date.now(),
+            ...extra,
+        };
+        if (this.inMemory) {
+            const conversation = this.memoryConversations.get(conversationId);
+            if (!conversation)
+                throw new Error(`Conversation ${conversationId} not found`);
+            conversation.messages.push(message);
+            conversation.updatedAt = Date.now();
+            return message;
+        }
+        withTextStoreLock(this.getConversationDir(conversationId), () => {
+            const meta = this.readConversationMeta(conversationId);
+            if (!meta)
+                throw new Error(`Conversation ${conversationId} not found`);
+            appendJsonLine(this.getMessagesPath(conversationId), message);
+            this.writeConversationMeta(conversationId, {
+                ...meta,
+                updatedAt: Date.now(),
+            });
+        });
+        return message;
+    }
+    getMessages(conversationId) {
+        if (this.inMemory) {
+            return [...(this.memoryConversations.get(conversationId)?.messages ?? [])];
+        }
+        return this.readConversationMessages(conversationId);
+    }
+    appendTurnJournalEntry(conversationId, turnId, entry) {
+        if (this.inMemory)
+            return;
+        withTextStoreLock(this.getConversationDir(conversationId), () => {
+            const meta = this.readConversationMeta(conversationId);
+            if (!meta)
+                throw new Error(`Conversation ${conversationId} not found`);
+            ensureDir(this.getTurnsDir(conversationId));
+            appendJsonLine(this.getTurnJournalPath(conversationId, turnId), entry);
+        });
+    }
+    getTurnJournal(conversationId, turnId) {
+        if (this.inMemory)
+            return [];
+        return readJsonLines(this.getTurnJournalPath(conversationId, turnId));
+    }
+    appendSessionEvent(conversationId, sessionId, event) {
+        if (this.inMemory)
+            return;
+        withTextStoreLock(this.getConversationDir(conversationId), () => {
+            const meta = this.readConversationMeta(conversationId);
+            if (!meta)
+                throw new Error(`Conversation ${conversationId} not found`);
+            ensureDir(this.getSessionsDir(conversationId));
+            appendJsonLine(this.getSessionLedgerPath(conversationId, sessionId), event);
+        });
+    }
+    getSessionEvents(conversationId, sessionId) {
+        if (this.inMemory)
+            return [];
+        return readJsonLines(this.getSessionLedgerPath(conversationId, sessionId));
+    }
+    saveQuerySession(conversationId, session) {
+        if (this.inMemory) {
+            let sessions = this.memorySessions.get(conversationId);
+            if (!sessions) {
+                sessions = new Map();
+                this.memorySessions.set(conversationId, sessions);
+            }
+            sessions.set(session.id, { ...session });
+            return;
+        }
+        withTextStoreLock(this.getConversationDir(conversationId), () => {
+            const meta = this.readConversationMeta(conversationId);
+            if (!meta)
+                throw new Error(`Conversation ${conversationId} not found`);
+            ensureDir(this.getSessionsDir(conversationId));
+            writeJsonFileAtomic(this.getSessionSnapshotPath(conversationId, session.id), session);
+        });
+    }
+    getQuerySession(conversationId, sessionId) {
+        if (this.inMemory) {
+            return this.memorySessions.get(conversationId)?.get(sessionId);
+        }
+        return readJsonFile(this.getSessionSnapshotPath(conversationId, sessionId), null) ?? undefined;
+    }
+    pruneTurnJournals(conversationId, policy) {
+        if (this.inMemory) {
+            return { prunedByAge: 0, prunedByCount: 0, remaining: 0 };
+        }
+        return withTextStoreLock(this.getConversationDir(conversationId), () => {
+            const meta = this.readConversationMeta(conversationId);
+            if (!meta)
+                return { prunedByAge: 0, prunedByCount: 0, remaining: 0 };
+            const files = this.listTurnJournalFiles(conversationId);
+            if (files.length === 0) {
+                return { prunedByAge: 0, prunedByCount: 0, remaining: 0 };
+            }
+            let retained = [...files];
+            let prunedByAge = 0;
+            let prunedByCount = 0;
+            if (policy.maxDays > 0) {
+                const cutoff = Date.now() - policy.maxDays * 24 * 60 * 60 * 1000;
+                const expired = retained.filter((file) => file.mtimeMs < cutoff);
+                for (const file of expired) {
+                    rmSync(file.path, { force: true });
+                }
+                prunedByAge = expired.length;
+                retained = retained.filter((file) => file.mtimeMs >= cutoff);
+            }
+            if (policy.maxFilesPerConversation > 0 && retained.length > policy.maxFilesPerConversation) {
+                const sorted = [...retained].sort((a, b) => b.mtimeMs - a.mtimeMs || a.turnId.localeCompare(b.turnId));
+                const keep = new Set(sorted
+                    .slice(0, policy.maxFilesPerConversation)
+                    .map((file) => file.path));
+                const overflow = retained.filter((file) => !keep.has(file.path));
+                for (const file of overflow) {
+                    rmSync(file.path, { force: true });
+                }
+                prunedByCount = overflow.length;
+                retained = retained.filter((file) => keep.has(file.path));
+            }
+            return {
+                prunedByAge,
+                prunedByCount,
+                remaining: retained.length,
+            };
+        });
+    }
+    deleteMessages(conversationId, messageIds) {
+        if (messageIds.length === 0)
+            return 0;
+        if (this.inMemory) {
+            const conversation = this.memoryConversations.get(conversationId);
+            if (!conversation)
+                return 0;
+            const before = conversation.messages.length;
+            conversation.messages = conversation.messages.filter((message) => !messageIds.includes(message.id));
+            return before - conversation.messages.length;
+        }
+        return withTextStoreLock(this.getConversationDir(conversationId), () => {
+            const messages = this.readConversationMessages(conversationId);
+            if (messages.length === 0)
+                return 0;
+            const filtered = messages.filter((message) => !messageIds.includes(message.id));
+            const deleted = messages.length - filtered.length;
+            if (deleted > 0) {
+                this.writeConversationMessages(conversationId, filtered);
+            }
+            return deleted;
+        });
+    }
+    delete(id) {
+        if (this.inMemory) {
+            const deleted = this.memoryConversations.delete(id);
+            this.memorySessions.delete(id);
+            log.debug('Deleted conversation', { id, deleted });
+            return deleted;
+        }
+        const conversationDir = this.getConversationDir(id);
+        return withTextStoreLock(conversationDir, () => {
+            if (!existsSync(conversationDir))
+                return false;
+            rmSync(conversationDir, { recursive: true, force: true });
+            log.debug('Deleted conversation', { id, deleted: true });
+            return true;
+        });
+    }
+    getPreview(conversationId) {
+        const messages = this.getMessages(conversationId);
+        return messages.find((message) => message.role === 'user')?.content ?? null;
+    }
+    close() {
+        // No-op for file-backed stores.
+    }
+    getConversationDir(id) {
+        return join(this.conversationsDir ?? dirname(DEFAULT_DB_PATH), id);
+    }
+    getMetaPath(id) {
+        return join(this.getConversationDir(id), 'meta.json');
+    }
+    getMessagesPath(id) {
+        return join(this.getConversationDir(id), 'messages.jsonl');
+    }
+    getTurnsDir(id) {
+        return join(this.getConversationDir(id), 'turns');
+    }
+    getTurnJournalPath(id, turnId) {
+        return join(this.getTurnsDir(id), `${turnId}.jsonl`);
+    }
+    getSessionsDir(id) {
+        return join(this.getConversationDir(id), 'sessions');
+    }
+    getSessionLedgerPath(id, sessionId) {
+        return join(this.getSessionsDir(id), `${sessionId}.jsonl`);
+    }
+    getSessionSnapshotPath(id, sessionId) {
+        return join(this.getSessionsDir(id), `${sessionId}.json`);
+    }
+    listTurnJournalFiles(id) {
+        const turnsDir = this.getTurnsDir(id);
+        if (!existsSync(turnsDir))
+            return [];
+        return readdirSync(turnsDir, { withFileTypes: true })
+            .filter((entry) => entry.isFile() && entry.name.endsWith('.jsonl'))
+            .map((entry) => {
+            const path = join(turnsDir, entry.name);
+            return {
+                turnId: entry.name.slice(0, -'.jsonl'.length),
+                path,
+                mtimeMs: statSync(path).mtimeMs,
+            };
+        });
+    }
+    readConversationMeta(id) {
+        return readJsonFile(this.getMetaPath(id), null) ?? undefined;
+    }
+    writeConversationMeta(id, meta) {
+        ensureDir(this.getConversationDir(id));
+        writeJsonFileAtomic(this.getMetaPath(id), meta);
+    }
+    readConversationMessages(id) {
+        return readJsonLines(this.getMessagesPath(id));
+    }
+    writeConversationMessages(id, messages) {
+        ensureDir(this.getConversationDir(id));
+        writeJsonLines(this.getMessagesPath(id), messages);
+    }
+}
+//# sourceMappingURL=conversation.js.map

package/dist/conversation.js.map

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

package/dist/discovery.d.ts

@@ -0,0 +1,32 @@
+import type { CerebrumAdapter, TrainingPair } from './orchestrator.js';
+import type { Message } from './types.js';
+export interface DiscoveryResult {
+    name: string;
+    role: string;
+    traits: string[];
+    conversation: Message[];
+    trainingPairs: TrainingPair[];
+}
+export interface DiscoveryCallbacks {
+    /** Display agent's message to the user */
+    sendMessage: (content: string) => void;
+    /** Get user's text input */
+    getUserInput: () => Promise<string>;
+    /** Called when discovery is complete */
+    onComplete: (result: DiscoveryResult) => void;
+    /** Called on each streaming chunk (optional) */
+    onChunk?: (chunk: string) => void;
+}
+export declare class DiscoveryEngine {
+    private cerebrum;
+    private callbacks;
+    private messages;
+    constructor(cerebrum: CerebrumAdapter, callbacks: DiscoveryCallbacks);
+    run(): Promise<DiscoveryResult>;
+    private getAgentResponse;
+    private parseCompletion;
+    private buildResult;
+    private extractPartialResult;
+    private extractTrainingPairs;
+}
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAmB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAwB1C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,4BAA4B;IAC5B,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,wCAAwC;IACxC,UAAU,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IAC9C,gDAAgD;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAID,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAiB;gBAErB,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,kBAAkB;IAK9D,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC;YAuDvB,gBAAgB;IAyB9B,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,oBAAoB;CAkB7B"}