cadenya 0.1.0

data/rbi/cadenya/resources/tool_sets/tools.rbi

@@ -0,0 +1,173 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class ToolSets
+      # Manage tool sets and the tools they contain. Tool sets group related tools, and
+      # tools define specific capabilities available to agents.
+      #
+      # When a tool set is managed, only API key actors can modify its tools; human
+      # (profile) actors cannot.
+      class Tools
+        # Creates a new tool in the tool set
+        sig do
+          params(
+            tool_set_id: String,
+            workspace_id: String,
+            metadata: Cadenya::CreateResourceMetadata::OrHash,
+            spec: Cadenya::ToolSets::ToolSpec::OrHash,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::ToolSets::Tool)
+        end
+        def create(
+          # Path param: Tool set ID. Accepts the canonical ts\_… form or the
+          # external_id:<value> form.
+          tool_set_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
+          spec:,
+          request_options: {}
+        )
+        end
+
+        # Retrieves a tool by ID from the workspace
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            tool_set_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::ToolSets::Tool)
+        end
+        def retrieve(
+          # Tool ID. Accepts the canonical tool\_… form or the external_id:<value> form.
+          id,
+          # Workspace ID.
+          workspace_id:,
+          # Tool set ID. Accepts the canonical ts\_… form or the external_id:<value> form.
+          tool_set_id:,
+          request_options: {}
+        )
+        end
+
+        # Updates a tool in the tool set
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            tool_set_id: String,
+            metadata: Cadenya::UpdateResourceMetadata::OrHash,
+            spec: Cadenya::ToolSets::ToolSpec::OrHash,
+            update_mask: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::ToolSets::Tool)
+        end
+        def update(
+          # Path param: Tool ID. Accepts the canonical tool\_… form or the
+          # external_id:<value> form.
+          id,
+          # Path param: Workspace ID.
+          workspace_id:,
+          # Path param: Tool set ID. Accepts the canonical ts\_… form or the
+          # external_id:<value> form.
+          tool_set_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
+          spec: nil,
+          # Body param
+          update_mask: nil,
+          request_options: {}
+        )
+        end
+
+        # Lists all tools in the tool set
+        sig do
+          params(
+            tool_set_id: String,
+            workspace_id: String,
+            bundle_key: String,
+            cursor: String,
+            include_info: T::Boolean,
+            limit: Integer,
+            names: T::Array[String],
+            prefix: String,
+            query: String,
+            requires_approval: T::Boolean,
+            sort_order: String,
+            statuses:
+              T::Array[Cadenya::ToolSets::ToolListParams::Status::OrSymbol],
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(
+            Cadenya::Internal::CursorPagination[Cadenya::ToolSets::Tool]
+          )
+        end
+        def list(
+          # Path param: Tool set ID. Accepts the canonical ts\_… form or the
+          # external_id:<value> form.
+          tool_set_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 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 name (exact match). Multiple values are OR'd
+          # together.
+          names: nil,
+          # Query param: Filter expression (query param: prefix)
+          prefix: nil,
+          # Query param: Free-form search query
+          query: nil,
+          # Query param: Filter by approval requirement. Omitted = no filter; true = only
+          # tools requiring approval; false = only tools not requiring approval.
+          requires_approval: nil,
+          # Query param: Sort order for results (asc or desc by creation time)
+          sort_order: nil,
+          # Query param: Filter by tool status. Multiple values are OR'd together.
+          statuses: nil,
+          request_options: {}
+        )
+        end
+
+        # Deletes a tool in the tool set
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            tool_set_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).void
+        end
+        def delete(
+          # Tool ID. Accepts the canonical tool\_… form or the external_id:<value> form.
+          id,
+          # Workspace ID.
+          workspace_id:,
+          # Tool set ID. Accepts the canonical ts\_… form or the external_id:<value> form.
+          tool_set_id:,
+          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/tool_sets.rbi

@@ -0,0 +1,175 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    # Manage tool sets and the tools they contain. Tool sets group related tools, and
+    # tools define specific capabilities available to agents.
+    #
+    # When a tool set is managed, only API key actors can modify its tools; human
+    # (profile) actors cannot.
+    class ToolSets
+      # Manage tool sets and the tools they contain. Tool sets group related tools, and
+      # tools define specific capabilities available to agents.
+      #
+      # When a tool set is managed, only API key actors can modify its tools; human
+      # (profile) actors cannot.
+      sig { returns(Cadenya::Resources::ToolSets::Tools) }
+      attr_reader :tools
+
+      # Creates a new tool set in the workspace
+      sig do
+        params(
+          workspace_id: String,
+          metadata: Cadenya::CreateResourceMetadata::OrHash,
+          spec: Cadenya::ToolSetSpec::OrHash,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::ToolSet)
+      end
+      def create(
+        # Workspace ID.
+        workspace_id,
+        # 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:,
+        spec:,
+        request_options: {}
+      )
+      end
+
+      # Retrieves a tool set by ID from the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::ToolSet)
+      end
+      def retrieve(
+        # Tool set ID. Accepts the canonical ts\_… form or the external_id:<value> form.
+        id,
+        # Workspace ID.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
+      # Updates a tool set in the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          metadata: Cadenya::UpdateResourceMetadata::OrHash,
+          spec: Cadenya::ToolSetSpec::OrHash,
+          update_mask: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::ToolSet)
+      end
+      def update(
+        # Path param: Tool set ID. Accepts the canonical ts\_… form or the
+        # external_id:<value> form.
+        id,
+        # Path param: Workspace ID.
+        workspace_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
+        spec: nil,
+        # Body param
+        update_mask: nil,
+        request_options: {}
+      )
+      end
+
+      # Lists all tool sets in the workspace
+      sig do
+        params(
+          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::ToolSet])
+      end
+      def list(
+        # Workspace ID.
+        workspace_id,
+        # Filter by bundle_key — return only resources owned by this bundle.
+        bundle_key: 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,
+        # Filter expression (query param: prefix)
+        prefix: nil,
+        # Free-form search query
+        query: nil,
+        # Sort order for results (asc or desc by creation time)
+        sort_order: nil,
+        request_options: {}
+      )
+      end
+
+      # Deletes a tool set in the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).void
+      end
+      def delete(
+        # Tool set ID. Accepts the canonical ts\_… form or the external_id:<value> form.
+        id,
+        # Workspace ID.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
+      # Lists all events (including sync status) for a tool set
+      sig do
+        params(
+          tool_set_id: String,
+          workspace_id: String,
+          cursor: String,
+          include_info: T::Boolean,
+          limit: Integer,
+          sort_order: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Internal::CursorPagination[Cadenya::ToolSetEvent])
+      end
+      def list_events(
+        # Path param: Tool set ID. Accepts the canonical ts\_… form or the
+        # external_id:<value> form.
+        tool_set_id,
+        # Path param: Workspace ID.
+        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,
+        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/uploads.rbi

@@ -0,0 +1,54 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    # Issue short-lived presigned URLs for direct client-to-object-storage uploads.
+    # Created uploads can be referenced by id when creating or updating resources that
+    # accept binary content (e.g., MemoryEntry).
+    class Uploads
+      # Issues a short-lived presigned URL for direct upload to object storage. The
+      # returned id is used to reference the upload from resources that accept binary
+      # content.
+      sig do
+        params(
+          workspace_id: String,
+          metadata: Cadenya::CreateResourceMetadata::OrHash,
+          spec: Cadenya::UploadSpec::OrHash,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Upload)
+      end
+      def create(
+        # Workspace ID.
+        workspace_id,
+        # 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:,
+        spec:,
+        request_options: {}
+      )
+      end
+
+      # Retrieves the current state of an upload, including its lifecycle status
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Upload)
+      end
+      def retrieve(
+        id,
+        # Workspace ID.
+        workspace_id:,
+        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/webhooks.rbi

@@ -0,0 +1,36 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class Webhooks
+      sig { params(payload: String).returns(Cadenya::UnsafeUnwrapWebhookEvent) }
+      def unsafe_unwrap(
+        # The raw webhook payload as a string
+        payload
+      )
+      end
+
+      sig do
+        params(
+          payload: String,
+          headers: T::Hash[String, String],
+          key: T.nilable(String)
+        ).returns(Cadenya::UnwrapWebhookEvent)
+      end
+      def unwrap(
+        # The raw webhook payload as a string
+        payload,
+        # The raw HTTP headers that came with the payload
+        headers:,
+        # The webhook signing key
+        key: @client.webhook_key
+      )
+      end
+
+      # @api private
+      sig { params(client: Cadenya::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/cadenya/resources/workspace_secrets.rbi

@@ -0,0 +1,131 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class WorkspaceSecrets
+      # Creates a new workspace secret in the workspace
+      sig do
+        params(
+          workspace_id: String,
+          metadata: Cadenya::CreateResourceMetadata::OrHash,
+          spec: Cadenya::WorkspaceSecretSpec::OrHash,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::WorkspaceSecret)
+      end
+      def create(
+        # The workspace that will own this secret.
+        workspace_id,
+        # 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:,
+        spec:,
+        request_options: {}
+      )
+      end
+
+      # Retrieves a workspace secret by ID from the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::WorkspaceSecret)
+      end
+      def retrieve(
+        # The secret to retrieve.
+        id,
+        # The workspace the secret belongs to.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
+      # Updates a workspace secret in the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          metadata: Cadenya::UpdateResourceMetadata::OrHash,
+          spec: Cadenya::WorkspaceSecretSpec::OrHash,
+          update_mask: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::WorkspaceSecret)
+      end
+      def update(
+        # Path param: The secret to update.
+        id,
+        # Path param: The workspace the secret belongs to.
+        workspace_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
+        spec: nil,
+        # Body param: Fields to update.
+        update_mask: nil,
+        request_options: {}
+      )
+      end
+
+      # Lists all workspace secrets in the workspace
+      sig do
+        params(
+          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::WorkspaceSecret])
+      end
+      def list(
+        # The workspace whose secrets will be listed.
+        workspace_id,
+        # Filter by bundle_key — return only resources owned by this bundle.
+        bundle_key: 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,
+        # Filter expression (query param: prefix)
+        prefix: nil,
+        # Free-form search query
+        query: nil,
+        # Sort order for results (asc or desc by creation time)
+        sort_order: nil,
+        request_options: {}
+      )
+      end
+
+      # Deletes a workspace secret from the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).void
+      end
+      def delete(
+        # The secret to delete.
+        id,
+        # The workspace the secret belongs to.
+        workspace_id:,
+        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/workspaces.rbi

@@ -0,0 +1,47 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    # Manage workspaces within an account. Workspaces provide organizational grouping
+    # and isolation for resources such as agents, tools, and API keys.
+    class Workspaces
+      # Lists all workspaces for the current account
+      sig do
+        params(
+          cursor: String,
+          include_info: T::Boolean,
+          limit: Integer,
+          sort_order: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Internal::CursorPagination[Cadenya::Workspace])
+      end
+      def list(
+        # 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,
+        # Sort order for results (asc or desc by creation time)
+        sort_order: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieves the workspace associated with the current API token. Useful for
+      # workspace-scoped tokens to identify which workspace they belong to.
+      sig do
+        params(request_options: Cadenya::RequestOptions::OrHash).returns(
+          Cadenya::Workspace
+        )
+      end
+      def get(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/version.rbi

@@ -0,0 +1,5 @@
+# typed: strong
+
+module Cadenya
+  VERSION = T.let(T.unsafe(nil), String)
+end

data/sig/cadenya/client.rbs

@@ -0,0 +1,53 @@
+module Cadenya
+  class Client < Cadenya::Internal::Transport::BaseClient
+    DEFAULT_MAX_RETRIES: 2
+
+    DEFAULT_TIMEOUT_IN_SECONDS: Float
+
+    DEFAULT_INITIAL_RETRY_DELAY: Float
+
+    DEFAULT_MAX_RETRY_DELAY: Float
+
+    attr_reader api_key: String
+
+    attr_reader webhook_key: String?
+
+    attr_reader account: Cadenya::Resources::Account
+
+    attr_reader agents: Cadenya::Resources::Agents
+
+    attr_reader objectives: Cadenya::Resources::Objectives
+
+    attr_reader memory_layers: Cadenya::Resources::MemoryLayers
+
+    attr_reader uploads: Cadenya::Resources::Uploads
+
+    attr_reader models: Cadenya::Resources::Models
+
+    attr_reader search: Cadenya::Resources::Search
+
+    attr_reader tool_sets: Cadenya::Resources::ToolSets
+
+    attr_reader api_keys: Cadenya::Resources::APIKeys
+
+    attr_reader workspace_secrets: Cadenya::Resources::WorkspaceSecrets
+
+    attr_reader workspaces: Cadenya::Resources::Workspaces
+
+    attr_reader webhooks: Cadenya::Resources::Webhooks
+
+    attr_reader bulk_workspace_resources: Cadenya::Resources::BulkWorkspaceResources
+
+    private def auth_headers: -> ::Hash[String, String]
+
+    def initialize: (
+      ?api_key: String?,
+      ?webhook_key: String?,
+      ?base_url: String?,
+      ?max_retries: Integer,
+      ?timeout: Float,
+      ?initial_retry_delay: Float,
+      ?max_retry_delay: Float
+    ) -> void
+  end
+end