threadwell 0.0.0 → 0.0.2

package/dist/core/memory/sqlite-memory-store.js

@@ -0,0 +1,300 @@
+import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync, renameSync } from "node:fs";
+import { dirname } from "node:path";
+import Database from "better-sqlite3";
+import { getDefaultMemoryPriority } from "./memory-schema.js";
+const CURRENT_SCHEMA_VERSION = 1;
+function parseJsonArray(value) {
+    if (!value)
+        return undefined;
+    try {
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed) && parsed.every((entry) => typeof entry === "string") ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseMetadata(value) {
+    if (!value)
+        return undefined;
+    try {
+        const parsed = JSON.parse(value);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+            return undefined;
+        const metadata = {};
+        for (const [key, entry] of Object.entries(parsed)) {
+            if (typeof entry === "string" || typeof entry === "number" || typeof entry === "boolean" || entry === null) {
+                metadata[key] = entry;
+            }
+        }
+        return metadata;
+    }
+    catch {
+        return undefined;
+    }
+}
+function rowToEvent(row) {
+    return {
+        id: row.id,
+        projectId: row.project_id,
+        sessionId: row.session_id,
+        type: row.type,
+        summary: row.summary,
+        content: row.content ?? undefined,
+        priority: row.priority,
+        filePaths: parseJsonArray(row.file_paths),
+        tags: parseJsonArray(row.tags),
+        metadata: parseMetadata(row.metadata),
+        createdAt: row.created_at,
+    };
+}
+export class SqliteMemoryStore {
+    kind = "sqlite";
+    dbPath;
+    db;
+    session;
+    writeQueue = Promise.resolve();
+    constructor(options) {
+        this.dbPath = options.dbPath;
+    }
+    async initialize(session) {
+        this.session = session;
+        this.open();
+        this.ensureProject(session);
+        this.ensureSession(session);
+    }
+    async recordEvent(session, event) {
+        return this.enqueueWrite(() => {
+            const db = this.open();
+            this.ensureProject(session);
+            this.ensureSession(session);
+            const memoryEvent = {
+                ...event,
+                id: randomUUID(),
+                projectId: session.projectId,
+                sessionId: session.sessionId,
+                priority: event.priority ?? getDefaultMemoryPriority(event.type),
+                createdAt: event.createdAt ?? new Date().toISOString(),
+            };
+            db.prepare(`INSERT INTO memory_events (id, project_id, session_id, type, summary, content, priority, file_paths, tags, metadata, created_at)
+				 VALUES (@id, @projectId, @sessionId, @type, @summary, @content, @priority, @filePaths, @tags, @metadata, @createdAt)`).run({
+                ...memoryEvent,
+                content: memoryEvent.content ?? null,
+                filePaths: memoryEvent.filePaths ? JSON.stringify(memoryEvent.filePaths) : null,
+                tags: memoryEvent.tags ? JSON.stringify(memoryEvent.tags) : null,
+                metadata: memoryEvent.metadata ? JSON.stringify(memoryEvent.metadata) : null,
+            });
+            return memoryEvent;
+        });
+    }
+    async search(request) {
+        const db = this.open();
+        const limit = request.limit ?? 10;
+        const query = request.query.trim();
+        if (!query) {
+            const rows = db
+                .prepare(`SELECT * FROM memory_events
+					 WHERE (@projectId IS NULL OR project_id = @projectId)
+					   AND (@sessionId IS NULL OR session_id = @sessionId)
+					 ORDER BY priority DESC, created_at DESC
+					 LIMIT @limit`)
+                .all({ projectId: request.projectId ?? null, sessionId: request.sessionId ?? null, limit });
+            return rows.map((row, index) => ({
+                event: rowToEvent(row),
+                score: limit - index,
+                reason: "sqlite priority/recency match",
+            }));
+        }
+        const rows = db
+            .prepare(`SELECT memory_events.*, bm25(memory_events_fts) AS rank
+				 FROM memory_events_fts
+				 JOIN memory_events ON memory_events_fts.rowid = memory_events.rowid
+				 WHERE memory_events_fts MATCH @query
+				   AND (@projectId IS NULL OR memory_events.project_id = @projectId)
+				   AND (@sessionId IS NULL OR memory_events.session_id = @sessionId)
+				 ORDER BY rank ASC, memory_events.priority DESC, memory_events.created_at DESC
+				 LIMIT @limit`)
+            .all({ projectId: request.projectId ?? null, sessionId: request.sessionId ?? null, query, limit });
+        return rows.map((row) => ({
+            event: rowToEvent(row),
+            score: -row.rank + row.priority,
+            reason: "sqlite fts5 bm25 match",
+        }));
+    }
+    async getRecent(projectId, limit) {
+        const rows = this.open()
+            .prepare("SELECT * FROM memory_events WHERE project_id = ? ORDER BY created_at DESC LIMIT ?")
+            .all(projectId, limit);
+        return rows.map(rowToEvent);
+    }
+    async deleteEvent(projectId, eventId) {
+        return this.enqueueWrite(() => {
+            const result = this.open()
+                .prepare("DELETE FROM memory_events WHERE project_id = ? AND id = ?")
+                .run(projectId, eventId);
+            return result.changes > 0;
+        });
+    }
+    async purgeProject(projectId) {
+        return this.enqueueWrite(() => {
+            const result = this.open().prepare("DELETE FROM memory_events WHERE project_id = ?").run(projectId);
+            return result.changes;
+        });
+    }
+    async getStatus() {
+        const db = this.open();
+        const row = db.prepare("SELECT COUNT(*) AS count FROM memory_events").get();
+        return {
+            enabled: true,
+            projectId: this.session?.projectId,
+            sessionId: this.session?.sessionId,
+            eventCount: row.count,
+            store: this.kind,
+        };
+    }
+    async close() {
+        this.db?.close();
+        this.db = undefined;
+    }
+    open() {
+        if (this.db)
+            return this.db;
+        mkdirSync(dirname(this.dbPath), { recursive: true });
+        try {
+            this.db = this.openDatabase();
+            this.configureDatabase(this.db);
+            return this.db;
+        }
+        catch (error) {
+            this.db?.close();
+            this.db = undefined;
+            if (!existsSync(this.dbPath))
+                throw error;
+            const corruptPath = `${this.dbPath}.corrupt.${Date.now()}`;
+            renameSync(this.dbPath, corruptPath);
+            this.db = this.openDatabase();
+            this.configureDatabase(this.db);
+            return this.db;
+        }
+    }
+    configureDatabase(db) {
+        db.pragma("journal_mode = WAL");
+        db.pragma("busy_timeout = 5000");
+        this.runMigrations(db);
+    }
+    runMigrations(db) {
+        db.exec(`
+			CREATE TABLE IF NOT EXISTS memory_schema_version (
+				version INTEGER NOT NULL
+			);
+		`);
+        const versionRow = db.prepare("SELECT version FROM memory_schema_version LIMIT 1").get();
+        const version = versionRow?.version ?? 0;
+        if (version < 1) {
+            db.exec(`
+				CREATE TABLE IF NOT EXISTS memory_projects (
+					project_id TEXT PRIMARY KEY,
+					root_path TEXT NOT NULL,
+					git_remote TEXT,
+					current_branch TEXT,
+					created_at TEXT NOT NULL,
+					last_seen_at TEXT NOT NULL
+				);
+
+				CREATE TABLE IF NOT EXISTS memory_sessions (
+					session_id TEXT PRIMARY KEY,
+					project_id TEXT NOT NULL,
+					cwd TEXT NOT NULL,
+					continuity_session_id TEXT,
+					model TEXT,
+					provider TEXT,
+					started_at TEXT NOT NULL,
+					last_seen_at TEXT NOT NULL,
+					ended_at TEXT,
+					FOREIGN KEY(project_id) REFERENCES memory_projects(project_id)
+				);
+
+				CREATE TABLE IF NOT EXISTS memory_events (
+					id TEXT PRIMARY KEY,
+					project_id TEXT NOT NULL,
+					session_id TEXT NOT NULL,
+					type TEXT NOT NULL,
+					summary TEXT NOT NULL,
+					content TEXT,
+					priority INTEGER NOT NULL,
+					file_paths TEXT,
+					tags TEXT,
+					metadata TEXT,
+					created_at TEXT NOT NULL,
+					FOREIGN KEY(project_id) REFERENCES memory_projects(project_id),
+					FOREIGN KEY(session_id) REFERENCES memory_sessions(session_id)
+				);
+
+				CREATE INDEX IF NOT EXISTS idx_memory_events_project_created ON memory_events(project_id, created_at DESC);
+				CREATE INDEX IF NOT EXISTS idx_memory_events_session_created ON memory_events(session_id, created_at DESC);
+				CREATE INDEX IF NOT EXISTS idx_memory_events_type_priority ON memory_events(type, priority DESC);
+
+				CREATE VIRTUAL TABLE IF NOT EXISTS memory_events_fts USING fts5(
+					summary,
+					content,
+					tags,
+					content='memory_events',
+					content_rowid='rowid'
+				);
+
+				CREATE TRIGGER IF NOT EXISTS memory_events_ai AFTER INSERT ON memory_events BEGIN
+					INSERT INTO memory_events_fts(rowid, summary, content, tags)
+					VALUES (new.rowid, new.summary, IFNULL(new.content, ''), IFNULL(new.tags, ''));
+				END;
+
+				CREATE TRIGGER IF NOT EXISTS memory_events_ad AFTER DELETE ON memory_events BEGIN
+					INSERT INTO memory_events_fts(memory_events_fts, rowid, summary, content, tags)
+					VALUES('delete', old.rowid, old.summary, IFNULL(old.content, ''), IFNULL(old.tags, ''));
+				END;
+
+				CREATE TRIGGER IF NOT EXISTS memory_events_au AFTER UPDATE ON memory_events BEGIN
+					INSERT INTO memory_events_fts(memory_events_fts, rowid, summary, content, tags)
+					VALUES('delete', old.rowid, old.summary, IFNULL(old.content, ''), IFNULL(old.tags, ''));
+					INSERT INTO memory_events_fts(rowid, summary, content, tags)
+					VALUES (new.rowid, new.summary, IFNULL(new.content, ''), IFNULL(new.tags, ''));
+				END;
+			`);
+            db.prepare("DELETE FROM memory_schema_version").run();
+            db.prepare("INSERT INTO memory_schema_version (version) VALUES (?)").run(CURRENT_SCHEMA_VERSION);
+        }
+    }
+    openDatabase() {
+        return new Database(this.dbPath);
+    }
+    async enqueueWrite(operation) {
+        const pending = this.writeQueue.then(operation, operation);
+        this.writeQueue = pending.then(() => undefined, () => undefined);
+        return pending;
+    }
+    ensureProject(session) {
+        const now = new Date().toISOString();
+        this.open()
+            .prepare(`INSERT INTO memory_projects (project_id, root_path, git_remote, current_branch, created_at, last_seen_at)
+				 VALUES (@projectId, @rootPath, NULL, NULL, @now, @now)
+				 ON CONFLICT(project_id) DO UPDATE SET last_seen_at = excluded.last_seen_at`)
+            .run({ projectId: session.projectId, rootPath: session.cwd, now });
+    }
+    ensureSession(session) {
+        const now = new Date().toISOString();
+        this.open()
+            .prepare(`INSERT INTO memory_sessions (session_id, project_id, cwd, continuity_session_id, model, provider, started_at, last_seen_at)
+				 VALUES (@sessionId, @projectId, @cwd, @continuitySessionId, @model, @provider, @now, @now)
+				 ON CONFLICT(session_id) DO UPDATE SET last_seen_at = excluded.last_seen_at`)
+            .run({
+            sessionId: session.sessionId,
+            projectId: session.projectId,
+            cwd: session.cwd,
+            continuitySessionId: session.continuitySessionId ?? null,
+            model: session.model ?? null,
+            provider: session.provider ?? null,
+            now,
+        });
+    }
+}
+//# sourceMappingURL=sqlite-memory-store.js.map

package/dist/core/memory/sqlite-memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-memory-store.js","sourceRoot":"","sources":["../../../src/core/memory/sqlite-memory-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { existsSync, mkdirSync, renameSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport Database from \"better-sqlite3\";\nimport { getDefaultMemoryPriority } from \"./memory-schema.js\";\nimport type { MemoryStore } from \"./memory-store.js\";\nimport type {\n\tMemoryEvent,\n\tMemoryEventInput,\n\tMemorySearchRequest,\n\tMemorySearchResult,\n\tMemorySessionIdentity,\n\tMemoryStatus,\n} from \"./memory-types.js\";\n\nconst CURRENT_SCHEMA_VERSION = 1;\n\ninterface SqliteMemoryStoreOptions {\n\tdbPath: string;\n}\n\ninterface EventRow {\n\tid: string;\n\tproject_id: string;\n\tsession_id: string;\n\ttype: MemoryEvent[\"type\"];\n\tsummary: string;\n\tcontent: string | null;\n\tpriority: number;\n\tfile_paths: string | null;\n\ttags: string | null;\n\tmetadata: string | null;\n\tcreated_at: string;\n}\n\nfunction parseJsonArray(value: string | null): string[] | undefined {\n\tif (!value) return undefined;\n\ttry {\n\t\tconst parsed = JSON.parse(value) as unknown;\n\t\treturn Array.isArray(parsed) && parsed.every((entry) => typeof entry === \"string\") ? parsed : undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction parseMetadata(value: string | null): Record<string, string | number | boolean | null> | undefined {\n\tif (!value) return undefined;\n\ttry {\n\t\tconst parsed = JSON.parse(value) as unknown;\n\t\tif (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) return undefined;\n\t\tconst metadata: Record<string, string | number | boolean | null> = {};\n\t\tfor (const [key, entry] of Object.entries(parsed)) {\n\t\t\tif (typeof entry === \"string\" || typeof entry === \"number\" || typeof entry === \"boolean\" || entry === null) {\n\t\t\t\tmetadata[key] = entry;\n\t\t\t}\n\t\t}\n\t\treturn metadata;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction rowToEvent(row: EventRow): MemoryEvent {\n\treturn {\n\t\tid: row.id,\n\t\tprojectId: row.project_id,\n\t\tsessionId: row.session_id,\n\t\ttype: row.type,\n\t\tsummary: row.summary,\n\t\tcontent: row.content ?? undefined,\n\t\tpriority: row.priority as MemoryEvent[\"priority\"],\n\t\tfilePaths: parseJsonArray(row.file_paths),\n\t\ttags: parseJsonArray(row.tags),\n\t\tmetadata: parseMetadata(row.metadata),\n\t\tcreatedAt: row.created_at,\n\t};\n}\n\nexport class SqliteMemoryStore implements MemoryStore {\n\treadonly kind = \"sqlite\";\n\tprivate readonly dbPath: string;\n\tprivate db: Database.Database | undefined;\n\tprivate session: MemorySessionIdentity | undefined;\n\tprivate writeQueue: Promise<void> = Promise.resolve();\n\n\tconstructor(options: SqliteMemoryStoreOptions) {\n\t\tthis.dbPath = options.dbPath;\n\t}\n\n\tasync initialize(session: MemorySessionIdentity): Promise<void> {\n\t\tthis.session = session;\n\t\tthis.open();\n\t\tthis.ensureProject(session);\n\t\tthis.ensureSession(session);\n\t}\n\n\tasync recordEvent(session: MemorySessionIdentity, event: MemoryEventInput): Promise<MemoryEvent> {\n\t\treturn this.enqueueWrite(() => {\n\t\t\tconst db = this.open();\n\t\t\tthis.ensureProject(session);\n\t\t\tthis.ensureSession(session);\n\t\t\tconst memoryEvent: MemoryEvent = {\n\t\t\t\t...event,\n\t\t\t\tid: randomUUID(),\n\t\t\t\tprojectId: session.projectId,\n\t\t\t\tsessionId: session.sessionId,\n\t\t\t\tpriority: event.priority ?? getDefaultMemoryPriority(event.type),\n\t\t\t\tcreatedAt: event.createdAt ?? new Date().toISOString(),\n\t\t\t};\n\t\t\tdb.prepare(\n\t\t\t\t`INSERT INTO memory_events (id, project_id, session_id, type, summary, content, priority, file_paths, tags, metadata, created_at)\n\t\t\t\t VALUES (@id, @projectId, @sessionId, @type, @summary, @content, @priority, @filePaths, @tags, @metadata, @createdAt)`,\n\t\t\t).run({\n\t\t\t\t...memoryEvent,\n\t\t\t\tcontent: memoryEvent.content ?? null,\n\t\t\t\tfilePaths: memoryEvent.filePaths ? JSON.stringify(memoryEvent.filePaths) : null,\n\t\t\t\ttags: memoryEvent.tags ? JSON.stringify(memoryEvent.tags) : null,\n\t\t\t\tmetadata: memoryEvent.metadata ? JSON.stringify(memoryEvent.metadata) : null,\n\t\t\t});\n\t\t\treturn memoryEvent;\n\t\t});\n\t}\n\n\tasync search(request: MemorySearchRequest): Promise<MemorySearchResult[]> {\n\t\tconst db = this.open();\n\t\tconst limit = request.limit ?? 10;\n\t\tconst query = request.query.trim();\n\t\tif (!query) {\n\t\t\tconst rows = db\n\t\t\t\t.prepare(\n\t\t\t\t\t`SELECT * FROM memory_events\n\t\t\t\t\t WHERE (@projectId IS NULL OR project_id = @projectId)\n\t\t\t\t\t   AND (@sessionId IS NULL OR session_id = @sessionId)\n\t\t\t\t\t ORDER BY priority DESC, created_at DESC\n\t\t\t\t\t LIMIT @limit`,\n\t\t\t\t)\n\t\t\t\t.all({ projectId: request.projectId ?? null, sessionId: request.sessionId ?? null, limit }) as EventRow[];\n\t\t\treturn rows.map((row, index) => ({\n\t\t\t\tevent: rowToEvent(row),\n\t\t\t\tscore: limit - index,\n\t\t\t\treason: \"sqlite priority/recency match\",\n\t\t\t}));\n\t\t}\n\n\t\tconst rows = db\n\t\t\t.prepare(\n\t\t\t\t`SELECT memory_events.*, bm25(memory_events_fts) AS rank\n\t\t\t\t FROM memory_events_fts\n\t\t\t\t JOIN memory_events ON memory_events_fts.rowid = memory_events.rowid\n\t\t\t\t WHERE memory_events_fts MATCH @query\n\t\t\t\t   AND (@projectId IS NULL OR memory_events.project_id = @projectId)\n\t\t\t\t   AND (@sessionId IS NULL OR memory_events.session_id = @sessionId)\n\t\t\t\t ORDER BY rank ASC, memory_events.priority DESC, memory_events.created_at DESC\n\t\t\t\t LIMIT @limit`,\n\t\t\t)\n\t\t\t.all({ projectId: request.projectId ?? null, sessionId: request.sessionId ?? null, query, limit }) as Array<\n\t\t\tEventRow & { rank: number }\n\t\t>;\n\t\treturn rows.map((row) => ({\n\t\t\tevent: rowToEvent(row),\n\t\t\tscore: -row.rank + row.priority,\n\t\t\treason: \"sqlite fts5 bm25 match\",\n\t\t}));\n\t}\n\n\tasync getRecent(projectId: string, limit: number): Promise<MemoryEvent[]> {\n\t\tconst rows = this.open()\n\t\t\t.prepare(\"SELECT * FROM memory_events WHERE project_id = ? ORDER BY created_at DESC LIMIT ?\")\n\t\t\t.all(projectId, limit) as EventRow[];\n\t\treturn rows.map(rowToEvent);\n\t}\n\n\tasync deleteEvent(projectId: string, eventId: string): Promise<boolean> {\n\t\treturn this.enqueueWrite(() => {\n\t\t\tconst result = this.open()\n\t\t\t\t.prepare(\"DELETE FROM memory_events WHERE project_id = ? AND id = ?\")\n\t\t\t\t.run(projectId, eventId);\n\t\t\treturn result.changes > 0;\n\t\t});\n\t}\n\n\tasync purgeProject(projectId: string): Promise<number> {\n\t\treturn this.enqueueWrite(() => {\n\t\t\tconst result = this.open().prepare(\"DELETE FROM memory_events WHERE project_id = ?\").run(projectId);\n\t\t\treturn result.changes;\n\t\t});\n\t}\n\n\tasync getStatus(): Promise<MemoryStatus> {\n\t\tconst db = this.open();\n\t\tconst row = db.prepare(\"SELECT COUNT(*) AS count FROM memory_events\").get() as { count: number };\n\t\treturn {\n\t\t\tenabled: true,\n\t\t\tprojectId: this.session?.projectId,\n\t\t\tsessionId: this.session?.sessionId,\n\t\t\teventCount: row.count,\n\t\t\tstore: this.kind,\n\t\t};\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.db?.close();\n\t\tthis.db = undefined;\n\t}\n\n\tprivate open(): Database.Database {\n\t\tif (this.db) return this.db;\n\t\tmkdirSync(dirname(this.dbPath), { recursive: true });\n\t\ttry {\n\t\t\tthis.db = this.openDatabase();\n\t\t\tthis.configureDatabase(this.db);\n\t\t\treturn this.db;\n\t\t} catch (error) {\n\t\t\tthis.db?.close();\n\t\t\tthis.db = undefined;\n\t\t\tif (!existsSync(this.dbPath)) throw error;\n\t\t\tconst corruptPath = `${this.dbPath}.corrupt.${Date.now()}`;\n\t\t\trenameSync(this.dbPath, corruptPath);\n\t\t\tthis.db = this.openDatabase();\n\t\t\tthis.configureDatabase(this.db);\n\t\t\treturn this.db;\n\t\t}\n\t}\n\n\tprivate configureDatabase(db: Database.Database): void {\n\t\tdb.pragma(\"journal_mode = WAL\");\n\t\tdb.pragma(\"busy_timeout = 5000\");\n\t\tthis.runMigrations(db);\n\t}\n\n\tprivate runMigrations(db: Database.Database): void {\n\t\tdb.exec(`\n\t\t\tCREATE TABLE IF NOT EXISTS memory_schema_version (\n\t\t\t\tversion INTEGER NOT NULL\n\t\t\t);\n\t\t`);\n\t\tconst versionRow = db.prepare(\"SELECT version FROM memory_schema_version LIMIT 1\").get() as\n\t\t\t| { version: number }\n\t\t\t| undefined;\n\t\tconst version = versionRow?.version ?? 0;\n\t\tif (version < 1) {\n\t\t\tdb.exec(`\n\t\t\t\tCREATE TABLE IF NOT EXISTS memory_projects (\n\t\t\t\t\tproject_id TEXT PRIMARY KEY,\n\t\t\t\t\troot_path TEXT NOT NULL,\n\t\t\t\t\tgit_remote TEXT,\n\t\t\t\t\tcurrent_branch TEXT,\n\t\t\t\t\tcreated_at TEXT NOT NULL,\n\t\t\t\t\tlast_seen_at TEXT NOT NULL\n\t\t\t\t);\n\n\t\t\t\tCREATE TABLE IF NOT EXISTS memory_sessions (\n\t\t\t\t\tsession_id TEXT PRIMARY KEY,\n\t\t\t\t\tproject_id TEXT NOT NULL,\n\t\t\t\t\tcwd TEXT NOT NULL,\n\t\t\t\t\tcontinuity_session_id TEXT,\n\t\t\t\t\tmodel TEXT,\n\t\t\t\t\tprovider TEXT,\n\t\t\t\t\tstarted_at TEXT NOT NULL,\n\t\t\t\t\tlast_seen_at TEXT NOT NULL,\n\t\t\t\t\tended_at TEXT,\n\t\t\t\t\tFOREIGN KEY(project_id) REFERENCES memory_projects(project_id)\n\t\t\t\t);\n\n\t\t\t\tCREATE TABLE IF NOT EXISTS memory_events (\n\t\t\t\t\tid TEXT PRIMARY KEY,\n\t\t\t\t\tproject_id TEXT NOT NULL,\n\t\t\t\t\tsession_id TEXT NOT NULL,\n\t\t\t\t\ttype TEXT NOT NULL,\n\t\t\t\t\tsummary TEXT NOT NULL,\n\t\t\t\t\tcontent TEXT,\n\t\t\t\t\tpriority INTEGER NOT NULL,\n\t\t\t\t\tfile_paths TEXT,\n\t\t\t\t\ttags TEXT,\n\t\t\t\t\tmetadata TEXT,\n\t\t\t\t\tcreated_at TEXT NOT NULL,\n\t\t\t\t\tFOREIGN KEY(project_id) REFERENCES memory_projects(project_id),\n\t\t\t\t\tFOREIGN KEY(session_id) REFERENCES memory_sessions(session_id)\n\t\t\t\t);\n\n\t\t\t\tCREATE INDEX IF NOT EXISTS idx_memory_events_project_created ON memory_events(project_id, created_at DESC);\n\t\t\t\tCREATE INDEX IF NOT EXISTS idx_memory_events_session_created ON memory_events(session_id, created_at DESC);\n\t\t\t\tCREATE INDEX IF NOT EXISTS idx_memory_events_type_priority ON memory_events(type, priority DESC);\n\n\t\t\t\tCREATE VIRTUAL TABLE IF NOT EXISTS memory_events_fts USING fts5(\n\t\t\t\t\tsummary,\n\t\t\t\t\tcontent,\n\t\t\t\t\ttags,\n\t\t\t\t\tcontent='memory_events',\n\t\t\t\t\tcontent_rowid='rowid'\n\t\t\t\t);\n\n\t\t\t\tCREATE TRIGGER IF NOT EXISTS memory_events_ai AFTER INSERT ON memory_events BEGIN\n\t\t\t\t\tINSERT INTO memory_events_fts(rowid, summary, content, tags)\n\t\t\t\t\tVALUES (new.rowid, new.summary, IFNULL(new.content, ''), IFNULL(new.tags, ''));\n\t\t\t\tEND;\n\n\t\t\t\tCREATE TRIGGER IF NOT EXISTS memory_events_ad AFTER DELETE ON memory_events BEGIN\n\t\t\t\t\tINSERT INTO memory_events_fts(memory_events_fts, rowid, summary, content, tags)\n\t\t\t\t\tVALUES('delete', old.rowid, old.summary, IFNULL(old.content, ''), IFNULL(old.tags, ''));\n\t\t\t\tEND;\n\n\t\t\t\tCREATE TRIGGER IF NOT EXISTS memory_events_au AFTER UPDATE ON memory_events BEGIN\n\t\t\t\t\tINSERT INTO memory_events_fts(memory_events_fts, rowid, summary, content, tags)\n\t\t\t\t\tVALUES('delete', old.rowid, old.summary, IFNULL(old.content, ''), IFNULL(old.tags, ''));\n\t\t\t\t\tINSERT INTO memory_events_fts(rowid, summary, content, tags)\n\t\t\t\t\tVALUES (new.rowid, new.summary, IFNULL(new.content, ''), IFNULL(new.tags, ''));\n\t\t\t\tEND;\n\t\t\t`);\n\t\t\tdb.prepare(\"DELETE FROM memory_schema_version\").run();\n\t\t\tdb.prepare(\"INSERT INTO memory_schema_version (version) VALUES (?)\").run(CURRENT_SCHEMA_VERSION);\n\t\t}\n\t}\n\n\tprivate openDatabase(): Database.Database {\n\t\treturn new Database(this.dbPath);\n\t}\n\n\tprivate async enqueueWrite<T>(operation: () => T): Promise<T> {\n\t\tconst pending = this.writeQueue.then(operation, operation);\n\t\tthis.writeQueue = pending.then(\n\t\t\t() => undefined,\n\t\t\t() => undefined,\n\t\t);\n\t\treturn pending;\n\t}\n\n\tprivate ensureProject(session: MemorySessionIdentity): void {\n\t\tconst now = new Date().toISOString();\n\t\tthis.open()\n\t\t\t.prepare(\n\t\t\t\t`INSERT INTO memory_projects (project_id, root_path, git_remote, current_branch, created_at, last_seen_at)\n\t\t\t\t VALUES (@projectId, @rootPath, NULL, NULL, @now, @now)\n\t\t\t\t ON CONFLICT(project_id) DO UPDATE SET last_seen_at = excluded.last_seen_at`,\n\t\t\t)\n\t\t\t.run({ projectId: session.projectId, rootPath: session.cwd, now });\n\t}\n\n\tprivate ensureSession(session: MemorySessionIdentity): void {\n\t\tconst now = new Date().toISOString();\n\t\tthis.open()\n\t\t\t.prepare(\n\t\t\t\t`INSERT INTO memory_sessions (session_id, project_id, cwd, continuity_session_id, model, provider, started_at, last_seen_at)\n\t\t\t\t VALUES (@sessionId, @projectId, @cwd, @continuitySessionId, @model, @provider, @now, @now)\n\t\t\t\t ON CONFLICT(session_id) DO UPDATE SET last_seen_at = excluded.last_seen_at`,\n\t\t\t)\n\t\t\t.run({\n\t\t\t\tsessionId: session.sessionId,\n\t\t\t\tprojectId: session.projectId,\n\t\t\t\tcwd: session.cwd,\n\t\t\t\tcontinuitySessionId: session.continuitySessionId ?? null,\n\t\t\t\tmodel: session.model ?? null,\n\t\t\t\tprovider: session.provider ?? null,\n\t\t\t\tnow,\n\t\t\t});\n\t}\n}\n"]}

package/dist/core/memory/startup-order.d.ts

@@ -0,0 +1,9 @@
+export type ThreadwellStartupReadLayer = "settings" | "continuity" | "event_memory" | "context" | "adrs" | "retrieval_capsule";
+export interface ThreadwellStartupReadStep {
+    layer: ThreadwellStartupReadLayer;
+    description: string;
+    optional: boolean;
+}
+export declare const THREADWELL_STARTUP_READ_ORDER: readonly ThreadwellStartupReadStep[];
+export declare function renderStartupReadOrder(): string;
+//# sourceMappingURL=startup-order.d.ts.map

package/dist/core/memory/startup-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-order.d.ts","sourceRoot":"","sources":["../../../src/core/memory/startup-order.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,0BAA0B,GACnC,UAAU,GACV,YAAY,GACZ,cAAc,GACd,SAAS,GACT,MAAM,GACN,mBAAmB,CAAC;AAEvB,MAAM,WAAW,yBAAyB;IACzC,KAAK,EAAE,0BAA0B,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,6BAA6B,EAAE,SAAS,yBAAyB,EA+BpE,CAAC;AAEX,wBAAgB,sBAAsB,IAAI,MAAM,CAO/C","sourcesContent":["export type ThreadwellStartupReadLayer =\n\t| \"settings\"\n\t| \"continuity\"\n\t| \"event_memory\"\n\t| \"context\"\n\t| \"adrs\"\n\t| \"retrieval_capsule\";\n\nexport interface ThreadwellStartupReadStep {\n\tlayer: ThreadwellStartupReadLayer;\n\tdescription: string;\n\toptional: boolean;\n}\n\nexport const THREADWELL_STARTUP_READ_ORDER: readonly ThreadwellStartupReadStep[] = [\n\t{\n\t\tlayer: \"settings\",\n\t\tdescription: \"Read continuity and memory settings before installing providers or stores.\",\n\t\toptional: false,\n\t},\n\t{\n\t\tlayer: \"continuity\",\n\t\tdescription: \"Load operational continuity first so current task, blockers, and next action stay authoritative.\",\n\t\toptional: true,\n\t},\n\t{\n\t\tlayer: \"event_memory\",\n\t\tdescription: \"Open event memory store after settings and before retrieval.\",\n\t\toptional: true,\n\t},\n\t{\n\t\tlayer: \"context\",\n\t\tdescription: \"Read CONTEXT.md as semantic vocabulary, preserving manual edits.\",\n\t\toptional: true,\n\t},\n\t{\n\t\tlayer: \"adrs\",\n\t\tdescription: \"Read accepted ADRs as durable current decisions; ignore superseded decisions for active context.\",\n\t\toptional: true,\n\t},\n\t{\n\t\tlayer: \"retrieval_capsule\",\n\t\tdescription: \"Build a bounded cited capsule from continuity, memory, context terms, and active ADRs.\",\n\t\toptional: true,\n\t},\n] as const;\n\nexport function renderStartupReadOrder(): string {\n\treturn [\n\t\t\"Threadwell startup read order:\",\n\t\t...THREADWELL_STARTUP_READ_ORDER.map(\n\t\t\t(step, index) => `${index + 1}. ${step.layer}${step.optional ? \" (optional)\" : \"\"}: ${step.description}`,\n\t\t),\n\t].join(\"\\n\");\n}\n"]}

package/dist/core/memory/startup-order.js

@@ -0,0 +1,39 @@
+export const THREADWELL_STARTUP_READ_ORDER = [
+    {
+        layer: "settings",
+        description: "Read continuity and memory settings before installing providers or stores.",
+        optional: false,
+    },
+    {
+        layer: "continuity",
+        description: "Load operational continuity first so current task, blockers, and next action stay authoritative.",
+        optional: true,
+    },
+    {
+        layer: "event_memory",
+        description: "Open event memory store after settings and before retrieval.",
+        optional: true,
+    },
+    {
+        layer: "context",
+        description: "Read CONTEXT.md as semantic vocabulary, preserving manual edits.",
+        optional: true,
+    },
+    {
+        layer: "adrs",
+        description: "Read accepted ADRs as durable current decisions; ignore superseded decisions for active context.",
+        optional: true,
+    },
+    {
+        layer: "retrieval_capsule",
+        description: "Build a bounded cited capsule from continuity, memory, context terms, and active ADRs.",
+        optional: true,
+    },
+];
+export function renderStartupReadOrder() {
+    return [
+        "Threadwell startup read order:",
+        ...THREADWELL_STARTUP_READ_ORDER.map((step, index) => `${index + 1}. ${step.layer}${step.optional ? " (optional)" : ""}: ${step.description}`),
+    ].join("\n");
+}
+//# sourceMappingURL=startup-order.js.map

package/dist/core/memory/startup-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-order.js","sourceRoot":"","sources":["../../../src/core/memory/startup-order.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,6BAA6B,GAAyC;IAClF;QACC,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,4EAA4E;QACzF,QAAQ,EAAE,KAAK;KACf;IACD;QACC,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,kGAAkG;QAC/G,QAAQ,EAAE,IAAI;KACd;IACD;QACC,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,8DAA8D;QAC3E,QAAQ,EAAE,IAAI;KACd;IACD;QACC,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,kEAAkE;QAC/E,QAAQ,EAAE,IAAI;KACd;IACD;QACC,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,kGAAkG;QAC/G,QAAQ,EAAE,IAAI;KACd;IACD;QACC,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,wFAAwF;QACrG,QAAQ,EAAE,IAAI;KACd;CACQ,CAAC;AAEX,MAAM,UAAU,sBAAsB,GAAW;IAChD,OAAO;QACN,gCAAgC;QAChC,GAAG,6BAA6B,CAAC,GAAG,CACnC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CACxG;KACD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAAA,CACb","sourcesContent":["export type ThreadwellStartupReadLayer =\n\t| \"settings\"\n\t| \"continuity\"\n\t| \"event_memory\"\n\t| \"context\"\n\t| \"adrs\"\n\t| \"retrieval_capsule\";\n\nexport interface ThreadwellStartupReadStep {\n\tlayer: ThreadwellStartupReadLayer;\n\tdescription: string;\n\toptional: boolean;\n}\n\nexport const THREADWELL_STARTUP_READ_ORDER: readonly ThreadwellStartupReadStep[] = [\n\t{\n\t\tlayer: \"settings\",\n\t\tdescription: \"Read continuity and memory settings before installing providers or stores.\",\n\t\toptional: false,\n\t},\n\t{\n\t\tlayer: \"continuity\",\n\t\tdescription: \"Load operational continuity first so current task, blockers, and next action stay authoritative.\",\n\t\toptional: true,\n\t},\n\t{\n\t\tlayer: \"event_memory\",\n\t\tdescription: \"Open event memory store after settings and before retrieval.\",\n\t\toptional: true,\n\t},\n\t{\n\t\tlayer: \"context\",\n\t\tdescription: \"Read CONTEXT.md as semantic vocabulary, preserving manual edits.\",\n\t\toptional: true,\n\t},\n\t{\n\t\tlayer: \"adrs\",\n\t\tdescription: \"Read accepted ADRs as durable current decisions; ignore superseded decisions for active context.\",\n\t\toptional: true,\n\t},\n\t{\n\t\tlayer: \"retrieval_capsule\",\n\t\tdescription: \"Build a bounded cited capsule from continuity, memory, context terms, and active ADRs.\",\n\t\toptional: true,\n\t},\n] as const;\n\nexport function renderStartupReadOrder(): string {\n\treturn [\n\t\t\"Threadwell startup read order:\",\n\t\t...THREADWELL_STARTUP_READ_ORDER.map(\n\t\t\t(step, index) => `${index + 1}. ${step.layer}${step.optional ? \" (optional)\" : \"\"}: ${step.description}`,\n\t\t),\n\t].join(\"\\n\");\n}\n"]}

package/dist/core/messages.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Custom message types and transformers for the coding agent.
+ *
+ * Extends the base AgentMessage type with coding-agent specific message types,
+ * and provides a transformer to convert them to LLM-compatible messages.
+ */
+import type { AgentMessage } from "@threadwell/agent-core";
+import type { ImageContent, Message, TextContent } from "@threadwell/ai";
+export declare const COMPACTION_SUMMARY_PREFIX = "The conversation history before this point was compacted into the following summary:\n\n<summary>\n";
+export declare const COMPACTION_SUMMARY_SUFFIX = "\n</summary>";
+export declare const BRANCH_SUMMARY_PREFIX = "The following is a summary of a branch that this conversation came back from:\n\n<summary>\n";
+export declare const BRANCH_SUMMARY_SUFFIX = "</summary>";
+/**
+ * Message type for bash executions via the ! command.
+ */
+export interface BashExecutionMessage {
+    role: "bashExecution";
+    command: string;
+    output: string;
+    exitCode: number | undefined;
+    cancelled: boolean;
+    truncated: boolean;
+    fullOutputPath?: string;
+    timestamp: number;
+    /** If true, this message is excluded from LLM context (!! prefix) */
+    excludeFromContext?: boolean;
+}
+/**
+ * Message type for extension-injected messages via sendMessage().
+ * These are custom messages that extensions can inject into the conversation.
+ */
+export interface CustomMessage<T = unknown> {
+    role: "custom";
+    customType: string;
+    content: string | (TextContent | ImageContent)[];
+    display: boolean;
+    details?: T;
+    timestamp: number;
+}
+export interface BranchSummaryMessage {
+    role: "branchSummary";
+    summary: string;
+    fromId: string;
+    timestamp: number;
+}
+export interface CompactionSummaryMessage {
+    role: "compactionSummary";
+    summary: string;
+    tokensBefore: number;
+    timestamp: number;
+}
+declare module "@threadwell/agent-core" {
+    interface CustomAgentMessages {
+        bashExecution: BashExecutionMessage;
+        custom: CustomMessage;
+        branchSummary: BranchSummaryMessage;
+        compactionSummary: CompactionSummaryMessage;
+    }
+}
+/**
+ * Convert a BashExecutionMessage to user message text for LLM context.
+ */
+export declare function bashExecutionToText(msg: BashExecutionMessage): string;
+export declare function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage;
+export declare function createCompactionSummaryMessage(summary: string, tokensBefore: number, timestamp: string): CompactionSummaryMessage;
+/** Convert CustomMessageEntry to AgentMessage format */
+export declare function createCustomMessage(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details: unknown | undefined, timestamp: string): CustomMessage;
+/**
+ * Transform AgentMessages (including custom types) to LLM-compatible Messages.
+ *
+ * This is used by:
+ * - Agent's transormToLlm option (for prompt calls and queued messages)
+ * - Compaction's generateSummary (for summarization)
+ * - Custom extensions and tools
+ */
+export declare function convertToLlm(messages: AgentMessage[]): Message[];
+//# sourceMappingURL=messages.d.ts.map

package/dist/core/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/core/messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEzE,eAAO,MAAM,yBAAyB,wGAGrC,CAAC;AAEF,eAAO,MAAM,yBAAyB,iBAC3B,CAAC;AAEZ,eAAO,MAAM,qBAAqB,iGAGjC,CAAC;AAEF,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,CAAC;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CAClB;AAGD,OAAO,QAAQ,wBAAwB,CAAC,CAAC;IACxC,UAAU,mBAAmB;QAC5B,aAAa,EAAE,oBAAoB,CAAC;QACpC,MAAM,EAAE,aAAa,CAAC;QACtB,aAAa,EAAE,oBAAoB,CAAC;QACpC,iBAAiB,EAAE,wBAAwB,CAAC;KAC5C;CACD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAgBrE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAOnH;AAED,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GACf,wBAAwB,CAO1B;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,EAChD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,SAAS,EAAE,MAAM,GACf,aAAa,CASf;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CA+ChE","sourcesContent":["/**\n * Custom message types and transformers for the coding agent.\n *\n * Extends the base AgentMessage type with coding-agent specific message types,\n * and provides a transformer to convert them to LLM-compatible messages.\n */\n\nimport type { AgentMessage } from \"@threadwell/agent-core\";\nimport type { ImageContent, Message, TextContent } from \"@threadwell/ai\";\n\nexport const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:\n\n<summary>\n`;\n\nexport const COMPACTION_SUMMARY_SUFFIX = `\n</summary>`;\n\nexport const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:\n\n<summary>\n`;\n\nexport const BRANCH_SUMMARY_SUFFIX = `</summary>`;\n\n/**\n * Message type for bash executions via the ! command.\n */\nexport interface BashExecutionMessage {\n\trole: \"bashExecution\";\n\tcommand: string;\n\toutput: string;\n\texitCode: number | undefined;\n\tcancelled: boolean;\n\ttruncated: boolean;\n\tfullOutputPath?: string;\n\ttimestamp: number;\n\t/** If true, this message is excluded from LLM context (!! prefix) */\n\texcludeFromContext?: boolean;\n}\n\n/**\n * Message type for extension-injected messages via sendMessage().\n * These are custom messages that extensions can inject into the conversation.\n */\nexport interface CustomMessage<T = unknown> {\n\trole: \"custom\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdisplay: boolean;\n\tdetails?: T;\n\ttimestamp: number;\n}\n\nexport interface BranchSummaryMessage {\n\trole: \"branchSummary\";\n\tsummary: string;\n\tfromId: string;\n\ttimestamp: number;\n}\n\nexport interface CompactionSummaryMessage {\n\trole: \"compactionSummary\";\n\tsummary: string;\n\ttokensBefore: number;\n\ttimestamp: number;\n}\n\n// Extend CustomAgentMessages via declaration merging\ndeclare module \"@threadwell/agent-core\" {\n\tinterface CustomAgentMessages {\n\t\tbashExecution: BashExecutionMessage;\n\t\tcustom: CustomMessage;\n\t\tbranchSummary: BranchSummaryMessage;\n\t\tcompactionSummary: CompactionSummaryMessage;\n\t}\n}\n\n/**\n * Convert a BashExecutionMessage to user message text for LLM context.\n */\nexport function bashExecutionToText(msg: BashExecutionMessage): string {\n\tlet text = `Ran \\`${msg.command}\\`\\n`;\n\tif (msg.output) {\n\t\ttext += `\\`\\`\\`\\n${msg.output}\\n\\`\\`\\``;\n\t} else {\n\t\ttext += \"(no output)\";\n\t}\n\tif (msg.cancelled) {\n\t\ttext += \"\\n\\n(command cancelled)\";\n\t} else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {\n\t\ttext += `\\n\\nCommand exited with code ${msg.exitCode}`;\n\t}\n\tif (msg.truncated && msg.fullOutputPath) {\n\t\ttext += `\\n\\n[Output truncated. Full output: ${msg.fullOutputPath}]`;\n\t}\n\treturn text;\n}\n\nexport function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage {\n\treturn {\n\t\trole: \"branchSummary\",\n\t\tsummary,\n\t\tfromId,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\nexport function createCompactionSummaryMessage(\n\tsummary: string,\n\ttokensBefore: number,\n\ttimestamp: string,\n): CompactionSummaryMessage {\n\treturn {\n\t\trole: \"compactionSummary\",\n\t\tsummary: summary,\n\t\ttokensBefore,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/** Convert CustomMessageEntry to AgentMessage format */\nexport function createCustomMessage(\n\tcustomType: string,\n\tcontent: string | (TextContent | ImageContent)[],\n\tdisplay: boolean,\n\tdetails: unknown | undefined,\n\ttimestamp: string,\n): CustomMessage {\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType,\n\t\tcontent,\n\t\tdisplay,\n\t\tdetails,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/**\n * Transform AgentMessages (including custom types) to LLM-compatible Messages.\n *\n * This is used by:\n * - Agent's transormToLlm option (for prompt calls and queued messages)\n * - Compaction's generateSummary (for summarization)\n * - Custom extensions and tools\n */\nexport function convertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages\n\t\t.map((m): Message | undefined => {\n\t\t\tswitch (m.role) {\n\t\t\t\tcase \"bashExecution\":\n\t\t\t\t\t// Skip messages excluded from context (!! prefix)\n\t\t\t\t\tif (m.excludeFromContext) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: bashExecutionToText(m) }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"custom\": {\n\t\t\t\t\tconst content = typeof m.content === \"string\" ? [{ type: \"text\" as const, text: m.content }] : m.content;\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tcase \"branchSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"compactionSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{ type: \"text\" as const, text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },\n\t\t\t\t\t\t],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"user\":\n\t\t\t\tcase \"assistant\":\n\t\t\t\tcase \"toolResult\":\n\t\t\t\t\treturn m;\n\t\t\t\tdefault:\n\t\t\t\t\t// biome-ignore lint/correctness/noSwitchDeclarations: fine\n\t\t\t\t\tconst _exhaustiveCheck: never = m;\n\t\t\t\t\treturn undefined;\n\t\t\t}\n\t\t})\n\t\t.filter((m) => m !== undefined);\n}\n"]}

package/dist/core/messages.js

@@ -0,0 +1,123 @@
+/**
+ * Custom message types and transformers for the coding agent.
+ *
+ * Extends the base AgentMessage type with coding-agent specific message types,
+ * and provides a transformer to convert them to LLM-compatible messages.
+ */
+export const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:
+
+<summary>
+`;
+export const COMPACTION_SUMMARY_SUFFIX = `
+</summary>`;
+export const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:
+
+<summary>
+`;
+export const BRANCH_SUMMARY_SUFFIX = `</summary>`;
+/**
+ * Convert a BashExecutionMessage to user message text for LLM context.
+ */
+export function bashExecutionToText(msg) {
+    let text = `Ran \`${msg.command}\`\n`;
+    if (msg.output) {
+        text += `\`\`\`\n${msg.output}\n\`\`\``;
+    }
+    else {
+        text += "(no output)";
+    }
+    if (msg.cancelled) {
+        text += "\n\n(command cancelled)";
+    }
+    else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {
+        text += `\n\nCommand exited with code ${msg.exitCode}`;
+    }
+    if (msg.truncated && msg.fullOutputPath) {
+        text += `\n\n[Output truncated. Full output: ${msg.fullOutputPath}]`;
+    }
+    return text;
+}
+export function createBranchSummaryMessage(summary, fromId, timestamp) {
+    return {
+        role: "branchSummary",
+        summary,
+        fromId,
+        timestamp: new Date(timestamp).getTime(),
+    };
+}
+export function createCompactionSummaryMessage(summary, tokensBefore, timestamp) {
+    return {
+        role: "compactionSummary",
+        summary: summary,
+        tokensBefore,
+        timestamp: new Date(timestamp).getTime(),
+    };
+}
+/** Convert CustomMessageEntry to AgentMessage format */
+export function createCustomMessage(customType, content, display, details, timestamp) {
+    return {
+        role: "custom",
+        customType,
+        content,
+        display,
+        details,
+        timestamp: new Date(timestamp).getTime(),
+    };
+}
+/**
+ * Transform AgentMessages (including custom types) to LLM-compatible Messages.
+ *
+ * This is used by:
+ * - Agent's transormToLlm option (for prompt calls and queued messages)
+ * - Compaction's generateSummary (for summarization)
+ * - Custom extensions and tools
+ */
+export function convertToLlm(messages) {
+    return messages
+        .map((m) => {
+        switch (m.role) {
+            case "bashExecution":
+                // Skip messages excluded from context (!! prefix)
+                if (m.excludeFromContext) {
+                    return undefined;
+                }
+                return {
+                    role: "user",
+                    content: [{ type: "text", text: bashExecutionToText(m) }],
+                    timestamp: m.timestamp,
+                };
+            case "custom": {
+                const content = typeof m.content === "string" ? [{ type: "text", text: m.content }] : m.content;
+                return {
+                    role: "user",
+                    content,
+                    timestamp: m.timestamp,
+                };
+            }
+            case "branchSummary":
+                return {
+                    role: "user",
+                    content: [{ type: "text", text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],
+                    timestamp: m.timestamp,
+                };
+            case "compactionSummary":
+                return {
+                    role: "user",
+                    content: [
+                        { type: "text", text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },
+                    ],
+                    timestamp: m.timestamp,
+                };
+            case "user":
+            case "assistant":
+            case "toolResult":
+                return m;
+            default:
+                // biome-ignore lint/correctness/noSwitchDeclarations: fine
+                const _exhaustiveCheck = m;
+                return undefined;
+        }
+    })
+        .filter((m) => m !== undefined);
+}
+//# sourceMappingURL=messages.js.map

package/dist/core/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/core/messages.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Custom message types and transformers for the coding agent.\n *\n * Extends the base AgentMessage type with coding-agent specific message types,\n * and provides a transformer to convert them to LLM-compatible messages.\n */\n\nimport type { AgentMessage } from \"@threadwell/agent-core\";\nimport type { ImageContent, Message, TextContent } from \"@threadwell/ai\";\n\nexport const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:\n\n<summary>\n`;\n\nexport const COMPACTION_SUMMARY_SUFFIX = `\n</summary>`;\n\nexport const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:\n\n<summary>\n`;\n\nexport const BRANCH_SUMMARY_SUFFIX = `</summary>`;\n\n/**\n * Message type for bash executions via the ! command.\n */\nexport interface BashExecutionMessage {\n\trole: \"bashExecution\";\n\tcommand: string;\n\toutput: string;\n\texitCode: number | undefined;\n\tcancelled: boolean;\n\ttruncated: boolean;\n\tfullOutputPath?: string;\n\ttimestamp: number;\n\t/** If true, this message is excluded from LLM context (!! prefix) */\n\texcludeFromContext?: boolean;\n}\n\n/**\n * Message type for extension-injected messages via sendMessage().\n * These are custom messages that extensions can inject into the conversation.\n */\nexport interface CustomMessage<T = unknown> {\n\trole: \"custom\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdisplay: boolean;\n\tdetails?: T;\n\ttimestamp: number;\n}\n\nexport interface BranchSummaryMessage {\n\trole: \"branchSummary\";\n\tsummary: string;\n\tfromId: string;\n\ttimestamp: number;\n}\n\nexport interface CompactionSummaryMessage {\n\trole: \"compactionSummary\";\n\tsummary: string;\n\ttokensBefore: number;\n\ttimestamp: number;\n}\n\n// Extend CustomAgentMessages via declaration merging\ndeclare module \"@threadwell/agent-core\" {\n\tinterface CustomAgentMessages {\n\t\tbashExecution: BashExecutionMessage;\n\t\tcustom: CustomMessage;\n\t\tbranchSummary: BranchSummaryMessage;\n\t\tcompactionSummary: CompactionSummaryMessage;\n\t}\n}\n\n/**\n * Convert a BashExecutionMessage to user message text for LLM context.\n */\nexport function bashExecutionToText(msg: BashExecutionMessage): string {\n\tlet text = `Ran \\`${msg.command}\\`\\n`;\n\tif (msg.output) {\n\t\ttext += `\\`\\`\\`\\n${msg.output}\\n\\`\\`\\``;\n\t} else {\n\t\ttext += \"(no output)\";\n\t}\n\tif (msg.cancelled) {\n\t\ttext += \"\\n\\n(command cancelled)\";\n\t} else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {\n\t\ttext += `\\n\\nCommand exited with code ${msg.exitCode}`;\n\t}\n\tif (msg.truncated && msg.fullOutputPath) {\n\t\ttext += `\\n\\n[Output truncated. Full output: ${msg.fullOutputPath}]`;\n\t}\n\treturn text;\n}\n\nexport function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage {\n\treturn {\n\t\trole: \"branchSummary\",\n\t\tsummary,\n\t\tfromId,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\nexport function createCompactionSummaryMessage(\n\tsummary: string,\n\ttokensBefore: number,\n\ttimestamp: string,\n): CompactionSummaryMessage {\n\treturn {\n\t\trole: \"compactionSummary\",\n\t\tsummary: summary,\n\t\ttokensBefore,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/** Convert CustomMessageEntry to AgentMessage format */\nexport function createCustomMessage(\n\tcustomType: string,\n\tcontent: string | (TextContent | ImageContent)[],\n\tdisplay: boolean,\n\tdetails: unknown | undefined,\n\ttimestamp: string,\n): CustomMessage {\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType,\n\t\tcontent,\n\t\tdisplay,\n\t\tdetails,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/**\n * Transform AgentMessages (including custom types) to LLM-compatible Messages.\n *\n * This is used by:\n * - Agent's transormToLlm option (for prompt calls and queued messages)\n * - Compaction's generateSummary (for summarization)\n * - Custom extensions and tools\n */\nexport function convertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages\n\t\t.map((m): Message | undefined => {\n\t\t\tswitch (m.role) {\n\t\t\t\tcase \"bashExecution\":\n\t\t\t\t\t// Skip messages excluded from context (!! prefix)\n\t\t\t\t\tif (m.excludeFromContext) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: bashExecutionToText(m) }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"custom\": {\n\t\t\t\t\tconst content = typeof m.content === \"string\" ? [{ type: \"text\" as const, text: m.content }] : m.content;\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tcase \"branchSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"compactionSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{ type: \"text\" as const, text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },\n\t\t\t\t\t\t],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"user\":\n\t\t\t\tcase \"assistant\":\n\t\t\t\tcase \"toolResult\":\n\t\t\t\t\treturn m;\n\t\t\t\tdefault:\n\t\t\t\t\t// biome-ignore lint/correctness/noSwitchDeclarations: fine\n\t\t\t\t\tconst _exhaustiveCheck: never = m;\n\t\t\t\t\treturn undefined;\n\t\t\t}\n\t\t})\n\t\t.filter((m) => m !== undefined);\n}\n"]}