centaurus-cli 3.0.1 → 3.1.0

package/dist/test-ssh-handler.js

@@ -1,198 +1,153 @@
-/**
- * Manual test script for SSH Handler
- *
- * This script provides basic verification of the SSH Handler implementation.
- * Run with: npx ts-node test-ssh-handler.ts
- */
-import { SSHHandler } from './context/handlers/ssh-handler.js';
+import { SSHHandler } from "./context/handlers/ssh-handler.js";
 async function runTests() {
-    console.log('🧪 SSH Handler Test Suite\n');
-    const handler = new SSHHandler();
-    let passedTests = 0;
-    let failedTests = 0;
-    // Test 1: Detection patterns
-    console.log('Test 1: Command detection');
+  console.log("\u{1F9EA} SSH Handler Test Suite\n");
+  const handler = new SSHHandler();
+  let passedTests = 0;
+  let failedTests = 0;
+  console.log("Test 1: Command detection");
+  try {
+    const test1 = handler.detect("ssh user@host");
+    const test2 = handler.detect("ssh -p 2222 user@host");
+    const test3 = !handler.detect("ls -la");
+    if (test1 && test2 && test3) {
+      console.log("\u2705 PASS: Command detection works correctly");
+      passedTests++;
+    } else {
+      console.log("\u274C FAIL: Command detection failed");
+      failedTests++;
+    }
+  } catch (error) {
+    console.log("\u274C FAIL: Command detection threw error:", error);
+    failedTests++;
+  }
+  console.log("\nTest 2: SSH command parsing");
+  try {
+    const config1 = handler.parseSSHCommand("ssh user@example.com");
+    const config2 = handler.parseSSHCommand("ssh -p 2222 user@example.com");
+    if (config1.host === "example.com" && config1.username === "user" && config1.port === 22 && config2.port === 2222) {
+      console.log("\u2705 PASS: SSH command parsing works correctly");
+      passedTests++;
+    } else {
+      console.log("\u274C FAIL: SSH command parsing failed");
+      console.log("  Config1:", config1);
+      console.log("  Config2:", config2);
+      failedTests++;
+    }
+  } catch (error) {
+    console.log("\u274C FAIL: SSH command parsing threw error:", error);
+    failedTests++;
+  }
+  console.log("\nTest 3: Breadcrumb generation");
+  try {
+    const emptyBreadcrumbs = handler.getBreadcrumbs();
+    handler.config = {
+      host: "example.com",
+      username: "testuser",
+      port: 22
+    };
+    const breadcrumbs = handler.getBreadcrumbs();
+    if (emptyBreadcrumbs.length === 0 && breadcrumbs.length === 2 && breadcrumbs[0].label === "ssh" && breadcrumbs[1].label === "testuser@example.com") {
+      console.log("\u2705 PASS: Breadcrumb generation works correctly");
+      passedTests++;
+    } else {
+      console.log("\u274C FAIL: Breadcrumb generation failed");
+      console.log("  Empty breadcrumbs:", emptyBreadcrumbs);
+      console.log("  Breadcrumbs:", breadcrumbs);
+      failedTests++;
+    }
+  } catch (error) {
+    console.log("\u274C FAIL: Breadcrumb generation threw error:", error);
+    failedTests++;
+  }
+  console.log("\nTest 4: Path resolution");
+  try {
+    handler.currentWorkingDirectory = "/home/user";
+    const absolutePath = handler.resolveAbsolutePath("/etc/hosts");
+    const homePath = handler.resolveAbsolutePath("~/documents");
+    const relativePath = handler.resolveAbsolutePath("documents/file.txt");
+    if (absolutePath === "/etc/hosts" && homePath === "~/documents" && relativePath === "/home/user/documents/file.txt") {
+      console.log("\u2705 PASS: Path resolution works correctly");
+      passedTests++;
+    } else {
+      console.log("\u274C FAIL: Path resolution failed");
+      console.log("  Absolute:", absolutePath);
+      console.log("  Home:", homePath);
+      console.log("  Relative:", relativePath);
+      failedTests++;
+    }
+  } catch (error) {
+    console.log("\u274C FAIL: Path resolution threw error:", error);
+    failedTests++;
+  }
+  console.log("\nTest 5: Shell integration scripts");
+  try {
+    handler.sessionId = "test-session-id";
+    handler.shellType = "bash";
+    const bashScript = handler.getShellIntegrationScript();
+    handler.shellType = "zsh";
+    const zshScript = handler.getShellIntegrationScript();
+    handler.shellType = "fish";
+    const fishScript = handler.getShellIntegrationScript();
+    if (bashScript.includes("CENTAURUS_SUBSHELL=1") && bashScript.includes("PROMPT_COMMAND") && zshScript.includes("precmd_functions") && fishScript.includes("fish_prompt")) {
+      console.log("\u2705 PASS: Shell integration scripts generated correctly");
+      passedTests++;
+    } else {
+      console.log("\u274C FAIL: Shell integration scripts failed");
+      failedTests++;
+    }
+  } catch (error) {
+    console.log("\u274C FAIL: Shell integration scripts threw error:", error);
+    failedTests++;
+  }
+  console.log("\nTest 6: Error handling");
+  try {
+    let errorThrown = false;
     try {
-        const test1 = handler.detect('ssh user@host');
-        const test2 = handler.detect('ssh -p 2222 user@host');
-        const test3 = !handler.detect('ls -la');
-        if (test1 && test2 && test3) {
-            console.log('✅ PASS: Command detection works correctly');
-            passedTests++;
-        }
-        else {
-            console.log('❌ FAIL: Command detection failed');
-            failedTests++;
-        }
-    }
-    catch (error) {
-        console.log('❌ FAIL: Command detection threw error:', error);
-        failedTests++;
-    }
-    // Test 2: SSH command parsing
-    console.log('\nTest 2: SSH command parsing');
-    try {
-        const config1 = handler.parseSSHCommand('ssh user@example.com');
-        const config2 = handler.parseSSHCommand('ssh -p 2222 user@example.com');
-        if (config1.host === 'example.com' &&
-            config1.username === 'user' &&
-            config1.port === 22 &&
-            config2.port === 2222) {
-            console.log('✅ PASS: SSH command parsing works correctly');
-            passedTests++;
-        }
-        else {
-            console.log('❌ FAIL: SSH command parsing failed');
-            console.log('  Config1:', config1);
-            console.log('  Config2:', config2);
-            failedTests++;
-        }
-    }
-    catch (error) {
-        console.log('❌ FAIL: SSH command parsing threw error:', error);
-        failedTests++;
-    }
-    // Test 3: Breadcrumbs
-    console.log('\nTest 3: Breadcrumb generation');
-    try {
-        const emptyBreadcrumbs = handler.getBreadcrumbs();
-        // Simulate config being set
-        handler.config = {
-            host: 'example.com',
-            username: 'testuser',
-            port: 22,
-        };
-        const breadcrumbs = handler.getBreadcrumbs();
-        if (emptyBreadcrumbs.length === 0 &&
-            breadcrumbs.length === 2 &&
-            breadcrumbs[0].label === 'ssh' &&
-            breadcrumbs[1].label === 'testuser@example.com') {
-            console.log('✅ PASS: Breadcrumb generation works correctly');
-            passedTests++;
-        }
-        else {
-            console.log('❌ FAIL: Breadcrumb generation failed');
-            console.log('  Empty breadcrumbs:', emptyBreadcrumbs);
-            console.log('  Breadcrumbs:', breadcrumbs);
-            failedTests++;
-        }
-    }
-    catch (error) {
-        console.log('❌ FAIL: Breadcrumb generation threw error:', error);
-        failedTests++;
-    }
-    // Test 4: Path resolution
-    console.log('\nTest 4: Path resolution');
-    try {
-        handler.currentWorkingDirectory = '/home/user';
-        const absolutePath = handler.resolveAbsolutePath('/etc/hosts');
-        const homePath = handler.resolveAbsolutePath('~/documents');
-        const relativePath = handler.resolveAbsolutePath('documents/file.txt');
-        if (absolutePath === '/etc/hosts' &&
-            homePath === '~/documents' &&
-            relativePath === '/home/user/documents/file.txt') {
-            console.log('✅ PASS: Path resolution works correctly');
-            passedTests++;
-        }
-        else {
-            console.log('❌ FAIL: Path resolution failed');
-            console.log('  Absolute:', absolutePath);
-            console.log('  Home:', homePath);
-            console.log('  Relative:', relativePath);
-            failedTests++;
-        }
-    }
-    catch (error) {
-        console.log('❌ FAIL: Path resolution threw error:', error);
-        failedTests++;
-    }
-    // Test 5: Shell integration scripts
-    console.log('\nTest 5: Shell integration scripts');
-    try {
-        handler.sessionId = 'test-session-id';
-        handler.shellType = 'bash';
-        const bashScript = handler.getShellIntegrationScript();
-        handler.shellType = 'zsh';
-        const zshScript = handler.getShellIntegrationScript();
-        handler.shellType = 'fish';
-        const fishScript = handler.getShellIntegrationScript();
-        if (bashScript.includes('CENTAURUS_SUBSHELL=1') &&
-            bashScript.includes('PROMPT_COMMAND') &&
-            zshScript.includes('precmd_functions') &&
-            fishScript.includes('fish_prompt')) {
-            console.log('✅ PASS: Shell integration scripts generated correctly');
-            passedTests++;
-        }
-        else {
-            console.log('❌ FAIL: Shell integration scripts failed');
-            failedTests++;
-        }
-    }
-    catch (error) {
-        console.log('❌ FAIL: Shell integration scripts threw error:', error);
-        failedTests++;
-    }
-    // Test 6: Error handling for invalid commands
-    console.log('\nTest 6: Error handling');
-    try {
-        let errorThrown = false;
-        try {
-            handler.parseSSHCommand('ssh');
-        }
-        catch (e) {
-            errorThrown = true;
-        }
-        if (errorThrown) {
-            console.log('✅ PASS: Error handling works correctly');
-            passedTests++;
-        }
-        else {
-            console.log('❌ FAIL: Error handling failed - no error thrown for invalid command');
-            failedTests++;
-        }
-    }
-    catch (error) {
-        console.log('❌ FAIL: Error handling test threw unexpected error:', error);
-        failedTests++;
-    }
-    // Test 7: Handler type and patterns
-    console.log('\nTest 7: Handler metadata');
-    try {
-        if (handler.type === 'ssh' &&
-            handler.detectionPatterns.length > 0 &&
-            handler.detectionPatterns[0] instanceof RegExp) {
-            console.log('✅ PASS: Handler metadata is correct');
-            passedTests++;
-        }
-        else {
-            console.log('❌ FAIL: Handler metadata is incorrect');
-            failedTests++;
-        }
-    }
-    catch (error) {
-        console.log('❌ FAIL: Handler metadata test threw error:', error);
-        failedTests++;
-    }
-    // Summary
-    console.log('\n' + '='.repeat(50));
-    console.log(`Test Results: ${passedTests} passed, ${failedTests} failed`);
-    console.log('='.repeat(50));
-    if (failedTests === 0) {
-        console.log('\n✅ All tests passed!');
-        console.log('\nNote: These are unit tests for the SSH Handler logic.');
-        console.log('Integration tests with an actual SSH server would require:');
-        console.log('  - A test SSH server running');
-        console.log('  - Environment variables: TEST_SSH_HOST, TEST_SSH_USER, TEST_SSH_PASSWORD');
-        console.log('  - Running the skipped integration tests in the test file');
-    }
-    else {
-        console.log('\n❌ Some tests failed. Please review the implementation.');
-        process.exit(1);
-    }
-}
-// Run tests
-runTests().catch(error => {
-    console.error('Test suite failed with error:', error);
+      handler.parseSSHCommand("ssh");
+    } catch (e) {
+      errorThrown = true;
+    }
+    if (errorThrown) {
+      console.log("\u2705 PASS: Error handling works correctly");
+      passedTests++;
+    } else {
+      console.log("\u274C FAIL: Error handling failed - no error thrown for invalid command");
+      failedTests++;
+    }
+  } catch (error) {
+    console.log("\u274C FAIL: Error handling test threw unexpected error:", error);
+    failedTests++;
+  }
+  console.log("\nTest 7: Handler metadata");
+  try {
+    if (handler.type === "ssh" && handler.detectionPatterns.length > 0 && handler.detectionPatterns[0] instanceof RegExp) {
+      console.log("\u2705 PASS: Handler metadata is correct");
+      passedTests++;
+    } else {
+      console.log("\u274C FAIL: Handler metadata is incorrect");
+      failedTests++;
+    }
+  } catch (error) {
+    console.log("\u274C FAIL: Handler metadata test threw error:", error);
+    failedTests++;
+  }
+  console.log("\n" + "=".repeat(50));
+  console.log(`Test Results: ${passedTests} passed, ${failedTests} failed`);
+  console.log("=".repeat(50));
+  if (failedTests === 0) {
+    console.log("\n\u2705 All tests passed!");
+    console.log("\nNote: These are unit tests for the SSH Handler logic.");
+    console.log("Integration tests with an actual SSH server would require:");
+    console.log("  - A test SSH server running");
+    console.log("  - Environment variables: TEST_SSH_HOST, TEST_SSH_USER, TEST_SSH_PASSWORD");
+    console.log("  - Running the skipped integration tests in the test file");
+  } else {
+    console.log("\n\u274C Some tests failed. Please review the implementation.");
     process.exit(1);
+  }
+}
+runTests().catch((error) => {
+  console.error("Test suite failed with error:", error);
+  process.exit(1);
 });
 //# sourceMappingURL=test-ssh-handler.js.map

package/dist/test-ssh-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-ssh-handler.js","sourceRoot":"","sources":["../src/test-ssh-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../src/test-ssh-handler.ts"],"sourcesContent":["/**\r\n * Manual test script for SSH Handler\r\n * \r\n * This script provides basic verification of the SSH Handler implementation.\r\n * Run with: npx ts-node test-ssh-handler.ts\r\n */\r\n\r\nimport { SSHHandler } from './context/handlers/ssh-handler.js';\r\n\r\nasync function runTests() {\r\n  console.log('🧪 SSH Handler Test Suite\\n');\r\n  \r\n  const handler = new SSHHandler();\r\n  let passedTests = 0;\r\n  let failedTests = 0;\r\n\r\n  // Test 1: Detection patterns\r\n  console.log('Test 1: Command detection');\r\n  try {\r\n    const test1 = handler.detect('ssh user@host');\r\n    const test2 = handler.detect('ssh -p 2222 user@host');\r\n    const test3 = !handler.detect('ls -la');\r\n    \r\n    if (test1 && test2 && test3) {\r\n      console.log('✅ PASS: Command detection works correctly');\r\n      passedTests++;\r\n    } else {\r\n      console.log('❌ FAIL: Command detection failed');\r\n      failedTests++;\r\n    }\r\n  } catch (error) {\r\n    console.log('❌ FAIL: Command detection threw error:', error);\r\n    failedTests++;\r\n  }\r\n\r\n  // Test 2: SSH command parsing\r\n  console.log('\\nTest 2: SSH command parsing');\r\n  try {\r\n    const config1 = (handler as any).parseSSHCommand('ssh user@example.com');\r\n    const config2 = (handler as any).parseSSHCommand('ssh -p 2222 user@example.com');\r\n    \r\n    if (\r\n      config1.host === 'example.com' &&\r\n      config1.username === 'user' &&\r\n      config1.port === 22 &&\r\n      config2.port === 2222\r\n    ) {\r\n      console.log('✅ PASS: SSH command parsing works correctly');\r\n      passedTests++;\r\n    } else {\r\n      console.log('❌ FAIL: SSH command parsing failed');\r\n      console.log('  Config1:', config1);\r\n      console.log('  Config2:', config2);\r\n      failedTests++;\r\n    }\r\n  } catch (error) {\r\n    console.log('❌ FAIL: SSH command parsing threw error:', error);\r\n    failedTests++;\r\n  }\r\n\r\n  // Test 3: Breadcrumbs\r\n  console.log('\\nTest 3: Breadcrumb generation');\r\n  try {\r\n    const emptyBreadcrumbs = handler.getBreadcrumbs();\r\n    \r\n    // Simulate config being set\r\n    (handler as any).config = {\r\n      host: 'example.com',\r\n      username: 'testuser',\r\n      port: 22,\r\n    };\r\n    \r\n    const breadcrumbs = handler.getBreadcrumbs();\r\n    \r\n    if (\r\n      emptyBreadcrumbs.length === 0 &&\r\n      breadcrumbs.length === 2 &&\r\n      breadcrumbs[0].label === 'ssh' &&\r\n      breadcrumbs[1].label === 'testuser@example.com'\r\n    ) {\r\n      console.log('✅ PASS: Breadcrumb generation works correctly');\r\n      passedTests++;\r\n    } else {\r\n      console.log('❌ FAIL: Breadcrumb generation failed');\r\n      console.log('  Empty breadcrumbs:', emptyBreadcrumbs);\r\n      console.log('  Breadcrumbs:', breadcrumbs);\r\n      failedTests++;\r\n    }\r\n  } catch (error) {\r\n    console.log('❌ FAIL: Breadcrumb generation threw error:', error);\r\n    failedTests++;\r\n  }\r\n\r\n  // Test 4: Path resolution\r\n  console.log('\\nTest 4: Path resolution');\r\n  try {\r\n    (handler as any).currentWorkingDirectory = '/home/user';\r\n    \r\n    const absolutePath = (handler as any).resolveAbsolutePath('/etc/hosts');\r\n    const homePath = (handler as any).resolveAbsolutePath('~/documents');\r\n    const relativePath = (handler as any).resolveAbsolutePath('documents/file.txt');\r\n    \r\n    if (\r\n      absolutePath === '/etc/hosts' &&\r\n      homePath === '~/documents' &&\r\n      relativePath === '/home/user/documents/file.txt'\r\n    ) {\r\n      console.log('✅ PASS: Path resolution works correctly');\r\n      passedTests++;\r\n    } else {\r\n      console.log('❌ FAIL: Path resolution failed');\r\n      console.log('  Absolute:', absolutePath);\r\n      console.log('  Home:', homePath);\r\n      console.log('  Relative:', relativePath);\r\n      failedTests++;\r\n    }\r\n  } catch (error) {\r\n    console.log('❌ FAIL: Path resolution threw error:', error);\r\n    failedTests++;\r\n  }\r\n\r\n  // Test 5: Shell integration scripts\r\n  console.log('\\nTest 5: Shell integration scripts');\r\n  try {\r\n    (handler as any).sessionId = 'test-session-id';\r\n    \r\n    (handler as any).shellType = 'bash';\r\n    const bashScript = (handler as any).getShellIntegrationScript();\r\n    \r\n    (handler as any).shellType = 'zsh';\r\n    const zshScript = (handler as any).getShellIntegrationScript();\r\n    \r\n    (handler as any).shellType = 'fish';\r\n    const fishScript = (handler as any).getShellIntegrationScript();\r\n    \r\n    if (\r\n      bashScript.includes('CENTAURUS_SUBSHELL=1') &&\r\n      bashScript.includes('PROMPT_COMMAND') &&\r\n      zshScript.includes('precmd_functions') &&\r\n      fishScript.includes('fish_prompt')\r\n    ) {\r\n      console.log('✅ PASS: Shell integration scripts generated correctly');\r\n      passedTests++;\r\n    } else {\r\n      console.log('❌ FAIL: Shell integration scripts failed');\r\n      failedTests++;\r\n    }\r\n  } catch (error) {\r\n    console.log('❌ FAIL: Shell integration scripts threw error:', error);\r\n    failedTests++;\r\n  }\r\n\r\n  // Test 6: Error handling for invalid commands\r\n  console.log('\\nTest 6: Error handling');\r\n  try {\r\n    let errorThrown = false;\r\n    try {\r\n      (handler as any).parseSSHCommand('ssh');\r\n    } catch (e) {\r\n      errorThrown = true;\r\n    }\r\n    \r\n    if (errorThrown) {\r\n      console.log('✅ PASS: Error handling works correctly');\r\n      passedTests++;\r\n    } else {\r\n      console.log('❌ FAIL: Error handling failed - no error thrown for invalid command');\r\n      failedTests++;\r\n    }\r\n  } catch (error) {\r\n    console.log('❌ FAIL: Error handling test threw unexpected error:', error);\r\n    failedTests++;\r\n  }\r\n\r\n  // Test 7: Handler type and patterns\r\n  console.log('\\nTest 7: Handler metadata');\r\n  try {\r\n    if (\r\n      handler.type === 'ssh' &&\r\n      handler.detectionPatterns.length > 0 &&\r\n      handler.detectionPatterns[0] instanceof RegExp\r\n    ) {\r\n      console.log('✅ PASS: Handler metadata is correct');\r\n      passedTests++;\r\n    } else {\r\n      console.log('❌ FAIL: Handler metadata is incorrect');\r\n      failedTests++;\r\n    }\r\n  } catch (error) {\r\n    console.log('❌ FAIL: Handler metadata test threw error:', error);\r\n    failedTests++;\r\n  }\r\n\r\n  // Summary\r\n  console.log('\\n' + '='.repeat(50));\r\n  console.log(`Test Results: ${passedTests} passed, ${failedTests} failed`);\r\n  console.log('='.repeat(50));\r\n\r\n  if (failedTests === 0) {\r\n    console.log('\\n✅ All tests passed!');\r\n    console.log('\\nNote: These are unit tests for the SSH Handler logic.');\r\n    console.log('Integration tests with an actual SSH server would require:');\r\n    console.log('  - A test SSH server running');\r\n    console.log('  - Environment variables: TEST_SSH_HOST, TEST_SSH_USER, TEST_SSH_PASSWORD');\r\n    console.log('  - Running the skipped integration tests in the test file');\r\n  } else {\r\n    console.log('\\n❌ Some tests failed. Please review the implementation.');\r\n    process.exit(1);\r\n  }\r\n}\r\n\r\n// Run tests\r\nrunTests().catch(error => {\r\n  console.error('Test suite failed with error:', error);\r\n  process.exit(1);\r\n});\r\n"],"mappings":"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","names":[]}

package/dist/tools/add-mcp.js

@@ -0,0 +1,161 @@
+const addMcpTool = {
+  schema: {
+    name: "add_mcp",
+    description: `Add and connect an MCP (Model Context Protocol) server at runtime. This tool saves the server configuration, connects to it, and registers all of its tools so you can immediately use them.
+
+USE THIS TOOL WHEN:
+- The user asks you to interact with an external service or application (browser, Slack, GitHub, database, etc.) and no matching MCP tools are currently available.
+- You have searched the web and found the correct MCP server package and its configuration for the desired capability.
+- You need to add a new integration on the fly without the user manually editing config files.
+
+HOW IT WORKS:
+1. You provide the MCP server config (name, command, args, env).
+2. The tool saves it to the MCP config file (~/.centaurus/mcp-config.json).
+3. It connects to the server process via stdio.
+4. It discovers and registers all tools the server exposes.
+5. It returns the connection status and list of new tools available to you.
+6. You can then immediately call those tools (they will appear as mcp_<serverName>_<toolName>).
+
+CONFIG FORMAT:
+Most MCP servers are npm packages run via npx. Common patterns:
+
+  npx-based server:
+    name: "browser"
+    command: "npx"
+    args: ["-y", "@anthropic/mcp-browser"]
+
+  node-based server:
+    name: "github"
+    command: "node"
+    args: ["/path/to/server.js"]
+
+  python-based server:
+    name: "postgres"
+    command: "uvx"
+    args: ["mcp-server-postgres", "--connection-string", "postgresql://..."]
+
+  docker-based server:
+    name: "custom-server"
+    command: "docker"
+    args: ["run", "-i", "--rm", "mcp/custom-server"]
+
+  Environment variables (for API keys, tokens, etc.):
+    name: "slack"
+    command: "npx"
+    args: ["-y", "@anthropic/mcp-slack"]
+    env: { "SLACK_BOT_TOKEN": "xoxb-..." }
+
+IMPORTANT NOTES:
+- The "name" must be unique across all configured MCP servers.
+- The "command" is the executable to run (npx, node, python, uvx, docker, etc.).
+- The "args" array contains all arguments passed to the command.
+- The "env" object is optional and sets additional environment variables for the server process.
+- If the connection fails, the config is automatically rolled back (removed).
+- The tool returns detailed logs so you can debug connection issues.
+- After a successful add, the new MCP tools are IMMEDIATELY available for you to call.`,
+    parameters: {
+      type: "object",
+      properties: {
+        reason_text: {
+          type: "string",
+          description: 'REQUIRED: A brief explanation of why you are adding this MCP server. Shown to the user before execution. Example: "Adding browser-control MCP server to navigate to YouTube"'
+        },
+        name: {
+          type: "string",
+          description: 'A unique name for this MCP server (e.g., "browser", "slack", "github"). Must be alphanumeric with hyphens/underscores only.'
+        },
+        command: {
+          type: "string",
+          description: 'The executable command to start the MCP server (e.g., "npx", "node", "python", "uvx", "docker").'
+        },
+        args: {
+          type: "array",
+          items: { type: "string" },
+          description: 'Arguments passed to the command. For npx packages, include "-y" to auto-install. Example: ["-y", "@anthropic/mcp-browser"]'
+        },
+        env: {
+          type: "object",
+          description: 'Optional environment variables for the server process. Use this for API keys, tokens, connection strings, etc. Example: { "GITHUB_TOKEN": "ghp_..." }'
+        },
+        timeout: {
+          type: "number",
+          description: "Optional connection timeout in seconds. Default is 60 seconds. Increase for servers that take longer to start (e.g., Docker-based or servers that need to download dependencies). Example: 120 for 2 minutes."
+        }
+      },
+      required: ["reason_text", "name", "command"]
+    }
+  },
+  async execute(args, context) {
+    const { name, command, args: serverArgs, env, timeout } = args;
+    if (!name || typeof name !== "string" || !name.trim()) {
+      throw new Error('Server "name" is required and must be a non-empty string.');
+    }
+    if (!command || typeof command !== "string" || !command.trim()) {
+      throw new Error('Server "command" is required and must be a non-empty string.');
+    }
+    if (!/^[a-zA-Z0-9_-]+$/.test(name.trim())) {
+      throw new Error("Server name must contain only alphanumeric characters, hyphens, and underscores.");
+    }
+    const approved = await context.requireApproval(
+      `Add MCP server: "${name}" (command: ${command} ${(serverArgs || []).join(" ")})`,
+      true
+      // MCP server installation is a risky operation
+    );
+    if (!approved || typeof approved === "object" && !approved.approved) {
+      return "MCP server addition cancelled by user.";
+    }
+    const serverConfig = {
+      name: name.trim(),
+      command: command.trim(),
+      args: Array.isArray(serverArgs) ? serverArgs : void 0,
+      env: env && typeof env === "object" && !Array.isArray(env) ? env : void 0,
+      enabled: true
+    };
+    const cliAdapter = context.cliAdapter;
+    if (!cliAdapter || typeof cliAdapter.mcpAddAndConnect !== "function") {
+      throw new Error("MCP subsystem is not available. The CLI may not be fully initialized.");
+    }
+    const timeoutMs = timeout && typeof timeout === "number" && timeout > 0 ? Math.round(timeout * 1e3) : 6e4;
+    const result = await cliAdapter.mcpAddAndConnect(serverConfig, timeoutMs);
+    let response = "";
+    if (result.success) {
+      response += `SUCCESS: MCP server "${result.serverName}" is now connected and ready.
+
+`;
+      response += `Available tools (${result.tools.length}):
+`;
+      for (const toolName of result.tools) {
+        response += `  - mcp_${result.serverName}_${toolName}
+`;
+      }
+      response += `
+You can now call these tools directly. They are registered and available for use.
+`;
+    } else {
+      response += `FAILED: Could not connect to MCP server "${result.serverName}".
+`;
+      response += `Error: ${result.error}
+`;
+      response += `
+The server config has been rolled back. You may need to:
+`;
+      response += `  1. Check that the package/command exists and is spelled correctly.
+`;
+      response += `  2. Ensure any required environment variables (API keys, tokens) are provided in the "env" parameter.
+`;
+      response += `  3. Try a different MCP server package or version.
+`;
+    }
+    if (result.logs) {
+      response += `
+Connection logs:
+${result.logs}
+`;
+    }
+    return response;
+  }
+};
+export {
+  addMcpTool
+};
+//# sourceMappingURL=add-mcp.js.map

package/dist/tools/add-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tools/add-mcp.ts"],"sourcesContent":["/**\r\n * Add MCP Tool\r\n *\r\n * Allows the AI agent to programmatically add MCP (Model Context Protocol) server\r\n * configurations at runtime. The tool saves the config, connects to the server,\r\n * registers the server's tools into the tool registry, and returns connection status\r\n * and available tools so the agent can immediately use them.\r\n *\r\n * This enables \"auto-provisioning\": the agent can search the web for an MCP server\r\n * that provides the capabilities it needs (e.g., browser control, Slack, GitHub),\r\n * add it on the fly, and then use the new tools without the user having to manually\r\n * configure anything.\r\n */\r\n\r\nimport { Tool, ToolExecutionContext } from './types.js';\r\n\r\nexport const addMcpTool: Tool = {\r\n    schema: {\r\n        name: 'add_mcp',\r\n        description: `Add and connect an MCP (Model Context Protocol) server at runtime. This tool saves the server configuration, connects to it, and registers all of its tools so you can immediately use them.\r\n\r\nUSE THIS TOOL WHEN:\r\n- The user asks you to interact with an external service or application (browser, Slack, GitHub, database, etc.) and no matching MCP tools are currently available.\r\n- You have searched the web and found the correct MCP server package and its configuration for the desired capability.\r\n- You need to add a new integration on the fly without the user manually editing config files.\r\n\r\nHOW IT WORKS:\r\n1. You provide the MCP server config (name, command, args, env).\r\n2. The tool saves it to the MCP config file (~/.centaurus/mcp-config.json).\r\n3. It connects to the server process via stdio.\r\n4. It discovers and registers all tools the server exposes.\r\n5. It returns the connection status and list of new tools available to you.\r\n6. You can then immediately call those tools (they will appear as mcp_<serverName>_<toolName>).\r\n\r\nCONFIG FORMAT:\r\nMost MCP servers are npm packages run via npx. Common patterns:\r\n\r\n  npx-based server:\r\n    name: \"browser\"\r\n    command: \"npx\"\r\n    args: [\"-y\", \"@anthropic/mcp-browser\"]\r\n\r\n  node-based server:\r\n    name: \"github\"\r\n    command: \"node\"\r\n    args: [\"/path/to/server.js\"]\r\n\r\n  python-based server:\r\n    name: \"postgres\"\r\n    command: \"uvx\"\r\n    args: [\"mcp-server-postgres\", \"--connection-string\", \"postgresql://...\"]\r\n\r\n  docker-based server:\r\n    name: \"custom-server\"\r\n    command: \"docker\"\r\n    args: [\"run\", \"-i\", \"--rm\", \"mcp/custom-server\"]\r\n\r\n  Environment variables (for API keys, tokens, etc.):\r\n    name: \"slack\"\r\n    command: \"npx\"\r\n    args: [\"-y\", \"@anthropic/mcp-slack\"]\r\n    env: { \"SLACK_BOT_TOKEN\": \"xoxb-...\" }\r\n\r\nIMPORTANT NOTES:\r\n- The \"name\" must be unique across all configured MCP servers.\r\n- The \"command\" is the executable to run (npx, node, python, uvx, docker, etc.).\r\n- The \"args\" array contains all arguments passed to the command.\r\n- The \"env\" object is optional and sets additional environment variables for the server process.\r\n- If the connection fails, the config is automatically rolled back (removed).\r\n- The tool returns detailed logs so you can debug connection issues.\r\n- After a successful add, the new MCP tools are IMMEDIATELY available for you to call.`,\r\n        parameters: {\r\n            type: 'object',\r\n            properties: {\r\n                reason_text: {\r\n                    type: 'string',\r\n                    description: 'REQUIRED: A brief explanation of why you are adding this MCP server. Shown to the user before execution. Example: \"Adding browser-control MCP server to navigate to YouTube\"',\r\n                },\r\n                name: {\r\n                    type: 'string',\r\n                    description: 'A unique name for this MCP server (e.g., \"browser\", \"slack\", \"github\"). Must be alphanumeric with hyphens/underscores only.',\r\n                },\r\n                command: {\r\n                    type: 'string',\r\n                    description: 'The executable command to start the MCP server (e.g., \"npx\", \"node\", \"python\", \"uvx\", \"docker\").',\r\n                },\r\n                args: {\r\n                    type: 'array',\r\n                    items: { type: 'string' },\r\n                    description: 'Arguments passed to the command. For npx packages, include \"-y\" to auto-install. Example: [\"-y\", \"@anthropic/mcp-browser\"]',\r\n                },\r\n                env: {\r\n                    type: 'object',\r\n                    description: 'Optional environment variables for the server process. Use this for API keys, tokens, connection strings, etc. Example: { \"GITHUB_TOKEN\": \"ghp_...\" }',\r\n                },\r\n                timeout: {\r\n                    type: 'number',\r\n                    description: 'Optional connection timeout in seconds. Default is 60 seconds. Increase for servers that take longer to start (e.g., Docker-based or servers that need to download dependencies). Example: 120 for 2 minutes.',\r\n                },\r\n            },\r\n            required: ['reason_text', 'name', 'command'],\r\n        },\r\n    },\r\n\r\n    async execute(args: Record<string, any>, context: ToolExecutionContext): Promise<string> {\r\n        const { name, command, args: serverArgs, env, timeout } = args;\r\n\r\n        // Validate required fields\r\n        if (!name || typeof name !== 'string' || !name.trim()) {\r\n            throw new Error('Server \"name\" is required and must be a non-empty string.');\r\n        }\r\n\r\n        if (!command || typeof command !== 'string' || !command.trim()) {\r\n            throw new Error('Server \"command\" is required and must be a non-empty string.');\r\n        }\r\n\r\n        // Validate name format (alphanumeric, hyphens, underscores)\r\n        if (!/^[a-zA-Z0-9_-]+$/.test(name.trim())) {\r\n            throw new Error('Server name must contain only alphanumeric characters, hyphens, and underscores.');\r\n        }\r\n\r\n        // Request user approval since this installs/runs external software\r\n        const approved = await context.requireApproval(\r\n            `Add MCP server: \"${name}\" (command: ${command} ${(serverArgs || []).join(' ')})`,\r\n            true // MCP server installation is a risky operation\r\n        );\r\n\r\n        if (!approved || (typeof approved === 'object' && !approved.approved)) {\r\n            return 'MCP server addition cancelled by user.';\r\n        }\r\n\r\n        // Build the server config\r\n        const serverConfig = {\r\n            name: name.trim(),\r\n            command: command.trim(),\r\n            args: Array.isArray(serverArgs) ? serverArgs : undefined,\r\n            env: env && typeof env === 'object' && !Array.isArray(env) ? env : undefined,\r\n            enabled: true,\r\n        };\r\n\r\n        // Access the CLI adapter to perform the add-and-connect operation\r\n        const cliAdapter = context.cliAdapter;\r\n        if (!cliAdapter || typeof cliAdapter.mcpAddAndConnect !== 'function') {\r\n            throw new Error('MCP subsystem is not available. The CLI may not be fully initialized.');\r\n        }\r\n\r\n        // Convert timeout from seconds to milliseconds (default 60s)\r\n        const timeoutMs = timeout && typeof timeout === 'number' && timeout > 0\r\n            ? Math.round(timeout * 1000)\r\n            : 60000;\r\n\r\n        const result = await cliAdapter.mcpAddAndConnect(serverConfig, timeoutMs);\r\n\r\n        // Format the response for the AI\r\n        let response = '';\r\n\r\n        if (result.success) {\r\n            response += `SUCCESS: MCP server \"${result.serverName}\" is now connected and ready.\\n\\n`;\r\n            response += `Available tools (${result.tools.length}):\\n`;\r\n            for (const toolName of result.tools) {\r\n                response += `  - mcp_${result.serverName}_${toolName}\\n`;\r\n            }\r\n            response += `\\nYou can now call these tools directly. They are registered and available for use.\\n`;\r\n        } else {\r\n            response += `FAILED: Could not connect to MCP server \"${result.serverName}\".\\n`;\r\n            response += `Error: ${result.error}\\n`;\r\n            response += `\\nThe server config has been rolled back. You may need to:\\n`;\r\n            response += `  1. Check that the package/command exists and is spelled correctly.\\n`;\r\n            response += `  2. Ensure any required environment variables (API keys, tokens) are provided in the \"env\" parameter.\\n`;\r\n            response += `  3. Try a different MCP server package or version.\\n`;\r\n        }\r\n\r\n        if (result.logs) {\r\n            response += `\\nConnection logs:\\n${result.logs}\\n`;\r\n        }\r\n\r\n        return response;\r\n    },\r\n};\r\n"],"mappings":"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","names":[]}