cerca 0.1.0

data/lib/cerca/models/tool_update_params.rb

@@ -0,0 +1,163 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Tools#update
+    class ToolUpdateParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute fleet_id
+      #
+      #   @return [String]
+      required :fleet_id, String
+
+      # @!attribute source_id
+      #
+      #   @return [String]
+      required :source_id, String
+
+      # @!attribute body
+      #
+      #   @return [Cerca::Models::ToolUpdateParams::Body::UpdateHTTPToolSourceRequest, Cerca::Models::ToolUpdateParams::Body::UpdateMcpToolSourceRequest]
+      required :body, union: -> { Cerca::ToolUpdateParams::Body }
+
+      # @!method initialize(fleet_id:, source_id:, body:, request_options: {})
+      #   @param fleet_id [String]
+      #   @param source_id [String]
+      #   @param body [Cerca::Models::ToolUpdateParams::Body::UpdateHTTPToolSourceRequest, Cerca::Models::ToolUpdateParams::Body::UpdateMcpToolSourceRequest]
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+
+      module Body
+        extend Cerca::Internal::Type::Union
+
+        discriminator :type
+
+        variant :http, -> { Cerca::ToolUpdateParams::Body::UpdateHTTPToolSourceRequest }
+
+        variant :mcp, -> { Cerca::ToolUpdateParams::Body::UpdateMcpToolSourceRequest }
+
+        class UpdateHTTPToolSourceRequest < Cerca::Internal::Type::BaseModel
+          # @!attribute auth
+          #   Tool source authentication configuration. The `kind` field selects one of
+          #   `none`, `api_key`, `oauth_exchange`, or `oauth_connection`.
+          #
+          #   @return [Cerca::Models::NoToolSourceAuth, Cerca::Models::APIKeyToolSourceAuth, Cerca::Models::OAuthExchangeToolSourceAuth, Cerca::Models::OAuthConnectionToolSourceAuth]
+          required :auth, union: -> { Cerca::ToolSourceAuth }
+
+          # @!attribute namespace
+          #
+          #   @return [String]
+          required :namespace, String
+
+          # @!attribute tools
+          #
+          #   @return [Array<Cerca::Models::HTTPToolDefinition>]
+          required :tools, -> { Cerca::Internal::Type::ArrayOf[Cerca::HTTPToolDefinition] }
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :http]
+          required :type, const: :http
+
+          # @!attribute approval
+          #
+          #   @return [Symbol, Cerca::Models::ToolApprovalMode, nil]
+          optional :approval, enum: -> { Cerca::ToolApprovalMode }
+
+          # @!attribute enabled
+          #
+          #   @return [Boolean, nil]
+          optional :enabled, Cerca::Internal::Type::Boolean
+
+          # @!attribute execution
+          #   HTTP tool execution retry and timeout policy.
+          #
+          #   @return [Cerca::Models::HTTPToolExecutionPolicy, nil]
+          optional :execution, -> { Cerca::HTTPToolExecutionPolicy }
+
+          # @!method initialize(auth:, namespace:, tools:, approval: nil, enabled: nil, execution: nil, type: :http)
+          #   Some parameter documentations has been truncated, see
+          #   {Cerca::Models::ToolUpdateParams::Body::UpdateHTTPToolSourceRequest} for more
+          #   details.
+          #
+          #   @param auth [Cerca::Models::NoToolSourceAuth, Cerca::Models::APIKeyToolSourceAuth, Cerca::Models::OAuthExchangeToolSourceAuth, Cerca::Models::OAuthConnectionToolSourceAuth] Tool source authentication configuration. The `kind` field selects one of `none`
+          #
+          #   @param namespace [String]
+          #
+          #   @param tools [Array<Cerca::Models::HTTPToolDefinition>]
+          #
+          #   @param approval [Symbol, Cerca::Models::ToolApprovalMode]
+          #
+          #   @param enabled [Boolean]
+          #
+          #   @param execution [Cerca::Models::HTTPToolExecutionPolicy] HTTP tool execution retry and timeout policy.
+          #
+          #   @param type [Symbol, :http]
+        end
+
+        class UpdateMcpToolSourceRequest < Cerca::Internal::Type::BaseModel
+          # @!attribute auth
+          #   Tool source authentication configuration. The `kind` field selects one of
+          #   `none`, `api_key`, `oauth_exchange`, or `oauth_connection`.
+          #
+          #   @return [Cerca::Models::NoToolSourceAuth, Cerca::Models::APIKeyToolSourceAuth, Cerca::Models::OAuthExchangeToolSourceAuth, Cerca::Models::OAuthConnectionToolSourceAuth]
+          required :auth, union: -> { Cerca::ToolSourceAuth }
+
+          # @!attribute namespace
+          #
+          #   @return [String]
+          required :namespace, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :mcp]
+          required :type, const: :mcp
+
+          # @!attribute url
+          #
+          #   @return [String]
+          required :url, String
+
+          # @!attribute approval
+          #
+          #   @return [Symbol, Cerca::Models::ToolApprovalMode, nil]
+          optional :approval, enum: -> { Cerca::ToolApprovalMode }
+
+          # @!attribute enabled
+          #
+          #   @return [Boolean, nil]
+          optional :enabled, Cerca::Internal::Type::Boolean
+
+          # @!attribute execution
+          #   MCP discovery and execution retry/timeout policy.
+          #
+          #   @return [Cerca::Models::McpToolExecutionPolicy, nil]
+          optional :execution, -> { Cerca::McpToolExecutionPolicy }
+
+          # @!method initialize(auth:, namespace:, url:, approval: nil, enabled: nil, execution: nil, type: :mcp)
+          #   Some parameter documentations has been truncated, see
+          #   {Cerca::Models::ToolUpdateParams::Body::UpdateMcpToolSourceRequest} for more
+          #   details.
+          #
+          #   @param auth [Cerca::Models::NoToolSourceAuth, Cerca::Models::APIKeyToolSourceAuth, Cerca::Models::OAuthExchangeToolSourceAuth, Cerca::Models::OAuthConnectionToolSourceAuth] Tool source authentication configuration. The `kind` field selects one of `none`
+          #
+          #   @param namespace [String]
+          #
+          #   @param url [String]
+          #
+          #   @param approval [Symbol, Cerca::Models::ToolApprovalMode]
+          #
+          #   @param enabled [Boolean]
+          #
+          #   @param execution [Cerca::Models::McpToolExecutionPolicy] MCP discovery and execution retry/timeout policy.
+          #
+          #   @param type [Symbol, :mcp]
+        end
+
+        # @!method self.variants
+        #   @return [Array(Cerca::Models::ToolUpdateParams::Body::UpdateHTTPToolSourceRequest, Cerca::Models::ToolUpdateParams::Body::UpdateMcpToolSourceRequest)]
+      end
+    end
+  end
+end

data/lib/cerca/models/turn.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Threads#start_turn
+    class Turn < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute completed_at
+      #
+      #   @return [String, nil]
+      required :completed_at, String, api_name: :completedAt, nil?: true
+
+      # @!attribute end_message_seq
+      #
+      #   @return [Float, nil]
+      required :end_message_seq, Float, api_name: :endMessageSeq, nil?: true
+
+      # @!attribute error
+      #
+      #   @return [String, nil]
+      required :error, String, nil?: true
+
+      # @!attribute message
+      #
+      #   @return [String]
+      required :message, String
+
+      # @!attribute result
+      #
+      #   @return [String, nil]
+      required :result, String, nil?: true
+
+      # @!attribute seq
+      #
+      #   @return [Float]
+      required :seq, Float
+
+      # @!attribute started_at
+      #
+      #   @return [String]
+      required :started_at, String, api_name: :startedAt
+
+      # @!attribute start_message_seq
+      #
+      #   @return [Float]
+      required :start_message_seq, Float, api_name: :startMessageSeq
+
+      # @!attribute status
+      #
+      #   @return [Symbol, Cerca::Models::Turn::Status]
+      required :status, enum: -> { Cerca::Turn::Status }
+
+      # @!attribute thread_id
+      #
+      #   @return [String]
+      required :thread_id, String, api_name: :threadId
+
+      # @!attribute token_usage
+      #
+      #   @return [Cerca::Models::TokenUsage, nil]
+      required :token_usage, -> { Cerca::TokenUsage }, api_name: :tokenUsage, nil?: true
+
+      # @!method initialize(id:, completed_at:, end_message_seq:, error:, message:, result:, seq:, started_at:, start_message_seq:, status:, thread_id:, token_usage:)
+      #   @param id [String]
+      #   @param completed_at [String, nil]
+      #   @param end_message_seq [Float, nil]
+      #   @param error [String, nil]
+      #   @param message [String]
+      #   @param result [String, nil]
+      #   @param seq [Float]
+      #   @param started_at [String]
+      #   @param start_message_seq [Float]
+      #   @param status [Symbol, Cerca::Models::Turn::Status]
+      #   @param thread_id [String]
+      #   @param token_usage [Cerca::Models::TokenUsage, nil]
+
+      # @see Cerca::Models::Turn#status
+      module Status
+        extend Cerca::Internal::Type::Enum
+
+        RUNNING = :running
+        COMPLETED = :completed
+        FAILED = :failed
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cerca/models/webhook_create_params.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Webhooks#create
+    class WebhookCreateParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute fleet_id
+      #
+      #   @return [String]
+      required :fleet_id, String
+
+      # @!attribute url
+      #   HTTPS endpoint that will receive webhook deliveries.
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!attribute events
+      #   Event names to deliver. Omit to subscribe to all non-test events.
+      #
+      #   @return [Array<Symbol, Cerca::Models::WebhookSubscriptionEventType>, nil]
+      optional :events, -> { Cerca::Internal::Type::ArrayOf[enum: Cerca::WebhookSubscriptionEventType] }
+
+      # @!method initialize(fleet_id:, url:, events: nil, request_options: {})
+      #   @param fleet_id [String]
+      #
+      #   @param url [String] HTTPS endpoint that will receive webhook deliveries.
+      #
+      #   @param events [Array<Symbol, Cerca::Models::WebhookSubscriptionEventType>] Event names to deliver. Omit to subscribe to all non-test events.
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/webhook_delete_params.rb

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

data/lib/cerca/models/webhook_event_type.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    module WebhookEventType
+      extend Cerca::Internal::Type::Enum
+
+      AGENT_CREATED = :"agent.created"
+      AGENT_UPDATED = :"agent.updated"
+      AGENT_DELETED = :"agent.deleted"
+      THREAD_CREATED = :"thread.created"
+      THREAD_STATUS_CHANGED = :"thread.status.changed"
+      THREAD_COMPLETED = :"thread.completed"
+      THREAD_FAILED = :"thread.failed"
+      TURN_CREATED = :"turn.created"
+      TURN_COMPLETED = :"turn.completed"
+      TURN_FAILED = :"turn.failed"
+      MESSAGE_CREATED = :"message.created"
+      APPROVAL_REQUESTED = :"approval.requested"
+      APPROVAL_RESOLVED = :"approval.resolved"
+      APPROVAL_GRANTED = :"approval.granted"
+      SCHEDULE_CREATED = :"schedule.created"
+      SCHEDULE_DELETED = :"schedule.deleted"
+      SCHEDULE_TRIGGERED = :"schedule.triggered"
+      CONNECTION_ATTACHED = :"connection.attached"
+      CONNECTION_DETACHED = :"connection.detached"
+      WEBHOOK_TEST = :"webhook.test"
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/cerca/models/webhook_list_params.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Webhooks#list
+    class WebhookListParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      # @!attribute fleet_id
+      #
+      #   @return [String]
+      required :fleet_id, String
+
+      # @!attribute cursor
+      #   Opaque pagination cursor returned by a previous request.
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute limit
+      #   Maximum number of items to return. Defaults to 20 and preserves parseInt
+      #   semantics.
+      #
+      #   @return [String, nil]
+      optional :limit, String
+
+      # @!method initialize(fleet_id:, cursor: nil, limit: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::WebhookListParams} for more details.
+      #
+      #   @param fleet_id [String]
+      #
+      #   @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      #   @param limit [String] Maximum number of items to return. Defaults to 20 and preserves parseInt semanti
+      #
+      #   @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cerca/models/webhook_retrieve_params.rb

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

data/lib/cerca/models/webhook_rotate_params.rb

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

data/lib/cerca/models/webhook_subscription.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Webhooks#retrieve
+    class WebhookSubscription < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute enabled
+      #
+      #   @return [Boolean]
+      required :enabled, Cerca::Internal::Type::Boolean
+
+      # @!attribute events
+      #
+      #   @return [Array<Symbol, Cerca::Models::WebhookEventType>]
+      required :events, -> { Cerca::Internal::Type::ArrayOf[enum: Cerca::WebhookEventType] }
+
+      # @!attribute fleet_id
+      #
+      #   @return [String]
+      required :fleet_id, String, api_name: :fleetId
+
+      # @!attribute updated_at
+      #
+      #   @return [String]
+      required :updated_at, String, api_name: :updatedAt
+
+      # @!attribute url
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!method initialize(id:, created_at:, enabled:, events:, fleet_id:, updated_at:, url:)
+      #   Webhook subscription metadata returned by list, get, and update. The one-time
+      #   signing secret is not returned here.
+      #
+      #   @param id [String]
+      #   @param created_at [String]
+      #   @param enabled [Boolean]
+      #   @param events [Array<Symbol, Cerca::Models::WebhookEventType>]
+      #   @param fleet_id [String]
+      #   @param updated_at [String]
+      #   @param url [String]
+    end
+  end
+end

data/lib/cerca/models/webhook_subscription_created.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Webhooks#create
+    class WebhookSubscriptionCreated < Cerca::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #
+      #   @return [String]
+      required :created_at, String, api_name: :createdAt
+
+      # @!attribute enabled
+      #
+      #   @return [Boolean]
+      required :enabled, Cerca::Internal::Type::Boolean
+
+      # @!attribute events
+      #
+      #   @return [Array<Symbol, Cerca::Models::WebhookEventType>]
+      required :events, -> { Cerca::Internal::Type::ArrayOf[enum: Cerca::WebhookEventType] }
+
+      # @!attribute fleet_id
+      #
+      #   @return [String]
+      required :fleet_id, String, api_name: :fleetId
+
+      # @!attribute secret
+      #   One-time webhook signing secret returned only by create and rotate responses.
+      #   The field name is `secret`.
+      #
+      #   @return [String]
+      required :secret, String
+
+      # @!attribute updated_at
+      #
+      #   @return [String]
+      required :updated_at, String, api_name: :updatedAt
+
+      # @!attribute url
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!method initialize(id:, created_at:, enabled:, events:, fleet_id:, secret:, updated_at:, url:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cerca::Models::WebhookSubscriptionCreated} for more details.
+      #
+      #   Webhook subscription response for create and rotate. Includes the one-time
+      #   `secret` field.
+      #
+      #   @param id [String]
+      #
+      #   @param created_at [String]
+      #
+      #   @param enabled [Boolean]
+      #
+      #   @param events [Array<Symbol, Cerca::Models::WebhookEventType>]
+      #
+      #   @param fleet_id [String]
+      #
+      #   @param secret [String] One-time webhook signing secret returned only by create and rotate responses. Th
+      #
+      #   @param updated_at [String]
+      #
+      #   @param url [String]
+    end
+  end
+end

data/lib/cerca/models/webhook_subscription_event_type.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # `webhook.test` is reserved for the test endpoint and cannot be subscribed to.
+    module WebhookSubscriptionEventType
+      extend Cerca::Internal::Type::Enum
+
+      AGENT_CREATED = :"agent.created"
+      AGENT_UPDATED = :"agent.updated"
+      AGENT_DELETED = :"agent.deleted"
+      THREAD_CREATED = :"thread.created"
+      THREAD_STATUS_CHANGED = :"thread.status.changed"
+      THREAD_COMPLETED = :"thread.completed"
+      THREAD_FAILED = :"thread.failed"
+      TURN_CREATED = :"turn.created"
+      TURN_COMPLETED = :"turn.completed"
+      TURN_FAILED = :"turn.failed"
+      MESSAGE_CREATED = :"message.created"
+      APPROVAL_REQUESTED = :"approval.requested"
+      APPROVAL_RESOLVED = :"approval.resolved"
+      APPROVAL_GRANTED = :"approval.granted"
+      SCHEDULE_CREATED = :"schedule.created"
+      SCHEDULE_DELETED = :"schedule.deleted"
+      SCHEDULE_TRIGGERED = :"schedule.triggered"
+      CONNECTION_ATTACHED = :"connection.attached"
+      CONNECTION_DETACHED = :"connection.detached"
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/cerca/models/webhook_test_params.rb

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

data/lib/cerca/models/webhook_test_response.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Models
+    # @see Cerca::Resources::Webhooks#test_
+    class WebhookTestResponse < Cerca::Internal::Type::BaseModel
+      # @!attribute error
+      #
+      #   @return [String, nil]
+      required :error, String, nil?: true
+
+      # @!attribute status_code
+      #
+      #   @return [Integer, nil]
+      required :status_code, Integer, api_name: :statusCode, nil?: true
+
+      # @!attribute success
+      #
+      #   @return [Boolean]
+      required :success, Cerca::Internal::Type::Boolean
+
+      # @!method initialize(error:, status_code:, success:)
+      #   @param error [String, nil]
+      #   @param status_code [Integer, nil]
+      #   @param success [Boolean]
+    end
+  end
+end