centaurus-cli 3.0.0 → 3.1.0

package/dist/tools/enter-remote-session.js

@@ -1,226 +1,180 @@
-/**
- * Enter Remote Session Tool
- *
- * Allows the AI agent to programmatically enter SSH, Docker, or WSL environments.
- * When executed, the session context automatically switches ("auto-warpify")
- * and subsequent commands run in the remote environment.
- *
- * Password prompts are handled by the existing password request callback,
- * which prompts the user for input when needed.
- */
-/**
- * Parse connection string from SSH command
- * Examples:
- *   "ssh rohan@192.168.1.100" -> "rohan@192.168.1.100"
- *   "ssh -p 22 rohan@localhost" -> "rohan@localhost"
- *   "ssh -i ~/.ssh/id_rsa user@host" -> "user@host"
- */
-export function parseSSHConnectionString(command) {
-    // Match user@host pattern in the command
-    const match = command.match(/(\S+)@(\S+)/);
-    if (match) {
-        return match[0];
-    }
-    return undefined;
+function parseSSHConnectionString(command) {
+  const match = command.match(/(\S+)@(\S+)/);
+  if (match) {
+    return match[0];
+  }
+  return void 0;
 }
-/**
- * Parse container name from Docker command
- * Examples:
- *   "docker exec -it mycontainer bash" -> "mycontainer"
- *   "docker exec mycontainer sh" -> "mycontainer"
- */
-export function parseDockerContainer(command) {
-    // docker exec pattern: look for container name after flags
-    const execMatch = command.match(/docker\s+exec\s+(?:-\w+\s+)*(\S+)/i);
-    if (execMatch) {
-        return execMatch[1];
-    }
-    // docker run pattern
-    const runMatch = command.match(/docker\s+run\s+(?:-\w+(?:\s+\S+)?\s+)*(\S+)/i);
-    if (runMatch) {
-        return runMatch[1];
-    }
-    return undefined;
+function parseDockerContainer(command) {
+  const execMatch = command.match(/docker\s+exec\s+(?:-\w+\s+)*(\S+)/i);
+  if (execMatch) {
+    return execMatch[1];
+  }
+  const runMatch = command.match(/docker\s+run\s+(?:-\w+(?:\s+\S+)?\s+)*(\S+)/i);
+  if (runMatch) {
+    return runMatch[1];
+  }
+  return void 0;
 }
-/**
- * Parse WSL distro name from command
- * Examples:
- *   "wsl" -> "Ubuntu" (default)
- *   "wsl -d Ubuntu-22.04" -> "Ubuntu-22.04"
- */
-export function parseWSLDistro(command) {
-    const match = command.match(/wsl\s+(?:-d|--distribution)\s+(\S+)/i);
-    if (match) {
-        return match[1];
-    }
-    return 'Ubuntu'; // Default distro
+function parseWSLDistro(command) {
+  const match = command.match(/wsl\s+(?:-d|--distribution)\s+(\S+)/i);
+  if (match) {
+    return match[1];
+  }
+  return "Ubuntu";
 }
-/**
- * Validate that the command matches the expected session type
- */
-export function validateCommand(command, sessionType) {
-    const trimmedCommand = command.trim().toLowerCase();
-    switch (sessionType) {
-        case 'ssh':
-            if (!trimmedCommand.startsWith('ssh ') && trimmedCommand !== 'ssh') {
-                return { valid: false, error: 'SSH command must start with "ssh"' };
-            }
-            // Validate it has a target
-            if (!command.match(/\S+@\S+/) && !command.match(/ssh\s+\S+/)) {
-                return { valid: false, error: 'SSH command must specify a host (e.g., "ssh user@host")' };
-            }
-            break;
-        case 'docker':
-            if (!trimmedCommand.startsWith('docker ')) {
-                return { valid: false, error: 'Docker command must start with "docker"' };
-            }
-            if (!trimmedCommand.includes('exec') && !trimmedCommand.includes('run')) {
-                return { valid: false, error: 'Docker command must use "exec" or "run" (e.g., "docker exec -it container bash")' };
-            }
-            break;
-        case 'wsl':
-            if (!trimmedCommand.startsWith('wsl') && trimmedCommand !== 'bash') {
-                return { valid: false, error: 'WSL command must start with "wsl" or be "bash"' };
-            }
-            break;
-    }
-    return { valid: true };
+function validateCommand(command, sessionType) {
+  const trimmedCommand = command.trim().toLowerCase();
+  switch (sessionType) {
+    case "ssh":
+      if (!trimmedCommand.startsWith("ssh ") && trimmedCommand !== "ssh") {
+        return { valid: false, error: 'SSH command must start with "ssh"' };
+      }
+      if (!command.match(/\S+@\S+/) && !command.match(/ssh\s+\S+/)) {
+        return { valid: false, error: 'SSH command must specify a host (e.g., "ssh user@host")' };
+      }
+      break;
+    case "docker":
+      if (!trimmedCommand.startsWith("docker ")) {
+        return { valid: false, error: 'Docker command must start with "docker"' };
+      }
+      if (!trimmedCommand.includes("exec") && !trimmedCommand.includes("run")) {
+        return { valid: false, error: 'Docker command must use "exec" or "run" (e.g., "docker exec -it container bash")' };
+      }
+      break;
+    case "wsl":
+      if (!trimmedCommand.startsWith("wsl") && trimmedCommand !== "bash") {
+        return { valid: false, error: 'WSL command must start with "wsl" or be "bash"' };
+      }
+      break;
+  }
+  return { valid: true };
 }
-/**
- * Get connection string based on session type and command
- */
-export function getConnectionString(command, sessionType) {
-    switch (sessionType) {
-        case 'ssh':
-            return parseSSHConnectionString(command);
-        case 'docker':
-            return parseDockerContainer(command);
-        case 'wsl':
-            return parseWSLDistro(command);
-        default:
-            return undefined;
-    }
+function getConnectionString(command, sessionType) {
+  switch (sessionType) {
+    case "ssh":
+      return parseSSHConnectionString(command);
+    case "docker":
+      return parseDockerContainer(command);
+    case "wsl":
+      return parseWSLDistro(command);
+    default:
+      return void 0;
+  }
 }
-export const enterRemoteSessionTool = {
-    schema: {
-        name: 'enter_remote_session',
-        description: `Manage remote environment sessions (SSH, Docker, or WSL).
-
-ACTIONS:
-- enter: Switch context to a remote session. All subsequent commands will run in the remote environment.
-- exit: Exit the current remote session and return to the parent environment.
-
-**Enter action**:
-After the tool executes successfully:
-- All subsequent commands will run in the remote environment
-- The working directory will change to the remote system's directory
-- File operations will target remote files
-
-Examples:
-- SSH: action="enter", session_type="ssh", command="ssh rohan@192.168.1.100"
-- Docker: action="enter", session_type="docker", command="docker exec -it mycontainer bash"
-- WSL: action="enter", session_type="wsl", command="wsl -d Ubuntu"
-
-**Exit action**:
-Exits the current remote session and returns to the parent environment (local or outer remote session).
-- Example: action="exit"
-
-IMPORTANT: 
-- You CANNOT run raw ssh/docker/wsl commands via execute_command. Use this tool instead.
-- To exit a remote session, use action="exit" instead of running the "exit" command.
+const enterRemoteSessionTool = {
+  schema: {
+    name: "enter_remote_session",
+    description: `Manage remote environment sessions (SSH, Docker, or WSL).
+
+ACTIONS:
+- enter: Switch context to a remote session. All subsequent commands will run in the remote environment.
+- exit: Exit the current remote session and return to the parent environment.
+
+**Enter action**:
+After the tool executes successfully:
+- All subsequent commands will run in the remote environment
+- The working directory will change to the remote system's directory
+- File operations will target remote files
+
+Examples:
+- SSH: action="enter", session_type="ssh", command="ssh rohan@192.168.1.100"
+- Docker: action="enter", session_type="docker", command="docker exec -it mycontainer bash"
+- WSL: action="enter", session_type="wsl", command="wsl -d Ubuntu"
+
+**Exit action**:
+Exits the current remote session and returns to the parent environment (local or outer remote session).
+- Example: action="exit"
+
+IMPORTANT: 
+- You CANNOT run raw ssh/docker/wsl commands via execute_command. Use this tool instead.
+- To exit a remote session, use action="exit" instead of running the "exit" command.
 - Password prompts go to the user; the tool will wait for user input.`,
-        parameters: {
-            type: 'object',
-            properties: {
-                action: {
-                    type: 'string',
-                    enum: ['enter', 'exit'],
-                    description: 'The action to perform: "enter" to connect to a remote session, "exit" to leave the current remote session.'
-                },
-                reason_text: {
-                    type: 'string',
-                    description: 'A short, user-facing explanation of why you are entering/exiting this remote session.'
-                },
-                session_type: {
-                    type: 'string',
-                    enum: ['ssh', 'docker', 'wsl'],
-                    description: 'The type of remote session to enter. Required for "enter" action.'
-                },
-                command: {
-                    type: 'string',
-                    description: 'The full command to establish the connection. Required for "enter" action. For SSH: "ssh user@host". For Docker: "docker exec -it container bash". For WSL: "wsl".'
-                }
-            },
-            required: ['action', 'reason_text']
-        }
-    },
-    async execute(args, context) {
-        const { action, session_type, command } = args;
-        // Check if cliAdapter is available
-        if (!context.cliAdapter) {
-            return 'Error: CLI adapter not available. Cannot manage remote session.';
-        }
-        // Handle exit action
-        if (action === 'exit') {
-            // Check if exitRemoteSession method exists
-            if (typeof context.cliAdapter.exitRemoteSession !== 'function') {
-                return 'Error: exitRemoteSession method not available on CLI adapter.';
-            }
-            try {
-                const success = await context.cliAdapter.exitRemoteSession();
-                if (success) {
-                    return 'Successfully exited remote session. Commands will now execute in the parent environment.';
-                }
-                else {
-                    return 'No remote session to exit. Already in local environment.';
-                }
-            }
-            catch (error) {
-                const errorMessage = error?.message || String(error);
-                return `Error exiting remote session: ${errorMessage}`;
-            }
-        }
-        // Handle enter action (default behavior)
-        // Validate session type
-        const validTypes = ['ssh', 'docker', 'wsl'];
-        if (!validTypes.includes(session_type)) {
-            return `Error: Invalid session_type "${session_type}". Must be one of: ssh, docker, wsl`;
-        }
-        if (!command) {
-            return 'Error: command is required for the "enter" action.';
-        }
-        // Validate command matches session type
-        const validation = validateCommand(command, session_type);
-        if (!validation.valid) {
-            return `Error: ${validation.error}`;
+    parameters: {
+      type: "object",
+      properties: {
+        action: {
+          type: "string",
+          enum: ["enter", "exit"],
+          description: 'The action to perform: "enter" to connect to a remote session, "exit" to leave the current remote session.'
+        },
+        reason_text: {
+          type: "string",
+          description: "A short, user-facing explanation of why you are entering/exiting this remote session."
+        },
+        session_type: {
+          type: "string",
+          enum: ["ssh", "docker", "wsl"],
+          description: 'The type of remote session to enter. Required for "enter" action.'
+        },
+        command: {
+          type: "string",
+          description: 'The full command to establish the connection. Required for "enter" action. For SSH: "ssh user@host". For Docker: "docker exec -it container bash". For WSL: "wsl".'
         }
-        // Check if warpifySession method exists
-        if (typeof context.cliAdapter.warpifySession !== 'function') {
-            return 'Error: warpifySession method not available on CLI adapter.';
-        }
-        // Get connection string for display purposes
-        const connectionString = getConnectionString(command, session_type);
-        try {
-            // Call warpifySession - this handles:
-            // 1. Password prompting via onPasswordRequest callback
-            // 2. Connection establishment via the appropriate handler
-            // 3. Context switching via contextManager
-            // 4. CWD updates
-            const success = await context.cliAdapter.warpifySession(command, session_type, connectionString);
-            if (success) {
-                const sessionDesc = connectionString
-                    ? `${session_type.toUpperCase()}: ${connectionString}`
-                    : session_type.toUpperCase();
-                return `Successfully entered remote session: ${sessionDesc}. All subsequent commands will now execute in this remote environment.`;
-            }
-            else {
-                return `Failed to enter remote session. Check the connection details and try again. The connection may have been rejected or timed out.`;
-            }
-        }
-        catch (error) {
-            const errorMessage = error?.message || String(error);
-            return `Error entering remote session: ${errorMessage}`;
+      },
+      required: ["action", "reason_text"]
+    }
+  },
+  async execute(args, context) {
+    const { action, session_type, command } = args;
+    if (!context.cliAdapter) {
+      return "Error: CLI adapter not available. Cannot manage remote session.";
+    }
+    if (action === "exit") {
+      if (typeof context.cliAdapter.exitRemoteSession !== "function") {
+        return "Error: exitRemoteSession method not available on CLI adapter.";
+      }
+      try {
+        const success = await context.cliAdapter.exitRemoteSession();
+        if (success) {
+          return "Successfully exited remote session. Commands will now execute in the parent environment.";
+        } else {
+          return "No remote session to exit. Already in local environment.";
         }
+      } catch (error) {
+        const errorMessage = error?.message || String(error);
+        return `Error exiting remote session: ${errorMessage}`;
+      }
+    }
+    const validTypes = ["ssh", "docker", "wsl"];
+    if (!validTypes.includes(session_type)) {
+      return `Error: Invalid session_type "${session_type}". Must be one of: ssh, docker, wsl`;
     }
+    if (!command) {
+      return 'Error: command is required for the "enter" action.';
+    }
+    const validation = validateCommand(command, session_type);
+    if (!validation.valid) {
+      return `Error: ${validation.error}`;
+    }
+    if (typeof context.cliAdapter.warpifySession !== "function") {
+      return "Error: warpifySession method not available on CLI adapter.";
+    }
+    const connectionString = getConnectionString(command, session_type);
+    try {
+      const success = await context.cliAdapter.warpifySession(
+        command,
+        session_type,
+        connectionString
+      );
+      if (success) {
+        const sessionDesc = connectionString ? `${session_type.toUpperCase()}: ${connectionString}` : session_type.toUpperCase();
+        return `Successfully entered remote session: ${sessionDesc}. All subsequent commands will now execute in this remote environment.`;
+      } else {
+        return `Failed to enter remote session. Check the connection details and try again. The connection may have been rejected or timed out.`;
+      }
+    } catch (error) {
+      const errorMessage = error?.message || String(error);
+      return `Error entering remote session: ${errorMessage}`;
+    }
+  }
+};
+export {
+  enterRemoteSessionTool,
+  getConnectionString,
+  parseDockerContainer,
+  parseSSHConnectionString,
+  parseWSLDistro,
+  validateCommand
 };
 //# sourceMappingURL=enter-remote-session.js.map

package/dist/tools/enter-remote-session.js.map

@@ -1 +1 @@
-{"version":3,"file":"enter-remote-session.js","sourceRoot":"","sources":["../../src/tools/enter-remote-session.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../src/tools/enter-remote-session.ts"],"sourcesContent":["/**\r\n * Enter Remote Session Tool\r\n * \r\n * Allows the AI agent to programmatically enter SSH, Docker, or WSL environments.\r\n * When executed, the session context automatically switches (\"auto-warpify\")\r\n * and subsequent commands run in the remote environment.\r\n * \r\n * Password prompts are handled by the existing password request callback,\r\n * which prompts the user for input when needed.\r\n */\r\n\r\nimport { Tool } from './types.js';\r\n\r\n// Valid session types\r\ntype SessionType = 'ssh' | 'docker' | 'wsl';\r\n\r\n/**\r\n * Parse connection string from SSH command\r\n * Examples:\r\n *   \"ssh rohan@192.168.1.100\" -> \"rohan@192.168.1.100\"\r\n *   \"ssh -p 22 rohan@localhost\" -> \"rohan@localhost\"\r\n *   \"ssh -i ~/.ssh/id_rsa user@host\" -> \"user@host\"\r\n */\r\nexport function parseSSHConnectionString(command: string): string | undefined {\r\n    // Match user@host pattern in the command\r\n    const match = command.match(/(\\S+)@(\\S+)/);\r\n    if (match) {\r\n        return match[0];\r\n    }\r\n    return undefined;\r\n}\r\n\r\n/**\r\n * Parse container name from Docker command\r\n * Examples:\r\n *   \"docker exec -it mycontainer bash\" -> \"mycontainer\"\r\n *   \"docker exec mycontainer sh\" -> \"mycontainer\"\r\n */\r\nexport function parseDockerContainer(command: string): string | undefined {\r\n    // docker exec pattern: look for container name after flags\r\n    const execMatch = command.match(/docker\\s+exec\\s+(?:-\\w+\\s+)*(\\S+)/i);\r\n    if (execMatch) {\r\n        return execMatch[1];\r\n    }\r\n    // docker run pattern\r\n    const runMatch = command.match(/docker\\s+run\\s+(?:-\\w+(?:\\s+\\S+)?\\s+)*(\\S+)/i);\r\n    if (runMatch) {\r\n        return runMatch[1];\r\n    }\r\n    return undefined;\r\n}\r\n\r\n/**\r\n * Parse WSL distro name from command\r\n * Examples:\r\n *   \"wsl\" -> \"Ubuntu\" (default)\r\n *   \"wsl -d Ubuntu-22.04\" -> \"Ubuntu-22.04\"\r\n */\r\nexport function parseWSLDistro(command: string): string {\r\n    const match = command.match(/wsl\\s+(?:-d|--distribution)\\s+(\\S+)/i);\r\n    if (match) {\r\n        return match[1];\r\n    }\r\n    return 'Ubuntu'; // Default distro\r\n}\r\n\r\n/**\r\n * Validate that the command matches the expected session type\r\n */\r\nexport function validateCommand(command: string, sessionType: SessionType): { valid: boolean; error?: string } {\r\n    const trimmedCommand = command.trim().toLowerCase();\r\n\r\n    switch (sessionType) {\r\n        case 'ssh':\r\n            if (!trimmedCommand.startsWith('ssh ') && trimmedCommand !== 'ssh') {\r\n                return { valid: false, error: 'SSH command must start with \"ssh\"' };\r\n            }\r\n            // Validate it has a target\r\n            if (!command.match(/\\S+@\\S+/) && !command.match(/ssh\\s+\\S+/)) {\r\n                return { valid: false, error: 'SSH command must specify a host (e.g., \"ssh user@host\")' };\r\n            }\r\n            break;\r\n\r\n        case 'docker':\r\n            if (!trimmedCommand.startsWith('docker ')) {\r\n                return { valid: false, error: 'Docker command must start with \"docker\"' };\r\n            }\r\n            if (!trimmedCommand.includes('exec') && !trimmedCommand.includes('run')) {\r\n                return { valid: false, error: 'Docker command must use \"exec\" or \"run\" (e.g., \"docker exec -it container bash\")' };\r\n            }\r\n            break;\r\n\r\n        case 'wsl':\r\n            if (!trimmedCommand.startsWith('wsl') && trimmedCommand !== 'bash') {\r\n                return { valid: false, error: 'WSL command must start with \"wsl\" or be \"bash\"' };\r\n            }\r\n            break;\r\n    }\r\n\r\n    return { valid: true };\r\n}\r\n\r\n/**\r\n * Get connection string based on session type and command\r\n */\r\nexport function getConnectionString(command: string, sessionType: SessionType): string | undefined {\r\n    switch (sessionType) {\r\n        case 'ssh':\r\n            return parseSSHConnectionString(command);\r\n        case 'docker':\r\n            return parseDockerContainer(command);\r\n        case 'wsl':\r\n            return parseWSLDistro(command);\r\n        default:\r\n            return undefined;\r\n    }\r\n}\r\n\r\nexport const enterRemoteSessionTool: Tool = {\r\n    schema: {\r\n        name: 'enter_remote_session',\r\n        description: `Manage remote environment sessions (SSH, Docker, or WSL).\r\n\r\nACTIONS:\r\n- enter: Switch context to a remote session. All subsequent commands will run in the remote environment.\r\n- exit: Exit the current remote session and return to the parent environment.\r\n\r\n**Enter action**:\r\nAfter the tool executes successfully:\r\n- All subsequent commands will run in the remote environment\r\n- The working directory will change to the remote system's directory\r\n- File operations will target remote files\r\n\r\nExamples:\r\n- SSH: action=\"enter\", session_type=\"ssh\", command=\"ssh rohan@192.168.1.100\"\r\n- Docker: action=\"enter\", session_type=\"docker\", command=\"docker exec -it mycontainer bash\"\r\n- WSL: action=\"enter\", session_type=\"wsl\", command=\"wsl -d Ubuntu\"\r\n\r\n**Exit action**:\r\nExits the current remote session and returns to the parent environment (local or outer remote session).\r\n- Example: action=\"exit\"\r\n\r\nIMPORTANT: \r\n- You CANNOT run raw ssh/docker/wsl commands via execute_command. Use this tool instead.\r\n- To exit a remote session, use action=\"exit\" instead of running the \"exit\" command.\r\n- Password prompts go to the user; the tool will wait for user input.`,\r\n        parameters: {\r\n            type: 'object',\r\n            properties: {\r\n                action: {\r\n                    type: 'string',\r\n                    enum: ['enter', 'exit'],\r\n                    description: 'The action to perform: \"enter\" to connect to a remote session, \"exit\" to leave the current remote session.'\r\n                },\r\n                reason_text: {\r\n                    type: 'string',\r\n                    description: 'A short, user-facing explanation of why you are entering/exiting this remote session.'\r\n                },\r\n                session_type: {\r\n                    type: 'string',\r\n                    enum: ['ssh', 'docker', 'wsl'],\r\n                    description: 'The type of remote session to enter. Required for \"enter\" action.'\r\n                },\r\n                command: {\r\n                    type: 'string',\r\n                    description: 'The full command to establish the connection. Required for \"enter\" action. For SSH: \"ssh user@host\". For Docker: \"docker exec -it container bash\". For WSL: \"wsl\".'\r\n                }\r\n            },\r\n            required: ['action', 'reason_text']\r\n        }\r\n    },\r\n\r\n    async execute(args, context): Promise<string> {\r\n        const { action, session_type, command } = args;\r\n\r\n        // Check if cliAdapter is available\r\n        if (!context.cliAdapter) {\r\n            return 'Error: CLI adapter not available. Cannot manage remote session.';\r\n        }\r\n\r\n        // Handle exit action\r\n        if (action === 'exit') {\r\n            // Check if exitRemoteSession method exists\r\n            if (typeof context.cliAdapter.exitRemoteSession !== 'function') {\r\n                return 'Error: exitRemoteSession method not available on CLI adapter.';\r\n            }\r\n\r\n            try {\r\n                const success = await context.cliAdapter.exitRemoteSession();\r\n                if (success) {\r\n                    return 'Successfully exited remote session. Commands will now execute in the parent environment.';\r\n                } else {\r\n                    return 'No remote session to exit. Already in local environment.';\r\n                }\r\n            } catch (error: any) {\r\n                const errorMessage = error?.message || String(error);\r\n                return `Error exiting remote session: ${errorMessage}`;\r\n            }\r\n        }\r\n\r\n        // Handle enter action (default behavior)\r\n        // Validate session type\r\n        const validTypes: SessionType[] = ['ssh', 'docker', 'wsl'];\r\n        if (!validTypes.includes(session_type)) {\r\n            return `Error: Invalid session_type \"${session_type}\". Must be one of: ssh, docker, wsl`;\r\n        }\r\n\r\n        if (!command) {\r\n            return 'Error: command is required for the \"enter\" action.';\r\n        }\r\n\r\n        // Validate command matches session type\r\n        const validation = validateCommand(command, session_type as SessionType);\r\n        if (!validation.valid) {\r\n            return `Error: ${validation.error}`;\r\n        }\r\n\r\n        // Check if warpifySession method exists\r\n        if (typeof context.cliAdapter.warpifySession !== 'function') {\r\n            return 'Error: warpifySession method not available on CLI adapter.';\r\n        }\r\n\r\n        // Get connection string for display purposes\r\n        const connectionString = getConnectionString(command, session_type as SessionType);\r\n\r\n        try {\r\n            // Call warpifySession - this handles:\r\n            // 1. Password prompting via onPasswordRequest callback\r\n            // 2. Connection establishment via the appropriate handler\r\n            // 3. Context switching via contextManager\r\n            // 4. CWD updates\r\n            const success = await context.cliAdapter.warpifySession(\r\n                command,\r\n                session_type as SessionType,\r\n                connectionString\r\n            );\r\n\r\n            if (success) {\r\n                const sessionDesc = connectionString\r\n                    ? `${session_type.toUpperCase()}: ${connectionString}`\r\n                    : session_type.toUpperCase();\r\n                return `Successfully entered remote session: ${sessionDesc}. All subsequent commands will now execute in this remote environment.`;\r\n            } else {\r\n                return `Failed to enter remote session. Check the connection details and try again. The connection may have been rejected or timed out.`;\r\n            }\r\n        } catch (error: any) {\r\n            const errorMessage = error?.message || String(error);\r\n            return `Error entering remote session: ${errorMessage}`;\r\n        }\r\n    }\r\n};\r\n"],"mappings":"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","names":[]}

package/dist/tools/fast-context.js

@@ -1,72 +1,65 @@
-import { FastContextAgent } from '../services/fast-context-agent.js';
-import { ToolRegistry } from './registry.js';
-import * as path from 'path';
-export const fastContextTool = {
-    schema: {
-        name: 'fast_context_search',
-        description: `Rapidly retrieve code context using an intelligent multi-turn agent.
-    
-    USE THIS TOOL WHEN:
-    - You need to understand how a feature is implemented across multiple files.
-    - You are exploring a new codebase and need a high-level overview of a component.
-    - Standard grep/find_files is too manual or you are unsure of exact terms.
-    - You want to "find where X is handled" and get a summarized answer with file pointers.
-    
-    HOW IT WORKS:
-    - It uses a specialized AI agent (FastContextAgent) to perform up to 8 turns of search.
-    - It executes parallel grep/find/read operations.
-    - It returns a synthesized markdown summary with relevant snippets and file paths.
-    
-    LIMITATIONS:
-    - Read-only. It cannot modify files.
+import { FastContextAgent } from "../services/fast-context-agent.js";
+import { ToolRegistry } from "./registry.js";
+import * as path from "path";
+const fastContextTool = {
+  schema: {
+    name: "fast_context_search",
+    description: `Rapidly retrieve code context using an intelligent multi-turn agent.
+    
+    USE THIS TOOL WHEN:
+    - You need to understand how a feature is implemented across multiple files.
+    - You are exploring a new codebase and need a high-level overview of a component.
+    - Standard grep/find_files is too manual or you are unsure of exact terms.
+    - You want to "find where X is handled" and get a summarized answer with file pointers.
+    
+    HOW IT WORKS:
+    - It uses a specialized AI agent (FastContextAgent) to perform up to 8 turns of search.
+    - It executes parallel grep/find/read operations.
+    - It returns a synthesized markdown summary with relevant snippets and file paths.
+    
+    LIMITATIONS:
+    - Read-only. It cannot modify files.
     - Optimized for speed (5s target), so it may miss deep/complex chains if not found quickly.`,
-        parameters: {
-            type: 'object',
-            properties: {
-                query: {
-                    type: 'string',
-                    description: 'The search query. Be specific about what you are looking for (e.g., "how is authentication handled in the backend?", "find the implementation of the grep tool").',
-                },
-                path: {
-                    type: 'string',
-                    description: 'Optional. The target directory to search within. Defaults to current working directory.',
-                },
-                reason_text: {
-                    type: 'string',
-                    description: 'REQUIRED: Explanation of why you are using this tool.'
-                }
-            },
-            required: ['query', 'reason_text'],
+    parameters: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          description: 'The search query. Be specific about what you are looking for (e.g., "how is authentication handled in the backend?", "find the implementation of the grep tool").'
         },
-    },
-    async execute(args, context) {
-        const { query, path: searchPath } = args;
-        const cwd = searchPath ? (path.isAbsolute(searchPath) ? searchPath : path.resolve(context.cwd, searchPath)) : context.cwd;
-        // We need a ToolRegistry instance.
-        // In a real dependency injection system, we'd inject it.
-        // Here, we can instantiate a new one, but it won't have tools registered unless we register them.
-        // However, FastContextAgent needs a registry to *execute* tools.
-        // If we create a new registry, it starts empty.
-        // Solution: We need access to the MAIN registry or re-register tools.
-        // Re-registering basic tools (grep, find, view, list) is safe and cheap.
-        const registry = new ToolRegistry();
-        // We lazily import standard tools to avoid circular dependencies if possible, 
-        // or just import them here.
-        const { grepSearchTool } = await import('./grep-search.js');
-        const { findFilesTool } = await import('./find-files.js');
-        const { viewFileTool, listDirTool } = await import('./file-ops.js');
-        registry.register(grepSearchTool);
-        registry.register(findFilesTool);
-        registry.register(viewFileTool);
-        registry.register(listDirTool);
-        const agent = new FastContextAgent(registry);
-        try {
-            const result = await agent.search(query, cwd, context);
-            return result;
-        }
-        catch (error) {
-            return `Fast Context Search Failed: ${error.message}`;
+        path: {
+          type: "string",
+          description: "Optional. The target directory to search within. Defaults to current working directory."
+        },
+        reason_text: {
+          type: "string",
+          description: "REQUIRED: Explanation of why you are using this tool."
         }
-    },
+      },
+      required: ["query", "reason_text"]
+    }
+  },
+  async execute(args, context) {
+    const { query, path: searchPath } = args;
+    const cwd = searchPath ? path.isAbsolute(searchPath) ? searchPath : path.resolve(context.cwd, searchPath) : context.cwd;
+    const registry = new ToolRegistry();
+    const { grepSearchTool } = await import("./grep-search.js");
+    const { findFilesTool } = await import("./find-files.js");
+    const { viewFileTool, listDirTool } = await import("./file-ops.js");
+    registry.register(grepSearchTool);
+    registry.register(findFilesTool);
+    registry.register(viewFileTool);
+    registry.register(listDirTool);
+    const agent = new FastContextAgent(registry);
+    try {
+      const result = await agent.search(query, cwd, context);
+      return result;
+    } catch (error) {
+      return `Fast Context Search Failed: ${error.message}`;
+    }
+  }
+};
+export {
+  fastContextTool
 };
 //# sourceMappingURL=fast-context.js.map

package/dist/tools/fast-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"fast-context.js","sourceRoot":"","sources":["../../src/tools/fast-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,CAAC,MAAM,eAAe,GAAS;IACjC,MAAM,EAAE;QACJ,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE;;;;;;;;;;;;;;;gGAe2E;QACxF,UAAU,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACR,KAAK,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mKAAmK;iBACnL;gBACD,IAAI,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yFAAyF;iBACzG;gBACD,WAAW,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uDAAuD;iBACvE;aACJ;YACD,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;SACrC;KACJ;IACD,KAAK,CAAC,OAAO,CAAC,IAAyB,EAAE,OAA6B;QAClE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QACzC,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;QAE1H,mCAAmC;QACnC,yDAAyD;QACzD,kGAAkG;QAClG,iEAAiE;QACjE,gDAAgD;QAChD,sEAAsE;QACtE,yEAAyE;QAEzE,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QAEpC,+EAA+E;QAC/E,4BAA4B;QAC5B,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC5D,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC1D,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAEpE,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAClC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACjC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAChC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAE/B,MAAM,KAAK,GAAG,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAE7C,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;YACvD,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO,+BAA+B,KAAK,CAAC,OAAO,EAAE,CAAC;QAC1D,CAAC;IACL,CAAC;CACJ,CAAC"}
+{"version":3,"sources":["../../src/tools/fast-context.ts"],"sourcesContent":["import { Tool, ToolExecutionContext } from './types.js';\r\nimport { FastContextAgent } from '../services/fast-context-agent.js';\r\nimport { ToolRegistry } from './registry.js';\r\nimport * as path from 'path';\r\n\r\nexport const fastContextTool: Tool = {\r\n    schema: {\r\n        name: 'fast_context_search',\r\n        description: `Rapidly retrieve code context using an intelligent multi-turn agent.\r\n    \r\n    USE THIS TOOL WHEN:\r\n    - You need to understand how a feature is implemented across multiple files.\r\n    - You are exploring a new codebase and need a high-level overview of a component.\r\n    - Standard grep/find_files is too manual or you are unsure of exact terms.\r\n    - You want to \"find where X is handled\" and get a summarized answer with file pointers.\r\n    \r\n    HOW IT WORKS:\r\n    - It uses a specialized AI agent (FastContextAgent) to perform up to 8 turns of search.\r\n    - It executes parallel grep/find/read operations.\r\n    - It returns a synthesized markdown summary with relevant snippets and file paths.\r\n    \r\n    LIMITATIONS:\r\n    - Read-only. It cannot modify files.\r\n    - Optimized for speed (5s target), so it may miss deep/complex chains if not found quickly.`,\r\n        parameters: {\r\n            type: 'object',\r\n            properties: {\r\n                query: {\r\n                    type: 'string',\r\n                    description: 'The search query. Be specific about what you are looking for (e.g., \"how is authentication handled in the backend?\", \"find the implementation of the grep tool\").',\r\n                },\r\n                path: {\r\n                    type: 'string',\r\n                    description: 'Optional. The target directory to search within. Defaults to current working directory.',\r\n                },\r\n                reason_text: {\r\n                    type: 'string',\r\n                    description: 'REQUIRED: Explanation of why you are using this tool.'\r\n                }\r\n            },\r\n            required: ['query', 'reason_text'],\r\n        },\r\n    },\r\n    async execute(args: Record<string, any>, context: ToolExecutionContext): Promise<string> {\r\n        const { query, path: searchPath } = args;\r\n        const cwd = searchPath ? (path.isAbsolute(searchPath) ? searchPath : path.resolve(context.cwd, searchPath)) : context.cwd;\r\n\r\n        // We need a ToolRegistry instance.\r\n        // In a real dependency injection system, we'd inject it.\r\n        // Here, we can instantiate a new one, but it won't have tools registered unless we register them.\r\n        // However, FastContextAgent needs a registry to *execute* tools.\r\n        // If we create a new registry, it starts empty.\r\n        // Solution: We need access to the MAIN registry or re-register tools.\r\n        // Re-registering basic tools (grep, find, view, list) is safe and cheap.\r\n\r\n        const registry = new ToolRegistry();\r\n\r\n        // We lazily import standard tools to avoid circular dependencies if possible, \r\n        // or just import them here.\r\n        const { grepSearchTool } = await import('./grep-search.js');\r\n        const { findFilesTool } = await import('./find-files.js');\r\n        const { viewFileTool, listDirTool } = await import('./file-ops.js');\r\n\r\n        registry.register(grepSearchTool);\r\n        registry.register(findFilesTool);\r\n        registry.register(viewFileTool);\r\n        registry.register(listDirTool);\r\n\r\n        const agent = new FastContextAgent(registry);\r\n\r\n        try {\r\n            const result = await agent.search(query, cwd, context);\r\n            return result;\r\n        } catch (error: any) {\r\n            return `Fast Context Search Failed: ${error.message}`;\r\n        }\r\n    },\r\n};\r\n"],"mappings":"AACA,SAAS,wBAAwB;AACjC,SAAS,oBAAoB;AAC7B,YAAY,UAAU;AAEf,MAAM,kBAAwB;AAAA,EACjC,QAAQ;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAgBb,YAAY;AAAA,MACR,MAAM;AAAA,MACN,YAAY;AAAA,QACR,OAAO;AAAA,UACH,MAAM;AAAA,UACN,aAAa;AAAA,QACjB;AAAA,QACA,MAAM;AAAA,UACF,MAAM;AAAA,UACN,aAAa;AAAA,QACjB;AAAA,QACA,aAAa;AAAA,UACT,MAAM;AAAA,UACN,aAAa;AAAA,QACjB;AAAA,MACJ;AAAA,MACA,UAAU,CAAC,SAAS,aAAa;AAAA,IACrC;AAAA,EACJ;AAAA,EACA,MAAM,QAAQ,MAA2B,SAAgD;AACrF,UAAM,EAAE,OAAO,MAAM,WAAW,IAAI;AACpC,UAAM,MAAM,aAAc,KAAK,WAAW,UAAU,IAAI,aAAa,KAAK,QAAQ,QAAQ,KAAK,UAAU,IAAK,QAAQ;AAUtH,UAAM,WAAW,IAAI,aAAa;AAIlC,UAAM,EAAE,eAAe,IAAI,MAAM,OAAO,kBAAkB;AAC1D,UAAM,EAAE,cAAc,IAAI,MAAM,OAAO,iBAAiB;AACxD,UAAM,EAAE,cAAc,YAAY,IAAI,MAAM,OAAO,eAAe;AAElE,aAAS,SAAS,cAAc;AAChC,aAAS,SAAS,aAAa;AAC/B,aAAS,SAAS,YAAY;AAC9B,aAAS,SAAS,WAAW;AAE7B,UAAM,QAAQ,IAAI,iBAAiB,QAAQ;AAE3C,QAAI;AACA,YAAM,SAAS,MAAM,MAAM,OAAO,OAAO,KAAK,OAAO;AACrD,aAAO;AAAA,IACX,SAAS,OAAY;AACjB,aAAO,+BAA+B,MAAM,OAAO;AAAA,IACvD;AAAA,EACJ;AACJ;","names":[]}