@revealui/harnesses 0.1.6 → 0.1.8

package/dist/chunk-DGQ5OB6L.js

@@ -0,0 +1,380 @@
+// src/storage/schema.ts
+var SCHEMA_SQL = `
+  CREATE TABLE IF NOT EXISTS agent_sessions (
+    id            TEXT PRIMARY KEY,
+    env           TEXT NOT NULL DEFAULT '',
+    task          TEXT NOT NULL DEFAULT '(starting)',
+    files         TEXT NOT NULL DEFAULT '',
+    pid           INTEGER,
+    started_at    TIMESTAMP NOT NULL DEFAULT NOW(),
+    updated_at    TIMESTAMP NOT NULL DEFAULT NOW(),
+    ended_at      TIMESTAMP,
+    exit_summary  TEXT
+  );
+
+  CREATE TABLE IF NOT EXISTS agent_messages (
+    id            SERIAL PRIMARY KEY,
+    from_agent    TEXT NOT NULL,
+    to_agent      TEXT NOT NULL,
+    subject       TEXT NOT NULL DEFAULT '',
+    body          TEXT NOT NULL DEFAULT '',
+    read          BOOLEAN NOT NULL DEFAULT FALSE,
+    created_at    TIMESTAMP NOT NULL DEFAULT NOW()
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_messages_to_unread
+    ON agent_messages (to_agent, read) WHERE read = FALSE;
+
+  CREATE TABLE IF NOT EXISTS file_reservations (
+    file_path     TEXT PRIMARY KEY,
+    agent_id      TEXT NOT NULL,
+    reserved_at   TIMESTAMP NOT NULL DEFAULT NOW(),
+    expires_at    TIMESTAMP NOT NULL,
+    reason        TEXT NOT NULL DEFAULT ''
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_reservations_agent
+    ON file_reservations (agent_id);
+
+  CREATE TABLE IF NOT EXISTS tasks (
+    id            TEXT PRIMARY KEY,
+    description   TEXT NOT NULL DEFAULT '',
+    status        TEXT NOT NULL DEFAULT 'open',
+    owner         TEXT,
+    claimed_at    TIMESTAMP,
+    completed_at  TIMESTAMP,
+    created_at    TIMESTAMP NOT NULL DEFAULT NOW()
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_tasks_status
+    ON tasks (status);
+
+  CREATE INDEX IF NOT EXISTS idx_tasks_owner
+    ON tasks (owner) WHERE owner IS NOT NULL;
+
+  CREATE TABLE IF NOT EXISTS events (
+    id            SERIAL PRIMARY KEY,
+    agent_id      TEXT NOT NULL,
+    event_type    TEXT NOT NULL,
+    payload       JSONB NOT NULL DEFAULT '{}',
+    created_at    TIMESTAMP NOT NULL DEFAULT NOW()
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_events_agent
+    ON events (agent_id, created_at DESC);
+`;
+
+// src/storage/daemon-store.ts
+var DaemonStore = class {
+  db = null;
+  dataDir;
+  constructor(config) {
+    this.dataDir = config.dataDir;
+  }
+  /** Initialize PGlite and create tables. */
+  async init() {
+    const { PGlite: PGliteClass } = await import("@electric-sql/pglite");
+    this.db = new PGliteClass(this.dataDir);
+    await this.db.exec(SCHEMA_SQL);
+  }
+  /** Shut down the database. */
+  async close() {
+    if (this.db) {
+      await this.db.close();
+      this.db = null;
+    }
+  }
+  getDb() {
+    if (!this.db) throw new Error("DaemonStore not initialized \u2014 call init() first");
+    return this.db;
+  }
+  // ---------------------------------------------------------------------------
+  // Sessions
+  // ---------------------------------------------------------------------------
+  /** Register or update an agent session. */
+  async registerSession(session) {
+    const db = this.getDb();
+    const result = await db.query(
+      `INSERT INTO agent_sessions (id, env, task, pid)
+       VALUES ($1, $2, $3, $4)
+       ON CONFLICT (id) DO UPDATE SET
+         env = EXCLUDED.env,
+         task = COALESCE(EXCLUDED.task, agent_sessions.task),
+         pid = COALESCE(EXCLUDED.pid, agent_sessions.pid),
+         updated_at = NOW(),
+         ended_at = NULL
+       RETURNING *`,
+      [session.id, session.env, session.task ?? "(starting)", session.pid ?? null]
+    );
+    return result.rows[0];
+  }
+  /** Update a session's task and/or files. */
+  async updateSession(id, updates) {
+    const db = this.getDb();
+    const sets = ["updated_at = NOW()"];
+    const params = [];
+    let paramIdx = 1;
+    if (updates.task !== void 0) {
+      sets.push(`task = $${paramIdx++}`);
+      params.push(updates.task);
+    }
+    if (updates.files !== void 0) {
+      sets.push(`files = $${paramIdx++}`);
+      params.push(updates.files);
+    }
+    params.push(id);
+    const result = await db.query(
+      `UPDATE agent_sessions SET ${sets.join(", ")} WHERE id = $${paramIdx} RETURNING *`,
+      params
+    );
+    return result.rows[0] ?? null;
+  }
+  /** End a session (mark ended_at, record exit summary). */
+  async endSession(id, exitSummary) {
+    const db = this.getDb();
+    await db.query(
+      `UPDATE agent_sessions SET ended_at = NOW(), exit_summary = $2, updated_at = NOW()
+       WHERE id = $1`,
+      [id, exitSummary ?? null]
+    );
+  }
+  /** Get all active sessions (ended_at IS NULL). */
+  async getActiveSessions() {
+    const db = this.getDb();
+    const result = await db.query(
+      "SELECT * FROM agent_sessions WHERE ended_at IS NULL ORDER BY started_at"
+    );
+    return result.rows;
+  }
+  /** Get session history for an agent (most recent first). */
+  async getSessionHistory(agentId, limit) {
+    const db = this.getDb();
+    const result = await db.query(
+      "SELECT * FROM agent_sessions WHERE id = $1 ORDER BY started_at DESC LIMIT $2",
+      [agentId, limit]
+    );
+    return result.rows;
+  }
+  // ---------------------------------------------------------------------------
+  // Messages
+  // ---------------------------------------------------------------------------
+  /** Send a message from one agent to another. */
+  async sendMessage(msg) {
+    const db = this.getDb();
+    const result = await db.query(
+      `INSERT INTO agent_messages (from_agent, to_agent, subject, body)
+       VALUES ($1, $2, $3, $4)
+       RETURNING *`,
+      [msg.fromAgent, msg.toAgent, msg.subject, msg.body ?? ""]
+    );
+    return result.rows[0];
+  }
+  /** Broadcast a message to all active agents (except sender). */
+  async broadcastMessage(msg) {
+    const active = await this.getActiveSessions();
+    let sent = 0;
+    for (const session of active) {
+      if (session.id === msg.fromAgent) continue;
+      await this.sendMessage({
+        fromAgent: msg.fromAgent,
+        toAgent: session.id,
+        subject: msg.subject,
+        body: msg.body
+      });
+      sent++;
+    }
+    return sent;
+  }
+  /** Get unread messages for an agent. */
+  async getInbox(agentId, unreadOnly) {
+    const db = this.getDb();
+    const whereClause = unreadOnly ? "WHERE to_agent = $1 AND read = FALSE" : "WHERE to_agent = $1";
+    const result = await db.query(
+      `SELECT * FROM agent_messages ${whereClause} ORDER BY created_at DESC LIMIT 50`,
+      [agentId]
+    );
+    return result.rows;
+  }
+  /** Mark messages as read. */
+  async markRead(messageIds) {
+    if (messageIds.length === 0) return;
+    const db = this.getDb();
+    const placeholders = messageIds.map((_, i) => `$${i + 1}`).join(", ");
+    await db.query(
+      `UPDATE agent_messages SET read = TRUE WHERE id IN (${placeholders})`,
+      messageIds
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // File Reservations
+  // ---------------------------------------------------------------------------
+  /** Reserve a file for an agent (CAS: fails if already reserved by another). */
+  async reserveFile(reservation) {
+    const db = this.getDb();
+    await db.query("DELETE FROM file_reservations WHERE expires_at < NOW()");
+    const result = await db.query(
+      `INSERT INTO file_reservations (file_path, agent_id, expires_at, reason)
+       VALUES ($1, $2, NOW() + ($3 || ' seconds')::INTERVAL, $4)
+       ON CONFLICT (file_path) DO UPDATE SET
+         agent_id = EXCLUDED.agent_id,
+         reserved_at = NOW(),
+         expires_at = EXCLUDED.expires_at,
+         reason = EXCLUDED.reason
+       WHERE file_reservations.agent_id = $2 OR file_reservations.expires_at < NOW()
+       RETURNING *`,
+      [
+        reservation.filePath,
+        reservation.agentId,
+        String(reservation.ttlSeconds),
+        reservation.reason ?? ""
+      ]
+    );
+    if (result.rows.length > 0) {
+      return { success: true };
+    }
+    const existing = await db.query(
+      "SELECT agent_id FROM file_reservations WHERE file_path = $1",
+      [reservation.filePath]
+    );
+    return { success: false, holder: existing.rows[0]?.agent_id };
+  }
+  /** Check who holds a file reservation. */
+  async checkReservation(filePath) {
+    const db = this.getDb();
+    await db.query("DELETE FROM file_reservations WHERE expires_at < NOW()");
+    const result = await db.query(
+      "SELECT * FROM file_reservations WHERE file_path = $1",
+      [filePath]
+    );
+    return result.rows[0] ?? null;
+  }
+  /** Release all reservations held by an agent. */
+  async releaseAllReservations(agentId) {
+    const db = this.getDb();
+    const result = await db.query("DELETE FROM file_reservations WHERE agent_id = $1", [agentId]);
+    return result.affectedRows ?? 0;
+  }
+  /** Get all reservations for an agent. */
+  async getReservations(agentId) {
+    const db = this.getDb();
+    await db.query("DELETE FROM file_reservations WHERE expires_at < NOW()");
+    const result = await db.query(
+      "SELECT * FROM file_reservations WHERE agent_id = $1 ORDER BY reserved_at",
+      [agentId]
+    );
+    return result.rows;
+  }
+  // ---------------------------------------------------------------------------
+  // Tasks
+  // ---------------------------------------------------------------------------
+  /** Create a new task. */
+  async createTask(task) {
+    const db = this.getDb();
+    const result = await db.query(
+      `INSERT INTO tasks (id, description) VALUES ($1, $2)
+       ON CONFLICT (id) DO UPDATE SET description = EXCLUDED.description
+       RETURNING *`,
+      [task.id, task.description]
+    );
+    return result.rows[0];
+  }
+  /** Claim a task atomically (CAS: fails if already claimed by another agent). */
+  async claimTask(taskId, agentId) {
+    const db = this.getDb();
+    const result = await db.query(
+      `UPDATE tasks SET status = 'claimed', owner = $2, claimed_at = NOW()
+       WHERE id = $1 AND (status = 'open' OR owner = $2)
+       RETURNING *`,
+      [taskId, agentId]
+    );
+    if (result.rows.length > 0) {
+      return { success: true };
+    }
+    const existing = await db.query("SELECT owner FROM tasks WHERE id = $1", [taskId]);
+    if (existing.rows.length === 0) {
+      return { success: false, owner: void 0 };
+    }
+    return { success: false, owner: existing.rows[0].owner ?? void 0 };
+  }
+  /** Complete a task (only the owner can complete it). */
+  async completeTask(taskId, agentId) {
+    const db = this.getDb();
+    const result = await db.query(
+      `UPDATE tasks SET status = 'completed', completed_at = NOW()
+       WHERE id = $1 AND owner = $2
+       RETURNING id`,
+      [taskId, agentId]
+    );
+    return (result.rows?.length ?? 0) > 0;
+  }
+  /** Release a claimed task back to open (only the owner can release). */
+  async releaseTask(taskId, agentId) {
+    const db = this.getDb();
+    const result = await db.query(
+      `UPDATE tasks SET status = 'open', owner = NULL, claimed_at = NULL
+       WHERE id = $1 AND owner = $2
+       RETURNING id`,
+      [taskId, agentId]
+    );
+    return (result.rows?.length ?? 0) > 0;
+  }
+  /** List tasks, optionally filtered by status and/or owner. */
+  async listTasks(filter) {
+    const db = this.getDb();
+    const conditions = [];
+    const params = [];
+    let paramIdx = 1;
+    if (filter?.status) {
+      conditions.push(`status = $${paramIdx++}`);
+      params.push(filter.status);
+    }
+    if (filter?.owner) {
+      conditions.push(`owner = $${paramIdx++}`);
+      params.push(filter.owner);
+    }
+    const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const result = await db.query(
+      `SELECT * FROM tasks ${where} ORDER BY created_at`,
+      params
+    );
+    return result.rows;
+  }
+  // ---------------------------------------------------------------------------
+  // Events
+  // ---------------------------------------------------------------------------
+  /** Append an event to the audit log. */
+  async logEvent(event) {
+    const db = this.getDb();
+    const result = await db.query(
+      `INSERT INTO events (agent_id, event_type, payload)
+       VALUES ($1, $2, $3)
+       RETURNING *`,
+      [event.agentId, event.eventType, JSON.stringify(event.payload ?? {})]
+    );
+    return result.rows[0];
+  }
+  /** Get recent events (newest first). */
+  async getRecentEvents(limit) {
+    const db = this.getDb();
+    const result = await db.query(
+      "SELECT * FROM events ORDER BY created_at DESC LIMIT $1",
+      [limit]
+    );
+    return result.rows;
+  }
+  /** Prune events older than a given number of days. */
+  async pruneEvents(olderThanDays) {
+    const db = this.getDb();
+    const result = await db.query(
+      `DELETE FROM events WHERE created_at < NOW() - ($1 || ' days')::INTERVAL`,
+      [String(olderThanDays)]
+    );
+    return result.affectedRows ?? 0;
+  }
+};
+
+export {
+  SCHEMA_SQL,
+  DaemonStore
+};
+//# sourceMappingURL=chunk-DGQ5OB6L.js.map

package/dist/chunk-DGQ5OB6L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/schema.ts","../src/storage/daemon-store.ts"],"sourcesContent":["/**\n * PGlite schema for the RevDev Harness daemon.\n *\n * Five tables provide persistent state for multi-agent coordination:\n *   - agent_sessions: active and historical agent sessions\n *   - agent_messages: inter-agent mailbox (point-to-point + broadcast)\n *   - file_reservations: advisory file locks with CAS semantics\n *   - tasks: claimable work items with CAS ownership\n *   - events: append-only event log for audit trail\n *\n * Uses raw SQL (no Drizzle ORM) to keep the daemon dependency-free.\n * PGlite runs in-process — no external database needed.\n */\n\n/** SQL statements to initialize the daemon database. */\nexport const SCHEMA_SQL = `\n  CREATE TABLE IF NOT EXISTS agent_sessions (\n    id            TEXT PRIMARY KEY,\n    env           TEXT NOT NULL DEFAULT '',\n    task          TEXT NOT NULL DEFAULT '(starting)',\n    files         TEXT NOT NULL DEFAULT '',\n    pid           INTEGER,\n    started_at    TIMESTAMP NOT NULL DEFAULT NOW(),\n    updated_at    TIMESTAMP NOT NULL DEFAULT NOW(),\n    ended_at      TIMESTAMP,\n    exit_summary  TEXT\n  );\n\n  CREATE TABLE IF NOT EXISTS agent_messages (\n    id            SERIAL PRIMARY KEY,\n    from_agent    TEXT NOT NULL,\n    to_agent      TEXT NOT NULL,\n    subject       TEXT NOT NULL DEFAULT '',\n    body          TEXT NOT NULL DEFAULT '',\n    read          BOOLEAN NOT NULL DEFAULT FALSE,\n    created_at    TIMESTAMP NOT NULL DEFAULT NOW()\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_messages_to_unread\n    ON agent_messages (to_agent, read) WHERE read = FALSE;\n\n  CREATE TABLE IF NOT EXISTS file_reservations (\n    file_path     TEXT PRIMARY KEY,\n    agent_id      TEXT NOT NULL,\n    reserved_at   TIMESTAMP NOT NULL DEFAULT NOW(),\n    expires_at    TIMESTAMP NOT NULL,\n    reason        TEXT NOT NULL DEFAULT ''\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_reservations_agent\n    ON file_reservations (agent_id);\n\n  CREATE TABLE IF NOT EXISTS tasks (\n    id            TEXT PRIMARY KEY,\n    description   TEXT NOT NULL DEFAULT '',\n    status        TEXT NOT NULL DEFAULT 'open',\n    owner         TEXT,\n    claimed_at    TIMESTAMP,\n    completed_at  TIMESTAMP,\n    created_at    TIMESTAMP NOT NULL DEFAULT NOW()\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_tasks_status\n    ON tasks (status);\n\n  CREATE INDEX IF NOT EXISTS idx_tasks_owner\n    ON tasks (owner) WHERE owner IS NOT NULL;\n\n  CREATE TABLE IF NOT EXISTS events (\n    id            SERIAL PRIMARY KEY,\n    agent_id      TEXT NOT NULL,\n    event_type    TEXT NOT NULL,\n    payload       JSONB NOT NULL DEFAULT '{}',\n    created_at    TIMESTAMP NOT NULL DEFAULT NOW()\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_events_agent\n    ON events (agent_id, created_at DESC);\n`;\n\n/** Session row shape. */\nexport interface AgentSession {\n  id: string;\n  env: string;\n  task: string;\n  files: string;\n  pid: number | null;\n  started_at: string;\n  updated_at: string;\n  ended_at: string | null;\n  exit_summary: string | null;\n}\n\n/** Message row shape. */\nexport interface AgentMessage {\n  id: number;\n  from_agent: string;\n  to_agent: string;\n  subject: string;\n  body: string;\n  read: boolean;\n  created_at: string;\n}\n\n/** File reservation row shape. */\nexport interface FileReservation {\n  file_path: string;\n  agent_id: string;\n  reserved_at: string;\n  expires_at: string;\n  reason: string;\n}\n\n/** Task row shape. */\nexport interface AgentTask {\n  id: string;\n  description: string;\n  status: 'open' | 'claimed' | 'completed';\n  owner: string | null;\n  claimed_at: string | null;\n  completed_at: string | null;\n  created_at: string;\n}\n\n/** Event row shape. */\nexport interface DaemonEvent {\n  id: number;\n  agent_id: string;\n  event_type: string;\n  payload: Record<string, unknown>;\n  created_at: string;\n}\n","/**\n * DaemonStore — persistent state for the RevDev Harness daemon.\n *\n * Backed by PGlite (in-process PostgreSQL). The database file lives at\n * ~/.local/share/revealui/harness.db and survives daemon restarts.\n *\n * All methods are async (PGlite queries return promises).\n */\n\nimport type { PGlite } from '@electric-sql/pglite';\nimport type {\n  AgentMessage,\n  AgentSession,\n  AgentTask,\n  DaemonEvent,\n  FileReservation,\n} from './schema.js';\nimport { SCHEMA_SQL } from './schema.js';\n\n/** Configuration for DaemonStore. */\nexport interface DaemonStoreConfig {\n  /** PGlite data directory (default: ~/.local/share/revealui/harness.db) */\n  dataDir: string;\n}\n\nexport class DaemonStore {\n  private db: PGlite | null = null;\n  private readonly dataDir: string;\n\n  constructor(config: DaemonStoreConfig) {\n    this.dataDir = config.dataDir;\n  }\n\n  /** Initialize PGlite and create tables. */\n  async init(): Promise<void> {\n    const { PGlite: PGliteClass } = await import('@electric-sql/pglite');\n    this.db = new PGliteClass(this.dataDir);\n    await this.db.exec(SCHEMA_SQL);\n  }\n\n  /** Shut down the database. */\n  async close(): Promise<void> {\n    if (this.db) {\n      await this.db.close();\n      this.db = null;\n    }\n  }\n\n  private getDb(): PGlite {\n    if (!this.db) throw new Error('DaemonStore not initialized — call init() first');\n    return this.db;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Sessions\n  // ---------------------------------------------------------------------------\n\n  /** Register or update an agent session. */\n  async registerSession(session: {\n    id: string;\n    env: string;\n    task?: string;\n    pid?: number;\n  }): Promise<AgentSession> {\n    const db = this.getDb();\n    const result = await db.query<AgentSession>(\n      `INSERT INTO agent_sessions (id, env, task, pid)\n       VALUES ($1, $2, $3, $4)\n       ON CONFLICT (id) DO UPDATE SET\n         env = EXCLUDED.env,\n         task = COALESCE(EXCLUDED.task, agent_sessions.task),\n         pid = COALESCE(EXCLUDED.pid, agent_sessions.pid),\n         updated_at = NOW(),\n         ended_at = NULL\n       RETURNING *`,\n      [session.id, session.env, session.task ?? '(starting)', session.pid ?? null],\n    );\n    // RETURNING * always produces a row for INSERT ... ON CONFLICT DO UPDATE\n    return result.rows[0] as AgentSession;\n  }\n\n  /** Update a session's task and/or files. */\n  async updateSession(\n    id: string,\n    updates: { task?: string; files?: string },\n  ): Promise<AgentSession | null> {\n    const db = this.getDb();\n    const sets: string[] = ['updated_at = NOW()'];\n    const params: unknown[] = [];\n    let paramIdx = 1;\n\n    if (updates.task !== undefined) {\n      sets.push(`task = $${paramIdx++}`);\n      params.push(updates.task);\n    }\n    if (updates.files !== undefined) {\n      sets.push(`files = $${paramIdx++}`);\n      params.push(updates.files);\n    }\n    params.push(id);\n\n    const result = await db.query<AgentSession>(\n      `UPDATE agent_sessions SET ${sets.join(', ')} WHERE id = $${paramIdx} RETURNING *`,\n      params,\n    );\n    return result.rows[0] ?? null;\n  }\n\n  /** End a session (mark ended_at, record exit summary). */\n  async endSession(id: string, exitSummary?: string): Promise<void> {\n    const db = this.getDb();\n    await db.query(\n      `UPDATE agent_sessions SET ended_at = NOW(), exit_summary = $2, updated_at = NOW()\n       WHERE id = $1`,\n      [id, exitSummary ?? null],\n    );\n  }\n\n  /** Get all active sessions (ended_at IS NULL). */\n  async getActiveSessions(): Promise<AgentSession[]> {\n    const db = this.getDb();\n    const result = await db.query<AgentSession>(\n      'SELECT * FROM agent_sessions WHERE ended_at IS NULL ORDER BY started_at',\n    );\n    return result.rows;\n  }\n\n  /** Get session history for an agent (most recent first). */\n  async getSessionHistory(agentId: string, limit: number): Promise<AgentSession[]> {\n    const db = this.getDb();\n    const result = await db.query<AgentSession>(\n      'SELECT * FROM agent_sessions WHERE id = $1 ORDER BY started_at DESC LIMIT $2',\n      [agentId, limit],\n    );\n    return result.rows;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Messages\n  // ---------------------------------------------------------------------------\n\n  /** Send a message from one agent to another. */\n  async sendMessage(msg: {\n    fromAgent: string;\n    toAgent: string;\n    subject: string;\n    body?: string;\n  }): Promise<AgentMessage> {\n    const db = this.getDb();\n    const result = await db.query<AgentMessage>(\n      `INSERT INTO agent_messages (from_agent, to_agent, subject, body)\n       VALUES ($1, $2, $3, $4)\n       RETURNING *`,\n      [msg.fromAgent, msg.toAgent, msg.subject, msg.body ?? ''],\n    );\n    // RETURNING * always produces a row for a plain INSERT\n    return result.rows[0] as AgentMessage;\n  }\n\n  /** Broadcast a message to all active agents (except sender). */\n  async broadcastMessage(msg: {\n    fromAgent: string;\n    subject: string;\n    body?: string;\n  }): Promise<number> {\n    const active = await this.getActiveSessions();\n    let sent = 0;\n    for (const session of active) {\n      if (session.id === msg.fromAgent) continue;\n      await this.sendMessage({\n        fromAgent: msg.fromAgent,\n        toAgent: session.id,\n        subject: msg.subject,\n        body: msg.body,\n      });\n      sent++;\n    }\n    return sent;\n  }\n\n  /** Get unread messages for an agent. */\n  async getInbox(agentId: string, unreadOnly: boolean): Promise<AgentMessage[]> {\n    const db = this.getDb();\n    const whereClause = unreadOnly ? 'WHERE to_agent = $1 AND read = FALSE' : 'WHERE to_agent = $1';\n    const result = await db.query<AgentMessage>(\n      `SELECT * FROM agent_messages ${whereClause} ORDER BY created_at DESC LIMIT 50`,\n      [agentId],\n    );\n    return result.rows;\n  }\n\n  /** Mark messages as read. */\n  async markRead(messageIds: number[]): Promise<void> {\n    if (messageIds.length === 0) return;\n    const db = this.getDb();\n    const placeholders = messageIds.map((_, i) => `$${i + 1}`).join(', ');\n    await db.query(\n      `UPDATE agent_messages SET read = TRUE WHERE id IN (${placeholders})`,\n      messageIds,\n    );\n  }\n\n  // ---------------------------------------------------------------------------\n  // File Reservations\n  // ---------------------------------------------------------------------------\n\n  /** Reserve a file for an agent (CAS: fails if already reserved by another). */\n  async reserveFile(reservation: {\n    filePath: string;\n    agentId: string;\n    ttlSeconds: number;\n    reason?: string;\n  }): Promise<{ success: boolean; holder?: string }> {\n    const db = this.getDb();\n\n    // Clean expired reservations first\n    await db.query('DELETE FROM file_reservations WHERE expires_at < NOW()');\n\n    // Try to insert (CAS semantics via ON CONFLICT)\n    const result = await db.query<FileReservation>(\n      `INSERT INTO file_reservations (file_path, agent_id, expires_at, reason)\n       VALUES ($1, $2, NOW() + ($3 || ' seconds')::INTERVAL, $4)\n       ON CONFLICT (file_path) DO UPDATE SET\n         agent_id = EXCLUDED.agent_id,\n         reserved_at = NOW(),\n         expires_at = EXCLUDED.expires_at,\n         reason = EXCLUDED.reason\n       WHERE file_reservations.agent_id = $2 OR file_reservations.expires_at < NOW()\n       RETURNING *`,\n      [\n        reservation.filePath,\n        reservation.agentId,\n        String(reservation.ttlSeconds),\n        reservation.reason ?? '',\n      ],\n    );\n\n    if (result.rows.length > 0) {\n      return { success: true };\n    }\n\n    // Someone else holds it — who?\n    const existing = await db.query<FileReservation>(\n      'SELECT agent_id FROM file_reservations WHERE file_path = $1',\n      [reservation.filePath],\n    );\n    return { success: false, holder: existing.rows[0]?.agent_id };\n  }\n\n  /** Check who holds a file reservation. */\n  async checkReservation(filePath: string): Promise<FileReservation | null> {\n    const db = this.getDb();\n    // Clean expired first\n    await db.query('DELETE FROM file_reservations WHERE expires_at < NOW()');\n    const result = await db.query<FileReservation>(\n      'SELECT * FROM file_reservations WHERE file_path = $1',\n      [filePath],\n    );\n    return result.rows[0] ?? null;\n  }\n\n  /** Release all reservations held by an agent. */\n  async releaseAllReservations(agentId: string): Promise<number> {\n    const db = this.getDb();\n    const result = await db.query('DELETE FROM file_reservations WHERE agent_id = $1', [agentId]);\n    return result.affectedRows ?? 0;\n  }\n\n  /** Get all reservations for an agent. */\n  async getReservations(agentId: string): Promise<FileReservation[]> {\n    const db = this.getDb();\n    await db.query('DELETE FROM file_reservations WHERE expires_at < NOW()');\n    const result = await db.query<FileReservation>(\n      'SELECT * FROM file_reservations WHERE agent_id = $1 ORDER BY reserved_at',\n      [agentId],\n    );\n    return result.rows;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Tasks\n  // ---------------------------------------------------------------------------\n\n  /** Create a new task. */\n  async createTask(task: { id: string; description: string }): Promise<AgentTask> {\n    const db = this.getDb();\n    const result = await db.query<AgentTask>(\n      `INSERT INTO tasks (id, description) VALUES ($1, $2)\n       ON CONFLICT (id) DO UPDATE SET description = EXCLUDED.description\n       RETURNING *`,\n      [task.id, task.description],\n    );\n    return result.rows[0] as AgentTask;\n  }\n\n  /** Claim a task atomically (CAS: fails if already claimed by another agent). */\n  async claimTask(taskId: string, agentId: string): Promise<{ success: boolean; owner?: string }> {\n    const db = this.getDb();\n    // Atomic: only claim if status is 'open' OR already owned by the same agent\n    const result = await db.query<AgentTask>(\n      `UPDATE tasks SET status = 'claimed', owner = $2, claimed_at = NOW()\n       WHERE id = $1 AND (status = 'open' OR owner = $2)\n       RETURNING *`,\n      [taskId, agentId],\n    );\n    if (result.rows.length > 0) {\n      return { success: true };\n    }\n    // Someone else owns it — who?\n    const existing = await db.query<AgentTask>('SELECT owner FROM tasks WHERE id = $1', [taskId]);\n    if (existing.rows.length === 0) {\n      return { success: false, owner: undefined };\n    }\n    return { success: false, owner: (existing.rows[0] as AgentTask).owner ?? undefined };\n  }\n\n  /** Complete a task (only the owner can complete it). */\n  async completeTask(taskId: string, agentId: string): Promise<boolean> {\n    const db = this.getDb();\n    const result = await db.query(\n      `UPDATE tasks SET status = 'completed', completed_at = NOW()\n       WHERE id = $1 AND owner = $2\n       RETURNING id`,\n      [taskId, agentId],\n    );\n    return (result.rows?.length ?? 0) > 0;\n  }\n\n  /** Release a claimed task back to open (only the owner can release). */\n  async releaseTask(taskId: string, agentId: string): Promise<boolean> {\n    const db = this.getDb();\n    const result = await db.query(\n      `UPDATE tasks SET status = 'open', owner = NULL, claimed_at = NULL\n       WHERE id = $1 AND owner = $2\n       RETURNING id`,\n      [taskId, agentId],\n    );\n    return (result.rows?.length ?? 0) > 0;\n  }\n\n  /** List tasks, optionally filtered by status and/or owner. */\n  async listTasks(filter?: { status?: string; owner?: string }): Promise<AgentTask[]> {\n    const db = this.getDb();\n    const conditions: string[] = [];\n    const params: unknown[] = [];\n    let paramIdx = 1;\n\n    if (filter?.status) {\n      conditions.push(`status = $${paramIdx++}`);\n      params.push(filter.status);\n    }\n    if (filter?.owner) {\n      conditions.push(`owner = $${paramIdx++}`);\n      params.push(filter.owner);\n    }\n\n    const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';\n    const result = await db.query<AgentTask>(\n      `SELECT * FROM tasks ${where} ORDER BY created_at`,\n      params,\n    );\n    return result.rows;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Events\n  // ---------------------------------------------------------------------------\n\n  /** Append an event to the audit log. */\n  async logEvent(event: {\n    agentId: string;\n    eventType: string;\n    payload?: Record<string, unknown>;\n  }): Promise<DaemonEvent> {\n    const db = this.getDb();\n    const result = await db.query<DaemonEvent>(\n      `INSERT INTO events (agent_id, event_type, payload)\n       VALUES ($1, $2, $3)\n       RETURNING *`,\n      [event.agentId, event.eventType, JSON.stringify(event.payload ?? {})],\n    );\n    // RETURNING * always produces a row for a plain INSERT\n    return result.rows[0] as DaemonEvent;\n  }\n\n  /** Get recent events (newest first). */\n  async getRecentEvents(limit: number): Promise<DaemonEvent[]> {\n    const db = this.getDb();\n    const result = await db.query<DaemonEvent>(\n      'SELECT * FROM events ORDER BY created_at DESC LIMIT $1',\n      [limit],\n    );\n    return result.rows;\n  }\n\n  /** Prune events older than a given number of days. */\n  async pruneEvents(olderThanDays: number): Promise<number> {\n    const db = this.getDb();\n    const result = await db.query(\n      `DELETE FROM events WHERE created_at < NOW() - ($1 || ' days')::INTERVAL`,\n      [String(olderThanDays)],\n    );\n    return result.affectedRows ?? 0;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-XXEKWC6F.js → chunk-PROC6EJC.js}

@@ -58,7 +58,7 @@ Detect documentation drift \u2014 places where code has changed but docs haven't
 - Flag undocumented commands or removed commands still in docs
 
 ### 4. Collection Fields \u2194 CMS Docs
-- Compare \`apps/cms/src/collections/\` field definitions against any collection docs
+- Compare \`apps/admin/src/collections/\` field definitions against any collection docs
 - Flag field additions/removals not reflected in documentation
 
 ### 5. Environment Variables
@@ -355,7 +355,7 @@ var stripeBestPracticesCommand = {
 - Log \`stripe_error\` codes for debugging; never expose raw error objects to clients
 
 ## RevealUI-Specific
-- Webhook endpoint: \`apps/cms\` at \`/api/webhooks/stripe\` (NOT the API endpoint)
+- Webhook endpoint: \`apps/admin\` at \`/api/webhooks/stripe\` (NOT the API endpoint)
 - Stripe service: \`packages/services/src/stripe/\`
 - Billing routes: \`apps/api/src/routes/billing.ts\`
 - Price IDs are managed via \`pnpm stripe:seed\` \u2014 see \`scripts/setup/seed-stripe.ts\``
@@ -569,8 +569,8 @@ RevealUI uses **two databases with strictly separated responsibilities**:
 - \`packages/core/\` \u2014 CMS engine must be DB-agnostic
 - \`packages/contracts/\` \u2014 contracts are schema-only
 - \`packages/config/\` \u2014 config must not hardcode DB client
-- \`apps/cms/src/collections/\` \u2014 collection hooks use Drizzle/Neon only
-- \`apps/cms/src/routes/\` \u2014 REST routes use Neon only
+- \`apps/admin/src/collections/\` \u2014 collection hooks use Drizzle/Neon only
+- \`apps/admin/src/routes/\` \u2014 REST routes use Neon only
 
 ## Schema Organization
 
@@ -773,7 +773,7 @@ When the Skill tool is available, proactively invoke the following skills in the
 
 - \`/vercel-react-best-practices\` \u2014 before completing any PR that touches React components or hooks
 - \`/stripe-best-practices\` \u2014 any time you write or modify billing, payment, webhook, or Stripe code
-- \`/next-best-practices\` \u2014 when implementing features in apps/cms or apps/marketing
+- \`/next-best-practices\` \u2014 when implementing features in apps/admin or apps/marketing
 - \`/next-cache-components\` \u2014 when adding 'use cache', cache profiles, or PPR to a Next.js route
 - \`/vercel-composition-patterns\` \u2014 when adding new components to @revealui/presentation
 - \`/web-design-guidelines\` \u2014 when asked to review a UI, page, or component for quality
@@ -932,7 +932,7 @@ In v4, theme tokens go in CSS, not JS:
 
 ### Consumer Pattern (current \u2014 v3 compat)
 \`\`\`ts
-// apps/cms/tailwind.config.ts
+// apps/admin/tailwind.config.ts
 import { createTailwindConfig } from 'dev/tailwind/create-config'
 export default createTailwindConfig({
   content: ['./src/**/*.{ts,tsx}'],
@@ -1589,8 +1589,8 @@ RevealUI uses **two databases with strictly separated responsibilities**:
 - \`packages/core/\` \u2014 CMS engine must be DB-agnostic
 - \`packages/contracts/\` \u2014 contracts are schema-only
 - \`packages/config/\` \u2014 config must not hardcode DB client
-- \`apps/cms/src/collections/\` \u2014 collection hooks use Drizzle/Neon only
-- \`apps/cms/src/routes/\` \u2014 REST routes use Neon only
+- \`apps/admin/src/collections/\` \u2014 collection hooks use Drizzle/Neon only
+- \`apps/admin/src/routes/\` \u2014 REST routes use Neon only
 
 ## Schema Organization
 
@@ -1815,7 +1815,7 @@ Follow these rules for ALL code changes in the RevealUI monorepo.
 - \`packages/services/src/supabase/\`
 - \`apps/*/src/lib/supabase/\`
 
-FORBIDDEN in: \`packages/core/\`, \`packages/contracts/\`, \`packages/config/\`, \`apps/cms/src/collections/\`, \`apps/cms/src/routes/\`
+FORBIDDEN in: \`packages/core/\`, \`packages/contracts/\`, \`packages/config/\`, \`apps/admin/src/collections/\`, \`apps/admin/src/routes/\`
 
 ## Code Quality
 
@@ -2534,4 +2534,4 @@ export {
   diffContent,
   listContent
 };
-//# sourceMappingURL=chunk-XXEKWC6F.js.map
+//# sourceMappingURL=chunk-PROC6EJC.js.map