cadenya 0.1.0

data/lib/cadenya/resources/agents/schedules.rb

@@ -0,0 +1,219 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Resources
+    class Agents
+      # Manage recurring schedules attached to agents. Schedules trigger objectives on a
+      # cadence defined by AgentScheduleSpec.Schedule.
+      class Schedules
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::ScheduleCreateParams} for more details.
+        #
+        # Creates a new schedule for an agent
+        #
+        # @overload create(agent_id, workspace_id:, metadata:, spec:, request_options: {})
+        #
+        # @param agent_id [String] Path param: Agent ID. Accepts the canonical `agent_…` form or the `external_id:<
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param metadata [Cadenya::Models::CreateResourceMetadata] Body param: CreateResourceMetadata contains the user-provided fields for creatin
+        #
+        # @param spec [Cadenya::Models::Agents::AgentScheduleSpec] Body param: AgentScheduleSpec is the user-provided configuration for a schedule.
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::Agents::AgentSchedule]
+        #
+        # @see Cadenya::Models::Agents::ScheduleCreateParams
+        def create(agent_id, params)
+          parsed, options = Cadenya::Agents::ScheduleCreateParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :post,
+            path: ["v1/workspaces/%1$s/agents/%2$s/schedules", workspace_id, agent_id],
+            body: parsed,
+            model: Cadenya::Agents::AgentSchedule,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::ScheduleRetrieveParams} for more details.
+        #
+        # Retrieves a schedule by ID from an agent
+        #
+        # @overload retrieve(id, workspace_id:, agent_id:, request_options: {})
+        #
+        # @param id [String] Schedule ID. Accepts the canonical `as_…` form or the `external_id:<value>` form
+        #
+        # @param workspace_id [String] Workspace ID.
+        #
+        # @param agent_id [String] Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>` form
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::Agents::AgentSchedule]
+        #
+        # @see Cadenya::Models::Agents::ScheduleRetrieveParams
+        def retrieve(id, params)
+          parsed, options = Cadenya::Agents::ScheduleRetrieveParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          agent_id =
+            parsed.delete(:agent_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["v1/workspaces/%1$s/agents/%2$s/schedules/%3$s", workspace_id, agent_id, id],
+            model: Cadenya::Agents::AgentSchedule,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::ScheduleUpdateParams} for more details.
+        #
+        # Updates a schedule for an agent
+        #
+        # @overload update(id, workspace_id:, agent_id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+        #
+        # @param id [String] Path param: Schedule ID. Accepts the canonical `as_…` form or the `external_id:<
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param agent_id [String] Path param: Agent ID. Accepts the canonical `agent_…` form or the `external_id:<
+        #
+        # @param metadata [Cadenya::Models::UpdateResourceMetadata] Body param: UpdateResourceMetadata contains the user-provided fields for updatin
+        #
+        # @param spec [Cadenya::Models::Agents::AgentScheduleSpec] Body param: AgentScheduleSpec is the user-provided configuration for a schedule.
+        #
+        # @param update_mask [String] Body param: Fields to update.
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::Agents::AgentSchedule]
+        #
+        # @see Cadenya::Models::Agents::ScheduleUpdateParams
+        def update(id, params)
+          parsed, options = Cadenya::Agents::ScheduleUpdateParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          agent_id =
+            parsed.delete(:agent_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :patch,
+            path: ["v1/workspaces/%1$s/agents/%2$s/schedules/%3$s", workspace_id, agent_id, id],
+            body: parsed,
+            model: Cadenya::Agents::AgentSchedule,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::ScheduleListParams} for more details.
+        #
+        # Lists all schedules for an agent
+        #
+        # @overload list(agent_id, workspace_id:, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, request_options: {})
+        #
+        # @param agent_id [String] Path param: Agent ID. Accepts the canonical `agent_…` form or the `external_id:<
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param bundle_key [String] Query param: Filter by bundle_key — return only resources owned by this bundle.
+        #
+        # @param cursor [String] Query param: Pagination cursor from previous response.
+        #
+        # @param include_info [Boolean] Query param: When true, the `info` field on each returned schedule is populated.
+        #
+        # @param limit [Integer] Query param: Maximum number of results to return.
+        #
+        # @param prefix [String] Query param: Filter expression (query param: prefix).
+        #
+        # @param query [String] Query param: Free-form search query.
+        #
+        # @param sort_order [String] Query param: Sort order for results (asc or desc by creation time).
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::Agents::AgentSchedule>]
+        #
+        # @see Cadenya::Models::Agents::ScheduleListParams
+        def list(agent_id, params)
+          parsed, options = Cadenya::Agents::ScheduleListParams.dump_request(params)
+          query = Cadenya::Internal::Util.encode_query_params(parsed)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["v1/workspaces/%1$s/agents/%2$s/schedules", workspace_id, agent_id],
+            query: query.transform_keys(
+              bundle_key: "bundleKey",
+              include_info: "includeInfo",
+              sort_order: "sortOrder"
+            ),
+            page: Cadenya::Internal::CursorPagination,
+            model: Cadenya::Agents::AgentSchedule,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::ScheduleDeleteParams} for more details.
+        #
+        # Deletes a schedule from an agent
+        #
+        # @overload delete(id, workspace_id:, agent_id:, request_options: {})
+        #
+        # @param id [String] Schedule ID. Accepts the canonical `as_…` form or the `external_id:<value>` form
+        #
+        # @param workspace_id [String] Workspace ID.
+        #
+        # @param agent_id [String] Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>` form
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Cadenya::Models::Agents::ScheduleDeleteParams
+        def delete(id, params)
+          parsed, options = Cadenya::Agents::ScheduleDeleteParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          agent_id =
+            parsed.delete(:agent_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :delete,
+            path: ["v1/workspaces/%1$s/agents/%2$s/schedules/%3$s", workspace_id, agent_id, id],
+            model: NilClass,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Cadenya::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/cadenya/resources/agents/variations.rb

@@ -0,0 +1,460 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Resources
+    class Agents
+      # Manage variations of an agent and their tool, sub-agent, and memory layer
+      # assignments.
+      class Variations
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::VariationCreateParams} for more details.
+        #
+        # Creates a new variation for an agent
+        #
+        # @overload create(agent_id, workspace_id:, metadata:, spec:, request_options: {})
+        #
+        # @param agent_id [String] Path param: Agent ID. Accepts the canonical `agent_…` form or the `external_id:<
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param metadata [Cadenya::Models::CreateResourceMetadata] Body param: CreateResourceMetadata contains the user-provided fields for creatin
+        #
+        # @param spec [Cadenya::Models::Agents::AgentVariationSpec] Body param: AgentVariationSpec defines the operational configuration for a varia
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::Agents::AgentVariation]
+        #
+        # @see Cadenya::Models::Agents::VariationCreateParams
+        def create(agent_id, params)
+          parsed, options = Cadenya::Agents::VariationCreateParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :post,
+            path: ["v1/workspaces/%1$s/agents/%2$s/variations", workspace_id, agent_id],
+            body: parsed,
+            model: Cadenya::Agents::AgentVariation,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::VariationRetrieveParams} for more details.
+        #
+        # Retrieves a variation by ID from an agent
+        #
+        # @overload retrieve(id, workspace_id:, agent_id:, request_options: {})
+        #
+        # @param id [String] Variation ID. Accepts the canonical `av_…` form or the `external_id:<value>` for
+        #
+        # @param workspace_id [String] Workspace ID.
+        #
+        # @param agent_id [String] Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>` form
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::Agents::AgentVariation]
+        #
+        # @see Cadenya::Models::Agents::VariationRetrieveParams
+        def retrieve(id, params)
+          parsed, options = Cadenya::Agents::VariationRetrieveParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          agent_id =
+            parsed.delete(:agent_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["v1/workspaces/%1$s/agents/%2$s/variations/%3$s", workspace_id, agent_id, id],
+            model: Cadenya::Agents::AgentVariation,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::VariationUpdateParams} for more details.
+        #
+        # Updates a variation for an agent
+        #
+        # @overload update(id, workspace_id:, agent_id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+        #
+        # @param id [String] Path param: Variation ID. Accepts the canonical `av_…` form or the `external_id:
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param agent_id [String] Path param: Agent ID. Accepts the canonical `agent_…` form or the `external_id:<
+        #
+        # @param metadata [Cadenya::Models::UpdateResourceMetadata] Body param: UpdateResourceMetadata contains the user-provided fields for updatin
+        #
+        # @param spec [Cadenya::Models::Agents::AgentVariationSpec] Body param: AgentVariationSpec defines the operational configuration for a varia
+        #
+        # @param update_mask [String] Body param: Fields to update
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::Agents::AgentVariation]
+        #
+        # @see Cadenya::Models::Agents::VariationUpdateParams
+        def update(id, params)
+          parsed, options = Cadenya::Agents::VariationUpdateParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          agent_id =
+            parsed.delete(:agent_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :patch,
+            path: ["v1/workspaces/%1$s/agents/%2$s/variations/%3$s", workspace_id, agent_id, id],
+            body: parsed,
+            model: Cadenya::Agents::AgentVariation,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::VariationListParams} for more details.
+        #
+        # Lists all variations for an agent
+        #
+        # @overload list(agent_id, workspace_id:, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, sort_order: nil, request_options: {})
+        #
+        # @param agent_id [String] Path param: Agent ID. Accepts the canonical `agent_…` form or the `external_id:<
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param bundle_key [String] Query param: Filter by bundle_key — return only resources owned by this bundle.
+        #
+        # @param cursor [String] Query param: Pagination cursor from previous response
+        #
+        # @param include_info [Boolean] Query param: When true, the `info` field on each returned variation is populated
+        #
+        # @param limit [Integer] Query param: Maximum number of results to return
+        #
+        # @param sort_order [String] Query param: Sort order for results (asc or desc by creation time)
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::Agents::AgentVariation>]
+        #
+        # @see Cadenya::Models::Agents::VariationListParams
+        def list(agent_id, params)
+          parsed, options = Cadenya::Agents::VariationListParams.dump_request(params)
+          query = Cadenya::Internal::Util.encode_query_params(parsed)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["v1/workspaces/%1$s/agents/%2$s/variations", workspace_id, agent_id],
+            query: query.transform_keys(
+              bundle_key: "bundleKey",
+              include_info: "includeInfo",
+              sort_order: "sortOrder"
+            ),
+            page: Cadenya::Internal::CursorPagination,
+            model: Cadenya::Agents::AgentVariation,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::VariationDeleteParams} for more details.
+        #
+        # Deletes a variation from an agent
+        #
+        # @overload delete(id, workspace_id:, agent_id:, request_options: {})
+        #
+        # @param id [String] Variation ID. Accepts the canonical `av_…` form or the `external_id:<value>` for
+        #
+        # @param workspace_id [String] Workspace ID.
+        #
+        # @param agent_id [String] Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>` form
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Cadenya::Models::Agents::VariationDeleteParams
+        def delete(id, params)
+          parsed, options = Cadenya::Agents::VariationDeleteParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          agent_id =
+            parsed.delete(:agent_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :delete,
+            path: ["v1/workspaces/%1$s/agents/%2$s/variations/%3$s", workspace_id, agent_id, id],
+            model: NilClass,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::VariationAddAssignmentParams} for more details.
+        #
+        # Assigns a tool, tool set, or sub-agent to a variation. Exactly one target ID
+        # must be set.
+        #
+        # @overload add_assignment(variation_id, workspace_id:, agent_id:, sub_agent_id: nil, tool_id: nil, tool_set_id: nil, request_options: {})
+        #
+        # @param variation_id [String] Path param: Variation ID. Accepts the canonical `av_…` form or the `external_id:
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param agent_id [String] Path param: Agent ID. Accepts the canonical `agent_…` form or the `external_id:<
+        #
+        # @param sub_agent_id [String] Body param
+        #
+        # @param tool_id [String] Body param
+        #
+        # @param tool_set_id [String] Body param
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::Agents::VariationAssignment]
+        #
+        # @see Cadenya::Models::Agents::VariationAddAssignmentParams
+        def add_assignment(variation_id, params)
+          parsed, options = Cadenya::Agents::VariationAddAssignmentParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          agent_id =
+            parsed.delete(:agent_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :post,
+            path: [
+              "v1/workspaces/%1$s/agents/%2$s/variations/%3$s/assignments",
+              workspace_id,
+              agent_id,
+              variation_id
+            ],
+            body: parsed,
+            model: Cadenya::Agents::VariationAssignment,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::VariationAddMemoryLayerParams} for more details.
+        #
+        # Attaches a memory layer to a variation at a given position in the variation's
+        # baseline memory stack.
+        #
+        # @overload add_memory_layer(variation_id, workspace_id:, agent_id:, memory_layer_id: nil, position: nil, request_options: {})
+        #
+        # @param variation_id [String] Path param: Variation ID. Accepts the canonical `av_…` form or the `external_id:
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param agent_id [String] Path param: Agent ID. Accepts the canonical `agent_…` form or the `external_id:<
+        #
+        # @param memory_layer_id [String] Body param: Layer to attach. Accepts the canonical `memlyr_…` form or the `exter
+        #
+        # @param position [Integer] Body param: Position in the stack. If omitted, server appends
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::Agents::VariationMemoryLayerAssignment]
+        #
+        # @see Cadenya::Models::Agents::VariationAddMemoryLayerParams
+        def add_memory_layer(variation_id, params)
+          parsed, options = Cadenya::Agents::VariationAddMemoryLayerParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          agent_id =
+            parsed.delete(:agent_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :post,
+            path: [
+              "v1/workspaces/%1$s/agents/%2$s/variations/%3$s/memory_layer_assignments",
+              workspace_id,
+              agent_id,
+              variation_id
+            ],
+            body: parsed,
+            model: Cadenya::Agents::VariationMemoryLayerAssignment,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::VariationRemoveAssignmentParams} for more details.
+        #
+        # Detaches an assignment from a variation, identified by the assignment ID
+        # returned when it was added.
+        #
+        # @overload remove_assignment(id, workspace_id:, agent_id:, variation_id:, request_options: {})
+        #
+        # @param id [String]
+        #
+        # @param workspace_id [String] Workspace ID.
+        #
+        # @param agent_id [String] Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>` form
+        #
+        # @param variation_id [String] Variation ID. Accepts the canonical `av_…` form or the `external_id:<value>` for
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Cadenya::Models::Agents::VariationRemoveAssignmentParams
+        def remove_assignment(id, params)
+          parsed, options = Cadenya::Agents::VariationRemoveAssignmentParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          agent_id =
+            parsed.delete(:agent_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          variation_id =
+            parsed.delete(:variation_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :delete,
+            path: [
+              "v1/workspaces/%1$s/agents/%2$s/variations/%3$s/assignments/%4$s",
+              workspace_id,
+              agent_id,
+              variation_id,
+              id
+            ],
+            model: NilClass,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::VariationRemoveMemoryLayerParams} for more details.
+        #
+        # Detaches a memory layer assignment from a variation, identified by the
+        # assignment id.
+        #
+        # @overload remove_memory_layer(id, workspace_id:, agent_id:, variation_id:, request_options: {})
+        #
+        # @param id [String]
+        #
+        # @param workspace_id [String] Workspace ID.
+        #
+        # @param agent_id [String] Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>` form
+        #
+        # @param variation_id [String] Variation ID. Accepts the canonical `av_…` form or the `external_id:<value>` for
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Cadenya::Models::Agents::VariationRemoveMemoryLayerParams
+        def remove_memory_layer(id, params)
+          parsed, options = Cadenya::Agents::VariationRemoveMemoryLayerParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          agent_id =
+            parsed.delete(:agent_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          variation_id =
+            parsed.delete(:variation_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :delete,
+            path: [
+              "v1/workspaces/%1$s/agents/%2$s/variations/%3$s/memory_layer_assignments/%4$s",
+              workspace_id,
+              agent_id,
+              variation_id,
+              id
+            ],
+            model: NilClass,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::VariationUpdateMemoryLayerParams} for more details.
+        #
+        # Updates the position of a memory layer assignment on a variation.
+        #
+        # @overload update_memory_layer(id, workspace_id:, agent_id:, variation_id:, position: nil, request_options: {})
+        #
+        # @param id [String] Path param
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param agent_id [String] Path param: Agent ID. Accepts the canonical `agent_…` form or the `external_id:<
+        #
+        # @param variation_id [String] Path param: Variation ID. Accepts the canonical `av_…` form or the `external_id:
+        #
+        # @param position [Integer] Body param: New position. Only field currently updatable on an assignment.
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::Agents::VariationMemoryLayerAssignment]
+        #
+        # @see Cadenya::Models::Agents::VariationUpdateMemoryLayerParams
+        def update_memory_layer(id, params)
+          parsed, options = Cadenya::Agents::VariationUpdateMemoryLayerParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          agent_id =
+            parsed.delete(:agent_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          variation_id =
+            parsed.delete(:variation_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :patch,
+            path: [
+              "v1/workspaces/%1$s/agents/%2$s/variations/%3$s/memory_layer_assignments/%4$s",
+              workspace_id,
+              agent_id,
+              variation_id,
+              id
+            ],
+            body: parsed,
+            model: Cadenya::Agents::VariationMemoryLayerAssignment,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Cadenya::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end