cadenya 0.1.0

data/lib/cadenya/models/agent_spec.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AgentSpec < Cadenya::Internal::Type::BaseModel
+      # @!attribute status
+      #   Status of the agent
+      #
+      #   @return [Symbol, Cadenya::Models::AgentSpec::Status]
+      required :status, enum: -> { Cadenya::AgentSpec::Status }
+
+      # @!attribute variation_selection_mode
+      #   Controls how variations are automatically selected when creating objectives
+      #   Defaults to RANDOM when unspecified
+      #
+      #   @return [Symbol, Cadenya::Models::AgentSpec::VariationSelectionMode]
+      required :variation_selection_mode,
+               enum: -> { Cadenya::AgentSpec::VariationSelectionMode },
+               api_name: :variationSelectionMode
+
+      # @!attribute description
+      #   Description of the agent's purpose
+      #
+      #   @return [String, nil]
+      optional :description, String
+
+      # @!attribute input_data_schema
+      #   InputDataSchema is used for enforcing a data input when objectives are created.
+      #   This is valuable when using liquid formatting in agent variation prompts. Input
+      #   data schema is also valuable when using an agent as a sub-agent, as the schema
+      #   is used as the tool's input parameter schema. If omitted, the sub-agent schema
+      #   will be loaded with a simple "prompt" free text string as its schema.
+      #
+      #   @return [Object, nil]
+      optional :input_data_schema, Cadenya::Internal::Type::Unknown, api_name: :inputDataSchema
+
+      # @!attribute webhook_events_url
+      #   The URL that Cadenya will send events for any objective assigned to the agent.
+      #
+      #   @return [String, nil]
+      optional :webhook_events_url, String, api_name: :webhookEventsUrl
+
+      # @!method initialize(status:, variation_selection_mode:, description: nil, input_data_schema: nil, webhook_events_url: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::AgentSpec} for more details.
+      #
+      #   Agent specification (user-provided configuration)
+      #
+      #   @param status [Symbol, Cadenya::Models::AgentSpec::Status] Status of the agent
+      #
+      #   @param variation_selection_mode [Symbol, Cadenya::Models::AgentSpec::VariationSelectionMode] Controls how variations are automatically selected when creating objectives
+      #
+      #   @param description [String] Description of the agent's purpose
+      #
+      #   @param input_data_schema [Object] InputDataSchema is used for enforcing a data input when objectives are created.
+      #
+      #   @param webhook_events_url [String] The URL that Cadenya will send events for any objective assigned to the agent.
+
+      # Status of the agent
+      #
+      # @see Cadenya::Models::AgentSpec#status
+      module Status
+        extend Cadenya::Internal::Type::Enum
+
+        AGENT_STATUS_UNSPECIFIED = :AGENT_STATUS_UNSPECIFIED
+        AGENT_STATUS_DRAFT = :AGENT_STATUS_DRAFT
+        AGENT_STATUS_PUBLISHED = :AGENT_STATUS_PUBLISHED
+        AGENT_STATUS_ARCHIVED = :AGENT_STATUS_ARCHIVED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Controls how variations are automatically selected when creating objectives
+      # Defaults to RANDOM when unspecified
+      #
+      # @see Cadenya::Models::AgentSpec#variation_selection_mode
+      module VariationSelectionMode
+        extend Cadenya::Internal::Type::Enum
+
+        VARIATION_SELECTION_MODE_UNSPECIFIED = :VARIATION_SELECTION_MODE_UNSPECIFIED
+        VARIATION_SELECTION_MODE_RANDOM = :VARIATION_SELECTION_MODE_RANDOM
+        VARIATION_SELECTION_MODE_WEIGHTED = :VARIATION_SELECTION_MODE_WEIGHTED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/agent_update_params.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Agents#update
+    class AgentUpdateParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      # @!attribute workspace_id
+      #
+      #   @return [String]
+      required :workspace_id, String
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute metadata
+      #   UpdateResourceMetadata contains the user-provided fields for updating a
+      #   workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
+      #   profile_id, created_at) are excluded since they are set by the server.
+      #
+      #   @return [Cadenya::Models::UpdateResourceMetadata, nil]
+      optional :metadata, -> { Cadenya::UpdateResourceMetadata }
+
+      # @!attribute spec
+      #   Agent specification (user-provided configuration)
+      #
+      #   @return [Cadenya::Models::AgentSpec, nil]
+      optional :spec, -> { Cadenya::AgentSpec }
+
+      # @!attribute update_mask
+      #   Fields to update
+      #
+      #   @return [String, nil]
+      optional :update_mask, String, api_name: :updateMask
+
+      # @!method initialize(workspace_id:, id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::AgentUpdateParams} for more details.
+      #
+      #   @param workspace_id [String]
+      #
+      #   @param id [String]
+      #
+      #   @param metadata [Cadenya::Models::UpdateResourceMetadata] UpdateResourceMetadata contains the user-provided fields for updating
+      #
+      #   @param spec [Cadenya::Models::AgentSpec] Agent specification (user-provided configuration)
+      #
+      #   @param update_mask [String] Fields to update
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/agent_variation_entry.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AgentVariationEntry < Cadenya::Internal::Type::BaseModel
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute spec
+      #   AgentVariationSpec defines the operational configuration for a variation
+      #
+      #   @return [Cadenya::Models::Agents::AgentVariationSpec]
+      required :spec, -> { Cadenya::Agents::AgentVariationSpec }
+
+      # @!attribute assignments
+      #   Reconciled list — server adjusts the variation's assignments to exactly this set
+      #   when the variation is bundle-owned.
+      #
+      #   @return [Array<Cadenya::Models::VariationAssignmentEntry>, nil]
+      optional :assignments, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::VariationAssignmentEntry] }
+
+      # @!attribute labels
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :labels, Cadenya::Internal::Type::HashOf[String]
+
+      # @!attribute memory_layers
+      #   Reconciled list of memory layer assignments. Up to 10 entries.
+      #
+      #   @return [Array<Cadenya::Models::VariationMemoryLayerEntry>, nil]
+      optional :memory_layers,
+               -> { Cadenya::Internal::Type::ArrayOf[Cadenya::VariationMemoryLayerEntry] },
+               api_name: :memoryLayers
+
+      # @!method initialize(name:, spec:, assignments: nil, labels: nil, memory_layers: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::AgentVariationEntry} for more details.
+      #
+      #   @param name [String]
+      #
+      #   @param spec [Cadenya::Models::Agents::AgentVariationSpec] AgentVariationSpec defines the operational configuration for a variation
+      #
+      #   @param assignments [Array<Cadenya::Models::VariationAssignmentEntry>] Reconciled list — server adjusts the variation's assignments to
+      #
+      #   @param labels [Hash{Symbol=>String}]
+      #
+      #   @param memory_layers [Array<Cadenya::Models::VariationMemoryLayerEntry>] Reconciled list of memory layer assignments. Up to 10 entries.
+    end
+  end
+end

data/lib/cadenya/models/agents/agent_schedule.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Schedules#create
+      class AgentSchedule < Cadenya::Internal::Type::BaseModel
+        # @!attribute metadata
+        #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @return [Cadenya::Models::ResourceMetadata]
+        required :metadata, -> { Cadenya::ResourceMetadata }
+
+        # @!attribute spec
+        #   AgentScheduleSpec is the user-provided configuration for a schedule.
+        #
+        #   @return [Cadenya::Models::Agents::AgentScheduleSpec]
+        required :spec, -> { Cadenya::Agents::AgentScheduleSpec }
+
+        # @!attribute info
+        #   AgentScheduleInfo provides read-only runtime data about a schedule.
+        #
+        #   @return [Cadenya::Models::Agents::AgentScheduleInfo, nil]
+        optional :info, -> { Cadenya::Agents::AgentScheduleInfo }
+
+        # @!method initialize(metadata:, spec:, info: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::AgentSchedule} for more details.
+        #
+        #   AgentSchedule resource — a recurring trigger attached to an agent that creates
+        #   objectives on its cadence.
+        #
+        #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @param spec [Cadenya::Models::Agents::AgentScheduleSpec] AgentScheduleSpec is the user-provided configuration for a schedule.
+        #
+        #   @param info [Cadenya::Models::Agents::AgentScheduleInfo] AgentScheduleInfo provides read-only runtime data about a schedule.
+      end
+    end
+
+    AgentSchedule = Agents::AgentSchedule
+  end
+end

data/lib/cadenya/models/agents/agent_schedule_info.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class AgentScheduleInfo < Cadenya::Internal::Type::BaseModel
+        # @!attribute created_by
+        #   A profile identifies a user or non-human principal (such as an API key) at the
+        #   account level. Profiles are account-scoped and can be granted access to multiple
+        #   workspaces.
+        #
+        #   @return [Cadenya::Models::Profile, nil]
+        optional :created_by, -> { Cadenya::Profile }, api_name: :createdBy
+
+        response_only do
+          # @!attribute last_fire_at
+          #   When the schedule last fired (regardless of objective outcome).
+          #
+          #   @return [Time, nil]
+          optional :last_fire_at, Time, api_name: :lastFireAt
+
+          # @!attribute last_objective_id
+          #   ID of the most recent objective the schedule created.
+          #
+          #   @return [String, nil]
+          optional :last_objective_id, String, api_name: :lastObjectiveId
+
+          # @!attribute last_skipped_at
+          #   When the schedule most recently skipped a fire (SKIP policy + prior in flight).
+          #
+          #   @return [Time, nil]
+          optional :last_skipped_at, Time, api_name: :lastSkippedAt
+
+          # @!attribute last_skip_reason
+          #   Reason for the most recent skip (e.g. "previous objective still running").
+          #
+          #   @return [String, nil]
+          optional :last_skip_reason, String, api_name: :lastSkipReason
+
+          # @!attribute next_fire_at
+          #   When the schedule will next fire. Computed from the spec; absent when the
+          #   schedule is PAUSED/ARCHIVED or has no future fire times.
+          #
+          #   @return [Time, nil]
+          optional :next_fire_at, Time, api_name: :nextFireAt
+
+          # @!attribute total_fires
+          #   Lifetime count of objectives created by this schedule.
+          #
+          #   @return [Integer, nil]
+          optional :total_fires, Integer, api_name: :totalFires
+        end
+
+        # @!method initialize(created_by: nil, last_fire_at: nil, last_objective_id: nil, last_skipped_at: nil, last_skip_reason: nil, next_fire_at: nil, total_fires: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::AgentScheduleInfo} for more details.
+        #
+        #   AgentScheduleInfo provides read-only runtime data about a schedule.
+        #
+        #   @param created_by [Cadenya::Models::Profile] A profile identifies a user or non-human principal (such as an API key)
+        #
+        #   @param last_fire_at [Time] When the schedule last fired (regardless of objective outcome).
+        #
+        #   @param last_objective_id [String] ID of the most recent objective the schedule created.
+        #
+        #   @param last_skipped_at [Time] When the schedule most recently skipped a fire (SKIP policy + prior in flight).
+        #
+        #   @param last_skip_reason [String] Reason for the most recent skip (e.g. "previous objective still running").
+        #
+        #   @param next_fire_at [Time] When the schedule will next fire. Computed from the spec; absent when
+        #
+        #   @param total_fires [Integer] Lifetime count of objectives created by this schedule.
+      end
+    end
+
+    AgentScheduleInfo = Agents::AgentScheduleInfo
+  end
+end

data/lib/cadenya/models/agents/agent_schedule_spec.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class AgentScheduleSpec < Cadenya::Internal::Type::BaseModel
+        # @!attribute initial_message
+        #   The initial message passed to CreateObjective on each fire. Becomes the first
+        #   user message in the objective's chat history.
+        #
+        #   @return [String]
+        required :initial_message, String, api_name: :initialMessage
+
+        # @!attribute schedule
+        #   Schedule defines WHEN the schedule fires. Temporal-style structured form: a list
+        #   of calendar rules (wall-clock) and/or interval rules (duration), OR'd together.
+        #   At least one rule is required.
+        #
+        #   @return [Cadenya::Models::Agents::AgentScheduleSpecSchedule]
+        required :schedule, -> { Cadenya::Agents::AgentScheduleSpecSchedule }
+
+        # @!attribute data
+        #   Optional input data passed to the objective. If the agent has an
+        #   input_data_schema, this must satisfy it.
+        #
+        #   @return [Object, nil]
+        optional :data, Cadenya::Internal::Type::Unknown
+
+        # @!attribute overlap_policy
+        #   What to do when the previous run is still in flight. Defaults to SKIP.
+        #
+        #   @return [Symbol, Cadenya::Models::Agents::AgentScheduleSpec::OverlapPolicy, nil]
+        optional :overlap_policy,
+                 enum: -> { Cadenya::Agents::AgentScheduleSpec::OverlapPolicy },
+                 api_name: :overlapPolicy
+
+        # @!attribute status
+        #   Lifecycle. Defaults to ACTIVE on create when unspecified.
+        #
+        #   @return [Symbol, Cadenya::Models::Agents::AgentScheduleSpec::Status, nil]
+        optional :status, enum: -> { Cadenya::Agents::AgentScheduleSpec::Status }
+
+        # @!attribute variation_id
+        #   Optional explicit variation. When unset, the agent's variation_selection_mode
+        #   chooses per fire.
+        #
+        #   @return [String, nil]
+        optional :variation_id, String, api_name: :variationId
+
+        # @!method initialize(initial_message:, schedule:, data: nil, overlap_policy: nil, status: nil, variation_id: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::AgentScheduleSpec} for more details.
+        #
+        #   AgentScheduleSpec is the user-provided configuration for a schedule.
+        #
+        #   @param initial_message [String] The initial message passed to CreateObjective on each fire. Becomes the
+        #
+        #   @param schedule [Cadenya::Models::Agents::AgentScheduleSpecSchedule] Schedule defines WHEN the schedule fires. Temporal-style structured form:
+        #
+        #   @param data [Object] Optional input data passed to the objective. If the agent has an
+        #
+        #   @param overlap_policy [Symbol, Cadenya::Models::Agents::AgentScheduleSpec::OverlapPolicy] What to do when the previous run is still in flight. Defaults to SKIP.
+        #
+        #   @param status [Symbol, Cadenya::Models::Agents::AgentScheduleSpec::Status] Lifecycle. Defaults to ACTIVE on create when unspecified.
+        #
+        #   @param variation_id [String] Optional explicit variation. When unset, the agent's variation_selection_mode
+
+        # What to do when the previous run is still in flight. Defaults to SKIP.
+        #
+        # @see Cadenya::Models::Agents::AgentScheduleSpec#overlap_policy
+        module OverlapPolicy
+          extend Cadenya::Internal::Type::Enum
+
+          OVERLAP_POLICY_UNSPECIFIED = :OVERLAP_POLICY_UNSPECIFIED
+          OVERLAP_POLICY_ALLOW = :OVERLAP_POLICY_ALLOW
+          OVERLAP_POLICY_SKIP = :OVERLAP_POLICY_SKIP
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Lifecycle. Defaults to ACTIVE on create when unspecified.
+        #
+        # @see Cadenya::Models::Agents::AgentScheduleSpec#status
+        module Status
+          extend Cadenya::Internal::Type::Enum
+
+          AGENT_SCHEDULE_STATUS_UNSPECIFIED = :AGENT_SCHEDULE_STATUS_UNSPECIFIED
+          AGENT_SCHEDULE_STATUS_ACTIVE = :AGENT_SCHEDULE_STATUS_ACTIVE
+          AGENT_SCHEDULE_STATUS_PAUSED = :AGENT_SCHEDULE_STATUS_PAUSED
+          AGENT_SCHEDULE_STATUS_ARCHIVED = :AGENT_SCHEDULE_STATUS_ARCHIVED
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+
+    AgentScheduleSpec = Agents::AgentScheduleSpec
+  end
+end

data/lib/cadenya/models/agents/agent_schedule_spec_schedule.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class AgentScheduleSpecSchedule < Cadenya::Internal::Type::BaseModel
+        # @!attribute calendars
+        #   Wall-clock rules. May be empty if `intervals` is non-empty.
+        #
+        #   @return [Array<Cadenya::Models::Agents::ScheduleCalendar>, nil]
+        optional :calendars, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Agents::ScheduleCalendar] }
+
+        # @!attribute intervals
+        #   Duration-based rules. May be empty if `calendars` is non-empty.
+        #
+        #   @return [Array<Cadenya::Models::Agents::ScheduleInterval>, nil]
+        optional :intervals, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Agents::ScheduleInterval] }
+
+        # @!attribute timezone
+        #   IANA tz name (e.g. "America/New_York"). Required. Applies to calendars;
+        #   intervals fire on wall-clock cadence anchored in this zone.
+        #
+        #   @return [String, nil]
+        optional :timezone, String
+
+        # @!method initialize(calendars: nil, intervals: nil, timezone: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::AgentScheduleSpecSchedule} for more details.
+        #
+        #   Schedule defines WHEN the schedule fires. Temporal-style structured form: a list
+        #   of calendar rules (wall-clock) and/or interval rules (duration), OR'd together.
+        #   At least one rule is required.
+        #
+        #   @param calendars [Array<Cadenya::Models::Agents::ScheduleCalendar>] Wall-clock rules. May be empty if `intervals` is non-empty.
+        #
+        #   @param intervals [Array<Cadenya::Models::Agents::ScheduleInterval>] Duration-based rules. May be empty if `calendars` is non-empty.
+        #
+        #   @param timezone [String] IANA tz name (e.g. "America/New_York"). Required. Applies to calendars;
+      end
+    end
+
+    AgentScheduleSpecSchedule = Agents::AgentScheduleSpecSchedule
+  end
+end

data/lib/cadenya/models/agents/agent_variation.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Variations#create
+      class AgentVariation < Cadenya::Internal::Type::BaseModel
+        # @!attribute metadata
+        #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @return [Cadenya::Models::ResourceMetadata]
+        required :metadata, -> { Cadenya::ResourceMetadata }
+
+        # @!attribute spec
+        #   AgentVariationSpec defines the operational configuration for a variation
+        #
+        #   @return [Cadenya::Models::Agents::AgentVariationSpec]
+        required :spec, -> { Cadenya::Agents::AgentVariationSpec }
+
+        response_only do
+          # @!attribute info
+          #   AgentVariationInfo provides read-only summary information about a variation
+          #
+          #   @return [Cadenya::Models::Agents::AgentVariationInfo, nil]
+          optional :info, -> { Cadenya::Agents::AgentVariationInfo }
+        end
+
+        # @!method initialize(metadata:, spec:, info: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::AgentVariation} for more details.
+        #
+        #   AgentVariation resource
+        #
+        #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @param spec [Cadenya::Models::Agents::AgentVariationSpec] AgentVariationSpec defines the operational configuration for a variation
+        #
+        #   @param info [Cadenya::Models::Agents::AgentVariationInfo] AgentVariationInfo provides read-only summary information about a variation
+      end
+    end
+
+    AgentVariation = Agents::AgentVariation
+  end
+end

data/lib/cadenya/models/agents/agent_variation_info.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class AgentVariationInfo < Cadenya::Internal::Type::BaseModel
+        # @!attribute created_by
+        #   A profile identifies a user or non-human principal (such as an API key) at the
+        #   account level. Profiles are account-scoped and can be granted access to multiple
+        #   workspaces.
+        #
+        #   @return [Cadenya::Models::Profile, nil]
+        optional :created_by, -> { Cadenya::Profile }, api_name: :createdBy
+
+        # @!attribute feedback_count
+        #   Total number of objective feedbacks received for this variation
+        #
+        #   @return [Integer, nil]
+        optional :feedback_count, Integer, api_name: :feedbackCount
+
+        # @!attribute score
+        #   Thompson Sampling score: posterior mean of Beta(ts_alpha, ts_beta). Range [0, 1]
+        #   where 0.5 = neutral, >0.5 = positive, <0.5 = negative.
+        #
+        #   @return [Float, nil]
+        optional :score, Float
+
+        response_only do
+          # @!attribute assignments
+          #   All tools, tool sets, and sub-agents assigned to this variation. Populated on
+          #   reads so clients can render a variation's full assignment list without calling
+          #   the add/remove endpoints just to enumerate.
+          #
+          #   @return [Array<Cadenya::Models::Agents::VariationAssignment>, nil]
+          optional :assignments, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Agents::VariationAssignment] }
+
+          # @!attribute memory_layer_assignments
+          #   Read-only list of memory layer assignments for this variation, returned in
+          #   ascending `position` (bottom → top). Capped at 10 entries.
+          #
+          #   @return [Array<Cadenya::Models::Agents::VariationMemoryLayerAssignment>, nil]
+          optional :memory_layer_assignments,
+                   -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Agents::VariationMemoryLayerAssignment] },
+                   api_name: :memoryLayerAssignments
+
+          # @!attribute memory_layer_count
+          #   Count of memory layer assignments.
+          #
+          #   @return [Integer, nil]
+          optional :memory_layer_count, Integer, api_name: :memoryLayerCount
+
+          # @!attribute model
+          #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+          #
+          #   @return [Cadenya::Models::ResourceMetadata, nil]
+          optional :model, -> { Cadenya::ResourceMetadata }
+
+          # @!attribute sub_agent_count
+          #   Number of sub-agents assigned to this variation
+          #
+          #   @return [Integer, nil]
+          optional :sub_agent_count, Integer, api_name: :subAgentCount
+
+          # @!attribute tool_count
+          #   Number of individual tools assigned to this variation
+          #
+          #   @return [Integer, nil]
+          optional :tool_count, Integer, api_name: :toolCount
+
+          # @!attribute tool_set_count
+          #   Number of tool sets assigned to this variation
+          #
+          #   @return [Integer, nil]
+          optional :tool_set_count, Integer, api_name: :toolSetCount
+        end
+
+        # @!method initialize(assignments: nil, created_by: nil, feedback_count: nil, memory_layer_assignments: nil, memory_layer_count: nil, model: nil, score: nil, sub_agent_count: nil, tool_count: nil, tool_set_count: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::AgentVariationInfo} for more details.
+        #
+        #   AgentVariationInfo provides read-only summary information about a variation
+        #
+        #   @param assignments [Array<Cadenya::Models::Agents::VariationAssignment>] All tools, tool sets, and sub-agents assigned to this variation.
+        #
+        #   @param created_by [Cadenya::Models::Profile] A profile identifies a user or non-human principal (such as an API key)
+        #
+        #   @param feedback_count [Integer] Total number of objective feedbacks received for this variation
+        #
+        #   @param memory_layer_assignments [Array<Cadenya::Models::Agents::VariationMemoryLayerAssignment>] Read-only list of memory layer assignments for this variation,
+        #
+        #   @param memory_layer_count [Integer] Count of memory layer assignments.
+        #
+        #   @param model [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @param score [Float] Thompson Sampling score: posterior mean of Beta(ts_alpha, ts_beta).
+        #
+        #   @param sub_agent_count [Integer] Number of sub-agents assigned to this variation
+        #
+        #   @param tool_count [Integer] Number of individual tools assigned to this variation
+        #
+        #   @param tool_set_count [Integer] Number of tool sets assigned to this variation
+      end
+    end
+
+    AgentVariationInfo = Agents::AgentVariationInfo
+  end
+end