hanseol 3.2.7

package/dist/tools/llm/simple/background-bash-tool.js

@@ -0,0 +1,320 @@
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import { logger } from '../../../utils/logger.js';
+import { isNativeWindows } from '../../../utils/platform-utils.js';
+class BackgroundProcessManager {
+    processes = new Map();
+    nextId = 1;
+    start(command, cwd) {
+        const id = `bg-${this.nextId++}`;
+        const workingDir = cwd || process.cwd();
+        const shell = '/bin/bash';
+        const shellArgs = ['-c', command];
+        const child = spawn(shell, shellArgs, {
+            cwd: workingDir,
+            env: { ...process.env },
+            detached: false,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const bgProcess = {
+            id,
+            command,
+            process: child,
+            startedAt: new Date(),
+            cwd: workingDir,
+            output: [],
+            maxOutputLines: 100,
+        };
+        child.stdout?.on('data', (data) => {
+            const lines = data.toString().split('\n').filter((l) => l.trim());
+            bgProcess.output.push(...lines);
+            if (bgProcess.output.length > bgProcess.maxOutputLines) {
+                bgProcess.output = bgProcess.output.slice(-bgProcess.maxOutputLines);
+            }
+        });
+        child.stderr?.on('data', (data) => {
+            const lines = data.toString().split('\n').filter((l) => l.trim());
+            bgProcess.output.push(...lines.map((l) => `[stderr] ${l}`));
+            if (bgProcess.output.length > bgProcess.maxOutputLines) {
+                bgProcess.output = bgProcess.output.slice(-bgProcess.maxOutputLines);
+            }
+        });
+        child.on('close', (code) => {
+            bgProcess.output.push(`[Process exited with code ${code}]`);
+        });
+        child.on('error', (error) => {
+            bgProcess.output.push(`[Error: ${error.message}]`);
+        });
+        this.processes.set(id, bgProcess);
+        return { id, pid: child.pid || 0 };
+    }
+    kill(id) {
+        const bgProcess = this.processes.get(id);
+        if (!bgProcess) {
+            return false;
+        }
+        try {
+            bgProcess.process.kill('SIGTERM');
+            setTimeout(() => {
+                if (!bgProcess.process.killed) {
+                    bgProcess.process.kill('SIGKILL');
+                }
+            }, 2000);
+            this.processes.delete(id);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    getStatus(id) {
+        const bgProcess = this.processes.get(id);
+        if (!bgProcess) {
+            return null;
+        }
+        return {
+            running: !bgProcess.process.killed && bgProcess.process.exitCode === null,
+            output: bgProcess.output.slice(-20),
+        };
+    }
+    list() {
+        return Array.from(this.processes.values()).map(p => ({
+            id: p.id,
+            command: p.command,
+            pid: p.process.pid || 0,
+            running: !p.process.killed && p.process.exitCode === null,
+            startedAt: p.startedAt,
+            cwd: p.cwd,
+        }));
+    }
+    killAll() {
+        let killed = 0;
+        for (const [id] of this.processes) {
+            if (this.kill(id)) {
+                killed++;
+            }
+        }
+        return killed;
+    }
+}
+export const backgroundProcessManager = new BackgroundProcessManager();
+const BASH_BACKGROUND_DEFINITION = {
+    type: 'function',
+    function: {
+        name: 'bash_background',
+        description: `Start a command in the background. Use this for long-running processes like:
+- npm run dev (development server)
+- npm start (application server)
+- python -m http.server (simple HTTP server)
+- docker-compose up
+
+The command will continue running after this tool returns.
+Use bash_background_status to check output, or bash_background_kill to stop it.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                reason: {
+                    type: 'string',
+                    description: 'Explanation of why you are running this in background',
+                },
+                command: {
+                    type: 'string',
+                    description: 'The command to run in background',
+                },
+                cwd: {
+                    type: 'string',
+                    description: 'Working directory (optional)',
+                },
+            },
+            required: ['reason', 'command'],
+        },
+    },
+};
+async function executeBashBackground(args) {
+    const command = args['command'];
+    const cwd = args['cwd'];
+    logger.enter('bashBackground.execute', { command, cwd });
+    if (isNativeWindows()) {
+        return {
+            success: false,
+            error: 'bash_background tool is not available on Native Windows. Use powershell_background instead.',
+        };
+    }
+    if (cwd) {
+        if (!fs.existsSync(cwd)) {
+            logger.warn('Invalid cwd provided (does not exist)', { cwd });
+            return {
+                success: false,
+                error: `Working directory does not exist: ${cwd}`,
+            };
+        }
+        if (!fs.statSync(cwd).isDirectory()) {
+            logger.warn('Invalid cwd provided (not a directory)', { cwd });
+            return {
+                success: false,
+                error: `Working directory path is not a directory: ${cwd}`,
+            };
+        }
+    }
+    try {
+        const { id, pid } = backgroundProcessManager.start(command, cwd);
+        await new Promise(r => setTimeout(r, 1000));
+        const status = backgroundProcessManager.getStatus(id);
+        const running = status?.running ?? false;
+        if (!running) {
+            const output = status?.output.join('\n') || '(no output)';
+            return {
+                success: false,
+                error: `Process failed to start or exited immediately.\nOutput:\n${output}`,
+            };
+        }
+        logger.exit('bashBackground.execute', { id, pid });
+        return {
+            success: true,
+            result: `Background process started\nID: ${id}\nPID: ${pid}\nCommand: ${command}\n\nUse bash_background_status with id="${id}" to check output.\nUse bash_background_kill with id="${id}" to stop it.`,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: `Failed to start background process: ${errorMessage}`,
+        };
+    }
+}
+export const bashBackgroundTool = {
+    definition: BASH_BACKGROUND_DEFINITION,
+    execute: executeBashBackground,
+    categories: ['llm-simple'],
+    description: 'Run command in background',
+};
+const BASH_BACKGROUND_STATUS_DEFINITION = {
+    type: 'function',
+    function: {
+        name: 'bash_background_status',
+        description: `Check the status and recent output of a background process.
+Use this to see if a server started successfully or to check for errors.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                reason: {
+                    type: 'string',
+                    description: 'Explanation of why you are checking status',
+                },
+                id: {
+                    type: 'string',
+                    description: 'The process ID (e.g., "bg-1") returned by bash_background',
+                },
+            },
+            required: ['reason', 'id'],
+        },
+    },
+};
+async function executeBashBackgroundStatus(args) {
+    const id = args['id'];
+    if (isNativeWindows()) {
+        return {
+            success: false,
+            error: 'bash_background_status tool is not available on Native Windows.',
+        };
+    }
+    const status = backgroundProcessManager.getStatus(id);
+    if (!status) {
+        if (!id || id === 'list') {
+            const processes = backgroundProcessManager.list();
+            if (processes.length === 0) {
+                return {
+                    success: true,
+                    result: 'No background processes running.',
+                };
+            }
+            const list = processes.map(p => {
+                const status = p.running ? 'running' : 'stopped';
+                return `- ${p.id}: ${p.command} (PID: ${p.pid}, ${status})`;
+            }).join('\n');
+            return {
+                success: true,
+                result: `Background processes:\n${list}`,
+            };
+        }
+        return {
+            success: false,
+            error: `No background process found with ID: ${id}`,
+        };
+    }
+    const statusStr = status.running ? 'Running' : 'Stopped';
+    const output = status.output.length > 0
+        ? status.output.join('\n')
+        : '(no output yet)';
+    return {
+        success: true,
+        result: `Process ${id}:\nStatus: ${statusStr}\n\nRecent output:\n${output}`,
+    };
+}
+export const bashBackgroundStatusTool = {
+    definition: BASH_BACKGROUND_STATUS_DEFINITION,
+    execute: executeBashBackgroundStatus,
+    categories: ['llm-simple'],
+    description: 'Check background process status',
+};
+const BASH_BACKGROUND_KILL_DEFINITION = {
+    type: 'function',
+    function: {
+        name: 'bash_background_kill',
+        description: `Stop a background process.
+Use this to stop development servers, watchers, or other long-running processes.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                reason: {
+                    type: 'string',
+                    description: 'Explanation of why you are killing this process',
+                },
+                id: {
+                    type: 'string',
+                    description: 'The process ID (e.g., "bg-1") to kill, or "all" to kill all background processes',
+                },
+            },
+            required: ['reason', 'id'],
+        },
+    },
+};
+async function executeBashBackgroundKill(args) {
+    const id = args['id'];
+    if (isNativeWindows()) {
+        return {
+            success: false,
+            error: 'bash_background_kill tool is not available on Native Windows.',
+        };
+    }
+    if (id === 'all') {
+        const killed = backgroundProcessManager.killAll();
+        return {
+            success: true,
+            result: `Killed ${killed} background process(es).`,
+        };
+    }
+    const success = backgroundProcessManager.kill(id);
+    if (!success) {
+        return {
+            success: false,
+            error: `No background process found with ID: ${id}`,
+        };
+    }
+    return {
+        success: true,
+        result: `Background process ${id} has been killed.`,
+    };
+}
+export const bashBackgroundKillTool = {
+    definition: BASH_BACKGROUND_KILL_DEFINITION,
+    execute: executeBashBackgroundKill,
+    categories: ['llm-simple'],
+    description: 'Kill background process',
+};
+export const BACKGROUND_BASH_TOOLS = [
+    bashBackgroundTool,
+    bashBackgroundStatusTool,
+    bashBackgroundKillTool,
+];
+//# sourceMappingURL=background-bash-tool.js.map

package/dist/tools/llm/simple/background-bash-tool.js.map

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

package/dist/tools/llm/simple/background-powershell-tool.d.ts

@@ -0,0 +1,30 @@
+import { LLMSimpleTool } from '../../types.js';
+declare class BackgroundPowerShellProcessManager {
+    private processes;
+    private nextId;
+    start(command: string, cwd?: string): {
+        id: string;
+        pid: number;
+    };
+    kill(id: string): boolean;
+    getStatus(id: string): {
+        running: boolean;
+        output: string[];
+    } | null;
+    list(): Array<{
+        id: string;
+        command: string;
+        pid: number;
+        running: boolean;
+        startedAt: Date;
+        cwd: string;
+    }>;
+    killAll(): number;
+}
+export declare const backgroundPowerShellProcessManager: BackgroundPowerShellProcessManager;
+export declare const powershellBackgroundTool: LLMSimpleTool;
+export declare const powershellBackgroundStatusTool: LLMSimpleTool;
+export declare const powershellBackgroundKillTool: LLMSimpleTool;
+export declare const BACKGROUND_POWERSHELL_TOOLS: LLMSimpleTool[];
+export {};
+//# sourceMappingURL=background-powershell-tool.d.ts.map

package/dist/tools/llm/simple/background-powershell-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-powershell-tool.d.ts","sourceRoot":"","sources":["../../../../src/tools/llm/simple/background-powershell-tool.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAA4B,MAAM,gBAAgB,CAAC;AAoBzE,cAAM,kCAAkC;IACtC,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,MAAM,CAAK;IAKnB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAyDjE,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAwBzB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI;IAepE,IAAI,IAAI,KAAK,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,IAAI,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IAcF,OAAO,IAAI,MAAM;CASlB;AAGD,eAAO,MAAM,kCAAkC,oCAA2C,CAAC;AAoF3F,eAAO,MAAM,wBAAwB,EAAE,aAKtC,CAAC;AAgFF,eAAO,MAAM,8BAA8B,EAAE,aAK5C,CAAC;AA8DF,eAAO,MAAM,4BAA4B,EAAE,aAK1C,CAAC;AAKF,eAAO,MAAM,2BAA2B,EAAE,aAAa,EAItD,CAAC"}

package/dist/tools/llm/simple/background-powershell-tool.js

@@ -0,0 +1,302 @@
+import { spawn } from 'child_process';
+import { logger } from '../../../utils/logger.js';
+import { isNativeWindows, findNativePowerShellPath } from '../../../utils/platform-utils.js';
+class BackgroundPowerShellProcessManager {
+    processes = new Map();
+    nextId = 1;
+    start(command, cwd) {
+        const id = `ps-bg-${this.nextId++}`;
+        const workingDir = cwd || process.cwd();
+        const psPath = findNativePowerShellPath();
+        const child = spawn(psPath, ['-NoProfile', '-Command', command], {
+            cwd: workingDir,
+            env: { ...process.env },
+            detached: false,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const bgProcess = {
+            id,
+            command,
+            process: child,
+            startedAt: new Date(),
+            cwd: workingDir,
+            output: [],
+            maxOutputLines: 100,
+        };
+        child.stdout?.on('data', (data) => {
+            const lines = data.toString().split('\n').filter((l) => l.trim());
+            bgProcess.output.push(...lines);
+            if (bgProcess.output.length > bgProcess.maxOutputLines) {
+                bgProcess.output = bgProcess.output.slice(-bgProcess.maxOutputLines);
+            }
+        });
+        child.stderr?.on('data', (data) => {
+            const lines = data.toString().split('\n').filter((l) => l.trim());
+            bgProcess.output.push(...lines.map((l) => `[stderr] ${l}`));
+            if (bgProcess.output.length > bgProcess.maxOutputLines) {
+                bgProcess.output = bgProcess.output.slice(-bgProcess.maxOutputLines);
+            }
+        });
+        child.on('close', (code) => {
+            bgProcess.output.push(`[Process exited with code ${code}]`);
+        });
+        child.on('error', (error) => {
+            bgProcess.output.push(`[Error: ${error.message}]`);
+        });
+        this.processes.set(id, bgProcess);
+        return { id, pid: child.pid || 0 };
+    }
+    kill(id) {
+        const bgProcess = this.processes.get(id);
+        if (!bgProcess) {
+            return false;
+        }
+        try {
+            bgProcess.process.kill('SIGTERM');
+            setTimeout(() => {
+                if (!bgProcess.process.killed) {
+                    bgProcess.process.kill('SIGKILL');
+                }
+            }, 2000);
+            this.processes.delete(id);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    getStatus(id) {
+        const bgProcess = this.processes.get(id);
+        if (!bgProcess) {
+            return null;
+        }
+        return {
+            running: !bgProcess.process.killed && bgProcess.process.exitCode === null,
+            output: bgProcess.output.slice(-20),
+        };
+    }
+    list() {
+        return Array.from(this.processes.values()).map(p => ({
+            id: p.id,
+            command: p.command,
+            pid: p.process.pid || 0,
+            running: !p.process.killed && p.process.exitCode === null,
+            startedAt: p.startedAt,
+            cwd: p.cwd,
+        }));
+    }
+    killAll() {
+        let killed = 0;
+        for (const [id] of this.processes) {
+            if (this.kill(id)) {
+                killed++;
+            }
+        }
+        return killed;
+    }
+}
+export const backgroundPowerShellProcessManager = new BackgroundPowerShellProcessManager();
+const POWERSHELL_BACKGROUND_DEFINITION = {
+    type: 'function',
+    function: {
+        name: 'powershell_background',
+        description: `Start a PowerShell command in the background on Windows. Use this for long-running processes like:
+- npm run dev (development server)
+- npm start (application server)
+- python -m http.server (simple HTTP server)
+- docker-compose up
+
+The command will continue running after this tool returns.
+Use powershell_background_status to check output, or powershell_background_kill to stop it.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                reason: {
+                    type: 'string',
+                    description: 'Explanation of why you are running this in background',
+                },
+                command: {
+                    type: 'string',
+                    description: 'The PowerShell command to run in background',
+                },
+                cwd: {
+                    type: 'string',
+                    description: 'Working directory (optional)',
+                },
+            },
+            required: ['reason', 'command'],
+        },
+    },
+};
+async function executePowerShellBackground(args) {
+    const command = args['command'];
+    const cwd = args['cwd'];
+    logger.enter('powershellBackground.execute', { command, cwd });
+    if (!isNativeWindows()) {
+        return {
+            success: false,
+            error: 'powershell_background tool is only available on Native Windows. Use bash_background instead.',
+        };
+    }
+    try {
+        const { id, pid } = backgroundPowerShellProcessManager.start(command, cwd);
+        await new Promise(r => setTimeout(r, 1000));
+        const status = backgroundPowerShellProcessManager.getStatus(id);
+        const running = status?.running ?? false;
+        if (!running) {
+            const output = status?.output.join('\n') || '(no output)';
+            return {
+                success: false,
+                error: `Process failed to start or exited immediately.\nOutput:\n${output}`,
+            };
+        }
+        logger.exit('powershellBackground.execute', { id, pid });
+        return {
+            success: true,
+            result: `Background process started\nID: ${id}\nPID: ${pid}\nCommand: ${command}\n\nUse powershell_background_status with id="${id}" to check output.\nUse powershell_background_kill with id="${id}" to stop it.`,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: `Failed to start background process: ${errorMessage}`,
+        };
+    }
+}
+export const powershellBackgroundTool = {
+    definition: POWERSHELL_BACKGROUND_DEFINITION,
+    execute: executePowerShellBackground,
+    categories: ['llm-simple'],
+    description: 'Run PowerShell command in background',
+};
+const POWERSHELL_BACKGROUND_STATUS_DEFINITION = {
+    type: 'function',
+    function: {
+        name: 'powershell_background_status',
+        description: `Check the status and recent output of a background PowerShell process.
+Use this to see if a server started successfully or to check for errors.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                reason: {
+                    type: 'string',
+                    description: 'Explanation of why you are checking status',
+                },
+                id: {
+                    type: 'string',
+                    description: 'The process ID (e.g., "ps-bg-1") returned by powershell_background',
+                },
+            },
+            required: ['reason', 'id'],
+        },
+    },
+};
+async function executePowerShellBackgroundStatus(args) {
+    const id = args['id'];
+    if (!isNativeWindows()) {
+        return {
+            success: false,
+            error: 'powershell_background_status tool is only available on Native Windows.',
+        };
+    }
+    const status = backgroundPowerShellProcessManager.getStatus(id);
+    if (!status) {
+        if (!id || id === 'list') {
+            const processes = backgroundPowerShellProcessManager.list();
+            if (processes.length === 0) {
+                return {
+                    success: true,
+                    result: 'No background PowerShell processes running.',
+                };
+            }
+            const list = processes.map(p => {
+                const status = p.running ? 'running' : 'stopped';
+                return `- ${p.id}: ${p.command} (PID: ${p.pid}, ${status})`;
+            }).join('\n');
+            return {
+                success: true,
+                result: `Background PowerShell processes:\n${list}`,
+            };
+        }
+        return {
+            success: false,
+            error: `No background process found with ID: ${id}`,
+        };
+    }
+    const statusStr = status.running ? 'Running' : 'Stopped';
+    const output = status.output.length > 0
+        ? status.output.join('\n')
+        : '(no output yet)';
+    return {
+        success: true,
+        result: `Process ${id}:\nStatus: ${statusStr}\n\nRecent output:\n${output}`,
+    };
+}
+export const powershellBackgroundStatusTool = {
+    definition: POWERSHELL_BACKGROUND_STATUS_DEFINITION,
+    execute: executePowerShellBackgroundStatus,
+    categories: ['llm-simple'],
+    description: 'Check background PowerShell process status',
+};
+const POWERSHELL_BACKGROUND_KILL_DEFINITION = {
+    type: 'function',
+    function: {
+        name: 'powershell_background_kill',
+        description: `Stop a background PowerShell process.
+Use this to stop development servers, watchers, or other long-running processes.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                reason: {
+                    type: 'string',
+                    description: 'Explanation of why you are killing this process',
+                },
+                id: {
+                    type: 'string',
+                    description: 'The process ID (e.g., "ps-bg-1") to kill, or "all" to kill all background processes',
+                },
+            },
+            required: ['reason', 'id'],
+        },
+    },
+};
+async function executePowerShellBackgroundKill(args) {
+    const id = args['id'];
+    if (!isNativeWindows()) {
+        return {
+            success: false,
+            error: 'powershell_background_kill tool is only available on Native Windows.',
+        };
+    }
+    if (id === 'all') {
+        const killed = backgroundPowerShellProcessManager.killAll();
+        return {
+            success: true,
+            result: `Killed ${killed} background PowerShell process(es).`,
+        };
+    }
+    const success = backgroundPowerShellProcessManager.kill(id);
+    if (!success) {
+        return {
+            success: false,
+            error: `No background process found with ID: ${id}`,
+        };
+    }
+    return {
+        success: true,
+        result: `Background process ${id} has been killed.`,
+    };
+}
+export const powershellBackgroundKillTool = {
+    definition: POWERSHELL_BACKGROUND_KILL_DEFINITION,
+    execute: executePowerShellBackgroundKill,
+    categories: ['llm-simple'],
+    description: 'Kill background PowerShell process',
+};
+export const BACKGROUND_POWERSHELL_TOOLS = [
+    powershellBackgroundTool,
+    powershellBackgroundStatusTool,
+    powershellBackgroundKillTool,
+];
+//# sourceMappingURL=background-powershell-tool.js.map