@antistud/handrails-cli 0.1.0

package/dist/src/runner/executors/claude-code.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeWithClaudeCode = executeWithClaudeCode;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const types_1 = require("./types");
+const logger_1 = require("../logger");
+/**
+ * Execute a task using the locally installed Claude Code CLI.
+ *
+ * Spawns `claude` with streaming JSON output so we can follow along in real-time.
+ */
+async function executeWithClaudeCode(input) {
+    const prompt = (0, types_1.buildPrompt)(input);
+    let mcpConfigPath = null;
+    return new Promise((resolve) => {
+        const chunks = [];
+        let stderr = '';
+        let finalResult = '';
+        const args = [
+            '-p', prompt,
+            '--system-prompt', input.systemPrompt,
+            '--output-format', 'stream-json',
+            '--verbose',
+            '--dangerously-skip-permissions',
+        ];
+        // Only restrict tools if explicitly specified
+        if (input.allowedTools) {
+            args.push('--allowedTools', input.allowedTools.join(','));
+        }
+        // Generate MCP config so claude can call handrails tools via stdio proxy
+        if (input.apiUrl && input.apiKey) {
+            try {
+                // Resolve the handrails CLI: __dirname is dist/runner/executors, go up 3 to package root
+                const cliDistPath = (0, path_1.join)(__dirname, '..', '..', 'bin', 'handrails.js');
+                const mcpConfig = {
+                    mcpServers: {
+                        handrails: {
+                            command: "node",
+                            args: [cliDistPath, "serve"],
+                            env: {
+                                HANDRAILS_API_KEY: input.apiKey,
+                                HANDRAILS_API_URL: input.apiUrl,
+                            },
+                        },
+                    },
+                };
+                const tmpDir = (0, fs_1.mkdtempSync)((0, path_1.join)((0, os_1.tmpdir)(), 'handrails-rig-'));
+                mcpConfigPath = (0, path_1.join)(tmpDir, 'mcp-config.json');
+                (0, fs_1.writeFileSync)(mcpConfigPath, JSON.stringify(mcpConfig, null, 2));
+                args.push('--mcp-config', mcpConfigPath);
+                logger_1.logger.info(`MCP config: ${mcpConfigPath} (stdio via @handrails/cli serve)`);
+                logger_1.logger.debug(`MCP API URL: ${input.apiUrl}`);
+            }
+            catch (err) {
+                logger_1.logger.warn(`Failed to create MCP config: ${err.message}`);
+            }
+        }
+        logger_1.logger.tool(`Spawning: claude -p ... --output-format stream-json --verbose --dangerously-skip-permissions`);
+        logger_1.logger.debug(`Allowed tools: ${input.allowedTools ? input.allowedTools.join(', ') : 'all (unrestricted)'}`);
+        logger_1.logger.debug(`Prompt length: ${prompt.length} chars`);
+        logger_1.logger.debug(`System prompt length: ${input.systemPrompt.length} chars`);
+        logger_1.logger.divider();
+        const child = (0, child_process_1.spawn)('claude', args, {
+            cwd: input.projectPath,
+            env: { ...process.env },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        logger_1.logger.debug(`Process spawned: PID ${child.pid}`);
+        let lineBuf = '';
+        child.stdout.on('data', (data) => {
+            const text = data.toString();
+            chunks.push(text);
+            // Parse streaming JSON events line by line
+            lineBuf += text;
+            const lines = lineBuf.split('\n');
+            lineBuf = lines.pop() || '';
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const event = JSON.parse(line);
+                    logStreamEvent(event);
+                    // Capture the final result text
+                    if (event.type === 'result' && event.result) {
+                        finalResult = typeof event.result === 'string'
+                            ? event.result
+                            : JSON.stringify(event.result);
+                    }
+                }
+                catch {
+                    // Not JSON, log raw
+                    if (line.trim()) {
+                        logger_1.logger.debug(`raw: ${line.trim()}`);
+                    }
+                }
+            }
+        });
+        child.stderr.on('data', (data) => {
+            const text = data.toString();
+            stderr += text;
+            for (const line of text.split('\n').filter(Boolean)) {
+                logger_1.logger.debug(`stderr: ${line}`);
+            }
+        });
+        const cleanup = () => {
+            if (mcpConfigPath) {
+                try {
+                    (0, fs_1.unlinkSync)(mcpConfigPath);
+                }
+                catch { /* ignore */ }
+            }
+        };
+        child.on('close', (code) => {
+            // Process any remaining buffer
+            if (lineBuf.trim()) {
+                try {
+                    const event = JSON.parse(lineBuf);
+                    logStreamEvent(event);
+                    if (event.type === 'result' && event.result) {
+                        finalResult = typeof event.result === 'string'
+                            ? event.result
+                            : JSON.stringify(event.result);
+                    }
+                }
+                catch { /* ignore */ }
+            }
+            cleanup();
+            logger_1.logger.divider();
+            logger_1.logger.info(`Process exited with code ${code}`);
+            const output = finalResult || chunks.join('');
+            if (code === 0) {
+                resolve({ status: 'completed', output: output.trim() });
+            }
+            else {
+                resolve({
+                    status: 'failed',
+                    output: output.trim(),
+                    error: stderr.trim() || `Claude Code exited with code ${code}`,
+                });
+            }
+        });
+        child.on('error', (err) => {
+            cleanup();
+            logger_1.logger.error(`Failed to spawn process: ${err.message}`);
+            resolve({
+                status: 'failed',
+                output: '',
+                error: `Failed to spawn Claude Code: ${err.message}. Is 'claude' installed and in PATH?`,
+            });
+        });
+    });
+}
+/**
+ * Log a streaming JSON event from the claude CLI in a human-readable way.
+ */
+function logStreamEvent(event) {
+    switch (event.type) {
+        case 'system':
+            logger_1.logger.info(`${event.subtype || 'system'}: ${event.message || JSON.stringify(event)}`);
+            break;
+        case 'assistant': {
+            const msg = event.message;
+            if (!msg)
+                break;
+            if (msg.type === 'text' || typeof msg.content === 'string') {
+                const text = msg.content || msg.text || '';
+                if (text) {
+                    // Show assistant text output
+                    for (const line of text.split('\n')) {
+                        console.log(`    💬 ${line}`);
+                    }
+                }
+            }
+            else if (msg.type === 'tool_use' || msg.tool_name) {
+                const toolName = msg.tool_name || msg.name || 'unknown';
+                const toolInput = msg.tool_input || msg.input;
+                logger_1.logger.tool(`${toolName}`);
+                if (toolInput) {
+                    const inputStr = typeof toolInput === 'string' ? toolInput : JSON.stringify(toolInput);
+                    const preview = inputStr.length > 200 ? inputStr.substring(0, 200) + '...' : inputStr;
+                    logger_1.logger.debug(`  input: ${preview}`);
+                }
+            }
+            break;
+        }
+        case 'tool_result':
+        case 'tool_output': {
+            const toolName = event.tool_name || event.name || '';
+            const output = event.output || event.content || event.result || '';
+            const outputStr = typeof output === 'string' ? output : JSON.stringify(output);
+            const preview = outputStr.length > 300 ? outputStr.substring(0, 300) + '...' : outputStr;
+            if (toolName) {
+                logger_1.logger.tool(`${toolName} → ${preview}`);
+            }
+            else {
+                logger_1.logger.debug(`tool result: ${preview}`);
+            }
+            break;
+        }
+        case 'content_block_start': {
+            const block = event.content_block;
+            if (block?.type === 'tool_use') {
+                logger_1.logger.tool(`▶ ${block.name || 'tool'}`);
+            }
+            break;
+        }
+        case 'content_block_delta': {
+            const delta = event.delta;
+            if (delta?.type === 'text_delta' && delta.text) {
+                process.stdout.write(delta.text);
+            }
+            else if (delta?.type === 'input_json_delta' && delta.partial_json) {
+                // Tool input streaming - show periodically
+            }
+            break;
+        }
+        case 'content_block_stop':
+            // Block finished
+            break;
+        case 'message_start':
+            logger_1.logger.debug('Agent thinking...');
+            break;
+        case 'message_delta':
+            if (event.delta?.stop_reason) {
+                logger_1.logger.debug(`Stop reason: ${event.delta.stop_reason}`);
+            }
+            break;
+        case 'message_stop':
+            break;
+        case 'result':
+            logger_1.logger.success('Task complete');
+            break;
+        case 'error':
+            logger_1.logger.error(`${event.error?.message || event.message || JSON.stringify(event)}`);
+            break;
+        default:
+            // Log unknown event types for visibility
+            if (event.type) {
+                logger_1.logger.debug(`event: ${event.type} ${event.subtype || ''}`);
+            }
+            break;
+    }
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/src/runner/executors/claude-code.js.map

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

package/dist/src/runner/executors/codex.d.ts

@@ -0,0 +1,9 @@
+import type { ExecutorInput, ExecutorResult } from './types';
+/**
+ * Execute a task using OpenAI Codex CLI.
+ *
+ * Codex is OpenAI's terminal coding agent.
+ * Spawns `codex` in quiet/non-interactive mode with full-auto approval.
+ * https://github.com/openai/codex
+ */
+export declare function executeWithCodex(input: ExecutorInput): Promise<ExecutorResult>;

package/dist/src/runner/executors/codex.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeWithCodex = executeWithCodex;
+const child_process_1 = require("child_process");
+const types_1 = require("./types");
+const logger_1 = require("../logger");
+/**
+ * Execute a task using OpenAI Codex CLI.
+ *
+ * Codex is OpenAI's terminal coding agent.
+ * Spawns `codex` in quiet/non-interactive mode with full-auto approval.
+ * https://github.com/openai/codex
+ */
+async function executeWithCodex(input) {
+    const prompt = (0, types_1.buildPrompt)(input);
+    // Prepend system prompt context into the prompt since codex
+    // uses --instructions for file-based instructions only
+    const fullPrompt = `${input.systemPrompt}\n\n---\n\n${prompt}`;
+    return new Promise((resolve) => {
+        const chunks = [];
+        let stderr = '';
+        const args = [
+            '--quiet',
+            '--approval-mode', 'full-auto',
+            fullPrompt,
+        ];
+        logger_1.logger.tool(`Spawning: codex --quiet --approval-mode full-auto "<${fullPrompt.length} chars>"`);
+        logger_1.logger.divider();
+        const child = (0, child_process_1.spawn)('codex', args, {
+            cwd: input.projectPath,
+            env: { ...process.env },
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        logger_1.logger.debug(`Process spawned: PID ${child.pid}`);
+        child.stdout.on('data', (data) => {
+            const text = data.toString();
+            chunks.push(text);
+            process.stdout.write(text);
+        });
+        child.stderr.on('data', (data) => {
+            const text = data.toString();
+            stderr += text;
+            for (const line of text.split('\n').filter(Boolean)) {
+                logger_1.logger.debug(`stderr: ${line}`);
+            }
+        });
+        child.on('close', (code) => {
+            logger_1.logger.divider();
+            logger_1.logger.info(`Process exited with code ${code}`);
+            const output = chunks.join('');
+            if (code === 0) {
+                resolve({ status: 'completed', output: output.trim() });
+            }
+            else {
+                resolve({
+                    status: 'failed',
+                    output: output.trim(),
+                    error: stderr.trim() || `Codex exited with code ${code}`,
+                });
+            }
+        });
+        child.on('error', (err) => {
+            logger_1.logger.error(`Failed to spawn process: ${err.message}`);
+            resolve({
+                status: 'failed',
+                output: '',
+                error: `Failed to spawn Codex: ${err.message}. Is 'codex' installed and in PATH?`,
+            });
+        });
+    });
+}
+//# sourceMappingURL=codex.js.map

package/dist/src/runner/executors/codex.js.map

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

package/dist/src/runner/executors/opencode.d.ts

@@ -0,0 +1,9 @@
+import type { ExecutorInput, ExecutorResult } from './types';
+/**
+ * Execute a task using OpenCode CLI.
+ *
+ * OpenCode is an open-source terminal AI assistant.
+ * Spawns `opencode` with the task prompt in non-interactive mode.
+ * https://opencode.ai
+ */
+export declare function executeWithOpenCode(input: ExecutorInput): Promise<ExecutorResult>;

package/dist/src/runner/executors/opencode.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeWithOpenCode = executeWithOpenCode;
+const child_process_1 = require("child_process");
+const types_1 = require("./types");
+const logger_1 = require("../logger");
+/**
+ * Execute a task using OpenCode CLI.
+ *
+ * OpenCode is an open-source terminal AI assistant.
+ * Spawns `opencode` with the task prompt in non-interactive mode.
+ * https://opencode.ai
+ */
+async function executeWithOpenCode(input) {
+    const prompt = (0, types_1.buildPrompt)(input);
+    // Prepend system prompt context into the prompt since opencode
+    // doesn't have a separate --system-prompt flag
+    const fullPrompt = `${input.systemPrompt}\n\n---\n\n${prompt}`;
+    return new Promise((resolve) => {
+        const chunks = [];
+        let stderr = '';
+        const args = [
+            'run',
+            '--prompt', fullPrompt,
+        ];
+        logger_1.logger.tool(`Spawning: opencode run --prompt "<${fullPrompt.length} chars>"`);
+        logger_1.logger.divider();
+        const child = (0, child_process_1.spawn)('opencode', args, {
+            cwd: input.projectPath,
+            env: { ...process.env },
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        logger_1.logger.debug(`Process spawned: PID ${child.pid}`);
+        child.stdout.on('data', (data) => {
+            const text = data.toString();
+            chunks.push(text);
+            process.stdout.write(text);
+        });
+        child.stderr.on('data', (data) => {
+            const text = data.toString();
+            stderr += text;
+            for (const line of text.split('\n').filter(Boolean)) {
+                logger_1.logger.debug(`stderr: ${line}`);
+            }
+        });
+        child.on('close', (code) => {
+            logger_1.logger.divider();
+            logger_1.logger.info(`Process exited with code ${code}`);
+            const output = chunks.join('');
+            if (code === 0) {
+                resolve({ status: 'completed', output: output.trim() });
+            }
+            else {
+                resolve({
+                    status: 'failed',
+                    output: output.trim(),
+                    error: stderr.trim() || `OpenCode exited with code ${code}`,
+                });
+            }
+        });
+        child.on('error', (err) => {
+            logger_1.logger.error(`Failed to spawn process: ${err.message}`);
+            resolve({
+                status: 'failed',
+                output: '',
+                error: `Failed to spawn OpenCode: ${err.message}. Is 'opencode' installed and in PATH?`,
+            });
+        });
+    });
+}
+//# sourceMappingURL=opencode.js.map

package/dist/src/runner/executors/opencode.js.map

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

package/dist/src/runner/executors/types.d.ts

@@ -0,0 +1,24 @@
+export type RigType = 'claude-code' | 'opencode' | 'codex';
+export interface ExecutorInput {
+    systemPrompt: string;
+    taskDescription: string;
+    priorMessages: Array<{
+        role: string;
+        content: string;
+    }>;
+    priorLearnings: string[];
+    projectPath: string;
+    allowedTools?: string[];
+    apiUrl?: string;
+    apiKey?: string;
+}
+export interface ExecutorResult {
+    status: 'completed' | 'failed';
+    output: string;
+    error?: string;
+}
+/**
+ * Build a plain-text prompt from the task payload.
+ * Shared across all executors.
+ */
+export declare function buildPrompt(input: ExecutorInput): string;

package/dist/src/runner/executors/types.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPrompt = buildPrompt;
+/**
+ * Build a plain-text prompt from the task payload.
+ * Shared across all executors.
+ */
+function buildPrompt(input) {
+    const parts = [];
+    parts.push(`## Task\n${input.taskDescription}`);
+    if (input.priorLearnings.length > 0) {
+        parts.push('\n## Prior Learnings');
+        for (const learning of input.priorLearnings) {
+            parts.push(`- ${learning}`);
+        }
+    }
+    if (input.priorMessages.length > 0) {
+        parts.push('\n## Prior Context');
+        for (const msg of input.priorMessages.slice(-5)) {
+            parts.push(`[${msg.role}]: ${msg.content.substring(0, 500)}`);
+        }
+    }
+    parts.push('\n## Instructions');
+    parts.push('Complete this task thoroughly. When done, provide a clear summary of what was accomplished.');
+    return parts.join('\n');
+}
+//# sourceMappingURL=types.js.map

package/dist/src/runner/executors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/runner/executors/types.ts"],"names":[],"mappings":";;AAuBA,kCAuBC;AA3BD;;;GAGG;AACH,SAAgB,WAAW,CAAC,KAAoB;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;IAEhD,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,6FAA6F,CAAC,CAAC;IAE1G,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/src/runner/index.d.ts

@@ -0,0 +1,34 @@
+import { RigType } from './executor';
+export interface RigOptions {
+    apiUrl: string;
+    rigKey: string;
+    projectPath: string;
+    heartbeatInterval?: number;
+    rigType?: RigType;
+}
+/**
+ * AgentRig — stateless executor.
+ *
+ * "Agents think. Rigs act. Harness keeps everything on track."
+ *
+ * Polls the Handrails server for tasks, executes them with local Claude Code,
+ * and reports results back. All state lives on the server.
+ */
+export declare class AgentRig {
+    private http;
+    private rigId;
+    private rigKey;
+    private projectPath;
+    private heartbeatMs;
+    private running;
+    private currentSessionId;
+    private rigType;
+    private rigTypeOverride;
+    private heartbeatCount;
+    constructor(options: RigOptions);
+    start(): Promise<void>;
+    private heartbeat;
+    private executeTask;
+    private reportProgress;
+    private sleep;
+}