host-execution-mcp 1.0.0

package/dist/tools/remote-schemas.js

@@ -0,0 +1,214 @@
+import { z } from "zod";
+const timeoutMs = z.number().int().positive().optional().describe("Timeout in milliseconds");
+export const landingTarget = z
+    .literal("landing")
+    .describe("Run on landing Context shell (omit contextKey)");
+export const podFields = {
+    namespace: z.string().min(1).describe("Kubernetes namespace (required when target=pod)"),
+    pod: z.string().min(1).describe("Pod name (required when target=pod)"),
+    container: z
+        .string()
+        .optional()
+        .describe("Container name (required when target=pod and pod has multiple containers)"),
+};
+export const contextFields = {
+    contextKey: z
+        .string()
+        .min(1)
+        .describe("HostExecutionContext key from context_derive (required when target=context)"),
+};
+/** Shared landing | pod [| context] discriminated union builder. */
+export function remotePathUnion(fields, opts = { allowContext: true }) {
+    const landing = z.object({ target: landingTarget, ...fields }).strict();
+    const pod = z.object({ target: z.literal("pod"), ...podFields, ...fields }).strict();
+    if (opts.allowContext === false) {
+        return z.discriminatedUnion("target", [landing, pod]);
+    }
+    const context = z
+        .object({ target: z.literal("context"), ...contextFields, ...fields })
+        .strict();
+    return z.discriminatedUnion("target", [landing, pod, context]);
+}
+const filePathField = {
+    path: z.string().min(1).describe("Absolute file path"),
+};
+const readModeFields = {
+    mode: z
+        .enum(["head", "tail"])
+        .optional()
+        .describe('Read from start ("head", default) or end ("tail")'),
+    lines: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Line count: default 500 for head, 200 for tail"),
+    maxLines: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Deprecated alias for lines when mode=head"),
+    offset: z.number().int().positive().optional().describe("Start line (mode=head only)"),
+    grep: z.string().optional().describe("Case-insensitive filter before tail (mode=tail only)"),
+    timeoutMs,
+};
+export function buildRemoteReadFileSchema(opts = { allowContext: true }) {
+    return remotePathUnion({ ...filePathField, ...readModeFields }, opts);
+}
+export function buildRemotePsSchema(opts = { allowContext: true }) {
+    return remotePathUnion({
+        pattern: z.string().optional().describe("Optional grep pattern for ps aux"),
+        timeoutMs,
+    }, opts);
+}
+/** Default schemas (ACCESS_KIND=ssh — context allowed). */
+export const remoteReadFileSchema = buildRemoteReadFileSchema({ allowContext: true });
+export const remotePsSchema = buildRemotePsSchema({ allowContext: true });
+/** Map discriminated-union input to internal RemoteTarget. */
+export function remoteInputToTarget(args) {
+    switch (args.target) {
+        case "landing":
+            return { target: "landing" };
+        case "pod":
+            return {
+                target: "pod",
+                namespace: args.namespace,
+                pod: args.pod,
+                container: args.container,
+            };
+        case "context":
+            return {
+                target: "context",
+                contextKey: args.contextKey,
+            };
+    }
+}
+const filePathEndpoint = {
+    path: z.string().min(1).describe("Absolute file or directory path"),
+};
+export function buildRemoteFileEndpointSchema(opts = { allowContext: true }) {
+    const local = z
+        .object({
+        target: z
+            .literal("local")
+            .describe("Path on the machine running host-execution-mcp (MCP server process)"),
+        ...filePathEndpoint,
+    })
+        .strict();
+    const landing = z.object({ target: landingTarget, ...filePathEndpoint }).strict();
+    const pod = z.object({ target: z.literal("pod"), ...podFields, ...filePathEndpoint }).strict();
+    if (opts.allowContext === false) {
+        return z.discriminatedUnion("target", [local, landing, pod]);
+    }
+    const context = z
+        .object({ target: z.literal("context"), ...contextFields, ...filePathEndpoint })
+        .strict();
+    return z.discriminatedUnion("target", [local, landing, pod, context]);
+}
+export const remoteFileEndpointSchema = buildRemoteFileEndpointSchema({ allowContext: true });
+function buildCopyObjectSchema(endpoint) {
+    return z
+        .object({
+        source: endpoint.describe("Copy from"),
+        dest: endpoint.describe("Copy to"),
+        recursive: z
+            .boolean()
+            .optional()
+            .describe("Directory copy (default true). local↔landing walks files; Runtime uses cp -a / scp -r / kubectl cp."),
+        /** @deprecated Prefer totalTimeoutMs; mapped to totalTimeoutMs when set. */
+        timeoutMs,
+        skipIfComplete: z
+            .boolean()
+            .optional()
+            .describe("Skip rewrite when destination already matches. Gate strength = verify: size (cheap) or size+sha256 (content). Incompatible with verify=none."),
+        progressIntervalMs: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Throttle interval for progress notifications (default 5000ms)"),
+        totalTimeoutMs: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Hard wall-clock limit for the whole copy (falls back to timeoutMs / DEFAULT_TIMEOUT_MS)"),
+        connectionTimeoutMs: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("local↔landing SFTP connect readyTimeout (default 20000ms)"),
+        verify: z
+            .enum(["none", "size", "size+sha256"])
+            .optional()
+            .describe("Verification / skip gate (default size). size=cheap size match; size+sha256=content (files + directories per-file). none forbidden with skipIfComplete."),
+    })
+        .strict()
+        .refine((v) => !(v.skipIfComplete === true && v.verify === "none"), {
+        message: "skipIfComplete requires verify=size or verify=size+sha256",
+        path: ["verify"],
+    });
+}
+export function buildRemoteCopyFileSchema(opts = { allowContext: true }) {
+    return buildCopyObjectSchema(buildRemoteFileEndpointSchema(opts));
+}
+export const remoteCopyFileSchema = buildRemoteCopyFileSchema({ allowContext: true });
+export function fileEndpointToInternal(endpoint) {
+    switch (endpoint.target) {
+        case "local":
+            return { target: "local", path: endpoint.path };
+        case "landing":
+            return { target: "landing", path: endpoint.path };
+        case "pod":
+            return {
+                target: "pod",
+                path: endpoint.path,
+                namespace: endpoint.namespace,
+                pod: endpoint.pod,
+                container: endpoint.container,
+            };
+        case "context":
+            return {
+                target: "context",
+                path: endpoint.path,
+                contextKey: endpoint.contextKey,
+            };
+    }
+}
+/** Materialize context endpoints to landing|host for the copy engine. */
+export function materializeCopyEndpoint(access, endpoint) {
+    if (endpoint.target !== "context") {
+        return endpoint;
+    }
+    const mat = access.materializeFileEndpoint({
+        target: "context",
+        contextKey: endpoint.contextKey,
+        path: endpoint.path,
+    });
+    return {
+        target: mat.target,
+        path: mat.path,
+        host: mat.host,
+        user: mat.user,
+        password: mat.password,
+    };
+}
+/** Normalize remote_read_file args. */
+export function resolveReadOptions(args) {
+    const mode = args.mode ?? "head";
+    if (mode === "tail") {
+        return {
+            mode: "tail",
+            lines: args.lines ?? args.maxLines ?? 200,
+            grep: args.grep,
+        };
+    }
+    return {
+        mode: "head",
+        lines: args.lines ?? args.maxLines ?? 500,
+        offset: args.offset,
+    };
+}
+//# sourceMappingURL=remote-schemas.js.map

package/dist/tools/remote-schemas.js.map

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

package/dist/utils/copy-executor.d.ts

@@ -0,0 +1,41 @@
+import type { AppConfig } from "../config.js";
+import type { AccessClient } from "../ssh/access-client.js";
+import { type FileEndpoint } from "./remote-copy.js";
+import { throwIfAborted, type CopyProgress, type CopySkipReason, type CopyVerifyMode } from "./copy-transfer.js";
+export { throwIfAborted };
+export interface CopyExecutionResult {
+    exitCode: number;
+    bytes?: number;
+    totalBytes?: number;
+    skippedBytes?: number;
+    skipped?: boolean;
+    skipReason?: CopySkipReason;
+    transferId: string;
+    verified?: boolean;
+    usedFastPath?: boolean;
+    message: string;
+    stderr: string;
+    durationMs: number;
+}
+export interface ExecuteRemoteCopyOptions {
+    recursive?: boolean;
+    /** @deprecated use totalTimeoutMs */
+    timeoutMs?: number;
+    skipIfComplete?: boolean;
+    progressIntervalMs?: number;
+    totalTimeoutMs?: number;
+    connectionTimeoutMs?: number;
+    verify?: CopyVerifyMode;
+    onProgress?: (progress: CopyProgress) => void;
+    transferId?: string;
+    signal?: AbortSignal;
+}
+/** Paradi landing is already TARGET — forbid second-hop / derived copy endpoints. */
+export declare function assertCopyEndpointsAllowed(config: AppConfig, source: FileEndpoint, dest: FileEndpoint): void;
+/** Execute remote_copy_file across local, landing, pod, and host endpoints. */
+export declare function executeRemoteCopy(deps: {
+    accessClient: AccessClient;
+    config: AppConfig;
+}, source: FileEndpoint, dest: FileEndpoint, options?: ExecuteRemoteCopyOptions): Promise<CopyExecutionResult>;
+/** Verify local file exists and return size (for tests). */
+export declare function localFileBytes(localPath: string): Promise<number>;

package/dist/utils/copy-executor.js

@@ -0,0 +1,231 @@
+import fs from "node:fs/promises";
+import crypto from "node:crypto";
+import { bashSingleQuote } from "./shell-quote.js";
+import { buildCopyFileCommand, parseCopyBytes } from "./remote-copy.js";
+import { createTransferId, DEFAULT_PROGRESS_INTERVAL_MS, resolveEffectiveVerify, throwIfAborted, } from "./copy-transfer.js";
+export { throwIfAborted };
+function tempLandingPath() {
+    return `/tmp/mcp_copy_${Date.now()}_${crypto.randomBytes(6).toString("hex")}`;
+}
+/** Paradi landing is already TARGET — forbid second-hop / derived copy endpoints. */
+export function assertCopyEndpointsAllowed(config, source, dest) {
+    if (config.accessKind !== "paradi-gateway") {
+        return;
+    }
+    if (source.target === "host" ||
+        dest.target === "host" ||
+        source.target === "context" ||
+        dest.target === "context") {
+        throw new Error("ACCESS_KIND=paradi-gateway already lands on TARGET — remote_copy second-hop host/context endpoints are unsupported by current Paradi AccessTransport. Use target=landing (landing=TARGET), pod, or local.");
+    }
+}
+function mergeOutput(raw) {
+    return [raw.stdout, raw.stderr].filter(Boolean).join("\n");
+}
+function resolveSftpOptions(options, config) {
+    const transferId = options.transferId ?? createTransferId();
+    const skipIfComplete = options.skipIfComplete === true;
+    // Enforce skip+none reject at Engine entry (not only Zod).
+    const verify = resolveEffectiveVerify(skipIfComplete, options.verify);
+    return {
+        skipIfComplete,
+        progressIntervalMs: options.progressIntervalMs ?? DEFAULT_PROGRESS_INTERVAL_MS,
+        totalTimeoutMs: options.totalTimeoutMs ?? options.timeoutMs ?? config.defaultTimeoutMs,
+        connectionTimeoutMs: options.connectionTimeoutMs,
+        verify,
+        onProgress: options.onProgress,
+        transferId,
+        signal: options.signal,
+    };
+}
+function remainingTimeoutMs(deadlineMs, fallback) {
+    const left = deadlineMs - Date.now();
+    if (left <= 0) {
+        throw new Error("Copy total timeout exceeded");
+    }
+    return Math.min(fallback, left);
+}
+function fromSftpResult(transfer, message, durationMs) {
+    return {
+        exitCode: 0,
+        bytes: transfer.bytes,
+        totalBytes: transfer.totalBytes,
+        skippedBytes: transfer.skippedBytes,
+        skipped: transfer.skipped,
+        skipReason: transfer.skipReason,
+        transferId: transfer.transferId,
+        verified: transfer.verified,
+        usedFastPath: transfer.usedFastPath,
+        message,
+        stderr: "",
+        durationMs,
+    };
+}
+async function removeLandingFile(accessClient, remotePath, timeoutMs, signal) {
+    await accessClient.exec(`rm -f ${bashSingleQuote(remotePath)}`, timeoutMs, undefined, signal).catch(() => undefined);
+}
+async function runLandingCopy(accessClient, source, dest, recursive, config, timeoutMs, signal) {
+    throwIfAborted(signal);
+    const command = buildCopyFileCommand(source, dest, recursive, config.targetUser, config.targetPassword);
+    const raw = await accessClient.exec(command, timeoutMs, undefined, signal);
+    const output = mergeOutput(raw);
+    return { exitCode: raw.exitCode, bytes: parseCopyBytes(output), output };
+}
+/** Execute remote_copy_file across local, landing, pod, and host endpoints. */
+export async function executeRemoteCopy(deps, source, dest, options = {}) {
+    const started = Date.now();
+    const recursive = options.recursive ?? true;
+    const sftpOpts = resolveSftpOptions(options, deps.config);
+    const budget = sftpOpts.totalTimeoutMs ?? deps.config.defaultTimeoutMs;
+    const deadlineMs = started + budget;
+    const src = source.target;
+    const dst = dest.target;
+    const duration = () => Date.now() - started;
+    const signal = options.signal;
+    throwIfAborted(signal);
+    assertCopyEndpointsAllowed(deps.config, source, dest);
+    const hopTimeout = () => remainingTimeoutMs(deadlineMs, budget);
+    if (src === "local" && dst === "landing") {
+        const transfer = await deps.accessClient.uploadPath(source.path, dest.path, {
+            ...sftpOpts,
+            totalTimeoutMs: hopTimeout(),
+        });
+        return fromSftpResult(transfer, `Copied local:${source.path} → landing:${dest.path}`, duration());
+    }
+    if (src === "landing" && dst === "local") {
+        const transfer = await deps.accessClient.downloadPath(source.path, dest.path, {
+            ...sftpOpts,
+            totalTimeoutMs: hopTimeout(),
+        });
+        return fromSftpResult(transfer, `Copied landing:${source.path} → local:${dest.path}`, duration());
+    }
+    if (src === "local" && dst === "pod") {
+        const tmp = tempLandingPath();
+        try {
+            const uploaded = await deps.accessClient.uploadPath(source.path, tmp, {
+                ...sftpOpts,
+                totalTimeoutMs: hopTimeout(),
+            });
+            throwIfAborted(signal);
+            const result = await runLandingCopy(deps.accessClient, { target: "landing", path: tmp }, dest, recursive, deps.config, hopTimeout(), signal);
+            if (result.exitCode !== 0) {
+                return {
+                    exitCode: result.exitCode,
+                    transferId: uploaded.transferId,
+                    totalBytes: uploaded.totalBytes,
+                    bytes: uploaded.bytes,
+                    message: result.output.trim() || "Copy failed",
+                    stderr: result.output,
+                    durationMs: duration(),
+                };
+            }
+            return {
+                ...fromSftpResult(uploaded, `Copied local:${source.path} → pod:${dest.path}`, duration()),
+                bytes: result.bytes ?? uploaded.bytes,
+            };
+        }
+        finally {
+            const left = Math.max(1_000, Math.min(15_000, deadlineMs - Date.now()));
+            await removeLandingFile(deps.accessClient, tmp, left, signal);
+        }
+    }
+    if (src === "pod" && dst === "local") {
+        const tmp = tempLandingPath();
+        try {
+            const result = await runLandingCopy(deps.accessClient, source, { target: "landing", path: tmp }, recursive, deps.config, hopTimeout(), signal);
+            if (result.exitCode !== 0) {
+                return {
+                    exitCode: result.exitCode,
+                    transferId: sftpOpts.transferId,
+                    message: result.output.trim() || "Copy failed",
+                    stderr: result.output,
+                    durationMs: duration(),
+                };
+            }
+            throwIfAborted(signal);
+            const transfer = await deps.accessClient.downloadPath(tmp, dest.path, {
+                ...sftpOpts,
+                totalTimeoutMs: hopTimeout(),
+            });
+            return fromSftpResult(transfer, `Copied pod:${source.path} → local:${dest.path}`, duration());
+        }
+        finally {
+            const left = Math.max(1_000, Math.min(15_000, deadlineMs - Date.now()));
+            await removeLandingFile(deps.accessClient, tmp, left, signal);
+        }
+    }
+    if (src === "local" && dst === "host") {
+        const tmp = tempLandingPath();
+        try {
+            const uploaded = await deps.accessClient.uploadPath(source.path, tmp, {
+                ...sftpOpts,
+                totalTimeoutMs: hopTimeout(),
+            });
+            throwIfAborted(signal);
+            const result = await runLandingCopy(deps.accessClient, { target: "landing", path: tmp }, dest, recursive, deps.config, hopTimeout(), signal);
+            if (result.exitCode !== 0) {
+                return {
+                    exitCode: result.exitCode,
+                    transferId: uploaded.transferId,
+                    totalBytes: uploaded.totalBytes,
+                    bytes: uploaded.bytes,
+                    message: result.output.trim() || "Copy failed",
+                    stderr: result.output,
+                    durationMs: duration(),
+                };
+            }
+            return {
+                ...fromSftpResult(uploaded, `Copied local:${source.path} → host:${dest.path}`, duration()),
+                bytes: result.bytes ?? uploaded.bytes,
+            };
+        }
+        finally {
+            const left = Math.max(1_000, Math.min(15_000, deadlineMs - Date.now()));
+            await removeLandingFile(deps.accessClient, tmp, left, signal);
+        }
+    }
+    if (src === "host" && dst === "local") {
+        const tmp = tempLandingPath();
+        try {
+            const result = await runLandingCopy(deps.accessClient, source, { target: "landing", path: tmp }, recursive, deps.config, hopTimeout(), signal);
+            if (result.exitCode !== 0) {
+                return {
+                    exitCode: result.exitCode,
+                    transferId: sftpOpts.transferId,
+                    message: result.output.trim() || "Copy failed",
+                    stderr: result.output,
+                    durationMs: duration(),
+                };
+            }
+            throwIfAborted(signal);
+            const transfer = await deps.accessClient.downloadPath(tmp, dest.path, {
+                ...sftpOpts,
+                totalTimeoutMs: hopTimeout(),
+            });
+            return fromSftpResult(transfer, `Copied host:${source.path} → local:${dest.path}`, duration());
+        }
+        finally {
+            const left = Math.max(1_000, Math.min(15_000, deadlineMs - Date.now()));
+            await removeLandingFile(deps.accessClient, tmp, left, signal);
+        }
+    }
+    throwIfAborted(signal);
+    const result = await runLandingCopy(deps.accessClient, source, dest, recursive, deps.config, hopTimeout(), signal);
+    return {
+        exitCode: result.exitCode,
+        bytes: result.bytes,
+        totalBytes: result.bytes,
+        transferId: sftpOpts.transferId,
+        message: result.exitCode === 0
+            ? `Copied ${source.target}:${source.path} → ${dest.target}:${dest.path}`
+            : result.output.trim() || "Copy failed",
+        stderr: result.output,
+        durationMs: duration(),
+    };
+}
+/** Verify local file exists and return size (for tests). */
+export async function localFileBytes(localPath) {
+    const stat = await fs.stat(localPath);
+    return stat.size;
+}
+//# sourceMappingURL=copy-executor.js.map

package/dist/utils/copy-executor.js.map

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

package/dist/utils/copy-job-manager.d.ts

@@ -0,0 +1,34 @@
+import type { AppConfig } from "../config.js";
+import type { AccessClient } from "../ssh/access-client.js";
+import type { FileEndpoint } from "./remote-copy.js";
+import { type ExecuteRemoteCopyOptions, type CopyExecutionResult } from "./copy-executor.js";
+import { type CopyJobHop, type RemoteCopyCancelResult, type RemoteCopyStartRequest, type RemoteCopyStartResult, type RemoteCopyStatusResult } from "./copy-job-types.js";
+import { CopyJobStore } from "./copy-job-store.js";
+type CopyRunner = (deps: {
+    accessClient: AccessClient;
+    config: AppConfig;
+}, source: FileEndpoint, dest: FileEndpoint, options?: ExecuteRemoteCopyOptions) => Promise<CopyExecutionResult>;
+/** Build a simple plan description for observability (engine still runs as one executeRemoteCopy). */
+export declare function buildCopyPlan(source: FileEndpoint, dest: FileEndpoint): CopyJobHop[];
+export declare class CopyJobManager {
+    private readonly deps;
+    private readonly store;
+    private readonly active;
+    private readonly executeCopy;
+    /** Resolves after orphan reconcile on startup. */
+    readonly ready: Promise<number>;
+    constructor(deps: {
+        accessClient: AccessClient;
+        config: AppConfig;
+    }, store?: CopyJobStore, executeCopy?: CopyRunner, options?: {
+        reconcileOnStart?: boolean;
+    });
+    get jobStorePath(): string;
+    /** Mark in-process jobs left as running/queued after MCP restart as failed. */
+    reconcileOrphans(): Promise<number>;
+    start(request: RemoteCopyStartRequest): Promise<RemoteCopyStartResult>;
+    status(transferId: string): Promise<RemoteCopyStatusResult>;
+    cancel(transferId: string): Promise<RemoteCopyCancelResult>;
+    private runJob;
+}
+export {};