agent-relay-server 0.15.0 → 0.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-server",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Lightweight HTTP message relay for inter-agent communication across machines",
   "module": "src/index.ts",
   "type": "module",

package/src/automations.ts

@@ -284,7 +284,7 @@ export function createAutomation(input: CreateAutomationInput, now = Date.now())
   if (!getOrchestrator(normalized.orchestratorId)) throw new ValidationError(`orchestrator ${normalized.orchestratorId} not found`);
   const id = randomUUID();
   const nextRunAt = normalized.enabled ? nextScheduledAt(normalized.schedule, normalized.timezone, now) : undefined;
-  db().prepare(`
+  db().query(`
     INSERT INTO automations (id, kind, name, description, enabled, schedule, timezone, next_run_at, catch_up_policy, concurrency_policy, orchestrator_id, target_policy, task_template, created_at, updated_at)
     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
   `).run(
@@ -327,7 +327,7 @@ export function updateAutomation(id: string, input: UpdateAutomationInput, now =
   const normalized = normalizeCreateInput(next);
   if (!getOrchestrator(normalized.orchestratorId)) throw new ValidationError(`orchestrator ${normalized.orchestratorId} not found`);
   const nextRunAt = normalized.enabled ? nextScheduledAt(normalized.schedule, normalized.timezone, now) : undefined;
-  db().prepare(`
+  db().query(`
     UPDATE automations
     SET name = ?, description = ?, enabled = ?, schedule = ?, timezone = ?, next_run_at = ?,
         catch_up_policy = ?, concurrency_policy = ?, orchestrator_id = ?, target_policy = ?, task_template = ?, updated_at = ?
@@ -352,18 +352,18 @@ export function updateAutomation(id: string, input: UpdateAutomationInput, now =
 
 export function deleteAutomation(id: string): boolean {
   ensureAutomationTables();
-  return db().prepare("DELETE FROM automations WHERE id = ?").run(id).changes > 0;
+  return db().query("DELETE FROM automations WHERE id = ?").run(id).changes > 0;
 }
 
 export function getAutomation(id: string): Automation | null {
   ensureAutomationTables();
-  const row = db().prepare("SELECT * FROM automations WHERE id = ?").get(id) as any;
+  const row = db().query("SELECT * FROM automations WHERE id = ?").get(id) as any;
   return row ? rowToAutomation(row) : null;
 }
 
 export function listAutomations(): Automation[] {
   ensureAutomationTables();
-  return (db().prepare("SELECT * FROM automations ORDER BY enabled DESC, next_run_at IS NULL, next_run_at ASC, name COLLATE NOCASE").all() as any[])
+  return (db().query("SELECT * FROM automations ORDER BY enabled DESC, next_run_at IS NULL, next_run_at ASC, name COLLATE NOCASE").all() as any[])
     .map(rowToAutomation);
 }
 
@@ -381,20 +381,20 @@ export function listAutomationRuns(filter: { automationId?: string; status?: str
   }
   const where = clauses.length ? `WHERE ${clauses.join(" AND ")}` : "";
   params.push(filter.limit ?? 100);
-  return (db().prepare(`SELECT * FROM automation_runs ${where} ORDER BY created_at DESC LIMIT ?`).all(...params) as any[])
+  return (db().query(`SELECT * FROM automation_runs ${where} ORDER BY created_at DESC LIMIT ?`).all(...params) as any[])
     .map(rowToAutomationRun);
 }
 
 function getAutomationRun(id: string): AutomationRun | null {
   ensureAutomationTables();
-  const row = db().prepare("SELECT * FROM automation_runs WHERE id = ?").get(id) as any;
+  const row = db().query("SELECT * FROM automation_runs WHERE id = ?").get(id) as any;
   return row ? rowToAutomationRun(row) : null;
 }
 
 export function runDueAutomations(now = Date.now()): AutomationDispatchResult[] {
   ensureAutomationTables();
   const results = dispatchQueuedAutomationRuns(now);
-  const due = (db().prepare("SELECT * FROM automations WHERE enabled = 1 AND next_run_at IS NOT NULL AND next_run_at <= ? ORDER BY next_run_at ASC LIMIT 25").all(now) as any[])
+  const due = (db().query("SELECT * FROM automations WHERE enabled = 1 AND next_run_at IS NOT NULL AND next_run_at <= ? ORDER BY next_run_at ASC LIMIT 25").all(now) as any[])
     .map(rowToAutomation);
   for (const automation of due) {
     if (hasActiveRun(automation.id)) {
@@ -421,7 +421,7 @@ export function runAutomationNow(id: string, now = Date.now()): AutomationDispat
 
 export function reconcileAutomationRuns(now = Date.now()): AutomationReconcileResult[] {
   ensureAutomationTables();
-  const rows = db().prepare(`
+  const rows = db().query(`
     SELECT * FROM automation_runs
     WHERE status IN ('scheduled', 'dispatching', 'waiting_agent', 'running') AND task_id IS NOT NULL
     ORDER BY created_at ASC
@@ -629,7 +629,7 @@ function createRunTask(
 
 function insertRun(automation: Automation, scheduledFor: number, now: number): AutomationRun {
   const id = randomUUID();
-  db().prepare(`
+  db().query(`
     INSERT INTO automation_runs (id, automation_id, status, scheduled_for, orchestrator_id, meta, created_at, updated_at)
     VALUES (?, ?, 'dispatching', ?, ?, '{}', ?, ?)
   `).run(id, automation.id, scheduledFor, automation.orchestratorId, now, now);
@@ -637,11 +637,11 @@ function insertRun(automation: Automation, scheduledFor: number, now: number): A
 }
 
 function enqueueAutomationRun(automation: Automation, scheduledFor: number, now: number): AutomationRun {
-  const existing = db().prepare("SELECT * FROM automation_runs WHERE automation_id = ? AND status = 'scheduled' AND scheduled_for = ?")
+  const existing = db().query("SELECT * FROM automation_runs WHERE automation_id = ? AND status = 'scheduled' AND scheduled_for = ?")
     .get(automation.id, scheduledFor) as any;
   if (existing) return rowToAutomationRun(existing);
   const id = randomUUID();
-  db().prepare(`
+  db().query(`
     INSERT INTO automation_runs (id, automation_id, status, scheduled_for, orchestrator_id, meta, created_at, updated_at)
     VALUES (?, ?, 'scheduled', ?, ?, '{}', ?, ?)
   `).run(id, automation.id, scheduledFor, automation.orchestratorId, now, now);
@@ -649,7 +649,7 @@ function enqueueAutomationRun(automation: Automation, scheduledFor: number, now:
 }
 
 function dispatchQueuedAutomationRuns(now: number): AutomationDispatchResult[] {
-  const queued = (db().prepare(`
+  const queued = (db().query(`
     SELECT r.* FROM automation_runs r
     JOIN automations a ON a.id = r.automation_id
     WHERE r.status = 'scheduled' AND a.enabled = 1
@@ -680,7 +680,7 @@ function updateRun(id: string, input: {
 }, now: number): void {
   const current = getAutomationRun(id);
   const meta = input.meta !== undefined ? input.meta : current?.meta;
-  db().prepare(`
+  db().query(`
     UPDATE automation_runs
     SET status = COALESCE(?, status),
         started_at = COALESCE(?, started_at),
@@ -715,20 +715,20 @@ function updateRun(id: string, input: {
 
 function hasActiveRun(automationId: string): boolean {
   const placeholders = [...BLOCKING_RUN_STATUSES].map(() => "?").join(",");
-  const row = db().prepare(`SELECT id FROM automation_runs WHERE automation_id = ? AND status IN (${placeholders}) LIMIT 1`)
+  const row = db().query(`SELECT id FROM automation_runs WHERE automation_id = ? AND status IN (${placeholders}) LIMIT 1`)
     .get(automationId, ...BLOCKING_RUN_STATUSES) as any;
   return Boolean(row);
 }
 
 function cancelActiveRuns(automationId: string, now: number, reason: string): void {
   const placeholders = [...OPEN_RUN_STATUSES].map(() => "?").join(",");
-  db().prepare(`UPDATE automation_runs SET status = 'canceled', finished_at = ?, error = ?, updated_at = ? WHERE automation_id = ? AND status IN (${placeholders})`)
+  db().query(`UPDATE automation_runs SET status = 'canceled', finished_at = ?, error = ?, updated_at = ? WHERE automation_id = ? AND status IN (${placeholders})`)
     .run(now, reason, now, automationId, ...OPEN_RUN_STATUSES);
 }
 
 function rescheduleAutomation(automation: Automation, now: number): void {
   const next = automation.enabled ? nextScheduledAt(automation.schedule, automation.timezone, now) : undefined;
-  db().prepare("UPDATE automations SET next_run_at = ?, updated_at = ? WHERE id = ?").run(next ?? null, now, automation.id);
+  db().query("UPDATE automations SET next_run_at = ?, updated_at = ? WHERE id = ?").run(next ?? null, now, automation.id);
 }
 
 function requireOnlineOrchestrator(orchestratorId: string): Orchestrator {

package/src/bus-outbox.ts

@@ -20,7 +20,7 @@ interface OutboxRow {
 
 export function appendEvent(type: string, source: string, data: unknown, subject?: string): number {
   const timestamp = Date.now();
-  const result = getDb().prepare(`
+  const result = getDb().query(`
     INSERT INTO bus_outbox (event_type, source, subject, data, timestamp)
     VALUES (?, ?, ?, ?, ?)
   `).run(type, source, subject ?? null, JSON.stringify(data ?? {}), timestamp);
@@ -28,7 +28,7 @@ export function appendEvent(type: string, source: string, data: unknown, subject
 }
 
 export function replayEvents(since: number, limit = 500): BusEvent[] {
-  const rows = getDb().prepare(`
+  const rows = getDb().query(`
     SELECT seq, event_type, source, subject, data, timestamp
     FROM bus_outbox
     WHERE seq > ?
@@ -40,17 +40,17 @@ export function replayEvents(since: number, limit = 500): BusEvent[] {
 
 export function pruneOutbox(retentionMs = 60 * 60 * 1000): number {
   const threshold = Date.now() - retentionMs;
-  const result = getDb().prepare("DELETE FROM bus_outbox WHERE timestamp < ?").run(threshold);
+  const result = getDb().query("DELETE FROM bus_outbox WHERE timestamp < ?").run(threshold);
   return result.changes;
 }
 
 export function getOutboxCursor(): number {
-  const row = getDb().prepare("SELECT coalesce(max(seq), 0) AS cursor FROM bus_outbox").get() as { cursor: number };
+  const row = getDb().query("SELECT coalesce(max(seq), 0) AS cursor FROM bus_outbox").get() as { cursor: number };
   return row.cursor;
 }
 
 export function getOldestOutboxCursor(): number {
-  const row = getDb().prepare("SELECT min(seq) AS cursor FROM bus_outbox").get() as { cursor: number | null };
+  const row = getDb().query("SELECT min(seq) AS cursor FROM bus_outbox").get() as { cursor: number | null };
   return row.cursor ?? 0;
 }
 

package/src/bus.ts

@@ -99,7 +99,7 @@ export function getBusConnectionCount(): number {
 export function expireStaleBusAgents(graceMs = Number(process.env.AGENT_RELAY_STALE_GRACE_MS) || 120_000): { agentIds: string[]; orphanedTasks: Task[] } {
   const cutoff = Date.now() - graceMs;
   const rows = getDb()
-    .prepare("SELECT id FROM agents WHERE status = 'stale' AND last_seen < ? AND id NOT IN ('user', 'system')")
+    .query("SELECT id FROM agents WHERE status = 'stale' AND last_seen < ? AND id NOT IN ('user', 'system')")
     .all(cutoff) as Array<{ id: string }>;
   const orphanedTasks: Task[] = [];
   for (const row of rows) {

package/src/commands-db.ts

@@ -41,7 +41,7 @@ export function createCommand(input: CreateCommandInput): Command {
     updatedAt: now,
     expiresAt: input.ttlMs ? now + input.ttlMs : defaultExpiresAt(input.type, now),
   };
-  getDb().prepare(`
+  getDb().query(`
     INSERT INTO commands (id, type, source, target, params, status, correlation_id, created_at, updated_at, expires_at)
     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
   `).run(
@@ -60,7 +60,7 @@ export function createCommand(input: CreateCommandInput): Command {
 }
 
 export function getCommand(id: string): Command | null {
-  const row = getDb().prepare("SELECT * FROM commands WHERE id = ?").get(id) as CommandRow | undefined;
+  const row = getDb().query("SELECT * FROM commands WHERE id = ?").get(id) as CommandRow | undefined;
   return row ? rowToCommand(row) : null;
 }
 
@@ -87,7 +87,7 @@ export function listCommands(filters: CommandFilters = {}): Command[] {
   const limit = Math.min(Math.max(filters.limit ?? 100, 1), 500);
   const bindings = [...params, limit] as any[];
   const rows = getDb()
-    .prepare(`SELECT * FROM commands ${where} ORDER BY created_at DESC LIMIT ?`)
+    .query(`SELECT * FROM commands ${where} ORDER BY created_at DESC LIMIT ?`)
     .all(...bindings) as CommandRow[];
   return rows.map(rowToCommand);
 }
@@ -97,7 +97,7 @@ export function updateCommand(id: string, input: UpdateCommandInput): Command |
   if (!existing) return null;
   const nextStatus = input.status ?? existing.status;
   const now = Date.now();
-  getDb().prepare(`
+  getDb().query(`
     UPDATE commands
     SET status = ?, result = ?, error = ?, updated_at = ?
     WHERE id = ?
@@ -121,7 +121,7 @@ export function deleteCommand(id: string): boolean {
 
 export function expireCommands(now: number = Date.now()): Command[] {
   const rows = getDb()
-    .prepare(`SELECT * FROM commands WHERE expires_at IS NOT NULL AND expires_at <= ? AND status IN (${ACTIVE_STATUSES.map(() => "?").join(",")})`)
+    .query(`SELECT * FROM commands WHERE expires_at IS NOT NULL AND expires_at <= ? AND status IN (${ACTIVE_STATUSES.map(() => "?").join(",")})`)
     .all(now, ...ACTIVE_STATUSES) as CommandRow[];
   for (const row of rows) updateCommand(row.id, { status: "timed_out", error: "command timed out" });
   return rows.map((row) => getCommand(row.id)).filter((command): command is Command => Boolean(command));

package/src/config-store.ts

@@ -483,13 +483,13 @@ function normalizeValue(namespace: string, key: string, value: unknown): unknown
 }
 
 export function getConfig<T = unknown>(namespace: string, key: string): ConfigEntry<T> | null {
-  const row = getDb().prepare("SELECT * FROM config WHERE namespace = ? AND key = ?").get(namespace, key) as ConfigRow | undefined;
+  const row = getDb().query("SELECT * FROM config WHERE namespace = ? AND key = ?").get(namespace, key) as ConfigRow | undefined;
   return row ? rowToConfigEntry<T>(row) : null;
 }
 
 export function listConfig<T = unknown>(namespace: string): ConfigEntry<T>[] {
   const rows = getDb()
-    .prepare("SELECT * FROM config WHERE namespace = ? ORDER BY key ASC")
+    .query("SELECT * FROM config WHERE namespace = ? ORDER BY key ASC")
     .all(namespace) as ConfigRow[];
   return rows.map(rowToConfigEntry<T>);
 }
@@ -502,12 +502,12 @@ export function setConfig<T = unknown>(namespace: string, key: string, value: T,
 
   getDb().transaction(() => {
     if (existing) {
-      getDb().prepare(`
+      getDb().query(`
         INSERT INTO config_history (namespace, key, value, version, changed_at, changed_by)
         VALUES (?, ?, ?, ?, ?, ?)
       `).run(existing.namespace, existing.key, JSON.stringify(existing.value), existing.version, now, updatedBy ?? null);
     }
-    getDb().prepare(`
+    getDb().query(`
       INSERT INTO config (namespace, key, value, version, updated_at, updated_by)
       VALUES (?, ?, ?, ?, ?, ?)
       ON CONFLICT(namespace, key) DO UPDATE SET
@@ -527,11 +527,11 @@ export function deleteConfig(namespace: string, key: string, updatedBy?: string)
   if (!existing) return false;
   const now = new Date().toISOString();
   getDb().transaction(() => {
-    getDb().prepare(`
+    getDb().query(`
       INSERT INTO config_history (namespace, key, value, version, changed_at, changed_by)
       VALUES (?, ?, ?, ?, ?, ?)
     `).run(existing.namespace, existing.key, JSON.stringify(existing.value), existing.version, now, updatedBy ?? null);
-    getDb().prepare("DELETE FROM config WHERE namespace = ? AND key = ?").run(namespace, key);
+    getDb().query("DELETE FROM config WHERE namespace = ? AND key = ?").run(namespace, key);
     pruneConfigHistory(namespace, key);
   })();
   return true;
@@ -540,13 +540,13 @@ export function deleteConfig(namespace: string, key: string, updatedBy?: string)
 export function getConfigHistory<T = unknown>(namespace: string, key: string, limit = CONFIG_HISTORY_LIMIT): ConfigHistoryEntry<T>[] {
   const safeLimit = Math.min(Math.max(limit, 1), 500);
   const rows = getDb()
-    .prepare("SELECT * FROM config_history WHERE namespace = ? AND key = ? ORDER BY version DESC, id DESC LIMIT ?")
+    .query("SELECT * FROM config_history WHERE namespace = ? AND key = ? ORDER BY version DESC, id DESC LIMIT ?")
     .all(namespace, key, safeLimit) as ConfigHistoryRow[];
   return rows.map(rowToConfigHistoryEntry<T>);
 }
 
 function pruneConfigHistory(namespace: string, key: string): void {
-  getDb().prepare(`
+  getDb().query(`
     DELETE FROM config_history
     WHERE namespace = ? AND key = ? AND id NOT IN (
       SELECT id FROM config_history
@@ -649,13 +649,13 @@ export function deleteAgentProfile(name: string, updatedBy?: string): boolean {
 }
 
 export function getManagedAgentState(policyName: string): ManagedAgentState | null {
-  const row = getDb().prepare("SELECT * FROM managed_agent_state WHERE policy_name = ?").get(policyName) as ManagedAgentStateRow | undefined;
+  const row = getDb().query("SELECT * FROM managed_agent_state WHERE policy_name = ?").get(policyName) as ManagedAgentStateRow | undefined;
   return row ? rowToManagedAgentState(row) : null;
 }
 
 function listManagedAgentStates(): ManagedAgentState[] {
   const rows = getDb()
-    .prepare("SELECT * FROM managed_agent_state ORDER BY policy_name ASC")
+    .query("SELECT * FROM managed_agent_state ORDER BY policy_name ASC")
     .all() as ManagedAgentStateRow[];
   return rows.map(rowToManagedAgentState);
 }
@@ -664,7 +664,7 @@ export function upsertManagedAgentState(input: ManagedAgentStateInput): ManagedA
   if (!VALID_MANAGED_STATUSES.includes(input.status)) throw new ValidationError("status must be a managed-agent status");
   if (!VALID_PROVIDERS.includes(input.provider)) throw new ValidationError("provider must be claude or codex");
   const now = input.updatedAt ?? Date.now();
-  getDb().prepare(`
+  getDb().query(`
     INSERT INTO managed_agent_state (
       policy_name, status, agent_id, orchestrator_id, provider, tmux_session, spawn_request_id, workspace_id, workspace_path, workspace_branch,
       last_spawn_at, last_stop_at, healthy_since, restart_count, consecutive_failures,
@@ -724,6 +724,6 @@ export function updateManagedAgentState(policyName: string, patch: ManagedAgentS
 }
 
 function deleteManagedAgentState(policyName: string): boolean {
-  const result = getDb().prepare("DELETE FROM managed_agent_state WHERE policy_name = ?").run(policyName);
+  const result = getDb().query("DELETE FROM managed_agent_state WHERE policy_name = ?").run(policyName);
   return result.changes > 0;
 }