cadenya 0.9.0 → 0.11.0

data/rbi/cadenya/models/agent_schedule_entry.rbi

@@ -24,18 +24,32 @@ module Cadenya
       sig { params(labels: T::Hash[Symbol, String]).void }
       attr_writer :labels
 
+      # Desired lifecycle state for the schedule. Defaults to STATE_ACTIVE when
+      # unspecified. Declare STATE_PAUSED to provision a schedule without it firing.
+      # STATE_ARCHIVED is rejected here.
+      sig { returns(T.nilable(Cadenya::AgentScheduleEntry::State::OrSymbol)) }
+      attr_reader :state
+
+      sig { params(state: Cadenya::AgentScheduleEntry::State::OrSymbol).void }
+      attr_writer :state
+
       sig do
         params(
           name: String,
           spec: Cadenya::Agents::AgentScheduleSpec::OrHash,
-          labels: T::Hash[Symbol, String]
+          labels: T::Hash[Symbol, String],
+          state: Cadenya::AgentScheduleEntry::State::OrSymbol
         ).returns(T.attached_class)
       end
       def self.new(
         name:,
         # AgentScheduleSpec is the user-provided configuration for a schedule.
         spec:,
-        labels: nil
+        labels: nil,
+        # Desired lifecycle state for the schedule. Defaults to STATE_ACTIVE when
+        # unspecified. Declare STATE_PAUSED to provision a schedule without it firing.
+        # STATE_ARCHIVED is rejected here.
+        state: nil
       )
       end
 
@@ -44,12 +58,47 @@ module Cadenya
           {
             name: String,
             spec: Cadenya::Agents::AgentScheduleSpec,
-            labels: T::Hash[Symbol, String]
+            labels: T::Hash[Symbol, String],
+            state: Cadenya::AgentScheduleEntry::State::OrSymbol
           }
         )
       end
       def to_hash
       end
+
+      # Desired lifecycle state for the schedule. Defaults to STATE_ACTIVE when
+      # unspecified. Declare STATE_PAUSED to provision a schedule without it firing.
+      # STATE_ARCHIVED is rejected here.
+      module State
+        extend Cadenya::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Cadenya::AgentScheduleEntry::State) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        STATE_UNSPECIFIED =
+          T.let(
+            :STATE_UNSPECIFIED,
+            Cadenya::AgentScheduleEntry::State::TaggedSymbol
+          )
+        STATE_ACTIVE =
+          T.let(:STATE_ACTIVE, Cadenya::AgentScheduleEntry::State::TaggedSymbol)
+        STATE_PAUSED =
+          T.let(:STATE_PAUSED, Cadenya::AgentScheduleEntry::State::TaggedSymbol)
+        STATE_ARCHIVED =
+          T.let(
+            :STATE_ARCHIVED,
+            Cadenya::AgentScheduleEntry::State::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Cadenya::AgentScheduleEntry::State::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/cadenya/models/agent_spec.rbi

@@ -6,10 +6,6 @@ module Cadenya
       OrHash =
         T.type_alias { T.any(Cadenya::AgentSpec, Cadenya::Internal::AnyHash) }
 
-      # Status of the agent
-      sig { returns(Cadenya::AgentSpec::Status::OrSymbol) }
-      attr_accessor :status
-
       # Controls how variations are automatically selected when creating objectives
       # Defaults to RANDOM when unspecified
       sig { returns(Cadenya::AgentSpec::VariationSelectionMode::OrSymbol) }
@@ -53,7 +49,6 @@ module Cadenya
       # Agent specification (user-provided configuration)
       sig do
         params(
-          status: Cadenya::AgentSpec::Status::OrSymbol,
           variation_selection_mode:
             Cadenya::AgentSpec::VariationSelectionMode::OrSymbol,
           description: String,
@@ -63,8 +58,6 @@ module Cadenya
         ).returns(T.attached_class)
       end
       def self.new(
-        # Status of the agent
-        status:,
         # Controls how variations are automatically selected when creating objectives
         # Defaults to RANDOM when unspecified
         variation_selection_mode:,
@@ -89,7 +82,6 @@ module Cadenya
       sig do
         override.returns(
           {
-            status: Cadenya::AgentSpec::Status::OrSymbol,
             variation_selection_mode:
               Cadenya::AgentSpec::VariationSelectionMode::OrSymbol,
             description: String,
@@ -102,39 +94,6 @@ module Cadenya
       def to_hash
       end
 
-      # Status of the agent
-      module Status
-        extend Cadenya::Internal::Type::Enum
-
-        TaggedSymbol =
-          T.type_alias { T.all(Symbol, Cadenya::AgentSpec::Status) }
-        OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-        AGENT_STATUS_UNSPECIFIED =
-          T.let(
-            :AGENT_STATUS_UNSPECIFIED,
-            Cadenya::AgentSpec::Status::TaggedSymbol
-          )
-        AGENT_STATUS_DRAFT =
-          T.let(:AGENT_STATUS_DRAFT, Cadenya::AgentSpec::Status::TaggedSymbol)
-        AGENT_STATUS_PUBLISHED =
-          T.let(
-            :AGENT_STATUS_PUBLISHED,
-            Cadenya::AgentSpec::Status::TaggedSymbol
-          )
-        AGENT_STATUS_ARCHIVED =
-          T.let(
-            :AGENT_STATUS_ARCHIVED,
-            Cadenya::AgentSpec::Status::TaggedSymbol
-          )
-
-        sig do
-          override.returns(T::Array[Cadenya::AgentSpec::Status::TaggedSymbol])
-        end
-        def self.values
-        end
-      end
-
       # Controls how variations are automatically selected when creating objectives
       # Defaults to RANDOM when unspecified
       module VariationSelectionMode

data/rbi/cadenya/models/agent_unarchive_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AgentUnarchiveParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::AgentUnarchiveParams, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :workspace_id
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig do
+        params(
+          workspace_id: String,
+          id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(workspace_id:, id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            workspace_id: String,
+            id: String,
+            request_options: Cadenya::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/agent_unpublish_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AgentUnpublishParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::AgentUnpublishParams, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :workspace_id
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig do
+        params(
+          workspace_id: String,
+          id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(workspace_id:, id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            workspace_id: String,
+            id: String,
+            request_options: Cadenya::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/agents/agent_schedule.rbi

@@ -32,12 +32,19 @@ module Cadenya
         sig { params(info: Cadenya::Agents::AgentScheduleInfo::OrHash).void }
         attr_writer :info
 
+        # The current lifecycle state of the schedule. Output only. Schedules are created
+        # STATE_ACTIVE; use the :pause, :resume, and :archive actions to transition
+        # between states.
+        sig { returns(Cadenya::Agents::AgentSchedule::State::TaggedSymbol) }
+        attr_accessor :state
+
         # AgentSchedule resource — a recurring trigger attached to an agent that creates
         # objectives on its cadence.
         sig do
           params(
             metadata: Cadenya::ResourceMetadata::OrHash,
             spec: Cadenya::Agents::AgentScheduleSpec::OrHash,
+            state: Cadenya::Agents::AgentSchedule::State::OrSymbol,
             info: Cadenya::Agents::AgentScheduleInfo::OrHash
           ).returns(T.attached_class)
         end
@@ -46,6 +53,10 @@ module Cadenya
           metadata:,
           # AgentScheduleSpec is the user-provided configuration for a schedule.
           spec:,
+          # The current lifecycle state of the schedule. Output only. Schedules are created
+          # STATE_ACTIVE; use the :pause, :resume, and :archive actions to transition
+          # between states.
+          state:,
           # AgentScheduleInfo provides read-only runtime data about a schedule.
           info: nil
         )
@@ -56,12 +67,55 @@ module Cadenya
             {
               metadata: Cadenya::ResourceMetadata,
               spec: Cadenya::Agents::AgentScheduleSpec,
+              state: Cadenya::Agents::AgentSchedule::State::TaggedSymbol,
               info: Cadenya::Agents::AgentScheduleInfo
             }
           )
         end
         def to_hash
         end
+
+        # The current lifecycle state of the schedule. Output only. Schedules are created
+        # STATE_ACTIVE; use the :pause, :resume, and :archive actions to transition
+        # between states.
+        module State
+          extend Cadenya::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Cadenya::Agents::AgentSchedule::State)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          STATE_UNSPECIFIED =
+            T.let(
+              :STATE_UNSPECIFIED,
+              Cadenya::Agents::AgentSchedule::State::TaggedSymbol
+            )
+          STATE_ACTIVE =
+            T.let(
+              :STATE_ACTIVE,
+              Cadenya::Agents::AgentSchedule::State::TaggedSymbol
+            )
+          STATE_PAUSED =
+            T.let(
+              :STATE_PAUSED,
+              Cadenya::Agents::AgentSchedule::State::TaggedSymbol
+            )
+          STATE_ARCHIVED =
+            T.let(
+              :STATE_ARCHIVED,
+              Cadenya::Agents::AgentSchedule::State::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[Cadenya::Agents::AgentSchedule::State::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/cadenya/models/agents/agent_schedule_info.rbi

@@ -52,7 +52,7 @@ module Cadenya
         attr_writer :last_skip_reason
 
         # When the schedule will next fire. Computed from the spec; absent when the
-        # schedule is PAUSED/ARCHIVED or has no future fire times.
+        # schedule is STATE_PAUSED/STATE_ARCHIVED or has no future fire times.
         sig { returns(T.nilable(Time)) }
         attr_reader :next_fire_at
 
@@ -92,7 +92,7 @@ module Cadenya
           # Reason for the most recent skip (e.g. "previous objective still running").
           last_skip_reason: nil,
           # When the schedule will next fire. Computed from the spec; absent when the
-          # schedule is PAUSED/ARCHIVED or has no future fire times.
+          # schedule is STATE_PAUSED/STATE_ARCHIVED or has no future fire times.
           next_fire_at: nil,
           # Lifetime count of objectives created by this schedule.
           total_fires: nil

data/rbi/cadenya/models/agents/agent_schedule_spec.rbi

@@ -14,11 +14,6 @@ module Cadenya
             )
           end
 
-        # The initial message passed to CreateObjective on each fire. Becomes the first
-        # user message in the objective's chat history.
-        sig { returns(String) }
-        attr_accessor :initial_message
-
         # 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.
@@ -40,6 +35,15 @@ module Cadenya
         sig { params(data: T.anything).void }
         attr_writer :data
 
+        # Optional initial message passed to CreateObjective on each fire. Becomes the
+        # first user message in the objective's chat history. When unset, the fired
+        # objective defers to the selected variation's user_message_template.
+        sig { returns(T.nilable(String)) }
+        attr_reader :initial_message
+
+        sig { params(initial_message: String).void }
+        attr_writer :initial_message
+
         # What to do when the previous run is still in flight. Defaults to SKIP.
         sig do
           returns(
@@ -58,20 +62,14 @@ module Cadenya
         end
         attr_writer :overlap_policy
 
-        # Lifecycle. Defaults to ACTIVE on create when unspecified.
-        sig do
-          returns(
-            T.nilable(Cadenya::Agents::AgentScheduleSpec::Status::OrSymbol)
-          )
-        end
-        attr_reader :status
+        # Optional data rendered into the variation's user_message_template when each
+        # fired objective is created. Separate from `data`, which renders the system
+        # prompt template.
+        sig { returns(T.nilable(T.anything)) }
+        attr_reader :user_data
 
-        sig do
-          params(
-            status: Cadenya::Agents::AgentScheduleSpec::Status::OrSymbol
-          ).void
-        end
-        attr_writer :status
+        sig { params(user_data: T.anything).void }
+        attr_writer :user_data
 
         # Optional explicit variation. When unset, the agent's variation_selection_mode
         # chooses per fire.
@@ -84,19 +82,16 @@ module Cadenya
         # AgentScheduleSpec is the user-provided configuration for a schedule.
         sig do
           params(
-            initial_message: String,
             schedule: Cadenya::Agents::AgentScheduleSpecSchedule::OrHash,
             data: T.anything,
+            initial_message: String,
             overlap_policy:
               Cadenya::Agents::AgentScheduleSpec::OverlapPolicy::OrSymbol,
-            status: Cadenya::Agents::AgentScheduleSpec::Status::OrSymbol,
+            user_data: T.anything,
             variation_id: String
           ).returns(T.attached_class)
         end
         def self.new(
-          # The initial message passed to CreateObjective on each fire. Becomes the first
-          # user message in the objective's chat history.
-          initial_message:,
           # 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.
@@ -104,10 +99,16 @@ module Cadenya
           # Optional input data passed to the objective. If the agent has an
           # input_data_schema, this must satisfy it.
           data: nil,
+          # Optional initial message passed to CreateObjective on each fire. Becomes the
+          # first user message in the objective's chat history. When unset, the fired
+          # objective defers to the selected variation's user_message_template.
+          initial_message: nil,
           # What to do when the previous run is still in flight. Defaults to SKIP.
           overlap_policy: nil,
-          # Lifecycle. Defaults to ACTIVE on create when unspecified.
-          status: nil,
+          # Optional data rendered into the variation's user_message_template when each
+          # fired objective is created. Separate from `data`, which renders the system
+          # prompt template.
+          user_data: nil,
           # Optional explicit variation. When unset, the agent's variation_selection_mode
           # chooses per fire.
           variation_id: nil
@@ -117,12 +118,12 @@ module Cadenya
         sig do
           override.returns(
             {
-              initial_message: String,
               schedule: Cadenya::Agents::AgentScheduleSpecSchedule,
               data: T.anything,
+              initial_message: String,
               overlap_policy:
                 Cadenya::Agents::AgentScheduleSpec::OverlapPolicy::OrSymbol,
-              status: Cadenya::Agents::AgentScheduleSpec::Status::OrSymbol,
+              user_data: T.anything,
               variation_id: String
             }
           )
@@ -166,46 +167,6 @@ module Cadenya
           def self.values
           end
         end
-
-        # Lifecycle. Defaults to ACTIVE on create when unspecified.
-        module Status
-          extend Cadenya::Internal::Type::Enum
-
-          TaggedSymbol =
-            T.type_alias do
-              T.all(Symbol, Cadenya::Agents::AgentScheduleSpec::Status)
-            end
-          OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-          AGENT_SCHEDULE_STATUS_UNSPECIFIED =
-            T.let(
-              :AGENT_SCHEDULE_STATUS_UNSPECIFIED,
-              Cadenya::Agents::AgentScheduleSpec::Status::TaggedSymbol
-            )
-          AGENT_SCHEDULE_STATUS_ACTIVE =
-            T.let(
-              :AGENT_SCHEDULE_STATUS_ACTIVE,
-              Cadenya::Agents::AgentScheduleSpec::Status::TaggedSymbol
-            )
-          AGENT_SCHEDULE_STATUS_PAUSED =
-            T.let(
-              :AGENT_SCHEDULE_STATUS_PAUSED,
-              Cadenya::Agents::AgentScheduleSpec::Status::TaggedSymbol
-            )
-          AGENT_SCHEDULE_STATUS_ARCHIVED =
-            T.let(
-              :AGENT_SCHEDULE_STATUS_ARCHIVED,
-              Cadenya::Agents::AgentScheduleSpec::Status::TaggedSymbol
-            )
-
-          sig do
-            override.returns(
-              T::Array[Cadenya::Agents::AgentScheduleSpec::Status::TaggedSymbol]
-            )
-          end
-          def self.values
-          end
-        end
       end
     end
   end

data/rbi/cadenya/models/agents/agent_variation_spec.rbi

@@ -103,12 +103,24 @@ module Cadenya
         end
         attr_writer :progressive_discovery
 
-        # The system prompt for this variation
+        # Liquid template for the system prompt of objectives using this variation.
+        # Rendered with CreateObjectiveRequest.data into Objective.system_prompt.
         sig { returns(T.nilable(String)) }
-        attr_reader :prompt
+        attr_reader :system_prompt_template
 
-        sig { params(prompt: String).void }
-        attr_writer :prompt
+        sig { params(system_prompt_template: String).void }
+        attr_writer :system_prompt_template
+
+        # Liquid template for the initial user message of objectives using this variation.
+        # Rendered with CreateObjectiveRequest.user_data and becomes the first user
+        # message in the LLM chat history. CreateObjectiveRequest.initial_message, when
+        # set, overrides the rendered result. If neither this template nor initial_message
+        # is present, objective creation is rejected with InvalidArgument.
+        sig { returns(T.nilable(String)) }
+        attr_reader :user_message_template
+
+        sig { params(user_message_template: String).void }
+        attr_writer :user_message_template
 
         # Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights).
         # Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0
@@ -133,7 +145,8 @@ module Cadenya
               Cadenya::Agents::AgentVariationSpecModelConfig::OrHash,
             progressive_discovery:
               Cadenya::Agents::AgentVariationSpecProgressiveDiscovery::OrHash,
-            prompt: String,
+            system_prompt_template: String,
+            user_message_template: String,
             weight: Integer
           ).returns(T.attached_class)
         end
@@ -162,8 +175,15 @@ module Cadenya
           # tool search. These are used in conjunction with the context-aware tool search
           # and can help select the best tools for the task.
           progressive_discovery: nil,
-          # The system prompt for this variation
-          prompt: nil,
+          # Liquid template for the system prompt of objectives using this variation.
+          # Rendered with CreateObjectiveRequest.data into Objective.system_prompt.
+          system_prompt_template: nil,
+          # Liquid template for the initial user message of objectives using this variation.
+          # Rendered with CreateObjectiveRequest.user_data and becomes the first user
+          # message in the LLM chat history. CreateObjectiveRequest.initial_message, when
+          # set, overrides the rendered result. If neither this template nor initial_message
+          # is present, objective creation is rejected with InvalidArgument.
+          user_message_template: nil,
           # Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights).
           # Only used when the agent's variation_selection_mode is WEIGHTED. A weight of 0
           # means never auto-selected, but can still be chosen explicitly via variation_id
@@ -184,7 +204,8 @@ module Cadenya
               model_config: Cadenya::Agents::AgentVariationSpecModelConfig,
               progressive_discovery:
                 Cadenya::Agents::AgentVariationSpecProgressiveDiscovery,
-              prompt: String,
+              system_prompt_template: String,
+              user_message_template: String,
               weight: Integer
             }
           )

data/rbi/cadenya/models/agents/schedule_archive_params.rbi

@@ -0,0 +1,53 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    module Agents
+      class ScheduleArchiveParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Agents::ScheduleArchiveParams,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :workspace_id
+
+        sig { returns(String) }
+        attr_accessor :agent_id
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        sig do
+          params(
+            workspace_id: String,
+            agent_id: String,
+            id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(workspace_id:, agent_id:, id:, request_options: {})
+        end
+
+        sig do
+          override.returns(
+            {
+              workspace_id: String,
+              agent_id: String,
+              id: String,
+              request_options: Cadenya::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/agents/schedule_pause_params.rbi

@@ -0,0 +1,53 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    module Agents
+      class SchedulePauseParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Agents::SchedulePauseParams,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :workspace_id
+
+        sig { returns(String) }
+        attr_accessor :agent_id
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        sig do
+          params(
+            workspace_id: String,
+            agent_id: String,
+            id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(workspace_id:, agent_id:, id:, request_options: {})
+        end
+
+        sig do
+          override.returns(
+            {
+              workspace_id: String,
+              agent_id: String,
+              id: String,
+              request_options: Cadenya::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end