@fleetless/contracts 5.0.0-next.2 → 5.0.0

package/CHANGELOG.md

@@ -9,6 +9,8 @@ version.
 
 ## [Unreleased]
 
+## [5.0.0] — 2026-09-30
+
 ### Added
 
 - **Protocol 5: `unknown` jobs, external goals, and a hard cut of protocols 3
@@ -40,6 +42,9 @@ version.
   caller is refused, not told the cancel succeeded. `reportedJobState`, every
   state but `unknown`, is what `job_update`, `job_status` entries and
   `hello.active_jobs` accept, so a bridge claiming `unknown` fails validation.
+  `POST /api/robots/:id/jobs/:slug/cancel` lists the answers this adds:
+  `409 cancel_rejected`, `504 bridge_timeout`, and `502` with the bridge's
+  own code (`unknown_slug`, `action_server_lost`, `internal_error`).
 
 ### Removed
 

package/artifacts/openapi.json

@@ -7003,7 +7003,7 @@
             }
           },
           "default": {
-            "description": "An error envelope. Codes this route is known to answer: `unauthorized`, `token_expired`, `token_revoked`, `forbidden`, `invalid_uuid`, `not_found`, `validation_error`, `not_cancellable`, `robot_offline`.",
+            "description": "An error envelope. Codes this route is known to answer: `unauthorized`, `token_expired`, `token_revoked`, `forbidden`, `invalid_uuid`, `not_found`, `validation_error`, `not_cancellable`, `robot_offline`, `cancel_rejected`, `bridge_timeout`, `unknown_slug`, `action_server_lost`, `internal_error`.",
             "content": {
               "application/json": {
                 "schema": {
@@ -7013,7 +7013,7 @@
             }
           }
         },
-        "description": "The body is optional: a bodyless `POST` was every caller's shape before `job_id` existed, and absent or `job_id: null` both mean \"cancel whatever is running\". A named `job_id` that is **not** what is running cancels nothing and answers `404` — the caller named an id and thereby ruled the other one out. An `external` job is cancelled the same way, through its goal id. Cancelling an `unknown` job also cancels every external goal on its action, since one of them may be that job. A service is `422 not_cancellable`: a service call has no goal to cancel. Nothing running is a `200` with `job: null`.",
+        "description": "The body is optional: a bodyless `POST` was every caller's shape before `job_id` existed, and absent or `job_id: null` both mean \"cancel whatever is running\". A named `job_id` that is **not** what is running cancels nothing and answers `404` — the caller named an id and thereby ruled the other one out. An `external` job is cancelled the same way, through its goal id. Cancelling an `unknown` job also cancels every external goal on its action, since one of them may be that job. A service is `422 not_cancellable`: a service call has no goal to cancel. Nothing running is a `200` with `job: null`. The answer waits for the bridge's `cancel_result`: a `200` means the action server accepted the cancel request, not that the goal has ended — the job's end arrives as its own update. Any goal answered `ERROR_REJECTED` makes it `409 cancel_rejected`, with every goal and its `return_code` in `details.goals`; no answer within `JOB_HEARTBEAT_TIMEOUT_MS` is `504 bridge_timeout`; a cancel the bridge could not send at all is `502` carrying the bridge's own code (`unknown_slug`, `action_server_lost`, `internal_error`).",
         "requestBody": {
           "required": false,
           "content": {

package/artifacts/routes.json

@@ -4147,10 +4147,15 @@
         "not_found",
         "validation_error",
         "not_cancellable",
-        "robot_offline"
+        "robot_offline",
+        "cancel_rejected",
+        "bridge_timeout",
+        "unknown_slug",
+        "action_server_lost",
+        "internal_error"
       ],
       "transport": "http",
-      "notes": "The body is optional: a bodyless `POST` was every caller's shape before `job_id` existed, and absent or `job_id: null` both mean \"cancel whatever is running\". A named `job_id` that is **not** what is running cancels nothing and answers `404` — the caller named an id and thereby ruled the other one out. An `external` job is cancelled the same way, through its goal id. Cancelling an `unknown` job also cancels every external goal on its action, since one of them may be that job. A service is `422 not_cancellable`: a service call has no goal to cancel. Nothing running is a `200` with `job: null`."
+      "notes": "The body is optional: a bodyless `POST` was every caller's shape before `job_id` existed, and absent or `job_id: null` both mean \"cancel whatever is running\". A named `job_id` that is **not** what is running cancels nothing and answers `404` — the caller named an id and thereby ruled the other one out. An `external` job is cancelled the same way, through its goal id. Cancelling an `unknown` job also cancels every external goal on its action, since one of them may be that job. A service is `422 not_cancellable`: a service call has no goal to cancel. Nothing running is a `200` with `job: null`. The answer waits for the bridge's `cancel_result`: a `200` means the action server accepted the cancel request, not that the goal has ended — the job's end arrives as its own update. Any goal answered `ERROR_REJECTED` makes it `409 cancel_rejected`, with every goal and its `return_code` in `details.goals`; no answer within `JOB_HEARTBEAT_TIMEOUT_MS` is `504 bridge_timeout`; a cancel the bridge could not send at all is `502` carrying the bridge's own code (`unknown_slug`, `action_server_lost`, `internal_error`)."
     },
     {
       "method": "POST",

package/dist/routes.js

@@ -2112,12 +2112,19 @@ export const ROUTES = [
             { name: 'slug', description: 'The action slug from the published configuration; a service slug is refused.' },
         ],
         query: null, request: cancelRequest, requestOptional: true, response: jobResponse,
-        errors: [...CLIENT_GUARD, 'invalid_uuid', 'not_found', 'validation_error', 'not_cancellable', 'robot_offline'], transport: 'http',
+        errors: [
+            ...CLIENT_GUARD, 'invalid_uuid', 'not_found', 'validation_error', 'not_cancellable', 'robot_offline',
+            'cancel_rejected', 'bridge_timeout', 'unknown_slug', 'action_server_lost', 'internal_error',
+        ], transport: 'http',
         notes: 'The body is optional: a bodyless `POST` was every caller\'s shape before `job_id` existed, and absent or `job_id: null` both mean ' +
             '"cancel whatever is running". A named `job_id` that is **not** what is running cancels nothing and answers `404` — the caller named an ' +
             'id and thereby ruled the other one out. An `external` job is cancelled the same way, through its goal id. Cancelling an `unknown` job ' +
             'also cancels every external goal on its action, since one of them may be that job. A service is `422 not_cancellable`: a service call ' +
-            'has no goal to cancel. Nothing running is a `200` with `job: null`.',
+            'has no goal to cancel. Nothing running is a `200` with `job: null`. The answer waits for the bridge\'s `cancel_result`: a `200` means ' +
+            'the action server accepted the cancel request, not that the goal has ended — the job\'s end arrives as its own update. Any goal ' +
+            'answered `ERROR_REJECTED` makes it `409 cancel_rejected`, with every goal and its `return_code` in `details.goals`; no answer within ' +
+            '`JOB_HEARTBEAT_TIMEOUT_MS` is `504 bridge_timeout`; a cancel the bridge could not send at all is `502` carrying the bridge\'s own ' +
+            'code (`unknown_slug`, `action_server_lost`, `internal_error`).',
     },
     {
         method: 'POST', path: '/api/robots/:id/publishers/:slug', section: 'commands',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fleetless/contracts",
-  "version": "5.0.0-next.2",
+  "version": "5.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",