smooth-ssh-mcp 0.1.1

package/dist/redaction.js

@@ -0,0 +1,64 @@
+const PATTERNS = [
+    {
+        name: "authorization-bearer",
+        regex: /\bAuthorization:\s*Bearer\s+[A-Za-z0-9._~+/=-]+/gi,
+        replace: "Authorization: Bearer [REDACTED]"
+    },
+    {
+        name: "password-assignment",
+        regex: /\b(password|passwd|secret|token|api[_-]?key)\b\s*[:=]\s*("[^"]*"|'[^']*'|\S+)/gi,
+        replace: (_match, key) => `${key}=[REDACTED]`
+    },
+    {
+        name: "private-key-block",
+        regex: /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g,
+        replace: "[REDACTED PRIVATE KEY]"
+    },
+    {
+        name: "private-key-incomplete",
+        regex: /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*$/g,
+        replace: "[REDACTED PRIVATE KEY]"
+    }
+];
+export function redactAndTruncate(text, maxBytes) {
+    const redactions = [];
+    let output = text;
+    for (const pattern of PATTERNS) {
+        let count = 0;
+        output = output.replace(pattern.regex, (...args) => {
+            count += 1;
+            if (typeof pattern.replace === "function") {
+                return pattern.replace(args[0], ...args.slice(1));
+            }
+            return pattern.replace;
+        });
+        if (count > 0) {
+            redactions.push({ pattern: pattern.name, count });
+        }
+    }
+    const originalBytes = Buffer.byteLength(output, "utf8");
+    if (originalBytes <= maxBytes) {
+        return { text: output, redactions, truncated: false, originalBytes };
+    }
+    return {
+        text: truncateUtf8(output, maxBytes),
+        redactions,
+        truncated: true,
+        originalBytes
+    };
+}
+function truncateUtf8(text, maxBytes) {
+    if (maxBytes <= 0)
+        return "";
+    let used = 0;
+    let result = "";
+    for (const char of text) {
+        const size = Buffer.byteLength(char, "utf8");
+        if (used + size > maxBytes)
+            break;
+        result += char;
+        used += size;
+    }
+    return result;
+}
+//# sourceMappingURL=redaction.js.map

package/dist/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AAQA,MAAM,QAAQ,GAAc;IAC1B;QACE,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,mDAAmD;QAC1D,OAAO,EAAE,kCAAkC;KAC5C;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,iFAAiF;QACxF,OAAO,EAAE,CAAC,MAAM,EAAE,GAAW,EAAE,EAAE,CAAC,GAAG,GAAG,aAAa;KACtD;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,6EAA6E;QACpF,OAAO,EAAE,wBAAwB;KAClC;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,6CAA6C;QACpD,OAAO,EAAE,wBAAwB;KAClC;CACF,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,QAAgB;IAC9D,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,IAAI,MAAM,GAAG,IAAI,CAAC;IAElB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE;YACjD,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC1C,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxD,IAAI,aAAa,IAAI,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IACvE,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC;QACpC,UAAU;QACV,SAAS,EAAE,IAAI;QACf,aAAa;KACd,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,QAAgB;IAClD,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,IAAI,GAAG,IAAI,GAAG,QAAQ;YAAE,MAAM;QAClC,MAAM,IAAI,IAAI,CAAC;QACf,IAAI,IAAI,IAAI,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,24 @@
+export type RunOptions = {
+    timeoutMs?: number;
+    input?: string;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    maxBufferBytes?: number;
+};
+export type RunResult = {
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+    startedAt: Date;
+    endedAt: Date;
+    durationMs: number;
+    timedOut: boolean;
+    stdoutTruncated?: boolean;
+    stderrTruncated?: boolean;
+};
+export type Runner = {
+    run(file: string, args: string[], options?: RunOptions): Promise<RunResult>;
+};
+export declare const nodeRunner: Runner;
+export declare function runProcess(file: string, args: string[], options?: RunOptions): Promise<RunResult>;

package/dist/runner.js

@@ -0,0 +1,90 @@
+import { spawn } from "node:child_process";
+export const nodeRunner = {
+    run(file, args, options = {}) {
+        return runProcess(file, args, options);
+    }
+};
+export function runProcess(file, args, options = {}) {
+    const startedAt = new Date();
+    return new Promise((resolve, reject) => {
+        const child = spawn(file, args, {
+            cwd: options.cwd,
+            env: options.env,
+            shell: false,
+            stdio: ["pipe", "pipe", "pipe"]
+        });
+        let stdout = "";
+        let stderr = "";
+        let stdoutTruncated = false;
+        let stderrTruncated = false;
+        let timedOut = false;
+        const maxBufferBytes = options.maxBufferBytes ?? 2 * 1024 * 1024;
+        const timeout = options.timeoutMs
+            ? setTimeout(() => {
+                timedOut = true;
+                child.kill("SIGTERM");
+                setTimeout(() => {
+                    if (!child.killed)
+                        child.kill("SIGKILL");
+                }, 1000).unref();
+            }, options.timeoutMs)
+            : undefined;
+        timeout?.unref();
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => {
+            const next = appendBounded(stdout, chunk, maxBufferBytes);
+            stdout = next.text;
+            stdoutTruncated ||= next.truncated;
+        });
+        child.stderr.on("data", (chunk) => {
+            const next = appendBounded(stderr, chunk, maxBufferBytes);
+            stderr = next.text;
+            stderrTruncated ||= next.truncated;
+        });
+        child.on("error", (error) => {
+            if (timeout)
+                clearTimeout(timeout);
+            reject(error);
+        });
+        child.on("close", (exitCode, signal) => {
+            if (timeout)
+                clearTimeout(timeout);
+            const endedAt = new Date();
+            resolve({
+                exitCode,
+                signal,
+                stdout,
+                stderr,
+                startedAt,
+                endedAt,
+                durationMs: endedAt.getTime() - startedAt.getTime(),
+                timedOut,
+                stdoutTruncated,
+                stderrTruncated
+            });
+        });
+        if (options.input)
+            child.stdin.write(options.input);
+        child.stdin.end();
+    });
+}
+function appendBounded(current, chunk, maxBytes) {
+    if (maxBytes <= 0)
+        return { text: "", truncated: true };
+    const combined = current + chunk;
+    if (Buffer.byteLength(combined, "utf8") <= maxBytes) {
+        return { text: combined, truncated: false };
+    }
+    let used = 0;
+    let text = "";
+    for (const char of combined) {
+        const size = Buffer.byteLength(char, "utf8");
+        if (used + size > maxBytes)
+            break;
+        text += char;
+        used += size;
+    }
+    return { text, truncated: true };
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+export declare function parseArgs(argv: string[]): {
+    mode: "serve" | "doctor" | "init" | "help" | "version";
+    configPath: string;
+    secretsPath?: string;
+    json: boolean;
+    force: boolean;
+};
+export declare function main(): Promise<void>;

package/dist/server.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+import { existsSync, realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { defaultInventoryPath, loadInventory } from "./inventory.js";
+import { createMcpServer } from "./mcpServer.js";
+import { formatDoctorReport, runDoctor } from "./doctor.js";
+import { formatInitReport, runInit } from "./init.js";
+import { JsonlAuditor } from "./audit.js";
+import { SshOperations } from "./operations.js";
+const VERSION = "0.1.1";
+export function parseArgs(argv) {
+    const mode = argv[0] === "--help" || argv[0] === "-h" ? "help" : argv[0] === "--version" || argv[0] === "-v" ? "version" : argv[0] === "doctor" ? "doctor" : argv[0] === "init" ? "init" : "serve";
+    const args = mode === "serve" ? argv : argv.slice(1);
+    const configIndex = args.findIndex((arg) => arg === "--config" || arg === "-c");
+    if (configIndex >= 0) {
+        const value = args[configIndex + 1];
+        if (!value)
+            throw new Error("--config requires a file path");
+        return { mode, configPath: value, secretsPath: parseOptionalValue(args, "--secrets"), json: args.includes("--json"), force: args.includes("--force") };
+    }
+    return { mode, configPath: defaultInventoryPath(), secretsPath: parseOptionalValue(args, "--secrets"), json: args.includes("--json"), force: args.includes("--force") };
+}
+function parseOptionalValue(argv, flag) {
+    const index = argv.findIndex((arg) => arg === flag);
+    if (index < 0)
+        return undefined;
+    const value = argv[index + 1];
+    if (!value)
+        throw new Error(`${flag} requires a file path`);
+    return value;
+}
+function formatHelp() {
+    return [
+        "smooth-ssh-mcp 0.1.1",
+        "",
+        "Usage:",
+        "  smooth-ssh-mcp [--config <hosts.yaml>]",
+        "  smooth-ssh-mcp init [--config <hosts.yaml>] [--secrets <secrets.env>] [--force] [--json]",
+        "  smooth-ssh-mcp doctor [--config <hosts.yaml>] [--secrets <secrets.env>] [--json]",
+        "",
+        "Options:",
+        "  -c, --config <path>  Host inventory path",
+        "  --secrets <path>     Secrets env file path for init and doctor",
+        "  --force              Regenerate init files even when they already exist",
+        "  --json               Print JSON for init and doctor",
+        "  -h, --help           Show this help",
+        "  -v, --version        Show version"
+    ].join("\n");
+}
+function loadInventoryForServer(configPath) {
+    const expanded = configPath.startsWith("~/")
+        ? `${process.env.HOME ?? ""}${configPath.slice(1)}`
+        : configPath;
+    if (!existsSync(expanded)) {
+        console.error(`[smooth-ssh-mcp] Inventory not found at ${configPath}. Starting with no hosts. ` +
+            "Create hosts.yaml or pass --config /path/to/hosts.yaml.");
+        return { hosts: [] };
+    }
+    return loadInventory(configPath);
+}
+export async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.mode === "help") {
+        console.log(formatHelp());
+        process.exit(0);
+    }
+    if (args.mode === "version") {
+        console.log(VERSION);
+        process.exit(0);
+    }
+    if (args.mode === "doctor") {
+        const report = runDoctor({ configPath: args.configPath, secretsPath: args.secretsPath });
+        console.log(args.json ? JSON.stringify(report, null, 2) : formatDoctorReport(report));
+        process.exit(report.ok ? 0 : 1);
+    }
+    if (args.mode === "init") {
+        const report = runInit({ configPath: args.configPath, secretsPath: args.secretsPath, force: args.force });
+        console.log(args.json ? JSON.stringify(report, null, 2) : formatInitReport(report));
+        process.exit(report.ok ? 0 : 1);
+    }
+    const { configPath } = args;
+    const inventory = loadInventoryForServer(configPath);
+    const operations = new SshOperations({ inventory });
+    installShutdownCleanup(operations);
+    const server = createMcpServer(operations, { auditor: new JsonlAuditor() });
+    process.stdin.resume();
+    await server.connect(new StdioServerTransport());
+    console.error(`[smooth-ssh-mcp] Running on stdio with ${inventory.hosts.length} configured hosts.`);
+    await keepStdioServerAlive();
+}
+function installShutdownCleanup(operations) {
+    let cleaned = false;
+    const cleanup = () => {
+        if (cleaned)
+            return;
+        cleaned = true;
+        operations.dispose();
+    };
+    process.once("beforeExit", cleanup);
+    for (const signal of ["SIGINT", "SIGTERM"]) {
+        process.once(signal, () => {
+            cleanup();
+            process.exit(0);
+        });
+    }
+}
+function keepStdioServerAlive() {
+    setInterval(() => undefined, 60_000);
+    return new Promise(() => undefined);
+}
+if (isDirectExecution()) {
+    main().catch((error) => {
+        console.error("[smooth-ssh-mcp] Fatal error:", error);
+        process.exit(1);
+    });
+}
+function isDirectExecution() {
+    const entryPath = process.argv[1];
+    if (!entryPath)
+        return false;
+    const currentPath = fileURLToPath(import.meta.url);
+    try {
+        return realpathSync(entryPath) === realpathSync(currentPath);
+    }
+    catch {
+        return entryPath === currentPath;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/sessionManager.d.ts

@@ -0,0 +1,77 @@
+import { EventEmitter } from "node:events";
+import type { Host } from "./types.js";
+type InputStreamLike = {
+    write?: (chunk: string) => unknown;
+    end?: () => unknown;
+};
+export type SpawnedSessionProcess = {
+    pid?: number;
+    stdout: EventEmitter;
+    stderr: EventEmitter;
+    stdin: InputStreamLike;
+    kill: (signal?: NodeJS.Signals) => unknown;
+    on: (event: string, listener: (...args: unknown[]) => void) => unknown;
+    unref?: () => unknown;
+};
+type SessionManagerOptions = {
+    controlDir: string;
+    maxSessions?: number;
+    outputBufferBytes?: number;
+    ttlSeconds?: number;
+    idleTimeoutSeconds?: number;
+    env?: NodeJS.ProcessEnv;
+    spawnProcess?: (file: string, args: string[], env?: NodeJS.ProcessEnv) => SpawnedSessionProcess;
+    spawnControlProcess?: (file: string, args: string[], env?: NodeJS.ProcessEnv) => SpawnedSessionProcess;
+};
+type SessionRecord = {
+    sessionId: string;
+    hostId: string;
+    host: Host;
+    pid?: number;
+    startedAt: number;
+    lastActiveAt: number;
+    state: "running" | "exited" | "error";
+    buffer: string;
+    truncated: boolean;
+    finalized: boolean;
+    process: SpawnedSessionProcess;
+    ttlSeconds: number;
+    idleTimeoutSeconds: number;
+    outputBufferBytes: number;
+};
+export type SessionInfo = Omit<SessionRecord, "buffer" | "finalized" | "host" | "process" | "startedAt" | "lastActiveAt"> & {
+    startedAt: string;
+    lastActiveAt: string;
+};
+export declare class SessionManager {
+    private readonly sessions;
+    private readonly maxSessions;
+    private readonly outputBufferBytes;
+    private readonly ttlSeconds;
+    private readonly idleTimeoutSeconds;
+    private readonly env;
+    private readonly spawnProcess;
+    private readonly spawnControlProcess;
+    constructor(options: SessionManagerOptions);
+    private readonly controlDir;
+    start(host: Host): SessionInfo;
+    send(sessionId: string, input: string): SessionInfo;
+    read(sessionId: string, maxBytes?: number): {
+        sessionId: string;
+        output: string;
+        truncated: boolean;
+        state: string;
+    };
+    hostForSession(sessionId: string): Host;
+    stop(sessionId: string): SessionInfo;
+    list(): SessionInfo[];
+    stopAll(): void;
+    getProcessForTest(sessionId: string): SpawnedSessionProcess;
+    private appendOutput;
+    private cleanupExpired;
+    private finalizeSession;
+    private closeControlMaster;
+    private requireSession;
+    private toInfo;
+}
+export {};

package/dist/sessionManager.js

@@ -0,0 +1,195 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { wrapWithPasswordAuth } from "./auth.js";
+import { buildSshArgs, buildSshControlArgs } from "./sshArgs.js";
+import { redactAndTruncate } from "./redaction.js";
+export class SessionManager {
+    sessions = new Map();
+    maxSessions;
+    outputBufferBytes;
+    ttlSeconds;
+    idleTimeoutSeconds;
+    env;
+    spawnProcess;
+    spawnControlProcess;
+    constructor(options) {
+        this.maxSessions = options.maxSessions ?? 8;
+        this.outputBufferBytes = options.outputBufferBytes ?? 64 * 1024;
+        this.ttlSeconds = options.ttlSeconds ?? 30 * 60;
+        this.idleTimeoutSeconds = options.idleTimeoutSeconds ?? 5 * 60;
+        this.env = options.env ?? process.env;
+        this.spawnProcess =
+            options.spawnProcess ??
+                ((file, args, env) => spawn(file, args, {
+                    env,
+                    shell: false,
+                    stdio: ["pipe", "pipe", "pipe"]
+                }));
+        this.spawnControlProcess =
+            options.spawnControlProcess ??
+                ((file, args, env) => spawn(file, args, {
+                    detached: true,
+                    env,
+                    shell: false,
+                    stdio: "ignore"
+                }));
+        this.controlDir = options.controlDir;
+    }
+    controlDir;
+    start(host) {
+        this.cleanupExpired();
+        if (this.sessions.size >= this.maxSessions) {
+            throw new Error(`Maximum active sessions reached: ${this.maxSessions}`);
+        }
+        const args = buildSshArgs(host, {
+            controlDir: this.controlDir,
+            forceTty: true,
+            batchMode: false
+        });
+        const commandSpec = wrapWithPasswordAuth(host, "ssh", args, this.env);
+        const child = this.spawnProcess(commandSpec.file, commandSpec.args, commandSpec.env);
+        const now = Date.now();
+        const record = {
+            sessionId: randomUUID(),
+            hostId: host.id,
+            host,
+            pid: child.pid,
+            startedAt: now,
+            lastActiveAt: now,
+            state: "running",
+            buffer: "",
+            truncated: false,
+            finalized: false,
+            process: child,
+            ttlSeconds: this.ttlSeconds,
+            idleTimeoutSeconds: this.idleTimeoutSeconds,
+            outputBufferBytes: this.outputBufferBytes
+        };
+        this.sessions.set(record.sessionId, record);
+        child.stdout.on("data", (chunk) => this.appendOutput(record, chunk));
+        child.stderr.on("data", (chunk) => this.appendOutput(record, chunk));
+        child.on("close", () => {
+            this.finalizeSession(record, { state: "exited", terminateProcess: false });
+        });
+        child.on("error", () => {
+            this.finalizeSession(record, { state: "error", terminateProcess: false });
+        });
+        return this.toInfo(record);
+    }
+    send(sessionId, input) {
+        const record = this.requireSession(sessionId);
+        if (record.state !== "running")
+            throw new Error(`Session is not running: ${sessionId}`);
+        record.process.stdin.write?.(input);
+        record.lastActiveAt = Date.now();
+        return this.toInfo(record);
+    }
+    read(sessionId, maxBytes) {
+        const record = this.requireSession(sessionId);
+        record.lastActiveAt = Date.now();
+        const limit = maxBytes ?? record.outputBufferBytes;
+        const redacted = redactAndTruncate(record.buffer, limit);
+        const truncated = record.truncated || redacted.truncated;
+        record.buffer = "";
+        record.truncated = false;
+        return {
+            sessionId,
+            output: redacted.text,
+            truncated,
+            state: record.state
+        };
+    }
+    hostForSession(sessionId) {
+        return this.requireSession(sessionId).host;
+    }
+    stop(sessionId) {
+        const record = this.requireSession(sessionId);
+        return this.finalizeSession(record, { state: "exited", terminateProcess: true });
+    }
+    list() {
+        this.cleanupExpired();
+        return [...this.sessions.values()].map((record) => this.toInfo(record));
+    }
+    stopAll() {
+        for (const record of [...this.sessions.values()]) {
+            this.finalizeSession(record, { state: "exited", terminateProcess: true });
+        }
+    }
+    getProcessForTest(sessionId) {
+        return this.requireSession(sessionId).process;
+    }
+    appendOutput(record, chunk) {
+        record.lastActiveAt = Date.now();
+        record.buffer += Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk);
+        while (Buffer.byteLength(record.buffer, "utf8") > record.outputBufferBytes) {
+            record.buffer = record.buffer.slice(1);
+            record.truncated = true;
+        }
+    }
+    cleanupExpired() {
+        const now = Date.now();
+        for (const [sessionId, record] of this.sessions) {
+            const ttlExpired = now - record.startedAt > record.ttlSeconds * 1000;
+            const idleExpired = now - record.lastActiveAt > record.idleTimeoutSeconds * 1000;
+            if (ttlExpired || idleExpired) {
+                this.finalizeSession(record, { state: "exited", terminateProcess: true });
+            }
+        }
+    }
+    finalizeSession(record, options) {
+        if (!record.finalized) {
+            record.finalized = true;
+            if (options.terminateProcess) {
+                record.process.stdin.end?.();
+                record.process.kill("SIGTERM");
+                forceKillLater(record.process);
+            }
+            this.closeControlMaster(record.host);
+        }
+        record.state = options.state;
+        record.lastActiveAt = Date.now();
+        this.sessions.delete(record.sessionId);
+        return this.toInfo(record);
+    }
+    closeControlMaster(host) {
+        const args = buildSshControlArgs(host, {
+            controlDir: this.controlDir,
+            controlCommand: "exit"
+        });
+        try {
+            const child = this.spawnControlProcess("ssh", args, this.env);
+            child.on("error", () => undefined);
+            child.unref?.();
+        }
+        catch {
+            // Best-effort cleanup only; a missing or already-closed control socket is fine.
+        }
+    }
+    requireSession(sessionId) {
+        this.cleanupExpired();
+        const record = this.sessions.get(sessionId);
+        if (!record)
+            throw new Error(`Session not found: ${sessionId}`);
+        return record;
+    }
+    toInfo(record) {
+        return {
+            sessionId: record.sessionId,
+            hostId: record.hostId,
+            pid: record.pid,
+            startedAt: new Date(record.startedAt).toISOString(),
+            lastActiveAt: new Date(record.lastActiveAt).toISOString(),
+            state: record.state,
+            truncated: record.truncated,
+            ttlSeconds: record.ttlSeconds,
+            idleTimeoutSeconds: record.idleTimeoutSeconds,
+            outputBufferBytes: record.outputBufferBytes
+        };
+    }
+}
+function forceKillLater(process) {
+    setTimeout(() => {
+        process.kill("SIGKILL");
+    }, 1000).unref();
+}
+//# sourceMappingURL=sessionManager.js.map

package/dist/sessionManager.js.map

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

package/dist/sshArgs.d.ts

@@ -0,0 +1,24 @@
+import type { Host } from "./types.js";
+type SshArgOptions = {
+    controlDir: string;
+    command?: string;
+    timeoutSeconds?: number;
+    forceTty?: boolean;
+    batchMode?: boolean;
+};
+type ScpArgOptions = {
+    controlDir: string;
+    direction: "upload" | "download";
+    localPath: string;
+    remotePath: string;
+};
+type SshControlOptions = {
+    controlDir: string;
+    controlCommand: "check" | "exit" | "stop";
+};
+export declare function buildSshArgs(host: Host, options: SshArgOptions): string[];
+export declare function buildSshControlArgs(host: Host, options: SshControlOptions): string[];
+export declare function buildScpArgs(host: Host, options: ScpArgOptions): string[];
+export declare function controlPathForHost(host: Host, controlDir: string): string;
+export declare function targetForHost(host: Host): string;
+export {};