cerca 0.1.0

data/rbi/cerca/models/webhook_event_type.rbi

@@ -0,0 +1,56 @@
+# typed: strong
+
+module Cerca
+  module Models
+    module WebhookEventType
+      extend Cerca::Internal::Type::Enum
+
+      TaggedSymbol = T.type_alias { T.all(Symbol, Cerca::WebhookEventType) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      AGENT_CREATED =
+        T.let(:"agent.created", Cerca::WebhookEventType::TaggedSymbol)
+      AGENT_UPDATED =
+        T.let(:"agent.updated", Cerca::WebhookEventType::TaggedSymbol)
+      AGENT_DELETED =
+        T.let(:"agent.deleted", Cerca::WebhookEventType::TaggedSymbol)
+      THREAD_CREATED =
+        T.let(:"thread.created", Cerca::WebhookEventType::TaggedSymbol)
+      THREAD_STATUS_CHANGED =
+        T.let(:"thread.status.changed", Cerca::WebhookEventType::TaggedSymbol)
+      THREAD_COMPLETED =
+        T.let(:"thread.completed", Cerca::WebhookEventType::TaggedSymbol)
+      THREAD_FAILED =
+        T.let(:"thread.failed", Cerca::WebhookEventType::TaggedSymbol)
+      TURN_CREATED =
+        T.let(:"turn.created", Cerca::WebhookEventType::TaggedSymbol)
+      TURN_COMPLETED =
+        T.let(:"turn.completed", Cerca::WebhookEventType::TaggedSymbol)
+      TURN_FAILED = T.let(:"turn.failed", Cerca::WebhookEventType::TaggedSymbol)
+      MESSAGE_CREATED =
+        T.let(:"message.created", Cerca::WebhookEventType::TaggedSymbol)
+      APPROVAL_REQUESTED =
+        T.let(:"approval.requested", Cerca::WebhookEventType::TaggedSymbol)
+      APPROVAL_RESOLVED =
+        T.let(:"approval.resolved", Cerca::WebhookEventType::TaggedSymbol)
+      APPROVAL_GRANTED =
+        T.let(:"approval.granted", Cerca::WebhookEventType::TaggedSymbol)
+      SCHEDULE_CREATED =
+        T.let(:"schedule.created", Cerca::WebhookEventType::TaggedSymbol)
+      SCHEDULE_DELETED =
+        T.let(:"schedule.deleted", Cerca::WebhookEventType::TaggedSymbol)
+      SCHEDULE_TRIGGERED =
+        T.let(:"schedule.triggered", Cerca::WebhookEventType::TaggedSymbol)
+      CONNECTION_ATTACHED =
+        T.let(:"connection.attached", Cerca::WebhookEventType::TaggedSymbol)
+      CONNECTION_DETACHED =
+        T.let(:"connection.detached", Cerca::WebhookEventType::TaggedSymbol)
+      WEBHOOK_TEST =
+        T.let(:"webhook.test", Cerca::WebhookEventType::TaggedSymbol)
+
+      sig { override.returns(T::Array[Cerca::WebhookEventType::TaggedSymbol]) }
+      def self.values
+      end
+    end
+  end
+end

data/rbi/cerca/models/webhook_list_params.rbi

@@ -0,0 +1,65 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class WebhookListParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::WebhookListParams, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :fleet_id
+
+      # Opaque pagination cursor returned by a previous request.
+      sig { returns(T.nilable(String)) }
+      attr_reader :cursor
+
+      sig { params(cursor: String).void }
+      attr_writer :cursor
+
+      # Maximum number of items to return. Defaults to 20 and preserves parseInt
+      # semantics.
+      sig { returns(T.nilable(String)) }
+      attr_reader :limit
+
+      sig { params(limit: String).void }
+      attr_writer :limit
+
+      sig do
+        params(
+          fleet_id: String,
+          cursor: String,
+          limit: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        fleet_id:,
+        # Opaque pagination cursor returned by a previous request.
+        cursor: nil,
+        # Maximum number of items to return. Defaults to 20 and preserves parseInt
+        # semantics.
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            fleet_id: String,
+            cursor: String,
+            limit: String,
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/webhook_retrieve_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class WebhookRetrieveParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::WebhookRetrieveParams, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :fleet_id
+
+      sig { returns(String) }
+      attr_accessor :webhook_id
+
+      sig do
+        params(
+          fleet_id: String,
+          webhook_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(fleet_id:, webhook_id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            fleet_id: String,
+            webhook_id: String,
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/webhook_rotate_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class WebhookRotateParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::WebhookRotateParams, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :fleet_id
+
+      sig { returns(String) }
+      attr_accessor :webhook_id
+
+      sig do
+        params(
+          fleet_id: String,
+          webhook_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(fleet_id:, webhook_id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            fleet_id: String,
+            webhook_id: String,
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/webhook_subscription.rbi

@@ -0,0 +1,73 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class WebhookSubscription < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::WebhookSubscription, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig { returns(String) }
+      attr_accessor :created_at
+
+      sig { returns(T::Boolean) }
+      attr_accessor :enabled
+
+      sig { returns(T::Array[Cerca::WebhookEventType::TaggedSymbol]) }
+      attr_accessor :events
+
+      sig { returns(String) }
+      attr_accessor :fleet_id
+
+      sig { returns(String) }
+      attr_accessor :updated_at
+
+      sig { returns(String) }
+      attr_accessor :url
+
+      # Webhook subscription metadata returned by list, get, and update. The one-time
+      # signing secret is not returned here.
+      sig do
+        params(
+          id: String,
+          created_at: String,
+          enabled: T::Boolean,
+          events: T::Array[Cerca::WebhookEventType::OrSymbol],
+          fleet_id: String,
+          updated_at: String,
+          url: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        created_at:,
+        enabled:,
+        events:,
+        fleet_id:,
+        updated_at:,
+        url:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            created_at: String,
+            enabled: T::Boolean,
+            events: T::Array[Cerca::WebhookEventType::TaggedSymbol],
+            fleet_id: String,
+            updated_at: String,
+            url: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/webhook_subscription_created.rbi

@@ -0,0 +1,83 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class WebhookSubscriptionCreated < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::WebhookSubscriptionCreated, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      sig { returns(String) }
+      attr_accessor :created_at
+
+      sig { returns(T::Boolean) }
+      attr_accessor :enabled
+
+      sig { returns(T::Array[Cerca::WebhookEventType::TaggedSymbol]) }
+      attr_accessor :events
+
+      sig { returns(String) }
+      attr_accessor :fleet_id
+
+      # One-time webhook signing secret returned only by create and rotate responses.
+      # The field name is `secret`.
+      sig { returns(String) }
+      attr_accessor :secret
+
+      sig { returns(String) }
+      attr_accessor :updated_at
+
+      sig { returns(String) }
+      attr_accessor :url
+
+      # Webhook subscription response for create and rotate. Includes the one-time
+      # `secret` field.
+      sig do
+        params(
+          id: String,
+          created_at: String,
+          enabled: T::Boolean,
+          events: T::Array[Cerca::WebhookEventType::OrSymbol],
+          fleet_id: String,
+          secret: String,
+          updated_at: String,
+          url: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        created_at:,
+        enabled:,
+        events:,
+        fleet_id:,
+        # One-time webhook signing secret returned only by create and rotate responses.
+        # The field name is `secret`.
+        secret:,
+        updated_at:,
+        url:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            created_at: String,
+            enabled: T::Boolean,
+            events: T::Array[Cerca::WebhookEventType::TaggedSymbol],
+            fleet_id: String,
+            secret: String,
+            updated_at: String,
+            url: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/webhook_subscription_event_type.rbi

@@ -0,0 +1,115 @@
+# typed: strong
+
+module Cerca
+  module Models
+    # `webhook.test` is reserved for the test endpoint and cannot be subscribed to.
+    module WebhookSubscriptionEventType
+      extend Cerca::Internal::Type::Enum
+
+      TaggedSymbol =
+        T.type_alias { T.all(Symbol, Cerca::WebhookSubscriptionEventType) }
+      OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+      AGENT_CREATED =
+        T.let(
+          :"agent.created",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      AGENT_UPDATED =
+        T.let(
+          :"agent.updated",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      AGENT_DELETED =
+        T.let(
+          :"agent.deleted",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      THREAD_CREATED =
+        T.let(
+          :"thread.created",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      THREAD_STATUS_CHANGED =
+        T.let(
+          :"thread.status.changed",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      THREAD_COMPLETED =
+        T.let(
+          :"thread.completed",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      THREAD_FAILED =
+        T.let(
+          :"thread.failed",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      TURN_CREATED =
+        T.let(
+          :"turn.created",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      TURN_COMPLETED =
+        T.let(
+          :"turn.completed",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      TURN_FAILED =
+        T.let(:"turn.failed", Cerca::WebhookSubscriptionEventType::TaggedSymbol)
+      MESSAGE_CREATED =
+        T.let(
+          :"message.created",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      APPROVAL_REQUESTED =
+        T.let(
+          :"approval.requested",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      APPROVAL_RESOLVED =
+        T.let(
+          :"approval.resolved",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      APPROVAL_GRANTED =
+        T.let(
+          :"approval.granted",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      SCHEDULE_CREATED =
+        T.let(
+          :"schedule.created",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      SCHEDULE_DELETED =
+        T.let(
+          :"schedule.deleted",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      SCHEDULE_TRIGGERED =
+        T.let(
+          :"schedule.triggered",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      CONNECTION_ATTACHED =
+        T.let(
+          :"connection.attached",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+      CONNECTION_DETACHED =
+        T.let(
+          :"connection.detached",
+          Cerca::WebhookSubscriptionEventType::TaggedSymbol
+        )
+
+      sig do
+        override.returns(
+          T::Array[Cerca::WebhookSubscriptionEventType::TaggedSymbol]
+        )
+      end
+      def self.values
+      end
+    end
+  end
+end

data/rbi/cerca/models/webhook_test_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class WebhookTestParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::WebhookTestParams, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :fleet_id
+
+      sig { returns(String) }
+      attr_accessor :webhook_id
+
+      sig do
+        params(
+          fleet_id: String,
+          webhook_id: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(fleet_id:, webhook_id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            fleet_id: String,
+            webhook_id: String,
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/webhook_test_response.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class WebhookTestResponse < Cerca::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::Models::WebhookTestResponse, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :error
+
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :status_code
+
+      sig { returns(T::Boolean) }
+      attr_accessor :success
+
+      sig do
+        params(
+          error: T.nilable(String),
+          status_code: T.nilable(Integer),
+          success: T::Boolean
+        ).returns(T.attached_class)
+      end
+      def self.new(error:, status_code:, success:)
+      end
+
+      sig do
+        override.returns(
+          {
+            error: T.nilable(String),
+            status_code: T.nilable(Integer),
+            success: T::Boolean
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cerca/models/webhook_update_params.rbi

@@ -0,0 +1,88 @@
+# typed: strong
+
+module Cerca
+  module Models
+    class WebhookUpdateParams < Cerca::Internal::Type::BaseModel
+      extend Cerca::Internal::Type::RequestParameters::Converter
+      include Cerca::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cerca::WebhookUpdateParams, Cerca::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :fleet_id
+
+      sig { returns(String) }
+      attr_accessor :webhook_id
+
+      # Whether deliveries are enabled for this subscription.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :enabled
+
+      sig { params(enabled: T::Boolean).void }
+      attr_writer :enabled
+
+      # Event names to deliver. Omit to subscribe to all non-test events.
+      sig do
+        returns(
+          T.nilable(T::Array[Cerca::WebhookSubscriptionEventType::OrSymbol])
+        )
+      end
+      attr_reader :events
+
+      sig do
+        params(
+          events: T::Array[Cerca::WebhookSubscriptionEventType::OrSymbol]
+        ).void
+      end
+      attr_writer :events
+
+      # HTTPS endpoint that will receive webhook deliveries.
+      sig { returns(T.nilable(String)) }
+      attr_reader :url
+
+      sig { params(url: String).void }
+      attr_writer :url
+
+      sig do
+        params(
+          fleet_id: String,
+          webhook_id: String,
+          enabled: T::Boolean,
+          events: T::Array[Cerca::WebhookSubscriptionEventType::OrSymbol],
+          url: String,
+          request_options: Cerca::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        fleet_id:,
+        webhook_id:,
+        # Whether deliveries are enabled for this subscription.
+        enabled: nil,
+        # Event names to deliver. Omit to subscribe to all non-test events.
+        events: nil,
+        # HTTPS endpoint that will receive webhook deliveries.
+        url: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            fleet_id: String,
+            webhook_id: String,
+            enabled: T::Boolean,
+            events: T::Array[Cerca::WebhookSubscriptionEventType::OrSymbol],
+            url: String,
+            request_options: Cerca::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end