cadenya 0.1.0

data/rbi/cadenya/resources/objectives/feedback.rbi

@@ -0,0 +1,69 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class Objectives
+      class Feedback
+        # Submits feedback for an objective's execution. Feedback scores are used by the
+        # agent variation scoring system to evaluate and rank variation performance.
+        sig do
+          params(
+            objective_id: String,
+            workspace_id: String,
+            data: Cadenya::Objectives::ObjectiveFeedbackData::OrHash,
+            metadata: Cadenya::CreateOperationMetadata::OrHash,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Objectives::ObjectiveFeedback)
+        end
+        def create(
+          # Path param: The ID of the objective. Supports "external_id:" prefix for external
+          # IDs.
+          objective_id,
+          # Path param
+          workspace_id:,
+          # Body param
+          data:,
+          # Body param: CreateOperationMetadata contains the user-provided fields for
+          # creating an operation. Read-only fields (id, account_id, workspace_id,
+          # created_at, profile_id) are excluded since they are set by the server.
+          metadata:,
+          request_options: {}
+        )
+        end
+
+        # Lists all feedback submitted for an objective
+        sig do
+          params(
+            objective_id: String,
+            workspace_id: String,
+            cursor: String,
+            limit: Integer,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(
+            Cadenya::Internal::CursorPagination[
+              Cadenya::Objectives::ObjectiveFeedback
+            ]
+          )
+        end
+        def list(
+          # Path param: The ID of the objective. Supports "external_id:" prefix for external
+          # IDs.
+          objective_id,
+          # Path param
+          workspace_id:,
+          # Query param: Pagination cursor from previous response
+          cursor: nil,
+          # Query param: Maximum number of results to return
+          limit: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Cadenya::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/resources/objectives/tasks.rbi

@@ -0,0 +1,64 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class Objectives
+      class Tasks
+        # Retrieves a task by ID from an objective
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            objective_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Objectives::ObjectiveTask)
+        end
+        def retrieve(
+          # Task ID
+          id,
+          workspace_id:,
+          # The ID of the objective. Supports "external_id:" prefix for external IDs.
+          objective_id:,
+          request_options: {}
+        )
+        end
+
+        # Lists all tasks for an objective
+        sig do
+          params(
+            objective_id: String,
+            workspace_id: String,
+            cursor: String,
+            limit: Integer,
+            sort_order: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(
+            Cadenya::Internal::CursorPagination[
+              Cadenya::Objectives::ObjectiveTask
+            ]
+          )
+        end
+        def list(
+          # Path param: The ID of the objective. Supports "external_id:" prefix for external
+          # IDs.
+          objective_id,
+          # Path param
+          workspace_id:,
+          # Query param: Pagination cursor from previous response
+          cursor: nil,
+          # Query param: Maximum number of results to return
+          limit: nil,
+          # Query param: Sort order for results
+          sort_order: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Cadenya::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/resources/objectives/tool_calls.rbi

@@ -0,0 +1,94 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class Objectives
+      class ToolCalls
+        # Lists all tool calls for an objective
+        sig do
+          params(
+            objective_id: String,
+            workspace_id: String,
+            cursor: String,
+            include_info: T::Boolean,
+            limit: Integer,
+            status: Cadenya::Objectives::ToolCallListParams::Status::OrSymbol,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(
+            Cadenya::Internal::CursorPagination[
+              Cadenya::Objectives::ObjectiveToolCall
+            ]
+          )
+        end
+        def list(
+          # Path param: The objective ID to return tool calls for
+          objective_id,
+          # Path param
+          workspace_id:,
+          # Query param: Pagination cursor from previous response
+          cursor: nil,
+          # Query param: When set to true you may use more of your alloted API rate-limit
+          include_info: nil,
+          # Query param: Maximum number of results to return
+          limit: nil,
+          # Query param: Filter by tool call status
+          status: nil,
+          request_options: {}
+        )
+        end
+
+        # When an agent attempts to use a tool that requires approval, use this endpoint
+        # to mark it as approved.
+        sig do
+          params(
+            tool_call_id: String,
+            workspace_id: String,
+            objective_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Objectives::ObjectiveToolCall)
+        end
+        def approve(
+          # The ID of the tool call to approve
+          tool_call_id,
+          workspace_id:,
+          # The ID of the objective. Supports "external_id:" prefix for external IDs.
+          objective_id:,
+          request_options: {}
+        )
+        end
+
+        # When an agent attempts to use a tool that requires approval, use this endpoint
+        # to mark it as denied. Use a memo to steer the LLM to a different decision or
+        # usage of the tool.
+        sig do
+          params(
+            tool_call_id: String,
+            workspace_id: String,
+            objective_id: String,
+            memo: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Objectives::ObjectiveToolCall)
+        end
+        def deny(
+          # Path param: The ID of the tool call to deny
+          tool_call_id,
+          # Path param
+          workspace_id:,
+          # Path param: The ID of the objective. Supports "external_id:" prefix for external
+          # IDs.
+          objective_id:,
+          # Body param: A memo to associate to the tool call denial. Use a memo to steer the
+          # LLM to a different decision or usage of the tool.
+          memo: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Cadenya::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/resources/objectives/tools.rbi

@@ -0,0 +1,42 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class Objectives
+      class Tools
+        # Lists all tools that were assigned to an objective
+        sig do
+          params(
+            objective_id: String,
+            workspace_id: String,
+            cursor: String,
+            limit: Integer,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(
+            Cadenya::Internal::CursorPagination[
+              Cadenya::Objectives::ObjectiveTool
+            ]
+          )
+        end
+        def list(
+          # Path param: The ID of the objective. Supports "external_id:" prefix for external
+          # IDs.
+          objective_id,
+          # Path param
+          workspace_id:,
+          # Query param: Pagination cursor from previous response
+          cursor: nil,
+          # Query param: Maximum number of results to return
+          limit: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Cadenya::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/resources/objectives.rbi

@@ -0,0 +1,244 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class Objectives
+      sig { returns(Cadenya::Resources::Objectives::Tools) }
+      attr_reader :tools
+
+      sig { returns(Cadenya::Resources::Objectives::ToolCalls) }
+      attr_reader :tool_calls
+
+      sig { returns(Cadenya::Resources::Objectives::Tasks) }
+      attr_reader :tasks
+
+      sig { returns(Cadenya::Resources::Objectives::Feedback) }
+      attr_reader :feedback
+
+      # Creates a new objective in the workspace
+      sig do
+        params(
+          workspace_id: String,
+          agent_id: String,
+          data: Cadenya::ObjectiveData::OrHash,
+          metadata: Cadenya::CreateOperationMetadata::OrHash,
+          variation_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Objective)
+      end
+      def create(
+        workspace_id,
+        agent_id:,
+        data:,
+        # CreateOperationMetadata contains the user-provided fields for creating an
+        # operation. Read-only fields (id, account_id, workspace_id, created_at,
+        # profile_id) are excluded since they are set by the server.
+        metadata:,
+        # Optional explicit variation selection. Overrides the agent's
+        # variation_selection_mode.
+        variation_id: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieves an objective by ID from the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Objective)
+      end
+      def retrieve(id, workspace_id:, request_options: {})
+      end
+
+      # Lists all objectives in the workspace
+      sig do
+        params(
+          workspace_id: String,
+          agent_id: String,
+          agent_schedule_id: String,
+          cursor: String,
+          include_info: T::Boolean,
+          limit: Integer,
+          parent_objective_id: String,
+          profile_id: String,
+          sort_order: String,
+          state: Cadenya::ObjectiveListParams::State::OrSymbol,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Internal::CursorPagination[Cadenya::Objective])
+      end
+      def list(
+        workspace_id,
+        # Agent ID for filtering
+        agent_id: nil,
+        # Filter to objectives produced by a specific AgentSchedule. Accepts canonical
+        # as\_… form or external_id:<value> form.
+        agent_schedule_id: nil,
+        # Pagination cursor from previous response
+        cursor: nil,
+        # When set to true you may use more of your alloted API rate-limit
+        include_info: nil,
+        # Maximum number of results to return
+        limit: nil,
+        # Optional filters
+        parent_objective_id: nil,
+        profile_id: nil,
+        # Sort order for results (asc or desc by creation time)
+        sort_order: nil,
+        # Filter by state
+        state: nil,
+        request_options: {}
+      )
+      end
+
+      # Cancels a running or pending objective. The objective's state will be set to
+      # STATE_CANCELLED.
+      sig do
+        params(
+          objective_id: String,
+          workspace_id: String,
+          reason: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Objective)
+      end
+      def cancel(
+        # Path param: The ID of the objective. Supports "external_id:" prefix for external
+        # IDs.
+        objective_id,
+        # Path param
+        workspace_id:,
+        # Body param: Optional reason for cancellation
+        reason: nil,
+        request_options: {}
+      )
+      end
+
+      # Triggers compaction on a running objective. Optionally override the variation's
+      # compaction config.
+      sig do
+        params(
+          objective_id: String,
+          workspace_id: String,
+          compaction_config:
+            Cadenya::Agents::AgentVariationSpecCompactionConfig::OrHash,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Models::ObjectiveCompactResponse)
+      end
+      def compact(
+        # Path param: The ID of the objective. Supports "external_id:" prefix for external
+        # IDs.
+        objective_id,
+        # Path param
+        workspace_id:,
+        # Body param: CompactionConfig defines how context window compaction behaves for
+        # objectives using this variation.
+        compaction_config: nil,
+        request_options: {}
+      )
+      end
+
+      # Continues an objective that has completed
+      sig do
+        params(
+          objective_id: String,
+          workspace_id: String,
+          enqueue: T::Boolean,
+          message: String,
+          secrets: T::Array[Cadenya::ObjectiveContinueParams::Secret::OrHash],
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Models::ObjectiveContinueResponse)
+      end
+      def continue(
+        # Path param: The ID of the objective. If you have assigned an external ID to the
+        # objective, you can prefix the ID with "external_id:". For example,
+        # "external_id:1234567890". Otherwise, the ID assigned by Cadenya should be used.
+        objective_id,
+        # Path param
+        workspace_id:,
+        # Body param: When set to true, the message will be enqueued for when the agent
+        # loop is available to process it.
+        enqueue: nil,
+        # Body param: The message to continue an objective that has completed (or you are
+        # enqueing)
+        message: nil,
+        # Body param: Secrets that should be included with the message. Helpful for when
+        # you need to update secrets on the objective (IE: A secret expires and needs to
+        # be refreshed)
+        secrets: nil,
+        request_options: {}
+      )
+      end
+
+      # Read-only list of the last five windows of execution for this objective, ordered
+      # by most recent first
+      sig do
+        params(
+          objective_id: String,
+          workspace_id: String,
+          cursor: String,
+          include_info: T::Boolean,
+          limit: Integer,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(
+          Cadenya::Internal::CursorPagination[Cadenya::ObjectiveContextWindow]
+        )
+      end
+      def list_context_windows(
+        # Path param: The objective ID to return windows for
+        objective_id,
+        # Path param
+        workspace_id:,
+        # Query param: Pagination cursor from previous response
+        cursor: nil,
+        # Query param: When set to true you may use more of your alloted API rate-limit
+        include_info: nil,
+        # Query param: Maximum number of results to return
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      # Lists all events for an objective
+      sig do
+        params(
+          objective_id: String,
+          workspace_id: String,
+          cursor: String,
+          include_info: T::Boolean,
+          limit: Integer,
+          sort_order: String,
+          window_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(
+          Cadenya::Internal::CursorPagination[
+            Cadenya::Models::ObjectiveListEventsResponse
+          ]
+        )
+      end
+      def list_events(
+        # Path param: Objective ID for filtering
+        objective_id,
+        # Path param
+        workspace_id:,
+        # Query param: Pagination cursor from previous response
+        cursor: nil,
+        # Query param: When set to true you may use more of your alloted API rate-limit
+        include_info: nil,
+        # Query param: Maximum number of results to return
+        limit: nil,
+        # Query param: Sort order for results (asc or desc by creation time)
+        sort_order: nil,
+        # Query param: Optional context window ID to filter events by
+        window_id: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Cadenya::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/cadenya/resources/search.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class Search
+      # Searches for tools or tool sets in the workspace
+      sig do
+        params(
+          workspace_id: String,
+          query: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Models::SearchSearchToolsOrToolSetsResponse)
+      end
+      def search_tools_or_tool_sets(
+        workspace_id,
+        query: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Cadenya::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end