agent-relay 0.1.0

package/dist/supervisor/state.js

@@ -0,0 +1,465 @@
+/**
+ * Agent State Management
+ *
+ * Handles persistent state for spawn-per-message architecture.
+ * Each agent has a state.json that maintains context across spawns.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { parseInboxMarkdown } from './inbox.js';
+/** Current state schema version */
+const STATE_VERSION = 1;
+/**
+ * State Manager for a single agent
+ */
+export class StateManager {
+    statePath;
+    lockPath;
+    config;
+    agentName;
+    constructor(agentName, config) {
+        this.agentName = agentName;
+        this.config = config;
+        const agentDir = path.join(config.dataDir, agentName);
+        this.statePath = path.join(agentDir, 'state.json');
+        this.lockPath = path.join(agentDir, 'agent.lock');
+    }
+    /**
+     * Initialize state directory
+     */
+    ensureDir() {
+        const dir = path.dirname(this.statePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+    /**
+     * Check if state file exists
+     */
+    exists() {
+        return fs.existsSync(this.statePath);
+    }
+    /**
+     * Load agent state from disk
+     */
+    load() {
+        if (!this.exists()) {
+            return null;
+        }
+        try {
+            const content = fs.readFileSync(this.statePath, 'utf-8');
+            const state = JSON.parse(content);
+            // Migrate older state formats
+            return this.migrateState(state);
+        }
+        catch (err) {
+            console.error(`[state] Failed to load state for ${this.agentName}:`, err);
+            return null;
+        }
+    }
+    /**
+     * Save agent state to disk
+     */
+    save(state) {
+        this.ensureDir();
+        const tmpPath = `${this.statePath}.tmp`;
+        fs.writeFileSync(tmpPath, JSON.stringify(state, null, 2), 'utf-8');
+        fs.renameSync(tmpPath, this.statePath);
+    }
+    /**
+     * Create initial state for a new agent
+     */
+    create(cli, cwd, customCommand) {
+        const now = new Date().toISOString();
+        const state = {
+            version: STATE_VERSION,
+            name: this.agentName,
+            cli,
+            summary: '',
+            recentMessages: [],
+            cwd,
+            customCommand,
+            lastActiveTs: now,
+            createdTs: now,
+            status: 'idle',
+            decisions: [],
+            openTodos: [],
+            filesModified: [],
+            externalRefs: [],
+        };
+        this.save(state);
+        return state;
+    }
+    /**
+     * Update state with a new relay exchange
+     */
+    addExchange(state, exchange) {
+        const updated = { ...state };
+        updated.recentMessages = [
+            ...state.recentMessages,
+            exchange,
+        ].slice(-this.config.maxRecentMessages);
+        updated.lastActiveTs = new Date().toISOString();
+        this.save(updated);
+        return updated;
+    }
+    /**
+     * Update the rolling summary
+     */
+    updateSummary(state, newSummary) {
+        const updated = { ...state };
+        // Truncate if too long
+        updated.summary = newSummary.length > this.config.maxSummaryLength
+            ? newSummary.substring(0, this.config.maxSummaryLength) + '...'
+            : newSummary;
+        updated.lastActiveTs = new Date().toISOString();
+        this.save(updated);
+        return updated;
+    }
+    /**
+     * Update supervisor-tracked status for the agent.
+     */
+    setStatus(state, status) {
+        const updated = { ...state, status };
+        updated.lastActiveTs = new Date().toISOString();
+        this.save(updated);
+        return updated;
+    }
+    /**
+     * Parse inbox content and record received exchanges into state.
+     */
+    recordInboxReceived(state, inboxContent) {
+        const messages = parseInboxMarkdown(inboxContent);
+        let updated = state;
+        for (const msg of messages) {
+            updated = this.addExchange(updated, {
+                direction: 'received',
+                peer: msg.from,
+                body: msg.body,
+                timestamp: msg.timestamp || new Date().toISOString(),
+            });
+        }
+        return updated;
+    }
+    /**
+     * Mark inbox as processed (for restart deduplication)
+     */
+    markInboxProcessed(state, timestamp) {
+        const updated = { ...state };
+        updated.lastProcessedInboxTs = timestamp || new Date().toISOString();
+        updated.lastActiveTs = new Date().toISOString();
+        this.save(updated);
+        return updated;
+    }
+    /**
+     * Check if messages should be skipped based on timestamp
+     * Returns true if the message timestamp is older than lastProcessedInboxTs
+     */
+    shouldSkipMessage(state, messageTs) {
+        if (!state.lastProcessedInboxTs)
+            return false;
+        return new Date(messageTs) <= new Date(state.lastProcessedInboxTs);
+    }
+    /**
+     * Add a decision (append-only)
+     */
+    addDecision(state, what, why) {
+        const updated = { ...state };
+        updated.decisions = [
+            ...state.decisions,
+            {
+                what,
+                why,
+                timestamp: new Date().toISOString(),
+            },
+        ];
+        updated.lastActiveTs = new Date().toISOString();
+        this.save(updated);
+        return updated;
+    }
+    /**
+     * Add a TODO item
+     */
+    addTodo(state, task, priority = 'normal', owner) {
+        const updated = { ...state };
+        updated.openTodos = [
+            ...state.openTodos,
+            {
+                task,
+                owner,
+                priority,
+                addedTs: new Date().toISOString(),
+            },
+        ];
+        updated.lastActiveTs = new Date().toISOString();
+        this.save(updated);
+        return updated;
+    }
+    /**
+     * Complete (remove) a TODO item by task text match
+     */
+    completeTodo(state, taskMatch) {
+        const updated = { ...state };
+        updated.openTodos = state.openTodos.filter((todo) => !todo.task.toLowerCase().includes(taskMatch.toLowerCase()));
+        updated.lastActiveTs = new Date().toISOString();
+        this.save(updated);
+        return updated;
+    }
+    /**
+     * Record a file modification
+     */
+    addFileModification(state, filePath, intent) {
+        const updated = { ...state };
+        // Replace existing entry for same path or append
+        const existing = state.filesModified.findIndex((f) => f.path === filePath);
+        if (existing >= 0) {
+            updated.filesModified = [...state.filesModified];
+            updated.filesModified[existing] = {
+                path: filePath,
+                intent,
+                timestamp: new Date().toISOString(),
+            };
+        }
+        else {
+            updated.filesModified = [
+                ...state.filesModified,
+                {
+                    path: filePath,
+                    intent,
+                    timestamp: new Date().toISOString(),
+                },
+            ];
+        }
+        updated.lastActiveTs = new Date().toISOString();
+        this.save(updated);
+        return updated;
+    }
+    /**
+     * Record an external command/reference
+     */
+    addExternalRef(state, command, resultSummary, logPath) {
+        const updated = { ...state };
+        const maxRefs = 20; // Keep bounded
+        updated.externalRefs = [
+            ...state.externalRefs.slice(-maxRefs + 1),
+            {
+                command,
+                resultSummary,
+                timestamp: new Date().toISOString(),
+                logPath,
+            },
+        ];
+        updated.lastActiveTs = new Date().toISOString();
+        this.save(updated);
+        return updated;
+    }
+    /**
+     * Migrate old state to current version
+     */
+    migrateState(state) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const s = state;
+        if (!s.version || s.version < STATE_VERSION) {
+            // Add missing fields from v1
+            s.version = STATE_VERSION;
+            s.status = s.status || 'idle';
+            s.decisions = s.decisions || [];
+            s.openTodos = s.openTodos || [];
+            s.filesModified = s.filesModified || [];
+            s.externalRefs = s.externalRefs || [];
+            this.save(s);
+        }
+        return s;
+    }
+    /**
+     * Try to acquire lock for this agent
+     * Returns true if lock acquired, false if already locked
+     */
+    tryLock() {
+        this.ensureDir();
+        try {
+            // Try to create lock file exclusively
+            const fd = fs.openSync(this.lockPath, 'wx');
+            fs.writeSync(fd, `${process.pid}\n${new Date().toISOString()}\n`);
+            fs.closeSync(fd);
+            return true;
+        }
+        catch (err) {
+            if (err.code === 'EEXIST') {
+                // Lock exists, check if stale (older than 5 minutes)
+                try {
+                    const stat = fs.statSync(this.lockPath);
+                    const age = Date.now() - stat.mtimeMs;
+                    if (age > 5 * 60 * 1000) {
+                        // Stale lock, remove and retry
+                        fs.unlinkSync(this.lockPath);
+                        return this.tryLock();
+                    }
+                }
+                catch {
+                    // Ignore stat errors
+                }
+                return false;
+            }
+            throw err;
+        }
+    }
+    /**
+     * Release lock for this agent
+     */
+    releaseLock() {
+        try {
+            if (fs.existsSync(this.lockPath)) {
+                fs.unlinkSync(this.lockPath);
+            }
+        }
+        catch (err) {
+            console.error(`[state] Failed to release lock for ${this.agentName}:`, err);
+        }
+    }
+    /**
+     * Check if agent is currently locked
+     */
+    isLocked() {
+        if (!fs.existsSync(this.lockPath)) {
+            return false;
+        }
+        // Check for stale lock
+        try {
+            const stat = fs.statSync(this.lockPath);
+            const age = Date.now() - stat.mtimeMs;
+            if (age > 5 * 60 * 1000) {
+                // Stale, consider unlocked
+                return false;
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get the inbox path for this agent
+     */
+    getInboxPath() {
+        return path.join(this.config.dataDir, this.agentName, 'inbox.md');
+    }
+    /**
+     * Get the state.json path for this agent
+     */
+    getStatePath() {
+        return this.statePath;
+    }
+    /**
+     * Get the lock path for this agent
+     */
+    getLockPath() {
+        return this.lockPath;
+    }
+    /**
+     * Build the initial prompt for a spawn including state context
+     */
+    buildSpawnPrompt(state, inboxContent) {
+        let prompt = '';
+        prompt += `You are ${state.name}, an AI agent collaborating with other CLI agents via agent-relay.\n`;
+        prompt += `Your job: read new relay messages and respond using @relay:AgentName <message>.\n`;
+        prompt += `\nCRITICAL: Do not wait for additional input. Process ALL messages and then exit.\n\n`;
+        // Add summary if present
+        if (state.summary) {
+            prompt += `## Context\n${state.summary}\n\n`;
+        }
+        // Add key decisions (stable context)
+        if (state.decisions.length > 0) {
+            prompt += `## Key Decisions Made\n`;
+            for (const decision of state.decisions.slice(-10)) {
+                prompt += `- **${decision.what}**: ${decision.why}\n`;
+            }
+            prompt += '\n';
+        }
+        // Add open TODOs
+        if (state.openTodos.length > 0) {
+            prompt += `## Open TODOs\n`;
+            for (const todo of state.openTodos) {
+                const priority = todo.priority === 'high' ? '[HIGH]' : todo.priority === 'low' ? '[low]' : '';
+                const owner = todo.owner ? ` (${todo.owner})` : '';
+                prompt += `- ${priority} ${todo.task}${owner}\n`;
+            }
+            prompt += '\n';
+        }
+        // Add files modified (for context on what we've touched)
+        if (state.filesModified.length > 0) {
+            prompt += `## Files Modified This Session\n`;
+            for (const file of state.filesModified.slice(-10)) {
+                prompt += `- \`${file.path}\`: ${file.intent}\n`;
+            }
+            prompt += '\n';
+        }
+        // Add recent external command references
+        if (state.externalRefs.length > 0) {
+            prompt += `## Recent Commands/Outputs\n`;
+            for (const ref of state.externalRefs.slice(-5)) {
+                prompt += `- \`${ref.command}\`: ${ref.resultSummary}\n`;
+            }
+            prompt += '\n';
+        }
+        // Add recent exchanges
+        if (state.recentMessages.length > 0) {
+            prompt += `## Recent Conversation\n`;
+            for (const exchange of state.recentMessages.slice(-10)) {
+                const direction = exchange.direction === 'sent' ? '→' : '←';
+                prompt += `[${exchange.timestamp}] ${direction} ${exchange.peer}: ${exchange.body}\n`;
+            }
+            prompt += '\n';
+        }
+        // Add inbox content
+        prompt += `## New Messages To Process\n${inboxContent}\n\n`;
+        // Add instructions
+        prompt += `## Instructions\n`;
+        prompt += `1. Read and understand each new message\n`;
+        prompt += `2. Respond using: @relay:AgentName Your reply\n`;
+        prompt += `3. When finished processing all messages, EXIT (do not wait)\n\n`;
+        prompt += `## Context Preservation\n`;
+        prompt += `After you respond, output an updated compact summary so future spawns keep context:\n`;
+        prompt += `[[SUMMARY]]<~1-2k chars: current goals, key decisions, current state, next steps>[[/SUMMARY]]\n\n`;
+        prompt += `Optional structured markers (only if helpful):\n`;
+        prompt += `- [[DECISION]]{\"what\":\"...\",\"why\":\"...\"}[[/DECISION]]\n`;
+        prompt += `- [[TODO]]{\"task\":\"...\",\"priority\":\"high|normal|low\",\"owner\":\"?\"}[[/TODO]]\n`;
+        prompt += `- [[DONE]]task substring[[/DONE]]\n`;
+        return prompt;
+    }
+}
+/**
+ * Global state registry for all agents
+ */
+export class StateRegistry {
+    config;
+    managers = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Get or create state manager for an agent
+     */
+    getManager(agentName) {
+        let manager = this.managers.get(agentName);
+        if (!manager) {
+            manager = new StateManager(agentName, this.config);
+            this.managers.set(agentName, manager);
+        }
+        return manager;
+    }
+    /**
+     * List all registered agents (from disk)
+     */
+    listAgents() {
+        if (!fs.existsSync(this.config.dataDir)) {
+            return [];
+        }
+        const entries = fs.readdirSync(this.config.dataDir, { withFileTypes: true });
+        return entries
+            .filter(e => e.isDirectory())
+            .filter(e => fs.existsSync(path.join(this.config.dataDir, e.name, 'state.json')))
+            .map(e => e.name);
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/supervisor/state.js.map

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

package/dist/supervisor/supervisor.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Agent Relay Supervisor
+ *
+ * Main supervisor loop that:
+ * 1. Watches registered agents for inbox messages
+ * 2. Spawns fresh CLI runs when messages arrive
+ * 3. Captures output and routes relay commands
+ * 4. Updates agent state for context preservation
+ */
+import type { SupervisorConfig, AgentRegistration, AgentState } from './types.js';
+export declare class Supervisor {
+    private config;
+    private registry;
+    private spawner;
+    private client;
+    private running;
+    private pollTimer?;
+    constructor(config?: Partial<SupervisorConfig>);
+    /**
+     * Start the supervisor
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the supervisor
+     */
+    stop(): void;
+    /**
+     * Register a new agent
+     */
+    registerAgent(registration: AgentRegistration): AgentState;
+    /**
+     * Unregister an agent
+     */
+    unregisterAgent(name: string): void;
+    /**
+     * Schedule next poll
+     */
+    private schedulePoll;
+    /**
+     * Poll all agents for new messages
+     */
+    private poll;
+    /**
+     * Process a single agent's inbox
+     */
+    private processAgent;
+    /**
+     * Get list of registered agents
+     */
+    getAgents(): string[];
+    /**
+     * Get agent state
+     */
+    getAgentState(name: string): AgentState | null;
+    /**
+     * Get lightweight diagnostics for CLI display.
+     */
+    getAgentDiagnostics(name: string): {
+        state: AgentState | null;
+        locked: boolean;
+        inboxPath: string;
+        statePath: string;
+        lockPath: string;
+        hasUnreadInbox: boolean;
+    };
+}
+//# sourceMappingURL=supervisor.d.ts.map

package/dist/supervisor/supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../src/supervisor/supervisor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAC,CAAiB;gBAEvB,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAmBlD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAgBZ;;OAEG;IACH,aAAa,CAAC,YAAY,EAAE,iBAAiB,GAAG,UAAU;IA2B1D;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQnC;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;YACW,IAAI;IAYlB;;OAEG;YACW,YAAY;IAkH1B;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAI9C;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG;QACjC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;QACzB,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,OAAO,CAAC;KACzB;CAmBF"}