@condorinst/mobile-bridge 0.23.0 → 0.23.1

package/AGENTS.md

@@ -122,12 +122,12 @@ build. Copy it, then install, so its `package.json` is the one you keep:
 
 ```bash
 mkdir my-home && cd my-home
-npm pack @condorinst/mobile-bridge@^0.23.0 && tar -xzf condorinst-mobile-bridge-*.tgz
+npm pack @condorinst/mobile-bridge@^0.23.1 && tar -xzf condorinst-mobile-bridge-*.tgz
 cp -r package/examples/minimal-home/. . && rm -rf package condorinst-mobile-bridge-*.tgz
 npm install
 ```
 
-In a project you already have: `npm install @condorinst/mobile-bridge@^0.23.0`
+In a project you already have: `npm install @condorinst/mobile-bridge@^0.23.1`
 (the caret gives you patches only while the package is below 1.0.0) and copy
 `build.mjs` from `node_modules/@condorinst/mobile-bridge/examples/minimal-home/`.
 

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.23.1] — 2026-10-21
+
+### Fixed (docs, harness)
+
+- A live session is short. 0.23.0 said that with `realTime` on the session
+  stays open until `realTime` goes off. On a real device (an ActLumus Plus on
+  an Android tablet, twice) it ended about 3 minutes after it started, with
+  `realTime` still on: the app does not end it, the link or the device does.
+  The docs now say to design live readings as a few minutes per sync.
+- Harness: with `realTime` on, a simulated session ends 3 minutes after it
+  started (`Scenario.realTimeSessionMs`), or when `realTime` goes off.
+
 ## [0.23.0] — 2026-10-21
 
 For Canvas apps with `nativeVersion` **0.18.0**, which fix the silent

package/README.md

@@ -17,8 +17,8 @@ network, every document is plain text at a pinned, unauthenticated URL;
 `llms.txt` is the index and `llms-full.txt` has every document in one file:
 
 ```
-https://cdn.jsdelivr.net/npm/@condorinst/mobile-bridge@0.23.0/llms.txt
-https://cdn.jsdelivr.net/npm/@condorinst/mobile-bridge@0.23.0/llms-full.txt
+https://cdn.jsdelivr.net/npm/@condorinst/mobile-bridge@0.23.1/llms.txt
+https://cdn.jsdelivr.net/npm/@condorinst/mobile-bridge@0.23.1/llms-full.txt
 ```
 
 The machine-readable contract — keys, commands, limits, capability matrix — is
@@ -32,7 +32,7 @@ The machine-readable contract — keys, commands, limits, capability matrix —
 ## Installation
 
 ```bash
-npm install @condorinst/mobile-bridge@^0.23.0
+npm install @condorinst/mobile-bridge@^0.23.1
 ```
 
 The package ships a prebuilt `dist/` (ESM + CJS + type declarations); no build
@@ -52,7 +52,7 @@ toolchain of ours is needed on your side.
 - **PATCH** (`0.23.x`): bugfix with no API change.
 - **MINOR** (`0.x.0`): new observable key, new command, backward-compatible API.
   > While on `0.x`, a minor bump may carry breaking changes (semver treats
-  > pre-1.0 minors as breaking). Pin `^0.23.0` to stay on safe patches.
+  > pre-1.0 minors as breaking). Pin `^0.23.1` to stay on safe patches.
 - **MAJOR** (`x.0.0`): incompatible schema change (key rename, payload shape
   change, public API change). `1.0.0` marks the production-stable contract.
 

package/contract/bridge-contract.json

@@ -1,12 +1,12 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "contractVersion": "0.23.0",
+  "contractVersion": "0.23.1",
   "description": "Machine-readable contract of the Condor Canvas JS<->Native bridge. It states what the TypeScript declarations in dist/index.d.ts cannot express: which keys and commands a sandboxed client can actually reach, which ones need human confirmation, where messages are dropped in silence, the hard limits, and which capability each native version carries. The TypeScript types remain canonical for payload shapes.",
   "audience": "Developers and AI agents building the client bundle that renders inside the Canvas Home.",
 
   "versions": {
     "note": "Four independent numbers coexist. Only nativeVersion tells you what the device can do.",
-    "package": "0.23.0",
+    "package": "0.23.1",
     "shellVersion": "0.6.0",
     "clientProtocolVersion": "0.5.0",
     "nativeVersion": "0.18.0",
@@ -101,7 +101,7 @@
     "entries": {
       "ping": { "args": {}, "requiresConfirmation": false, "repliesOn": "pingPong", "note": "Handled by the app's background service: lost without a reply if sent before the service is up. BridgeClient.waitForService() resends it until a pingPong arrives." },
       "userDevice": { "args": { "getFromServer": "boolean, default false. false: memory or cache while fresh, else the server (use at boot). true: the server first, cache on failure (use for a refresh button)." }, "requiresConfirmation": false, "repliesOn": "userDevice", "prefer": "BridgeClient.requestUserDevices({ getFromServer }), which resends with backoff and resolves { status: 'timeout', hasDevices } instead of waiting forever.", "note": "From nativeVersion 0.18.0 the app re-sends a request lost while its background service starts, and answers a failed lookup with empty arrays and `error` (NO_DEVICES | NETWORK | SESSION | UNKNOWN). Below 0.18.0 a request sent before the service is up is lost, and a failed lookup gets no reply." },
-      "realTime": { "args": { "serialNo": "int", "deviceId": "int, optional, minNativeVersion 0.17.0", "value": "boolean" }, "requiresConfirmation": false, "repliesOn": "realTime", "note": "Off by default. The deviceLightSensors stream only flows while this is on and the device is in a BLE session; while it is on, the app keeps the session open after the sync (it ends when realTime goes off or the link drops); the stream stops when the session ends and resumes at the next one. The app switches it off for every device when it restarts. The ack means the wish is recorded; it does not require a connected device. Always send serialNo; add deviceId to address one device when two share a serialNo." },
+      "realTime": { "args": { "serialNo": "int", "deviceId": "int, optional, minNativeVersion 0.17.0", "value": "boolean" }, "requiresConfirmation": false, "repliesOn": "realTime", "note": "Off by default. The deviceLightSensors stream only flows while this is on and the device is in a BLE session; while it is on, the app does not end the session after the sync, but on a real device the session still ended about 3 minutes after it started (the link or the device ends it); switching it off ends the session; the stream stops when the session ends and resumes at the next one. The app switches it off for every device when it restarts. The ack means the wish is recorded; it does not require a connected device. Always send serialNo; add deviceId to address one device when two share a serialNo." },
       "deviceConnection": { "args": { "type": "'add' | 'remove'", "serialNo": "int", "deviceId": "int, optional, minNativeVersion 0.17.0" }, "requiresConfirmation": false, "repliesOn": "deviceConnection", "note": "Pairs nothing. 'add' subscribes to the BLE connection state of a device from the userDevice list; the state arrives on the deviceConnection key on every CHANGE only — the current state is not replayed (except isConnect false at once for a device the app does not know). Start every device as 'unknown'. An ActLumus is between sessions most of the time (bleConnectionPeriod, minutes). 'remove' stops it." },
       "sensorLog": { "args": { "requestId": "string", "serialNo": "int", "bodyPart": "'wrist' | 'necklace', optional", "limit": "1..1000, optional", "startingAfter": "opaque cursor, optional", "endingBefore": "opaque cursor, optional", "startTime": "timestamp, optional, minNativeVersion 0.15.0", "endTime": "timestamp, optional, minNativeVersion 0.15.0" }, "requiresConfirmation": false, "repliesOn": "sensorLog", "prefer": "BridgeClient.fetchSensorLog(query), which correlates requestId and applies a timeout for you.", "paging": { "orderWithinPage": "chronological ascending", "noCursorNoRange": "the most recent `limit` logs; older pages with endingBefore while hasPrevious", "withStartTime": "the oldest logs of the range first; newer pages with startingAfter while hasMore", "onlyEndTime": "the most recent logs before endTime", "defaultLimit": 10, "maxLimit": 1000, "logPeriod": "one log per period, programmable per device, default 60 s; derive it from consecutive log_time values" } },
       "openSettings": { "args": {}, "requiresConfirmation": false, "repliesOn": null },

package/dist/cli.cjs

@@ -6,7 +6,7 @@ var import_node_fs4 = require("fs");
 var import_node_path4 = require("path");
 
 // package.json
-var version = "0.23.0";
+var version = "0.23.1";
 
 // src/canvas-admin/command.ts
 var import_node_crypto2 = require("crypto");