cerca 0.1.0

data/lib/cerca/resources/events.rb

@@ -0,0 +1,269 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class Events
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::EventListForAgentParams} for more details.
+      #
+      # List events
+      #
+      # @overload list_for_agent(agent_id, cursor: nil, events: nil, history: nil, limit: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      # @param events [String] Comma-separated event type filter.
+      #
+      # @param history [Symbol, Cerca::Models::EventListForAgentParams::History] When true, starts from the beginning of the retained buffer.
+      #
+      # @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::EventsCursorPage<Cerca::Models::SubscriptionEvent>]
+      #
+      # @see Cerca::Models::EventListForAgentParams
+      def list_for_agent(agent_id, params = {})
+        parsed, options = Cerca::EventListForAgentParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/events", agent_id],
+          query: query,
+          page: Cerca::Internal::EventsCursorPage,
+          model: Cerca::SubscriptionEvent,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::EventListForFleetParams} for more details.
+      #
+      # List events
+      #
+      # @overload list_for_fleet(fleet_id, cursor: nil, events: nil, history: nil, limit: nil, request_options: {})
+      #
+      # @param fleet_id [String]
+      #
+      # @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      # @param events [String] Comma-separated event type filter.
+      #
+      # @param history [Symbol, Cerca::Models::EventListForFleetParams::History] When true, starts from the beginning of the retained buffer.
+      #
+      # @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::EventsCursorPage<Cerca::Models::SubscriptionEvent>]
+      #
+      # @see Cerca::Models::EventListForFleetParams
+      def list_for_fleet(fleet_id, params = {})
+        parsed, options = Cerca::EventListForFleetParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["fleets/%1$s/events", fleet_id],
+          query: query,
+          page: Cerca::Internal::EventsCursorPage,
+          model: Cerca::SubscriptionEvent,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::EventListForThreadParams} for more details.
+      #
+      # List events
+      #
+      # @overload list_for_thread(agent_id, thread_id, cursor: nil, events: nil, history: nil, limit: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param thread_id [String]
+      #
+      # @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      # @param events [String] Comma-separated event type filter.
+      #
+      # @param history [Symbol, Cerca::Models::EventListForThreadParams::History] When true, starts from the beginning of the retained buffer.
+      #
+      # @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::EventsCursorPage<Cerca::Models::SubscriptionEvent>]
+      #
+      # @see Cerca::Models::EventListForThreadParams
+      def list_for_thread(agent_id, thread_id, params = {})
+        parsed, options = Cerca::EventListForThreadParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/threads/%2$s/events", agent_id, thread_id],
+          query: query,
+          page: Cerca::Internal::EventsCursorPage,
+          model: Cerca::SubscriptionEvent,
+          options: options
+        )
+      end
+
+      # Server-Sent Events stream. Each SSE data frame is JSON matching this response
+      # schema.
+      #
+      # @overload stream_for_agent_streaming(agent_id, cursor: nil, events: nil, history: nil, last_event_id: nil, request_options: {})
+      #
+      # @param agent_id [String] Path param
+      #
+      # @param cursor [String] Query param: Opaque pagination cursor returned by a previous request.
+      #
+      # @param events [String] Query param: Comma-separated event type filter.
+      #
+      # @param history [Symbol, Cerca::Models::EventStreamForAgentParams::History] Query param: When true, starts from the beginning of the retained buffer.
+      #
+      # @param last_event_id [String] Header param: Resume an event-log stream after the last received SSE event id.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Internal::Stream<Cerca::Models::SubscriptionEvent>]
+      #
+      # @see Cerca::Models::EventStreamForAgentParams
+      def stream_for_agent_streaming(agent_id, params = {})
+        query_params = [:cursor, :events, :history]
+        parsed, options = Cerca::EventStreamForAgentParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed.slice(*query_params))
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/events/stream", agent_id],
+          query: query,
+          headers: {
+            "accept" => "text/event-stream",
+            "accept-encoding" => "identity",
+            **parsed.except(*query_params)
+          }.transform_keys(
+            last_event_id: "last-event-id"
+          ),
+          stream: Cerca::Internal::Stream,
+          model: Cerca::SubscriptionEvent,
+          options: options
+        )
+      end
+
+      # Server-Sent Events stream. Each SSE data frame is JSON matching this response
+      # schema.
+      #
+      # @overload stream_for_fleet_streaming(fleet_id, cursor: nil, events: nil, history: nil, last_event_id: nil, request_options: {})
+      #
+      # @param fleet_id [String] Path param
+      #
+      # @param cursor [String] Query param: Opaque pagination cursor returned by a previous request.
+      #
+      # @param events [String] Query param: Comma-separated event type filter.
+      #
+      # @param history [Symbol, Cerca::Models::EventStreamForFleetParams::History] Query param: When true, starts from the beginning of the retained buffer.
+      #
+      # @param last_event_id [String] Header param: Resume an event-log stream after the last received SSE event id.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Internal::Stream<Cerca::Models::SubscriptionEvent>]
+      #
+      # @see Cerca::Models::EventStreamForFleetParams
+      def stream_for_fleet_streaming(fleet_id, params = {})
+        query_params = [:cursor, :events, :history]
+        parsed, options = Cerca::EventStreamForFleetParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed.slice(*query_params))
+        @client.request(
+          method: :get,
+          path: ["fleets/%1$s/events/stream", fleet_id],
+          query: query,
+          headers: {
+            "accept" => "text/event-stream",
+            "accept-encoding" => "identity",
+            **parsed.except(*query_params)
+          }.transform_keys(
+            last_event_id: "last-event-id"
+          ),
+          stream: Cerca::Internal::Stream,
+          model: Cerca::SubscriptionEvent,
+          options: options
+        )
+      end
+
+      # Server-Sent Events stream. Each SSE data frame is JSON matching this response
+      # schema.
+      #
+      # @overload stream_for_thread_streaming(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::Internal::Stream<Cerca::Models::ThreadStreamEvent::ThreadStreamStatusMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamContentMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamProgressMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamTurnStartedMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamTurnCompletedMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamItemStartedMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamItemCompletedMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamTokenUsageMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalRequestedMessage, Cerca::Models::ThreadStreamEvent::ThreadStreamApprovalResolvedMessage>]
+      #
+      # @see Cerca::Models::EventStreamForThreadParams
+      def stream_for_thread_streaming(agent_id, thread_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/threads/%2$s/stream", agent_id, thread_id],
+          headers: {"accept" => "text/event-stream", "accept-encoding" => "identity"},
+          stream: Cerca::Internal::Stream,
+          model: Cerca::ThreadStreamEvent,
+          options: params[:request_options]
+        )
+      end
+
+      # Server-Sent Events stream. Each SSE data frame is JSON matching this response
+      # schema.
+      #
+      # @overload stream_for_thread_events_streaming(agent_id, thread_id, cursor: nil, events: nil, history: nil, last_event_id: nil, request_options: {})
+      #
+      # @param agent_id [String] Path param
+      #
+      # @param thread_id [String] Path param
+      #
+      # @param cursor [String] Query param: Opaque pagination cursor returned by a previous request.
+      #
+      # @param events [String] Query param: Comma-separated event type filter.
+      #
+      # @param history [Symbol, Cerca::Models::EventStreamForThreadEventsParams::History] Query param: When true, starts from the beginning of the retained buffer.
+      #
+      # @param last_event_id [String] Header param: Resume an event-log stream after the last received SSE event id.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Internal::Stream<Cerca::Models::SubscriptionEvent>]
+      #
+      # @see Cerca::Models::EventStreamForThreadEventsParams
+      def stream_for_thread_events_streaming(agent_id, thread_id, params = {})
+        query_params = [:cursor, :events, :history]
+        parsed, options = Cerca::EventStreamForThreadEventsParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed.slice(*query_params))
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/threads/%2$s/events/stream", agent_id, thread_id],
+          query: query,
+          headers: {
+            "accept" => "text/event-stream",
+            "accept-encoding" => "identity",
+            **parsed.except(*query_params)
+          }.transform_keys(
+            last_event_id: "last-event-id"
+          ),
+          stream: Cerca::Internal::Stream,
+          model: Cerca::SubscriptionEvent,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cerca/resources/fleets.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class Fleets
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cerca/resources/models.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class Models
+      # List models
+      #
+      # @overload list(request_options: {})
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::ModelListResponse]
+      #
+      # @see Cerca::Models::ModelListParams
+      def list(params = {})
+        @client.request(
+          method: :get,
+          path: "models",
+          model: Cerca::Models::ModelListResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cerca/resources/oauth.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class OAuth
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::OAuthConnectParams} for more details.
+      #
+      # Start OAuth authorization
+      #
+      # @overload connect(provider, owner:, return_origin:, scopes: nil, request_options: {})
+      #
+      # @param provider [String]
+      #
+      # @param owner [Cerca::Models::ConnectionOwner::OrganizationConnectionOwner, Cerca::Models::ConnectionOwner::FleetConnectionOwner] Public owner for a reusable connection. Organization owners use the authenticate
+      #
+      # @param return_origin [String] HTTP(S) origin that receives the OAuth completion message.
+      #
+      # @param scopes [Array<String>] Provider-specific OAuth scopes. Empty entries are ignored after trimming.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::OAuthConnectResponse]
+      #
+      # @see Cerca::Models::OAuthConnectParams
+      def connect(provider, params)
+        parsed, options = Cerca::OAuthConnectParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["oauth/connect/%1$s", provider],
+          body: parsed,
+          model: Cerca::OAuthConnectResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cerca/resources/sandbox.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class Sandbox
+      # Execute sandbox command
+      #
+      # @overload exec_(agent_id, command:, max_buffer: nil, execution_timeout: nil, workdir: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param command [String]
+      #
+      # @param max_buffer [Float]
+      #
+      # @param execution_timeout [Float] Timeout in seconds. Runtime converts this to milliseconds.
+      #
+      # @param workdir [String, nil] Optional sandbox working directory.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::ExecResult]
+      #
+      # @see Cerca::Models::SandboxExecParams
+      def exec_(agent_id, params)
+        parsed, options = Cerca::SandboxExecParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["agents/%1$s/sandbox/exec", agent_id],
+          body: parsed,
+          model: Cerca::ExecResult,
+          options: options
+        )
+      end
+
+      # Read sandbox file
+      #
+      # @overload read(agent_id, path:, limit: nil, offset: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param path [String]
+      # @param limit [Float]
+      # @param offset [Float]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::ReadResponse]
+      #
+      # @see Cerca::Models::SandboxReadParams
+      def read(agent_id, params)
+        parsed, options = Cerca::SandboxReadParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["agents/%1$s/sandbox/read", agent_id],
+          body: parsed,
+          model: Cerca::ReadResponse,
+          options: options
+        )
+      end
+
+      # Write sandbox file
+      #
+      # @overload write(agent_id, content:, path:, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param content [String]
+      # @param path [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::SandboxWriteResponse]
+      #
+      # @see Cerca::Models::SandboxWriteParams
+      def write(agent_id, params)
+        parsed, options = Cerca::SandboxWriteParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["agents/%1$s/sandbox/write", agent_id],
+          body: parsed,
+          model: Cerca::Models::SandboxWriteResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cerca/resources/schedules.rb

@@ -0,0 +1,159 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class Schedules
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::ScheduleCreateParams} for more details.
+      #
+      # Create schedule
+      #
+      # @overload create(agent_id, message:, name:, cron: nil, instructions: nil, model: nil, run_at: nil, timezone: nil, tools: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param message [String]
+      #
+      # @param name [String]
+      #
+      # @param cron [String]
+      #
+      # @param instructions [String]
+      #
+      # @param model [String]
+      #
+      # @param run_at [Time]
+      #
+      # @param timezone [String]
+      #
+      # @param tools [Array<String>] Per-schedule tool subset. When the schedule starts a thread, these tools can onl
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::Schedule]
+      #
+      # @see Cerca::Models::ScheduleCreateParams
+      def create(agent_id, params)
+        parsed, options = Cerca::ScheduleCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["agents/%1$s/schedules", agent_id],
+          body: parsed,
+          model: Cerca::Schedule,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::ScheduleUpdateParams} for more details.
+      #
+      # Update schedule
+      #
+      # @overload update(agent_id, schedule_id, cron: nil, enabled: nil, instructions: nil, message: nil, model: nil, name: nil, run_at: nil, timezone: nil, tools: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param schedule_id [String]
+      #
+      # @param cron [String]
+      #
+      # @param enabled [Boolean]
+      #
+      # @param instructions [String]
+      #
+      # @param message [String]
+      #
+      # @param model [String]
+      #
+      # @param name [String]
+      #
+      # @param run_at [Time]
+      #
+      # @param timezone [String]
+      #
+      # @param tools [Array<String>] Per-schedule tool subset. When updated, these tools can only narrow the agent's
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::Schedule]
+      #
+      # @see Cerca::Models::ScheduleUpdateParams
+      def update(agent_id, schedule_id, params = {})
+        parsed, options = Cerca::ScheduleUpdateParams.dump_request(params)
+        @client.request(
+          method: :put,
+          path: ["agents/%1$s/schedules/%2$s", agent_id, schedule_id],
+          body: parsed,
+          model: Cerca::Schedule,
+          options: options
+        )
+      end
+
+      # List schedules
+      #
+      # @overload list(agent_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::ScheduleListResponse]
+      #
+      # @see Cerca::Models::ScheduleListParams
+      def list(agent_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/schedules", agent_id],
+          model: Cerca::Models::ScheduleListResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Delete schedule
+      #
+      # @overload delete(agent_id, schedule_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param schedule_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::ScheduleDeleteResponse]
+      #
+      # @see Cerca::Models::ScheduleDeleteParams
+      def delete(agent_id, schedule_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["agents/%1$s/schedules/%2$s", agent_id, schedule_id],
+          model: Cerca::Models::ScheduleDeleteResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Trigger schedule
+      #
+      # @overload trigger(agent_id, schedule_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param schedule_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::ScheduleTriggerResponse]
+      #
+      # @see Cerca::Models::ScheduleTriggerParams
+      def trigger(agent_id, schedule_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["agents/%1$s/schedules/%2$s/trigger", agent_id, schedule_id],
+          model: Cerca::Models::ScheduleTriggerResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end