@kvell007/embed-labs-local-bridge 0.1.0-alpha.24 → 0.1.0-alpha.26

package/README.md

@@ -19,12 +19,16 @@ are complete.
   `@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.
+- Event-maintained device inventory for serial ports, RP2350-compatible UF2
+  volumes, Rockchip USB Loader/Maskrom style devices, RP2350 Monitor endpoints,
+  and TaishanPi USB ECM or configured-host probes.
 - Bounded TCP, serial path, serial capture, and SSH command probes.
 - 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.
+- RP2350/Pico 2 monitor capability catalog plus first-class GPIO, UART, I2C,
+  SPI, logic-analyzer, Wi-Fi, and debug-probe operations routed through the
+  shared `/api/operation` bridge.
 - Stable HTTP/JSON response contracts used by the CLI and agent plugins.
 
 ## Install
@@ -62,6 +66,9 @@ omitted during install, reinstall without `--omit=optional`.
 
 - `GET /healthz`
 - `GET /v1/devices`
+- `GET /v1/devices?refresh=1`
+- `GET /v1/devices/<local_device_id>`
+- `GET /v1/devices/stream`
 - `GET /v1/debug/tools`
 - `GET /v1/tools/capabilities`
 - `POST /v1/tools/invoke`
@@ -81,15 +88,37 @@ Examples:
 ```bash
 curl -fsS http://127.0.0.1:18083/healthz
 curl -fsS http://127.0.0.1:18083/v1/devices
+curl -fsS http://127.0.0.1:18083/v1/devices?refresh=1
 curl -fsS http://127.0.0.1:18083/v1/debug/tools
 curl -fsS http://127.0.0.1:18083/v1/devices/probe \
   -H 'content-type: application/json' \
   -d '{"host":"198.19.77.2","ports":[22,15301],"timeout_ms":1000}'
+curl -fsS http://127.0.0.1:18083/v1/tools/invoke \
+  -H 'content-type: application/json' \
+  -d '{"capability_id":"rp2350.monitor.capabilities","input":{}}'
+curl -fsS http://127.0.0.1:18083/v1/tools/invoke \
+  -H 'content-type: application/json' \
+  -d '{"capability_id":"rp2350.monitor.gpio.read","approved":true,"input":{"pins":[16,17],"pull":"none"}}'
 curl -fsS http://127.0.0.1:18083/v1/tools/invoke \
   -H 'content-type: application/json' \
   -d '{"capability_id":"rp2350.monitor.spi.transfer","approved":true,"input":{"hex":"a55a3cc3"}}'
 ```
 
+RP2350/Pico 2 monitor capabilities are intentionally exposed as a complete
+hardware surface: `rp2350.monitor.capabilities`, `status`, `gpio.read`,
+`gpio.write`, `uart.write`, `i2c.transfer`, `spi.transfer`, `logic.capture`,
+`logic.decode`, `wifi.manage`, `probe.debug`, `operation`, and legacy
+`command`. Agents should ask for the catalog first when the protocol or
+operation is unclear, then use the specific tool rather than scraping the
+monitor UI.
+
+`GET /v1/devices` and `/v1/devices/stream` read the bridge's current
+in-memory inventory. They do not perform hardware scans as a side effect. The
+bridge keeps that inventory warm through startup refresh, platform device
+events, cheap locator polling, and a low-frequency fallback scan. Use
+`/v1/devices?refresh=1` or the `device.scan` tool only for explicit diagnostic
+refreshes.
+
 ## Hardware Support Boundary
 
 Current local behavior is intentionally narrow:
@@ -101,6 +130,9 @@ Current local behavior is intentionally narrow:
   they do not open probes, start GDB servers, or create debug sessions.
 - RP2350 UF2 flashing copies a `.uf2` artifact to a mounted UF2 volume only
   after a ready flash plan and explicit approval.
+- RP2350 Monitor protocol operations are exposed through the capability catalog
+  and specific local tools. Agents should not scrape the monitor UI or call raw
+  serial/TCP endpoints to learn operation formats.
 - TaishanPi image-set planning can check required image files and
   `rkdeveloptool` availability, but real destructive TaishanPi flashing is
   guarded and not enabled. The bridge returns a blocked job until the exact

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kvell007/embed-labs-local-bridge",
-  "version": "0.1.0-alpha.24",
+  "version": "0.1.0-alpha.26",
   "description": "Local hardware bridge service for Embed Labs Cloud. Experimental npm publish.",
   "private": false,
   "type": "module",
@@ -18,10 +18,10 @@
     "embed-local-bridge": "dist/index.js"
   },
   "optionalDependencies": {
-    "@embed-labs/local-bridge-darwin-arm64": "npm:@kvell007/embed-labs-local-bridge-darwin-arm64@0.1.0-alpha.24",
-    "@embed-labs/local-bridge-linux-arm64": "npm:@kvell007/embed-labs-local-bridge-linux-arm64@0.1.0-alpha.24",
-    "@embed-labs/local-bridge-linux-x64": "npm:@kvell007/embed-labs-local-bridge-linux-x64@0.1.0-alpha.24",
-    "@embed-labs/local-bridge-win32-x64": "npm:@kvell007/embed-labs-local-bridge-win32-x64@0.1.0-alpha.24"
+    "@embed-labs/local-bridge-darwin-arm64": "npm:@kvell007/embed-labs-local-bridge-darwin-arm64@0.1.0-alpha.26",
+    "@embed-labs/local-bridge-linux-arm64": "npm:@kvell007/embed-labs-local-bridge-linux-arm64@0.1.0-alpha.26",
+    "@embed-labs/local-bridge-linux-x64": "npm:@kvell007/embed-labs-local-bridge-linux-x64@0.1.0-alpha.26",
+    "@embed-labs/local-bridge-win32-x64": "npm:@kvell007/embed-labs-local-bridge-win32-x64@0.1.0-alpha.26"
   },
   "publishConfig": {
     "access": "public",