crosspad-mcp-server 5.1.0 → 6.0.0

package/dist/tools/idf-monitor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Serial log capture from a connected CrossPad device.
+ *
+ * Uses Python/pyserial for direct serial reading — no TTY required.
+ * This avoids idf.py monitor's TTY dependency while still using
+ * the IDF Python venv (which has pyserial installed).
+ *
+ * Multi-device aware: requires port when multiple devices connected.
+ */
+import { OnLine } from "../utils/exec.js";
+export interface MonitorResult {
+    success: boolean;
+    port: string;
+    duration_seconds: number;
+    lines: string[];
+    line_count: number;
+    truncated: boolean;
+    error?: string;
+}
+/**
+ * Capture serial logs from a connected CrossPad device.
+ *
+ * @param port - Serial port (auto-detect if undefined)
+ * @param timeoutSeconds - How long to capture (default 10)
+ * @param maxLines - Maximum lines to return (default 500)
+ * @param filter - Optional string filter — only return lines containing this
+ * @param onLine - Streaming callback for real-time output
+ */
+export declare function crosspadIdfMonitor(port: string | undefined, timeoutSeconds: number | undefined, maxLines: number | undefined, filter: string | undefined, onLine?: OnLine): Promise<MonitorResult>;

package/dist/tools/idf-monitor.js

@@ -0,0 +1,168 @@
+/**
+ * Serial log capture from a connected CrossPad device.
+ *
+ * Uses Python/pyserial for direct serial reading — no TTY required.
+ * This avoids idf.py monitor's TTY dependency while still using
+ * the IDF Python venv (which has pyserial installed).
+ *
+ * Multi-device aware: requires port when multiple devices connected.
+ */
+import { IS_WINDOWS } from "../config.js";
+import { getIdfEnv } from "../utils/exec.js";
+import { findCrosspadPort } from "../utils/device.js";
+import { spawn } from "child_process";
+/**
+ * Build a Python script that reads from serial port for a given duration.
+ * Uses pyserial (available in IDF venv). No TTY dependency.
+ */
+function buildSerialReaderScript(port, timeoutSeconds) {
+    // Escape for embedding in shell command
+    const escapedPort = port.replace(/'/g, "\\'");
+    return [
+        "import serial, sys, time",
+        `ser = serial.Serial('${escapedPort}', 115200, timeout=1)`,
+        `end = time.time() + ${timeoutSeconds}`,
+        "try:",
+        "    while time.time() < end:",
+        "        line = ser.readline()",
+        "        if line:",
+        "            text = line.decode('utf-8', errors='replace').rstrip()",
+        "            if text:",
+        "                print(text, flush=True)",
+        "except KeyboardInterrupt:",
+        "    pass",
+        "finally:",
+        "    ser.close()",
+    ].join("\n");
+}
+/**
+ * Capture serial logs from a connected CrossPad device.
+ *
+ * @param port - Serial port (auto-detect if undefined)
+ * @param timeoutSeconds - How long to capture (default 10)
+ * @param maxLines - Maximum lines to return (default 500)
+ * @param filter - Optional string filter — only return lines containing this
+ * @param onLine - Streaming callback for real-time output
+ */
+export async function crosspadIdfMonitor(port, timeoutSeconds = 10, maxLines = 500, filter, onLine) {
+    const startTime = Date.now();
+    // Resolve port
+    const resolved = findCrosspadPort(port);
+    if (resolved.error) {
+        return {
+            success: false,
+            port: "",
+            duration_seconds: 0,
+            lines: [],
+            line_count: 0,
+            truncated: false,
+            error: resolved.error,
+        };
+    }
+    const targetPort = resolved.port;
+    onLine?.("stdout", `[idf-monitor] Capturing from ${targetPort} for ${timeoutSeconds}s...`);
+    // Get IDF environment (for Python with pyserial)
+    let env;
+    try {
+        env = getIdfEnv();
+    }
+    catch (err) {
+        return {
+            success: false,
+            port: targetPort,
+            duration_seconds: 0,
+            lines: [],
+            line_count: 0,
+            truncated: false,
+            error: `Failed to initialize IDF environment: ${err.message}`,
+        };
+    }
+    const script = buildSerialReaderScript(targetPort, timeoutSeconds);
+    const shell = IS_WINDOWS ? "cmd.exe" : "/bin/bash";
+    return new Promise((resolve) => {
+        const lines = [];
+        let totalLines = 0;
+        let truncated = false;
+        let stdoutBuf = "";
+        // Run Python script with IDF env (has pyserial on PATH)
+        const child = spawn("python3", ["-c", script], {
+            env,
+            shell: false,
+            stdio: ["pipe", "pipe", "pipe"],
+            windowsHide: true,
+        });
+        // Safety kill: slightly after the Python timeout
+        const timer = setTimeout(() => {
+            onLine?.("stdout", `[idf-monitor] Timeout reached (${timeoutSeconds}s), stopping...`);
+            child.kill("SIGTERM");
+            setTimeout(() => {
+                if (!child.killed)
+                    child.kill("SIGKILL");
+            }, 2000);
+        }, (timeoutSeconds + 3) * 1000);
+        function processLine(line) {
+            // Strip ANSI escape codes
+            const clean = line.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "").replace(/\r/g, "");
+            if (!clean.trim())
+                return;
+            totalLines++;
+            // Apply filter if specified
+            if (filter && !clean.toLowerCase().includes(filter.toLowerCase())) {
+                return;
+            }
+            if (lines.length < maxLines) {
+                lines.push(clean);
+                onLine?.("stdout", clean);
+            }
+            else {
+                truncated = true;
+            }
+        }
+        child.stdout?.on("data", (chunk) => {
+            stdoutBuf += chunk.toString();
+            const parts = stdoutBuf.split("\n");
+            for (let i = 0; i < parts.length - 1; i++) {
+                processLine(parts[i]);
+            }
+            stdoutBuf = parts[parts.length - 1];
+        });
+        child.stderr?.on("data", (chunk) => {
+            const text = chunk.toString();
+            for (const sline of text.split("\n")) {
+                if (sline.trim()) {
+                    onLine?.("stderr", sline.replace(/\r/g, ""));
+                }
+            }
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            if (stdoutBuf.trim()) {
+                processLine(stdoutBuf);
+            }
+            const duration = (Date.now() - startTime) / 1000;
+            onLine?.("stdout", `[idf-monitor] Captured ${lines.length} lines in ${duration.toFixed(1)}s`);
+            resolve({
+                success: code === 0 || lines.length > 0,
+                port: targetPort,
+                duration_seconds: duration,
+                lines,
+                line_count: totalLines,
+                truncated,
+            });
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            const duration = (Date.now() - startTime) / 1000;
+            resolve({
+                success: false,
+                port: targetPort,
+                duration_seconds: duration,
+                lines,
+                line_count: totalLines,
+                truncated,
+                error: err.message,
+            });
+        });
+    });
+}
+//# sourceMappingURL=idf-monitor.js.map

package/dist/tools/idf-monitor.js.map

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

package/dist/tools/midi.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Send MIDI events to the CrossPad simulator via TCP remote control.
+ *
+ * Supports: note_on, note_off, cc (control change), program_change.
+ * Uses the same remote control protocol as other sim commands.
+ */
+export type MidiEventType = "note_on" | "note_off" | "cc" | "program_change";
+export interface MidiSendParams {
+    type: MidiEventType;
+    channel: number;
+    note?: number;
+    velocity?: number;
+    cc_num?: number;
+    value?: number;
+    program?: number;
+}
+export interface MidiSendResult {
+    success: boolean;
+    type: MidiEventType;
+    channel: number;
+    details: Record<string, number>;
+    error?: string;
+}
+/**
+ * Send a MIDI event to the running simulator.
+ */
+export declare function crosspadMidiSend(params: MidiSendParams): Promise<MidiSendResult>;

package/dist/tools/midi.js

@@ -0,0 +1,112 @@
+/**
+ * Send MIDI events to the CrossPad simulator via TCP remote control.
+ *
+ * Supports: note_on, note_off, cc (control change), program_change.
+ * Uses the same remote control protocol as other sim commands.
+ */
+import { sendRemoteCommand, isSimulatorRunning } from "../utils/remote-client.js";
+/**
+ * Send a MIDI event to the running simulator.
+ */
+export async function crosspadMidiSend(params) {
+    const running = await isSimulatorRunning();
+    if (!running) {
+        return {
+            success: false,
+            type: params.type,
+            channel: params.channel,
+            details: {},
+            error: "Simulator is not running. Use crosspad_build action=pc_run to start it.",
+        };
+    }
+    // Validate channel
+    if (params.channel < 0 || params.channel > 15) {
+        return {
+            success: false,
+            type: params.type,
+            channel: params.channel,
+            details: {},
+            error: "MIDI channel must be 0-15",
+        };
+    }
+    let cmd;
+    const details = { channel: params.channel };
+    switch (params.type) {
+        case "note_on": {
+            const note = params.note ?? 60;
+            const velocity = params.velocity ?? 127;
+            if (note < 0 || note > 127) {
+                return { success: false, type: params.type, channel: params.channel, details, error: "Note must be 0-127" };
+            }
+            if (velocity < 0 || velocity > 127) {
+                return { success: false, type: params.type, channel: params.channel, details, error: "Velocity must be 0-127" };
+            }
+            cmd = { cmd: "midi", type: "note_on", channel: params.channel, note, velocity };
+            details.note = note;
+            details.velocity = velocity;
+            break;
+        }
+        case "note_off": {
+            const note = params.note ?? 60;
+            const velocity = params.velocity ?? 0;
+            if (note < 0 || note > 127) {
+                return { success: false, type: params.type, channel: params.channel, details, error: "Note must be 0-127" };
+            }
+            cmd = { cmd: "midi", type: "note_off", channel: params.channel, note, velocity };
+            details.note = note;
+            details.velocity = velocity;
+            break;
+        }
+        case "cc": {
+            const ccNum = params.cc_num ?? 0;
+            const value = params.value ?? 0;
+            if (ccNum < 0 || ccNum > 127) {
+                return { success: false, type: params.type, channel: params.channel, details, error: "CC number must be 0-127" };
+            }
+            if (value < 0 || value > 127) {
+                return { success: false, type: params.type, channel: params.channel, details, error: "Value must be 0-127" };
+            }
+            cmd = { cmd: "midi", type: "cc", channel: params.channel, cc: ccNum, value };
+            details.cc = ccNum;
+            details.value = value;
+            break;
+        }
+        case "program_change": {
+            const program = params.program ?? 0;
+            if (program < 0 || program > 127) {
+                return { success: false, type: params.type, channel: params.channel, details, error: "Program must be 0-127" };
+            }
+            cmd = { cmd: "midi", type: "program_change", channel: params.channel, program };
+            details.program = program;
+            break;
+        }
+        default:
+            return {
+                success: false,
+                type: params.type,
+                channel: params.channel,
+                details: {},
+                error: `Unknown MIDI event type: ${params.type}`,
+            };
+    }
+    try {
+        const resp = await sendRemoteCommand(cmd);
+        return {
+            success: resp.ok === true,
+            type: params.type,
+            channel: params.channel,
+            details,
+            error: resp.ok ? undefined : resp.error ?? "Simulator rejected MIDI command",
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            type: params.type,
+            channel: params.channel,
+            details,
+            error: err.message,
+        };
+    }
+}
+//# sourceMappingURL=midi.js.map

package/dist/tools/midi.js.map

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

package/dist/tools/repo-actions.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Mutable repo operations: submodule update and commit.
+ *
+ * These are intentionally separate from repos.ts (read-only status)
+ * to make the mutation surface explicit.
+ */
+export interface SubmoduleUpdateResult {
+    success: boolean;
+    submodule: string;
+    repo: string;
+    old_sha: string | null;
+    new_sha: string | null;
+    commits_pulled: number;
+    changed_files: string[];
+    staged: boolean;
+    error?: string;
+}
+export interface CommitResult {
+    success: boolean;
+    repo: string;
+    commit_hash: string | null;
+    message: string;
+    files_committed: string[];
+    error?: string;
+}
+/**
+ * Update a submodule in a parent repo to the latest commit on its tracking branch.
+ *
+ * Workflow:
+ * 1. cd into submodule
+ * 2. git fetch origin
+ * 3. git checkout origin/<branch> (default: main)
+ * 4. cd back to parent, git add <submodule>
+ * 5. Report old→new SHA, commits pulled, files changed
+ */
+export declare function crosspadSubmoduleUpdate(submodule: string, repo: string, branch?: string): SubmoduleUpdateResult;
+/**
+ * Commit changes in a specific repo.
+ *
+ * Safety:
+ * - Refuses if working tree has merge conflicts
+ * - If files specified, stages only those files
+ * - If no files specified, commits whatever is currently staged
+ * - Never pushes to remote
+ */
+export declare function crosspadCommit(repo: string, message: string, files?: string[]): CommitResult;

package/dist/tools/repo-actions.js

@@ -0,0 +1,273 @@
+/**
+ * Mutable repo operations: submodule update and commit.
+ *
+ * These are intentionally separate from repos.ts (read-only status)
+ * to make the mutation surface explicit.
+ */
+import fs from "fs";
+import path from "path";
+import { getRepos } from "../config.js";
+import { runCommand } from "../utils/exec.js";
+import { getHead } from "../utils/git.js";
+const REPO_ALIASES = {
+    idf: "platform-idf",
+    pc: "crosspad-pc",
+    arduino: "ESP32-S3",
+    core: "crosspad-core",
+    gui: "crosspad-gui",
+};
+function resolveRepo(repo) {
+    const repos = getRepos();
+    const canonical = REPO_ALIASES[repo] ?? repo;
+    if (repos[canonical]) {
+        return { name: canonical, root: repos[canonical] };
+    }
+    // Try partial match
+    for (const [name, repoPath] of Object.entries(repos)) {
+        if (name.toLowerCase().includes(repo.toLowerCase())) {
+            return { name, root: repoPath };
+        }
+    }
+    return null;
+}
+function getAvailableRepoNames() {
+    return Object.keys(getRepos());
+}
+// ═══════════════════════════════════════════════════════════════════════
+// SUBMODULE PATHS — where each submodule lives inside parent repos
+// ═══════════════════════════════════════════════════════════════════════
+const SUBMODULE_PATHS = {
+    "platform-idf": {
+        "crosspad-core": "components/crosspad-core",
+        "crosspad-gui": "components/crosspad-gui",
+        "crosspad-instructions": "components/crosspad-instructions",
+        "crosspad-sampler": "components/crosspad-sampler",
+    },
+    "crosspad-pc": {
+        "crosspad-core": "crosspad-core",
+        "crosspad-gui": "crosspad-gui",
+    },
+    "ESP32-S3": {
+        "crosspad-core": "lib/crosspad-core",
+        "crosspad-gui": "lib/crosspad-gui",
+    },
+};
+function getSubmodulePath(repoName, submodule) {
+    return SUBMODULE_PATHS[repoName]?.[submodule] ?? null;
+}
+// ═══════════════════════════════════════════════════════════════════════
+// SUBMODULE UPDATE
+// ═══════════════════════════════════════════════════════════════════════
+/**
+ * Update a submodule in a parent repo to the latest commit on its tracking branch.
+ *
+ * Workflow:
+ * 1. cd into submodule
+ * 2. git fetch origin
+ * 3. git checkout origin/<branch> (default: main)
+ * 4. cd back to parent, git add <submodule>
+ * 5. Report old→new SHA, commits pulled, files changed
+ */
+export function crosspadSubmoduleUpdate(submodule, repo, branch = "main") {
+    const resolvedRepo = resolveRepo(repo);
+    if (!resolvedRepo) {
+        return {
+            success: false,
+            submodule,
+            repo,
+            old_sha: null,
+            new_sha: null,
+            commits_pulled: 0,
+            changed_files: [],
+            staged: false,
+            error: `Unknown repo "${repo}". Available: ${getAvailableRepoNames().join(", ")}`,
+        };
+    }
+    const subPath = getSubmodulePath(resolvedRepo.name, submodule);
+    if (!subPath) {
+        const knownSubs = Object.keys(SUBMODULE_PATHS[resolvedRepo.name] ?? {});
+        return {
+            success: false,
+            submodule,
+            repo: resolvedRepo.name,
+            old_sha: null,
+            new_sha: null,
+            commits_pulled: 0,
+            changed_files: [],
+            staged: false,
+            error: `Submodule "${submodule}" not found in ${resolvedRepo.name}. Known: ${knownSubs.join(", ")}`,
+        };
+    }
+    const fullSubPath = path.join(resolvedRepo.root, subPath);
+    if (!fs.existsSync(fullSubPath)) {
+        return {
+            success: false,
+            submodule,
+            repo: resolvedRepo.name,
+            old_sha: null,
+            new_sha: null,
+            commits_pulled: 0,
+            changed_files: [],
+            staged: false,
+            error: `Submodule directory not found: ${fullSubPath}`,
+        };
+    }
+    // Get current SHA
+    const oldSha = getHead(fullSubPath);
+    // Fetch latest
+    const fetchResult = runCommand("git fetch origin", fullSubPath, 30_000);
+    if (!fetchResult.success) {
+        return {
+            success: false,
+            submodule,
+            repo: resolvedRepo.name,
+            old_sha: oldSha,
+            new_sha: null,
+            commits_pulled: 0,
+            changed_files: [],
+            staged: false,
+            error: `git fetch failed: ${fetchResult.stderr}`,
+        };
+    }
+    // Checkout target
+    const checkoutResult = runCommand(`git checkout origin/${branch}`, fullSubPath, 15_000);
+    if (!checkoutResult.success) {
+        return {
+            success: false,
+            submodule,
+            repo: resolvedRepo.name,
+            old_sha: oldSha,
+            new_sha: null,
+            commits_pulled: 0,
+            changed_files: [],
+            staged: false,
+            error: `git checkout origin/${branch} failed: ${checkoutResult.stderr}`,
+        };
+    }
+    // Get new SHA
+    const newSha = getHead(fullSubPath);
+    // Count commits between old and new
+    let commitsPulled = 0;
+    let changedFiles = [];
+    if (oldSha && newSha && oldSha !== newSha) {
+        const countResult = runCommand(`git rev-list --count ${oldSha}..${newSha}`, fullSubPath);
+        if (countResult.success) {
+            commitsPulled = parseInt(countResult.stdout.trim(), 10) || 0;
+        }
+        const diffResult = runCommand(`git diff --name-only ${oldSha}..${newSha}`, fullSubPath);
+        if (diffResult.success) {
+            changedFiles = diffResult.stdout
+                .trim()
+                .split("\n")
+                .filter((l) => l.length > 0);
+        }
+    }
+    // Stage the submodule update in parent repo
+    const addResult = runCommand(`git add ${subPath}`, resolvedRepo.root, 10_000);
+    return {
+        success: true,
+        submodule,
+        repo: resolvedRepo.name,
+        old_sha: oldSha,
+        new_sha: newSha,
+        commits_pulled: commitsPulled,
+        changed_files: changedFiles,
+        staged: addResult.success,
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════
+// COMMIT
+// ═══════════════════════════════════════════════════════════════════════
+/**
+ * Commit changes in a specific repo.
+ *
+ * Safety:
+ * - Refuses if working tree has merge conflicts
+ * - If files specified, stages only those files
+ * - If no files specified, commits whatever is currently staged
+ * - Never pushes to remote
+ */
+export function crosspadCommit(repo, message, files) {
+    const resolvedRepo = resolveRepo(repo);
+    if (!resolvedRepo) {
+        return {
+            success: false,
+            repo,
+            commit_hash: null,
+            message,
+            files_committed: [],
+            error: `Unknown repo "${repo}". Available: ${getAvailableRepoNames().join(", ")}`,
+        };
+    }
+    // Check for merge conflicts
+    const statusResult = runCommand("git status --porcelain", resolvedRepo.root);
+    if (statusResult.success) {
+        const conflicted = statusResult.stdout
+            .split("\n")
+            .filter((l) => l.startsWith("UU") || l.startsWith("AA") || l.startsWith("DD"));
+        if (conflicted.length > 0) {
+            return {
+                success: false,
+                repo: resolvedRepo.name,
+                commit_hash: null,
+                message,
+                files_committed: [],
+                error: `Merge conflicts detected:\n${conflicted.join("\n")}\nResolve conflicts before committing.`,
+            };
+        }
+    }
+    // Stage specific files if provided
+    if (files && files.length > 0) {
+        const fileList = files.map((f) => `"${f}"`).join(" ");
+        const addResult = runCommand(`git add ${fileList}`, resolvedRepo.root, 10_000);
+        if (!addResult.success) {
+            return {
+                success: false,
+                repo: resolvedRepo.name,
+                commit_hash: null,
+                message,
+                files_committed: [],
+                error: `git add failed: ${addResult.stderr}`,
+            };
+        }
+    }
+    // Check something is staged
+    const diffResult = runCommand("git diff --cached --name-only", resolvedRepo.root);
+    const stagedFiles = diffResult.success
+        ? diffResult.stdout.trim().split("\n").filter((l) => l.length > 0)
+        : [];
+    if (stagedFiles.length === 0) {
+        return {
+            success: false,
+            repo: resolvedRepo.name,
+            commit_hash: null,
+            message,
+            files_committed: [],
+            error: "Nothing staged to commit. Stage files first or specify files parameter.",
+        };
+    }
+    // Commit — escape message for shell safety
+    const escapedMessage = message.replace(/'/g, "'\\''");
+    const commitResult = runCommand(`git commit -m '${escapedMessage}'`, resolvedRepo.root, 30_000);
+    if (!commitResult.success) {
+        return {
+            success: false,
+            repo: resolvedRepo.name,
+            commit_hash: null,
+            message,
+            files_committed: stagedFiles,
+            error: `git commit failed: ${commitResult.stderr || commitResult.stdout}`,
+        };
+    }
+    // Get the new commit hash
+    const hashResult = runCommand("git rev-parse HEAD", resolvedRepo.root);
+    const commitHash = hashResult.success ? hashResult.stdout.trim() : null;
+    return {
+        success: true,
+        repo: resolvedRepo.name,
+        commit_hash: commitHash,
+        message,
+        files_committed: stagedFiles,
+    };
+}
+//# sourceMappingURL=repo-actions.js.map