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

package/dist/hardware.js

@@ -0,0 +1,310 @@
+import { constants } from "node:fs";
+import { access, stat } from "node:fs/promises";
+import { basename } from "node:path";
+import { deployTaishanPiArtifact } from "./adapters/deploy.js";
+import { probeTcp, probeTcpWithEvidence } from "./adapters/network.js";
+import { listSerialPorts } from "./adapters/serial.js";
+import { findUf2Volumes } from "./adapters/uf2.js";
+import { isRockchipUsb, scanUsbDevices } from "./adapters/usb.js";
+export { buildFlashPlan, executeRp2350Uf2Flash } from "./adapters/flash.js";
+export { scanDebugTools } from "./adapters/debug.js";
+export { captureSerial, listSerialPorts } from "./adapters/serial.js";
+export { runBoundedSsh } from "./adapters/network.js";
+export { scanUsbDevices } from "./adapters/usb.js";
+const TAISHANPI_DEFAULT_HOST = "198.19.77.2";
+const DEFAULT_PROBE_TIMEOUT_MS = 1000;
+const MIN_PROBE_TIMEOUT_MS = 100;
+const MAX_PROBE_TIMEOUT_MS = 5000;
+const MAX_PROBE_PORTS = 16;
+const MAX_SERIAL_PATHS = 16;
+const DEFAULT_TAISHANPI_REMOTE_DIR = "/userdata/embed-labs/apps";
+const SAFE_REMOTE_DEPLOY_PREFIXES = [`${DEFAULT_TAISHANPI_REMOTE_DIR}/`, "/tmp/embed-labs/"];
+export async function scanHardware() {
+    const observedAt = new Date().toISOString();
+    const warnings = [];
+    const usb = await scanUsbDevices(warnings);
+    const serial = await listSerialPorts(warnings);
+    const devices = [];
+    for (const volumePath of await findUf2Volumes()) {
+        devices.push({
+            device_id: `rp2350-uf2-${safeId(basename(volumePath))}`,
+            board_id: "rp2350",
+            display_name: `RP2350 UF2 boot volume (${basename(volumePath)})`,
+            status: "bootloader",
+            locators: [{ transport: "uf2-volume", volume_path: volumePath }],
+            observed_at: observedAt,
+            summary_for_user: `Detected RP2350-compatible UF2 boot volume at ${volumePath}.`
+        });
+    }
+    const taishanPiUsb = usb.find((item) => isRockchipUsb(item));
+    if (taishanPiUsb) {
+        const mode = /maskrom/i.test(taishanPiUsb.product_name ?? "")
+            ? "bootloader"
+            : /loader|rockchip/i.test(taishanPiUsb.product_name ?? "")
+                ? "bootloader"
+                : "unknown";
+        devices.push({
+            device_id: `taishanpi-rockusb-${safeId(taishanPiUsb.serial_number ?? taishanPiUsb.location_id ?? "device")}`,
+            board_id: "taishanpi",
+            display_name: taishanPiUsb.product_name ?? "TaishanPi Rockchip USB device",
+            status: mode,
+            locators: [{ transport: "rockusb" }],
+            usb: taishanPiUsb,
+            observed_at: observedAt,
+            summary_for_user: "Detected a Rockchip USB device that may be TaishanPi Loader/Maskrom."
+        });
+    }
+    const taishanRuntime = await probeTcp(TAISHANPI_DEFAULT_HOST, 22, 800);
+    const taishanControl = await probeTcp(TAISHANPI_DEFAULT_HOST, 15301, 800);
+    if (taishanRuntime || taishanControl) {
+        const evidence = [{
+                evidence_id: `evidence_${Date.now()}_taishanpi_tcp`,
+                board_id: "taishanpi",
+                method: "probe",
+                summary: `USB ECM probe host=${TAISHANPI_DEFAULT_HOST} ssh=${taishanRuntime} control=${taishanControl}`,
+                observed_at: observedAt,
+                verdict: taishanRuntime || taishanControl ? "pass" : "inconclusive"
+            }];
+        devices.push({
+            device_id: `taishanpi-usbecm-${TAISHANPI_DEFAULT_HOST.replace(/\./g, "")}`,
+            board_id: "taishanpi",
+            display_name: "TaishanPi USB ECM runtime",
+            status: "connected",
+            locators: [
+                { transport: "usbecm", host: TAISHANPI_DEFAULT_HOST },
+                { transport: "ssh", host: TAISHANPI_DEFAULT_HOST, port: 22 }
+            ],
+            observed_at: observedAt,
+            summary_for_user: `Detected TaishanPi runtime link at ${TAISHANPI_DEFAULT_HOST}.`,
+            evidence
+        });
+    }
+    for (const port of serial) {
+        devices.push({
+            device_id: `serial-${safeId(port.path)}`,
+            display_name: port.display_name ?? `Serial port ${port.path}`,
+            status: port.available ? "connected" : "not_ready",
+            locators: [{ transport: "serial", path: port.path }],
+            serial: port,
+            observed_at: observedAt,
+            summary_for_user: `Detected serial port ${port.path}.`
+        });
+    }
+    return { devices, usb, serial, observed_at: observedAt, warnings };
+}
+export async function probeDevices(request) {
+    const observedAt = new Date().toISOString();
+    const timeoutMs = clampProbeTimeout(request.timeout_ms);
+    const warnings = buildProbeWarnings(request);
+    const host = request.host?.trim();
+    const ports = normalizeProbePorts(request.ports ?? []);
+    const serialPaths = normalizeSerialPaths(request.serial_paths ?? []);
+    const knownSerialPorts = process.platform === "win32" && serialPaths.length > 0
+        ? await listSerialPorts(warnings)
+        : undefined;
+    const [tcp, serialPathResults] = await Promise.all([
+        host
+            ? Promise.all(ports.map((port) => probeTcpWithEvidence(host, port, timeoutMs, observedAt)))
+            : Promise.resolve([]),
+        Promise.all(serialPaths.map((path) => probeSerialPath(path, observedAt, knownSerialPorts)))
+    ]);
+    const reachablePorts = tcp.filter((item) => item.reachable).length;
+    const existingSerialPaths = serialPathResults.filter((item) => item.exists).length;
+    return {
+        observed_at: observedAt,
+        timeout_ms: timeoutMs,
+        tcp,
+        serial_paths: serialPathResults,
+        summary_for_user: `Probe finished: ${reachablePorts}/${tcp.length} TCP ports reachable, ${existingSerialPaths}/${serialPathResults.length} serial paths exist.`,
+        warnings: warnings.length > 0 ? warnings : undefined
+    };
+}
+export async function deployTaishanPiApplication(request) {
+    return await deployTaishanPiArtifact(request);
+}
+export function validateTaishanPiDeployRequest(input) {
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        return { error: "Request body must be a JSON object." };
+    }
+    const request = input;
+    const unknownFields = Object.keys(request).filter((field) => ![
+        "board_id",
+        "host",
+        "user",
+        "artifact_path",
+        "remote_path",
+        "run",
+        "timeout_seconds",
+        "approved"
+    ].includes(field));
+    if (unknownFields.length > 0) {
+        return { error: `Unsupported field(s): ${unknownFields.join(", ")}.` };
+    }
+    if (request.board_id !== undefined && request.board_id !== "taishanpi") {
+        return { error: "board_id must be taishanpi when provided." };
+    }
+    if (typeof request.host !== "string" || !isValidDeployHost(request.host.trim())) {
+        return { error: "host must be a hostname or IP address without schemes, paths, spaces, or credentials." };
+    }
+    if (request.user !== undefined && (typeof request.user !== "string" || !/^[a-z_][a-z0-9_-]{0,31}$/i.test(request.user.trim()))) {
+        return { error: "user must be a safe SSH user name when provided." };
+    }
+    if (typeof request.artifact_path !== "string" || !request.artifact_path.trim()) {
+        return { error: "artifact_path is required." };
+    }
+    if (request.remote_path !== undefined && (typeof request.remote_path !== "string" || !isSafeRemoteDeployPath(request.remote_path.trim()))) {
+        return { error: `remote_path must be under ${SAFE_REMOTE_DEPLOY_PREFIXES.join(" or ")} and contain only safe path characters.` };
+    }
+    if (request.run !== undefined && typeof request.run !== "boolean") {
+        return { error: "run must be a boolean when provided." };
+    }
+    if (request.timeout_seconds !== undefined && (typeof request.timeout_seconds !== "number" || !Number.isFinite(request.timeout_seconds) || request.timeout_seconds <= 0)) {
+        return { error: "timeout_seconds must be a positive number when provided." };
+    }
+    if (request.approved !== undefined && typeof request.approved !== "boolean") {
+        return { error: "approved must be a boolean when provided." };
+    }
+    return {
+        request: {
+            board_id: "taishanpi",
+            host: request.host.trim(),
+            user: typeof request.user === "string" ? request.user.trim() : undefined,
+            artifact_path: request.artifact_path.trim(),
+            remote_path: typeof request.remote_path === "string" ? request.remote_path.trim() : undefined,
+            run: typeof request.run === "boolean" ? request.run : undefined,
+            timeout_seconds: typeof request.timeout_seconds === "number" ? request.timeout_seconds : undefined,
+            approved: typeof request.approved === "boolean" ? request.approved : undefined
+        }
+    };
+}
+async function probeSerialPath(path, observedAt, knownSerialPorts) {
+    const knownPort = knownSerialPorts?.find((port) => port.path.toLowerCase() === path.toLowerCase());
+    if (knownPort) {
+        return {
+            transport: "serial-path",
+            path,
+            exists: true,
+            path_type: "unknown",
+            readable: knownPort.available,
+            writable: knownPort.available,
+            observed_at: observedAt
+        };
+    }
+    try {
+        const pathStat = await stat(path);
+        const [readable, writable] = await Promise.all([
+            canAccess(path, constants.R_OK),
+            canAccess(path, constants.W_OK)
+        ]);
+        return {
+            transport: "serial-path",
+            path,
+            exists: true,
+            path_type: pathStat.isCharacterDevice()
+                ? "character_device"
+                : pathStat.isFile()
+                    ? "file"
+                    : pathStat.isDirectory()
+                        ? "directory"
+                        : "other",
+            readable,
+            writable,
+            observed_at: observedAt
+        };
+    }
+    catch (error) {
+        const typed = error;
+        return {
+            transport: "serial-path",
+            path,
+            exists: false,
+            path_type: "unknown",
+            observed_at: observedAt,
+            error_code: typed.code,
+            error_message: typed.message
+        };
+    }
+}
+async function canAccess(path, mode) {
+    try {
+        await access(path, mode);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function clampProbeTimeout(timeoutMs) {
+    const timeout = Number.isFinite(timeoutMs) ? Number(timeoutMs) : DEFAULT_PROBE_TIMEOUT_MS;
+    return Math.max(MIN_PROBE_TIMEOUT_MS, Math.min(Math.trunc(timeout), MAX_PROBE_TIMEOUT_MS));
+}
+function normalizeProbePorts(ports) {
+    const normalized = ports
+        .map((port) => Math.trunc(Number(port)))
+        .filter((port) => Number.isInteger(port) && port > 0 && port <= 65_535);
+    return [...new Set(normalized)].slice(0, MAX_PROBE_PORTS);
+}
+function normalizeSerialPaths(paths) {
+    const normalized = paths
+        .map((path) => path.trim())
+        .filter(Boolean);
+    return [...new Set(normalized)].slice(0, MAX_SERIAL_PATHS);
+}
+function buildProbeWarnings(request) {
+    const warnings = [];
+    if (request.host && (request.ports?.length ?? 0) === 0) {
+        warnings.push({
+            code: "probe_host_without_ports",
+            message: "Host was provided without TCP ports, so no TCP probe was performed."
+        });
+    }
+    if (request.timeout_ms !== undefined && (request.timeout_ms < MIN_PROBE_TIMEOUT_MS || request.timeout_ms > MAX_PROBE_TIMEOUT_MS)) {
+        warnings.push({
+            code: "probe_timeout_clamped",
+            message: `Probe timeout was clamped to ${MIN_PROBE_TIMEOUT_MS}-${MAX_PROBE_TIMEOUT_MS}ms.`
+        });
+    }
+    if (countUniqueProbePorts(request.ports ?? []) > MAX_PROBE_PORTS) {
+        warnings.push({
+            code: "probe_ports_truncated",
+            message: `Only the first ${MAX_PROBE_PORTS} unique valid ports were probed.`
+        });
+    }
+    if (countUniqueSerialPaths(request.serial_paths ?? []) > MAX_SERIAL_PATHS) {
+        warnings.push({
+            code: "probe_serial_paths_truncated",
+            message: `Only the first ${MAX_SERIAL_PATHS} unique serial paths were probed.`
+        });
+    }
+    return warnings;
+}
+function countUniqueProbePorts(ports) {
+    return new Set(ports
+        .map((port) => Math.trunc(Number(port)))
+        .filter((port) => Number.isInteger(port) && port > 0 && port <= 65_535)).size;
+}
+function countUniqueSerialPaths(paths) {
+    return new Set(paths.map((path) => path.trim()).filter(Boolean)).size;
+}
+function safeId(input) {
+    return input.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "unknown";
+}
+function isValidDeployHost(host) {
+    if (!host || host.length > 253 || /[\s\x00-\x1f\x7f]/.test(host)) {
+        return false;
+    }
+    if (host.includes("://") || host.includes("/") || host.includes("\\") || host.includes("@")) {
+        return false;
+    }
+    return /^[a-zA-Z0-9.-]+$/.test(host);
+}
+function isSafeRemoteDeployPath(remotePath) {
+    if (!SAFE_REMOTE_DEPLOY_PREFIXES.some((prefix) => remotePath.startsWith(prefix))) {
+        return false;
+    }
+    if (remotePath.includes("..") || /[\s\x00-\x1f\x7f'"`$;&|<>()[\]{}]/.test(remotePath)) {
+        return false;
+    }
+    return /^\/[A-Za-z0-9._/-]+$/.test(remotePath) && !remotePath.endsWith("/");
+}
+//# sourceMappingURL=hardware.js.map

package/dist/hardware.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export { startServer } from "./server.js";

package/dist/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { startServer } from "./server.js";
+export { startServer } from "./server.js";
+if (isDirectRun()) {
+    startServer();
+}
+function isDirectRun() {
+    if (!process.argv[1]) {
+        return false;
+    }
+    try {
+        return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,IAAI,WAAW,EAAE,EAAE,CAAC;IAClB,WAAW,EAAE,CAAC;AAChB,CAAC;AAED,SAAS,WAAW;IAClB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/jobs.d.ts

@@ -0,0 +1,4 @@
+import type { BridgeJob, FlashRunRequest } from "@embed-labs/protocol";
+export declare function listJobs(): BridgeJob[];
+export declare function getJob(localJobId: string): BridgeJob | undefined;
+export declare function startFlashJob(request: FlashRunRequest): Promise<BridgeJob>;

package/dist/jobs.js

@@ -0,0 +1,125 @@
+import { buildFlashPlan, executeRp2350Uf2Flash } from "./hardware.js";
+import { tailLines } from "./process.js";
+const jobs = new Map();
+export function listJobs() {
+    return [...jobs.values()].sort((a, b) => a.created_at.localeCompare(b.created_at));
+}
+export function getJob(localJobId) {
+    return jobs.get(localJobId);
+}
+export async function startFlashJob(request) {
+    const now = new Date().toISOString();
+    const localJobId = `local_job_${Date.now()}_${Math.random().toString(16).slice(2)}`;
+    const job = {
+        local_job_id: localJobId,
+        state: "queued",
+        kind: "flash.device",
+        progress_stage: "queued",
+        progress_text: "Flash job queued.",
+        progress_percent: 0,
+        output_tail: [],
+        created_at: now,
+        updated_at: now
+    };
+    jobs.set(localJobId, job);
+    void runFlashJob(localJobId, request);
+    return job;
+}
+async function runFlashJob(localJobId, request) {
+    updateJob(localJobId, {
+        state: "planning",
+        progress_stage: "plan",
+        progress_text: "Building flash plan.",
+        progress_percent: 5
+    });
+    try {
+        const plan = await buildFlashPlan(request);
+        if (!plan.ready) {
+            updateJob(localJobId, {
+                state: "blocked",
+                progress_stage: "not_ready",
+                progress_text: plan.summary,
+                progress_percent: 10,
+                result: { plan },
+                error: {
+                    code: "flash_plan_not_ready",
+                    message: plan.summary,
+                    retryable: true,
+                    details: { missing_files: plan.missing_files, missing_tools: plan.missing_tools }
+                }
+            });
+            return;
+        }
+        if (!request.approved) {
+            updateJob(localJobId, {
+                state: "awaiting_approval",
+                progress_stage: "awaiting_approval",
+                progress_text: "Flash plan requires explicit approval.",
+                progress_percent: 15,
+                result: { plan },
+                error: {
+                    code: "approval_required",
+                    message: "Re-run with approved=true after the user approves the destructive flash plan.",
+                    retryable: true
+                }
+            });
+            return;
+        }
+        updateJob(localJobId, {
+            state: "running",
+            progress_stage: "flash",
+            progress_text: "Executing local flash profile.",
+            progress_percent: 30,
+            result: { plan }
+        });
+        if (request.board_id === "rp2350") {
+            const result = await executeRp2350Uf2Flash(plan);
+            updateJob(localJobId, {
+                state: "succeeded",
+                progress_stage: "finished",
+                progress_text: "RP2350 UF2 copy finished.",
+                progress_percent: 100,
+                output_tail: tailLines(JSON.stringify(result, null, 2)),
+                result: { plan, flash_result: result }
+            });
+            return;
+        }
+        updateJob(localJobId, {
+            state: "blocked",
+            progress_stage: "blocked_by_profile_review",
+            progress_text: "Real flashing for this board is blocked until the Board Pack command profile is accepted.",
+            progress_percent: 40,
+            result: { plan },
+            error: {
+                code: "flash_profile_not_accepted",
+                message: "This board has a planner, but its destructive command template is not accepted yet.",
+                retryable: false,
+                remediation: "Complete EL-010/EL-011 flash profile review before enabling this real flash path."
+            }
+        });
+    }
+    catch (error) {
+        updateJob(localJobId, {
+            state: "failed",
+            progress_stage: "failed",
+            progress_text: "Flash job failed.",
+            error: {
+                code: "flash_job_failed",
+                message: error instanceof Error ? error.message : String(error),
+                retryable: true
+            }
+        });
+    }
+}
+function updateJob(localJobId, patch) {
+    const existing = jobs.get(localJobId);
+    if (!existing) {
+        return;
+    }
+    jobs.set(localJobId, {
+        ...existing,
+        ...patch,
+        updated_at: new Date().toISOString()
+    });
+}
+//# sourceMappingURL=jobs.js.map

package/dist/jobs.js.map

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

package/dist/process.d.ts

@@ -0,0 +1,13 @@
+export interface CommandResult {
+    command: string;
+    args: string[];
+    exit_code: number | null;
+    stdout: string;
+    stderr: string;
+    timed_out: boolean;
+}
+export declare function commandExists(command: string): Promise<boolean>;
+export declare function resolveCommand(command: string): Promise<string | undefined>;
+export declare function stripControl(input: string): string;
+export declare function runCommand(command: string, args: string[], timeoutMs?: number, stdin?: string | Buffer): Promise<CommandResult>;
+export declare function tailLines(text: string, maxLines?: number): string[];

package/dist/process.js

@@ -0,0 +1,77 @@
+import { spawn } from "node:child_process";
+import { access } from "node:fs/promises";
+import { constants } from "node:fs";
+import { join } from "node:path";
+export async function commandExists(command) {
+    return (await resolveCommand(command)) !== undefined;
+}
+export async function resolveCommand(command) {
+    const pathParts = (process.env.PATH ?? "").split(process.platform === "win32" ? ";" : ":");
+    const suffixes = process.platform === "win32" ? ["", ".exe", ".cmd", ".bat"] : [""];
+    for (const dir of pathParts) {
+        for (const suffix of suffixes) {
+            const candidate = dir ? join(dir, `${command}${suffix}`) : `${command}${suffix}`;
+            try {
+                await access(candidate, constants.X_OK);
+                return candidate;
+            }
+            catch {
+                // Keep looking.
+            }
+        }
+    }
+    return undefined;
+}
+export function stripControl(input) {
+    return input
+        .replace(/\u001b\[[0-9;?]*[ -/]*[@-~]/g, "")
+        .replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/g, "");
+}
+export async function runCommand(command, args, timeoutMs = 10_000, stdin) {
+    return new Promise((resolve) => {
+        const child = spawn(command, args, { stdio: [stdin === undefined ? "ignore" : "pipe", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+            setTimeout(() => child.kill("SIGKILL"), 1000).unref();
+        }, timeoutMs);
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk.toString("utf8");
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        if (stdin !== undefined && child.stdin) {
+            child.stdin.end(stdin);
+        }
+        child.on("error", (error) => {
+            clearTimeout(timer);
+            resolve({
+                command,
+                args,
+                exit_code: null,
+                stdout: "",
+                stderr: error.message,
+                timed_out: timedOut
+            });
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            resolve({
+                command,
+                args,
+                exit_code: code,
+                stdout: stripControl(stdout),
+                stderr: stripControl(stderr),
+                timed_out: timedOut
+            });
+        });
+    });
+}
+export function tailLines(text, maxLines = 40) {
+    return text.split(/\r?\n/).filter(Boolean).slice(-maxLines);
+}
+//# sourceMappingURL=process.js.map

package/dist/process.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+import http from "node:http";
+export interface BridgeServerOptions {
+    host?: string;
+    port?: number;
+}
+export declare function startServer(options?: BridgeServerOptions): http.Server;