cadenya 0.1.0

data/lib/cadenya/resources/search.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Resources
+    class Search
+      # Searches for tools or tool sets in the workspace
+      #
+      # @overload search_tools_or_tool_sets(workspace_id, query: nil, request_options: {})
+      #
+      # @param workspace_id [String]
+      # @param query [String]
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::SearchSearchToolsOrToolSetsResponse]
+      #
+      # @see Cadenya::Models::SearchSearchToolsOrToolSetsParams
+      def search_tools_or_tool_sets(workspace_id, params = {})
+        parsed, options = Cadenya::SearchSearchToolsOrToolSetsParams.dump_request(params)
+        query = Cadenya::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["v1/workspaces/%1$s/search/tools_or_tool_sets", workspace_id],
+          query: query,
+          model: Cadenya::Models::SearchSearchToolsOrToolSetsResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cadenya::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cadenya/resources/tool_sets/tools.rb

@@ -0,0 +1,229 @@
+# frozen_string_literal: true
+
+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
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::ToolSets::ToolCreateParams} for more details.
+        #
+        # Creates a new tool in the tool set
+        #
+        # @overload create(tool_set_id, workspace_id:, metadata:, spec:, request_options: {})
+        #
+        # @param tool_set_id [String] Path param: Tool set ID. Accepts the canonical ts\_… form or the
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param metadata [Cadenya::Models::CreateResourceMetadata] Body param: CreateResourceMetadata contains the user-provided fields for creatin
+        #
+        # @param spec [Cadenya::Models::ToolSets::ToolSpec] Body param
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::ToolSets::Tool]
+        #
+        # @see Cadenya::Models::ToolSets::ToolCreateParams
+        def create(tool_set_id, params)
+          parsed, options = Cadenya::ToolSets::ToolCreateParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :post,
+            path: ["v1/workspaces/%1$s/tool_sets/%2$s/tools", workspace_id, tool_set_id],
+            body: parsed,
+            model: Cadenya::ToolSets::Tool,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::ToolSets::ToolRetrieveParams} for more details.
+        #
+        # Retrieves a tool by ID from the workspace
+        #
+        # @overload retrieve(id, workspace_id:, tool_set_id:, request_options: {})
+        #
+        # @param id [String] Tool ID. Accepts the canonical tool\_… form or the
+        #
+        # @param workspace_id [String] Workspace ID.
+        #
+        # @param tool_set_id [String] Tool set ID. Accepts the canonical ts\_… form or the
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::ToolSets::Tool]
+        #
+        # @see Cadenya::Models::ToolSets::ToolRetrieveParams
+        def retrieve(id, params)
+          parsed, options = Cadenya::ToolSets::ToolRetrieveParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          tool_set_id =
+            parsed.delete(:tool_set_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["v1/workspaces/%1$s/tool_sets/%2$s/tools/%3$s", workspace_id, tool_set_id, id],
+            model: Cadenya::ToolSets::Tool,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::ToolSets::ToolUpdateParams} for more details.
+        #
+        # Updates a tool in the tool set
+        #
+        # @overload update(id, workspace_id:, tool_set_id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+        #
+        # @param id [String] Path param: Tool ID. Accepts the canonical tool\_… form or the
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param tool_set_id [String] Path param: Tool set ID. Accepts the canonical ts\_… form or the
+        #
+        # @param metadata [Cadenya::Models::UpdateResourceMetadata] Body param: UpdateResourceMetadata contains the user-provided fields for updatin
+        #
+        # @param spec [Cadenya::Models::ToolSets::ToolSpec] Body param
+        #
+        # @param update_mask [String] Body param
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::ToolSets::Tool]
+        #
+        # @see Cadenya::Models::ToolSets::ToolUpdateParams
+        def update(id, params)
+          parsed, options = Cadenya::ToolSets::ToolUpdateParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          tool_set_id =
+            parsed.delete(:tool_set_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :put,
+            path: ["v1/workspaces/%1$s/tool_sets/%2$s/tools/%3$s", workspace_id, tool_set_id, id],
+            body: parsed,
+            model: Cadenya::ToolSets::Tool,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::ToolSets::ToolListParams} for more details.
+        #
+        # Lists all tools in the tool set
+        #
+        # @overload list(tool_set_id, workspace_id:, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, names: nil, prefix: nil, query: nil, requires_approval: nil, sort_order: nil, statuses: nil, request_options: {})
+        #
+        # @param tool_set_id [String] Path param: Tool set ID. Accepts the canonical ts\_… form or the
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param bundle_key [String] Query param: Filter by bundle_key — return only resources owned by this bundle.
+        #
+        # @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 names [Array<String>] Query param: Filter by tool name (exact match). Multiple values are OR'd togethe
+        #
+        # @param prefix [String] Query param: Filter expression (query param: prefix)
+        #
+        # @param query [String] Query param: Free-form search query
+        #
+        # @param requires_approval [Boolean] Query param: Filter by approval requirement. Omitted = no filter; true = only to
+        #
+        # @param sort_order [String] Query param: Sort order for results (asc or desc by creation time)
+        #
+        # @param statuses [Array<Symbol, Cadenya::Models::ToolSets::ToolListParams::Status>] Query param: Filter by tool status. Multiple values are OR'd together.
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::ToolSets::Tool>]
+        #
+        # @see Cadenya::Models::ToolSets::ToolListParams
+        def list(tool_set_id, params)
+          parsed, options = Cadenya::ToolSets::ToolListParams.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/tool_sets/%2$s/tools", workspace_id, tool_set_id],
+            query: query.transform_keys(
+              bundle_key: "bundleKey",
+              include_info: "includeInfo",
+              requires_approval: "requiresApproval",
+              sort_order: "sortOrder"
+            ),
+            page: Cadenya::Internal::CursorPagination,
+            model: Cadenya::ToolSets::Tool,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::ToolSets::ToolDeleteParams} for more details.
+        #
+        # Deletes a tool in the tool set
+        #
+        # @overload delete(id, workspace_id:, tool_set_id:, request_options: {})
+        #
+        # @param id [String] Tool ID. Accepts the canonical tool\_… form or the
+        #
+        # @param workspace_id [String] Workspace ID.
+        #
+        # @param tool_set_id [String] Tool set ID. Accepts the canonical ts\_… form or the
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Cadenya::Models::ToolSets::ToolDeleteParams
+        def delete(id, params)
+          parsed, options = Cadenya::ToolSets::ToolDeleteParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          tool_set_id =
+            parsed.delete(:tool_set_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :delete,
+            path: ["v1/workspaces/%1$s/tool_sets/%2$s/tools/%3$s", workspace_id, tool_set_id, id],
+            model: NilClass,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Cadenya::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/cadenya/resources/tool_sets.rb

@@ -0,0 +1,237 @@
+# frozen_string_literal: true
+
+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.
+      # @return [Cadenya::Resources::ToolSets::Tools]
+      attr_reader :tools
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::ToolSetCreateParams} for more details.
+      #
+      # Creates a new tool set in the workspace
+      #
+      # @overload create(workspace_id, metadata:, spec:, request_options: {})
+      #
+      # @param workspace_id [String] Workspace ID.
+      #
+      # @param metadata [Cadenya::Models::CreateResourceMetadata] CreateResourceMetadata contains the user-provided fields for creating
+      #
+      # @param spec [Cadenya::Models::ToolSetSpec]
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::ToolSet]
+      #
+      # @see Cadenya::Models::ToolSetCreateParams
+      def create(workspace_id, params)
+        parsed, options = Cadenya::ToolSetCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/workspaces/%1$s/tool_sets", workspace_id],
+          body: parsed,
+          model: Cadenya::ToolSet,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::ToolSetRetrieveParams} for more details.
+      #
+      # Retrieves a tool set by ID from the workspace
+      #
+      # @overload retrieve(id, workspace_id:, request_options: {})
+      #
+      # @param id [String] Tool set ID. Accepts the canonical ts\_… form or the
+      #
+      # @param workspace_id [String] Workspace ID.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::ToolSet]
+      #
+      # @see Cadenya::Models::ToolSetRetrieveParams
+      def retrieve(id, params)
+        parsed, options = Cadenya::ToolSetRetrieveParams.dump_request(params)
+        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/tool_sets/%2$s", workspace_id, id],
+          model: Cadenya::ToolSet,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::ToolSetUpdateParams} for more details.
+      #
+      # Updates a tool set in the workspace
+      #
+      # @overload update(id, workspace_id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+      #
+      # @param id [String] Path param: Tool set ID. Accepts the canonical ts\_… form or the
+      #
+      # @param workspace_id [String] Path param: Workspace ID.
+      #
+      # @param metadata [Cadenya::Models::UpdateResourceMetadata] Body param: UpdateResourceMetadata contains the user-provided fields for updatin
+      #
+      # @param spec [Cadenya::Models::ToolSetSpec] Body param
+      #
+      # @param update_mask [String] Body param
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::ToolSet]
+      #
+      # @see Cadenya::Models::ToolSetUpdateParams
+      def update(id, params)
+        parsed, options = Cadenya::ToolSetUpdateParams.dump_request(params)
+        workspace_id =
+          parsed.delete(:workspace_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :put,
+          path: ["v1/workspaces/%1$s/tool_sets/%2$s", workspace_id, id],
+          body: parsed,
+          model: Cadenya::ToolSet,
+          options: options
+        )
+      end
+
+      # Lists all tool sets in the workspace
+      #
+      # @overload list(workspace_id, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, request_options: {})
+      #
+      # @param workspace_id [String] Workspace ID.
+      #
+      # @param bundle_key [String] Filter by bundle_key — return only resources owned by this bundle.
+      #
+      # @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 prefix [String] Filter expression (query param: prefix)
+      #
+      # @param query [String] Free-form search query
+      #
+      # @param sort_order [String] Sort order for results (asc or desc by creation time)
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::ToolSet>]
+      #
+      # @see Cadenya::Models::ToolSetListParams
+      def list(workspace_id, params = {})
+        parsed, options = Cadenya::ToolSetListParams.dump_request(params)
+        query = Cadenya::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["v1/workspaces/%1$s/tool_sets", workspace_id],
+          query: query.transform_keys(
+            bundle_key: "bundleKey",
+            include_info: "includeInfo",
+            sort_order: "sortOrder"
+          ),
+          page: Cadenya::Internal::CursorPagination,
+          model: Cadenya::ToolSet,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::ToolSetDeleteParams} for more details.
+      #
+      # Deletes a tool set in the workspace
+      #
+      # @overload delete(id, workspace_id:, request_options: {})
+      #
+      # @param id [String] Tool set ID. Accepts the canonical ts\_… form or the
+      #
+      # @param workspace_id [String] Workspace ID.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Cadenya::Models::ToolSetDeleteParams
+      def delete(id, params)
+        parsed, options = Cadenya::ToolSetDeleteParams.dump_request(params)
+        workspace_id =
+          parsed.delete(:workspace_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :delete,
+          path: ["v1/workspaces/%1$s/tool_sets/%2$s", workspace_id, id],
+          model: NilClass,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::ToolSetListEventsParams} for more details.
+      #
+      # Lists all events (including sync status) for a tool set
+      #
+      # @overload list_events(tool_set_id, workspace_id:, cursor: nil, include_info: nil, limit: nil, sort_order: nil, request_options: {})
+      #
+      # @param tool_set_id [String] Path param: Tool set ID. Accepts the canonical ts\_… form or the
+      #
+      # @param workspace_id [String] Path param: Workspace ID.
+      #
+      # @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 sort_order [String] Query param: Sort order for results (asc or desc by creation time)
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::ToolSetEvent>]
+      #
+      # @see Cadenya::Models::ToolSetListEventsParams
+      def list_events(tool_set_id, params)
+        parsed, options = Cadenya::ToolSetListEventsParams.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/tool_sets/%2$s/events", workspace_id, tool_set_id],
+          query: query.transform_keys(include_info: "includeInfo", sort_order: "sortOrder"),
+          page: Cadenya::Internal::CursorPagination,
+          model: Cadenya::ToolSetEvent,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cadenya::Client]
+      def initialize(client:)
+        @client = client
+        @tools = Cadenya::Resources::ToolSets::Tools.new(client: client)
+      end
+    end
+  end
+end

data/lib/cadenya/resources/uploads.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+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
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::UploadCreateParams} for more details.
+      #
+      # 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.
+      #
+      # @overload create(workspace_id, metadata:, spec:, request_options: {})
+      #
+      # @param workspace_id [String] Workspace ID.
+      #
+      # @param metadata [Cadenya::Models::CreateResourceMetadata] CreateResourceMetadata contains the user-provided fields for creating
+      #
+      # @param spec [Cadenya::Models::UploadSpec]
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::Upload]
+      #
+      # @see Cadenya::Models::UploadCreateParams
+      def create(workspace_id, params)
+        parsed, options = Cadenya::UploadCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/workspaces/%1$s/uploads", workspace_id],
+          body: parsed,
+          model: Cadenya::Upload,
+          options: options
+        )
+      end
+
+      # Retrieves the current state of an upload, including its lifecycle status
+      #
+      # @overload retrieve(id, workspace_id:, request_options: {})
+      #
+      # @param id [String]
+      #
+      # @param workspace_id [String] Workspace ID.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::Upload]
+      #
+      # @see Cadenya::Models::UploadRetrieveParams
+      def retrieve(id, params)
+        parsed, options = Cadenya::UploadRetrieveParams.dump_request(params)
+        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/uploads/%2$s", workspace_id, id],
+          model: Cadenya::Upload,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cadenya::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cadenya/resources/webhooks.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Resources
+    class Webhooks
+      # @param payload [String] The raw webhook payload as a string
+      #
+      # @return [Cadenya::Models::UnsafeUnwrapWebhookEvent]
+      def unsafe_unwrap(payload)
+        parsed = JSON.parse(payload, symbolize_names: true)
+        Cadenya::Internal::Type::Converter.coerce(Cadenya::Models::UnsafeUnwrapWebhookEvent, parsed)
+      end
+
+      # @param payload [String] The raw webhook payload as a string
+      #
+      # @param headers [Hash{String=>String}] The raw HTTP headers that came with the payload
+      #
+      # @param key [String, nil] The webhook signing key
+      #
+      # @return [Cadenya::Models::UnwrapWebhookEvent]
+      def unwrap(payload, headers:, key: @client.webhook_key)
+        if key.nil?
+          raise ArgumentError.new("Cannot verify a webhook without a key on either the client's webhook_key or passed in as an argument")
+        end
+
+        ::StandardWebhooks::Webhook.new(key).verify(payload, headers)
+
+        parsed = JSON.parse(payload, symbolize_names: true)
+        Cadenya::Internal::Type::Converter.coerce(Cadenya::Models::UnwrapWebhookEvent, parsed)
+      end
+
+      # @api private
+      #
+      # @param client [Cadenya::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end