cadenya 0.1.0

data/lib/cadenya/models/agents/agent_variation_spec.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class AgentVariationSpec < Cadenya::Internal::Type::BaseModel
+        # @!attribute compaction_config
+        #   CompactionConfig defines how context window compaction behaves for objectives
+        #   using this variation.
+        #
+        #   @return [Cadenya::Models::Agents::AgentVariationSpecCompactionConfig, nil]
+        optional :compaction_config,
+                 -> { Cadenya::Agents::AgentVariationSpecCompactionConfig },
+                 api_name: :compactionConfig
+
+        # @!attribute constraints
+        #   Execution constraints
+        #
+        #   @return [Cadenya::Models::Agents::AgentVariationSpecConstraints, nil]
+        optional :constraints, -> { Cadenya::Agents::AgentVariationSpecConstraints }
+
+        # @!attribute description
+        #   Human-readable description of what this variation does or when it should be used
+        #
+        #   @return [String, nil]
+        optional :description, String
+
+        # @!attribute enable_episodic_memory
+        #   Enable episodic memory for objectives using this variation. When true, the
+        #   system automatically creates a document namespace for each objective using the
+        #   objective's episodic_key as the external_id, allowing the agent to store and
+        #   retrieve documents specific to that episode.
+        #
+        #   @return [Boolean, nil]
+        optional :enable_episodic_memory, Cadenya::Internal::Type::Boolean, api_name: :enableEpisodicMemory
+
+        # @!attribute episodic_memory_ttl
+        #   How long episodic memories should be retained. After this duration, episodic
+        #   document namespaces can be automatically cleaned up. If not set, episodic
+        #   memories are retained indefinitely.
+        #
+        #   @return [Integer, nil]
+        optional :episodic_memory_ttl, Integer, api_name: :episodicMemoryTtl
+
+        # @!attribute model_config
+        #   ModelConfig defines the model configuration for a variation
+        #
+        #   @return [Cadenya::Models::Agents::AgentVariationSpecModelConfig, nil]
+        optional :model_config, -> { Cadenya::Agents::AgentVariationSpecModelConfig }, api_name: :modelConfig
+
+        # @!attribute progressive_discovery
+        #   ProgressiveDiscovery is used to indicate that the agent should automatically
+        #   discover tools that are not explicitly assigned to it. Max tools is the maximum
+        #   number of tools that can be discovered per search. Hints are optional hints for
+        #   tool search. These are used in conjunction with the context-aware tool search
+        #   and can help select the best tools for the task.
+        #
+        #   @return [Cadenya::Models::Agents::AgentVariationSpecProgressiveDiscovery, nil]
+        optional :progressive_discovery,
+                 -> { Cadenya::Agents::AgentVariationSpecProgressiveDiscovery },
+                 api_name: :progressiveDiscovery
+
+        # @!attribute prompt
+        #   The system prompt for this variation
+        #
+        #   @return [String, nil]
+        optional :prompt, String
+
+        # @!attribute weight
+        #   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
+        #   on CreateObjectiveRequest.
+        #
+        #   @return [Integer, nil]
+        optional :weight, Integer
+
+        # @!method initialize(compaction_config: nil, constraints: nil, description: nil, enable_episodic_memory: nil, episodic_memory_ttl: nil, model_config: nil, progressive_discovery: nil, prompt: nil, weight: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::AgentVariationSpec} for more details.
+        #
+        #   AgentVariationSpec defines the operational configuration for a variation
+        #
+        #   @param compaction_config [Cadenya::Models::Agents::AgentVariationSpecCompactionConfig] CompactionConfig defines how context window compaction behaves for objectives us
+        #
+        #   @param constraints [Cadenya::Models::Agents::AgentVariationSpecConstraints] Execution constraints
+        #
+        #   @param description [String] Human-readable description of what this variation does or when it should be used
+        #
+        #   @param enable_episodic_memory [Boolean] Enable episodic memory for objectives using this variation.
+        #
+        #   @param episodic_memory_ttl [Integer] How long episodic memories should be retained.
+        #
+        #   @param model_config [Cadenya::Models::Agents::AgentVariationSpecModelConfig] ModelConfig defines the model configuration for a variation
+        #
+        #   @param progressive_discovery [Cadenya::Models::Agents::AgentVariationSpecProgressiveDiscovery] ProgressiveDiscovery is used to indicate that the agent should automatically dis
+        #
+        #   @param prompt [String] The system prompt for this variation
+        #
+        #   @param weight [Integer] Weight for weighted random selection (>= 0). P(v) = v.weight / sum(all_weights).
+      end
+    end
+
+    AgentVariationSpec = Agents::AgentVariationSpec
+  end
+end

data/lib/cadenya/models/agents/agent_variation_spec_compaction_config.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class AgentVariationSpecCompactionConfig < Cadenya::Internal::Type::BaseModel
+        # @!attribute summarization
+        #   SummarizationStrategy configures LLM-powered summarization of older conversation
+        #   turns.
+        #
+        #   @return [Cadenya::Models::Agents::CompactionConfigSummarizationStrategy, nil]
+        optional :summarization, -> { Cadenya::Agents::CompactionConfigSummarizationStrategy }
+
+        # @!attribute tool_result_clearing
+        #   ToolResultClearingStrategy configures clearing of older tool result content.
+        #
+        #   @return [Cadenya::Models::Agents::CompactionConfigToolResultClearingStrategy, nil]
+        optional :tool_result_clearing,
+                 -> { Cadenya::Agents::CompactionConfigToolResultClearingStrategy },
+                 api_name: :toolResultClearing
+
+        # @!attribute trigger_threshold
+        #   Trigger threshold as a percentage of the model's context window (0.0 to 1.0).
+        #   When input tokens reach this percentage of the model's limit, compaction
+        #   triggers. Default: 0.75 (75%)
+        #
+        #   @return [Float, nil]
+        optional :trigger_threshold, Float, api_name: :triggerThreshold
+
+        # @!method initialize(summarization: nil, tool_result_clearing: nil, trigger_threshold: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::AgentVariationSpecCompactionConfig} for more details.
+        #
+        #   CompactionConfig defines how context window compaction behaves for objectives
+        #   using this variation.
+        #
+        #   @param summarization [Cadenya::Models::Agents::CompactionConfigSummarizationStrategy] SummarizationStrategy configures LLM-powered summarization of older conversation
+        #
+        #   @param tool_result_clearing [Cadenya::Models::Agents::CompactionConfigToolResultClearingStrategy] ToolResultClearingStrategy configures clearing of older tool result content.
+        #
+        #   @param trigger_threshold [Float] Trigger threshold as a percentage of the model's context window (0.0 to 1.0).
+      end
+    end
+
+    AgentVariationSpecCompactionConfig = Agents::AgentVariationSpecCompactionConfig
+  end
+end

data/lib/cadenya/models/agents/agent_variation_spec_constraints.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class AgentVariationSpecConstraints < Cadenya::Internal::Type::BaseModel
+        # @!attribute max_sub_objectives
+        #   The maximum number of sub-objectives that can be created. 0 means no limit.
+        #
+        #   @return [Integer, nil]
+        optional :max_sub_objectives, Integer, api_name: :maxSubObjectives
+
+        # @!attribute max_tool_calls
+        #   The maximum number of tool calls that can be made. 0 means no limit.
+        #
+        #   @return [Integer, nil]
+        optional :max_tool_calls, Integer, api_name: :maxToolCalls
+
+        # @!method initialize(max_sub_objectives: nil, max_tool_calls: nil)
+        #   @param max_sub_objectives [Integer] The maximum number of sub-objectives that can be created. 0 means no limit.
+        #
+        #   @param max_tool_calls [Integer] The maximum number of tool calls that can be made. 0 means no limit.
+      end
+    end
+
+    AgentVariationSpecConstraints = Agents::AgentVariationSpecConstraints
+  end
+end

data/lib/cadenya/models/agents/agent_variation_spec_model_config.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class AgentVariationSpecModelConfig < Cadenya::Internal::Type::BaseModel
+        # @!attribute model_id
+        #   The model identifier in family/model format (e.g., "claude/opus-4.6",
+        #   "claude/sonnet-4.5")
+        #
+        #   @return [String, nil]
+        optional :model_id, String, api_name: :modelId
+
+        # @!attribute temperature
+        #   Sampling temperature for model inference (0.0 to 1.0) Lower values produce more
+        #   deterministic outputs, higher values increase randomness
+        #
+        #   @return [Float, nil]
+        optional :temperature, Float
+
+        # @!method initialize(model_id: nil, temperature: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::AgentVariationSpecModelConfig} for more details.
+        #
+        #   ModelConfig defines the model configuration for a variation
+        #
+        #   @param model_id [String] The model identifier in family/model format (e.g., "claude/opus-4.6", "claude/so
+        #
+        #   @param temperature [Float] Sampling temperature for model inference (0.0 to 1.0)
+      end
+    end
+
+    AgentVariationSpecModelConfig = Agents::AgentVariationSpecModelConfig
+  end
+end

data/lib/cadenya/models/agents/agent_variation_spec_progressive_discovery.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class AgentVariationSpecProgressiveDiscovery < Cadenya::Internal::Type::BaseModel
+        # @!attribute hints
+        #
+        #   @return [Array<String>, nil]
+        optional :hints, Cadenya::Internal::Type::ArrayOf[String]
+
+        # @!attribute max_tools
+        #
+        #   @return [Integer, nil]
+        optional :max_tools, Integer, api_name: :maxTools
+
+        # @!attribute rerank_threshold
+        #   Rerank Threshold is an optional value that instructs whether or not to run a
+        #   search result through a embedding/reranker process which can improve performance
+        #   and reduce context bloat when tools reach the configured threshold. If a tool
+        #   match must exceed 0.8, for example, the tool very closely match the query the
+        #   tool search performed.
+        #
+        #   @return [Float, nil]
+        optional :rerank_threshold, Float, api_name: :rerankThreshold
+
+        # @!method initialize(hints: nil, max_tools: nil, rerank_threshold: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::AgentVariationSpecProgressiveDiscovery} for more
+        #   details.
+        #
+        #   ProgressiveDiscovery is used to indicate that the agent should automatically
+        #   discover tools that are not explicitly assigned to it. Max tools is the maximum
+        #   number of tools that can be discovered per search. Hints are optional hints for
+        #   tool search. These are used in conjunction with the context-aware tool search
+        #   and can help select the best tools for the task.
+        #
+        #   @param hints [Array<String>]
+        #
+        #   @param max_tools [Integer]
+        #
+        #   @param rerank_threshold [Float] Rerank Threshold is an optional value that instructs whether or not to run a sea
+      end
+    end
+
+    AgentVariationSpecProgressiveDiscovery = Agents::AgentVariationSpecProgressiveDiscovery
+  end
+end

data/lib/cadenya/models/agents/compaction_config_summarization_strategy.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class CompactionConfigSummarizationStrategy < Cadenya::Internal::Type::BaseModel
+        # @!attribute instructions
+        #   Custom instructions that guide what the summarizer preserves. Replaces the
+        #   default summarization prompt entirely. Example: "Preserve all code snippets,
+        #   variable names, and technical decisions."
+        #
+        #   @return [String, nil]
+        optional :instructions, String
+
+        # @!method initialize(instructions: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::CompactionConfigSummarizationStrategy} for more
+        #   details.
+        #
+        #   SummarizationStrategy configures LLM-powered summarization of older conversation
+        #   turns.
+        #
+        #   @param instructions [String] Custom instructions that guide what the summarizer preserves.
+      end
+    end
+  end
+end

data/lib/cadenya/models/agents/compaction_config_tool_result_clearing_strategy.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class CompactionConfigToolResultClearingStrategy < Cadenya::Internal::Type::BaseModel
+        # @!attribute preserve_recent_results
+        #   Number of most recent tool call results to keep intact. Older tool results have
+        #   their content replaced with "[result cleared]" while preserving the assistant
+        #   tool call message (function name, arguments). Default: 2
+        #
+        #   @return [Integer, nil]
+        optional :preserve_recent_results, Integer, api_name: :preserveRecentResults
+
+        # @!method initialize(preserve_recent_results: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::CompactionConfigToolResultClearingStrategy} for more
+        #   details.
+        #
+        #   ToolResultClearingStrategy configures clearing of older tool result content.
+        #
+        #   @param preserve_recent_results [Integer] Number of most recent tool call results to keep intact.
+      end
+    end
+  end
+end

data/lib/cadenya/models/agents/feedback_list_params.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Feedback#list
+      class FeedbackListParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute agent_variation_id
+        #   Optional filter to limit results to feedback on objectives run by a single agent
+        #   variation. Supports "external_id:" prefix for external IDs.
+        #
+        #   @return [String, nil]
+        optional :agent_variation_id, String
+
+        # @!attribute created_after
+        #   Inclusive lower bound on feedback creation time.
+        #
+        #   @return [Time, nil]
+        optional :created_after, Time
+
+        # @!attribute created_before
+        #   Exclusive upper bound on feedback creation time.
+        #
+        #   @return [Time, nil]
+        optional :created_before, Time
+
+        # @!attribute cursor
+        #   Pagination cursor from previous response.
+        #
+        #   @return [String, nil]
+        optional :cursor, String
+
+        # @!attribute include_info
+        #   When set to true you may use more of your alloted API rate-limit
+        #
+        #   @return [Boolean, nil]
+        optional :include_info, Cadenya::Internal::Type::Boolean
+
+        # @!attribute limit
+        #   Maximum number of results to return.
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute query
+        #   Free-text search applied to the feedback comment. Case-insensitive substring
+        #   match.
+        #
+        #   @return [String, nil]
+        optional :query, String
+
+        # @!attribute sentiment
+        #   Filter by sentiment. UNSPECIFIED returns feedback regardless of score.
+        #
+        #   @return [Symbol, Cadenya::Models::Agents::FeedbackListParams::Sentiment, nil]
+        optional :sentiment, enum: -> { Cadenya::Agents::FeedbackListParams::Sentiment }
+
+        # @!method initialize(workspace_id:, agent_id:, agent_variation_id: nil, created_after: nil, created_before: nil, cursor: nil, include_info: nil, limit: nil, query: nil, sentiment: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::FeedbackListParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param agent_id [String]
+        #
+        #   @param agent_variation_id [String] Optional filter to limit results to feedback on objectives run by a single
+        #
+        #   @param created_after [Time] Inclusive lower bound on feedback creation time.
+        #
+        #   @param created_before [Time] Exclusive upper bound on feedback creation time.
+        #
+        #   @param cursor [String] Pagination cursor from previous response.
+        #
+        #   @param include_info [Boolean] When set to true you may use more of your alloted API rate-limit
+        #
+        #   @param limit [Integer] Maximum number of results to return.
+        #
+        #   @param query [String] Free-text search applied to the feedback comment. Case-insensitive substring mat
+        #
+        #   @param sentiment [Symbol, Cadenya::Models::Agents::FeedbackListParams::Sentiment] Filter by sentiment. UNSPECIFIED returns feedback regardless of score.
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+
+        # Filter by sentiment. UNSPECIFIED returns feedback regardless of score.
+        module Sentiment
+          extend Cadenya::Internal::Type::Enum
+
+          FEEDBACK_SENTIMENT_UNSPECIFIED = :FEEDBACK_SENTIMENT_UNSPECIFIED
+          FEEDBACK_SENTIMENT_POSITIVE = :FEEDBACK_SENTIMENT_POSITIVE
+          FEEDBACK_SENTIMENT_NEGATIVE = :FEEDBACK_SENTIMENT_NEGATIVE
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/cadenya/models/agents/schedule_calendar.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class ScheduleCalendar < Cadenya::Internal::Type::BaseModel
+        # @!attribute comment
+        #
+        #   @return [String, nil]
+        optional :comment, String
+
+        # @!attribute day_of_month
+        #
+        #   @return [Array<Cadenya::Models::Agents::ScheduleRange>, nil]
+        optional :day_of_month,
+                 -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Agents::ScheduleRange] },
+                 api_name: :dayOfMonth
+
+        # @!attribute day_of_week
+        #
+        #   @return [Array<Cadenya::Models::Agents::ScheduleRange>, nil]
+        optional :day_of_week,
+                 -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Agents::ScheduleRange] },
+                 api_name: :dayOfWeek
+
+        # @!attribute hour
+        #
+        #   @return [Array<Cadenya::Models::Agents::ScheduleRange>, nil]
+        optional :hour, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Agents::ScheduleRange] }
+
+        # @!attribute minute
+        #
+        #   @return [Array<Cadenya::Models::Agents::ScheduleRange>, nil]
+        optional :minute, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Agents::ScheduleRange] }
+
+        # @!attribute month
+        #
+        #   @return [Array<Cadenya::Models::Agents::ScheduleRange>, nil]
+        optional :month, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Agents::ScheduleRange] }
+
+        # @!attribute second
+        #
+        #   @return [Array<Cadenya::Models::Agents::ScheduleRange>, nil]
+        optional :second, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Agents::ScheduleRange] }
+
+        # @!method initialize(comment: nil, day_of_month: nil, day_of_week: nil, hour: nil, minute: nil, month: nil, second: nil)
+        #   Calendar is a wall-clock rule. Empty field-list semantics:
+        #
+        #   - second/minute/hour: empty means [{start: 0}] (top of the unit)
+        #   - day_of_month/month/day_of_week: empty means "any value" Fire times = cartesian
+        #     product across all fields.
+        #
+        #   @param comment [String]
+        #   @param day_of_month [Array<Cadenya::Models::Agents::ScheduleRange>]
+        #   @param day_of_week [Array<Cadenya::Models::Agents::ScheduleRange>]
+        #   @param hour [Array<Cadenya::Models::Agents::ScheduleRange>]
+        #   @param minute [Array<Cadenya::Models::Agents::ScheduleRange>]
+        #   @param month [Array<Cadenya::Models::Agents::ScheduleRange>]
+        #   @param second [Array<Cadenya::Models::Agents::ScheduleRange>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/agents/schedule_create_params.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Schedules#create
+      class ScheduleCreateParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute metadata
+        #   CreateResourceMetadata contains the user-provided fields for creating a
+        #   workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
+        #   profile_id, created_at) are excluded since they are set by the server.
+        #
+        #   @return [Cadenya::Models::CreateResourceMetadata]
+        required :metadata, -> { Cadenya::CreateResourceMetadata }
+
+        # @!attribute spec
+        #   AgentScheduleSpec is the user-provided configuration for a schedule.
+        #
+        #   @return [Cadenya::Models::Agents::AgentScheduleSpec]
+        required :spec, -> { Cadenya::Agents::AgentScheduleSpec }
+
+        # @!method initialize(workspace_id:, agent_id:, metadata:, spec:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::Agents::ScheduleCreateParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param agent_id [String]
+        #
+        #   @param metadata [Cadenya::Models::CreateResourceMetadata] CreateResourceMetadata contains the user-provided fields for creating
+        #
+        #   @param spec [Cadenya::Models::Agents::AgentScheduleSpec] AgentScheduleSpec is the user-provided configuration for a schedule.
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/agents/schedule_delete_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      # @see Cadenya::Resources::Agents::Schedules#delete
+      class ScheduleDeleteParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(workspace_id:, agent_id:, id:, request_options: {})
+        #   @param workspace_id [String]
+        #   @param agent_id [String]
+        #   @param id [String]
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/agents/schedule_interval.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module Agents
+      class ScheduleInterval < Cadenya::Internal::Type::BaseModel
+        # @!attribute every
+        #
+        #   @return [String, nil]
+        optional :every, String
+
+        # @!attribute offset
+        #   Phase shift within `every`. Must be < `every` (enforced at runtime).
+        #
+        #   @return [String, nil]
+        optional :offset, String
+
+        # @!method initialize(every: nil, offset: nil)
+        #   Interval is a duration-based rule. Fires every `every` from a stable anchor
+        #   (workspace epoch), optionally phase-shifted by `offset`.
+        #
+        #   @param every [String]
+        #
+        #   @param offset [String] Phase shift within `every`. Must be < `every` (enforced at runtime).
+      end
+    end
+  end
+end