cadenya 0.9.0 → 0.10.0

data/rbi/cadenya/models/agent.rbi

@@ -20,6 +20,12 @@ module Cadenya
       sig { params(spec: Cadenya::AgentSpec::OrHash).void }
       attr_writer :spec
 
+      # The current lifecycle state of the agent. Output only. Agents are created in
+      # STATE_DRAFT; use the :publish, :unpublish, :archive, and :unarchive actions to
+      # transition between states.
+      sig { returns(Cadenya::Agent::State::TaggedSymbol) }
+      attr_accessor :state
+
       # AgentInfo contains simple information about an agent for display or quick
       # reference
       sig { returns(T.nilable(Cadenya::AgentInfo)) }
@@ -33,6 +39,7 @@ module Cadenya
         params(
           metadata: Cadenya::ResourceMetadata::OrHash,
           spec: Cadenya::AgentSpec::OrHash,
+          state: Cadenya::Agent::State::OrSymbol,
           info: Cadenya::AgentInfo::OrHash
         ).returns(T.attached_class)
       end
@@ -41,6 +48,10 @@ module Cadenya
         metadata:,
         # Agent specification (user-provided configuration)
         spec:,
+        # The current lifecycle state of the agent. Output only. Agents are created in
+        # STATE_DRAFT; use the :publish, :unpublish, :archive, and :unarchive actions to
+        # transition between states.
+        state:,
         # AgentInfo contains simple information about an agent for display or quick
         # reference
         info: nil
@@ -52,12 +63,35 @@ module Cadenya
           {
             metadata: Cadenya::ResourceMetadata,
             spec: Cadenya::AgentSpec,
+            state: Cadenya::Agent::State::TaggedSymbol,
             info: Cadenya::AgentInfo
           }
         )
       end
       def to_hash
       end
+
+      # The current lifecycle state of the agent. Output only. Agents are created in
+      # STATE_DRAFT; use the :publish, :unpublish, :archive, and :unarchive actions to
+      # transition between states.
+      module State
+        extend Cadenya::Internal::Type::Enum
+
+        TaggedSymbol = T.type_alias { T.all(Symbol, Cadenya::Agent::State) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        STATE_UNSPECIFIED =
+          T.let(:STATE_UNSPECIFIED, Cadenya::Agent::State::TaggedSymbol)
+        STATE_DRAFT = T.let(:STATE_DRAFT, Cadenya::Agent::State::TaggedSymbol)
+        STATE_PUBLISHED =
+          T.let(:STATE_PUBLISHED, Cadenya::Agent::State::TaggedSymbol)
+        STATE_ARCHIVED =
+          T.let(:STATE_ARCHIVED, Cadenya::Agent::State::TaggedSymbol)
+
+        sig { override.returns(T::Array[Cadenya::Agent::State::TaggedSymbol]) }
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/cadenya/models/agent_archive_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AgentArchiveParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::AgentArchiveParams, 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_entry.rbi

@@ -33,6 +33,15 @@ module Cadenya
       end
       attr_writer :schedules
 
+      # Desired lifecycle state for the agent. Defaults to STATE_DRAFT when unspecified.
+      # STATE_PUBLISHED publishes the agent once its variations exist; see also
+      # BulkWorkspaceApplyData.automatically_publish_agents.
+      sig { returns(T.nilable(Cadenya::AgentEntry::State::OrSymbol)) }
+      attr_reader :state
+
+      sig { params(state: Cadenya::AgentEntry::State::OrSymbol).void }
+      attr_writer :state
+
       # Variations under this agent, keyed by external_id.
       sig { returns(T.nilable(T::Hash[Symbol, Cadenya::AgentVariationEntry])) }
       attr_reader :variations
@@ -50,6 +59,7 @@ module Cadenya
           spec: Cadenya::AgentSpec::OrHash,
           labels: T::Hash[Symbol, String],
           schedules: T::Hash[Symbol, Cadenya::AgentScheduleEntry::OrHash],
+          state: Cadenya::AgentEntry::State::OrSymbol,
           variations: T::Hash[Symbol, Cadenya::AgentVariationEntry::OrHash]
         ).returns(T.attached_class)
       end
@@ -60,6 +70,10 @@ module Cadenya
         labels: nil,
         # Schedules under this agent, keyed by external_id.
         schedules: nil,
+        # Desired lifecycle state for the agent. Defaults to STATE_DRAFT when unspecified.
+        # STATE_PUBLISHED publishes the agent once its variations exist; see also
+        # BulkWorkspaceApplyData.automatically_publish_agents.
+        state: nil,
         # Variations under this agent, keyed by external_id.
         variations: nil
       )
@@ -72,12 +86,39 @@ module Cadenya
             spec: Cadenya::AgentSpec,
             labels: T::Hash[Symbol, String],
             schedules: T::Hash[Symbol, Cadenya::AgentScheduleEntry],
+            state: Cadenya::AgentEntry::State::OrSymbol,
             variations: T::Hash[Symbol, Cadenya::AgentVariationEntry]
           }
         )
       end
       def to_hash
       end
+
+      # Desired lifecycle state for the agent. Defaults to STATE_DRAFT when unspecified.
+      # STATE_PUBLISHED publishes the agent once its variations exist; see also
+      # BulkWorkspaceApplyData.automatically_publish_agents.
+      module State
+        extend Cadenya::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Cadenya::AgentEntry::State) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        STATE_UNSPECIFIED =
+          T.let(:STATE_UNSPECIFIED, Cadenya::AgentEntry::State::TaggedSymbol)
+        STATE_DRAFT =
+          T.let(:STATE_DRAFT, Cadenya::AgentEntry::State::TaggedSymbol)
+        STATE_PUBLISHED =
+          T.let(:STATE_PUBLISHED, Cadenya::AgentEntry::State::TaggedSymbol)
+        STATE_ARCHIVED =
+          T.let(:STATE_ARCHIVED, Cadenya::AgentEntry::State::TaggedSymbol)
+
+        sig do
+          override.returns(T::Array[Cadenya::AgentEntry::State::TaggedSymbol])
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/cadenya/models/agent_list_params.rbi

@@ -64,12 +64,12 @@ module Cadenya
       sig { params(sort_order: String).void }
       attr_writer :sort_order
 
-      # Filter by agent publication status
-      sig { returns(T.nilable(Cadenya::AgentListParams::Status::OrSymbol)) }
-      attr_reader :status
+      # Filter by agent lifecycle state
+      sig { returns(T.nilable(Cadenya::AgentListParams::State::OrSymbol)) }
+      attr_reader :state
 
-      sig { params(status: Cadenya::AgentListParams::Status::OrSymbol).void }
-      attr_writer :status
+      sig { params(state: Cadenya::AgentListParams::State::OrSymbol).void }
+      attr_writer :state
 
       # Filter by variation selection mode
       sig do
@@ -97,7 +97,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
@@ -120,8 +120,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: {}
@@ -139,7 +139,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
@@ -149,38 +149,29 @@ module Cadenya
       def to_hash
       end
 
-      # Filter by agent publication status
-      module Status
+      # Filter by agent lifecycle state
+      module State
         extend Cadenya::Internal::Type::Enum
 
         TaggedSymbol =
-          T.type_alias { T.all(Symbol, Cadenya::AgentListParams::Status) }
+          T.type_alias { T.all(Symbol, Cadenya::AgentListParams::State) }
         OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-        AGENT_STATUS_UNSPECIFIED =
+        STATE_UNSPECIFIED =
           T.let(
-            :AGENT_STATUS_UNSPECIFIED,
-            Cadenya::AgentListParams::Status::TaggedSymbol
-          )
-        AGENT_STATUS_DRAFT =
-          T.let(
-            :AGENT_STATUS_DRAFT,
-            Cadenya::AgentListParams::Status::TaggedSymbol
-          )
-        AGENT_STATUS_PUBLISHED =
-          T.let(
-            :AGENT_STATUS_PUBLISHED,
-            Cadenya::AgentListParams::Status::TaggedSymbol
-          )
-        AGENT_STATUS_ARCHIVED =
-          T.let(
-            :AGENT_STATUS_ARCHIVED,
-            Cadenya::AgentListParams::Status::TaggedSymbol
+            :STATE_UNSPECIFIED,
+            Cadenya::AgentListParams::State::TaggedSymbol
           )
+        STATE_DRAFT =
+          T.let(:STATE_DRAFT, Cadenya::AgentListParams::State::TaggedSymbol)
+        STATE_PUBLISHED =
+          T.let(:STATE_PUBLISHED, Cadenya::AgentListParams::State::TaggedSymbol)
+        STATE_ARCHIVED =
+          T.let(:STATE_ARCHIVED, Cadenya::AgentListParams::State::TaggedSymbol)
 
         sig do
           override.returns(
-            T::Array[Cadenya::AgentListParams::Status::TaggedSymbol]
+            T::Array[Cadenya::AgentListParams::State::TaggedSymbol]
           )
         end
         def self.values

data/rbi/cadenya/models/agent_publish_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AgentPublishParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::AgentPublishParams, 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_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