@alessai/hive-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 alessai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,217 @@
+# Hive MCP
+
+An MCP server that spawns external AI CLIs as subagents. Give any MCP-compatible host (Claude Code, Cursor, Windsurf, etc.) the ability to delegate tasks to Gemini, Claude, Codex, or any custom CLI tool.
+
+## What it does
+
+Hive exposes two MCP tools:
+
+- **`hivesingle`** — Spawn a single CLI agent with a role-specific system prompt
+- **`hive`** — Spawn 2+ CLI agents in parallel with the same prompt, collect all responses
+
+Each agent runs as a child process with full tool access (filesystem, shell, web search) — whatever the underlying CLI supports.
+
+## Install
+
+### Claude Code
+
+```bash
+claude mcp add hive -- npx @alessai/hive-mcp
+```
+
+### Cursor / Windsurf / other MCP hosts
+
+Add to your MCP config:
+
+```json
+{
+  "hive": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["hive-mcp"]
+  }
+}
+```
+
+### From source
+
+```bash
+git clone https://github.com/alessai/Hive-MCP.git
+cd Hive-MCP
+npm install && npm run build
+claude mcp add hive node ./dist/index.js
+```
+
+## Prerequisites
+
+You need the CLI tools installed for whichever agents you want to use:
+
+| Agent | CLI | Install |
+|-------|-----|---------|
+| Gemini | `gemini` | `npm install -g @anthropic-ai/gemini-cli` or see [Gemini CLI docs](https://github.com/google-gemini/gemini-cli) |
+| Claude | `claude` | `npm install -g @anthropic-ai/claude-code` or see [Claude Code docs](https://docs.anthropic.com/en/docs/claude-code) |
+| Codex | `codex` | See [Codex CLI docs](https://github.com/openai/codex) |
+
+Only install the CLIs you plan to use. Hive will report a clear error if a CLI isn't found.
+
+## Tools
+
+### `hivesingle`
+
+Spawn a single CLI agent.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `client` | string | yes | CLI client to use (`gemini`, `claude`, `codex`, `glm`, or custom) |
+| `prompt` | string | yes | The task or question |
+| `role` | string | no | Role-based system prompt (see [Roles](#roles)) |
+| `continuation_id` | string | no | Thread ID for multi-turn conversations |
+| `cwd` | string | no | Working directory for the CLI process |
+
+### `hive`
+
+Spawn multiple CLI agents in parallel with the same prompt. Defaults to `gemini` + `glm`.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `clients` | string[] | no | CLI clients to query (default: `["gemini", "glm"]`) |
+| `prompt` | string | yes | The task or question |
+| `role` | string | no | Role-based system prompt (see [Roles](#roles)) |
+| `cwd` | string | no | Working directory for all CLI processes |
+
+## Roles
+
+Role prompts shape agent behavior. Each role injects a system prompt tailored for the task:
+
+| Role | Purpose |
+|------|---------|
+| `default` | General-purpose assistant |
+| `reviewer` | Code review — bugs, style, security |
+| `debugger` | Systematic debugging and root cause analysis |
+| `planner` | Break down tasks into implementation steps |
+| `thinker` | Deep exploration before answering |
+| `analyst` | Architecture and dependency analysis |
+| `refactor` | Improve code structure without changing behavior |
+| `testgen` | Generate comprehensive test cases |
+| `secaudit` | Security audit (OWASP top 10, etc.) |
+| `docgen` | Generate documentation |
+| `precommit` | Pre-commit review checklist |
+| `challenger` | Devil's advocate — find flaws and risks |
+| `apilookup` | Find correct API usage and signatures |
+| `tracer` | Trace execution flow through code |
+
+All agents also receive a capabilities preamble reminding them they have full tool access (filesystem, shell, web).
+
+## CLI client configuration
+
+### Built-in clients
+
+Hive ships with configs for 4 clients in `conf/cli_clients/`:
+
+| Client | CLI | Model | Timeout |
+|--------|-----|-------|---------|
+| `gemini` | `gemini` | gemini-2.5-pro | 5 min |
+| `claude` | `claude` | default | 30 min |
+| `glm` | `claude` | opus | 30 min |
+| `codex` | `codex` | default | 10 min |
+
+### Custom clients
+
+Add JSON files to `~/.hive/cli_clients/` to register custom clients or override built-ins.
+
+```json
+{
+  "name": "my-agent",
+  "command": "my-cli-tool",
+  "runner": "gemini",
+  "additional_args": ["--flag", "value"],
+  "env": {},
+  "timeout_seconds": 300,
+  "roles": {}
+}
+```
+
+**Fields:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `name` | string | Client name (used in tool calls) |
+| `command` | string | CLI executable name or path |
+| `runner` | string | Agent behavior: `"gemini"`, `"claude"`, `"codex"`, or omit for base |
+| `additional_args` | string[] | Extra CLI arguments |
+| `env` | object | Environment variables for the process |
+| `timeout_seconds` | number | Process timeout (default: 300) |
+| `roles` | object | Per-role overrides (optional) |
+
+The `runner` field determines how Hive interacts with the CLI:
+
+| Runner | System prompt | Output format | Parser |
+|--------|--------------|---------------|--------|
+| `gemini` | via `-p` flag | JSON (`-o json`) | Extracts from Gemini JSON response |
+| `claude` | via `--append-system-prompt` flag | JSON (`--output-format json`) | Extracts from Claude JSONL events |
+| `codex` | via stdin | JSONL (`exec --json`) | Extracts from Codex JSONL stream |
+| base (default) | via stdin | raw text | Returns stdout as-is |
+
+User configs in `~/.hive/cli_clients/` override built-in configs with the same name.
+
+## Multi-turn conversations
+
+Pass a `continuation_id` to `hivesingle` to maintain context across calls. Hive stores conversation turns on disk (`~/.hive/threads/`) with a 30-minute TTL and 100-thread LRU cap.
+
+```
+# First call
+hivesingle(client: "gemini", prompt: "Explain this codebase", continuation_id: "session-1")
+
+# Follow-up (context is preserved)
+hivesingle(client: "gemini", prompt: "Now focus on the auth module", continuation_id: "session-1")
+```
+
+## How it works
+
+```
+MCP Host (Claude Code, Cursor, etc.)
+    ↓ MCP tool call
+Hive MCP Server
+    ↓ child_process.spawn()
+CLI Agent (gemini, claude, codex)
+    ↓ stdout/stderr
+Parse output → return to host
+```
+
+1. The MCP host calls `hivesingle` or `hive`
+2. Hive resolves the client config, loads the role prompt, and builds CLI arguments
+3. The CLI is spawned as a child process with the prompt piped via stdin or flags
+4. Hive streams progress notifications back to the host while waiting
+5. On completion, the output is parsed (JSON/JSONL/raw) and returned
+
+Each agent runs in its own process with full access to whatever tools the CLI provides. Hive is just the bridge.
+
+## Project structure
+
+```
+├── conf/cli_clients/     # Built-in CLI client configs (JSON)
+├── prompts/              # 14 role-based system prompt templates
+├── src/
+│   ├── index.ts          # MCP server entry point, tool registration
+│   ├── types.ts          # TypeScript interfaces
+│   ├── agents/           # CLI agent implementations (base, gemini, claude, codex)
+│   ├── config/           # Config loading, internal defaults, constants
+│   ├── parsers/          # Output parsers (gemini JSON, claude JSONL, codex JSONL, raw)
+│   ├── prompts/          # Prompt template loader
+│   ├── continuation/     # Multi-turn conversation store
+│   └── tools/            # Tool handlers (hivesingle, hive consensus)
+├── dist/                 # Compiled output (gitignored)
+└── package.json
+```
+
+## Development
+
+```bash
+npm run dev     # Watch mode (recompiles on changes)
+npm run build   # One-time build
+npm start       # Run the server directly
+```
+
+## License
+
+[MIT](LICENSE)

package/conf/cli_clients/claude.json

@@ -0,0 +1,9 @@
+{
+  "name": "claude",
+  "command": "claude",
+  "runner": "claude",
+  "additional_args": ["--permission-mode", "bypassPermissions"],
+  "env": {},
+  "timeout_seconds": 1800,
+  "roles": {}
+}

package/conf/cli_clients/codex.json

@@ -0,0 +1,9 @@
+{
+  "name": "codex",
+  "command": "codex",
+  "runner": "codex",
+  "additional_args": [],
+  "env": {},
+  "timeout_seconds": 600,
+  "roles": {}
+}

package/conf/cli_clients/gemini.json

@@ -0,0 +1,9 @@
+{
+  "name": "gemini",
+  "command": "gemini",
+  "runner": "gemini",
+  "additional_args": ["-m", "gemini-2.5-pro"],
+  "env": {},
+  "timeout_seconds": 300,
+  "roles": {}
+}

package/conf/cli_clients/glm.json

@@ -0,0 +1,12 @@
+{
+  "name": "glm",
+  "command": "claude",
+  "runner": "claude",
+  "additional_args": [
+    "--permission-mode", "bypassPermissions",
+    "--model", "opus"
+  ],
+  "env": {},
+  "timeout_seconds": 1800,
+  "roles": {}
+}

package/dist/agents/base.d.ts

@@ -0,0 +1,12 @@
+import type { ResolvedClient, SpawnResult, ProgressCallback } from "../types.js";
+export declare class BaseCLIAgent {
+    protected client: ResolvedClient;
+    constructor(client: ResolvedClient);
+    /** Build the full args array for the CLI command */
+    protected buildArgs(systemPrompt: string | undefined, userPrompt: string): string[];
+    /** Build the stdin content to pipe to the process */
+    protected buildStdin(systemPrompt: string | undefined, userPrompt: string): string;
+    /** Run the CLI process */
+    run(systemPrompt: string | undefined, userPrompt: string, cwd?: string, onProgress?: ProgressCallback): Promise<SpawnResult>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/agents/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/agents/base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAoBjF,qBAAa,YAAY;IACvB,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC;gBAErB,MAAM,EAAE,cAAc;IAIlC,oDAAoD;IACpD,SAAS,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAUnF,qDAAqD;IACrD,SAAS,CAAC,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAOlF,0BAA0B;IACpB,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;CA6GnI"}

package/dist/agents/base.js

@@ -0,0 +1,138 @@
+import { spawn } from "node:child_process";
+import { MAX_OUTPUT_CHARS } from "../config/constants.js";
+import { log } from "../log.js";
+// Track active child processes for cleanup on server exit
+const activeChildren = new Set();
+function cleanupChildren() {
+    for (const child of activeChildren) {
+        try {
+            if (child.pid)
+                process.kill(-child.pid, "SIGKILL");
+        }
+        catch { /* already dead */ }
+    }
+    activeChildren.clear();
+}
+// Clean up children on exit. Use "exit" event only — signal handlers
+// that call process.exit() prevent stdout from flushing (breaks MCP stdio transport).
+process.on("exit", cleanupChildren);
+export class BaseCLIAgent {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Build the full args array for the CLI command */
+    buildArgs(systemPrompt, userPrompt) {
+        const args = [...this.client.output_args, ...this.client.additional_args];
+        if (systemPrompt && this.client.prompt_injection === "flag" && this.client.prompt_flag) {
+            args.push(this.client.prompt_flag, systemPrompt);
+        }
+        return args;
+    }
+    /** Build the stdin content to pipe to the process */
+    buildStdin(systemPrompt, userPrompt) {
+        if (systemPrompt && this.client.prompt_injection === "stdin") {
+            return `${systemPrompt}\n\n${userPrompt}`;
+        }
+        return userPrompt;
+    }
+    /** Run the CLI process */
+    async run(systemPrompt, userPrompt, cwd, onProgress) {
+        const args = this.buildArgs(systemPrompt, userPrompt);
+        const stdinContent = this.buildStdin(systemPrompt, userPrompt);
+        // Strip env vars that block nested sessions or corrupt JSON output
+        const { CLAUDECODE: _1, // Prevents Claude-in-Claude nesting check
+        FORCE_COLOR: _2, // Prevents ANSI escape codes in JSON output
+        NO_COLOR: _3, // Let CLIs decide color based on TTY detection
+        ...cleanEnv } = process.env;
+        const env = { ...cleanEnv, ...this.client.env };
+        const timeoutMs = this.client.timeout_seconds * 1000;
+        log(`[${this.client.name}] Spawning: ${this.client.command} ${args.map(a => a.length > 80 ? a.slice(0, 80) + "..." : a).join(" ")}`);
+        return new Promise((resolve) => {
+            let stdout = "";
+            let stderr = "";
+            let timedOut = false;
+            let settled = false;
+            const spawnStart = Date.now();
+            const child = spawn(this.client.command, args, {
+                cwd: cwd ?? process.cwd(),
+                env,
+                stdio: ["pipe", "pipe", "pipe"],
+                detached: true, // Create process group so we can kill the entire tree
+            });
+            activeChildren.add(child);
+            // Periodic progress updates every 10s while waiting
+            const progressInterval = onProgress ? setInterval(() => {
+                const elapsed = Math.round((Date.now() - spawnStart) / 1000);
+                const bytesReceived = stdout.length + stderr.length;
+                const progressPct = Math.min(80, Math.round((elapsed / this.client.timeout_seconds) * 80));
+                onProgress(`Waiting for ${this.client.name} response... (${elapsed}s elapsed, ${bytesReceived.toLocaleString()} bytes received)`, progressPct, 100).catch(() => { }); // fire-and-forget, don't crash on notification failure
+            }, 10_000) : undefined;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                log(`[${this.client.name}] Timeout after ${this.client.timeout_seconds}s — sending SIGTERM`);
+                // Kill the entire process group (child + its subprocesses)
+                try {
+                    if (child.pid)
+                        process.kill(-child.pid, "SIGTERM");
+                }
+                catch { /* already dead */ }
+                // Force kill after 3s grace period
+                setTimeout(() => {
+                    try {
+                        if (child.pid)
+                            process.kill(-child.pid, "SIGKILL");
+                    }
+                    catch { /* already dead */ }
+                }, 3000);
+            }, timeoutMs);
+            child.stdout.on("data", (chunk) => {
+                // Raw buffer needs to be large enough to capture verbose JSON event streams
+                // (Claude's --output-format json includes init events with all tool names).
+                // Final response is still capped at MAX_OUTPUT_CHARS in hive.ts.
+                if (stdout.length < MAX_OUTPUT_CHARS * 20) {
+                    stdout += chunk.toString();
+                }
+            });
+            child.stderr.on("data", (chunk) => {
+                if (stderr.length < MAX_OUTPUT_CHARS) {
+                    stderr += chunk.toString();
+                }
+            });
+            // Prevent stdin errors from crashing the server (child may die before write completes)
+            child.stdin.on("error", () => { });
+            const finish = (exitCode) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                if (progressInterval)
+                    clearInterval(progressInterval);
+                activeChildren.delete(child);
+                log(`[${this.client.name}] Exited: code=${exitCode} timedOut=${timedOut} stdout=${stdout.length}bytes stderr=${stderr.length}bytes`);
+                resolve({ stdout, stderr, exitCode, timedOut });
+            };
+            child.on("close", (code) => finish(code));
+            child.on("error", (err) => {
+                const msg = err.code === "ENOENT"
+                    ? `CLI "${this.client.command}" not found. Is it installed and in PATH?`
+                    : `Spawn error: ${err.message}`;
+                log(`[${this.client.name}] Error: ${msg}`);
+                stderr += `\n${msg}`;
+                finish(1);
+            });
+            // Detached processes won't keep the parent alive — unref so MCP server can exit cleanly
+            child.unref();
+            // Write to stdin and close
+            if (stdinContent) {
+                child.stdin.write(stdinContent, () => {
+                    child.stdin.end();
+                });
+            }
+            else {
+                child.stdin.end();
+            }
+        });
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/agents/base.js.map

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

package/dist/agents/claude.d.ts

@@ -0,0 +1,10 @@
+import { BaseCLIAgent } from "./base.js";
+import type { ResolvedClient } from "../types.js";
+export declare class ClaudeAgent extends BaseCLIAgent {
+    constructor(client: ResolvedClient);
+    /** Claude uses --append-system-prompt flag for system prompt injection, user prompt via stdin */
+    protected buildArgs(systemPrompt: string | undefined, userPrompt: string): string[];
+    /** Claude gets user prompt via stdin only (system prompt goes via flag) */
+    protected buildStdin(systemPrompt: string | undefined, userPrompt: string): string;
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/agents/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/agents/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,qBAAa,WAAY,SAAQ,YAAY;gBAC/B,MAAM,EAAE,cAAc;IAIlC,iGAAiG;cAC9E,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAU5F,2EAA2E;cACxD,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;CAG5F"}

package/dist/agents/claude.js

@@ -0,0 +1,19 @@
+import { BaseCLIAgent } from "./base.js";
+export class ClaudeAgent extends BaseCLIAgent {
+    constructor(client) {
+        super(client);
+    }
+    /** Claude uses --append-system-prompt flag for system prompt injection, user prompt via stdin */
+    buildArgs(systemPrompt, userPrompt) {
+        const args = [...this.client.output_args, ...this.client.additional_args];
+        if (systemPrompt && this.client.prompt_flag) {
+            args.push(this.client.prompt_flag, systemPrompt);
+        }
+        return args;
+    }
+    /** Claude gets user prompt via stdin only (system prompt goes via flag) */
+    buildStdin(systemPrompt, userPrompt) {
+        return userPrompt;
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/agents/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/agents/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,MAAM,OAAO,WAAY,SAAQ,YAAY;IAC3C,YAAY,MAAsB;QAChC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED,iGAAiG;IAC9E,SAAS,CAAC,YAAgC,EAAE,UAAkB;QAC/E,MAAM,IAAI,GAAa,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAEpF,IAAI,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2EAA2E;IACxD,UAAU,CAAC,YAAgC,EAAE,UAAkB;QAChF,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/agents/codex.d.ts

@@ -0,0 +1,10 @@
+import { BaseCLIAgent } from "./base.js";
+import type { ResolvedClient, SpawnResult, ProgressCallback } from "../types.js";
+export declare class CodexAgent extends BaseCLIAgent {
+    constructor(client: ResolvedClient);
+    /** Codex uses `exec` subcommand — inject it before other args if not already present */
+    protected buildArgs(systemPrompt: string | undefined, userPrompt: string): string[];
+    /** Codex JSONL output can have broken lines — stderr is useful for diagnostics */
+    run(systemPrompt: string | undefined, userPrompt: string, cwd?: string, onProgress?: ProgressCallback): Promise<SpawnResult>;
+}
+//# sourceMappingURL=codex.d.ts.map

package/dist/agents/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/agents/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjF,qBAAa,UAAW,SAAQ,YAAY;gBAC9B,MAAM,EAAE,cAAc;IAIlC,wFAAwF;cACrE,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAW5F,kFAAkF;IACnE,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;CAI5I"}

package/dist/agents/codex.js

@@ -0,0 +1,21 @@
+import { BaseCLIAgent } from "./base.js";
+export class CodexAgent extends BaseCLIAgent {
+    constructor(client) {
+        super(client);
+    }
+    /** Codex uses `exec` subcommand — inject it before other args if not already present */
+    buildArgs(systemPrompt, userPrompt) {
+        const args = super.buildArgs(systemPrompt, userPrompt);
+        // Ensure 'exec' is first if output_args doesn't already start with it
+        if (args[0] !== "exec") {
+            // output_args for codex should be ["exec", "--json"] so this is a safety check
+        }
+        return args;
+    }
+    /** Codex JSONL output can have broken lines — stderr is useful for diagnostics */
+    async run(systemPrompt, userPrompt, cwd, onProgress) {
+        const result = await super.run(systemPrompt, userPrompt, cwd, onProgress);
+        return result;
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/agents/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/agents/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,MAAM,OAAO,UAAW,SAAQ,YAAY;IAC1C,YAAY,MAAsB;QAChC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED,wFAAwF;IACrE,SAAS,CAAC,YAAgC,EAAE,UAAkB;QAC/E,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAEvD,sEAAsE;QACtE,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;YACvB,+EAA+E;QACjF,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kFAAkF;IACzE,KAAK,CAAC,GAAG,CAAC,YAAgC,EAAE,UAAkB,EAAE,GAAY,EAAE,UAA6B;QAClH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/agents/factory.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedClient } from "../types.js";
+import { BaseCLIAgent } from "./base.js";
+export declare function createAgent(client: ResolvedClient): BaseCLIAgent;
+//# sourceMappingURL=factory.d.ts.map

package/dist/agents/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/agents/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAWhE"}

package/dist/agents/factory.js

@@ -0,0 +1,17 @@
+import { BaseCLIAgent } from "./base.js";
+import { GeminiAgent } from "./gemini.js";
+import { ClaudeAgent } from "./claude.js";
+import { CodexAgent } from "./codex.js";
+export function createAgent(client) {
+    switch (client.runner) {
+        case "gemini":
+            return new GeminiAgent(client);
+        case "claude":
+            return new ClaudeAgent(client);
+        case "codex":
+            return new CodexAgent(client);
+        default:
+            return new BaseCLIAgent(client);
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/agents/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/agents/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,UAAU,WAAW,CAAC,MAAsB;IAChD,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,QAAQ;YACX,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,QAAQ;YACX,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAChC;YACE,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/agents/gemini.d.ts

@@ -0,0 +1,23 @@
+import { BaseCLIAgent } from "./base.js";
+import type { ResolvedClient, SpawnResult, ProgressCallback } from "../types.js";
+export declare class GeminiAgent extends BaseCLIAgent {
+    constructor(client: ResolvedClient);
+    /**
+     * Gemini uses -p for headless mode. When both -p and stdin are provided,
+     * -p gives the instruction and stdin provides content.
+     *
+     * Strategy:
+     * - System prompt → -p flag (instructions)
+     * - User prompt → stdin (content, no arg length limit)
+     * - No system prompt → -p with user prompt directly
+     */
+    protected buildArgs(systemPrompt: string | undefined, userPrompt: string): string[];
+    /**
+     * Stdin carries the user prompt when system prompt is in -p,
+     * or empty when user prompt is short enough for -p.
+     */
+    protected buildStdin(systemPrompt: string | undefined, userPrompt: string): string;
+    /** Filter known Gemini stderr noise */
+    run(systemPrompt: string | undefined, userPrompt: string, cwd?: string, onProgress?: ProgressCallback): Promise<SpawnResult>;
+}
+//# sourceMappingURL=gemini.d.ts.map

package/dist/agents/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/agents/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjF,qBAAa,WAAY,SAAQ,YAAY;gBAC/B,MAAM,EAAE,cAAc;IAIlC;;;;;;;;OAQG;cACgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAoB5F;;;OAGG;cACgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAY3F,uCAAuC;IACxB,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;CAa5I"}

package/dist/agents/gemini.js

@@ -0,0 +1,62 @@
+import { BaseCLIAgent } from "./base.js";
+export class GeminiAgent extends BaseCLIAgent {
+    constructor(client) {
+        super(client);
+    }
+    /**
+     * Gemini uses -p for headless mode. When both -p and stdin are provided,
+     * -p gives the instruction and stdin provides content.
+     *
+     * Strategy:
+     * - System prompt → -p flag (instructions)
+     * - User prompt → stdin (content, no arg length limit)
+     * - No system prompt → -p with user prompt directly
+     */
+    buildArgs(systemPrompt, userPrompt) {
+        const args = [...this.client.output_args, ...this.client.additional_args];
+        if (systemPrompt) {
+            // System prompt as -p instruction, user prompt goes via stdin
+            args.push("-p", systemPrompt);
+        }
+        else {
+            // No system prompt — use -p for headless mode with short prompt,
+            // or stdin for long prompts to avoid arg length limits
+            if (userPrompt.length < 50_000) {
+                args.push("-p", userPrompt);
+            }
+            else {
+                // Long prompt — -p with minimal instruction, full prompt via stdin
+                args.push("-p", "Process the following input:");
+            }
+        }
+        return args;
+    }
+    /**
+     * Stdin carries the user prompt when system prompt is in -p,
+     * or empty when user prompt is short enough for -p.
+     */
+    buildStdin(systemPrompt, userPrompt) {
+        if (systemPrompt) {
+            // System prompt is in -p, user prompt goes here
+            return userPrompt;
+        }
+        // No system prompt — if short, it went in -p; if long, it goes here
+        if (userPrompt.length < 50_000) {
+            return "";
+        }
+        return userPrompt;
+    }
+    /** Filter known Gemini stderr noise */
+    async run(systemPrompt, userPrompt, cwd, onProgress) {
+        const result = await super.run(systemPrompt, userPrompt, cwd, onProgress);
+        if (result.stderr) {
+            result.stderr = result.stderr
+                .split("\n")
+                .filter(line => !line.includes("WARNING") && !line.includes("I/O"))
+                .join("\n")
+                .trim();
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=gemini.js.map