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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +14 -2
  2. package/package.json +5 -5
package/README.md CHANGED
@@ -19,8 +19,9 @@ are complete.
19
19
  `@embed-labs/local-bridge-linux-arm64`, and
20
20
  `@embed-labs/local-bridge-win32-x64`.
21
21
  - Local health endpoint.
22
- - Device discovery for serial ports, RP2350-compatible UF2 volumes, Rockchip
23
- USB Loader/Maskrom style devices, and the current TaishanPi USB ECM probe.
22
+ - Event-maintained device inventory for serial ports, RP2350-compatible UF2
23
+ volumes, Rockchip USB Loader/Maskrom style devices, RP2350 Monitor endpoints,
24
+ and TaishanPi USB ECM or configured-host probes.
24
25
  - Bounded TCP, serial path, serial capture, and SSH command probes.
25
26
  - Non-destructive debug tool availability scans for OpenOCD, probe-rs, pyOCD,
26
27
  and SEGGER J-Link command-line tools.
@@ -65,6 +66,9 @@ omitted during install, reinstall without `--omit=optional`.
65
66
 
66
67
  - `GET /healthz`
67
68
  - `GET /v1/devices`
69
+ - `GET /v1/devices?refresh=1`
70
+ - `GET /v1/devices/<local_device_id>`
71
+ - `GET /v1/devices/stream`
68
72
  - `GET /v1/debug/tools`
69
73
  - `GET /v1/tools/capabilities`
70
74
  - `POST /v1/tools/invoke`
@@ -84,6 +88,7 @@ Examples:
84
88
  ```bash
85
89
  curl -fsS http://127.0.0.1:18083/healthz
86
90
  curl -fsS http://127.0.0.1:18083/v1/devices
91
+ curl -fsS http://127.0.0.1:18083/v1/devices?refresh=1
87
92
  curl -fsS http://127.0.0.1:18083/v1/debug/tools
88
93
  curl -fsS http://127.0.0.1:18083/v1/devices/probe \
89
94
  -H 'content-type: application/json' \
@@ -107,6 +112,13 @@ hardware surface: `rp2350.monitor.capabilities`, `status`, `gpio.read`,
107
112
  operation is unclear, then use the specific tool rather than scraping the
108
113
  monitor UI.
109
114
 
115
+ `GET /v1/devices` and `/v1/devices/stream` read the bridge's current
116
+ in-memory inventory. They do not perform hardware scans as a side effect. The
117
+ bridge keeps that inventory warm through startup refresh, platform device
118
+ events, cheap locator polling, and a low-frequency fallback scan. Use
119
+ `/v1/devices?refresh=1` or the `device.scan` tool only for explicit diagnostic
120
+ refreshes.
121
+
110
122
  ## Hardware Support Boundary
111
123
 
112
124
  Current local behavior is intentionally narrow:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kvell007/embed-labs-local-bridge",
3
- "version": "0.1.0-alpha.25",
3
+ "version": "0.1.0-alpha.26",
4
4
  "description": "Local hardware bridge service for Embed Labs Cloud. Experimental npm publish.",
5
5
  "private": false,
6
6
  "type": "module",
@@ -18,10 +18,10 @@
18
18
  "embed-local-bridge": "dist/index.js"
19
19
  },
20
20
  "optionalDependencies": {
21
- "@embed-labs/local-bridge-darwin-arm64": "npm:@kvell007/embed-labs-local-bridge-darwin-arm64@0.1.0-alpha.25",
22
- "@embed-labs/local-bridge-linux-arm64": "npm:@kvell007/embed-labs-local-bridge-linux-arm64@0.1.0-alpha.25",
23
- "@embed-labs/local-bridge-linux-x64": "npm:@kvell007/embed-labs-local-bridge-linux-x64@0.1.0-alpha.25",
24
- "@embed-labs/local-bridge-win32-x64": "npm:@kvell007/embed-labs-local-bridge-win32-x64@0.1.0-alpha.25"
21
+ "@embed-labs/local-bridge-darwin-arm64": "npm:@kvell007/embed-labs-local-bridge-darwin-arm64@0.1.0-alpha.26",
22
+ "@embed-labs/local-bridge-linux-arm64": "npm:@kvell007/embed-labs-local-bridge-linux-arm64@0.1.0-alpha.26",
23
+ "@embed-labs/local-bridge-linux-x64": "npm:@kvell007/embed-labs-local-bridge-linux-x64@0.1.0-alpha.26",
24
+ "@embed-labs/local-bridge-win32-x64": "npm:@kvell007/embed-labs-local-bridge-win32-x64@0.1.0-alpha.26"
25
25
  },
26
26
  "publishConfig": {
27
27
  "access": "public",