@paretools/remote 0.11.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dave London
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerAllTools } from "./tools/index.js";
+const server = new McpServer({ name: "@paretools/remote", version: "0.1.0" }, {
+    instructions: "Structured remote operations (SSH, rsync). Run commands on remote hosts, test connectivity, scan host keys, and sync files. Returns typed JSON.",
+});
+registerAllTools(server);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC/C;IACE,YAAY,EACV,iJAAiJ;CACpJ,CACF,CAAC;AAEF,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAEzB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/lib/formatters.d.ts

@@ -0,0 +1,59 @@
+import type { SshRunResult, SshTestResult, SshKeyscanResult, RsyncResult } from "../schemas/index.js";
+/** Formats structured ssh run results into human-readable output. */
+export declare function formatSshRun(data: SshRunResult): string;
+/** Formats structured ssh test results into human-readable output. */
+export declare function formatSshTest(data: SshTestResult): string;
+/** Formats structured ssh-keyscan results into human-readable output. */
+export declare function formatSshKeyscan(data: SshKeyscanResult): string;
+/** Formats structured rsync results into human-readable output. */
+export declare function formatRsync(data: RsyncResult): string;
+/** Compact ssh run: drop stdout/stderr. */
+export interface SshRunCompact {
+    [key: string]: unknown;
+    host: string;
+    user?: string;
+    command: string;
+    success: boolean;
+    exitCode: number;
+    duration: number;
+    timedOut: boolean;
+}
+export declare function compactSshRunMap(data: SshRunResult): SshRunCompact;
+export declare function formatSshRunCompact(data: SshRunCompact): string;
+/** Compact ssh test: minimal connectivity info. */
+export interface SshTestCompact {
+    [key: string]: unknown;
+    host: string;
+    user?: string;
+    reachable: boolean;
+    duration: number;
+}
+export declare function compactSshTestMap(data: SshTestResult): SshTestCompact;
+export declare function formatSshTestCompact(data: SshTestCompact): string;
+/** Compact keyscan: key count only. */
+export interface SshKeyscanCompact {
+    [key: string]: unknown;
+    host: string;
+    keyCount: number;
+    keyTypes: string[];
+    success: boolean;
+}
+export declare function compactSshKeyscanMap(data: SshKeyscanResult): SshKeyscanCompact;
+export declare function formatSshKeyscanCompact(data: SshKeyscanCompact): string;
+/** Compact rsync: drop stdout/stderr, keep stats. */
+export interface RsyncCompact {
+    [key: string]: unknown;
+    source: string;
+    destination: string;
+    dryRun: boolean;
+    success: boolean;
+    exitCode: number;
+    filesTransferred?: number;
+    totalSize?: string;
+    speedup?: string;
+    duration: number;
+    timedOut: boolean;
+}
+export declare function compactRsyncMap(data: RsyncResult): RsyncCompact;
+export declare function formatRsyncCompact(data: RsyncCompact): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/lib/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/lib/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAI7B,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAevD;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAYzD;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAa/D;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAoBrD;AAID,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,CAUlE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAO/D;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAOrE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAKjE;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAO9E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAGvE;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CAa/D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAU7D"}

package/dist/lib/formatters.js

@@ -0,0 +1,153 @@
+// ── Full formatters ──────────────────────────────────────────────────
+/** Formats structured ssh run results into human-readable output. */
+export function formatSshRun(data) {
+    const lines = [];
+    const target = data.user ? `${data.user}@${data.host}` : data.host;
+    if (data.timedOut) {
+        lines.push(`ssh ${target}: TIMED OUT after ${data.duration}ms (exit code ${data.exitCode}).`);
+    }
+    else if (data.success) {
+        lines.push(`ssh ${target}: success (${data.duration}ms).`);
+    }
+    else {
+        lines.push(`ssh ${target}: exit code ${data.exitCode} (${data.duration}ms).`);
+    }
+    lines.push(`command: ${data.command}`);
+    if (data.stdout)
+        lines.push(data.stdout);
+    if (data.stderr)
+        lines.push(data.stderr);
+    return lines.join("\n");
+}
+/** Formats structured ssh test results into human-readable output. */
+export function formatSshTest(data) {
+    const lines = [];
+    const target = data.user ? `${data.user}@${data.host}` : data.host;
+    if (data.reachable) {
+        lines.push(`ssh ${target}: reachable (${data.duration}ms).`);
+    }
+    else {
+        lines.push(`ssh ${target}: unreachable (exit code ${data.exitCode}, ${data.duration}ms).`);
+    }
+    if (data.banner)
+        lines.push(`banner: ${data.banner}`);
+    if (data.error)
+        lines.push(`error: ${data.error}`);
+    return lines.join("\n");
+}
+/** Formats structured ssh-keyscan results into human-readable output. */
+export function formatSshKeyscan(data) {
+    const lines = [];
+    if (data.success) {
+        lines.push(`ssh-keyscan ${data.host}: ${data.keys.length} keys found.`);
+    }
+    else {
+        lines.push(`ssh-keyscan ${data.host}: failed.`);
+    }
+    for (const key of data.keys) {
+        lines.push(`  ${key.keyType}: ${key.key.substring(0, 40)}...`);
+    }
+    if (data.error)
+        lines.push(`error: ${data.error}`);
+    return lines.join("\n");
+}
+/** Formats structured rsync results into human-readable output. */
+export function formatRsync(data) {
+    const lines = [];
+    const mode = data.dryRun ? " (dry-run)" : "";
+    if (data.timedOut) {
+        lines.push(`rsync${mode}: TIMED OUT after ${data.duration}ms (exit code ${data.exitCode}).`);
+    }
+    else if (data.success) {
+        lines.push(`rsync${mode}: success (${data.duration}ms).`);
+    }
+    else {
+        lines.push(`rsync${mode}: exit code ${data.exitCode} (${data.duration}ms).`);
+    }
+    lines.push(`source: ${data.source}`);
+    lines.push(`destination: ${data.destination}`);
+    if (data.filesTransferred !== undefined)
+        lines.push(`files transferred: ${data.filesTransferred}`);
+    if (data.totalSize)
+        lines.push(`total size: ${data.totalSize}`);
+    if (data.speedup)
+        lines.push(`speedup: ${data.speedup}`);
+    if (data.stdout)
+        lines.push(data.stdout);
+    if (data.stderr)
+        lines.push(data.stderr);
+    return lines.join("\n");
+}
+export function compactSshRunMap(data) {
+    return {
+        host: data.host,
+        user: data.user,
+        command: data.command,
+        success: data.success,
+        exitCode: data.exitCode,
+        duration: data.duration,
+        timedOut: data.timedOut,
+    };
+}
+export function formatSshRunCompact(data) {
+    const target = data.user ? `${data.user}@${data.host}` : data.host;
+    if (data.timedOut) {
+        return `ssh ${target}: TIMED OUT after ${data.duration}ms (exit code ${data.exitCode}).`;
+    }
+    if (data.success)
+        return `ssh ${target}: success (${data.duration}ms).`;
+    return `ssh ${target}: exit code ${data.exitCode} (${data.duration}ms).`;
+}
+export function compactSshTestMap(data) {
+    return {
+        host: data.host,
+        user: data.user,
+        reachable: data.reachable,
+        duration: data.duration,
+    };
+}
+export function formatSshTestCompact(data) {
+    const target = data.user ? `${data.user}@${data.host}` : data.host;
+    return data.reachable
+        ? `ssh ${target}: reachable (${data.duration}ms).`
+        : `ssh ${target}: unreachable (${data.duration}ms).`;
+}
+export function compactSshKeyscanMap(data) {
+    return {
+        host: data.host,
+        keyCount: data.keys.length,
+        keyTypes: data.keys.map((k) => k.keyType),
+        success: data.success,
+    };
+}
+export function formatSshKeyscanCompact(data) {
+    if (!data.success)
+        return `ssh-keyscan ${data.host}: failed.`;
+    return `ssh-keyscan ${data.host}: ${data.keyCount} keys (${data.keyTypes.join(", ")}).`;
+}
+export function compactRsyncMap(data) {
+    return {
+        source: data.source,
+        destination: data.destination,
+        dryRun: data.dryRun,
+        success: data.success,
+        exitCode: data.exitCode,
+        filesTransferred: data.filesTransferred,
+        totalSize: data.totalSize,
+        speedup: data.speedup,
+        duration: data.duration,
+        timedOut: data.timedOut,
+    };
+}
+export function formatRsyncCompact(data) {
+    const mode = data.dryRun ? " (dry-run)" : "";
+    if (data.timedOut) {
+        return `rsync${mode}: TIMED OUT after ${data.duration}ms.`;
+    }
+    if (data.success) {
+        const stats = data.filesTransferred !== undefined ? `, ${data.filesTransferred} files` : "";
+        return `rsync${mode}: success (${data.duration}ms${stats}).`;
+    }
+    return `rsync${mode}: exit code ${data.exitCode} (${data.duration}ms).`;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/lib/formatters.js.map

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

package/dist/lib/parsers.d.ts

@@ -0,0 +1,35 @@
+import type { SshRunResult, SshTestResult, SshKeyscanResult, RsyncResult } from "../schemas/index.js";
+/**
+ * Parses the output of an ssh remote command execution into structured data.
+ */
+export declare function parseSshRunOutput(host: string, user: string | undefined, command: string, stdout: string, stderr: string, exitCode: number, duration: number, timedOut?: boolean): SshRunResult;
+/**
+ * Parses the output of an ssh connectivity test into structured data.
+ */
+export declare function parseSshTestOutput(host: string, user: string | undefined, stdout: string, stderr: string, exitCode: number, duration: number): SshTestResult;
+/**
+ * Parses the output of ssh-keyscan into structured host key data.
+ *
+ * Expected format (one key per line):
+ * ```
+ * github.com ssh-ed25519 AAAAC3Nza...
+ * github.com ssh-rsa AAAAB3Nza...
+ * ```
+ *
+ * Comment lines starting with # are ignored.
+ */
+export declare function parseSshKeyscanOutput(host: string, stdout: string, stderr: string, exitCode: number): SshKeyscanResult;
+/**
+ * Parses the output of rsync into structured transfer data.
+ *
+ * When run with --stats, rsync outputs lines like:
+ * ```
+ * Number of files: 10
+ * Number of regular files transferred: 3
+ * Total file size: 1,234 bytes
+ * ...
+ * speedup is 1.23
+ * ```
+ */
+export declare function parseRsyncOutput(source: string, destination: string, dryRun: boolean, stdout: string, stderr: string, exitCode: number, duration: number, timedOut?: boolean): RsyncResult;
+//# sourceMappingURL=parsers.d.ts.map

package/dist/lib/parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../src/lib/parsers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAI7B;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,OAAe,GACxB,YAAY,CAYd;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,aAAa,CAcf;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,gBAAgB,CA0BlB;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,OAAe,GACxB,WAAW,CAuCb"}

package/dist/lib/parsers.js

@@ -0,0 +1,120 @@
+// ── SSH Run ─────────────────────────────────────────────────────────────
+/**
+ * Parses the output of an ssh remote command execution into structured data.
+ */
+export function parseSshRunOutput(host, user, command, stdout, stderr, exitCode, duration, timedOut = false) {
+    return {
+        host,
+        user: user || undefined,
+        command,
+        success: exitCode === 0 && !timedOut,
+        exitCode,
+        stdout: stdout.trimEnd() || undefined,
+        stderr: stderr.trimEnd() || undefined,
+        duration,
+        timedOut,
+    };
+}
+// ── SSH Test ────────────────────────────────────────────────────────────
+/**
+ * Parses the output of an ssh connectivity test into structured data.
+ */
+export function parseSshTestOutput(host, user, stdout, stderr, exitCode, duration) {
+    // ssh -T often writes the banner to stderr
+    const combined = (stdout + "\n" + stderr).trim();
+    const banner = combined || undefined;
+    return {
+        host,
+        user: user || undefined,
+        reachable: exitCode === 0,
+        exitCode,
+        banner,
+        error: exitCode !== 0 ? stderr.trimEnd() || undefined : undefined,
+        duration,
+    };
+}
+// ── SSH Keyscan ─────────────────────────────────────────────────────────
+/**
+ * Parses the output of ssh-keyscan into structured host key data.
+ *
+ * Expected format (one key per line):
+ * ```
+ * github.com ssh-ed25519 AAAAC3Nza...
+ * github.com ssh-rsa AAAAB3Nza...
+ * ```
+ *
+ * Comment lines starting with # are ignored.
+ */
+export function parseSshKeyscanOutput(host, stdout, stderr, exitCode) {
+    const keys = [];
+    for (const line of stdout.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        // Format: hostname keytype key
+        const parts = trimmed.split(/\s+/, 3);
+        if (parts.length === 3) {
+            keys.push({
+                host: parts[0],
+                keyType: parts[1],
+                key: parts[2],
+            });
+        }
+    }
+    const hasError = exitCode !== 0 || (keys.length === 0 && stderr.trim().length > 0);
+    return {
+        host,
+        keys,
+        error: hasError ? stderr.trimEnd() || undefined : undefined,
+        success: keys.length > 0,
+    };
+}
+// ── Rsync ───────────────────────────────────────────────────────────────
+/**
+ * Parses the output of rsync into structured transfer data.
+ *
+ * When run with --stats, rsync outputs lines like:
+ * ```
+ * Number of files: 10
+ * Number of regular files transferred: 3
+ * Total file size: 1,234 bytes
+ * ...
+ * speedup is 1.23
+ * ```
+ */
+export function parseRsyncOutput(source, destination, dryRun, stdout, stderr, exitCode, duration, timedOut = false) {
+    let filesTransferred;
+    let totalSize;
+    let speedup;
+    // Parse --stats output
+    for (const line of stdout.split("\n")) {
+        const trimmed = line.trim();
+        const transferMatch = trimmed.match(/^Number of (?:regular )?files transferred:\s*([\d,]+)/i);
+        if (transferMatch) {
+            filesTransferred = parseInt(transferMatch[1].replace(/,/g, ""), 10);
+        }
+        const sizeMatch = trimmed.match(/^Total file size:\s*(.+?)(?:\s+bytes)?$/i);
+        if (sizeMatch) {
+            totalSize = sizeMatch[1].trim();
+        }
+        const speedupMatch = trimmed.match(/speedup is\s+([\d.]+)/i);
+        if (speedupMatch) {
+            speedup = speedupMatch[1];
+        }
+    }
+    return {
+        source,
+        destination,
+        dryRun,
+        success: exitCode === 0 && !timedOut,
+        exitCode,
+        filesTransferred,
+        totalSize,
+        speedup,
+        stdout: stdout.trimEnd() || undefined,
+        stderr: stderr.trimEnd() || undefined,
+        duration,
+        timedOut,
+    };
+}
+//# sourceMappingURL=parsers.js.map

package/dist/lib/parsers.js.map

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

package/dist/lib/remote-runner.d.ts

@@ -0,0 +1,8 @@
+import { type RunResult } from "@paretools/shared";
+/** Runs an `ssh` command with the given arguments. */
+export declare function sshCmd(args: string[], cwd?: string): Promise<RunResult>;
+/** Runs an `ssh-keyscan` command with the given arguments. */
+export declare function sshKeyscanCmd(args: string[], cwd?: string): Promise<RunResult>;
+/** Runs an `rsync` command with the given arguments. */
+export declare function rsyncCmd(args: string[], cwd?: string): Promise<RunResult>;
+//# sourceMappingURL=remote-runner.d.ts.map

package/dist/lib/remote-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-runner.d.ts","sourceRoot":"","sources":["../../src/lib/remote-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAExD,sDAAsD;AACtD,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAE7E;AAED,8DAA8D;AAC9D,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAEpF;AAED,wDAAwD;AACxD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAE/E"}

package/dist/lib/remote-runner.js

@@ -0,0 +1,14 @@
+import { run } from "@paretools/shared";
+/** Runs an `ssh` command with the given arguments. */
+export async function sshCmd(args, cwd) {
+    return run("ssh", args, { cwd, timeout: 300_000 });
+}
+/** Runs an `ssh-keyscan` command with the given arguments. */
+export async function sshKeyscanCmd(args, cwd) {
+    return run("ssh-keyscan", args, { cwd, timeout: 60_000 });
+}
+/** Runs an `rsync` command with the given arguments. */
+export async function rsyncCmd(args, cwd) {
+    return run("rsync", args, { cwd, timeout: 300_000 });
+}
+//# sourceMappingURL=remote-runner.js.map

package/dist/lib/remote-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-runner.js","sourceRoot":"","sources":["../../src/lib/remote-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAkB,MAAM,mBAAmB,CAAC;AAExD,sDAAsD;AACtD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc,EAAE,GAAY;IACvD,OAAO,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc,EAAE,GAAY;IAC9D,OAAO,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAc,EAAE,GAAY;IACzD,OAAO,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/dist/schemas/index.d.ts

@@ -0,0 +1,60 @@
+import { z } from "zod";
+/** Zod schema for structured ssh command execution output. */
+export declare const SshRunResultSchema: z.ZodObject<{
+    host: z.ZodString;
+    user: z.ZodOptional<z.ZodString>;
+    command: z.ZodString;
+    success: z.ZodBoolean;
+    exitCode: z.ZodNumber;
+    stdout: z.ZodOptional<z.ZodString>;
+    stderr: z.ZodOptional<z.ZodString>;
+    duration: z.ZodNumber;
+    timedOut: z.ZodBoolean;
+}, z.core.$strip>;
+export type SshRunResult = z.infer<typeof SshRunResultSchema>;
+/** Zod schema for structured ssh connectivity test output. */
+export declare const SshTestResultSchema: z.ZodObject<{
+    host: z.ZodString;
+    user: z.ZodOptional<z.ZodString>;
+    reachable: z.ZodBoolean;
+    exitCode: z.ZodNumber;
+    banner: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    duration: z.ZodNumber;
+}, z.core.$strip>;
+export type SshTestResult = z.infer<typeof SshTestResultSchema>;
+/** Zod schema for a single host key entry. */
+export declare const HostKeySchema: z.ZodObject<{
+    host: z.ZodString;
+    keyType: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strip>;
+/** Zod schema for structured ssh-keyscan output. */
+export declare const SshKeyscanResultSchema: z.ZodObject<{
+    host: z.ZodString;
+    keys: z.ZodArray<z.ZodObject<{
+        host: z.ZodString;
+        keyType: z.ZodString;
+        key: z.ZodString;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+export type SshKeyscanResult = z.infer<typeof SshKeyscanResultSchema>;
+/** Zod schema for structured rsync transfer output. */
+export declare const RsyncResultSchema: z.ZodObject<{
+    source: z.ZodString;
+    destination: z.ZodString;
+    dryRun: z.ZodBoolean;
+    success: z.ZodBoolean;
+    exitCode: z.ZodNumber;
+    filesTransferred: z.ZodOptional<z.ZodNumber>;
+    totalSize: z.ZodOptional<z.ZodString>;
+    speedup: z.ZodOptional<z.ZodString>;
+    stdout: z.ZodOptional<z.ZodString>;
+    stderr: z.ZodOptional<z.ZodString>;
+    duration: z.ZodNumber;
+    timedOut: z.ZodBoolean;
+}, z.core.$strip>;
+export type RsyncResult = z.infer<typeof RsyncResultSchema>;
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB;;;;;;;;;;iBAU7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB;;;;;;;;iBAQ9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,8CAA8C;AAC9C,eAAO,MAAM,aAAa;;;;iBAIxB,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,sBAAsB;;;;;;;;;iBAKjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,uDAAuD;AACvD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAa5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+// ── SSH Run ─────────────────────────────────────────────────────────────
+/** Zod schema for structured ssh command execution output. */
+export const SshRunResultSchema = z.object({
+    host: z.string(),
+    user: z.string().optional(),
+    command: z.string(),
+    success: z.boolean(),
+    exitCode: z.number(),
+    stdout: z.string().optional(),
+    stderr: z.string().optional(),
+    duration: z.number(),
+    timedOut: z.boolean(),
+});
+// ── SSH Test ────────────────────────────────────────────────────────────
+/** Zod schema for structured ssh connectivity test output. */
+export const SshTestResultSchema = z.object({
+    host: z.string(),
+    user: z.string().optional(),
+    reachable: z.boolean(),
+    exitCode: z.number(),
+    banner: z.string().optional(),
+    error: z.string().optional(),
+    duration: z.number(),
+});
+// ── SSH Keyscan ─────────────────────────────────────────────────────────
+/** Zod schema for a single host key entry. */
+export const HostKeySchema = z.object({
+    host: z.string(),
+    keyType: z.string(),
+    key: z.string(),
+});
+/** Zod schema for structured ssh-keyscan output. */
+export const SshKeyscanResultSchema = z.object({
+    host: z.string(),
+    keys: z.array(HostKeySchema),
+    error: z.string().optional(),
+    success: z.boolean(),
+});
+// ── Rsync ───────────────────────────────────────────────────────────────
+/** Zod schema for structured rsync transfer output. */
+export const RsyncResultSchema = z.object({
+    source: z.string(),
+    destination: z.string(),
+    dryRun: z.boolean(),
+    success: z.boolean(),
+    exitCode: z.number(),
+    filesTransferred: z.number().optional(),
+    totalSize: z.string().optional(),
+    speedup: z.string().optional(),
+    stdout: z.string().optional(),
+    stderr: z.string().optional(),
+    duration: z.number(),
+    timedOut: z.boolean(),
+});
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,2EAA2E;AAE3E,8DAA8D;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;CACtB,CAAC,CAAC;AAIH,2EAA2E;AAE3E,8DAA8D;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAIH,2EAA2E;AAE3E,8CAA8C;AAC9C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CAChB,CAAC,CAAC;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC;AAIH,2EAA2E;AAE3E,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;CACtB,CAAC,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Registers all Remote tools on the given MCP server, filtered by policy. */
+export declare function registerAllTools(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,QAMjD"}

package/dist/tools/index.js

@@ -0,0 +1,18 @@
+import { shouldRegisterTool } from "@paretools/shared";
+import { registerSshRunTool } from "./ssh-run.js";
+import { registerSshTestTool } from "./ssh-test.js";
+import { registerSshKeyscanTool } from "./ssh-keyscan.js";
+import { registerRsyncTool } from "./rsync.js";
+/** Registers all Remote tools on the given MCP server, filtered by policy. */
+export function registerAllTools(server) {
+    const s = (name) => shouldRegisterTool("remote", name);
+    if (s("ssh-run"))
+        registerSshRunTool(server);
+    if (s("ssh-test"))
+        registerSshTestTool(server);
+    if (s("ssh-keyscan"))
+        registerSshKeyscanTool(server);
+    if (s("rsync"))
+        registerRsyncTool(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC/D,IAAI,CAAC,CAAC,SAAS,CAAC;QAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,UAAU,CAAC;QAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC,CAAC,aAAa,CAAC;QAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,CAAC,OAAO,CAAC;QAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC"}

package/dist/tools/rsync.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Registers the `rsync` tool on the given MCP server. */
+export declare function registerRsyncTool(server: McpServer): void;
+//# sourceMappingURL=rsync.d.ts.map

package/dist/tools/rsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rsync.d.ts","sourceRoot":"","sources":["../../src/tools/rsync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,QA0JlD"}

package/dist/tools/rsync.js

@@ -0,0 +1,124 @@
+import { z } from "zod";
+import { compactDualOutput, assertNoFlagInjection, INPUT_LIMITS, compactInput, projectPathInput, } from "@paretools/shared";
+import { rsyncCmd } from "../lib/remote-runner.js";
+import { parseRsyncOutput } from "../lib/parsers.js";
+import { formatRsync, compactRsyncMap, formatRsyncCompact } from "../lib/formatters.js";
+import { RsyncResultSchema } from "../schemas/index.js";
+/** Registers the `rsync` tool on the given MCP server. */
+export function registerRsyncTool(server) {
+    server.registerTool("rsync", {
+        title: "Rsync File Sync",
+        description: "Syncs files between local and remote locations using rsync. WARNING: Defaults to dry-run mode for safety — set dryRun=false to actually transfer files. Returns structured transfer statistics.",
+        inputSchema: {
+            source: z
+                .string()
+                .max(INPUT_LIMITS.STRING_MAX)
+                .describe("Source path (local path or remote user@host:path). Use trailing / to sync directory contents."),
+            destination: z
+                .string()
+                .max(INPUT_LIMITS.STRING_MAX)
+                .describe("Destination path (local path or remote user@host:path)"),
+            dryRun: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Preview what would be transferred without making changes (default: true for safety). Set to false to actually transfer."),
+            archive: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Archive mode: preserves permissions, timestamps, symlinks (rsync -a)"),
+            compress: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Compress data during transfer (rsync -z)"),
+            verbose: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Verbose output showing transferred files (rsync -v)"),
+            delete: z
+                .boolean()
+                .optional()
+                .describe("Delete files in destination that don't exist in source. Use with caution!"),
+            exclude: z
+                .array(z.string().max(INPUT_LIMITS.SHORT_STRING_MAX))
+                .max(INPUT_LIMITS.ARRAY_MAX)
+                .optional()
+                .describe("Patterns to exclude from sync (e.g. node_modules, .git)"),
+            include: z
+                .array(z.string().max(INPUT_LIMITS.SHORT_STRING_MAX))
+                .max(INPUT_LIMITS.ARRAY_MAX)
+                .optional()
+                .describe("Patterns to include in sync"),
+            sshPort: z.number().optional().describe("SSH port for remote transfers"),
+            identityFile: z
+                .string()
+                .max(INPUT_LIMITS.PATH_MAX)
+                .optional()
+                .describe("SSH private key file for remote transfers"),
+            path: projectPathInput,
+            compact: compactInput,
+        },
+        outputSchema: RsyncResultSchema,
+    }, async ({ source, destination, dryRun, archive, compress, verbose, delete: deleteDest, exclude, include, sshPort, identityFile, path, compact, }) => {
+        assertNoFlagInjection(source, "source");
+        assertNoFlagInjection(destination, "destination");
+        if (identityFile)
+            assertNoFlagInjection(identityFile, "identityFile");
+        const cwd = path || process.cwd();
+        const args = [];
+        if (archive)
+            args.push("-a");
+        if (compress)
+            args.push("-z");
+        if (verbose)
+            args.push("-v");
+        if (dryRun)
+            args.push("--dry-run");
+        if (deleteDest)
+            args.push("--delete");
+        // Always include --stats for structured output parsing
+        args.push("--stats");
+        // Exclude patterns
+        for (const pattern of exclude || []) {
+            args.push("--exclude", pattern);
+        }
+        // Include patterns
+        for (const pattern of include || []) {
+            args.push("--include", pattern);
+        }
+        // SSH options for remote transfers
+        if (sshPort !== undefined || identityFile) {
+            const sshOpts = ["ssh"];
+            if (sshPort !== undefined)
+                sshOpts.push(`-p ${sshPort}`);
+            if (identityFile)
+                sshOpts.push(`-i ${identityFile}`);
+            args.push("-e", sshOpts.join(" "));
+        }
+        args.push(source, destination);
+        const start = Date.now();
+        let timedOut = false;
+        let result;
+        try {
+            result = await rsyncCmd(args, cwd);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            if (errMsg.includes("timed out")) {
+                timedOut = true;
+                result = { exitCode: 124, stdout: "", stderr: errMsg };
+            }
+            else {
+                throw err;
+            }
+        }
+        const duration = Date.now() - start;
+        const data = parseRsyncOutput(source, destination, dryRun ?? true, result.stdout, result.stderr, result.exitCode, duration, timedOut);
+        const rawOutput = (result.stdout + "\n" + result.stderr).trim();
+        return compactDualOutput(data, rawOutput, formatRsync, compactRsyncMap, formatRsyncCompact, compact === false);
+    });
+}
+//# sourceMappingURL=rsync.js.map

package/dist/tools/rsync.js.map

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

package/dist/tools/ssh-keyscan.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Registers the `ssh-keyscan` tool on the given MCP server. */
+export declare function registerSshKeyscanTool(server: McpServer): void;
+//# sourceMappingURL=ssh-keyscan.d.ts.map

package/dist/tools/ssh-keyscan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-keyscan.d.ts","sourceRoot":"","sources":["../../src/tools/ssh-keyscan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBzE,gEAAgE;AAChE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QA6DvD"}

package/dist/tools/ssh-keyscan.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { compactDualOutput, assertNoFlagInjection, INPUT_LIMITS, compactInput, } from "@paretools/shared";
+import { sshKeyscanCmd } from "../lib/remote-runner.js";
+import { parseSshKeyscanOutput } from "../lib/parsers.js";
+import { formatSshKeyscan, compactSshKeyscanMap, formatSshKeyscanCompact, } from "../lib/formatters.js";
+import { SshKeyscanResultSchema } from "../schemas/index.js";
+/** Registers the `ssh-keyscan` tool on the given MCP server. */
+export function registerSshKeyscanTool(server) {
+    server.registerTool("ssh-keyscan", {
+        title: "SSH Keyscan",
+        description: "Retrieves public host keys from a remote SSH server using `ssh-keyscan`. Useful for populating known_hosts or verifying host key fingerprints.",
+        inputSchema: {
+            host: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .describe("Remote host to scan for public keys (hostname or IP address)"),
+            port: z.number().optional().describe("SSH port number (default: 22)"),
+            keyType: z
+                .enum(["rsa", "ecdsa", "ed25519"])
+                .optional()
+                .describe("Specific key type to request (default: all types)"),
+            timeout: z
+                .number()
+                .optional()
+                .describe("Timeout in seconds for the keyscan operation (default: 5)"),
+            compact: compactInput,
+        },
+        outputSchema: SshKeyscanResultSchema,
+    }, async ({ host, port, keyType, timeout, compact }) => {
+        assertNoFlagInjection(host, "host");
+        const args = [];
+        if (port !== undefined)
+            args.push("-p", String(port));
+        if (keyType)
+            args.push("-t", keyType);
+        if (timeout !== undefined) {
+            args.push("-T", String(timeout));
+        }
+        else {
+            args.push("-T", "5");
+        }
+        args.push(host);
+        let result;
+        try {
+            result = await sshKeyscanCmd(args);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            result = { exitCode: 1, stdout: "", stderr: errMsg };
+        }
+        const data = parseSshKeyscanOutput(host, result.stdout, result.stderr, result.exitCode);
+        const rawOutput = (result.stdout + "\n" + result.stderr).trim();
+        return compactDualOutput(data, rawOutput, formatSshKeyscan, compactSshKeyscanMap, formatSshKeyscanCompact, compact === false);
+    });
+}
+//# sourceMappingURL=ssh-keyscan.js.map

package/dist/tools/ssh-keyscan.js.map

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

package/dist/tools/ssh-run.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Registers the `ssh-run` tool on the given MCP server. */
+export declare function registerSshRunTool(server: McpServer): void;
+//# sourceMappingURL=ssh-run.d.ts.map

package/dist/tools/ssh-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-run.d.ts","sourceRoot":"","sources":["../../src/tools/ssh-run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QA+FnD"}

package/dist/tools/ssh-run.js

@@ -0,0 +1,82 @@
+import { z } from "zod";
+import { compactDualOutput, assertNoFlagInjection, INPUT_LIMITS, compactInput, } from "@paretools/shared";
+import { sshCmd } from "../lib/remote-runner.js";
+import { parseSshRunOutput } from "../lib/parsers.js";
+import { formatSshRun, compactSshRunMap, formatSshRunCompact } from "../lib/formatters.js";
+import { SshRunResultSchema } from "../schemas/index.js";
+/** Registers the `ssh-run` tool on the given MCP server. */
+export function registerSshRunTool(server) {
+    server.registerTool("ssh-run", {
+        title: "SSH Run Command",
+        description: "Executes a command on a remote host via SSH. WARNING: This runs commands on a remote machine. Ensure the host and command are correct before executing. Returns structured output with stdout, stderr, exit code, and duration.",
+        inputSchema: {
+            host: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .describe("Remote host to connect to (hostname or IP address)"),
+            user: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .optional()
+                .describe("SSH username (if not specified, uses SSH config default)"),
+            command: z
+                .string()
+                .max(INPUT_LIMITS.STRING_MAX)
+                .describe("Command to execute on the remote host"),
+            port: z.number().optional().describe("SSH port number (default: 22)"),
+            identityFile: z
+                .string()
+                .max(INPUT_LIMITS.PATH_MAX)
+                .optional()
+                .describe("Path to SSH private key file"),
+            options: z
+                .array(z.string().max(INPUT_LIMITS.SHORT_STRING_MAX))
+                .max(INPUT_LIMITS.ARRAY_MAX)
+                .optional()
+                .default([])
+                .describe("Additional SSH options as -o key=value pairs (e.g. StrictHostKeyChecking=no)"),
+            compact: compactInput,
+        },
+        outputSchema: SshRunResultSchema,
+    }, async ({ host, user, command, port, identityFile, options, compact }) => {
+        assertNoFlagInjection(host, "host");
+        if (user)
+            assertNoFlagInjection(user, "user");
+        if (identityFile)
+            assertNoFlagInjection(identityFile, "identityFile");
+        const args = [];
+        // Add options
+        for (const opt of options || []) {
+            assertNoFlagInjection(opt, "options");
+            args.push("-o", opt);
+        }
+        if (port !== undefined)
+            args.push("-p", String(port));
+        if (identityFile)
+            args.push("-i", identityFile);
+        // Build destination
+        const destination = user ? `${user}@${host}` : host;
+        args.push(destination, command);
+        const start = Date.now();
+        let timedOut = false;
+        let result;
+        try {
+            result = await sshCmd(args);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            if (errMsg.includes("timed out")) {
+                timedOut = true;
+                result = { exitCode: 124, stdout: "", stderr: errMsg };
+            }
+            else {
+                throw err;
+            }
+        }
+        const duration = Date.now() - start;
+        const data = parseSshRunOutput(host, user, command, result.stdout, result.stderr, result.exitCode, duration, timedOut);
+        const rawOutput = (result.stdout + "\n" + result.stderr).trim();
+        return compactDualOutput(data, rawOutput, formatSshRun, compactSshRunMap, formatSshRunCompact, compact === false);
+    });
+}
+//# sourceMappingURL=ssh-run.js.map

package/dist/tools/ssh-run.js.map

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

package/dist/tools/ssh-test.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Registers the `ssh-test` tool on the given MCP server. */
+export declare function registerSshTestTool(server: McpServer): void;
+//# sourceMappingURL=ssh-test.d.ts.map

package/dist/tools/ssh-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-test.d.ts","sourceRoot":"","sources":["../../src/tools/ssh-test.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QAkFpD"}

package/dist/tools/ssh-test.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { compactDualOutput, assertNoFlagInjection, INPUT_LIMITS, compactInput, } from "@paretools/shared";
+import { sshCmd } from "../lib/remote-runner.js";
+import { parseSshTestOutput } from "../lib/parsers.js";
+import { formatSshTest, compactSshTestMap, formatSshTestCompact } from "../lib/formatters.js";
+import { SshTestResultSchema } from "../schemas/index.js";
+/** Registers the `ssh-test` tool on the given MCP server. */
+export function registerSshTestTool(server) {
+    server.registerTool("ssh-test", {
+        title: "SSH Test Connection",
+        description: "Tests SSH connectivity to a remote host using `ssh -T`. Returns whether the host is reachable and any banner message.",
+        inputSchema: {
+            host: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .describe("Remote host to test connectivity to (hostname or IP address)"),
+            user: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .optional()
+                .describe("SSH username (if not specified, uses SSH config default)"),
+            port: z.number().optional().describe("SSH port number (default: 22)"),
+            identityFile: z
+                .string()
+                .max(INPUT_LIMITS.PATH_MAX)
+                .optional()
+                .describe("Path to SSH private key file"),
+            connectTimeout: z
+                .number()
+                .optional()
+                .describe("Connection timeout in seconds (default: 10)"),
+            compact: compactInput,
+        },
+        outputSchema: SshTestResultSchema,
+    }, async ({ host, user, port, identityFile, connectTimeout, compact }) => {
+        assertNoFlagInjection(host, "host");
+        if (user)
+            assertNoFlagInjection(user, "user");
+        if (identityFile)
+            assertNoFlagInjection(identityFile, "identityFile");
+        const args = ["-T"];
+        if (port !== undefined)
+            args.push("-p", String(port));
+        if (identityFile)
+            args.push("-i", identityFile);
+        if (connectTimeout !== undefined) {
+            args.push("-o", `ConnectTimeout=${connectTimeout}`);
+        }
+        else {
+            args.push("-o", "ConnectTimeout=10");
+        }
+        // Disable interactive prompts
+        args.push("-o", "BatchMode=yes");
+        const destination = user ? `${user}@${host}` : host;
+        args.push(destination);
+        const start = Date.now();
+        let result;
+        try {
+            result = await sshCmd(args);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            result = { exitCode: 255, stdout: "", stderr: errMsg };
+        }
+        const duration = Date.now() - start;
+        const data = parseSshTestOutput(host, user, result.stdout, result.stderr, result.exitCode, duration);
+        const rawOutput = (result.stdout + "\n" + result.stderr).trim();
+        return compactDualOutput(data, rawOutput, formatSshTest, compactSshTestMap, formatSshTestCompact, compact === false);
+    });
+}
+//# sourceMappingURL=ssh-test.js.map

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

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

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@paretools/remote",
+  "version": "0.11.0",
+  "mcpName": "io.github.Dave-London/pare-remote",
+  "description": "MCP server for remote operations (SSH, rsync) with structured, token-efficient output",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "structured-output",
+    "ai",
+    "ai-agent",
+    "claude",
+    "cursor",
+    "copilot",
+    "token-efficient",
+    "devtools",
+    "cli",
+    "ssh",
+    "rsync",
+    "remote",
+    "devops"
+  ],
+  "homepage": "https://github.com/Dave-London/Pare/tree/main/packages/server-remote",
+  "engines": {
+    "node": ">=20"
+  },
+  "type": "module",
+  "bin": {
+    "pare-remote": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Dave-London/Pare.git",
+    "directory": "packages/server-remote"
+  },
+  "bugs": {
+    "url": "https://github.com/Dave-London/Pare/issues"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^4.3.6",
+    "@paretools/shared": "0.11.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18",
+    "@paretools/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "coverage": "vitest run --coverage",
+    "lint": "eslint src/"
+  }
+}