cadenya 0.1.0

data/rbi/cadenya/models.rbi

@@ -0,0 +1,292 @@
+# typed: strong
+
+module Cadenya
+  AccountAPI = Cadenya::Models::AccountAPI
+
+  AccountInfo = Cadenya::Models::AccountInfo
+
+  AccountResourceMetadata = Cadenya::Models::AccountResourceMetadata
+
+  AccountRetrieveParams = Cadenya::Models::AccountRetrieveParams
+
+  AccountRotateWebhookSigningKeyParams =
+    Cadenya::Models::AccountRotateWebhookSigningKeyParams
+
+  AccountSpec = Cadenya::Models::AccountSpec
+
+  Agent = Cadenya::Models::Agent
+
+  AgentCreateParams = Cadenya::Models::AgentCreateParams
+
+  AgentDeleteParams = Cadenya::Models::AgentDeleteParams
+
+  AgentEntry = Cadenya::Models::AgentEntry
+
+  AgentInfo = Cadenya::Models::AgentInfo
+
+  AgentListParams = Cadenya::Models::AgentListParams
+
+  AgentRetrieveParams = Cadenya::Models::AgentRetrieveParams
+
+  Agents = Cadenya::Models::Agents
+
+  AgentScheduleEntry = Cadenya::Models::AgentScheduleEntry
+
+  AgentSpec = Cadenya::Models::AgentSpec
+
+  AgentUpdateParams = Cadenya::Models::AgentUpdateParams
+
+  AgentVariationEntry = Cadenya::Models::AgentVariationEntry
+
+  APIKey = Cadenya::Models::APIKey
+
+  APIKeyCreateParams = Cadenya::Models::APIKeyCreateParams
+
+  APIKeyDeleteParams = Cadenya::Models::APIKeyDeleteParams
+
+  APIKeyInfo = Cadenya::Models::APIKeyInfo
+
+  APIKeyListParams = Cadenya::Models::APIKeyListParams
+
+  APIKeyRetrieveParams = Cadenya::Models::APIKeyRetrieveParams
+
+  APIKeyRotateParams = Cadenya::Models::APIKeyRotateParams
+
+  APIKeys = Cadenya::Models::APIKeys
+
+  APIKeySpec = Cadenya::Models::APIKeySpec
+
+  APIKeyUpdateParams = Cadenya::Models::APIKeyUpdateParams
+
+  AssistantMessage = Cadenya::Models::AssistantMessage
+
+  AssistantToolCall = Cadenya::Models::AssistantToolCall
+
+  BareMetadata = Cadenya::Models::BareMetadata
+
+  BulkWorkspaceApply = Cadenya::Models::BulkWorkspaceApply
+
+  BulkWorkspaceApplyData = Cadenya::Models::BulkWorkspaceApplyData
+
+  BulkWorkspaceApplyInfo = Cadenya::Models::BulkWorkspaceApplyInfo
+
+  BulkWorkspaceApplyStatus = Cadenya::Models::BulkWorkspaceApplyStatus
+
+  BulkWorkspaceResourceApplyParams =
+    Cadenya::Models::BulkWorkspaceResourceApplyParams
+
+  BulkWorkspaceResourceListParams =
+    Cadenya::Models::BulkWorkspaceResourceListParams
+
+  BulkWorkspaceResourceRetrieveParams =
+    Cadenya::Models::BulkWorkspaceResourceRetrieveParams
+
+  BulkWorkspaceResources = Cadenya::Models::BulkWorkspaceResources
+
+  CallableTool = Cadenya::Models::CallableTool
+
+  ContextWindowCompacted = Cadenya::Models::ContextWindowCompacted
+
+  CreateOperationMetadata = Cadenya::Models::CreateOperationMetadata
+
+  CreateResourceMetadata = Cadenya::Models::CreateResourceMetadata
+
+  McpToolFilter = Cadenya::Models::McpToolFilter
+
+  MemoryEntryItem = Cadenya::Models::MemoryEntryItem
+
+  MemoryLayer = Cadenya::Models::MemoryLayer
+
+  MemoryLayerCreateParams = Cadenya::Models::MemoryLayerCreateParams
+
+  MemoryLayerDeleteParams = Cadenya::Models::MemoryLayerDeleteParams
+
+  MemoryLayerEntry = Cadenya::Models::MemoryLayerEntry
+
+  MemoryLayerInfo = Cadenya::Models::MemoryLayerInfo
+
+  MemoryLayerListParams = Cadenya::Models::MemoryLayerListParams
+
+  MemoryLayerRetrieveParams = Cadenya::Models::MemoryLayerRetrieveParams
+
+  MemoryLayers = Cadenya::Models::MemoryLayers
+
+  MemoryLayerSpec = Cadenya::Models::MemoryLayerSpec
+
+  MemoryLayerUpdateParams = Cadenya::Models::MemoryLayerUpdateParams
+
+  MemoryRead = Cadenya::Models::MemoryRead
+
+  MemoryReference = Cadenya::Models::MemoryReference
+
+  Model = Cadenya::Models::Model
+
+  ModelListParams = Cadenya::Models::ModelListParams
+
+  ModelRetrieveParams = Cadenya::Models::ModelRetrieveParams
+
+  ModelSetStatusParams = Cadenya::Models::ModelSetStatusParams
+
+  ModelSpec = Cadenya::Models::ModelSpec
+
+  Objective = Cadenya::Models::Objective
+
+  ObjectiveCancelParams = Cadenya::Models::ObjectiveCancelParams
+
+  ObjectiveCompactParams = Cadenya::Models::ObjectiveCompactParams
+
+  ObjectiveContextWindow = Cadenya::Models::ObjectiveContextWindow
+
+  ObjectiveContextWindowData = Cadenya::Models::ObjectiveContextWindowData
+
+  ObjectiveContinueParams = Cadenya::Models::ObjectiveContinueParams
+
+  ObjectiveCreateParams = Cadenya::Models::ObjectiveCreateParams
+
+  ObjectiveData = Cadenya::Models::ObjectiveData
+
+  ObjectiveDataSecret = Cadenya::Models::ObjectiveDataSecret
+
+  ObjectiveError = Cadenya::Models::ObjectiveError
+
+  ObjectiveEventData = Cadenya::Models::ObjectiveEventData
+
+  ObjectiveEventInfo = Cadenya::Models::ObjectiveEventInfo
+
+  ObjectiveEventWebhookData = Cadenya::Models::ObjectiveEventWebhookData
+
+  ObjectiveInfo = Cadenya::Models::ObjectiveInfo
+
+  ObjectiveListContextWindowsParams =
+    Cadenya::Models::ObjectiveListContextWindowsParams
+
+  ObjectiveListEventsParams = Cadenya::Models::ObjectiveListEventsParams
+
+  ObjectiveListParams = Cadenya::Models::ObjectiveListParams
+
+  ObjectiveRetrieveParams = Cadenya::Models::ObjectiveRetrieveParams
+
+  Objectives = Cadenya::Models::Objectives
+
+  ObjectiveStatus = Cadenya::Models::ObjectiveStatus
+
+  OperationMetadata = Cadenya::Models::OperationMetadata
+
+  Page = Cadenya::Models::Page
+
+  Profile = Cadenya::Models::Profile
+
+  ProfileSpec = Cadenya::Models::ProfileSpec
+
+  ResourceMetadata = Cadenya::Models::ResourceMetadata
+
+  RotateWebhookSigningKeyResponse =
+    Cadenya::Models::RotateWebhookSigningKeyResponse
+
+  SearchSearchToolsOrToolSetsParams =
+    Cadenya::Models::SearchSearchToolsOrToolSetsParams
+
+  SubObjectiveCreated = Cadenya::Models::SubObjectiveCreated
+
+  SyncCompleted = Cadenya::Models::SyncCompleted
+
+  SyncFailed = Cadenya::Models::SyncFailed
+
+  SyncStarted = Cadenya::Models::SyncStarted
+
+  ToolApprovalRequested = Cadenya::Models::ToolApprovalRequested
+
+  ToolApproved = Cadenya::Models::ToolApproved
+
+  ToolCalled = Cadenya::Models::ToolCalled
+
+  ToolDenied = Cadenya::Models::ToolDenied
+
+  ToolEntry = Cadenya::Models::ToolEntry
+
+  ToolError = Cadenya::Models::ToolError
+
+  ToolResult = Cadenya::Models::ToolResult
+
+  ToolSet = Cadenya::Models::ToolSet
+
+  ToolSetAdapter = Cadenya::Models::ToolSetAdapter
+
+  ToolSetAdapterHTTP = Cadenya::Models::ToolSetAdapterHTTP
+
+  ToolSetAdapterMcp = Cadenya::Models::ToolSetAdapterMcp
+
+  ToolSetCreateParams = Cadenya::Models::ToolSetCreateParams
+
+  ToolSetDeleteParams = Cadenya::Models::ToolSetDeleteParams
+
+  ToolSetEntry = Cadenya::Models::ToolSetEntry
+
+  ToolSetEvent = Cadenya::Models::ToolSetEvent
+
+  ToolSetEventData = Cadenya::Models::ToolSetEventData
+
+  ToolSetInfo = Cadenya::Models::ToolSetInfo
+
+  ToolSetListEventsParams = Cadenya::Models::ToolSetListEventsParams
+
+  ToolSetListParams = Cadenya::Models::ToolSetListParams
+
+  ToolSetRetrieveParams = Cadenya::Models::ToolSetRetrieveParams
+
+  ToolSets = Cadenya::Models::ToolSets
+
+  ToolSetSpec = Cadenya::Models::ToolSetSpec
+
+  ToolSetUpdateParams = Cadenya::Models::ToolSetUpdateParams
+
+  UnsafeUnwrapWebhookEvent = Cadenya::Models::UnsafeUnwrapWebhookEvent
+
+  UnwrapWebhookEvent = Cadenya::Models::UnwrapWebhookEvent
+
+  UpdateResourceMetadata = Cadenya::Models::UpdateResourceMetadata
+
+  Upload = Cadenya::Models::Upload
+
+  UploadCreateParams = Cadenya::Models::UploadCreateParams
+
+  UploadInfo = Cadenya::Models::UploadInfo
+
+  UploadRetrieveParams = Cadenya::Models::UploadRetrieveParams
+
+  UploadSpec = Cadenya::Models::UploadSpec
+
+  UserMessage = Cadenya::Models::UserMessage
+
+  VariationAssignmentEntry = Cadenya::Models::VariationAssignmentEntry
+
+  VariationMemoryLayerEntry = Cadenya::Models::VariationMemoryLayerEntry
+
+  WebhookUnsafeUnwrapParams = Cadenya::Models::WebhookUnsafeUnwrapParams
+
+  WebhookUnwrapParams = Cadenya::Models::WebhookUnwrapParams
+
+  Workspace = Cadenya::Models::Workspace
+
+  WorkspaceGetParams = Cadenya::Models::WorkspaceGetParams
+
+  WorkspaceListParams = Cadenya::Models::WorkspaceListParams
+
+  WorkspaceSecret = Cadenya::Models::WorkspaceSecret
+
+  WorkspaceSecretCreateParams = Cadenya::Models::WorkspaceSecretCreateParams
+
+  WorkspaceSecretDeleteParams = Cadenya::Models::WorkspaceSecretDeleteParams
+
+  WorkspaceSecretInfo = Cadenya::Models::WorkspaceSecretInfo
+
+  WorkspaceSecretListParams = Cadenya::Models::WorkspaceSecretListParams
+
+  WorkspaceSecretRetrieveParams = Cadenya::Models::WorkspaceSecretRetrieveParams
+
+  WorkspaceSecretSpec = Cadenya::Models::WorkspaceSecretSpec
+
+  WorkspaceSecretUpdateParams = Cadenya::Models::WorkspaceSecretUpdateParams
+
+  WorkspaceSpec = Cadenya::Models::WorkspaceSpec
+end

data/rbi/cadenya/request_options.rbi

@@ -0,0 +1,57 @@
+# typed: strong
+
+module Cadenya
+  # Specify HTTP behaviour to use for a specific request. These options supplement
+  # or override those provided at the client level.
+  #
+  # When making a request, you can pass an actual {RequestOptions} instance, or
+  # simply pass a Hash with symbol keys matching the attributes on this class.
+  class RequestOptions < Cadenya::Internal::Type::BaseModel
+    OrHash =
+      T.type_alias do
+        T.any(Cadenya::RequestOptions, Cadenya::Internal::AnyHash)
+      end
+
+    # @api private
+    sig { params(opts: Cadenya::RequestOptions::OrHash).void }
+    def self.validate!(opts)
+    end
+
+    # Idempotency key to send with request and all associated retries. Will only be
+    # sent for write requests.
+    sig { returns(T.nilable(String)) }
+    attr_accessor :idempotency_key
+
+    # Extra query params to send with the request. These are `.merge`’d into any
+    # `query` given at the client level.
+    sig do
+      returns(
+        T.nilable(T::Hash[String, T.nilable(T.any(T::Array[String], String))])
+      )
+    end
+    attr_accessor :extra_query
+
+    # Extra headers to send with the request. These are `.merged`’d into any
+    # `extra_headers` given at the client level.
+    sig { returns(T.nilable(T::Hash[String, T.nilable(String)])) }
+    attr_accessor :extra_headers
+
+    # Extra data to send with the request. These are deep merged into any data
+    # generated as part of the normal request.
+    sig { returns(T.nilable(T.anything)) }
+    attr_accessor :extra_body
+
+    # Maximum number of retries to attempt after a failed initial request.
+    sig { returns(T.nilable(Integer)) }
+    attr_accessor :max_retries
+
+    # Request timeout in seconds.
+    sig { returns(T.nilable(Float)) }
+    attr_accessor :timeout
+
+    # Returns a new instance of RequestOptions.
+    sig { params(values: Cadenya::Internal::AnyHash).returns(T.attached_class) }
+    def self.new(values = {})
+    end
+  end
+end

data/rbi/cadenya/resources/account.rbi

@@ -0,0 +1,33 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    # Manage the authenticated account. Accounts are the top-level organizational unit
+    # and contain one or more workspaces.
+    class Account
+      # Retrieves the current account for the token accessing the API. Useful to check
+      # if the credentials are valid.
+      sig do
+        params(request_options: Cadenya::RequestOptions::OrHash).returns(
+          Cadenya::AccountAPI
+        )
+      end
+      def retrieve(request_options: {})
+      end
+
+      # Rotates the webhook signing key for the account. Returns only the new key.
+      sig do
+        params(request_options: Cadenya::RequestOptions::OrHash).returns(
+          Cadenya::RotateWebhookSigningKeyResponse
+        )
+      end
+      def rotate_webhook_signing_key(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/agents/feedback.rbi

@@ -0,0 +1,66 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class Agents
+      # Manage AI agents within a workspace. Agents define AI behavior and tool access.
+      class Feedback
+        # Lists feedback submitted across all objectives belonging to an agent. Supports
+        # search by comment, sentiment filter, agent variation filter, and creation date
+        # range. Results are ordered by creation time, newest first.
+        sig do
+          params(
+            agent_id: String,
+            workspace_id: String,
+            agent_variation_id: String,
+            created_after: Time,
+            created_before: Time,
+            cursor: String,
+            include_info: T::Boolean,
+            limit: Integer,
+            query: String,
+            sentiment: Cadenya::Agents::FeedbackListParams::Sentiment::OrSymbol,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(
+            Cadenya::Internal::CursorPagination[
+              Cadenya::Objectives::ObjectiveFeedback
+            ]
+          )
+        end
+        def list(
+          # Path param: The ID of the agent. Supports "external_id:" prefix for external
+          # IDs.
+          agent_id,
+          # Path param
+          workspace_id:,
+          # Query param: Optional filter to limit results to feedback on objectives run by a
+          # single agent variation. Supports "external_id:" prefix for external IDs.
+          agent_variation_id: nil,
+          # Query param: Inclusive lower bound on feedback creation time.
+          created_after: nil,
+          # Query param: Exclusive upper bound on feedback creation time.
+          created_before: nil,
+          # 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: Free-text search applied to the feedback comment. Case-insensitive
+          # substring match.
+          query: nil,
+          # Query param: Filter by sentiment. UNSPECIFIED returns feedback regardless of
+          # score.
+          sentiment: 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/agents/schedules.rbi

@@ -0,0 +1,163 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class Agents
+      # Manage recurring schedules attached to agents. Schedules trigger objectives on a
+      # cadence defined by AgentScheduleSpec.Schedule.
+      class Schedules
+        # Creates a new schedule for an agent
+        sig do
+          params(
+            agent_id: String,
+            workspace_id: String,
+            metadata: Cadenya::CreateResourceMetadata::OrHash,
+            spec: Cadenya::Agents::AgentScheduleSpec::OrHash,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Agents::AgentSchedule)
+        end
+        def create(
+          # Path param: Agent ID. Accepts the canonical `agent_…` form or the
+          # `external_id:<value>` form.
+          agent_id,
+          # Path param: Workspace ID.
+          workspace_id:,
+          # Body param: 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.
+          metadata:,
+          # Body param: AgentScheduleSpec is the user-provided configuration for a schedule.
+          spec:,
+          request_options: {}
+        )
+        end
+
+        # Retrieves a schedule by ID from an agent
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            agent_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Agents::AgentSchedule)
+        end
+        def retrieve(
+          # Schedule ID. Accepts the canonical `as_…` form or the `external_id:<value>`
+          # form.
+          id,
+          # Workspace ID.
+          workspace_id:,
+          # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+          # form.
+          agent_id:,
+          request_options: {}
+        )
+        end
+
+        # Updates a schedule for an agent
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            agent_id: String,
+            metadata: Cadenya::UpdateResourceMetadata::OrHash,
+            spec: Cadenya::Agents::AgentScheduleSpec::OrHash,
+            update_mask: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Agents::AgentSchedule)
+        end
+        def update(
+          # Path param: Schedule ID. Accepts the canonical `as_…` form or the
+          # `external_id:<value>` form.
+          id,
+          # Path param: Workspace ID.
+          workspace_id:,
+          # Path param: Agent ID. Accepts the canonical `agent_…` form or the
+          # `external_id:<value>` form.
+          agent_id:,
+          # Body param: UpdateResourceMetadata contains the user-provided fields for
+          # updating 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.
+          metadata: nil,
+          # Body param: AgentScheduleSpec is the user-provided configuration for a schedule.
+          spec: nil,
+          # Body param: Fields to update.
+          update_mask: nil,
+          request_options: {}
+        )
+        end
+
+        # Lists all schedules for an agent
+        sig do
+          params(
+            agent_id: String,
+            workspace_id: String,
+            bundle_key: String,
+            cursor: String,
+            include_info: T::Boolean,
+            limit: Integer,
+            prefix: String,
+            query: String,
+            sort_order: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(
+            Cadenya::Internal::CursorPagination[Cadenya::Agents::AgentSchedule]
+          )
+        end
+        def list(
+          # Path param: Agent ID. Accepts the canonical `agent_…` form or the
+          # `external_id:<value>` form.
+          agent_id,
+          # Path param: Workspace ID.
+          workspace_id:,
+          # Query param: Filter by bundle_key — return only resources owned by this bundle.
+          bundle_key: nil,
+          # Query param: Pagination cursor from previous response.
+          cursor: nil,
+          # Query param: When true, the `info` field on each returned schedule is populated.
+          # Requests with this flag count more against your rate limit.
+          include_info: nil,
+          # Query param: Maximum number of results to return.
+          limit: nil,
+          # Query param: Filter expression (query param: prefix).
+          prefix: nil,
+          # Query param: Free-form search query.
+          query: nil,
+          # Query param: Sort order for results (asc or desc by creation time).
+          sort_order: nil,
+          request_options: {}
+        )
+        end
+
+        # Deletes a schedule from an agent
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            agent_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).void
+        end
+        def delete(
+          # Schedule ID. Accepts the canonical `as_…` form or the `external_id:<value>`
+          # form.
+          id,
+          # Workspace ID.
+          workspace_id:,
+          # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+          # form.
+          agent_id:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Cadenya::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end