@remnux/mcp-server 0.1.0

package/dist/handlers/run-tool.d.ts

@@ -0,0 +1,10 @@
+import type { HandlerDeps } from "./types.js";
+import type { RunToolArgs } from "../schemas/tools.js";
+export declare function handleRunTool(deps: HandlerDeps, args: RunToolArgs): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=run-tool.d.ts.map

package/dist/handlers/run-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tool.d.ts","sourceRoot":"","sources":["../../src/handlers/run-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAQvD,wBAAsB,aAAa,CACjC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,WAAW;;;;;;GA2FlB"}

package/dist/handlers/run-tool.js

@@ -0,0 +1,99 @@
+import { validateFilePath, isCommandSafe } from "../security/blocklist.js";
+import { formatResponse, formatError } from "../response.js";
+import { REMnuxError } from "../errors/remnux-error.js";
+import { toREMnuxError } from "../errors/error-mapper.js";
+import { parseToolOutput, hasParser } from "../parsers/index.js";
+import { toolRegistry } from "../tools/registry.js";
+export async function handleRunTool(deps, args) {
+    const startTime = Date.now();
+    const { connector, config } = deps;
+    // Build full command
+    let fullCommand = args.command;
+    if (args.input_file) {
+        // Validate input file path (skip unless --sandbox)
+        if (!config.noSandbox) {
+            const pathValidation = validateFilePath(args.input_file, config.samplesDir);
+            if (!pathValidation.safe) {
+                return formatError("run_tool", new REMnuxError(pathValidation.error || "Invalid input file path", "INVALID_PATH", "validation", "Use a relative path within the samples directory"), startTime);
+            }
+        }
+        // Append quoted file path to command (single-quotes prevent shell expansion)
+        // Escape any single quotes in the path as defense-in-depth (isPathSafe also rejects them)
+        const escapedFile = args.input_file.replace(/'/g, "'\\''");
+        fullCommand = `${args.command} '${config.samplesDir}/${escapedFile}'`;
+    }
+    // Security: Validate command against blocklist
+    const validation = isCommandSafe(fullCommand);
+    if (!validation.safe) {
+        return formatError("run_tool", new REMnuxError(validation.error || "Command blocked", "COMMAND_BLOCKED", "security", "This command is blocked for security reasons. Use an allowed tool instead."), startTime);
+    }
+    const MAX_STDOUT_RESPONSE = 100 * 1024; // 100KB — fits in LLM context
+    const MAX_STDERR_RESPONSE = 50 * 1024;
+    try {
+        const result = await connector.executeShell(fullCommand, {
+            timeout: (args.timeout || config.timeout) * 1000,
+            cwd: config.samplesDir,
+        });
+        let stdout = result.stdout || "";
+        let stderr = result.stderr || "";
+        // Filter Volatility 3 progress bar noise from stderr
+        stderr = stderr.replace(/^Progress:\s+[\d.]+\s+.*$/gm, "").trim();
+        let truncated = false;
+        const fullStdoutLength = stdout.length;
+        if (stdout.length > MAX_STDOUT_RESPONSE) {
+            stdout = stdout.slice(0, MAX_STDOUT_RESPONSE);
+            truncated = true;
+        }
+        if (stderr.length > MAX_STDERR_RESPONSE) {
+            stderr = stderr.slice(0, MAX_STDERR_RESPONSE);
+            truncated = true;
+        }
+        // Auto-parse output if command matches a known tool with a parser
+        let findings;
+        let parsedMetadata;
+        const toolName = detectToolName(fullCommand);
+        if (toolName && hasParser(toolName) && stdout) {
+            const parsed = parseToolOutput(toolName, stdout);
+            if (parsed.parsed) {
+                findings = parsed.findings;
+                parsedMetadata = parsed.metadata;
+            }
+        }
+        return formatResponse("run_tool", {
+            command: fullCommand,
+            stdout,
+            stderr,
+            exit_code: result.exitCode,
+            truncated,
+            ...(truncated && {
+                truncation_notice: "Output exceeded response size limit. Use 'run_tool' with '| head -N' or redirect to a file for full output.",
+                full_stdout_length: fullStdoutLength,
+            }),
+            ...(findings && { findings, parsed_metadata: parsedMetadata }),
+        }, startTime);
+    }
+    catch (error) {
+        return formatError("run_tool", toREMnuxError(error), startTime);
+    }
+}
+/**
+ * Detect the parser-registered tool name from a command string.
+ * Extracts the base command name (strips path and .py suffix),
+ * then finds a registry definition whose command matches AND has a parser.
+ */
+function detectToolName(command) {
+    const firstWord = command.split(/\s/)[0];
+    // Strip path prefix (/usr/bin/olevba → olevba) and .py suffix
+    const baseCmd = firstWord.replace(/^.*\//, "").replace(/\.py$/, "");
+    // Check registry definitions that have a parser
+    for (const def of toolRegistry.all()) {
+        if (def.command === baseCmd && hasParser(def.name)) {
+            return def.name;
+        }
+    }
+    // Direct parser name match (e.g. command name IS the parser key)
+    if (hasParser(baseCmd))
+        return baseCmd;
+    return undefined;
+}
+//# sourceMappingURL=run-tool.js.map

package/dist/handlers/run-tool.js.map

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

package/dist/handlers/suggest-tools.d.ts

@@ -0,0 +1,10 @@
+import type { HandlerDeps } from "./types.js";
+import type { SuggestToolsArgs } from "../schemas/tools.js";
+export declare function handleSuggestTools(deps: HandlerDeps, args: SuggestToolsArgs): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=suggest-tools.d.ts.map

package/dist/handlers/suggest-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest-tools.d.ts","sourceRoot":"","sources":["../../src/handlers/suggest-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA8J5D,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,gBAAgB;;;;;;GA8FvB"}

package/dist/handlers/suggest-tools.js

@@ -0,0 +1,202 @@
+import { validateFilePath } from "../security/blocklist.js";
+import { matchFileType, CATEGORY_TAG_MAP } from "../file-type-mappings.js";
+import { toolRegistry } from "../tools/registry.js";
+import { formatResponse, formatError } from "../response.js";
+import { REMnuxError } from "../errors/remnux-error.js";
+import { toREMnuxError } from "../errors/error-mapper.js";
+/**
+ * Base per-category expert guidance for the AI agent.
+ */
+const BASE_HINTS = {
+    DOTNET: "Start with peframe and diec for triage. diec detects packers/protectors. " +
+        "ilspycmd decompiles .NET to C# source. " +
+        "capa identifies capabilities like C2, persistence, or file manipulation.",
+    PE: "Start with peframe and diec for triage — diec detects packers and compilers. " +
+        "capa maps capabilities to MITRE ATT&CK. floss extracts obfuscated strings. " +
+        "For deep analysis, pedump shows raw PE structure and brxor bruteforces XOR-encoded strings.",
+    PDF: "Start with pdfid to identify suspicious elements (/JS, /JavaScript, /OpenAction, /Launch). " +
+        "Use pdf-parser --stats for structural overview. If suspicious objects found, " +
+        "extract them with pdf-parser -o <obj_id> -d. peepdf-3 provides interactive deep analysis. " +
+        "qpdf decrypts permission-locked PDFs. pdftk extracts metadata and document info.",
+    OLE2: "Start with oleid for risk indicators (macros, encryption, external links). " +
+        "olevba extracts and analyzes VBA macros — look for auto-execute triggers and suspicious keywords. " +
+        "oledump lists OLE streams; use -s <stream> -v to dump specific macro streams. " +
+        "pcodedmp disassembles VBA p-code (useful when source is stomped). " +
+        "xlmdeobfuscator handles Excel 4.0 XLM macros.",
+    OOXML: "olevba handles both OLE2 and OOXML macro extraction. " +
+        "zipdump lists the ZIP structure — OOXML files are ZIP archives with XML inside. " +
+        "Look for unusual entries or embedded OLE objects within the archive. " +
+        "pcodedmp disassembles VBA p-code. xlmdeobfuscator deobfuscates Excel 4.0 XLM macros.",
+    RTF: "rtfobj extracts embedded objects (OLE, packages) from RTF files. " +
+        "rtfdump analyzes RTF structure and can reveal obfuscated content. " +
+        "Look for embedded executables, shellcode, or CVE exploits in objects.",
+    ELF: "readelf -h shows ELF header (type, arch, entry point). " +
+        "readelf -S lists sections — look for unusual section names or sizes. " +
+        "capa detects capabilities in ELF binaries similar to PE analysis.",
+    Script: "strings extracts readable content for quick triage. " +
+        "js-beautify reformats and deobfuscates JavaScript — look for eval(), " +
+        "document.write(), String.fromCharCode(), and unescape() patterns. " +
+        "base64dump finds and decodes Base64 and other encoded strings — " +
+        "common in PowerShell, bash, and JavaScript malware. " +
+        "box-js analyzes and deobfuscates JavaScript malware in a sandbox environment. " +
+        "For heavily obfuscated JS, consider manual deobfuscation with run_tool after reviewing js-beautify output.",
+    JAR: "zipdump lists the JAR archive contents (JAR files are ZIP format). " +
+        "Look for unusual class files, embedded resources, or manifest entries. " +
+        "exiftool reveals metadata about the archive.",
+    Email: "emldump analyzes EML structure and extracts attachments. " +
+        "msgconvert converts Outlook MSG files to EML format for analysis with emldump. " +
+        "Look for suspicious attachments, embedded URLs, and header anomalies. " +
+        "Extract attachments for further analysis with appropriate tools.",
+    APK: "apktool decompiles the APK to smali and extracts resources. " +
+        "droidlysis performs static analysis identifying permissions, API calls, and risk indicators. " +
+        "Look for excessive permissions, obfuscation, and suspicious network activity.",
+    OneNote: "OneNote file detected. No dedicated OneNote tools are currently available in REMnux. " +
+        "Use strings and exiftool for basic triage. Use run_tool to manually extract embedded objects. " +
+        "OneNote files may contain embedded scripts, executables, or malicious attachments.",
+    Shellcode: "Raw shellcode detected. scdbgc provides fast Win32 API call tracing (x86 only). " +
+        "speakeasy emulates both x86 and x64 shellcode with Windows API emulation. " +
+        "Look for resolved API names, network connections, file system access, and registry modifications in emulation output. " +
+        "For deep analysis, qltool (Qiling) provides multi-platform emulation and tracesc traces execution via Wine. " +
+        "Use strings and xorsearch for static indicators before emulation.",
+    Memory: "Memory image detected. Start with vol3-info to identify OS and kernel version. " +
+        "vol3-pslist and vol3-pstree reveal running processes; vol3-psscan finds hidden/unlinked processes. " +
+        "vol3-netscan shows network connections. vol3-cmdline extracts process arguments. " +
+        "vol3-dlllist shows loaded DLLs. vol3-filescan finds file objects. vol3-hivelist lists registry hives. " +
+        "For deeper analysis, vol3-malfind detects injected code and vol3-handles lists open handles. " +
+        "For Linux memory images, use vol3-linux-pslist.",
+    Unknown: "File type not recognized. strings and exiftool provide basic triage. " +
+        "base64dump searches for encoded content. xorsearch tries common XOR keys. " +
+        "translate.py applies byte-level transforms (XOR, shift). re-search.py extracts regex patterns. " +
+        "file-magic.py identifies embedded file types. numbers-to-string.py decodes numeric payloads. " +
+        "Consider using 'file' or 'diec' via run_tool for deeper type identification.",
+};
+/** Extract observable properties from `file` command output. */
+function extractFileProperties(fileOutput) {
+    const lower = fileOutput.toLowerCase();
+    const props = {};
+    if (/upx/i.test(fileOutput))
+        props.packed = "UPX";
+    else if (/aspack/i.test(fileOutput))
+        props.packed = "ASPack";
+    else if (/pecompact/i.test(fileOutput))
+        props.packed = "PECompact";
+    else if (/themida/i.test(fileOutput))
+        props.packed = "Themida";
+    if (lower.includes(".net") || lower.includes("mono/") || lower.includes("msil")) {
+        props.isDotNet = true;
+    }
+    if (lower.includes("(dll)") || lower.includes("dll ")) {
+        props.isDll = true;
+    }
+    if (/purebasic/i.test(fileOutput))
+        props.compiler = "PureBasic";
+    else if (/masm/i.test(fileOutput))
+        props.compiler = "MASM";
+    else if (/delphi/i.test(fileOutput))
+        props.compiler = "Delphi";
+    else if (/autoit/i.test(fileOutput))
+        props.compiler = "AutoIt";
+    return props;
+}
+/** Generate dynamic hints by augmenting base hints with property-specific guidance. */
+function generateHints(category, fileOutput) {
+    const base = BASE_HINTS[category] ?? BASE_HINTS.Unknown;
+    const props = extractFileProperties(fileOutput);
+    const extras = [];
+    if (props.packed) {
+        extras.push(`Packer detected: ${props.packed}. ` +
+            "capa and floss results may be limited on packed samples. " +
+            (props.packed === "UPX"
+                ? "UPX can be unpacked with the upx-decompress tool — recommend unpacking then re-analyzing."
+                : "No standard unpacker available; expect partial static analysis results."));
+    }
+    if (props.isDotNet) {
+        extras.push("Detected .NET assembly — ilspycmd decompilation recommended for source-level analysis.");
+    }
+    if (props.isDll) {
+        extras.push("DLL detected — check exports with `pedump --exports` for entry point analysis.");
+    }
+    if (props.compiler) {
+        extras.push(`Unusual compiler: ${props.compiler}. This may indicate specialized tooling or uncommon origin.`);
+    }
+    if (extras.length === 0)
+        return base;
+    return base + "\n\nAdditional notes: " + extras.join(" ");
+}
+export async function handleSuggestTools(deps, args) {
+    const startTime = Date.now();
+    try {
+        const { connector, config } = deps;
+        const depth = (args.depth ?? "standard");
+        // Validate file path (skip unless --sandbox)
+        if (!config.noSandbox) {
+            const validation = validateFilePath(args.file, config.samplesDir);
+            if (!validation.safe) {
+                return formatError("suggest_tools", new REMnuxError(validation.error || "Invalid file path", "INVALID_PATH", "validation", "Use a relative path within the samples directory"), startTime);
+            }
+        }
+        const filePath = `${config.samplesDir}/${args.file}`;
+        // Detect file type
+        let fileOutput;
+        try {
+            const result = await connector.execute(["file", filePath], { timeout: 30000 });
+            fileOutput = result.stdout?.trim() || "";
+            if (!fileOutput) {
+                return formatError("suggest_tools", new REMnuxError("Could not determine file type (empty `file` output)", "EMPTY_OUTPUT", "tool_failure", "Check that the file exists and is readable"), startTime);
+            }
+        }
+        catch (error) {
+            const msg = `Error running file command: ${error instanceof Error ? error.message : "Unknown error"}`;
+            return formatError("suggest_tools", new REMnuxError(msg, "EMPTY_OUTPUT", "tool_failure", "Check that the file exists and is readable"), startTime);
+        }
+        // Match category and get tools from registry
+        const category = matchFileType(fileOutput, args.file);
+        const primaryTag = CATEGORY_TAG_MAP[category.name] ?? "fallback";
+        const tools = toolRegistry.byTagAndTier(primaryTag, depth);
+        // Check tool availability (batch all unique commands in one shell call)
+        const uniqueCommands = [...new Set(tools.map((t) => t.command))];
+        const availableCommands = new Set();
+        if (uniqueCommands.length > 0) {
+            try {
+                // Single shell call: check all commands at once
+                const checks = uniqueCommands.map((c) => `which ${c} >/dev/null 2>&1 && echo "${c}"`).join("; ");
+                const check = await connector.executeShell(checks, {
+                    timeout: 10000,
+                    cwd: config.samplesDir,
+                });
+                for (const line of (check.stdout || "").split("\n")) {
+                    const cmd = line.trim();
+                    if (cmd)
+                        availableCommands.add(cmd);
+                }
+            }
+            catch {
+                // On failure, assume all available (graceful degradation)
+                for (const c of uniqueCommands)
+                    availableCommands.add(c);
+            }
+        }
+        const recommended = tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            tier: t.tier,
+            tags: t.tags ?? [],
+            ...(availableCommands.has(t.command) ? {} : { available: false }),
+        }));
+        return formatResponse("suggest_tools", {
+            file: args.file,
+            detected_type: fileOutput,
+            matched_category: category.name,
+            depth,
+            recommended_tools: recommended,
+            ...(recommended.length === 0 && {
+                warning: `No tools registered for category "${category.name}" at depth "${depth}". Try depth "deep" or use run_tool directly.`,
+            }),
+            analysis_hints: generateHints(category.name, fileOutput),
+        }, startTime);
+    }
+    catch (error) {
+        return formatError("suggest_tools", toREMnuxError(error), startTime);
+    }
+}
+//# sourceMappingURL=suggest-tools.js.map

package/dist/handlers/suggest-tools.js.map

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

package/dist/handlers/types.d.ts

@@ -0,0 +1,15 @@
+import type { Connector } from "../connectors/index.js";
+import type { SessionState } from "../state/session.js";
+export interface HandlerConfig {
+    samplesDir: string;
+    outputDir: string;
+    timeout: number;
+    noSandbox: boolean;
+    mode: "docker" | "ssh" | "local";
+}
+export interface HandlerDeps {
+    connector: Connector;
+    config: HandlerConfig;
+    sessionState: SessionState;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/handlers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/handlers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;CAC5B"}

package/dist/handlers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/handlers/types.js.map

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

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

@@ -0,0 +1,10 @@
+import type { HandlerDeps } from "./types.js";
+import type { UploadFromHostArgs } from "../schemas/tools.js";
+export declare function handleUploadFile(deps: HandlerDeps, args: UploadFromHostArgs): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=upload-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upload-file.d.ts","sourceRoot":"","sources":["../../src/handlers/upload-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAO9D,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,kBAAkB;;;;;;GAkDzB"}

package/dist/handlers/upload-file.js

@@ -0,0 +1,33 @@
+import { uploadSampleFromHost, validateHostPath, validateFilename } from "../file-upload.js";
+import { formatResponse, formatError } from "../response.js";
+import { REMnuxError } from "../errors/remnux-error.js";
+import { toREMnuxError } from "../errors/error-mapper.js";
+import { basename } from "path";
+export async function handleUploadFile(deps, args) {
+    const startTime = Date.now();
+    const { connector, config } = deps;
+    // Validate host path first
+    const pathValidation = validateHostPath(args.host_path);
+    if (!pathValidation.valid) {
+        return formatError("upload_file", new REMnuxError(pathValidation.error || "Invalid host path", "INVALID_PATH", "validation", "Provide an absolute path to a file on the host filesystem"), startTime);
+    }
+    // Validate filename if provided
+    const targetFilename = args.filename ?? basename(args.host_path);
+    const filenameValidation = validateFilename(targetFilename);
+    if (!filenameValidation.valid) {
+        return formatError("upload_file", new REMnuxError(filenameValidation.error || "Invalid filename", "INVALID_FILENAME", "validation", "Use alphanumeric characters, hyphens, underscores, and dots only"), startTime);
+    }
+    try {
+        const result = await uploadSampleFromHost(connector, config.samplesDir, args.host_path, args.filename, args.overwrite);
+        if (result.success) {
+            return formatResponse("upload_file", result, startTime);
+        }
+        else {
+            return formatError("upload_file", new REMnuxError(result.error || "Upload failed", "UPLOAD_FAILED", "tool_failure", "Check that the file exists and is readable on the host filesystem"), startTime);
+        }
+    }
+    catch (error) {
+        return formatError("upload_file", toREMnuxError(error), startTime);
+    }
+}
+//# sourceMappingURL=upload-file.js.map

package/dist/handlers/upload-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-file.js","sourceRoot":"","sources":["../../src/handlers/upload-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAiB,EACjB,IAAwB;IAExB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEnC,2BAA2B;IAC3B,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC,aAAa,EAAE,IAAI,WAAW,CAC/C,cAAc,CAAC,KAAK,IAAI,mBAAmB,EAC3C,cAAc,EACd,YAAY,EACZ,2DAA2D,CAC5D,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC;IAED,gCAAgC;IAChC,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAC5D,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC,aAAa,EAAE,IAAI,WAAW,CAC/C,kBAAkB,CAAC,KAAK,IAAI,kBAAkB,EAC9C,kBAAkB,EAClB,YAAY,EACZ,kEAAkE,CACnE,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CACvC,SAAS,EACT,MAAM,CAAC,UAAU,EACjB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,SAAS,CACf,CAAC;QAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,cAAc,CAAC,aAAa,EAAE,MAA4C,EAAE,SAAS,CAAC,CAAC;QAChG,CAAC;aAAM,CAAC;YACN,OAAO,WAAW,CAAC,aAAa,EAAE,IAAI,WAAW,CAC/C,MAAM,CAAC,KAAK,IAAI,eAAe,EAC/B,eAAe,EACf,cAAc,EACd,mEAAmE,CACpE,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,aAAa,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;IACrE,CAAC;AACH,CAAC"}

package/dist/handlers/upload-from-host.d.ts

@@ -0,0 +1,10 @@
+import type { HandlerDeps } from "./types.js";
+import type { UploadFromHostArgs } from "../schemas/tools.js";
+export declare function handleUploadFromHost(deps: HandlerDeps, args: UploadFromHostArgs): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=upload-from-host.d.ts.map

package/dist/handlers/upload-from-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-from-host.d.ts","sourceRoot":"","sources":["../../src/handlers/upload-from-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAO9D,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,kBAAkB;;;;;;GAkDzB"}

package/dist/handlers/upload-from-host.js

@@ -0,0 +1,33 @@
+import { uploadSampleFromHost, validateHostPath, validateFilename } from "../file-upload.js";
+import { formatResponse, formatError } from "../response.js";
+import { REMnuxError } from "../errors/remnux-error.js";
+import { toREMnuxError } from "../errors/error-mapper.js";
+import { basename } from "path";
+export async function handleUploadFromHost(deps, args) {
+    const startTime = Date.now();
+    const { connector, config } = deps;
+    // Validate host path first
+    const pathValidation = validateHostPath(args.host_path);
+    if (!pathValidation.valid) {
+        return formatError("upload_from_host", new REMnuxError(pathValidation.error || "Invalid host path", "INVALID_PATH", "validation", "Provide an absolute path to a file on the host filesystem"), startTime);
+    }
+    // Validate filename if provided
+    const targetFilename = args.filename ?? basename(args.host_path);
+    const filenameValidation = validateFilename(targetFilename);
+    if (!filenameValidation.valid) {
+        return formatError("upload_from_host", new REMnuxError(filenameValidation.error || "Invalid filename", "INVALID_FILENAME", "validation", "Use alphanumeric characters, hyphens, underscores, and dots only"), startTime);
+    }
+    try {
+        const result = await uploadSampleFromHost(connector, config.samplesDir, args.host_path, args.filename, args.overwrite);
+        if (result.success) {
+            return formatResponse("upload_from_host", result, startTime);
+        }
+        else {
+            return formatError("upload_from_host", new REMnuxError(result.error || "Upload failed", "UPLOAD_FAILED", "tool_failure", "Check that the file exists and is readable on the host filesystem"), startTime);
+        }
+    }
+    catch (error) {
+        return formatError("upload_from_host", toREMnuxError(error), startTime);
+    }
+}
+//# sourceMappingURL=upload-from-host.js.map

package/dist/handlers/upload-from-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-from-host.js","sourceRoot":"","sources":["../../src/handlers/upload-from-host.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAiB,EACjB,IAAwB;IAExB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEnC,2BAA2B;IAC3B,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC,kBAAkB,EAAE,IAAI,WAAW,CACpD,cAAc,CAAC,KAAK,IAAI,mBAAmB,EAC3C,cAAc,EACd,YAAY,EACZ,2DAA2D,CAC5D,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC;IAED,gCAAgC;IAChC,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAC5D,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC,kBAAkB,EAAE,IAAI,WAAW,CACpD,kBAAkB,CAAC,KAAK,IAAI,kBAAkB,EAC9C,kBAAkB,EAClB,YAAY,EACZ,kEAAkE,CACnE,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CACvC,SAAS,EACT,MAAM,CAAC,UAAU,EACjB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,SAAS,CACf,CAAC;QAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,cAAc,CAAC,kBAAkB,EAAE,MAA4C,EAAE,SAAS,CAAC,CAAC;QACrG,CAAC;aAAM,CAAC;YACN,OAAO,WAAW,CAAC,kBAAkB,EAAE,IAAI,WAAW,CACpD,MAAM,CAAC,KAAK,IAAI,eAAe,EAC/B,eAAe,EACf,cAAc,EACd,mEAAmE,CACpE,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,kBAAkB,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/handlers/upload-sample.d.ts

@@ -0,0 +1,10 @@
+import type { HandlerDeps } from "./types.js";
+import type { UploadSampleArgs } from "../schemas/tools.js";
+export declare function handleUploadSample(deps: HandlerDeps, args: UploadSampleArgs): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=upload-sample.d.ts.map

package/dist/handlers/upload-sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-sample.d.ts","sourceRoot":"","sources":["../../src/handlers/upload-sample.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM5D,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,gBAAgB;;;;;;GAsCvB"}

package/dist/handlers/upload-sample.js

@@ -0,0 +1,26 @@
+import { uploadSample, validateFilename } from "../file-upload.js";
+import { formatResponse, formatError } from "../response.js";
+import { REMnuxError } from "../errors/remnux-error.js";
+import { toREMnuxError } from "../errors/error-mapper.js";
+export async function handleUploadSample(deps, args) {
+    const startTime = Date.now();
+    const { connector, config } = deps;
+    // Validate filename first (before attempting upload)
+    const filenameValidation = validateFilename(args.filename);
+    if (!filenameValidation.valid) {
+        return formatError("upload_sample", new REMnuxError(filenameValidation.error || "Invalid filename", "INVALID_FILENAME", "validation", "Use alphanumeric characters, hyphens, underscores, and dots only"), startTime);
+    }
+    try {
+        const result = await uploadSample(connector, config.samplesDir, args.filename, args.content_base64, args.overwrite);
+        if (result.success) {
+            return formatResponse("upload_sample", result, startTime);
+        }
+        else {
+            return formatError("upload_sample", new REMnuxError(result.error || "Upload failed", "UPLOAD_FAILED", "tool_failure", "Check disk space and write permissions in the samples directory"), startTime);
+        }
+    }
+    catch (error) {
+        return formatError("upload_sample", toREMnuxError(error), startTime);
+    }
+}
+//# sourceMappingURL=upload-sample.js.map

package/dist/handlers/upload-sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-sample.js","sourceRoot":"","sources":["../../src/handlers/upload-sample.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAiB,EACjB,IAAsB;IAEtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEnC,qDAAqD;IACrD,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3D,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC,eAAe,EAAE,IAAI,WAAW,CACjD,kBAAkB,CAAC,KAAK,IAAI,kBAAkB,EAC9C,kBAAkB,EAClB,YAAY,EACZ,kEAAkE,CACnE,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,SAAS,EACT,MAAM,CAAC,UAAU,EACjB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,SAAS,CACf,CAAC;QAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,cAAc,CAAC,eAAe,EAAE,MAA4C,EAAE,SAAS,CAAC,CAAC;QAClG,CAAC;aAAM,CAAC;YACN,OAAO,WAAW,CAAC,eAAe,EAAE,IAAI,WAAW,CACjD,MAAM,CAAC,KAAK,IAAI,eAAe,EAC/B,eAAe,EACf,cAAc,EACd,iEAAiE,CAClE,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,eAAe,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ConnectorConfig } from "./connectors/index.js";
+export interface ServerConfig extends ConnectorConfig {
+    samplesDir: string;
+    outputDir: string;
+    timeout: number;
+    noSandbox?: boolean;
+    transport?: "stdio" | "http";
+    httpPort?: number;
+    httpHost?: string;
+    httpToken?: string;
+}
+export declare function createServer(config: ServerConfig): Promise<McpServer>;
+export declare function startServer(config: ServerConfig): Promise<void>;
+//# 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":"AACA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAOtF,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA6B9E,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,sBA6OtD;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,iBAarD"}