@jini-ai/sqlite 0.1.0

package/dist/db/capabilities/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../src/db/capabilities/capabilities.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAqB7C,SAAS,mBAAmB,CAAC,CAAQ;IACnC,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,eAAyB,CAAC;QACpD,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,qKAAqK;AACrK,MAAM,UAAU,0BAA0B,CAAC,EAAY,EAAE,GAA2E;IAClI,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9C,EAAE,CAAC,OAAO,CACR;;;;;;wCAMoC,CACrC,CAAC,GAAG,CAAC;QACJ,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC;QAChD,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,SAAS;KACV,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,yBAAyB,CAAC,EAAY;IACpD,OAAO,IAAI,CACT,EAAE,CAAC,OAAO,CACR;iDAC2C,CAC5C,CAAC,GAAG,EAAE,CACR,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAC7B,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,uBAAuB,CAAC,EAAY,EAAE,EAAU;IAC9D,MAAM,CAAC,GAAG,GAAG,CACX,EAAE,CAAC,OAAO,CACR;kDAC4C,CAC7C,CAAC,GAAG,CAAC,EAAE,CAAC,CACV,CAAC;IACF,OAAO,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3C,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,yBAAyB,CAAC,EAAY,EAAE,MAAiC;IACvF,EAAE,CAAC,OAAO,CACR;;gHAE4G,CAC7G,CAAC,GAAG,CAAC;QACJ,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC;QAC/C,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;QAC9E,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI;QAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI;KACxC,CAAC,CAAC;AACL,CAAC"}

package/dist/db/capabilities/index.d.ts

@@ -0,0 +1,4 @@
+/** @module db/capabilities/index
+ * Public re-export surface for the capabilities/ concern subdirectory. */
+export * from './capabilities.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/db/capabilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/db/capabilities/index.ts"],"names":[],"mappings":"AAAA;0EAC0E;AAC1E,cAAc,mBAAmB,CAAC"}

package/dist/db/capabilities/index.js

@@ -0,0 +1,4 @@
+/** @module db/capabilities/index
+ * Public re-export surface for the capabilities/ concern subdirectory. */
+export * from './capabilities.js';
+//# sourceMappingURL=index.js.map

package/dist/db/capabilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/db/capabilities/index.ts"],"names":[],"mappings":"AAAA;0EAC0E;AAC1E,cAAc,mBAAmB,CAAC"}

package/dist/db/connection/connection.d.ts

@@ -0,0 +1,18 @@
+import type { SqliteDb } from '../core/index.js';
+/**
+ * Open (or return the cached) project database at `<dataDir>/app.sqlite`, creating the
+ * directory if needed, enabling WAL + foreign keys, and running all pending schema migrations.
+ * Calling with a different resolved path closes the previous connection first.
+ * @param projectRoot - fallback parent directory when `dataDir` is not supplied (uses a `.jini` subfolder)
+ * @param options.dataDir - explicit data directory; overrides the default `.jini` subfolder
+ * @returns the live `SqliteDb` handle, ready for immediate use
+ */
+export declare function openDatabase(projectRoot: string, { dataDir }?: {
+    dataDir?: string;
+}): SqliteDb;
+/**
+ * Close the active database connection and clear the module-level singleton.
+ * Safe to call when no connection is open (no-op in that case).
+ */
+export declare function closeDatabase(): void;
+//# sourceMappingURL=connection.d.ts.map

package/dist/db/connection/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/db/connection/connection.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAOjD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,QAAQ,CAalG;AAED;;;GAGG;AACH,wBAAgB,aAAa,SAK5B"}

package/dist/db/connection/connection.js

@@ -0,0 +1,48 @@
+/** @module db/connection/connection
+ * Database lifecycle: opens and closes the module-level better-sqlite3 singleton.
+ * Reaches the `schema` sibling barrel to run `migrate` immediately after every `openDatabase` call;
+ * that is the only cross-concern edge in the db module.
+ */
+import Database from 'better-sqlite3';
+import path from 'node:path';
+import fs from 'node:fs';
+import { migrate } from '../schema/index.js';
+/** @internal Module-level singleton tracking the currently-open database handle and its resolved file path. */
+let dbInstance = null;
+let dbFile = null;
+/**
+ * Open (or return the cached) project database at `<dataDir>/app.sqlite`, creating the
+ * directory if needed, enabling WAL + foreign keys, and running all pending schema migrations.
+ * Calling with a different resolved path closes the previous connection first.
+ * @param projectRoot - fallback parent directory when `dataDir` is not supplied (uses a `.jini` subfolder)
+ * @param options.dataDir - explicit data directory; overrides the default `.jini` subfolder
+ * @returns the live `SqliteDb` handle, ready for immediate use
+ */
+export function openDatabase(projectRoot, { dataDir } = {}) {
+    const dir = dataDir ? path.resolve(dataDir) : path.join(projectRoot, '.jini');
+    const file = path.join(dir, 'app.sqlite');
+    if (dbInstance && dbFile === file)
+        return dbInstance;
+    if (dbInstance)
+        closeDatabase();
+    fs.mkdirSync(dir, { recursive: true });
+    const db = new Database(file);
+    db.pragma('journal_mode = WAL');
+    db.pragma('foreign_keys = ON');
+    migrate(db);
+    dbInstance = db;
+    dbFile = file;
+    return db;
+}
+/**
+ * Close the active database connection and clear the module-level singleton.
+ * Safe to call when no connection is open (no-op in that case).
+ */
+export function closeDatabase() {
+    if (!dbInstance)
+        return;
+    dbInstance.close();
+    dbInstance = null;
+    dbFile = null;
+}
+//# sourceMappingURL=connection.js.map

package/dist/db/connection/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../src/db/connection/connection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,+GAA+G;AAC/G,IAAI,UAAU,GAAoB,IAAI,CAAC;AACvC,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,EAAE,OAAO,KAA2B,EAAE;IACtF,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC1C,IAAI,UAAU,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,UAAU,CAAC;IACrD,IAAI,UAAU;QAAE,aAAa,EAAE,CAAC;IAChC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,UAAU,GAAG,EAAE,CAAC;IAChB,MAAM,GAAG,IAAI,CAAC;IACd,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,UAAU;QAAE,OAAO;IACxB,UAAU,CAAC,KAAK,EAAE,CAAC;IACnB,UAAU,GAAG,IAAI,CAAC;IAClB,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC"}

package/dist/db/connection/index.d.ts

@@ -0,0 +1,3 @@
+/** @module db/connection/index */
+export { openDatabase, closeDatabase } from './connection.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/db/connection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/db/connection/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/db/connection/index.js

@@ -0,0 +1,3 @@
+/** @module db/connection/index */
+export { openDatabase, closeDatabase } from './connection.js';
+//# sourceMappingURL=index.js.map

package/dist/db/connection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/db/connection/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/db/conversations/conversations.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @module db/conversations/conversations
+ * Owns conversation CRUD and list/get queries with per-conversation run summaries and
+ * total run-duration aggregation. Imports only the core/ kernel (types + rows helper).
+ */
+import type { SqliteDb, DbRow, ChatSessionMode } from '../core/index.js';
+/**
+ * Returns all conversations for a project, newest first, each enriched with message count,
+ * the latest assistant run summary, and total accumulated run duration across all terminal runs.
+ * @param db Open SQLite database handle.
+ * @param projectId The project whose conversations to list.
+ */
+export declare function listConversations(db: SqliteDb, projectId: string): {
+    latestRun: {
+        durationMs?: number;
+        endedAt?: number | undefined;
+        startedAt?: number | undefined;
+        status: string;
+    } | undefined;
+    totalDurationMs?: number;
+    id: any;
+    projectId: any;
+    title: any;
+    sessionMode: ChatSessionMode;
+    messageCount: number;
+    createdAt: number;
+    updatedAt: number;
+}[];
+/**
+ * Fetches a single conversation by id with its latest run summary and total run duration.
+ * Returns null when no matching conversation exists.
+ * @param db Open SQLite database handle.
+ * @param id Conversation id.
+ */
+export declare function getConversation(db: SqliteDb, id: string): {
+    totalDurationMs?: number;
+    latestRun: {
+        durationMs?: number;
+        endedAt?: number | undefined;
+        startedAt?: number | undefined;
+        status: string;
+    } | undefined;
+    id: any;
+    projectId: any;
+    title: any;
+    sessionMode: ChatSessionMode;
+    messageCount: number;
+    createdAt: number;
+    updatedAt: number;
+} | null;
+/**
+ * Coerces an arbitrary database value to a valid ChatSessionMode, defaulting to 'design'.
+ * Upholds the invariant that no conversation ever carries an unknown session mode.
+ * @param value Raw value read from the session_mode column.
+ * @returns A valid ChatSessionMode: 'chat', 'plan', or 'design'.
+ */
+export declare function normalizeConversationSessionMode(value: unknown): ChatSessionMode;
+/**
+ * Inserts a new conversation row and returns the full conversation record (including run summary).
+ * Normalizes sessionMode before persisting so the stored value is always a valid ChatSessionMode.
+ * @param db Open SQLite database handle.
+ * @param c Conversation fields to insert.
+ */
+export declare function insertConversation(db: SqliteDb, c: DbRow): {
+    totalDurationMs?: number;
+    latestRun: {
+        durationMs?: number;
+        endedAt?: number | undefined;
+        startedAt?: number | undefined;
+        status: string;
+    } | undefined;
+    id: any;
+    projectId: any;
+    title: any;
+    sessionMode: ChatSessionMode;
+    messageCount: number;
+    createdAt: number;
+    updatedAt: number;
+} | null;
+/**
+ * Applies a partial patch to an existing conversation, merging with the current record.
+ * Returns null when the conversation does not exist; otherwise returns the updated record.
+ * @param db Open SQLite database handle.
+ * @param id Conversation id to update.
+ * @param patch Fields to overwrite; sessionMode and updatedAt are normalized before persisting.
+ */
+export declare function updateConversation(db: SqliteDb, id: string, patch: DbRow): {
+    totalDurationMs?: number;
+    latestRun: {
+        durationMs?: number;
+        endedAt?: number | undefined;
+        startedAt?: number | undefined;
+        status: string;
+    } | undefined;
+    id: any;
+    projectId: any;
+    title: any;
+    sessionMode: ChatSessionMode;
+    messageCount: number;
+    createdAt: number;
+    updatedAt: number;
+} | null;
+/**
+ * Removes a conversation row by id. Cascading deletes on messages are handled by the schema.
+ * @param db Open SQLite database handle.
+ * @param id Conversation id to delete.
+ */
+export declare function deleteConversation(db: SqliteDb, id: string): void;
+//# sourceMappingURL=conversations.d.ts.map

package/dist/db/conversations/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../../src/db/conversations/conversations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGzE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;IA4DhE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM;;;;;;;;;;;;;;;SAevD;AAuBD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAEhF;AA6HD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK;;;;;;;;;;;;;;;SAcxD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;;;;;;;;;;;;;;;SAgBxE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,QAE1D"}

package/dist/db/conversations/conversations.js

@@ -0,0 +1,274 @@
+import { rows } from '../core/index.js';
+/**
+ * Returns all conversations for a project, newest first, each enriched with message count,
+ * the latest assistant run summary, and total accumulated run duration across all terminal runs.
+ * @param db Open SQLite database handle.
+ * @param projectId The project whose conversations to list.
+ */
+export function listConversations(db, projectId) {
+    return rows(db
+        .prepare(`WITH project_conversations AS (
+          SELECT id, project_id AS projectId, title, session_mode AS sessionMode,
+                 created_at AS createdAt, updated_at AS updatedAt
+            FROM conversations
+           WHERE project_id = ?
+        ),
+        latest_runs AS (
+          SELECT conversation_id AS conversationId,
+                 run_status AS latestRunStatus,
+                 started_at AS latestRunStartedAt,
+                 ended_at AS latestRunEndedAt,
+                 events_json AS latestRunEventsJson
+            FROM (
+              SELECT m.conversation_id,
+                     m.run_status,
+                     m.started_at,
+                     m.ended_at,
+                     m.events_json,
+                     ROW_NUMBER() OVER (
+                       PARTITION BY m.conversation_id
+                       ORDER BY m.position DESC
+                     ) AS rn
+                FROM messages m
+                JOIN project_conversations c ON c.id = m.conversation_id
+               WHERE m.role = 'assistant'
+                 AND m.run_status IS NOT NULL
+            )
+           WHERE rn = 1
+        ),
+        message_counts AS (
+          SELECT m.conversation_id AS conversationId,
+                 COUNT(*) AS messageCount
+            FROM messages m
+            JOIN project_conversations c ON c.id = m.conversation_id
+           GROUP BY m.conversation_id
+        ),
+        total_run_durations AS (
+          SELECT m.conversation_id AS conversationId,
+                 SUM(${terminalRunDurationSql('m')}) AS totalDurationMs
+            FROM messages m
+            JOIN project_conversations c ON c.id = m.conversation_id
+           WHERE m.role = 'assistant'
+             AND m.run_status IN ('succeeded', 'failed', 'canceled')
+           GROUP BY m.conversation_id
+        )
+        SELECT c.id, c.projectId, c.title, c.sessionMode, c.createdAt, c.updatedAt,
+               COALESCE(mc.messageCount, 0) AS messageCount,
+               lr.latestRunStatus, lr.latestRunStartedAt,
+               lr.latestRunEndedAt, lr.latestRunEventsJson,
+               trd.totalDurationMs
+          FROM project_conversations c
+          LEFT JOIN latest_runs lr ON lr.conversationId = c.id
+          LEFT JOIN message_counts mc ON mc.conversationId = c.id
+          LEFT JOIN total_run_durations trd ON trd.conversationId = c.id
+         ORDER BY c.updatedAt DESC`)
+        .all(projectId)).map(normalizeConversation);
+}
+/**
+ * Fetches a single conversation by id with its latest run summary and total run duration.
+ * Returns null when no matching conversation exists.
+ * @param db Open SQLite database handle.
+ * @param id Conversation id.
+ */
+export function getConversation(db, id) {
+    const r = db
+        .prepare(`SELECT id, project_id AS projectId, title, session_mode AS sessionMode,
+              created_at AS createdAt, updated_at AS updatedAt,
+              (SELECT COUNT(*) FROM messages WHERE conversation_id = conversations.id) AS messageCount
+         FROM conversations WHERE id = ?`)
+        .get(id);
+    if (!r)
+        return null;
+    return {
+        ...normalizeConversation(r),
+        latestRun: latestConversationRunSummary(db, r.id) ?? undefined,
+        ...numberProperty('totalDurationMs', totalConversationRunDurationMs(db, r.id)),
+    };
+}
+/** @internal Shapes a raw SQLite row into the canonical conversation object, including run summary. */
+function normalizeConversation(r) {
+    const latestRun = conversationRunSummaryFromRow({
+        runStatus: r.latestRunStatus,
+        startedAt: r.latestRunStartedAt,
+        endedAt: r.latestRunEndedAt,
+        eventsJson: r.latestRunEventsJson,
+    });
+    return {
+        id: r.id,
+        projectId: r.projectId,
+        title: r.title ?? null,
+        sessionMode: normalizeConversationSessionMode(r.sessionMode),
+        messageCount: Number(r.messageCount),
+        createdAt: Number(r.createdAt),
+        updatedAt: Number(r.updatedAt),
+        ...numberProperty('totalDurationMs', r.totalDurationMs),
+        latestRun: latestRun ?? undefined,
+    };
+}
+/**
+ * Coerces an arbitrary database value to a valid ChatSessionMode, defaulting to 'design'.
+ * Upholds the invariant that no conversation ever carries an unknown session mode.
+ * @param value Raw value read from the session_mode column.
+ * @returns A valid ChatSessionMode: 'chat', 'plan', or 'design'.
+ */
+export function normalizeConversationSessionMode(value) {
+    return value === 'chat' || value === 'plan' ? value : 'design';
+}
+/**
+ * @internal Produces a single-key object `{ [key]: number }` only when value is a finite number,
+ * omitting the key entirely otherwise. Generic over `key` (rather than plain `string`) so the
+ * spread of its return type into a caller's object literal carries a real, statically-known
+ * optional property instead of collapsing to an index signature the compiler then can't see
+ * through at the call site.
+ */
+function numberProperty(key, value) {
+    const n = value == null ? undefined : Number(value);
+    return typeof n === 'number' && Number.isFinite(n)
+        ? { [key]: n }
+        : {};
+}
+/** @internal Queries the most recent assistant run summary for a conversation (used by getConversation's per-row fetch path). */
+function latestConversationRunSummary(db, conversationId) {
+    const row = db
+        .prepare(`SELECT run_status AS runStatus,
+              started_at AS startedAt,
+              ended_at AS endedAt,
+              events_json AS eventsJson
+         FROM messages
+        WHERE conversation_id = ?
+          AND role = 'assistant'
+          AND run_status IS NOT NULL
+        ORDER BY position DESC
+        LIMIT 1`)
+        .get(conversationId);
+    return conversationRunSummaryFromRow(row);
+}
+/** @internal Sums terminal-run duration across all succeeded/failed/canceled assistant messages in a conversation. */
+function totalConversationRunDurationMs(db, conversationId) {
+    const row = db
+        .prepare(`SELECT SUM(${terminalRunDurationSql()}) AS totalDurationMs
+         FROM messages
+        WHERE conversation_id = ?
+          AND role = 'assistant'
+          AND run_status IN ('succeeded', 'failed', 'canceled')`)
+        .get(conversationId);
+    return row?.totalDurationMs == null ? undefined : Number(row.totalDurationMs);
+}
+/** @internal Emits the SQL CASE expression that resolves a terminal run's duration: wall-clock diff when both timestamps exist, otherwise the latest usage event's durationMs. */
+function terminalRunDurationSql(alias) {
+    const p = alias ? `${alias}.` : '';
+    return `CASE
+            WHEN ${p}started_at IS NOT NULL AND ${p}ended_at IS NOT NULL THEN
+              CASE
+                WHEN CAST(${p}ended_at AS INTEGER) >= CAST(${p}started_at AS INTEGER)
+                  THEN CAST(${p}ended_at AS INTEGER) - CAST(${p}started_at AS INTEGER)
+                ELSE 0
+              END
+            ELSE (
+              SELECT CASE
+                       WHEN json_extract(usage_event.value, '$.durationMs') >= 0
+                         THEN json_extract(usage_event.value, '$.durationMs')
+                       ELSE 0
+                     END
+                FROM json_each(
+                  CASE
+                    WHEN json_valid(${p}events_json) AND json_type(${p}events_json) = 'array'
+                      THEN ${p}events_json
+                    ELSE '[]'
+                  END
+                ) AS usage_event
+               WHERE usage_event.type = 'object'
+                 AND json_extract(usage_event.value, '$.kind') = 'usage'
+                 AND json_type(usage_event.value, '$.durationMs') IN ('integer', 'real')
+               ORDER BY CAST(usage_event.key AS INTEGER) DESC
+               LIMIT 1
+            )
+          END`;
+}
+/** @internal Converts a raw message row (runStatus/startedAt/endedAt/eventsJson) into a run summary object, or null when no run status is present. */
+function conversationRunSummaryFromRow(row) {
+    if (!row || typeof row.runStatus !== 'string')
+        return null;
+    const startedAt = row.startedAt == null ? undefined : Number(row.startedAt);
+    const endedAt = row.endedAt == null ? undefined : Number(row.endedAt);
+    const usageDurationMs = latestUsageDurationMs(row.eventsJson);
+    const durationMs = Number.isFinite(startedAt) && Number.isFinite(endedAt)
+        ? Math.max(0, endedAt - startedAt)
+        : usageDurationMs;
+    return {
+        status: row.runStatus,
+        ...(Number.isFinite(startedAt) ? { startedAt } : {}),
+        ...(Number.isFinite(endedAt) ? { endedAt } : {}),
+        ...(typeof durationMs === 'number' && Number.isFinite(durationMs)
+            ? { durationMs }
+            : {}),
+    };
+}
+/** @internal Parses events_json to find the most recent usage event's durationMs; returns undefined when events_json is absent or malformed. */
+function latestUsageDurationMs(eventsJson) {
+    if (typeof eventsJson !== 'string' || eventsJson.length === 0)
+        return undefined;
+    try {
+        const events = JSON.parse(eventsJson);
+        if (!Array.isArray(events))
+            return undefined;
+        for (let i = events.length - 1; i >= 0; i -= 1) {
+            const event = events[i];
+            if (event &&
+                typeof event === 'object' &&
+                event.kind === 'usage' &&
+                typeof event.durationMs === 'number' &&
+                Number.isFinite(event.durationMs)) {
+                return Math.max(0, event.durationMs);
+            }
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+/**
+ * Inserts a new conversation row and returns the full conversation record (including run summary).
+ * Normalizes sessionMode before persisting so the stored value is always a valid ChatSessionMode.
+ * @param db Open SQLite database handle.
+ * @param c Conversation fields to insert.
+ */
+export function insertConversation(db, c) {
+    db.prepare(`INSERT INTO conversations
+       (id, project_id, title, session_mode, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?)`).run(c.id, c.projectId, c.title ?? null, normalizeConversationSessionMode(c.sessionMode), c.createdAt, c.updatedAt);
+    return getConversation(db, c.id);
+}
+/**
+ * Applies a partial patch to an existing conversation, merging with the current record.
+ * Returns null when the conversation does not exist; otherwise returns the updated record.
+ * @param db Open SQLite database handle.
+ * @param id Conversation id to update.
+ * @param patch Fields to overwrite; sessionMode and updatedAt are normalized before persisting.
+ */
+export function updateConversation(db, id, patch) {
+    const existing = getConversation(db, id);
+    if (!existing)
+        return null;
+    const merged = {
+        ...existing,
+        ...patch,
+        sessionMode: Object.prototype.hasOwnProperty.call(patch, 'sessionMode')
+            ? normalizeConversationSessionMode(patch.sessionMode)
+            : existing.sessionMode,
+        updatedAt: typeof patch.updatedAt === 'number' ? patch.updatedAt : Date.now(),
+    };
+    db.prepare(`UPDATE conversations
+        SET title = ?, session_mode = ?, updated_at = ? WHERE id = ?`).run(merged.title ?? null, merged.sessionMode, merged.updatedAt, id);
+    return getConversation(db, id);
+}
+/**
+ * Removes a conversation row by id. Cascading deletes on messages are handled by the schema.
+ * @param db Open SQLite database handle.
+ * @param id Conversation id to delete.
+ */
+export function deleteConversation(db, id) {
+    db.prepare(`DELETE FROM conversations WHERE id = ?`).run(id);
+}
+//# sourceMappingURL=conversations.js.map

package/dist/db/conversations/conversations.js.map

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

package/dist/db/conversations/index.d.ts

@@ -0,0 +1,3 @@
+/** @module db/conversations/index */
+export { listConversations, getConversation, normalizeConversationSessionMode, insertConversation, updateConversation, deleteConversation, } from './conversations.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/db/conversations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/db/conversations/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gCAAgC,EAChC,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/db/conversations/index.js

@@ -0,0 +1,3 @@
+/** @module db/conversations/index */
+export { listConversations, getConversation, normalizeConversationSessionMode, insertConversation, updateConversation, deleteConversation, } from './conversations.js';
+//# sourceMappingURL=index.js.map

package/dist/db/conversations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/db/conversations/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gCAAgC,EAChC,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/db/core/index.d.ts

@@ -0,0 +1,6 @@
+/** @module db/core/index
+ * Foundation barrel — re-exports all shared type aliases and pure row/JSON primitives; no side effects and no sibling subdirectory imports. */
+export * from './types.js';
+export * from './json.js';
+export * from './rows.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/db/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/db/core/index.ts"],"names":[],"mappings":"AAAA;+IAC+I;AAC/I,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/db/core/index.js

@@ -0,0 +1,6 @@
+/** @module db/core/index
+ * Foundation barrel — re-exports all shared type aliases and pure row/JSON primitives; no side effects and no sibling subdirectory imports. */
+export * from './types.js';
+export * from './json.js';
+export * from './rows.js';
+//# sourceMappingURL=index.js.map

package/dist/db/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/db/core/index.ts"],"names":[],"mappings":"AAAA;+IAC+I;AAC/I,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/db/core/json.d.ts

@@ -0,0 +1,13 @@
+/** @module db/core/json
+ * Pure JSON parsing utility that converts SQLite TEXT columns to JS values without throwing.
+ * Imports no sibling subdirectory.
+ */
+/**
+ * Safely parse a SQLite TEXT column value to a JS value.
+ * Returns `undefined` instead of throwing for non-string, empty, or malformed JSON —
+ * callers should narrow the return type before use.
+ * @param s - raw column value as stored in SQLite (typically `string | null`)
+ * @returns parsed value, or `undefined` if the input is absent or unparseable
+ */
+export declare function parseJsonOrUndef(s: unknown): any;
+//# sourceMappingURL=json.d.ts.map

package/dist/db/core/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/db/core/json.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,GAAG,CAOhD"}

package/dist/db/core/json.js

@@ -0,0 +1,22 @@
+/** @module db/core/json
+ * Pure JSON parsing utility that converts SQLite TEXT columns to JS values without throwing.
+ * Imports no sibling subdirectory.
+ */
+/**
+ * Safely parse a SQLite TEXT column value to a JS value.
+ * Returns `undefined` instead of throwing for non-string, empty, or malformed JSON —
+ * callers should narrow the return type before use.
+ * @param s - raw column value as stored in SQLite (typically `string | null`)
+ * @returns parsed value, or `undefined` if the input is absent or unparseable
+ */
+export function parseJsonOrUndef(s) {
+    if (typeof s !== 'string' || !s)
+        return undefined;
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/db/core/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/db/core/json.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAU;IACzC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAClD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/db/core/rows.d.ts

@@ -0,0 +1,18 @@
+/** @module db/core/rows
+ * Helpers that normalize raw better-sqlite3 query results to typed `DbRow` values.
+ * Imports no sibling subdirectory; depends only on `core/types`.
+ */
+import type { DbRow } from './types.js';
+/**
+ * Narrow a single `db.prepare(…).get()` result to `DbRow | null`.
+ * Returns `null` for falsy or non-object returns so callers can distinguish "no row" from an empty row.
+ * @param value - raw return from better-sqlite3's `.get()`
+ */
+export declare function row(value: unknown): DbRow | null;
+/**
+ * Map a `db.prepare(…).all()` result array to `DbRow[]`, replacing any falsy or non-object
+ * entries with an empty object so the array length is always preserved.
+ * @param value - raw return from better-sqlite3's `.all()`
+ */
+export declare function rows(value: unknown[]): DbRow[];
+//# sourceMappingURL=rows.d.ts.map

package/dist/db/core/rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../../src/db/core/rows.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,CAE9C"}

package/dist/db/core/rows.js

@@ -0,0 +1,17 @@
+/**
+ * Narrow a single `db.prepare(…).get()` result to `DbRow | null`.
+ * Returns `null` for falsy or non-object returns so callers can distinguish "no row" from an empty row.
+ * @param value - raw return from better-sqlite3's `.get()`
+ */
+export function row(value) {
+    return value && typeof value === 'object' ? value : null;
+}
+/**
+ * Map a `db.prepare(…).all()` result array to `DbRow[]`, replacing any falsy or non-object
+ * entries with an empty object so the array length is always preserved.
+ * @param value - raw return from better-sqlite3's `.all()`
+ */
+export function rows(value) {
+    return value.map((item) => row(item) ?? {});
+}
+//# sourceMappingURL=rows.js.map