@kvell007/embed-labs-local-bridge 0.1.0-alpha.0 → 0.1.0-alpha.10

package/dist/adapters/debug.js

@@ -54,8 +54,8 @@ async function scanDebugTool(spec, observedAt) {
         available: resolvedPath !== undefined,
         resolved_path: resolvedPath,
         summary: resolvedPath
-            ? `Found ${spec.command} on PATH.`
-            : `${spec.command} was not found on PATH.`
+            ? `Found ${spec.command} on PATH or an Embed Labs local toolchain path.`
+            : `${spec.command} was not found on PATH or an Embed Labs local toolchain path.`
     });
     if (!resolvedPath) {
         return {
@@ -64,7 +64,7 @@ async function scanDebugTool(spec, observedAt) {
             command: spec.command,
             available: false,
             evidence,
-            summary_for_user: `${spec.display_name} is not available on PATH.`
+            summary_for_user: `${spec.display_name} is not available on PATH or an Embed Labs local toolchain path.`
         };
     }
     const versionResult = await runCommand(resolvedPath, spec.version_args, VERSION_TIMEOUT_MS);

package/dist/adapters/debug.js.map

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

package/dist/adapters/logo.d.ts

@@ -0,0 +1,2 @@
+import type { BootLogoModifyRequest, BootLogoModifyResult } from "@embed-labs/protocol";
+export declare function prepareBootLogoModification(request: BootLogoModifyRequest): Promise<BootLogoModifyResult>;

package/dist/adapters/logo.js

@@ -0,0 +1,108 @@
+import { createHash, randomUUID } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { copyFile, mkdir, mkdtemp, stat, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { basename, extname, join, parse, resolve } from "node:path";
+export async function prepareBootLogoModification(request) {
+    const observedAt = new Date().toISOString();
+    const logoPath = resolve(request.logo_path);
+    const logoStat = await requireRegularFile(logoPath, "logo_path");
+    const kernelLogoPath = request.kernel_logo_path ? resolve(request.kernel_logo_path) : undefined;
+    const kernelLogoStat = kernelLogoPath ? await requireRegularFile(kernelLogoPath, "kernel_logo_path") : undefined;
+    const inputImagePath = request.image_path ? resolve(request.image_path) : undefined;
+    const inputImageStat = inputImagePath ? await requireRegularFile(inputImagePath, "image_path") : undefined;
+    const outputDir = request.output_dir
+        ? resolve(request.output_dir)
+        : await mkdtemp(join(tmpdir(), "embed-boot-logo-"));
+    await mkdir(outputDir, { recursive: true });
+    const unique = `${Date.now()}-${randomUUID().slice(0, 8)}`;
+    const sourceName = inputImagePath ? basename(inputImagePath) : "boot-logo-manifest.json";
+    const requestedStem = request.output_name ? parse(request.output_name).name : parse(sourceName).name;
+    const safeStem = safeFileStem(requestedStem || "boot-logo");
+    const imageExtension = inputImagePath ? extname(inputImagePath) || ".img" : undefined;
+    const modifiedImagePath = inputImagePath ? join(outputDir, `${safeStem}-${unique}${imageExtension}`) : undefined;
+    const manifestPath = join(outputDir, `${safeStem}-${unique}.boot-logo.json`);
+    const logoSha256 = await sha256(logoPath);
+    const kernelLogoSha256 = kernelLogoPath ? await sha256(kernelLogoPath) : undefined;
+    const inputImageSha256 = inputImagePath ? await sha256(inputImagePath) : undefined;
+    if (inputImagePath && modifiedImagePath) {
+        await copyFile(inputImagePath, modifiedImagePath);
+    }
+    const manifest = {
+        schema_version: "0.1",
+        kind: "boot-logo-modification",
+        mode: "local_manifest_mvp",
+        replacement_applied: false,
+        board_id: request.board_id,
+        variant_id: request.variant_id,
+        input_image_path: inputImagePath,
+        modified_image_path: modifiedImagePath,
+        logo_path: logoPath,
+        kernel_logo_path: kernelLogoPath,
+        rotate: request.rotate,
+        scale: request.scale,
+        input_image_sha256: inputImageSha256,
+        input_image_size_bytes: inputImageStat?.size,
+        logo_sha256: logoSha256,
+        logo_size_bytes: logoStat.size,
+        kernel_logo_sha256: kernelLogoSha256,
+        kernel_logo_size_bytes: kernelLogoStat?.size,
+        free_for_registered_users: true,
+        requires_server_workspace: false,
+        observed_at: observedAt,
+        notes: [
+            "This local free operation validates inputs and creates an isolated artifact bundle for boot-logo replacement.",
+            "It does not allocate a server workspace and does not flash a board.",
+            "Board-profile repack/flash workers must consume this manifest before writing a boot partition."
+        ]
+    };
+    await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+    return {
+        board_id: request.board_id,
+        variant_id: request.variant_id,
+        modified_image_path: modifiedImagePath,
+        manifest_path: manifestPath,
+        input_image_path: inputImagePath,
+        logo_path: logoPath,
+        kernel_logo_path: kernelLogoPath,
+        output_dir: outputDir,
+        input_image_sha256: inputImageSha256,
+        logo_sha256: logoSha256,
+        kernel_logo_sha256: kernelLogoSha256,
+        bytes: inputImageStat?.size,
+        destructive: false,
+        approval_required: false,
+        requires_server_workspace: false,
+        free_for_registered_users: true,
+        observed_at: observedAt,
+        summary_for_user: inputImagePath
+            ? `Prepared an isolated boot-logo replacement bundle for ${request.board_id}; copied the input image and wrote a manifest without allocating server resources.`
+            : `Prepared a boot-logo replacement manifest for ${request.board_id} without allocating server resources.`
+    };
+}
+async function requireRegularFile(path, fieldName) {
+    let fileStat;
+    try {
+        fileStat = await stat(path);
+    }
+    catch {
+        throw new Error(`${fieldName} does not exist: ${path}`);
+    }
+    if (!fileStat.isFile()) {
+        throw new Error(`${fieldName} must point to a regular file: ${path}`);
+    }
+    return { size: fileStat.size };
+}
+function safeFileStem(value) {
+    const cleaned = value.trim().replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+    return cleaned.slice(0, 80) || "boot-logo";
+}
+async function sha256(path) {
+    const hash = createHash("sha256");
+    const stream = createReadStream(path);
+    for await (const chunk of stream) {
+        hash.update(chunk);
+    }
+    return hash.digest("hex");
+}
+//# sourceMappingURL=logo.js.map

package/dist/adapters/logo.js.map

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

package/dist/adapters/taishanpi-live.d.ts

@@ -0,0 +1,163 @@
+export interface TaishanPiLiveOptions {
+    host?: string;
+    user?: string;
+    timeout_seconds?: number;
+}
+export interface TaishanPiWifiScanOptions extends TaishanPiLiveOptions {
+    interface?: string;
+}
+export interface TaishanPiBluetoothScanOptions extends TaishanPiLiveOptions {
+    duration_seconds?: number;
+}
+export interface TaishanPiQmlRuntimeOptions extends TaishanPiLiveOptions {
+    port?: number;
+    force_restart?: boolean;
+}
+export declare function scanTaishanPiWifiNetworks(options?: TaishanPiWifiScanOptions): Promise<{
+    board_id: string;
+    host: string;
+    user: string;
+    interface: string | undefined;
+    ok: boolean;
+    networks: {
+        bssid?: string;
+        ssid?: string;
+        signal_dbm?: number;
+        frequency_mhz?: number;
+        channel?: number;
+    }[];
+    network_count: number;
+    exit_code: number | null;
+    timed_out: boolean;
+    output_tail: string[];
+    error: {
+        code: string;
+        message: string;
+    } | undefined;
+    observed_at: string;
+    summary_for_user: string;
+}>;
+export declare function scanTaishanPiBluetoothDevices(options?: TaishanPiBluetoothScanOptions): Promise<{
+    board_id: string;
+    host: string;
+    user: string;
+    ok: boolean;
+    bringup_attempted: boolean;
+    adapter_info: string;
+    raw_scan_results: string;
+    devices: {
+        address: string;
+        name?: string;
+    }[];
+    device_count: number;
+    duration_seconds: number;
+    exit_code: number | null;
+    timed_out: boolean;
+    output_tail: string[];
+    error: {
+        code: string;
+        message: string;
+    } | undefined;
+    observed_at: string;
+    summary_for_user: string;
+}>;
+export declare function readTaishanPiCpuFrequency(options?: TaishanPiLiveOptions): Promise<{
+    board_id: string;
+    host: string;
+    user: string;
+    ok: boolean;
+    frequencies: {
+        policy: number;
+        khz: number;
+        mhz: number;
+    }[];
+    exit_code: number | null;
+    timed_out: boolean;
+    output_tail: string[];
+    observed_at: string;
+    summary_for_user: string;
+}>;
+export declare function readTaishanPiTemperature(options?: TaishanPiLiveOptions): Promise<{
+    board_id: string;
+    host: string;
+    user: string;
+    ok: boolean;
+    zones: {
+        zone: string;
+        milli_celsius: number;
+        celsius: number;
+    }[];
+    exit_code: number | null;
+    timed_out: boolean;
+    output_tail: string[];
+    observed_at: string;
+    summary_for_user: string;
+}>;
+export declare function getTaishanPiQmlRuntimeStatus(options?: TaishanPiQmlRuntimeOptions): Promise<{
+    board_id: string;
+    host: string;
+    user: string;
+    port: number;
+    ok: boolean;
+    reachable: boolean;
+    runner: string;
+    runner_executable: boolean;
+    log_path: string;
+    tcp: import("@embed-labs/protocol").TcpProbeEvidence;
+    ssh: {
+        ok: boolean;
+        exit_code: number | null;
+        timed_out: boolean;
+        output_tail: string[];
+    };
+    observed_at: string;
+    summary_for_user: string;
+}>;
+export declare function startTaishanPiQmlRuntime(options?: TaishanPiQmlRuntimeOptions): Promise<{
+    started: boolean;
+    observed_at: string;
+    summary_for_user: string;
+    board_id: string;
+    host: string;
+    user: string;
+    port: number;
+    ok: boolean;
+    reachable: boolean;
+    runner: string;
+    runner_executable: boolean;
+    log_path: string;
+    tcp: import("@embed-labs/protocol").TcpProbeEvidence;
+    ssh: {
+        ok: boolean;
+        exit_code: number | null;
+        timed_out: boolean;
+        output_tail: string[];
+    };
+} | {
+    started: boolean;
+    start_exit_code: number | null;
+    start_timed_out: boolean;
+    start_output_tail: string[];
+    error: {
+        code: string;
+        message: string;
+    } | undefined;
+    observed_at: string;
+    summary_for_user: string;
+    board_id: string;
+    host: string;
+    user: string;
+    port: number;
+    ok: boolean;
+    reachable: boolean;
+    runner: string;
+    runner_executable: boolean;
+    log_path: string;
+    tcp: import("@embed-labs/protocol").TcpProbeEvidence;
+    ssh: {
+        ok: boolean;
+        exit_code: number | null;
+        timed_out: boolean;
+        output_tail: string[];
+    };
+}>;

package/dist/adapters/taishanpi-live.js

@@ -0,0 +1,349 @@
+import { probeTcpWithEvidence } from "./network.js";
+import { commandExists, runCommand, tailLines } from "../process.js";
+const DEFAULT_HOST = "198.19.77.2";
+const DEFAULT_USER = "root";
+const DEFAULT_TIMEOUT_SECONDS = 8;
+const DEFAULT_QML_PORT = 18130;
+const QML_RUNNER = "/userdata/embed-qml-board-runtime/run-board-runtime.sh";
+const QML_LOG = "/tmp/embed-qml-board-runtime.log";
+export async function scanTaishanPiWifiNetworks(options = {}) {
+    const observedAt = new Date().toISOString();
+    const host = liveHost(options.host);
+    const user = liveUser(options.user);
+    const timeoutSeconds = liveTimeoutSeconds(options.timeout_seconds);
+    const requestedInterface = options.interface?.trim();
+    const interfaceExpr = requestedInterface
+        ? shellQuote(requestedInterface)
+        : "\"$(iw dev 2>/dev/null | sed -n 's/^[[:space:]]*Interface[[:space:]]\\{1,\\}\\([^[:space:]]\\{1,\\}\\).*/\\1/p' | head -n 1)\"";
+    const command = [
+        "if ! command -v iw >/dev/null 2>&1; then echo __EMBED_IW_NOT_FOUND__; exit 127; fi",
+        `IFACE=${interfaceExpr}`,
+        "if [ -z \"$IFACE\" ]; then echo __EMBED_NO_WIFI_INTERFACE__; exit 3; fi",
+        "iw dev \"$IFACE\" scan 2>&1"
+    ].join("; ");
+    const ssh = await runTaishanPiSsh(host, user, command, timeoutSeconds);
+    const output = `${ssh.stdout}\n${ssh.stderr}`.trim();
+    const networks = ssh.exit_code === 0 ? parseWifiScan(ssh.stdout) : [];
+    const error = wifiError(ssh, output);
+    return {
+        board_id: "taishanpi",
+        host,
+        user,
+        interface: requestedInterface ?? firstWifiInterface(ssh.stdout) ?? undefined,
+        ok: ssh.exit_code === 0,
+        networks,
+        network_count: networks.length,
+        exit_code: ssh.exit_code,
+        timed_out: ssh.timed_out,
+        output_tail: tailLines(output),
+        error,
+        observed_at: observedAt,
+        summary_for_user: ssh.exit_code === 0
+            ? `WiFi scan completed on ${host}: ${networks.length} network(s) found.`
+            : `WiFi scan did not complete on ${host}${error ? `: ${error.message}` : "."}`
+    };
+}
+export async function scanTaishanPiBluetoothDevices(options = {}) {
+    const observedAt = new Date().toISOString();
+    const host = liveHost(options.host);
+    const user = liveUser(options.user);
+    const durationSeconds = Math.max(3, Math.min(Math.trunc(options.duration_seconds ?? 8), 30));
+    const timeoutSeconds = Math.max(durationSeconds + 8, liveTimeoutSeconds(options.timeout_seconds));
+    const command = [
+        "if ! command -v hciconfig >/dev/null 2>&1; then echo __EMBED_HCICONFIG_NOT_FOUND__; exit 127; fi",
+        "BRINGUP_ATTEMPTED=0",
+        "if [ ! -e /sys/class/bluetooth/hci0 ] && command -v hciattach >/dev/null 2>&1 && [ -e /dev/ttyS1 ]; then if ! ps | grep -F 'hciattach -n /dev/ttyS1' | grep -v grep >/dev/null 2>&1; then nohup hciattach -n /dev/ttyS1 any 1500000 noflow >/tmp/embedlabs-hciattach.log 2>&1 < /dev/null & BRINGUP_ATTEMPTED=1; sleep 2; fi; fi",
+        "echo __EMBED_BRINGUP_ATTEMPTED__=$BRINGUP_ATTEMPTED",
+        "if [ ! -e /sys/class/bluetooth/hci0 ]; then echo __EMBED_NO_BLUETOOTH_HCI__; exit 3; fi",
+        "hciconfig hci0 up 2>&1 || true",
+        "echo __EMBED_HCICONFIG__",
+        "hciconfig -a 2>&1 || true",
+        "echo __EMBED_SCAN__",
+        `if command -v hcitool >/dev/null 2>&1; then timeout ${durationSeconds} hcitool scan 2>&1 || true; elif command -v bluetoothctl >/dev/null 2>&1; then timeout ${durationSeconds} bluetoothctl scan on 2>&1 || true; else echo __EMBED_BLUETOOTH_SCAN_TOOL_NOT_FOUND__; exit 127; fi`
+    ].join("; ");
+    const ssh = await runTaishanPiSsh(host, user, command, timeoutSeconds);
+    const output = `${ssh.stdout}\n${ssh.stderr}`.trim();
+    const devices = ssh.exit_code === 0 ? parseBluetoothScan(bluetoothScanSection(ssh.stdout)) : [];
+    const error = bluetoothError(ssh, output);
+    return {
+        board_id: "taishanpi",
+        host,
+        user,
+        ok: ssh.exit_code === 0 && !error,
+        bringup_attempted: /__EMBED_BRINGUP_ATTEMPTED__=1/.test(ssh.stdout),
+        adapter_info: bluetoothAdapterSection(ssh.stdout),
+        raw_scan_results: bluetoothScanSection(ssh.stdout),
+        devices,
+        device_count: devices.length,
+        duration_seconds: durationSeconds,
+        exit_code: ssh.exit_code,
+        timed_out: ssh.timed_out,
+        output_tail: tailLines(output),
+        error,
+        observed_at: observedAt,
+        summary_for_user: ssh.exit_code === 0 && !error
+            ? `Bluetooth scan completed on ${host}: ${devices.length} device(s) found.`
+            : `Bluetooth scan is not ready on ${host}${error ? `: ${error.message}` : "."}`
+    };
+}
+export async function readTaishanPiCpuFrequency(options = {}) {
+    const observedAt = new Date().toISOString();
+    const host = liveHost(options.host);
+    const user = liveUser(options.user);
+    const ssh = await runTaishanPiSsh(host, user, "cat /sys/devices/system/cpu/cpufreq/policy*/scaling_cur_freq 2>/dev/null", liveTimeoutSeconds(options.timeout_seconds));
+    const values = ssh.stdout.split(/\s+/)
+        .map((item) => Number(item.trim()))
+        .filter((item) => Number.isFinite(item) && item > 0);
+    const frequencies = values.map((khz, index) => ({ policy: index, khz, mhz: khz / 1000 }));
+    return {
+        board_id: "taishanpi",
+        host,
+        user,
+        ok: ssh.exit_code === 0 && frequencies.length > 0,
+        frequencies,
+        exit_code: ssh.exit_code,
+        timed_out: ssh.timed_out,
+        output_tail: tailLines(`${ssh.stdout}\n${ssh.stderr}`),
+        observed_at: observedAt,
+        summary_for_user: frequencies.length > 0
+            ? `CPU frequency read completed on ${host}: ${frequencies.map((item) => `${item.mhz} MHz`).join(", ")}.`
+            : `CPU frequency could not be read on ${host}.`
+    };
+}
+export async function readTaishanPiTemperature(options = {}) {
+    const observedAt = new Date().toISOString();
+    const host = liveHost(options.host);
+    const user = liveUser(options.user);
+    const command = "for z in /sys/class/thermal/thermal_zone*; do [ -f \"$z/temp\" ] || continue; type=$(cat \"$z/type\" 2>/dev/null || basename \"$z\"); temp=$(cat \"$z/temp\" 2>/dev/null || true); [ -n \"$temp\" ] && printf '%s=%s\\n' \"$type\" \"$temp\"; done";
+    const ssh = await runTaishanPiSsh(host, user, command, liveTimeoutSeconds(options.timeout_seconds));
+    const zones = ssh.stdout.split(/\r?\n/)
+        .map((line, index) => parseTemperatureLine(line, index))
+        .filter((item) => item !== undefined);
+    return {
+        board_id: "taishanpi",
+        host,
+        user,
+        ok: ssh.exit_code === 0 && zones.length > 0,
+        zones,
+        exit_code: ssh.exit_code,
+        timed_out: ssh.timed_out,
+        output_tail: tailLines(`${ssh.stdout}\n${ssh.stderr}`),
+        observed_at: observedAt,
+        summary_for_user: zones.length > 0
+            ? `Temperature read completed on ${host}: ${zones.map((item) => `${item.zone}=${item.celsius.toFixed(1)} C`).join(", ")}.`
+            : `Temperature could not be read on ${host}.`
+    };
+}
+export async function getTaishanPiQmlRuntimeStatus(options = {}) {
+    const observedAt = new Date().toISOString();
+    const host = liveHost(options.host);
+    const user = liveUser(options.user);
+    const port = livePort(options.port);
+    const [tcp, ssh] = await Promise.all([
+        probeTcpWithEvidence(host, port, 1000, observedAt),
+        runTaishanPiSsh(host, user, [
+            `[ -x ${shellQuote(QML_RUNNER)} ] && echo runner_executable=true || echo runner_executable=false`,
+            `ps | grep -F ${shellQuote("embed-qml-board-runtime")} | grep -v grep || true`,
+            `tail -n 40 ${shellQuote(QML_LOG)} 2>/dev/null || true`
+        ].join("; "), liveTimeoutSeconds(options.timeout_seconds))
+    ]);
+    const output = `${ssh.stdout}\n${ssh.stderr}`.trim();
+    const runnerExecutable = /runner_executable=true/.test(ssh.stdout);
+    return {
+        board_id: "taishanpi",
+        host,
+        user,
+        port,
+        ok: tcp.reachable,
+        reachable: tcp.reachable,
+        runner: QML_RUNNER,
+        runner_executable: runnerExecutable,
+        log_path: QML_LOG,
+        tcp,
+        ssh: {
+            ok: ssh.exit_code === 0,
+            exit_code: ssh.exit_code,
+            timed_out: ssh.timed_out,
+            output_tail: tailLines(output)
+        },
+        observed_at: observedAt,
+        summary_for_user: tcp.reachable
+            ? `QML board runtime is reachable at ${host}:${port}.`
+            : `QML board runtime is not reachable at ${host}:${port}.`
+    };
+}
+export async function startTaishanPiQmlRuntime(options = {}) {
+    const observedAt = new Date().toISOString();
+    const host = liveHost(options.host);
+    const user = liveUser(options.user);
+    const port = livePort(options.port);
+    const before = options.force_restart === true ? undefined : await getTaishanPiQmlRuntimeStatus({ host, user, port, timeout_seconds: options.timeout_seconds });
+    if (before?.reachable) {
+        return {
+            ...before,
+            started: false,
+            observed_at: observedAt,
+            summary_for_user: `QML board runtime was already reachable at ${host}:${port}.`
+        };
+    }
+    const command = [
+        options.force_restart === true ? `pkill -f ${shellQuote("embed-qml-board-runtime")} 2>/dev/null || true` : "",
+        `if [ ! -x ${shellQuote(QML_RUNNER)} ]; then echo __EMBED_QML_RUNNER_NOT_FOUND__; exit 3; fi`,
+        `nohup ${shellQuote(QML_RUNNER)} > ${shellQuote(QML_LOG)} 2>&1 < /dev/null & echo started_pid=$!`
+    ].filter(Boolean).join("; ");
+    const ssh = await runTaishanPiSsh(host, user, command, liveTimeoutSeconds(options.timeout_seconds));
+    await new Promise((resolve) => setTimeout(resolve, 1200));
+    const status = await getTaishanPiQmlRuntimeStatus({ host, user, port, timeout_seconds: options.timeout_seconds });
+    const output = `${ssh.stdout}\n${ssh.stderr}`.trim();
+    return {
+        ...status,
+        started: status.reachable,
+        start_exit_code: ssh.exit_code,
+        start_timed_out: ssh.timed_out,
+        start_output_tail: tailLines(output),
+        error: ssh.exit_code === 0 ? undefined : qmlStartError(ssh, output),
+        observed_at: observedAt,
+        summary_for_user: status.reachable
+            ? `QML board runtime started and is reachable at ${host}:${port}.`
+            : `QML board runtime did not become reachable at ${host}:${port}.`
+    };
+}
+async function runTaishanPiSsh(host, user, command, timeoutSeconds) {
+    const sshExists = await commandExists("ssh");
+    if (!sshExists) {
+        return {
+            command: "ssh",
+            args: [],
+            exit_code: null,
+            stdout: "",
+            stderr: "ssh binary was not found on PATH.",
+            timed_out: false
+        };
+    }
+    return await runCommand("ssh", [
+        "-o", "BatchMode=yes",
+        "-o", "LogLevel=ERROR",
+        "-o", "UserKnownHostsFile=/dev/null",
+        "-o", "StrictHostKeyChecking=no",
+        "-o", `ConnectTimeout=${Math.max(1, Math.min(timeoutSeconds, 30))}`,
+        `${user}@${host}`,
+        command
+    ], timeoutSeconds * 1000 + 1000);
+}
+function parseWifiScan(output) {
+    const networks = [];
+    const blocks = output.split(/^BSS /m).slice(1);
+    for (const block of blocks) {
+        const firstLine = block.split(/\r?\n/, 1)[0] ?? "";
+        const bssid = firstLine.match(/^([0-9a-f:]{17})/i)?.[1];
+        const ssid = block.match(/^[ \t]*SSID:[ \t]*(.*)$/m)?.[1] ?? "";
+        const signal = Number(block.match(/^[ \t]*signal:[ \t]*(-?\d+(?:\.\d+)?)[ \t]*dBm$/m)?.[1]);
+        const frequency = Number(block.match(/^[ \t]*freq:[ \t]*(\d+)/m)?.[1]);
+        const channel = Number(block.match(/^[ \t]*DS Parameter set:[ \t]*channel[ \t]*(\d+)/m)?.[1]);
+        networks.push({
+            bssid,
+            ssid,
+            signal_dbm: Number.isFinite(signal) ? signal : undefined,
+            frequency_mhz: Number.isFinite(frequency) ? frequency : undefined,
+            channel: Number.isFinite(channel) ? channel : undefined
+        });
+    }
+    return networks;
+}
+function parseBluetoothScan(output) {
+    const devices = new Map();
+    for (const line of output.split(/\r?\n/)) {
+        const bluetoothctlMatch = line.match(/Device\s+([0-9A-F:]{17})\s*(.*)$/i);
+        const hcitoolMatch = line.match(/^\s*([0-9A-F:]{17})\s+(.+?)\s*$/i);
+        const match = bluetoothctlMatch ?? hcitoolMatch;
+        if (match && !/^Scanning\b/i.test(line.trim())) {
+            const address = match[1].toUpperCase();
+            devices.set(address, { address, name: match[2]?.trim() || undefined });
+        }
+    }
+    return [...devices.values()];
+}
+function bluetoothAdapterSection(output) {
+    return output
+        .split("__EMBED_HCICONFIG__")[1]
+        ?.split("__EMBED_SCAN__")[0]
+        ?.trim() ?? "";
+}
+function bluetoothScanSection(output) {
+    return output.split("__EMBED_SCAN__")[1]?.trim() ?? output;
+}
+function parseTemperatureLine(line, index) {
+    const match = line.match(/^([^=]+)=(-?\d+)$/);
+    if (!match) {
+        return undefined;
+    }
+    const milliCelsius = Number(match[2]);
+    if (!Number.isFinite(milliCelsius)) {
+        return undefined;
+    }
+    return {
+        zone: match[1] || `thermal_zone${index}`,
+        milli_celsius: milliCelsius,
+        celsius: milliCelsius / 1000
+    };
+}
+function firstWifiInterface(output) {
+    return output.match(/^\s*Interface\s+(\S+)/m)?.[1];
+}
+function wifiError(ssh, output) {
+    if (ssh.timed_out) {
+        return { code: "wifi_scan_timeout", message: "WiFi scan timed out." };
+    }
+    if (output.includes("__EMBED_IW_NOT_FOUND__")) {
+        return { code: "iw_not_found", message: "iw is not installed on the board." };
+    }
+    if (output.includes("__EMBED_NO_WIFI_INTERFACE__")) {
+        return { code: "wifi_interface_not_found", message: "No WiFi interface was found on the board." };
+    }
+    return ssh.exit_code === 0 ? undefined : { code: "wifi_scan_failed", message: "The board WiFi scan command failed." };
+}
+function bluetoothError(ssh, output) {
+    if (ssh.timed_out) {
+        return { code: "bluetooth_scan_timeout", message: "Bluetooth scan timed out." };
+    }
+    if (output.includes("__EMBED_BLUETOOTHCTL_NOT_FOUND__")) {
+        return { code: "bluetoothctl_not_found", message: "bluetoothctl is not installed on the board." };
+    }
+    if (output.includes("__EMBED_HCICONFIG_NOT_FOUND__")) {
+        return { code: "hciconfig_not_found", message: "hciconfig is not installed on the board." };
+    }
+    if (output.includes("__EMBED_BLUETOOTH_SCAN_TOOL_NOT_FOUND__")) {
+        return { code: "bluetooth_scan_tool_not_found", message: "Neither hcitool nor bluetoothctl is installed on the board." };
+    }
+    if (output.includes("__EMBED_NO_BLUETOOTH_HCI__")) {
+        return { code: "bluetooth_controller_not_found", message: "No Bluetooth HCI controller is exposed by the board runtime." };
+    }
+    return ssh.exit_code === 0 ? undefined : { code: "bluetooth_scan_failed", message: "The board Bluetooth scan command failed." };
+}
+function qmlStartError(ssh, output) {
+    if (ssh.timed_out) {
+        return { code: "qml_runtime_start_timeout", message: "QML runtime start command timed out." };
+    }
+    if (output.includes("__EMBED_QML_RUNNER_NOT_FOUND__")) {
+        return { code: "qml_runner_not_found", message: `${QML_RUNNER} is not executable on the board.` };
+    }
+    return ssh.exit_code === 0 ? undefined : { code: "qml_runtime_start_failed", message: "QML runtime start command failed." };
+}
+function liveHost(host) {
+    return host?.trim() || DEFAULT_HOST;
+}
+function liveUser(user) {
+    return user?.trim() || DEFAULT_USER;
+}
+function liveTimeoutSeconds(timeoutSeconds) {
+    const value = Number.isFinite(timeoutSeconds) ? Math.trunc(Number(timeoutSeconds)) : DEFAULT_TIMEOUT_SECONDS;
+    return Math.max(3, Math.min(value, 60));
+}
+function livePort(port) {
+    const value = Number.isFinite(port) ? Math.trunc(Number(port)) : DEFAULT_QML_PORT;
+    return Math.max(1, Math.min(value, 65_535));
+}
+function shellQuote(value) {
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+//# sourceMappingURL=taishanpi-live.js.map