cadenya 0.1.0

data/lib/cadenya/models.rb

@@ -0,0 +1,323 @@
+# frozen_string_literal: true
+
+module Cadenya
+  [Cadenya::Internal::Type::BaseModel, *Cadenya::Internal::Type::BaseModel.subclasses].each do |cls|
+    cls.define_sorbet_constant!(:OrHash) { T.type_alias { T.any(cls, Cadenya::Internal::AnyHash) } }
+  end
+
+  Cadenya::Internal::Util.walk_namespaces(Cadenya::Models).each do |mod|
+    case mod
+    in Cadenya::Internal::Type::Enum | Cadenya::Internal::Type::Union
+      mod.constants.each do |name|
+        case mod.const_get(name)
+        in true | false
+          mod.define_sorbet_constant!(:TaggedBoolean) { T.type_alias { T::Boolean } }
+          mod.define_sorbet_constant!(:OrBoolean) { T.type_alias { T::Boolean } }
+        in Integer
+          mod.define_sorbet_constant!(:TaggedInteger) { T.type_alias { Integer } }
+          mod.define_sorbet_constant!(:OrInteger) { T.type_alias { Integer } }
+        in Float
+          mod.define_sorbet_constant!(:TaggedFloat) { T.type_alias { Float } }
+          mod.define_sorbet_constant!(:OrFloat) { T.type_alias { Float } }
+        in Symbol
+          mod.define_sorbet_constant!(:TaggedSymbol) { T.type_alias { Symbol } }
+          mod.define_sorbet_constant!(:OrSymbol) { T.type_alias { T.any(Symbol, String) } }
+        else
+        end
+      end
+    else
+    end
+  end
+
+  Cadenya::Internal::Util.walk_namespaces(Cadenya::Models)
+                         .lazy
+                         .grep(Cadenya::Internal::Type::Union)
+                         .each do |mod|
+    const = :Variants
+    next if mod.sorbet_constant_defined?(const)
+
+    mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
+  end
+
+  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/lib/cadenya/request_options.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+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
+    # @api private
+    #
+    # @param opts [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    #
+    # @raise [ArgumentError]
+    def self.validate!(opts)
+      case opts
+      in Cadenya::RequestOptions | Hash
+        opts.to_h.each_key do |k|
+          unless fields.include?(k)
+            raise ArgumentError.new("Request `opts` keys must be one of #{fields.keys}, got #{k.inspect}")
+          end
+        end
+      else
+        raise ArgumentError.new("Request `opts` must be a Hash or RequestOptions, got #{opts.inspect}")
+      end
+    end
+
+    # @!attribute idempotency_key
+    #   Idempotency key to send with request and all associated retries. Will only be
+    #   sent for write requests.
+    #
+    #   @return [String, nil]
+    optional :idempotency_key, String
+
+    # @!attribute extra_query
+    #   Extra query params to send with the request. These are `.merge`’d into any
+    #   `query` given at the client level.
+    #
+    #   @return [Hash{String=>Array<String>, String, nil}, nil]
+    optional :extra_query, Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::ArrayOf[String]]
+
+    # @!attribute extra_headers
+    #   Extra headers to send with the request. These are `.merged`’d into any
+    #   `extra_headers` given at the client level.
+    #
+    #   @return [Hash{String=>String, nil}, nil]
+    optional :extra_headers, Cadenya::Internal::Type::HashOf[String, nil?: true]
+
+    # @!attribute extra_body
+    #   Extra data to send with the request. These are deep merged into any data
+    #   generated as part of the normal request.
+    #
+    #   @return [Object, nil]
+    optional :extra_body, Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown]
+
+    # @!attribute max_retries
+    #   Maximum number of retries to attempt after a failed initial request.
+    #
+    #   @return [Integer, nil]
+    optional :max_retries, Integer
+
+    # @!attribute timeout
+    #   Request timeout in seconds.
+    #
+    #   @return [Float, nil]
+    optional :timeout, Float
+
+    # @!method initialize(values = {})
+    #   Returns a new instance of RequestOptions.
+    #
+    #   @param values [Hash{Symbol=>Object}]
+
+    define_sorbet_constant!(:OrHash) do
+      T.type_alias { T.any(Cadenya::RequestOptions, Cadenya::Internal::AnyHash) }
+    end
+  end
+end

data/lib/cadenya/resources/account.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+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.
+      #
+      # @overload retrieve(request_options: {})
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::AccountAPI]
+      #
+      # @see Cadenya::Models::AccountRetrieveParams
+      def retrieve(params = {})
+        @client.request(
+          method: :get,
+          path: "v1/account",
+          model: Cadenya::AccountAPI,
+          options: params[:request_options]
+        )
+      end
+
+      # Rotates the webhook signing key for the account. Returns only the new key.
+      #
+      # @overload rotate_webhook_signing_key(request_options: {})
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::RotateWebhookSigningKeyResponse]
+      #
+      # @see Cadenya::Models::AccountRotateWebhookSigningKeyParams
+      def rotate_webhook_signing_key(params = {})
+        @client.request(
+          method: :post,
+          path: "v1/account/rotate_webhook_signing_key",
+          model: Cadenya::RotateWebhookSigningKeyResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cadenya::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cadenya/resources/agents/feedback.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Resources
+    class Agents
+      # Manage AI agents within a workspace. Agents define AI behavior and tool access.
+      class Feedback
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Agents::FeedbackListParams} for more details.
+        #
+        # 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.
+        #
+        # @overload list(agent_id, workspace_id:, agent_variation_id: nil, created_after: nil, created_before: nil, cursor: nil, include_info: nil, limit: nil, query: nil, sentiment: nil, request_options: {})
+        #
+        # @param agent_id [String] Path param: The ID of the agent. Supports "external_id:" prefix for external IDs
+        #
+        # @param workspace_id [String] Path param
+        #
+        # @param agent_variation_id [String] Query param: Optional filter to limit results to feedback on objectives run by a
+        #
+        # @param created_after [Time] Query param: Inclusive lower bound on feedback creation time.
+        #
+        # @param created_before [Time] Query param: Exclusive upper bound on feedback creation time.
+        #
+        # @param cursor [String] Query param: Pagination cursor from previous response.
+        #
+        # @param include_info [Boolean] Query param: When set to true you may use more of your alloted API rate-limit
+        #
+        # @param limit [Integer] Query param: Maximum number of results to return.
+        #
+        # @param query [String] Query param: Free-text search applied to the feedback comment. Case-insensitive
+        #
+        # @param sentiment [Symbol, Cadenya::Models::Agents::FeedbackListParams::Sentiment] Query param: Filter by sentiment. UNSPECIFIED returns feedback regardless of sco
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::Objectives::ObjectiveFeedback>]
+        #
+        # @see Cadenya::Models::Agents::FeedbackListParams
+        def list(agent_id, params)
+          parsed, options = Cadenya::Agents::FeedbackListParams.dump_request(params)
+          query = Cadenya::Internal::Util.encode_query_params(parsed)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["v1/workspaces/%1$s/agents/%2$s/feedback", workspace_id, agent_id],
+            query: query.transform_keys(
+              agent_variation_id: "agentVariationId",
+              created_after: "createdAfter",
+              created_before: "createdBefore",
+              include_info: "includeInfo"
+            ),
+            page: Cadenya::Internal::CursorPagination,
+            model: Cadenya::Objectives::ObjectiveFeedback,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Cadenya::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end