cadenya 0.1.0

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

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Schedules#list
+      class ScheduleListParams < 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 agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute bundle_key
+        #   Filter by bundle_key — return only resources owned by this bundle.
+        #
+        #   @return [String, nil]
+        optional :bundle_key, String
+
+        # @!attribute cursor
+        #   Pagination cursor from previous response.
+        #
+        #   @return [String, nil]
+        optional :cursor, String
+
+        # @!attribute include_info
+        #   When true, the `info` field on each returned schedule is populated. Requests
+        #   with this flag count more against your rate limit.
+        #
+        #   @return [Boolean, nil]
+        optional :include_info, Cadenya::Internal::Type::Boolean
+
+        # @!attribute limit
+        #   Maximum number of results to return.
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute prefix
+        #   Filter expression (query param: prefix).
+        #
+        #   @return [String, nil]
+        optional :prefix, String
+
+        # @!attribute query
+        #   Free-form search query.
+        #
+        #   @return [String, nil]
+        optional :query, String
+
+        # @!attribute sort_order
+        #   Sort order for results (asc or desc by creation time).
+        #
+        #   @return [String, nil]
+        optional :sort_order, String
+
+        # @!method initialize(workspace_id:, agent_id:, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::ScheduleListParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param agent_id [String]
+        #
+        #   @param bundle_key [String] Filter by bundle_key — return only resources owned by this bundle.
+        #
+        #   @param cursor [String] Pagination cursor from previous response.
+        #
+        #   @param include_info [Boolean] When true, the `info` field on each returned schedule is populated.
+        #
+        #   @param limit [Integer] Maximum number of results to return.
+        #
+        #   @param prefix [String] Filter expression (query param: prefix).
+        #
+        #   @param query [String] Free-form search query.
+        #
+        #   @param sort_order [String] Sort order for results (asc or desc by creation time).
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class ScheduleRange < Cadenya::Internal::Type::BaseModel
+        # @!attribute end_
+        #
+        #   @return [Integer, nil]
+        optional :end_, Integer, api_name: :end
+
+        # @!attribute start
+        #
+        #   @return [Integer, nil]
+        optional :start, Integer
+
+        # @!attribute step
+        #
+        #   @return [Integer, nil]
+        optional :step, Integer
+
+        # @!method initialize(end_: nil, start: nil, step: nil)
+        #   Inclusive numeric range with optional step. {start: 9} → 9 {start: 9, end: 17} →
+        #   9..17 {start: 0, end: 59, step: 15} → 0,15,30,45 `end` defaults to `start`;
+        #   `step` defaults to 1.
+        #
+        #   @param end_ [Integer]
+        #   @param start [Integer]
+        #   @param step [Integer]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Schedules#retrieve
+      class ScheduleRetrieveParams < 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 agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(workspace_id:, agent_id:, id:, request_options: {})
+        #   @param workspace_id [String]
+        #   @param agent_id [String]
+        #   @param id [String]
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Schedules#update
+      class ScheduleUpdateParams < 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 agent_id
+        #
+        #   @return [String]
+        required :agent_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
+        #   AgentScheduleSpec is the user-provided configuration for a schedule.
+        #
+        #   @return [Cadenya::Models::Agents::AgentScheduleSpec, nil]
+        optional :spec, -> { Cadenya::Agents::AgentScheduleSpec }
+
+        # @!attribute update_mask
+        #   Fields to update.
+        #
+        #   @return [String, nil]
+        optional :update_mask, String, api_name: :updateMask
+
+        # @!method initialize(workspace_id:, agent_id:, id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::ScheduleUpdateParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param agent_id [String]
+        #
+        #   @param id [String]
+        #
+        #   @param metadata [Cadenya::Models::UpdateResourceMetadata] UpdateResourceMetadata contains the user-provided fields for updating
+        #
+        #   @param spec [Cadenya::Models::Agents::AgentScheduleSpec] AgentScheduleSpec is the user-provided configuration for a schedule.
+        #
+        #   @param update_mask [String] Fields to update.
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Variations#add_assignment
+      class VariationAddAssignmentParams < 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 agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute variation_id
+        #
+        #   @return [String]
+        required :variation_id, String
+
+        # @!attribute sub_agent_id
+        #
+        #   @return [String, nil]
+        optional :sub_agent_id, String, api_name: :subAgentId
+
+        # @!attribute tool_id
+        #
+        #   @return [String, nil]
+        optional :tool_id, String, api_name: :toolId
+
+        # @!attribute tool_set_id
+        #
+        #   @return [String, nil]
+        optional :tool_set_id, String, api_name: :toolSetId
+
+        # @!method initialize(workspace_id:, agent_id:, variation_id:, sub_agent_id: nil, tool_id: nil, tool_set_id: nil, request_options: {})
+        #   @param workspace_id [String]
+        #   @param agent_id [String]
+        #   @param variation_id [String]
+        #   @param sub_agent_id [String]
+        #   @param tool_id [String]
+        #   @param tool_set_id [String]
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Variations#add_memory_layer
+      class VariationAddMemoryLayerParams < 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 agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute variation_id
+        #
+        #   @return [String]
+        required :variation_id, String
+
+        # @!attribute memory_layer_id
+        #   Layer to attach. Accepts the canonical `memlyr_…` form or the
+        #   `external_id:<value>` form.
+        #
+        #   @return [String, nil]
+        optional :memory_layer_id, String, api_name: :memoryLayerId
+
+        # @!attribute position
+        #   Position in the stack. If omitted, server appends (max existing position + 1).
+        #
+        #   @return [Integer, nil]
+        optional :position, Integer
+
+        # @!method initialize(workspace_id:, agent_id:, variation_id:, memory_layer_id: nil, position: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::VariationAddMemoryLayerParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param agent_id [String]
+        #
+        #   @param variation_id [String]
+        #
+        #   @param memory_layer_id [String] Layer to attach. Accepts the canonical `memlyr_…` form or the `external_id:<valu
+        #
+        #   @param position [Integer] Position in the stack. If omitted, server appends
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Variations#add_assignment
+      class VariationAssignment < Cadenya::Internal::Type::BaseModel
+        # @!attribute agent
+        #   BareMetadata contains the minimal metadata for a resource: the ID and an
+        #   optional human-readable name. These are used for reference fields where the full
+        #   metadata (account scoping, timestamps, labels, external IDs) is not needed —
+        #   e.g., the tool references inside an agent variation spec or the tools assigned
+        #   to an objective. Both fields are server-populated; clients provide IDs through
+        #   sibling fields rather than by constructing a BareMetadata themselves.
+        #
+        #   @return [Cadenya::Models::BareMetadata, nil]
+        optional :agent, -> { Cadenya::BareMetadata }
+
+        # @!attribute tool
+        #   BareMetadata contains the minimal metadata for a resource: the ID and an
+        #   optional human-readable name. These are used for reference fields where the full
+        #   metadata (account scoping, timestamps, labels, external IDs) is not needed —
+        #   e.g., the tool references inside an agent variation spec or the tools assigned
+        #   to an objective. Both fields are server-populated; clients provide IDs through
+        #   sibling fields rather than by constructing a BareMetadata themselves.
+        #
+        #   @return [Cadenya::Models::BareMetadata, nil]
+        optional :tool, -> { Cadenya::BareMetadata }
+
+        # @!attribute tool_set
+        #   BareMetadata contains the minimal metadata for a resource: the ID and an
+        #   optional human-readable name. These are used for reference fields where the full
+        #   metadata (account scoping, timestamps, labels, external IDs) is not needed —
+        #   e.g., the tool references inside an agent variation spec or the tools assigned
+        #   to an objective. Both fields are server-populated; clients provide IDs through
+        #   sibling fields rather than by constructing a BareMetadata themselves.
+        #
+        #   @return [Cadenya::Models::BareMetadata, nil]
+        optional :tool_set, -> { Cadenya::BareMetadata }, api_name: :toolSet
+
+        response_only do
+          # @!attribute id
+          #
+          #   @return [String, nil]
+          optional :id, String
+        end
+
+        # @!method initialize(id: nil, agent: nil, tool: nil, tool_set: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::VariationAssignment} for more details.
+        #
+        #   A read-only reference to a single tool, tool set, or sub-agent attached to a
+        #   variation. Read the full set of assignments via
+        #   `AgentVariationInfo.assignments`; mutations go through the dedicated add/remove
+        #   assignment endpoints.
+        #
+        #   The `id` identifies the assignment itself (not the referenced resource) and is
+        #   the handle used to remove the assignment. It is returned by the add endpoint and
+        #   present on every entry in `AgentVariationInfo.assignments`.
+        #
+        #   @param id [String]
+        #
+        #   @param agent [Cadenya::Models::BareMetadata] BareMetadata contains the minimal metadata for a resource: the ID and an
+        #
+        #   @param tool [Cadenya::Models::BareMetadata] BareMetadata contains the minimal metadata for a resource: the ID and an
+        #
+        #   @param tool_set [Cadenya::Models::BareMetadata] BareMetadata contains the minimal metadata for a resource: the ID and an
+      end
+    end
+  end
+end

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

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Variations#create
+      class VariationCreateParams < 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 agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute metadata
+        #   CreateResourceMetadata contains the user-provided fields for creating 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::CreateResourceMetadata]
+        required :metadata, -> { Cadenya::CreateResourceMetadata }
+
+        # @!attribute spec
+        #   AgentVariationSpec defines the operational configuration for a variation
+        #
+        #   @return [Cadenya::Models::Agents::AgentVariationSpec]
+        required :spec, -> { Cadenya::Agents::AgentVariationSpec }
+
+        # @!method initialize(workspace_id:, agent_id:, metadata:, spec:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::VariationCreateParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param agent_id [String]
+        #
+        #   @param metadata [Cadenya::Models::CreateResourceMetadata] CreateResourceMetadata contains the user-provided fields for creating
+        #
+        #   @param spec [Cadenya::Models::Agents::AgentVariationSpec] AgentVariationSpec defines the operational configuration for a variation
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Variations#delete
+      class VariationDeleteParams < 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 agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(workspace_id:, agent_id:, id:, request_options: {})
+        #   @param workspace_id [String]
+        #   @param agent_id [String]
+        #   @param id [String]
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Variations#list
+      class VariationListParams < 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 agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute bundle_key
+        #   Filter by bundle_key — return only resources owned by this bundle.
+        #
+        #   @return [String, nil]
+        optional :bundle_key, String
+
+        # @!attribute cursor
+        #   Pagination cursor from previous response
+        #
+        #   @return [String, nil]
+        optional :cursor, String
+
+        # @!attribute include_info
+        #   When true, the `info` field on each returned variation is populated. Requests
+        #   with this flag count more against your rate limit.
+        #
+        #   @return [Boolean, nil]
+        optional :include_info, Cadenya::Internal::Type::Boolean
+
+        # @!attribute limit
+        #   Maximum number of results to return
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute sort_order
+        #   Sort order for results (asc or desc by creation time)
+        #
+        #   @return [String, nil]
+        optional :sort_order, String
+
+        # @!method initialize(workspace_id:, agent_id:, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, sort_order: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::VariationListParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param agent_id [String]
+        #
+        #   @param bundle_key [String] Filter by bundle_key — return only resources owned by this bundle.
+        #
+        #   @param cursor [String] Pagination cursor from previous response
+        #
+        #   @param include_info [Boolean] When true, the `info` field on each returned variation is populated.
+        #
+        #   @param limit [Integer] Maximum number of results to return
+        #
+        #   @param sort_order [String] Sort order for results (asc or desc by creation time)
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Variations#add_memory_layer
+      class VariationMemoryLayerAssignment < Cadenya::Internal::Type::BaseModel
+        # @!attribute memory_layer
+        #   BareMetadata contains the minimal metadata for a resource: the ID and an
+        #   optional human-readable name. These are used for reference fields where the full
+        #   metadata (account scoping, timestamps, labels, external IDs) is not needed —
+        #   e.g., the tool references inside an agent variation spec or the tools assigned
+        #   to an objective. Both fields are server-populated; clients provide IDs through
+        #   sibling fields rather than by constructing a BareMetadata themselves.
+        #
+        #   @return [Cadenya::Models::BareMetadata, nil]
+        optional :memory_layer, -> { Cadenya::BareMetadata }, api_name: :memoryLayer
+
+        # @!attribute position
+        #   Position in the variation's baseline stack. Lower values sit lower; the
+        #   highest-position assignment is on top of the variation's baseline. Gaps are fine
+        #   — only relative position matters. Positions must be unique within a variation; a
+        #   request that would collide with an existing assignment's position is rejected
+        #   with InvalidArgument.
+        #
+        #   @return [Integer, nil]
+        optional :position, Integer
+
+        response_only do
+          # @!attribute id
+          #   Assignment row id — handle for removing the assignment. Distinct from the
+          #   referenced memory layer's id.
+          #
+          #   @return [String, nil]
+          optional :id, String
+        end
+
+        # @!method initialize(id: nil, memory_layer: nil, position: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::VariationMemoryLayerAssignment} for more details.
+        #
+        #   VariationMemoryLayerAssignment attaches a single MemoryLayer to a variation at a
+        #   given position in the variation's baseline memory stack. A variation has at most
+        #   one assignment per memory_layer_id.
+        #
+        #   Variations only support whole-layer attachments — entry pinning is an
+        #   objective-level capability.
+        #
+        #   @param id [String] Assignment row id — handle for removing the assignment. Distinct
+        #
+        #   @param memory_layer [Cadenya::Models::BareMetadata] BareMetadata contains the minimal metadata for a resource: the ID and an
+        #
+        #   @param position [Integer] Position in the variation's baseline stack. Lower values sit lower;
+      end
+    end
+  end
+end

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

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Variations#remove_assignment
+      class VariationRemoveAssignmentParams < 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 agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute variation_id
+        #
+        #   @return [String]
+        required :variation_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(workspace_id:, agent_id:, variation_id:, id:, request_options: {})
+        #   @param workspace_id [String]
+        #   @param agent_id [String]
+        #   @param variation_id [String]
+        #   @param id [String]
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end