cadenya 0.1.0

data/lib/cadenya/models/tool_set_list_params.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::ToolSets#list
+    class ToolSetListParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      # @!attribute workspace_id
+      #
+      #   @return [String]
+      required :workspace_id, String
+
+      # @!attribute bundle_key
+      #   Filter by bundle_key — return only resources owned by this bundle.
+      #
+      #   @return [String, nil]
+      optional :bundle_key, String
+
+      # @!attribute cursor
+      #   Pagination cursor from previous response
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute include_info
+      #   When set to true you may use more of your alloted API rate-limit
+      #
+      #   @return [Boolean, nil]
+      optional :include_info, Cadenya::Internal::Type::Boolean
+
+      # @!attribute limit
+      #   Maximum number of results to return
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute prefix
+      #   Filter expression (query param: prefix)
+      #
+      #   @return [String, nil]
+      optional :prefix, String
+
+      # @!attribute query
+      #   Free-form search query
+      #
+      #   @return [String, nil]
+      optional :query, String
+
+      # @!attribute sort_order
+      #   Sort order for results (asc or desc by creation time)
+      #
+      #   @return [String, nil]
+      optional :sort_order, String
+
+      # @!method initialize(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]
+      #
+      #   @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}]
+    end
+  end
+end

data/lib/cadenya/models/tool_set_retrieve_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::ToolSets#retrieve
+    class ToolSetRetrieveParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      # @!attribute workspace_id
+      #
+      #   @return [String]
+      required :workspace_id, String
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(workspace_id:, id:, request_options: {})
+      #   @param workspace_id [String]
+      #   @param id [String]
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/tool_set_spec.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ToolSetSpec < Cadenya::Internal::Type::BaseModel
+      # @!attribute adapter
+      #
+      #   @return [Cadenya::Models::ToolSetAdapter, nil]
+      optional :adapter, -> { Cadenya::ToolSetAdapter }
+
+      # @!attribute description
+      #
+      #   @return [String, nil]
+      optional :description, String
+
+      # @!method initialize(adapter: nil, description: nil)
+      #   @param adapter [Cadenya::Models::ToolSetAdapter]
+      #   @param description [String]
+    end
+  end
+end

data/lib/cadenya/models/tool_set_update_params.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::ToolSets#update
+    class ToolSetUpdateParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      # @!attribute workspace_id
+      #
+      #   @return [String]
+      required :workspace_id, String
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute metadata
+      #   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.
+      #
+      #   @return [Cadenya::Models::UpdateResourceMetadata, nil]
+      optional :metadata, -> { Cadenya::UpdateResourceMetadata }
+
+      # @!attribute spec
+      #
+      #   @return [Cadenya::Models::ToolSetSpec, nil]
+      optional :spec, -> { Cadenya::ToolSetSpec }
+
+      # @!attribute update_mask
+      #
+      #   @return [String, nil]
+      optional :update_mask, String, api_name: :updateMask
+
+      # @!method initialize(workspace_id:, id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ToolSetUpdateParams} for more details.
+      #
+      #   @param workspace_id [String]
+      #
+      #   @param id [String]
+      #
+      #   @param metadata [Cadenya::Models::UpdateResourceMetadata] UpdateResourceMetadata contains the user-provided fields for updating
+      #
+      #   @param spec [Cadenya::Models::ToolSetSpec]
+      #
+      #   @param update_mask [String]
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/config_http.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      class ConfigHTTP < Cadenya::Internal::Type::BaseModel
+        # @!attribute request_method
+        #
+        #   @return [Symbol, Cadenya::Models::ToolSets::ConfigHTTP::RequestMethod]
+        required :request_method,
+                 enum: -> { Cadenya::ToolSets::ConfigHTTP::RequestMethod },
+                 api_name: :requestMethod
+
+        # @!attribute headers
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :headers, Cadenya::Internal::Type::HashOf[String]
+
+        # @!attribute path
+        #
+        #   @return [String, nil]
+        optional :path, String
+
+        # @!attribute query
+        #
+        #   @return [String, nil]
+        optional :query, String
+
+        # @!attribute request_body_content_type
+        #
+        #   @return [String, nil]
+        optional :request_body_content_type, String, api_name: :requestBodyContentType
+
+        # @!attribute request_body_template
+        #   These are only used when the request method is a POST, PUT, or PATCH
+        #
+        #   @return [String, nil]
+        optional :request_body_template, String, api_name: :requestBodyTemplate
+
+        # @!attribute tool_name
+        #   The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP
+        #   adapter. This is used to match the tool spec to the correct endpoint on the HTTP
+        #   adapter. it will be derived from the name of the tool if not provided.
+        #
+        #   @return [String, nil]
+        optional :tool_name, String, api_name: :toolName
+
+        # @!method initialize(request_method:, headers: nil, path: nil, query: nil, request_body_content_type: nil, request_body_template: nil, tool_name: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ToolSets::ConfigHTTP} for more details.
+        #
+        #   @param request_method [Symbol, Cadenya::Models::ToolSets::ConfigHTTP::RequestMethod]
+        #
+        #   @param headers [Hash{Symbol=>String}]
+        #
+        #   @param path [String]
+        #
+        #   @param query [String]
+        #
+        #   @param request_body_content_type [String]
+        #
+        #   @param request_body_template [String] These are only used when the request method is a POST, PUT, or PATCH
+        #
+        #   @param tool_name [String] The tool name (commonly an "operation id" in OpenAPI specs) to call on the HTTP
+
+        # @see Cadenya::Models::ToolSets::ConfigHTTP#request_method
+        module RequestMethod
+          extend Cadenya::Internal::Type::Enum
+
+          HTTP_METHOD_UNSPECIFIED = :HTTP_METHOD_UNSPECIFIED
+          GET = :GET
+          POST = :POST
+          PUT = :PUT
+          PATCH = :PATCH
+          DELETE = :DELETE
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/config_mcp.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      class ConfigMcp < Cadenya::Internal::Type::BaseModel
+        # @!attribute tool_description
+        #
+        #   @return [String, nil]
+        optional :tool_description, String, api_name: :toolDescription
+
+        # @!attribute tool_name
+        #
+        #   @return [String, nil]
+        optional :tool_name, String, api_name: :toolName
+
+        # @!attribute tool_title
+        #
+        #   @return [String, nil]
+        optional :tool_title, String, api_name: :toolTitle
+
+        # @!method initialize(tool_description: nil, tool_name: nil, tool_title: nil)
+        #   @param tool_description [String]
+        #   @param tool_name [String]
+        #   @param tool_title [String]
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/tool.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      # @see Cadenya::Resources::ToolSets::Tools#create
+      class Tool < Cadenya::Internal::Type::BaseModel
+        # @!attribute metadata
+        #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @return [Cadenya::Models::ResourceMetadata]
+        required :metadata, -> { Cadenya::ResourceMetadata }
+
+        # @!attribute spec
+        #
+        #   @return [Cadenya::Models::ToolSets::ToolSpec]
+        required :spec, -> { Cadenya::ToolSets::ToolSpec }
+
+        # @!attribute info
+        #
+        #   @return [Cadenya::Models::ToolSets::ToolInfo, nil]
+        optional :info, -> { Cadenya::ToolSets::ToolInfo }
+
+        # @!method initialize(metadata:, spec:, info: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ToolSets::Tool} for more details.
+        #
+        #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @param spec [Cadenya::Models::ToolSets::ToolSpec]
+        #
+        #   @param info [Cadenya::Models::ToolSets::ToolInfo]
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/tool_create_params.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      # @see Cadenya::Resources::ToolSets::Tools#create
+      class ToolCreateParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute tool_set_id
+        #
+        #   @return [String]
+        required :tool_set_id, String
+
+        # @!attribute metadata
+        #   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.
+        #
+        #   @return [Cadenya::Models::CreateResourceMetadata]
+        required :metadata, -> { Cadenya::CreateResourceMetadata }
+
+        # @!attribute spec
+        #
+        #   @return [Cadenya::Models::ToolSets::ToolSpec]
+        required :spec, -> { Cadenya::ToolSets::ToolSpec }
+
+        # @!method initialize(workspace_id:, tool_set_id:, metadata:, spec:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ToolSets::ToolCreateParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param tool_set_id [String]
+        #
+        #   @param metadata [Cadenya::Models::CreateResourceMetadata] CreateResourceMetadata contains the user-provided fields for creating
+        #
+        #   @param spec [Cadenya::Models::ToolSets::ToolSpec]
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/tool_delete_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      # @see Cadenya::Resources::ToolSets::Tools#delete
+      class ToolDeleteParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute tool_set_id
+        #
+        #   @return [String]
+        required :tool_set_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(workspace_id:, tool_set_id:, id:, request_options: {})
+        #   @param workspace_id [String]
+        #   @param tool_set_id [String]
+        #   @param id [String]
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/tool_info.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      class ToolInfo < Cadenya::Internal::Type::BaseModel
+        # @!attribute created_by
+        #   A profile identifies a user or non-human principal (such as an API key) at the
+        #   account level. Profiles are account-scoped and can be granted access to multiple
+        #   workspaces.
+        #
+        #   @return [Cadenya::Models::Profile, nil]
+        optional :created_by, -> { Cadenya::Profile }, api_name: :createdBy
+
+        # @!attribute tool_set
+        #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @return [Cadenya::Models::ResourceMetadata, nil]
+        optional :tool_set, -> { Cadenya::ResourceMetadata }, api_name: :toolSet
+
+        # @!method initialize(created_by: nil, tool_set: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ToolSets::ToolInfo} for more details.
+        #
+        #   @param created_by [Cadenya::Models::Profile] A profile identifies a user or non-human principal (such as an API key)
+        #
+        #   @param tool_set [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/tool_list_params.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      # @see Cadenya::Resources::ToolSets::Tools#list
+      class ToolListParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute tool_set_id
+        #
+        #   @return [String]
+        required :tool_set_id, String
+
+        # @!attribute bundle_key
+        #   Filter by bundle_key — return only resources owned by this bundle.
+        #
+        #   @return [String, nil]
+        optional :bundle_key, String
+
+        # @!attribute cursor
+        #   Pagination cursor from previous response
+        #
+        #   @return [String, nil]
+        optional :cursor, String
+
+        # @!attribute include_info
+        #   When set to true you may use more of your alloted API rate-limit
+        #
+        #   @return [Boolean, nil]
+        optional :include_info, Cadenya::Internal::Type::Boolean
+
+        # @!attribute limit
+        #   Maximum number of results to return
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute names
+        #   Filter by tool name (exact match). Multiple values are OR'd together.
+        #
+        #   @return [Array<String>, nil]
+        optional :names, Cadenya::Internal::Type::ArrayOf[String]
+
+        # @!attribute prefix
+        #   Filter expression (query param: prefix)
+        #
+        #   @return [String, nil]
+        optional :prefix, String
+
+        # @!attribute query
+        #   Free-form search query
+        #
+        #   @return [String, nil]
+        optional :query, String
+
+        # @!attribute requires_approval
+        #   Filter by approval requirement. Omitted = no filter; true = only tools requiring
+        #   approval; false = only tools not requiring approval.
+        #
+        #   @return [Boolean, nil]
+        optional :requires_approval, Cadenya::Internal::Type::Boolean
+
+        # @!attribute sort_order
+        #   Sort order for results (asc or desc by creation time)
+        #
+        #   @return [String, nil]
+        optional :sort_order, String
+
+        # @!attribute statuses
+        #   Filter by tool status. Multiple values are OR'd together.
+        #
+        #   @return [Array<Symbol, Cadenya::Models::ToolSets::ToolListParams::Status>, nil]
+        optional :statuses,
+                 -> { Cadenya::Internal::Type::ArrayOf[enum: Cadenya::ToolSets::ToolListParams::Status] }
+
+        # @!method initialize(workspace_id:, tool_set_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: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ToolSets::ToolListParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param tool_set_id [String]
+        #
+        #   @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 names [Array<String>] Filter by tool name (exact match). Multiple values are OR'd together.
+        #
+        #   @param prefix [String] Filter expression (query param: prefix)
+        #
+        #   @param query [String] Free-form search query
+        #
+        #   @param requires_approval [Boolean] Filter by approval requirement. Omitted = no filter; true = only tools
+        #
+        #   @param sort_order [String] Sort order for results (asc or desc by creation time)
+        #
+        #   @param statuses [Array<Symbol, Cadenya::Models::ToolSets::ToolListParams::Status>] Filter by tool status. Multiple values are OR'd together.
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+
+        module Status
+          extend Cadenya::Internal::Type::Enum
+
+          TOOL_STATUS_UNSPECIFIED = :TOOL_STATUS_UNSPECIFIED
+          TOOL_STATUS_AVAILABLE = :TOOL_STATUS_AVAILABLE
+          TOOL_STATUS_OMITTED = :TOOL_STATUS_OMITTED
+          TOOL_STATUS_ARCHIVED = :TOOL_STATUS_ARCHIVED
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/tool_retrieve_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      # @see Cadenya::Resources::ToolSets::Tools#retrieve
+      class ToolRetrieveParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        # @!attribute workspace_id
+        #
+        #   @return [String]
+        required :workspace_id, String
+
+        # @!attribute tool_set_id
+        #
+        #   @return [String]
+        required :tool_set_id, String
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(workspace_id:, tool_set_id:, id:, request_options: {})
+        #   @param workspace_id [String]
+        #   @param tool_set_id [String]
+        #   @param id [String]
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/tool_spec.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      class ToolSpec < Cadenya::Internal::Type::BaseModel
+        # @!attribute config
+        #   Config defines the adapter to use for the tool. This is used to determine how
+        #   the tool is called. For example, if the tool is an HTTP tool, the adapter will
+        #   be Http. If the tool is an inline tool, the adapter will be Inline.
+        #
+        #   @return [Cadenya::Models::ToolSets::ToolSpecConfig]
+        required :config, -> { Cadenya::ToolSets::ToolSpecConfig }
+
+        # @!attribute description
+        #
+        #   @return [String]
+        required :description, String
+
+        # @!attribute parameters
+        #
+        #   @return [Hash{Symbol=>Object}]
+        required :parameters, Cadenya::Internal::Type::HashOf[Cadenya::Internal::Type::Unknown]
+
+        # @!attribute status
+        #
+        #   @return [Symbol, Cadenya::Models::ToolSets::ToolSpec::Status]
+        required :status, enum: -> { Cadenya::ToolSets::ToolSpec::Status }
+
+        # @!attribute requires_approval
+        #
+        #   @return [Boolean, nil]
+        optional :requires_approval, Cadenya::Internal::Type::Boolean, api_name: :requiresApproval
+
+        # @!method initialize(config:, description:, parameters:, status:, requires_approval: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ToolSets::ToolSpec} for more details.
+        #
+        #   @param config [Cadenya::Models::ToolSets::ToolSpecConfig] Config defines the adapter to use for the tool.
+        #
+        #   @param description [String]
+        #
+        #   @param parameters [Hash{Symbol=>Object}]
+        #
+        #   @param status [Symbol, Cadenya::Models::ToolSets::ToolSpec::Status]
+        #
+        #   @param requires_approval [Boolean]
+
+        # @see Cadenya::Models::ToolSets::ToolSpec#status
+        module Status
+          extend Cadenya::Internal::Type::Enum
+
+          TOOL_STATUS_UNSPECIFIED = :TOOL_STATUS_UNSPECIFIED
+          TOOL_STATUS_AVAILABLE = :TOOL_STATUS_AVAILABLE
+          TOOL_STATUS_OMITTED = :TOOL_STATUS_OMITTED
+          TOOL_STATUS_ARCHIVED = :TOOL_STATUS_ARCHIVED
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end