@proletariat/cli 0.3.65 → 0.3.66

package/dist/lib/registry/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Machine-level Agent Registry
+ *
+ * Tracks all agents across all projects in a single SQLite database
+ * at ~/.prlt/agents.db. This provides a global view of agent activity
+ * regardless of which workspace they belong to.
+ */
+import Database from 'better-sqlite3';
+export type MachineAgentStatus = 'running' | 'idle' | 'completed';
+export interface MachineAgent {
+    agentName: string;
+    projectPath: string;
+    sessionId: string | null;
+    ticketId: string | null;
+    status: MachineAgentStatus;
+    spawnedAt: string;
+    lastSeenAt: string;
+}
+/**
+ * Open (or create) the machine-level agent registry at ~/.prlt/agents.db.
+ * Ensures the ~/.prlt directory and schema exist.
+ */
+export declare function openMachineRegistry(): Database.Database;
+/**
+ * Register an agent spawn in the machine registry.
+ * Uses INSERT OR REPLACE so re-spawning the same agent updates the record.
+ */
+export declare function registerAgent(params: {
+    agentName: string;
+    projectPath: string;
+    sessionId?: string;
+    ticketId?: string;
+}): void;
+/**
+ * Update the status of an agent in the machine registry.
+ */
+export declare function updateAgentStatus(agentName: string, projectPath: string, status: MachineAgentStatus): void;
+/**
+ * Touch the last_seen_at timestamp for a running agent.
+ */
+export declare function touchAgentLastSeen(agentName: string, projectPath: string): void;
+/**
+ * Get all agents in the machine registry, optionally filtered.
+ */
+export declare function getMachineAgents(filters?: {
+    status?: MachineAgentStatus;
+    projectPath?: string;
+}): MachineAgent[];
+/**
+ * Get a single agent by name and project path.
+ */
+export declare function getMachineAgent(agentName: string, projectPath: string): MachineAgent | undefined;

package/dist/lib/registry/index.js

@@ -0,0 +1,169 @@
+/**
+ * Machine-level Agent Registry
+ *
+ * Tracks all agents across all projects in a single SQLite database
+ * at ~/.prlt/agents.db. This provides a global view of agent activity
+ * regardless of which workspace they belong to.
+ */
+import Database from 'better-sqlite3';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { throwIfNativeBindingError } from '../database/native-validation.js';
+// =============================================================================
+// Schema
+// =============================================================================
+const REGISTRY_SCHEMA = `
+CREATE TABLE IF NOT EXISTS agents (
+  agent_name TEXT NOT NULL,
+  project_path TEXT NOT NULL,
+  session_id TEXT,
+  ticket_id TEXT,
+  status TEXT NOT NULL DEFAULT 'running' CHECK (status IN ('running', 'idle', 'completed')),
+  spawned_at TEXT NOT NULL,
+  last_seen_at TEXT NOT NULL,
+  PRIMARY KEY (agent_name, project_path)
+);
+
+CREATE INDEX IF NOT EXISTS idx_registry_status ON agents(status);
+CREATE INDEX IF NOT EXISTS idx_registry_project ON agents(project_path);
+`;
+// =============================================================================
+// Helpers
+// =============================================================================
+function rowToMachineAgent(row) {
+    return {
+        agentName: row.agent_name,
+        projectPath: row.project_path,
+        sessionId: row.session_id,
+        ticketId: row.ticket_id,
+        status: row.status,
+        spawnedAt: row.spawned_at,
+        lastSeenAt: row.last_seen_at,
+    };
+}
+function getMachineRegistryPath() {
+    return path.join(os.homedir(), '.prlt', 'agents.db');
+}
+// =============================================================================
+// Database Access
+// =============================================================================
+/**
+ * Open (or create) the machine-level agent registry at ~/.prlt/agents.db.
+ * Ensures the ~/.prlt directory and schema exist.
+ */
+export function openMachineRegistry() {
+    const dbPath = getMachineRegistryPath();
+    const dir = path.dirname(dbPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    try {
+        const db = new Database(dbPath);
+        db.pragma('journal_mode = WAL');
+        db.pragma('busy_timeout = 3000');
+        db.exec(REGISTRY_SCHEMA);
+        return db;
+    }
+    catch (error) {
+        throwIfNativeBindingError(error, 'machine agent registry');
+        throw error;
+    }
+}
+// =============================================================================
+// Write Operations
+// =============================================================================
+/**
+ * Register an agent spawn in the machine registry.
+ * Uses INSERT OR REPLACE so re-spawning the same agent updates the record.
+ */
+export function registerAgent(params) {
+    const db = openMachineRegistry();
+    try {
+        const now = new Date().toISOString();
+        db.prepare(`
+      INSERT OR REPLACE INTO agents (agent_name, project_path, session_id, ticket_id, status, spawned_at, last_seen_at)
+      VALUES (?, ?, ?, ?, 'running', ?, ?)
+    `).run(params.agentName, params.projectPath, params.sessionId ?? null, params.ticketId ?? null, now, now);
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Update the status of an agent in the machine registry.
+ */
+export function updateAgentStatus(agentName, projectPath, status) {
+    const db = openMachineRegistry();
+    try {
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE agents SET status = ?, last_seen_at = ?
+      WHERE agent_name = ? AND project_path = ?
+    `).run(status, now, agentName, projectPath);
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Touch the last_seen_at timestamp for a running agent.
+ */
+export function touchAgentLastSeen(agentName, projectPath) {
+    const db = openMachineRegistry();
+    try {
+        const now = new Date().toISOString();
+        db.prepare(`
+      UPDATE agents SET last_seen_at = ?
+      WHERE agent_name = ? AND project_path = ?
+    `).run(now, agentName, projectPath);
+    }
+    finally {
+        db.close();
+    }
+}
+// =============================================================================
+// Read Operations
+// =============================================================================
+/**
+ * Get all agents in the machine registry, optionally filtered.
+ */
+export function getMachineAgents(filters) {
+    const db = openMachineRegistry();
+    try {
+        let sql = 'SELECT * FROM agents';
+        const conditions = [];
+        const params = [];
+        if (filters?.status) {
+            conditions.push('status = ?');
+            params.push(filters.status);
+        }
+        if (filters?.projectPath) {
+            conditions.push('project_path = ?');
+            params.push(filters.projectPath);
+        }
+        if (conditions.length > 0) {
+            sql += ' WHERE ' + conditions.join(' AND ');
+        }
+        sql += ' ORDER BY last_seen_at DESC';
+        const rows = db.prepare(sql).all(...params);
+        return rows.map(rowToMachineAgent);
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Get a single agent by name and project path.
+ */
+export function getMachineAgent(agentName, projectPath) {
+    const db = openMachineRegistry();
+    try {
+        const row = db.prepare('SELECT * FROM agents WHERE agent_name = ? AND project_path = ?').get(agentName, projectPath);
+        return row ? rowToMachineAgent(row) : undefined;
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/registry/index.js.map

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