@fleetless/contracts 5.1.0 → 5.2.0

package/CHANGELOG.md

@@ -9,6 +9,21 @@ version.
 
 ## [Unreleased]
 
+## [5.2.0] — 2026-09-30
+
+### Added
+
+- **A cancel can be limited to the bridge's own job.** `cancel`
+  (`cloudCancel`) gains an optional `own_only: boolean`; absent means
+  `false`, today's meaning. With `true` the bridge cancels the named job
+  only if it started it itself: a `job_id` it does not hold — typically an
+  `unknown` job — cancels nothing, where without the flag it cancels every
+  external goal on the action. The cloud sets it on the cancels it sends on
+  its own (a republish's reset and its resend at the next hello), so a
+  republish never stops a goal Fleetless did not start; a user's cancel
+  never sets it. `LATEST_BRIDGE_VERSION` is `6.1.0`, the first bridge that
+  honours it. The protocol stays 5.
+
 ## [5.1.0] — 2026-09-30
 
 ### Added

package/artifacts/constants.json

@@ -9,7 +9,7 @@
     }
   ],
   "PROTOCOL_SUNSET_DAYS": 90,
-  "LATEST_BRIDGE_VERSION": "6.0.0",
+  "LATEST_BRIDGE_VERSION": "6.1.0",
   "CLOSE_ROBOT_DELETED": 4004,
   "CLOSE_TOKEN_ROTATED": 4005,
   "JOB_HEARTBEAT_INTERVAL_MS": 1000,

package/artifacts/schema/cloud-cancel.schema.json

@@ -28,6 +28,9 @@
           "type": "null"
         }
       ]
+    },
+    "own_only": {
+      "type": "boolean"
     }
   },
   "required": [

package/dist/protocol.d.ts

@@ -78,7 +78,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 = "6.0.0";
+export declare const LATEST_BRIDGE_VERSION = "6.1.0";
 export interface ProtocolStatus {
     status: 'current' | 'deprecated' | 'unsupported';
     /** ISO date, or null for a current or unknown version. */
@@ -642,12 +642,24 @@ export type CloudInvoke = z.infer<typeof cloudInvoke>;
  * `request_id` correlates the bridge's `cancel_result`, which carries each
  * goal's `CancelGoal` return code; the cloud answers its caller only from
  * that.
+ *
+ * `own_only` (fleetless#84) limits a cancel to a job the bridge started
+ * itself and holds. `true`: the bridge cancels the named job only if it is
+ * its own; a `job_id` it does not hold, or holds as an external goal,
+ * cancels **nothing** and is answered `goals: []`. The cloud sets it on the
+ * cancels it sends on its own — a republish's reset and that reset's resend
+ * at the next hello — so a republish never stops a goal Fleetless did not
+ * start. A user's cancel never sets it: only an explicit cancel may reach
+ * external goals. Absent means `false`, today's meaning. `true` needs a
+ * `job_id`: the bridge refuses `own_only: true` with `job_id: null` as
+ * unusable. Bridges before 6.1.0 ignore the key.
  */
 export declare const cloudCancel: z.ZodObject<{
     type: z.ZodLiteral<"cancel">;
     request_id: z.ZodString;
     slug: z.ZodString;
     job_id: z.ZodNullable<z.ZodUUID>;
+    own_only: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type CloudCancel = z.infer<typeof cloudCancel>;
 /**

package/dist/protocol.js

@@ -79,7 +79,7 @@ export const PROTOCOL_VERSIONS = [
     { version: 5, bridge_from: '6.0.0', deprecated_at: null },
 ];
 /** The newest bridge package. The cloud mails organisations still below it. */
-export const LATEST_BRIDGE_VERSION = '6.0.0';
+export const LATEST_BRIDGE_VERSION = '6.1.0';
 const DAY_MS = 24 * 60 * 60 * 1000;
 function isoDate(date) {
     return date.toISOString().slice(0, 10);
@@ -481,12 +481,24 @@ export const cloudInvoke = z.object({
  * `request_id` correlates the bridge's `cancel_result`, which carries each
  * goal's `CancelGoal` return code; the cloud answers its caller only from
  * that.
+ *
+ * `own_only` (fleetless#84) limits a cancel to a job the bridge started
+ * itself and holds. `true`: the bridge cancels the named job only if it is
+ * its own; a `job_id` it does not hold, or holds as an external goal,
+ * cancels **nothing** and is answered `goals: []`. The cloud sets it on the
+ * cancels it sends on its own — a republish's reset and that reset's resend
+ * at the next hello — so a republish never stops a goal Fleetless did not
+ * start. A user's cancel never sets it: only an explicit cancel may reach
+ * external goals. Absent means `false`, today's meaning. `true` needs a
+ * `job_id`: the bridge refuses `own_only: true` with `job_id: null` as
+ * unusable. Bridges before 6.1.0 ignore the key.
  */
 export const cloudCancel = z.object({
     type: z.literal('cancel'),
     request_id: z.string().min(1).max(64),
     slug,
     job_id: z.uuid().nullable(),
+    own_only: z.boolean().optional(),
 });
 /**
  * The ROS 2 `action_msgs/srv/CancelGoal` return codes: `0` `ERROR_NONE` (the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fleetless/contracts",
-  "version": "5.1.0",
+  "version": "5.2.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",