cerca 0.1.0

data/lib/cerca/resources/threads.rb

@@ -0,0 +1,233 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class Threads
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::ThreadCreateParams} for more details.
+      #
+      # Create thread
+      #
+      # @overload create(agent_id, instructions: nil, message: nil, model: nil, system_prompt: nil, tools: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param instructions [String]
+      #
+      # @param message [String]
+      #
+      # @param model [String]
+      #
+      # @param system_prompt [String] Deprecated alias for `instructions`; accepted for backwards compatibility.
+      #
+      # @param tools [Array<String>] Per-thread tool subset. Omit to inherit the agent's full effective tools; pass [
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::Thread]
+      #
+      # @see Cerca::Models::ThreadCreateParams
+      def create(agent_id, params = {})
+        parsed, options = Cerca::ThreadCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["agents/%1$s/threads", agent_id],
+          body: parsed,
+          model: Cerca::Thread,
+          options: options
+        )
+      end
+
+      # Retrieve thread
+      #
+      # @overload retrieve(agent_id, thread_id, debug: nil, include_messages: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param thread_id [String]
+      #
+      # @param debug [Symbol, Cerca::Models::ThreadRetrieveParams::Debug] When true, includes debug-only compiled context fields.
+      #
+      # @param include_messages [Symbol, Cerca::Models::ThreadRetrieveParams::IncludeMessages] When true, includes message content in the thread detail.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::Thread]
+      #
+      # @see Cerca::Models::ThreadRetrieveParams
+      def retrieve(agent_id, thread_id, params = {})
+        parsed, options = Cerca::ThreadRetrieveParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/threads/%2$s", agent_id, thread_id],
+          query: query.transform_keys(include_messages: "includeMessages"),
+          model: Cerca::Thread,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::ThreadListParams} for more details.
+      #
+      # List threads
+      #
+      # @overload list(agent_id, cursor: nil, limit: nil, schedule_id: nil, status: nil, request_options: {})
+      #
+      # @param agent_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 schedule_id [String] Optional schedule id filter.
+      #
+      # @param status [Symbol, Cerca::Models::Status] Optional thread status filter.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Internal::ThreadsCursorPage<Cerca::Models::ThreadSummary>]
+      #
+      # @see Cerca::Models::ThreadListParams
+      def list(agent_id, params = {})
+        parsed, options = Cerca::ThreadListParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/threads", agent_id],
+          query: query.transform_keys(schedule_id: "scheduleId"),
+          page: Cerca::Internal::ThreadsCursorPage,
+          model: Cerca::ThreadSummary,
+          options: options
+        )
+      end
+
+      # Cancel a running or awaiting thread. The underlying runtime treats repeat
+      # cancellation as an idempotent lifecycle operation when possible.
+      #
+      # @overload cancel(agent_id, thread_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param thread_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::Thread]
+      #
+      # @see Cerca::Models::ThreadCancelParams
+      def cancel(agent_id, thread_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["agents/%1$s/threads/%2$s/cancel", agent_id, thread_id],
+          model: Cerca::Thread,
+          options: params[:request_options]
+        )
+      end
+
+      # Close an idle thread. Closing a running, awaiting, or already-closed thread
+      # returns a lifecycle conflict.
+      #
+      # @overload close(agent_id, thread_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param thread_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::Thread]
+      #
+      # @see Cerca::Models::ThreadCloseParams
+      def close(agent_id, thread_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["agents/%1$s/threads/%2$s/close", agent_id, thread_id],
+          model: Cerca::Thread,
+          options: params[:request_options]
+        )
+      end
+
+      # Force context compaction for an idle thread. Compacting a running thread returns
+      # a lifecycle conflict.
+      #
+      # @overload compact(agent_id, thread_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param thread_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::Thread]
+      #
+      # @see Cerca::Models::ThreadCompactParams
+      def compact(agent_id, thread_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["agents/%1$s/threads/%2$s/compact", agent_id, thread_id],
+          model: Cerca::Thread,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::ThreadStartTurnParams} for more details.
+      #
+      # Create turn
+      #
+      # @overload start_turn(agent_id, thread_id, message:, model: nil, tools: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param thread_id [String]
+      #
+      # @param message [String]
+      #
+      # @param model [String]
+      #
+      # @param tools [Array<String>] Per-turn tool subset. Omit to inherit the thread's current tools; pass [] to run
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::Turn]
+      #
+      # @see Cerca::Models::ThreadStartTurnParams
+      def start_turn(agent_id, thread_id, params)
+        parsed, options = Cerca::ThreadStartTurnParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["agents/%1$s/threads/%2$s/turns", agent_id, thread_id],
+          body: parsed,
+          model: Cerca::Turn,
+          options: options
+        )
+      end
+
+      # Steer a thread with another user message. Steering a closed thread returns a
+      # conflict; steering a running or awaiting thread queues the message.
+      #
+      # @overload steer(agent_id, thread_id, message:, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param thread_id [String]
+      # @param message [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::SteerResult]
+      #
+      # @see Cerca::Models::ThreadSteerParams
+      def steer(agent_id, thread_id, params)
+        parsed, options = Cerca::ThreadSteerParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["agents/%1$s/threads/%2$s/steer", agent_id, thread_id],
+          body: parsed,
+          model: Cerca::SteerResult,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cerca/resources/tools.rb

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class Tools
+      # Create tool
+      #
+      # @overload create(fleet_id, body:, request_options: {})
+      #
+      # @param fleet_id [String]
+      # @param body [Cerca::Models::ToolCreateParams::Body::CreateHTTPToolSourceRequest, Cerca::Models::ToolCreateParams::Body::CreateMcpToolSourceRequest]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::HTTPToolSource, Cerca::Models::McpToolSource]
+      #
+      # @see Cerca::Models::ToolCreateParams
+      def create(fleet_id, params)
+        parsed, options = Cerca::ToolCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["fleets/%1$s/tools", fleet_id],
+          body: parsed[:body],
+          model: Cerca::ToolSource,
+          options: options
+        )
+      end
+
+      # Retrieve tool source
+      #
+      # @overload retrieve(fleet_id, source_id, request_options: {})
+      #
+      # @param fleet_id [String]
+      # @param source_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::HTTPToolSource, Cerca::Models::McpToolSource]
+      #
+      # @see Cerca::Models::ToolRetrieveParams
+      def retrieve(fleet_id, source_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["fleets/%1$s/tools/%2$s", fleet_id, source_id],
+          model: Cerca::ToolSource,
+          options: params[:request_options]
+        )
+      end
+
+      # Update tool source
+      #
+      # @overload update(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}, nil]
+      #
+      # @return [Cerca::Models::HTTPToolSource, Cerca::Models::McpToolSource]
+      #
+      # @see Cerca::Models::ToolUpdateParams
+      def update(fleet_id, source_id, params)
+        parsed, options = Cerca::ToolUpdateParams.dump_request(params)
+        @client.request(
+          method: :put,
+          path: ["fleets/%1$s/tools/%2$s", fleet_id, source_id],
+          body: parsed[:body],
+          model: Cerca::ToolSource,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::ToolListParams} for more details.
+      #
+      # List tools
+      #
+      # @overload list(fleet_id, cursor: nil, limit: nil, request_options: {})
+      #
+      # @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}, nil]
+      #
+      # @return [Cerca::Internal::SourcesCursorPage<Cerca::Models::HTTPToolSource, Cerca::Models::McpToolSource>]
+      #
+      # @see Cerca::Models::ToolListParams
+      def list(fleet_id, params = {})
+        parsed, options = Cerca::ToolListParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["fleets/%1$s/tools", fleet_id],
+          query: query,
+          page: Cerca::Internal::SourcesCursorPage,
+          model: Cerca::ToolSource,
+          options: options
+        )
+      end
+
+      # Delete tool source
+      #
+      # @overload delete(fleet_id, source_id, request_options: {})
+      #
+      # @param fleet_id [String]
+      # @param source_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Cerca::Models::ToolDeleteParams
+      def delete(fleet_id, source_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["fleets/%1$s/tools/%2$s", fleet_id, source_id],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cerca/resources/webhooks.rb

@@ -0,0 +1,181 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class Webhooks
+      # Create webhook
+      #
+      # @overload create(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}, nil]
+      #
+      # @return [Cerca::Models::WebhookSubscriptionCreated]
+      #
+      # @see Cerca::Models::WebhookCreateParams
+      def create(fleet_id, params)
+        parsed, options = Cerca::WebhookCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["fleets/%1$s/webhooks", fleet_id],
+          body: parsed,
+          model: Cerca::WebhookSubscriptionCreated,
+          options: options
+        )
+      end
+
+      # Retrieve webhook
+      #
+      # @overload retrieve(fleet_id, webhook_id, request_options: {})
+      #
+      # @param fleet_id [String]
+      # @param webhook_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::WebhookSubscription]
+      #
+      # @see Cerca::Models::WebhookRetrieveParams
+      def retrieve(fleet_id, webhook_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["fleets/%1$s/webhooks/%2$s", fleet_id, webhook_id],
+          model: Cerca::WebhookSubscription,
+          options: params[:request_options]
+        )
+      end
+
+      # Update webhook
+      #
+      # @overload update(fleet_id, webhook_id, enabled: nil, events: nil, url: nil, request_options: {})
+      #
+      # @param fleet_id [String]
+      #
+      # @param webhook_id [String]
+      #
+      # @param enabled [Boolean] Whether deliveries are enabled for this subscription.
+      #
+      # @param events [Array<Symbol, Cerca::Models::WebhookSubscriptionEventType>] Event names to deliver. Omit to subscribe to all non-test events.
+      #
+      # @param url [String] HTTPS endpoint that will receive webhook deliveries.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::WebhookSubscription]
+      #
+      # @see Cerca::Models::WebhookUpdateParams
+      def update(fleet_id, webhook_id, params = {})
+        parsed, options = Cerca::WebhookUpdateParams.dump_request(params)
+        @client.request(
+          method: :put,
+          path: ["fleets/%1$s/webhooks/%2$s", fleet_id, webhook_id],
+          body: parsed,
+          model: Cerca::WebhookSubscription,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::WebhookListParams} for more details.
+      #
+      # List webhooks
+      #
+      # @overload list(fleet_id, cursor: nil, limit: nil, request_options: {})
+      #
+      # @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}, nil]
+      #
+      # @return [Cerca::Internal::SubscriptionsCursorPage<Cerca::Models::WebhookSubscription>]
+      #
+      # @see Cerca::Models::WebhookListParams
+      def list(fleet_id, params = {})
+        parsed, options = Cerca::WebhookListParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["fleets/%1$s/webhooks", fleet_id],
+          query: query,
+          page: Cerca::Internal::SubscriptionsCursorPage,
+          model: Cerca::WebhookSubscription,
+          options: options
+        )
+      end
+
+      # Delete webhook
+      #
+      # @overload delete(fleet_id, webhook_id, request_options: {})
+      #
+      # @param fleet_id [String]
+      # @param webhook_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Cerca::Models::WebhookDeleteParams
+      def delete(fleet_id, webhook_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["fleets/%1$s/webhooks/%2$s", fleet_id, webhook_id],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
+      # Rotate webhook secret
+      #
+      # @overload rotate(fleet_id, webhook_id, request_options: {})
+      #
+      # @param fleet_id [String]
+      # @param webhook_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::WebhookSubscriptionCreated]
+      #
+      # @see Cerca::Models::WebhookRotateParams
+      def rotate(fleet_id, webhook_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["fleets/%1$s/webhooks/%2$s/rotate", fleet_id, webhook_id],
+          model: Cerca::WebhookSubscriptionCreated,
+          options: params[:request_options]
+        )
+      end
+
+      # Send test webhook
+      #
+      # @overload test_(fleet_id, webhook_id, request_options: {})
+      #
+      # @param fleet_id [String]
+      # @param webhook_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::WebhookTestResponse]
+      #
+      # @see Cerca::Models::WebhookTestParams
+      def test_(fleet_id, webhook_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["fleets/%1$s/webhooks/%2$s/test", fleet_id, webhook_id],
+          model: Cerca::Models::WebhookTestResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cerca/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Cerca
+  VERSION = "0.1.0"
+end