@wandelbots/nova-js 3.13.0-pr.307.ea0533d → 3.13.0

package/src/lib/experimental/nats/generated/operations.ts

@@ -35,150 +35,698 @@ import type {
 
 /** Subject parameters required by each NATS subject, e.g. "nova.v2.cells.{cell}". */
 export interface NatsOperationParams {
-  /** publishCell */
-  "nova.v2.cells.{cell}": { cell: string }
-  /** publishApp */
-  "nova.v2.cells.{cell}.apps.{app}": { cell: string; app: string }
-  /** publishProgramStatus */
-  "nova.v2.cells.{cell}.programs": { cell: string }
-  /** publishRobotController */
+  /**
+   * Cell Configuration
+   *
+   * Publishes the configuration for a cell.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishCell
+   */
+  "nova.v2.cells.{cell}": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
+    cell: string
+  }
+  /**
+   * App Configuration
+   *
+   * Publishes the configuration for a GUI application in the cell.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishApp
+   */
+  "nova.v2.cells.{cell}.apps.{app}": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
+    cell: string
+    /**
+     * Name of the provided application.
+     * Must be unique within the cell and is used as an identifier for addressing the application in all API calls, e.g., when updating the application.
+     */
+    app: string
+  }
+  /**
+   * Program Status
+   *
+   * Publishes status messages for programs running in an app within a cell.
+   * The status messages provide information about the current state of a program run.
+   *
+   * @operationId publishProgramStatus
+   */
+  "nova.v2.cells.{cell}.programs": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
+    cell: string
+  }
+  /**
+   * Robot Controller Configuration
+   *
+   * Publishes the configuration of a robot controller.
+   *
+   * @operationId publishRobotController
+   */
   "nova.v2.cells.{cell}.controllers.{controller}": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
     cell: string
+    /**
+     * Unique identifier to address a controller in the cell.
+     */
     controller: string
   }
-  /** publishCellStatus */
-  "nova.v2.cells.{cell}.status": { cell: string }
-  /** publishCellCycle */
-  "nova.v2.cells.{cell}.cycle": { cell: string }
-  /** publishSystemStatus */
-  "nova.v2.system.status": Record<string, never>
-  /** publishCollisionSetup */
+  /**
+   * Service Status
+   *
+   * Publishes the status of all cell resources.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishCellStatus
+   */
+  "nova.v2.cells.{cell}.status": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
+    cell: string
+  }
+  /**
+   * Cell Cycle Event
+   *
+   * Publishes the cycle events for a cell.
+   *
+   * @operationId publishCellCycle
+   */
+  "nova.v2.cells.{cell}.cycle": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
+    cell: string
+  }
+  /**
+   * Wandelbots NOVA status
+   *
+   * Publishes the status of all system services.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishSystemStatus
+   */
+  "nova.v2.system.status": Record<never, never>
+  /**
+   * Collision Setup
+   *
+   * Publishes the stored collision setup.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishCollisionSetup
+   */
   "nova.v2.cells.{cell}.collision.setups.{setup}": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
     cell: string
+    /**
+     * Unique identifier addressing a collision setup.
+     */
     setup: string
   }
-  /** publishBUSIOStatus */
-  "nova.v2.cells.{cell}.bus-ios.status": { cell: string }
-  /** publishBUSIOsIOs */
-  "nova.v2.cells.{cell}.bus-ios.ios": { cell: string }
-  /** setBUSIOsIOs */
-  "nova.v2.cells.{cell}.bus-ios.ios.set": { cell: string }
-  /** selectRobotControllerIOs */
+  /**
+   * BUS Inputs/Outputs Service Status
+   *
+   * Publishes the status of BUS inputs/outputs service.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`.
+   *
+   * @operationId publishBUSIOStatus
+   */
+  "nova.v2.cells.{cell}.bus-ios.status": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
+    cell: string
+  }
+  /**
+   * BUS Input/Output Values
+   *
+   * Publishes updates of BUS input/output values.
+   *
+   * @operationId publishBUSIOsIOs
+   */
+  "nova.v2.cells.{cell}.bus-ios.ios": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
+    cell: string
+  }
+  /**
+   * Set Output Values
+   *
+   * Set output values published with the BUS inputs/outputs service.
+   * If you're using a virtual service, you can set inputs as well.
+   *
+   * @operationId setBUSIOsIOs
+   */
+  "nova.v2.cells.{cell}.bus-ios.ios.set": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
+    cell: string
+  }
+  /**
+   * Select Input/Output Values
+   *
+   * Select input/output values published by the controller.
+   *
+   * @operationId selectRobotControllerIOs
+   */
   "nova.v2.cells.{cell}.controllers.{controller}.ios.select": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
     cell: string
+    /**
+     * Unique identifier to address a controller in a cell.
+     */
     controller: string
   }
-  /** publishRobotControllerIOs */
+  /**
+   * Input/Output Values
+   *
+   * Publishes updates of input/output values.
+   *
+   * @operationId publishRobotControllerIOs
+   */
   "nova.v2.cells.{cell}.controllers.{controller}.ios": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
     cell: string
+    /**
+     * Unique identifier to address a controller in the cell.
+     */
     controller: string
   }
-  /** publishRobotControllersState */
+  /**
+   * State of Robot Controller
+   *
+   * Publishes the current state of a robot controller.
+   *
+   * @operationId publishRobotControllersState
+   */
   "nova.v2.cells.{cell}.controllers.{controller}.state": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
     cell: string
+    /**
+     * Unique identifier to address a controller in the cell.
+     */
     controller: string
   }
-  /** publishMotionGroupDescription */
+  /**
+   * Description of Motion Group
+   *
+   * Publishes the description of a motion group, including TCPs, mounting, safety zones, limits, etc.
+   *
+   * @operationId publishMotionGroupDescription
+   */
   "nova.v2.cells.{cell}.controllers.{controller}.motion-groups.{motion-group}.description": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
     cell: string
+    /**
+     * Unique identifier addressing a controller in the cell.
+     */
     controller: string
+    /**
+     * Motion group identifier.
+     */
     "motion-group": string
   }
-  /** eventSystemUpdateStarted */
-  "nova.v2.events.system.update.started": Record<string, never>
-  /** eventSystemUpdateCompleted */
-  "nova.v2.events.system.update.completed": Record<string, never>
-  /** eventSystemNetworkStatusChanged */
-  "nova.v2.events.system.network.status.changed": Record<string, never>
-  /** eventCellCreated */
-  "nova.v2.events.cells.{cell}.created": { cell: string }
-  /** eventCellUpdated */
-  "nova.v2.events.cells.{cell}.updated": { cell: string }
-  /** eventCellDeleted */
-  "nova.v2.events.cells.{cell}.deleted": { cell: string }
-  /** eventAppCreated */
+  /**
+   * System Update Started
+   *
+   * Publishes an event when a system update process is initiated.
+   *
+   * This event is triggered once the service-manager begins a system update process,
+   * providing details about the update metadata, trigger information, and pre-update checks.
+   *
+   * The event follows CloudEvents v1.0 specification and is persisted in NATS JetStream
+   * for reliable delivery and event replay capabilities.
+   *
+   * @operationId eventSystemUpdateStarted
+   */
+  "nova.v2.events.system.update.started": Record<never, never>
+  /**
+   * System Update Completed
+   *
+   * Publishes an event when a system update process is completed.
+   *
+   * This event is triggered once the service-manager completes a system update process,
+   * providing comprehensive results including success status, component outcomes,
+   * error details, and post-update validation results.
+   *
+   * The event follows CloudEvents v1.0 specification and is persisted in NATS JetStream
+   * for reliable delivery and event replay capabilities.
+   *
+   * @operationId eventSystemUpdateCompleted
+   */
+  "nova.v2.events.system.update.completed": Record<never, never>
+  /**
+   * System Network Status Changed
+   *
+   * Publishes an event when a system network status changes.
+   *
+   * This event is triggered once system-info service detects a change in the system network status,
+   * providing details about the new network state and related information.
+   *
+   * The event follows CloudEvents v1.0 specification and is persisted in NATS JetStream
+   * for reliable delivery and event replay capabilities.
+   *
+   * @operationId eventSystemNetworkStatusChanged
+   */
+  "nova.v2.events.system.network.status.changed": Record<never, never>
+  /**
+   * Cell Created
+   *
+   * Publishes an event when a cell foundation release is created.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventCellCreated
+   */
+  "nova.v2.events.cells.{cell}.created": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
+    cell: string
+  }
+  /**
+   * Cell Updated
+   *
+   * Publishes an event when a cell foundation release is updated.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventCellUpdated
+   */
+  "nova.v2.events.cells.{cell}.updated": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
+    cell: string
+  }
+  /**
+   * Cell Deleted
+   *
+   * Publishes an event when a cell foundation release is deleted.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventCellDeleted
+   */
+  "nova.v2.events.cells.{cell}.deleted": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
+    cell: string
+  }
+  /**
+   * App Created
+   *
+   * Publishes an event when an app release is created in a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventAppCreated
+   */
   "nova.v2.events.cells.{cell}.apps.{app}.created": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
     cell: string
+    /**
+     * Unique identifier addressing an app in the cell.
+     */
     app: string
   }
-  /** eventAppUpdated */
+  /**
+   * App Updated
+   *
+   * Publishes an event when an app release is updated in a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventAppUpdated
+   */
   "nova.v2.events.cells.{cell}.apps.{app}.updated": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
     cell: string
+    /**
+     * Unique identifier addressing an app in the cell.
+     */
     app: string
   }
-  /** eventAppDeleted */
+  /**
+   * App Deleted
+   *
+   * Publishes an event when an app release is deleted from a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventAppDeleted
+   */
   "nova.v2.events.cells.{cell}.apps.{app}.deleted": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
     cell: string
+    /**
+     * Unique identifier addressing an app in the cell.
+     */
     app: string
   }
-  /** eventRobotControllerCreated */
+  /**
+   * Robot Controller Created
+   *
+   * Publishes an event when a robot controller release is created in a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventRobotControllerCreated
+   */
   "nova.v2.events.cells.{cell}.controllers.{controller}.created": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
     cell: string
+    /**
+     * Unique identifier to address a controller in the cell.
+     */
     controller: string
   }
-  /** eventRobotControllerUpdated */
+  /**
+   * Robot Controller Updated
+   *
+   * Publishes an event when a robot controller release is updated in a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventRobotControllerUpdated
+   */
   "nova.v2.events.cells.{cell}.controllers.{controller}.updated": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
     cell: string
+    /**
+     * Unique identifier to address a controller in the cell.
+     */
     controller: string
   }
-  /** eventRobotControllerDeleted */
+  /**
+   * Robot Controller Deleted
+   *
+   * Publishes an event when a robot controller release is deleted from a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventRobotControllerDeleted
+   */
   "nova.v2.events.cells.{cell}.controllers.{controller}.deleted": {
+    /**
+     * Unique identifier addressing a cell in all API calls.
+     */
     cell: string
+    /**
+     * Unique identifier to address a controller in the cell.
+     */
     controller: string
   }
 }
 
 /** Payload types for subjects the server publishes and the client subscribes to. */
 export interface NatsSubscribePayloads {
-  /** publishCell */
+  /**
+   * Cell Configuration
+   *
+   * Publishes the configuration for a cell.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishCell
+   */
   "nova.v2.cells.{cell}": Cell
-  /** publishApp */
+  /**
+   * App Configuration
+   *
+   * Publishes the configuration for a GUI application in the cell.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishApp
+   */
   "nova.v2.cells.{cell}.apps.{app}": App
-  /** publishProgramStatus */
+  /**
+   * Program Status
+   *
+   * Publishes status messages for programs running in an app within a cell.
+   * The status messages provide information about the current state of a program run.
+   *
+   * @operationId publishProgramStatus
+   */
   "nova.v2.cells.{cell}.programs": ProgramStatus
-  /** publishRobotController */
+  /**
+   * Robot Controller Configuration
+   *
+   * Publishes the configuration of a robot controller.
+   *
+   * @operationId publishRobotController
+   */
   "nova.v2.cells.{cell}.controllers.{controller}": RobotController
-  /** publishCellStatus */
+  /**
+   * Service Status
+   *
+   * Publishes the status of all cell resources.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishCellStatus
+   */
   "nova.v2.cells.{cell}.status": ServiceStatusList
-  /** publishCellCycle */
+  /**
+   * Cell Cycle Event
+   *
+   * Publishes the cycle events for a cell.
+   *
+   * @operationId publishCellCycle
+   */
   "nova.v2.cells.{cell}.cycle": CellCycleEvent
-  /** publishSystemStatus */
+  /**
+   * Wandelbots NOVA status
+   *
+   * Publishes the status of all system services.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishSystemStatus
+   */
   "nova.v2.system.status": ServiceStatusList
-  /** publishCollisionSetup */
+  /**
+   * Collision Setup
+   *
+   * Publishes the stored collision setup.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishCollisionSetup
+   */
   "nova.v2.cells.{cell}.collision.setups.{setup}": CollisionSetup
-  /** publishBUSIOStatus */
+  /**
+   * BUS Inputs/Outputs Service Status
+   *
+   * Publishes the status of BUS inputs/outputs service.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`.
+   *
+   * @operationId publishBUSIOStatus
+   */
   "nova.v2.cells.{cell}.bus-ios.status": BusIOsState
-  /** publishBUSIOsIOs */
+  /**
+   * BUS Input/Output Values
+   *
+   * Publishes updates of BUS input/output values.
+   *
+   * @operationId publishBUSIOsIOs
+   */
   "nova.v2.cells.{cell}.bus-ios.ios": ListIOValuesResponse
-  /** publishRobotControllerIOs */
+  /**
+   * Input/Output Values
+   *
+   * Publishes updates of input/output values.
+   *
+   * @operationId publishRobotControllerIOs
+   */
   "nova.v2.cells.{cell}.controllers.{controller}.ios": StreamIOValuesResponse
-  /** publishRobotControllersState */
+  /**
+   * State of Robot Controller
+   *
+   * Publishes the current state of a robot controller.
+   *
+   * @operationId publishRobotControllersState
+   */
   "nova.v2.cells.{cell}.controllers.{controller}.state": RobotControllerState
-  /** publishMotionGroupDescription */
+  /**
+   * Description of Motion Group
+   *
+   * Publishes the description of a motion group, including TCPs, mounting, safety zones, limits, etc.
+   *
+   * @operationId publishMotionGroupDescription
+   */
   "nova.v2.cells.{cell}.controllers.{controller}.motion-groups.{motion-group}.description": MotionGroupDescription
-  /** eventSystemUpdateStarted */
+  /**
+   * System Update Started
+   *
+   * Publishes an event when a system update process is initiated.
+   *
+   * This event is triggered once the service-manager begins a system update process,
+   * providing details about the update metadata, trigger information, and pre-update checks.
+   *
+   * The event follows CloudEvents v1.0 specification and is persisted in NATS JetStream
+   * for reliable delivery and event replay capabilities.
+   *
+   * @operationId eventSystemUpdateStarted
+   */
   "nova.v2.events.system.update.started": SystemUpdateStartedEvent
-  /** eventSystemUpdateCompleted */
+  /**
+   * System Update Completed
+   *
+   * Publishes an event when a system update process is completed.
+   *
+   * This event is triggered once the service-manager completes a system update process,
+   * providing comprehensive results including success status, component outcomes,
+   * error details, and post-update validation results.
+   *
+   * The event follows CloudEvents v1.0 specification and is persisted in NATS JetStream
+   * for reliable delivery and event replay capabilities.
+   *
+   * @operationId eventSystemUpdateCompleted
+   */
   "nova.v2.events.system.update.completed": SystemUpdateCompletedEvent
-  /** eventSystemNetworkStatusChanged */
+  /**
+   * System Network Status Changed
+   *
+   * Publishes an event when a system network status changes.
+   *
+   * This event is triggered once system-info service detects a change in the system network status,
+   * providing details about the new network state and related information.
+   *
+   * The event follows CloudEvents v1.0 specification and is persisted in NATS JetStream
+   * for reliable delivery and event replay capabilities.
+   *
+   * @operationId eventSystemNetworkStatusChanged
+   */
   "nova.v2.events.system.network.status.changed": NetworkStatusChangedEvent
-  /** eventCellCreated */
+  /**
+   * Cell Created
+   *
+   * Publishes an event when a cell foundation release is created.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventCellCreated
+   */
   "nova.v2.events.cells.{cell}.created": CellCreatedEvent
-  /** eventCellUpdated */
+  /**
+   * Cell Updated
+   *
+   * Publishes an event when a cell foundation release is updated.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventCellUpdated
+   */
   "nova.v2.events.cells.{cell}.updated": CellUpdatedEvent
-  /** eventCellDeleted */
+  /**
+   * Cell Deleted
+   *
+   * Publishes an event when a cell foundation release is deleted.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventCellDeleted
+   */
   "nova.v2.events.cells.{cell}.deleted": CellDeletedEvent
-  /** eventAppCreated */
+  /**
+   * App Created
+   *
+   * Publishes an event when an app release is created in a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventAppCreated
+   */
   "nova.v2.events.cells.{cell}.apps.{app}.created": AppCreatedEvent
-  /** eventAppUpdated */
+  /**
+   * App Updated
+   *
+   * Publishes an event when an app release is updated in a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventAppUpdated
+   */
   "nova.v2.events.cells.{cell}.apps.{app}.updated": AppUpdatedEvent
-  /** eventAppDeleted */
+  /**
+   * App Deleted
+   *
+   * Publishes an event when an app release is deleted from a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventAppDeleted
+   */
   "nova.v2.events.cells.{cell}.apps.{app}.deleted": AppDeletedEvent
-  /** eventRobotControllerCreated */
+  /**
+   * Robot Controller Created
+   *
+   * Publishes an event when a robot controller release is created in a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventRobotControllerCreated
+   */
   "nova.v2.events.cells.{cell}.controllers.{controller}.created": RobotControllerCreatedEvent
-  /** eventRobotControllerUpdated */
+  /**
+   * Robot Controller Updated
+   *
+   * Publishes an event when a robot controller release is updated in a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventRobotControllerUpdated
+   */
   "nova.v2.events.cells.{cell}.controllers.{controller}.updated": RobotControllerUpdatedEvent
-  /** eventRobotControllerDeleted */
+  /**
+   * Robot Controller Deleted
+   *
+   * Publishes an event when a robot controller release is deleted from a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventRobotControllerDeleted
+   */
   "nova.v2.events.cells.{cell}.controllers.{controller}.deleted": RobotControllerDeletedEvent
 }
 
@@ -186,18 +734,317 @@ export type NatsSubscribeSubject = keyof NatsSubscribePayloads
 
 /** Request payload types for subjects the client sends requests to. */
 export interface NatsRequestPayloads {
-  /** setBUSIOsIOs */
+  /**
+   * Set Output Values
+   *
+   * Set output values published with the BUS inputs/outputs service.
+   * If you're using a virtual service, you can set inputs as well.
+   *
+   * @operationId setBUSIOsIOs
+   */
   "nova.v2.cells.{cell}.bus-ios.ios.set": ListIOValuesResponse
-  /** selectRobotControllerIOs */
+  /**
+   * Select Input/Output Values
+   *
+   * Select input/output values published by the controller.
+   *
+   * @operationId selectRobotControllerIOs
+   */
   "nova.v2.cells.{cell}.controllers.{controller}.ios.select": SelectIOs
 }
 
 /** Reply payload types for request/reply subjects. */
 export interface NatsReplyPayloads {
-  /** setBUSIOsIOs */
+  /**
+   * Set Output Values
+   *
+   * Set output values published with the BUS inputs/outputs service.
+   * If you're using a virtual service, you can set inputs as well.
+   *
+   * @operationId setBUSIOsIOs
+   */
   "nova.v2.cells.{cell}.bus-ios.ios.set": NatsErrorPayload
-  /** selectRobotControllerIOs */
+  /**
+   * Select Input/Output Values
+   *
+   * Select input/output values published by the controller.
+   *
+   * @operationId selectRobotControllerIOs
+   */
   "nova.v2.cells.{cell}.controllers.{controller}.ios.select": NatsErrorPayload
 }
 
 export type NatsRequestSubject = keyof NatsRequestPayloads
+
+/** Payload types for every subject defined in the spec, publishable via NovaNatsClient#publish. */
+export interface NatsPublishPayloads {
+  /**
+   * Cell Configuration
+   *
+   * Publishes the configuration for a cell.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishCell
+   */
+  "nova.v2.cells.{cell}": Cell
+  /**
+   * App Configuration
+   *
+   * Publishes the configuration for a GUI application in the cell.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishApp
+   */
+  "nova.v2.cells.{cell}.apps.{app}": App
+  /**
+   * Program Status
+   *
+   * Publishes status messages for programs running in an app within a cell.
+   * The status messages provide information about the current state of a program run.
+   *
+   * @operationId publishProgramStatus
+   */
+  "nova.v2.cells.{cell}.programs": ProgramStatus
+  /**
+   * Robot Controller Configuration
+   *
+   * Publishes the configuration of a robot controller.
+   *
+   * @operationId publishRobotController
+   */
+  "nova.v2.cells.{cell}.controllers.{controller}": RobotController
+  /**
+   * Service Status
+   *
+   * Publishes the status of all cell resources.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishCellStatus
+   */
+  "nova.v2.cells.{cell}.status": ServiceStatusList
+  /**
+   * Cell Cycle Event
+   *
+   * Publishes the cycle events for a cell.
+   *
+   * @operationId publishCellCycle
+   */
+  "nova.v2.cells.{cell}.cycle": CellCycleEvent
+  /**
+   * Wandelbots NOVA status
+   *
+   * Publishes the status of all system services.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishSystemStatus
+   */
+  "nova.v2.system.status": ServiceStatusList
+  /**
+   * Collision Setup
+   *
+   * Publishes the stored collision setup.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`
+   *
+   * @operationId publishCollisionSetup
+   */
+  "nova.v2.cells.{cell}.collision.setups.{setup}": CollisionSetup
+  /**
+   * BUS Inputs/Outputs Service Status
+   *
+   * Publishes the status of BUS inputs/outputs service.
+   *
+   * The latest status message is persisted NATS JetStream, documented in `x-nats-jetstream-stream`.
+   *
+   * @operationId publishBUSIOStatus
+   */
+  "nova.v2.cells.{cell}.bus-ios.status": BusIOsState
+  /**
+   * BUS Input/Output Values
+   *
+   * Publishes updates of BUS input/output values.
+   *
+   * @operationId publishBUSIOsIOs
+   */
+  "nova.v2.cells.{cell}.bus-ios.ios": ListIOValuesResponse
+  /**
+   * Set Output Values
+   *
+   * Set output values published with the BUS inputs/outputs service.
+   * If you're using a virtual service, you can set inputs as well.
+   *
+   * @operationId setBUSIOsIOs
+   */
+  "nova.v2.cells.{cell}.bus-ios.ios.set": ListIOValuesResponse
+  /**
+   * Select Input/Output Values
+   *
+   * Select input/output values published by the controller.
+   *
+   * @operationId selectRobotControllerIOs
+   */
+  "nova.v2.cells.{cell}.controllers.{controller}.ios.select": SelectIOs
+  /**
+   * Input/Output Values
+   *
+   * Publishes updates of input/output values.
+   *
+   * @operationId publishRobotControllerIOs
+   */
+  "nova.v2.cells.{cell}.controllers.{controller}.ios": StreamIOValuesResponse
+  /**
+   * State of Robot Controller
+   *
+   * Publishes the current state of a robot controller.
+   *
+   * @operationId publishRobotControllersState
+   */
+  "nova.v2.cells.{cell}.controllers.{controller}.state": RobotControllerState
+  /**
+   * Description of Motion Group
+   *
+   * Publishes the description of a motion group, including TCPs, mounting, safety zones, limits, etc.
+   *
+   * @operationId publishMotionGroupDescription
+   */
+  "nova.v2.cells.{cell}.controllers.{controller}.motion-groups.{motion-group}.description": MotionGroupDescription
+  /**
+   * System Update Started
+   *
+   * Publishes an event when a system update process is initiated.
+   *
+   * This event is triggered once the service-manager begins a system update process,
+   * providing details about the update metadata, trigger information, and pre-update checks.
+   *
+   * The event follows CloudEvents v1.0 specification and is persisted in NATS JetStream
+   * for reliable delivery and event replay capabilities.
+   *
+   * @operationId eventSystemUpdateStarted
+   */
+  "nova.v2.events.system.update.started": SystemUpdateStartedEvent
+  /**
+   * System Update Completed
+   *
+   * Publishes an event when a system update process is completed.
+   *
+   * This event is triggered once the service-manager completes a system update process,
+   * providing comprehensive results including success status, component outcomes,
+   * error details, and post-update validation results.
+   *
+   * The event follows CloudEvents v1.0 specification and is persisted in NATS JetStream
+   * for reliable delivery and event replay capabilities.
+   *
+   * @operationId eventSystemUpdateCompleted
+   */
+  "nova.v2.events.system.update.completed": SystemUpdateCompletedEvent
+  /**
+   * System Network Status Changed
+   *
+   * Publishes an event when a system network status changes.
+   *
+   * This event is triggered once system-info service detects a change in the system network status,
+   * providing details about the new network state and related information.
+   *
+   * The event follows CloudEvents v1.0 specification and is persisted in NATS JetStream
+   * for reliable delivery and event replay capabilities.
+   *
+   * @operationId eventSystemNetworkStatusChanged
+   */
+  "nova.v2.events.system.network.status.changed": NetworkStatusChangedEvent
+  /**
+   * Cell Created
+   *
+   * Publishes an event when a cell foundation release is created.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventCellCreated
+   */
+  "nova.v2.events.cells.{cell}.created": CellCreatedEvent
+  /**
+   * Cell Updated
+   *
+   * Publishes an event when a cell foundation release is updated.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventCellUpdated
+   */
+  "nova.v2.events.cells.{cell}.updated": CellUpdatedEvent
+  /**
+   * Cell Deleted
+   *
+   * Publishes an event when a cell foundation release is deleted.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventCellDeleted
+   */
+  "nova.v2.events.cells.{cell}.deleted": CellDeletedEvent
+  /**
+   * App Created
+   *
+   * Publishes an event when an app release is created in a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventAppCreated
+   */
+  "nova.v2.events.cells.{cell}.apps.{app}.created": AppCreatedEvent
+  /**
+   * App Updated
+   *
+   * Publishes an event when an app release is updated in a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventAppUpdated
+   */
+  "nova.v2.events.cells.{cell}.apps.{app}.updated": AppUpdatedEvent
+  /**
+   * App Deleted
+   *
+   * Publishes an event when an app release is deleted from a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventAppDeleted
+   */
+  "nova.v2.events.cells.{cell}.apps.{app}.deleted": AppDeletedEvent
+  /**
+   * Robot Controller Created
+   *
+   * Publishes an event when a robot controller release is created in a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventRobotControllerCreated
+   */
+  "nova.v2.events.cells.{cell}.controllers.{controller}.created": RobotControllerCreatedEvent
+  /**
+   * Robot Controller Updated
+   *
+   * Publishes an event when a robot controller release is updated in a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventRobotControllerUpdated
+   */
+  "nova.v2.events.cells.{cell}.controllers.{controller}.updated": RobotControllerUpdatedEvent
+  /**
+   * Robot Controller Deleted
+   *
+   * Publishes an event when a robot controller release is deleted from a cell.
+   *
+   * The event follows CloudEvents v1.0 and is persisted in NATS JetStream for reliable delivery and replay capabilities.
+   *
+   * @operationId eventRobotControllerDeleted
+   */
+  "nova.v2.events.cells.{cell}.controllers.{controller}.deleted": RobotControllerDeletedEvent
+}
+
+export type NatsPublishSubject = keyof NatsPublishPayloads