@esp-vision/device-cli 0.1.0 → 0.1.1

package/README.md

@@ -2,7 +2,7 @@
 
 `@esp-vision/device-cli` installs the `esp-vision-device` command for device discovery, inspection, configuration, control, firmware updates, Python execution, device file operations, JPEG capture, sequential batch plans, and bounded event watches. It is an optional host interface backed by the same `@esp-vision/device-core` package used by ESP-VISION clients.
 
-Requires Node.js 22 or newer. Serial access requires Python with `pyserial`; firmware flashing requires Python `esptool>=5.3,<6`. LAN discovery uses the bundled multicast-DNS client.
+Requires Node.js 22 or newer. Serial access requires Python with `pyserial`; firmware flashing requires Python `esptool==5.6.0`. LAN discovery uses the bundled multicast-DNS client. Check the selected interpreter with `PYTHON --version` and `PYTHON -c "import serial"`; install pyserial there with `PYTHON -m pip install pyserial` (replace `PYTHON` with that executable). Windows Python Launcher users can use `--python py` and `py -m pip install pyserial`. A failed serial setup gets a bounded environment diagnosis after connection cleanup; successful connections, TCP operations, help, and offline firmware checks do not start it. Busy/access-denied errors keep their port-specific guidance; an unknown adapter failure is not proof of missing Python or pyserial.
 
 Run `esp-vision-device --help` for the command reference, or `esp-vision-device --help --json` for the versioned machine-readable command, output, and limit capabilities envelope.
 
@@ -26,7 +26,7 @@ For a continuous app, finish directory operations and uploads before starting it
 
 `files list`, `files read`, `files write`, `files remove`, and `files mkdir` operate on device paths. `files read DEVICE_PATH --output LOCAL_FILE` writes binary content to a local file. `files write DEVICE_PATH --file LOCAL_FILE` sends local bytes to the device. Reads are capped at 16 MiB by default; `--max-bytes` can lower that limit.
 
-`capture camera|screen --output LOCAL.jpg` writes one JPEG and returns its path, byte count, source, MIME type, and capture metadata. Images are never embedded as base64 in JSON output.
+`capture camera|screen --output LOCAL.jpg` writes one JPEG and returns its path, byte count, source, MIME type, and capture metadata. Images are never embedded as base64 in JSON output. The `source` field identifies the requested source; it does not certify whether annotations are present. `camera` observes the application's latest camera frame, not the LCD image. Application drawing depends on firmware publication behavior; firmware advertising `debug.capture_frame.observed.v1` supplies an independent copy made at acquisition, before later drawing, without triggering a new acquisition. `screen` captures the current LCD framebuffer, including drawing rendered there; use it to verify LCD overlays and UI. It requires an initialized display, and camera/display dimensions may differ. Neither source starts the application or initializes the sensor/display for you.
 
 ## Bounded event watch
 
@@ -58,3 +58,5 @@ For a continuous app, finish directory operations and uploads before starting it
 Status, Python output, firmware phases, cancellation, errors, and duration are NDJSON events on stderr. SIGINT exits with code 130, SIGTERM with 143, argument/plan errors with 2, other failures with 1, and success with 0. Busy or uncertain operations are never retried automatically.
 
 Inspect JSON output uses the same versioned envelope as other commands. Human-readable inspect output remains a terminal table.
+
+Device paths such as `/models` stay absolute device paths on Windows. Git Bash/MSYS may rewrite them; use PowerShell or prefix the individual command with `MSYS2_ARG_CONV_EXCL="*"`, supplying local paths in Windows form. Quoting the device path alone does not prevent conversion. Invalid device paths now fail before connecting, with a shell hint for Windows host paths.

package/THIRD_PARTY_NOTICES.md

@@ -120,7 +120,7 @@ Bundled from: `node_modules/@esp-vision/device-core/src/firmware_feed.js`, `node
 
 ### Source notice 7
 
-Bundled from: `node_modules/@esp-vision/device-core/src/firmware_io.js`, `node_modules/@esp-vision/device-core/src/firmware_release.js`, `node_modules/@esp-vision/device-core/src/node.js`
+Bundled from: `node_modules/@esp-vision/device-core/src/firmware_io.js`, `node_modules/@esp-vision/device-core/src/firmware_release.js`, `node_modules/@esp-vision/device-core/src/node.js`, `src/serial_diagnostics.js`
 
 ```text
 // SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
@@ -128,7 +128,7 @@ Bundled from: `node_modules/@esp-vision/device-core/src/firmware_io.js`, `node_m
 
 ### Source notice 8
 
-Bundled from: `node_modules/@esp-vision/device-core/src/device_files.js`, `node_modules/@esp-vision/device-core/src/device_python.js`, `node_modules/@esp-vision/device-core/src/firmware_feed.js`, `node_modules/@esp-vision/device-core/src/firmware_flash.js`, `node_modules/@esp-vision/device-core/src/firmware_io.js`, `node_modules/@esp-vision/device-core/src/firmware_release.js`, `node_modules/@esp-vision/device-core/src/index.js`, `node_modules/@esp-vision/device-core/src/network_discovery.js`, `node_modules/@esp-vision/device-core/src/network_discovery_node.js`, `node_modules/@esp-vision/device-core/src/node.js`, `node_modules/@esp-vision/device-core/src/node_inventory.js`, `node_modules/@esp-vision/device-core/src/node_rom.js`, `node_modules/@esp-vision/device-core/src/node_transport.js`, `src/cli.js`
+Bundled from: `node_modules/@esp-vision/device-core/src/device_files.js`, `node_modules/@esp-vision/device-core/src/device_python.js`, `node_modules/@esp-vision/device-core/src/firmware_feed.js`, `node_modules/@esp-vision/device-core/src/firmware_flash.js`, `node_modules/@esp-vision/device-core/src/firmware_io.js`, `node_modules/@esp-vision/device-core/src/firmware_release.js`, `node_modules/@esp-vision/device-core/src/index.js`, `node_modules/@esp-vision/device-core/src/network_discovery.js`, `node_modules/@esp-vision/device-core/src/network_discovery_node.js`, `node_modules/@esp-vision/device-core/src/node.js`, `node_modules/@esp-vision/device-core/src/node_inventory.js`, `node_modules/@esp-vision/device-core/src/node_rom.js`, `node_modules/@esp-vision/device-core/src/node_transport.js`, `src/cli.js`, `src/serial_diagnostics.js`
 
 ```text
 // SPDX-License-Identifier: Apache-2.0

package/dist/device-cli.mjs

@@ -3795,6 +3795,60 @@ function stringWidth(string, options2 = {}) {
   return width;
 }
 
+// src/serial_diagnostics.js
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+var check = `import sys
+try:
+ import serial
+except ModuleNotFoundError as error:
+ sys.exit(71 if error.name == 'serial' else 73)
+except Exception:
+ sys.exit(73)
+sys.exit(0 if callable(getattr(serial, 'Serial', None)) else 72)
+`;
+async function explainSerialFailure(failure3, options2, dependencies = {}) {
+  if (failure3?.code === "SERIAL_BUSY") {
+    failure3.message = "Serial port is busy. Close the IDE, serial monitor or other process using this port before retrying.";
+    return failure3;
+  }
+  if (failure3?.code === "SERIAL_ACCESS_DENIED") {
+    failure3.message = "Serial port access was denied. Check port permissions and close other applications using it; Windows may report an occupied port as access denied.";
+    return failure3;
+  }
+  if (!["SERIAL_ERROR", "SERIAL_UNAVAILABLE"].includes(failure3?.code)) return failure3;
+  if (dependencies.signal?.aborted) return failure3;
+  if (["read", "write", "stdout", "stdin"].includes(failure3.details?.stage)) return failure3;
+  let reason = "unknown";
+  try {
+    await (dependencies.execFile ?? promisify(execFile))(options2.python, ["-c", check], {
+      signal: dependencies.signal,
+      timeout: Math.min(options2.timeout ?? 3e3, 3e3),
+      maxBuffer: 4096,
+      windowsHide: true
+    });
+    reason = "available";
+  } catch (cause) {
+    if (dependencies.signal?.aborted) return failure3;
+    if (cause.code === "ENOENT") reason = "missing-python";
+    else if (cause.code === "EACCES") reason = "python-permission";
+    else if (cause.code === 71) reason = "missing-pyserial";
+    else if (cause.code === 72) reason = "invalid-pyserial";
+    else if (cause.code === 73) reason = "import-failed";
+  }
+  const messages = {
+    "missing-python": "The configured Python executable was not found. Check python3 --version (Windows: python --version or py --version), then select an installed interpreter with --python PATH; Windows Python Launcher users can use --python py.",
+    "python-permission": "The configured Python executable could not be started because access was denied. Check executable permissions or select an accessible interpreter with --python PATH.",
+    "missing-pyserial": 'The configured Python interpreter has no pyserial module. Install it in that same interpreter with PYTHON -m pip install pyserial (Windows Launcher: py -m pip install pyserial and --python py), then verify PYTHON -c "import serial". Replace PYTHON with the executable selected by --python.',
+    "invalid-pyserial": "The configured Python imported a serial module without the pyserial Serial API. Check for a conflicting serial.py or serial package; verify pyserial in the interpreter selected by --python.",
+    "import-failed": 'The configured Python could not import pyserial successfully. Run PYTHON -c "import serial" in the same interpreter to inspect the environment; select it with --python PATH.',
+    available: "Python and the pyserial Serial API are available. Check the selected port, cable, OS permissions and whether another application owns the port. The serial failure does not establish a missing dependency.",
+    unknown: 'Serial adapter failed; Python/pyserial availability could not be established. Check PYTHON --version and PYTHON -c "import serial", select that interpreter with --python PATH (Windows Launcher: --python py), and check port permissions and other applications using the port.'
+  };
+  failure3.message = messages[reason];
+  return failure3;
+}
+
 // node_modules/@esp-vision/device-core/src/device_session.js
 var EV_MUX_VERSION = 4;
 var INLINE_PYTHON_REPL_TIMEOUT_MS = 5e3;
@@ -7807,8 +7861,8 @@ import { createInterface } from "node:readline";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // node_modules/@esp-vision/device-core/src/node_inventory.js
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
+import { execFile as execFile2 } from "node:child_process";
+import { promisify as promisify2 } from "node:util";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // node_modules/@esp-vision/device-core/src/network_discovery_node.js
@@ -7949,7 +8003,7 @@ var defaultPython = process.platform === "win32" ? "python" : "python3";
 async function listSerial({ python = defaultPython, signal, timeout = 1e4 } = {}, dependencies = {}) {
   if (!Number.isFinite(timeout) || timeout <= 0) throw new RangeError("Serial enumeration timeout must be positive");
   try {
-    const run = dependencies.execFile ?? promisify(execFile);
+    const run = dependencies.execFile ?? promisify2(execFile2);
     const { stdout } = await run(python, [fileURLToPath2(new URL("./node_serial.py", import.meta.url)), "--list"], { signal, timeout, maxBuffer: 1024 * 1024, windowsHide: true });
     const ports = JSON.parse(stdout);
     if (!Array.isArray(ports)) throw new Error("Invalid serial list");
@@ -8174,9 +8228,12 @@ esp-vision-device files write DEVICE_PATH --file LOCAL_FILE [--no-overwrite]
 esp-vision-device files remove DEVICE_PATH [--type file|directory]
 esp-vision-device files mkdir DEVICE_DIR [--recursive]
 esp-vision-device capture camera|screen --output LOCAL.jpg [--quality N] [--max-bytes N]
+  camera: Observe the application's camera-frame source, not the LCD image. Freshness and application drawing depend on firmware publication behavior.
+  screen: Capture the current LCD framebuffer, including drawing rendered there. Use this to verify LCD overlays and UI; display initialization is required.
 esp-vision-device batch PLAN.json [--port PATH | --tcp HOST[:PORT]]
 esp-vision-device watch --duration MS [--port PATH | --tcp HOST[:PORT]]
 Common: --timeout MS, --python PYTHON (default python3; Windows python), --json, --help
+Serial setup: check PYTHON --version and PYTHON -c "import serial" with the selected interpreter. Install pyserial there with PYTHON -m pip install pyserial. Windows Launcher: --python py and py -m pip install pyserial.
 All commands that operate on a device require --port or --tcp, except inspect and offline firmware check.
 Python --completion start accepts only --path DEVICE.py. It acknowledges the start, disconnects, and exits; it does not retain a daemon or resumable job.
 Python --timeout is an execution deadline for --completion wait only; omit it with --completion start.
@@ -8187,7 +8244,7 @@ Batch plans use schemaVersion 1 with an operations array. Operations run sequent
 In JSON mode stdout contains one schemaVersion 1 JSON envelope. Python output, status, logs, and errors are NDJSON events on stderr.
 Binary file reads and JPEG captures always write to --output. Local output is capped at 16 MiB by default and --max-bytes may lower that cap.
 Firmware versions come from dl.espressif.com by default; local catalogs are advanced overrides.
-Firmware update uses the built-in serial flasher (Python esptool>=5.3,<6). TCP is not OTA.
+Firmware update uses the built-in serial flasher (Python esptool==5.6.0). TCP is not OTA.
 Default mode update preserves the existing layout/data; explicit mode install writes a complete image, replacing data in its written range. Blank boards require --board and a ROM-capable USJ/UART port, not an application USB-OTG interface.`;
 var cliCapabilities = Object.freeze({
   commands: {
@@ -8197,7 +8254,7 @@ var cliCapabilities = Object.freeze({
     firmware: ["check", "update"],
     python: ["--source CODE", "--file LOCAL.py", "--path DEVICE.py", "live output, log and state NDJSON events"],
     files: ["list", "read", "write", "remove", "mkdir"],
-    capture: ["camera JPEG", "screen JPEG"],
+    capture: ["camera JPEG: latest application camera frame, not the LCD image; drawing depends on firmware publication behavior", "screen JPEG: LCD framebuffer with drawing rendered there; requires display initialization"],
     batch: ["sequential schemaVersion 1 JSON plan", "one connection", "stop at first failure"],
     watch: ["bounded output, log, state and diagnostic stream", "one connection", "no script launch or reconnect"]
   },
@@ -8215,6 +8272,13 @@ var error = (code, message, options2 = {}) => Object.assign(new Error(message),
 var optionError = (message) => error("ARGUMENT", message);
 var knownDeviceCommands = ["configure", "control", "firmware", "python", "files", "capture", "batch", "watch"];
 var commonOptions = ["port", "tcp", "python", "timeout", "json", "role"];
+function devicePath(value, { root = false, fail: fail2 = optionError } = {}) {
+  if (typeof value !== "string" || !value.startsWith("/") || !root && value === "/" || new TextEncoder().encode(value).length > 123 || /[\x00-\x1f\x7f\\"]/.test(value) || value.includes("..") || value.includes("//") || value.length > 1 && value.endsWith("/")) {
+    const shellHint = typeof value === "string" && /^[A-Za-z]:[\\/]/.test(value) ? ' Received a Windows host path; Git Bash/MSYS may have converted the device path. Use PowerShell or prefix this command with MSYS2_ARG_CONV_EXCL="*" and keep local paths in Windows form.' : "";
+    throw fail2("Expected an absolute device path (for example /models), at most 123 UTF-8 bytes, without traversal, trailing slash or forbidden characters." + shellHint);
+  }
+  return value;
+}
 function parseTcpAddress(value) {
   const match = /^(?:\[([0-9a-fA-F:]+)\]|([^\s:/@?#]+))(?::([0-9]+))?$/.exec(value);
   if (!match || Number(match[3] ?? 3232) < 1 || Number(match[3] ?? 3232) > 65535) {
@@ -8367,6 +8431,7 @@ function parseCli(args) {
     if (!endpoint) throw optionError("Specify --port or --tcp");
     const forms = ["source", "file", "path"].filter((key) => v[key] !== void 0);
     if (forms.length !== 1) throw optionError("Specify exactly one of --source, --file or --path");
+    if (v.path !== void 0) devicePath(v.path);
     options2.completion = v.completion ?? "wait";
     if (!["wait", "start"].includes(options2.completion)) throw optionError("--completion must be wait or start");
     if (options2.completion === "start" && v.path === void 0) throw optionError("--completion start requires device --path");
@@ -8390,6 +8455,7 @@ function parseCli(args) {
       if (v.path !== void 0) throw optionError(`files ${subcommand} uses a positional device path`);
       options2.path = pathPositional;
     }
+    devicePath(options2.path, { root: subcommand === "list" });
     if (subcommand === "read") {
       if (!v.output) throw optionError("files read requires --output LOCAL_FILE");
       options2.maxBytes = parsePositiveInteger(v["max-bytes"] ?? String(MAX_FILE_OUTPUT), "--max-bytes", { max: MAX_FILE_OUTPUT });
@@ -8438,7 +8504,27 @@ async function passwordFromInput(options2) {
 }
 function errorInfo(failure3) {
   if (!failure3) return void 0;
-  return { code: failure3.code ?? "COMMAND_FAILED", message: failure3.message ?? "Command failed" };
+  const info = { code: failure3.code ?? "COMMAND_FAILED", message: failure3.message ?? "Command failed" };
+  if (failure3.code === "ROM_OPERATION_FAILED") {
+    if (typeof failure3.operation === "string") info.operation = failure3.operation.slice(0, 64);
+    if (typeof failure3.cause === "string") info.detail = failure3.cause.slice(0, 1024);
+  }
+  if (failure3.reset?.acknowledged === false && failure3.reset.outcome === "unknown") {
+    info.reset = { acknowledged: false, outcome: "unknown" };
+  }
+  if (String(failure3.code).startsWith("ROM_") && typeof failure3.transition?.command?.attempted === "boolean") {
+    const transition = failure3.transition;
+    info.transition = {
+      command: {
+        attempted: transition.command.attempted,
+        acknowledged: transition.command.acknowledged === true,
+        outcome: ["unknown", "not_attempted"].includes(transition.command.outcome) ? transition.command.outcome : "unknown"
+      },
+      observed: transition.observed === "rom" ? "rom" : null,
+      cleanup: typeof transition.cleanup?.ok === "boolean" ? { ok: transition.cleanup.ok } : null
+    };
+  }
+  return info;
 }
 function attachCleanupFailure(primary, cleanupFailure) {
   if (primary && cleanupFailure) {
@@ -8458,12 +8544,7 @@ function validatePlan(plan, planFile) {
     if (typeof value !== "string" || value.length === 0 || value.includes("\0")) throw planError("Batch local paths must be nonempty strings");
     return resolve(base, value);
   };
-  const devicePath = (value, { root = false } = {}) => {
-    if (typeof value !== "string" || !root && value === "/" || !value.startsWith("/") || value.length > 123 || /[\x00-\x1f\x7f\\"]/.test(value) || value.includes("..") || value.includes("//") || value.length > 1 && value.endsWith("/")) {
-      throw planError("Batch device paths must be absolute valid device paths");
-    }
-    return value;
-  };
+  const planDevicePath = (value, options2 = {}) => devicePath(value, { ...options2, fail: planError });
   return plan.operations.map((operation, index) => {
     const fail2 = (message) => {
       throw planError(`Batch operation ${index + 1}: ${message}`);
@@ -8484,27 +8565,27 @@ function validatePlan(plan, planFile) {
       const forms = ["source", "file", "path"].filter((key) => Object.hasOwn(operation, key));
       if (forms.length !== 1) fail2("python requires exactly one of source, file or path");
       if (operation.source !== void 0 && typeof operation.source !== "string") fail2("source must be a string");
-      if (operation.path !== void 0) copy.path = devicePath(operation.path);
+      if (operation.path !== void 0) copy.path = planDevicePath(operation.path);
       if (operation.file !== void 0) copy.file = local(operation.file);
     } else if (operation.op === "files.list") {
-      copy.path = devicePath(operation.path ?? "/", { root: true });
+      copy.path = planDevicePath(operation.path ?? "/", { root: true });
       if (operation.recursive !== void 0 && typeof operation.recursive !== "boolean") fail2("recursive must be boolean");
     } else if (operation.op === "files.read") {
-      copy.path = devicePath(operation.path);
+      copy.path = planDevicePath(operation.path);
       if (operation.output === void 0) fail2("files.read requires output");
       copy.output = local(operation.output);
       copy.maxBytes = operation.maxBytes ?? MAX_FILE_OUTPUT;
       if (!Number.isSafeInteger(copy.maxBytes) || copy.maxBytes < 1 || copy.maxBytes > MAX_FILE_OUTPUT) fail2("maxBytes must be 1..16 MiB");
     } else if (operation.op === "files.write") {
-      copy.path = devicePath(operation.path);
+      copy.path = planDevicePath(operation.path);
       if (operation.file === void 0) fail2("files.write requires file");
       copy.file = local(operation.file);
       if (operation.overwrite !== void 0 && typeof operation.overwrite !== "boolean") fail2("overwrite must be boolean");
     } else if (operation.op === "files.remove") {
-      copy.path = devicePath(operation.path);
+      copy.path = planDevicePath(operation.path);
       if (operation.type !== void 0 && !["file", "directory"].includes(operation.type)) fail2("type must be file or directory");
     } else if (operation.op === "files.mkdir") {
-      copy.path = devicePath(operation.path);
+      copy.path = planDevicePath(operation.path);
       if (operation.recursive !== void 0 && typeof operation.recursive !== "boolean") fail2("recursive must be boolean");
     } else if (operation.op === "capture") {
       if (!["camera", "screen"].includes(operation.source)) fail2("capture source must be camera or screen");
@@ -8742,6 +8823,24 @@ function createWatchObserver(device, options2, dependencies) {
     }
   };
 }
+async function cliInventory(options2, dependencies) {
+  let serialFailure;
+  const listing = await inventory(options2, {
+    ...dependencies,
+    async listSerial(request) {
+      try {
+        return await (dependencies.listSerial ?? listSerial)(request);
+      } catch (failure3) {
+        serialFailure = await explainSerialFailure(failure3, options2, dependencies);
+        throw serialFailure;
+      }
+    }
+  });
+  if (serialFailure) for (const warning of listing.warnings) {
+    if (warning.source === "serial") warning.message = serialFailure.message;
+  }
+  return listing;
+}
 async function runCli(options2, dependencies = {}) {
   if (options2.help) return { help: usage };
   const startedAt = Date.now();
@@ -8756,13 +8855,13 @@ async function runCli(options2, dependencies = {}) {
     }
   }
   if (options2.command === "inspect" && !endpoint && !options2.select) {
-    const listing = await (dependencies.inventory ?? inventory)({ ...options2, signal: dependencies.signal, timeout: Math.min(options2.timeout, 1e4) }, dependencies);
-    if (listing.sourcesAvailable === 0) throw error("ENUMERATION_UNAVAILABLE", "No inventory source succeeded; check Python/pyserial, multicast-dns and permissions");
+    const listing = await (dependencies.inventory ?? cliInventory)({ ...options2, signal: dependencies.signal, timeout: Math.min(options2.timeout, 1e4) }, dependencies);
+    if (listing.sourcesAvailable === 0) throw error("ENUMERATION_UNAVAILABLE", `No inventory source succeeded. ${listing.warnings.map((warning) => warning.message).join(" ")}`);
     emit(dependencies, { event: "duration", milliseconds: Date.now() - startedAt });
     return listing;
   }
   if (options2.command === "inspect" && !endpoint && options2.select) {
-    const listing = await (dependencies.inventory ?? inventory)({ ...options2, signal: dependencies.signal, timeout: Math.min(options2.timeout, 1e4) }, dependencies);
+    const listing = await (dependencies.inventory ?? cliInventory)({ ...options2, signal: dependencies.signal, timeout: Math.min(options2.timeout, 1e4) }, dependencies);
     endpoint = listing.devices.find((row) => row.number === options2.select);
     if (!endpoint) {
       emit(dependencies, { event: "duration", milliseconds: Date.now() - startedAt });
@@ -8845,6 +8944,9 @@ async function runCli(options2, dependencies = {}) {
     primary = attachCleanupFailure(primary, cleanupFailure);
   }
   emit(dependencies, { event: "state", state: "disconnected" });
+  if (primary && endpoint?.interface !== "tcp" && (endpoint || options2.port)) {
+    primary = await explainSerialFailure(primary, options2, dependencies);
+  }
   const durationMs = Date.now() - startedAt;
   emit(dependencies, { event: "duration", milliseconds: durationMs });
   if (primary) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esp-vision/device-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Standalone command line interface for ESP-VISION devices.",
   "type": "module",
   "bin": {
@@ -36,7 +36,7 @@
     "cli"
   ],
   "devDependencies": {
-    "@esp-vision/device-core": "0.5.1",
+    "@esp-vision/device-core": "~0.5.0",
     "esbuild": "0.25.12",
     "multicast-dns": "7.2.5",
     "string-width": "7.2.0"
@@ -45,5 +45,12 @@
     "type": "git",
     "url": "git+https://github.com/espressif/esp-vision.git",
     "directory": "host/device-cli"
+  },
+  "espVisionReleaseType": "patch",
+  "espVision": {
+    "deviceCore": "~0.5.0",
+    "resolved": {
+      "deviceCore": "0.5.1"
+    }
   }
 }