@esp-vision/device-core 0.5.0 → 0.5.1

package/CHANGELOG.md

@@ -1,6 +1,12 @@
 # Changelog
 
-## [Unreleased]
+## 0.5.1
+
+### Fixed
+
+- Make packaged execution-deadline regressions deterministic with a controlled clock, including expiry before VM entry, and keep installation guidance independent of temporary publication state.
+
+## 0.5.0
 
 ### Changed
 

package/README.md

@@ -19,10 +19,10 @@
 | Visibility | Public; installation needs no npm login |
 | Source location | `host/device-core` in the ESP-VISION firmware repository |
 
-The latest public npm release is **0.4.2**. This source prepares **0.5.0 (not yet published)**: Core becomes an SDK-only package, the management CLI moves to `@esp-vision/device-cli`, and Python execution/file reads have no aggregate deadline unless configured. Pin the exact package version and verify it exists in the public registry before installing. Until publication, use a tarball packed from an exact reviewed source commit. CI authenticates with the protected `NPM_PUBLISH_TOKEN` and verifies that `npm whoami` returns `esp-vision` before publishing. Tokens are not part of this package or its documentation.
+The **0.5.x** package line is SDK-only: the management CLI lives in `@esp-vision/device-cli`, and Python execution/file reads have no aggregate deadline unless configured. Pin the exact package version and verify it exists in the public registry before installing. For unpublished source changes, use a tarball packed from an exact reviewed source commit. CI authenticates with the protected `NPM_PUBLISH_TOKEN` and verifies that `npm whoami` returns `esp-vision` before publishing. Tokens are not part of this package or its documentation.
 
 ```sh
-npm install --save-exact @esp-vision/device-core@0.5.0 --registry=https://registry.npmjs.org/
+npm install --save-exact @esp-vision/device-core@0.5.1 --registry=https://registry.npmjs.org/
 ```
 
 EV-MUX v4 firmware is required. A v3 hello is rejected with `VERSION_MISMATCH`; applications should ask the user to update firmware. Core has no runtime dependency on the IDE, Agent, DOM or Node serial libraries. The host supplies the physical byte transport and discovery adapter; Core owns protocol parsing, session negotiation, REPL coordination and device operations.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esp-vision/device-core",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Shared EV-MUX, framed REPL, device session, and action contracts for ESP Vision clients.",
   "type": "module",
   "exports": {

package/schemas/device-actions-v1.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "ESP Vision Device Actions",
-  "deviceCoreVersion": "0.5.0",
+  "deviceCoreVersion": "0.5.1",
   "schemaVersion": 1,
   "actions": [
     {

package/tests/test-device-execution.mjs

@@ -341,18 +341,45 @@ test('failed stop does not claim execution has finished', async () => {
   fixture.session.close()
 })
 
-test('bounded Agent execution still times out and sends a shared interrupt', async () => {
+test('bounded Agent execution still times out and sends a shared interrupt', async (t) => {
+  t.mock.timers.enable({ apis: ['setTimeout'] })
   const fixture = executionFixture()
+  t.after(() => fixture.session.close())
+  // Isolate the running-script deadline from the separately covered upload
+  // and REPL setup. A real 30 ms startup budget races CI scheduling.
+  fixture.session.stopForRepl = async () => true
+  fixture.session.writeScript = async () => {}
   let started
   const starting = new Promise(resolve => { started = resolve })
   const done = fixture.session.runScript('/trial.py', 'while True: pass', { timeout: 30, onStarted: started })
   const rejected = assert.rejects(done, (error) => error.code === 'SCRIPT_TIMEOUT')
   await starting
+  t.mock.timers.tick(30)
   await rejected
   assert.equal(fixture.session.scriptRunSnapshot(), null)
-  await new Promise(resolve => setTimeout(resolve, 0))
+  await new Promise(resolve => setImmediate(resolve))
   assert.ok(fixture.requests.some(({ metadata, payload }) => metadata.method === 'device.control' && payload.action === 'stop'))
-  fixture.session.close()
+})
+
+test('bounded start handles reject when the deadline precedes VM entry', async (t) => {
+  t.mock.timers.enable({ apis: ['setTimeout'] })
+  const fixture = executionFixture({ deferStart: true })
+  t.after(() => fixture.session.close())
+  fixture.session.stopForRepl = async () => true
+  fixture.session.writeScript = async () => {}
+  let started = false
+  const starting = fixture.session.startScript('/trial.py', undefined, {
+    inlineCompletion: true,
+    timeout: 30,
+    onStarted() { started = true },
+  })
+  const rejected = assert.rejects(starting, { code: 'SCRIPT_TIMEOUT' })
+  await new Promise(resolve => setImmediate(resolve))
+  t.mock.timers.tick(30)
+  await rejected
+  assert.equal(started, false)
+  assert.equal(fixture.session.scriptRunSnapshot(), null)
+  assert.equal(fixture.session.runStarting, false)
 })
 
 test('VM reset and disconnect settle interactive completion and allow the next VM run', async () => {