cadenya 0.1.0

data/rbi/cadenya/models/agents/webhook_delivery_data.rbi

@@ -0,0 +1,281 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    module Agents
+      class WebhookDeliveryData < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Agents::WebhookDeliveryData,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # Related resources
+        sig { returns(String) }
+        attr_accessor :agent_id
+
+        sig { returns(Integer) }
+        attr_accessor :attempt_count
+
+        # The type of objective event that triggered this webhook delivery
+        sig do
+          returns(Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol)
+        end
+        attr_accessor :event_type
+
+        # Response details. The response body is not retained.
+        sig { returns(Integer) }
+        attr_accessor :http_status_code
+
+        sig { returns(Time) }
+        attr_accessor :last_attempt_at
+
+        sig { returns(Integer) }
+        attr_accessor :latency_ms
+
+        sig { returns(String) }
+        attr_accessor :objective_event_id
+
+        sig { returns(String) }
+        attr_accessor :objective_id
+
+        # Content length of the response body in bytes
+        sig { returns(String) }
+        attr_accessor :response_content_length
+
+        sig do
+          returns(Cadenya::Agents::WebhookDeliveryData::Status::TaggedSymbol)
+        end
+        attr_accessor :status
+
+        sig { returns(String) }
+        attr_accessor :webhook_id
+
+        # Webhook delivery details
+        sig { returns(String) }
+        attr_accessor :webhook_url
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :error_message
+
+        sig { params(error_message: String).void }
+        attr_writer :error_message
+
+        # Response headers received from the webhook endpoint
+        sig { returns(T.nilable(T::Hash[Symbol, String])) }
+        attr_reader :response_headers
+
+        sig { params(response_headers: T::Hash[Symbol, String]).void }
+        attr_writer :response_headers
+
+        sig do
+          params(
+            agent_id: String,
+            attempt_count: Integer,
+            event_type:
+              Cadenya::Agents::WebhookDeliveryData::EventType::OrSymbol,
+            http_status_code: Integer,
+            last_attempt_at: Time,
+            latency_ms: Integer,
+            objective_event_id: String,
+            objective_id: String,
+            response_content_length: String,
+            status: Cadenya::Agents::WebhookDeliveryData::Status::OrSymbol,
+            webhook_id: String,
+            webhook_url: String,
+            error_message: String,
+            response_headers: T::Hash[Symbol, String]
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Related resources
+          agent_id:,
+          attempt_count:,
+          # The type of objective event that triggered this webhook delivery
+          event_type:,
+          # Response details. The response body is not retained.
+          http_status_code:,
+          last_attempt_at:,
+          latency_ms:,
+          objective_event_id:,
+          objective_id:,
+          # Content length of the response body in bytes
+          response_content_length:,
+          status:,
+          webhook_id:,
+          # Webhook delivery details
+          webhook_url:,
+          error_message: nil,
+          # Response headers received from the webhook endpoint
+          response_headers: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              agent_id: String,
+              attempt_count: Integer,
+              event_type:
+                Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol,
+              http_status_code: Integer,
+              last_attempt_at: Time,
+              latency_ms: Integer,
+              objective_event_id: String,
+              objective_id: String,
+              response_content_length: String,
+              status:
+                Cadenya::Agents::WebhookDeliveryData::Status::TaggedSymbol,
+              webhook_id: String,
+              webhook_url: String,
+              error_message: String,
+              response_headers: T::Hash[Symbol, String]
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # The type of objective event that triggered this webhook delivery
+        module EventType
+          extend Cadenya::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Cadenya::Agents::WebhookDeliveryData::EventType)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          OBJECTIVE_EVENT_TYPE_UNSPECIFIED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_UNSPECIFIED,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_USER_MESSAGE =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_USER_MESSAGE,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_TOOL_APPROVAL_REQUESTED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TOOL_APPROVAL_REQUESTED,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_TOOL_APPROVED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TOOL_APPROVED,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_TOOL_DENIED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TOOL_DENIED,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_TOOL_CALLED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TOOL_CALLED,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_ERROR =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_ERROR,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_TOOL_RESULT =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TOOL_RESULT,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_TOOL_ERROR =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TOOL_ERROR,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_MEMORY_READ =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_MEMORY_READ,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_CANCELLED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_CANCELLED,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        module Status
+          extend Cadenya::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Cadenya::Agents::WebhookDeliveryData::Status)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          WEBHOOK_DELIVERY_STATUS_UNSPECIFIED =
+            T.let(
+              :WEBHOOK_DELIVERY_STATUS_UNSPECIFIED,
+              Cadenya::Agents::WebhookDeliveryData::Status::TaggedSymbol
+            )
+          WEBHOOK_DELIVERY_STATUS_PENDING =
+            T.let(
+              :WEBHOOK_DELIVERY_STATUS_PENDING,
+              Cadenya::Agents::WebhookDeliveryData::Status::TaggedSymbol
+            )
+          WEBHOOK_DELIVERY_STATUS_COMPLETED =
+            T.let(
+              :WEBHOOK_DELIVERY_STATUS_COMPLETED,
+              Cadenya::Agents::WebhookDeliveryData::Status::TaggedSymbol
+            )
+          WEBHOOK_DELIVERY_STATUS_FAILED =
+            T.let(
+              :WEBHOOK_DELIVERY_STATUS_FAILED,
+              Cadenya::Agents::WebhookDeliveryData::Status::TaggedSymbol
+            )
+          WEBHOOK_DELIVERY_STATUS_DISABLED =
+            T.let(
+              :WEBHOOK_DELIVERY_STATUS_DISABLED,
+              Cadenya::Agents::WebhookDeliveryData::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Cadenya::Agents::WebhookDeliveryData::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/agents/webhook_delivery_list_params.rbi

@@ -0,0 +1,204 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    module Agents
+      class WebhookDeliveryListParams < Cadenya::Internal::Type::BaseModel
+        extend Cadenya::Internal::Type::RequestParameters::Converter
+        include Cadenya::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Agents::WebhookDeliveryListParams,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :workspace_id
+
+        sig { returns(String) }
+        attr_accessor :agent_id
+
+        # Pagination cursor from previous response
+        sig { returns(T.nilable(String)) }
+        attr_reader :cursor
+
+        sig { params(cursor: String).void }
+        attr_writer :cursor
+
+        # Optional filter by event type
+        sig do
+          returns(
+            T.nilable(
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::OrSymbol
+            )
+          )
+        end
+        attr_reader :event_type
+
+        sig do
+          params(
+            event_type:
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::OrSymbol
+          ).void
+        end
+        attr_writer :event_type
+
+        # Maximum number of results to return
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :limit
+
+        sig { params(limit: Integer).void }
+        attr_writer :limit
+
+        # Optional filter by objective ID
+        sig { returns(T.nilable(String)) }
+        attr_reader :objective_id
+
+        sig { params(objective_id: String).void }
+        attr_writer :objective_id
+
+        sig do
+          params(
+            workspace_id: String,
+            agent_id: String,
+            cursor: String,
+            event_type:
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::OrSymbol,
+            limit: Integer,
+            objective_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          workspace_id:,
+          agent_id:,
+          # Pagination cursor from previous response
+          cursor: nil,
+          # Optional filter by event type
+          event_type: nil,
+          # Maximum number of results to return
+          limit: nil,
+          # Optional filter by objective ID
+          objective_id: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              workspace_id: String,
+              agent_id: String,
+              cursor: String,
+              event_type:
+                Cadenya::Agents::WebhookDeliveryListParams::EventType::OrSymbol,
+              limit: Integer,
+              objective_id: String,
+              request_options: Cadenya::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Optional filter by event type
+        module EventType
+          extend Cadenya::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Cadenya::Agents::WebhookDeliveryListParams::EventType
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          OBJECTIVE_EVENT_TYPE_UNSPECIFIED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_UNSPECIFIED,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_USER_MESSAGE =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_USER_MESSAGE,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_TOOL_APPROVAL_REQUESTED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TOOL_APPROVAL_REQUESTED,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_TOOL_APPROVED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TOOL_APPROVED,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_TOOL_DENIED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TOOL_DENIED,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_TOOL_CALLED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TOOL_CALLED,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_SUB_OBJECTIVE_CREATED,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_ERROR =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_ERROR,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_ASSISTANT_MESSAGE,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_TOOL_RESULT =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TOOL_RESULT,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_TOOL_ERROR =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_TOOL_ERROR,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_CONTEXT_WINDOW_COMPACTED,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_MEMORY_READ =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_MEMORY_READ,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+          OBJECTIVE_EVENT_TYPE_CANCELLED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_CANCELLED,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/api_key.rbi

@@ -0,0 +1,63 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class APIKey < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Cadenya::APIKey, Cadenya::Internal::AnyHash) }
+
+      # AccountResourceMetadata is used to represent a resource that is associated to an
+      # account but not to a workspace.
+      sig { returns(Cadenya::AccountResourceMetadata) }
+      attr_reader :metadata
+
+      sig { params(metadata: Cadenya::AccountResourceMetadata::OrHash).void }
+      attr_writer :metadata
+
+      # Configuration for an API key.
+      sig { returns(Cadenya::APIKeySpec) }
+      attr_reader :spec
+
+      sig { params(spec: Cadenya::APIKeySpec::OrHash).void }
+      attr_writer :spec
+
+      sig { returns(T.nilable(Cadenya::APIKeyInfo)) }
+      attr_reader :info
+
+      sig { params(info: Cadenya::APIKeyInfo::OrHash).void }
+      attr_writer :info
+
+      # An API key for the account. Use workspace-association RPCs to grant the key
+      # access to specific workspaces; a key with zero workspaces is valid but cannot
+      # access workspace-scoped resources.
+      sig do
+        params(
+          metadata: Cadenya::AccountResourceMetadata::OrHash,
+          spec: Cadenya::APIKeySpec::OrHash,
+          info: Cadenya::APIKeyInfo::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # AccountResourceMetadata is used to represent a resource that is associated to an
+        # account but not to a workspace.
+        metadata:,
+        # Configuration for an API key.
+        spec:,
+        info: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            metadata: Cadenya::AccountResourceMetadata,
+            spec: Cadenya::APIKeySpec,
+            info: Cadenya::APIKeyInfo
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/api_key_create_params.rbi

@@ -0,0 +1,140 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class APIKeyCreateParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::APIKeyCreateParams, Cadenya::Internal::AnyHash)
+        end
+
+      # CreateAccountResourceMetadata contains the user-provided fields for creating an
+      # account-scoped resource. Read-only fields (id, account_id, profile_id) are
+      # excluded since they are set by the server.
+      sig { returns(Cadenya::APIKeyCreateParams::Metadata) }
+      attr_reader :metadata
+
+      sig do
+        params(metadata: Cadenya::APIKeyCreateParams::Metadata::OrHash).void
+      end
+      attr_writer :metadata
+
+      # Configuration for an API key.
+      sig { returns(Cadenya::APIKeySpec) }
+      attr_reader :spec
+
+      sig { params(spec: Cadenya::APIKeySpec::OrHash).void }
+      attr_writer :spec
+
+      # Workspaces this API key will have access to on creation. Optional — a key can be
+      # created with no workspace access and granted later via AddAPIKeyWorkspace.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :initial_workspace_ids
+
+      sig { params(initial_workspace_ids: T::Array[String]).void }
+      attr_writer :initial_workspace_ids
+
+      sig do
+        params(
+          metadata: Cadenya::APIKeyCreateParams::Metadata::OrHash,
+          spec: Cadenya::APIKeySpec::OrHash,
+          initial_workspace_ids: T::Array[String],
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # CreateAccountResourceMetadata contains the user-provided fields for creating an
+        # account-scoped resource. Read-only fields (id, account_id, profile_id) are
+        # excluded since they are set by the server.
+        metadata:,
+        # Configuration for an API key.
+        spec:,
+        # Workspaces this API key will have access to on creation. Optional — a key can be
+        # created with no workspace access and granted later via AddAPIKeyWorkspace.
+        initial_workspace_ids: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            metadata: Cadenya::APIKeyCreateParams::Metadata,
+            spec: Cadenya::APIKeySpec,
+            initial_workspace_ids: T::Array[String],
+            request_options: Cadenya::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Metadata < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::APIKeyCreateParams::Metadata,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # Human-readable name for the resource (e.g., "Production API Key", "Staging
+        # Workspace")
+        sig { returns(String) }
+        attr_accessor :name
+
+        # External ID for the resource (e.g., a workflow ID from an external system)
+        sig { returns(T.nilable(String)) }
+        attr_reader :external_id
+
+        sig { params(external_id: String).void }
+        attr_writer :external_id
+
+        # Arbitrary key-value pairs for categorization and filtering Examples:
+        # {"environment": "production", "team": "platform", "version": "v2"}
+        sig { returns(T.nilable(T::Hash[Symbol, String])) }
+        attr_reader :labels
+
+        sig { params(labels: T::Hash[Symbol, String]).void }
+        attr_writer :labels
+
+        # CreateAccountResourceMetadata contains the user-provided fields for creating an
+        # account-scoped resource. Read-only fields (id, account_id, profile_id) are
+        # excluded since they are set by the server.
+        sig do
+          params(
+            name: String,
+            external_id: String,
+            labels: T::Hash[Symbol, String]
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Human-readable name for the resource (e.g., "Production API Key", "Staging
+          # Workspace")
+          name:,
+          # External ID for the resource (e.g., a workflow ID from an external system)
+          external_id: nil,
+          # Arbitrary key-value pairs for categorization and filtering Examples:
+          # {"environment": "production", "team": "platform", "version": "v2"}
+          labels: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              name: String,
+              external_id: String,
+              labels: T::Hash[Symbol, String]
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end