zavudev 0.5.0 → 0.7.0

data/rbi/zavudev/models/contact_channel.rbi

@@ -0,0 +1,231 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    class ContactChannel < Zavudev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Zavudev::ContactChannel, Zavudev::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      # Channel type.
+      sig { returns(Zavudev::ContactChannel::Channel::TaggedSymbol) }
+      attr_accessor :channel
+
+      sig { returns(Time) }
+      attr_accessor :created_at
+
+      # Channel identifier (phone number or email address).
+      sig { returns(String) }
+      attr_accessor :identifier
+
+      # Whether this is the primary channel for its type.
+      sig { returns(T::Boolean) }
+      attr_accessor :is_primary
+
+      # Whether this channel has been verified.
+      sig { returns(T::Boolean) }
+      attr_accessor :verified
+
+      # ISO country code for phone numbers.
+      sig { returns(T.nilable(String)) }
+      attr_reader :country_code
+
+      sig { params(country_code: String).void }
+      attr_writer :country_code
+
+      # Optional label for the channel.
+      sig { returns(T.nilable(String)) }
+      attr_reader :label
+
+      sig { params(label: String).void }
+      attr_writer :label
+
+      # Last time a message was received on this channel.
+      sig { returns(T.nilable(Time)) }
+      attr_reader :last_inbound_at
+
+      sig { params(last_inbound_at: Time).void }
+      attr_writer :last_inbound_at
+
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :metadata
+
+      sig { params(metadata: T::Hash[Symbol, String]).void }
+      attr_writer :metadata
+
+      # Delivery metrics for this channel.
+      sig { returns(T.nilable(Zavudev::ContactChannel::Metrics)) }
+      attr_reader :metrics
+
+      sig { params(metrics: Zavudev::ContactChannel::Metrics::OrHash).void }
+      attr_writer :metrics
+
+      sig { returns(T.nilable(Time)) }
+      attr_reader :updated_at
+
+      sig { params(updated_at: Time).void }
+      attr_writer :updated_at
+
+      # A communication channel for a contact.
+      sig do
+        params(
+          id: String,
+          channel: Zavudev::ContactChannel::Channel::OrSymbol,
+          created_at: Time,
+          identifier: String,
+          is_primary: T::Boolean,
+          verified: T::Boolean,
+          country_code: String,
+          label: String,
+          last_inbound_at: Time,
+          metadata: T::Hash[Symbol, String],
+          metrics: Zavudev::ContactChannel::Metrics::OrHash,
+          updated_at: Time
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        # Channel type.
+        channel:,
+        created_at:,
+        # Channel identifier (phone number or email address).
+        identifier:,
+        # Whether this is the primary channel for its type.
+        is_primary:,
+        # Whether this channel has been verified.
+        verified:,
+        # ISO country code for phone numbers.
+        country_code: nil,
+        # Optional label for the channel.
+        label: nil,
+        # Last time a message was received on this channel.
+        last_inbound_at: nil,
+        metadata: nil,
+        # Delivery metrics for this channel.
+        metrics: nil,
+        updated_at: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            channel: Zavudev::ContactChannel::Channel::TaggedSymbol,
+            created_at: Time,
+            identifier: String,
+            is_primary: T::Boolean,
+            verified: T::Boolean,
+            country_code: String,
+            label: String,
+            last_inbound_at: Time,
+            metadata: T::Hash[Symbol, String],
+            metrics: Zavudev::ContactChannel::Metrics,
+            updated_at: Time
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Channel type.
+      module Channel
+        extend Zavudev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Zavudev::ContactChannel::Channel) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SMS = T.let(:sms, Zavudev::ContactChannel::Channel::TaggedSymbol)
+        WHATSAPP =
+          T.let(:whatsapp, Zavudev::ContactChannel::Channel::TaggedSymbol)
+        EMAIL = T.let(:email, Zavudev::ContactChannel::Channel::TaggedSymbol)
+        TELEGRAM =
+          T.let(:telegram, Zavudev::ContactChannel::Channel::TaggedSymbol)
+        VOICE = T.let(:voice, Zavudev::ContactChannel::Channel::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Zavudev::ContactChannel::Channel::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class Metrics < Zavudev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Zavudev::ContactChannel::Metrics, Zavudev::Internal::AnyHash)
+          end
+
+        sig { returns(T.nilable(Float)) }
+        attr_reader :avg_delivery_time_ms
+
+        sig { params(avg_delivery_time_ms: Float).void }
+        attr_writer :avg_delivery_time_ms
+
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :failure_count
+
+        sig { params(failure_count: Integer).void }
+        attr_writer :failure_count
+
+        sig { returns(T.nilable(Time)) }
+        attr_reader :last_success_at
+
+        sig { params(last_success_at: Time).void }
+        attr_writer :last_success_at
+
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :success_count
+
+        sig { params(success_count: Integer).void }
+        attr_writer :success_count
+
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :total_attempts
+
+        sig { params(total_attempts: Integer).void }
+        attr_writer :total_attempts
+
+        # Delivery metrics for this channel.
+        sig do
+          params(
+            avg_delivery_time_ms: Float,
+            failure_count: Integer,
+            last_success_at: Time,
+            success_count: Integer,
+            total_attempts: Integer
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          avg_delivery_time_ms: nil,
+          failure_count: nil,
+          last_success_at: nil,
+          success_count: nil,
+          total_attempts: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              avg_delivery_time_ms: Float,
+              failure_count: Integer,
+              last_success_at: Time,
+              success_count: Integer,
+              total_attempts: Integer
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/models/message_send_params.rbi

@@ -30,8 +30,9 @@ module Zavudev
       end
       attr_writer :attachments
 
-      # Delivery channel. Use 'auto' for intelligent routing. If omitted with non-text
-      # messageType, WhatsApp is used. For email recipients, defaults to 'email'.
+      # Delivery channel. Use 'auto' for intelligent routing. If omitted, channel is
+      # auto-selected based on sender capabilities and recipient type. For email
+      # recipients, defaults to 'email'.
       sig { returns(T.nilable(Zavudev::Channel::OrSymbol)) }
       attr_reader :channel
 
@@ -143,8 +144,9 @@ module Zavudev
         # Email attachments. Only supported when channel is 'email'. Maximum 40MB total
         # size.
         attachments: nil,
-        # Delivery channel. Use 'auto' for intelligent routing. If omitted with non-text
-        # messageType, WhatsApp is used. For email recipients, defaults to 'email'.
+        # Delivery channel. Use 'auto' for intelligent routing. If omitted, channel is
+        # auto-selected based on sender capabilities and recipient type. For email
+        # recipients, defaults to 'email'.
         channel: nil,
         # Additional content for non-text message types.
         content: nil,

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

@@ -34,16 +34,14 @@ module Zavudev
           sig { returns(Integer) }
           attr_accessor :priority
 
-          sig { returns(T::Array[Zavudev::Senders::Agent::AgentFlow::Step]) }
+          sig { returns(T::Array[Zavudev::Senders::Agent::FlowStep]) }
           attr_accessor :steps
 
-          sig { returns(Zavudev::Senders::Agent::AgentFlow::Trigger) }
+          sig { returns(Zavudev::Senders::Agent::FlowTrigger) }
           attr_reader :trigger
 
           sig do
-            params(
-              trigger: Zavudev::Senders::Agent::AgentFlow::Trigger::OrHash
-            ).void
+            params(trigger: Zavudev::Senders::Agent::FlowTrigger::OrHash).void
           end
           attr_writer :trigger
 
@@ -61,8 +59,8 @@ module Zavudev
               enabled: T::Boolean,
               name: String,
               priority: Integer,
-              steps: T::Array[Zavudev::Senders::Agent::AgentFlow::Step::OrHash],
-              trigger: Zavudev::Senders::Agent::AgentFlow::Trigger::OrHash,
+              steps: T::Array[Zavudev::Senders::Agent::FlowStep::OrHash],
+              trigger: Zavudev::Senders::Agent::FlowTrigger::OrHash,
               updated_at: Time,
               description: T.nilable(String)
             ).returns(T.attached_class)
@@ -91,8 +89,8 @@ module Zavudev
                 enabled: T::Boolean,
                 name: String,
                 priority: Integer,
-                steps: T::Array[Zavudev::Senders::Agent::AgentFlow::Step],
-                trigger: Zavudev::Senders::Agent::AgentFlow::Trigger,
+                steps: T::Array[Zavudev::Senders::Agent::FlowStep],
+                trigger: Zavudev::Senders::Agent::FlowTrigger,
                 updated_at: Time,
                 description: T.nilable(String)
               }
@@ -100,230 +98,6 @@ module Zavudev
           end
           def to_hash
           end
-
-          class Step < Zavudev::Internal::Type::BaseModel
-            OrHash =
-              T.type_alias do
-                T.any(
-                  Zavudev::Senders::Agent::AgentFlow::Step,
-                  Zavudev::Internal::AnyHash
-                )
-              end
-
-            # Unique step identifier.
-            sig { returns(String) }
-            attr_accessor :id
-
-            # Step configuration (varies by type).
-            sig { returns(T::Hash[Symbol, T.anything]) }
-            attr_accessor :config
-
-            # Type of flow step.
-            sig do
-              returns(
-                Zavudev::Senders::Agent::AgentFlow::Step::Type::TaggedSymbol
-              )
-            end
-            attr_accessor :type
-
-            # ID of the next step to execute.
-            sig { returns(T.nilable(String)) }
-            attr_accessor :next_step_id
-
-            sig do
-              params(
-                id: String,
-                config: T::Hash[Symbol, T.anything],
-                type: Zavudev::Senders::Agent::AgentFlow::Step::Type::OrSymbol,
-                next_step_id: T.nilable(String)
-              ).returns(T.attached_class)
-            end
-            def self.new(
-              # Unique step identifier.
-              id:,
-              # Step configuration (varies by type).
-              config:,
-              # Type of flow step.
-              type:,
-              # ID of the next step to execute.
-              next_step_id: nil
-            )
-            end
-
-            sig do
-              override.returns(
-                {
-                  id: String,
-                  config: T::Hash[Symbol, T.anything],
-                  type:
-                    Zavudev::Senders::Agent::AgentFlow::Step::Type::TaggedSymbol,
-                  next_step_id: T.nilable(String)
-                }
-              )
-            end
-            def to_hash
-            end
-
-            # Type of flow step.
-            module Type
-              extend Zavudev::Internal::Type::Enum
-
-              TaggedSymbol =
-                T.type_alias do
-                  T.all(Symbol, Zavudev::Senders::Agent::AgentFlow::Step::Type)
-                end
-              OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-              MESSAGE =
-                T.let(
-                  :message,
-                  Zavudev::Senders::Agent::AgentFlow::Step::Type::TaggedSymbol
-                )
-              COLLECT =
-                T.let(
-                  :collect,
-                  Zavudev::Senders::Agent::AgentFlow::Step::Type::TaggedSymbol
-                )
-              CONDITION =
-                T.let(
-                  :condition,
-                  Zavudev::Senders::Agent::AgentFlow::Step::Type::TaggedSymbol
-                )
-              TOOL =
-                T.let(
-                  :tool,
-                  Zavudev::Senders::Agent::AgentFlow::Step::Type::TaggedSymbol
-                )
-              LLM =
-                T.let(
-                  :llm,
-                  Zavudev::Senders::Agent::AgentFlow::Step::Type::TaggedSymbol
-                )
-              TRANSFER =
-                T.let(
-                  :transfer,
-                  Zavudev::Senders::Agent::AgentFlow::Step::Type::TaggedSymbol
-                )
-
-              sig do
-                override.returns(
-                  T::Array[
-                    Zavudev::Senders::Agent::AgentFlow::Step::Type::TaggedSymbol
-                  ]
-                )
-              end
-              def self.values
-              end
-            end
-          end
-
-          class Trigger < Zavudev::Internal::Type::BaseModel
-            OrHash =
-              T.type_alias do
-                T.any(
-                  Zavudev::Senders::Agent::AgentFlow::Trigger,
-                  Zavudev::Internal::AnyHash
-                )
-              end
-
-            # Type of trigger for a flow.
-            sig do
-              returns(
-                Zavudev::Senders::Agent::AgentFlow::Trigger::Type::TaggedSymbol
-              )
-            end
-            attr_accessor :type
-
-            # Intent that triggers the flow (for intent type).
-            sig { returns(T.nilable(String)) }
-            attr_reader :intent
-
-            sig { params(intent: String).void }
-            attr_writer :intent
-
-            # Keywords that trigger the flow (for keyword type).
-            sig { returns(T.nilable(T::Array[String])) }
-            attr_reader :keywords
-
-            sig { params(keywords: T::Array[String]).void }
-            attr_writer :keywords
-
-            sig do
-              params(
-                type:
-                  Zavudev::Senders::Agent::AgentFlow::Trigger::Type::OrSymbol,
-                intent: String,
-                keywords: T::Array[String]
-              ).returns(T.attached_class)
-            end
-            def self.new(
-              # Type of trigger for a flow.
-              type:,
-              # Intent that triggers the flow (for intent type).
-              intent: nil,
-              # Keywords that trigger the flow (for keyword type).
-              keywords: nil
-            )
-            end
-
-            sig do
-              override.returns(
-                {
-                  type:
-                    Zavudev::Senders::Agent::AgentFlow::Trigger::Type::TaggedSymbol,
-                  intent: String,
-                  keywords: T::Array[String]
-                }
-              )
-            end
-            def to_hash
-            end
-
-            # Type of trigger for a flow.
-            module Type
-              extend Zavudev::Internal::Type::Enum
-
-              TaggedSymbol =
-                T.type_alias do
-                  T.all(
-                    Symbol,
-                    Zavudev::Senders::Agent::AgentFlow::Trigger::Type
-                  )
-                end
-              OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-              KEYWORD =
-                T.let(
-                  :keyword,
-                  Zavudev::Senders::Agent::AgentFlow::Trigger::Type::TaggedSymbol
-                )
-              INTENT =
-                T.let(
-                  :intent,
-                  Zavudev::Senders::Agent::AgentFlow::Trigger::Type::TaggedSymbol
-                )
-              ALWAYS =
-                T.let(
-                  :always,
-                  Zavudev::Senders::Agent::AgentFlow::Trigger::Type::TaggedSymbol
-                )
-              MANUAL =
-                T.let(
-                  :manual,
-                  Zavudev::Senders::Agent::AgentFlow::Trigger::Type::TaggedSymbol
-                )
-
-              sig do
-                override.returns(
-                  T::Array[
-                    Zavudev::Senders::Agent::AgentFlow::Trigger::Type::TaggedSymbol
-                  ]
-                )
-              end
-              def self.values
-              end
-            end
-          end
         end
       end
     end

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

@@ -34,12 +34,12 @@ module Zavudev
           sig { returns(String) }
           attr_accessor :name
 
-          sig { returns(Zavudev::Senders::Agent::AgentTool::Parameters) }
+          sig { returns(Zavudev::Senders::Agent::ToolParameters) }
           attr_reader :parameters
 
           sig do
             params(
-              parameters: Zavudev::Senders::Agent::AgentTool::Parameters::OrHash
+              parameters: Zavudev::Senders::Agent::ToolParameters::OrHash
             ).void
           end
           attr_writer :parameters
@@ -59,8 +59,7 @@ module Zavudev
               description: String,
               enabled: T::Boolean,
               name: String,
-              parameters:
-                Zavudev::Senders::Agent::AgentTool::Parameters::OrHash,
+              parameters: Zavudev::Senders::Agent::ToolParameters::OrHash,
               updated_at: Time,
               webhook_url: String
             ).returns(T.attached_class)
@@ -89,7 +88,7 @@ module Zavudev
                 description: String,
                 enabled: T::Boolean,
                 name: String,
-                parameters: Zavudev::Senders::Agent::AgentTool::Parameters,
+                parameters: Zavudev::Senders::Agent::ToolParameters,
                 updated_at: Time,
                 webhook_url: String
               }
@@ -97,131 +96,6 @@ module Zavudev
           end
           def to_hash
           end
-
-          class Parameters < Zavudev::Internal::Type::BaseModel
-            OrHash =
-              T.type_alias do
-                T.any(
-                  Zavudev::Senders::Agent::AgentTool::Parameters,
-                  Zavudev::Internal::AnyHash
-                )
-              end
-
-            sig do
-              returns(
-                T::Hash[
-                  Symbol,
-                  Zavudev::Senders::Agent::AgentTool::Parameters::Property
-                ]
-              )
-            end
-            attr_accessor :properties
-
-            sig { returns(T::Array[String]) }
-            attr_accessor :required
-
-            sig do
-              returns(
-                Zavudev::Senders::Agent::AgentTool::Parameters::Type::TaggedSymbol
-              )
-            end
-            attr_accessor :type
-
-            sig do
-              params(
-                properties:
-                  T::Hash[
-                    Symbol,
-                    Zavudev::Senders::Agent::AgentTool::Parameters::Property::OrHash
-                  ],
-                required: T::Array[String],
-                type:
-                  Zavudev::Senders::Agent::AgentTool::Parameters::Type::OrSymbol
-              ).returns(T.attached_class)
-            end
-            def self.new(properties:, required:, type:)
-            end
-
-            sig do
-              override.returns(
-                {
-                  properties:
-                    T::Hash[
-                      Symbol,
-                      Zavudev::Senders::Agent::AgentTool::Parameters::Property
-                    ],
-                  required: T::Array[String],
-                  type:
-                    Zavudev::Senders::Agent::AgentTool::Parameters::Type::TaggedSymbol
-                }
-              )
-            end
-            def to_hash
-            end
-
-            class Property < Zavudev::Internal::Type::BaseModel
-              OrHash =
-                T.type_alias do
-                  T.any(
-                    Zavudev::Senders::Agent::AgentTool::Parameters::Property,
-                    Zavudev::Internal::AnyHash
-                  )
-                end
-
-              sig { returns(T.nilable(String)) }
-              attr_reader :description
-
-              sig { params(description: String).void }
-              attr_writer :description
-
-              sig { returns(T.nilable(String)) }
-              attr_reader :type
-
-              sig { params(type: String).void }
-              attr_writer :type
-
-              sig do
-                params(description: String, type: String).returns(
-                  T.attached_class
-                )
-              end
-              def self.new(description: nil, type: nil)
-              end
-
-              sig { override.returns({ description: String, type: String }) }
-              def to_hash
-              end
-            end
-
-            module Type
-              extend Zavudev::Internal::Type::Enum
-
-              TaggedSymbol =
-                T.type_alias do
-                  T.all(
-                    Symbol,
-                    Zavudev::Senders::Agent::AgentTool::Parameters::Type
-                  )
-                end
-              OrSymbol = T.type_alias { T.any(Symbol, String) }
-
-              OBJECT =
-                T.let(
-                  :object,
-                  Zavudev::Senders::Agent::AgentTool::Parameters::Type::TaggedSymbol
-                )
-
-              sig do
-                override.returns(
-                  T::Array[
-                    Zavudev::Senders::Agent::AgentTool::Parameters::Type::TaggedSymbol
-                  ]
-                )
-              end
-              def self.values
-              end
-            end
-          end
         end
       end
     end