winhelm-mcp 1.1.0

package/dist/engine/task-manager.js

@@ -0,0 +1,203 @@
+import { spawn, execSync } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { ConfigManager } from "../config/config-manager.js";
+import { logger } from "../utils/logger.js";
+import { getPowerShellExecutable } from "./powershell-runner.js";
+export class TaskManager {
+    static instance = null;
+    tasks = new Map();
+    maxBufferLines = 1000;
+    maxRetainedTasks = 50;
+    constructor() { }
+    static getInstance() {
+        if (!TaskManager.instance) {
+            TaskManager.instance = new TaskManager();
+        }
+        return TaskManager.instance;
+    }
+    /**
+     * Start a command as a long-running background task
+     */
+    startTask(command, cwd = process.cwd()) {
+        const configManager = ConfigManager.getInstance();
+        // 1. Security Check
+        const check = configManager.isCommandAllowed(command);
+        if (!check.allowed) {
+            const reason = check.reason || "Command blocked by security policy";
+            logger.security(reason, command);
+            throw new Error(reason);
+        }
+        // 2. Validate CWD against allowedDirectories
+        const cwdCheck = configManager.isPathAllowed(cwd);
+        const config = configManager.getConfig();
+        if (!cwdCheck.allowed && config.allowSystemExecution === false) {
+            const reason = cwdCheck.reason || `Working directory "${cwd}" is not permitted`;
+            logger.security(reason, command);
+            throw new Error(reason);
+        }
+        const taskId = randomUUID().slice(0, 8);
+        const utf8Setup = "[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new(); " +
+            "[Console]::InputEncoding = [System.Text.UTF8Encoding]::new(); " +
+            "$OutputEncoding = [System.Text.UTF8Encoding]::new(); ";
+        const fullCommand = utf8Setup + command;
+        const preferPwsh = config.preferPwsh !== false;
+        const executable = getPowerShellExecutable(preferPwsh);
+        const child = spawn(executable, ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-Command", fullCommand], {
+            cwd,
+            windowsHide: true,
+            env: { ...process.env, PYTHONIOENCODING: "utf-8" },
+        });
+        const task = {
+            id: taskId,
+            command,
+            cwd,
+            pid: child.pid,
+            startTime: new Date().toISOString(),
+            status: "running",
+            outputBuffer: [],
+            process: child,
+        };
+        const appendOutput = (chunk) => {
+            const lines = chunk.toString("utf-8").split(/\r?\n/);
+            for (const line of lines) {
+                if (!line && lines.length === 1)
+                    continue;
+                task.outputBuffer.push(line);
+                if (task.outputBuffer.length > this.maxBufferLines) {
+                    task.outputBuffer.shift();
+                }
+            }
+        };
+        child.stdout?.on("data", appendOutput);
+        child.stderr?.on("data", appendOutput);
+        child.on("close", (code) => {
+            task.endTime = new Date().toISOString();
+            task.exitCode = code;
+            if (task.status === "running") {
+                task.status = code === 0 ? "completed" : "failed";
+            }
+            logger.info(`Background task [${taskId}] exited`, `Exit code: ${code}`);
+        });
+        child.on("error", (err) => {
+            task.endTime = new Date().toISOString();
+            task.status = "failed";
+            task.outputBuffer.push(`[Process Error]: ${err.message}`);
+            logger.error(`Background task [${taskId}] error`, err.message);
+        });
+        this.tasks.set(taskId, task);
+        // Prune oldest completed tasks if exceeding retention limit
+        if (this.tasks.size > this.maxRetainedTasks) {
+            for (const [id, t] of this.tasks.entries()) {
+                if (t.status !== "running") {
+                    this.tasks.delete(id);
+                    break;
+                }
+            }
+        }
+        logger.info(`Background task started [${taskId}]`, `PID: ${child.pid} | Command: ${command}`);
+        return {
+            id: task.id,
+            command: task.command,
+            cwd: task.cwd,
+            pid: task.pid,
+            startTime: task.startTime,
+            status: task.status,
+            outputLinesCount: 0,
+        };
+    }
+    /**
+     * List all background tasks
+     */
+    listTasks() {
+        return Array.from(this.tasks.values()).map((t) => ({
+            id: t.id,
+            command: t.command,
+            cwd: t.cwd,
+            pid: t.pid,
+            startTime: t.startTime,
+            endTime: t.endTime,
+            status: t.status,
+            exitCode: t.exitCode,
+            outputLinesCount: t.outputBuffer.length,
+        }));
+    }
+    /**
+     * Get buffered logs for a task
+     */
+    getTaskLogs(taskId, tailLines = 100) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new Error(`Background task "${taskId}" not found`);
+        }
+        const sliced = task.outputBuffer.slice(-tailLines);
+        return {
+            logs: sliced.join("\n"),
+            task: {
+                id: task.id,
+                command: task.command,
+                cwd: task.cwd,
+                pid: task.pid,
+                startTime: task.startTime,
+                endTime: task.endTime,
+                status: task.status,
+                exitCode: task.exitCode,
+                outputLinesCount: task.outputBuffer.length,
+            },
+        };
+    }
+    /**
+     * Send text to standard input of a running background task
+     */
+    sendInput(taskId, input) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new Error(`Background task "${taskId}" not found`);
+        }
+        if (task.status !== "running" || !task.process || !task.process.stdin) {
+            throw new Error(`Task "${taskId}" is not currently running (status: ${task.status})`);
+        }
+        task.process.stdin.write(input + "\n");
+        return { success: true };
+    }
+    terminateProcess(task) {
+        if (!task.process || task.status !== "running")
+            return;
+        task.status = "killed";
+        if (task.pid && process.platform === "win32") {
+            try {
+                execSync(`taskkill /pid ${task.pid} /T /F`, { stdio: "ignore" });
+                return;
+            }
+            catch {
+                // Fallback to standard process kill
+            }
+        }
+        try {
+            task.process.kill("SIGKILL");
+        }
+        catch {
+            // process might already be dead
+        }
+    }
+    /**
+     * Terminate a background task
+     */
+    killTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task) {
+            throw new Error(`Background task "${taskId}" not found`);
+        }
+        this.terminateProcess(task);
+        return { success: true };
+    }
+    /**
+     * Terminate all background tasks on server shutdown
+     */
+    killAll() {
+        for (const task of this.tasks.values()) {
+            this.terminateProcess(task);
+        }
+    }
+}
+export const taskManager = TaskManager.getInstance();
+//# sourceMappingURL=task-manager.js.map

package/dist/engine/task-manager.js.map

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

package/dist/gateway/dashboard-html.d.ts

@@ -0,0 +1,7 @@
+import { type ToolProfile } from "../config/profiles.js";
+/**
+ * Lightweight, zero-dependency, self-contained Web Monitor Dashboard for WinHelm.
+ * Served directly by Express without external CDN dependencies.
+ */
+export declare function getDashboardHtml(activeProfile?: ToolProfile): string;
+//# sourceMappingURL=dashboard-html.d.ts.map

package/dist/gateway/dashboard-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-html.d.ts","sourceRoot":"","sources":["../../src/gateway/dashboard-html.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,GAAE,WAAoB,GAAG,MAAM,CA4mB5E"}