@elvatis_com/elvatis-mcp 0.2.0

package/dist/index.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * elvatis-mcp — MCP server exposing OpenClaw tools to Claude Desktop, Cursor, Windsurf, and any MCP client.
+ *
+ * Transports:
+ *   stdio (default)  — for Claude Desktop / local clients
+ *   http             — for remote clients (set MCP_TRANSPORT=http)
+ *
+ * Configuration:
+ *   Copy .env.example to .env and fill in your values.
+ *   Or set env vars directly in claude_desktop_config.json.
+ *
+ * Usage:
+ *   npx @elvatis_com/elvatis-mcp
+ *   MCP_TRANSPORT=http MCP_HTTP_PORT=3333 npx @elvatis_com/elvatis-mcp
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+// Load .env — try multiple locations so it works regardless of cwd or client:
+//   1. <project-root>/.env  — resolved via __dirname from dist/index.js (most reliable)
+//   2. cwd/.env             — fallback for local dev (`node dist/index.js` from repo root)
+// dotenv.config() is a no-op if the file doesn't exist, so ordering is safe.
+const path = __importStar(require("path"));
+const dotenv = __importStar(require("dotenv"));
+dotenv.config({ path: path.resolve(__dirname, '..', '.env') });
+dotenv.config(); // cwd fallback — only loads vars not already set above
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const config_js_1 = require("./config.js");
+const home_js_1 = require("./tools/home.js");
+const memory_js_1 = require("./tools/memory.js");
+const cron_js_1 = require("./tools/cron.js");
+const openclaw_js_1 = require("./tools/openclaw.js");
+const gemini_js_1 = require("./tools/gemini.js");
+const codex_js_1 = require("./tools/codex.js");
+const help_js_1 = require("./tools/help.js");
+const local_llm_js_1 = require("./tools/local-llm.js");
+const splitter_js_1 = require("./tools/splitter.js");
+function toText(result) {
+    return JSON.stringify(result, null, 2);
+}
+function registerTool(server, name, description, schema, handler) {
+    server.tool(name, description, schema, handler);
+}
+async function main() {
+    const config = (0, config_js_1.loadConfig)();
+    const server = new mcp_js_1.McpServer({
+        name: 'elvatis-mcp',
+        version: '0.1.0',
+    });
+    // --- Home Assistant tools ---
+    registerTool(server, 'home_get_state', 'Get the current state of a Home Assistant entity (light, climate, sensor, switch, vacuum, media_player, etc.)', home_js_1.getStateSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, home_js_1.handleGetState)(args, config)) }] }));
+    registerTool(server, 'home_light', 'Control a light: turn on/off/toggle, set brightness (0-100%), color temperature, or RGB color', home_js_1.lightSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, home_js_1.handleLight)(args, config)) }] }));
+    registerTool(server, 'home_climate', 'Control Tado thermostats: set target temperature or HVAC mode (heat/auto/off)', home_js_1.climateSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, home_js_1.handleClimate)(args, config)) }] }));
+    registerTool(server, 'home_scene', 'Activate a Hue scene in a room (wohnzimmer, flur, kuche, schlafzimmer, home)', home_js_1.sceneSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, home_js_1.handleScene)(args, config)) }] }));
+    registerTool(server, 'home_vacuum', 'Control the Roborock vacuum: start full clean, stop, return to dock, or get status', home_js_1.vacuumSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, home_js_1.handleVacuum)(args, config)) }] }));
+    registerTool(server, 'home_sensors', 'Read all environmental sensors: temperature, humidity, CO2 for all rooms plus outside temperature', home_js_1.sensorsSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, home_js_1.handleSensors)(args, config)) }] }));
+    // --- Memory tools (SSH to OpenClaw server) ---
+    registerTool(server, 'openclaw_memory_write', 'Write a note to today\'s daily memory log on the OpenClaw server. Use for capturing important context, decisions, or things to remember.', memory_js_1.memoryWriteSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, memory_js_1.handleMemoryWrite)(args, config)) }] }));
+    registerTool(server, 'openclaw_memory_read_today', 'Read today\'s memory log from the OpenClaw server', memory_js_1.memoryReadTodaySchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, memory_js_1.handleMemoryReadToday)(args, config)) }] }));
+    registerTool(server, 'openclaw_memory_search', 'Search across daily memory files on the OpenClaw server for a keyword (default: last 14 days)', memory_js_1.memorySearchSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, memory_js_1.handleMemorySearch)(args, config)) }] }));
+    // --- Cron tools (SSH to OpenClaw server) ---
+    registerTool(server, 'openclaw_cron_list', 'List all scheduled OpenClaw cron jobs', cron_js_1.cronListSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, cron_js_1.handleCronList)(args, config)) }] }));
+    registerTool(server, 'openclaw_cron_run', 'Trigger an OpenClaw cron job immediately by its ID', cron_js_1.cronRunSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, cron_js_1.handleCronRun)(args, config)) }] }));
+    registerTool(server, 'openclaw_cron_status', 'Get OpenClaw cron scheduler status and overview', cron_js_1.cronStatusSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, cron_js_1.handleCronStatus)(args, config)) }] }));
+    // --- OpenClaw sub-agent tools (SSH orchestration) ---
+    registerTool(server, 'openclaw_run', 'Send a task or prompt to the OpenClaw AI agent via SSH. The agent has access to all installed plugins (trading, home automation, etc.) and multiple LLM backends. Use this to delegate complex tasks that OpenClaw already knows how to handle.', openclaw_js_1.openclawRunSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, openclaw_js_1.handleOpenclawRun)(args, config)) }] }));
+    registerTool(server, 'openclaw_status', 'Check if the OpenClaw daemon is running on the server and get version info', openclaw_js_1.openclawStatusSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, openclaw_js_1.handleOpenclawStatus)(args, config)) }] }));
+    registerTool(server, 'openclaw_plugins', 'List all plugins installed on the OpenClaw server', openclaw_js_1.openclawPluginsSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, openclaw_js_1.handleOpenclawPlugins)(args, config)) }] }));
+    // --- Gemini sub-agent (local spawn) ---
+    registerTool(server, 'gemini_run', 'Send a prompt to Google Gemini via the local gemini CLI. Fast, direct LLM call with no OpenClaw overhead. Uses cached Google auth — no API key required.', gemini_js_1.geminiRunSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, gemini_js_1.handleGeminiRun)(args, config)) }] }));
+    // --- Codex sub-agent (local spawn) ---
+    registerTool(server, 'codex_run', 'Send a task to OpenAI Codex via the local codex CLI. Specializes in coding tasks, file operations, and technical analysis. Uses cached OpenAI auth — no API key required.', codex_js_1.codexRunSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, codex_js_1.handleCodexRun)(args, config)) }] }));
+    // --- Local LLM sub-agent ---
+    registerTool(server, 'local_llm_run', 'Send a prompt to a local LLM (LM Studio, Ollama, llama.cpp, or any OpenAI-compatible server). Free, private, no API key needed. Best for simple tasks: classify, format, extract, rewrite, proofread.', local_llm_js_1.localLlmRunSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, local_llm_js_1.handleLocalLlmRun)(args, config)) }] }));
+    // --- Routing and orchestration ---
+    registerTool(server, 'mcp_help', 'List all available elvatis-mcp tools with a routing guide. Optionally provide a task description to get a specific recommendation for which sub-agent (openclaw_run, gemini_run, codex_run, local_llm_run) or tool to use.', help_js_1.mcpHelpSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, help_js_1.handleMcpHelp)(args)) }] }));
+    registerTool(server, 'prompt_split', 'Analyze a complex prompt and split it into sub-tasks with agent assignments. '
+        + 'Returns a structured plan showing which sub-agent (gemini, codex, openclaw, local LLM) handles each part, '
+        + 'dependency ordering, and the actual prompts to send. '
+        + 'Each subtask includes a suggested model that the user can override before execution. '
+        + 'IMPORTANT: Always present the plan to the user for review before executing. '
+        + 'Strategy: "auto" (default), "gemini", "local", or "heuristic".', splitter_js_1.promptSplitSchema.shape, async (args) => ({ content: [{ type: 'text', text: toText(await (0, splitter_js_1.handlePromptSplit)(args, config)) }] }));
+    // --- Transport ---
+    if (config.transport === 'stdio') {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await server.connect(transport);
+        process.stderr.write('[elvatis-mcp] Running on stdio transport\n');
+    }
+    else {
+        const { createServer } = await Promise.resolve().then(() => __importStar(require('http')));
+        const { StreamableHTTPServerTransport } = await Promise.resolve().then(() => __importStar(require('@modelcontextprotocol/sdk/server/streamableHttp.js')));
+        const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+        const httpServer = createServer(async (req, res) => {
+            if (req.url === '/mcp') {
+                await transport.handleRequest(req, res);
+            }
+            else {
+                res.writeHead(404);
+                res.end('Not found — MCP endpoint is /mcp');
+            }
+        });
+        await server.connect(transport);
+        httpServer.listen(config.httpPort, () => {
+            process.stderr.write(`[elvatis-mcp] Running on HTTP at http://localhost:${config.httpPort}/mcp\n`);
+        });
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`[elvatis-mcp] Fatal: ${err}\n`);
+    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/spawn.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Local process spawner — runs a command on the same machine as the MCP server.
+ * Used by gemini_run and codex_run tools.
+ * No SSH required: these CLIs authenticate via their own local credential stores.
+ */
+/**
+ * Spawn a local command and return stdout as a string.
+ * Progress output on stderr is silently collected (not forwarded).
+ * Throws if the process exits with a non-zero code or times out.
+ */
+export declare function spawnLocal(cmd: string, args: string[], timeoutMs: number): Promise<string>;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../src/spawn.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CA4CjB"}

package/dist/spawn.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Local process spawner — runs a command on the same machine as the MCP server.
+ * Used by gemini_run and codex_run tools.
+ * No SSH required: these CLIs authenticate via their own local credential stores.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spawnLocal = spawnLocal;
+const child_process_1 = require("child_process");
+/**
+ * Spawn a local command and return stdout as a string.
+ * Progress output on stderr is silently collected (not forwarded).
+ * Throws if the process exits with a non-zero code or times out.
+ */
+function spawnLocal(cmd, args, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const proc = (0, child_process_1.spawn)(cmd, args, {
+            shell: false,
+            // Inherit the current environment so the CLI can find its auth credentials
+            env: process.env,
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', (d) => { stdout += d.toString(); });
+        // Codex streams progress to stderr during execution — collect but don't reject on it
+        proc.stderr.on('data', (d) => { stderr += d.toString(); });
+        const timer = setTimeout(() => {
+            proc.kill('SIGTERM');
+            reject(new Error(`Process "${cmd}" timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        proc.on('close', (code) => {
+            clearTimeout(timer);
+            if (code !== 0) {
+                // Include stderr in the error message for easier debugging
+                const detail = stderr.trim() || stdout.trim() || '(no output)';
+                reject(new Error(`"${cmd}" exited with code ${code}: ${detail.substring(0, 500)}`));
+            }
+            else {
+                resolve(stdout);
+            }
+        });
+        proc.on('error', (err) => {
+            clearTimeout(timer);
+            if (err.code === 'ENOENT') {
+                reject(new Error(`Command not found: "${cmd}". ` +
+                    `Make sure it is installed globally (npm install -g @google/gemini-cli OR @openai/codex) ` +
+                    `and available on PATH.`));
+            }
+            else {
+                reject(err);
+            }
+        });
+    });
+}
+//# sourceMappingURL=spawn.js.map

package/dist/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../src/spawn.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AASH,gCAgDC;AAvDD,iDAAsC;AAEtC;;;;GAIG;AACH,SAAgB,UAAU,CACxB,GAAW,EACX,IAAc,EACd,SAAiB;IAEjB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,IAAA,qBAAK,EAAC,GAAG,EAAE,IAAI,EAAE;YAC5B,KAAK,EAAE,KAAK;YACZ,2EAA2E;YAC3E,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,qFAAqF;QACrF,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,GAAG,qBAAqB,SAAS,IAAI,CAAC,CAAC,CAAC;QACvE,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,2DAA2D;gBAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,aAAa,CAAC;gBAC/D,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,sBAAsB,IAAI,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACtF,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;YAC9C,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,KAAK,CACd,uBAAuB,GAAG,KAAK;oBAC/B,0FAA0F;oBAC1F,wBAAwB,CACzB,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/ssh.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SSH exec helper — runs shell commands on the OpenClaw server.
+ * Uses the system `ssh` binary (OpenSSH, available on Windows 10+, macOS, Linux).
+ * No additional npm dependencies required.
+ *
+ * Set SSH_DEBUG=1 in your environment to enable verbose SSH output (-vvv).
+ */
+export interface SshConfig {
+    host: string;
+    port: number;
+    username: string;
+    /** Path to private key, ~ is expanded to os.homedir() */
+    keyPath: string;
+}
+/**
+ * Execute a shell command on the remote host and return stdout as a string.
+ * Throws if the command exits with a non-zero code or times out.
+ * On transient failures (exit 255), retries once after a short delay.
+ */
+export declare function sshExec(cfg: SshConfig, command: string, timeoutMs?: number): Promise<string>;
+/** Read a file on the remote host. Returns empty string if file does not exist. */
+export declare function sshReadFile(cfg: SshConfig, remotePath: string): Promise<string>;
+/**
+ * Append content to a remote file, creating the directory if needed.
+ * Content is base64-encoded to survive shell escaping of special characters.
+ */
+export declare function sshAppendFile(cfg: SshConfig, remotePath: string, content: string): Promise<void>;
+//# sourceMappingURL=ssh.d.ts.map

package/dist/ssh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh.d.ts","sourceRoot":"","sources":["../src/ssh.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;CACjB;AAiCD;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlG;AA4ED,mFAAmF;AACnF,wBAAsB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAItG"}

package/dist/ssh.js

@@ -0,0 +1,171 @@
+"use strict";
+/**
+ * SSH exec helper — runs shell commands on the OpenClaw server.
+ * Uses the system `ssh` binary (OpenSSH, available on Windows 10+, macOS, Linux).
+ * No additional npm dependencies required.
+ *
+ * Set SSH_DEBUG=1 in your environment to enable verbose SSH output (-vvv).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sshExec = sshExec;
+exports.sshReadFile = sshReadFile;
+exports.sshAppendFile = sshAppendFile;
+const child_process_1 = require("child_process");
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/**
+ * Resolve the SSH binary to a full path on Windows.
+ * Claude Desktop (MSIX) and Claude Code may have a different PATH than the
+ * user's interactive shell. We try known locations explicitly so we don't
+ * depend on PATH resolution inside a sandboxed child process.
+ */
+/**
+ * Build a PATH that guarantees the Windows native OpenSSH directory is included.
+ * Claude Desktop (MSIX) and Claude Code may strip PATH entries, so we add
+ * the known SSH locations explicitly.
+ */
+function sshEnv() {
+    const env = { ...process.env, HOME: os.homedir() };
+    if (process.platform === 'win32') {
+        const root = process.env['SystemRoot'] || 'C:\\Windows';
+        const sshDirs = [
+            path.join(root, 'System32', 'OpenSSH'),
+            path.join(root, 'Sysnative', 'OpenSSH'),
+        ];
+        const currentPath = env['PATH'] || env['Path'] || '';
+        // Prepend SSH directories so they are found first
+        env['PATH'] = sshDirs.join(';') + ';' + currentPath;
+    }
+    return env;
+}
+/** Normalize a file path to forward slashes (SSH on Windows needs this). */
+function normalizePath(p) {
+    return p.replace(/\\/g, '/');
+}
+/**
+ * Execute a shell command on the remote host and return stdout as a string.
+ * Throws if the command exits with a non-zero code or times out.
+ * On transient failures (exit 255), retries once after a short delay.
+ */
+async function sshExec(cfg, command, timeoutMs = 15000) {
+    try {
+        return await sshExecOnce(cfg, command, timeoutMs);
+    }
+    catch (err) {
+        // Retry once on exit 255 (connection-level failure, often transient on Windows)
+        const msg = err instanceof Error ? err.message : '';
+        if (msg.includes('exit 255')) {
+            await new Promise(r => setTimeout(r, 1000));
+            return sshExecOnce(cfg, command, timeoutMs);
+        }
+        throw err;
+    }
+}
+function sshExecOnce(cfg, command, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        // Expand ~ and normalize to forward slashes for cross-platform SSH compatibility
+        const keyPath = normalizePath(cfg.keyPath.replace(/^~/, os.homedir()));
+        const debug = process.env['SSH_DEBUG'] === '1';
+        const args = [
+            '-i', keyPath,
+            '-o', 'StrictHostKeyChecking=no',
+            '-o', 'UserKnownHostsFile=/dev/null', // prevent known_hosts divergence across SSH clients
+            '-o', 'BatchMode=yes',
+            '-o', 'ConnectTimeout=10',
+            '-o', 'ServerAliveInterval=5', // detect dead connections faster
+            '-o', 'ServerAliveCountMax=2',
+            '-p', String(cfg.port),
+        ];
+        if (debug) {
+            args.push('-vvv');
+        }
+        args.push(`${cfg.username}@${cfg.host}`, command);
+        // Use plain 'ssh' and rely on PATH (augmented with known SSH dirs via sshEnv).
+        // No shell: true, no full path resolution. This avoids cmd.exe backslash escaping
+        // issues and WoW64 System32 redirection problems on Windows.
+        const proc = (0, child_process_1.spawn)('ssh', args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            windowsHide: true,
+            env: sshEnv(),
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', (d) => { stdout += d.toString(); });
+        proc.stderr.on('data', (d) => { stderr += d.toString(); });
+        const timer = setTimeout(() => {
+            proc.kill();
+            reject(new Error(`SSH timed out after ${timeoutMs}ms (host: ${cfg.host}:${cfg.port}, user: ${cfg.username}, key: ${keyPath})`));
+        }, timeoutMs);
+        proc.on('close', (code) => {
+            clearTimeout(timer);
+            if (code !== 0) {
+                const detail = stderr.trim() || stdout.trim() || 'no output from ssh';
+                const hint = code === 255
+                    ? ` | Tip: verify SSH_HOST (${cfg.host}), SSH_USER (${cfg.username}), SSH_KEY_PATH (${keyPath}) in your .env. Set SSH_DEBUG=1 for verbose logs.`
+                    : '';
+                reject(new Error(`SSH failed (exit ${code}) connecting to ${cfg.username}@${cfg.host}:${cfg.port}: ${detail}${hint}`));
+            }
+            else {
+                resolve(stdout);
+            }
+        });
+        proc.on('error', (err) => {
+            clearTimeout(timer);
+            if (err.code === 'ENOENT') {
+                reject(new Error('ssh binary not found on PATH. ' +
+                    'Windows: Settings > Optional Features > OpenSSH Client. ' +
+                    'macOS/Linux: should be pre-installed.'));
+            }
+            else {
+                reject(err);
+            }
+        });
+    });
+}
+/** Read a file on the remote host. Returns empty string if file does not exist. */
+async function sshReadFile(cfg, remotePath) {
+    return sshExec(cfg, `cat ${remotePath} 2>/dev/null || true`);
+}
+/**
+ * Append content to a remote file, creating the directory if needed.
+ * Content is base64-encoded to survive shell escaping of special characters.
+ */
+async function sshAppendFile(cfg, remotePath, content) {
+    const encoded = Buffer.from(content).toString('base64');
+    const dir = remotePath.replace(/\/[^/]+$/, '');
+    await sshExec(cfg, `mkdir -p ${dir} && echo "${encoded}" | base64 -d >> ${remotePath}`);
+}
+//# sourceMappingURL=ssh.js.map

package/dist/ssh.js.map

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

package/dist/tools/codex.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Codex sub-agent tool.
+ *
+ * Uses the @openai/codex CLI in non-interactive mode:
+ *   codex exec "<prompt>" --approval-mode never [--model <model>]
+ *
+ * Authentication: the CLI uses locally cached OpenAI credentials
+ * (from `codex login`). No OPENAI_API_KEY env var required if logged in.
+ *
+ * Output behavior (codex exec):
+ *   - Progress and tool calls stream to stderr (silently collected)
+ *   - Final agent message is printed to stdout as plain text
+ *
+ * Use --approval-mode never for non-interactive operation (no pausing for
+ * human approval before executing shell commands). Codex may still read and
+ * write files on the machine running the MCP server — use accordingly.
+ *
+ * Use cases vs openclaw_run / gemini_run:
+ *   - Coding tasks: refactoring, debugging, code generation (Codex specializes here)
+ *   - OpenAI model stack (o3, gpt-5-codex, etc.)
+ *   - Long agentic tasks that require multiple tool calls (file read/write, shell)
+ */
+import { z } from 'zod';
+import { Config } from '../config.js';
+export declare const codexRunSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    approval_mode: z.ZodDefault<z.ZodEnum<["never", "on-request"]>>;
+    timeout_seconds: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    timeout_seconds: number;
+    approval_mode: "never" | "on-request";
+    model?: string | undefined;
+}, {
+    prompt: string;
+    timeout_seconds?: number | undefined;
+    model?: string | undefined;
+    approval_mode?: "never" | "on-request" | undefined;
+}>;
+export declare function handleCodexRun(args: {
+    prompt: string;
+    model?: string;
+    approval_mode: 'never' | 'on-request';
+    timeout_seconds: number;
+}, config: Config): Promise<{
+    success: boolean;
+    error: string;
+    hint: string;
+    response?: undefined;
+    model?: undefined;
+    approval_mode?: undefined;
+} | {
+    success: boolean;
+    response: string;
+    model: string;
+    approval_mode: "never" | "on-request";
+    error?: undefined;
+    hint?: undefined;
+}>;
+//# sourceMappingURL=codex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/tools/codex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAKtC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAgBzB,CAAC;AAIH,wBAAsB,cAAc,CAClC,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,GAAG,YAAY,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC;CACzB,EACD,MAAM,EAAE,MAAM;;;;;;;;;;;;;;GAuBf"}

package/dist/tools/codex.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Codex sub-agent tool.
+ *
+ * Uses the @openai/codex CLI in non-interactive mode:
+ *   codex exec "<prompt>" --approval-mode never [--model <model>]
+ *
+ * Authentication: the CLI uses locally cached OpenAI credentials
+ * (from `codex login`). No OPENAI_API_KEY env var required if logged in.
+ *
+ * Output behavior (codex exec):
+ *   - Progress and tool calls stream to stderr (silently collected)
+ *   - Final agent message is printed to stdout as plain text
+ *
+ * Use --approval-mode never for non-interactive operation (no pausing for
+ * human approval before executing shell commands). Codex may still read and
+ * write files on the machine running the MCP server — use accordingly.
+ *
+ * Use cases vs openclaw_run / gemini_run:
+ *   - Coding tasks: refactoring, debugging, code generation (Codex specializes here)
+ *   - OpenAI model stack (o3, gpt-5-codex, etc.)
+ *   - Long agentic tasks that require multiple tool calls (file read/write, shell)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codexRunSchema = void 0;
+exports.handleCodexRun = handleCodexRun;
+const zod_1 = require("zod");
+const spawn_js_1 = require("../spawn.js");
+// --- Schemas ---
+exports.codexRunSchema = zod_1.z.object({
+    prompt: zod_1.z.string().describe('Task or question to send to the Codex AI agent. ' +
+        'Works best for coding tasks, file operations, and technical analysis.'),
+    model: zod_1.z.string().optional().describe('OpenAI model to use, e.g. "o3", "gpt-5-codex". ' +
+        'Omit to use the configured default (CODEX_MODEL env var or Codex default).'),
+    approval_mode: zod_1.z.enum(['never', 'on-request']).default('never').describe('"never": runs all commands without pausing (non-interactive, default). ' +
+        '"on-request": pauses for approval before shell commands — not suitable for automation.'),
+    timeout_seconds: zod_1.z.number().min(10).max(600).default(120).describe('Max seconds to wait. Codex tasks can take longer than Gemini — 120s default.'),
+});
+// --- Handler ---
+async function handleCodexRun(args, config) {
+    const model = args.model ?? config.codexModel;
+    const cliArgs = ['exec', args.prompt, '--approval-mode', args.approval_mode];
+    if (model)
+        cliArgs.push('--model', model);
+    let response;
+    try {
+        response = await (0, spawn_js_1.spawnLocal)('codex', cliArgs, args.timeout_seconds * 1000);
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: String(err),
+            hint: 'Run `codex login` to authenticate, or check `codex --version` to confirm the CLI is installed.',
+        };
+    }
+    return {
+        success: true,
+        response: response.trim(),
+        model: model ?? 'default',
+        approval_mode: args.approval_mode,
+    };
+}
+//# sourceMappingURL=codex.js.map

package/dist/tools/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/tools/codex.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AA4BH,wCA8BC;AAxDD,6BAAwB;AAExB,0CAAyC;AAEzC,kBAAkB;AAEL,QAAA,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACzB,kDAAkD;QAClD,uEAAuE,CACxE;IACD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACnC,iDAAiD;QACjD,4EAA4E,CAC7E;IACD,aAAa,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CACtE,yEAAyE;QACzE,wFAAwF,CACzF;IACD,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAChE,8EAA8E,CAC/E;CACF,CAAC,CAAC;AAEH,kBAAkB;AAEX,KAAK,UAAU,cAAc,CAClC,IAKC,EACD,MAAc;IAEd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,UAAU,CAAC;IAC9C,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7E,IAAI,KAAK;QAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAE1C,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,IAAA,qBAAU,EAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC7E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;YAClB,IAAI,EAAE,gGAAgG;SACvG,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE;QACzB,KAAK,EAAE,KAAK,IAAI,SAAS;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC;AACJ,CAAC"}