@cobotar/protocol 0.18.10 → 0.18.12

package/README.md

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

package/lib/capability/v1/actor_skill_pb.ts

@@ -122,6 +122,14 @@ export const ActorSkillSchema: GenMessage<ActorSkill> = /*@__PURE__*/
   messageDesc(file_capability_v1_actor_skill, 1);
 
 /**
+ *
+ * Alternative categories:
+ * AWARE: Understands concept
+ * ASSISTED: Can perform with guidance
+ * COMPETENT: Can perform independently
+ * EXPERT: Can troubleshoot and optimize
+ * CERTIFIED: Officially qualified
+ *
  * @generated from enum capability.v1.SkillLevel
  */
 export enum SkillLevel {

package/lib/capability/v1/skill_definition_pb.ts

@@ -81,50 +81,142 @@ export const SkillDefinitionsSchema: GenMessage<SkillDefinitions> = /*@__PURE__*
   messageDesc(file_capability_v1_skill_definition, 1);
 
 /**
+ * SkillDomain classifies a skill according to the type of work it primarily
+ * represents. Domains are used for:
+ * - organizing skills in UIs and editors
+ * - filtering skills during task authoring
+ * - reasoning about capabilities during planning and assignment
+ *
+ * A domain does NOT define the exact operation itself (that is done by the
+ * skill), but rather the general category of work the skill belongs to.
+ *
+ * Domains should remain stable and relatively few in number, since they
+ * typically appear in filters, dashboards, and analytics.
+ *
  * @generated from enum capability.v1.SkillDomain
  */
 export enum SkillDomain {
   /**
+   * Default value when the domain is unknown or not yet assigned.
+   *
    * @generated from enum value: SKILL_DOMAIN_UNSPECIFIED = 0;
    */
   UNSPECIFIED = 0,
 
   /**
+   * General physical handling of parts, tools, or materials.
+   *
+   * Examples:
+   * - gripping or stabilizing a workpiece
+   * - positioning a component
+   * - moving or placing a part
+   * - cleaning or wiping surfaces
+   *
+   * This domain typically involves manipulation rather than modification.
+   *
    * @generated from enum value: SKILL_DOMAIN_HANDLING = 1;
    */
   HANDLING = 1,
 
   /**
+   * Mechanical assembly operations that combine components into an assembly.
+   *
+   * Examples:
+   * - inserting components
+   * - aligning parts
+   * - mounting subassemblies
+   * - press-fitting components
+   *
+   * Assembly usually precedes fastening or validation steps.
+   *
    * @generated from enum value: SKILL_DOMAIN_ASSEMBLY = 2;
    */
   ASSEMBLY = 2,
 
   /**
+   * Operations involving threaded fasteners or torque-controlled joining.
+   *
+   * Examples:
+   * - tightening bolts or screws
+   * - loosening fasteners
+   * - torque verification
+   *
+   * This domain is separated from general assembly because fastening
+   * frequently requires specialized tools, torque control, and validation.
+   *
    * @generated from enum value: SKILL_DOMAIN_FASTENING = 3;
    */
   FASTENING = 3,
 
   /**
+   * Inspection, verification, and quality assurance activities.
+   *
+   * Examples:
+   * - visual inspection
+   * - detecting part presence
+   * - measuring dimensions
+   * - verifying assembly completion
+   *
+   * These skills are often used for validation steps within processes.
+   *
    * @generated from enum value: SKILL_DOMAIN_INSPECTION = 4;
    */
   INSPECTION = 4,
 
   /**
+   * Tasks involving electrical or electronic components and systems.
+   *
+   * Examples:
+   * - connecting electrical components
+   * - handling ESD-sensitive parts
+   * - interacting with electrical assemblies or wiring
+   *
+   * This domain may impose additional safety or handling constraints.
+   *
    * @generated from enum value: SKILL_DOMAIN_ELECTRICAL = 5;
    */
   ELECTRICAL = 5,
 
   /**
+   * Skills related to coordination between multiple actors.
+   *
+   * Examples:
+   * - human–robot collaboration
+   * - synchronized operations
+   * - shared workspace interactions
+   *
+   * These skills are important when tasks involve cooperation between
+   * humans, robots, or automated equipment.
+   *
    * @generated from enum value: SKILL_DOMAIN_COLLABORATION = 6;
    */
   COLLABORATION = 6,
 
   /**
+   * Safety-critical skills required to safely perform certain operations.
+   *
+   * Examples:
+   * - interacting with safety systems
+   * - operating within guarded environments
+   * - acknowledging safety procedures
+   *
+   * These skills may represent certifications or required training.
+   *
    * @generated from enum value: SKILL_DOMAIN_SAFETY = 7;
    */
   SAFETY = 7,
 
   /**
+   * Skills related to operating, supervising, or interacting with robots.
+   *
+   * Examples:
+   * - executing robot motion
+   * - supervising automated tasks
+   * - operating robot interfaces
+   *
+   * This domain is particularly relevant in human-robot collaboration
+   * environments.
+   *
    * @generated from enum value: SKILL_DOMAIN_ROBOT_OPERATION = 8;
    */
   ROBOT_OPERATION = 8,

package/lib/capability/v1/tool_requirement_pb.ts

@@ -15,7 +15,7 @@ import type { Message } from "@bufbuild/protobuf";
  * Describes the file capability/v1/tool_requirement.proto.
  */
 export const file_capability_v1_tool_requirement: GenFile = /*@__PURE__*/
-  fileDesc("CiRjYXBhYmlsaXR5L3YxL3Rvb2xfcmVxdWlyZW1lbnQucHJvdG8SDWNhcGFiaWxpdHkudjEi8QEKD1Rvb2xSZXF1aXJlbWVudBIyCgRyb2xlGAEgASgOMhcuY2FwYWJpbGl0eS52MS5Ub29sUm9sZUILukgIyAEBggECEAESRwoTcmVxdWlyZWRfcHJvcGVydGllcxgCIAMoDjIbLmNhcGFiaWxpdHkudjEuVG9vbFByb3BlcnR5Qg26SAqSAQciBYIBAhABEjwKEm1pbmltdW1fY2FwYWJpbGl0eRgDIAEoCzIgLmNhcGFiaWxpdHkudjEuQ2FwYWJpbGl0eVByb2ZpbGUSIwobYWxsb3dlZF90b29sX2RlZmluaXRpb25faWRzGAQgAygJKu8BCgxUb29sUHJvcGVydHkSHQoZVE9PTF9QUk9QRVJUWV9VTlNQRUNJRklFRBAAEiMKH1RPT0xfUFJPUEVSVFlfVE9SUVVFX0NPTlRST0xMRUQQARIaChZUT09MX1BST1BFUlRZX0VTRF9TQUZFEAISGwoXVE9PTF9QUk9QRVJUWV9JTlNVTEFURUQQAxIkCiBUT09MX1BST1BFUlRZX0NPTExBQk9SQVRJVkVfU0FGRRAEEhwKGFRPT0xfUFJPUEVSVFlfQ0FMSUJSQVRFRBAFEh4KGlRPT0xfUFJPUEVSVFlfUVVJQ0tfQ0hBTkdFEAZCyAEKEWNvbS5jYXBhYmlsaXR5LnYxQhRUb29sUmVxdWlyZW1lbnRQcm90b1ABWj9naXRodWIuY29tL2NvYm90YXIvcHJvdG9jb2wvbWVzc2FnZXMvY2FwYWJpbGl0eS92MTtjYXBhYmlsaXR5djGiAgNDWFiqAhZNZXNzYWdlcy5DYXBhYmlsaXR5LlYxygINQ2FwYWJpbGl0eVxWMeICGUNhcGFiaWxpdHlcVjFcR1BCTWV0YWRhdGHqAg5DYXBhYmlsaXR5OjpWMWIGcHJvdG8z", [file_buf_validate_validate, file_capability_v1_capability_profile, file_capability_v1_skill_definition]);
+  fileDesc("CiRjYXBhYmlsaXR5L3YxL3Rvb2xfcmVxdWlyZW1lbnQucHJvdG8SDWNhcGFiaWxpdHkudjEi7gEKD1Rvb2xSZXF1aXJlbWVudBIvCgRyb2xlGAEgASgOMhcuY2FwYWJpbGl0eS52MS5Ub29sUm9sZUIIukgFggECEAESRwoTcmVxdWlyZWRfcHJvcGVydGllcxgCIAMoDjIbLmNhcGFiaWxpdHkudjEuVG9vbFByb3BlcnR5Qg26SAqSAQciBYIBAhABEjwKEm1pbmltdW1fY2FwYWJpbGl0eRgDIAEoCzIgLmNhcGFiaWxpdHkudjEuQ2FwYWJpbGl0eVByb2ZpbGUSIwobYWxsb3dlZF90b29sX2RlZmluaXRpb25faWRzGAQgAygJKu8BCgxUb29sUHJvcGVydHkSHQoZVE9PTF9QUk9QRVJUWV9VTlNQRUNJRklFRBAAEiMKH1RPT0xfUFJPUEVSVFlfVE9SUVVFX0NPTlRST0xMRUQQARIaChZUT09MX1BST1BFUlRZX0VTRF9TQUZFEAISGwoXVE9PTF9QUk9QRVJUWV9JTlNVTEFURUQQAxIkCiBUT09MX1BST1BFUlRZX0NPTExBQk9SQVRJVkVfU0FGRRAEEhwKGFRPT0xfUFJPUEVSVFlfQ0FMSUJSQVRFRBAFEh4KGlRPT0xfUFJPUEVSVFlfUVVJQ0tfQ0hBTkdFEAZCyAEKEWNvbS5jYXBhYmlsaXR5LnYxQhRUb29sUmVxdWlyZW1lbnRQcm90b1ABWj9naXRodWIuY29tL2NvYm90YXIvcHJvdG9jb2wvbWVzc2FnZXMvY2FwYWJpbGl0eS92MTtjYXBhYmlsaXR5djGiAgNDWFiqAhZNZXNzYWdlcy5DYXBhYmlsaXR5LlYxygINQ2FwYWJpbGl0eVxWMeICGUNhcGFiaWxpdHlcVjFcR1BCTWV0YWRhdGHqAg5DYXBhYmlsaXR5OjpWMWIGcHJvdG8z", [file_buf_validate_validate, file_capability_v1_capability_profile, file_capability_v1_skill_definition]);
 
 /**
  * @generated from message capability.v1.ToolRequirement

package/lib/common/v1/enums_pb.ts

@@ -48,30 +48,101 @@ export const ResourceStatusSchema: GenEnum<ResourceStatus> = /*@__PURE__*/
   enumDesc(file_common_v1_enums, 0);
 
 /**
+ * SafetyRelevance indicates how safety-critical a task, action, or capability is.
+ *
+ * This value helps systems determine:
+ * - whether additional validation or confirmation is required
+ * - what actor permissions or certifications are needed
+ * - whether supervision or restricted execution policies apply
+ * - how prominently the task should be displayed or highlighted in UIs
+ *
+ * Safety relevance does NOT necessarily mean the task is dangerous,
+ * but rather the potential consequences if the task is performed
+ * incorrectly or skipped.
+ *
+ * The levels are intentionally coarse to keep authoring simple while
+ * still allowing meaningful safety-aware behavior.
+ *
  * @generated from enum common.v1.SafetyRelevance
  */
 export enum SafetyRelevance {
   /**
+   * Default value when safety relevance has not yet been determined.
+   *
+   * Systems should typically treat this conservatively, often
+   * equivalent to MEDIUM unless explicitly overridden.
+   *
    * @generated from enum value: SAFETY_RELEVANCE_UNSPECIFIED = 0;
    */
   UNSPECIFIED = 0,
 
   /**
+   * Minimal safety impact.
+   *
+   * Errors are unlikely to cause harm to people, equipment,
+   * or product integrity.
+   *
+   * Examples:
+   * - wiping a surface
+   * - organizing components
+   * - non-critical visual checks
+   *
+   * Typically requires no special permissions or confirmations.
+   *
    * @generated from enum value: SAFETY_RELEVANCE_LOW = 1;
    */
   LOW = 1,
 
   /**
+   * Moderate safety impact.
+   *
+   * Mistakes may affect product quality or create minor risk
+   * to equipment or operators.
+   *
+   * Examples:
+   * - positioning components
+   * - inserting non-critical parts
+   * - non-torque-sensitive operations
+   *
+   * Systems may require basic validation or confirmation.
+   *
    * @generated from enum value: SAFETY_RELEVANCE_MEDIUM = 2;
    */
   MEDIUM = 2,
 
   /**
+   * High safety impact.
+   *
+   * Incorrect execution may lead to equipment damage, significant
+   * product defects, or operator risk.
+   *
+   * Examples:
+   * - torque-controlled fastening
+   * - applying significant force
+   * - electrical assembly steps
+   *
+   * Systems may enforce stricter validation, tool feedback,
+   * or actor capability checks.
+   *
    * @generated from enum value: SAFETY_RELEVANCE_HIGH = 3;
    */
   HIGH = 3,
 
   /**
+   * Safety-critical operations.
+   *
+   * Incorrect execution may pose serious risk to human safety,
+   * regulatory compliance, or system integrity.
+   *
+   * Examples:
+   * - safety-critical fasteners
+   * - interacting with safety systems
+   * - hazardous energy isolation steps
+   * - operations requiring certified personnel
+   *
+   * Systems should require strict validation, restricted actor
+   * permissions, and explicit confirmation before completion.
+   *
    * @generated from enum value: SAFETY_RELEVANCE_CRITICAL = 4;
    */
   CRITICAL = 4,

package/lib/common/v1/time_pb.ts

@@ -4,15 +4,16 @@
 
 import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
 import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
-import type { Duration, Timestamp } from "@bufbuild/protobuf/wkt";
-import { file_google_protobuf_duration, file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+import { file_buf_validate_validate } from "../../buf/validate/validate_pb.ts";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
 import type { Message } from "@bufbuild/protobuf";
 
 /**
  * Describes the file common/v1/time.proto.
  */
 export const file_common_v1_time: GenFile = /*@__PURE__*/
-  fileDesc("ChRjb21tb24vdjEvdGltZS5wcm90bxIJY29tbW9uLnYxImAKClRpbWVXaW5kb3cSKQoFc3RhcnQYASABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEicKA2VuZBgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAijwEKEUVzdGltYXRlZER1cmF0aW9uEioKB25vbWluYWwYASABKAsyGS5nb29nbGUucHJvdG9idWYuRHVyYXRpb24SJgoDbWluGAIgASgLMhkuZ29vZ2xlLnByb3RvYnVmLkR1cmF0aW9uEiYKA21heBgDIAEoCzIZLmdvb2dsZS5wcm90b2J1Zi5EdXJhdGlvbkKhAQoNY29tLmNvbW1vbi52MUIJVGltZVByb3RvUAFaN2dpdGh1Yi5jb20vY29ib3Rhci9wcm90b2NvbC9tZXNzYWdlcy9jb21tb24vdjE7Y29tbW9udjGiAgNDWFiqAhJNZXNzYWdlcy5Db21tb24uVjHKAglDb21tb25cVjHiAhVDb21tb25cVjFcR1BCTWV0YWRhdGHqAgpDb21tb246OlYxYgZwcm90bzM", [file_google_protobuf_duration, file_google_protobuf_timestamp]);
+  fileDesc("ChRjb21tb24vdjEvdGltZS5wcm90bxIJY29tbW9uLnYxImAKClRpbWVXaW5kb3cSKQoFc3RhcnQYASABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEicKA2VuZBgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAicQoRRXN0aW1hdGVkRHVyYXRpb24SIAoPbm9taW5hbF9zZWNvbmRzGAEgASgFQge6SAQaAigAEhwKC21pbl9zZWNvbmRzGAIgASgFQge6SAQaAigAEhwKC21heF9zZWNvbmRzGAMgASgFQge6SAQaAigAQqEBCg1jb20uY29tbW9uLnYxQglUaW1lUHJvdG9QAVo3Z2l0aHViLmNvbS9jb2JvdGFyL3Byb3RvY29sL21lc3NhZ2VzL2NvbW1vbi92MTtjb21tb252MaICA0NYWKoCEk1lc3NhZ2VzLkNvbW1vbi5WMcoCCUNvbW1vblxWMeICFUNvbW1vblxWMVxHUEJNZXRhZGF0YeoCCkNvbW1vbjo6VjFiBnByb3RvMw", [file_buf_validate_validate, file_google_protobuf_timestamp]);
 
 /**
  * @generated from message common.v1.TimeWindow
@@ -41,19 +42,21 @@ export const TimeWindowSchema: GenMessage<TimeWindow> = /*@__PURE__*/
  */
 export type EstimatedDuration = Message<"common.v1.EstimatedDuration"> & {
   /**
-   * @generated from field: google.protobuf.Duration nominal = 1;
+   * Expected time in seconds
+   *
+   * @generated from field: int32 nominal_seconds = 1;
    */
-  nominal?: Duration;
+  nominalSeconds: number;
 
   /**
-   * @generated from field: google.protobuf.Duration min = 2;
+   * @generated from field: int32 min_seconds = 2;
    */
-  min?: Duration;
+  minSeconds: number;
 
   /**
-   * @generated from field: google.protobuf.Duration max = 3;
+   * @generated from field: int32 max_seconds = 3;
    */
-  max?: Duration;
+  maxSeconds: number;
 };
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cobotar/protocol",
-  "version": "0.18.10",
+  "version": "0.18.12",
   "description": "A collection of protobuf messages for the CobotAR-project",
   "homepage": "https://github.com/cobotar/protocol#readme",
   "files": [