agent-relay 0.1.0

package/dist/supervisor/spawner.js

@@ -0,0 +1,282 @@
+/**
+ * CLI Spawner
+ *
+ * Handles spawning fresh CLI instances for different agent types.
+ * Supports Claude Code, Codex, Cursor, and custom commands.
+ */
+import { spawn } from 'node:child_process';
+const CLI_COMMANDS = {
+    claude: {
+        cmd: 'claude',
+        args: ['--dangerously-skip-permissions'],
+        promptMode: 'flag',
+        promptFlag: '-p',
+    },
+    codex: {
+        cmd: 'codex',
+        // Prefer stdin for robustness (some codex invocations are flaky with huge -p prompts).
+        // Try --quiet first but retry without it if unsupported.
+        args: ['--quiet'],
+        promptMode: 'stdin',
+    },
+    cursor: {
+        cmd: 'cursor',
+        args: ['--cli'],
+        promptMode: 'flag',
+        promptFlag: '-p',
+    },
+    custom: {
+        cmd: '',
+        args: [],
+        promptMode: 'stdin',
+    },
+};
+/** Relay command patterns */
+const INLINE_RELAY_PATTERN = /^(\s*)@relay:(\S+)\s+(.+)$/gm;
+const BLOCK_RELAY_PATTERN = /\[\[RELAY\]\]([\s\S]*?)\[\[\/RELAY\]\]/g;
+/** Structured state markers */
+const DECISION_PATTERN = /\[\[DECISION\]\]([\s\S]*?)\[\[\/DECISION\]\]/g;
+const TODO_PATTERN = /\[\[TODO\]\]([\s\S]*?)\[\[\/TODO\]\]/g;
+const DONE_PATTERN = /\[\[DONE\]\]([\s\S]*?)\[\[\/DONE\]\]/g;
+const SUMMARY_PATTERN = /\[\[SUMMARY\]\]([\s\S]*?)\[\[\/SUMMARY\]\]/g;
+/**
+ * Parse structured state markers from CLI output
+ */
+export function parseStateMarkers(output) {
+    const decisions = [];
+    const todos = [];
+    const dones = [];
+    let summary;
+    // Parse decisions
+    let match;
+    while ((match = DECISION_PATTERN.exec(output)) !== null) {
+        try {
+            const json = JSON.parse(match[1].trim());
+            if (json.what) {
+                decisions.push({
+                    what: json.what,
+                    why: json.why || '',
+                });
+            }
+        }
+        catch {
+            // Not valid JSON, try simple text format
+            const text = match[1].trim();
+            if (text) {
+                decisions.push({ what: text, why: '' });
+            }
+        }
+    }
+    // Parse TODOs
+    while ((match = TODO_PATTERN.exec(output)) !== null) {
+        try {
+            const json = JSON.parse(match[1].trim());
+            if (json.task) {
+                todos.push({
+                    task: json.task,
+                    priority: json.priority || 'normal',
+                    owner: json.owner,
+                });
+            }
+        }
+        catch {
+            // Not valid JSON, treat as simple task
+            const text = match[1].trim();
+            if (text) {
+                todos.push({ task: text, priority: 'normal' });
+            }
+        }
+    }
+    // Parse DONEs (task completions)
+    while ((match = DONE_PATTERN.exec(output)) !== null) {
+        const text = match[1].trim();
+        if (text) {
+            dones.push({ taskMatch: text });
+        }
+    }
+    // Parse SUMMARY (take last one)
+    while ((match = SUMMARY_PATTERN.exec(output)) !== null) {
+        const text = match[1].trim();
+        if (text)
+            summary = text;
+    }
+    return { decisions, todos, dones, summary };
+}
+/**
+ * Parse relay commands from CLI output
+ */
+export function parseRelayCommands(output) {
+    const commands = [];
+    // Parse inline commands
+    let match;
+    while ((match = INLINE_RELAY_PATTERN.exec(output)) !== null) {
+        commands.push({
+            to: match[2],
+            body: match[3],
+            kind: 'message',
+        });
+    }
+    // Parse block commands
+    while ((match = BLOCK_RELAY_PATTERN.exec(output)) !== null) {
+        try {
+            const json = JSON.parse(match[1].trim());
+            if (json.to && json.type) {
+                commands.push({
+                    to: json.to,
+                    body: json.body || json.text || '',
+                    kind: json.type,
+                });
+            }
+        }
+        catch {
+            // Invalid JSON, skip
+        }
+    }
+    return commands;
+}
+/**
+ * CLI Spawner class
+ */
+export class CLISpawner {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Spawn a CLI with the given prompt
+     */
+    async spawn(cli, prompt, cwd, customCommand) {
+        const { cmd, args, promptMode, promptFlag } = cli === 'custom' && customCommand
+            ? this.parseCustomCommand(customCommand)
+            : CLI_COMMANDS[cli];
+        if (!cmd) {
+            throw new Error(`Invalid CLI type: ${cli}`);
+        }
+        const attempt = async (attemptArgs) => {
+            const fullArgs = [...attemptArgs];
+            if (promptMode === 'flag' && promptFlag) {
+                fullArgs.push(promptFlag, prompt);
+            }
+            if (this.config.verbose) {
+                console.error(`[spawner] Running: ${cmd} ${fullArgs.join(' ')}`);
+            }
+            return new Promise((resolve) => {
+                const proc = spawn(cmd, fullArgs, {
+                    cwd,
+                    env: {
+                        ...process.env,
+                        AGENT_RELAY_SUPERVISED: '1',
+                    },
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                });
+                let stdout = '';
+                let stderr = '';
+                proc.stdout?.on('data', (data) => {
+                    const chunk = data.toString();
+                    stdout += chunk;
+                    if (this.config.verbose) {
+                        process.stdout.write(chunk);
+                    }
+                });
+                proc.stderr?.on('data', (data) => {
+                    const chunk = data.toString();
+                    stderr += chunk;
+                    if (this.config.verbose) {
+                        process.stderr.write(chunk);
+                    }
+                });
+                // For CLIs that read prompt from stdin instead of flag
+                if (promptMode === 'stdin') {
+                    proc.stdin?.write(prompt);
+                    proc.stdin?.end();
+                }
+                proc.on('close', (code) => {
+                    // Some CLIs emit user-visible output on stderr; parse both for commands/markers.
+                    const combined = `${stdout}\n${stderr}`;
+                    const relayCommands = parseRelayCommands(combined);
+                    const stateMarkers = parseStateMarkers(combined);
+                    if (this.config.verbose) {
+                        console.error(`[spawner] Exited with code ${code}, found ${relayCommands.length} relay commands, ${stateMarkers.decisions.length} decisions, ${stateMarkers.todos.length} todos, ${stateMarkers.dones.length} dones`);
+                    }
+                    resolve({
+                        exitCode: code ?? 1,
+                        stdout,
+                        stderr,
+                        relayCommands,
+                        stateMarkers,
+                    });
+                });
+                proc.on('error', (err) => {
+                    console.error(`[spawner] Spawn error:`, err);
+                    resolve({
+                        exitCode: 1,
+                        stdout,
+                        stderr: stderr + `\nSpawn error: ${err.message}`,
+                        relayCommands: [],
+                        stateMarkers: { decisions: [], todos: [], dones: [] },
+                    });
+                });
+                // Timeout after 5 minutes
+                setTimeout(() => {
+                    if (!proc.killed) {
+                        console.error(`[spawner] Timeout, killing process`);
+                        proc.kill('SIGTERM');
+                    }
+                }, 5 * 60 * 1000);
+            });
+        };
+        // First attempt
+        const first = await attempt(args);
+        // Codex-specific retry: if --quiet is unsupported, retry without it.
+        if (cli === 'codex' &&
+            args.includes('--quiet') &&
+            first.exitCode !== 0 &&
+            /unknown option|unrecognized option|invalid option|unexpected option|unknown flag/i.test(first.stderr)) {
+            if (this.config.verbose) {
+                console.error('[spawner] codex --quiet unsupported; retrying without --quiet');
+            }
+            return attempt(args.filter((a) => a !== '--quiet'));
+        }
+        return first;
+    }
+    /**
+     * Parse a custom command string into cmd, args, promptFlag
+     */
+    parseCustomCommand(command) {
+        const parts = command.split(' ');
+        const cmd = parts[0];
+        const args = parts.slice(1);
+        // Try to detect prompt flag
+        let promptFlag;
+        let promptMode = 'stdin';
+        const pFlagIdx = args.indexOf('-p');
+        const promptFlagIdx = args.indexOf('--prompt');
+        if (pFlagIdx !== -1) {
+            promptFlag = '-p';
+            args.splice(pFlagIdx, 1);
+            promptMode = 'flag';
+        }
+        else if (promptFlagIdx !== -1) {
+            promptFlag = '--prompt';
+            args.splice(promptFlagIdx, 1);
+            promptMode = 'flag';
+        }
+        return { cmd, args, promptMode, promptFlag };
+    }
+    /**
+     * Check if a CLI is available
+     */
+    async isAvailable(cli, customCommand) {
+        const cmd = cli === 'custom' && customCommand
+            ? customCommand.split(' ')[0]
+            : CLI_COMMANDS[cli].cmd;
+        if (!cmd)
+            return false;
+        return new Promise((resolve) => {
+            const proc = spawn('which', [cmd], { stdio: 'ignore' });
+            proc.on('close', (code) => resolve(code === 0));
+            proc.on('error', () => resolve(false));
+        });
+    }
+}
+//# sourceMappingURL=spawner.js.map

package/dist/supervisor/spawner.js.map

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

package/dist/supervisor/state.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Agent State Management
+ *
+ * Handles persistent state for spawn-per-message architecture.
+ * Each agent has a state.json that maintains context across spawns.
+ */
+import type { AgentState, RelayExchange, CLIType, SupervisorConfig } from './types.js';
+/**
+ * State Manager for a single agent
+ */
+export declare class StateManager {
+    private statePath;
+    private lockPath;
+    private config;
+    private agentName;
+    constructor(agentName: string, config: SupervisorConfig);
+    /**
+     * Initialize state directory
+     */
+    ensureDir(): void;
+    /**
+     * Check if state file exists
+     */
+    exists(): boolean;
+    /**
+     * Load agent state from disk
+     */
+    load(): AgentState | null;
+    /**
+     * Save agent state to disk
+     */
+    save(state: AgentState): void;
+    /**
+     * Create initial state for a new agent
+     */
+    create(cli: CLIType, cwd: string, customCommand?: string): AgentState;
+    /**
+     * Update state with a new relay exchange
+     */
+    addExchange(state: AgentState, exchange: RelayExchange): AgentState;
+    /**
+     * Update the rolling summary
+     */
+    updateSummary(state: AgentState, newSummary: string): AgentState;
+    /**
+     * Update supervisor-tracked status for the agent.
+     */
+    setStatus(state: AgentState, status: NonNullable<AgentState['status']>): AgentState;
+    /**
+     * Parse inbox content and record received exchanges into state.
+     */
+    recordInboxReceived(state: AgentState, inboxContent: string): AgentState;
+    /**
+     * Mark inbox as processed (for restart deduplication)
+     */
+    markInboxProcessed(state: AgentState, timestamp?: string): AgentState;
+    /**
+     * Check if messages should be skipped based on timestamp
+     * Returns true if the message timestamp is older than lastProcessedInboxTs
+     */
+    shouldSkipMessage(state: AgentState, messageTs: string): boolean;
+    /**
+     * Add a decision (append-only)
+     */
+    addDecision(state: AgentState, what: string, why: string): AgentState;
+    /**
+     * Add a TODO item
+     */
+    addTodo(state: AgentState, task: string, priority?: 'high' | 'normal' | 'low', owner?: string): AgentState;
+    /**
+     * Complete (remove) a TODO item by task text match
+     */
+    completeTodo(state: AgentState, taskMatch: string): AgentState;
+    /**
+     * Record a file modification
+     */
+    addFileModification(state: AgentState, filePath: string, intent: string): AgentState;
+    /**
+     * Record an external command/reference
+     */
+    addExternalRef(state: AgentState, command: string, resultSummary: string, logPath?: string): AgentState;
+    /**
+     * Migrate old state to current version
+     */
+    migrateState(state: AgentState): AgentState;
+    /**
+     * Try to acquire lock for this agent
+     * Returns true if lock acquired, false if already locked
+     */
+    tryLock(): boolean;
+    /**
+     * Release lock for this agent
+     */
+    releaseLock(): void;
+    /**
+     * Check if agent is currently locked
+     */
+    isLocked(): boolean;
+    /**
+     * Get the inbox path for this agent
+     */
+    getInboxPath(): string;
+    /**
+     * Get the state.json path for this agent
+     */
+    getStatePath(): string;
+    /**
+     * Get the lock path for this agent
+     */
+    getLockPath(): string;
+    /**
+     * Build the initial prompt for a spawn including state context
+     */
+    buildSpawnPrompt(state: AgentState, inboxContent: string): string;
+}
+/**
+ * Global state registry for all agents
+ */
+export declare class StateRegistry {
+    private config;
+    private managers;
+    constructor(config: SupervisorConfig);
+    /**
+     * Get or create state manager for an agent
+     */
+    getManager(agentName: string): StateManager;
+    /**
+     * List all registered agents (from disk)
+     */
+    listAgents(): string[];
+}
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/supervisor/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,OAAO,EACP,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB;IAQvD;;OAEG;IACH,SAAS,IAAI,IAAI;IAOjB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,IAAI,IAAI,UAAU,GAAG,IAAI;IAezB;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAO7B;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,UAAU;IAsBrE;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,GAAG,UAAU;IAWnE;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU;IAWhE;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,GAAG,UAAU;IAOnF;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,UAAU;IAcxE;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU;IAQrE;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAKhE;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU;IAerE;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,GAAG,QAAQ,GAAG,KAAgB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU;IAgBpH;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU;IAU9D;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU;IA0BpF;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;IAiBvG;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU;IAgB3C;;;OAGG;IACH,OAAO,IAAI,OAAO;IA4BlB;;OAEG;IACH,WAAW,IAAI,IAAI;IAUnB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAkBnB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;CAgFlE;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,QAAQ,CAAwC;gBAE5C,MAAM,EAAE,gBAAgB;IAIpC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAS3C;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;CAUvB"}