crosspad-mcp-server 4.0.0

package/dist/tools/test.js

@@ -0,0 +1,227 @@
+import fs from "fs";
+import path from "path";
+import { CROSSPAD_PC_ROOT, VCPKG_TOOLCHAIN } from "../config.js";
+import { runBuild, runBuildStream } from "../utils/exec.js";
+import { IS_WINDOWS } from "../config.js";
+const TESTS_DIR = path.join(CROSSPAD_PC_ROOT, "tests");
+const BIN_DIR = path.join(CROSSPAD_PC_ROOT, "bin");
+const EXE_EXT = IS_WINDOWS ? ".exe" : "";
+const TEST_EXE = path.join(BIN_DIR, `crosspad_tests${EXE_EXT}`);
+/**
+ * Build and run the crosspad test suite (Catch2).
+ * If tests/ dir doesn't exist, offers to scaffold it.
+ */
+export async function crosspadTest(filter = "", listOnly = false, onLine) {
+    const startTime = Date.now();
+    // Check if test infrastructure exists
+    if (!fs.existsSync(TESTS_DIR)) {
+        return {
+            success: false,
+            tests_found: false,
+            build_output: "",
+            test_output: `No tests/ directory found. Use crosspad_test_scaffold to create test infrastructure.`,
+            passed: 0,
+            failed: 0,
+            errors: ["tests/ directory not found"],
+            duration_seconds: 0,
+        };
+    }
+    // Ensure cmake is configured with BUILD_TESTING=ON
+    onLine?.("stdout", "[crosspad] Configuring cmake with BUILD_TESTING=ON...");
+    const generator = process.env.CMAKE_GENERATOR || (IS_WINDOWS ? "Ninja" : "");
+    const genFlag = generator ? ` -G ${generator}` : "";
+    const configCmd = `cmake -B build${genFlag} -DCMAKE_TOOLCHAIN_FILE=${VCPKG_TOOLCHAIN} -DCMAKE_BUILD_TYPE=Debug -DBUILD_TESTING=ON`;
+    let configResult;
+    if (onLine) {
+        configResult = await runBuildStream(configCmd, CROSSPAD_PC_ROOT, onLine, 120_000);
+    }
+    else {
+        configResult = runBuild(configCmd, CROSSPAD_PC_ROOT, 120_000);
+    }
+    if (!configResult.success) {
+        return {
+            success: false,
+            tests_found: true,
+            build_output: (configResult.stdout + "\n" + configResult.stderr).slice(-3000),
+            test_output: "",
+            passed: 0,
+            failed: 0,
+            errors: parseErrors(configResult.stdout + "\n" + configResult.stderr),
+            duration_seconds: (Date.now() - startTime) / 1000,
+        };
+    }
+    // Build tests target
+    onLine?.("stdout", "[crosspad] Building test target...");
+    const buildCmd = "cmake --build build --target crosspad_tests";
+    let buildResult;
+    if (onLine) {
+        buildResult = await runBuildStream(buildCmd, CROSSPAD_PC_ROOT, onLine, 300_000);
+    }
+    else {
+        buildResult = runBuild(buildCmd, CROSSPAD_PC_ROOT, 300_000);
+    }
+    if (!buildResult.success) {
+        return {
+            success: false,
+            tests_found: true,
+            build_output: (buildResult.stdout + "\n" + buildResult.stderr).slice(-3000),
+            test_output: "",
+            passed: 0,
+            failed: 0,
+            errors: parseErrors(buildResult.stdout + "\n" + buildResult.stderr),
+            duration_seconds: (Date.now() - startTime) / 1000,
+        };
+    }
+    if (!fs.existsSync(TEST_EXE)) {
+        return {
+            success: false,
+            tests_found: true,
+            build_output: buildResult.stdout.slice(-1000),
+            test_output: "Test executable not found after build",
+            passed: 0,
+            failed: 0,
+            errors: [`${TEST_EXE} not found`],
+            duration_seconds: (Date.now() - startTime) / 1000,
+        };
+    }
+    // Run tests
+    let testCmd = `"${TEST_EXE}"`;
+    if (listOnly) {
+        testCmd += " --list-tests";
+    }
+    else {
+        testCmd += " --reporter compact";
+        if (filter) {
+            testCmd += ` "${filter}"`;
+        }
+    }
+    onLine?.("stdout", "[crosspad] Running tests...");
+    let testResult;
+    if (onLine) {
+        testResult = await runBuildStream(testCmd, CROSSPAD_PC_ROOT, onLine, 120_000);
+    }
+    else {
+        testResult = runBuild(testCmd, CROSSPAD_PC_ROOT, 120_000);
+    }
+    const testOutput = testResult.stdout + "\n" + testResult.stderr;
+    // Parse Catch2 compact output
+    const { passed, failed } = parseCatch2Output(testOutput);
+    const result = {
+        success: testResult.success,
+        tests_found: true,
+        build_output: buildResult.stdout.slice(-500),
+        test_output: testOutput.slice(-5000),
+        passed,
+        failed,
+        errors: testResult.success ? [] : parseErrors(testOutput),
+        duration_seconds: (Date.now() - startTime) / 1000,
+    };
+    onLine?.("stdout", `[crosspad] Tests ${result.success ? "PASSED" : "FAILED"}: ${passed} passed, ${failed} failed (${result.duration_seconds.toFixed(1)}s)`);
+    return result;
+}
+/**
+ * Scaffold the test infrastructure: CMakeLists.txt additions + sample test file.
+ * Returns file contents — does NOT write to disk.
+ */
+export function crosspadTestScaffold() {
+    const files = {};
+    // tests/CMakeLists.txt
+    files["tests/CMakeLists.txt"] = `# CrossPad test suite — Catch2 v3
+Include(FetchContent)
+
+FetchContent_Declare(
+  Catch2
+  GIT_REPOSITORY https://github.com/catchorg/Catch2.git
+  GIT_TAG        v3.5.2
+)
+FetchContent_MakeAvailable(Catch2)
+
+# Collect test sources
+file(GLOB_RECURSE TEST_SOURCES "\${CMAKE_CURRENT_SOURCE_DIR}/*.cpp")
+
+add_executable(crosspad_tests \${TEST_SOURCES})
+
+target_link_libraries(crosspad_tests PRIVATE
+  Catch2::Catch2WithMain
+)
+
+# Include crosspad-core headers (for testing core logic)
+target_include_directories(crosspad_tests PRIVATE
+  \${CMAKE_SOURCE_DIR}/crosspad-core/include
+  \${CMAKE_SOURCE_DIR}/crosspad-gui/include
+  \${CMAKE_SOURCE_DIR}/src
+)
+
+# Same defines as main target
+target_compile_definitions(crosspad_tests PRIVATE
+  PLATFORM_PC=1
+  CP_LCD_HOR_RES=320
+  CP_LCD_VER_RES=240
+)
+
+# Add crosspad-core sources we want to test (non-platform-specific)
+# Add individual source files as needed:
+# target_sources(crosspad_tests PRIVATE
+#   \${CMAKE_SOURCE_DIR}/crosspad-core/src/SomeFile.cpp
+# )
+
+include(CTest)
+include(Catch)
+catch_discover_tests(crosspad_tests)
+`;
+    // tests/test_pad_manager.cpp — sample test
+    files["tests/test_pad_manager.cpp"] = `#include <catch2/catch_test_macros.hpp>
+
+// Example: test crosspad-core types without full platform init
+// #include <crosspad/pad/PadManager.hpp>
+// #include <crosspad/platform/PlatformCapabilities.hpp>
+
+TEST_CASE("Sanity check", "[core]") {
+    REQUIRE(1 + 1 == 2);
+}
+
+// TEST_CASE("PlatformCapabilities bitflags", "[core][capabilities]") {
+//     using crosspad::Capability;
+//     using crosspad::setPlatformCapabilities;
+//     using crosspad::hasCapability;
+//     using crosspad::hasAnyCapability;
+//
+//     setPlatformCapabilities(Capability::Midi | Capability::Pads);
+//
+//     REQUIRE(hasCapability(Capability::Midi));
+//     REQUIRE(hasCapability(Capability::Pads));
+//     REQUIRE_FALSE(hasCapability(Capability::AudioOut));
+//     REQUIRE(hasAnyCapability(Capability::Midi | Capability::AudioOut));
+// }
+`;
+    // Patch for root CMakeLists.txt
+    const cmakePatch = `
+# Add this near the end of your CMakeLists.txt, before any final install/packaging:
+# --- Test suite ---
+if(EXISTS "\${CMAKE_SOURCE_DIR}/tests/CMakeLists.txt")
+  add_subdirectory(tests)
+endif()
+`;
+    return { files, cmake_patch: cmakePatch };
+}
+function parseCatch2Output(output) {
+    // Catch2 compact reporter: "Passed X test(s)" / "Failed X test(s)"
+    const passedMatch = output.match(/(\d+)\s+assertion[s]?\s+.*passed/i) ||
+        output.match(/All tests passed\s*\((\d+)/i);
+    const failedMatch = output.match(/(\d+)\s+assertion[s]?\s+.*failed/i) ||
+        output.match(/test cases?:\s*\d+\s*\|\s*(\d+)\s+failed/i);
+    return {
+        passed: passedMatch ? parseInt(passedMatch[1], 10) : 0,
+        failed: failedMatch ? parseInt(failedMatch[1], 10) : 0,
+    };
+}
+function parseErrors(output) {
+    const errors = [];
+    for (const line of output.split("\n")) {
+        if (/\berror\b/i.test(line) && !line.includes("error(s)")) {
+            errors.push(line.trim());
+        }
+    }
+    return errors.slice(0, 20);
+}
+//# sourceMappingURL=test.js.map

package/dist/tools/test.js.map

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

package/dist/utils/exec.d.ts

@@ -0,0 +1,58 @@
+/** Callback invoked for each line of stdout/stderr during streaming exec. */
+export type OnLine = (stream: "stdout" | "stderr", line: string) => void;
+/**
+ * Capture MSVC environment by running vcvarsall.bat and parsing `set` output.
+ * Cached for the lifetime of the server process. Windows-only.
+ */
+export declare function getMsvcEnv(): Record<string, string>;
+export interface ExecResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    durationMs: number;
+}
+/**
+ * Run a command with the MSVC environment, capturing output.
+ */
+export declare function runWithMsvc(cmd: string, cwd: string, timeoutMs?: number): ExecResult;
+/**
+ * Run a command in the default shell, capturing output.
+ */
+export declare function runCommand(cmd: string, cwd: string, timeoutMs?: number): ExecResult;
+/**
+ * Run a command with the MSVC environment, streaming output line-by-line.
+ */
+export declare function runWithMsvcStream(cmd: string, cwd: string, onLine: OnLine, timeoutMs?: number): Promise<ExecResult>;
+/**
+ * Run a command in the default shell, streaming output line-by-line.
+ */
+export declare function runCommandStream(cmd: string, cwd: string, onLine: OnLine, timeoutMs?: number): Promise<ExecResult>;
+/**
+ * Capture ESP-IDF environment by running export.bat and parsing `set` output.
+ * Must unset MSYSTEM to prevent ESP-IDF from rejecting MSYS shells.
+ * Cached for the lifetime of the server process. Windows-only.
+ */
+export declare function getIdfEnv(): Record<string, string>;
+/**
+ * Run a command with the ESP-IDF environment, capturing output.
+ */
+export declare function runWithIdf(cmd: string, cwd: string, timeoutMs?: number): ExecResult;
+/**
+ * Run a command with the ESP-IDF environment, streaming output line-by-line.
+ */
+export declare function runWithIdfStream(cmd: string, cwd: string, onLine: OnLine, timeoutMs?: number): Promise<ExecResult>;
+/**
+ * Run a build command with the appropriate environment for the current platform.
+ * Windows: MSVC env + cmd.exe shell. Unix: default shell.
+ */
+export declare function runBuild(cmd: string, cwd: string, timeoutMs?: number): ExecResult;
+/**
+ * Run a build command with streaming output, platform-aware.
+ * Windows: MSVC env + cmd.exe shell. Unix: default shell.
+ */
+export declare function runBuildStream(cmd: string, cwd: string, onLine: OnLine, timeoutMs?: number): Promise<ExecResult>;
+/**
+ * Spawn a detached process (for crosspad_run).
+ */
+export declare function spawnDetached(exe: string, args: string[], cwd: string): number | null;

package/dist/utils/exec.js

@@ -0,0 +1,292 @@
+import { execSync, spawn } from "child_process";
+import { VCVARSALL, IS_WINDOWS, IDF_PATH } from "../config.js";
+let cachedMsvcEnv = null;
+/**
+ * Capture MSVC environment by running vcvarsall.bat and parsing `set` output.
+ * Cached for the lifetime of the server process. Windows-only.
+ */
+export function getMsvcEnv() {
+    if (!IS_WINDOWS) {
+        return { ...process.env };
+    }
+    if (cachedMsvcEnv)
+        return cachedMsvcEnv;
+    const cmd = `"${VCVARSALL}" x64 >nul 2>&1 && set`;
+    const output = execSync(cmd, {
+        shell: "cmd.exe",
+        encoding: "utf-8",
+        timeout: 30_000,
+    });
+    const env = {};
+    for (const line of output.split("\n")) {
+        const eq = line.indexOf("=");
+        if (eq > 0) {
+            env[line.slice(0, eq)] = line.slice(eq + 1).trimEnd();
+        }
+    }
+    cachedMsvcEnv = env;
+    return env;
+}
+/**
+ * Run a command with the MSVC environment, capturing output.
+ */
+export function runWithMsvc(cmd, cwd, timeoutMs = 300_000) {
+    const env = getMsvcEnv();
+    const start = Date.now();
+    try {
+        const stdout = execSync(cmd, {
+            cwd,
+            env,
+            shell: "cmd.exe",
+            encoding: "utf-8",
+            timeout: timeoutMs,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return {
+            success: true,
+            stdout: normalizeLineEndings(stdout),
+            stderr: "",
+            exitCode: 0,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            stdout: normalizeLineEndings(err.stdout?.toString() ?? ""),
+            stderr: normalizeLineEndings(err.stderr?.toString() ?? ""),
+            exitCode: err.status ?? 1,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+/**
+ * Run a command in the default shell, capturing output.
+ */
+export function runCommand(cmd, cwd, timeoutMs = 60_000) {
+    const start = Date.now();
+    try {
+        const stdout = execSync(cmd, {
+            cwd,
+            encoding: "utf-8",
+            timeout: timeoutMs,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return {
+            success: true,
+            stdout: normalizeLineEndings(stdout),
+            stderr: "",
+            exitCode: 0,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            stdout: normalizeLineEndings(err.stdout?.toString() ?? ""),
+            stderr: normalizeLineEndings(err.stderr?.toString() ?? ""),
+            exitCode: err.status ?? 1,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════
+// STREAMING VARIANTS (spawn-based, line-by-line callbacks)
+// ═══════════════════════════════════════════════════════════════════════
+/**
+ * Helper: spawn a process and stream stdout/stderr line-by-line via onLine.
+ * Returns the same ExecResult as the sync variants.
+ */
+function spawnStreaming(cmd, cwd, env, shell, onLine, timeoutMs) {
+    return new Promise((resolve) => {
+        const start = Date.now();
+        const child = spawn(cmd, [], {
+            cwd,
+            env,
+            shell,
+            stdio: ["pipe", "pipe", "pipe"],
+            windowsHide: true,
+        });
+        let stdout = "";
+        let stderr = "";
+        let stdoutBuf = "";
+        let stderrBuf = "";
+        let killed = false;
+        const timer = setTimeout(() => {
+            killed = true;
+            child.kill("SIGTERM");
+        }, timeoutMs);
+        function flushLines(buf, stream) {
+            const parts = buf.split("\n");
+            // Last part is incomplete — keep it in buffer
+            for (let i = 0; i < parts.length - 1; i++) {
+                const line = parts[i].replace(/\r$/, "");
+                onLine(stream, line);
+            }
+            return parts[parts.length - 1];
+        }
+        child.stdout?.on("data", (chunk) => {
+            const text = chunk.toString();
+            stdout += text;
+            stdoutBuf += text;
+            stdoutBuf = flushLines(stdoutBuf, "stdout");
+        });
+        child.stderr?.on("data", (chunk) => {
+            const text = chunk.toString();
+            stderr += text;
+            stderrBuf += text;
+            stderrBuf = flushLines(stderrBuf, "stderr");
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            // Flush remaining partial lines
+            if (stdoutBuf.length > 0)
+                onLine("stdout", stdoutBuf.replace(/\r$/, ""));
+            if (stderrBuf.length > 0)
+                onLine("stderr", stderrBuf.replace(/\r$/, ""));
+            resolve({
+                success: killed ? false : code === 0,
+                stdout: normalizeLineEndings(stdout),
+                stderr: normalizeLineEndings(stderr),
+                exitCode: killed ? -1 : (code ?? 1),
+                durationMs: Date.now() - start,
+            });
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            resolve({
+                success: false,
+                stdout: normalizeLineEndings(stdout),
+                stderr: normalizeLineEndings(stderr + "\n" + err.message),
+                exitCode: 1,
+                durationMs: Date.now() - start,
+            });
+        });
+    });
+}
+/**
+ * Run a command with the MSVC environment, streaming output line-by-line.
+ */
+export function runWithMsvcStream(cmd, cwd, onLine, timeoutMs = 300_000) {
+    const env = getMsvcEnv();
+    return spawnStreaming(cmd, cwd, env, "cmd.exe", onLine, timeoutMs);
+}
+/**
+ * Run a command in the default shell, streaming output line-by-line.
+ */
+export function runCommandStream(cmd, cwd, onLine, timeoutMs = 60_000) {
+    return spawnStreaming(cmd, cwd, undefined, true, onLine, timeoutMs);
+}
+// ═══════════════════════════════════════════════════════════════════════
+// ESP-IDF ENVIRONMENT
+// ═══════════════════════════════════════════════════════════════════════
+let cachedIdfEnv = null;
+/**
+ * Capture ESP-IDF environment by running export.bat and parsing `set` output.
+ * Must unset MSYSTEM to prevent ESP-IDF from rejecting MSYS shells.
+ * Cached for the lifetime of the server process. Windows-only.
+ */
+export function getIdfEnv() {
+    if (!IS_WINDOWS) {
+        return { ...process.env };
+    }
+    if (cachedIdfEnv)
+        return cachedIdfEnv;
+    const exportBat = `${IDF_PATH}\\export.bat`;
+    const cmd = `set MSYSTEM=&& set PYTHONIOENCODING=utf-8&& call ${exportBat} >nul 2>&1 && set`;
+    const output = execSync(cmd, {
+        shell: "cmd.exe",
+        encoding: "utf-8",
+        timeout: 60_000,
+    });
+    const env = {};
+    for (const line of output.split("\n")) {
+        const eq = line.indexOf("=");
+        if (eq > 0) {
+            env[line.slice(0, eq)] = line.slice(eq + 1).trimEnd();
+        }
+    }
+    cachedIdfEnv = env;
+    return env;
+}
+/**
+ * Run a command with the ESP-IDF environment, capturing output.
+ */
+export function runWithIdf(cmd, cwd, timeoutMs = 600_000) {
+    const env = getIdfEnv();
+    const start = Date.now();
+    try {
+        const stdout = execSync(cmd, {
+            cwd,
+            env,
+            shell: "cmd.exe",
+            encoding: "utf-8",
+            timeout: timeoutMs,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return {
+            success: true,
+            stdout: normalizeLineEndings(stdout),
+            stderr: "",
+            exitCode: 0,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            stdout: normalizeLineEndings(err.stdout?.toString() ?? ""),
+            stderr: normalizeLineEndings(err.stderr?.toString() ?? ""),
+            exitCode: err.status ?? 1,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+/**
+ * Run a command with the ESP-IDF environment, streaming output line-by-line.
+ */
+export function runWithIdfStream(cmd, cwd, onLine, timeoutMs = 600_000) {
+    const env = getIdfEnv();
+    return spawnStreaming(cmd, cwd, env, "cmd.exe", onLine, timeoutMs);
+}
+// ═══════════════════════════════════════════════════════════════════════
+// PLATFORM-AGNOSTIC BUILD WRAPPERS
+// ═══════════════════════════════════════════════════════════════════════
+/**
+ * Run a build command with the appropriate environment for the current platform.
+ * Windows: MSVC env + cmd.exe shell. Unix: default shell.
+ */
+export function runBuild(cmd, cwd, timeoutMs = 300_000) {
+    if (IS_WINDOWS) {
+        return runWithMsvc(cmd, cwd, timeoutMs);
+    }
+    return runCommand(cmd, cwd, timeoutMs);
+}
+/**
+ * Run a build command with streaming output, platform-aware.
+ * Windows: MSVC env + cmd.exe shell. Unix: default shell.
+ */
+export function runBuildStream(cmd, cwd, onLine, timeoutMs = 300_000) {
+    if (IS_WINDOWS) {
+        return runWithMsvcStream(cmd, cwd, onLine, timeoutMs);
+    }
+    return runCommandStream(cmd, cwd, onLine, timeoutMs);
+}
+/** Strip \r from Windows line endings */
+function normalizeLineEndings(s) {
+    return s.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+}
+/**
+ * Spawn a detached process (for crosspad_run).
+ */
+export function spawnDetached(exe, args, cwd) {
+    const opts = {
+        cwd,
+        detached: true,
+        stdio: "ignore",
+    };
+    const child = spawn(exe, args, opts);
+    child.unref();
+    return child.pid ?? null;
+}
+//# sourceMappingURL=exec.js.map

package/dist/utils/exec.js.map

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

package/dist/utils/git.d.ts

@@ -0,0 +1,10 @@
+export interface RepoStatus {
+    name: string;
+    path: string;
+    branch: string;
+    head: string;
+    dirtyFiles: string[];
+}
+export declare function getRepoStatus(name: string, repoPath: string): RepoStatus;
+export declare function getSubmodulePin(repoPath: string, submodule: string): string | null;
+export declare function getHead(repoPath: string): string | null;

package/dist/utils/git.js

@@ -0,0 +1,29 @@
+import { runCommand } from "./exec.js";
+export function getRepoStatus(name, repoPath) {
+    const branch = runCommand("git branch --show-current", repoPath);
+    const log = runCommand("git log --oneline -1", repoPath);
+    const status = runCommand("git status --porcelain", repoPath);
+    return {
+        name,
+        path: repoPath,
+        branch: branch.stdout.trim(),
+        head: log.stdout.trim(),
+        dirtyFiles: status.stdout
+            .trim()
+            .split("\n")
+            .filter((l) => l.length > 0),
+    };
+}
+export function getSubmodulePin(repoPath, submodule) {
+    const result = runCommand(`git submodule status ${submodule}`, repoPath);
+    if (!result.success)
+        return null;
+    // Output format: " abc1234 submodule-name (desc)" or "+abc1234 ..."
+    const match = result.stdout.match(/[+ -]?([0-9a-f]+)/);
+    return match ? match[1] : null;
+}
+export function getHead(repoPath) {
+    const result = runCommand("git rev-parse HEAD", repoPath);
+    return result.success ? result.stdout.trim() : null;
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAUvC,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAAgB;IAC1D,MAAM,MAAM,GAAG,UAAU,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,UAAU,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,UAAU,CAAC,wBAAwB,EAAE,QAAQ,CAAC,CAAC;IAE9D,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAC5B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;QACvB,UAAU,EAAE,MAAM,CAAC,MAAM;aACtB,IAAI,EAAE;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,SAAiB;IAEjB,MAAM,MAAM,GAAG,UAAU,CACvB,wBAAwB,SAAS,EAAE,EACnC,QAAQ,CACT,CAAC;IACF,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IACjC,oEAAoE;IACpE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,QAAgB;IACtC,MAAM,MAAM,GAAG,UAAU,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC"}

package/dist/utils/remote-client.d.ts

@@ -0,0 +1,17 @@
+/**
+ * TCP client for communicating with the CrossPad simulator's remote control server.
+ * Protocol: newline-delimited JSON over TCP on localhost:19840.
+ */
+export interface RemoteResponse {
+    ok: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Send a JSON command to the running simulator and return the response.
+ * Opens a fresh TCP connection per call (simple, stateless).
+ */
+export declare function sendRemoteCommand(command: Record<string, unknown>): Promise<RemoteResponse>;
+/**
+ * Check if the simulator's remote control server is reachable.
+ */
+export declare function isSimulatorRunning(): Promise<boolean>;