cerca 0.1.0

data/lib/cerca/models/connection.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Connections#create
+    class Connection < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute account_label
+      #
+      #   @return [String, nil]
+      required :account_label, String, api_name: :accountLabel, nil?: true
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute owner
+      #   Public owner for a reusable connection. Organization owners use the
+      #   authenticated organization; fleet owners add a fleetId.
+      #
+      #   @return [Cerca::Models::ConnectionOwner::OrganizationConnectionOwner, Cerca::Models::ConnectionOwner::FleetConnectionOwner]
+      required :owner, union: -> { Cerca::ConnectionOwner }
+
+      # @!attribute provider
+      #
+      #   @return [Symbol, Cerca::Models::CredentialProvider]
+      required :provider, enum: -> { Cerca::CredentialProvider }
+
+      # @!attribute scopes
+      #
+      #   @return [Array<String>]
+      required :scopes, Cerca::Internal::Type::ArrayOf[String]
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Cerca::Models::CredentialType]
+      required :type, enum: -> { Cerca::CredentialType }
+
+      # @!attribute updated_at
+      #
+      #   @return [String]
+      required :updated_at, String, api_name: :updatedAt
+
+      # @!method initialize(id:, account_label:, created_at:, owner:, provider:, scopes:, type:, updated_at:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::Connection} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param account_label [String, nil]
+      #
+      #   @param created_at [String]
+      #
+      #   @param owner [Cerca::Models::ConnectionOwner::OrganizationConnectionOwner, Cerca::Models::ConnectionOwner::FleetConnectionOwner] Public owner for a reusable connection. Organization owners use the authenticate
+      #
+      #   @param provider [Symbol, Cerca::Models::CredentialProvider]
+      #
+      #   @param scopes [Array<String>]
+      #
+      #   @param type [Symbol, Cerca::Models::CredentialType]
+      #
+      #   @param updated_at [String]
+    end
+  end
+end

data/lib/cerca/models/connection_attach_params.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Connections#attach
+    class ConnectionAttachParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute connection_id
+      #
+      #   @return [String]
+      required :connection_id, String, api_name: :connectionId
+
+      # @!attribute metadata
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :metadata, Cerca::Internal::Type::HashOf[String]
+
+      # @!method initialize(agent_id:, connection_id:, metadata: nil, request_options: {})
+      #   @param agent_id [String]
+      #   @param connection_id [String]
+      #   @param metadata [Hash{Symbol=>String}]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/connection_create_params.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Connections#create
+    class ConnectionCreateParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute api_key
+      #   API key secret. It is stored securely and is not returned.
+      #
+      #   @return [String]
+      required :api_key, String, api_name: :apiKey
+
+      # @!attribute owner
+      #   Public owner for a reusable connection. Organization owners use the
+      #   authenticated organization; fleet owners add a fleetId.
+      #
+      #   @return [Cerca::Models::ConnectionOwner::OrganizationConnectionOwner, Cerca::Models::ConnectionOwner::FleetConnectionOwner]
+      required :owner, union: -> { Cerca::ConnectionOwner }
+
+      # @!attribute provider
+      #   Credential provider to store an API key for.
+      #
+      #   @return [String]
+      required :provider, String
+
+      # @!attribute account_label
+      #   Optional human-readable account label.
+      #
+      #   @return [String, nil]
+      optional :account_label, String, api_name: :accountLabel
+
+      # @!method initialize(api_key:, owner:, provider:, account_label: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::ConnectionCreateParams} for more details.
+      #
+      #   @param api_key [String] API key secret. It is stored securely and is not returned.
+      #
+      #   @param owner [Cerca::Models::ConnectionOwner::OrganizationConnectionOwner, Cerca::Models::ConnectionOwner::FleetConnectionOwner] Public owner for a reusable connection. Organization owners use the authenticate
+      #
+      #   @param provider [String] Credential provider to store an API key for.
+      #
+      #   @param account_label [String] Optional human-readable account label.
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/connection_delete_params.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Connections#delete
+    class ConnectionDeleteParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute connection_id
+      #
+      #   @return [String]
+      required :connection_id, String
+
+      # @!attribute owner_type
+      #   Public connection owner type.
+      #
+      #   @return [Symbol, Cerca::Models::ConnectionDeleteParams::OwnerType]
+      required :owner_type, enum: -> { Cerca::ConnectionDeleteParams::OwnerType }
+
+      # @!attribute fleet_id
+      #   Required when ownerType is fleet.
+      #
+      #   @return [String, nil]
+      optional :fleet_id, String
+
+      # @!method initialize(connection_id:, owner_type:, fleet_id: nil, request_options: {})
+      #   @param connection_id [String]
+      #
+      #   @param owner_type [Symbol, Cerca::Models::ConnectionDeleteParams::OwnerType] Public connection owner type.
+      #
+      #   @param fleet_id [String] Required when ownerType is fleet.
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+
+      # Public connection owner type.
+      module OwnerType
+        extend Cerca::Internal::Type::Enum
+
+        ORGANIZATION = :organization
+        FLEET = :fleet
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/connection_delete_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Connections#delete
+    class ConnectionDeleteResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute success
+      #
+      #   @return [Boolean, true]
+      required :success, const: true
+
+      # @!method initialize(success: true)
+      #   @param success [Boolean, true]
+    end
+  end
+end

data/lib/cerca/models/connection_detach_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Connections#detach
+    class ConnectionDetachParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute connection_id
+      #
+      #   @return [String]
+      required :connection_id, String
+
+      # @!method initialize(agent_id:, connection_id:, request_options: {})
+      #   @param agent_id [String]
+      #   @param connection_id [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/connection_detach_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Connections#detach
+    class ConnectionDetachResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute success
+      #
+      #   @return [Boolean, true]
+      required :success, const: true
+
+      # @!method initialize(success: true)
+      #   @param success [Boolean, true]
+    end
+  end
+end

data/lib/cerca/models/connection_list_for_agent_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Connections#list_for_agent
+    class ConnectionListForAgentParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!method initialize(agent_id:, request_options: {})
+      #   @param agent_id [String]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/connection_list_for_agent_response.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Connections#list_for_agent
+    class ConnectionListForAgentResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute connections
+      #
+      #   @return [Array<Cerca::Models::AttachedConnection>]
+      required :connections, -> { Cerca::Internal::Type::ArrayOf[Cerca::AttachedConnection] }
+
+      # @!attribute cursor
+      #
+      #   @return [String, nil]
+      required :cursor, String, nil?: true
+
+      # @!attribute has_more
+      #
+      #   @return [Boolean]
+      required :has_more, Cerca::Internal::Type::Boolean, api_name: :hasMore
+
+      # @!method initialize(connections:, cursor:, has_more:)
+      #   @param connections [Array<Cerca::Models::AttachedConnection>]
+      #   @param cursor [String, nil]
+      #   @param has_more [Boolean]
+    end
+  end
+end

data/lib/cerca/models/connection_list_params.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Connections#list
+    class ConnectionListParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute owner_type
+      #   Public connection owner type.
+      #
+      #   @return [Symbol, Cerca::Models::ConnectionListParams::OwnerType]
+      required :owner_type, enum: -> { Cerca::ConnectionListParams::OwnerType }
+
+      # @!attribute cursor
+      #   Opaque pagination cursor returned by a previous request.
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute fleet_id
+      #   Required when ownerType is fleet.
+      #
+      #   @return [String, nil]
+      optional :fleet_id, String
+
+      # @!attribute limit
+      #   Maximum number of items to return. Defaults to 20 and preserves parseInt
+      #   semantics.
+      #
+      #   @return [String, nil]
+      optional :limit, String
+
+      # @!method initialize(owner_type:, cursor: nil, fleet_id: nil, limit: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::ConnectionListParams} for more details.
+      #
+      #   @param owner_type [Symbol, Cerca::Models::ConnectionListParams::OwnerType] Public connection owner type.
+      #
+      #   @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      #   @param fleet_id [String] Required when ownerType is fleet.
+      #
+      #   @param limit [String] Maximum number of items to return. Defaults to 20 and preserves parseInt semanti
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+
+      # Public connection owner type.
+      module OwnerType
+        extend Cerca::Internal::Type::Enum
+
+        ORGANIZATION = :organization
+        FLEET = :fleet
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/connection_owner.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # Public owner for a reusable connection. Organization owners use the
+    # authenticated organization; fleet owners add a fleetId.
+    module ConnectionOwner
+      extend Cerca::Internal::Type::Union
+
+      discriminator :type
+
+      variant :organization, -> { Cerca::ConnectionOwner::OrganizationConnectionOwner }
+
+      variant :fleet, -> { Cerca::ConnectionOwner::FleetConnectionOwner }
+
+      class OrganizationConnectionOwner < Cerca::Internal::Type::BaseModel
+        # @!attribute type
+        #
+        #   @return [Symbol, :organization]
+        required :type, const: :organization
+
+        # @!method initialize(type: :organization)
+        #   @param type [Symbol, :organization]
+      end
+
+      class FleetConnectionOwner < Cerca::Internal::Type::BaseModel
+        # @!attribute fleet_id
+        #
+        #   @return [String]
+        required :fleet_id, String, api_name: :fleetId
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :fleet]
+        required :type, const: :fleet
+
+        # @!method initialize(fleet_id:, type: :fleet)
+        #   @param fleet_id [String]
+        #   @param type [Symbol, :fleet]
+      end
+
+      # @!method self.variants
+      #   @return [Array(Cerca::Models::ConnectionOwner::OrganizationConnectionOwner, Cerca::Models::ConnectionOwner::FleetConnectionOwner)]
+    end
+  end
+end

data/lib/cerca/models/content_block.rb

@@ -0,0 +1,209 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # Message content block. The `type` field distinguishes text, tool use, tool
+    # result, server tool use, and web search result blocks.
+    module ContentBlock
+      extend Cerca::Internal::Type::Union
+
+      discriminator :type
+
+      variant :text, -> { Cerca::ContentBlock::TextContentBlock }
+
+      variant :tool_use, -> { Cerca::ContentBlock::ToolUseContentBlock }
+
+      variant :tool_result, -> { Cerca::ContentBlock::ToolResultContentBlock }
+
+      variant :server_tool_use, -> { Cerca::ContentBlock::ServerToolUseContentBlock }
+
+      variant :web_search_tool_result, -> { Cerca::ContentBlock::WebSearchToolResultContentBlock }
+
+      class TextContentBlock < Cerca::Internal::Type::BaseModel
+        # @!attribute text
+        #
+        #   @return [String]
+        required :text, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :text]
+        required :type, const: :text
+
+        # @!attribute provider_metadata
+        #
+        #   @return [Hash{Symbol=>Hash{Symbol=>String}}, nil]
+        optional :provider_metadata,
+                 Cerca::Internal::Type::HashOf[Cerca::Internal::Type::HashOf[String]],
+                 api_name: :providerMetadata
+
+        # @!method initialize(text:, provider_metadata: nil, type: :text)
+        #   @param text [String]
+        #   @param provider_metadata [Hash{Symbol=>Hash{Symbol=>String}}]
+        #   @param type [Symbol, :text]
+      end
+
+      class ToolUseContentBlock < Cerca::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute input
+        #   Any JSON value. Generated SDKs may expose this value boundary as unknown or Any.
+        #
+        #   @return [Object]
+        required :input, Cerca::Internal::Type::Unknown
+
+        # @!attribute name
+        #
+        #   @return [Symbol, Cerca::Models::ToolName]
+        required :name, enum: -> { Cerca::ToolName }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :tool_use]
+        required :type, const: :tool_use
+
+        # @!attribute provider_metadata
+        #
+        #   @return [Hash{Symbol=>Hash{Symbol=>String}}, nil]
+        optional :provider_metadata,
+                 Cerca::Internal::Type::HashOf[Cerca::Internal::Type::HashOf[String]],
+                 api_name: :providerMetadata
+
+        # @!method initialize(id:, input:, name:, provider_metadata: nil, type: :tool_use)
+        #   Some parameter documentations has been truncated, see
+        #   {Cerca::Models::ContentBlock::ToolUseContentBlock} for more details.
+        #
+        #   @param id [String]
+        #
+        #   @param input [Object] Any JSON value. Generated SDKs may expose this value boundary as unknown or Any.
+        #
+        #   @param name [Symbol, Cerca::Models::ToolName]
+        #
+        #   @param provider_metadata [Hash{Symbol=>Hash{Symbol=>String}}]
+        #
+        #   @param type [Symbol, :tool_use]
+      end
+
+      class ToolResultContentBlock < Cerca::Internal::Type::BaseModel
+        # @!attribute content
+        #
+        #   @return [String]
+        required :content, String
+
+        # @!attribute is_error
+        #
+        #   @return [Boolean]
+        required :is_error, Cerca::Internal::Type::Boolean, api_name: :isError
+
+        # @!attribute tool_use_id
+        #
+        #   @return [String]
+        required :tool_use_id, String, api_name: :toolUseId
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :tool_result]
+        required :type, const: :tool_result
+
+        # @!attribute denied_by_user
+        #
+        #   @return [Boolean, nil]
+        optional :denied_by_user, Cerca::Internal::Type::Boolean, api_name: :deniedByUser
+
+        # @!attribute provider_metadata
+        #
+        #   @return [Hash{Symbol=>Hash{Symbol=>String}}, nil]
+        optional :provider_metadata,
+                 Cerca::Internal::Type::HashOf[Cerca::Internal::Type::HashOf[String]],
+                 api_name: :providerMetadata
+
+        # @!method initialize(content:, is_error:, tool_use_id:, denied_by_user: nil, provider_metadata: nil, type: :tool_result)
+        #   @param content [String]
+        #   @param is_error [Boolean]
+        #   @param tool_use_id [String]
+        #   @param denied_by_user [Boolean]
+        #   @param provider_metadata [Hash{Symbol=>Hash{Symbol=>String}}]
+        #   @param type [Symbol, :tool_result]
+      end
+
+      class ServerToolUseContentBlock < Cerca::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute input
+        #   Any JSON value. Generated SDKs may expose this value boundary as unknown or Any.
+        #
+        #   @return [Object]
+        required :input, Cerca::Internal::Type::Unknown
+
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :server_tool_use]
+        required :type, const: :server_tool_use
+
+        # @!attribute provider_metadata
+        #
+        #   @return [Hash{Symbol=>Hash{Symbol=>String}}, nil]
+        optional :provider_metadata,
+                 Cerca::Internal::Type::HashOf[Cerca::Internal::Type::HashOf[String]],
+                 api_name: :providerMetadata
+
+        # @!method initialize(id:, input:, name:, provider_metadata: nil, type: :server_tool_use)
+        #   Some parameter documentations has been truncated, see
+        #   {Cerca::Models::ContentBlock::ServerToolUseContentBlock} for more details.
+        #
+        #   @param id [String]
+        #
+        #   @param input [Object] Any JSON value. Generated SDKs may expose this value boundary as unknown or Any.
+        #
+        #   @param name [String]
+        #
+        #   @param provider_metadata [Hash{Symbol=>Hash{Symbol=>String}}]
+        #
+        #   @param type [Symbol, :server_tool_use]
+      end
+
+      class WebSearchToolResultContentBlock < Cerca::Internal::Type::BaseModel
+        # @!attribute content
+        #   Web search result payload. The runtime returns either an array of web search
+        #   results or an error object.
+        #
+        #   @return [Object]
+        required :content, Cerca::Internal::Type::Unknown
+
+        # @!attribute tool_use_id
+        #
+        #   @return [String]
+        required :tool_use_id, String, api_name: :toolUseId
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :web_search_tool_result]
+        required :type, const: :web_search_tool_result
+
+        # @!method initialize(content:, tool_use_id:, type: :web_search_tool_result)
+        #   Some parameter documentations has been truncated, see
+        #   {Cerca::Models::ContentBlock::WebSearchToolResultContentBlock} for more details.
+        #
+        #   @param content [Object] Web search result payload. The runtime returns either an array of web search res
+        #
+        #   @param tool_use_id [String]
+        #
+        #   @param type [Symbol, :web_search_tool_result]
+      end
+
+      # @!method self.variants
+      #   @return [Array(Cerca::Models::ContentBlock::TextContentBlock, Cerca::Models::ContentBlock::ToolUseContentBlock, Cerca::Models::ContentBlock::ToolResultContentBlock, Cerca::Models::ContentBlock::ServerToolUseContentBlock, Cerca::Models::ContentBlock::WebSearchToolResultContentBlock)]
+    end
+  end
+end

data/lib/cerca/models/context_delete_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Context#delete
+    class ContextDeleteParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute key
+      #   Context entry key.
+      #
+      #   @return [String]
+      required :key, String
+
+      # @!method initialize(agent_id:, key:, request_options: {})
+      #   @param agent_id [String]
+      #
+      #   @param key [String] Context entry key.
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/context_delete_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Context#delete
+    class ContextDeleteResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute success
+      #
+      #   @return [Boolean, true]
+      required :success, const: true
+
+      # @!method initialize(success: true)
+      #   @param success [Boolean, true]
+    end
+  end
+end