@fleetless/sdk 4.0.0 → 4.2.0-next.1

package/dist/index.d.cts

@@ -63,6 +63,23 @@ declare const mcpRobotDatasheet: z.ZodObject<{
 }, z.core.$strip>;
 type McpRobotDatasheet = z.infer<typeof mcpRobotDatasheet>;
 
+/**
+ * The ROS 2 `action_msgs/srv/CancelGoal` return codes: `0` `ERROR_NONE` (the
+ * server accepted the cancel request), `1` `ERROR_REJECTED` (it refused),
+ * `2` `ERROR_UNKNOWN_GOAL_ID`, `3` `ERROR_GOAL_TERMINATED` (the goal had
+ * already ended). An accepted request is not an ended goal: whether the goal
+ * ends, and how, is what the action's status reports afterwards, and reaches
+ * the cloud as the goal's `job_update`.
+ */
+declare const CANCEL_RETURN_CODES: {
+    readonly none: 0;
+    readonly rejected: 1;
+    readonly unknown_goal_id: 2;
+    readonly goal_terminated: 3;
+};
+declare const cancelReturnCode: z.ZodNumber;
+type CancelReturnCode$1 = z.infer<typeof cancelReturnCode>;
+
 
 /**
  * Jobs: one running unit of work on a robot — an action
@@ -74,14 +91,20 @@ type McpRobotDatasheet = z.infer<typeof mcpRobotDatasheet>;
  * 1. **State is observed by slug, not by id.** The id is informative; a client
  *    watches `robot × slug` and sees whatever job is running there, which is
  *    also why every observer of a slug sees the same job.
- * 2. **`lost` is a real outcome and must be said out loud.** Job state
- *    lives only in the bridge's memory; if it restarts mid-job, the results
- *    are gone. The cloud then marks the job `lost` — never leaves it reading
- *    "running" because nobody contradicted it. A system that reports a
- *    machine is still working when it does not know is worse than one that
- *    admits it lost track.
+ * 2. **What the cloud does not know it calls `unknown`, and `lost` is final.**
+ *    A job whose robot went quiet — offline past `JOB_OFFLINE_GRACE_MS`, or
+ *    connected but silent past `JOB_HEARTBEAT_TIMEOUT_MS` — is `unknown`: not
+ *    terminal, the slug stays occupied, and only a statement of the bridge
+ *    resolves it (it is running, it ended, or the bridge does not know it and
+ *    nothing else runs on its action). `lost` is what that last statement
+ *    produces, and nothing ever leaves it. Neither is left reading "running"
+ *    because nobody contradicted it: a system that reports a machine is still
+ *    working when it does not know is worse than one that says so — and one
+ *    that declares work lost on a guess is wrong the moment the robot comes
+ *    back and says it finished.
  */
 declare const jobState: z.ZodEnum<{
+    unknown: "unknown";
     failed: "failed";
     running: "running";
     succeeded: "succeeded";
@@ -89,17 +112,42 @@ declare const jobState: z.ZodEnum<{
     lost: "lost";
 }>;
 type JobState = z.infer<typeof jobState>;
+/**
+ * Who started a job.
+ *
+ * `fleetless` for every job the cloud minted from an invocation. `external`
+ * for a goal the bridge found active on a published action without having
+ * sent it — started by anyone else on the robot's ROS graph, or the bridge's
+ * own goal after its mapping was lost. An external job has the same shape,
+ * states, live stream and cancel as any other, but no parameters (ROS 2
+ * publishes a goal's request nowhere), no starter, and it lives in memory
+ * only: it is never written to `job_runs` and never counts towards quotas.
+ */
+declare const jobOrigin: z.ZodEnum<{
+    fleetless: "fleetless";
+    external: "external";
+}>;
+type JobOrigin$1 = z.infer<typeof jobOrigin>;
+/**
+ * One job, as the cloud tells every client about it — a Fleetless job or an
+ * external goal alike, told apart only by `origin`.
+ */
 declare const job: z.ZodObject<{
     id: z.ZodUUID;
     robot_id: z.ZodUUID;
     slug: z.ZodString;
     state: z.ZodEnum<{
+        unknown: "unknown";
         failed: "failed";
         running: "running";
         succeeded: "succeeded";
         cancelled: "cancelled";
         lost: "lost";
     }>;
+    origin: z.ZodEnum<{
+        fleetless: "fleetless";
+        external: "external";
+    }>;
     started_at: z.ZodISODateTime;
     updated_at: z.ZodISODateTime;
     seq: z.ZodNumber;
@@ -129,12 +177,17 @@ declare const jobEvent: z.ZodObject<{
         robot_id: z.ZodUUID;
         slug: z.ZodString;
         state: z.ZodEnum<{
+            unknown: "unknown";
             failed: "failed";
             running: "running";
             succeeded: "succeeded";
             cancelled: "cancelled";
             lost: "lost";
         }>;
+        origin: z.ZodEnum<{
+            fleetless: "fleetless";
+            external: "external";
+        }>;
         started_at: z.ZodISODateTime;
         updated_at: z.ZodISODateTime;
         seq: z.ZodNumber;
@@ -153,6 +206,11 @@ type JobEvent = z.infer<typeof jobEvent>;
 /**
  * What a busy refusal tells the caller: what is already running. A refusal that
  * only says "busy" forces the caller to guess whether to wait or to give up.
+ *
+ * `running` is whatever occupies the slug — a `running` job, an `unknown` one
+ * the robot has not accounted for yet, or an `external` goal someone else
+ * started — and its `state` and `origin` say which, so a caller can tell
+ * "wait for it" from "cancel what someone else started".
  */
 declare const busyDetails: z.ZodObject<{
     running: z.ZodObject<{
@@ -160,12 +218,17 @@ declare const busyDetails: z.ZodObject<{
         robot_id: z.ZodUUID;
         slug: z.ZodString;
         state: z.ZodEnum<{
+            unknown: "unknown";
             failed: "failed";
             running: "running";
             succeeded: "succeeded";
             cancelled: "cancelled";
             lost: "lost";
         }>;
+        origin: z.ZodEnum<{
+            fleetless: "fleetless";
+            external: "external";
+        }>;
         started_at: z.ZodISODateTime;
         updated_at: z.ZodISODateTime;
         seq: z.ZodNumber;
@@ -194,6 +257,7 @@ declare const jobRun: z.ZodObject<{
         service: "service";
     }>;
     state: z.ZodEnum<{
+        unknown: "unknown";
         failed: "failed";
         running: "running";
         succeeded: "succeeded";
@@ -234,6 +298,7 @@ declare const jobRunListResponse: z.ZodObject<{
             service: "service";
         }>;
         state: z.ZodEnum<{
+            unknown: "unknown";
             failed: "failed";
             running: "running";
             succeeded: "succeeded";
@@ -761,12 +826,31 @@ declare const parameterInvalidDetails: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 type ParameterInvalidDetails = z.infer<typeof parameterInvalidDetails>;
+/**
+ * The `details` of a `cancel_rejected` refusal: every goal the cancel reached,
+ * accepted ones included, each with the `CancelGoal` return code its action
+ * server answered — compare `return_code` against `CANCEL_RETURN_CODES`
+ * (`none`, `rejected`, `unknown_goal_id`, `goal_terminated`); it is `null`
+ * when that goal's server did not answer within the bridge's bound. Always at
+ * least one goal: the cloud refuses a cancel only because a goal's server
+ * answered `ERROR_REJECTED`. Pinned here for the reason
+ * `parameterInvalidDetails` is: a caller parses it instead of reading the
+ * shape from prose.
+ */
+declare const cancelRejectedDetails: z.ZodObject<{
+    goals: z.ZodArray<z.ZodObject<{
+        job_id: z.ZodUUID;
+        goal_id: z.ZodString;
+        return_code: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type CancelRejectedDetails = z.infer<typeof cancelRejectedDetails>;
 /**
  * The codes in use today. The wire deliberately allows any string — this
  * list is the shared vocabulary, not a closed set, so a new refusal never
  * needs a contracts release before it can be reported honestly.
  */
-declare const ERROR_CODES: readonly ["not_found", "validation_error", "bad_request", "unknown_datapoint", "invalid_token", "protocol_mismatch", "invalid_frame", "duplicate_slug", "reserved_slug", "unknown_slug", "unknown_field_path", "unknown_type", "unknown_topic", "invalid_rate", "invalid_range", "config_conflict", "no_data", "robot_offline", "bridge_timeout", "unauthorized", "forbidden", "invalid_credentials", "token_expired", "token_revoked", "email_taken", "identifier_taken", "weak_password", "account_blocked", "busy", "parameter_invalid", "job_lost", "publisher_busy", "unknown_command", "not_subscribable", "camera_offline", "no_snapshot_yet", "live_unavailable", "wrong_kind", "not_recorded", "not_aggregatable", "quota_exceeded", "credential_in_use", "goal_timeout", "robot_in_use", "robot_deletion_partial", "job_queue_full", "invalid_uuid", "rate_limited", "tier_required", "token_spent", "service_timeout", "asset_missing", "dynamic_registration_disabled", "client_limit_reached", "idp_unavailable", "mcp_disabled", "tool_not_available", "capability_required", "last_owner", "target_state_conflict", "signup_closed", "draft_not_a_document", "internal_error", "not_cancellable", "unsupported_media_type", "wrong_browser", "invalid_yaml", "unstorable_yaml", "registration_closed", "domain_not_allowed", "email_unverified", "origin_not_allowed", "template_invalid", "provider_disabled", "provider_misconfigured", "invalid_redirect_uri", "interaction_expired"];
+declare const ERROR_CODES: readonly ["not_found", "validation_error", "bad_request", "unknown_datapoint", "invalid_token", "protocol_mismatch", "bridge_too_old", "invalid_frame", "duplicate_slug", "reserved_slug", "unknown_slug", "unknown_field_path", "unknown_type", "unknown_topic", "invalid_rate", "invalid_range", "config_conflict", "no_data", "robot_offline", "bridge_timeout", "unauthorized", "forbidden", "invalid_credentials", "token_expired", "token_revoked", "email_taken", "identifier_taken", "weak_password", "account_blocked", "busy", "parameter_invalid", "cancel_rejected", "job_lost", "job_unknown_to_bridge", "action_server_lost", "action_failed", "goal_rejected", "goal_send_failed", "result_failed", "goal_uncontrollable", "bridge_disconnected", "config_changed", "publisher_busy", "unknown_command", "not_subscribable", "camera_offline", "no_snapshot_yet", "live_unavailable", "wrong_kind", "not_recorded", "not_aggregatable", "quota_exceeded", "credential_in_use", "goal_timeout", "robot_in_use", "robot_deletion_partial", "job_queue_full", "invalid_uuid", "rate_limited", "tier_required", "token_spent", "service_timeout", "asset_missing", "dynamic_registration_disabled", "client_limit_reached", "idp_unavailable", "mcp_disabled", "tool_not_available", "capability_required", "last_owner", "target_state_conflict", "signup_closed", "draft_not_a_document", "internal_error", "not_cancellable", "unsupported_media_type", "wrong_browser", "invalid_yaml", "unstorable_yaml", "registration_closed", "domain_not_allowed", "email_unverified", "origin_not_allowed", "template_invalid", "provider_disabled", "provider_misconfigured", "invalid_redirect_uri", "interaction_expired"];
 type ErrorCode = (typeof ERROR_CODES)[number];
 
 /**
@@ -1019,6 +1103,17 @@ interface JobSubscription {
     unsubscribe(): void;
 }
 
+/**
+ * One goal's answer to a cancel: the ROS 2 `CancelGoal` return code its action
+ * server sent — `0` accepted (`CANCEL_RETURN_CODES.none`), `1` refused
+ * (`rejected`), `2` unknown goal (`unknown_goal_id`), `3` already ended
+ * (`goal_terminated`). The type of `return_code` in `CancelRejectedDetails`,
+ * where it is `null` when that goal's server did not answer. The wire shape is
+ * contracts' `cancelReturnCode`; the alias exists so the reference can
+ * describe it — a JSDoc on an `export type { … } from` statement does not
+ * survive bundling.
+ */
+type CancelReturnCode = CancelReturnCode$1;
 /**
  * Long-running work on a robot, reachable as `client.actions`. An action is
  * a ROS action the developer exposed under a slug: it is invoked, runs as
@@ -1059,6 +1154,27 @@ interface ActionsApi {
      * was nothing there", and "I stopped a job that started after I last
      * looked" are three different outcomes a discarded result cannot tell
      * apart.
+     *
+     * **Resolving means the robot's action server accepted the cancel, not
+     * that the goal ended.** The returned job is usually still `running`; how
+     * it ends arrives as its own update (`subscribe`). The platform answers
+     * from the action server's `CancelGoal` return codes, so a cancel can
+     * also reject with:
+     * - `cancel_rejected` — the server refused (`ERROR_REJECTED`) and the goal
+     *   keeps running unless its job later says otherwise.
+     *   `cancelRejectedDetails.parse(error.details).goals` lists every goal the
+     *   cancel reached as `{ job_id, goal_id, return_code }`; compare
+     *   `return_code` against `CANCEL_RETURN_CODES`: `none` (`0`, accepted),
+     *   `rejected` (`1`), `unknown_goal_id` (`2`), `goal_terminated` (`3`,
+     *   already ended), or `null` when that goal's server did not answer.
+     * - `bridge_timeout` — the robot's bridge did not answer in time; whether
+     *   the cancel reached the server is unknown.
+     * - the bridge's own code when it could not ask at all (e.g.
+     *   `unknown_slug`, `action_server_lost`), `not_cancellable` for a service,
+     *   and `robot_offline`.
+     *
+     * Cancelling an `unknown` job cancels every `external` goal on its action,
+     * never another of the platform's own jobs.
      */
     cancel(robotId: string, slug: string, jobId?: string | null, options?: SendCommandOptions): Promise<Job | null>;
     /**
@@ -2076,6 +2192,18 @@ interface DatapointsApi {
     }): Promise<HistorySamplesResponse>;
 }
 
+/**
+ * Who started a job: `fleetless` for every job the cloud minted from an
+ * invocation, `external` for a goal the bridge found active on a published
+ * action without having sent it. An external job has no parameters and no
+ * starter (ROS 2 publishes neither) and is never in `jobs.history`. The type
+ * of `Job.origin`, which every job carries.
+ *
+ * The wire shape is contracts' `jobOrigin`; the alias exists so the reference
+ * can describe it — a JSDoc on an `export type { … } from` statement does not
+ * survive bundling.
+ */
+type JobOrigin = JobOrigin$1;
 /**
  * The filters `jobs.history` reads. Every field is optional; the wire names
  * are snake_case and this SDK spells them the way its other options are
@@ -2087,7 +2215,7 @@ interface DatapointsApi {
 interface JobHistoryOptions {
     /** Only runs of this action or service. */
     slug?: string;
-    /** Only runs in this state: `running`, `succeeded`, `failed`, `cancelled` or `lost`. */
+    /** Only runs in this state: `running`, `unknown`, `succeeded`, `failed`, `cancelled` or `lost`. */
     state?: JobState;
     /** Only `action` runs, or only `service` runs. */
     kind?: 'action' | 'service';
@@ -2387,4 +2515,4 @@ interface FleetlessClient {
  */
 declare function createClient(options: FleetlessClientOptions): FleetlessClient;
 
-export { type AcceptInvitationOptions, type ActionsApi, type Asset, type AssetBytes, type AssetListResponse, type AssetsApi, type AuthApi, type BeginOidcLoginOptions, type BusyDetails, type CameraDescriptor, type CameraLiveSession, type CameraSnapshot, type CameraSnapshotMeta, type CamerasApi, type ClientIdentity, type ClientMcpInteraction, type ClientOidcErrorCode, type ClientRobotListItem, type CompleteOidcLoginOptions, type CreateMeshLoaderOptions, type CredentialSource, type DatapointEvent, type DatapointSubscription, type DatapointSubscriptionHandlers, type DatapointValue, type DatapointsApi, type FleetlessClient, type FleetlessClientConfig, type FleetlessClientOptions, FleetlessError, type FleetlessErrorCode, type FleetlessErrorOptions, type HistoryAggregation, type HistoryBucketsResponse, type HistoryOptions, type HistorySamplesResponse, InMemoryTokenStore, type InvokeOptions, type Job, type JobEvent, type JobHistoryOptions, type JobRun, type JobRunListResponse, type JobState, type JobSubscription, type JobSubscriptionHandlers, type JobsApi, type McpCapabilities, type McpConsentGrant, type McpExposure, type McpInteractionDecision, type McpRobotDatasheet, type MeshLoaderDelegate, type OidcLoginRequest, type ParameterInvalidDetails, type ParameterViolation, type PrepareUrdfSceneOptions, type ProviderButton, type PublishersApi, type RateLimitDetails, type RegisterOptions, type RobotsApi, SDK_ERROR_CODES, type SdkErrorCode, type SendCommandOptions, type ServicesApi, type StoredSession, type TokenStore, type UrdfCompleteness, type UrdfSceneManager, type UrdfSceneResources, createClient, parameterInvalidDetails };
+export { type AcceptInvitationOptions, type ActionsApi, type Asset, type AssetBytes, type AssetListResponse, type AssetsApi, type AuthApi, type BeginOidcLoginOptions, type BusyDetails, CANCEL_RETURN_CODES, type CameraDescriptor, type CameraLiveSession, type CameraSnapshot, type CameraSnapshotMeta, type CamerasApi, type CancelRejectedDetails, type CancelReturnCode, type ClientIdentity, type ClientMcpInteraction, type ClientOidcErrorCode, type ClientRobotListItem, type CompleteOidcLoginOptions, type CreateMeshLoaderOptions, type CredentialSource, type DatapointEvent, type DatapointSubscription, type DatapointSubscriptionHandlers, type DatapointValue, type DatapointsApi, type FleetlessClient, type FleetlessClientConfig, type FleetlessClientOptions, FleetlessError, type FleetlessErrorCode, type FleetlessErrorOptions, type HistoryAggregation, type HistoryBucketsResponse, type HistoryOptions, type HistorySamplesResponse, InMemoryTokenStore, type InvokeOptions, type Job, type JobEvent, type JobHistoryOptions, type JobOrigin, type JobRun, type JobRunListResponse, type JobState, type JobSubscription, type JobSubscriptionHandlers, type JobsApi, type McpCapabilities, type McpConsentGrant, type McpExposure, type McpInteractionDecision, type McpRobotDatasheet, type MeshLoaderDelegate, type OidcLoginRequest, type ParameterInvalidDetails, type ParameterViolation, type PrepareUrdfSceneOptions, type ProviderButton, type PublishersApi, type RateLimitDetails, type RegisterOptions, type RobotsApi, SDK_ERROR_CODES, type SdkErrorCode, type SendCommandOptions, type ServicesApi, type StoredSession, type TokenStore, type UrdfCompleteness, type UrdfSceneManager, type UrdfSceneResources, cancelRejectedDetails, createClient, parameterInvalidDetails };

package/dist/index.d.ts

@@ -63,6 +63,23 @@ declare const mcpRobotDatasheet: z.ZodObject<{
 }, z.core.$strip>;
 type McpRobotDatasheet = z.infer<typeof mcpRobotDatasheet>;
 
+/**
+ * The ROS 2 `action_msgs/srv/CancelGoal` return codes: `0` `ERROR_NONE` (the
+ * server accepted the cancel request), `1` `ERROR_REJECTED` (it refused),
+ * `2` `ERROR_UNKNOWN_GOAL_ID`, `3` `ERROR_GOAL_TERMINATED` (the goal had
+ * already ended). An accepted request is not an ended goal: whether the goal
+ * ends, and how, is what the action's status reports afterwards, and reaches
+ * the cloud as the goal's `job_update`.
+ */
+declare const CANCEL_RETURN_CODES: {
+    readonly none: 0;
+    readonly rejected: 1;
+    readonly unknown_goal_id: 2;
+    readonly goal_terminated: 3;
+};
+declare const cancelReturnCode: z.ZodNumber;
+type CancelReturnCode$1 = z.infer<typeof cancelReturnCode>;
+
 
 /**
  * Jobs: one running unit of work on a robot — an action
@@ -74,14 +91,20 @@ type McpRobotDatasheet = z.infer<typeof mcpRobotDatasheet>;
  * 1. **State is observed by slug, not by id.** The id is informative; a client
  *    watches `robot × slug` and sees whatever job is running there, which is
  *    also why every observer of a slug sees the same job.
- * 2. **`lost` is a real outcome and must be said out loud.** Job state
- *    lives only in the bridge's memory; if it restarts mid-job, the results
- *    are gone. The cloud then marks the job `lost` — never leaves it reading
- *    "running" because nobody contradicted it. A system that reports a
- *    machine is still working when it does not know is worse than one that
- *    admits it lost track.
+ * 2. **What the cloud does not know it calls `unknown`, and `lost` is final.**
+ *    A job whose robot went quiet — offline past `JOB_OFFLINE_GRACE_MS`, or
+ *    connected but silent past `JOB_HEARTBEAT_TIMEOUT_MS` — is `unknown`: not
+ *    terminal, the slug stays occupied, and only a statement of the bridge
+ *    resolves it (it is running, it ended, or the bridge does not know it and
+ *    nothing else runs on its action). `lost` is what that last statement
+ *    produces, and nothing ever leaves it. Neither is left reading "running"
+ *    because nobody contradicted it: a system that reports a machine is still
+ *    working when it does not know is worse than one that says so — and one
+ *    that declares work lost on a guess is wrong the moment the robot comes
+ *    back and says it finished.
  */
 declare const jobState: z.ZodEnum<{
+    unknown: "unknown";
     failed: "failed";
     running: "running";
     succeeded: "succeeded";
@@ -89,17 +112,42 @@ declare const jobState: z.ZodEnum<{
     lost: "lost";
 }>;
 type JobState = z.infer<typeof jobState>;
+/**
+ * Who started a job.
+ *
+ * `fleetless` for every job the cloud minted from an invocation. `external`
+ * for a goal the bridge found active on a published action without having
+ * sent it — started by anyone else on the robot's ROS graph, or the bridge's
+ * own goal after its mapping was lost. An external job has the same shape,
+ * states, live stream and cancel as any other, but no parameters (ROS 2
+ * publishes a goal's request nowhere), no starter, and it lives in memory
+ * only: it is never written to `job_runs` and never counts towards quotas.
+ */
+declare const jobOrigin: z.ZodEnum<{
+    fleetless: "fleetless";
+    external: "external";
+}>;
+type JobOrigin$1 = z.infer<typeof jobOrigin>;
+/**
+ * One job, as the cloud tells every client about it — a Fleetless job or an
+ * external goal alike, told apart only by `origin`.
+ */
 declare const job: z.ZodObject<{
     id: z.ZodUUID;
     robot_id: z.ZodUUID;
     slug: z.ZodString;
     state: z.ZodEnum<{
+        unknown: "unknown";
         failed: "failed";
         running: "running";
         succeeded: "succeeded";
         cancelled: "cancelled";
         lost: "lost";
     }>;
+    origin: z.ZodEnum<{
+        fleetless: "fleetless";
+        external: "external";
+    }>;
     started_at: z.ZodISODateTime;
     updated_at: z.ZodISODateTime;
     seq: z.ZodNumber;
@@ -129,12 +177,17 @@ declare const jobEvent: z.ZodObject<{
         robot_id: z.ZodUUID;
         slug: z.ZodString;
         state: z.ZodEnum<{
+            unknown: "unknown";
             failed: "failed";
             running: "running";
             succeeded: "succeeded";
             cancelled: "cancelled";
             lost: "lost";
         }>;
+        origin: z.ZodEnum<{
+            fleetless: "fleetless";
+            external: "external";
+        }>;
         started_at: z.ZodISODateTime;
         updated_at: z.ZodISODateTime;
         seq: z.ZodNumber;
@@ -153,6 +206,11 @@ type JobEvent = z.infer<typeof jobEvent>;
 /**
  * What a busy refusal tells the caller: what is already running. A refusal that
  * only says "busy" forces the caller to guess whether to wait or to give up.
+ *
+ * `running` is whatever occupies the slug — a `running` job, an `unknown` one
+ * the robot has not accounted for yet, or an `external` goal someone else
+ * started — and its `state` and `origin` say which, so a caller can tell
+ * "wait for it" from "cancel what someone else started".
  */
 declare const busyDetails: z.ZodObject<{
     running: z.ZodObject<{
@@ -160,12 +218,17 @@ declare const busyDetails: z.ZodObject<{
         robot_id: z.ZodUUID;
         slug: z.ZodString;
         state: z.ZodEnum<{
+            unknown: "unknown";
             failed: "failed";
             running: "running";
             succeeded: "succeeded";
             cancelled: "cancelled";
             lost: "lost";
         }>;
+        origin: z.ZodEnum<{
+            fleetless: "fleetless";
+            external: "external";
+        }>;
         started_at: z.ZodISODateTime;
         updated_at: z.ZodISODateTime;
         seq: z.ZodNumber;
@@ -194,6 +257,7 @@ declare const jobRun: z.ZodObject<{
         service: "service";
     }>;
     state: z.ZodEnum<{
+        unknown: "unknown";
         failed: "failed";
         running: "running";
         succeeded: "succeeded";
@@ -234,6 +298,7 @@ declare const jobRunListResponse: z.ZodObject<{
             service: "service";
         }>;
         state: z.ZodEnum<{
+            unknown: "unknown";
             failed: "failed";
             running: "running";
             succeeded: "succeeded";
@@ -761,12 +826,31 @@ declare const parameterInvalidDetails: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 type ParameterInvalidDetails = z.infer<typeof parameterInvalidDetails>;
+/**
+ * The `details` of a `cancel_rejected` refusal: every goal the cancel reached,
+ * accepted ones included, each with the `CancelGoal` return code its action
+ * server answered — compare `return_code` against `CANCEL_RETURN_CODES`
+ * (`none`, `rejected`, `unknown_goal_id`, `goal_terminated`); it is `null`
+ * when that goal's server did not answer within the bridge's bound. Always at
+ * least one goal: the cloud refuses a cancel only because a goal's server
+ * answered `ERROR_REJECTED`. Pinned here for the reason
+ * `parameterInvalidDetails` is: a caller parses it instead of reading the
+ * shape from prose.
+ */
+declare const cancelRejectedDetails: z.ZodObject<{
+    goals: z.ZodArray<z.ZodObject<{
+        job_id: z.ZodUUID;
+        goal_id: z.ZodString;
+        return_code: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type CancelRejectedDetails = z.infer<typeof cancelRejectedDetails>;
 /**
  * The codes in use today. The wire deliberately allows any string — this
  * list is the shared vocabulary, not a closed set, so a new refusal never
  * needs a contracts release before it can be reported honestly.
  */
-declare const ERROR_CODES: readonly ["not_found", "validation_error", "bad_request", "unknown_datapoint", "invalid_token", "protocol_mismatch", "invalid_frame", "duplicate_slug", "reserved_slug", "unknown_slug", "unknown_field_path", "unknown_type", "unknown_topic", "invalid_rate", "invalid_range", "config_conflict", "no_data", "robot_offline", "bridge_timeout", "unauthorized", "forbidden", "invalid_credentials", "token_expired", "token_revoked", "email_taken", "identifier_taken", "weak_password", "account_blocked", "busy", "parameter_invalid", "job_lost", "publisher_busy", "unknown_command", "not_subscribable", "camera_offline", "no_snapshot_yet", "live_unavailable", "wrong_kind", "not_recorded", "not_aggregatable", "quota_exceeded", "credential_in_use", "goal_timeout", "robot_in_use", "robot_deletion_partial", "job_queue_full", "invalid_uuid", "rate_limited", "tier_required", "token_spent", "service_timeout", "asset_missing", "dynamic_registration_disabled", "client_limit_reached", "idp_unavailable", "mcp_disabled", "tool_not_available", "capability_required", "last_owner", "target_state_conflict", "signup_closed", "draft_not_a_document", "internal_error", "not_cancellable", "unsupported_media_type", "wrong_browser", "invalid_yaml", "unstorable_yaml", "registration_closed", "domain_not_allowed", "email_unverified", "origin_not_allowed", "template_invalid", "provider_disabled", "provider_misconfigured", "invalid_redirect_uri", "interaction_expired"];
+declare const ERROR_CODES: readonly ["not_found", "validation_error", "bad_request", "unknown_datapoint", "invalid_token", "protocol_mismatch", "bridge_too_old", "invalid_frame", "duplicate_slug", "reserved_slug", "unknown_slug", "unknown_field_path", "unknown_type", "unknown_topic", "invalid_rate", "invalid_range", "config_conflict", "no_data", "robot_offline", "bridge_timeout", "unauthorized", "forbidden", "invalid_credentials", "token_expired", "token_revoked", "email_taken", "identifier_taken", "weak_password", "account_blocked", "busy", "parameter_invalid", "cancel_rejected", "job_lost", "job_unknown_to_bridge", "action_server_lost", "action_failed", "goal_rejected", "goal_send_failed", "result_failed", "goal_uncontrollable", "bridge_disconnected", "config_changed", "publisher_busy", "unknown_command", "not_subscribable", "camera_offline", "no_snapshot_yet", "live_unavailable", "wrong_kind", "not_recorded", "not_aggregatable", "quota_exceeded", "credential_in_use", "goal_timeout", "robot_in_use", "robot_deletion_partial", "job_queue_full", "invalid_uuid", "rate_limited", "tier_required", "token_spent", "service_timeout", "asset_missing", "dynamic_registration_disabled", "client_limit_reached", "idp_unavailable", "mcp_disabled", "tool_not_available", "capability_required", "last_owner", "target_state_conflict", "signup_closed", "draft_not_a_document", "internal_error", "not_cancellable", "unsupported_media_type", "wrong_browser", "invalid_yaml", "unstorable_yaml", "registration_closed", "domain_not_allowed", "email_unverified", "origin_not_allowed", "template_invalid", "provider_disabled", "provider_misconfigured", "invalid_redirect_uri", "interaction_expired"];
 type ErrorCode = (typeof ERROR_CODES)[number];
 
 /**
@@ -1019,6 +1103,17 @@ interface JobSubscription {
     unsubscribe(): void;
 }
 
+/**
+ * One goal's answer to a cancel: the ROS 2 `CancelGoal` return code its action
+ * server sent — `0` accepted (`CANCEL_RETURN_CODES.none`), `1` refused
+ * (`rejected`), `2` unknown goal (`unknown_goal_id`), `3` already ended
+ * (`goal_terminated`). The type of `return_code` in `CancelRejectedDetails`,
+ * where it is `null` when that goal's server did not answer. The wire shape is
+ * contracts' `cancelReturnCode`; the alias exists so the reference can
+ * describe it — a JSDoc on an `export type { … } from` statement does not
+ * survive bundling.
+ */
+type CancelReturnCode = CancelReturnCode$1;
 /**
  * Long-running work on a robot, reachable as `client.actions`. An action is
  * a ROS action the developer exposed under a slug: it is invoked, runs as
@@ -1059,6 +1154,27 @@ interface ActionsApi {
      * was nothing there", and "I stopped a job that started after I last
      * looked" are three different outcomes a discarded result cannot tell
      * apart.
+     *
+     * **Resolving means the robot's action server accepted the cancel, not
+     * that the goal ended.** The returned job is usually still `running`; how
+     * it ends arrives as its own update (`subscribe`). The platform answers
+     * from the action server's `CancelGoal` return codes, so a cancel can
+     * also reject with:
+     * - `cancel_rejected` — the server refused (`ERROR_REJECTED`) and the goal
+     *   keeps running unless its job later says otherwise.
+     *   `cancelRejectedDetails.parse(error.details).goals` lists every goal the
+     *   cancel reached as `{ job_id, goal_id, return_code }`; compare
+     *   `return_code` against `CANCEL_RETURN_CODES`: `none` (`0`, accepted),
+     *   `rejected` (`1`), `unknown_goal_id` (`2`), `goal_terminated` (`3`,
+     *   already ended), or `null` when that goal's server did not answer.
+     * - `bridge_timeout` — the robot's bridge did not answer in time; whether
+     *   the cancel reached the server is unknown.
+     * - the bridge's own code when it could not ask at all (e.g.
+     *   `unknown_slug`, `action_server_lost`), `not_cancellable` for a service,
+     *   and `robot_offline`.
+     *
+     * Cancelling an `unknown` job cancels every `external` goal on its action,
+     * never another of the platform's own jobs.
      */
     cancel(robotId: string, slug: string, jobId?: string | null, options?: SendCommandOptions): Promise<Job | null>;
     /**
@@ -2076,6 +2192,18 @@ interface DatapointsApi {
     }): Promise<HistorySamplesResponse>;
 }
 
+/**
+ * Who started a job: `fleetless` for every job the cloud minted from an
+ * invocation, `external` for a goal the bridge found active on a published
+ * action without having sent it. An external job has no parameters and no
+ * starter (ROS 2 publishes neither) and is never in `jobs.history`. The type
+ * of `Job.origin`, which every job carries.
+ *
+ * The wire shape is contracts' `jobOrigin`; the alias exists so the reference
+ * can describe it — a JSDoc on an `export type { … } from` statement does not
+ * survive bundling.
+ */
+type JobOrigin = JobOrigin$1;
 /**
  * The filters `jobs.history` reads. Every field is optional; the wire names
  * are snake_case and this SDK spells them the way its other options are
@@ -2087,7 +2215,7 @@ interface DatapointsApi {
 interface JobHistoryOptions {
     /** Only runs of this action or service. */
     slug?: string;
-    /** Only runs in this state: `running`, `succeeded`, `failed`, `cancelled` or `lost`. */
+    /** Only runs in this state: `running`, `unknown`, `succeeded`, `failed`, `cancelled` or `lost`. */
     state?: JobState;
     /** Only `action` runs, or only `service` runs. */
     kind?: 'action' | 'service';
@@ -2387,4 +2515,4 @@ interface FleetlessClient {
  */
 declare function createClient(options: FleetlessClientOptions): FleetlessClient;
 
-export { type AcceptInvitationOptions, type ActionsApi, type Asset, type AssetBytes, type AssetListResponse, type AssetsApi, type AuthApi, type BeginOidcLoginOptions, type BusyDetails, type CameraDescriptor, type CameraLiveSession, type CameraSnapshot, type CameraSnapshotMeta, type CamerasApi, type ClientIdentity, type ClientMcpInteraction, type ClientOidcErrorCode, type ClientRobotListItem, type CompleteOidcLoginOptions, type CreateMeshLoaderOptions, type CredentialSource, type DatapointEvent, type DatapointSubscription, type DatapointSubscriptionHandlers, type DatapointValue, type DatapointsApi, type FleetlessClient, type FleetlessClientConfig, type FleetlessClientOptions, FleetlessError, type FleetlessErrorCode, type FleetlessErrorOptions, type HistoryAggregation, type HistoryBucketsResponse, type HistoryOptions, type HistorySamplesResponse, InMemoryTokenStore, type InvokeOptions, type Job, type JobEvent, type JobHistoryOptions, type JobRun, type JobRunListResponse, type JobState, type JobSubscription, type JobSubscriptionHandlers, type JobsApi, type McpCapabilities, type McpConsentGrant, type McpExposure, type McpInteractionDecision, type McpRobotDatasheet, type MeshLoaderDelegate, type OidcLoginRequest, type ParameterInvalidDetails, type ParameterViolation, type PrepareUrdfSceneOptions, type ProviderButton, type PublishersApi, type RateLimitDetails, type RegisterOptions, type RobotsApi, SDK_ERROR_CODES, type SdkErrorCode, type SendCommandOptions, type ServicesApi, type StoredSession, type TokenStore, type UrdfCompleteness, type UrdfSceneManager, type UrdfSceneResources, createClient, parameterInvalidDetails };
+export { type AcceptInvitationOptions, type ActionsApi, type Asset, type AssetBytes, type AssetListResponse, type AssetsApi, type AuthApi, type BeginOidcLoginOptions, type BusyDetails, CANCEL_RETURN_CODES, type CameraDescriptor, type CameraLiveSession, type CameraSnapshot, type CameraSnapshotMeta, type CamerasApi, type CancelRejectedDetails, type CancelReturnCode, type ClientIdentity, type ClientMcpInteraction, type ClientOidcErrorCode, type ClientRobotListItem, type CompleteOidcLoginOptions, type CreateMeshLoaderOptions, type CredentialSource, type DatapointEvent, type DatapointSubscription, type DatapointSubscriptionHandlers, type DatapointValue, type DatapointsApi, type FleetlessClient, type FleetlessClientConfig, type FleetlessClientOptions, FleetlessError, type FleetlessErrorCode, type FleetlessErrorOptions, type HistoryAggregation, type HistoryBucketsResponse, type HistoryOptions, type HistorySamplesResponse, InMemoryTokenStore, type InvokeOptions, type Job, type JobEvent, type JobHistoryOptions, type JobOrigin, type JobRun, type JobRunListResponse, type JobState, type JobSubscription, type JobSubscriptionHandlers, type JobsApi, type McpCapabilities, type McpConsentGrant, type McpExposure, type McpInteractionDecision, type McpRobotDatasheet, type MeshLoaderDelegate, type OidcLoginRequest, type ParameterInvalidDetails, type ParameterViolation, type PrepareUrdfSceneOptions, type ProviderButton, type PublishersApi, type RateLimitDetails, type RegisterOptions, type RobotsApi, SDK_ERROR_CODES, type SdkErrorCode, type SendCommandOptions, type ServicesApi, type StoredSession, type TokenStore, type UrdfCompleteness, type UrdfSceneManager, type UrdfSceneResources, cancelRejectedDetails, createClient, parameterInvalidDetails };