zavudev 0.0.2

data/rbi/zavudev/resources/senders/agent/knowledge_bases.rbi

@@ -0,0 +1,102 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Senders
+      class Agent
+        class KnowledgeBases
+          sig do
+            returns(
+              Zavudev::Resources::Senders::Agent::KnowledgeBases::Documents
+            )
+          end
+          attr_reader :documents
+
+          # Create a new knowledge base for an agent.
+          sig do
+            params(
+              sender_id: String,
+              name: String,
+              description: String,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(
+              Zavudev::Models::Senders::Agent::KnowledgeBaseCreateResponse
+            )
+          end
+          def create(sender_id, name:, description: nil, request_options: {})
+          end
+
+          # Get a specific knowledge base.
+          sig do
+            params(
+              kb_id: String,
+              sender_id: String,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(
+              Zavudev::Models::Senders::Agent::KnowledgeBaseRetrieveResponse
+            )
+          end
+          def retrieve(kb_id, sender_id:, request_options: {})
+          end
+
+          # Update a knowledge base.
+          sig do
+            params(
+              kb_id: String,
+              sender_id: String,
+              description: T.nilable(String),
+              name: String,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(
+              Zavudev::Models::Senders::Agent::KnowledgeBaseUpdateResponse
+            )
+          end
+          def update(
+            # Path param
+            kb_id,
+            # Path param
+            sender_id:,
+            # Body param
+            description: nil,
+            # Body param
+            name: nil,
+            request_options: {}
+          )
+          end
+
+          # List knowledge bases for an agent.
+          sig do
+            params(
+              sender_id: String,
+              cursor: String,
+              limit: Integer,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(
+              Zavudev::Internal::Cursor[
+                Zavudev::Senders::Agent::AgentKnowledgeBase
+              ]
+            )
+          end
+          def list(sender_id, cursor: nil, limit: nil, request_options: {})
+          end
+
+          # Delete a knowledge base and all its documents.
+          sig do
+            params(
+              kb_id: String,
+              sender_id: String,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).void
+          end
+          def delete(kb_id, sender_id:, request_options: {})
+          end
+
+          # @api private
+          sig { params(client: Zavudev::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/resources/senders/agent/tools.rbi

@@ -0,0 +1,143 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Senders
+      class Agent
+        class Tools
+          # Create a new tool for an agent. Tools allow the agent to call external webhooks.
+          sig do
+            params(
+              sender_id: String,
+              description: String,
+              name: String,
+              parameters:
+                Zavudev::Senders::Agent::ToolCreateParams::Parameters::OrHash,
+              webhook_url: String,
+              enabled: T::Boolean,
+              webhook_secret: String,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(Zavudev::Models::Senders::Agent::ToolCreateResponse)
+          end
+          def create(
+            sender_id,
+            description:,
+            name:,
+            parameters:,
+            # Must be HTTPS.
+            webhook_url:,
+            enabled: nil,
+            # Optional secret for webhook signature verification.
+            webhook_secret: nil,
+            request_options: {}
+          )
+          end
+
+          # Get a specific tool.
+          sig do
+            params(
+              tool_id: String,
+              sender_id: String,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(Zavudev::Models::Senders::Agent::ToolRetrieveResponse)
+          end
+          def retrieve(tool_id, sender_id:, request_options: {})
+          end
+
+          # Update a tool.
+          sig do
+            params(
+              tool_id: String,
+              sender_id: String,
+              description: String,
+              enabled: T::Boolean,
+              name: String,
+              parameters:
+                Zavudev::Senders::Agent::ToolUpdateParams::Parameters::OrHash,
+              webhook_secret: T.nilable(String),
+              webhook_url: String,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(Zavudev::Models::Senders::Agent::ToolUpdateResponse)
+          end
+          def update(
+            # Path param
+            tool_id,
+            # Path param
+            sender_id:,
+            # Body param
+            description: nil,
+            # Body param
+            enabled: nil,
+            # Body param
+            name: nil,
+            # Body param
+            parameters: nil,
+            # Body param
+            webhook_secret: nil,
+            # Body param
+            webhook_url: nil,
+            request_options: {}
+          )
+          end
+
+          # List tools for an agent.
+          sig do
+            params(
+              sender_id: String,
+              cursor: String,
+              enabled: T::Boolean,
+              limit: Integer,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(
+              Zavudev::Internal::Cursor[Zavudev::Senders::Agent::AgentTool]
+            )
+          end
+          def list(
+            sender_id,
+            cursor: nil,
+            enabled: nil,
+            limit: nil,
+            request_options: {}
+          )
+          end
+
+          # Delete a tool.
+          sig do
+            params(
+              tool_id: String,
+              sender_id: String,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).void
+          end
+          def delete(tool_id, sender_id:, request_options: {})
+          end
+
+          # Test a tool by triggering its webhook with test parameters.
+          sig do
+            params(
+              tool_id: String,
+              sender_id: String,
+              test_params: T::Hash[Symbol, T.anything],
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(Zavudev::Models::Senders::Agent::ToolTestResponse)
+          end
+          def test_(
+            # Path param
+            tool_id,
+            # Path param
+            sender_id:,
+            # Body param: Parameters to pass to the tool for testing.
+            test_params:,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: Zavudev::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/resources/senders/agent.rbi

@@ -0,0 +1,131 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Senders
+      class Agent
+        sig { returns(Zavudev::Resources::Senders::Agent::Executions) }
+        attr_reader :executions
+
+        sig { returns(Zavudev::Resources::Senders::Agent::Flows) }
+        attr_reader :flows
+
+        sig { returns(Zavudev::Resources::Senders::Agent::Tools) }
+        attr_reader :tools
+
+        sig { returns(Zavudev::Resources::Senders::Agent::KnowledgeBases) }
+        attr_reader :knowledge_bases
+
+        # Create an AI agent for a sender. Each sender can have at most one agent.
+        sig do
+          params(
+            sender_id: String,
+            model: String,
+            name: String,
+            provider: Zavudev::Senders::AgentProvider::OrSymbol,
+            system_prompt: String,
+            api_key: String,
+            context_window_messages: Integer,
+            include_contact_metadata: T::Boolean,
+            max_tokens: Integer,
+            temperature: Float,
+            trigger_on_channels: T::Array[String],
+            trigger_on_message_types: T::Array[String],
+            request_options: Zavudev::RequestOptions::OrHash
+          ).returns(Zavudev::Senders::AgentResponse)
+        end
+        def create(
+          sender_id,
+          model:,
+          name:,
+          # LLM provider for the AI agent.
+          provider:,
+          system_prompt:,
+          # API key for the LLM provider. Required unless provider is 'zavu'.
+          api_key: nil,
+          context_window_messages: nil,
+          include_contact_metadata: nil,
+          max_tokens: nil,
+          temperature: nil,
+          trigger_on_channels: nil,
+          trigger_on_message_types: nil,
+          request_options: {}
+        )
+        end
+
+        # Get the AI agent configuration for a sender.
+        sig do
+          params(
+            sender_id: String,
+            request_options: Zavudev::RequestOptions::OrHash
+          ).returns(Zavudev::Senders::AgentResponse)
+        end
+        def retrieve(sender_id, request_options: {})
+        end
+
+        # Update an AI agent's configuration.
+        sig do
+          params(
+            sender_id: String,
+            api_key: String,
+            context_window_messages: Integer,
+            enabled: T::Boolean,
+            include_contact_metadata: T::Boolean,
+            max_tokens: T.nilable(Integer),
+            model: String,
+            name: String,
+            provider: Zavudev::Senders::AgentProvider::OrSymbol,
+            system_prompt: String,
+            temperature: T.nilable(Float),
+            trigger_on_channels: T::Array[String],
+            trigger_on_message_types: T::Array[String],
+            request_options: Zavudev::RequestOptions::OrHash
+          ).returns(Zavudev::Senders::AgentResponse)
+        end
+        def update(
+          sender_id,
+          api_key: nil,
+          context_window_messages: nil,
+          enabled: nil,
+          include_contact_metadata: nil,
+          max_tokens: nil,
+          model: nil,
+          name: nil,
+          # LLM provider for the AI agent.
+          provider: nil,
+          system_prompt: nil,
+          temperature: nil,
+          trigger_on_channels: nil,
+          trigger_on_message_types: nil,
+          request_options: {}
+        )
+        end
+
+        # Delete an AI agent.
+        sig do
+          params(
+            sender_id: String,
+            request_options: Zavudev::RequestOptions::OrHash
+          ).void
+        end
+        def delete(sender_id, request_options: {})
+        end
+
+        # Get statistics for an AI agent including invocations, tokens, and costs.
+        sig do
+          params(
+            sender_id: String,
+            request_options: Zavudev::RequestOptions::OrHash
+          ).returns(Zavudev::Senders::AgentStats)
+        end
+        def stats(sender_id, request_options: {})
+        end
+
+        # @api private
+        sig { params(client: Zavudev::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/resources/senders.rbi

@@ -0,0 +1,173 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Senders
+      sig { returns(Zavudev::Resources::Senders::Agent) }
+      attr_reader :agent
+
+      # Create sender
+      sig do
+        params(
+          name: String,
+          phone_number: String,
+          set_as_default: T::Boolean,
+          webhook_events: T::Array[Zavudev::WebhookEvent::OrSymbol],
+          webhook_url: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Sender)
+      end
+      def create(
+        name:,
+        phone_number:,
+        set_as_default: nil,
+        # Events to subscribe to.
+        webhook_events: nil,
+        # HTTPS URL for webhook events.
+        webhook_url: nil,
+        request_options: {}
+      )
+      end
+
+      # Get sender
+      sig do
+        params(
+          sender_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Sender)
+      end
+      def retrieve(sender_id, request_options: {})
+      end
+
+      # Update sender
+      sig do
+        params(
+          sender_id: String,
+          email_receiving_enabled: T::Boolean,
+          name: String,
+          set_as_default: T::Boolean,
+          webhook_active: T::Boolean,
+          webhook_events: T::Array[Zavudev::WebhookEvent::OrSymbol],
+          webhook_url: T.nilable(String),
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Sender)
+      end
+      def update(
+        sender_id,
+        # Enable or disable inbound email receiving for this sender.
+        email_receiving_enabled: nil,
+        name: nil,
+        set_as_default: nil,
+        # Whether the webhook is active.
+        webhook_active: nil,
+        # Events to subscribe to.
+        webhook_events: nil,
+        # HTTPS URL for webhook events. Set to null to remove webhook.
+        webhook_url: nil,
+        request_options: {}
+      )
+      end
+
+      # List senders
+      sig do
+        params(
+          cursor: String,
+          limit: Integer,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Internal::Cursor[Zavudev::Sender])
+      end
+      def list(cursor: nil, limit: nil, request_options: {})
+      end
+
+      # Delete sender
+      sig do
+        params(
+          sender_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).void
+      end
+      def delete(sender_id, request_options: {})
+      end
+
+      # Get the WhatsApp Business profile for a sender. The sender must have a WhatsApp
+      # Business Account connected.
+      sig do
+        params(
+          sender_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::WhatsappBusinessProfileResponse)
+      end
+      def get_profile(sender_id, request_options: {})
+      end
+
+      # Regenerate the webhook secret for a sender. The old secret will be invalidated
+      # immediately.
+      sig do
+        params(
+          sender_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::WebhookSecretResponse)
+      end
+      def regenerate_webhook_secret(sender_id, request_options: {})
+      end
+
+      # Update the WhatsApp Business profile for a sender. The sender must have a
+      # WhatsApp Business Account connected.
+      sig do
+        params(
+          sender_id: String,
+          about: String,
+          address: String,
+          description: String,
+          email: String,
+          vertical: Zavudev::WhatsappBusinessProfileVertical::OrSymbol,
+          websites: T::Array[String],
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::SenderUpdateProfileResponse)
+      end
+      def update_profile(
+        sender_id,
+        # Short description of the business (max 139 characters).
+        about: nil,
+        # Physical address of the business (max 256 characters).
+        address: nil,
+        # Extended description of the business (max 512 characters).
+        description: nil,
+        # Business email address.
+        email: nil,
+        # Business category for WhatsApp Business profile.
+        vertical: nil,
+        # Business website URLs (maximum 2).
+        websites: nil,
+        request_options: {}
+      )
+      end
+
+      # Upload a new profile picture for the WhatsApp Business profile. The image will
+      # be uploaded to Meta and set as the profile picture.
+      sig do
+        params(
+          sender_id: String,
+          image_url: String,
+          mime_type:
+            Zavudev::SenderUploadProfilePictureParams::MimeType::OrSymbol,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::SenderUploadProfilePictureResponse)
+      end
+      def upload_profile_picture(
+        sender_id,
+        # URL of the image to upload.
+        image_url:,
+        # MIME type of the image.
+        mime_type:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Zavudev::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/zavudev/resources/templates.rbi

@@ -0,0 +1,96 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Templates
+      # Create a WhatsApp message template. Note: Templates must be approved by Meta
+      # before use.
+      sig do
+        params(
+          body: String,
+          language: String,
+          name: String,
+          add_security_recommendation: T::Boolean,
+          buttons: T::Array[Zavudev::TemplateCreateParams::Button::OrHash],
+          code_expiration_minutes: Integer,
+          variables: T::Array[String],
+          whatsapp_category: Zavudev::WhatsappCategory::OrSymbol,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Template)
+      end
+      def create(
+        body:,
+        language:,
+        name:,
+        # Add 'Do not share this code' disclaimer. Only for AUTHENTICATION templates.
+        add_security_recommendation: nil,
+        # Template buttons (max 3).
+        buttons: nil,
+        # Code expiration time in minutes. Only for AUTHENTICATION templates.
+        code_expiration_minutes: nil,
+        variables: nil,
+        # WhatsApp template category.
+        whatsapp_category: nil,
+        request_options: {}
+      )
+      end
+
+      # Get template
+      sig do
+        params(
+          template_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Template)
+      end
+      def retrieve(template_id, request_options: {})
+      end
+
+      # List WhatsApp message templates for this project.
+      sig do
+        params(
+          cursor: String,
+          limit: Integer,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Internal::Cursor[Zavudev::Template])
+      end
+      def list(cursor: nil, limit: nil, request_options: {})
+      end
+
+      # Delete template
+      sig do
+        params(
+          template_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).void
+      end
+      def delete(template_id, request_options: {})
+      end
+
+      # Submit a WhatsApp template to Meta for approval. The template must be in draft
+      # status and associated with a sender that has a WhatsApp Business Account
+      # configured.
+      sig do
+        params(
+          template_id: String,
+          sender_id: String,
+          category: Zavudev::WhatsappCategory::OrSymbol,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Template)
+      end
+      def submit(
+        template_id,
+        # The sender ID with the WhatsApp Business Account to submit the template to.
+        sender_id:,
+        # Template category. If not provided, uses the category set on the template.
+        category: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Zavudev::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/zavudev/version.rbi

@@ -0,0 +1,5 @@
+# typed: strong
+
+module Zavudev
+  VERSION = T.let(T.unsafe(nil), String)
+end

data/sig/zavudev/client.rbs

@@ -0,0 +1,42 @@
+module Zavudev
+  class Client < Zavudev::Internal::Transport::BaseClient
+    DEFAULT_MAX_RETRIES: 2
+
+    DEFAULT_TIMEOUT_IN_SECONDS: Float
+
+    DEFAULT_INITIAL_RETRY_DELAY: Float
+
+    DEFAULT_MAX_RETRY_DELAY: Float
+
+    attr_reader api_key: String
+
+    attr_reader messages: Zavudev::Resources::Messages
+
+    attr_reader templates: Zavudev::Resources::Templates
+
+    attr_reader senders: Zavudev::Resources::Senders
+
+    attr_reader contacts: Zavudev::Resources::Contacts
+
+    attr_reader broadcasts: Zavudev::Resources::Broadcasts
+
+    attr_reader introspect: Zavudev::Resources::Introspect
+
+    attr_reader phone_numbers: Zavudev::Resources::PhoneNumbers
+
+    attr_reader addresses: Zavudev::Resources::Addresses
+
+    attr_reader regulatory_documents: Zavudev::Resources::RegulatoryDocuments
+
+    private def auth_headers: -> ::Hash[String, String]
+
+    def initialize: (
+      ?api_key: String?,
+      ?base_url: String?,
+      ?max_retries: Integer,
+      ?timeout: Float,
+      ?initial_retry_delay: Float,
+      ?max_retry_delay: Float
+    ) -> void
+  end
+end