zavudev 0.0.2

data/rbi/zavudev/resources/contacts.rbi

@@ -0,0 +1,67 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Contacts
+      # Get contact
+      sig do
+        params(
+          contact_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Contact)
+      end
+      def retrieve(contact_id, request_options: {})
+      end
+
+      # Update contact
+      sig do
+        params(
+          contact_id: String,
+          default_channel:
+            T.nilable(Zavudev::ContactUpdateParams::DefaultChannel::OrSymbol),
+          metadata: T::Hash[Symbol, String],
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Contact)
+      end
+      def update(
+        contact_id,
+        # Preferred channel for this contact. Set to null to clear.
+        default_channel: nil,
+        metadata: nil,
+        request_options: {}
+      )
+      end
+
+      # List contacts with their communication channels.
+      sig do
+        params(
+          cursor: String,
+          limit: Integer,
+          phone_number: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Internal::Cursor[Zavudev::Contact])
+      end
+      def list(cursor: nil, limit: nil, phone_number: nil, request_options: {})
+      end
+
+      # Get contact by phone number
+      sig do
+        params(
+          phone_number: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Contact)
+      end
+      def retrieve_by_phone(
+        # E.164 phone number.
+        phone_number,
+        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/introspect.rbi

@@ -0,0 +1,22 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Introspect
+      # Validate a phone number and check if a WhatsApp conversation window is open.
+      sig do
+        params(
+          phone_number: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::IntrospectValidatePhoneResponse)
+      end
+      def validate_phone(phone_number:, 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/messages.rbi

@@ -0,0 +1,139 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Messages
+      # Get message by ID
+      sig do
+        params(
+          message_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::MessageResponse)
+      end
+      def retrieve(message_id, request_options: {})
+      end
+
+      # List messages previously sent by this project.
+      sig do
+        params(
+          channel: Zavudev::Channel::OrSymbol,
+          cursor: String,
+          limit: Integer,
+          status: Zavudev::MessageStatus::OrSymbol,
+          to: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Internal::Cursor[Zavudev::Message])
+      end
+      def list(
+        # Delivery channel. Use 'auto' for intelligent routing.
+        channel: nil,
+        cursor: nil,
+        limit: nil,
+        status: nil,
+        to: nil,
+        request_options: {}
+      )
+      end
+
+      # Send an emoji reaction to an existing WhatsApp message. Reactions are only
+      # supported for WhatsApp messages.
+      sig do
+        params(
+          message_id: String,
+          emoji: String,
+          zavu_sender: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::MessageResponse)
+      end
+      def react(
+        # Path param
+        message_id,
+        # Body param: Single emoji character to react with.
+        emoji:,
+        # Header param: Optional sender profile ID. If omitted, the project's default
+        # sender will be used.
+        zavu_sender: nil,
+        request_options: {}
+      )
+      end
+
+      # Send a message to a recipient via SMS or WhatsApp.
+      #
+      # **Channel selection:**
+      #
+      # - If `channel` is omitted and `messageType` is `text`, defaults to SMS
+      # - If `messageType` is anything other than `text`, WhatsApp is used automatically
+      #
+      # **WhatsApp 24-hour window:**
+      #
+      # - Free-form messages (non-template) require an open 24h window
+      # - Window opens when the user messages you first
+      # - Use template messages to initiate conversations outside the window
+      #
+      # **Email requirements:**
+      #
+      # - Email channel requires KYC verification. Complete identity verification in the
+      #   dashboard before sending emails.
+      sig do
+        params(
+          to: String,
+          channel: Zavudev::Channel::OrSymbol,
+          content: Zavudev::MessageContent::OrHash,
+          fallback_enabled: T::Boolean,
+          html_body: String,
+          idempotency_key: String,
+          message_type: Zavudev::MessageType::OrSymbol,
+          metadata: T::Hash[Symbol, String],
+          reply_to: String,
+          subject: String,
+          text: String,
+          voice_language: String,
+          zavu_sender: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::MessageResponse)
+      end
+      def send_(
+        # Body param: Recipient phone number in E.164 format or email address.
+        to:,
+        # Body param: Delivery channel. Use 'auto' for intelligent routing. If omitted
+        # with non-text messageType, WhatsApp is used. For email recipients, defaults to
+        # 'email'.
+        channel: nil,
+        # Body param: Additional content for non-text message types.
+        content: nil,
+        # Body param: Whether to enable automatic fallback to SMS if WhatsApp fails.
+        # Defaults to true.
+        fallback_enabled: nil,
+        # Body param: HTML body for email messages. If provided, email will be sent as
+        # multipart with both text and HTML.
+        html_body: nil,
+        # Body param: Optional idempotency key to avoid duplicate sends.
+        idempotency_key: nil,
+        # Body param: Type of message. Defaults to 'text'.
+        message_type: nil,
+        # Body param: Arbitrary metadata to associate with the message.
+        metadata: nil,
+        # Body param: Reply-To email address for email messages.
+        reply_to: nil,
+        # Body param: Email subject line. Required when channel is 'email' or recipient is
+        # an email address.
+        subject: nil,
+        # Body param: Text body for text messages or caption for media messages.
+        text: nil,
+        # Body param: Language code for voice text-to-speech (e.g., 'en-US', 'es-ES',
+        # 'pt-BR'). If omitted, language is auto-detected from recipient's country code.
+        voice_language: nil,
+        # Header param: Optional sender profile ID. If omitted, the project's default
+        # sender will be used.
+        zavu_sender: 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/resources/phone_numbers.rbi

@@ -0,0 +1,130 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class PhoneNumbers
+      # Get details of a specific phone number.
+      sig do
+        params(
+          phone_number_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::PhoneNumberRetrieveResponse)
+      end
+      def retrieve(phone_number_id, request_options: {})
+      end
+
+      # Update a phone number's name or sender assignment.
+      sig do
+        params(
+          phone_number_id: String,
+          name: T.nilable(String),
+          sender_id: T.nilable(String),
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::PhoneNumberUpdateResponse)
+      end
+      def update(
+        phone_number_id,
+        # Custom name for the phone number. Set to null to clear.
+        name: nil,
+        # Sender ID to assign the phone number to. Set to null to unassign.
+        sender_id: nil,
+        request_options: {}
+      )
+      end
+
+      # List all phone numbers owned by this project.
+      sig do
+        params(
+          cursor: String,
+          limit: Integer,
+          status: Zavudev::PhoneNumberStatus::OrSymbol,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Internal::Cursor[Zavudev::OwnedPhoneNumber])
+      end
+      def list(
+        # Pagination cursor.
+        cursor: nil,
+        limit: nil,
+        # Filter by phone number status.
+        status: nil,
+        request_options: {}
+      )
+      end
+
+      # Purchase an available phone number. The first US phone number is free for each
+      # team.
+      sig do
+        params(
+          phone_number: String,
+          name: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::PhoneNumberPurchaseResponse)
+      end
+      def purchase(
+        # Phone number in E.164 format.
+        phone_number:,
+        # Optional custom name for the phone number.
+        name: nil,
+        request_options: {}
+      )
+      end
+
+      # Release a phone number. The phone number must not be assigned to a sender.
+      sig do
+        params(
+          phone_number_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).void
+      end
+      def release(phone_number_id, request_options: {})
+      end
+
+      # Get regulatory requirements for purchasing phone numbers in a specific country.
+      # Some countries require additional documentation (addresses, identity documents)
+      # before phone numbers can be activated.
+      sig do
+        params(
+          country_code: String,
+          type: Zavudev::PhoneNumberType::OrSymbol,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::PhoneNumberRequirementsResponse)
+      end
+      def requirements(
+        # Two-letter ISO country code.
+        country_code:,
+        # Type of phone number (local, mobile, tollFree).
+        type: nil,
+        request_options: {}
+      )
+      end
+
+      # Search for available phone numbers to purchase by country and type.
+      sig do
+        params(
+          country_code: String,
+          contains: String,
+          limit: Integer,
+          type: Zavudev::PhoneNumberType::OrSymbol,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::PhoneNumberSearchAvailableResponse)
+      end
+      def search_available(
+        # Two-letter ISO country code.
+        country_code:,
+        # Search for numbers containing this string.
+        contains: nil,
+        # Maximum number of results to return.
+        limit: nil,
+        # Type of phone number to search for.
+        type: 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/resources/regulatory_documents.rbi

@@ -0,0 +1,77 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class RegulatoryDocuments
+      # Create a regulatory document record after uploading the file. Use the upload-url
+      # endpoint first to get an upload URL.
+      sig do
+        params(
+          document_type:
+            Zavudev::RegulatoryDocumentCreateParams::DocumentType::OrSymbol,
+          file_size: Integer,
+          mime_type: String,
+          name: String,
+          storage_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::RegulatoryDocumentCreateResponse)
+      end
+      def create(
+        document_type:,
+        file_size:,
+        mime_type:,
+        name:,
+        # Storage ID from the upload-url endpoint.
+        storage_id:,
+        request_options: {}
+      )
+      end
+
+      # Get a specific regulatory document.
+      sig do
+        params(
+          document_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::RegulatoryDocumentRetrieveResponse)
+      end
+      def retrieve(document_id, request_options: {})
+      end
+
+      # List regulatory documents for this project.
+      sig do
+        params(
+          cursor: String,
+          limit: Integer,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Internal::Cursor[Zavudev::RegulatoryDocument])
+      end
+      def list(cursor: nil, limit: nil, request_options: {})
+      end
+
+      # Delete a regulatory document. Cannot delete verified documents.
+      sig do
+        params(
+          document_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).void
+      end
+      def delete(document_id, request_options: {})
+      end
+
+      # Get a presigned URL to upload a document file. After uploading, use the
+      # storageId to create the document record.
+      sig do
+        params(request_options: Zavudev::RequestOptions::OrHash).returns(
+          Zavudev::Models::RegulatoryDocumentUploadURLResponse
+        )
+      end
+      def upload_url(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/senders/agent/executions.rbi

@@ -0,0 +1,38 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Senders
+      class Agent
+        class Executions
+          # List recent agent executions with pagination.
+          sig do
+            params(
+              sender_id: String,
+              cursor: String,
+              limit: Integer,
+              status: Zavudev::Senders::AgentExecutionStatus::OrSymbol,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(
+              Zavudev::Internal::Cursor[Zavudev::Senders::AgentExecution]
+            )
+          end
+          def list(
+            sender_id,
+            cursor: nil,
+            limit: nil,
+            # Status of an agent execution.
+            status: nil,
+            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/flows.rbi

@@ -0,0 +1,147 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Senders
+      class Agent
+        class Flows
+          # Create a new flow for an agent.
+          sig do
+            params(
+              sender_id: String,
+              name: String,
+              steps:
+                T::Array[
+                  Zavudev::Senders::Agent::FlowCreateParams::Step::OrHash
+                ],
+              trigger:
+                Zavudev::Senders::Agent::FlowCreateParams::Trigger::OrHash,
+              description: String,
+              enabled: T::Boolean,
+              priority: Integer,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(Zavudev::Models::Senders::Agent::FlowCreateResponse)
+          end
+          def create(
+            sender_id,
+            name:,
+            steps:,
+            trigger:,
+            description: nil,
+            enabled: nil,
+            priority: nil,
+            request_options: {}
+          )
+          end
+
+          # Get a specific flow.
+          sig do
+            params(
+              flow_id: String,
+              sender_id: String,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(Zavudev::Models::Senders::Agent::FlowRetrieveResponse)
+          end
+          def retrieve(flow_id, sender_id:, request_options: {})
+          end
+
+          # Update a flow.
+          sig do
+            params(
+              flow_id: String,
+              sender_id: String,
+              description: String,
+              enabled: T::Boolean,
+              name: String,
+              priority: Integer,
+              steps:
+                T::Array[
+                  Zavudev::Senders::Agent::FlowUpdateParams::Step::OrHash
+                ],
+              trigger:
+                Zavudev::Senders::Agent::FlowUpdateParams::Trigger::OrHash,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(Zavudev::Models::Senders::Agent::FlowUpdateResponse)
+          end
+          def update(
+            # Path param
+            flow_id,
+            # Path param
+            sender_id:,
+            # Body param
+            description: nil,
+            # Body param
+            enabled: nil,
+            # Body param
+            name: nil,
+            # Body param
+            priority: nil,
+            # Body param
+            steps: nil,
+            # Body param
+            trigger: nil,
+            request_options: {}
+          )
+          end
+
+          # List flows 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::AgentFlow]
+            )
+          end
+          def list(
+            sender_id,
+            cursor: nil,
+            enabled: nil,
+            limit: nil,
+            request_options: {}
+          )
+          end
+
+          # Delete a flow. Cannot delete flows with active sessions.
+          sig do
+            params(
+              flow_id: String,
+              sender_id: String,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).void
+          end
+          def delete(flow_id, sender_id:, request_options: {})
+          end
+
+          # Create a copy of an existing flow with a new name.
+          sig do
+            params(
+              flow_id: String,
+              sender_id: String,
+              new_name: String,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(Zavudev::Models::Senders::Agent::FlowDuplicateResponse)
+          end
+          def duplicate(
+            # Path param
+            flow_id,
+            # Path param
+            sender_id:,
+            # Body param
+            new_name:,
+            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/knowledge_bases/documents.rbi

@@ -0,0 +1,83 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Senders
+      class Agent
+        class KnowledgeBases
+          class Documents
+            # Add a document to a knowledge base. The document will be automatically processed
+            # for RAG.
+            sig do
+              params(
+                kb_id: String,
+                sender_id: String,
+                content: String,
+                title: String,
+                request_options: Zavudev::RequestOptions::OrHash
+              ).returns(
+                Zavudev::Models::Senders::Agent::KnowledgeBases::DocumentCreateResponse
+              )
+            end
+            def create(
+              # Path param
+              kb_id,
+              # Path param
+              sender_id:,
+              # Body param
+              content:,
+              # Body param
+              title:,
+              request_options: {}
+            )
+            end
+
+            # List documents in a knowledge base.
+            sig do
+              params(
+                kb_id: String,
+                sender_id: String,
+                cursor: String,
+                limit: Integer,
+                request_options: Zavudev::RequestOptions::OrHash
+              ).returns(
+                Zavudev::Internal::Cursor[
+                  Zavudev::Senders::Agent::AgentDocument
+                ]
+              )
+            end
+            def list(
+              # Path param
+              kb_id,
+              # Path param
+              sender_id:,
+              # Query param
+              cursor: nil,
+              # Query param
+              limit: nil,
+              request_options: {}
+            )
+            end
+
+            # Delete a document from a knowledge base.
+            sig do
+              params(
+                doc_id: String,
+                sender_id: String,
+                kb_id: String,
+                request_options: Zavudev::RequestOptions::OrHash
+              ).void
+            end
+            def delete(doc_id, sender_id:, kb_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
+end