cadenya 0.32.0 → 0.34.0

data/rbi/cadenya/models/api_keys/access_list_params.rbi

@@ -25,6 +25,15 @@ module Cadenya
         sig { params(cursor: String).void }
         attr_writer :cursor
 
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        sig { returns(T.nilable(String)) }
+        attr_reader :labels
+
+        sig { params(labels: String).void }
+        attr_writer :labels
+
         # Maximum number of results to return.
         sig { returns(T.nilable(Integer)) }
         attr_reader :limit
@@ -36,6 +45,7 @@ module Cadenya
           params(
             id: String,
             cursor: String,
+            labels: String,
             limit: Integer,
             request_options: Cadenya::RequestOptions::OrHash
           ).returns(T.attached_class)
@@ -44,6 +54,10 @@ module Cadenya
           id:,
           # Pagination cursor from previous response.
           cursor: nil,
+          # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+          # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+          # semantics).
+          labels: nil,
           # Maximum number of results to return.
           limit: nil,
           request_options: {}
@@ -55,6 +69,7 @@ module Cadenya
             {
               id: String,
               cursor: String,
+              labels: String,
               limit: Integer,
               request_options: Cadenya::RequestOptions
             }

data/rbi/cadenya/models/create_operation_metadata.rbi

@@ -15,8 +15,11 @@ module Cadenya
       sig { params(external_id: String).void }
       attr_writer :external_id
 
-      # Arbitrary key-value pairs for categorization and filtering Examples:
-      # {"priority": "high", "source": "api", "workflow": "onboarding"}
+      # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+      # characters with "-", "\_", or "." allowed between; keys follow the same shape
+      # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+      # of at most 253 characters. Examples: {"priority": "high", "source": "api",
+      # "workflow": "onboarding"}
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
       attr_reader :labels
 
@@ -34,8 +37,11 @@ module Cadenya
       def self.new(
         # External ID for the operation (e.g., a workflow ID from an external system)
         external_id: nil,
-        # Arbitrary key-value pairs for categorization and filtering Examples:
-        # {"priority": "high", "source": "api", "workflow": "onboarding"}
+        # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+        # characters with "-", "\_", or "." allowed between; keys follow the same shape
+        # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+        # of at most 253 characters. Examples: {"priority": "high", "source": "api",
+        # "workflow": "onboarding"}
         labels: nil
       )
       end

data/rbi/cadenya/models/create_resource_metadata.rbi

@@ -20,8 +20,11 @@ module Cadenya
       sig { params(external_id: String).void }
       attr_writer :external_id
 
-      # Arbitrary key-value pairs for categorization and filtering Examples:
-      # {"environment": "production", "team": "platform", "version": "v2"}
+      # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+      # characters with "-", "\_", or "." allowed between; keys follow the same shape
+      # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+      # of at most 253 characters. Examples: {"environment": "production", "team":
+      # "platform", "version": "v2"}
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
       attr_reader :labels
 
@@ -44,8 +47,11 @@ module Cadenya
         name:,
         # External ID for the resource (e.g., a workflow ID from an external system)
         external_id: nil,
-        # Arbitrary key-value pairs for categorization and filtering Examples:
-        # {"environment": "production", "team": "platform", "version": "v2"}
+        # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+        # characters with "-", "\_", or "." allowed between; keys follow the same shape
+        # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+        # of at most 253 characters. Examples: {"environment": "production", "team":
+        # "platform", "version": "v2"}
         labels: nil
       )
       end

data/rbi/cadenya/models/memory_layer_list_params.rbi

@@ -44,6 +44,15 @@ module Cadenya
       sig { params(include_info: T::Boolean).void }
       attr_writer :include_info
 
+      # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+      # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+      # semantics).
+      sig { returns(T.nilable(String)) }
+      attr_reader :labels
+
+      sig { params(labels: String).void }
+      attr_writer :labels
+
       # Maximum number of results to return
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
@@ -86,6 +95,7 @@ module Cadenya
           cursor: String,
           episodic_key_prefix: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           query: String,
@@ -106,6 +116,10 @@ module Cadenya
         episodic_key_prefix: nil,
         # When set to true you may use more of your alloted API rate-limit
         include_info: nil,
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        labels: nil,
         # Maximum number of results to return
         limit: nil,
         # Filter expression (query param: prefix)
@@ -128,6 +142,7 @@ module Cadenya
             cursor: String,
             episodic_key_prefix: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             prefix: String,
             query: String,

data/rbi/cadenya/models/memory_layers/entry_list_params.rbi

@@ -35,6 +35,15 @@ module Cadenya
         sig { params(include_info: T::Boolean).void }
         attr_writer :include_info
 
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        sig { returns(T.nilable(String)) }
+        attr_reader :labels
+
+        sig { params(labels: String).void }
+        attr_writer :labels
+
         # Maximum number of results to return
         sig { returns(T.nilable(Integer)) }
         attr_reader :limit
@@ -70,6 +79,7 @@ module Cadenya
             memory_layer_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             prefix: String,
             query: String,
@@ -84,6 +94,10 @@ module Cadenya
           cursor: nil,
           # When set to true you may use more of your alloted API rate-limit
           include_info: nil,
+          # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+          # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+          # semantics).
+          labels: nil,
           # Maximum number of results to return
           limit: nil,
           # Filter by key prefix (e.g., "skills/postmortem/" to list all entries under that
@@ -104,6 +118,7 @@ module Cadenya
               memory_layer_id: String,
               cursor: String,
               include_info: T::Boolean,
+              labels: String,
               limit: Integer,
               prefix: String,
               query: String,

data/rbi/cadenya/models/model_list_params.rbi

@@ -46,6 +46,15 @@ module Cadenya
       sig { params(is_assigned: T::Boolean).void }
       attr_writer :is_assigned
 
+      # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+      # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+      # semantics).
+      sig { returns(T.nilable(String)) }
+      attr_reader :labels
+
+      sig { params(labels: String).void }
+      attr_writer :labels
+
       # Maximum number of results to return
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
@@ -88,6 +97,7 @@ module Cadenya
           cursor: String,
           include_info: T::Boolean,
           is_assigned: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           query: String,
@@ -110,6 +120,10 @@ module Cadenya
         # agents count as assigned; archived agents do not. Assignment does not imply
         # recent traffic — see ModelInfo.last_used_at for that.
         is_assigned: nil,
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        labels: nil,
         # Maximum number of results to return
         limit: nil,
         # Filter by name prefix
@@ -132,6 +146,7 @@ module Cadenya
             cursor: String,
             include_info: T::Boolean,
             is_assigned: T::Boolean,
+            labels: String,
             limit: Integer,
             prefix: String,
             query: String,

data/rbi/cadenya/models/objective_list_context_windows_params.rbi

@@ -34,6 +34,15 @@ module Cadenya
       sig { params(include_info: T::Boolean).void }
       attr_writer :include_info
 
+      # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+      # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+      # semantics).
+      sig { returns(T.nilable(String)) }
+      attr_reader :labels
+
+      sig { params(labels: String).void }
+      attr_writer :labels
+
       # Maximum number of results to return
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
@@ -47,6 +56,7 @@ module Cadenya
           objective_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           request_options: Cadenya::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -58,6 +68,10 @@ module Cadenya
         cursor: nil,
         # When set to true you may use more of your alloted API rate-limit
         include_info: nil,
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        labels: nil,
         # Maximum number of results to return
         limit: nil,
         request_options: {}
@@ -71,6 +85,7 @@ module Cadenya
             objective_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             request_options: Cadenya::RequestOptions
           }

data/rbi/cadenya/models/objective_list_events_params.rbi

@@ -31,6 +31,15 @@ module Cadenya
       sig { params(include_info: T::Boolean).void }
       attr_writer :include_info
 
+      # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+      # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+      # semantics).
+      sig { returns(T.nilable(String)) }
+      attr_reader :labels
+
+      sig { params(labels: String).void }
+      attr_writer :labels
+
       # Maximum number of results to return
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
@@ -65,6 +74,7 @@ module Cadenya
           objective_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           since_event_id: String,
           sort_order: String,
@@ -79,6 +89,10 @@ module Cadenya
         cursor: nil,
         # When set to true you may use more of your alloted API rate-limit
         include_info: nil,
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        labels: nil,
         # Maximum number of results to return
         limit: nil,
         # Optional string to fetch events since an ID
@@ -98,6 +112,7 @@ module Cadenya
             objective_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             since_event_id: String,
             sort_order: String,

data/rbi/cadenya/models/objective_list_params.rbi

@@ -43,6 +43,15 @@ module Cadenya
       sig { params(include_info: T::Boolean).void }
       attr_writer :include_info
 
+      # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+      # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+      # semantics).
+      sig { returns(T.nilable(String)) }
+      attr_reader :labels
+
+      sig { params(labels: String).void }
+      attr_writer :labels
+
       # Maximum number of results to return
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
@@ -84,6 +93,7 @@ module Cadenya
           agent_schedule_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           parent_objective_id: String,
           profile_id: String,
@@ -103,6 +113,10 @@ module Cadenya
         cursor: nil,
         # When set to true you may use more of your alloted API rate-limit
         include_info: nil,
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        labels: nil,
         # Maximum number of results to return
         limit: nil,
         # Optional filters
@@ -124,6 +138,7 @@ module Cadenya
             agent_schedule_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             parent_objective_id: String,
             profile_id: String,

data/rbi/cadenya/models/objectives/feedback_list_params.rbi

@@ -28,6 +28,15 @@ module Cadenya
         sig { params(cursor: String).void }
         attr_writer :cursor
 
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        sig { returns(T.nilable(String)) }
+        attr_reader :labels
+
+        sig { params(labels: String).void }
+        attr_writer :labels
+
         # Maximum number of results to return
         sig { returns(T.nilable(Integer)) }
         attr_reader :limit
@@ -40,6 +49,7 @@ module Cadenya
             workspace_id: String,
             objective_id: String,
             cursor: String,
+            labels: String,
             limit: Integer,
             request_options: Cadenya::RequestOptions::OrHash
           ).returns(T.attached_class)
@@ -49,6 +59,10 @@ module Cadenya
           objective_id:,
           # Pagination cursor from previous response
           cursor: nil,
+          # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+          # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+          # semantics).
+          labels: nil,
           # Maximum number of results to return
           limit: nil,
           request_options: {}
@@ -61,6 +75,7 @@ module Cadenya
               workspace_id: String,
               objective_id: String,
               cursor: String,
+              labels: String,
               limit: Integer,
               request_options: Cadenya::RequestOptions
             }

data/rbi/cadenya/models/objectives/tool_call_list_params.rbi

@@ -55,6 +55,15 @@ module Cadenya
         sig { params(include_info: T::Boolean).void }
         attr_writer :include_info
 
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        sig { returns(T.nilable(String)) }
+        attr_reader :labels
+
+        sig { params(labels: String).void }
+        attr_writer :labels
+
         # Maximum number of results to return
         sig { returns(T.nilable(Integer)) }
         attr_reader :limit
@@ -85,6 +94,7 @@ module Cadenya
             execution_status:
               Cadenya::Objectives::ToolCallListParams::ExecutionStatus::OrSymbol,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             status: Cadenya::Objectives::ToolCallListParams::Status::OrSymbol,
             request_options: Cadenya::RequestOptions::OrHash
@@ -101,6 +111,10 @@ module Cadenya
           execution_status: nil,
           # When set to true you may use more of your alloted API rate-limit
           include_info: nil,
+          # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+          # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+          # semantics).
+          labels: nil,
           # Maximum number of results to return
           limit: nil,
           # Filter by tool call status
@@ -118,6 +132,7 @@ module Cadenya
               execution_status:
                 Cadenya::Objectives::ToolCallListParams::ExecutionStatus::OrSymbol,
               include_info: T::Boolean,
+              labels: String,
               limit: Integer,
               status: Cadenya::Objectives::ToolCallListParams::Status::OrSymbol,
               request_options: Cadenya::RequestOptions

data/rbi/cadenya/models/operation_metadata.rbi

@@ -15,8 +15,11 @@ module Cadenya
       sig { params(external_id: String).void }
       attr_writer :external_id
 
-      # Arbitrary key-value pairs for categorization and filtering Examples:
-      # {"priority": "high", "source": "api", "workflow": "onboarding"}
+      # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+      # characters with "-", "\_", or "." allowed between; keys follow the same shape
+      # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+      # of at most 253 characters. Examples: {"priority": "high", "source": "api",
+      # "workflow": "onboarding"}
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
       attr_reader :labels
 
@@ -71,8 +74,11 @@ module Cadenya
         workspace_id:,
         # External ID for the operation (e.g., a workflow ID from an external system)
         external_id: nil,
-        # Arbitrary key-value pairs for categorization and filtering Examples:
-        # {"priority": "high", "source": "api", "workflow": "onboarding"}
+        # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+        # characters with "-", "\_", or "." allowed between; keys follow the same shape
+        # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+        # of at most 253 characters. Examples: {"priority": "high", "source": "api",
+        # "workflow": "onboarding"}
         labels: nil
       )
       end

data/rbi/cadenya/models/resource_metadata.rbi

@@ -20,8 +20,11 @@ module Cadenya
       sig { params(external_id: String).void }
       attr_writer :external_id
 
-      # Arbitrary key-value pairs for categorization and filtering Examples:
-      # {"environment": "production", "team": "platform", "version": "v2"}
+      # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+      # characters with "-", "\_", or "." allowed between; keys follow the same shape
+      # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+      # of at most 253 characters. Examples: {"environment": "production", "team":
+      # "platform", "version": "v2"}
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
       attr_reader :labels
 
@@ -85,8 +88,11 @@ module Cadenya
         workspace_id:,
         # External ID for the resource (e.g., a workflow ID from an external system)
         external_id: nil,
-        # Arbitrary key-value pairs for categorization and filtering Examples:
-        # {"environment": "production", "team": "platform", "version": "v2"}
+        # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+        # characters with "-", "\_", or "." allowed between; keys follow the same shape
+        # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+        # of at most 253 characters. Examples: {"environment": "production", "team":
+        # "platform", "version": "v2"}
         labels: nil,
         # Timestamp when this resource was last updated
         updated_at: nil

data/rbi/cadenya/models/tool_set_list_events_params.rbi

@@ -31,6 +31,15 @@ module Cadenya
       sig { params(include_info: T::Boolean).void }
       attr_writer :include_info
 
+      # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+      # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+      # semantics).
+      sig { returns(T.nilable(String)) }
+      attr_reader :labels
+
+      sig { params(labels: String).void }
+      attr_writer :labels
+
       # Maximum number of results to return
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
@@ -51,6 +60,7 @@ module Cadenya
           tool_set_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           sort_order: String,
           request_options: Cadenya::RequestOptions::OrHash
@@ -63,6 +73,10 @@ module Cadenya
         cursor: nil,
         # When set to true you may use more of your alloted API rate-limit
         include_info: nil,
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        labels: nil,
         # Maximum number of results to return
         limit: nil,
         # Sort order for results (asc or desc by creation time)
@@ -78,6 +92,7 @@ module Cadenya
             tool_set_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             sort_order: String,
             request_options: Cadenya::RequestOptions

data/rbi/cadenya/models/tool_set_list_params.rbi

@@ -28,6 +28,15 @@ module Cadenya
       sig { params(include_info: T::Boolean).void }
       attr_writer :include_info
 
+      # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+      # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+      # semantics).
+      sig { returns(T.nilable(String)) }
+      attr_reader :labels
+
+      sig { params(labels: String).void }
+      attr_writer :labels
+
       # Maximum number of results to return
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
@@ -69,6 +78,7 @@ module Cadenya
           workspace_id: String,
           cursor: String,
           include_info: T::Boolean,
+          labels: String,
           limit: Integer,
           prefix: String,
           query: String,
@@ -83,6 +93,10 @@ module Cadenya
         cursor: nil,
         # When set to true you may use more of your alloted API rate-limit
         include_info: nil,
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        labels: nil,
         # Maximum number of results to return
         limit: nil,
         # Filter expression (query param: prefix)
@@ -104,6 +118,7 @@ module Cadenya
             workspace_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             prefix: String,
             query: String,

data/rbi/cadenya/models/tool_sets/tool_list_params.rbi

@@ -32,6 +32,15 @@ module Cadenya
         sig { params(include_info: T::Boolean).void }
         attr_writer :include_info
 
+        # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+        # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+        # semantics).
+        sig { returns(T.nilable(String)) }
+        attr_reader :labels
+
+        sig { params(labels: String).void }
+        attr_writer :labels
+
         # Maximum number of results to return
         sig { returns(T.nilable(Integer)) }
         attr_reader :limit
@@ -98,6 +107,7 @@ module Cadenya
             tool_set_id: String,
             cursor: String,
             include_info: T::Boolean,
+            labels: String,
             limit: Integer,
             names: T::Array[String],
             prefix: String,
@@ -116,6 +126,10 @@ module Cadenya
           cursor: nil,
           # When set to true you may use more of your alloted API rate-limit
           include_info: nil,
+          # Filters by metadata labels. Comma-separated key=value pairs, e.g.
+          # "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+          # semantics).
+          labels: nil,
           # Maximum number of results to return
           limit: nil,
           # Filter by tool name (exact match). Multiple values are OR'd together.
@@ -142,6 +156,7 @@ module Cadenya
               tool_set_id: String,
               cursor: String,
               include_info: T::Boolean,
+              labels: String,
               limit: Integer,
               names: T::Array[String],
               prefix: String,

data/rbi/cadenya/models/update_resource_metadata.rbi

@@ -20,8 +20,11 @@ module Cadenya
       sig { params(external_id: String).void }
       attr_writer :external_id
 
-      # Arbitrary key-value pairs for categorization and filtering Examples:
-      # {"environment": "production", "team": "platform", "version": "v2"}
+      # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+      # characters with "-", "\_", or "." allowed between; keys follow the same shape
+      # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+      # of at most 253 characters. Examples: {"environment": "production", "team":
+      # "platform", "version": "v2"}
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
       attr_reader :labels
 
@@ -44,8 +47,11 @@ module Cadenya
         name:,
         # External ID for the resource (e.g., a workflow ID from an external system)
         external_id: nil,
-        # Arbitrary key-value pairs for categorization and filtering Examples:
-        # {"environment": "production", "team": "platform", "version": "v2"}
+        # Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric
+        # characters with "-", "\_", or "." allowed between; keys follow the same shape
+        # and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/")
+        # of at most 253 characters. Examples: {"environment": "production", "team":
+        # "platform", "version": "v2"}
         labels: nil
       )
       end