zavudev 0.9.1 → 0.11.0

data/rbi/zavudev/models/me_retrieve_response.rbi

@@ -0,0 +1,151 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    class MeRetrieveResponse < Zavudev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Zavudev::Models::MeRetrieveResponse, Zavudev::Internal::AnyHash)
+        end
+
+      sig { returns(Zavudev::Models::MeRetrieveResponse::APIKey) }
+      attr_reader :api_key
+
+      sig do
+        params(
+          api_key: Zavudev::Models::MeRetrieveResponse::APIKey::OrHash
+        ).void
+      end
+      attr_writer :api_key
+
+      sig { returns(T::Boolean) }
+      attr_accessor :is_test_mode
+
+      sig { returns(Zavudev::Models::MeRetrieveResponse::Project) }
+      attr_reader :project
+
+      sig do
+        params(
+          project: Zavudev::Models::MeRetrieveResponse::Project::OrHash
+        ).void
+      end
+      attr_writer :project
+
+      sig { returns(Zavudev::Models::MeRetrieveResponse::Team) }
+      attr_reader :team
+
+      sig do
+        params(team: Zavudev::Models::MeRetrieveResponse::Team::OrHash).void
+      end
+      attr_writer :team
+
+      sig do
+        params(
+          api_key: Zavudev::Models::MeRetrieveResponse::APIKey::OrHash,
+          is_test_mode: T::Boolean,
+          project: Zavudev::Models::MeRetrieveResponse::Project::OrHash,
+          team: Zavudev::Models::MeRetrieveResponse::Team::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(api_key:, is_test_mode:, project:, team:)
+      end
+
+      sig do
+        override.returns(
+          {
+            api_key: Zavudev::Models::MeRetrieveResponse::APIKey,
+            is_test_mode: T::Boolean,
+            project: Zavudev::Models::MeRetrieveResponse::Project,
+            team: Zavudev::Models::MeRetrieveResponse::Team
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class APIKey < Zavudev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Zavudev::Models::MeRetrieveResponse::APIKey,
+              Zavudev::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        sig { params(id: String).returns(T.attached_class) }
+        def self.new(id:)
+        end
+
+        sig { override.returns({ id: String }) }
+        def to_hash
+        end
+      end
+
+      class Project < Zavudev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Zavudev::Models::MeRetrieveResponse::Project,
+              Zavudev::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        sig { returns(T::Boolean) }
+        attr_accessor :is_sub_account
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :name
+
+        sig do
+          params(
+            id: String,
+            is_sub_account: T::Boolean,
+            name: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(id:, is_sub_account:, name:)
+        end
+
+        sig do
+          override.returns(
+            { id: String, is_sub_account: T::Boolean, name: T.nilable(String) }
+          )
+        end
+        def to_hash
+        end
+      end
+
+      class Team < Zavudev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Zavudev::Models::MeRetrieveResponse::Team,
+              Zavudev::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :name
+
+        sig do
+          params(id: String, name: T.nilable(String)).returns(T.attached_class)
+        end
+        def self.new(id:, name:)
+        end
+
+        sig { override.returns({ id: String, name: T.nilable(String) }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/models/message_show_typing_params.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    class MessageShowTypingParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Zavudev::MessageShowTypingParams, Zavudev::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :message_id
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :zavu_sender
+
+      sig { params(zavu_sender: String).void }
+      attr_writer :zavu_sender
+
+      sig do
+        params(
+          message_id: String,
+          zavu_sender: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(message_id:, zavu_sender: nil, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          {
+            message_id: String,
+            zavu_sender: String,
+            request_options: Zavudev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/zavudev/models/message_show_typing_response.rbi

@@ -0,0 +1,26 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    class MessageShowTypingResponse < Zavudev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Zavudev::Models::MessageShowTypingResponse,
+            Zavudev::Internal::AnyHash
+          )
+        end
+
+      sig { returns(T::Boolean) }
+      attr_accessor :success
+
+      sig { params(success: T::Boolean).returns(T.attached_class) }
+      def self.new(success:)
+      end
+
+      sig { override.returns({ success: T::Boolean }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/zavudev/models/senders/agent/execution_retrieve_params.rbi

@@ -0,0 +1,50 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    module Senders
+      module Agent
+        class ExecutionRetrieveParams < Zavudev::Internal::Type::BaseModel
+          extend Zavudev::Internal::Type::RequestParameters::Converter
+          include Zavudev::Internal::Type::RequestParameters
+
+          OrHash =
+            T.type_alias do
+              T.any(
+                Zavudev::Senders::Agent::ExecutionRetrieveParams,
+                Zavudev::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :sender_id
+
+          sig { returns(String) }
+          attr_accessor :execution_id
+
+          sig do
+            params(
+              sender_id: String,
+              execution_id: String,
+              request_options: Zavudev::RequestOptions::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(sender_id:, execution_id:, request_options: {})
+          end
+
+          sig do
+            override.returns(
+              {
+                sender_id: String,
+                execution_id: String,
+                request_options: Zavudev::RequestOptions
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/models/senders/agent/execution_retrieve_response.rbi

@@ -0,0 +1,41 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    module Senders
+      module Agent
+        class ExecutionRetrieveResponse < Zavudev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Zavudev::Models::Senders::Agent::ExecutionRetrieveResponse,
+                Zavudev::Internal::AnyHash
+              )
+            end
+
+          sig { returns(Zavudev::Senders::AgentExecution) }
+          attr_reader :execution
+
+          sig do
+            params(execution: Zavudev::Senders::AgentExecution::OrHash).void
+          end
+          attr_writer :execution
+
+          sig do
+            params(execution: Zavudev::Senders::AgentExecution::OrHash).returns(
+              T.attached_class
+            )
+          end
+          def self.new(execution:)
+          end
+
+          sig do
+            override.returns({ execution: Zavudev::Senders::AgentExecution })
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/models/webhook_event.rbi

@@ -35,6 +35,13 @@ module Zavudev
     #
     # - `invitation.status_changed`: A partner invitation status changed (pending,
     #   in_progress, completed, cancelled)
+    #
+    # **Custom domain events:**
+    #
+    # - `domain.verified`: A custom email domain passed verification (DKIM, and
+    #   SPF/DMARC/MAIL FROM if enhanced records are enabled)
+    # - `domain.failed`: A custom email domain failed verification or is partially
+    #   verified
     module WebhookEvent
       extend Zavudev::Internal::Type::Enum
 
@@ -61,6 +68,10 @@ module Zavudev
         T.let(:"template.status_changed", Zavudev::WebhookEvent::TaggedSymbol)
       INVITATION_STATUS_CHANGED =
         T.let(:"invitation.status_changed", Zavudev::WebhookEvent::TaggedSymbol)
+      DOMAIN_VERIFIED =
+        T.let(:"domain.verified", Zavudev::WebhookEvent::TaggedSymbol)
+      DOMAIN_FAILED =
+        T.let(:"domain.failed", Zavudev::WebhookEvent::TaggedSymbol)
 
       sig { override.returns(T::Array[Zavudev::WebhookEvent::TaggedSymbol]) }
       def self.values

data/rbi/zavudev/models.rbi

@@ -65,6 +65,8 @@ module Zavudev
 
   ContactCreateParams = Zavudev::Models::ContactCreateParams
 
+  ContactDeleteParams = Zavudev::Models::ContactDeleteParams
+
   ContactDismissMergeSuggestionParams =
     Zavudev::Models::ContactDismissMergeSuggestionParams
 
@@ -88,6 +90,22 @@ module Zavudev
 
   ExportRetrieveParams = Zavudev::Models::ExportRetrieveParams
 
+  FunctionCreateParams = Zavudev::Models::FunctionCreateParams
+
+  FunctionDeleteParams = Zavudev::Models::FunctionDeleteParams
+
+  FunctionDeployParams = Zavudev::Models::FunctionDeployParams
+
+  FunctionGetDeploymentParams = Zavudev::Models::FunctionGetDeploymentParams
+
+  FunctionRetrieveParams = Zavudev::Models::FunctionRetrieveParams
+
+  Functions = Zavudev::Models::Functions
+
+  FunctionTailLogsParams = Zavudev::Models::FunctionTailLogsParams
+
+  FunctionUpdateParams = Zavudev::Models::FunctionUpdateParams
+
   IntrospectValidatePhoneParams = Zavudev::Models::IntrospectValidatePhoneParams
 
   Invitation = Zavudev::Models::Invitation
@@ -102,6 +120,8 @@ module Zavudev
 
   LineType = Zavudev::Models::LineType
 
+  MeRetrieveParams = Zavudev::Models::MeRetrieveParams
+
   Message = Zavudev::Models::Message
 
   MessageContent = Zavudev::Models::MessageContent
@@ -116,6 +136,8 @@ module Zavudev
 
   MessageSendParams = Zavudev::Models::MessageSendParams
 
+  MessageShowTypingParams = Zavudev::Models::MessageShowTypingParams
+
   MessageStatus = Zavudev::Models::MessageStatus
 
   MessageType = Zavudev::Models::MessageType

data/rbi/zavudev/resources/contacts.rbi

@@ -67,6 +67,21 @@ module Zavudev
       def list(cursor: nil, limit: nil, phone_number: nil, request_options: {})
       end
 
+      # Permanently delete a contact and its communication channels. Implements
+      # right-to-erasure obligations under GDPR Art. 17, Ley 19.628 (Chile) Art. 12,
+      # CCPA § 1798.105, and LGPD Art. 18.VI. The contact, its channels, and any
+      # associated agent flow sessions and conversation threads are removed. Past
+      # message records and broadcast delivery logs are retained for billing/audit but
+      # no longer reference the deleted contact.
+      sig do
+        params(
+          contact_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).void
+      end
+      def delete(contact_id, request_options: {})
+      end
+
       # Dismiss the merge suggestion for a contact.
       sig do
         params(

data/rbi/zavudev/resources/functions/secrets.rbi

@@ -0,0 +1,69 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Functions
+      class Secrets
+        # Lists every secret key set on the function. Plaintext is NEVER returned — only
+        # the last 4 characters of each value, for visual confirmation.
+        sig do
+          params(
+            function_id: String,
+            request_options: Zavudev::RequestOptions::OrHash
+          ).returns(Zavudev::Models::Functions::SecretListResponse)
+        end
+        def list(
+          # Zavu Function ID.
+          function_id,
+          request_options: {}
+        )
+        end
+
+        # Create or update a secret on a function. Marks the function out-of-sync; the
+        # next `POST /deploy` re-publishes the Lambda with the new env. Keys must match
+        # `[A-Z_][A-Z0-9_]*` (uppercase env-var style) and cannot start with reserved
+        # prefixes (AWS*, LAMBDA*, etc).
+        sig do
+          params(
+            key: String,
+            function_id: String,
+            value: String,
+            request_options: Zavudev::RequestOptions::OrHash
+          ).returns(T.anything)
+        end
+        def set(
+          # Path param
+          key,
+          # Path param: Zavu Function ID.
+          function_id:,
+          # Body param
+          value:,
+          request_options: {}
+        )
+        end
+
+        # Remove a secret from a function. Doesn't take effect on the running Lambda until
+        # the next deploy.
+        sig do
+          params(
+            key: String,
+            function_id: String,
+            request_options: Zavudev::RequestOptions::OrHash
+          ).void
+        end
+        def unset(
+          key,
+          # Zavu Function ID.
+          function_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/functions.rbi

@@ -0,0 +1,171 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Functions
+      sig { returns(Zavudev::Resources::Functions::Secrets) }
+      attr_reader :secrets
+
+      # Create a new Zavu Function. The function starts in `draft` status. A dedicated
+      # API key is auto-provisioned and injected as the `ZAVU_API_KEY` secret so the
+      # function can call back into the Zavu API without manual setup.
+      #
+      # Provide `sourceCode` to seed the draft. Call
+      # `POST /v1/functions/{functionId}/deploy` afterwards to publish.
+      sig do
+        params(
+          name: String,
+          slug: String,
+          dependencies: T::Hash[Symbol, String],
+          description: String,
+          http_enabled: T::Boolean,
+          memory_mb: Zavudev::FunctionCreateParams::MemoryMB::OrInteger,
+          runtime: Zavudev::FunctionCreateParams::Runtime::OrSymbol,
+          source_code: String,
+          timeout_sec: Integer,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::FunctionCreateResponse)
+      end
+      def create(
+        name:,
+        # URL-safe identifier (lowercase, digits, hyphens). Must be unique per project.
+        slug:,
+        # npm dependencies. Keys are package names, values are semver ranges.
+        dependencies: nil,
+        description: nil,
+        # Whether to expose a public HTTPS URL for this function.
+        http_enabled: nil,
+        memory_mb: nil,
+        # Runtime the function is deployed on.
+        runtime: nil,
+        # TypeScript source code for the function entry point (max ~900KB).
+        source_code: nil,
+        timeout_sec: nil,
+        request_options: {}
+      )
+      end
+
+      # Get function
+      sig do
+        params(
+          function_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::FunctionRetrieveResponse)
+      end
+      def retrieve(
+        # Zavu Function ID.
+        function_id,
+        request_options: {}
+      )
+      end
+
+      # Update the draft source code and/or dependency map without triggering a build.
+      # Visible in the dashboard immediately, but the live (deployed) function does not
+      # change until `POST /v1/functions/{functionId}/deploy` runs.
+      sig do
+        params(
+          function_id: String,
+          dependencies: T::Hash[Symbol, String],
+          source_code: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::FunctionUpdateResponse)
+      end
+      def update(
+        # Zavu Function ID.
+        function_id,
+        # New dependency map (replaces existing dependencies).
+        dependencies: nil,
+        # New source code to publish (replaces the draft).
+        source_code: nil,
+        request_options: {}
+      )
+      end
+
+      # Permanently delete a function and cascade: triggers, secrets, deployment
+      # history, managed agents+tools, and revoke the auto-provisioned API key. The AWS
+      # Lambda + log group are torn down asynchronously.
+      sig do
+        params(
+          function_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::FunctionDeleteResponse)
+      end
+      def delete(
+        # Zavu Function ID.
+        function_id,
+        request_options: {}
+      )
+      end
+
+      # Publish the function. If `sourceCode` or `dependencies` are provided in the
+      # body, they replace the current draft before deployment. Returns immediately with
+      # a deployment ID — poll `GET /v1/functions/deployments/{deploymentId}` until
+      # status is `active` or `failed`.
+      sig do
+        params(
+          function_id: String,
+          dependencies: T::Hash[Symbol, String],
+          source_code: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::FunctionDeployResponse)
+      end
+      def deploy(
+        # Zavu Function ID.
+        function_id,
+        # New dependency map (replaces existing dependencies).
+        dependencies: nil,
+        # New source code to publish (replaces the draft).
+        source_code: nil,
+        request_options: {}
+      )
+      end
+
+      # Fetch a deployment to poll its status during a deploy.
+      sig do
+        params(
+          deployment_id: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::FunctionGetDeploymentResponse)
+      end
+      def get_deployment(
+        # Function deployment ID.
+        deployment_id,
+        request_options: {}
+      )
+      end
+
+      # Fetch invocation logs for a function. Logs are paginated via `nextToken`. Pass
+      # `startTime` / `endTime` (Unix epoch milliseconds) to bound the window, or
+      # `filterPattern` to filter messages.
+      sig do
+        params(
+          function_id: String,
+          end_time: Integer,
+          filter_pattern: String,
+          limit: Integer,
+          next_token: String,
+          start_time: Integer,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::FunctionTailLogsResponse)
+      end
+      def tail_logs(
+        # Zavu Function ID.
+        function_id,
+        # End of the log window in Unix epoch milliseconds.
+        end_time: nil,
+        filter_pattern: nil,
+        limit: nil,
+        next_token: nil,
+        # Start of the log window in Unix epoch milliseconds.
+        start_time: 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/me.rbi

@@ -0,0 +1,22 @@
+# typed: strong
+
+module Zavudev
+  module Resources
+    class Me
+      # Returns the project, team, and API key metadata bound to the current Bearer
+      # token. Used by CLIs and SDKs to confirm which project they will operate on.
+      sig do
+        params(request_options: Zavudev::RequestOptions::OrHash).returns(
+          Zavudev::Models::MeRetrieveResponse
+        )
+      end
+      def retrieve(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

@@ -135,6 +135,27 @@ module Zavudev
       )
       end
 
+      # Mark an inbound WhatsApp message as read and display a typing indicator to the
+      # user while you prepare a response. The indicator is automatically dismissed when
+      # you send a reply, or after 25 seconds — whichever comes first. Only valid for
+      # inbound WhatsApp messages. Use this when a reply will take more than a couple of
+      # seconds (LLM agent, tool call, lookup) to improve the recipient's experience.
+      sig do
+        params(
+          message_id: String,
+          zavu_sender: String,
+          request_options: Zavudev::RequestOptions::OrHash
+        ).returns(Zavudev::Models::MessageShowTypingResponse)
+      end
+      def show_typing(
+        message_id,
+        # 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:)