zavudev 0.18.0 → 0.20.0

data/lib/zavudev/resources/phone_numbers.rb

@@ -76,8 +76,12 @@ module Zavudev
         )
       end
 
-      # Purchase an available phone number. The first US phone number is free for each
-      # team.
+      # Purchase an available phone number. Requires a paid plan: the Free plan cannot
+      # purchase phone numbers and receives `402` with code `paid_plan_required`. Paid
+      # plans include one US number at no charge. The included number is one per account
+      # and is granted once: claiming it spends the benefit for good, so releasing that
+      # number does not make another one free, and numbers the account already bought do
+      # not consume it.
       #
       # @overload purchase(phone_number:, name: nil, request_options: {})
       #
@@ -147,12 +151,17 @@ module Zavudev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Zavudev::Models::PhoneNumberSearchAvailableParams} for more details.
+      #
       # Search for available phone numbers to purchase by country and type.
       #
-      # @overload search_available(country_code:, contains: nil, limit: nil, type: nil, request_options: {})
+      # @overload search_available(country_code:, capabilities: nil, contains: nil, limit: nil, type: nil, request_options: {})
       #
       # @param country_code [String] Two-letter ISO country code.
       #
+      # @param capabilities [String] Comma-separated capabilities the number must have: `sms`, `voice`, `mms`. Number
+      #
       # @param contains [String] Search for numbers containing this string.
       #
       # @param limit [Integer] Maximum number of results to return.

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

@@ -33,6 +33,11 @@ module Zavudev
 
           # List recent agent executions with pagination.
           #
+          # An execution is one inbound message answered by the agent, so this covers the
+          # messaging channels only. Voice calls are never listed here regardless of how
+          # many the agent handled. Use `GET /v1/calls` (and `GET /v1/calls/{callId}` for
+          # the transcript) for voice.
+          #
           # @overload list(sender_id, cursor: nil, limit: nil, status: nil, request_options: {})
           #
           # @param sender_id [String]

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

@@ -5,6 +5,9 @@ module Zavudev
     class Senders
       class Agent
         class Tools
+          # Some parameter documentations has been truncated, see
+          # {Zavudev::Models::Senders::Agent::ToolCreateParams} for more details.
+          #
           # Create a new tool for an agent. Tools allow the agent to call external webhooks.
           #
           # @overload create(sender_id, description:, name:, parameters:, webhook_url:, enabled: nil, webhook_secret: nil, request_options: {})
@@ -21,7 +24,7 @@ module Zavudev
           #
           # @param enabled [Boolean]
           #
-          # @param webhook_secret [String] Optional secret for webhook signature verification.
+          # @param webhook_secret [String] Signing secret for the webhook. Optional: Zavu generates one when omitted and re
           #
           # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -155,7 +158,16 @@ module Zavudev
             )
           end
 
-          # Test a tool by triggering its webhook with test parameters.
+          # Run a tool with the parameters you supply and return what it answered.
+          #
+          # The call is synchronous: the response carries the tool's status, body, and
+          # duration, so a green result is evidence the tool ran rather than evidence it was
+          # accepted. Each run is also recorded and readable afterwards via
+          # `GET /v1/senders/{senderId}/agent/tools/{toolId}/test-runs`.
+          #
+          # A tool that answers with an error is reported as a run with `success: false` —
+          # the endpoint itself still returns 200. This fires the tool's real webhook, so a
+          # test has whatever side effects the tool has.
           #
           # @overload test_(tool_id, sender_id:, test_params:, request_options: {})
           #

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

@@ -16,9 +16,12 @@ module Zavudev
         # @return [Zavudev::Resources::Senders::Agent::KnowledgeBases]
         attr_reader :knowledge_bases
 
+        # Some parameter documentations has been truncated, see
+        # {Zavudev::Models::Senders::AgentCreateParams} for more details.
+        #
         # Create an AI agent for a sender. Each sender can have at most one agent.
         #
-        # @overload create(sender_id, model:, name:, provider:, system_prompt:, api_key: nil, context_window_messages: nil, include_contact_metadata: nil, max_tokens: nil, temperature: nil, trigger_on_channels: nil, trigger_on_message_types: nil, request_options: {})
+        # @overload create(sender_id, model:, name:, provider:, system_prompt:, api_key: nil, context_window_messages: nil, include_contact_metadata: nil, max_tokens: nil, temperature: nil, trigger_on_channels: nil, trigger_on_message_types: nil, voice: nil, request_options: {})
         #
         # @param sender_id [String]
         #
@@ -44,6 +47,8 @@ module Zavudev
         #
         # @param trigger_on_message_types [Array<String>]
         #
+        # @param voice [Zavudev::Models::Senders::AgentCreateParams::Voice] Voice Agent configuration. Enable this to let the agent answer and place phone c
+        #
         # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Zavudev::Models::Senders::AgentResponse]
@@ -79,9 +84,12 @@ module Zavudev
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Zavudev::Models::Senders::AgentUpdateParams} for more details.
+        #
         # Update an AI agent's configuration.
         #
-        # @overload update(sender_id, api_key: nil, context_window_messages: nil, enabled: nil, include_contact_metadata: nil, max_tokens: nil, model: nil, name: nil, provider: nil, system_prompt: nil, temperature: nil, trigger_on_channels: nil, trigger_on_message_types: nil, request_options: {})
+        # @overload update(sender_id, api_key: nil, context_window_messages: nil, enabled: nil, include_contact_metadata: nil, max_tokens: nil, model: nil, name: nil, provider: nil, system_prompt: nil, temperature: nil, trigger_on_channels: nil, trigger_on_message_types: nil, voice: nil, request_options: {})
         #
         # @param sender_id [String]
         #
@@ -109,6 +117,8 @@ module Zavudev
         #
         # @param trigger_on_message_types [Array<String>]
         #
+        # @param voice [Zavudev::Models::Senders::AgentUpdateParams::Voice] Voice Agent configuration. Patch this object to enable voice, change the greetin
+        #
         # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Zavudev::Models::Senders::AgentResponse]
@@ -146,6 +156,12 @@ module Zavudev
 
         # Get statistics for an AI agent including invocations, tokens, and costs.
         #
+        # Covers the messaging channels only. Voice calls are not counted here: a call is
+        # a multi-turn conversation rather than one inbound message and one reply, so it
+        # is recorded as a call, not an execution. An agent that only answers phone calls
+        # reports zeros on every field. Use `GET /v1/calls` for voice activity, duration,
+        # and cost.
+        #
         # @overload stats(sender_id, request_options: {})
         #
         # @param sender_id [String]

data/lib/zavudev/resources/senders.rb

@@ -14,7 +14,7 @@ module Zavudev
       #
       # Create sender
       #
-      # @overload create(name:, email_address: nil, email_domain_id: nil, email_from_name: nil, email_receiving_enabled: nil, phone_number: nil, set_as_default: nil, webhook_events: nil, webhook_url: nil, request_options: {})
+      # @overload create(name:, email_address: nil, email_domain_id: nil, email_from_name: nil, email_receiving_enabled: nil, enable_sms_oneway: nil, enable_voice: nil, phone_number: nil, set_as_default: nil, webhook_events: nil, webhook_signature_version: nil, webhook_url: nil, request_options: {})
       #
       # @param name [String]
       #
@@ -26,12 +26,18 @@ module Zavudev
       #
       # @param email_receiving_enabled [Boolean] Enable inbound email receiving on this sender. Requires a verified MX record on
       #
-      # @param phone_number [String] Phone number in E.164 format. Required for phone-based channels (SMS, WhatsApp).
+      # @param enable_sms_oneway [Boolean] Enable the one-way SMS channel (`sms_oneway`). Needs nothing else — no phone num
+      #
+      # @param enable_voice [Boolean] Let this sender place and answer phone calls. Requires `phoneNumber`; enabling i
+      #
+      # @param phone_number [String] Phone number in E.164 format, and it must be a number your project already owns
       #
       # @param set_as_default [Boolean]
       #
       # @param webhook_events [Array<Symbol, Zavudev::Models::WebhookEvent>] Events to subscribe to.
       #
+      # @param webhook_signature_version [Symbol, Zavudev::Models::SenderCreateParams::WebhookSignatureVersion] Which `X-Zavu-Signature` scheme this receiver is sent.
+      #
       # @param webhook_url [String] HTTPS URL for webhook events.
       #
       # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -74,7 +80,7 @@ module Zavudev
       #
       # Update sender
       #
-      # @overload update(sender_id, email_address: nil, email_catch_all_enabled: nil, email_domain_id: nil, email_from_name: nil, email_receiving_enabled: nil, name: nil, set_as_default: nil, webhook_active: nil, webhook_events: nil, webhook_url: nil, request_options: {})
+      # @overload update(sender_id, email_address: nil, email_catch_all_enabled: nil, email_domain_id: nil, email_from_name: nil, email_receiving_enabled: nil, enable_sms_oneway: nil, enable_voice: nil, name: nil, set_as_default: nil, webhook_active: nil, webhook_events: nil, webhook_signature_version: nil, webhook_url: nil, request_options: {})
       #
       # @param sender_id [String]
       #
@@ -88,6 +94,10 @@ module Zavudev
       #
       # @param email_receiving_enabled [Boolean] Enable or disable inbound email receiving for this sender.
       #
+      # @param enable_sms_oneway [Boolean] Turn the one-way SMS channel on or off. Enabling needs nothing else and takes ef
+      #
+      # @param enable_voice [Boolean] Turn the voice channel on or off. The sender must already have a phone number pr
+      #
       # @param name [String]
       #
       # @param set_as_default [Boolean]
@@ -96,6 +106,8 @@ module Zavudev
       #
       # @param webhook_events [Array<Symbol, Zavudev::Models::WebhookEvent>] Events to subscribe to.
       #
+      # @param webhook_signature_version [Symbol, Zavudev::Models::SenderUpdateParams::WebhookSignatureVersion] Which `X-Zavu-Signature` scheme this receiver is sent.
+      #
       # @param webhook_url [String, nil] HTTPS URL for webhook events. Set to null to remove webhook.
       #
       # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/zavudev/version.rb

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

data/rbi/zavudev/models/channel.rbi

@@ -2,10 +2,7 @@
 
 module Zavudev
   module Models
-    # Delivery channel. Use 'auto' for intelligent routing. `whatsapp_alt` is the
-    # QR-linked WhatsApp channel and is only accepted for teams with the WhatsApp
-    # Alternative feature enabled; the sender must have a connected whatsapp_alt
-    # session.
+    # Delivery channel. Use 'auto' for intelligent routing.
     module Channel
       extend Zavudev::Internal::Type::Enum
 
@@ -16,7 +13,6 @@ module Zavudev
       SMS = T.let(:sms, Zavudev::Channel::TaggedSymbol)
       SMS_ONEWAY = T.let(:sms_oneway, Zavudev::Channel::TaggedSymbol)
       WHATSAPP = T.let(:whatsapp, Zavudev::Channel::TaggedSymbol)
-      WHATSAPP_ALT = T.let(:whatsapp_alt, Zavudev::Channel::TaggedSymbol)
       TELEGRAM = T.let(:telegram, Zavudev::Channel::TaggedSymbol)
       EMAIL = T.let(:email, Zavudev::Channel::TaggedSymbol)
       INSTAGRAM = T.let(:instagram, Zavudev::Channel::TaggedSymbol)

data/rbi/zavudev/models/function_create_params.rbi

@@ -31,6 +31,27 @@ module Zavudev
       sig { params(description: String).void }
       attr_writer :description
 
+      # Which file in `files` is the entry point. Defaults to `index.ts`.
+      sig { returns(T.nilable(String)) }
+      attr_reader :entrypoint
+
+      sig { params(entrypoint: String).void }
+      attr_writer :entrypoint
+
+      # The project's source files, keyed by path relative to the project root (e.g.
+      # `index.ts`, `lib/orders.ts`). Imports between them are resolved when the
+      # function is built, so a function can be split across as many files as it needs.
+      #
+      # Paths must be relative and use forward slashes; `..`, `node_modules/` and
+      # `package.json` are rejected. npm packages are not uploaded here — declare them
+      # under `dependencies` and Zavu installs them. Limits: 200 files and 900,000 bytes
+      # for the whole tree.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :files
+
+      sig { params(files: T::Hash[Symbol, String]).void }
+      attr_writer :files
+
       # Whether to expose a public HTTPS URL for this function.
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :http_enabled
@@ -61,13 +82,19 @@ module Zavudev
       end
       attr_writer :runtime
 
-      # TypeScript source code for the function entry point (max ~900KB).
+      # Shortcut for a single-file function: exactly equivalent to sending `files` with
+      # one entry named after `entrypoint` (`index.ts` by default). Fully supported —
+      # use whichever fits. If both are sent, `files` wins.
       sig { returns(T.nilable(String)) }
       attr_reader :source_code
 
       sig { params(source_code: String).void }
       attr_writer :source_code
 
+      # Per-invocation timeout in seconds. Event and cron invocations are asynchronous,
+      # so a long timeout only bounds cost; a tool called during a live conversation
+      # holds up the reply, and a function exposed over HTTP is additionally bounded by
+      # the platform's HTTP response limit.
       sig { returns(T.nilable(Integer)) }
       attr_reader :timeout_sec
 
@@ -80,6 +107,8 @@ module Zavudev
           slug: String,
           dependencies: T::Hash[Symbol, String],
           description: String,
+          entrypoint: String,
+          files: T::Hash[Symbol, String],
           http_enabled: T::Boolean,
           memory_mb: Zavudev::FunctionCreateParams::MemoryMB::OrInteger,
           runtime: Zavudev::FunctionCreateParams::Runtime::OrSymbol,
@@ -95,13 +124,30 @@ module Zavudev
         # npm dependencies. Keys are package names, values are semver ranges.
         dependencies: nil,
         description: nil,
+        # Which file in `files` is the entry point. Defaults to `index.ts`.
+        entrypoint: nil,
+        # The project's source files, keyed by path relative to the project root (e.g.
+        # `index.ts`, `lib/orders.ts`). Imports between them are resolved when the
+        # function is built, so a function can be split across as many files as it needs.
+        #
+        # Paths must be relative and use forward slashes; `..`, `node_modules/` and
+        # `package.json` are rejected. npm packages are not uploaded here — declare them
+        # under `dependencies` and Zavu installs them. Limits: 200 files and 900,000 bytes
+        # for the whole tree.
+        files: 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).
+        # Shortcut for a single-file function: exactly equivalent to sending `files` with
+        # one entry named after `entrypoint` (`index.ts` by default). Fully supported —
+        # use whichever fits. If both are sent, `files` wins.
         source_code: nil,
+        # Per-invocation timeout in seconds. Event and cron invocations are asynchronous,
+        # so a long timeout only bounds cost; a tool called during a live conversation
+        # holds up the reply, and a function exposed over HTTP is additionally bounded by
+        # the platform's HTTP response limit.
         timeout_sec: nil,
         request_options: {}
       )
@@ -114,6 +160,8 @@ module Zavudev
             slug: String,
             dependencies: T::Hash[Symbol, String],
             description: String,
+            entrypoint: String,
+            files: T::Hash[Symbol, String],
             http_enabled: T::Boolean,
             memory_mb: Zavudev::FunctionCreateParams::MemoryMB::OrInteger,
             runtime: Zavudev::FunctionCreateParams::Runtime::OrSymbol,

data/rbi/zavudev/models/function_create_response.rbi

@@ -108,7 +108,9 @@ module Zavudev
         sig { returns(T.nilable(String)) }
         attr_accessor :description
 
-        # HTTPS endpoint when httpEnabled is true.
+        # HTTPS endpoint, present only while httpEnabled is true. Null otherwise,
+        # including for a function that was previously exposed — the stored URL stops
+        # serving the moment HTTP is turned off, so it is never returned.
         sig { returns(T.nilable(String)) }
         attr_accessor :public_url
 
@@ -157,7 +159,9 @@ module Zavudev
           # ID of the deployment currently serving traffic.
           active_deployment_id: nil,
           description: nil,
-          # HTTPS endpoint when httpEnabled is true.
+          # HTTPS endpoint, present only while httpEnabled is true. Null otherwise,
+          # including for a function that was previously exposed — the stored URL stops
+          # serving the moment HTTP is turned off, so it is never returned.
           public_url: nil
         )
         end

data/rbi/zavudev/models/function_deploy_params.rbi

@@ -21,7 +21,30 @@ module Zavudev
       sig { params(dependencies: T::Hash[Symbol, String]).void }
       attr_writer :dependencies
 
-      # New source code to publish (replaces the draft).
+      # Which file in `files` is the entry point. Defaults to `index.ts`.
+      sig { returns(T.nilable(String)) }
+      attr_reader :entrypoint
+
+      sig { params(entrypoint: String).void }
+      attr_writer :entrypoint
+
+      # The project's source files, keyed by path relative to the project root (e.g.
+      # `index.ts`, `lib/orders.ts`). Imports between them are resolved when the
+      # function is built, so a function can be split across as many files as it needs.
+      #
+      # Paths must be relative and use forward slashes; `..`, `node_modules/` and
+      # `package.json` are rejected. npm packages are not uploaded here — declare them
+      # under `dependencies` and Zavu installs them. Limits: 200 files and 900,000 bytes
+      # for the whole tree.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :files
+
+      sig { params(files: T::Hash[Symbol, String]).void }
+      attr_writer :files
+
+      # Shortcut for a single-file function: exactly equivalent to sending `files` with
+      # one entry named after `entrypoint` (`index.ts` by default). Fully supported —
+      # use whichever fits. If both are sent, `files` wins.
       sig { returns(T.nilable(String)) }
       attr_reader :source_code
 
@@ -32,6 +55,8 @@ module Zavudev
         params(
           function_id: String,
           dependencies: T::Hash[Symbol, String],
+          entrypoint: String,
+          files: T::Hash[Symbol, String],
           source_code: String,
           request_options: Zavudev::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -40,7 +65,20 @@ module Zavudev
         function_id:,
         # New dependency map (replaces existing dependencies).
         dependencies: nil,
-        # New source code to publish (replaces the draft).
+        # Which file in `files` is the entry point. Defaults to `index.ts`.
+        entrypoint: nil,
+        # The project's source files, keyed by path relative to the project root (e.g.
+        # `index.ts`, `lib/orders.ts`). Imports between them are resolved when the
+        # function is built, so a function can be split across as many files as it needs.
+        #
+        # Paths must be relative and use forward slashes; `..`, `node_modules/` and
+        # `package.json` are rejected. npm packages are not uploaded here — declare them
+        # under `dependencies` and Zavu installs them. Limits: 200 files and 900,000 bytes
+        # for the whole tree.
+        files: nil,
+        # Shortcut for a single-file function: exactly equivalent to sending `files` with
+        # one entry named after `entrypoint` (`index.ts` by default). Fully supported —
+        # use whichever fits. If both are sent, `files` wins.
         source_code: nil,
         request_options: {}
       )
@@ -51,6 +89,8 @@ module Zavudev
           {
             function_id: String,
             dependencies: T::Hash[Symbol, String],
+            entrypoint: String,
+            files: T::Hash[Symbol, String],
             source_code: String,
             request_options: Zavudev::RequestOptions
           }

data/rbi/zavudev/models/function_deploy_response.rbi

@@ -69,6 +69,15 @@ module Zavudev
         sig { returns(Integer) }
         attr_accessor :version
 
+        # What the build printed: dependency installation, the bundler's output, and the
+        # compiler's message when it failed. Returned when fetching a single deployment,
+        # omitted from the list. Read this first when a deploy fails — `errorMessage` is
+        # often the outer wrapper's summary, and the line that names the broken import or
+        # the syntax error is here.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :build_logs
+
+        # Size of the built bundle in bytes. Null until the build finishes.
         sig { returns(T.nilable(Integer)) }
         attr_accessor :bundle_bytes
 
@@ -79,6 +88,7 @@ module Zavudev
         sig { returns(T.nilable(String)) }
         attr_accessor :error_message
 
+        # Total size of the deployed source tree in bytes.
         sig { returns(T.nilable(Integer)) }
         attr_accessor :source_code_bytes
 
@@ -90,6 +100,7 @@ module Zavudev
             status:
               Zavudev::Models::FunctionDeployResponse::Deployment::Status::OrSymbol,
             version: Integer,
+            build_logs: T.nilable(String),
             bundle_bytes: T.nilable(Integer),
             deployed_at: T.nilable(Time),
             error_message: T.nilable(String),
@@ -104,10 +115,18 @@ module Zavudev
           status:,
           # Monotonically increasing deployment version, starting at 1.
           version:,
+          # What the build printed: dependency installation, the bundler's output, and the
+          # compiler's message when it failed. Returned when fetching a single deployment,
+          # omitted from the list. Read this first when a deploy fails — `errorMessage` is
+          # often the outer wrapper's summary, and the line that names the broken import or
+          # the syntax error is here.
+          build_logs: nil,
+          # Size of the built bundle in bytes. Null until the build finishes.
           bundle_bytes: nil,
           deployed_at: nil,
           # Failure reason when status is 'failed'.
           error_message: nil,
+          # Total size of the deployed source tree in bytes.
           source_code_bytes: nil
         )
         end
@@ -121,6 +140,7 @@ module Zavudev
               status:
                 Zavudev::Models::FunctionDeployResponse::Deployment::Status::TaggedSymbol,
               version: Integer,
+              build_logs: T.nilable(String),
               bundle_bytes: T.nilable(Integer),
               deployed_at: T.nilable(Time),
               error_message: T.nilable(String),

data/rbi/zavudev/models/function_get_deployment_response.rbi

@@ -74,6 +74,15 @@ module Zavudev
         sig { returns(Integer) }
         attr_accessor :version
 
+        # What the build printed: dependency installation, the bundler's output, and the
+        # compiler's message when it failed. Returned when fetching a single deployment,
+        # omitted from the list. Read this first when a deploy fails — `errorMessage` is
+        # often the outer wrapper's summary, and the line that names the broken import or
+        # the syntax error is here.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :build_logs
+
+        # Size of the built bundle in bytes. Null until the build finishes.
         sig { returns(T.nilable(Integer)) }
         attr_accessor :bundle_bytes
 
@@ -84,6 +93,7 @@ module Zavudev
         sig { returns(T.nilable(String)) }
         attr_accessor :error_message
 
+        # Total size of the deployed source tree in bytes.
         sig { returns(T.nilable(Integer)) }
         attr_accessor :source_code_bytes
 
@@ -95,6 +105,7 @@ module Zavudev
             status:
               Zavudev::Models::FunctionGetDeploymentResponse::Deployment::Status::OrSymbol,
             version: Integer,
+            build_logs: T.nilable(String),
             bundle_bytes: T.nilable(Integer),
             deployed_at: T.nilable(Time),
             error_message: T.nilable(String),
@@ -109,10 +120,18 @@ module Zavudev
           status:,
           # Monotonically increasing deployment version, starting at 1.
           version:,
+          # What the build printed: dependency installation, the bundler's output, and the
+          # compiler's message when it failed. Returned when fetching a single deployment,
+          # omitted from the list. Read this first when a deploy fails — `errorMessage` is
+          # often the outer wrapper's summary, and the line that names the broken import or
+          # the syntax error is here.
+          build_logs: nil,
+          # Size of the built bundle in bytes. Null until the build finishes.
           bundle_bytes: nil,
           deployed_at: nil,
           # Failure reason when status is 'failed'.
           error_message: nil,
+          # Total size of the deployed source tree in bytes.
           source_code_bytes: nil
         )
         end
@@ -126,6 +145,7 @@ module Zavudev
               status:
                 Zavudev::Models::FunctionGetDeploymentResponse::Deployment::Status::TaggedSymbol,
               version: Integer,
+              build_logs: T.nilable(String),
               bundle_bytes: T.nilable(Integer),
               deployed_at: T.nilable(Time),
               error_message: T.nilable(String),

data/rbi/zavudev/models/function_retrieve_response.rbi

@@ -108,7 +108,9 @@ module Zavudev
         sig { returns(T.nilable(String)) }
         attr_accessor :description
 
-        # HTTPS endpoint when httpEnabled is true.
+        # HTTPS endpoint, present only while httpEnabled is true. Null otherwise,
+        # including for a function that was previously exposed — the stored URL stops
+        # serving the moment HTTP is turned off, so it is never returned.
         sig { returns(T.nilable(String)) }
         attr_accessor :public_url
 
@@ -157,7 +159,9 @@ module Zavudev
           # ID of the deployment currently serving traffic.
           active_deployment_id: nil,
           description: nil,
-          # HTTPS endpoint when httpEnabled is true.
+          # HTTPS endpoint, present only while httpEnabled is true. Null otherwise,
+          # including for a function that was previously exposed — the stored URL stops
+          # serving the moment HTTP is turned off, so it is never returned.
           public_url: nil
         )
         end

data/rbi/zavudev/models/function_update_params.rbi

@@ -21,7 +21,39 @@ module Zavudev
       sig { params(dependencies: T::Hash[Symbol, String]).void }
       attr_writer :dependencies
 
-      # New source code to publish (replaces the draft).
+      # Which file in `files` is the entry point. Defaults to `index.ts`.
+      sig { returns(T.nilable(String)) }
+      attr_reader :entrypoint
+
+      sig { params(entrypoint: String).void }
+      attr_writer :entrypoint
+
+      # The project's source files, keyed by path relative to the project root (e.g.
+      # `index.ts`, `lib/orders.ts`). Imports between them are resolved when the
+      # function is built, so a function can be split across as many files as it needs.
+      #
+      # Paths must be relative and use forward slashes; `..`, `node_modules/` and
+      # `package.json` are rejected. npm packages are not uploaded here — declare them
+      # under `dependencies` and Zavu installs them. Limits: 200 files and 900,000 bytes
+      # for the whole tree.
+      sig { returns(T.nilable(T::Hash[Symbol, String])) }
+      attr_reader :files
+
+      sig { params(files: T::Hash[Symbol, String]).void }
+      attr_writer :files
+
+      # Expose the function on its public HTTPS URL, or take it down. Applies to the
+      # already-deployed function without redeploying; the URL is returned as
+      # `publicUrl`.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :http_enabled
+
+      sig { params(http_enabled: T::Boolean).void }
+      attr_writer :http_enabled
+
+      # Shortcut for a single-file function: exactly equivalent to sending `files` with
+      # one entry named after `entrypoint` (`index.ts` by default). Fully supported —
+      # use whichever fits. If both are sent, `files` wins.
       sig { returns(T.nilable(String)) }
       attr_reader :source_code
 
@@ -32,6 +64,9 @@ module Zavudev
         params(
           function_id: String,
           dependencies: T::Hash[Symbol, String],
+          entrypoint: String,
+          files: T::Hash[Symbol, String],
+          http_enabled: T::Boolean,
           source_code: String,
           request_options: Zavudev::RequestOptions::OrHash
         ).returns(T.attached_class)
@@ -40,7 +75,24 @@ module Zavudev
         function_id:,
         # New dependency map (replaces existing dependencies).
         dependencies: nil,
-        # New source code to publish (replaces the draft).
+        # Which file in `files` is the entry point. Defaults to `index.ts`.
+        entrypoint: nil,
+        # The project's source files, keyed by path relative to the project root (e.g.
+        # `index.ts`, `lib/orders.ts`). Imports between them are resolved when the
+        # function is built, so a function can be split across as many files as it needs.
+        #
+        # Paths must be relative and use forward slashes; `..`, `node_modules/` and
+        # `package.json` are rejected. npm packages are not uploaded here — declare them
+        # under `dependencies` and Zavu installs them. Limits: 200 files and 900,000 bytes
+        # for the whole tree.
+        files: nil,
+        # Expose the function on its public HTTPS URL, or take it down. Applies to the
+        # already-deployed function without redeploying; the URL is returned as
+        # `publicUrl`.
+        http_enabled: nil,
+        # Shortcut for a single-file function: exactly equivalent to sending `files` with
+        # one entry named after `entrypoint` (`index.ts` by default). Fully supported —
+        # use whichever fits. If both are sent, `files` wins.
         source_code: nil,
         request_options: {}
       )
@@ -51,6 +103,9 @@ module Zavudev
           {
             function_id: String,
             dependencies: T::Hash[Symbol, String],
+            entrypoint: String,
+            files: T::Hash[Symbol, String],
+            http_enabled: T::Boolean,
             source_code: String,
             request_options: Zavudev::RequestOptions
           }