voiceml 0.9.2 → 0.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ce6f40c38ff553e748881a1b57f940e977cd24983da928988a7dcc77640cc32d
-  data.tar.gz: d6d26a2ab6ee10d9df572f24c6b667cb87cb03bb68ef40234fb05308db3d3789
+  metadata.gz: 758b40e32d36539e838ab6418d8a978b089ebfebc7754847049e47fb281e4336
+  data.tar.gz: 057dc821a03507d3883edc839e9e5e2ead794e162cef2ff76ea6bf1d6f9787d6
 SHA512:
-  metadata.gz: 28fe625cbe02ccd47894507e8c28d8eecd06f0caae4aea040f5e21af82980072e39a74aa7cb788fc885f9b24e58239099a87dac639a79b9f3a3c248769e0a652
-  data.tar.gz: 85fd838a671b848768a791d590fbcdefa40c49e89d80b8f2c2c98f475af7035489a727ca3d1ecd7e5988296a5a62f32e3784344fc9fcc11f24beec16d5d9619e
+  metadata.gz: d88a3dc916f95b965f0899f910a0fee987d85b9d81ee33dc2dec8ce9b3d71178209e7c07999fb599d76cf172ad620b84d144459e2d3cb9ecde7e9a87e2a60dc1
+  data.tar.gz: 9aa62aaa635a1e2021ded627867cc6954eb389c16732c67ab9470fad749a6acbe64f448b7bd92dae412798196d024022d83c33ce0203f6718d0158330da8f5d5

data/README.md

@@ -2,10 +2,10 @@
 
 The official Ruby client for the [VoiceML REST API](https://voicetel.com/docs/api/v0.9/voiceml/) — Twilio-compatible outbound voice and answering-machine-detection from VoiceTel, with idiomatic snake_case kwargs, structured errors, and a Twilio-compatible wire format.
 
-![Version](https://img.shields.io/badge/version-0.9.2-blue)
-![Ruby](https://img.shields.io/badge/ruby-3.0%2B-red)
+![Version](https://img.shields.io/badge/version-0.9.3-blue)
+![Ruby](https://img.shields.io/badge/ruby-3.1%2B-red)
 ![License](https://img.shields.io/badge/license-MIT-green)
-![Tests](https://img.shields.io/badge/tests-188%20examples-brightgreen)
+![Tests](https://img.shields.io/badge/tests-227%20examples-brightgreen)
 ![Gem](https://img.shields.io/badge/gem-voiceml-blue)
 
 ## 📚 Table of Contents
@@ -44,9 +44,11 @@ The official Ruby client for the [VoiceML REST API](https://voicetel.com/docs/ap
 - **Queues** — create, list, update, delete, peek, dequeue (front or specific member).
 - **Applications** — CRUD on stored TwiML + callback bundles.
 - **Recordings** — account-wide list, metadata fetch, audio fetch (follows S3 redirect), delete.
-- **Messages** — create, fetch, list (To/From/DateSent filters + pagination), update (Body redaction; Status=canceled), delete.
+- **Messages** — create, fetch, list (To/From/DateSent filters + pagination), update (Body redaction; Status=canceled), delete, delivery feedback (`create_feedback`).
 - **IncomingPhoneNumbers** — list, fetch, update.
 - **Notifications** — fetch, list.
+- **Monitor Alerts** — `client.monitor_alerts` list (severity + date-window filters) and fetch over the `/v1` `meta` envelope.
+- **Accounts** — `client.accounts.fetch` / `update` / `fetch_balance` / `rotate_key` (key rotation returns the new key on `AccountWithKey#api_key`).
 - **SIP** — SIP Trunking: Domains (CRUD), CredentialLists + Credentials (CRUD), IpAccessControlLists + IpAddresses (CRUD), Domain↔ACL/CredentialList mappings (historical, Auth/Calls, Auth/Registrations namespaces).
 - **Routes V2** — Twilio Inbound Processing Region API: `client.routes_v2.sip_domains.fetch(name)` / `update(name, voice_region:, friendly_name:)`.
 - **Messaging Service** — `client.messaging_v1.services` CRUD (`MG...` services), routed automatically at the `messaging.voicetel.com` product host.
@@ -57,7 +59,7 @@ The official Ruby client for the [VoiceML REST API](https://voicetel.com/docs/ap
 VoiceML mirrors Twilio's product-per-subdomain model. The whole `conversations_v1` group is routed to `conversations.voicetel.com` and `messaging_v1` to `messaging.voicetel.com`, while everything else stays on the default `voiceml.voicetel.com`. These hosts are derived automatically from `base_url`; a non-`voicetel.com` base (e.g. a self-hosted instance) keeps every product on that single host. Override per product with `messaging_base_url:` / `conversations_base_url:` on the client constructor.
 
 ### 🧪 Tested
-- **188 examples** with mocked HTTP layer (`webmock`) covering every resource and pagination edge cases — spec drift gets caught at parse time.
+- **227 examples** with mocked HTTP layer (`webmock`) covering every resource and pagination edge cases — spec drift gets caught at parse time.
 - Integration smoke spec gated by env vars — safe for CI.
 
 ### 📦 Clean Distribution
@@ -77,7 +79,7 @@ Or in your `Gemfile`:
 gem 'voiceml', '~> 0.7'
 ```
 
-Requires Ruby 3.0 or later.
+Requires Ruby 3.1 or later.
 
 ## 🏁 Quickstart
 
@@ -90,8 +92,8 @@ client = VoiceML::Client.new(
 )
 
 call = client.calls.create(
-  to:                '+18005551234',
-  from:              '+18005550000',
+  to:                '+14155550100',
+  from:              '+14155550101',
   url:               'https://example.com/twiml',
   machine_detection: 'DetectMessageEnd'
 )
@@ -105,7 +107,7 @@ end
 
 ## 🔑 Authentication
 
-Every endpoint uses **HTTP Basic** with your `AccountSid` as the username and your per-tenant API key as the password — identical to Twilio's auth shape, so credentials issued for Twilio code work here unchanged.
+Every endpoint uses **HTTP Basic** with your `AccountSid` as the username and your per-tenant API key as the password — the same positions Twilio SDKs use, so existing credential-passing code migrates unchanged. VoiceML issues its own credentials; Twilio-issued credentials do not work here.
 
 - **Username** = your `AccountSid` (Twilio-format `AC` + 32 hex chars).
 - **Password** = your per-tenant API key (pass as `api_key:` or, for migration-compatible drop-in, `auth_token:`).
@@ -126,9 +128,11 @@ client.diagnostics.health  # uses your AccountSid + key on every call
 | `client.queues` | create, list, update, delete | peek, dequeue (front or specific member) |
 | `client.applications` | CRUD on TwiML + callback bundles | |
 | `client.recordings` | account-wide list, metadata, audio fetch, delete | follows S3 redirect for audio |
-| `client.messages` | create, fetch, list, update, delete | To/From/DateSent filters; Body redaction; Status=canceled |
+| `client.messages` | create, fetch, list, update, delete, create_feedback | To/From/DateSent filters; Body redaction; Status=canceled; delivery feedback |
 | `client.incoming_phone_numbers` | list, fetch, update | |
 | `client.notifications` | fetch, list | |
+| `client.monitor_alerts` | list, fetch | Monitor v1 Alerts (`/v1` `meta` envelope); severity + date-window filters |
+| `client.accounts` | fetch, update, fetch_balance, rotate_key | rotate_key returns the new API key on `AccountWithKey#api_key` |
 | `client.messaging_v1.services` | create, list, fetch, update, delete | Messaging Service (`MG...`); routed at `messaging.voicetel.com` |
 | `client.pricing.v1` / `.v2` | countries.list / fetch, numbers.fetch | Voice, Messaging, PhoneNumbers, Trunking (read-only, default host) |
 | `client.diagnostics` | `/health`, OpenAPI spec | |
@@ -139,8 +143,8 @@ Methods accept idiomatic snake_case keyword arguments — they're translated to
 client = VoiceML::Client.new(account_sid: 'AC...', api_key: '...')
 
 call = client.calls.create(
-  to:   '+18005551234',
-  from: '+18005550000',
+  to:   '+14155550100',
+  from: '+14155550101',
   url:  'https://example.com/twiml'
 )
 
@@ -195,7 +199,7 @@ client.calls.each(status: 'completed', page_size: 200) do |call|
 end
 
 # Enumerator form — chain with Enumerable methods
-recent = client.messages.each(from: '+18005550000', page_size: 200).first(50)
+recent = client.messages.each(from: '+14155550101', page_size: 200).first(50)
 
 client.queues.each do |q|
   archive(q) if q.current_size.zero?

data/lib/voiceml/client.rb

@@ -18,43 +18,66 @@ require_relative 'resources/conversations_v1'
 require_relative 'resources/assistants_v1'
 require_relative 'resources/messaging_v1'
 require_relative 'resources/pricing'
+require_relative 'resources/accounts'
+require_relative 'resources/outgoing_caller_ids'
+require_relative 'resources/exports'
+require_relative 'resources/usage_records'
+require_relative 'resources/transcriptions'
+require_relative 'resources/monitor_v1'
 
 module VoiceML
   # Synchronous client for the VoiceML REST API.
   #
   # VoiceML uses HTTP Basic auth: the `account_sid` (Twilio-format `AC` + 32 hex) is the
-  # username and `api_key` is the password. Drop-in compatible with the Twilio Ruby SDK
-  # constructor signature.
+  # username and `api_key` is the password, in the same HTTP Basic positions twilio-ruby
+  # uses. VoiceML issues its own credentials — the AccountSid plus a VoiceML API key;
+  # Twilio-issued credentials do not work here.
+  #
+  # A client without an `api_key:` is a credential-less diagnostics client: only
+  # {VoiceML::DiagnosticsResource} calls work (the spec marks them `security: []`);
+  # anything authenticated raises {VoiceML::ConfigurationError}.
+  #
+  # The client is thread-safe: requests may be issued from any number of threads,
+  # each holding its own connection per host.
   #
   # @example
   #   client = VoiceML::Client.new(account_sid: 'AC...', api_key: '...')
   #   call = client.calls.create(
-  #     to: '+18005551234',
-  #     from: '+18005550000',
-  #     url: 'https://example.com/twiml'
+  #     to: '+14155550100',
+  #     from: '+14155550101',
+  #     url: 'https://example.com/handler'
   #   )
   #   puts call.sid, call.status
   class Client
     attr_reader :calls, :conferences, :queues, :applications, :recordings,
                 :incoming_phone_numbers, :notifications, :diagnostics, :messages,
                 :sip, :routes_v2, :voice_v1, :conversations_v1, :assistants_v1,
-                :messaging_v1, :pricing
+                :messaging_v1, :pricing, :accounts, :outgoing_caller_ids, :exports,
+                :usage_records, :transcriptions, :monitor_alerts
 
     # @param account_sid [String] Twilio-format AccountSid (`AC` + 32 hex).
-    # @param api_key     [String, nil] per-tenant API key. Pass either `api_key:` or the
-    #   Twilio-compatible alias `auth_token:` (not both — `ArgumentError` if you do).
-    # @param auth_token  [String, nil] Twilio-compatible alias for `api_key`. Lets twilio-ruby
-    #   code (`VoiceML::Client.new(account_sid: sid, auth_token: token)`) work unchanged.
+    # @param api_key     [String, nil] per-tenant VoiceML API key. Pass either `api_key:` or
+    #   the Twilio-compatible alias `auth_token:` (not both — `ArgumentError` if you do).
+    #   Omit both for a credential-less diagnostics-only client.
+    # @param auth_token  [String, nil] Twilio-compatible alias for `api_key`. Lets
+    #   credential-passing code written for twilio-ruby keep its call shape; the key
+    #   itself must be a VoiceML API key.
     # @param base_url    [String] server base URL. Defaults to `https://voiceml.voicetel.com`.
-    # @param timeout     [Numeric] per-request timeout in seconds. Defaults to 30.
-    # @param max_retries [Integer] retry attempts for 429/5xx and transport errors. Defaults to 2.
+    # @param timeout     [Numeric] per-request connect/read/write timeout in seconds. Defaults to 30.
+    # @param max_retries [Integer] retry attempts. Idempotent requests (GET/HEAD/PUT/DELETE)
+    #   retry on 429/5xx and transport errors; POST/PATCH retry only on 429 and
+    #   connect-phase failures. Defaults to 2.
     # @param user_agent  [String, nil] override the `User-Agent` header. Defaults to
     #   `"voiceml-ruby/#{VERSION}"`.
+    # @param http_client [Net::HTTP, #call, nil] a `Net::HTTP` used for its own host, or a
+    #   factory `->(uri) { Net::HTTP.new(uri.host, uri.port) }` supplying every
+    #   connection. Caller-supplied connections are never finished by the SDK; hosts the
+    #   object/factory does not cover fall back to SDK-managed connections.
     # @param messaging_base_url     [String, nil] override the host for `messaging_v1`. Defaults to
     #   the `messaging.*.voicetel.com` subdomain derived from `base_url` (else `base_url` itself).
     # @param conversations_base_url [String, nil] override the host for `conversations_v1`. Defaults
     #   to the `conversations.*.voicetel.com` subdomain derived from `base_url` (else `base_url`).
-    def initialize(account_sid:, api_key: nil, auth_token: nil,
+    def initialize(account_sid: nil, api_key: nil, auth_token: nil,
                    base_url: Transport::DEFAULT_BASE_URL,
                    timeout: Transport::DEFAULT_TIMEOUT,
                    max_retries: Transport::DEFAULT_MAX_RETRIES,
@@ -102,6 +125,12 @@ module VoiceML
       @assistants_v1          = AssistantsV1Resource.new(@transport)
       @messaging_v1           = MessagingV1Resource.new(messaging_transport)
       @pricing                = PricingResource.new(@transport)
+      @accounts               = AccountsResource.new(@transport)
+      @outgoing_caller_ids    = OutgoingCallerIdsResource.new(@transport)
+      @exports                = ExportsResource.new(@transport)
+      @usage_records          = UsageRecordsResource.new(@transport)
+      @transcriptions         = TranscriptionsResource.new(@transport)
+      @monitor_alerts         = MonitorAlertsResource.new(@transport)
     end
 
     def account_sid
@@ -111,5 +140,16 @@ module VoiceML
     def base_url
       @transport.base_url
     end
+
+    # Close SDK-managed idle connections. The client remains usable.
+    def close
+      @transport.close
+    end
+
+    # A redacted dump: never includes the API key.
+    def inspect
+      "#<#{self.class.name} account_sid=#{account_sid} base_url=#{base_url}>"
+    end
+    alias to_s inspect
   end
 end

data/lib/voiceml/errors.rb

@@ -43,12 +43,25 @@ module VoiceML
   # HTTP 410 — recording audio is no longer available (no local file, no S3 key).
   class GoneError < ApiError; end
 
-  # HTTP 429 — per-account rate limit exceeded.
-  class RateLimitError < ApiError; end
+  # HTTP 429 — per-account rate limit exceeded. When the server sends a
+  # `Retry-After` header, the parsed delay in seconds is exposed on
+  # `#retry_after`.
+  class RateLimitError < ApiError
+    attr_reader :retry_after
+
+    def retry_after=(seconds)
+      @retry_after = seconds
+    end
+  end
 
   # HTTP 501 — endpoint is mounted as a stub (e.g. UserDefinedMessages).
   class NotImplementedAPIError < ApiError; end
 
+  # The request could not be delivered: connection failures, TLS errors,
+  # timeouts, malformed or refused redirects. The original exception is
+  # preserved as `#cause`.
+  class ConnectionError < ApiError; end
+
   # HTTP 5xx — the server hit an error processing the request.
   class ServerError < ApiError; end
 

data/lib/voiceml/models/accounts.rb

@@ -6,17 +6,18 @@ module VoiceML
   # Twilio-compatible Account resource. The voiceml SDK is single-account
   # (the credential's account is implicit on every call), so this model
   # exists primarily to decode `GET/POST /Accounts/{Sid}.json` responses
-  # round-trip with the Twilio shape — useful for migration tooling that
-  # echoes the account record back to the caller.
+  # in the Twilio-compatible wire format — useful for migration tooling
+  # that echoes the account record back to the caller.
   class Account
     ATTRIBUTES = %w[
-      sid friendly_name status type auth_token owner_account_sid
+      sid friendly_name status type owner_account_sid
       date_created date_updated subresource_uris uri
     ].freeze
 
     attr_reader(*ATTRIBUTES.map(&:to_sym))
 
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each do |field|
         value = attrs.key?(field) ? attrs[field] : attrs[field.to_sym]
         instance_variable_set("@#{field}", value)
@@ -34,11 +35,13 @@ module VoiceML
   # the account's settlement currency. No `sid` field on the wire (the
   # balance is account-scoped, not its own resource).
   class Balance
+    include RawAttributes
     ATTRIBUTES = %w[account_sid balance currency].freeze
 
     attr_reader(*ATTRIBUTES.map(&:to_sym))
 
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each do |field|
         value = attrs.key?(field) ? attrs[field] : attrs[field.to_sym]
         instance_variable_set("@#{field}", value)
@@ -51,4 +54,45 @@ module VoiceML
       new(hash)
     end
   end
+
+  # `POST /Accounts/{Sid}/RotateKey` response — the account configuration
+  # view plus the freshly generated `api_key`. No read endpoint returns the
+  # key, so store it right away; requests signed with the previous key fail
+  # with 401 from that point on. The key is secret material and never
+  # appears in `inspect` / `to_s` output.
+  class AccountWithKey
+    include RawAttributes
+    ATTRIBUTES = %w[
+      sid api_key sip_username name phone_regions allow_cidr disabled
+      stt_fs_vendor stt_http_url stt_http_token_set tts_http_url
+      tts_http_token_set tts_engine_name tts_default_voice tts_default_language
+      stripe_secret_key_set pay_enabled sms_provider sms_allowed_providers
+      stt_allowed_providers stt_provider voice_url voice_method
+      voice_fallback_url voice_fallback_method aws_bucket aws_region
+      aws_prefix aws_access_key_id aws_secret_access_key_set aws_kms_key_id
+      created_at updated_at
+    ].freeze
+
+    attr_reader(*ATTRIBUTES.map(&:to_sym))
+
+    def initialize(attrs = {})
+      @raw_attributes = attrs
+      ATTRIBUTES.each do |field|
+        value = attrs.key?(field) ? attrs[field] : attrs[field.to_sym]
+        instance_variable_set("@#{field}", value)
+      end
+    end
+
+    def self.from_hash(hash)
+      return nil if hash.nil?
+
+      new(hash)
+    end
+
+    # A redacted dump: never includes the api_key.
+    def inspect
+      "#<#{self.class.name} sid=#{@sid}>"
+    end
+    alias to_s inspect
+  end
 end

data/lib/voiceml/models/applications.rb

@@ -5,16 +5,20 @@ require_relative 'common'
 module VoiceML
   # Persistent TwiML+callback bundle dispatched by `<Dial><Application>`.
   class Application
+    include RawAttributes
     ATTRIBUTES = %w[
       sid account_sid friendly_name api_version voice_url voice_method
       voice_fallback_url voice_fallback_method voice_caller_id_lookup
       status_callback status_callback_method status_callback_event
+      message_status_callback sms_status_callback
+      sms_url sms_method sms_fallback_url sms_fallback_method
       date_created date_updated uri
     ].freeze
 
     attr_reader(*ATTRIBUTES.map(&:to_sym))
 
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each do |field|
         value = attrs.key?(field) ? attrs[field] : attrs[field.to_sym]
         instance_variable_set("@#{field}", value)
@@ -30,11 +34,13 @@ module VoiceML
 
   # Paginated `GET /Applications` response.
   class ApplicationList
+    include RawAttributes
     include Pageable
 
     attr_reader :applications
 
     def initialize(hash = {})
+      @raw_attributes = hash
       assign_page_fields(hash)
       @applications = (hash['applications'] || []).map { |a| Application.from_hash(a) }
     end

data/lib/voiceml/models/assistants_v1.rb

@@ -18,21 +18,25 @@ module VoiceML
 
   # AssistantsV1Assistant — `aia_asst_...`. Used by list/create/update/delete responses.
   class AssistantsV1Assistant
+    include RawAttributes
     ATTRIBUTES = %w[
       account_sid customer_ai id model name owner url personality_prompt
       date_created date_updated
     ].freeze
     attr_reader(*ATTRIBUTES.map(&:to_sym))
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs.key?(f) ? attrs[f] : attrs[f.to_sym]) }
     end
     def self.from_hash(h); h.nil? ? nil : new(h); end
   end
 
   class AssistantsV1AssistantList
+    include RawAttributes
     include V1Pageable
     attr_reader :assistants
     def initialize(hash = {})
+      @raw_attributes = hash
       assign_meta_fields(hash)
       @assistants = (hash['assistants'] || []).map { |h| AssistantsV1Assistant.from_hash(h) }
     end
@@ -41,12 +45,14 @@ module VoiceML
   # AssistantsV1AssistantWithToolsAndKnowledge — fetch-one shape that includes the
   # attached tools and knowledge arrays inline.
   class AssistantsV1AssistantWithToolsAndKnowledge
+    include RawAttributes
     ATTRIBUTES = %w[
       account_sid customer_ai id model name owner url personality_prompt
       date_created date_updated tools knowledge
     ].freeze
     attr_reader(*ATTRIBUTES.map(&:to_sym))
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs.key?(f) ? attrs[f] : attrs[f.to_sym]) }
     end
     def self.from_hash(h); h.nil? ? nil : new(h); end
@@ -54,21 +60,25 @@ module VoiceML
 
   # AssistantsV1Tool — `aia_tool_...`.
   class AssistantsV1Tool
+    include RawAttributes
     ATTRIBUTES = %w[
       account_sid description enabled id meta name requires_auth type url
       date_created date_updated
     ].freeze
     attr_reader(*ATTRIBUTES.map(&:to_sym))
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs.key?(f) ? attrs[f] : attrs[f.to_sym]) }
     end
     def self.from_hash(h); h.nil? ? nil : new(h); end
   end
 
   class AssistantsV1ToolList
+    include RawAttributes
     include V1Pageable
     attr_reader :tools
     def initialize(hash = {})
+      @raw_attributes = hash
       assign_meta_fields(hash)
       @tools = (hash['tools'] || []).map { |h| AssistantsV1Tool.from_hash(h) }
     end
@@ -76,12 +86,14 @@ module VoiceML
 
   # AssistantsV1ToolWithPolicies — fetch-one shape that includes the policies array inline.
   class AssistantsV1ToolWithPolicies
+    include RawAttributes
     ATTRIBUTES = %w[
       account_sid description enabled id meta name requires_auth type url
       date_created date_updated policies
     ].freeze
     attr_reader(*ATTRIBUTES.map(&:to_sym))
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs.key?(f) ? attrs[f] : attrs[f.to_sym]) }
     end
     def self.from_hash(h); h.nil? ? nil : new(h); end
@@ -89,21 +101,25 @@ module VoiceML
 
   # AssistantsV1Knowledge — `aia_know_...`.
   class AssistantsV1Knowledge
+    include RawAttributes
     ATTRIBUTES = %w[
       account_sid description id knowledge_source_details name status type url
       embedding_model date_created date_updated
     ].freeze
     attr_reader(*ATTRIBUTES.map(&:to_sym))
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs.key?(f) ? attrs[f] : attrs[f.to_sym]) }
     end
     def self.from_hash(h); h.nil? ? nil : new(h); end
   end
 
   class AssistantsV1KnowledgeList
+    include RawAttributes
     include V1Pageable
     attr_reader :knowledge
     def initialize(hash = {})
+      @raw_attributes = hash
       assign_meta_fields(hash)
       @knowledge = (hash['knowledge'] || []).map { |h| AssistantsV1Knowledge.from_hash(h) }
     end
@@ -111,9 +127,11 @@ module VoiceML
 
   # AssistantsV1KnowledgeStatus — read-only ingestion status snapshot.
   class AssistantsV1KnowledgeStatus
+    include RawAttributes
     ATTRIBUTES = %w[account_sid status last_status date_updated].freeze
     attr_reader(*ATTRIBUTES.map(&:to_sym))
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs.key?(f) ? attrs[f] : attrs[f.to_sym]) }
     end
     def self.from_hash(h); h.nil? ? nil : new(h); end
@@ -121,18 +139,22 @@ module VoiceML
 
   # AssistantsV1KnowledgeChunk — single retrieved chunk of indexed Knowledge content.
   class AssistantsV1KnowledgeChunk
+    include RawAttributes
     ATTRIBUTES = %w[account_sid content metadata date_created date_updated].freeze
     attr_reader(*ATTRIBUTES.map(&:to_sym))
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs.key?(f) ? attrs[f] : attrs[f.to_sym]) }
     end
     def self.from_hash(h); h.nil? ? nil : new(h); end
   end
 
   class AssistantsV1KnowledgeChunkList
+    include RawAttributes
     include V1Pageable
     attr_reader :chunks
     def initialize(hash = {})
+      @raw_attributes = hash
       assign_meta_fields(hash)
       @chunks = (hash['chunks'] || []).map { |h| AssistantsV1KnowledgeChunk.from_hash(h) }
     end
@@ -140,20 +162,24 @@ module VoiceML
 
   # AssistantsV1Session — a chat session between an identity and an Assistant.
   class AssistantsV1Session
+    include RawAttributes
     ATTRIBUTES = %w[
       id account_sid assistant_id verified identity date_created date_updated
     ].freeze
     attr_reader(*ATTRIBUTES.map(&:to_sym))
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs.key?(f) ? attrs[f] : attrs[f.to_sym]) }
     end
     def self.from_hash(h); h.nil? ? nil : new(h); end
   end
 
   class AssistantsV1SessionList
+    include RawAttributes
     include V1Pageable
     attr_reader :sessions
     def initialize(hash = {})
+      @raw_attributes = hash
       assign_meta_fields(hash)
       @sessions = (hash['sessions'] || []).map { |h| AssistantsV1Session.from_hash(h) }
     end
@@ -161,21 +187,25 @@ module VoiceML
 
   # AssistantsV1Message — `aia_msg_...`. One message in an Assistant session.
   class AssistantsV1Message
+    include RawAttributes
     ATTRIBUTES = %w[
       id account_sid assistant_id session_id identity role content meta
       date_created date_updated
     ].freeze
     attr_reader(*ATTRIBUTES.map(&:to_sym))
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs.key?(f) ? attrs[f] : attrs[f.to_sym]) }
     end
     def self.from_hash(h); h.nil? ? nil : new(h); end
   end
 
   class AssistantsV1MessageList
+    include RawAttributes
     include V1Pageable
     attr_reader :messages
     def initialize(hash = {})
+      @raw_attributes = hash
       assign_meta_fields(hash)
       @messages = (hash['messages'] || []).map { |h| AssistantsV1Message.from_hash(h) }
     end
@@ -184,9 +214,11 @@ module VoiceML
   # AssistantsV1SendMessageResponse — POST /v1/Assistants/{id}/Messages return shape.
   # Distinct from AssistantsV1Message: carries the model's reply body + flag/abort signals.
   class AssistantsV1SendMessageResponse
+    include RawAttributes
     ATTRIBUTES = %w[status flagged aborted session_id account_sid body error].freeze
     attr_reader(*ATTRIBUTES.map(&:to_sym))
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs.key?(f) ? attrs[f] : attrs[f.to_sym]) }
     end
     def self.from_hash(h); h.nil? ? nil : new(h); end
@@ -194,21 +226,25 @@ module VoiceML
 
   # AssistantsV1Feedback — `aia_fdbk_...`. Numeric score + text feedback on a message.
   class AssistantsV1Feedback
+    include RawAttributes
     ATTRIBUTES = %w[
       assistant_id id account_sid user_sid message_id score session_id text
       date_created date_updated
     ].freeze
     attr_reader(*ATTRIBUTES.map(&:to_sym))
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs.key?(f) ? attrs[f] : attrs[f.to_sym]) }
     end
     def self.from_hash(h); h.nil? ? nil : new(h); end
   end
 
   class AssistantsV1FeedbackList
+    include RawAttributes
     include V1Pageable
     attr_reader :feedbacks
     def initialize(hash = {})
+      @raw_attributes = hash
       assign_meta_fields(hash)
       @feedbacks = (hash['feedbacks'] || []).map { |h| AssistantsV1Feedback.from_hash(h) }
     end
@@ -217,21 +253,25 @@ module VoiceML
   # AssistantsV1Policy — `aia_plcy_...`. Read-only — listed under /v1/Policies (filterable
   # by ToolId/KnowledgeId) and embedded inline on Tool fetch responses.
   class AssistantsV1Policy
+    include RawAttributes
     ATTRIBUTES = %w[
       id name description account_sid user_sid type policy_details
       date_created date_updated
     ].freeze
     attr_reader(*ATTRIBUTES.map(&:to_sym))
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs.key?(f) ? attrs[f] : attrs[f.to_sym]) }
     end
     def self.from_hash(h); h.nil? ? nil : new(h); end
   end
 
   class AssistantsV1PolicyList
+    include RawAttributes
     include V1Pageable
     attr_reader :policies
     def initialize(hash = {})
+      @raw_attributes = hash
       assign_meta_fields(hash)
       @policies = (hash['policies'] || []).map { |h| AssistantsV1Policy.from_hash(h) }
     end

data/lib/voiceml/models/calls.rb

@@ -6,6 +6,7 @@ module VoiceML
   # A Twilio-compatible Call resource. Returned by `client.calls.create`, `client.calls.get`,
   # `client.calls.update`, and listed in `CallList#calls`.
   class Call
+    include RawAttributes
     ATTRIBUTES = %w[
       sid account_sid api_version to to_formatted from from_formatted
       parent_call_sid caller_name forwarded_from status direction
@@ -17,6 +18,7 @@ module VoiceML
     attr_reader(*ATTRIBUTES.map(&:to_sym))
 
     def initialize(attrs = {})
+      @raw_attributes = attrs
       ATTRIBUTES.each do |field|
         value = attrs.key?(field) ? attrs[field] : attrs[field.to_sym]
         instance_variable_set("@#{field}", value)
@@ -32,11 +34,13 @@ module VoiceML
 
   # Paginated `GET /Calls` response.
   class CallList
+    include RawAttributes
     include Pageable
 
     attr_reader :calls
 
     def initialize(hash = {})
+      @raw_attributes = hash
       assign_page_fields(hash)
       @calls = (hash['calls'] || []).map { |c| Call.from_hash(c) }
     end