@mndrk/agx 2.0.36 → 2.0.39

package/cloud-runtime/standalone/lib/history-store.ts

@@ -1,4 +1,5 @@
-import Database from "better-sqlite3";
+import { DatabaseSync, type SQLInputValue } from "node:sqlite";
+import { pragmaAll, pragmaSet, transaction, transactionFn } from "./sqlite-compat";
 import { promises as fs } from "fs";
 import path from "path";
 import os from "os";
@@ -218,7 +219,7 @@ export interface ThreadStatusSnapshot {
   lastUpdatedAt: number | null;
 }
 
-function hasSqliteObject(db: Database.Database, type: "table" | "trigger", name: string): boolean {
+function hasSqliteObject(db: DatabaseSync, type: "table" | "trigger", name: string): boolean {
   const row = db
     .prepare(`SELECT 1 FROM sqlite_master WHERE type = ? AND name = ? LIMIT 1`)
     .get(type, name);
@@ -235,7 +236,7 @@ function isPidAlive(pid: number | null | undefined): boolean {
   }
 }
 
-function initializeMessageSearch(db: Database.Database): void {
+function initializeMessageSearch(db: DatabaseSync): void {
   const hasFtsTable = hasSqliteObject(db, "table", "messages_fts");
   db.exec(`
     CREATE VIRTUAL TABLE IF NOT EXISTS messages_fts USING fts5(
@@ -272,13 +273,13 @@ function initializeMessageSearch(db: Database.Database): void {
   }
 }
 
-function isThreadScopedTable(db: Database.Database, tableName: string): boolean {
-  const columns = db.prepare(`PRAGMA table_info(${tableName})`).all() as Array<{ name: string }>;
+function isThreadScopedTable(db: DatabaseSync, tableName: string): boolean {
+  const columns = pragmaAll(db, `table_info(${tableName})`) as Array<{ name: string }>;
   return columns.some((column) => column.name === "thread_id");
 }
 
-function migrateThreadReplyColumns(db: Database.Database): void {
-  const columns = db.prepare(`PRAGMA table_info(messages)`).all() as Array<{ name: string }>;
+function migrateThreadReplyColumns(db: DatabaseSync): void {
+  const columns = pragmaAll(db, `table_info(messages)`) as Array<{ name: string }>;
   const colNames = new Set(columns.map((c) => c.name));
   if (!colNames.has("root_message_id")) {
     db.exec(`
@@ -290,8 +291,8 @@ function migrateThreadReplyColumns(db: Database.Database): void {
   }
 }
 
-function migrateThreadStatusColumns(db: Database.Database): void {
-  const columns = db.prepare(`PRAGMA table_info(messages)`).all() as Array<{ name: string }>;
+function migrateThreadStatusColumns(db: DatabaseSync): void {
+  const columns = pragmaAll(db, `table_info(messages)`) as Array<{ name: string }>;
   const colNames = new Set(columns.map((c) => c.name));
   if (!colNames.has("thread_status")) {
     db.exec(`
@@ -301,8 +302,8 @@ function migrateThreadStatusColumns(db: Database.Database): void {
   }
 }
 
-function migrateReactionHostPidColumn(db: Database.Database): void {
-  const columns = db.prepare(`PRAGMA table_info(message_reactions)`).all() as Array<{ name: string }>;
+function migrateReactionHostPidColumn(db: DatabaseSync): void {
+  const columns = pragmaAll(db, `table_info(message_reactions)`) as Array<{ name: string }>;
   const colNames = new Set(columns.map((c) => c.name));
   if (!colNames.has("host_pid")) {
     db.exec(`ALTER TABLE message_reactions ADD COLUMN host_pid INTEGER`);
@@ -312,8 +313,8 @@ function migrateReactionHostPidColumn(db: Database.Database): void {
   }
 }
 
-function migrateLogsToAgentProcessId(db: Database.Database): void {
-  const columns = db.prepare(`PRAGMA table_info(logs)`).all() as Array<{ name: string }>;
+function migrateLogsToAgentProcessId(db: DatabaseSync): void {
+  const columns = pragmaAll(db, `table_info(logs)`) as Array<{ name: string }>;
   const colNames = new Set(columns.map((c) => c.name));
   // Already migrated if agent_process_id exists
   if (colNames.has("agent_process_id")) return;
@@ -331,8 +332,8 @@ function migrateLogsToAgentProcessId(db: Database.Database): void {
   `);
 }
 
-function migrateAgentProcessesAddId(db: Database.Database): void {
-  const columns = db.prepare(`PRAGMA table_info(agent_processes)`).all() as Array<{ name: string }>;
+function migrateAgentProcessesAddId(db: DatabaseSync): void {
+  const columns = pragmaAll(db, `table_info(agent_processes)`) as Array<{ name: string }>;
   if (columns.length === 0) return; // table doesn't exist yet, DDL will create it
   const colNames = new Set(columns.map((c) => c.name));
   if (colNames.has("id")) return; // already has id column
@@ -416,7 +417,7 @@ function toChatRunStepRecord(row: ChatRunStepRow): ChatRunStepRecord {
   };
 }
 
-function migrateLegacyTables(db: Database.Database): void {
+function migrateLegacyTables(db: DatabaseSync): void {
   if (!isThreadScopedTable(db, "messages")) {
     db.exec(`
       ALTER TABLE messages RENAME TO messages_legacy;
@@ -462,10 +463,10 @@ function migrateLegacyTables(db: Database.Database): void {
   migrateLogsToAgentProcessId(db);
 }
 
-const withDatabase = async <T>(run: (db: Database.Database) => T): Promise<T> => {
+const withDatabase = async <T>(run: (db: DatabaseSync) => T): Promise<T> => {
   await fs.mkdir(HISTORY_DIR, { recursive: true });
-  const db = new Database(DB_PATH);
-  db.pragma("journal_mode = WAL");
+  const db = new DatabaseSync(DB_PATH);
+  pragmaSet(db, "journal_mode = WAL");
   try {
     db.exec(`
       CREATE TABLE IF NOT EXISTS messages (
@@ -611,7 +612,7 @@ function aggregateReactionRows(rows: ReactionRow[]): Map<string, MessageReaction
 }
 
 function loadMessageReactions(
-  db: Database.Database,
+  db: DatabaseSync,
   threadId: string,
   messageIds?: string[]
 ): Map<string, MessageReaction[]> {
@@ -626,7 +627,7 @@ function loadMessageReactions(
          WHERE thread_id = ? AND message_id IN (${placeholders})
          ORDER BY updated_at ASC`
       )
-      .all(threadId, ...messageIds) as ReactionRow[];
+      .all(threadId, ...messageIds) as unknown as ReactionRow[];
     return aggregateReactionRows(rows);
   }
 
@@ -637,7 +638,7 @@ function loadMessageReactions(
        WHERE thread_id = ?
        ORDER BY updated_at ASC`
     )
-    .all(threadId) as ReactionRow[];
+    .all(threadId) as unknown as ReactionRow[];
   return aggregateReactionRows(rows);
 }
 
@@ -769,7 +770,7 @@ export async function listRootMessages(options?: {
 
     const countRow = db
       .prepare(`SELECT COUNT(*) as cnt FROM messages m WHERE ${whereClause}`)
-      .get(...(params.length ? [params] : []).flat()) as { cnt: number };
+      .get(...(params.length ? [params] : []).flat().map(v => v as SQLInputValue)) as { cnt: number };
 
     const rows = db
       .prepare(
@@ -782,7 +783,7 @@ export async function listRootMessages(options?: {
          ORDER BY last_activity DESC
          LIMIT ? OFFSET ?`
       )
-      .all(...params, limit, offset) as RootMessageRow[];
+      .all(...params.map(v => v as SQLInputValue), limit, offset) as unknown as RootMessageRow[];
 
     return { rows, total: countRow.cnt };
   });
@@ -840,7 +841,7 @@ export async function loadHistory(threadId: string, since?: number): Promise<Gro
          ORDER BY timestamp ASC`;
     const rows = (since != null
       ? db.prepare(query).all(normalizedThreadId, since)
-      : db.prepare(query).all(normalizedThreadId)) as MessageRow[];
+      : db.prepare(query).all(normalizedThreadId)) as unknown as MessageRow[];
     const reactionMap = loadMessageReactions(
       db,
       normalizedThreadId,
@@ -919,7 +920,7 @@ export async function getThreadStatusSnapshot(
          WHERE thread_id = ? AND id = ?
          LIMIT 1`
       )
-      .get(scopedThreadId, scopedRootMessageId) as MessageRow | undefined;
+      .get(scopedThreadId, scopedRootMessageId) as unknown as MessageRow | undefined;
 
     if (!rootCandidate) {
       return {
@@ -1036,7 +1037,7 @@ export async function getThreadStatusSnapshot(
              last_activity = ?
          WHERE id = ?`
       );
-      const markManyStale = db.transaction((ids: number[]) => {
+      const markManyStale = transactionFn(db, (ids: number[]) => {
         for (const id of ids) {
           markStale.run(now, id);
         }
@@ -1142,7 +1143,7 @@ export async function saveMessages(threadId: string, messages: GroupMessage[]):
       `INSERT OR REPLACE INTO messages (thread_id, id, role, participant_id, content, timestamp, root_message_id, parent_message_id, depth, thread_status, outcome_note)
        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
     );
-    const insertMany = db.transaction((msgs: GroupMessage[]) => {
+    const insertMany = transactionFn(db, (msgs: GroupMessage[]) => {
       for (const m of msgs) {
         stmt.run(normalizedThreadId, m.id, m.role, m.participantId, m.content, m.timestamp, m.rootMessageId ?? null, m.parentMessageId ?? null, m.depth ?? 0, m.threadStatus ?? null, m.outcomeNote ?? null);
       }
@@ -1182,7 +1183,7 @@ export async function createChatRun(input: {
       now
     );
 
-    const row = db.prepare("SELECT * FROM chat_runs WHERE id = ? LIMIT 1").get(input.id) as ChatRunRow | undefined;
+    const row = db.prepare("SELECT * FROM chat_runs WHERE id = ? LIMIT 1").get(input.id) as unknown as ChatRunRow | undefined;
     if (!row) {
       throw new Error(`Failed to create chat run ${input.id}`);
     }
@@ -1221,14 +1222,14 @@ export async function sweepStaleChatRuns(input?: {
       )
       .run(now, now, ...params);
 
-    return result.changes;
+    return Number(result.changes);
   });
 }
 
 export async function getChatRun(chatRunId: string): Promise<ChatRunRecord | null> {
   await sweepStaleChatRuns();
   return withDatabase((db) => {
-    const row = db.prepare("SELECT * FROM chat_runs WHERE id = ? LIMIT 1").get(chatRunId) as ChatRunRow | undefined;
+    const row = db.prepare("SELECT * FROM chat_runs WHERE id = ? LIMIT 1").get(chatRunId) as unknown as ChatRunRow | undefined;
     return row ? toChatRunRecord(row) : null;
   });
 }
@@ -1260,7 +1261,7 @@ export async function listChatRuns(input: {
     const where = clauses.length > 0 ? `WHERE ${clauses.join(" AND ")}` : "";
     const rows = db
       .prepare(`SELECT * FROM chat_runs ${where} ORDER BY updated_at DESC LIMIT ?`)
-      .all(...params, limit) as ChatRunRow[];
+      .all(...params, limit) as unknown as ChatRunRow[];
     return rows.map(toChatRunRecord);
   });
 }
@@ -1311,7 +1312,7 @@ export async function updateChatRun(input: {
     params.push(input.id);
     db.prepare(`UPDATE chat_runs SET ${updates.join(", ")} WHERE id = ?`).run(...params);
 
-    const row = db.prepare("SELECT * FROM chat_runs WHERE id = ? LIMIT 1").get(input.id) as ChatRunRow | undefined;
+    const row = db.prepare("SELECT * FROM chat_runs WHERE id = ? LIMIT 1").get(input.id) as unknown as ChatRunRow | undefined;
     return row ? toChatRunRecord(row) : null;
   });
 }
@@ -1346,7 +1347,7 @@ export async function appendChatRunStep(input: {
       input.status === "completed" || input.status === "failed" ? now : null
     );
 
-    const row = db.prepare("SELECT * FROM chat_run_steps WHERE id = ? LIMIT 1").get(input.id) as ChatRunStepRow | undefined;
+    const row = db.prepare("SELECT * FROM chat_run_steps WHERE id = ? LIMIT 1").get(input.id) as unknown as ChatRunStepRow | undefined;
     if (!row) {
       throw new Error(`Failed to append chat run step ${input.id}`);
     }
@@ -1376,12 +1377,12 @@ export async function updateChatRunStep(input: {
       params.push(input.completedAt);
     }
     if (updates.length === 0) {
-      const existing = db.prepare("SELECT * FROM chat_run_steps WHERE id = ? LIMIT 1").get(input.id) as ChatRunStepRow | undefined;
+      const existing = db.prepare("SELECT * FROM chat_run_steps WHERE id = ? LIMIT 1").get(input.id) as unknown as ChatRunStepRow | undefined;
       return existing ? toChatRunStepRecord(existing) : null;
     }
     params.push(input.id);
     db.prepare(`UPDATE chat_run_steps SET ${updates.join(", ")} WHERE id = ?`).run(...params);
-    const row = db.prepare("SELECT * FROM chat_run_steps WHERE id = ? LIMIT 1").get(input.id) as ChatRunStepRow | undefined;
+    const row = db.prepare("SELECT * FROM chat_run_steps WHERE id = ? LIMIT 1").get(input.id) as unknown as ChatRunStepRow | undefined;
     return row ? toChatRunStepRecord(row) : null;
   });
 }
@@ -1390,7 +1391,7 @@ export async function listChatRunSteps(chatRunId: string): Promise<ChatRunStepRe
   return withDatabase((db) => {
     const rows = db
       .prepare("SELECT * FROM chat_run_steps WHERE chat_run_id = ? ORDER BY step_index ASC, started_at ASC")
-      .all(chatRunId) as ChatRunStepRow[];
+      .all(chatRunId) as unknown as ChatRunStepRow[];
     return rows.map(toChatRunStepRecord);
   });
 }
@@ -1419,7 +1420,7 @@ export async function getMessageThread(messageId: string): Promise<{ threadId: s
 export async function clearHistory(threadId: string): Promise<void> {
   const normalizedThreadId = threadId.trim() || LEGACY_THREAD_ID;
   await withDatabase((db) => {
-    const tx = db.transaction((id: string) => {
+    const tx = transactionFn(db, (id: string) => {
       db.prepare(`DELETE FROM message_reactions WHERE thread_id = ?`).run(id);
       db.prepare(`DELETE FROM messages WHERE thread_id = ?`).run(id);
     });
@@ -1433,7 +1434,7 @@ export async function deleteMessage(threadId: string, messageId: string): Promis
   if (!normalizedMessageId) return;
 
   await withDatabase((db) => {
-    const tx = db.transaction((thread: string, msgId: string) => {
+    const tx = transactionFn(db, (thread: string, msgId: string) => {
       db.prepare(
         `DELETE FROM message_reactions WHERE thread_id = ? AND message_id = ?`
       ).run(thread, msgId);
@@ -1451,7 +1452,7 @@ export async function clearRootThread(threadId: string, rootMessageId: string):
   if (!normalizedRootMessageId) return;
 
   await withDatabase((db) => {
-    const tx = db.transaction((thread: string, rootId: string) => {
+    const tx = transactionFn(db, (thread: string, rootId: string) => {
       db.prepare(
         `DELETE FROM message_reactions
          WHERE thread_id = ?
@@ -1509,7 +1510,7 @@ export async function searchMessages(input: SearchMessagesInput): Promise<Search
            WHERE ${ftsWhereClauses.join(" AND ")}
            ORDER BY rank ASC, m.timestamp DESC`
         )
-        .all(...ftsWhereParams) as Array<SearchRow & { snippet: string; rank: number }>;
+        .all(...ftsWhereParams) as unknown as Array<SearchRow & { snippet: string; rank: number }>;
 
       for (const row of ftsRows) {
         const key = `${row.thread_id}:${row.id}`;
@@ -1550,7 +1551,7 @@ export async function searchMessages(input: SearchMessagesInput): Promise<Search
          WHERE ${fallbackClauses.join(" AND ")}
          ORDER BY m.timestamp DESC`
       )
-      .all(...fallbackParams) as Array<SearchRow & { content: string }>;
+      .all(...fallbackParams) as unknown as Array<SearchRow & { content: string }>;
 
     for (const row of fallbackRows) {
       const key = `${row.thread_id}:${row.id}`;
@@ -1736,12 +1737,11 @@ export async function saveLogs(
     const stmt = db.prepare(
       "INSERT INTO logs (agent_process_id, stream, line, timestamp) VALUES (?, ?, ?, ?)"
     );
-    const tx = db.transaction(() => {
+    transaction(db, () => {
       for (const e of entries) {
         stmt.run(agentProcessId, e.stream, e.line, e.timestamp);
       }
     });
-    tx();
   });
 }
 
@@ -1758,7 +1758,7 @@ export async function loadLogs(workspaceId: string): Promise<LogRow[]> {
          ORDER BY l.timestamp DESC, l.id DESC
          LIMIT 100`
       )
-      .all(normalized) as LogRow[];
+      .all(normalized) as unknown as LogRow[];
     return rows.reverse();
   });
 }
@@ -1836,7 +1836,7 @@ export async function sweepStaleWorkingReactions(
       )
       .run(now, normalizedThreadId, cutoff);
 
-    return { updated: result.changes };
+    return { updated: Number(result.changes) };
   });
 }
 

package/cloud-runtime/standalone/lib/knowledge-store.ts

@@ -1,5 +1,6 @@
 import { createHash, randomUUID } from "crypto";
 import { getSQLiteDb } from "./sqlite-query-adapter";
+import { transactionFn } from "./sqlite-compat";
 
 export type KnowledgeScope = "agent" | "repo" | "project";
 export type KnowledgeSourceType = "reflection" | "thread_transition" | "task_completion";
@@ -191,7 +192,7 @@ export function storeKnowledgeEntries(drafts: KnowledgeDraft[]): number {
   );
 
   let inserted = 0;
-  const tx = db.transaction((entries: KnowledgeDraft[]) => {
+  const tx = transactionFn(db, (entries: KnowledgeDraft[]) => {
     for (const draft of entries) {
       const subjectId = draft.subjectId.trim();
       const title = draft.title.trim();

package/cloud-runtime/standalone/lib/participants-store.ts

@@ -1,4 +1,5 @@
-import Database from "better-sqlite3";
+import { DatabaseSync } from "node:sqlite";
+import { pragmaAll, pragmaSet, transaction, transactionFn } from "./sqlite-compat";
 import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "fs";
 import path from "path";
 import os from "os";
@@ -55,7 +56,7 @@ function migrateAgentDirectory(oldId: string, newId: string, displayName: string
   }
 }
 
-function migrateLegacyParticipantIds(db: Database.Database): void {
+function migrateLegacyParticipantIds(db: DatabaseSync): void {
   const rows = db
     .prepare("SELECT id, name, provider FROM participants")
     .all() as Array<{ id: string; name: string; provider: string }>;
@@ -125,7 +126,7 @@ function migrateLegacyParticipantIds(db: Database.Database): void {
     ).map((row) => row.name)
   );
 
-  const migrateTxn = db.transaction((participantOps: Array<{ from: string; to: string }>, referenceOps: Array<{ from: string; to: string }>) => {
+  const migrateTxn = transactionFn(db, (participantOps: Array<{ from: string; to: string }>, referenceOps: Array<{ from: string; to: string }>) => {
     const updateParticipant = db.prepare("UPDATE participants SET id = ? WHERE id = ?");
     const updateMessages = tableNames.has("messages")
       ? db.prepare("UPDATE messages SET participant_id = ? WHERE participant_id = ?")
@@ -158,10 +159,10 @@ function migrateLegacyParticipantIds(db: Database.Database): void {
   }
 }
 
-function getDb(): Database.Database {
+function getDb(): DatabaseSync {
   mkdirSync(STORE_DIR, { recursive: true });
-  const db = new Database(DB_PATH);
-  db.pragma("journal_mode = WAL");
+  const db = new DatabaseSync(DB_PATH);
+  pragmaSet(db, "journal_mode = WAL");
   db.exec(`
     CREATE TABLE IF NOT EXISTS participants (
       id TEXT PRIMARY KEY,
@@ -176,7 +177,7 @@ function getDb(): Database.Database {
     );
   `);
 
-  const columns = db.prepare("PRAGMA table_info(participants)").all() as Array<{ name: string }>;
+  const columns = pragmaAll(db, "table_info(participants)") as Array<{ name: string }>;
   // Migration: rename persona -> identity, persona_file -> identity_file
   if (columns.some((column) => column.name === "persona")) {
     db.exec("ALTER TABLE participants RENAME COLUMN persona TO identity");
@@ -310,7 +311,7 @@ export function reorderParticipants(orderedIds: string[]): void {
   const db = getDb();
   try {
     const stmt = db.prepare("UPDATE participants SET sort_order = ? WHERE id = ?");
-    const txn = db.transaction((ids: string[]) => {
+    const txn = transactionFn(db, (ids: string[]) => {
       for (let i = 0; i < ids.length; i++) {
         stmt.run(i, ids[i]);
       }

package/cloud-runtime/standalone/lib/queue/sqlite-adapter.ts

@@ -1,4 +1,5 @@
-import Database from "better-sqlite3";
+import { DatabaseSync } from "node:sqlite";
+import { pragmaAll, transaction } from "../sqlite-compat";
 import { v4 as uuidv4 } from "uuid";
 import path from "path";
 import fs from "fs";
@@ -33,7 +34,7 @@ interface SQLiteJobRow {
 }
 
 export class SQLiteQueueAdapter implements QueueAdapter {
-  private db: Database.Database;
+  private db: DatabaseSync;
   private workers: Map<string, { handler: Function; options: WorkerOptions; running: boolean }> = new Map();
   private pollingInterval: NodeJS.Timeout | null = null;
   private writeRateInterval: NodeJS.Timeout | null = null;
@@ -50,7 +51,7 @@ export class SQLiteQueueAdapter implements QueueAdapter {
       fs.mkdirSync(dir, { recursive: true });
     }
 
-    this.db = new Database(finalPath);
+    this.db = new DatabaseSync(finalPath);
 
     // Apply contract PRAGMAs and validate environment
     const errors = validateSQLiteEnvironment(this.db, finalPath);
@@ -93,7 +94,7 @@ export class SQLiteQueueAdapter implements QueueAdapter {
     `);
 
     // Migrate: add columns that may be missing from older schemas
-    const cols = this.db.pragma('table_info(agx_jobs)') as { name: string }[];
+    const cols = pragmaAll(this.db, 'table_info(agx_jobs)') as { name: string }[];
     const colNames = new Set(cols.map(c => c.name));
     if (!colNames.has('failed_at')) {
       this.db.exec(`ALTER TABLE agx_jobs ADD COLUMN failed_at INTEGER`);
@@ -187,7 +188,7 @@ export class SQLiteQueueAdapter implements QueueAdapter {
     const staleBefore = now - getStaleJobTimeoutMs();
 
     // Transactional claim
-    const jobs = this.db.transaction(() => {
+    const jobs = transaction(this.db, () => {
       const reapedJobs = this.reapStaleJobs(queue, now, staleBefore);
       if (reapedJobs.length > 0) {
         writeDebugLog("queue.reap_stale", {
@@ -227,7 +228,7 @@ export class SQLiteQueueAdapter implements QueueAdapter {
         name: queue,
         data: JSON.parse(c.data)
       }));
-    })();
+    });
 
     if (jobs.length > 0) {
       writeDebugLog("queue.claim", {
@@ -271,9 +272,9 @@ export class SQLiteQueueAdapter implements QueueAdapter {
       SET status = 'completed', completed_at = ?, worker_id = NULL
       WHERE id = ?
     `);
-    this.db.transaction(() => {
+    transaction(this.db, () => {
       for (const id of ids) stmt.run(now, id);
-    })();
+    });
   }
 
   private failJobs(ids: string[], error: string) {
@@ -299,9 +300,9 @@ export class SQLiteQueueAdapter implements QueueAdapter {
       WHERE id = ?
     `);
 
-    this.db.transaction(() => {
+    transaction(this.db, () => {
       for (const id of ids) {
-        const job = stmt.get(id) as SQLiteJobRow;
+        const job = stmt.get(id) as unknown as SQLiteJobRow;
         if (job && job.retry_count < job.retry_limit) {
           // Retry
           // Simple backoff: 2s * retry_count
@@ -312,7 +313,7 @@ export class SQLiteQueueAdapter implements QueueAdapter {
           updateFailed.run(now, error, id);
         }
       }
-    })();
+    });
   }
 
   private reapStaleJobs(queue: string, now: number, staleBefore: number): Array<{

package/cloud-runtime/standalone/lib/repo-knowledge.ts

@@ -1,4 +1,5 @@
 import { getSQLiteDb } from "./sqlite-query-adapter";
+import { transaction } from "./sqlite-compat";
 import { getKnowledgeNote } from "./knowledge-notes";
 
 export type RepoKnowledgeProducer = "human" | "system";
@@ -29,7 +30,7 @@ function getRepoRow(repoId: string): RepoRow | null {
          FROM project_repos
          WHERE id = ?`
       )
-      .get(repoId) as RepoRow | undefined) ?? null
+      .get(repoId) as unknown as RepoRow | undefined) ?? null
   );
 }
 
@@ -61,7 +62,7 @@ export function listRepoKnowledge(
            WHERE repo_id = ? AND producer = ?
            ORDER BY created_at DESC`
         )
-        .all(repoId, producer) as RepoKnowledgeRow[])
+        .all(repoId, producer) as unknown as RepoKnowledgeRow[])
     : (db
         .prepare(
           `SELECT id, repo_id, content, producer, created_at
@@ -69,7 +70,7 @@ export function listRepoKnowledge(
            WHERE repo_id = ?
            ORDER BY created_at DESC`
         )
-        .all(repoId) as RepoKnowledgeRow[]);
+        .all(repoId) as unknown as RepoKnowledgeRow[]);
 
   if (options?.includeLegacyHumanFallback === false) {
     return rows;
@@ -113,12 +114,12 @@ export function replaceRepoKnowledge(
   const db = getSQLiteDb();
   const trimmed = content.trim();
 
-  db.transaction(() => {
+  transaction(db, () => {
     db.prepare("DELETE FROM repo_knowledge WHERE repo_id = ? AND producer = ?").run(repoId, producer);
     if (trimmed) {
       db.prepare("INSERT INTO repo_knowledge (repo_id, content, producer) VALUES (?, ?, ?)").run(repoId, trimmed, producer);
     }
-  })();
+  });
 
   return listRepoKnowledge(repoId, { producer, includeLegacyHumanFallback: false });
 }

package/cloud-runtime/standalone/lib/sqlite-compat.ts

@@ -0,0 +1,75 @@
+/**
+ * Compatibility helpers for migrating from better-sqlite3 to node:sqlite.
+ *
+ * Provides pragma() and transaction() helpers that match
+ * the better-sqlite3 API surface used throughout agx-cloud.
+ *
+ * For backups, use the module-level `backup()` from "node:sqlite" directly.
+ */
+import { DatabaseSync } from "node:sqlite";
+
+/**
+ * Read a PRAGMA value, returning the value directly (like better-sqlite3's simple mode).
+ * Example: pragmaGet(db, "journal_mode") => "wal"
+ */
+export function pragmaGet(db: DatabaseSync, key: string): unknown {
+  const row = db.prepare(`PRAGMA ${key}`).get() as Record<string, unknown> | undefined;
+  if (!row) return undefined;
+  // Return the first column value regardless of column name.
+  // Some PRAGMAs use a different column name than the key (e.g. busy_timeout → timeout).
+  const values = Object.values(row);
+  return values.length > 0 ? values[0] : undefined;
+}
+
+/**
+ * Read a PRAGMA that returns multiple rows (like table_info, foreign_key_check).
+ * Example: pragmaAll(db, "table_info(agents)") => [{ cid: 0, name: "id", ... }]
+ */
+export function pragmaAll(db: DatabaseSync, key: string): unknown[] {
+  return db.prepare(`PRAGMA ${key}`).all();
+}
+
+/**
+ * Set a PRAGMA value.
+ * Example: pragmaSet(db, "journal_mode = WAL")
+ */
+export function pragmaSet(db: DatabaseSync, pragma: string): void {
+  db.exec(`PRAGMA ${pragma}`);
+}
+
+/**
+ * Run a function inside a transaction. Mimics better-sqlite3's db.transaction() API.
+ * Automatically commits on success, rolls back on error.
+ */
+export function transaction<T>(db: DatabaseSync, fn: () => T): T {
+  db.exec("BEGIN");
+  try {
+    const result = fn();
+    db.exec("COMMIT");
+    return result;
+  } catch (err) {
+    db.exec("ROLLBACK");
+    throw err;
+  }
+}
+
+/**
+ * Returns a reusable transaction wrapper (like better-sqlite3's db.transaction(fn)).
+ * The returned function accepts args and passes them to fn.
+ */
+export function transactionFn<TArgs extends unknown[], TResult>(
+  db: DatabaseSync,
+  fn: (...args: TArgs) => TResult,
+): (...args: TArgs) => TResult {
+  return (...args: TArgs) => {
+    db.exec("BEGIN");
+    try {
+      const result = fn(...args);
+      db.exec("COMMIT");
+      return result;
+    } catch (err) {
+      db.exec("ROLLBACK");
+      throw err;
+    }
+  };
+}