@kkweon/agent-orchestrator-mcp 1.0.0

package/README.md

@@ -0,0 +1,65 @@
+# Agent Orchestrator MCP Server
+
+This is an MCP (Model Context Protocol) server that enables a "Master" agent (e.g., Gemini CLI) to orchestrate multiple sub-agents within `tmux` panes.
+
+## Features
+
+- **Tmux Integration**: Automatically splits the current tmux window to create panes for sub-agents.
+- **Agent Management**: Create, list, and delete sub-agents.
+- **Task Orchestration**: Enqueue tasks for specific agents.
+- **Inter-Agent Communication**: Agents can emit events and poll for commands.
+
+## Installation
+
+```bash
+npm install -g @kkweon/agent-orchestrator-mcp
+```
+
+## Configuration
+
+Add this server to your MCP client configuration (e.g., `gemini-cli`'s `settings.json` or `mcpServers` config).
+
+```json
+{
+  "mcpServers": {
+    "agent-orchestrator": {
+      "command": "agent-orchestrator-mcp",
+      "args": [],
+      "env": {}
+    }
+  }
+}
+```
+
+## Tools
+
+### `agent_create`
+Create a new agent in a new tmux pane.
+- `name` (string): Name of the agent.
+- `role` (string): Role/instruction for the agent.
+- `cwd` (string, optional): Working directory.
+
+### `agent_list`
+List all active agents managed by this server.
+
+### `agent_delete`
+Delete an agent and close its tmux pane.
+- `agent_id` (string): The ID of the agent to delete.
+
+### `task_enqueue`
+Enqueue a task for an agent.
+- `agent_id` (string): Target agent ID.
+- `task` (object): Task payload.
+
+### `wait_for_command` (Internal)
+Used by sub-agents to poll for new commands/tasks.
+
+### `emit_event` (Internal)
+Used by sub-agents to report progress or results.
+
+## Development
+
+1. Clone the repository.
+2. Install dependencies: `npm install`
+3. Build: `npm run build`
+4. Run locally: `npm start`

package/dist/agent-manager.js

@@ -0,0 +1,183 @@
+import * as tmux from "./tmux.js";
+import { randomUUID } from "crypto";
+import fs from "fs/promises";
+import path from "path";
+import { fileURLToPath } from "url";
+// Get directory of current module
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Helper to get workspace root
+const AGENTS_DIR = ".agents";
+export class AgentManager {
+    workspaceRoot;
+    sessionId; // Expose sessionId for tests
+    constructor(workspaceRoot = process.cwd()) {
+        this.workspaceRoot = workspaceRoot;
+        // If we are a sub-agent, we might be passed a session ID? 
+        // But usually the orchestrator *starts* a new session or manages one.
+        // Let's stick to generating one for the orchestrator instance.
+        // If the user wants to resume, they'd need to pass it, but for now we generate new.
+        this.sessionId = randomUUID();
+    }
+    getSessionDir() {
+        return path.join(this.workspaceRoot, AGENTS_DIR, "sessions", this.sessionId);
+    }
+    getAgentDir(agentId) {
+        return path.join(this.getSessionDir(), "agents", agentId);
+    }
+    async ensureSessionDir() {
+        await fs.mkdir(path.join(this.getSessionDir(), "agents"), { recursive: true });
+    }
+    async createAgent(params) {
+        await this.ensureSessionDir();
+        const id = randomUUID();
+        const agentDir = this.getAgentDir(id);
+        await fs.mkdir(agentDir, { recursive: true });
+        await fs.mkdir(path.join(agentDir, "artifacts"), { recursive: true });
+        // Initialize files
+        await fs.writeFile(path.join(agentDir, "inbox.jsonl"), "");
+        await fs.writeFile(path.join(agentDir, "outbox.jsonl"), "");
+        let context = await tmux.getCurrentTmuxContext();
+        if (!context) {
+            try {
+                context = await tmux.createTmuxSession("openclaw-agents");
+            }
+            catch (e) {
+                console.error("Warning: Could not determine tmux context", e);
+                throw e;
+            }
+        }
+        const pane = await tmux.splitPane(context.paneId, "horizontal", params.cwd);
+        const agent = {
+            id,
+            name: params.name,
+            role: params.role,
+            tmuxPaneId: `${pane.sessionId}:${pane.windowId}:${pane.paneId}`,
+            status: "created",
+            queue: [],
+            lastEventSeq: 0,
+            createdAt: Date.now(),
+            metadata: {},
+        };
+        await fs.writeFile(path.join(agentDir, "meta.json"), JSON.stringify(agent, null, 2));
+        // 1. Prepare Environment
+        await tmux.sendKeys(pane.paneId, `export AGENT_ID=${id}`);
+        await tmux.sendKeys(pane.paneId, `export AGENT_SESSION_ID=${this.sessionId}`);
+        // 2. Launch Gemini CLI
+        // Model preference: params > env > default
+        const model = params.model || process.env.GEMINI_MODEL || "auto";
+        const cmd = `gemini -m ${model}`;
+        // We assume 'gemini' is in the PATH.
+        await tmux.sendKeys(pane.paneId, cmd);
+        // 3. Inject Inception Prompt (Brain Bootstrapping)
+        // We send this as input to the running Gemini CLI.
+        const inceptionPrompt = `
+You are a specialized sub-agent with ID "${id}" and Role "${params.role}".
+Your goal is to autonomously process tasks from the orchestrator.
+
+PROTOCOL:
+1. Loop indefinitely.
+2. Inside the loop, call the tool 'wait_for_command' with agent_id="${id}" and timeout_ms=30000.
+3. If 'wait_for_command' returns a task, execute it using your capabilities.
+4. After execution, call the tool 'emit_event' with agent_id="${id}" and type="task_completed" (include the result).
+5. If it times out or fails, just retry the loop.
+
+Start your loop now.
+`.trim();
+        // Send the prompt. 
+        // Warning: Large prompts might be flaky with send-keys if buffer overflows, 
+        // but for this length it should be fine.
+        await tmux.sendKeys(pane.paneId, inceptionPrompt);
+        return agent;
+    }
+    async listAgents() {
+        await this.ensureSessionDir();
+        const agentsDir = path.join(this.getSessionDir(), "agents");
+        try {
+            const dirs = await fs.readdir(agentsDir);
+            const agents = [];
+            for (const dir of dirs) {
+                try {
+                    const meta = JSON.parse(await fs.readFile(path.join(agentsDir, dir, "meta.json"), "utf-8"));
+                    agents.push(meta);
+                }
+                catch (e) {
+                    // ignore invalid dirs
+                }
+            }
+            return agents;
+        }
+        catch (e) {
+            return [];
+        }
+    }
+    async deleteAgent(id) {
+        const agentDir = this.getAgentDir(id);
+        try {
+            const meta = JSON.parse(await fs.readFile(path.join(agentDir, "meta.json"), "utf-8"));
+            const parts = meta.tmuxPaneId.split(":");
+            const paneId = parts[2] || parts[0];
+            await tmux.killPane(paneId);
+        }
+        catch (e) {
+            // ignore
+        }
+    }
+    async enqueueTask(agentId, taskPayload) {
+        const agentDir = this.getAgentDir(agentId);
+        const taskId = randomUUID();
+        const taskEvent = {
+            type: "task",
+            taskId,
+            payload: taskPayload,
+            timestamp: Date.now()
+        };
+        try {
+            await fs.access(agentDir);
+        }
+        catch {
+            throw new Error(`Agent ${agentId} not found in session ${this.sessionId}`);
+        }
+        await fs.appendFile(path.join(agentDir, "inbox.jsonl"), JSON.stringify(taskEvent) + "\n");
+        return taskId;
+    }
+    async waitForCommand(agentId, cursor = 0, timeoutMs = 10000) {
+        const agentDir = this.getAgentDir(agentId);
+        const inboxPath = path.join(agentDir, "inbox.jsonl");
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeoutMs) {
+            try {
+                const content = await fs.readFile(inboxPath, "utf-8");
+                const lines = content.split("\n").filter(line => line.trim() !== "");
+                if (lines.length > cursor) {
+                    const line = lines[cursor];
+                    const command = JSON.parse(line);
+                    return {
+                        status: "command",
+                        command,
+                        next_cursor: cursor + 1
+                    };
+                }
+            }
+            catch (e) {
+                // file might not exist yet
+            }
+            await new Promise(r => setTimeout(r, 500));
+        }
+        return { status: "timeout", next_cursor: cursor };
+    }
+    async emitEvent(agentId, event) {
+        const agentDir = this.getAgentDir(agentId);
+        const outboxPath = path.join(agentDir, "outbox.jsonl");
+        const broadcastPath = path.join(this.getSessionDir(), "broadcast.jsonl");
+        const entry = {
+            ...event,
+            agentId,
+            timestamp: Date.now()
+        };
+        const line = JSON.stringify(entry) + "\n";
+        await fs.appendFile(outboxPath, line);
+        await fs.appendFile(broadcastPath, line);
+    }
+}
+//# sourceMappingURL=agent-manager.js.map

package/dist/agent-manager.js.map

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

package/dist/index.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { AgentManager } from "./agent-manager.js";
+const server = new Server({
+    name: "agent-orchestrator-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+const agentManager = new AgentManager();
+const TOOLS = [
+    {
+        name: "agent_create",
+        description: "Create a new agent in a new tmux pane",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+                role: { type: "string" },
+                cwd: { type: "string" },
+            },
+            required: ["name", "role"],
+        },
+    },
+    {
+        name: "agent_list",
+        description: "List all active agents",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "agent_delete",
+        description: "Delete an agent and its tmux pane",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string" },
+            },
+            required: ["agent_id"],
+        },
+    },
+    {
+        name: "task_enqueue",
+        description: "Enqueue a task for an agent",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string" },
+                task: { type: "object" },
+            },
+            required: ["agent_id", "task"],
+        },
+    },
+    {
+        name: "wait_for_command",
+        description: "Internal: Agent polls for new commands",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string" },
+                timeout_ms: { type: "number" },
+                cursor: { type: "number" },
+            },
+            required: ["agent_id", "timeout_ms"],
+        },
+    },
+    {
+        name: "emit_event",
+        description: "Internal: Agent emits an event (result/log)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: { type: "string" },
+                event: { type: "object" },
+            },
+            required: ["agent_id", "event"],
+        },
+    }
+];
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS,
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        if (name === "agent_create") {
+            const params = args;
+            const agent = await agentManager.createAgent(params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(agent, null, 2) }],
+            };
+        }
+        if (name === "agent_list") {
+            const agents = await agentManager.listAgents();
+            return {
+                content: [{ type: "text", text: JSON.stringify(agents, null, 2) }],
+            };
+        }
+        if (name === "agent_delete") {
+            const { agent_id } = args;
+            await agentManager.deleteAgent(agent_id);
+            return {
+                content: [{ type: "text", text: `Agent ${agent_id} deleted` }],
+            };
+        }
+        if (name === "task_enqueue") {
+            const { agent_id, task } = args;
+            const taskId = await agentManager.enqueueTask(agent_id, task);
+            return {
+                content: [{ type: "text", text: JSON.stringify({ task_id: taskId }) }],
+            };
+        }
+        if (name === "wait_for_command") {
+            const { agent_id, timeout_ms, cursor } = args;
+            const result = await agentManager.waitForCommand(agent_id, cursor || 0, timeout_ms);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result) }],
+            };
+        }
+        if (name === "emit_event") {
+            const { agent_id, event } = args;
+            await agentManager.emitEvent(agent_id, event);
+            return {
+                content: [{ type: "text", text: "ok" }],
+            };
+        }
+        throw new Error(`Tool not found: ${name}`);
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Agent Orchestrator MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tmux.js

@@ -0,0 +1,37 @@
+import { exec } from "child_process";
+import { promisify } from "util";
+const execAsync = promisify(exec);
+export async function getCurrentTmuxContext() {
+    try {
+        const { stdout } = await execAsync("tmux display-message -p '#{session_id}:#{window_id}:#{pane_id}'");
+        const [sessionId, windowId, paneId] = stdout.trim().split(":");
+        return { sessionId, windowId, paneId };
+    }
+    catch (error) {
+        return null; // Not inside tmux
+    }
+}
+export async function createTmuxSession(sessionName) {
+    await execAsync(`tmux new-session -d -s ${sessionName}`);
+    const { stdout } = await execAsync(`tmux display-message -t ${sessionName} -p '#{session_id}:#{window_id}:#{pane_id}'`);
+    const [sessionId, windowId, paneId] = stdout.trim().split(":");
+    return { sessionId, windowId, paneId };
+}
+export async function splitPane(targetPaneId, direction = "horizontal", cwd) {
+    const flag = direction === "horizontal" ? "-h" : "-v";
+    const cwdCmd = cwd ? `-c ${cwd}` : "";
+    const { stdout } = await execAsync(`tmux split-window -d ${flag} -t ${targetPaneId} ${cwdCmd} -P -F '#{session_id}:#{window_id}:#{pane_id}'`);
+    const [sessionId, windowId, paneId] = stdout.trim().split(":");
+    return { sessionId, windowId, paneId };
+}
+export async function sendKeys(paneId, keys) {
+    await execAsync(`tmux send-keys -t ${paneId} "${keys}" Enter`);
+}
+export async function capturePane(paneId, lines = 100) {
+    const { stdout } = await execAsync(`tmux capture-pane -p -t ${paneId} -S -${lines}`);
+    return stdout;
+}
+export async function killPane(paneId) {
+    await execAsync(`tmux kill-pane -t ${paneId}`);
+}
+//# sourceMappingURL=tmux.js.map

package/dist/tmux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux.js","sourceRoot":"","sources":["../src/tmux.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAQlC,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,iEAAiE,CAAC,CAAC;QACtG,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,CAAC,kBAAkB;IACjC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAAmB;IACzD,MAAM,SAAS,CAAC,0BAA0B,WAAW,EAAE,CAAC,CAAC;IACzD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,2BAA2B,WAAW,6CAA6C,CAAC,CAAC;IACxH,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,YAAoB,EAAE,YAAuC,YAAY,EAAE,GAAY;IACrH,MAAM,IAAI,GAAG,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,wBAAwB,IAAI,OAAO,YAAY,IAAI,MAAM,gDAAgD,CAAC,CAAC;IAC9I,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAc,EAAE,IAAY;IACzD,MAAM,SAAS,CAAC,qBAAqB,MAAM,KAAK,IAAI,SAAS,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,KAAK,GAAG,GAAG;IAC3D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,2BAA2B,MAAM,QAAQ,KAAK,EAAE,CAAC,CAAC;IACrF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAc;IAC3C,MAAM,SAAS,CAAC,qBAAqB,MAAM,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/gemini-extension.json

@@ -0,0 +1,11 @@
+{
+  "name": "agent-orchestrator",
+  "version": "1.0.0",
+  "mcpServers": {
+    "orchestrator": {
+      "command": "node",
+      "args": ["${extensionPath}${/}dist${/}index.js"],
+      "cwd": "${extensionPath}"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@kkweon/agent-orchestrator-mcp",
+  "version": "1.0.0",
+  "description": "Agent Orchestrator MCP Server for tmux-based sub-agents",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kkweon/agent-orchestrator-mcp.git"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "agent-orchestrator-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "gemini-extension.json",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.12.7",
+    "jest": "^30.2.0",
+    "semantic-release": "^25.0.3",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.4.5"
+  }
+}