@remnux/mcp-server 0.1.0

package/dist/connectors/ssh.js

@@ -0,0 +1,237 @@
+import { Client } from "ssh2";
+// Output size limit (10MB)
+const MAX_OUTPUT_SIZE = 10 * 1024 * 1024;
+export class SSHConnector {
+    config;
+    client = null;
+    constructor(config) {
+        this.config = config;
+    }
+    async connect() {
+        if (this.client)
+            return this.client;
+        return new Promise((resolve, reject) => {
+            const client = new Client();
+            client.on("ready", () => {
+                this.client = client;
+                resolve(client);
+            });
+            client.on("error", reject);
+            // Try to connect with private key first, then password
+            const connectConfig = {
+                host: this.config.host,
+                port: this.config.port,
+                username: this.config.user,
+            };
+            if (this.config.privateKey) {
+                connectConfig.privateKey = this.config.privateKey;
+            }
+            else if (this.config.password) {
+                connectConfig.password = this.config.password;
+            }
+            else {
+                // Use SSH agent
+                connectConfig.agent = process.env.SSH_AUTH_SOCK;
+            }
+            client.connect(connectConfig);
+        });
+    }
+    async execute(command, options = {}) {
+        const client = await this.connect();
+        const timeout = options.timeout || 300000;
+        // Validate command array is not empty
+        if (command.length === 0) {
+            throw new Error("Command array cannot be empty");
+        }
+        // Proper shell escaping using single quotes
+        // Single quotes preserve everything literally except single quotes themselves
+        // To include a single quote: end single quote, add escaped single quote, start single quote again
+        const cmdString = command
+            .map((arg) => `'${arg.replace(/'/g, "'\\''")}'`)
+            .join(" ");
+        // Also escape cwd path if provided
+        const escapedCwd = options.cwd ? `'${options.cwd.replace(/'/g, "'\\''")}'` : null;
+        const fullCmd = escapedCwd ? `cd ${escapedCwd} && ${cmdString}` : cmdString;
+        return new Promise((resolve, reject) => {
+            let timedOut = false;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                // Clean up the SSH connection on timeout
+                this.client?.end();
+                this.client = null;
+                reject(new Error(`Command timed out after ${timeout / 1000} seconds`));
+            }, timeout);
+            client.exec(fullCmd, (err, stream) => {
+                if (err) {
+                    clearTimeout(timer);
+                    return reject(err);
+                }
+                let stdout = "";
+                let stderr = "";
+                let outputTruncated = false;
+                stream.on("data", (data) => {
+                    if (stdout.length < MAX_OUTPUT_SIZE) {
+                        stdout += data.toString();
+                        if (stdout.length >= MAX_OUTPUT_SIZE) {
+                            stdout = stdout.slice(0, MAX_OUTPUT_SIZE);
+                            outputTruncated = true;
+                        }
+                    }
+                });
+                stream.stderr.on("data", (data) => {
+                    if (stderr.length < MAX_OUTPUT_SIZE) {
+                        stderr += data.toString();
+                        if (stderr.length >= MAX_OUTPUT_SIZE) {
+                            stderr = stderr.slice(0, MAX_OUTPUT_SIZE);
+                            outputTruncated = true;
+                        }
+                    }
+                });
+                stream.on("close", (code) => {
+                    if (timedOut)
+                        return;
+                    clearTimeout(timer);
+                    let finalStdout = stdout.trim();
+                    if (outputTruncated) {
+                        finalStdout += "\n\n[OUTPUT TRUNCATED - exceeded 10MB limit]";
+                    }
+                    resolve({
+                        stdout: finalStdout,
+                        stderr: stderr.trim(),
+                        exitCode: code,
+                    });
+                });
+            });
+        });
+    }
+    async executeShell(command, options = {}) {
+        const client = await this.connect();
+        const timeout = options.timeout || 300000;
+        // Build the full command with optional cwd
+        const escapedCwd = options.cwd ? `'${options.cwd.replace(/'/g, "'\\''")}'` : null;
+        const fullCmd = escapedCwd ? `cd ${escapedCwd} && ${command}` : command;
+        return new Promise((resolve, reject) => {
+            let timedOut = false;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                this.client?.end();
+                this.client = null;
+                reject(new Error(`Command timed out after ${timeout / 1000} seconds`));
+            }, timeout);
+            client.exec(fullCmd, (err, stream) => {
+                if (err) {
+                    clearTimeout(timer);
+                    return reject(err);
+                }
+                let stdout = "";
+                let stderr = "";
+                let outputTruncated = false;
+                stream.on("data", (data) => {
+                    if (stdout.length < MAX_OUTPUT_SIZE) {
+                        stdout += data.toString();
+                        if (stdout.length >= MAX_OUTPUT_SIZE) {
+                            stdout = stdout.slice(0, MAX_OUTPUT_SIZE);
+                            outputTruncated = true;
+                        }
+                    }
+                });
+                stream.stderr.on("data", (data) => {
+                    if (stderr.length < MAX_OUTPUT_SIZE) {
+                        stderr += data.toString();
+                        if (stderr.length >= MAX_OUTPUT_SIZE) {
+                            stderr = stderr.slice(0, MAX_OUTPUT_SIZE);
+                            outputTruncated = true;
+                        }
+                    }
+                });
+                stream.on("close", (code) => {
+                    if (timedOut)
+                        return;
+                    clearTimeout(timer);
+                    let finalStdout = stdout.trim();
+                    if (outputTruncated) {
+                        finalStdout += "\n\n[OUTPUT TRUNCATED - exceeded 10MB limit]";
+                    }
+                    resolve({
+                        stdout: finalStdout,
+                        stderr: stderr.trim(),
+                        exitCode: code,
+                    });
+                });
+            });
+        });
+    }
+    async writeFile(remotePath, content) {
+        const client = await this.connect();
+        return new Promise((resolve, reject) => {
+            client.sftp((err, sftp) => {
+                if (err) {
+                    return reject(new Error(`SFTP error: ${err.message}`));
+                }
+                const writeStream = sftp.createWriteStream(remotePath);
+                writeStream.on("error", (writeErr) => {
+                    sftp.end();
+                    reject(new Error(`SFTP write error: ${writeErr.message}`));
+                });
+                writeStream.on("close", () => {
+                    sftp.end();
+                    resolve();
+                });
+                writeStream.end(content);
+            });
+        });
+    }
+    async writeFileFromPath(remotePath, hostPath) {
+        const client = await this.connect();
+        const { createReadStream } = await import("fs");
+        const { pipeline } = await import("stream/promises");
+        return new Promise((resolve, reject) => {
+            client.sftp((err, sftp) => {
+                if (err) {
+                    return reject(new Error(`SFTP error: ${err.message}`));
+                }
+                const readStream = createReadStream(hostPath);
+                const writeStream = sftp.createWriteStream(remotePath);
+                pipeline(readStream, writeStream)
+                    .then(() => {
+                    sftp.end();
+                    resolve();
+                })
+                    .catch((pipeErr) => {
+                    sftp.end();
+                    reject(new Error(`SFTP write error: ${pipeErr.message}`));
+                });
+            });
+        });
+    }
+    async readFileToPath(remotePath, hostPath) {
+        const client = await this.connect();
+        const { createWriteStream } = await import("fs");
+        const { pipeline } = await import("stream/promises");
+        return new Promise((resolve, reject) => {
+            client.sftp((err, sftp) => {
+                if (err) {
+                    return reject(new Error(`SFTP error: ${err.message}`));
+                }
+                const readStream = sftp.createReadStream(remotePath);
+                const writeStream = createWriteStream(hostPath);
+                pipeline(readStream, writeStream)
+                    .then(() => {
+                    sftp.end();
+                    resolve();
+                })
+                    .catch((pipeErr) => {
+                    sftp.end();
+                    reject(new Error(`SFTP read error: ${pipeErr.message}`));
+                });
+            });
+        });
+    }
+    async disconnect() {
+        if (this.client) {
+            this.client.end();
+            this.client = null;
+        }
+    }
+}
+//# sourceMappingURL=ssh.js.map

package/dist/connectors/ssh.js.map

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

package/dist/errors/error-mapper.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Maps raw/unknown errors into structured REMnuxError instances.
+ *
+ * Catch blocks can call `toREMnuxError(err)` to get a typed error
+ * with code, category, and remediation hint.
+ */
+import { REMnuxError } from "./remnux-error.js";
+export declare function toREMnuxError(raw: unknown): REMnuxError;
+//# sourceMappingURL=error-mapper.d.ts.map

package/dist/errors/error-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.d.ts","sourceRoot":"","sources":["../../src/errors/error-mapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAmCvD"}

package/dist/errors/error-mapper.js

@@ -0,0 +1,24 @@
+/**
+ * Maps raw/unknown errors into structured REMnuxError instances.
+ *
+ * Catch blocks can call `toREMnuxError(err)` to get a typed error
+ * with code, category, and remediation hint.
+ */
+import { REMnuxError } from "./remnux-error.js";
+export function toREMnuxError(raw) {
+    if (raw instanceof REMnuxError) {
+        return raw;
+    }
+    const msg = raw instanceof Error ? raw.message : String(raw);
+    if (/is not running|not running/i.test(msg)) {
+        return new REMnuxError(msg, "CONNECTION_FAILED", "connection", "Run `docker start remnux` or check the container status");
+    }
+    if (/ECONNREFUSED/i.test(msg)) {
+        return new REMnuxError(msg, "CONNECTION_FAILED", "connection", "Check SSH host/port configuration");
+    }
+    if (/timeout/i.test(msg)) {
+        return new REMnuxError(msg, "COMMAND_TIMEOUT", "timeout", "Increase --timeout or simplify the command");
+    }
+    return new REMnuxError(msg, "UNKNOWN_ERROR", "tool_failure");
+}
+//# sourceMappingURL=error-mapper.js.map

package/dist/errors/error-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.js","sourceRoot":"","sources":["../../src/errors/error-mapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAE7D,IAAI,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,OAAO,IAAI,WAAW,CACpB,GAAG,EACH,mBAAmB,EACnB,YAAY,EACZ,yDAAyD,CAC1D,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,WAAW,CACpB,GAAG,EACH,mBAAmB,EACnB,YAAY,EACZ,mCAAmC,CACpC,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,WAAW,CACpB,GAAG,EACH,iBAAiB,EACjB,SAAS,EACT,4CAA4C,CAC7C,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;AAC/D,CAAC"}

package/dist/errors/remnux-error.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Structured error type for REMnux MCP tools.
+ *
+ * Carries a machine-readable code, category, and optional
+ * remediation hint so callers can programmatically handle errors.
+ */
+export type ErrorCategory = "validation" | "security" | "connection" | "timeout" | "not_found" | "tool_failure";
+export declare class REMnuxError extends Error {
+    readonly code: string;
+    readonly category: ErrorCategory;
+    readonly remediation?: string;
+    constructor(message: string, code: string, category: ErrorCategory, remediation?: string);
+}
+//# sourceMappingURL=remnux-error.d.ts.map

package/dist/errors/remnux-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remnux-error.d.ts","sourceRoot":"","sources":["../../src/errors/remnux-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,SAAS,GACT,WAAW,GACX,cAAc,CAAC;AAEnB,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,EACvB,WAAW,CAAC,EAAE,MAAM;CAQvB"}

package/dist/errors/remnux-error.js

@@ -0,0 +1,19 @@
+/**
+ * Structured error type for REMnux MCP tools.
+ *
+ * Carries a machine-readable code, category, and optional
+ * remediation hint so callers can programmatically handle errors.
+ */
+export class REMnuxError extends Error {
+    code;
+    category;
+    remediation;
+    constructor(message, code, category, remediation) {
+        super(message);
+        this.name = "REMnuxError";
+        this.code = code;
+        this.category = category;
+        this.remediation = remediation;
+    }
+}
+//# sourceMappingURL=remnux-error.js.map

package/dist/errors/remnux-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remnux-error.js","sourceRoot":"","sources":["../../src/errors/remnux-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAS;IACb,QAAQ,CAAgB;IACxB,WAAW,CAAU;IAE9B,YACE,OAAe,EACf,IAAY,EACZ,QAAuB,EACvB,WAAoB;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF"}

package/dist/file-type-mappings.d.ts

@@ -0,0 +1,30 @@
+/**
+ * File type detection patterns.
+ *
+ * Maps `file` command output patterns to analysis categories.
+ * Tool lists are derived from the tool registry via tags — not duplicated here.
+ *
+ * Derived from:
+ *   - https://zeltser.com/remnux-malware-analysis-tips
+ *   - https://zeltser.com/analyzing-malicious-documents
+ */
+/** Depth tiers for analysis. Canonical definition — import from here. */
+export type DepthTier = "quick" | "standard" | "deep";
+/** Ordered list of depth tiers from shallowest to deepest. */
+export declare const DEPTH_TIER_ORDER: readonly DepthTier[];
+export interface FileTypeCategory {
+    /** Category name (e.g., "PE", "PDF") */
+    name: string;
+    /** Patterns matched against `file` command output (case-insensitive) */
+    patterns: RegExp[];
+}
+export declare const FILE_TYPE_CATEGORIES: FileTypeCategory[];
+/** Maps category names to their primary registry tag. */
+export declare const CATEGORY_TAG_MAP: Record<string, string>;
+/**
+ * Match `file` command output to a category. Returns the first match or fallback.
+ * @param fileOutput - Output from the `file` command
+ * @param filename - Optional filename for extension-based fallback (e.g., when `file` says "Zip archive")
+ */
+export declare function matchFileType(fileOutput: string, filename?: string): FileTypeCategory;
+//# sourceMappingURL=file-type-mappings.d.ts.map

package/dist/file-type-mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-type-mappings.d.ts","sourceRoot":"","sources":["../src/file-type-mappings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,yEAAyE;AACzE,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAEtD,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,EAAE,SAAS,SAAS,EAA2C,CAAC;AAE7F,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,EA6DlD,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgBnD,CAAC;AAcF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAmCrF"}

package/dist/file-type-mappings.js

@@ -0,0 +1,136 @@
+/**
+ * File type detection patterns.
+ *
+ * Maps `file` command output patterns to analysis categories.
+ * Tool lists are derived from the tool registry via tags — not duplicated here.
+ *
+ * Derived from:
+ *   - https://zeltser.com/remnux-malware-analysis-tips
+ *   - https://zeltser.com/analyzing-malicious-documents
+ */
+/** Ordered list of depth tiers from shallowest to deepest. */
+export const DEPTH_TIER_ORDER = ["quick", "standard", "deep"];
+export const FILE_TYPE_CATEGORIES = [
+    // DOTNET must precede PE: both match "PE32" but DOTNET patterns are more
+    // specific (Mono/.Net, .Net assembly). First-match wins in matchFileType().
+    {
+        name: "DOTNET",
+        patterns: [/Mono\/\.Net/i, /\.Net assembly/i, /PE32.*\.NET/i],
+    },
+    {
+        name: "PE",
+        patterns: [/PE32\+?/i, /MS-DOS executable/i],
+    },
+    {
+        name: "PDF",
+        patterns: [/\bPDF\b/i],
+    },
+    {
+        name: "OLE2",
+        patterns: [
+            /Composite Document File/i,
+            /OLE 2/i,
+            /Microsoft Word(?! 2007)/i,
+            /Microsoft Excel(?! 2007)/i,
+            /Microsoft PowerPoint(?! 2007)/i,
+        ],
+    },
+    {
+        name: "OOXML",
+        patterns: [
+            /Microsoft Word 2007/i,
+            /Microsoft Excel 2007/i,
+            /\bOOXML\b/i,
+        ],
+    },
+    {
+        name: "RTF",
+        patterns: [/Rich Text Format/i, /\bRTF\b/],
+    },
+    {
+        name: "ELF",
+        patterns: [/\bELF\b/],
+    },
+    {
+        name: "OneNote",
+        patterns: [/OneNote/i],
+    },
+    {
+        name: "Script",
+        patterns: [/shell script/i, /script text/i, /ASCII text/i, /UTF-8.*text/i],
+    },
+    {
+        name: "JAR",
+        patterns: [/Java archive/i, /\bJAR\b/i],
+    },
+    {
+        name: "Email",
+        patterns: [/\bmail\b/i, /RFC 822/i, /\bSMTP\b/i],
+    },
+    {
+        name: "APK",
+        patterns: [/\bAndroid\b/i],
+    },
+];
+/** Maps category names to their primary registry tag. */
+export const CATEGORY_TAG_MAP = {
+    DOTNET: "dotnet",
+    PE: "pe",
+    PDF: "pdf",
+    OLE2: "ole2",
+    OOXML: "ooxml",
+    RTF: "rtf",
+    ELF: "elf",
+    OneNote: "onenote",
+    Script: "script",
+    JAR: "jar",
+    Email: "email",
+    APK: "apk",
+    Memory: "memory",
+    Shellcode: "shellcode",
+    Unknown: "fallback",
+};
+/** Memory image extensions — used as fallback when `file` reports "data". */
+const MEMORY_EXTENSIONS = /\.(img|raw|mem|vmem|dmp|lime)$/i;
+/** Shellcode extensions — used as fallback when `file` reports "data". */
+const SHELLCODE_EXTENSIONS = /\.(bin|sc|shellcode|payload)$/i;
+/** OOXML file extensions — used as fallback when `file` reports "Zip archive". */
+const OOXML_EXTENSIONS = /\.(docx|docm|xlsx|xlsm|pptx|pptm)$/i;
+/** OLE2 macro-enabled extensions that `file` may misidentify. */
+const OLE2_EXTENSIONS = /\.(doc|xls|ppt)$/i;
+/**
+ * Match `file` command output to a category. Returns the first match or fallback.
+ * @param fileOutput - Output from the `file` command
+ * @param filename - Optional filename for extension-based fallback (e.g., when `file` says "Zip archive")
+ */
+export function matchFileType(fileOutput, filename) {
+    // Strip "<path>: " prefix from `file` command output (e.g., "/home/remnux/files/samples/foo.img: data" → "data")
+    const typeOutput = fileOutput.includes(":") ? fileOutput.split(":").slice(1).join(":").trim() : fileOutput.trim();
+    for (const category of FILE_TYPE_CATEGORIES) {
+        for (const pattern of category.patterns) {
+            if (pattern.test(typeOutput)) {
+                return category;
+            }
+        }
+    }
+    // Fallback: if `file` says "Zip archive" and filename has OOXML extension, classify as OOXML
+    if (filename && /zip archive/i.test(typeOutput)) {
+        if (OOXML_EXTENSIONS.test(filename)) {
+            return FILE_TYPE_CATEGORIES.find((c) => c.name === "OOXML");
+        }
+    }
+    // Fallback: if filename has OLE2 extension and `file` output is ambiguous (e.g., "data", "CDF")
+    if (filename && OLE2_EXTENSIONS.test(filename) && /^data$|^CDF/i.test(typeOutput)) {
+        return FILE_TYPE_CATEGORIES.find((c) => c.name === "OLE2");
+    }
+    // Fallback: memory images — `file` reports "data" for raw memory dumps
+    if (filename && MEMORY_EXTENSIONS.test(filename) && /^data$/i.test(typeOutput)) {
+        return { name: "Memory", patterns: [] };
+    }
+    // Fallback: shellcode — `file` reports "data" and filename has shellcode extension
+    if (filename && SHELLCODE_EXTENSIONS.test(filename) && /^data$/i.test(typeOutput)) {
+        return { name: "Shellcode", patterns: [] };
+    }
+    return { name: "Unknown", patterns: [] };
+}
+//# sourceMappingURL=file-type-mappings.js.map

package/dist/file-type-mappings.js.map

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

package/dist/file-upload.d.ts

@@ -0,0 +1,44 @@
+/**
+ * File upload module for REMnux MCP server
+ *
+ * Allows AI assistants to upload files from the host filesystem to the
+ * samples directory via MCP. Reads files locally — no base64 in context.
+ */
+import type { Connector } from "./connectors/index.js";
+export interface UploadResult {
+    success: boolean;
+    path?: string;
+    size_bytes?: number;
+    sha256?: string;
+    error?: string;
+}
+/**
+ * Validate filename for security
+ * - No path separators (/, \)
+ * - No path traversal (..)
+ * - No null bytes
+ * - Reasonable length
+ */
+export declare function validateFilename(filename: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Validate a host filesystem path for security
+ */
+export declare function validateHostPath(hostPath: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Upload a file from the host filesystem to the samples directory
+ *
+ * @param connector - Connector to write files on REMnux
+ * @param samplesDir - Base samples directory on REMnux
+ * @param hostPath - Absolute path on the host filesystem
+ * @param filename - Override filename (defaults to basename of hostPath)
+ * @param overwrite - Whether to overwrite if file exists (default: false)
+ * @returns Upload result with file path, size, and SHA256 hash
+ */
+export declare function uploadSampleFromHost(connector: Connector, samplesDir: string, hostPath: string, filename?: string, overwrite?: boolean): Promise<UploadResult>;
+//# sourceMappingURL=file-upload.d.ts.map

package/dist/file-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-upload.d.ts","sourceRoot":"","sources":["../src/file-upload.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAKvD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA2BrF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAwBrF;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,GAAE,OAAe,GACzB,OAAO,CAAC,YAAY,CAAC,CAsGvB"}