@kvell007/embed-labs-local-bridge 0.1.0-alpha.20 → 0.1.0-alpha.22

package/README.md

@@ -12,8 +12,12 @@ are complete.
 
 ## What It Provides
 
-- `embed-local-bridge` binary.
-- `startServer()` library entry point.
+- `embed-local-bridge` npm launcher.
+- Native Go bridge binaries delivered through platform optional packages:
+  `@embed-labs/local-bridge-darwin-arm64`,
+  `@embed-labs/local-bridge-linux-x64`,
+  `@embed-labs/local-bridge-linux-arm64`, and
+  `@embed-labs/local-bridge-win32-x64`.
 - Local health endpoint.
 - Device discovery for serial ports, RP2350-compatible UF2 volumes, Rockchip
   USB Loader/Maskrom style devices, and the current TaishanPi USB ECM probe.
@@ -21,7 +25,7 @@ are complete.
 - Non-destructive debug tool availability scans for OpenOCD, probe-rs, pyOCD,
   and SEGGER J-Link command-line tools.
 - Flash plan endpoints and local job tracking.
-- Shared response contracts from `@embed-labs/protocol`.
+- Stable HTTP/JSON response contracts used by the CLI and agent plugins.
 
 ## Install
 
@@ -50,19 +54,17 @@ The bridge listens on `127.0.0.1:18083` by default.
 EMBED_BRIDGE_HOST=127.0.0.1 EMBED_BRIDGE_PORT=18083 embed-local-bridge
 ```
 
-Library usage:
-
-```ts
-import { startServer } from "@embed-labs/local-bridge";
-
-const server = startServer({ host: "127.0.0.1", port: 18083 });
-```
+This package no longer exports a TypeScript `startServer()` runtime. It is a
+small JavaScript launcher for the Go binary. If optional dependencies were
+omitted during install, reinstall without `--omit=optional`.
 
 ## HTTP Surface
 
 - `GET /healthz`
 - `GET /v1/devices`
 - `GET /v1/debug/tools`
+- `GET /v1/tools/capabilities`
+- `POST /v1/tools/invoke`
 - `POST /v1/devices/probe`
 - `GET /v1/serial/ports`
 - `POST /v1/serial/capture`
@@ -71,6 +73,8 @@ const server = startServer({ host: "127.0.0.1", port: 18083 });
 - `POST /v1/flash/run`
 - `GET /v1/jobs`
 - `GET /v1/jobs/<local_job_id>`
+- RP2350 Monitor paths: `GET /api/health`, `GET /api/snapshot`,
+  `POST /api/operation`, `GET /api/stream`, and `/rp2350-monitor/`.
 
 Examples:
 
@@ -114,7 +118,8 @@ claims.
 
 ## Runtime Requirements
 
-- Node.js 20 or newer.
+- Node.js 20 or newer for the npm launcher.
+- The matching native optional package for the current OS/CPU.
 - Optional platform tools depending on the requested action, such as OpenSSH
   for `POST /v1/ssh/run`, `rkdeveloptool` for TaishanPi planning checks, and
   debug tools such as `openocd`, `probe-rs`, `pyocd`, `JLinkExe`, and

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 #!/usr/bin/env node
-export { startServer } from "./server.js";
+export declare function resolveBridgeBinary(): string;
+export declare function startBridgeProcess(args?: string[]): Promise<number>;

package/dist/index.js

@@ -1,10 +1,131 @@
 #!/usr/bin/env node
-import { realpathSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { accessSync, constants, realpathSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join, resolve } from "node:path";
+import { arch, platform } from "node:os";
 import { fileURLToPath } from "node:url";
-import { startServer } from "./server.js";
-export { startServer } from "./server.js";
+const require = createRequire(import.meta.url);
+const TARGETS = {
+    "darwin-arm64": {
+        packageName: "@embed-labs/local-bridge-darwin-arm64",
+        artifactDir: "darwin-arm64",
+        binaryName: "embed-local-bridge"
+    },
+    "linux-x64": {
+        packageName: "@embed-labs/local-bridge-linux-x64",
+        artifactDir: "linux-x64",
+        binaryName: "embed-local-bridge"
+    },
+    "linux-arm64": {
+        packageName: "@embed-labs/local-bridge-linux-arm64",
+        artifactDir: "linux-arm64",
+        binaryName: "embed-local-bridge"
+    },
+    "win32-x64": {
+        packageName: "@embed-labs/local-bridge-win32-x64",
+        artifactDir: "win32-x64",
+        binaryName: "embed-local-bridge.exe"
+    }
+};
+export function resolveBridgeBinary() {
+    const explicit = process.env.EMBED_LOCAL_BRIDGE_BINARY?.trim();
+    if (explicit) {
+        return assertExecutable(explicit, `EMBED_LOCAL_BRIDGE_BINARY points to a non-executable file: ${explicit}`);
+    }
+    const targetKey = `${platform()}-${arch()}`;
+    const target = TARGETS[targetKey];
+    if (!target) {
+        throw new Error(`Embed Labs Local Bridge does not provide a native binary for ${targetKey}. Supported targets: ${Object.keys(TARGETS).join(", ")}.`);
+    }
+    const packagedBinary = resolvePackagedBinary(target);
+    if (packagedBinary) {
+        return packagedBinary;
+    }
+    const repoBinary = resolveRepoArtifactBinary(target);
+    if (repoBinary) {
+        return repoBinary;
+    }
+    throw new Error([
+        `Embed Labs Local Bridge native package is missing for ${targetKey}.`,
+        `Expected optional dependency ${target.packageName}.`,
+        "Reinstall without omitting optional dependencies:",
+        "  npm install",
+        "or install the CLI package again without --omit=optional.",
+        "For source-tree development, run npm run build:bridge-go first."
+    ].join("\n"));
+}
+export function startBridgeProcess(args = process.argv.slice(2)) {
+    const binary = resolveBridgeBinary();
+    const child = spawn(binary, args, {
+        stdio: "inherit",
+        env: process.env
+    });
+    const forwardSignal = (signal) => {
+        if (!child.killed) {
+            child.kill(signal);
+        }
+    };
+    process.once("SIGINT", forwardSignal);
+    process.once("SIGTERM", forwardSignal);
+    return new Promise((resolve) => {
+        child.on("error", (error) => {
+            console.error(error instanceof Error ? error.message : String(error));
+            resolve(1);
+        });
+        child.on("close", (code, signal) => {
+            process.off("SIGINT", forwardSignal);
+            process.off("SIGTERM", forwardSignal);
+            if (signal) {
+                resolve(signal === "SIGINT" || signal === "SIGTERM" ? 0 : 1);
+            }
+            else {
+                resolve(code ?? 0);
+            }
+        });
+    });
+}
 if (isDirectRun()) {
-    startServer();
+    startBridgeProcess().then((code) => {
+        process.exitCode = code;
+    });
+}
+function resolvePackagedBinary(target) {
+    try {
+        const packageJson = require.resolve(`${target.packageName}/package.json`);
+        return assertExecutable(join(dirname(packageJson), "bin", target.binaryName), "");
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveRepoArtifactBinary(target) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        resolve(here, "../../../artifacts/local-bridge-bin", target.artifactDir, target.binaryName),
+        resolve(here, "../../artifacts/local-bridge-bin", target.artifactDir, target.binaryName)
+    ];
+    for (const candidate of candidates) {
+        try {
+            return assertExecutable(candidate, "");
+        }
+        catch {
+            // Keep searching fallback candidates.
+        }
+    }
+    return undefined;
+}
+function assertExecutable(path, message) {
+    try {
+        accessSync(path, constants.X_OK);
+    }
+    catch (error) {
+        if (message) {
+            throw new Error(message);
+        }
+        throw error;
+    }
+    return path;
 }
 function isDirectRun() {
     if (!process.argv[1]) {

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@kvell007/embed-labs-local-bridge",
-  "version": "0.1.0-alpha.20",
+  "version": "0.1.0-alpha.22",
   "description": "Local hardware bridge service for Embed Labs Cloud. Experimental npm publish.",
   "private": false,
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
-    "dist",
+    "dist/index.js",
+    "dist/index.d.ts",
     "README.md"
   ],
   "engines": {
@@ -16,8 +17,11 @@
   "bin": {
     "embed-local-bridge": "dist/index.js"
   },
-  "dependencies": {
-    "@embed-labs/protocol": "npm:@kvell007/embed-labs-protocol@0.1.0-alpha.20"
+  "optionalDependencies": {
+    "@embed-labs/local-bridge-darwin-arm64": "npm:@kvell007/embed-labs-local-bridge-darwin-arm64@0.1.0-alpha.22",
+    "@embed-labs/local-bridge-linux-arm64": "npm:@kvell007/embed-labs-local-bridge-linux-arm64@0.1.0-alpha.22",
+    "@embed-labs/local-bridge-linux-x64": "npm:@kvell007/embed-labs-local-bridge-linux-x64@0.1.0-alpha.22",
+    "@embed-labs/local-bridge-win32-x64": "npm:@kvell007/embed-labs-local-bridge-win32-x64@0.1.0-alpha.22"
   },
   "publishConfig": {
     "access": "public",

package/dist/adapters/debug.d.ts

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

package/dist/adapters/debug.js

@@ -1,124 +0,0 @@
-import { resolveCommand, runCommand, tailLines } from "../process.js";
-const VERSION_TIMEOUT_MS = 2500;
-const DEBUG_TOOLS = [
-    {
-        tool_id: "openocd",
-        display_name: "OpenOCD",
-        command: "openocd",
-        version_args: ["--version"]
-    },
-    {
-        tool_id: "probe-rs",
-        display_name: "probe-rs",
-        command: "probe-rs",
-        version_args: ["--version"]
-    },
-    {
-        tool_id: "pyocd",
-        display_name: "pyOCD",
-        command: "pyocd",
-        version_args: ["--version"]
-    },
-    {
-        tool_id: "jlink-commander",
-        display_name: "SEGGER J-Link Commander",
-        command: "JLinkExe",
-        version_args: ["-?"]
-    },
-    {
-        tool_id: "jlink-gdb-server",
-        display_name: "SEGGER J-Link GDB Server",
-        command: "JLinkGDBServerCLExe",
-        version_args: ["-?"]
-    }
-];
-export async function scanDebugTools() {
-    const observedAt = new Date().toISOString();
-    const tools = await Promise.all(DEBUG_TOOLS.map((tool) => scanDebugTool(tool, observedAt)));
-    const availableCount = tools.filter((tool) => tool.available).length;
-    return {
-        tools,
-        observed_at: observedAt,
-        summary_for_user: `Debug tool scan finished: ${availableCount}/${tools.length} tools available. No debug sessions or probe connections were opened.`
-    };
-}
-async function scanDebugTool(spec, observedAt) {
-    const evidence = [];
-    const resolvedPath = await resolveCommand(spec.command);
-    evidence.push({
-        evidence_id: evidenceId(spec.tool_id, "path", observedAt),
-        tool_id: spec.tool_id,
-        kind: "path_lookup",
-        command: spec.command,
-        observed_at: observedAt,
-        available: resolvedPath !== undefined,
-        resolved_path: resolvedPath,
-        summary: resolvedPath
-            ? `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 {
-            tool_id: spec.tool_id,
-            display_name: spec.display_name,
-            command: spec.command,
-            available: false,
-            evidence,
-            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);
-    const stdoutTail = tailLines(versionResult.stdout, 8);
-    const stderrTail = tailLines(versionResult.stderr, 8);
-    const version = extractVersionLine(`${versionResult.stdout}\n${versionResult.stderr}`);
-    evidence.push({
-        evidence_id: evidenceId(spec.tool_id, "version", observedAt),
-        tool_id: spec.tool_id,
-        kind: "version_command",
-        command: spec.command,
-        args: spec.version_args,
-        observed_at: observedAt,
-        exit_code: versionResult.exit_code,
-        timed_out: versionResult.timed_out,
-        stdout_tail: stdoutTail.length > 0 ? stdoutTail : undefined,
-        stderr_tail: stderrTail.length > 0 ? stderrTail : undefined,
-        error_code: versionResult.timed_out
-            ? "version_command_timeout"
-            : versionResult.exit_code === 0
-                ? undefined
-                : "version_command_nonzero",
-        error_message: versionResult.timed_out
-            ? `Version/help command exceeded ${VERSION_TIMEOUT_MS}ms.`
-            : versionResult.exit_code === 0
-                ? undefined
-                : `Version/help command exited with code ${versionResult.exit_code ?? "unknown"}.`,
-        summary: versionResult.timed_out
-            ? `${spec.command} was found, but the bounded version/help command timed out.`
-            : versionResult.exit_code === 0
-                ? `${spec.command} version/help command completed.`
-                : `${spec.command} was found, but its version/help command exited non-zero.`
-    });
-    return {
-        tool_id: spec.tool_id,
-        display_name: spec.display_name,
-        command: spec.command,
-        available: true,
-        version,
-        evidence,
-        summary_for_user: version
-            ? `${spec.display_name} is available (${version}).`
-            : `${spec.display_name} is available; version output was not recognized.`
-    };
-}
-function extractVersionLine(output) {
-    return output
-        .split(/\r?\n/)
-        .map((line) => line.trim())
-        .find((line) => line.length > 0)
-        ?.slice(0, 160);
-}
-function evidenceId(toolId, kind, observedAt) {
-    const stableTime = observedAt.replace(/[^0-9]/g, "");
-    return `debug_${toolId}_${kind}_${stableTime}`;
-}
-//# sourceMappingURL=debug.js.map

package/dist/adapters/debug.js.map

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

package/dist/adapters/deploy.d.ts

@@ -1,5 +0,0 @@
-import type { BoardDeployRequest, BoardDeployResult, ErrorEnvelope } from "@embed-labs/protocol";
-export declare function deployTaishanPiArtifact(request: BoardDeployRequest): Promise<BoardDeployResult | {
-    ok: false;
-    error: ErrorEnvelope;
-}>;

package/dist/adapters/deploy.js

@@ -1,132 +0,0 @@
-import { readFile, stat } from "node:fs/promises";
-import { posix } from "node:path";
-import { commandExists, runCommand, tailLines } from "../process.js";
-const DEFAULT_REMOTE_PATH = "/userdata/embed-labs/apps/app";
-const REMOTE_ROOT = "/userdata/embed-labs/apps";
-const MAX_ARTIFACT_BYTES = 16 * 1024 * 1024;
-export async function deployTaishanPiArtifact(request) {
-    const observedAt = new Date().toISOString();
-    if (request.board_id !== "taishanpi") {
-        return failDeploy("unsupported_board", `board_id must be taishanpi, got ${request.board_id}.`);
-    }
-    const host = request.host.trim();
-    const user = request.user?.trim() || "root";
-    const remotePath = normalizeRemotePath(request.remote_path ?? DEFAULT_REMOTE_PATH);
-    const timeoutSeconds = clampTimeoutSeconds(request.timeout_seconds);
-    if (!remotePath) {
-        return failDeploy("invalid_remote_path", `remote_path must stay under ${REMOTE_ROOT} and contain only safe path characters.`);
-    }
-    if (!/^[A-Za-z0-9._-]{1,64}$/.test(user)) {
-        return failDeploy("invalid_user", "SSH user must contain only letters, numbers, dots, underscores, or hyphens.");
-    }
-    if (!await commandExists("ssh")) {
-        return failDeploy("ssh_not_found", "ssh binary was not found on PATH.", "Install OpenSSH client or add ssh to PATH.");
-    }
-    const artifactStat = await stat(request.artifact_path).catch(() => undefined);
-    if (!artifactStat?.isFile()) {
-        return failDeploy("artifact_file_not_found", `Local artifact file is not available: ${request.artifact_path}`);
-    }
-    if (artifactStat.size > MAX_ARTIFACT_BYTES) {
-        return failDeploy("artifact_file_too_large", `Local Bridge deploy currently accepts artifacts up to ${MAX_ARTIFACT_BYTES} bytes on the SSH/base64 MVP path.`);
-    }
-    const artifactBytes = await readFile(request.artifact_path);
-    const remoteDir = posix.dirname(remotePath);
-    const tmpPath = `${remotePath}.tmp.${Date.now()}`;
-    const logPath = `${remotePath}.log`;
-    const pidPath = `${remotePath}.pid`;
-    const upload = await ssh(host, user, [
-        `mkdir -p ${shellQuote(remoteDir)}`,
-        "umask 077",
-        `base64 -d > ${shellQuote(tmpPath)}`,
-        `chmod 0755 ${shellQuote(tmpPath)}`,
-        `mv -f ${shellQuote(tmpPath)} ${shellQuote(remotePath)}`
-    ].join(" && "), timeoutSeconds, artifactBytes.toString("base64"));
-    if (upload.exit_code !== 0) {
-        return commandFailure(upload.timed_out ? "artifact_upload_timeout" : "artifact_upload_failed", "Failed to upload the artifact to the board over SSH/base64.", upload);
-    }
-    let runResult;
-    if (request.run === true) {
-        runResult = await ssh(host, user, [
-            `cd ${shellQuote(remoteDir)}`,
-            `(nohup ${shellQuote(remotePath)} > ${shellQuote(logPath)} 2>&1 < /dev/null & printf '%s' "$!" > ${shellQuote(pidPath)})`,
-            "sleep 1",
-            "printf 'pid='",
-            `cat ${shellQuote(pidPath)}`,
-            "printf '\\n'",
-            `tail -n 40 ${shellQuote(logPath)} 2>/dev/null || true`
-        ].join(" && "), timeoutSeconds);
-        if (runResult.exit_code !== 0) {
-            return commandFailure(runResult.timed_out ? "artifact_run_timeout" : "artifact_run_failed", "The artifact was deployed, but the start/log command failed.", runResult);
-        }
-    }
-    return {
-        board_id: "taishanpi",
-        host,
-        user,
-        artifact_path: request.artifact_path,
-        artifact_size_bytes: artifactStat.size,
-        remote_path: remotePath,
-        deployed: true,
-        ran: request.run === true && runResult?.exit_code === 0,
-        remote_pid: runResult ? extractPid(runResult.stdout) : undefined,
-        log_path: logPath,
-        exit_code: runResult?.exit_code,
-        stdout: runResult?.stdout,
-        stderr: runResult?.stderr,
-        output_tail: runResult ? tailLines(`${runResult.stdout}\n${runResult.stderr}`) : tailLines(`${upload.stdout}\n${upload.stderr}`),
-        observed_at: observedAt
-    };
-}
-async function ssh(host, user, command, timeoutSeconds, stdin) {
-    return runCommand("ssh", [
-        "-o", "BatchMode=yes",
-        "-o", "UserKnownHostsFile=/dev/null",
-        "-o", "StrictHostKeyChecking=no",
-        "-o", `ConnectTimeout=${Math.max(1, Math.min(timeoutSeconds, 30))}`,
-        `${user}@${host}`,
-        command
-    ], timeoutSeconds * 1000 + 1000, stdin);
-}
-function normalizeRemotePath(input) {
-    if (!input.startsWith("/") || /[\u0000-\u001f\u007f]/.test(input)) {
-        return undefined;
-    }
-    const normalized = posix.normalize(input);
-    if (normalized === REMOTE_ROOT || !normalized.startsWith(`${REMOTE_ROOT}/`)) {
-        return undefined;
-    }
-    if (!/^\/[A-Za-z0-9._/-]+$/.test(normalized) || normalized.endsWith("/")) {
-        return undefined;
-    }
-    return normalized;
-}
-function clampTimeoutSeconds(value) {
-    const timeout = Number.isFinite(value) ? Number(value) : 30;
-    return Math.max(5, Math.min(Math.trunc(timeout), 120));
-}
-function failDeploy(code, message, remediation) {
-    return { ok: false, error: { code, message, remediation } };
-}
-function commandFailure(code, message, result) {
-    return {
-        ok: false,
-        error: {
-            code,
-            message,
-            details: {
-                exit_code: result.exit_code,
-                stdout: result.stdout,
-                stderr: result.stderr,
-                timed_out: result.timed_out
-            }
-        }
-    };
-}
-function shellQuote(value) {
-    return `'${value.replace(/'/g, "'\\''")}'`;
-}
-function extractPid(stdout) {
-    const match = stdout.match(/^pid=(\d+)/m);
-    return match?.[1];
-}
-//# sourceMappingURL=deploy.js.map

package/dist/adapters/deploy.js.map

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

package/dist/adapters/flash.d.ts

@@ -1,3 +0,0 @@
-import type { FlashPlan, FlashPlanRequest } from "@embed-labs/protocol";
-export declare function buildFlashPlan(request: FlashPlanRequest): Promise<FlashPlan>;
-export declare function executeRp2350Uf2Flash(plan: FlashPlan): Promise<Record<string, unknown>>;