telnyx 5.173.0 → 5.175.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (675) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +14 -0
  3. data/README.md +1 -1
  4. data/lib/telnyx/client.rb +18 -4
  5. data/lib/telnyx/internal/email_events_cursor_pagination.rb +104 -0
  6. data/lib/telnyx/lib/access_token.rb +141 -0
  7. data/lib/telnyx/lib/telephony_credentials.rb +87 -0
  8. data/lib/telnyx/lib.rb +2 -0
  9. data/lib/telnyx/models/agent_gateway.rb +110 -0
  10. data/lib/telnyx/models/agent_gateway_create_params.rb +34 -0
  11. data/lib/telnyx/models/agent_gateway_delete_params.rb +20 -0
  12. data/lib/telnyx/models/agent_gateway_list_params.rb +30 -0
  13. data/lib/telnyx/models/agent_gateway_response.rb +17 -0
  14. data/lib/telnyx/models/agent_gateway_retrieve_models_params.rb +20 -0
  15. data/lib/telnyx/models/agent_gateway_retrieve_models_response.rb +108 -0
  16. data/lib/telnyx/models/agent_gateway_retrieve_params.rb +20 -0
  17. data/lib/telnyx/models/agent_gateway_retrieve_spend_logs_params.rb +73 -0
  18. data/lib/telnyx/models/agent_gateway_retrieve_spend_logs_response.rb +186 -0
  19. data/lib/telnyx/models/agent_gateways/agent_gateway_api.rb +105 -0
  20. data/lib/telnyx/models/agent_gateways/agent_gateway_api_response.rb +20 -0
  21. data/lib/telnyx/models/agent_gateways/agent_gateway_aws_sig_v4_auth.rb +69 -0
  22. data/lib/telnyx/models/agent_gateways/agent_gateway_guardrail.rb +122 -0
  23. data/lib/telnyx/models/agent_gateways/agent_gateway_guardrail_response.rb +20 -0
  24. data/lib/telnyx/models/agent_gateways/agent_gateway_key.rb +130 -0
  25. data/lib/telnyx/models/agent_gateways/agent_gateway_key_response.rb +21 -0
  26. data/lib/telnyx/models/agent_gateways/agent_gateway_mcp_server.rb +116 -0
  27. data/lib/telnyx/models/agent_gateways/agent_gateway_mcp_server_response.rb +20 -0
  28. data/lib/telnyx/models/agent_gateways/agent_gateway_no_auth.rb +31 -0
  29. data/lib/telnyx/models/agent_gateways/agent_gateway_oauth_client_credentials.rb +99 -0
  30. data/lib/telnyx/models/agent_gateways/agent_gateway_passthrough_auth.rb +32 -0
  31. data/lib/telnyx/models/agent_gateways/agent_gateway_policy.rb +86 -0
  32. data/lib/telnyx/models/agent_gateways/agent_gateway_policy_attachment.rb +74 -0
  33. data/lib/telnyx/models/agent_gateways/agent_gateway_policy_attachment_response.rb +21 -0
  34. data/lib/telnyx/models/agent_gateways/agent_gateway_policy_guardrails.rb +31 -0
  35. data/lib/telnyx/models/agent_gateways/agent_gateway_policy_pipeline.rb +48 -0
  36. data/lib/telnyx/models/agent_gateways/agent_gateway_policy_response.rb +21 -0
  37. data/lib/telnyx/models/agent_gateways/agent_gateway_policy_step.rb +114 -0
  38. data/lib/telnyx/models/agent_gateways/agent_gateway_shown_auth.rb +22 -0
  39. data/lib/telnyx/models/agent_gateways/agent_gateway_static_auth.rb +68 -0
  40. data/lib/telnyx/models/agent_gateways/agent_gateway_team.rb +106 -0
  41. data/lib/telnyx/models/agent_gateways/agent_gateway_team_response.rb +25 -0
  42. data/lib/telnyx/models/agent_gateways/api_create_params.rb +117 -0
  43. data/lib/telnyx/models/agent_gateways/api_delete_params.rb +28 -0
  44. data/lib/telnyx/models/agent_gateways/api_list_params.rb +22 -0
  45. data/lib/telnyx/models/agent_gateways/api_list_response.rb +18 -0
  46. data/lib/telnyx/models/agent_gateways/api_update_params.rb +124 -0
  47. data/lib/telnyx/models/agent_gateways/guardrail_create_params.rb +113 -0
  48. data/lib/telnyx/models/agent_gateways/guardrail_delete_params.rb +28 -0
  49. data/lib/telnyx/models/agent_gateways/guardrail_list_params.rb +22 -0
  50. data/lib/telnyx/models/agent_gateways/guardrail_list_response.rb +18 -0
  51. data/lib/telnyx/models/agent_gateways/guardrail_update_params.rb +94 -0
  52. data/lib/telnyx/models/agent_gateways/key_create_params.rb +100 -0
  53. data/lib/telnyx/models/agent_gateways/key_create_response.rb +150 -0
  54. data/lib/telnyx/models/agent_gateways/key_delete_params.rb +28 -0
  55. data/lib/telnyx/models/agent_gateways/key_list_params.rb +31 -0
  56. data/lib/telnyx/models/agent_gateways/key_list_response.rb +18 -0
  57. data/lib/telnyx/models/agent_gateways/key_update_params.rb +110 -0
  58. data/lib/telnyx/models/agent_gateways/keys/agent_gateway_tool_permissions.rb +45 -0
  59. data/lib/telnyx/models/agent_gateways/keys/agent_gateway_tool_permissions_response.rb +20 -0
  60. data/lib/telnyx/models/agent_gateways/keys/tool_permission_create_params.rb +30 -0
  61. data/lib/telnyx/models/agent_gateways/keys/tool_permission_list_params.rb +30 -0
  62. data/lib/telnyx/models/agent_gateways/mcp_server_create_params.rb +128 -0
  63. data/lib/telnyx/models/agent_gateways/mcp_server_delete_params.rb +28 -0
  64. data/lib/telnyx/models/agent_gateways/mcp_server_list_params.rb +22 -0
  65. data/lib/telnyx/models/agent_gateways/mcp_server_list_response.rb +18 -0
  66. data/lib/telnyx/models/agent_gateways/mcp_server_update_params.rb +135 -0
  67. data/lib/telnyx/models/agent_gateways/policy_attachment_create_params.rb +59 -0
  68. data/lib/telnyx/models/agent_gateways/policy_attachment_delete_params.rb +28 -0
  69. data/lib/telnyx/models/agent_gateways/policy_attachment_list_params.rb +22 -0
  70. data/lib/telnyx/models/agent_gateways/policy_attachment_list_response.rb +19 -0
  71. data/lib/telnyx/models/agent_gateways/policy_create_params.rb +79 -0
  72. data/lib/telnyx/models/agent_gateways/policy_delete_params.rb +28 -0
  73. data/lib/telnyx/models/agent_gateways/policy_list_params.rb +22 -0
  74. data/lib/telnyx/models/agent_gateways/policy_list_response.rb +18 -0
  75. data/lib/telnyx/models/agent_gateways/policy_retrieve_params.rb +28 -0
  76. data/lib/telnyx/models/agent_gateways/policy_update_params.rb +77 -0
  77. data/lib/telnyx/models/agent_gateways/team_create_params.rb +71 -0
  78. data/lib/telnyx/models/agent_gateways/team_delete_params.rb +28 -0
  79. data/lib/telnyx/models/agent_gateways/team_list_params.rb +22 -0
  80. data/lib/telnyx/models/agent_gateways/team_list_response.rb +18 -0
  81. data/lib/telnyx/models/agent_gateways/team_update_params.rb +90 -0
  82. data/lib/telnyx/models/agent_gateways/teams/tool_permission_create_params.rb +30 -0
  83. data/lib/telnyx/models/agent_gateways/teams/tool_permission_list_params.rb +30 -0
  84. data/lib/telnyx/models/ai/chat_completion_request.rb +3 -5
  85. data/lib/telnyx/models/ai/conversation_delete_delete_params.rb +28 -0
  86. data/lib/telnyx/models/ai/external_llm.rb +20 -1
  87. data/lib/telnyx/models/ai/external_llm_req.rb +20 -1
  88. data/lib/telnyx/models/ai/inference_embedding_interruption_settings.rb +14 -2
  89. data/lib/telnyx/models/ai/inference_embedding_voice_settings.rb +13 -1
  90. data/lib/telnyx/models/ai/memory/namespaces/agent_memory_page_meta.rb +58 -0
  91. data/lib/telnyx/models/ai/memory/namespaces/namespace_settings.rb +26 -0
  92. data/lib/telnyx/models/ai/memory/namespaces/namespace_settings_response.rb +3 -41
  93. data/lib/telnyx/models/ai/memory/namespaces/page_meta.rb +6 -18
  94. data/lib/telnyx/models/ai/memory/namespaces/profile_ingest_params.rb +4 -4
  95. data/lib/telnyx/models/ai/memory/namespaces/profiles/source_retrieve_response.rb +4 -4
  96. data/lib/telnyx/models/ai/memory/namespaces/summary_settings.rb +33 -0
  97. data/lib/telnyx/models/ai/pay_tool_params.rb +791 -1
  98. data/lib/telnyx/models/ai/privacy_settings.rb +26 -12
  99. data/lib/telnyx/models/ai/start_speaking_plan.rb +24 -5
  100. data/lib/telnyx/models/ai/telephony_settings.rb +13 -1
  101. data/lib/telnyx/models/ai/tests/test_framework/v1_retrieve_personalities_response.rb +27 -16
  102. data/lib/telnyx/models/ai/transcription_challenger.rb +148 -0
  103. data/lib/telnyx/models/ai/transcription_endpointing_plan.rb +5 -1
  104. data/lib/telnyx/models/ai/transcription_fallback_model.rb +78 -0
  105. data/lib/telnyx/models/ai/transcription_settings.rb +6 -219
  106. data/lib/telnyx/models/ai/transcription_settings_config.rb +2 -1
  107. data/lib/telnyx/models/browser_session_create_params.rb +3 -3
  108. data/lib/telnyx/models/browser_sessions/action_response.rb +10 -9
  109. data/lib/telnyx/models/browser_sessions/wait_for_action.rb +5 -5
  110. data/lib/telnyx/models/calendar_connection.rb +188 -0
  111. data/lib/telnyx/models/calendar_connection_create_params.rb +33 -0
  112. data/lib/telnyx/models/calendar_connection_create_response.rb +57 -0
  113. data/lib/telnyx/models/calendar_connection_delete_params.rb +20 -0
  114. data/lib/telnyx/models/calendar_connection_list_params.rb +14 -0
  115. data/lib/telnyx/models/calendar_connection_list_response.rb +16 -0
  116. data/lib/telnyx/models/calendar_connection_response.rb +16 -0
  117. data/lib/telnyx/models/calendar_connection_retrieve_params.rb +20 -0
  118. data/lib/telnyx/models/calendar_connection_update_params.rb +189 -0
  119. data/lib/telnyx/models/calendar_connection_update_response.rb +210 -0
  120. data/lib/telnyx/models/calendar_connections/calendar_meeting.rb +203 -0
  121. data/lib/telnyx/models/calendar_connections/meeting_list_params.rb +39 -0
  122. data/lib/telnyx/models/calendar_connections/meeting_list_response.rb +18 -0
  123. data/lib/telnyx/models/calendar_connections/meeting_update_params.rb +42 -0
  124. data/lib/telnyx/models/calendar_connections/meeting_update_response.rb +18 -0
  125. data/lib/telnyx/models/call_analyzed_webhook_event.rb +12 -17
  126. data/lib/telnyx/models/calls/action_gather_using_ai_params.rb +5 -3
  127. data/lib/telnyx/models/calls/action_gather_using_speak_params.rb +5 -3
  128. data/lib/telnyx/models/calls/action_speak_params.rb +5 -3
  129. data/lib/telnyx/models/calls/action_start_conversation_relay_params.rb +5 -3
  130. data/lib/telnyx/models/calls/assembly_ai_voice_settings.rb +30 -0
  131. data/lib/telnyx/models/compute/funcs/func_log_export_config.rb +96 -0
  132. data/lib/telnyx/models/compute/funcs/func_log_export_config_response.rb +3 -89
  133. data/lib/telnyx/models/conferences/action_speak_params.rb +5 -3
  134. data/lib/telnyx/models/conversation_relay_embedded_config.rb +5 -3
  135. data/lib/telnyx/models/conversation_relay_language.rb +5 -3
  136. data/lib/telnyx/models/email_event_list_response.rb +218 -265
  137. data/lib/telnyx/models/email_template_common.rb +5 -26
  138. data/lib/telnyx/models/email_template_create_params.rb +5 -26
  139. data/lib/telnyx/models/enterprises/enterprise_email_verification_status.rb +87 -0
  140. data/lib/telnyx/models/enterprises/enterprise_email_verification_status_wrapped.rb +3 -83
  141. data/lib/telnyx/models/enterprises/reputation/external_verification.rb +72 -0
  142. data/lib/telnyx/models/enterprises/reputation/external_verification_wrapped.rb +3 -67
  143. data/lib/telnyx/models/generic_pay_connector_config.rb +18 -18
  144. data/lib/telnyx/models/llm_token_gateway/budget_duration.rb +3 -3
  145. data/lib/telnyx/models/meeting_bot/calendar_retrieve_oauth_callback_params.rb +40 -0
  146. data/lib/telnyx/models/meeting_bot/calendar_retrieve_oauth_callback_response.rb +9 -0
  147. data/lib/telnyx/models/meeting_session.rb +117 -72
  148. data/lib/telnyx/models/meeting_session_assistant.rb +57 -0
  149. data/lib/telnyx/models/meeting_session_create_params.rb +107 -65
  150. data/lib/telnyx/models/meeting_session_leave_policy.rb +75 -0
  151. data/lib/telnyx/models/meeting_session_recording_destination.rb +33 -0
  152. data/lib/telnyx/models/meeting_session_recording_export.rb +67 -0
  153. data/lib/telnyx/models/meeting_session_response.rb +4 -4
  154. data/lib/telnyx/models/meeting_session_retrieve_recordings_params.rb +20 -0
  155. data/lib/telnyx/models/meeting_session_retrieve_recordings_response.rb +56 -0
  156. data/lib/telnyx/models/meeting_session_retrieve_transcript_response.rb +16 -2
  157. data/lib/telnyx/models/meeting_sessions/action_send_chat_params.rb +7 -2
  158. data/lib/telnyx/models/message_event.rb +1 -1
  159. data/lib/telnyx/models/message_whatsapp_params.rb +6 -6
  160. data/lib/telnyx/models/messaging_outbound_message_payload.rb +22 -1
  161. data/lib/telnyx/models/messaging_profile_features.rb +16 -1
  162. data/lib/telnyx/models/model_metadata.rb +10 -1
  163. data/lib/telnyx/models/number_lookup_retrieve_response.rb +10 -1
  164. data/lib/telnyx/models/outbound_message_payload.rb +22 -1
  165. data/lib/telnyx/models/pay_connector.rb +3 -3
  166. data/lib/telnyx/models/phone_numbers/numbers_phone_numbers_job.rb +6 -50
  167. data/lib/telnyx/models/phone_numbers/phone_numbers_job.rb +6 -50
  168. data/lib/telnyx/models/phone_numbers/phone_numbers_job_pending_operation.rb +28 -0
  169. data/lib/telnyx/models/phone_numbers/phone_numbers_job_successful_operation.rb +28 -0
  170. data/lib/telnyx/models/recording_export_failed_webhook_event.rb +119 -0
  171. data/lib/telnyx/models/recording_exported_webhook_event.rb +106 -0
  172. data/lib/telnyx/models/session.rb +3 -3
  173. data/lib/telnyx/models/session_status_changed_webhook_event.rb +28 -1
  174. data/lib/telnyx/models/telephony_credential.rb +13 -1
  175. data/lib/telnyx/models/telephony_credential_retrieve_token_material_params.rb +20 -0
  176. data/lib/telnyx/models/telephony_credential_retrieve_token_material_response.rb +23 -0
  177. data/lib/telnyx/models/text_to_speech_generate_speech_params.rb +127 -1
  178. data/lib/telnyx/models/text_to_speech_list_voices_params.rb +1 -0
  179. data/lib/telnyx/models/text_to_speech_retrieve_speech_params.rb +1 -0
  180. data/lib/telnyx/models/token_material.rb +42 -0
  181. data/lib/telnyx/models/unsafe_unwrap_webhook_event.rb +5 -1
  182. data/lib/telnyx/models/unwrap_webhook_event.rb +5 -1
  183. data/lib/telnyx/models/update_email_template_request.rb +5 -26
  184. data/lib/telnyx/models/user_profile.rb +198 -0
  185. data/lib/telnyx/models/user_profile_list_params.rb +14 -0
  186. data/lib/telnyx/models/user_profile_list_response.rb +17 -0
  187. data/lib/telnyx/models/user_profile_patch_all_params.rb +365 -0
  188. data/lib/telnyx/models/user_profile_patch_all_response.rb +17 -0
  189. data/lib/telnyx/models/variable_schema_entry.rb +28 -0
  190. data/lib/telnyx/models/voice_clone_create_from_upload_params.rb +0 -2
  191. data/lib/telnyx/models/voice_clone_data.rb +1 -0
  192. data/lib/telnyx/models/voice_clone_list_params.rb +1 -0
  193. data/lib/telnyx/models/whatsapp/hosted_signup_create_response.rb +3 -83
  194. data/lib/telnyx/models/whatsapp/hosted_signup_retrieve_response.rb +3 -84
  195. data/lib/telnyx/models/whatsapp/phone_number_get_response.rb +3 -191
  196. data/lib/telnyx/models/whatsapp/phone_number_retrieve_phone_number_response.rb +3 -192
  197. data/lib/telnyx/models/whatsapp/{hosted_signup_list_response.rb → whatsapp_hosted_signup.rb} +8 -6
  198. data/lib/telnyx/models/whatsapp/{phone_number_list_response.rb → whatsapp_phone_response.rb} +12 -12
  199. data/lib/telnyx/models.rb +63 -0
  200. data/lib/telnyx/resources/agent_gateways/apis.rb +159 -0
  201. data/lib/telnyx/resources/agent_gateways/guardrails.rb +144 -0
  202. data/lib/telnyx/resources/agent_gateways/keys/tool_permissions.rb +86 -0
  203. data/lib/telnyx/resources/agent_gateways/keys.rb +176 -0
  204. data/lib/telnyx/resources/agent_gateways/mcp_servers.rb +160 -0
  205. data/lib/telnyx/resources/agent_gateways/policies.rb +175 -0
  206. data/lib/telnyx/resources/agent_gateways/policy_attachments.rb +98 -0
  207. data/lib/telnyx/resources/agent_gateways/teams/tool_permissions.rb +82 -0
  208. data/lib/telnyx/resources/agent_gateways/teams.rb +156 -0
  209. data/lib/telnyx/resources/agent_gateways.rb +209 -0
  210. data/lib/telnyx/resources/ai/conversations.rb +39 -1
  211. data/lib/telnyx/resources/browser_sessions.rb +1 -1
  212. data/lib/telnyx/resources/calendar_connections/meetings.rb +83 -0
  213. data/lib/telnyx/resources/calendar_connections.rb +155 -0
  214. data/lib/telnyx/resources/calls/actions.rb +4 -4
  215. data/lib/telnyx/resources/conferences/actions.rb +1 -1
  216. data/lib/telnyx/resources/email_events.rb +2 -1
  217. data/lib/telnyx/resources/email_templates.rb +3 -3
  218. data/lib/telnyx/resources/meeting_bot/calendar.rb +48 -0
  219. data/lib/telnyx/resources/meeting_bot.rb +19 -0
  220. data/lib/telnyx/resources/meeting_sessions/actions.rb +18 -11
  221. data/lib/telnyx/resources/meeting_sessions/artifacts.rb +8 -7
  222. data/lib/telnyx/resources/meeting_sessions.rb +73 -28
  223. data/lib/telnyx/resources/portouts.rb +2 -1
  224. data/lib/telnyx/resources/telephony_credentials.rb +23 -0
  225. data/lib/telnyx/resources/text_to_speech.rb +5 -3
  226. data/lib/telnyx/resources/user_profile.rb +138 -0
  227. data/lib/telnyx/resources/webhooks.rb +2 -2
  228. data/lib/telnyx/resources/whatsapp/business_accounts/phone_numbers.rb +2 -2
  229. data/lib/telnyx/resources/whatsapp/hosted_signups.rb +2 -2
  230. data/lib/telnyx/resources/whatsapp/phone_numbers.rb +2 -2
  231. data/lib/telnyx/version.rb +1 -1
  232. data/lib/telnyx.rb +139 -5
  233. data/rbi/telnyx/client.rbi +14 -3
  234. data/rbi/telnyx/internal/email_events_cursor_pagination.rbi +40 -0
  235. data/rbi/telnyx/lib/access_token.rbi +73 -0
  236. data/rbi/telnyx/lib/telephony_credentials.rbi +50 -0
  237. data/rbi/telnyx/models/agent_gateway.rbi +136 -0
  238. data/rbi/telnyx/models/agent_gateway_create_params.rbi +53 -0
  239. data/rbi/telnyx/models/agent_gateway_delete_params.rbi +35 -0
  240. data/rbi/telnyx/models/agent_gateway_list_params.rbi +57 -0
  241. data/rbi/telnyx/models/agent_gateway_response.rbi +32 -0
  242. data/rbi/telnyx/models/agent_gateway_retrieve_models_params.rbi +38 -0
  243. data/rbi/telnyx/models/agent_gateway_retrieve_models_response.rbi +194 -0
  244. data/rbi/telnyx/models/agent_gateway_retrieve_params.rbi +35 -0
  245. data/rbi/telnyx/models/agent_gateway_retrieve_spend_logs_params.rbi +112 -0
  246. data/rbi/telnyx/models/agent_gateway_retrieve_spend_logs_response.rbi +269 -0
  247. data/rbi/telnyx/models/agent_gateways/agent_gateway_api.rbi +135 -0
  248. data/rbi/telnyx/models/agent_gateways/agent_gateway_api_response.rbi +41 -0
  249. data/rbi/telnyx/models/agent_gateways/agent_gateway_aws_sig_v4_auth.rbi +89 -0
  250. data/rbi/telnyx/models/agent_gateways/agent_gateway_guardrail.rbi +254 -0
  251. data/rbi/telnyx/models/agent_gateways/agent_gateway_guardrail_response.rbi +45 -0
  252. data/rbi/telnyx/models/agent_gateways/agent_gateway_key.rbi +151 -0
  253. data/rbi/telnyx/models/agent_gateways/agent_gateway_key_response.rbi +45 -0
  254. data/rbi/telnyx/models/agent_gateways/agent_gateway_mcp_server.rbi +172 -0
  255. data/rbi/telnyx/models/agent_gateways/agent_gateway_mcp_server_response.rbi +45 -0
  256. data/rbi/telnyx/models/agent_gateways/agent_gateway_no_auth.rbi +76 -0
  257. data/rbi/telnyx/models/agent_gateways/agent_gateway_oauth_client_credentials.rbi +155 -0
  258. data/rbi/telnyx/models/agent_gateways/agent_gateway_passthrough_auth.rbi +87 -0
  259. data/rbi/telnyx/models/agent_gateways/agent_gateway_policy.rbi +136 -0
  260. data/rbi/telnyx/models/agent_gateways/agent_gateway_policy_attachment.rbi +95 -0
  261. data/rbi/telnyx/models/agent_gateways/agent_gateway_policy_attachment_response.rbi +50 -0
  262. data/rbi/telnyx/models/agent_gateways/agent_gateway_policy_guardrails.rbi +54 -0
  263. data/rbi/telnyx/models/agent_gateways/agent_gateway_policy_pipeline.rbi +97 -0
  264. data/rbi/telnyx/models/agent_gateways/agent_gateway_policy_response.rbi +45 -0
  265. data/rbi/telnyx/models/agent_gateways/agent_gateway_policy_step.rbi +273 -0
  266. data/rbi/telnyx/models/agent_gateways/agent_gateway_shown_auth.rbi +35 -0
  267. data/rbi/telnyx/models/agent_gateways/agent_gateway_static_auth.rbi +124 -0
  268. data/rbi/telnyx/models/agent_gateways/agent_gateway_team.rbi +126 -0
  269. data/rbi/telnyx/models/agent_gateways/agent_gateway_team_response.rbi +47 -0
  270. data/rbi/telnyx/models/agent_gateways/api_create_params.rbi +194 -0
  271. data/rbi/telnyx/models/agent_gateways/api_delete_params.rbi +48 -0
  272. data/rbi/telnyx/models/agent_gateways/api_list_params.rbi +40 -0
  273. data/rbi/telnyx/models/agent_gateways/api_list_response.rbi +36 -0
  274. data/rbi/telnyx/models/agent_gateways/api_update_params.rbi +206 -0
  275. data/rbi/telnyx/models/agent_gateways/guardrail_create_params.rbi +253 -0
  276. data/rbi/telnyx/models/agent_gateways/guardrail_delete_params.rbi +48 -0
  277. data/rbi/telnyx/models/agent_gateways/guardrail_list_params.rbi +40 -0
  278. data/rbi/telnyx/models/agent_gateways/guardrail_list_response.rbi +36 -0
  279. data/rbi/telnyx/models/agent_gateways/guardrail_update_params.rbi +199 -0
  280. data/rbi/telnyx/models/agent_gateways/key_create_params.rbi +122 -0
  281. data/rbi/telnyx/models/agent_gateways/key_create_response.rbi +199 -0
  282. data/rbi/telnyx/models/agent_gateways/key_delete_params.rbi +48 -0
  283. data/rbi/telnyx/models/agent_gateways/key_list_params.rbi +57 -0
  284. data/rbi/telnyx/models/agent_gateways/key_list_response.rbi +36 -0
  285. data/rbi/telnyx/models/agent_gateways/key_update_params.rbi +141 -0
  286. data/rbi/telnyx/models/agent_gateways/keys/agent_gateway_tool_permissions.rbi +96 -0
  287. data/rbi/telnyx/models/agent_gateways/keys/agent_gateway_tool_permissions_response.rbi +49 -0
  288. data/rbi/telnyx/models/agent_gateways/keys/tool_permission_create_params.rbi +50 -0
  289. data/rbi/telnyx/models/agent_gateways/keys/tool_permission_list_params.rbi +50 -0
  290. data/rbi/telnyx/models/agent_gateways/mcp_server_create_params.rbi +246 -0
  291. data/rbi/telnyx/models/agent_gateways/mcp_server_delete_params.rbi +48 -0
  292. data/rbi/telnyx/models/agent_gateways/mcp_server_list_params.rbi +40 -0
  293. data/rbi/telnyx/models/agent_gateways/mcp_server_list_response.rbi +36 -0
  294. data/rbi/telnyx/models/agent_gateways/mcp_server_update_params.rbi +258 -0
  295. data/rbi/telnyx/models/agent_gateways/policy_attachment_create_params.rbi +86 -0
  296. data/rbi/telnyx/models/agent_gateways/policy_attachment_delete_params.rbi +48 -0
  297. data/rbi/telnyx/models/agent_gateways/policy_attachment_list_params.rbi +40 -0
  298. data/rbi/telnyx/models/agent_gateways/policy_attachment_list_response.rbi +44 -0
  299. data/rbi/telnyx/models/agent_gateways/policy_create_params.rbi +133 -0
  300. data/rbi/telnyx/models/agent_gateways/policy_delete_params.rbi +48 -0
  301. data/rbi/telnyx/models/agent_gateways/policy_list_params.rbi +40 -0
  302. data/rbi/telnyx/models/agent_gateways/policy_list_response.rbi +36 -0
  303. data/rbi/telnyx/models/agent_gateways/policy_retrieve_params.rbi +48 -0
  304. data/rbi/telnyx/models/agent_gateways/policy_update_params.rbi +129 -0
  305. data/rbi/telnyx/models/agent_gateways/team_create_params.rbi +94 -0
  306. data/rbi/telnyx/models/agent_gateways/team_delete_params.rbi +48 -0
  307. data/rbi/telnyx/models/agent_gateways/team_list_params.rbi +40 -0
  308. data/rbi/telnyx/models/agent_gateways/team_list_response.rbi +36 -0
  309. data/rbi/telnyx/models/agent_gateways/team_update_params.rbi +119 -0
  310. data/rbi/telnyx/models/agent_gateways/teams/tool_permission_create_params.rbi +50 -0
  311. data/rbi/telnyx/models/agent_gateways/teams/tool_permission_list_params.rbi +50 -0
  312. data/rbi/telnyx/models/ai/chat_completion_request.rbi +6 -10
  313. data/rbi/telnyx/models/ai/conversation_delete_delete_params.rbi +48 -0
  314. data/rbi/telnyx/models/ai/external_llm.rbi +30 -0
  315. data/rbi/telnyx/models/ai/external_llm_req.rbi +30 -0
  316. data/rbi/telnyx/models/ai/inference_embedding_interruption_settings.rbi +29 -3
  317. data/rbi/telnyx/models/ai/inference_embedding_voice_settings.rbi +16 -0
  318. data/rbi/telnyx/models/ai/memory/namespaces/agent_memory_page_meta.rbi +81 -0
  319. data/rbi/telnyx/models/ai/memory/namespaces/namespace_settings.rbi +58 -0
  320. data/rbi/telnyx/models/ai/memory/namespaces/namespace_settings_response.rbi +4 -107
  321. data/rbi/telnyx/models/ai/memory/namespaces/page_meta.rbi +6 -17
  322. data/rbi/telnyx/models/ai/memory/namespaces/profile_ingest_params.rbi +2 -2
  323. data/rbi/telnyx/models/ai/memory/namespaces/profiles/source_retrieve_response.rbi +2 -2
  324. data/rbi/telnyx/models/ai/memory/namespaces/summary_settings.rbi +51 -0
  325. data/rbi/telnyx/models/ai/pay_tool_params.rbi +1943 -0
  326. data/rbi/telnyx/models/ai/privacy_settings.rbi +50 -22
  327. data/rbi/telnyx/models/ai/start_speaking_plan.rbi +33 -7
  328. data/rbi/telnyx/models/ai/telephony_settings.rbi +16 -0
  329. data/rbi/telnyx/models/ai/tests/test_framework/v1_retrieve_personalities_response.rbi +22 -13
  330. data/rbi/telnyx/models/ai/transcription_challenger.rbi +318 -0
  331. data/rbi/telnyx/models/ai/transcription_endpointing_plan.rbi +5 -1
  332. data/rbi/telnyx/models/ai/transcription_fallback_model.rbi +171 -0
  333. data/rbi/telnyx/models/ai/transcription_settings.rbi +7 -531
  334. data/rbi/telnyx/models/browser_session_create_params.rbi +4 -4
  335. data/rbi/telnyx/models/browser_sessions/action_response.rbi +11 -11
  336. data/rbi/telnyx/models/browser_sessions/wait_for_action.rbi +6 -6
  337. data/rbi/telnyx/models/calendar_connection.rbi +277 -0
  338. data/rbi/telnyx/models/calendar_connection_create_params.rbi +81 -0
  339. data/rbi/telnyx/models/calendar_connection_create_response.rbi +133 -0
  340. data/rbi/telnyx/models/calendar_connection_delete_params.rbi +38 -0
  341. data/rbi/telnyx/models/calendar_connection_list_params.rbi +27 -0
  342. data/rbi/telnyx/models/calendar_connection_list_response.rbi +30 -0
  343. data/rbi/telnyx/models/calendar_connection_response.rbi +30 -0
  344. data/rbi/telnyx/models/calendar_connection_retrieve_params.rbi +38 -0
  345. data/rbi/telnyx/models/calendar_connection_update_params.rbi +367 -0
  346. data/rbi/telnyx/models/calendar_connection_update_response.rbi +376 -0
  347. data/rbi/telnyx/models/calendar_connections/calendar_meeting.rbi +390 -0
  348. data/rbi/telnyx/models/calendar_connections/meeting_list_params.rbi +68 -0
  349. data/rbi/telnyx/models/calendar_connections/meeting_list_response.rbi +36 -0
  350. data/rbi/telnyx/models/calendar_connections/meeting_update_params.rbi +62 -0
  351. data/rbi/telnyx/models/calendar_connections/meeting_update_response.rbi +43 -0
  352. data/rbi/telnyx/models/call_analyzed_webhook_event.rbi +11 -16
  353. data/rbi/telnyx/models/calls/action_gather_using_ai_params.rbi +10 -5
  354. data/rbi/telnyx/models/calls/action_gather_using_speak_params.rbi +10 -5
  355. data/rbi/telnyx/models/calls/action_speak_params.rbi +10 -5
  356. data/rbi/telnyx/models/calls/action_start_conversation_relay_params.rbi +10 -5
  357. data/rbi/telnyx/models/calls/assembly_ai_voice_settings.rbi +67 -0
  358. data/rbi/telnyx/models/compute/funcs/func_log_export_config.rbi +175 -0
  359. data/rbi/telnyx/models/compute/funcs/func_log_export_config_response.rbi +4 -176
  360. data/rbi/telnyx/models/conferences/action_speak_params.rbi +10 -5
  361. data/rbi/telnyx/models/conversation_relay_embedded_config.rbi +10 -5
  362. data/rbi/telnyx/models/conversation_relay_language.rbi +10 -5
  363. data/rbi/telnyx/models/email_event_list_response.rbi +441 -548
  364. data/rbi/telnyx/models/email_template_common.rbi +3 -56
  365. data/rbi/telnyx/models/email_template_create_params.rbi +3 -59
  366. data/rbi/telnyx/models/enterprises/enterprise_email_verification_status.rbi +159 -0
  367. data/rbi/telnyx/models/enterprises/enterprise_email_verification_status_wrapped.rbi +4 -162
  368. data/rbi/telnyx/models/enterprises/reputation/external_verification.rbi +113 -0
  369. data/rbi/telnyx/models/enterprises/reputation/external_verification_wrapped.rbi +4 -108
  370. data/rbi/telnyx/models/generic_pay_connector_config.rbi +24 -24
  371. data/rbi/telnyx/models/llm_token_gateway/budget_duration.rbi +3 -3
  372. data/rbi/telnyx/models/meeting_bot/calendar_retrieve_oauth_callback_params.rbi +73 -0
  373. data/rbi/telnyx/models/meeting_bot/calendar_retrieve_oauth_callback_response.rbi +9 -0
  374. data/rbi/telnyx/models/meeting_session.rbi +218 -117
  375. data/rbi/telnyx/models/meeting_session_assistant.rbi +94 -0
  376. data/rbi/telnyx/models/meeting_session_create_params.rbi +196 -97
  377. data/rbi/telnyx/models/meeting_session_leave_policy.rbi +111 -0
  378. data/rbi/telnyx/models/meeting_session_recording_destination.rbi +46 -0
  379. data/rbi/telnyx/models/meeting_session_recording_export.rbi +115 -0
  380. data/rbi/telnyx/models/meeting_session_response.rbi +6 -6
  381. data/rbi/telnyx/models/meeting_session_retrieve_recordings_params.rbi +38 -0
  382. data/rbi/telnyx/models/meeting_session_retrieve_recordings_response.rbi +116 -0
  383. data/rbi/telnyx/models/meeting_session_retrieve_transcript_response.rbi +10 -0
  384. data/rbi/telnyx/models/meeting_sessions/action_send_chat_params.rbi +6 -2
  385. data/rbi/telnyx/models/message_whatsapp_params.rbi +20 -10
  386. data/rbi/telnyx/models/messaging_outbound_message_payload.rbi +26 -0
  387. data/rbi/telnyx/models/messaging_profile_features.rbi +36 -5
  388. data/rbi/telnyx/models/model_metadata.rbi +13 -0
  389. data/rbi/telnyx/models/number_lookup_retrieve_response.rbi +14 -1
  390. data/rbi/telnyx/models/outbound_message_payload.rbi +26 -0
  391. data/rbi/telnyx/models/pay_connector.rbi +4 -4
  392. data/rbi/telnyx/models/phone_numbers/numbers_phone_numbers_job.rbi +8 -96
  393. data/rbi/telnyx/models/phone_numbers/phone_numbers_job.rbi +8 -94
  394. data/rbi/telnyx/models/phone_numbers/phone_numbers_job_pending_operation.rbi +49 -0
  395. data/rbi/telnyx/models/phone_numbers/phone_numbers_job_successful_operation.rbi +49 -0
  396. data/rbi/telnyx/models/recording_export_failed_webhook_event.rbi +243 -0
  397. data/rbi/telnyx/models/recording_exported_webhook_event.rbi +171 -0
  398. data/rbi/telnyx/models/session.rbi +3 -3
  399. data/rbi/telnyx/models/session_status_changed_webhook_event.rbi +92 -3
  400. data/rbi/telnyx/models/telephony_credential.rbi +13 -0
  401. data/rbi/telnyx/models/telephony_credential_retrieve_token_material_params.rbi +38 -0
  402. data/rbi/telnyx/models/telephony_credential_retrieve_token_material_response.rbi +39 -0
  403. data/rbi/telnyx/models/text_to_speech_generate_speech_params.rbi +358 -0
  404. data/rbi/telnyx/models/text_to_speech_list_voices_params.rbi +5 -0
  405. data/rbi/telnyx/models/text_to_speech_retrieve_speech_params.rbi +5 -0
  406. data/rbi/telnyx/models/token_material.rbi +61 -0
  407. data/rbi/telnyx/models/unsafe_unwrap_webhook_event.rbi +2 -0
  408. data/rbi/telnyx/models/unwrap_webhook_event.rbi +2 -0
  409. data/rbi/telnyx/models/update_email_template_request.rbi +3 -59
  410. data/rbi/telnyx/models/user_profile.rbi +286 -0
  411. data/rbi/telnyx/models/user_profile_list_params.rbi +27 -0
  412. data/rbi/telnyx/models/user_profile_list_response.rbi +35 -0
  413. data/rbi/telnyx/models/user_profile_patch_all_params.rbi +582 -0
  414. data/rbi/telnyx/models/user_profile_patch_all_response.rbi +35 -0
  415. data/rbi/telnyx/models/variable_schema_entry.rbi +40 -0
  416. data/rbi/telnyx/models/voice_clone_create_from_upload_params.rbi +0 -10
  417. data/rbi/telnyx/models/voice_clone_data.rbi +2 -0
  418. data/rbi/telnyx/models/voice_clone_list_params.rbi +5 -0
  419. data/rbi/telnyx/models/whatsapp/hosted_signup_create_response.rbi +6 -173
  420. data/rbi/telnyx/models/whatsapp/hosted_signup_retrieve_response.rbi +6 -175
  421. data/rbi/telnyx/models/whatsapp/phone_number_get_response.rbi +4 -366
  422. data/rbi/telnyx/models/whatsapp/phone_number_retrieve_phone_number_response.rbi +6 -368
  423. data/rbi/telnyx/models/whatsapp/{hosted_signup_list_response.rbi → whatsapp_hosted_signup.rbi} +11 -12
  424. data/rbi/telnyx/models/whatsapp/{phone_number_list_response.rbi → whatsapp_phone_response.rbi} +23 -23
  425. data/rbi/telnyx/models.rbi +72 -0
  426. data/rbi/telnyx/resources/agent_gateways/apis.rbi +157 -0
  427. data/rbi/telnyx/resources/agent_gateways/guardrails.rbi +144 -0
  428. data/rbi/telnyx/resources/agent_gateways/keys/tool_permissions.rbi +68 -0
  429. data/rbi/telnyx/resources/agent_gateways/keys.rbi +153 -0
  430. data/rbi/telnyx/resources/agent_gateways/mcp_servers.rbi +157 -0
  431. data/rbi/telnyx/resources/agent_gateways/policies.rbi +151 -0
  432. data/rbi/telnyx/resources/agent_gateways/policy_attachments.rbi +74 -0
  433. data/rbi/telnyx/resources/agent_gateways/teams/tool_permissions.rbi +67 -0
  434. data/rbi/telnyx/resources/agent_gateways/teams.rbi +131 -0
  435. data/rbi/telnyx/resources/agent_gateways.rbi +159 -0
  436. data/rbi/telnyx/resources/ai/conversations.rbi +29 -1
  437. data/rbi/telnyx/resources/ai/openai/chat.rbi +3 -5
  438. data/rbi/telnyx/resources/browser_sessions.rbi +1 -1
  439. data/rbi/telnyx/resources/calendar_connections/meetings.rbi +62 -0
  440. data/rbi/telnyx/resources/calendar_connections.rbi +137 -0
  441. data/rbi/telnyx/resources/calls/actions.rbi +8 -4
  442. data/rbi/telnyx/resources/conferences/actions.rbi +2 -1
  443. data/rbi/telnyx/resources/email_events.rbi +5 -1
  444. data/rbi/telnyx/resources/email_templates.rbi +3 -18
  445. data/rbi/telnyx/resources/meeting_bot/calendar.rbi +38 -0
  446. data/rbi/telnyx/resources/{tts_integrations.rbi → meeting_bot.rbi} +4 -3
  447. data/rbi/telnyx/resources/meeting_sessions/actions.rbi +17 -11
  448. data/rbi/telnyx/resources/meeting_sessions/artifacts.rbi +8 -7
  449. data/rbi/telnyx/resources/meeting_sessions.rbi +96 -40
  450. data/rbi/telnyx/resources/portouts.rbi +2 -1
  451. data/rbi/telnyx/resources/telephony_credentials.rbi +19 -0
  452. data/rbi/telnyx/resources/text_to_speech.rbi +7 -2
  453. data/rbi/telnyx/resources/user_profile.rbi +164 -0
  454. data/rbi/telnyx/resources/webhooks.rbi +4 -0
  455. data/rbi/telnyx/resources/whatsapp/business_accounts/phone_numbers.rbi +1 -1
  456. data/rbi/telnyx/resources/whatsapp/hosted_signups.rbi +1 -1
  457. data/rbi/telnyx/resources/whatsapp/phone_numbers.rbi +1 -1
  458. data/sig/telnyx/client.rbs +8 -2
  459. data/sig/telnyx/internal/email_events_cursor_pagination.rbs +24 -0
  460. data/sig/telnyx/models/agent_gateway.rbs +74 -0
  461. data/sig/telnyx/models/agent_gateway_create_params.rbs +28 -0
  462. data/sig/telnyx/models/agent_gateway_delete_params.rbs +23 -0
  463. data/sig/telnyx/models/agent_gateway_list_params.rbs +32 -0
  464. data/sig/telnyx/models/agent_gateway_response.rbs +13 -0
  465. data/sig/telnyx/models/agent_gateway_retrieve_models_params.rbs +23 -0
  466. data/sig/telnyx/models/agent_gateway_retrieve_models_response.rbs +94 -0
  467. data/sig/telnyx/models/agent_gateway_retrieve_params.rbs +23 -0
  468. data/sig/telnyx/models/agent_gateway_retrieve_spend_logs_params.rbs +68 -0
  469. data/sig/telnyx/models/agent_gateway_retrieve_spend_logs_response.rbs +139 -0
  470. data/sig/telnyx/models/agent_gateways/agent_gateway_api.rbs +74 -0
  471. data/sig/telnyx/models/agent_gateways/agent_gateway_api_response.rbs +18 -0
  472. data/sig/telnyx/models/agent_gateways/agent_gateway_aws_sig_v4_auth.rbs +56 -0
  473. data/sig/telnyx/models/agent_gateways/agent_gateway_guardrail.rbs +107 -0
  474. data/sig/telnyx/models/agent_gateways/agent_gateway_guardrail_response.rbs +20 -0
  475. data/sig/telnyx/models/agent_gateways/agent_gateway_key.rbs +89 -0
  476. data/sig/telnyx/models/agent_gateways/agent_gateway_key_response.rbs +18 -0
  477. data/sig/telnyx/models/agent_gateways/agent_gateway_mcp_server.rbs +85 -0
  478. data/sig/telnyx/models/agent_gateways/agent_gateway_mcp_server_response.rbs +20 -0
  479. data/sig/telnyx/models/agent_gateways/agent_gateway_no_auth.rbs +36 -0
  480. data/sig/telnyx/models/agent_gateways/agent_gateway_oauth_client_credentials.rbs +76 -0
  481. data/sig/telnyx/models/agent_gateways/agent_gateway_passthrough_auth.rbs +38 -0
  482. data/sig/telnyx/models/agent_gateways/agent_gateway_policy.rbs +59 -0
  483. data/sig/telnyx/models/agent_gateways/agent_gateway_policy_attachment.rbs +54 -0
  484. data/sig/telnyx/models/agent_gateways/agent_gateway_policy_attachment_response.rbs +22 -0
  485. data/sig/telnyx/models/agent_gateways/agent_gateway_policy_guardrails.rbs +27 -0
  486. data/sig/telnyx/models/agent_gateways/agent_gateway_policy_pipeline.rbs +40 -0
  487. data/sig/telnyx/models/agent_gateways/agent_gateway_policy_response.rbs +20 -0
  488. data/sig/telnyx/models/agent_gateways/agent_gateway_policy_step.rbs +98 -0
  489. data/sig/telnyx/models/agent_gateways/agent_gateway_shown_auth.rbs +17 -0
  490. data/sig/telnyx/models/agent_gateways/agent_gateway_static_auth.rbs +48 -0
  491. data/sig/telnyx/models/agent_gateways/agent_gateway_team.rbs +74 -0
  492. data/sig/telnyx/models/agent_gateways/agent_gateway_team_response.rbs +18 -0
  493. data/sig/telnyx/models/agent_gateways/api_create_params.rbs +92 -0
  494. data/sig/telnyx/models/agent_gateways/api_delete_params.rbs +30 -0
  495. data/sig/telnyx/models/agent_gateways/api_list_params.rbs +25 -0
  496. data/sig/telnyx/models/agent_gateways/api_list_response.rbs +20 -0
  497. data/sig/telnyx/models/agent_gateways/api_update_params.rbs +101 -0
  498. data/sig/telnyx/models/agent_gateways/guardrail_create_params.rbs +105 -0
  499. data/sig/telnyx/models/agent_gateways/guardrail_delete_params.rbs +30 -0
  500. data/sig/telnyx/models/agent_gateways/guardrail_list_params.rbs +25 -0
  501. data/sig/telnyx/models/agent_gateways/guardrail_list_response.rbs +20 -0
  502. data/sig/telnyx/models/agent_gateways/guardrail_update_params.rbs +86 -0
  503. data/sig/telnyx/models/agent_gateways/key_create_params.rbs +73 -0
  504. data/sig/telnyx/models/agent_gateways/key_create_response.rbs +107 -0
  505. data/sig/telnyx/models/agent_gateways/key_delete_params.rbs +30 -0
  506. data/sig/telnyx/models/agent_gateways/key_list_params.rbs +32 -0
  507. data/sig/telnyx/models/agent_gateways/key_list_response.rbs +20 -0
  508. data/sig/telnyx/models/agent_gateways/key_update_params.rbs +89 -0
  509. data/sig/telnyx/models/agent_gateways/keys/agent_gateway_tool_permissions.rbs +38 -0
  510. data/sig/telnyx/models/agent_gateways/keys/agent_gateway_tool_permissions_response.rbs +22 -0
  511. data/sig/telnyx/models/agent_gateways/keys/tool_permission_create_params.rbs +36 -0
  512. data/sig/telnyx/models/agent_gateways/keys/tool_permission_list_params.rbs +32 -0
  513. data/sig/telnyx/models/agent_gateways/mcp_server_create_params.rbs +108 -0
  514. data/sig/telnyx/models/agent_gateways/mcp_server_delete_params.rbs +30 -0
  515. data/sig/telnyx/models/agent_gateways/mcp_server_list_params.rbs +25 -0
  516. data/sig/telnyx/models/agent_gateways/mcp_server_list_response.rbs +20 -0
  517. data/sig/telnyx/models/agent_gateways/mcp_server_update_params.rbs +117 -0
  518. data/sig/telnyx/models/agent_gateways/policy_attachment_create_params.rbs +52 -0
  519. data/sig/telnyx/models/agent_gateways/policy_attachment_delete_params.rbs +30 -0
  520. data/sig/telnyx/models/agent_gateways/policy_attachment_list_params.rbs +25 -0
  521. data/sig/telnyx/models/agent_gateways/policy_attachment_list_response.rbs +20 -0
  522. data/sig/telnyx/models/agent_gateways/policy_create_params.rbs +62 -0
  523. data/sig/telnyx/models/agent_gateways/policy_delete_params.rbs +30 -0
  524. data/sig/telnyx/models/agent_gateways/policy_list_params.rbs +25 -0
  525. data/sig/telnyx/models/agent_gateways/policy_list_response.rbs +20 -0
  526. data/sig/telnyx/models/agent_gateways/policy_retrieve_params.rbs +30 -0
  527. data/sig/telnyx/models/agent_gateways/policy_update_params.rbs +62 -0
  528. data/sig/telnyx/models/agent_gateways/team_create_params.rbs +58 -0
  529. data/sig/telnyx/models/agent_gateways/team_delete_params.rbs +30 -0
  530. data/sig/telnyx/models/agent_gateways/team_list_params.rbs +25 -0
  531. data/sig/telnyx/models/agent_gateways/team_list_response.rbs +20 -0
  532. data/sig/telnyx/models/agent_gateways/team_update_params.rbs +74 -0
  533. data/sig/telnyx/models/agent_gateways/teams/tool_permission_create_params.rbs +36 -0
  534. data/sig/telnyx/models/agent_gateways/teams/tool_permission_list_params.rbs +32 -0
  535. data/sig/telnyx/models/ai/conversation_delete_delete_params.rbs +30 -0
  536. data/sig/telnyx/models/ai/external_llm.rbs +5 -0
  537. data/sig/telnyx/models/ai/external_llm_req.rbs +5 -0
  538. data/sig/telnyx/models/ai/inference_embedding_interruption_settings.rbs +4 -8
  539. data/sig/telnyx/models/ai/inference_embedding_voice_settings.rbs +5 -0
  540. data/sig/telnyx/models/ai/memory/namespaces/agent_memory_page_meta.rbs +41 -0
  541. data/sig/telnyx/models/ai/memory/namespaces/namespace_settings.rbs +30 -0
  542. data/sig/telnyx/models/ai/memory/namespaces/namespace_settings_response.rbs +4 -37
  543. data/sig/telnyx/models/ai/memory/namespaces/profile_ingest_params.rbs +2 -2
  544. data/sig/telnyx/models/ai/memory/namespaces/profiles/source_retrieve_response.rbs +2 -2
  545. data/sig/telnyx/models/ai/memory/namespaces/summary_settings.rbs +19 -0
  546. data/sig/telnyx/models/ai/pay_tool_params.rbs +768 -0
  547. data/sig/telnyx/models/ai/start_speaking_plan.rbs +4 -8
  548. data/sig/telnyx/models/ai/telephony_settings.rbs +5 -0
  549. data/sig/telnyx/models/ai/tests/test_framework/v1_retrieve_personalities_response.rbs +19 -17
  550. data/sig/telnyx/models/ai/transcription_challenger.rbs +98 -0
  551. data/sig/telnyx/models/ai/transcription_fallback_model.rbs +63 -0
  552. data/sig/telnyx/models/ai/transcription_settings.rbs +8 -159
  553. data/sig/telnyx/models/browser_session_create_params.rbs +5 -5
  554. data/sig/telnyx/models/browser_sessions/action_response.rbs +16 -14
  555. data/sig/telnyx/models/browser_sessions/wait_for_action.rbs +3 -3
  556. data/sig/telnyx/models/calendar_connection.rbs +131 -0
  557. data/sig/telnyx/models/calendar_connection_create_params.rbs +35 -0
  558. data/sig/telnyx/models/calendar_connection_create_response.rbs +56 -0
  559. data/sig/telnyx/models/calendar_connection_delete_params.rbs +20 -0
  560. data/sig/telnyx/models/calendar_connection_list_params.rbs +15 -0
  561. data/sig/telnyx/models/calendar_connection_list_response.rbs +14 -0
  562. data/sig/telnyx/models/calendar_connection_response.rbs +13 -0
  563. data/sig/telnyx/models/calendar_connection_retrieve_params.rbs +20 -0
  564. data/sig/telnyx/models/calendar_connection_update_params.rbs +141 -0
  565. data/sig/telnyx/models/calendar_connection_update_response.rbs +153 -0
  566. data/sig/telnyx/models/calendar_connections/calendar_meeting.rbs +168 -0
  567. data/sig/telnyx/models/calendar_connections/meeting_list_params.rbs +38 -0
  568. data/sig/telnyx/models/calendar_connections/meeting_list_response.rbs +20 -0
  569. data/sig/telnyx/models/calendar_connections/meeting_update_params.rbs +34 -0
  570. data/sig/telnyx/models/calendar_connections/meeting_update_response.rbs +18 -0
  571. data/sig/telnyx/models/call_analyzed_webhook_event.rbs +9 -9
  572. data/sig/telnyx/models/calls/action_gather_using_ai_params.rbs +1 -0
  573. data/sig/telnyx/models/calls/action_gather_using_speak_params.rbs +1 -0
  574. data/sig/telnyx/models/calls/action_speak_params.rbs +1 -0
  575. data/sig/telnyx/models/calls/action_start_conversation_relay_params.rbs +1 -0
  576. data/sig/telnyx/models/calls/assembly_ai_voice_settings.rbs +30 -0
  577. data/sig/telnyx/models/compute/funcs/func_log_export_config.rbs +96 -0
  578. data/sig/telnyx/models/compute/funcs/func_log_export_config_response.rbs +6 -95
  579. data/sig/telnyx/models/conferences/action_speak_params.rbs +1 -0
  580. data/sig/telnyx/models/conversation_relay_embedded_config.rbs +1 -0
  581. data/sig/telnyx/models/conversation_relay_language.rbs +1 -0
  582. data/sig/telnyx/models/email_event_list_response.rbs +171 -222
  583. data/sig/telnyx/models/email_template_common.rbs +4 -18
  584. data/sig/telnyx/models/email_template_create_params.rbs +4 -18
  585. data/sig/telnyx/models/enterprises/enterprise_email_verification_status.rbs +65 -0
  586. data/sig/telnyx/models/enterprises/enterprise_email_verification_status_wrapped.rbs +4 -64
  587. data/sig/telnyx/models/enterprises/reputation/external_verification.rbs +64 -0
  588. data/sig/telnyx/models/enterprises/reputation/external_verification_wrapped.rbs +4 -61
  589. data/sig/telnyx/models/generic_pay_connector_config.rbs +30 -30
  590. data/sig/telnyx/models/llm_token_gateway/budget_duration.rbs +3 -3
  591. data/sig/telnyx/models/meeting_bot/calendar_retrieve_oauth_callback_params.rbs +40 -0
  592. data/sig/telnyx/models/meeting_bot/calendar_retrieve_oauth_callback_response.rbs +7 -0
  593. data/sig/telnyx/models/meeting_session.rbs +79 -57
  594. data/sig/telnyx/models/meeting_session_assistant.rbs +46 -0
  595. data/sig/telnyx/models/meeting_session_create_params.rbs +47 -0
  596. data/sig/telnyx/models/meeting_session_leave_policy.rbs +60 -0
  597. data/sig/telnyx/models/meeting_session_recording_destination.rbs +18 -0
  598. data/sig/telnyx/models/meeting_session_recording_export.rbs +62 -0
  599. data/sig/telnyx/models/meeting_session_retrieve_recordings_params.rbs +20 -0
  600. data/sig/telnyx/models/meeting_session_retrieve_recordings_response.rbs +39 -0
  601. data/sig/telnyx/models/message_whatsapp_params.rbs +20 -10
  602. data/sig/telnyx/models/messaging_outbound_message_payload.rbs +10 -0
  603. data/sig/telnyx/models/messaging_profile_features.rbs +14 -3
  604. data/sig/telnyx/models/model_metadata.rbs +7 -0
  605. data/sig/telnyx/models/number_lookup_retrieve_response.rbs +13 -3
  606. data/sig/telnyx/models/outbound_message_payload.rbs +10 -0
  607. data/sig/telnyx/models/pay_connector.rbs +5 -5
  608. data/sig/telnyx/models/phone_numbers/numbers_phone_numbers_job.rbs +12 -44
  609. data/sig/telnyx/models/phone_numbers/phone_numbers_job.rbs +12 -44
  610. data/sig/telnyx/models/phone_numbers/phone_numbers_job_pending_operation.rbs +24 -0
  611. data/sig/telnyx/models/phone_numbers/phone_numbers_job_successful_operation.rbs +24 -0
  612. data/sig/telnyx/models/recording_export_failed_webhook_event.rbs +121 -0
  613. data/sig/telnyx/models/recording_exported_webhook_event.rbs +97 -0
  614. data/sig/telnyx/models/session.rbs +4 -4
  615. data/sig/telnyx/models/session_status_changed_webhook_event.rbs +37 -3
  616. data/sig/telnyx/models/telephony_credential.rbs +7 -0
  617. data/sig/telnyx/models/telephony_credential_retrieve_token_material_params.rbs +20 -0
  618. data/sig/telnyx/models/telephony_credential_retrieve_token_material_response.rbs +16 -0
  619. data/sig/telnyx/models/text_to_speech_generate_speech_params.rbs +118 -0
  620. data/sig/telnyx/models/text_to_speech_list_voices_params.rbs +2 -0
  621. data/sig/telnyx/models/text_to_speech_retrieve_speech_params.rbs +2 -0
  622. data/sig/telnyx/models/token_material.rbs +28 -0
  623. data/sig/telnyx/models/unsafe_unwrap_webhook_event.rbs +2 -0
  624. data/sig/telnyx/models/unwrap_webhook_event.rbs +2 -0
  625. data/sig/telnyx/models/update_email_template_request.rbs +4 -18
  626. data/sig/telnyx/models/user_profile.rbs +147 -0
  627. data/sig/telnyx/models/user_profile_list_params.rbs +15 -0
  628. data/sig/telnyx/models/user_profile_list_response.rbs +13 -0
  629. data/sig/telnyx/models/user_profile_patch_all_params.rbs +302 -0
  630. data/sig/telnyx/models/user_profile_patch_all_response.rbs +13 -0
  631. data/sig/telnyx/models/variable_schema_entry.rbs +17 -0
  632. data/sig/telnyx/models/voice_clone_create_from_upload_params.rbs +2 -4
  633. data/sig/telnyx/models/voice_clone_data.rbs +2 -1
  634. data/sig/telnyx/models/voice_clone_list_params.rbs +2 -1
  635. data/sig/telnyx/models/whatsapp/hosted_signup_create_response.rbs +6 -90
  636. data/sig/telnyx/models/whatsapp/hosted_signup_retrieve_response.rbs +6 -90
  637. data/sig/telnyx/models/whatsapp/phone_number_get_response.rbs +6 -185
  638. data/sig/telnyx/models/whatsapp/phone_number_retrieve_phone_number_response.rbs +4 -189
  639. data/sig/telnyx/models/whatsapp/{hosted_signup_list_response.rbs → whatsapp_hosted_signup.rbs} +11 -9
  640. data/sig/telnyx/models/whatsapp/{phone_number_list_response.rbs → whatsapp_phone_response.rbs} +13 -11
  641. data/sig/telnyx/models.rbs +62 -0
  642. data/sig/telnyx/resources/agent_gateways/apis.rbs +47 -0
  643. data/sig/telnyx/resources/agent_gateways/guardrails.rbs +40 -0
  644. data/sig/telnyx/resources/agent_gateways/keys/tool_permissions.rbs +24 -0
  645. data/sig/telnyx/resources/agent_gateways/keys.rbs +53 -0
  646. data/sig/telnyx/resources/agent_gateways/mcp_servers.rbs +47 -0
  647. data/sig/telnyx/resources/agent_gateways/policies.rbs +48 -0
  648. data/sig/telnyx/resources/agent_gateways/policy_attachments.rbs +29 -0
  649. data/sig/telnyx/resources/agent_gateways/teams/tool_permissions.rbs +24 -0
  650. data/sig/telnyx/resources/agent_gateways/teams.rbs +46 -0
  651. data/sig/telnyx/resources/agent_gateways.rbs +59 -0
  652. data/sig/telnyx/resources/ai/conversations.rbs +6 -0
  653. data/sig/telnyx/resources/browser_sessions.rbs +1 -1
  654. data/sig/telnyx/resources/calendar_connections/meetings.rbs +23 -0
  655. data/sig/telnyx/resources/calendar_connections.rbs +42 -0
  656. data/sig/telnyx/resources/email_events.rbs +1 -1
  657. data/sig/telnyx/resources/email_templates.rbs +3 -3
  658. data/sig/telnyx/resources/meeting_bot/calendar.rbs +16 -0
  659. data/sig/telnyx/resources/{tts_integrations.rbs → meeting_bot.rbs} +2 -2
  660. data/sig/telnyx/resources/meeting_sessions.rbs +9 -0
  661. data/sig/telnyx/resources/telephony_credentials.rbs +5 -0
  662. data/sig/telnyx/resources/text_to_speech.rbs +1 -0
  663. data/sig/telnyx/resources/user_profile.rbs +52 -0
  664. data/sig/telnyx/resources/webhooks.rbs +4 -0
  665. data/sig/telnyx/resources/whatsapp/business_accounts/phone_numbers.rbs +1 -1
  666. data/sig/telnyx/resources/whatsapp/hosted_signups.rbs +1 -1
  667. data/sig/telnyx/resources/whatsapp/phone_numbers.rbs +1 -1
  668. metadata +423 -17
  669. data/lib/telnyx/models/whatsapp/business_accounts/phone_number_list_response.rb +0 -198
  670. data/lib/telnyx/resources/tts_integrations/actions.rb +0 -16
  671. data/lib/telnyx/resources/tts_integrations.rb +0 -18
  672. data/rbi/telnyx/models/whatsapp/business_accounts/phone_number_list_response.rbi +0 -358
  673. data/rbi/telnyx/resources/tts_integrations/actions.rbi +0 -14
  674. data/sig/telnyx/models/whatsapp/business_accounts/phone_number_list_response.rbs +0 -186
  675. data/sig/telnyx/resources/tts_integrations/actions.rbs +0 -9
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: a8a0d9edaab7084b74be27c5c41e73fc0089a2ef12cddd59fb974320a0144439
4
- data.tar.gz: 5657256ca67f97cade75834a3247666105fdb2e05853aed4a5e54d84f40fefe8
3
+ metadata.gz: f357d208801e3a8d7f0ccdc1f6ba2c65fd0f16237a2d44e4bcf1b355cf479fce
4
+ data.tar.gz: f9118e3971988965b6796b3a5b8901a9317de1ca8306e7579ae17f78b6e03cfa
5
5
  SHA512:
6
- metadata.gz: 9fae567fb853b28065d5791761ce257b840a971e8628c5b31930b74c7f45b21ee1e707903bf26921eff9f2538249dd55cca5f3c39b8550b038ffd9d33e011d51
7
- data.tar.gz: 0073a20d3cf951262e622b5caf07990c4ee8e80085e0c18a6f9e3e6639d5d26cec68f7cb54883a0c48e8c9a2fea22e9a89f8ec9ad98e475cc3c299db27b47784
6
+ metadata.gz: b5b614d8ca48cc67922c1b0e3154998fe5954c33f57a77ec758681d7134f10a288aa6864ffb1654fe1643d0e5d47cf8b2bf4cb903be6296b38a29050c536e364
7
+ data.tar.gz: 7702cb2014bc02418d6e29a207bf186b6fa7218291dcc5ca7296de1e6f6f3ded70a921403822e5fcd4d5746a74e13a871d5951635845e051827da1cd0c3da657
data/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # Changelog
2
2
 
3
+ ## [5.175.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.174.0...v5.175.0) (2026-11-06)
4
+
5
+
6
+ ### Features
7
+
8
+ * promote from staging f1eb561 ([ff861fc](https://github.com/team-telnyx/telnyx-ruby/commit/ff861fcca600d7fc83d93e9cea9c1b16a9bdd5ac))
9
+
10
+ ## [5.174.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.173.0...v5.174.0) (2026-10-29)
11
+
12
+
13
+ ### Features
14
+
15
+ * promote from staging 458522c ([15f8625](https://github.com/team-telnyx/telnyx-ruby/commit/15f86251ff7ccfc9ec222355907441ddc10b1b07))
16
+
3
17
  ## [5.173.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.172.0...v5.173.0) (2026-10-28)
4
18
 
5
19
 
data/README.md CHANGED
@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
24
24
  <!-- x-release-please-start-version -->
25
25
 
26
26
  ```ruby
27
- gem "telnyx", "~> 5.173.0"
27
+ gem "telnyx", "~> 5.175.0"
28
28
  ```
29
29
 
30
30
  <!-- x-release-please-end -->
data/lib/telnyx/client.rb CHANGED
@@ -824,9 +824,6 @@ module Telnyx
824
824
  # @return [Telnyx::Resources::DialMetrics]
825
825
  attr_reader :dial_metrics
826
826
 
827
- # @return [Telnyx::Resources::TtsIntegrations]
828
- attr_reader :tts_integrations
829
-
830
827
  # Tailscale Subnet Router operations
831
828
  # @return [Telnyx::Resources::TailscaleSubnetRouters]
832
829
  attr_reader :tailscale_subnet_routers
@@ -851,6 +848,20 @@ module Telnyx
851
848
  # @return [Telnyx::Resources::Tunnels]
852
849
  attr_reader :tunnels
853
850
 
851
+ # Read and update the authenticated user's profile and data locality.
852
+ # @return [Telnyx::Resources::UserProfile]
853
+ attr_reader :user_profile
854
+
855
+ # @return [Telnyx::Resources::AgentGateways]
856
+ attr_reader :agent_gateways
857
+
858
+ # Connect calendars and manage automatic meeting joins.
859
+ # @return [Telnyx::Resources::CalendarConnections]
860
+ attr_reader :calendar_connections
861
+
862
+ # @return [Telnyx::Resources::MeetingBot]
863
+ attr_reader :meeting_bot
864
+
854
865
  # @api private
855
866
  #
856
867
  # @return [Hash{String=>String}]
@@ -1153,13 +1164,16 @@ module Telnyx
1153
1164
  @llm_token_gateway = Telnyx::Resources::LlmTokenGateway.new(client: self)
1154
1165
  @sip_registration_status = Telnyx::Resources::SipRegistrationStatus.new(client: self)
1155
1166
  @dial_metrics = Telnyx::Resources::DialMetrics.new(client: self)
1156
- @tts_integrations = Telnyx::Resources::TtsIntegrations.new(client: self)
1157
1167
  @tailscale_subnet_routers = Telnyx::Resources::TailscaleSubnetRouters.new(client: self)
1158
1168
  @artifact_downloads = Telnyx::Resources::ArtifactDownloads.new(client: self)
1159
1169
  @email = Telnyx::Resources::Email.new(client: self)
1160
1170
  @network_routes = Telnyx::Resources::NetworkRoutes.new(client: self)
1161
1171
  @pay_connectors = Telnyx::Resources::PayConnectors.new(client: self)
1162
1172
  @tunnels = Telnyx::Resources::Tunnels.new(client: self)
1173
+ @user_profile = Telnyx::Resources::UserProfile.new(client: self)
1174
+ @agent_gateways = Telnyx::Resources::AgentGateways.new(client: self)
1175
+ @calendar_connections = Telnyx::Resources::CalendarConnections.new(client: self)
1176
+ @meeting_bot = Telnyx::Resources::MeetingBot.new(client: self)
1163
1177
  end
1164
1178
  end
1165
1179
  end
@@ -0,0 +1,104 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Telnyx
4
+ module Internal
5
+ # @generic Elem
6
+ #
7
+ # @example
8
+ # if email_events_cursor_pagination.has_next?
9
+ # email_events_cursor_pagination = email_events_cursor_pagination.next_page
10
+ # end
11
+ #
12
+ # @example
13
+ # email_events_cursor_pagination.auto_paging_each do |email_event|
14
+ # puts(email_event)
15
+ # end
16
+ class EmailEventsCursorPagination
17
+ include Telnyx::Internal::Type::BasePage
18
+
19
+ # @return [Array<generic<Elem>>, nil]
20
+ attr_accessor :data
21
+
22
+ # @return [Meta]
23
+ attr_accessor :meta
24
+
25
+ # @return [Boolean]
26
+ def next_page?
27
+ !data.to_a.empty? && !meta&.page_cursor.to_s.empty?
28
+ end
29
+
30
+ # @raise [Telnyx::HTTP::Error]
31
+ # @return [self]
32
+ def next_page
33
+ unless next_page?
34
+ message = "No more pages available. Please check #next_page? before calling ##{__method__}"
35
+ raise RuntimeError.new(message)
36
+ end
37
+
38
+ req = Telnyx::Internal::Util.deep_merge(@req, {query: {"page[cursor]": meta&.page_cursor}})
39
+ @client.request(req)
40
+ end
41
+
42
+ # @param blk [Proc]
43
+ #
44
+ # @yieldparam [generic<Elem>]
45
+ def auto_paging_each(&blk)
46
+ unless block_given?
47
+ raise ArgumentError.new("A block must be given to ##{__method__}")
48
+ end
49
+
50
+ page = self
51
+ loop do
52
+ page.data&.each(&blk)
53
+
54
+ break unless page.next_page?
55
+ page = page.next_page
56
+ end
57
+ end
58
+
59
+ # @api private
60
+ #
61
+ # @param client [Telnyx::Internal::Transport::BaseClient]
62
+ # @param req [Hash{Symbol=>Object}]
63
+ # @param headers [Hash{String=>String}]
64
+ # @param page_data [Hash{Symbol=>Object}]
65
+ def initialize(client:, req:, headers:, page_data:)
66
+ super
67
+
68
+ case page_data
69
+ in {data: Array => data}
70
+ @data = data.map { Telnyx::Internal::Type::Converter.coerce(@model, _1) }
71
+ else
72
+ end
73
+ case page_data
74
+ in {meta: Hash | nil => meta}
75
+ @meta =
76
+ Telnyx::Internal::Type::Converter.coerce(
77
+ Telnyx::Internal::EmailEventsCursorPagination::Meta,
78
+ meta
79
+ )
80
+ else
81
+ end
82
+ end
83
+
84
+ # @api private
85
+ #
86
+ # @return [String]
87
+ def inspect
88
+ model = Telnyx::Internal::Type::Converter.inspect(@model, depth: 1)
89
+
90
+ "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)}>"
91
+ end
92
+
93
+ class Meta < Telnyx::Internal::Type::BaseModel
94
+ # @!attribute page_cursor
95
+ #
96
+ # @return [String, nil]
97
+ optional :page_cursor, String
98
+
99
+ # @!method initialize(page_cursor: nil)
100
+ # @param page_cursor [String]
101
+ end
102
+ end
103
+ end
104
+ end
@@ -0,0 +1,141 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "base64"
4
+ require "json"
5
+ require "openssl"
6
+
7
+ module Telnyx
8
+ module Lib
9
+ # Mints a WebRTC login token for a telephony credential locally, with no
10
+ # request to Telnyx.
11
+ #
12
+ # The token has the same shape as the one `POST /v2/telephony_credentials/:id/token`
13
+ # (`client.telephony_credentials.create_token`) returns, so it is used the
14
+ # same way: pass it to the WebRTC SDK as `login_token`. Telnyx verifies it
15
+ # on login.
16
+ #
17
+ # The signing material comes from the credential: `token_material` is in the
18
+ # response of `POST /v2/telephony_credentials` and of
19
+ # `GET /v2/telephony_credentials/:id/token_material`. It is as sensitive as
20
+ # the SIP password, so keep it on the server; never ship it to a browser.
21
+ #
22
+ # credential = client.telephony_credentials.create(connection_id: "123")
23
+ # client.telephony_credentials.to_jwt(credential) # 1 hour
24
+ # client.telephony_credentials.to_jwt(credential, ttl: 600) # 10 minutes
25
+ #
26
+ # Or from stored values, with no client at all:
27
+ #
28
+ # Telnyx::Lib::AccessToken.new(
29
+ # credential_id: "...", user_id: "...", identity: "gencred...",
30
+ # expires_at: "2027-01-01T00:00:00Z",
31
+ # token_material: {kid: "v1", tel_token: "...", signing_secret: "..."}
32
+ # ).to_jwt
33
+ class AccessToken
34
+ DEFAULT_TTL = 3600
35
+ MAX_TTL = 86_400
36
+ CONTENT_TYPE = "telnyx-webrtc;v=1"
37
+ ALGORITHM = "HS256"
38
+ MATERIAL_FIELDS = [:kid, :tel_token, :signing_secret].freeze
39
+
40
+ # Raised by {AccessToken.decode} when the signature does not match.
41
+ class SignatureError < StandardError
42
+ end
43
+
44
+ attr_reader :credential_id, :user_id, :identity, :expires_at, :ttl
45
+
46
+ # @param credential_id [String] the telephony credential `id`
47
+ # @param user_id [String] the credential's `user_id`
48
+ # @param identity [String] the credential's `sip_username`
49
+ # @param token_material [Hash, Telnyx::Internal::Type::BaseModel] `kid`, `tel_token`, `signing_secret`
50
+ # @param expires_at [String, nil] the credential's `expires_at`, as the API returns it
51
+ # @param ttl [Integer] token lifetime in seconds, 1..86400; default one hour
52
+ def initialize(credential_id:, user_id:, identity:, token_material:, expires_at: nil, ttl: DEFAULT_TTL)
53
+ @credential_id = required(credential_id, "credential_id")
54
+ @user_id = required(user_id, "user_id")
55
+ @identity = required(identity, "identity")
56
+ @expires_at = expires_at
57
+ @material = normalize_material(token_material)
58
+ @ttl = Integer(ttl).clamp(1, MAX_TTL)
59
+ end
60
+
61
+ # The signed token, valid from `now` for `ttl` seconds.
62
+ #
63
+ # @param now [Time]
64
+ #
65
+ # @return [String]
66
+ def to_jwt(now: Time.now)
67
+ iat = now.to_i
68
+ header = {alg: ALGORITHM, typ: "JWT", cty: CONTENT_TYPE, kid: @material.fetch(:kid)}
69
+ payload = {
70
+ sub: credential_id,
71
+ user_id: user_id,
72
+ identity: identity,
73
+ cred_exp: expires_at,
74
+ tel_token: @material.fetch(:tel_token),
75
+ iat: iat,
76
+ nbf: iat,
77
+ exp: iat + ttl,
78
+ jti: "#{credential_id}-#{iat}"
79
+ }
80
+
81
+ signing_input = "#{encode(JSON.generate(header))}.#{encode(JSON.generate(payload))}"
82
+ "#{signing_input}.#{encode(self.class.sign(signing_input, @material.fetch(:signing_secret)))}"
83
+ end
84
+
85
+ alias_method :to_s, :to_jwt
86
+
87
+ class << self
88
+ # Decodes a token minted by this class and checks its signature against
89
+ # `signing_secret`. Meant for tests and debugging: Telnyx does the real
90
+ # verification on login.
91
+ #
92
+ # @param jwt [String]
93
+ # @param signing_secret [String] base64url, as in `token_material`
94
+ #
95
+ # @raise [Telnyx::Lib::AccessToken::SignatureError] if the signature does not match
96
+ # @return [Hash{String=>Object}] the claims
97
+ def decode(jwt, signing_secret:)
98
+ head, body, sig = jwt.to_s.split(".")
99
+ raise ArgumentError.new("not a JWT") if sig.nil?
100
+
101
+ expected = sign("#{head}.#{body}", signing_secret)
102
+ given = Base64.urlsafe_decode64(sig)
103
+ valid = given.bytesize == expected.bytesize && OpenSSL.fixed_length_secure_compare(given, expected)
104
+ raise SignatureError.new("signature does not match the payload") unless valid
105
+
106
+ JSON.parse(Base64.urlsafe_decode64(body))
107
+ end
108
+
109
+ # @param signing_input [String]
110
+ # @param signing_secret [String] base64url
111
+ #
112
+ # @return [String] raw HMAC-SHA256 bytes
113
+ def sign(signing_input, signing_secret)
114
+ OpenSSL::HMAC.digest("SHA256", Base64.urlsafe_decode64(signing_secret), signing_input)
115
+ end
116
+ end
117
+
118
+ private
119
+
120
+ def encode(bytes) = Base64.urlsafe_encode64(bytes, padding: false)
121
+
122
+ def required(value, name)
123
+ raise ArgumentError.new("#{name} is required to mint a token") if value.nil? || value.to_s.empty?
124
+
125
+ value.to_s
126
+ end
127
+
128
+ def normalize_material(material)
129
+ hash = material.respond_to?(:to_hash) ? material.to_hash : material
130
+ raise ArgumentError.new("token_material is required to mint a token") unless hash.is_a?(Hash)
131
+
132
+ MATERIAL_FIELDS.to_h do |field|
133
+ value = hash[field] || hash[field.to_s]
134
+ raise ArgumentError.new("token_material.#{field} is missing") if value.nil? || value.to_s.empty?
135
+
136
+ [field, value.to_s]
137
+ end
138
+ end
139
+ end
140
+ end
141
+ end
@@ -0,0 +1,87 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative "access_token"
4
+
5
+ module Telnyx
6
+ module Lib
7
+ # Local WebRTC login tokens for `client.telephony_credentials`. Mixed into
8
+ # the generated {Telnyx::Resources::TelephonyCredentials} from `lib/telnyx/lib.rb`,
9
+ # so it survives codegen.
10
+ module TelephonyCredentials
11
+ # A WebRTC login token for a credential, minted locally with no request
12
+ # to Telnyx per token. Same use as `create_token`: hand it to the WebRTC
13
+ # SDK as `login_token`.
14
+ #
15
+ # The signing material (`kid`, `tel_token`, `signing_secret`) is read from
16
+ # the credential's `token_material`, present on the `create` response. A
17
+ # credential given by id, or one from `retrieve` or `list`, fetches it
18
+ # with {#fetch_token_material}. Pass `token_material:` to mint from values
19
+ # stored earlier, with no request at all.
20
+ #
21
+ # @param credential [String, Telnyx::Models::TelephonyCredential, Telnyx::Models::TelephonyCredentialCreateResponse, Telnyx::Models::TelephonyCredentialRetrieveResponse]
22
+ # the credential id, the credential, or the `create` / `retrieve` response holding it
23
+ #
24
+ # @param ttl [Integer] token lifetime in seconds, 1..86400; default one hour
25
+ #
26
+ # @param token_material [Hash{Symbol=>String}, nil] `kid`, `tel_token`, `signing_secret` stored earlier
27
+ #
28
+ # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
29
+ #
30
+ # @return [String]
31
+ def to_jwt(
32
+ credential,
33
+ ttl: Telnyx::Lib::AccessToken::DEFAULT_TTL,
34
+ token_material: nil,
35
+ request_options: {}
36
+ )
37
+ model = credential_model(credential, request_options: request_options)
38
+ material = token_material || model[:token_material] ||
39
+ fetch_token_material(model.id, request_options: request_options)
40
+
41
+ Telnyx::Lib::AccessToken.new(
42
+ credential_id: model.id,
43
+ user_id: model.user_id,
44
+ identity: model.sip_username,
45
+ expires_at: model.expires_at,
46
+ token_material: material,
47
+ ttl: ttl
48
+ ).to_jwt
49
+ end
50
+
51
+ # `GET /v2/telephony_credentials/:id/token_material`. Treat the result
52
+ # like the SIP password: keep it on the server.
53
+ #
54
+ # @param id [String] Identifies the resource.
55
+ #
56
+ # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
57
+ #
58
+ # @return [Hash{Symbol=>Object}] `kid`, `tel_token`, `signing_secret`
59
+ def fetch_token_material(id, request_options: {})
60
+ body = @client.request(
61
+ method: :get,
62
+ path: ["telephony_credentials/%1$s/token_material", id],
63
+ model: Telnyx::Internal::Type::Unknown,
64
+ options: request_options
65
+ )
66
+ body.is_a?(Hash) && body.key?(:data) ? body.fetch(:data) : body
67
+ end
68
+
69
+ private
70
+
71
+ # @return [Telnyx::Models::TelephonyCredential]
72
+ def credential_model(credential, request_options:)
73
+ model = credential.respond_to?(:data) ? credential.data : credential
74
+ model = retrieve(model, request_options: request_options).data if model.is_a?(String)
75
+ return model if model.is_a?(Telnyx::Models::TelephonyCredential)
76
+
77
+ raise ArgumentError.new("expected a telephony credential or its id, got #{credential.inspect}")
78
+ end
79
+ end
80
+ end
81
+
82
+ module Resources
83
+ class TelephonyCredentials
84
+ include Telnyx::Lib::TelephonyCredentials
85
+ end
86
+ end
87
+ end
data/lib/telnyx/lib.rb CHANGED
@@ -14,3 +14,5 @@
14
14
  require_relative "lib/webhook_verification_error"
15
15
  require_relative "lib/webhook_verification"
16
16
  require_relative "lib/websocket"
17
+ require_relative "lib/access_token"
18
+ require_relative "lib/telephony_credentials"
@@ -0,0 +1,110 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Telnyx
4
+ module Models
5
+ # @see Telnyx::Resources::AgentGateways#list
6
+ class AgentGateway < Telnyx::Internal::Type::BaseModel
7
+ # @!attribute id
8
+ # Identifies the instance.
9
+ #
10
+ # @return [String]
11
+ required :id, String
12
+
13
+ # @!attribute created_at
14
+ # When the instance was created.
15
+ #
16
+ # @return [Time]
17
+ required :created_at, Time
18
+
19
+ # @!attribute engine
20
+ # The gateway engine.
21
+ #
22
+ # @return [Symbol, :litellm]
23
+ required :engine, const: :litellm
24
+
25
+ # @!attribute engine_version
26
+ # The engine version the instance runs.
27
+ #
28
+ # @return [String]
29
+ required :engine_version, String
30
+
31
+ # @!attribute gateway_url
32
+ # The base URL of the instance's API, `http://<address>:4000`, where the address
33
+ # is the instance's peer address on the WireGuard Interface. Reachable only from
34
+ # hosts on the instance's _Network_, and every request to it carries a key from
35
+ # this API. `null` until the instance is `ready`.
36
+ #
37
+ # @return [String, nil]
38
+ required :gateway_url, String, nil?: true
39
+
40
+ # @!attribute name
41
+ # A label for people; `null` when none was given.
42
+ #
43
+ # @return [String, nil]
44
+ required :name, String, nil?: true
45
+
46
+ # @!attribute network_id
47
+ # The [_Network_](https://developers.telnyx.com/docs/network/overview) the
48
+ # WireGuard Interface belongs to.
49
+ #
50
+ # @return [String, nil]
51
+ required :network_id, String, nil?: true
52
+
53
+ # @!attribute status
54
+ # Where the instance is in its lifecycle. `pending`: created and waiting to start.
55
+ # `provisioning`: starting. `ready`: running, with its `gateway_url` set.
56
+ # `failed`: did not start in time; delete it. `deleting`: being removed.
57
+ #
58
+ # @return [Symbol, Telnyx::Models::AgentGateway::Status]
59
+ required :status, enum: -> { Telnyx::AgentGateway::Status }
60
+
61
+ # @!attribute wireguard_interface_id
62
+ # The WireGuard Interface the instance joins as a peer.
63
+ #
64
+ # @return [String, nil]
65
+ required :wireguard_interface_id, String, nil?: true
66
+
67
+ # @!method initialize(id:, created_at:, engine_version:, gateway_url:, name:, network_id:, status:, wireguard_interface_id:, engine: :litellm)
68
+ # Some parameter documentations has been truncated, see
69
+ # {Telnyx::Models::AgentGateway} for more details.
70
+ #
71
+ # An Agent Gateway instance on a WireGuard Interface.
72
+ #
73
+ # @param id [String] Identifies the instance.
74
+ #
75
+ # @param created_at [Time] When the instance was created.
76
+ #
77
+ # @param engine_version [String] The engine version the instance runs.
78
+ #
79
+ # @param gateway_url [String, nil] The base URL of the instance's API, `http://<address>:4000`, where the address i
80
+ #
81
+ # @param name [String, nil] A label for people; `null` when none was given.
82
+ #
83
+ # @param network_id [String, nil] The [_Network_](https://developers.telnyx.com/docs/network/overview) the WireGua
84
+ #
85
+ # @param status [Symbol, Telnyx::Models::AgentGateway::Status] Where the instance is in its lifecycle. `pending`: created and waiting to start.
86
+ #
87
+ # @param wireguard_interface_id [String, nil] The WireGuard Interface the instance joins as a peer.
88
+ #
89
+ # @param engine [Symbol, :litellm] The gateway engine.
90
+
91
+ # Where the instance is in its lifecycle. `pending`: created and waiting to start.
92
+ # `provisioning`: starting. `ready`: running, with its `gateway_url` set.
93
+ # `failed`: did not start in time; delete it. `deleting`: being removed.
94
+ #
95
+ # @see Telnyx::Models::AgentGateway#status
96
+ module Status
97
+ extend Telnyx::Internal::Type::Enum
98
+
99
+ PENDING = :pending
100
+ PROVISIONING = :provisioning
101
+ READY = :ready
102
+ FAILED = :failed
103
+ DELETING = :deleting
104
+
105
+ # @!method self.values
106
+ # @return [Array<Symbol>]
107
+ end
108
+ end
109
+ end
110
+ end
@@ -0,0 +1,34 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Telnyx
4
+ module Models
5
+ # @see Telnyx::Resources::AgentGateways#create
6
+ class AgentGatewayCreateParams < Telnyx::Internal::Type::BaseModel
7
+ extend Telnyx::Internal::Type::RequestParameters::Converter
8
+ include Telnyx::Internal::Type::RequestParameters
9
+
10
+ # @!attribute wireguard_interface_id
11
+ # One of the account's WireGuard Interfaces. The instance joins it as a peer, and
12
+ # the interface's other peers reach the instance.
13
+ #
14
+ # @return [String]
15
+ required :wireguard_interface_id, String
16
+
17
+ # @!attribute name
18
+ # A label for people.
19
+ #
20
+ # @return [String, nil]
21
+ optional :name, String, nil?: true
22
+
23
+ # @!method initialize(wireguard_interface_id:, name: nil, request_options: {})
24
+ # Some parameter documentations has been truncated, see
25
+ # {Telnyx::Models::AgentGatewayCreateParams} for more details.
26
+ #
27
+ # @param wireguard_interface_id [String] One of the account's WireGuard Interfaces. The instance joins it as a peer, and
28
+ #
29
+ # @param name [String, nil] A label for people.
30
+ #
31
+ # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
32
+ end
33
+ end
34
+ end
@@ -0,0 +1,20 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Telnyx
4
+ module Models
5
+ # @see Telnyx::Resources::AgentGateways#delete
6
+ class AgentGatewayDeleteParams < Telnyx::Internal::Type::BaseModel
7
+ extend Telnyx::Internal::Type::RequestParameters::Converter
8
+ include Telnyx::Internal::Type::RequestParameters
9
+
10
+ # @!attribute instance_id
11
+ #
12
+ # @return [String]
13
+ required :instance_id, String
14
+
15
+ # @!method initialize(instance_id:, request_options: {})
16
+ # @param instance_id [String]
17
+ # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
18
+ end
19
+ end
20
+ end
@@ -0,0 +1,30 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Telnyx
4
+ module Models
5
+ # @see Telnyx::Resources::AgentGateways#list
6
+ class AgentGatewayListParams < Telnyx::Internal::Type::BaseModel
7
+ extend Telnyx::Internal::Type::RequestParameters::Converter
8
+ include Telnyx::Internal::Type::RequestParameters
9
+
10
+ # @!attribute page_number
11
+ # The page to return, counting from 1.
12
+ #
13
+ # @return [Integer, nil]
14
+ optional :page_number, Integer
15
+
16
+ # @!attribute page_size
17
+ # Results per page.
18
+ #
19
+ # @return [Integer, nil]
20
+ optional :page_size, Integer
21
+
22
+ # @!method initialize(page_number: nil, page_size: nil, request_options: {})
23
+ # @param page_number [Integer] The page to return, counting from 1.
24
+ #
25
+ # @param page_size [Integer] Results per page.
26
+ #
27
+ # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
28
+ end
29
+ end
30
+ end
@@ -0,0 +1,17 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Telnyx
4
+ module Models
5
+ # @see Telnyx::Resources::AgentGateways#create
6
+ class AgentGatewayResponse < Telnyx::Internal::Type::BaseModel
7
+ # @!attribute data
8
+ # An Agent Gateway instance on a WireGuard Interface.
9
+ #
10
+ # @return [Telnyx::Models::AgentGateway]
11
+ required :data, -> { Telnyx::AgentGateway }
12
+
13
+ # @!method initialize(data:)
14
+ # @param data [Telnyx::Models::AgentGateway] An Agent Gateway instance on a WireGuard Interface.
15
+ end
16
+ end
17
+ end
@@ -0,0 +1,20 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Telnyx
4
+ module Models
5
+ # @see Telnyx::Resources::AgentGateways#retrieve_models
6
+ class AgentGatewayRetrieveModelsParams < Telnyx::Internal::Type::BaseModel
7
+ extend Telnyx::Internal::Type::RequestParameters::Converter
8
+ include Telnyx::Internal::Type::RequestParameters
9
+
10
+ # @!attribute instance_id
11
+ #
12
+ # @return [String]
13
+ required :instance_id, String
14
+
15
+ # @!method initialize(instance_id:, request_options: {})
16
+ # @param instance_id [String]
17
+ # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
18
+ end
19
+ end
20
+ end