@cobotar/protocol 0.18.18 → 0.18.20

package/README.md

@@ -1,7 +1,7 @@
 # CobotAR-Protocol
 A collection of protobuf messages for the CobotAR-project
 
-Current version: 0.18.18
+Current version: 0.18.20
 
 ## Documentation
 Find it here: [documentation/README.md](documentation/README.md)

package/lib/capability/v1/actor_skill_pb.ts

@@ -213,6 +213,23 @@ export const SkillLevelSchema: GenEnum<SkillLevel> = /*@__PURE__*/
   enumDesc(file_capability_v1_actor_skill, 0);
 
 /**
+ * SkillStatus describes the current usability of an actor's skill.
+ *
+ * The status is operational and should be interpreted together with the
+ * associated policy, validity timestamps, and any derived restrictions.
+ *
+ * Typical semantics:
+ * - ACTIVE      -> skill is fully usable
+ * - RESTRICTED  -> skill is usable, but only under additional runtime
+ *                  safeguards such as AR guidance, extra validation,
+ *                  supervision, or other assistance
+ * - EXPIRED     -> skill is no longer valid and must not be used
+ *
+ * Loaders and runtime planners should therefore treat:
+ * - ACTIVE     -> feasible
+ * - RESTRICTED -> feasible with restrictions
+ * - EXPIRED    -> infeasible
+ *
  * @generated from enum capability.v1.SkillStatus
  */
 export enum SkillStatus {
@@ -222,16 +239,28 @@ export enum SkillStatus {
   UNSPECIFIED = 0,
 
   /**
+   * Skill is valid and can be used normally.
+   *
    * @generated from enum value: SKILL_STATUS_ACTIVE = 1;
    */
   ACTIVE = 1,
 
   /**
+   * Skill is allowed but restricted. The actor may perform the task but additional safeguards
+   *
+   * Examples:
+   * - AR guidance required
+   * - manual confirmation required
+   * - second check required
+   * - supervisor approval required
+   *
    * @generated from enum value: SKILL_STATUS_RESTRICTED = 2;
    */
   RESTRICTED = 2,
 
   /**
+   * Skill is no longer valid and cannot be used.
+   *
    * @generated from enum value: SKILL_STATUS_EXPIRED = 3;
    */
   EXPIRED = 3,

package/lib/capability/v1/tool_requirement_pb.ts

@@ -15,16 +15,16 @@ import type { Message } from "@bufbuild/protobuf";
  * Describes the file capability/v1/tool_requirement.proto.
  */
 export const file_capability_v1_tool_requirement: GenFile = /*@__PURE__*/
-  fileDesc("CiRjYXBhYmlsaXR5L3YxL3Rvb2xfcmVxdWlyZW1lbnQucHJvdG8SDWNhcGFiaWxpdHkudjEi7gEKD1Rvb2xSZXF1aXJlbWVudBIvCgRyb2xlGAEgASgOMhcuY2FwYWJpbGl0eS52MS5Ub29sUm9sZUIIukgFggECEAESRwoTcmVxdWlyZWRfcHJvcGVydGllcxgCIAMoDjIbLmNhcGFiaWxpdHkudjEuVG9vbFByb3BlcnR5Qg26SAqSAQciBYIBAhABEjwKEm1pbmltdW1fY2FwYWJpbGl0eRgDIAEoCzIgLmNhcGFiaWxpdHkudjEuQ2FwYWJpbGl0eVByb2ZpbGUSIwobYWxsb3dlZF90b29sX2RlZmluaXRpb25faWRzGAQgAygJKu8BCgxUb29sUHJvcGVydHkSHQoZVE9PTF9QUk9QRVJUWV9VTlNQRUNJRklFRBAAEiMKH1RPT0xfUFJPUEVSVFlfVE9SUVVFX0NPTlRST0xMRUQQARIaChZUT09MX1BST1BFUlRZX0VTRF9TQUZFEAISGwoXVE9PTF9QUk9QRVJUWV9JTlNVTEFURUQQAxIkCiBUT09MX1BST1BFUlRZX0NPTExBQk9SQVRJVkVfU0FGRRAEEhwKGFRPT0xfUFJPUEVSVFlfQ0FMSUJSQVRFRBAFEh4KGlRPT0xfUFJPUEVSVFlfUVVJQ0tfQ0hBTkdFEAZCyAEKEWNvbS5jYXBhYmlsaXR5LnYxQhRUb29sUmVxdWlyZW1lbnRQcm90b1ABWj9naXRodWIuY29tL2NvYm90YXIvcHJvdG9jb2wvbWVzc2FnZXMvY2FwYWJpbGl0eS92MTtjYXBhYmlsaXR5djGiAgNDWFiqAhZNZXNzYWdlcy5DYXBhYmlsaXR5LlYxygINQ2FwYWJpbGl0eVxWMeICGUNhcGFiaWxpdHlcVjFcR1BCTWV0YWRhdGHqAg5DYXBhYmlsaXR5OjpWMWIGcHJvdG8z", [file_buf_validate_validate, file_capability_v1_capability_profile, file_capability_v1_skill_definition]);
+  fileDesc("CiRjYXBhYmlsaXR5L3YxL3Rvb2xfcmVxdWlyZW1lbnQucHJvdG8SDWNhcGFiaWxpdHkudjEi9AEKD1Rvb2xSZXF1aXJlbWVudBI1CgVyb2xlcxgBIAMoDjIXLmNhcGFiaWxpdHkudjEuVG9vbFJvbGVCDbpICpIBByIFggECEAESRwoTcmVxdWlyZWRfcHJvcGVydGllcxgCIAMoDjIbLmNhcGFiaWxpdHkudjEuVG9vbFByb3BlcnR5Qg26SAqSAQciBYIBAhABEjwKEm1pbmltdW1fY2FwYWJpbGl0eRgDIAEoCzIgLmNhcGFiaWxpdHkudjEuQ2FwYWJpbGl0eVByb2ZpbGUSIwobYWxsb3dlZF90b29sX2RlZmluaXRpb25faWRzGAQgAygJKu8BCgxUb29sUHJvcGVydHkSHQoZVE9PTF9QUk9QRVJUWV9VTlNQRUNJRklFRBAAEiMKH1RPT0xfUFJPUEVSVFlfVE9SUVVFX0NPTlRST0xMRUQQARIaChZUT09MX1BST1BFUlRZX0VTRF9TQUZFEAISGwoXVE9PTF9QUk9QRVJUWV9JTlNVTEFURUQQAxIkCiBUT09MX1BST1BFUlRZX0NPTExBQk9SQVRJVkVfU0FGRRAEEhwKGFRPT0xfUFJPUEVSVFlfQ0FMSUJSQVRFRBAFEh4KGlRPT0xfUFJPUEVSVFlfUVVJQ0tfQ0hBTkdFEAZCyAEKEWNvbS5jYXBhYmlsaXR5LnYxQhRUb29sUmVxdWlyZW1lbnRQcm90b1ABWj9naXRodWIuY29tL2NvYm90YXIvcHJvdG9jb2wvbWVzc2FnZXMvY2FwYWJpbGl0eS92MTtjYXBhYmlsaXR5djGiAgNDWFiqAhZNZXNzYWdlcy5DYXBhYmlsaXR5LlYxygINQ2FwYWJpbGl0eVxWMeICGUNhcGFiaWxpdHlcVjFcR1BCTWV0YWRhdGHqAg5DYXBhYmlsaXR5OjpWMWIGcHJvdG8z", [file_buf_validate_validate, file_capability_v1_capability_profile, file_capability_v1_skill_definition]);
 
 /**
  * @generated from message capability.v1.ToolRequirement
  */
 export type ToolRequirement = Message<"capability.v1.ToolRequirement"> & {
   /**
-   * @generated from field: capability.v1.ToolRole role = 1;
+   * @generated from field: repeated capability.v1.ToolRole roles = 1;
    */
-  role: ToolRole;
+  roles: ToolRole[];
 
   /**
    * @generated from field: repeated capability.v1.ToolProperty required_properties = 2;

package/lib/resources/v1/cell_definition_pb.ts

@@ -2,19 +2,36 @@
 // @generated from file resources/v1/cell_definition.proto (package resources.v1, syntax proto3)
 /* eslint-disable */
 
-import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
-import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_buf_validate_validate } from "../../buf/validate/validate_pb.ts";
 import type { CustomProperties } from "../../common/v1/custom_properties_pb.ts";
 import { file_common_v1_custom_properties } from "../../common/v1/custom_properties_pb.ts";
+import type { LocalizedPose } from "../../geometry/v1/pose_pb.ts";
+import { file_geometry_v1_pose } from "../../geometry/v1/pose_pb.ts";
+import { file_validation_v1_predefined_string_rules } from "../../validation/v1/predefined_string_rules_pb.ts";
 import type { Message } from "@bufbuild/protobuf";
 
 /**
  * Describes the file resources/v1/cell_definition.proto.
  */
 export const file_resources_v1_cell_definition: GenFile = /*@__PURE__*/
-  fileDesc("CiJyZXNvdXJjZXMvdjEvY2VsbF9kZWZpbml0aW9uLnByb3RvEgxyZXNvdXJjZXMudjEijwEKDkNlbGxEZWZpbml0aW9uEgoKAmlkGAEgASgJEgwKBG5hbWUYAiABKAkSEwoLZGVzY3JpcHRpb24YAyABKAkSDAoEaWNvbhgEIAEoCRITCgtzdGF0aW9uX2lkcxgFIAMoCRIrCgZjdXN0b20YBiABKAsyGy5jb21tb24udjEuQ3VzdG9tUHJvcGVydGllcyI+Cg9DZWxsRGVmaW5pdGlvbnMSKwoFaXRlbXMYASADKAsyHC5yZXNvdXJjZXMudjEuQ2VsbERlZmluaXRpb25CwAEKEGNvbS5yZXNvdXJjZXMudjFCE0NlbGxEZWZpbml0aW9uUHJvdG9QAVo9Z2l0aHViLmNvbS9jb2JvdGFyL3Byb3RvY29sL21lc3NhZ2VzL3Jlc291cmNlcy92MTtyZXNvdXJjZXN2MaICA1JYWKoCFU1lc3NhZ2VzLlJlc291cmNlcy5WMcoCDFJlc291cmNlc1xWMeICGFJlc291cmNlc1xWMVxHUEJNZXRhZGF0YeoCDVJlc291cmNlczo6VjFiBnByb3RvMw", [file_common_v1_custom_properties]);
+  fileDesc("CiJyZXNvdXJjZXMvdjEvY2VsbF9kZWZpbml0aW9uLnByb3RvEgxyZXNvdXJjZXMudjEi5gMKDkNlbGxEZWZpbml0aW9uEgoKAmlkGAEgASgJEhcKBG5hbWUYAiABKAlCCbpIBnIEgPEEARITCgtkZXNjcmlwdGlvbhgDIAEoCRIMCgRpY29uGAQgASgJEhMKC3N0YXRpb25faWRzGAUgAygJEjIKBnN0YXR1cxgGIAEoDjIYLnJlc291cmNlcy52MS5DZWxsU3RhdHVzQgi6SAWCAQIQARIpChhtYXhfY29uY3VycmVudF9wcm9jZXNzZXMYByABKAVCB7pIBBoCKAASHAoUYWxsb3dfcXVldWVkX3Byb2Nlc3MYCCABKAgSGQoRdG9vbF9pbnN0YW5jZV9pZHMYCSADKAkSHgoWY29udGFpbmVyX2luc3RhbmNlX2lkcxgKIAMoCRIaChJyb2JvdF9pbnN0YW5jZV9pZHMYCyADKAkSGgoSYXNzZXRfaW5zdGFuY2VfaWRzGAwgAygJEhsKE21hcmtlcl9pbnN0YW5jZV9pZHMYDSADKAkSEgoKd29ya2VyX2lkcxgOIAMoCRIpCgVmcmFtZRgPIAEoCzIaLmdlb21ldHJ5LnYxLkxvY2FsaXplZFBvc2USKwoGY3VzdG9tGBAgASgLMhsuY29tbW9uLnYxLkN1c3RvbVByb3BlcnRpZXMiPgoPQ2VsbERlZmluaXRpb25zEisKBWl0ZW1zGAEgAygLMhwucmVzb3VyY2VzLnYxLkNlbGxEZWZpbml0aW9uKoYBCgpDZWxsU3RhdHVzEhsKF0NFTExfU1RBVFVTX1VOU1BFQ0lGSUVEEAASFAoQQ0VMTF9TVEFUVVNfT1BFThABEhQKEENFTExfU1RBVFVTX0JVU1kQAhIWChJDRUxMX1NUQVRVU19DTE9TRUQQAxIXChNDRUxMX1NUQVRVU19CTE9DS0VEEARCwAEKEGNvbS5yZXNvdXJjZXMudjFCE0NlbGxEZWZpbml0aW9uUHJvdG9QAVo9Z2l0aHViLmNvbS9jb2JvdGFyL3Byb3RvY29sL21lc3NhZ2VzL3Jlc291cmNlcy92MTtyZXNvdXJjZXN2MaICA1JYWKoCFU1lc3NhZ2VzLlJlc291cmNlcy5WMcoCDFJlc291cmNlc1xWMeICGFJlc291cmNlc1xWMVxHUEJNZXRhZGF0YeoCDVJlc291cmNlczo6VjFiBnByb3RvMw", [file_buf_validate_validate, file_common_v1_custom_properties, file_geometry_v1_pose, file_validation_v1_predefined_string_rules]);
 
 /**
+ * CellDefinition describes an operational grouping of stations and shared
+ * resources inside a line.
+ *
+ * A cell is useful when multiple stations share workers, robots, assets,
+ * safety boundaries, or scheduling constraints. It gives the model a clear
+ * middle layer between line-level routing and station-level execution.
+ *
+ * Typical cell responsibilities:
+ * - group stations into a shared execution/safety zone
+ * - own resources that are shared across several stations
+ * - expose operational state and capacity above individual stations
+ * - act as an optional target/selector scope for loaders and planners
+ *
  * @generated from message resources.v1.CellDefinition
  */
 export type CellDefinition = Message<"resources.v1.CellDefinition"> & {
@@ -39,12 +56,84 @@ export type CellDefinition = Message<"resources.v1.CellDefinition"> & {
   icon: string;
 
   /**
+   * Stations belonging to this cell.
+   *
    * @generated from field: repeated string station_ids = 5;
    */
   stationIds: string[];
 
   /**
-   * @generated from field: common.v1.CustomProperties custom = 6;
+   * Current operational availability of the cell as a whole.
+   *
+   * @generated from field: resources.v1.CellStatus status = 6;
+   */
+  status: CellStatus;
+
+  /**
+   * Maximum number of active/queued processes this cell should host concurrently.
+   *
+   * @generated from field: int32 max_concurrent_processes = 7;
+   */
+  maxConcurrentProcesses: number;
+
+  /**
+   * If true, loaders may create queued ProcessRuns when the cell is BUSY.
+   *
+   * @generated from field: bool allow_queued_process = 8;
+   */
+  allowQueuedProcess: boolean;
+
+  /**
+   * Shared tools mounted, parked, or otherwise directly available here.
+   *
+   * @generated from field: repeated string tool_instance_ids = 9;
+   */
+  toolInstanceIds: string[];
+
+  /**
+   * Shared fixtures, trays, pallets, bins, or other concrete containers.
+   *
+   * @generated from field: repeated string container_instance_ids = 10;
+   */
+  containerInstanceIds: string[];
+
+  /**
+   * Robots shared across multiple stations inside the cell.
+   *
+   * @generated from field: repeated string robot_instance_ids = 11;
+   */
+  robotInstanceIds: string[];
+
+  /**
+   * Shared assets such as cameras, HMIs, or feeders serving several stations.
+   *
+   * @generated from field: repeated string asset_instance_ids = 12;
+   */
+  assetInstanceIds: string[];
+
+  /**
+   * Markers shared for this cell for localization, AR anchoring, or identification.
+   *
+   * @generated from field: repeated string marker_instance_ids = 13;
+   */
+  markerInstanceIds: string[];
+
+  /**
+   * Shared worker pool for the cell when workers are not bound to a specific station.
+   *
+   * @generated from field: repeated string worker_ids = 14;
+   */
+  workerIds: string[];
+
+  /**
+   * Cell-local reference frame or zone anchor.
+   *
+   * @generated from field: geometry.v1.LocalizedPose frame = 15;
+   */
+  frame?: LocalizedPose;
+
+  /**
+   * @generated from field: common.v1.CustomProperties custom = 16;
    */
   custom?: CustomProperties;
 };
@@ -73,3 +162,65 @@ export type CellDefinitions = Message<"resources.v1.CellDefinitions"> & {
 export const CellDefinitionsSchema: GenMessage<CellDefinitions> = /*@__PURE__*/
   messageDesc(file_resources_v1_cell_definition, 1);
 
+/**
+ * CellStatus describes whether a cell can currently accept or host work.
+ *
+ * A cell is typically a grouping of stations and related resources. The loader
+ * can use this status to quickly reject or prefer a cell before evaluating
+ * individual stations.
+ *
+ * Status should be interpreted as:
+ * - OPEN    -> cell can accept new work now
+ * - BUSY    -> cell is occupied; queueing may still be possible
+ * - CLOSED  -> cell is intentionally unavailable
+ * - BLOCKED -> cell is unavailable due to fault, safety state, maintenance,
+ *              or other blocking condition
+ *
+ * This field is operational and should be considered together with
+ * max_concurrent_processes and the status of contained stations.
+ *
+ * @generated from enum resources.v1.CellStatus
+ */
+export enum CellStatus {
+  /**
+   * @generated from enum value: CELL_STATUS_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Cell can accept new work now.
+   *
+   * @generated from enum value: CELL_STATUS_OPEN = 1;
+   */
+  OPEN = 1,
+
+  /**
+   * Cell is currently occupied by one or more active runs.
+   * Depending on policy, new runs may still be queued.
+   *
+   * @generated from enum value: CELL_STATUS_BUSY = 2;
+   */
+  BUSY = 2,
+
+  /**
+   * Cell is intentionally unavailable for loading or running work.
+   *
+   * @generated from enum value: CELL_STATUS_CLOSED = 3;
+   */
+  CLOSED = 3,
+
+  /**
+   * Cell is temporarily unavailable due to fault, interlock,
+   * maintenance state, or similar blocking condition.
+   *
+   * @generated from enum value: CELL_STATUS_BLOCKED = 4;
+   */
+  BLOCKED = 4,
+}
+
+/**
+ * Describes the enum resources.v1.CellStatus.
+ */
+export const CellStatusSchema: GenEnum<CellStatus> = /*@__PURE__*/
+  enumDesc(file_resources_v1_cell_definition, 0);
+

package/lib/resources/v1/line_definition_pb.ts

@@ -0,0 +1,199 @@
+// @generated by protoc-gen-es v2.10.2 with parameter "target=ts,import_extension=ts"
+// @generated from file resources/v1/line_definition.proto (package resources.v1, syntax proto3)
+/* eslint-disable */
+
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_buf_validate_validate } from "../../buf/validate/validate_pb.ts";
+import type { CustomProperties } from "../../common/v1/custom_properties_pb.ts";
+import { file_common_v1_custom_properties } from "../../common/v1/custom_properties_pb.ts";
+import { file_validation_v1_predefined_string_rules } from "../../validation/v1/predefined_string_rules_pb.ts";
+import type { Message } from "@bufbuild/protobuf";
+
+/**
+ * Describes the file resources/v1/line_definition.proto.
+ */
+export const file_resources_v1_line_definition: GenFile = /*@__PURE__*/
+  fileDesc("CiJyZXNvdXJjZXMvdjEvbGluZV9kZWZpbml0aW9uLnByb3RvEgxyZXNvdXJjZXMudjEivwIKDkxpbmVEZWZpbml0aW9uEhgKAmlkGAEgASgJQgy6SAnIAQFyBKjyBAESFwoEbmFtZRgCIAEoCUIJukgGcgSA8QQBEhMKC2Rlc2NyaXB0aW9uGAMgASgJEgwKBGljb24YBCABKAkSJAoEdHlwZRgFIAEoDjIWLnJlc291cmNlcy52MS5MaW5lVHlwZRIyCgZzdGF0dXMYBiABKA4yGC5yZXNvdXJjZXMudjEuTGluZVN0YXR1c0IIukgFggECEAESKQoYbWF4X2NvbmN1cnJlbnRfcHJvY2Vzc2VzGAcgASgFQge6SAQaAigAEhAKCGNlbGxfaWRzGAggAygJEhMKC3N0YXRpb25faWRzGAkgAygJEisKBmN1c3RvbRgKIAEoCzIbLmNvbW1vbi52MS5DdXN0b21Qcm9wZXJ0aWVzIj4KD0xpbmVEZWZpbml0aW9ucxIrCgVpdGVtcxgBIAMoCzIcLnJlc291cmNlcy52MS5MaW5lRGVmaW5pdGlvbiolCghMaW5lVHlwZRIZChVMSU5FX1RZUEVfVU5TUEVDSUZJRUQQACqGAQoKTGluZVN0YXR1cxIbChdMSU5FX1NUQVRVU19VTlNQRUNJRklFRBAAEhQKEExJTkVfU1RBVFVTX09QRU4QARIUChBMSU5FX1NUQVRVU19CVVNZEAISFgoSTElORV9TVEFUVVNfQ0xPU0VEEAMSFwoTTElORV9TVEFUVVNfQkxPQ0tFRBAEQsABChBjb20ucmVzb3VyY2VzLnYxQhNMaW5lRGVmaW5pdGlvblByb3RvUAFaPWdpdGh1Yi5jb20vY29ib3Rhci9wcm90b2NvbC9tZXNzYWdlcy9yZXNvdXJjZXMvdjE7cmVzb3VyY2VzdjGiAgNSWFiqAhVNZXNzYWdlcy5SZXNvdXJjZXMuVjHKAgxSZXNvdXJjZXNcVjHiAhhSZXNvdXJjZXNcVjFcR1BCTWV0YWRhdGHqAg1SZXNvdXJjZXM6OlYxYgZwcm90bzM", [file_buf_validate_validate, file_common_v1_custom_properties, file_validation_v1_predefined_string_rules]);
+
+/**
+ * LineDefinition describes the highest operational routing context for loading
+ * and dispatching work.
+ *
+ * A line groups cells and/or stations into a production area that can be
+ * targeted by ProcessLoadRequest. Loaders typically resolve a concrete cell and
+ * station within the selected line.
+ *
+ * Typical line responsibilities:
+ * - act as the top-level routing target for process loading
+ * - expose high-level operational status and capacity
+ * - contain one or more cells and/or directly attached stations
+ * - provide a coarse operational boundary for planning and dispatch
+ *
+ * @generated from message resources.v1.LineDefinition
+ */
+export type LineDefinition = Message<"resources.v1.LineDefinition"> & {
+  /**
+   * @generated from field: string id = 1;
+   */
+  id: string;
+
+  /**
+   * @generated from field: string name = 2;
+   */
+  name: string;
+
+  /**
+   * @generated from field: string description = 3;
+   */
+  description: string;
+
+  /**
+   * @generated from field: string icon = 4;
+   */
+  icon: string;
+
+  /**
+   * Broad line classification. Keep optional until concrete line types are introduced.
+   *
+   * @generated from field: resources.v1.LineType type = 5;
+   */
+  type: LineType;
+
+  /**
+   * Current operational availability of the line as a whole.
+   *
+   * @generated from field: resources.v1.LineStatus status = 6;
+   */
+  status: LineStatus;
+
+  /**
+   * Maximum number of active/queued processes this line should host concurrently.
+   *
+   * @generated from field: int32 max_concurrent_processes = 7;
+   */
+  maxConcurrentProcesses: number;
+
+  /**
+   * Cells belonging to this line.
+   *
+   * @generated from field: repeated string cell_ids = 8;
+   */
+  cellIds: string[];
+
+  /**
+   * Optional directly attached stations when a line references stations without an intermediate cell.
+   *
+   * @generated from field: repeated string station_ids = 9;
+   */
+  stationIds: string[];
+
+  /**
+   * @generated from field: common.v1.CustomProperties custom = 10;
+   */
+  custom?: CustomProperties;
+};
+
+/**
+ * Describes the message resources.v1.LineDefinition.
+ * Use `create(LineDefinitionSchema)` to create a new message.
+ */
+export const LineDefinitionSchema: GenMessage<LineDefinition> = /*@__PURE__*/
+  messageDesc(file_resources_v1_line_definition, 0);
+
+/**
+ * @generated from message resources.v1.LineDefinitions
+ */
+export type LineDefinitions = Message<"resources.v1.LineDefinitions"> & {
+  /**
+   * @generated from field: repeated resources.v1.LineDefinition items = 1;
+   */
+  items: LineDefinition[];
+};
+
+/**
+ * Describes the message resources.v1.LineDefinitions.
+ * Use `create(LineDefinitionsSchema)` to create a new message.
+ */
+export const LineDefinitionsSchema: GenMessage<LineDefinitions> = /*@__PURE__*/
+  messageDesc(file_resources_v1_line_definition, 1);
+
+/**
+ * @generated from enum resources.v1.LineType
+ */
+export enum LineType {
+  /**
+   * @generated from enum value: LINE_TYPE_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+}
+
+/**
+ * Describes the enum resources.v1.LineType.
+ */
+export const LineTypeSchema: GenEnum<LineType> = /*@__PURE__*/
+  enumDesc(file_resources_v1_line_definition, 0);
+
+/**
+ * LineStatus describes whether a production line can currently accept work.
+ *
+ * A line is a higher-level operational grouping of cells and/or stations.
+ * The loader can use this status as an early gate before checking specific
+ * cells, stations, and resources.
+ *
+ * Status should be interpreted as:
+ * - OPEN    -> line can accept new work now
+ * - BUSY    -> line is operational but currently occupied; queueing may still
+ *              be allowed
+ * - CLOSED  -> line is intentionally unavailable
+ * - BLOCKED -> line is unavailable due to fault, safety state, maintenance,
+ *              or similar blocking condition
+ *
+ * This field is operational and should be considered together with
+ * max_concurrent_processes and the statuses of child cells/stations.
+ *
+ * @generated from enum resources.v1.LineStatus
+ */
+export enum LineStatus {
+  /**
+   * @generated from enum value: LINE_STATUS_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Line can accept new work now.
+   *
+   * @generated from enum value: LINE_STATUS_OPEN = 1;
+   */
+  OPEN = 1,
+
+  /**
+   * Line is currently occupied by one or more active runs.
+   * Depending on policy, new runs may still be queued.
+   *
+   * @generated from enum value: LINE_STATUS_BUSY = 2;
+   */
+  BUSY = 2,
+
+  /**
+   * Line is intentionally unavailable for loading or running work.
+   *
+   * @generated from enum value: LINE_STATUS_CLOSED = 3;
+   */
+  CLOSED = 3,
+
+  /**
+   * Line is temporarily unavailable due to fault, interlock,
+   * maintenance state, or similar blocking condition.
+   *
+   * @generated from enum value: LINE_STATUS_BLOCKED = 4;
+   */
+  BLOCKED = 4,
+}
+
+/**
+ * Describes the enum resources.v1.LineStatus.
+ */
+export const LineStatusSchema: GenEnum<LineStatus> = /*@__PURE__*/
+  enumDesc(file_resources_v1_line_definition, 1);
+

package/lib/resources/v1/station_definition_pb.ts

@@ -16,9 +16,21 @@ import type { Message } from "@bufbuild/protobuf";
  * Describes the file resources/v1/station_definition.proto.
  */
 export const file_resources_v1_station_definition: GenFile = /*@__PURE__*/
-  fileDesc("CiVyZXNvdXJjZXMvdjEvc3RhdGlvbl9kZWZpbml0aW9uLnByb3RvEgxyZXNvdXJjZXMudjEiigMKEVN0YXRpb25EZWZpbml0aW9uEgoKAmlkGAEgASgJEhcKBG5hbWUYAiABKAlCCbpIBnIEgPEEARITCgtkZXNjcmlwdGlvbhgDIAEoCRIMCgRpY29uGAQgASgJEjEKBHR5cGUYBSABKA4yGS5yZXNvdXJjZXMudjEuU3RhdGlvblR5cGVCCLpIBYIBAhABEhkKEXRvb2xfaW5zdGFuY2VfaWRzGAYgAygJEh4KFmNvbnRhaW5lcl9pbnN0YW5jZV9pZHMYByADKAkSGgoScm9ib3RfaW5zdGFuY2VfaWRzGAggAygJEhoKEmFzc2V0X2luc3RhbmNlX2lkcxgJIAMoCRIbChNtYXJrZXJfaW5zdGFuY2VfaWRzGAogAygJEhIKCndvcmtlcl9pZHMYCyADKAkSKQoFZnJhbWUYDCABKAsyGi5nZW9tZXRyeS52MS5Mb2NhbGl6ZWRQb3NlEisKBmN1c3RvbRgNIAEoCzIbLmNvbW1vbi52MS5DdXN0b21Qcm9wZXJ0aWVzIkQKElN0YXRpb25EZWZpbml0aW9ucxIuCgVpdGVtcxgBIAMoCzIfLnJlc291cmNlcy52MS5TdGF0aW9uRGVmaW5pdGlvbiqrAQoLU3RhdGlvblR5cGUSHAoYU1RBVElPTl9UWVBFX1VOU1BFQ0lGSUVEEAASGAoUU1RBVElPTl9UWVBFX1NUT1JBR0UQARIfChtTVEFUSU9OX1RZUEVfTUFOVUFMX1NUQVRJT04QAhIiCh5TVEFUSU9OX1RZUEVfQVVUT01BVElDX1NUQVRJT04QAxIfChtTVEFUSU9OX1RZUEVfSFlCUklEX1NUQVRJT04QBELDAQoQY29tLnJlc291cmNlcy52MUIWU3RhdGlvbkRlZmluaXRpb25Qcm90b1ABWj1naXRodWIuY29tL2NvYm90YXIvcHJvdG9jb2wvbWVzc2FnZXMvcmVzb3VyY2VzL3YxO3Jlc291cmNlc3YxogIDUlhYqgIVTWVzc2FnZXMuUmVzb3VyY2VzLlYxygIMUmVzb3VyY2VzXFYx4gIYUmVzb3VyY2VzXFYxXEdQQk1ldGFkYXRh6gINUmVzb3VyY2VzOjpWMWIGcHJvdG8z", [file_buf_validate_validate, file_common_v1_custom_properties, file_geometry_v1_pose, file_validation_v1_predefined_string_rules]);
+  fileDesc("CiVyZXNvdXJjZXMvdjEvc3RhdGlvbl9kZWZpbml0aW9uLnByb3RvEgxyZXNvdXJjZXMudjEiigQKEVN0YXRpb25EZWZpbml0aW9uEgoKAmlkGAEgASgJEhcKBG5hbWUYAiABKAlCCbpIBnIEgPEEARITCgtkZXNjcmlwdGlvbhgDIAEoCRIMCgRpY29uGAQgASgJEjEKBHR5cGUYBSABKA4yGS5yZXNvdXJjZXMudjEuU3RhdGlvblR5cGVCCLpIBYIBAhABEjUKBnN0YXR1cxgGIAEoDjIbLnJlc291cmNlcy52MS5TdGF0aW9uU3RhdHVzQgi6SAWCAQIQARIpChhtYXhfY29uY3VycmVudF9wcm9jZXNzZXMYByABKAVCB7pIBBoCKAASHAoUYWxsb3dfcXVldWVkX3Byb2Nlc3MYCCABKAgSGQoRdG9vbF9pbnN0YW5jZV9pZHMYCSADKAkSHgoWY29udGFpbmVyX2luc3RhbmNlX2lkcxgKIAMoCRIaChJyb2JvdF9pbnN0YW5jZV9pZHMYCyADKAkSGgoSYXNzZXRfaW5zdGFuY2VfaWRzGAwgAygJEhsKE21hcmtlcl9pbnN0YW5jZV9pZHMYDSADKAkSEgoKd29ya2VyX2lkcxgOIAMoCRIpCgVmcmFtZRgPIAEoCzIaLmdlb21ldHJ5LnYxLkxvY2FsaXplZFBvc2USKwoGY3VzdG9tGBAgASgLMhsuY29tbW9uLnYxLkN1c3RvbVByb3BlcnRpZXMiRAoSU3RhdGlvbkRlZmluaXRpb25zEi4KBWl0ZW1zGAEgAygLMh8ucmVzb3VyY2VzLnYxLlN0YXRpb25EZWZpbml0aW9uKqsBCgtTdGF0aW9uVHlwZRIcChhTVEFUSU9OX1RZUEVfVU5TUEVDSUZJRUQQABIYChRTVEFUSU9OX1RZUEVfU1RPUkFHRRABEh8KG1NUQVRJT05fVFlQRV9NQU5VQUxfU1RBVElPThACEiIKHlNUQVRJT05fVFlQRV9BVVRPTUFUSUNfU1RBVElPThADEh8KG1NUQVRJT05fVFlQRV9IWUJSSURfU1RBVElPThAEKpgBCg1TdGF0aW9uU3RhdHVzEh4KGlNUQVRJT05fU1RBVFVTX1VOU1BFQ0lGSUVEEAASFwoTU1RBVElPTl9TVEFUVVNfT1BFThABEhcKE1NUQVRJT05fU1RBVFVTX0JVU1kQAhIZChVTVEFUSU9OX1NUQVRVU19DTE9TRUQQAxIaChZTVEFUSU9OX1NUQVRVU19CTE9DS0VEEARCwwEKEGNvbS5yZXNvdXJjZXMudjFCFlN0YXRpb25EZWZpbml0aW9uUHJvdG9QAVo9Z2l0aHViLmNvbS9jb2JvdGFyL3Byb3RvY29sL21lc3NhZ2VzL3Jlc291cmNlcy92MTtyZXNvdXJjZXN2MaICA1JYWKoCFU1lc3NhZ2VzLlJlc291cmNlcy5WMcoCDFJlc291cmNlc1xWMeICGFJlc291cmNlc1xWMVxHUEJNZXRhZGF0YeoCDVJlc291cmNlczo6VjFiBnByb3RvMw", [file_buf_validate_validate, file_common_v1_custom_properties, file_geometry_v1_pose, file_validation_v1_predefined_string_rules]);
 
 /**
+ * StationDefinition describes a concrete execution point inside a cell or line.
+ *
+ * A station is the most specific location where work is typically loaded,
+ * queued, executed, and tracked at runtime. Stations are therefore the primary
+ * target for task/resource matching in loader/planner logic.
+ *
+ * Typical station responsibilities:
+ * - host concrete task execution
+ * - own station-local tools, containers, robots, markers, and frame
+ * - expose operational state such as OPEN/BUSY/CLOSED/BLOCKED
+ * - optionally allow queueing when already occupied
+ *
  * @generated from message resources.v1.StationDefinition
  */
 export type StationDefinition = Message<"resources.v1.StationDefinition"> & {
@@ -43,51 +55,84 @@ export type StationDefinition = Message<"resources.v1.StationDefinition"> & {
   icon: string;
 
   /**
+   * Broad station classification, e.g. manual, automatic, or hybrid.
+   *
    * @generated from field: resources.v1.StationType type = 5;
    */
   type: StationType;
 
   /**
-   * @generated from field: repeated string tool_instance_ids = 6;
+   * Current operational availability used by loaders, planners, and UIs.
+   *
+   * @generated from field: resources.v1.StationStatus status = 6;
+   */
+  status: StationStatus;
+
+  /**
+   * Maximum number of active/queued processes this station should host concurrently.
+   *
+   * @generated from field: int32 max_concurrent_processes = 7;
+   */
+  maxConcurrentProcesses: number;
+
+  /**
+   * If true, loaders may create queued ProcessRuns when the station is BUSY.
+   *
+   * @generated from field: bool allow_queued_process = 8;
+   */
+  allowQueuedProcess: boolean;
+
+  /**
+   * Station-local tools mounted, parked, or otherwise directly available here.
+   *
+   * @generated from field: repeated string tool_instance_ids = 9;
    */
   toolInstanceIds: string[];
 
   /**
-   * @generated from field: repeated string container_instance_ids = 7;
+   * Station-local fixtures, trays, pallets, bins, or other concrete containers.
+   *
+   * @generated from field: repeated string container_instance_ids = 10;
    */
   containerInstanceIds: string[];
 
   /**
-   * @generated from field: repeated string robot_instance_ids = 8;
+   * Robots directly assigned to or executing within this station.
+   *
+   * @generated from field: repeated string robot_instance_ids = 11;
    */
   robotInstanceIds: string[];
 
   /**
-   * @generated from field: repeated string asset_instance_ids = 9;
+   * Station-local assets such as cameras, HMIs, feeders, or sensors.
+   *
+   * @generated from field: repeated string asset_instance_ids = 12;
    */
   assetInstanceIds: string[];
 
   /**
-   * move to cell?
+   * Markers used specifically at this station for localization, AR anchoring, or identification.
    *
-   * @generated from field: repeated string marker_instance_ids = 10;
+   * @generated from field: repeated string marker_instance_ids = 13;
    */
   markerInstanceIds: string[];
 
   /**
-   * move to cell?
+   * Workers explicitly assigned to this station. Use cell-level worker_ids for shared pools.
    *
-   * @generated from field: repeated string worker_ids = 11;
+   * @generated from field: repeated string worker_ids = 14;
    */
   workerIds: string[];
 
   /**
-   * @generated from field: geometry.v1.LocalizedPose frame = 12;
+   * Station-local reference frame used for runtime bindings, AR anchoring, and execution geometry.
+   *
+   * @generated from field: geometry.v1.LocalizedPose frame = 15;
    */
   frame?: LocalizedPose;
 
   /**
-   * @generated from field: common.v1.CustomProperties custom = 13;
+   * @generated from field: common.v1.CustomProperties custom = 16;
    */
   custom?: CustomProperties;
 };
@@ -152,3 +197,64 @@ export enum StationType {
 export const StationTypeSchema: GenEnum<StationType> = /*@__PURE__*/
   enumDesc(file_resources_v1_station_definition, 0);
 
+/**
+ * StationStatus describes whether a station can currently accept or execute work.
+ *
+ * This is an operational/runtime-oriented state used by loaders, planners,
+ * dispatchers, and UIs when deciding whether a ProcessRun can be started here.
+ *
+ * Status should be interpreted as:
+ * - OPEN    -> can accept new work now
+ * - BUSY    -> currently occupied; may still allow queueing
+ * - CLOSED  -> intentionally unavailable for new work
+ * - BLOCKED -> unavailable due to a fault, interlock, maintenance lock, or
+ *              other condition that should prevent execution
+ *
+ * A station may also expose capacity constraints through
+ * max_concurrent_processes, which is separate from this status field.
+ *
+ * @generated from enum resources.v1.StationStatus
+ */
+export enum StationStatus {
+  /**
+   * @generated from enum value: STATION_STATUS_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Station can accept new work now.
+   *
+   * @generated from enum value: STATION_STATUS_OPEN = 1;
+   */
+  OPEN = 1,
+
+  /**
+   * Station is currently occupied by one or more active runs.
+   * Depending on loader policy and allow_queued_process, new runs may be queued.
+   *
+   * @generated from enum value: STATION_STATUS_BUSY = 2;
+   */
+  BUSY = 2,
+
+  /**
+   * Station is intentionally unavailable for loading or running work.
+   *
+   * @generated from enum value: STATION_STATUS_CLOSED = 3;
+   */
+  CLOSED = 3,
+
+  /**
+   * Station is temporarily unavailable due to fault, safety interlock,
+   * maintenance state, missing prerequisite, or similar blocking condition.
+   *
+   * @generated from enum value: STATION_STATUS_BLOCKED = 4;
+   */
+  BLOCKED = 4,
+}
+
+/**
+ * Describes the enum resources.v1.StationStatus.
+ */
+export const StationStatusSchema: GenEnum<StationStatus> = /*@__PURE__*/
+  enumDesc(file_resources_v1_station_definition, 1);
+