zavudev 0.10.0 → 0.12.0

data/lib/zavudev/resources/functions.rb

@@ -0,0 +1,220 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Resources
+    class Functions
+      # @return [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.
+      #
+      # @overload create(name:, slug:, dependencies: nil, description: nil, http_enabled: nil, memory_mb: nil, runtime: nil, source_code: nil, timeout_sec: nil, request_options: {})
+      #
+      # @param name [String]
+      #
+      # @param slug [String] URL-safe identifier (lowercase, digits, hyphens). Must be unique per project.
+      #
+      # @param dependencies [Hash{Symbol=>String}] npm dependencies. Keys are package names, values are semver ranges.
+      #
+      # @param description [String]
+      #
+      # @param http_enabled [Boolean] Whether to expose a public HTTPS URL for this function.
+      #
+      # @param memory_mb [Integer, Zavudev::Models::FunctionCreateParams::MemoryMB]
+      #
+      # @param runtime [Symbol, Zavudev::Models::FunctionCreateParams::Runtime] Runtime the function is deployed on.
+      #
+      # @param source_code [String] TypeScript source code for the function entry point (max ~900KB).
+      #
+      # @param timeout_sec [Integer]
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionCreateResponse]
+      #
+      # @see Zavudev::Models::FunctionCreateParams
+      def create(params)
+        parsed, options = Zavudev::FunctionCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/functions",
+          body: parsed,
+          model: Zavudev::Models::FunctionCreateResponse,
+          options: options
+        )
+      end
+
+      # Get function
+      #
+      # @overload retrieve(function_id, request_options: {})
+      #
+      # @param function_id [String] Zavu Function ID.
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionRetrieveResponse]
+      #
+      # @see Zavudev::Models::FunctionRetrieveParams
+      def retrieve(function_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/functions/%1$s", function_id],
+          model: Zavudev::Models::FunctionRetrieveResponse,
+          options: params[: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.
+      #
+      # @overload update(function_id, dependencies: nil, source_code: nil, request_options: {})
+      #
+      # @param function_id [String] Zavu Function ID.
+      #
+      # @param dependencies [Hash{Symbol=>String}] New dependency map (replaces existing dependencies).
+      #
+      # @param source_code [String] New source code to publish (replaces the draft).
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionUpdateResponse]
+      #
+      # @see Zavudev::Models::FunctionUpdateParams
+      def update(function_id, params = {})
+        parsed, options = Zavudev::FunctionUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["v1/functions/%1$s", function_id],
+          body: parsed,
+          model: Zavudev::Models::FunctionUpdateResponse,
+          options: 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.
+      #
+      # @overload delete(function_id, request_options: {})
+      #
+      # @param function_id [String] Zavu Function ID.
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionDeleteResponse]
+      #
+      # @see Zavudev::Models::FunctionDeleteParams
+      def delete(function_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["v1/functions/%1$s", function_id],
+          model: Zavudev::Models::FunctionDeleteResponse,
+          options: params[: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`.
+      #
+      # @overload deploy(function_id, dependencies: nil, source_code: nil, request_options: {})
+      #
+      # @param function_id [String] Zavu Function ID.
+      #
+      # @param dependencies [Hash{Symbol=>String}] New dependency map (replaces existing dependencies).
+      #
+      # @param source_code [String] New source code to publish (replaces the draft).
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionDeployResponse]
+      #
+      # @see Zavudev::Models::FunctionDeployParams
+      def deploy(function_id, params = {})
+        parsed, options = Zavudev::FunctionDeployParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/functions/%1$s/deploy", function_id],
+          body: parsed,
+          model: Zavudev::Models::FunctionDeployResponse,
+          options: options
+        )
+      end
+
+      # Fetch a deployment to poll its status during a deploy.
+      #
+      # @overload get_deployment(deployment_id, request_options: {})
+      #
+      # @param deployment_id [String] Function deployment ID.
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionGetDeploymentResponse]
+      #
+      # @see Zavudev::Models::FunctionGetDeploymentParams
+      def get_deployment(deployment_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/functions/deployments/%1$s", deployment_id],
+          model: Zavudev::Models::FunctionGetDeploymentResponse,
+          options: params[: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.
+      #
+      # @overload tail_logs(function_id, end_time: nil, filter_pattern: nil, limit: nil, next_token: nil, start_time: nil, request_options: {})
+      #
+      # @param function_id [String] Zavu Function ID.
+      #
+      # @param end_time [Integer] End of the log window in Unix epoch milliseconds.
+      #
+      # @param filter_pattern [String]
+      #
+      # @param limit [Integer]
+      #
+      # @param next_token [String]
+      #
+      # @param start_time [Integer] Start of the log window in Unix epoch milliseconds.
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionTailLogsResponse]
+      #
+      # @see Zavudev::Models::FunctionTailLogsParams
+      def tail_logs(function_id, params = {})
+        parsed, options = Zavudev::FunctionTailLogsParams.dump_request(params)
+        query = Zavudev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["v1/functions/%1$s/logs", function_id],
+          query: query.transform_keys(
+            end_time: "endTime",
+            filter_pattern: "filterPattern",
+            next_token: "nextToken",
+            start_time: "startTime"
+          ),
+          model: Zavudev::Models::FunctionTailLogsResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Zavudev::Client]
+      def initialize(client:)
+        @client = client
+        @secrets = Zavudev::Resources::Functions::Secrets.new(client: client)
+      end
+    end
+  end
+end

data/lib/zavudev/resources/me.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+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.
+      #
+      # @overload retrieve(request_options: {})
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::MeRetrieveResponse]
+      #
+      # @see Zavudev::Models::MeRetrieveParams
+      def retrieve(params = {})
+        @client.request(
+          method: :get,
+          path: "v1/me",
+          model: Zavudev::Models::MeRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Zavudev::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/zavudev/resources/messages.rb

@@ -155,6 +155,37 @@ module Zavudev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Zavudev::Models::MessageShowTypingParams} for more details.
+      #
+      # 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.
+      #
+      # @overload show_typing(message_id, zavu_sender: nil, request_options: {})
+      #
+      # @param message_id [String]
+      #
+      # @param zavu_sender [String] Optional sender profile ID. If omitted, the project's default sender will be use
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::MessageShowTypingResponse]
+      #
+      # @see Zavudev::Models::MessageShowTypingParams
+      def show_typing(message_id, params = {})
+        parsed, options = Zavudev::MessageShowTypingParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/messages/%1$s/typing", message_id],
+          headers: parsed.transform_keys(zavu_sender: "zavu-sender"),
+          model: Zavudev::Models::MessageShowTypingResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [Zavudev::Client]

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.10.0"
+  VERSION = "0.12.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/broadcast_contact.rbi

@@ -58,6 +58,12 @@ module Zavudev
       sig { params(template_button_variables: T::Hash[Symbol, String]).void }
       attr_writer :template_button_variables
 
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :template_header_variables
+
+      sig { params(template_header_variables: T::Hash[Symbol, String]).void }
+      attr_writer :template_header_variables
+
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
       attr_reader :template_variables
 
@@ -77,6 +83,7 @@ module Zavudev
           message_id: String,
           processed_at: Time,
           template_button_variables: T::Hash[Symbol, String],
+          template_header_variables: T::Hash[Symbol, String],
           template_variables: T::Hash[Symbol, String]
         ).returns(T.attached_class)
       end
@@ -94,6 +101,7 @@ module Zavudev
         message_id: nil,
         processed_at: nil,
         template_button_variables: nil,
+        template_header_variables: nil,
         template_variables: nil
       )
       end
@@ -113,6 +121,7 @@ module Zavudev
             message_id: String,
             processed_at: Time,
             template_button_variables: T::Hash[Symbol, String],
+            template_header_variables: T::Hash[Symbol, String],
             template_variables: T::Hash[Symbol, String]
           }
         )

data/rbi/zavudev/models/broadcast_content.rbi

@@ -44,6 +44,15 @@ module Zavudev
       sig { params(template_button_variables: T::Hash[Symbol, String]).void }
       attr_writer :template_button_variables
 
+      # Default value for a text-header variable, keyed by `1` (can be overridden per
+      # contact). If omitted, Zavu resolves the header from `templateVariables` by the
+      # header placeholder's name.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :template_header_variables
+
+      sig { params(template_header_variables: T::Hash[Symbol, String]).void }
+      attr_writer :template_header_variables
+
       # Template ID for template messages.
       sig { returns(T.nilable(String)) }
       attr_reader :template_id
@@ -51,8 +60,10 @@ module Zavudev
       sig { params(template_id: String).void }
       attr_writer :template_id
 
-      # Default body variables (can be overridden per contact). Keys are positions (1,
-      # 2, ...).
+      # Default body variables (can be overridden per contact). Key them to match the
+      # template body: by position (`1`, `2`, ...) for positional templates, or by name
+      # (e.g. `customer_name`) for named templates. Zavu detects the template's format
+      # and sends the correct payload to Meta. Do not mix positional and named keys.
       sig { returns(T.nilable(T::Hash[Symbol, String])) }
       attr_reader :template_variables
 
@@ -67,6 +78,7 @@ module Zavudev
           media_url: String,
           mime_type: String,
           template_button_variables: T::Hash[Symbol, String],
+          template_header_variables: T::Hash[Symbol, String],
           template_id: String,
           template_variables: T::Hash[Symbol, String]
         ).returns(T.attached_class)
@@ -83,10 +95,16 @@ module Zavudev
         # Default button variables for dynamic URL/OTP buttons. Keys are the button index
         # (0, 1, 2). Per-contact values override these.
         template_button_variables: nil,
+        # Default value for a text-header variable, keyed by `1` (can be overridden per
+        # contact). If omitted, Zavu resolves the header from `templateVariables` by the
+        # header placeholder's name.
+        template_header_variables: nil,
         # Template ID for template messages.
         template_id: nil,
-        # Default body variables (can be overridden per contact). Keys are positions (1,
-        # 2, ...).
+        # Default body variables (can be overridden per contact). Key them to match the
+        # template body: by position (`1`, `2`, ...) for positional templates, or by name
+        # (e.g. `customer_name`) for named templates. Zavu detects the template's format
+        # and sends the correct payload to Meta. Do not mix positional and named keys.
         template_variables: nil
       )
       end
@@ -99,6 +117,7 @@ module Zavudev
             media_url: String,
             mime_type: String,
             template_button_variables: T::Hash[Symbol, String],
+            template_header_variables: T::Hash[Symbol, String],
             template_id: String,
             template_variables: T::Hash[Symbol, String]
           }

data/rbi/zavudev/models/broadcasts/contact_add_params.rbi

@@ -76,8 +76,20 @@ module Zavudev
           end
           attr_writer :template_button_variables
 
-          # Per-contact body variables. Keys are positions (1, 2, ...) matching the order
-          # placeholders appear in the template body.
+          # Per-contact value for a text-header variable, keyed by `1`. If omitted, Zavu
+          # resolves the header from `templateVariables` by the header placeholder's name.
+          sig { returns(T.nilable(T::Hash[Symbol, String])) }
+          attr_reader :template_header_variables
+
+          sig do
+            params(template_header_variables: T::Hash[Symbol, String]).void
+          end
+          attr_writer :template_header_variables
+
+          # Per-contact body variables. Key them to match the template body: by position
+          # (`1`, `2`, ...) for positional templates, or by name (e.g. `customer_name`) for
+          # named templates. Zavu detects the template's format and sends the correct
+          # payload to Meta. Do not mix positional and named keys.
           sig { returns(T.nilable(T::Hash[Symbol, String])) }
           attr_reader :template_variables
 
@@ -88,6 +100,7 @@ module Zavudev
             params(
               recipient: String,
               template_button_variables: T::Hash[Symbol, String],
+              template_header_variables: T::Hash[Symbol, String],
               template_variables: T::Hash[Symbol, String]
             ).returns(T.attached_class)
           end
@@ -97,8 +110,13 @@ module Zavudev
             # Per-contact button variables for dynamic URL/OTP buttons. Keys are the button
             # index (0, 1, 2).
             template_button_variables: nil,
-            # Per-contact body variables. Keys are positions (1, 2, ...) matching the order
-            # placeholders appear in the template body.
+            # Per-contact value for a text-header variable, keyed by `1`. If omitted, Zavu
+            # resolves the header from `templateVariables` by the header placeholder's name.
+            template_header_variables: nil,
+            # Per-contact body variables. Key them to match the template body: by position
+            # (`1`, `2`, ...) for positional templates, or by name (e.g. `customer_name`) for
+            # named templates. Zavu detects the template's format and sends the correct
+            # payload to Meta. Do not mix positional and named keys.
             template_variables: nil
           )
           end
@@ -108,6 +126,7 @@ module Zavudev
               {
                 recipient: String,
                 template_button_variables: T::Hash[Symbol, String],
+                template_header_variables: T::Hash[Symbol, String],
                 template_variables: T::Hash[Symbol, String]
               }
             )

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