cadenya 0.1.0

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

@@ -0,0 +1,68 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    AgentSchedule = Agents::AgentSchedule
+
+    module Agents
+      class AgentSchedule < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Cadenya::Agents::AgentSchedule, Cadenya::Internal::AnyHash)
+          end
+
+        # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        sig { returns(Cadenya::ResourceMetadata) }
+        attr_reader :metadata
+
+        sig { params(metadata: Cadenya::ResourceMetadata::OrHash).void }
+        attr_writer :metadata
+
+        # AgentScheduleSpec is the user-provided configuration for a schedule.
+        sig { returns(Cadenya::Agents::AgentScheduleSpec) }
+        attr_reader :spec
+
+        sig { params(spec: Cadenya::Agents::AgentScheduleSpec::OrHash).void }
+        attr_writer :spec
+
+        # AgentScheduleInfo provides read-only runtime data about a schedule.
+        sig { returns(T.nilable(Cadenya::Agents::AgentScheduleInfo)) }
+        attr_reader :info
+
+        sig { params(info: Cadenya::Agents::AgentScheduleInfo::OrHash).void }
+        attr_writer :info
+
+        # 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,
+            info: Cadenya::Agents::AgentScheduleInfo::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+          metadata:,
+          # AgentScheduleSpec is the user-provided configuration for a schedule.
+          spec:,
+          # AgentScheduleInfo provides read-only runtime data about a schedule.
+          info: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              metadata: Cadenya::ResourceMetadata,
+              spec: Cadenya::Agents::AgentScheduleSpec,
+              info: Cadenya::Agents::AgentScheduleInfo
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,120 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    AgentScheduleInfo = Agents::AgentScheduleInfo
+
+    module Agents
+      class AgentScheduleInfo < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Agents::AgentScheduleInfo,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # A profile identifies a user or non-human principal (such as an API key) at the
+        # account level. Profiles are account-scoped and can be granted access to multiple
+        # workspaces.
+        sig { returns(T.nilable(Cadenya::Profile)) }
+        attr_reader :created_by
+
+        sig { params(created_by: Cadenya::Profile::OrHash).void }
+        attr_writer :created_by
+
+        # When the schedule last fired (regardless of objective outcome).
+        sig { returns(T.nilable(Time)) }
+        attr_reader :last_fire_at
+
+        sig { params(last_fire_at: Time).void }
+        attr_writer :last_fire_at
+
+        # ID of the most recent objective the schedule created.
+        sig { returns(T.nilable(String)) }
+        attr_reader :last_objective_id
+
+        sig { params(last_objective_id: String).void }
+        attr_writer :last_objective_id
+
+        # When the schedule most recently skipped a fire (SKIP policy + prior in flight).
+        sig { returns(T.nilable(Time)) }
+        attr_reader :last_skipped_at
+
+        sig { params(last_skipped_at: Time).void }
+        attr_writer :last_skipped_at
+
+        # Reason for the most recent skip (e.g. "previous objective still running").
+        sig { returns(T.nilable(String)) }
+        attr_reader :last_skip_reason
+
+        sig { params(last_skip_reason: String).void }
+        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.
+        sig { returns(T.nilable(Time)) }
+        attr_reader :next_fire_at
+
+        sig { params(next_fire_at: Time).void }
+        attr_writer :next_fire_at
+
+        # Lifetime count of objectives created by this schedule.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :total_fires
+
+        sig { params(total_fires: Integer).void }
+        attr_writer :total_fires
+
+        # AgentScheduleInfo provides read-only runtime data about a schedule.
+        sig do
+          params(
+            created_by: Cadenya::Profile::OrHash,
+            last_fire_at: Time,
+            last_objective_id: String,
+            last_skipped_at: Time,
+            last_skip_reason: String,
+            next_fire_at: Time,
+            total_fires: Integer
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # A profile identifies a user or non-human principal (such as an API key) at the
+          # account level. Profiles are account-scoped and can be granted access to multiple
+          # workspaces.
+          created_by: nil,
+          # When the schedule last fired (regardless of objective outcome).
+          last_fire_at: nil,
+          # ID of the most recent objective the schedule created.
+          last_objective_id: nil,
+          # When the schedule most recently skipped a fire (SKIP policy + prior in flight).
+          last_skipped_at: nil,
+          # 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.
+          next_fire_at: nil,
+          # Lifetime count of objectives created by this schedule.
+          total_fires: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              created_by: Cadenya::Profile,
+              last_fire_at: Time,
+              last_objective_id: String,
+              last_skipped_at: Time,
+              last_skip_reason: String,
+              next_fire_at: Time,
+              total_fires: Integer
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,212 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    AgentScheduleSpec = Agents::AgentScheduleSpec
+
+    module Agents
+      class AgentScheduleSpec < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Agents::AgentScheduleSpec,
+              Cadenya::Internal::AnyHash
+            )
+          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.
+        sig { returns(Cadenya::Agents::AgentScheduleSpecSchedule) }
+        attr_reader :schedule
+
+        sig do
+          params(
+            schedule: Cadenya::Agents::AgentScheduleSpecSchedule::OrHash
+          ).void
+        end
+        attr_writer :schedule
+
+        # Optional input data passed to the objective. If the agent has an
+        # input_data_schema, this must satisfy it.
+        sig { returns(T.nilable(T.anything)) }
+        attr_reader :data
+
+        sig { params(data: T.anything).void }
+        attr_writer :data
+
+        # What to do when the previous run is still in flight. Defaults to SKIP.
+        sig do
+          returns(
+            T.nilable(
+              Cadenya::Agents::AgentScheduleSpec::OverlapPolicy::OrSymbol
+            )
+          )
+        end
+        attr_reader :overlap_policy
+
+        sig do
+          params(
+            overlap_policy:
+              Cadenya::Agents::AgentScheduleSpec::OverlapPolicy::OrSymbol
+          ).void
+        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
+
+        sig do
+          params(
+            status: Cadenya::Agents::AgentScheduleSpec::Status::OrSymbol
+          ).void
+        end
+        attr_writer :status
+
+        # Optional explicit variation. When unset, the agent's variation_selection_mode
+        # chooses per fire.
+        sig { returns(T.nilable(String)) }
+        attr_reader :variation_id
+
+        sig { params(variation_id: String).void }
+        attr_writer :variation_id
+
+        # AgentScheduleSpec is the user-provided configuration for a schedule.
+        sig do
+          params(
+            initial_message: String,
+            schedule: Cadenya::Agents::AgentScheduleSpecSchedule::OrHash,
+            data: T.anything,
+            overlap_policy:
+              Cadenya::Agents::AgentScheduleSpec::OverlapPolicy::OrSymbol,
+            status: Cadenya::Agents::AgentScheduleSpec::Status::OrSymbol,
+            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.
+          schedule:,
+          # Optional input data passed to the objective. If the agent has an
+          # input_data_schema, this must satisfy it.
+          data: 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 explicit variation. When unset, the agent's variation_selection_mode
+          # chooses per fire.
+          variation_id: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              initial_message: String,
+              schedule: Cadenya::Agents::AgentScheduleSpecSchedule,
+              data: T.anything,
+              overlap_policy:
+                Cadenya::Agents::AgentScheduleSpec::OverlapPolicy::OrSymbol,
+              status: Cadenya::Agents::AgentScheduleSpec::Status::OrSymbol,
+              variation_id: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # What to do when the previous run is still in flight. Defaults to SKIP.
+        module OverlapPolicy
+          extend Cadenya::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Cadenya::Agents::AgentScheduleSpec::OverlapPolicy)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          OVERLAP_POLICY_UNSPECIFIED =
+            T.let(
+              :OVERLAP_POLICY_UNSPECIFIED,
+              Cadenya::Agents::AgentScheduleSpec::OverlapPolicy::TaggedSymbol
+            )
+          OVERLAP_POLICY_ALLOW =
+            T.let(
+              :OVERLAP_POLICY_ALLOW,
+              Cadenya::Agents::AgentScheduleSpec::OverlapPolicy::TaggedSymbol
+            )
+          OVERLAP_POLICY_SKIP =
+            T.let(
+              :OVERLAP_POLICY_SKIP,
+              Cadenya::Agents::AgentScheduleSpec::OverlapPolicy::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Cadenya::Agents::AgentScheduleSpec::OverlapPolicy::TaggedSymbol
+              ]
+            )
+          end
+          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
+end

data/rbi/cadenya/models/agents/agent_schedule_spec_schedule.rbi

@@ -0,0 +1,82 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    AgentScheduleSpecSchedule = Agents::AgentScheduleSpecSchedule
+
+    module Agents
+      class AgentScheduleSpecSchedule < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Agents::AgentScheduleSpecSchedule,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # Wall-clock rules. May be empty if `intervals` is non-empty.
+        sig { returns(T.nilable(T::Array[Cadenya::Agents::ScheduleCalendar])) }
+        attr_reader :calendars
+
+        sig do
+          params(
+            calendars: T::Array[Cadenya::Agents::ScheduleCalendar::OrHash]
+          ).void
+        end
+        attr_writer :calendars
+
+        # Duration-based rules. May be empty if `calendars` is non-empty.
+        sig { returns(T.nilable(T::Array[Cadenya::Agents::ScheduleInterval])) }
+        attr_reader :intervals
+
+        sig do
+          params(
+            intervals: T::Array[Cadenya::Agents::ScheduleInterval::OrHash]
+          ).void
+        end
+        attr_writer :intervals
+
+        # IANA tz name (e.g. "America/New_York"). Required. Applies to calendars;
+        # intervals fire on wall-clock cadence anchored in this zone.
+        sig { returns(T.nilable(String)) }
+        attr_reader :timezone
+
+        sig { params(timezone: String).void }
+        attr_writer :timezone
+
+        # 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.
+        sig do
+          params(
+            calendars: T::Array[Cadenya::Agents::ScheduleCalendar::OrHash],
+            intervals: T::Array[Cadenya::Agents::ScheduleInterval::OrHash],
+            timezone: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Wall-clock rules. May be empty if `intervals` is non-empty.
+          calendars: nil,
+          # Duration-based rules. May be empty if `calendars` is non-empty.
+          intervals: nil,
+          # IANA tz name (e.g. "America/New_York"). Required. Applies to calendars;
+          # intervals fire on wall-clock cadence anchored in this zone.
+          timezone: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              calendars: T::Array[Cadenya::Agents::ScheduleCalendar],
+              intervals: T::Array[Cadenya::Agents::ScheduleInterval],
+              timezone: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/agents/agent_variation.rbi

@@ -0,0 +1,67 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    AgentVariation = Agents::AgentVariation
+
+    module Agents
+      class AgentVariation < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Cadenya::Agents::AgentVariation, Cadenya::Internal::AnyHash)
+          end
+
+        # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        sig { returns(Cadenya::ResourceMetadata) }
+        attr_reader :metadata
+
+        sig { params(metadata: Cadenya::ResourceMetadata::OrHash).void }
+        attr_writer :metadata
+
+        # AgentVariationSpec defines the operational configuration for a variation
+        sig { returns(Cadenya::Agents::AgentVariationSpec) }
+        attr_reader :spec
+
+        sig { params(spec: Cadenya::Agents::AgentVariationSpec::OrHash).void }
+        attr_writer :spec
+
+        # AgentVariationInfo provides read-only summary information about a variation
+        sig { returns(T.nilable(Cadenya::Agents::AgentVariationInfo)) }
+        attr_reader :info
+
+        sig { params(info: Cadenya::Agents::AgentVariationInfo::OrHash).void }
+        attr_writer :info
+
+        # AgentVariation resource
+        sig do
+          params(
+            metadata: Cadenya::ResourceMetadata::OrHash,
+            spec: Cadenya::Agents::AgentVariationSpec::OrHash,
+            info: Cadenya::Agents::AgentVariationInfo::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+          metadata:,
+          # AgentVariationSpec defines the operational configuration for a variation
+          spec:,
+          # AgentVariationInfo provides read-only summary information about a variation
+          info: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              metadata: Cadenya::ResourceMetadata,
+              spec: Cadenya::Agents::AgentVariationSpec,
+              info: Cadenya::Agents::AgentVariationInfo
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end