@fleetless/contracts 4.0.0-next.1 → 4.0.0

package/CHANGELOG.md

@@ -9,15 +9,17 @@ version.
 
 ## [Unreleased]
 
+## [4.0.0] — 2026-09-29
+
 ### Added
 
 - **Protocol 4: a job heartbeat, and a vanished action server ends its job.**
-  Protocol bumped: bridges from `4.1.0`, and protocol 3 sunsets
-  2026-12-27 (protocol 2 sunset 2026-12-21). The bridge now sends a
+  Protocol bumped: bridges from `5.0.0`, and protocol 3 sunsets
+  2026-12-28 (protocol 2 sunset 2026-12-21). The bridge now sends a
   `job_update` heartbeat every `JOB_HEARTBEAT_INTERVAL_MS` for every running
-  job; `job_lost` gains an optional `error`, so a bridge that finds its
-  action server gone can say `action_server_lost` instead of leaving the
-  cloud to guess. `JOB_HEARTBEAT_TIMEOUT_MS` bounds a protocol-4 job's
+  job, and ends a job whose action server vanished `lost` with
+  `action_server_lost` instead of leaving the cloud to guess; `job_lost`
+  gains an optional `error` that can say the same. `JOB_HEARTBEAT_TIMEOUT_MS` bounds a protocol-4 job's
   silence once it has been heard from at all; `patience_ms` now bounds only
   the acceptance gap on such a job (unchanged for protocol 3, which sends no
   heartbeat). `JOB_OFFLINE_GRACE_MS` (five minutes) replaces the informal

package/artifacts/constants.json

@@ -10,16 +10,16 @@
     {
       "version": 3,
       "bridge_from": "4.0.0",
-      "deprecated_at": "2026-09-28"
+      "deprecated_at": "2026-09-29"
     },
     {
       "version": 4,
-      "bridge_from": "4.1.0",
+      "bridge_from": "5.0.0",
       "deprecated_at": null
     }
   ],
   "PROTOCOL_SUNSET_DAYS": 90,
-  "LATEST_BRIDGE_VERSION": "4.1.0",
+  "LATEST_BRIDGE_VERSION": "5.0.0",
   "CLOSE_ROBOT_DELETED": 4004,
   "CLOSE_TOKEN_ROTATED": 4005,
   "JOB_HEARTBEAT_INTERVAL_MS": 1000,

package/dist/errors.js

@@ -163,7 +163,7 @@ export const ERROR_CODES = [
     'goal_send_failed',
     /** Asking the action server for its result raised; `job.error.code` on `failed`. */
     'result_failed',
-    /** A goal accepted after its own timeout could not then be cancelled; `job.error.code` on `failed`. */
+    /** A goal accepted after its own timeout could not then be cancelled; `job.error.code` on `lost`. */
     'goal_uncontrollable',
     /**
      * The robot stayed offline for longer than `JOB_OFFLINE_GRACE_MS` while a

package/dist/protocol.d.ts

@@ -11,10 +11,11 @@ import { z } from 'zod';
  * which names the window and reaches the robot's detail view as
  * `last_hello_error`.
  *
- * **4 (2026-09-28):** the bridge sends a `job_update` heartbeat at
+ * **4 (2026-09-29):** the bridge sends a `job_update` heartbeat at
  * `JOB_HEARTBEAT_INTERVAL_MS` for every running job, whether or not the
- * action said anything new, and reports a vanished action server with
- * `job_lost`'s new optional `error`, `action_server_lost`. The cloud bounds
+ * action said anything new, and ends a job whose action server vanished
+ * `lost` with `action_server_lost` (a terminal `job_update`; `job_lost`
+ * gains an optional `error` for the same purpose). The cloud bounds
  * a protocol-4 job's silence by the heartbeat (`JOB_HEARTBEAT_TIMEOUT_MS`)
  * once it has heard from the job at all; `patience_ms` still bounds
  * acceptance, the same as before. Offline tolerance is
@@ -56,7 +57,7 @@ export interface ProtocolVersionEntry {
  */
 export declare const PROTOCOL_VERSIONS: readonly ProtocolVersionEntry[];
 /** The newest bridge package. The cloud mails organisations still below it. */
-export declare const LATEST_BRIDGE_VERSION = "4.1.0";
+export declare const LATEST_BRIDGE_VERSION = "5.0.0";
 export interface ProtocolStatus {
     status: 'current' | 'deprecated' | 'unsupported';
     /** ISO date, or null for a current or unknown version. */

package/dist/protocol.js

@@ -17,10 +17,11 @@ import { rosTypeName } from './common.js';
  * which names the window and reaches the robot's detail view as
  * `last_hello_error`.
  *
- * **4 (2026-09-28):** the bridge sends a `job_update` heartbeat at
+ * **4 (2026-09-29):** the bridge sends a `job_update` heartbeat at
  * `JOB_HEARTBEAT_INTERVAL_MS` for every running job, whether or not the
- * action said anything new, and reports a vanished action server with
- * `job_lost`'s new optional `error`, `action_server_lost`. The cloud bounds
+ * action said anything new, and ends a job whose action server vanished
+ * `lost` with `action_server_lost` (a terminal `job_update`; `job_lost`
+ * gains an optional `error` for the same purpose). The cloud bounds
  * a protocol-4 job's silence by the heartbeat (`JOB_HEARTBEAT_TIMEOUT_MS`)
  * once it has heard from the job at all; `patience_ms` still bounds
  * acceptance, the same as before. Offline tolerance is
@@ -55,11 +56,11 @@ export const PROTOCOL_SUNSET_DAYS = 90;
  */
 export const PROTOCOL_VERSIONS = [
     { version: 2, bridge_from: '3.0.0', deprecated_at: '2026-09-22' },
-    { version: 3, bridge_from: '4.0.0', deprecated_at: '2026-09-28' },
-    { version: 4, bridge_from: '4.1.0', deprecated_at: null },
+    { version: 3, bridge_from: '4.0.0', deprecated_at: '2026-09-29' },
+    { version: 4, bridge_from: '5.0.0', deprecated_at: null },
 ];
 /** The newest bridge package. The cloud mails organisations still below it. */
-export const LATEST_BRIDGE_VERSION = '4.1.0';
+export const LATEST_BRIDGE_VERSION = '5.0.0';
 const DAY_MS = 24 * 60 * 60 * 1000;
 function isoDate(date) {
     return date.toISOString().slice(0, 10);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fleetless/contracts",
-  "version": "4.0.0-next.1",
+  "version": "4.0.0",
   "description": "Fleetless wire contracts: the bridge-cloud protocol, the REST API schemas and the error codes, as zod schemas with generated JSON Schema and OpenAPI artifacts.",
   "license": "Apache-2.0",
   "author": "Dehne Robotik GmbH",