cadenya 0.9.0 → 0.11.0

data/rbi/cadenya/resources/agents/schedules.rbi

@@ -153,6 +153,76 @@ module Cadenya
         )
         end
 
+        # Transitions a schedule to STATE_ARCHIVED and removes its underlying timer.
+        # Archiving is terminal: archived schedules never fire and cannot be reactivated;
+        # create a new schedule instead.
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            agent_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Agents::AgentSchedule)
+        end
+        def archive(
+          # Schedule ID. Accepts the canonical `as_…` form or the `external_id:<value>`
+          # form.
+          id,
+          # Workspace ID.
+          workspace_id:,
+          # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+          # form.
+          agent_id:,
+          request_options: {}
+        )
+        end
+
+        # Transitions a schedule to STATE_PAUSED. Paused schedules retain history but do
+        # not fire.
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            agent_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Agents::AgentSchedule)
+        end
+        def pause(
+          # Schedule ID. Accepts the canonical `as_…` form or the `external_id:<value>`
+          # form.
+          id,
+          # Workspace ID.
+          workspace_id:,
+          # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+          # form.
+          agent_id:,
+          request_options: {}
+        )
+        end
+
+        # Transitions a paused schedule back to STATE_ACTIVE so it fires on its cadence
+        # again. Archived schedules cannot be resumed.
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            agent_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Agents::AgentSchedule)
+        end
+        def resume(
+          # Schedule ID. Accepts the canonical `as_…` form or the `external_id:<value>`
+          # form.
+          id,
+          # Workspace ID.
+          workspace_id:,
+          # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+          # form.
+          agent_id:,
+          request_options: {}
+        )
+        end
+
         # @api private
         sig { params(client: Cadenya::Client).returns(T.attached_class) }
         def self.new(client:)

data/rbi/cadenya/resources/agents.rbi

@@ -107,7 +107,7 @@ module Cadenya
           prefix: String,
           query: String,
           sort_order: String,
-          status: Cadenya::AgentListParams::Status::OrSymbol,
+          state: Cadenya::AgentListParams::State::OrSymbol,
           variation_selection_mode:
             Cadenya::AgentListParams::VariationSelectionMode::OrSymbol,
           request_options: Cadenya::RequestOptions::OrHash
@@ -131,8 +131,8 @@ module Cadenya
         query: nil,
         # Sort order for results (asc or desc by creation time)
         sort_order: nil,
-        # Filter by agent publication status
-        status: nil,
+        # Filter by agent lifecycle state
+        state: nil,
         # Filter by variation selection mode
         variation_selection_mode: nil,
         request_options: {}
@@ -157,6 +157,82 @@ module Cadenya
       )
       end
 
+      # Transitions an agent to STATE_ARCHIVED. Archived agents are hidden from list
+      # results and cannot be used for objectives; active schedules are paused.
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Agent)
+      end
+      def archive(
+        # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+        # form.
+        id,
+        # Workspace ID.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
+      # Transitions an agent to STATE_PUBLISHED, making it available for objectives. The
+      # agent must have at least one variation.
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Agent)
+      end
+      def publish(
+        # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+        # form.
+        id,
+        # Workspace ID.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
+      # Transitions an archived agent back to STATE_DRAFT. Publish the agent again to
+      # make it available for objectives.
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Agent)
+      end
+      def unarchive(
+        # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+        # form.
+        id,
+        # Workspace ID.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
+      # Transitions a published agent back to STATE_DRAFT. Active schedules for the
+      # agent are paused until it is published again.
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Agent)
+      end
+      def unpublish(
+        # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+        # form.
+        id,
+        # Workspace ID.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: Cadenya::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/cadenya/resources/models.rbi

@@ -35,7 +35,7 @@ module Cadenya
           prefix: String,
           query: String,
           sort_order: String,
-          status: Cadenya::ModelListParams::Status::OrSymbol,
+          state: Cadenya::ModelListParams::State::OrSymbol,
           request_options: Cadenya::RequestOptions::OrHash
         ).returns(Cadenya::Internal::CursorPagination[Cadenya::Model])
       end
@@ -60,28 +60,44 @@ module Cadenya
         query: nil,
         # Sort order for results (asc or desc by creation time)
         sort_order: nil,
-        # Filter by model status
-        status: nil,
+        # Filter by model state
+        state: nil,
         request_options: {}
       )
       end
 
-      # Enables or disables a model in the workspace
+      # Transitions a model to STATE_DISABLED. Fails while agent variations are still
+      # provisioned on the model; use :swapModelOnVariations to move them first.
       sig do
         params(
           id: String,
           workspace_id: String,
-          status: Cadenya::ModelSetStatusParams::Status::OrSymbol,
           request_options: Cadenya::RequestOptions::OrHash
         ).returns(Cadenya::Model)
       end
-      def set_status(
-        # Path param: Model ID
+      def disable(
+        # Model ID
         id,
-        # Path param: Workspace ID.
+        # Workspace ID.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
+      # Transitions a model to STATE_ENABLED, making it available for agent variations
+      # in the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Model)
+      end
+      def enable(
+        # Model ID
+        id,
+        # Workspace ID.
         workspace_id:,
-        # Body param: The new status for the model
-        status: nil,
         request_options: {}
       )
       end

data/rbi/cadenya/resources/objectives.rbi

@@ -25,6 +25,7 @@ module Cadenya
           memory_stack: T::Array[Cadenya::MemoryReference::OrHash],
           metadata: Cadenya::CreateOperationMetadata::OrHash,
           secrets: T::Array[Cadenya::ObjectiveCreateParams::Secret::OrHash],
+          user_data: T::Hash[Symbol, T.anything],
           variation_id: String,
           request_options: Cadenya::RequestOptions::OrHash
         ).returns(Cadenya::Objective)
@@ -35,9 +36,11 @@ module Cadenya
         # Arbitrary data for the objective. May be used in liquid templates for prompts
         # configured on the agent variation
         data:,
-        # Optional override for initial message sent to the agent. This becomes the first
-        # user message in the LLM chat history. The agent variation is used to set this if
-        # not present.
+        # Optional override for the initial message sent to the agent. This becomes the
+        # first user message in the LLM chat history. When not set, the selected
+        # variation's user_message_template is rendered with user_data instead. If neither
+        # this field nor a user_message_template is present, the request is rejected with
+        # InvalidArgument.
         initial_message: nil,
         # Memory layers/entries to push onto this objective's memory stack on top of the
         # baseline stack inherited from the selected variation.
@@ -62,6 +65,10 @@ module Cadenya
         # Secrets that can be used in the headers for tool calls using the secret
         # interpolation format.
         secrets: nil,
+        # Arbitrary data rendered into the selected variation's user_message_template
+        # (liquid) to produce the initial user message. Separate from `data`, which
+        # renders the system prompt template.
+        user_data: nil,
         # Optional explicit variation selection. Overrides the agent's
         # variation_selection_mode.
         variation_id: nil,

data/rbi/cadenya/resources/tool_sets/tools.rbi

@@ -104,8 +104,8 @@ module Cadenya
             query: String,
             requires_approval: T::Boolean,
             sort_order: String,
-            statuses:
-              T::Array[Cadenya::ToolSets::ToolListParams::Status::OrSymbol],
+            states:
+              T::Array[Cadenya::ToolSets::ToolListParams::State::OrSymbol],
             request_options: Cadenya::RequestOptions::OrHash
           ).returns(
             Cadenya::Internal::CursorPagination[Cadenya::ToolSets::Tool]
@@ -137,8 +137,8 @@ module Cadenya
           requires_approval: nil,
           # Query param: Sort order for results (asc or desc by creation time)
           sort_order: nil,
-          # Query param: Filter by tool status. Multiple values are OR'd together.
-          statuses: nil,
+          # Query param: Filter by tool state. Multiple values are OR'd together.
+          states: nil,
           request_options: {}
         )
         end
@@ -163,6 +163,48 @@ module Cadenya
         )
         end
 
+        # Transitions a tool to STATE_OMITTED, excluding it from agent use. Fails if the
+        # tool is currently assigned to agent variations.
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            tool_set_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::ToolSets::Tool)
+        end
+        def omit(
+          # Tool ID. Accepts the canonical tool\_… form or the external_id:<value> form.
+          id,
+          # Workspace ID.
+          workspace_id:,
+          # Tool set ID. Accepts the canonical ts\_… form or the external_id:<value> form.
+          tool_set_id:,
+          request_options: {}
+        )
+        end
+
+        # Transitions an omitted tool back to STATE_AVAILABLE. For managed tool sets, the
+        # next sync may omit the tool again if its filters still exclude it.
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            tool_set_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::ToolSets::Tool)
+        end
+        def restore(
+          # Tool ID. Accepts the canonical tool\_… form or the external_id:<value> form.
+          id,
+          # Workspace ID.
+          workspace_id:,
+          # Tool set ID. Accepts the canonical ts\_… form or the external_id:<value> form.
+          tool_set_id:,
+          request_options: {}
+        )
+        end
+
         # @api private
         sig { params(client: Cadenya::Client).returns(T.attached_class) }
         def self.new(client:)

data/rbi/cadenya/resources/tool_sets.rbi

@@ -95,6 +95,7 @@ module Cadenya
           prefix: String,
           query: String,
           sort_order: String,
+          state: Cadenya::ToolSetListParams::State::OrSymbol,
           request_options: Cadenya::RequestOptions::OrHash
         ).returns(Cadenya::Internal::CursorPagination[Cadenya::ToolSet])
       end
@@ -115,6 +116,9 @@ module Cadenya
         query: nil,
         # Sort order for results (asc or desc by creation time)
         sort_order: nil,
+        # Filter by tool set lifecycle state. Defaults to STATE_ACTIVE when unspecified;
+        # pass STATE_ARCHIVED to list archived tool sets.
+        state: nil,
         request_options: {}
       )
       end
@@ -136,6 +140,27 @@ module Cadenya
       )
       end
 
+      # Transitions a tool set to STATE_ARCHIVED. Syncing stops, the tool set is hidden
+      # from list results, its tools are no longer offered to objectives, and new
+      # variation assignments are rejected. Existing assignments are retained, and
+      # history is preserved — unlike delete, archiving works while the tool set is
+      # still assigned to agent variations.
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::ToolSet)
+      end
+      def archive(
+        # Tool set ID. Accepts the canonical ts\_… form or the external_id:<value> form.
+        id,
+        # Workspace ID.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
       # Retrieves the current OpenAPI specification JSON that has been consumed by the
       # tool set. Only applicable to tool sets using the OpenAPI adapter.
       sig do
@@ -184,6 +209,25 @@ module Cadenya
       )
       end
 
+      # Transitions an archived tool set back to STATE_ACTIVE. Managed tool sets resume
+      # syncing on their next cycle and their tools become available to objectives
+      # again.
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::ToolSet)
+      end
+      def unarchive(
+        # Tool set ID. Accepts the canonical ts\_… form or the external_id:<value> form.
+        id,
+        # Workspace ID.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: Cadenya::Client).returns(T.attached_class) }
       def self.new(client:)

data/sig/cadenya/models/agent.rbs

@@ -4,6 +4,7 @@ module Cadenya
       {
         metadata: Cadenya::ResourceMetadata,
         spec: Cadenya::AgentSpec,
+        state: Cadenya::Models::Agent::state,
         info: Cadenya::AgentInfo
       }
 
@@ -12,6 +13,8 @@ module Cadenya
 
       attr_accessor spec: Cadenya::AgentSpec
 
+      attr_accessor state: Cadenya::Models::Agent::state
+
       attr_reader info: Cadenya::AgentInfo?
 
       def info=: (Cadenya::AgentInfo) -> Cadenya::AgentInfo
@@ -19,14 +22,30 @@ module Cadenya
       def initialize: (
         metadata: Cadenya::ResourceMetadata,
         spec: Cadenya::AgentSpec,
+        state: Cadenya::Models::Agent::state,
         ?info: Cadenya::AgentInfo
       ) -> void
 
       def to_hash: -> {
         metadata: Cadenya::ResourceMetadata,
         spec: Cadenya::AgentSpec,
+        state: Cadenya::Models::Agent::state,
         info: Cadenya::AgentInfo
       }
+
+      type state =
+        :STATE_UNSPECIFIED | :STATE_DRAFT | :STATE_PUBLISHED | :STATE_ARCHIVED
+
+      module State
+        extend Cadenya::Internal::Type::Enum
+
+        STATE_UNSPECIFIED: :STATE_UNSPECIFIED
+        STATE_DRAFT: :STATE_DRAFT
+        STATE_PUBLISHED: :STATE_PUBLISHED
+        STATE_ARCHIVED: :STATE_ARCHIVED
+
+        def self?.values: -> ::Array[Cadenya::Models::Agent::state]
+      end
     end
   end
 end

data/sig/cadenya/models/agent_archive_params.rbs

@@ -0,0 +1,28 @@
+module Cadenya
+  module Models
+    type agent_archive_params =
+      { workspace_id: String, id: String }
+      & Cadenya::Internal::Type::request_parameters
+
+    class AgentArchiveParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      attr_accessor workspace_id: String
+
+      attr_accessor id: String
+
+      def initialize: (
+        workspace_id: String,
+        id: String,
+        ?request_options: Cadenya::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        workspace_id: String,
+        id: String,
+        request_options: Cadenya::RequestOptions
+      }
+    end
+  end
+end

data/sig/cadenya/models/agent_entry.rbs

@@ -6,6 +6,7 @@ module Cadenya
         spec: Cadenya::AgentSpec,
         labels: ::Hash[Symbol, String],
         schedules: ::Hash[Symbol, Cadenya::AgentScheduleEntry],
+        state: Cadenya::Models::AgentEntry::state,
         variations: ::Hash[Symbol, Cadenya::AgentVariationEntry]
       }
 
@@ -24,6 +25,12 @@ module Cadenya
         ::Hash[Symbol, Cadenya::AgentScheduleEntry]
       ) -> ::Hash[Symbol, Cadenya::AgentScheduleEntry]
 
+      attr_reader state: Cadenya::Models::AgentEntry::state?
+
+      def state=: (
+        Cadenya::Models::AgentEntry::state
+      ) -> Cadenya::Models::AgentEntry::state
+
       attr_reader variations: ::Hash[Symbol, Cadenya::AgentVariationEntry]?
 
       def variations=: (
@@ -35,6 +42,7 @@ module Cadenya
         spec: Cadenya::AgentSpec,
         ?labels: ::Hash[Symbol, String],
         ?schedules: ::Hash[Symbol, Cadenya::AgentScheduleEntry],
+        ?state: Cadenya::Models::AgentEntry::state,
         ?variations: ::Hash[Symbol, Cadenya::AgentVariationEntry]
       ) -> void
 
@@ -43,8 +51,23 @@ module Cadenya
         spec: Cadenya::AgentSpec,
         labels: ::Hash[Symbol, String],
         schedules: ::Hash[Symbol, Cadenya::AgentScheduleEntry],
+        state: Cadenya::Models::AgentEntry::state,
         variations: ::Hash[Symbol, Cadenya::AgentVariationEntry]
       }
+
+      type state =
+        :STATE_UNSPECIFIED | :STATE_DRAFT | :STATE_PUBLISHED | :STATE_ARCHIVED
+
+      module State
+        extend Cadenya::Internal::Type::Enum
+
+        STATE_UNSPECIFIED: :STATE_UNSPECIFIED
+        STATE_DRAFT: :STATE_DRAFT
+        STATE_PUBLISHED: :STATE_PUBLISHED
+        STATE_ARCHIVED: :STATE_ARCHIVED
+
+        def self?.values: -> ::Array[Cadenya::Models::AgentEntry::state]
+      end
     end
   end
 end

data/sig/cadenya/models/agent_list_params.rbs

@@ -10,7 +10,7 @@ module Cadenya
         prefix: String,
         query: String,
         sort_order: String,
-        status: Cadenya::Models::AgentListParams::status,
+        state: Cadenya::Models::AgentListParams::state,
         variation_selection_mode: Cadenya::Models::AgentListParams::variation_selection_mode
       }
       & Cadenya::Internal::Type::request_parameters
@@ -49,11 +49,11 @@ module Cadenya
 
       def sort_order=: (String) -> String
 
-      attr_reader status: Cadenya::Models::AgentListParams::status?
+      attr_reader state: Cadenya::Models::AgentListParams::state?
 
-      def status=: (
-        Cadenya::Models::AgentListParams::status
-      ) -> Cadenya::Models::AgentListParams::status
+      def state=: (
+        Cadenya::Models::AgentListParams::state
+      ) -> Cadenya::Models::AgentListParams::state
 
       attr_reader variation_selection_mode: Cadenya::Models::AgentListParams::variation_selection_mode?
 
@@ -70,7 +70,7 @@ module Cadenya
         ?prefix: String,
         ?query: String,
         ?sort_order: String,
-        ?status: Cadenya::Models::AgentListParams::status,
+        ?state: Cadenya::Models::AgentListParams::state,
         ?variation_selection_mode: Cadenya::Models::AgentListParams::variation_selection_mode,
         ?request_options: Cadenya::request_opts
       ) -> void
@@ -84,26 +84,23 @@ module Cadenya
         prefix: String,
         query: String,
         sort_order: String,
-        status: Cadenya::Models::AgentListParams::status,
+        state: Cadenya::Models::AgentListParams::state,
         variation_selection_mode: Cadenya::Models::AgentListParams::variation_selection_mode,
         request_options: Cadenya::RequestOptions
       }
 
-      type status =
-        :AGENT_STATUS_UNSPECIFIED
-        | :AGENT_STATUS_DRAFT
-        | :AGENT_STATUS_PUBLISHED
-        | :AGENT_STATUS_ARCHIVED
+      type state =
+        :STATE_UNSPECIFIED | :STATE_DRAFT | :STATE_PUBLISHED | :STATE_ARCHIVED
 
-      module Status
+      module State
         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
+        STATE_UNSPECIFIED: :STATE_UNSPECIFIED
+        STATE_DRAFT: :STATE_DRAFT
+        STATE_PUBLISHED: :STATE_PUBLISHED
+        STATE_ARCHIVED: :STATE_ARCHIVED
 
-        def self?.values: -> ::Array[Cadenya::Models::AgentListParams::status]
+        def self?.values: -> ::Array[Cadenya::Models::AgentListParams::state]
       end
 
       type variation_selection_mode =

data/sig/cadenya/models/agent_publish_params.rbs

@@ -0,0 +1,28 @@
+module Cadenya
+  module Models
+    type agent_publish_params =
+      { workspace_id: String, id: String }
+      & Cadenya::Internal::Type::request_parameters
+
+    class AgentPublishParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      attr_accessor workspace_id: String
+
+      attr_accessor id: String
+
+      def initialize: (
+        workspace_id: String,
+        id: String,
+        ?request_options: Cadenya::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        workspace_id: String,
+        id: String,
+        request_options: Cadenya::RequestOptions
+      }
+    end
+  end
+end