@mndrk/agx 2.0.34 → 2.0.38

package/cloud-runtime/standalone/components/PromptJobBoard.tsx

@@ -1261,7 +1261,7 @@ export default function PromptJobBoard({ projectId }: { projectId?: string } = {
         <div className="flex flex-col sm:flex-row justify-between items-start sm:items-end gap-4 mb-6">
           <div>
             <h1 className="text-2xl font-bold tracking-tight mb-1">
-              Prompt Scheduler
+              Scheduled Tasks
             </h1>
             <p className="text-sm text-[var(--muted-foreground)]">
               {counts.active} active job{counts.active !== 1 ? "s" : ""}{" "}
@@ -1347,6 +1347,17 @@ export default function PromptJobBoard({ projectId }: { projectId?: string } = {
                           job.state === 'active' ? 'translate-x-[11px]' : 'translate-x-[1.5px]'
                         }`} />
                       </button>
+                      <button
+                        onClick={(e) => {
+                          e.stopPropagation();
+                          setEditingJob(job);
+                          setShowCreate(true);
+                        }}
+                        title="Edit"
+                        className="p-1.5 rounded-md border border-[var(--card-border)] text-[var(--muted-foreground)] hover:text-[var(--foreground)] hover:border-[var(--muted-foreground)] transition-colors"
+                      >
+                        <Pencil size={12} />
+                      </button>
                       <button
                         onClick={(e) => handleRunNow(job.id, e)}
                         disabled={isBusy}

package/cloud-runtime/standalone/components/errors/StartupGuard.tsx

@@ -28,7 +28,7 @@ function mapCheckToError(check: { label: string; value: string }): StartupError
 
   const fixes: Record<string, string> = {
     "SQLite Version":
-      "brew install sqlite3 && npm rebuild better-sqlite3",
+      "Ensure Node.js >= 22.16 is installed (node:sqlite requires it)",
     journal_mode:
       "Ensure the database is on a local filesystem with no exclusive locks",
     foreign_keys: "PRAGMA foreign_keys = ON",

package/cloud-runtime/standalone/components/errors/StartupGuardWrapper.tsx

@@ -27,7 +27,7 @@ function mapCheckToError(check: { label: string; value: string }): StartupError
   const kind = kindMap[check.label] || "pragma_error";
 
   const fixes: Record<string, string> = {
-    "SQLite Version": "brew install sqlite3 && npm rebuild better-sqlite3",
+    "SQLite Version": "Ensure Node.js >= 22.16 is installed (node:sqlite requires it)",
     journal_mode: "Ensure the database is on a local filesystem with no exclusive locks",
     foreign_keys: "PRAGMA foreign_keys = ON",
     "JSON1 Extension": "Rebuild SQLite with JSON1 enabled, or use a system SQLite that includes it",

package/cloud-runtime/standalone/components/thread/WorkspaceSidebar.tsx

@@ -481,7 +481,7 @@ export function WorkspaceSidebar({
                         aria-current={isActiveProjectAutomations ? "page" : undefined}
                       >
                         <Zap size={12} className="flex-shrink-0 text-[var(--muted-foreground)]" />
-                        <span className="workspace-sidebar__workspace-title text-xs">Automations</span>
+                        <span className="workspace-sidebar__workspace-title text-xs">Scheduled Tasks</span>
                       </Link>
                     </div>
 

package/cloud-runtime/standalone/hooks/usePromptJobs.ts

@@ -1,16 +1,17 @@
 'use client';
 
-import { useState, useEffect, useCallback } from 'react';
+import { useState, useEffect, useCallback, useRef } from 'react';
 import type { PromptJob, PromptRun } from '@/src/prompt-scheduler/types';
 
 export function usePromptJobs(projectId?: string) {
   const [jobs, setJobs] = useState<PromptJob[]>([]);
   const [loading, setLoading] = useState(true);
   const [error, setError] = useState<string | null>(null);
+  const initialFetchDone = useRef(false);
 
   const fetchJobs = useCallback(async () => {
     try {
-      setLoading(true);
+      if (!initialFetchDone.current) setLoading(true);
       const params = projectId ? `?projectId=${encodeURIComponent(projectId)}` : '';
       const res = await fetch(`/api/prompt-jobs${params}`);
       if (!res.ok) throw new Error(`Failed to fetch: ${res.status}`);
@@ -21,10 +22,12 @@ export function usePromptJobs(projectId?: string) {
       setError(err instanceof Error ? err.message : String(err));
     } finally {
       setLoading(false);
+      initialFetchDone.current = true;
     }
   }, [projectId]);
 
   useEffect(() => {
+    initialFetchDone.current = false;
     fetchJobs();
     const interval = setInterval(fetchJobs, 10_000);
     return () => clearInterval(interval);
@@ -52,9 +55,7 @@ export function usePromptJobs(projectId?: string) {
   }, [fetchJobs]);
 
   const deleteJob = useCallback(async (id: string) => {
-    const res = await fetch(`/api/prompt-jobs/${id}`, {
-      method: 'DELETE',
-    });
+    const res = await fetch(`/api/prompt-jobs/${id}`, { method: 'DELETE' });
     if (res.ok) await fetchJobs();
     return res.ok;
   }, [fetchJobs]);
@@ -81,9 +82,7 @@ export function usePromptJobs(projectId?: string) {
   }, [fetchJobs]);
 
   const cancelRun = useCallback(async (id: string) => {
-    const res = await fetch(`/api/prompt-jobs/${id}/cancel`, {
-      method: 'POST',
-    });
+    const res = await fetch(`/api/prompt-jobs/${id}/cancel`, { method: 'POST' });
     if (res.ok) await fetchJobs();
     return res.ok;
   }, [fetchJobs]);
@@ -96,16 +95,8 @@ export function usePromptJobs(projectId?: string) {
   }, []);
 
   return {
-    jobs,
-    loading,
-    error,
+    jobs, loading, error,
     refresh: fetchJobs,
-    createJob,
-    updateJob,
-    deleteJob,
-    toggleJob,
-    runNow,
-    cancelRun,
-    fetchRuns,
+    createJob, updateJob, deleteJob, toggleJob, runNow, cancelRun, fetchRuns,
   };
 }

package/cloud-runtime/standalone/instrumentation.ts

@@ -2,6 +2,7 @@ const SCHEDULE_POLL_INTERVAL_MS = 15_000;
 
 export async function register() {
   if (process.env.NEXT_RUNTIME === 'nodejs') {
+    await import("./lib/check-node-version");
     const { getQueue, QUEUE_NAMES } = await import('@/lib/queue/boss');
     const { taskProcessor } = await import('@/lib/orchestrator/processor');
 

package/cloud-runtime/standalone/lib/agent-process-registry.ts

@@ -1,4 +1,5 @@
-import Database from "better-sqlite3";
+import { DatabaseSync } from "node:sqlite";
+import { pragmaSet } from "./sqlite-compat";
 import path from "path";
 import os from "os";
 import { mkdirSync, existsSync } from "fs";
@@ -52,10 +53,10 @@ function toEntry(row: Row): AgentProcessEntry {
   };
 }
 
-function getDb(): Database.Database {
+function getDb(): DatabaseSync {
   mkdirSync(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");
   db.exec(`
     CREATE TABLE IF NOT EXISTS agent_processes (
       id           INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -85,7 +86,7 @@ function getDb(): Database.Database {
   return db;
 }
 
-function withDb<T>(fn: (db: Database.Database) => T): T {
+function withDb<T>(fn: (db: DatabaseSync) => T): T {
   const db = getDb();
   try {
     return fn(db);
@@ -176,7 +177,7 @@ export function getByThread(threadId: string): AgentProcessEntry[] {
   return withDb((db) => {
     const rows = db
       .prepare("SELECT * FROM agent_processes WHERE thread_id = ?")
-      .all(threadId) as Row[];
+      .all(threadId) as unknown as Row[];
     return rows.map(toEntry);
   });
 }
@@ -185,14 +186,14 @@ export function getByWorkspace(workspaceId: string): AgentProcessEntry[] {
   return withDb((db) => {
     const rows = db
       .prepare("SELECT * FROM agent_processes WHERE workspace_id = ?")
-      .all(workspaceId) as Row[];
+      .all(workspaceId) as unknown as Row[];
     return rows.map(toEntry);
   });
 }
 
 export function getAll(): AgentProcessEntry[] {
   return withDb((db) => {
-    const rows = db.prepare("SELECT * FROM agent_processes").all() as Row[];
+    const rows = db.prepare("SELECT * FROM agent_processes").all() as unknown as Row[];
     return rows.map(toEntry);
   });
 }
@@ -207,7 +208,7 @@ export function getAllEnriched(): EnrichedProcessEntry[] {
       SELECT ap.*, substr(m.content, 1, 120) AS thread_title
       FROM agent_processes ap
       LEFT JOIN messages m ON m.id = ap.thread_id AND m.thread_id = ap.workspace_id
-    `).all() as (Row & { thread_title: string | null })[];
+    `).all() as unknown as (Row & { thread_title: string | null })[];
     return rows.map((r) => ({ ...toEntry(r), threadTitle: r.thread_title }));
   });
 }

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

@@ -1,4 +1,5 @@
-import Database from "better-sqlite3";
+import { DatabaseSync } from "node:sqlite";
+import { pragmaSet } from "./sqlite-compat";
 import { promises as fs } from "fs";
 import path from "path";
 import os from "os";
@@ -10,13 +11,13 @@ const HISTORY_DIR =
 const DB_PATH = path.join(HISTORY_DIR, "history.sqlite");
 const UPLOADS_DIR = path.join(HISTORY_DIR, "uploads");
 
-function getDb(): Database.Database {
-  const db = new Database(DB_PATH);
-  db.pragma("journal_mode = WAL");
+function getDb(): DatabaseSync {
+  const db = new DatabaseSync(DB_PATH);
+  pragmaSet(db, "journal_mode = WAL");
   return db;
 }
 
-export function initAttachmentsTable(db: Database.Database): void {
+export function initAttachmentsTable(db: DatabaseSync): void {
   db.exec(`
     CREATE TABLE IF NOT EXISTS attachments (
       id TEXT PRIMARY KEY,

package/cloud-runtime/standalone/lib/check-node-version.ts

@@ -0,0 +1,12 @@
+export {};
+
+if (typeof process !== "undefined" && process.versions?.node) {
+  const [major, minor] = process.versions.node.split(".").map(Number);
+  if (major < 22 || (major === 22 && minor < 16)) {
+    console.error(
+      `agx-cloud requires Node.js >= 22.16.0 (found ${process.version}). ` +
+      `node:sqlite is not available on older versions.`
+    );
+    process.exit(1);
+  }
+}

package/cloud-runtime/standalone/lib/db-adapter.interface.ts

@@ -87,7 +87,7 @@ import type {
 
 /**
  * Opaque client handle passed into transaction callbacks.
- * Drivers supply their own concrete type (e.g. pg PoolClient, better-sqlite3 Database).
+ * Drivers supply their own concrete type (e.g. pg PoolClient, node:sqlite DatabaseSync).
  */
 export type TransactionClient = unknown;
 

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]);
       }