zavudev 0.9.1 → 0.11.0

data/lib/zavudev/resources/senders/agent/executions.rb

@@ -5,6 +5,32 @@ module Zavudev
     class Senders
       class Agent
         class Executions
+          # Fetch full details for one execution — including `errorMessage`, `errorCode`,
+          # and `responseText`. Use this to debug failures surfaced by the list endpoint.
+          #
+          # @overload retrieve(execution_id, sender_id:, request_options: {})
+          #
+          # @param execution_id [String]
+          # @param sender_id [String]
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Models::Senders::Agent::ExecutionRetrieveResponse]
+          #
+          # @see Zavudev::Models::Senders::Agent::ExecutionRetrieveParams
+          def retrieve(execution_id, params)
+            parsed, options = Zavudev::Senders::Agent::ExecutionRetrieveParams.dump_request(params)
+            sender_id =
+              parsed.delete(:sender_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :get,
+              path: ["v1/senders/%1$s/agent/executions/%2$s", sender_id, execution_id],
+              model: Zavudev::Models::Senders::Agent::ExecutionRetrieveResponse,
+              options: options
+            )
+          end
+
           # List recent agent executions with pagination.
           #
           # @overload list(sender_id, cursor: nil, limit: nil, status: nil, request_options: {})

data/lib/zavudev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Zavudev
-  VERSION = "0.9.1"
+  VERSION = "0.11.0"
 end

data/lib/zavudev.rb

@@ -99,6 +99,7 @@ require_relative "zavudev/models/channel"
 require_relative "zavudev/models/contact"
 require_relative "zavudev/models/contact_channel"
 require_relative "zavudev/models/contact_create_params"
+require_relative "zavudev/models/contact_delete_params"
 require_relative "zavudev/models/contact_dismiss_merge_suggestion_params"
 require_relative "zavudev/models/contact_list_params"
 require_relative "zavudev/models/contact_merge_params"
@@ -118,6 +119,25 @@ require_relative "zavudev/models/export_create_response"
 require_relative "zavudev/models/export_list_params"
 require_relative "zavudev/models/export_retrieve_params"
 require_relative "zavudev/models/export_retrieve_response"
+require_relative "zavudev/models/function_create_params"
+require_relative "zavudev/models/function_create_response"
+require_relative "zavudev/models/function_delete_params"
+require_relative "zavudev/models/function_delete_response"
+require_relative "zavudev/models/function_deploy_params"
+require_relative "zavudev/models/function_deploy_response"
+require_relative "zavudev/models/function_get_deployment_params"
+require_relative "zavudev/models/function_get_deployment_response"
+require_relative "zavudev/models/function_retrieve_params"
+require_relative "zavudev/models/function_retrieve_response"
+require_relative "zavudev/models/functions/secret_list_params"
+require_relative "zavudev/models/functions/secret_list_response"
+require_relative "zavudev/models/functions/secret_set_params"
+require_relative "zavudev/models/functions/secret_set_response"
+require_relative "zavudev/models/functions/secret_unset_params"
+require_relative "zavudev/models/function_tail_logs_params"
+require_relative "zavudev/models/function_tail_logs_response"
+require_relative "zavudev/models/function_update_params"
+require_relative "zavudev/models/function_update_response"
 require_relative "zavudev/models/introspect_validate_phone_params"
 require_relative "zavudev/models/introspect_validate_phone_response"
 require_relative "zavudev/models/invitation"
@@ -129,6 +149,8 @@ require_relative "zavudev/models/invitation_list_params"
 require_relative "zavudev/models/invitation_retrieve_params"
 require_relative "zavudev/models/invitation_retrieve_response"
 require_relative "zavudev/models/line_type"
+require_relative "zavudev/models/me_retrieve_params"
+require_relative "zavudev/models/me_retrieve_response"
 require_relative "zavudev/models/message"
 require_relative "zavudev/models/message_content"
 require_relative "zavudev/models/message_list_params"
@@ -136,6 +158,8 @@ require_relative "zavudev/models/message_react_params"
 require_relative "zavudev/models/message_response"
 require_relative "zavudev/models/message_retrieve_params"
 require_relative "zavudev/models/message_send_params"
+require_relative "zavudev/models/message_show_typing_params"
+require_relative "zavudev/models/message_show_typing_response"
 require_relative "zavudev/models/message_status"
 require_relative "zavudev/models/message_type"
 require_relative "zavudev/models/number_10dlc/brand_create_params"
@@ -217,6 +241,8 @@ require_relative "zavudev/models/senders/agent/agent_flow"
 require_relative "zavudev/models/senders/agent/agent_knowledge_base"
 require_relative "zavudev/models/senders/agent/agent_tool"
 require_relative "zavudev/models/senders/agent/execution_list_params"
+require_relative "zavudev/models/senders/agent/execution_retrieve_params"
+require_relative "zavudev/models/senders/agent/execution_retrieve_response"
 require_relative "zavudev/models/senders/agent/flow_create_params"
 require_relative "zavudev/models/senders/agent/flow_create_response"
 require_relative "zavudev/models/senders/agent/flow_delete_params"
@@ -323,8 +349,11 @@ require_relative "zavudev/resources/broadcasts/contacts"
 require_relative "zavudev/resources/contacts"
 require_relative "zavudev/resources/contacts/channels"
 require_relative "zavudev/resources/exports"
+require_relative "zavudev/resources/functions"
+require_relative "zavudev/resources/functions/secrets"
 require_relative "zavudev/resources/introspect"
 require_relative "zavudev/resources/invitations"
+require_relative "zavudev/resources/me"
 require_relative "zavudev/resources/messages"
 require_relative "zavudev/resources/number_10dlc"
 require_relative "zavudev/resources/number_10dlc/brands"

data/rbi/zavudev/client.rbi

@@ -64,6 +64,12 @@ module Zavudev
     sig { returns(Zavudev::Resources::Number10dlc) }
     attr_reader :number_10dlc
 
+    sig { returns(Zavudev::Resources::Me) }
+    attr_reader :me
+
+    sig { returns(Zavudev::Resources::Functions) }
+    attr_reader :functions
+
     # @api private
     sig { override.returns(T::Hash[String, String]) }
     private def auth_headers

data/rbi/zavudev/models/contact_delete_params.rbi

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

data/rbi/zavudev/models/function_create_params.rbi

@@ -0,0 +1,177 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    class FunctionCreateParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Zavudev::FunctionCreateParams, Zavudev::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :name
+
+      # URL-safe identifier (lowercase, digits, hyphens). Must be unique per project.
+      sig { returns(String) }
+      attr_accessor :slug
+
+      # npm dependencies. Keys are package names, values are semver ranges.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :dependencies
+
+      sig { params(dependencies: T::Hash[Symbol, String]).void }
+      attr_writer :dependencies
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :description
+
+      sig { params(description: String).void }
+      attr_writer :description
+
+      # Whether to expose a public HTTPS URL for this function.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :http_enabled
+
+      sig { params(http_enabled: T::Boolean).void }
+      attr_writer :http_enabled
+
+      sig do
+        returns(T.nilable(Zavudev::FunctionCreateParams::MemoryMB::OrInteger))
+      end
+      attr_reader :memory_mb
+
+      sig do
+        params(
+          memory_mb: Zavudev::FunctionCreateParams::MemoryMB::OrInteger
+        ).void
+      end
+      attr_writer :memory_mb
+
+      # Runtime the function is deployed on.
+      sig do
+        returns(T.nilable(Zavudev::FunctionCreateParams::Runtime::OrSymbol))
+      end
+      attr_reader :runtime
+
+      sig do
+        params(runtime: Zavudev::FunctionCreateParams::Runtime::OrSymbol).void
+      end
+      attr_writer :runtime
+
+      # TypeScript source code for the function entry point (max ~900KB).
+      sig { returns(T.nilable(String)) }
+      attr_reader :source_code
+
+      sig { params(source_code: String).void }
+      attr_writer :source_code
+
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :timeout_sec
+
+      sig { params(timeout_sec: Integer).void }
+      attr_writer :timeout_sec
+
+      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(T.attached_class)
+      end
+      def self.new(
+        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
+
+      sig do
+        override.returns(
+          {
+            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
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module MemoryMB
+        extend Zavudev::Internal::Type::Enum
+
+        TaggedInteger =
+          T.type_alias do
+            T.all(Integer, Zavudev::FunctionCreateParams::MemoryMB)
+          end
+        OrInteger = T.type_alias { Integer }
+
+        MEMORY_MB_128 =
+          T.let(128, Zavudev::FunctionCreateParams::MemoryMB::TaggedInteger)
+        MEMORY_MB_256 =
+          T.let(256, Zavudev::FunctionCreateParams::MemoryMB::TaggedInteger)
+        MEMORY_MB_512 =
+          T.let(512, Zavudev::FunctionCreateParams::MemoryMB::TaggedInteger)
+        MEMORY_MB_1024 =
+          T.let(1024, Zavudev::FunctionCreateParams::MemoryMB::TaggedInteger)
+
+        sig do
+          override.returns(
+            T::Array[Zavudev::FunctionCreateParams::MemoryMB::TaggedInteger]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # Runtime the function is deployed on.
+      module Runtime
+        extend Zavudev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Zavudev::FunctionCreateParams::Runtime) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        NODEJS24 =
+          T.let(:nodejs24, Zavudev::FunctionCreateParams::Runtime::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Zavudev::FunctionCreateParams::Runtime::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/models/function_create_response.rbi

@@ -0,0 +1,277 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    class FunctionCreateResponse < Zavudev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Zavudev::Models::FunctionCreateResponse,
+            Zavudev::Internal::AnyHash
+          )
+        end
+
+      # A Zavu Function — user-supplied TypeScript that runs in Zavu Cloud and reacts to
+      # messaging events or HTTP requests.
+      sig { returns(Zavudev::Models::FunctionCreateResponse::Function) }
+      attr_reader :function
+
+      sig do
+        params(
+          function: Zavudev::Models::FunctionCreateResponse::Function::OrHash
+        ).void
+      end
+      attr_writer :function
+
+      sig do
+        params(
+          function: Zavudev::Models::FunctionCreateResponse::Function::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # A Zavu Function — user-supplied TypeScript that runs in Zavu Cloud and reacts to
+        # messaging events or HTTP requests.
+        function:
+      )
+      end
+
+      sig do
+        override.returns(
+          { function: Zavudev::Models::FunctionCreateResponse::Function }
+        )
+      end
+      def to_hash
+      end
+
+      class Function < Zavudev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Zavudev::Models::FunctionCreateResponse::Function,
+              Zavudev::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :id
+
+        sig { returns(Time) }
+        attr_accessor :created_at
+
+        # npm dependencies installed in the function bundle. Keys are package names,
+        # values are semver ranges.
+        sig { returns(T::Hash[Symbol, String]) }
+        attr_accessor :dependencies
+
+        # Whether the function can be invoked over HTTPS via its public URL.
+        sig { returns(T::Boolean) }
+        attr_accessor :http_enabled
+
+        # Memory allocation in MB.
+        sig { returns(Integer) }
+        attr_accessor :memory_mb
+
+        sig { returns(String) }
+        attr_accessor :name
+
+        # Runtime the function is deployed on.
+        sig do
+          returns(
+            Zavudev::Models::FunctionCreateResponse::Function::Runtime::TaggedSymbol
+          )
+        end
+        attr_accessor :runtime
+
+        # URL-safe identifier, unique per project.
+        sig { returns(String) }
+        attr_accessor :slug
+
+        # Lifecycle status of a Zavu Function.
+        sig do
+          returns(
+            Zavudev::Models::FunctionCreateResponse::Function::Status::TaggedSymbol
+          )
+        end
+        attr_accessor :status
+
+        # Per-invocation timeout in seconds.
+        sig { returns(Integer) }
+        attr_accessor :timeout_sec
+
+        sig { returns(Time) }
+        attr_accessor :updated_at
+
+        # ID of the deployment currently serving traffic.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :active_deployment_id
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :description
+
+        # HTTPS endpoint when httpEnabled is true.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :public_url
+
+        # A Zavu Function — user-supplied TypeScript that runs in Zavu Cloud and reacts to
+        # messaging events or HTTP requests.
+        sig do
+          params(
+            id: String,
+            created_at: Time,
+            dependencies: T::Hash[Symbol, String],
+            http_enabled: T::Boolean,
+            memory_mb: Integer,
+            name: String,
+            runtime:
+              Zavudev::Models::FunctionCreateResponse::Function::Runtime::OrSymbol,
+            slug: String,
+            status:
+              Zavudev::Models::FunctionCreateResponse::Function::Status::OrSymbol,
+            timeout_sec: Integer,
+            updated_at: Time,
+            active_deployment_id: T.nilable(String),
+            description: T.nilable(String),
+            public_url: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          id:,
+          created_at:,
+          # npm dependencies installed in the function bundle. Keys are package names,
+          # values are semver ranges.
+          dependencies:,
+          # Whether the function can be invoked over HTTPS via its public URL.
+          http_enabled:,
+          # Memory allocation in MB.
+          memory_mb:,
+          name:,
+          # Runtime the function is deployed on.
+          runtime:,
+          # URL-safe identifier, unique per project.
+          slug:,
+          # Lifecycle status of a Zavu Function.
+          status:,
+          # Per-invocation timeout in seconds.
+          timeout_sec:,
+          updated_at:,
+          # ID of the deployment currently serving traffic.
+          active_deployment_id: nil,
+          description: nil,
+          # HTTPS endpoint when httpEnabled is true.
+          public_url: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Time,
+              dependencies: T::Hash[Symbol, String],
+              http_enabled: T::Boolean,
+              memory_mb: Integer,
+              name: String,
+              runtime:
+                Zavudev::Models::FunctionCreateResponse::Function::Runtime::TaggedSymbol,
+              slug: String,
+              status:
+                Zavudev::Models::FunctionCreateResponse::Function::Status::TaggedSymbol,
+              timeout_sec: Integer,
+              updated_at: Time,
+              active_deployment_id: T.nilable(String),
+              description: T.nilable(String),
+              public_url: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Runtime the function is deployed on.
+        module Runtime
+          extend Zavudev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Zavudev::Models::FunctionCreateResponse::Function::Runtime
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          NODEJS24 =
+            T.let(
+              :nodejs24,
+              Zavudev::Models::FunctionCreateResponse::Function::Runtime::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Zavudev::Models::FunctionCreateResponse::Function::Runtime::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        # Lifecycle status of a Zavu Function.
+        module Status
+          extend Zavudev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Zavudev::Models::FunctionCreateResponse::Function::Status
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          DRAFT =
+            T.let(
+              :draft,
+              Zavudev::Models::FunctionCreateResponse::Function::Status::TaggedSymbol
+            )
+          BUNDLING =
+            T.let(
+              :bundling,
+              Zavudev::Models::FunctionCreateResponse::Function::Status::TaggedSymbol
+            )
+          DEPLOYING =
+            T.let(
+              :deploying,
+              Zavudev::Models::FunctionCreateResponse::Function::Status::TaggedSymbol
+            )
+          ACTIVE =
+            T.let(
+              :active,
+              Zavudev::Models::FunctionCreateResponse::Function::Status::TaggedSymbol
+            )
+          FAILED =
+            T.let(
+              :failed,
+              Zavudev::Models::FunctionCreateResponse::Function::Status::TaggedSymbol
+            )
+          DISABLED =
+            T.let(
+              :disabled,
+              Zavudev::Models::FunctionCreateResponse::Function::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Zavudev::Models::FunctionCreateResponse::Function::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/zavudev/models/function_delete_params.rbi

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

data/rbi/zavudev/models/function_delete_response.rbi

@@ -0,0 +1,44 @@
+# typed: strong
+
+module Zavudev
+  module Models
+    class FunctionDeleteResponse < Zavudev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Zavudev::Models::FunctionDeleteResponse,
+            Zavudev::Internal::AnyHash
+          )
+        end
+
+      sig { returns(T::Boolean) }
+      attr_accessor :deleted
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :name
+
+      sig { params(name: String).void }
+      attr_writer :name
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :slug
+
+      sig { params(slug: String).void }
+      attr_writer :slug
+
+      sig do
+        params(deleted: T::Boolean, name: String, slug: String).returns(
+          T.attached_class
+        )
+      end
+      def self.new(deleted:, name: nil, slug: nil)
+      end
+
+      sig do
+        override.returns({ deleted: T::Boolean, name: String, slug: String })
+      end
+      def to_hash
+      end
+    end
+  end
+end