@cobotar/protocol 0.19.7 → 0.19.9

package/README.md

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

package/lib/capability/v1/actor_skill_pb.ts

@@ -350,6 +350,13 @@ export const SkillStatusSchema: GenEnum<SkillStatus> = /*@__PURE__*/
   enumDesc(file_capability_v1_actor_skill, 1);
 
 /**
+ * SkillInvalidityReason explains why an actor skill is currently restricted,
+ * expired, or otherwise not fully valid.
+ *
+ * These reasons are intended to be stable, machine-readable summary codes that
+ * can be shown in UI, used in loaders/runtime checks, and derived from evidence,
+ * policy evaluation, or engineering-change events.
+ *
  * @generated from enum capability.v1.SkillInvalidityReason
  */
 export enum SkillInvalidityReason {
@@ -359,21 +366,51 @@ export enum SkillInvalidityReason {
   UNSPECIFIED = 0,
 
   /**
+   * The skill has degraded due to lack of recent practice or evidence of use.
+   *
+   * Typical examples:
+   * - no executions in the active policy window
+   * - no recent successful evidence for the skill
+   *
    * @generated from enum value: SKILL_INVALIDITY_REASON_INACTIVITY = 1;
    */
   INACTIVITY = 1,
 
   /**
+   * The skill is restricted or invalid because observed failure rate or quality
+   * performance exceeded the allowed threshold.
+   *
+   * Typical examples:
+   * - too many failed executions in the recent window
+   * - too many out-of-tolerance results
+   * - too many inspection failures or retries
+   *
    * @generated from enum value: SKILL_INVALIDITY_REASON_FAILURE_RATE = 2;
    */
   FAILURE_RATE = 2,
 
   /**
+   * The governing validity/certification policy has expired the skill based on
+   * time or other policy-defined rules.
+   *
+   * Typical examples:
+   * - certification period elapsed
+   * - revalidation deadline passed
+   *
    * @generated from enum value: SKILL_INVALIDITY_REASON_POLICY_EXPIRED = 3;
    */
   POLICY_EXPIRED = 3,
 
   /**
+   * The skill has been invalidated because a relevant engineering or process
+   * change means previous validation/training can no longer be trusted.
+   *
+   * Typical examples:
+   * - tool model or capability changed
+   * - torque/program parameters changed
+   * - product revision changed
+   * - robot program or fixture configuration changed
+   *
    * @generated from enum value: SKILL_INVALIDITY_REASON_ENGINEERING_CHANGE = 4;
    */
   ENGINEERING_CHANGE = 4,
@@ -386,6 +423,12 @@ export const SkillInvalidityReasonSchema: GenEnum<SkillInvalidityReason> = /*@__
   enumDesc(file_capability_v1_actor_skill, 2);
 
 /**
+ * SkillNextAction describes the recommended next action needed to restore,
+ * strengthen, or safely compensate for a restricted/expired skill.
+ *
+ * These actions are intended to be stable, machine-readable guidance codes that
+ * can be surfaced in UI and used by operational workflows.
+ *
  * @generated from enum capability.v1.SkillNextAction
  */
 export enum SkillNextAction {
@@ -395,26 +438,65 @@ export enum SkillNextAction {
   UNSPECIFIED = 0,
 
   /**
+   * A short targeted intervention is recommended before normal independent use.
+   *
+   * Typical examples:
+   * - brief AR-guided walkthrough
+   * - quick reminder of the critical steps
+   * - short digital refresher module
+   *
    * @generated from enum value: SKILL_NEXT_ACTION_MICRO_TRAINING = 1;
    */
   MICRO_TRAINING = 1,
 
   /**
+   * A broader retraining session is recommended because the skill has degraded
+   * beyond what a short intervention should address.
+   *
+   * Typical examples:
+   * - instructor-led refresher
+   * - extended guided practice
+   * - retraining on updated process/tooling
+   *
    * @generated from enum value: SKILL_NEXT_ACTION_REFRESHER_TRAINING = 2;
    */
   REFRESHER_TRAINING = 2,
 
   /**
+   * Formal re-certification or re-validation is required before the skill can
+   * return to normal unrestricted use.
+   *
+   * Typical examples:
+   * - certification renewal
+   * - formal competency check
+   * - validated robot/program re-approval
+   *
    * @generated from enum value: SKILL_NEXT_ACTION_RE_CERTIFICATION = 3;
    */
   RE_CERTIFICATION = 3,
 
   /**
+   * Additional runtime validation must be performed before or during task
+   * execution to safely use the skill in its current state.
+   *
+   * Typical examples:
+   * - second check required
+   * - vision/tool confirmation required
+   * - extra verification step before completion
+   *
    * @generated from enum value: SKILL_NEXT_ACTION_EXTRA_VALIDATION_REQUIRED = 4;
    */
   EXTRA_VALIDATION_REQUIRED = 4,
 
   /**
+   * Supervisor or responsible authority approval is required before the actor
+   * may execute tasks relying on this skill.
+   *
+   * Typical examples:
+   * - technician sign-off
+   * - team lead approval
+   * - engineering approval for temporary restricted use
+   *
    * @generated from enum value: SKILL_NEXT_ACTION_SUPERVISOR_APPROVAL_REQUIRED = 5;
    */
   SUPERVISOR_APPROVAL_REQUIRED = 5,

package/lib/process/v1/process_recipe_pb.ts

@@ -7,6 +7,10 @@ import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
 import { file_buf_validate_validate } from "../../buf/validate/validate_pb.ts";
 import type { ExternalReference } from "../../common/v1/external_references_pb.ts";
 import { file_common_v1_external_references } from "../../common/v1/external_references_pb.ts";
+import type { SequenceDefinition } from "./sequence_definition_pb.ts";
+import { file_process_v1_sequence_definition } from "./sequence_definition_pb.ts";
+import type { TaskDefinition } from "./task_definition_pb.ts";
+import { file_process_v1_task_definition } from "./task_definition_pb.ts";
 import { file_validation_v1_predefined_string_rules } from "../../validation/v1/predefined_string_rules_pb.ts";
 import type { VariantRule } from "../../variance/v1/variant_rule_pb.ts";
 import { file_variance_v1_variant_rule } from "../../variance/v1/variant_rule_pb.ts";
@@ -16,7 +20,7 @@ import type { Message } from "@bufbuild/protobuf";
  * Describes the file process/v1/process_recipe.proto.
  */
 export const file_process_v1_process_recipe: GenFile = /*@__PURE__*/
-  fileDesc("Ch9wcm9jZXNzL3YxL3Byb2Nlc3NfcmVjaXBlLnByb3RvEgpwcm9jZXNzLnYxImsKE1JlY2lwZUFwcGxpY2FiaWxpdHkSKQoHaW5jbHVkZRgBIAMoCzIYLnZhcmlhbmNlLnYxLlZhcmlhbnRSdWxlEikKB2V4Y2x1ZGUYAiADKAsyGC52YXJpYW5jZS52MS5WYXJpYW50UnVsZSKLAwoNUHJvY2Vzc1JlY2lwZRIKCgJpZBgBIAEoCRIXCgRuYW1lGAIgASgJQgm6SAZyBIDxBAESDAoEaWNvbhgDIAEoCRITCgtkZXNjcmlwdGlvbhgEIAEoCRIyCgR0eXBlGAUgASgOMhcucHJvY2Vzcy52MS5Qcm9jZXNzVHlwZUILukgIyAEBggECEAESHQoVcHJvZHVjdF9kZWZpbml0aW9uX2lkGAYgASgJEjYKDWFwcGxpY2FiaWxpdHkYByABKAsyHy5wcm9jZXNzLnYxLlJlY2lwZUFwcGxpY2FiaWxpdHkSGAoQcm9vdF9zZXF1ZW5jZV9pZBgIIAEoCRIUCgxzZXF1ZW5jZV9pZHMYCSADKAkSEAoIdGFza19pZHMYCiADKAkSKgoic3VwcG9ydGVkX2NvbnRhaW5lcl9kZWZpbml0aW9uX2lkcxgLIAMoCRI5ChNleHRlcm5hbF9yZWZlcmVuY2VzGAwgAygLMhwuY29tbW9uLnYxLkV4dGVybmFsUmVmZXJlbmNlIjoKDlByb2Nlc3NSZWNpcGVzEigKBWl0ZW1zGAEgAygLMhkucHJvY2Vzcy52MS5Qcm9jZXNzUmVjaXBlKtUBCgtQcm9jZXNzVHlwZRIcChhQUk9DRVNTX1RZUEVfVU5TUEVDSUZJRUQQABIZChVQUk9DRVNTX1RZUEVfQVNTRU1CTFkQARIcChhQUk9DRVNTX1RZUEVfRElTQVNTRU1CTFkQAhIbChdQUk9DRVNTX1RZUEVfSU5TUEVDVElPThADEhoKFlBST0NFU1NfVFlQRV9DSEVDS0xJU1QQBBIYChRQUk9DRVNTX1RZUEVfS0lUVElORxAFEhwKGFBST0NFU1NfVFlQRV9NQUlOVEVOQU5DRRAGQrEBCg5jb20ucHJvY2Vzcy52MUISUHJvY2Vzc1JlY2lwZVByb3RvUAFaOWdpdGh1Yi5jb20vY29ib3Rhci9wcm90b2NvbC9tZXNzYWdlcy9wcm9jZXNzL3YxO3Byb2Nlc3N2MaICA1BYWKoCE01lc3NhZ2VzLlByb2Nlc3MuVjHKAgpQcm9jZXNzXFYx4gIWUHJvY2Vzc1xWMVxHUEJNZXRhZGF0YeoCC1Byb2Nlc3M6OlYxYgZwcm90bzM", [file_buf_validate_validate, file_common_v1_external_references, file_validation_v1_predefined_string_rules, file_variance_v1_variant_rule]);
+  fileDesc("Ch9wcm9jZXNzL3YxL3Byb2Nlc3NfcmVjaXBlLnByb3RvEgpwcm9jZXNzLnYxImsKE1JlY2lwZUFwcGxpY2FiaWxpdHkSKQoHaW5jbHVkZRgBIAMoCzIYLnZhcmlhbmNlLnYxLlZhcmlhbnRSdWxlEikKB2V4Y2x1ZGUYAiADKAsyGC52YXJpYW5jZS52MS5WYXJpYW50UnVsZSKLAwoNUHJvY2Vzc1JlY2lwZRIKCgJpZBgBIAEoCRIXCgRuYW1lGAIgASgJQgm6SAZyBIDxBAESDAoEaWNvbhgDIAEoCRITCgtkZXNjcmlwdGlvbhgEIAEoCRIyCgR0eXBlGAUgASgOMhcucHJvY2Vzcy52MS5Qcm9jZXNzVHlwZUILukgIyAEBggECEAESHQoVcHJvZHVjdF9kZWZpbml0aW9uX2lkGAYgASgJEjYKDWFwcGxpY2FiaWxpdHkYByABKAsyHy5wcm9jZXNzLnYxLlJlY2lwZUFwcGxpY2FiaWxpdHkSGAoQcm9vdF9zZXF1ZW5jZV9pZBgIIAEoCRIUCgxzZXF1ZW5jZV9pZHMYCSADKAkSEAoIdGFza19pZHMYCiADKAkSKgoic3VwcG9ydGVkX2NvbnRhaW5lcl9kZWZpbml0aW9uX2lkcxgLIAMoCRI5ChNleHRlcm5hbF9yZWZlcmVuY2VzGAwgAygLMhwuY29tbW9uLnYxLkV4dGVybmFsUmVmZXJlbmNlIjoKDlByb2Nlc3NSZWNpcGVzEigKBWl0ZW1zGAEgAygLMhkucHJvY2Vzcy52MS5Qcm9jZXNzUmVjaXBlIqYBChNDcmVhdGVQcm9jZXNzUmVjaXBlEjEKBnJlY2lwZRgBIAEoCzIZLnByb2Nlc3MudjEuUHJvY2Vzc1JlY2lwZUIGukgDyAEBEjEKCXNlcXVlbmNlcxgCIAMoCzIeLnByb2Nlc3MudjEuU2VxdWVuY2VEZWZpbml0aW9uEikKBXRhc2tzGAMgAygLMhoucHJvY2Vzcy52MS5UYXNrRGVmaW5pdGlvbiI5ChZBZGRSb290U2VxdWVuY2VSZXF1ZXN0Eh8KCXJlY2lwZV9pZBgBIAEoCUIMukgJyAEBcgSg8gQBIl0KF0FkZENoaWxkU2VxdWVuY2VSZXF1ZXN0Eh8KCXJlY2lwZV9pZBgBIAEoCUIMukgJyAEBcgSg8gQBEiEKC3NlcXVlbmNlX2lkGAIgASgJQgy6SAnIAQFyBKjyBAEiWwoVUmVtb3ZlU2VxdWVuY2VSZXF1ZXN0Eh8KCXJlY2lwZV9pZBgBIAEoCUIMukgJyAEBcgSg8gQBEiEKC3NlcXVlbmNlX2lkGAIgASgJQgy6SAnIAQFyBKjyBAEiWQoTQWRkQ2hpbGRUYXNrUmVxdWVzdBIfCglyZWNpcGVfaWQYASABKAlCDLpICcgBAXIEoPIEARIhCgtzZXF1ZW5jZV9pZBgCIAEoCUIMukgJyAEBcgSo8gQBIlMKEVJlbW92ZVRhc2tSZXF1ZXN0Eh8KCXJlY2lwZV9pZBgBIAEoCUIMukgJyAEBcgSg8gQBEh0KB3Rhc2tfaWQYAiABKAlCDLpICcgBAXIEsPIEASrVAQoLUHJvY2Vzc1R5cGUSHAoYUFJPQ0VTU19UWVBFX1VOU1BFQ0lGSUVEEAASGQoVUFJPQ0VTU19UWVBFX0FTU0VNQkxZEAESHAoYUFJPQ0VTU19UWVBFX0RJU0FTU0VNQkxZEAISGwoXUFJPQ0VTU19UWVBFX0lOU1BFQ1RJT04QAxIaChZQUk9DRVNTX1RZUEVfQ0hFQ0tMSVNUEAQSGAoUUFJPQ0VTU19UWVBFX0tJVFRJTkcQBRIcChhQUk9DRVNTX1RZUEVfTUFJTlRFTkFOQ0UQBkKxAQoOY29tLnByb2Nlc3MudjFCElByb2Nlc3NSZWNpcGVQcm90b1ABWjlnaXRodWIuY29tL2NvYm90YXIvcHJvdG9jb2wvbWVzc2FnZXMvcHJvY2Vzcy92MTtwcm9jZXNzdjGiAgNQWFiqAhNNZXNzYWdlcy5Qcm9jZXNzLlYxygIKUHJvY2Vzc1xWMeICFlByb2Nlc3NcVjFcR1BCTWV0YWRhdGHqAgtQcm9jZXNzOjpWMWIGcHJvdG8z", [file_buf_validate_validate, file_common_v1_external_references, file_process_v1_sequence_definition, file_process_v1_task_definition, file_validation_v1_predefined_string_rules, file_variance_v1_variant_rule]);
 
 /**
  * @generated from message process.v1.RecipeApplicability
@@ -143,6 +147,138 @@ export type ProcessRecipes = Message<"process.v1.ProcessRecipes"> & {
 export const ProcessRecipesSchema: GenMessage<ProcessRecipes> = /*@__PURE__*/
   messageDesc(file_process_v1_process_recipe, 2);
 
+/**
+ * @generated from message process.v1.CreateProcessRecipe
+ */
+export type CreateProcessRecipe = Message<"process.v1.CreateProcessRecipe"> & {
+  /**
+   * @generated from field: process.v1.ProcessRecipe recipe = 1;
+   */
+  recipe?: ProcessRecipe;
+
+  /**
+   * @generated from field: repeated process.v1.SequenceDefinition sequences = 2;
+   */
+  sequences: SequenceDefinition[];
+
+  /**
+   * @generated from field: repeated process.v1.TaskDefinition tasks = 3;
+   */
+  tasks: TaskDefinition[];
+};
+
+/**
+ * Describes the message process.v1.CreateProcessRecipe.
+ * Use `create(CreateProcessRecipeSchema)` to create a new message.
+ */
+export const CreateProcessRecipeSchema: GenMessage<CreateProcessRecipe> = /*@__PURE__*/
+  messageDesc(file_process_v1_process_recipe, 3);
+
+/**
+ * @generated from message process.v1.AddRootSequenceRequest
+ */
+export type AddRootSequenceRequest = Message<"process.v1.AddRootSequenceRequest"> & {
+  /**
+   * @generated from field: string recipe_id = 1;
+   */
+  recipeId: string;
+};
+
+/**
+ * Describes the message process.v1.AddRootSequenceRequest.
+ * Use `create(AddRootSequenceRequestSchema)` to create a new message.
+ */
+export const AddRootSequenceRequestSchema: GenMessage<AddRootSequenceRequest> = /*@__PURE__*/
+  messageDesc(file_process_v1_process_recipe, 4);
+
+/**
+ * @generated from message process.v1.AddChildSequenceRequest
+ */
+export type AddChildSequenceRequest = Message<"process.v1.AddChildSequenceRequest"> & {
+  /**
+   * @generated from field: string recipe_id = 1;
+   */
+  recipeId: string;
+
+  /**
+   * @generated from field: string sequence_id = 2;
+   */
+  sequenceId: string;
+};
+
+/**
+ * Describes the message process.v1.AddChildSequenceRequest.
+ * Use `create(AddChildSequenceRequestSchema)` to create a new message.
+ */
+export const AddChildSequenceRequestSchema: GenMessage<AddChildSequenceRequest> = /*@__PURE__*/
+  messageDesc(file_process_v1_process_recipe, 5);
+
+/**
+ * @generated from message process.v1.RemoveSequenceRequest
+ */
+export type RemoveSequenceRequest = Message<"process.v1.RemoveSequenceRequest"> & {
+  /**
+   * @generated from field: string recipe_id = 1;
+   */
+  recipeId: string;
+
+  /**
+   * @generated from field: string sequence_id = 2;
+   */
+  sequenceId: string;
+};
+
+/**
+ * Describes the message process.v1.RemoveSequenceRequest.
+ * Use `create(RemoveSequenceRequestSchema)` to create a new message.
+ */
+export const RemoveSequenceRequestSchema: GenMessage<RemoveSequenceRequest> = /*@__PURE__*/
+  messageDesc(file_process_v1_process_recipe, 6);
+
+/**
+ * @generated from message process.v1.AddChildTaskRequest
+ */
+export type AddChildTaskRequest = Message<"process.v1.AddChildTaskRequest"> & {
+  /**
+   * @generated from field: string recipe_id = 1;
+   */
+  recipeId: string;
+
+  /**
+   * @generated from field: string sequence_id = 2;
+   */
+  sequenceId: string;
+};
+
+/**
+ * Describes the message process.v1.AddChildTaskRequest.
+ * Use `create(AddChildTaskRequestSchema)` to create a new message.
+ */
+export const AddChildTaskRequestSchema: GenMessage<AddChildTaskRequest> = /*@__PURE__*/
+  messageDesc(file_process_v1_process_recipe, 7);
+
+/**
+ * @generated from message process.v1.RemoveTaskRequest
+ */
+export type RemoveTaskRequest = Message<"process.v1.RemoveTaskRequest"> & {
+  /**
+   * @generated from field: string recipe_id = 1;
+   */
+  recipeId: string;
+
+  /**
+   * @generated from field: string task_id = 2;
+   */
+  taskId: string;
+};
+
+/**
+ * Describes the message process.v1.RemoveTaskRequest.
+ * Use `create(RemoveTaskRequestSchema)` to create a new message.
+ */
+export const RemoveTaskRequestSchema: GenMessage<RemoveTaskRequest> = /*@__PURE__*/
+  messageDesc(file_process_v1_process_recipe, 8);
+
 /**
  * @generated from enum process.v1.ProcessType
  */

package/package.json

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