telnyx 7.24.0 → 7.26.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 (536) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/client.d.mts +27 -6
  3. package/client.d.mts.map +1 -1
  4. package/client.d.ts +27 -6
  5. package/client.d.ts.map +1 -1
  6. package/client.js +21 -0
  7. package/client.js.map +1 -1
  8. package/client.mjs +21 -0
  9. package/client.mjs.map +1 -1
  10. package/package.json +1 -1
  11. package/resources/ai/ai.d.mts +16 -6
  12. package/resources/ai/ai.d.mts.map +1 -1
  13. package/resources/ai/ai.d.ts +16 -6
  14. package/resources/ai/ai.d.ts.map +1 -1
  15. package/resources/ai/ai.js +4 -0
  16. package/resources/ai/ai.js.map +1 -1
  17. package/resources/ai/ai.mjs +4 -0
  18. package/resources/ai/ai.mjs.map +1 -1
  19. package/resources/ai/assistants/assistants.d.mts +551 -33
  20. package/resources/ai/assistants/assistants.d.mts.map +1 -1
  21. package/resources/ai/assistants/assistants.d.ts +551 -33
  22. package/resources/ai/assistants/assistants.d.ts.map +1 -1
  23. package/resources/ai/assistants/assistants.js +79 -2
  24. package/resources/ai/assistants/assistants.js.map +1 -1
  25. package/resources/ai/assistants/assistants.mjs +79 -2
  26. package/resources/ai/assistants/assistants.mjs.map +1 -1
  27. package/resources/ai/assistants/deleted.d.mts +60 -0
  28. package/resources/ai/assistants/deleted.d.mts.map +1 -0
  29. package/resources/ai/assistants/deleted.d.ts +60 -0
  30. package/resources/ai/assistants/deleted.d.ts.map +1 -0
  31. package/resources/ai/assistants/deleted.js +49 -0
  32. package/resources/ai/assistants/deleted.js.map +1 -0
  33. package/resources/ai/assistants/deleted.mjs +45 -0
  34. package/resources/ai/assistants/deleted.mjs.map +1 -0
  35. package/resources/ai/assistants/index.d.mts +2 -1
  36. package/resources/ai/assistants/index.d.mts.map +1 -1
  37. package/resources/ai/assistants/index.d.ts +2 -1
  38. package/resources/ai/assistants/index.d.ts.map +1 -1
  39. package/resources/ai/assistants/index.js +3 -1
  40. package/resources/ai/assistants/index.js.map +1 -1
  41. package/resources/ai/assistants/index.mjs +1 -0
  42. package/resources/ai/assistants/index.mjs.map +1 -1
  43. package/resources/ai/assistants/versions.d.mts +48 -0
  44. package/resources/ai/assistants/versions.d.mts.map +1 -1
  45. package/resources/ai/assistants/versions.d.ts +48 -0
  46. package/resources/ai/assistants/versions.d.ts.map +1 -1
  47. package/resources/ai/avatars.d.mts +187 -0
  48. package/resources/ai/avatars.d.mts.map +1 -0
  49. package/resources/ai/avatars.d.ts +187 -0
  50. package/resources/ai/avatars.d.ts.map +1 -0
  51. package/resources/ai/avatars.js +93 -0
  52. package/resources/ai/avatars.js.map +1 -0
  53. package/resources/ai/avatars.mjs +89 -0
  54. package/resources/ai/avatars.mjs.map +1 -0
  55. package/resources/ai/chat.d.mts +21 -2
  56. package/resources/ai/chat.d.mts.map +1 -1
  57. package/resources/ai/chat.d.ts +21 -2
  58. package/resources/ai/chat.d.ts.map +1 -1
  59. package/resources/ai/conversations/conversations.d.mts +8 -0
  60. package/resources/ai/conversations/conversations.d.mts.map +1 -1
  61. package/resources/ai/conversations/conversations.d.ts +8 -0
  62. package/resources/ai/conversations/conversations.d.ts.map +1 -1
  63. package/resources/ai/conversations/conversations.js.map +1 -1
  64. package/resources/ai/conversations/conversations.mjs.map +1 -1
  65. package/resources/ai/embeddings/embeddings.d.mts +1 -1
  66. package/resources/ai/embeddings/embeddings.d.ts +1 -1
  67. package/resources/ai/embeddings/embeddings.js +1 -1
  68. package/resources/ai/embeddings/embeddings.mjs +1 -1
  69. package/resources/ai/index.d.mts +3 -2
  70. package/resources/ai/index.d.mts.map +1 -1
  71. package/resources/ai/index.d.ts +3 -2
  72. package/resources/ai/index.d.ts.map +1 -1
  73. package/resources/ai/index.js +3 -1
  74. package/resources/ai/index.js.map +1 -1
  75. package/resources/ai/index.mjs +1 -0
  76. package/resources/ai/index.mjs.map +1 -1
  77. package/resources/ai/memory/index.d.mts +1 -1
  78. package/resources/ai/memory/index.d.mts.map +1 -1
  79. package/resources/ai/memory/index.d.ts +1 -1
  80. package/resources/ai/memory/index.d.ts.map +1 -1
  81. package/resources/ai/memory/index.js.map +1 -1
  82. package/resources/ai/memory/index.mjs +1 -1
  83. package/resources/ai/memory/index.mjs.map +1 -1
  84. package/resources/ai/memory/memory.d.mts +2 -2
  85. package/resources/ai/memory/memory.d.mts.map +1 -1
  86. package/resources/ai/memory/memory.d.ts +2 -2
  87. package/resources/ai/memory/memory.d.ts.map +1 -1
  88. package/resources/ai/memory/memory.js.map +1 -1
  89. package/resources/ai/memory/memory.mjs +1 -1
  90. package/resources/ai/memory/memory.mjs.map +1 -1
  91. package/resources/ai/memory/namespaces/index.d.mts +2 -2
  92. package/resources/ai/memory/namespaces/index.d.mts.map +1 -1
  93. package/resources/ai/memory/namespaces/index.d.ts +2 -2
  94. package/resources/ai/memory/namespaces/index.d.ts.map +1 -1
  95. package/resources/ai/memory/namespaces/index.js.map +1 -1
  96. package/resources/ai/memory/namespaces/index.mjs +1 -1
  97. package/resources/ai/memory/namespaces/index.mjs.map +1 -1
  98. package/resources/ai/memory/namespaces/namespaces.d.mts +62 -6
  99. package/resources/ai/memory/namespaces/namespaces.d.mts.map +1 -1
  100. package/resources/ai/memory/namespaces/namespaces.d.ts +62 -6
  101. package/resources/ai/memory/namespaces/namespaces.d.ts.map +1 -1
  102. package/resources/ai/memory/namespaces/namespaces.js +41 -3
  103. package/resources/ai/memory/namespaces/namespaces.js.map +1 -1
  104. package/resources/ai/memory/namespaces/namespaces.mjs +41 -3
  105. package/resources/ai/memory/namespaces/namespaces.mjs.map +1 -1
  106. package/resources/ai/memory/namespaces/profiles/index.d.mts +1 -1
  107. package/resources/ai/memory/namespaces/profiles/index.d.mts.map +1 -1
  108. package/resources/ai/memory/namespaces/profiles/index.d.ts +1 -1
  109. package/resources/ai/memory/namespaces/profiles/index.d.ts.map +1 -1
  110. package/resources/ai/memory/namespaces/profiles/index.js.map +1 -1
  111. package/resources/ai/memory/namespaces/profiles/index.mjs.map +1 -1
  112. package/resources/ai/memory/namespaces/profiles/profiles.d.mts +54 -1
  113. package/resources/ai/memory/namespaces/profiles/profiles.d.mts.map +1 -1
  114. package/resources/ai/memory/namespaces/profiles/profiles.d.ts +54 -1
  115. package/resources/ai/memory/namespaces/profiles/profiles.d.ts.map +1 -1
  116. package/resources/ai/memory/namespaces/profiles/profiles.js +31 -0
  117. package/resources/ai/memory/namespaces/profiles/profiles.js.map +1 -1
  118. package/resources/ai/memory/namespaces/profiles/profiles.mjs +31 -0
  119. package/resources/ai/memory/namespaces/profiles/profiles.mjs.map +1 -1
  120. package/resources/ai/openai/chat.d.mts +21 -2
  121. package/resources/ai/openai/chat.d.mts.map +1 -1
  122. package/resources/ai/openai/chat.d.ts +21 -2
  123. package/resources/ai/openai/chat.d.ts.map +1 -1
  124. package/resources/ai/tools.d.mts +20 -5
  125. package/resources/ai/tools.d.mts.map +1 -1
  126. package/resources/ai/tools.d.ts +20 -5
  127. package/resources/ai/tools.d.ts.map +1 -1
  128. package/resources/ai/tools.js +5 -2
  129. package/resources/ai/tools.js.map +1 -1
  130. package/resources/ai/tools.mjs +5 -2
  131. package/resources/ai/tools.mjs.map +1 -1
  132. package/resources/calls/actions.d.mts +135 -30
  133. package/resources/calls/actions.d.mts.map +1 -1
  134. package/resources/calls/actions.d.ts +135 -30
  135. package/resources/calls/actions.d.ts.map +1 -1
  136. package/resources/calls/actions.js +31 -0
  137. package/resources/calls/actions.js.map +1 -1
  138. package/resources/calls/actions.mjs +31 -0
  139. package/resources/calls/actions.mjs.map +1 -1
  140. package/resources/calls/calls.d.mts +72 -25
  141. package/resources/calls/calls.d.mts.map +1 -1
  142. package/resources/calls/calls.d.ts +72 -25
  143. package/resources/calls/calls.d.ts.map +1 -1
  144. package/resources/calls/calls.js +11 -0
  145. package/resources/calls/calls.js.map +1 -1
  146. package/resources/calls/calls.mjs +11 -0
  147. package/resources/calls/calls.mjs.map +1 -1
  148. package/resources/calls/index.d.mts +1 -1
  149. package/resources/calls/index.d.mts.map +1 -1
  150. package/resources/calls/index.d.ts +1 -1
  151. package/resources/calls/index.d.ts.map +1 -1
  152. package/resources/calls/index.js.map +1 -1
  153. package/resources/calls/index.mjs.map +1 -1
  154. package/resources/dir/dir.d.mts +226 -31
  155. package/resources/dir/dir.d.mts.map +1 -1
  156. package/resources/dir/dir.d.ts +226 -31
  157. package/resources/dir/dir.d.ts.map +1 -1
  158. package/resources/dir/dir.js +78 -14
  159. package/resources/dir/dir.js.map +1 -1
  160. package/resources/dir/dir.mjs +78 -14
  161. package/resources/dir/dir.mjs.map +1 -1
  162. package/resources/dir/index.d.mts +1 -1
  163. package/resources/dir/index.d.mts.map +1 -1
  164. package/resources/dir/index.d.ts +1 -1
  165. package/resources/dir/index.d.ts.map +1 -1
  166. package/resources/dir/index.js.map +1 -1
  167. package/resources/dir/index.mjs.map +1 -1
  168. package/resources/dir/phone-numbers.d.mts +8 -8
  169. package/resources/dir/phone-numbers.d.mts.map +1 -1
  170. package/resources/dir/phone-numbers.d.ts +8 -8
  171. package/resources/dir/phone-numbers.d.ts.map +1 -1
  172. package/resources/dir/phone-numbers.js +4 -4
  173. package/resources/dir/phone-numbers.mjs +4 -4
  174. package/resources/dir/references.d.mts +9 -6
  175. package/resources/dir/references.d.mts.map +1 -1
  176. package/resources/dir/references.d.ts +9 -6
  177. package/resources/dir/references.d.ts.map +1 -1
  178. package/resources/email-templates.d.mts +109 -18
  179. package/resources/email-templates.d.mts.map +1 -1
  180. package/resources/email-templates.d.ts +109 -18
  181. package/resources/email-templates.d.ts.map +1 -1
  182. package/resources/email-templates.js +5 -1
  183. package/resources/email-templates.js.map +1 -1
  184. package/resources/email-templates.mjs +5 -1
  185. package/resources/email-templates.mjs.map +1 -1
  186. package/resources/enterprises/dir.d.mts +25 -3
  187. package/resources/enterprises/dir.d.mts.map +1 -1
  188. package/resources/enterprises/dir.d.ts +25 -3
  189. package/resources/enterprises/dir.d.ts.map +1 -1
  190. package/resources/enterprises/dir.js +8 -2
  191. package/resources/enterprises/dir.js.map +1 -1
  192. package/resources/enterprises/dir.mjs +8 -2
  193. package/resources/enterprises/dir.mjs.map +1 -1
  194. package/resources/enterprises/enterprises.d.mts +244 -28
  195. package/resources/enterprises/enterprises.d.mts.map +1 -1
  196. package/resources/enterprises/enterprises.d.ts +244 -28
  197. package/resources/enterprises/enterprises.d.ts.map +1 -1
  198. package/resources/enterprises/enterprises.js +31 -7
  199. package/resources/enterprises/enterprises.js.map +1 -1
  200. package/resources/enterprises/enterprises.mjs +31 -7
  201. package/resources/enterprises/enterprises.mjs.map +1 -1
  202. package/resources/enterprises/index.d.mts +2 -1
  203. package/resources/enterprises/index.d.mts.map +1 -1
  204. package/resources/enterprises/index.d.ts +2 -1
  205. package/resources/enterprises/index.d.ts.map +1 -1
  206. package/resources/enterprises/index.js +3 -1
  207. package/resources/enterprises/index.js.map +1 -1
  208. package/resources/enterprises/index.mjs +1 -0
  209. package/resources/enterprises/index.mjs.map +1 -1
  210. package/resources/enterprises/reputation/external-verification.d.mts +94 -0
  211. package/resources/enterprises/reputation/external-verification.d.mts.map +1 -0
  212. package/resources/enterprises/reputation/external-verification.d.ts +94 -0
  213. package/resources/enterprises/reputation/external-verification.d.ts.map +1 -0
  214. package/resources/enterprises/reputation/external-verification.js +54 -0
  215. package/resources/enterprises/reputation/external-verification.js.map +1 -0
  216. package/resources/enterprises/reputation/external-verification.mjs +50 -0
  217. package/resources/enterprises/reputation/external-verification.mjs.map +1 -0
  218. package/resources/enterprises/reputation/index.d.mts +3 -2
  219. package/resources/enterprises/reputation/index.d.mts.map +1 -1
  220. package/resources/enterprises/reputation/index.d.ts +3 -2
  221. package/resources/enterprises/reputation/index.d.ts.map +1 -1
  222. package/resources/enterprises/reputation/index.js +3 -1
  223. package/resources/enterprises/reputation/index.js.map +1 -1
  224. package/resources/enterprises/reputation/index.mjs +1 -0
  225. package/resources/enterprises/reputation/index.mjs.map +1 -1
  226. package/resources/enterprises/reputation/loa.d.mts +64 -3
  227. package/resources/enterprises/reputation/loa.d.mts.map +1 -1
  228. package/resources/enterprises/reputation/loa.d.ts +64 -3
  229. package/resources/enterprises/reputation/loa.d.ts.map +1 -1
  230. package/resources/enterprises/reputation/numbers.d.mts +197 -4
  231. package/resources/enterprises/reputation/numbers.d.mts.map +1 -1
  232. package/resources/enterprises/reputation/numbers.d.ts +197 -4
  233. package/resources/enterprises/reputation/numbers.d.ts.map +1 -1
  234. package/resources/enterprises/reputation/numbers.js +58 -2
  235. package/resources/enterprises/reputation/numbers.js.map +1 -1
  236. package/resources/enterprises/reputation/numbers.mjs +58 -2
  237. package/resources/enterprises/reputation/numbers.mjs.map +1 -1
  238. package/resources/enterprises/reputation/remediation.d.mts +3 -2
  239. package/resources/enterprises/reputation/remediation.d.mts.map +1 -1
  240. package/resources/enterprises/reputation/remediation.d.ts +3 -2
  241. package/resources/enterprises/reputation/remediation.d.ts.map +1 -1
  242. package/resources/enterprises/reputation/reputation.d.mts +39 -3
  243. package/resources/enterprises/reputation/reputation.d.mts.map +1 -1
  244. package/resources/enterprises/reputation/reputation.d.ts +39 -3
  245. package/resources/enterprises/reputation/reputation.d.ts.map +1 -1
  246. package/resources/enterprises/reputation/reputation.js +22 -0
  247. package/resources/enterprises/reputation/reputation.js.map +1 -1
  248. package/resources/enterprises/reputation/reputation.mjs +22 -0
  249. package/resources/enterprises/reputation/reputation.mjs.map +1 -1
  250. package/resources/enterprises/verify-email.d.mts +91 -0
  251. package/resources/enterprises/verify-email.d.mts.map +1 -0
  252. package/resources/enterprises/verify-email.d.ts +91 -0
  253. package/resources/enterprises/verify-email.d.ts.map +1 -0
  254. package/resources/enterprises/verify-email.js +55 -0
  255. package/resources/enterprises/verify-email.js.map +1 -0
  256. package/resources/enterprises/verify-email.mjs +51 -0
  257. package/resources/enterprises/verify-email.mjs.map +1 -0
  258. package/resources/global-ip-assignment-health.d.mts +4 -4
  259. package/resources/global-ip-assignment-health.d.mts.map +1 -1
  260. package/resources/global-ip-assignment-health.d.ts +4 -4
  261. package/resources/global-ip-assignment-health.d.ts.map +1 -1
  262. package/resources/global-ip-assignments-usage.d.mts +4 -4
  263. package/resources/global-ip-assignments-usage.d.mts.map +1 -1
  264. package/resources/global-ip-assignments-usage.d.ts +4 -4
  265. package/resources/global-ip-assignments-usage.d.ts.map +1 -1
  266. package/resources/index.d.mts +6 -3
  267. package/resources/index.d.mts.map +1 -1
  268. package/resources/index.d.ts +6 -3
  269. package/resources/index.d.ts.map +1 -1
  270. package/resources/index.js +9 -3
  271. package/resources/index.js.map +1 -1
  272. package/resources/index.mjs +3 -0
  273. package/resources/index.mjs.map +1 -1
  274. package/resources/infringement-claims.d.mts +4 -0
  275. package/resources/infringement-claims.d.mts.map +1 -1
  276. package/resources/infringement-claims.d.ts +4 -0
  277. package/resources/infringement-claims.d.ts.map +1 -1
  278. package/resources/llm-token-gateway/index.d.mts +6 -0
  279. package/resources/llm-token-gateway/index.d.mts.map +1 -0
  280. package/resources/llm-token-gateway/index.d.ts +6 -0
  281. package/resources/llm-token-gateway/index.d.ts.map +1 -0
  282. package/resources/llm-token-gateway/index.js +15 -0
  283. package/resources/llm-token-gateway/index.js.map +1 -0
  284. package/resources/llm-token-gateway/index.mjs +7 -0
  285. package/resources/llm-token-gateway/index.mjs.map +1 -0
  286. package/resources/llm-token-gateway/llm-token-gateway.d.mts +22 -0
  287. package/resources/llm-token-gateway/llm-token-gateway.d.mts.map +1 -0
  288. package/resources/llm-token-gateway/llm-token-gateway.d.ts +22 -0
  289. package/resources/llm-token-gateway/llm-token-gateway.d.ts.map +1 -0
  290. package/resources/llm-token-gateway/llm-token-gateway.js +29 -0
  291. package/resources/llm-token-gateway/llm-token-gateway.js.map +1 -0
  292. package/resources/llm-token-gateway/llm-token-gateway.mjs +24 -0
  293. package/resources/llm-token-gateway/llm-token-gateway.mjs.map +1 -0
  294. package/resources/llm-token-gateway/spend.d.mts +223 -0
  295. package/resources/llm-token-gateway/spend.d.mts.map +1 -0
  296. package/resources/llm-token-gateway/spend.d.ts +223 -0
  297. package/resources/llm-token-gateway/spend.d.ts.map +1 -0
  298. package/resources/llm-token-gateway/spend.js +56 -0
  299. package/resources/llm-token-gateway/spend.js.map +1 -0
  300. package/resources/llm-token-gateway/spend.mjs +52 -0
  301. package/resources/llm-token-gateway/spend.mjs.map +1 -0
  302. package/resources/llm-token-gateway/token-groups.d.mts +577 -0
  303. package/resources/llm-token-gateway/token-groups.d.mts.map +1 -0
  304. package/resources/llm-token-gateway/token-groups.d.ts +577 -0
  305. package/resources/llm-token-gateway/token-groups.d.ts.map +1 -0
  306. package/resources/llm-token-gateway/token-groups.js +139 -0
  307. package/resources/llm-token-gateway/token-groups.js.map +1 -0
  308. package/resources/llm-token-gateway/token-groups.mjs +135 -0
  309. package/resources/llm-token-gateway/token-groups.mjs.map +1 -0
  310. package/resources/llm-token-gateway/token-keys.d.mts +318 -0
  311. package/resources/llm-token-gateway/token-keys.d.mts.map +1 -0
  312. package/resources/llm-token-gateway/token-keys.d.ts +318 -0
  313. package/resources/llm-token-gateway/token-keys.d.ts.map +1 -0
  314. package/resources/llm-token-gateway/token-keys.js +127 -0
  315. package/resources/llm-token-gateway/token-keys.js.map +1 -0
  316. package/resources/llm-token-gateway/token-keys.mjs +123 -0
  317. package/resources/llm-token-gateway/token-keys.mjs.map +1 -0
  318. package/resources/llm-token-gateway/usage.d.mts +319 -0
  319. package/resources/llm-token-gateway/usage.d.mts.map +1 -0
  320. package/resources/llm-token-gateway/usage.d.ts +319 -0
  321. package/resources/llm-token-gateway/usage.d.ts.map +1 -0
  322. package/resources/llm-token-gateway/usage.js +63 -0
  323. package/resources/llm-token-gateway/usage.js.map +1 -0
  324. package/resources/llm-token-gateway/usage.mjs +59 -0
  325. package/resources/llm-token-gateway/usage.mjs.map +1 -0
  326. package/resources/llm-token-gateway.d.mts +2 -0
  327. package/resources/llm-token-gateway.d.mts.map +1 -0
  328. package/resources/llm-token-gateway.d.ts +2 -0
  329. package/resources/llm-token-gateway.d.ts.map +1 -0
  330. package/resources/llm-token-gateway.js +6 -0
  331. package/resources/llm-token-gateway.js.map +1 -0
  332. package/resources/llm-token-gateway.mjs +3 -0
  333. package/resources/llm-token-gateway.mjs.map +1 -0
  334. package/resources/meeting-sessions/meeting-sessions.d.mts +8 -9
  335. package/resources/meeting-sessions/meeting-sessions.d.mts.map +1 -1
  336. package/resources/meeting-sessions/meeting-sessions.d.ts +8 -9
  337. package/resources/meeting-sessions/meeting-sessions.d.ts.map +1 -1
  338. package/resources/meeting-sessions/meeting-sessions.js +6 -6
  339. package/resources/meeting-sessions/meeting-sessions.js.map +1 -1
  340. package/resources/meeting-sessions/meeting-sessions.mjs +6 -6
  341. package/resources/meeting-sessions/meeting-sessions.mjs.map +1 -1
  342. package/resources/phone-numbers/jobs.d.mts +17 -5
  343. package/resources/phone-numbers/jobs.d.mts.map +1 -1
  344. package/resources/phone-numbers/jobs.d.ts +17 -5
  345. package/resources/phone-numbers/jobs.d.ts.map +1 -1
  346. package/resources/phone-numbers/jobs.js +4 -3
  347. package/resources/phone-numbers/jobs.js.map +1 -1
  348. package/resources/phone-numbers/jobs.mjs +4 -3
  349. package/resources/phone-numbers/jobs.mjs.map +1 -1
  350. package/resources/porting-orders/phone-number-blocks.d.mts +1 -1
  351. package/resources/porting-orders/phone-number-blocks.d.mts.map +1 -1
  352. package/resources/porting-orders/phone-number-blocks.d.ts +1 -1
  353. package/resources/porting-orders/phone-number-blocks.d.ts.map +1 -1
  354. package/resources/porting-orders/porting-orders.d.mts +1 -1
  355. package/resources/porting-orders/porting-orders.d.mts.map +1 -1
  356. package/resources/porting-orders/porting-orders.d.ts +1 -1
  357. package/resources/porting-orders/porting-orders.d.ts.map +1 -1
  358. package/resources/porting-orders/porting-orders.js.map +1 -1
  359. package/resources/porting-orders/porting-orders.mjs.map +1 -1
  360. package/resources/porting-phone-numbers.d.mts +1 -1
  361. package/resources/porting-phone-numbers.d.mts.map +1 -1
  362. package/resources/porting-phone-numbers.d.ts +1 -1
  363. package/resources/porting-phone-numbers.d.ts.map +1 -1
  364. package/resources/reputation/numbers.d.mts +10 -0
  365. package/resources/reputation/numbers.d.mts.map +1 -1
  366. package/resources/reputation/numbers.d.ts +10 -0
  367. package/resources/reputation/numbers.d.ts.map +1 -1
  368. package/resources/requirements.d.mts +2 -2
  369. package/resources/requirements.d.mts.map +1 -1
  370. package/resources/requirements.d.ts +2 -2
  371. package/resources/requirements.d.ts.map +1 -1
  372. package/resources/sip-registration-status.d.mts +149 -0
  373. package/resources/sip-registration-status.d.mts.map +1 -0
  374. package/resources/sip-registration-status.d.ts +149 -0
  375. package/resources/sip-registration-status.d.ts.map +1 -0
  376. package/resources/sip-registration-status.js +32 -0
  377. package/resources/sip-registration-status.js.map +1 -0
  378. package/resources/sip-registration-status.mjs +28 -0
  379. package/resources/sip-registration-status.mjs.map +1 -0
  380. package/resources/spend-limits.d.mts +335 -0
  381. package/resources/spend-limits.d.mts.map +1 -0
  382. package/resources/spend-limits.d.ts +335 -0
  383. package/resources/spend-limits.d.ts.map +1 -0
  384. package/resources/spend-limits.js +91 -0
  385. package/resources/spend-limits.js.map +1 -0
  386. package/resources/spend-limits.mjs +87 -0
  387. package/resources/spend-limits.mjs.map +1 -0
  388. package/resources/terms-of-service/agreements.d.mts +12 -0
  389. package/resources/terms-of-service/agreements.d.mts.map +1 -1
  390. package/resources/terms-of-service/agreements.d.ts +12 -0
  391. package/resources/terms-of-service/agreements.d.ts.map +1 -1
  392. package/resources/terms-of-service/terms-of-service.d.mts +15 -0
  393. package/resources/terms-of-service/terms-of-service.d.mts.map +1 -1
  394. package/resources/terms-of-service/terms-of-service.d.ts +15 -0
  395. package/resources/terms-of-service/terms-of-service.d.ts.map +1 -1
  396. package/resources/terms-of-service/terms-of-service.js.map +1 -1
  397. package/resources/terms-of-service/terms-of-service.mjs.map +1 -1
  398. package/resources/texml/texml.d.mts +7 -3
  399. package/resources/texml/texml.d.mts.map +1 -1
  400. package/resources/texml/texml.d.ts +7 -3
  401. package/resources/texml/texml.d.ts.map +1 -1
  402. package/resources/texml/texml.js +4 -2
  403. package/resources/texml/texml.js.map +1 -1
  404. package/resources/texml/texml.mjs +4 -2
  405. package/resources/texml/texml.mjs.map +1 -1
  406. package/resources/text-to-speech/text-to-speech.d.mts +4 -2
  407. package/resources/text-to-speech/text-to-speech.d.mts.map +1 -1
  408. package/resources/text-to-speech/text-to-speech.d.ts +4 -2
  409. package/resources/text-to-speech/text-to-speech.d.ts.map +1 -1
  410. package/resources/webhooks.d.mts +967 -6
  411. package/resources/webhooks.d.mts.map +1 -1
  412. package/resources/webhooks.d.ts +967 -6
  413. package/resources/webhooks.d.ts.map +1 -1
  414. package/resources/webhooks.js.map +1 -1
  415. package/resources/webhooks.mjs.map +1 -1
  416. package/resources/whatsapp/index.d.mts +1 -0
  417. package/resources/whatsapp/index.d.mts.map +1 -1
  418. package/resources/whatsapp/index.d.ts +1 -0
  419. package/resources/whatsapp/index.d.ts.map +1 -1
  420. package/resources/whatsapp/index.js +3 -1
  421. package/resources/whatsapp/index.js.map +1 -1
  422. package/resources/whatsapp/index.mjs +1 -0
  423. package/resources/whatsapp/index.mjs.map +1 -1
  424. package/resources/whatsapp/phone-numbers/calling-routing.d.mts +90 -0
  425. package/resources/whatsapp/phone-numbers/calling-routing.d.mts.map +1 -0
  426. package/resources/whatsapp/phone-numbers/calling-routing.d.ts +90 -0
  427. package/resources/whatsapp/phone-numbers/calling-routing.d.ts.map +1 -0
  428. package/resources/whatsapp/phone-numbers/calling-routing.js +66 -0
  429. package/resources/whatsapp/phone-numbers/calling-routing.js.map +1 -0
  430. package/resources/whatsapp/phone-numbers/calling-routing.mjs +62 -0
  431. package/resources/whatsapp/phone-numbers/calling-routing.mjs.map +1 -0
  432. package/resources/whatsapp/phone-numbers/index.d.mts +1 -0
  433. package/resources/whatsapp/phone-numbers/index.d.mts.map +1 -1
  434. package/resources/whatsapp/phone-numbers/index.d.ts +1 -0
  435. package/resources/whatsapp/phone-numbers/index.d.ts.map +1 -1
  436. package/resources/whatsapp/phone-numbers/index.js +3 -1
  437. package/resources/whatsapp/phone-numbers/index.js.map +1 -1
  438. package/resources/whatsapp/phone-numbers/index.mjs +1 -0
  439. package/resources/whatsapp/phone-numbers/index.mjs.map +1 -1
  440. package/resources/whatsapp/phone-numbers/phone-numbers.d.mts +4 -0
  441. package/resources/whatsapp/phone-numbers/phone-numbers.d.mts.map +1 -1
  442. package/resources/whatsapp/phone-numbers/phone-numbers.d.ts +4 -0
  443. package/resources/whatsapp/phone-numbers/phone-numbers.d.ts.map +1 -1
  444. package/resources/whatsapp/phone-numbers/phone-numbers.js +4 -0
  445. package/resources/whatsapp/phone-numbers/phone-numbers.js.map +1 -1
  446. package/resources/whatsapp/phone-numbers/phone-numbers.mjs +4 -0
  447. package/resources/whatsapp/phone-numbers/phone-numbers.mjs.map +1 -1
  448. package/resources/whatsapp/signup.d.mts +128 -0
  449. package/resources/whatsapp/signup.d.mts.map +1 -0
  450. package/resources/whatsapp/signup.d.ts +128 -0
  451. package/resources/whatsapp/signup.d.ts.map +1 -0
  452. package/resources/whatsapp/signup.js +42 -0
  453. package/resources/whatsapp/signup.js.map +1 -0
  454. package/resources/whatsapp/signup.mjs +38 -0
  455. package/resources/whatsapp/signup.mjs.map +1 -0
  456. package/resources/whatsapp/whatsapp.d.mts +4 -0
  457. package/resources/whatsapp/whatsapp.d.mts.map +1 -1
  458. package/resources/whatsapp/whatsapp.d.ts +4 -0
  459. package/resources/whatsapp/whatsapp.d.ts.map +1 -1
  460. package/resources/whatsapp/whatsapp.js +4 -0
  461. package/resources/whatsapp/whatsapp.js.map +1 -1
  462. package/resources/whatsapp/whatsapp.mjs +4 -0
  463. package/resources/whatsapp/whatsapp.mjs.map +1 -1
  464. package/src/client.ts +83 -0
  465. package/src/resources/ai/ai.ts +48 -4
  466. package/src/resources/ai/assistants/assistants.ts +676 -33
  467. package/src/resources/ai/assistants/deleted.ts +86 -0
  468. package/src/resources/ai/assistants/index.ts +13 -0
  469. package/src/resources/ai/assistants/versions.ts +54 -0
  470. package/src/resources/ai/avatars.ts +238 -0
  471. package/src/resources/ai/chat.ts +21 -2
  472. package/src/resources/ai/conversations/conversations.ts +9 -0
  473. package/src/resources/ai/embeddings/embeddings.ts +1 -1
  474. package/src/resources/ai/index.ts +18 -1
  475. package/src/resources/ai/memory/index.ts +9 -1
  476. package/src/resources/ai/memory/memory.ts +13 -1
  477. package/src/resources/ai/memory/namespaces/index.ts +11 -1
  478. package/src/resources/ai/memory/namespaces/namespaces.ts +85 -3
  479. package/src/resources/ai/memory/namespaces/profiles/index.ts +2 -0
  480. package/src/resources/ai/memory/namespaces/profiles/profiles.ts +71 -0
  481. package/src/resources/ai/openai/chat.ts +21 -2
  482. package/src/resources/ai/tools.ts +25 -7
  483. package/src/resources/calls/actions.ts +141 -25
  484. package/src/resources/calls/calls.ts +73 -17
  485. package/src/resources/calls/index.ts +1 -0
  486. package/src/resources/dir/dir.ts +269 -35
  487. package/src/resources/dir/index.ts +6 -0
  488. package/src/resources/dir/phone-numbers.ts +9 -10
  489. package/src/resources/dir/references.ts +9 -6
  490. package/src/resources/email-templates.ts +121 -19
  491. package/src/resources/enterprises/dir.ts +27 -3
  492. package/src/resources/enterprises/enterprises.ts +257 -26
  493. package/src/resources/enterprises/index.ts +6 -0
  494. package/src/resources/enterprises/reputation/external-verification.ts +125 -0
  495. package/src/resources/enterprises/reputation/index.ts +12 -0
  496. package/src/resources/enterprises/reputation/loa.ts +76 -3
  497. package/src/resources/enterprises/reputation/numbers.ts +256 -3
  498. package/src/resources/enterprises/reputation/remediation.ts +3 -2
  499. package/src/resources/enterprises/reputation/reputation.ts +70 -0
  500. package/src/resources/enterprises/verify-email.ts +117 -0
  501. package/src/resources/global-ip-assignment-health.ts +4 -4
  502. package/src/resources/global-ip-assignments-usage.ts +4 -4
  503. package/src/resources/index.ts +31 -0
  504. package/src/resources/infringement-claims.ts +4 -0
  505. package/src/resources/llm-token-gateway/index.ts +41 -0
  506. package/src/resources/llm-token-gateway/llm-token-gateway.ts +101 -0
  507. package/src/resources/llm-token-gateway/spend.ts +309 -0
  508. package/src/resources/llm-token-gateway/token-groups.ts +724 -0
  509. package/src/resources/llm-token-gateway/token-keys.ts +422 -0
  510. package/src/resources/llm-token-gateway/usage.ts +460 -0
  511. package/src/resources/llm-token-gateway.ts +3 -0
  512. package/src/resources/meeting-sessions/meeting-sessions.ts +8 -9
  513. package/src/resources/phone-numbers/jobs.ts +18 -5
  514. package/src/resources/porting-orders/phone-number-blocks.ts +9 -1
  515. package/src/resources/porting-orders/porting-orders.ts +9 -1
  516. package/src/resources/porting-phone-numbers.ts +9 -1
  517. package/src/resources/reputation/numbers.ts +12 -0
  518. package/src/resources/requirements.ts +2 -2
  519. package/src/resources/sip-registration-status.ts +188 -0
  520. package/src/resources/spend-limits.ts +428 -0
  521. package/src/resources/terms-of-service/agreements.ts +12 -0
  522. package/src/resources/terms-of-service/terms-of-service.ts +15 -0
  523. package/src/resources/texml/texml.ts +7 -3
  524. package/src/resources/text-to-speech/text-to-speech.ts +4 -2
  525. package/src/resources/webhooks.ts +1460 -228
  526. package/src/resources/whatsapp/index.ts +7 -0
  527. package/src/resources/whatsapp/phone-numbers/calling-routing.ts +114 -0
  528. package/src/resources/whatsapp/phone-numbers/index.ts +7 -0
  529. package/src/resources/whatsapp/phone-numbers/phone-numbers.ts +18 -0
  530. package/src/resources/whatsapp/signup.ts +188 -0
  531. package/src/resources/whatsapp/whatsapp.ts +18 -0
  532. package/src/version.ts +1 -1
  533. package/version.d.mts +1 -1
  534. package/version.d.ts +1 -1
  535. package/version.js +1 -1
  536. package/version.mjs +1 -1
@@ -0,0 +1,319 @@
1
+ import { APIResource } from "../../core/resource.mjs";
2
+ import * as UsageAPI from "./usage.mjs";
3
+ import { APIPromise } from "../../core/api-promise.mjs";
4
+ import { RequestOptions } from "../../internal/request-options.mjs";
5
+ /**
6
+ * Manage and report AI Gateway usage.
7
+ */
8
+ export declare class Usage extends APIResource {
9
+ /**
10
+ * Gateway reference/enforcement usage, not invoice truth or BYOK provider charges.
11
+ * Requires the dedicated llm_token_gateway.usage.read V2 action for combined spend
12
+ * and guardrail reporting; existing spend.read and guardrail_events.read grants do
13
+ * not grant this endpoint. All totals, UTC daily buckets, models and latest 20
14
+ * guardrail events share one database snapshot. UTC half-open dates, at most 31
15
+ * days. Zero-filled days; at most 1000 models (503 rather than truncation on
16
+ * overflow/timeout). Known tokens sum independently known categories across latest
17
+ * attempt evidence, including corrections; unknown spend is excluded and
18
+ * unknown_requests/reserved_spend remain explicit. Guardrail counts count events,
19
+ * not distinct requests. No raw spend events, prompts or secrets. This read-only
20
+ * report creates no pagination snapshot and accepts no pagination parameters.
21
+ *
22
+ * @example
23
+ * ```ts
24
+ * const response =
25
+ * await client.llmTokenGateway.usage.retrieveSummary({
26
+ * end_date: '2019-12-27',
27
+ * start_date: '2019-12-27',
28
+ * token_group_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
29
+ * });
30
+ * ```
31
+ */
32
+ retrieveSummary(query: UsageRetrieveSummaryParams, options?: RequestOptions): APIPromise<UsageRetrieveSummaryResponse>;
33
+ /**
34
+ * Durable, replayable, content-free usage export for customer pipelines. Requires
35
+ * the dedicated llm_token_gateway.usage_export.read V2 action; spend.read and
36
+ * usage.read do not grant it. Records are inference.request (one per immutable
37
+ * ledger revision; a correction adds a new id with supersedes, keep the highest
38
+ * revision per request_id) and guardrail.evaluation (one per guardrail event,
39
+ * including blocked prompts with no inference record; correlate on request_id).
40
+ * Delivery is at least once in commit order: deduplicate on id. Records appear
41
+ * after settlement and after every older database transaction has finished
42
+ * (meta.horizon_lag_seconds); keep polling with next_cursor, which is always
43
+ * returned and is reusable after has_more is false. After a logical database
44
+ * restore, restart from start_time and deduplicate on id; a cursor from before it
45
+ * may return 409 cursor_expired (no Retry-After). Retention promise 30 days. No
46
+ * prompts, responses, provider credentials, supplier or customer rates. Gateway
47
+ * reference/enforcement usage, not invoice truth or BYOK provider charges.
48
+ *
49
+ * @example
50
+ * ```ts
51
+ * const response =
52
+ * await client.llmTokenGateway.usage.retrieveExport();
53
+ * ```
54
+ */
55
+ retrieveExport(query?: UsageRetrieveExportParams | null | undefined, options?: RequestOptions): APIPromise<UsageRetrieveExportResponse>;
56
+ }
57
+ export interface GuardrailFinding {
58
+ action: 'flag' | 'block';
59
+ code: string;
60
+ count: number;
61
+ detector: 'secrets' | 'dlp' | 'safety';
62
+ }
63
+ export interface UsageRetrieveExportResponse {
64
+ data: Array<UsageRetrieveExportResponse.UsageExportInferenceRequest | UsageRetrieveExportResponse.UsageExportGuardrailEvaluation>;
65
+ meta: UsageRetrieveExportResponse.Meta;
66
+ }
67
+ export declare namespace UsageRetrieveExportResponse {
68
+ interface UsageExportInferenceRequest {
69
+ /**
70
+ * Deterministic: req\_{request_id}\_r{revision}. Deduplicate on id.
71
+ */
72
+ id: string;
73
+ attempts: number;
74
+ biller: 'telnyx' | 'provider' | 'none';
75
+ cache_hit: boolean;
76
+ configuration_version: number;
77
+ /**
78
+ * USD decimal string with exactly 6 places, 0 to 1000000000.000000 (the Money
79
+ * bound); enforcement basis, not invoice truth.
80
+ */
81
+ cost: string | null;
82
+ end_user_id: string | null;
83
+ input_tokens: number | null;
84
+ /**
85
+ * Customer request tags captured at admission; {} when untagged.
86
+ */
87
+ metadata: {
88
+ [key: string]: string | number | boolean;
89
+ };
90
+ model: string;
91
+ output_tokens: number | null;
92
+ protocol: 'openai' | 'anthropic';
93
+ provider: string;
94
+ provider_key_id: string | null;
95
+ provider_model: string;
96
+ rate_version: string;
97
+ request_id: string;
98
+ revision: number;
99
+ route_mode: 'managed' | 'byok' | 'cache';
100
+ schema_version: 1;
101
+ status: 'succeeded' | 'failed' | 'partial' | 'unknown';
102
+ stream: boolean;
103
+ /**
104
+ * Previous revision id; keep the highest revision per request_id.
105
+ */
106
+ supersedes: string | null;
107
+ timings: UsageExportInferenceRequest.Timings;
108
+ token_group_id: string;
109
+ token_key_id: string;
110
+ token_user_id: string | null;
111
+ type: 'inference.request';
112
+ usage_source: 'provider' | 'gateway_tokenizer' | 'operator' | null;
113
+ usage_status: 'known' | 'unknown' | 'reconciled';
114
+ }
115
+ namespace UsageExportInferenceRequest {
116
+ interface Timings {
117
+ admitted_at: string;
118
+ completed_at: string | null;
119
+ first_attempt_at: string | null;
120
+ /**
121
+ * completed_at - admitted_at as recorded by the ledger; not time to first token.
122
+ */
123
+ gateway_duration_ms: number | null;
124
+ settled_at: string;
125
+ }
126
+ }
127
+ interface UsageExportGuardrailEvaluation {
128
+ id: string;
129
+ created_at: string;
130
+ end_user_id: string | null;
131
+ evaluation_input_tokens: number | null;
132
+ evaluation_output_tokens: number | null;
133
+ findings: Array<UsageAPI.GuardrailFinding>;
134
+ /**
135
+ * Customer request tags from the x-ltg-metadata header: up to 5 entries. Keys are
136
+ * case-sensitive; keys starting with ltg*, telnyx*, litellm* or cf* (any case) are
137
+ * reserved. Values are strings (1-256 characters, no control or format
138
+ * characters), integers within +/-9007199254740991, or booleans; floats, null,
139
+ * objects and arrays are rejected. Values that look like credentials are rejected.
140
+ * Tags are attribution only: never forwarded upstream, never part of the response
141
+ * cache key, never used for budgets or routing. An untagged request reports {}.
142
+ */
143
+ metadata: {
144
+ [key: string]: string | number | boolean;
145
+ };
146
+ model: string;
147
+ outcome: 'evaluated' | 'flagged' | 'blocked' | 'unevaluated';
148
+ request_id: string;
149
+ schema_version: 1;
150
+ stage: 'prompt' | 'response';
151
+ token_group_id: string;
152
+ token_key_id: string;
153
+ token_user_id: string | null;
154
+ type: 'guardrail.evaluation';
155
+ }
156
+ interface Meta {
157
+ has_more: boolean;
158
+ horizon_lag_seconds: number;
159
+ next_cursor: string;
160
+ }
161
+ }
162
+ export interface UsageRetrieveSummaryResponse {
163
+ data: UsageRetrieveSummaryResponse.Data;
164
+ meta: UsageRetrieveSummaryResponse.Meta;
165
+ }
166
+ export declare namespace UsageRetrieveSummaryResponse {
167
+ interface Data {
168
+ by_day: Array<Data.ByDay>;
169
+ by_model: Array<Data.ByModel>;
170
+ guardrails: Data.Guardrails;
171
+ totals: Data.Totals;
172
+ }
173
+ namespace Data {
174
+ interface ByDay {
175
+ cache_hits: number;
176
+ date: string;
177
+ failed_requests: number;
178
+ input_tokens: number;
179
+ output_tokens: number;
180
+ partial_requests: number;
181
+ requests: number;
182
+ /**
183
+ * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
184
+ * never binary float accounting.
185
+ */
186
+ reserved_spend: number;
187
+ /**
188
+ * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
189
+ * never binary float accounting.
190
+ */
191
+ spend: number;
192
+ succeeded_requests: number;
193
+ unknown_requests: number;
194
+ }
195
+ interface ByModel {
196
+ cache_hits: number;
197
+ failed_requests: number;
198
+ input_tokens: number;
199
+ model: string;
200
+ output_tokens: number;
201
+ partial_requests: number;
202
+ requests: number;
203
+ /**
204
+ * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
205
+ * never binary float accounting.
206
+ */
207
+ reserved_spend: number;
208
+ /**
209
+ * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
210
+ * never binary float accounting.
211
+ */
212
+ spend: number;
213
+ succeeded_requests: number;
214
+ unknown_requests: number;
215
+ }
216
+ interface Guardrails {
217
+ blocked_events: number;
218
+ flagged_events: number;
219
+ recent_events: Array<Guardrails.RecentEvent>;
220
+ }
221
+ namespace Guardrails {
222
+ interface RecentEvent {
223
+ id: string;
224
+ created_at: string;
225
+ end_user_id: string | null;
226
+ evaluation_input_tokens: number | null;
227
+ evaluation_output_tokens: number | null;
228
+ findings: Array<UsageAPI.GuardrailFinding>;
229
+ /**
230
+ * Customer request tags from the x-ltg-metadata header: up to 5 entries. Keys are
231
+ * case-sensitive; keys starting with ltg*, telnyx*, litellm* or cf* (any case) are
232
+ * reserved. Values are strings (1-256 characters, no control or format
233
+ * characters), integers within +/-9007199254740991, or booleans; floats, null,
234
+ * objects and arrays are rejected. Values that look like credentials are rejected.
235
+ * Tags are attribution only: never forwarded upstream, never part of the response
236
+ * cache key, never used for budgets or routing. An untagged request reports {}.
237
+ */
238
+ metadata: {
239
+ [key: string]: string | number | boolean;
240
+ };
241
+ model: string;
242
+ outcome: 'evaluated' | 'flagged' | 'blocked' | 'unevaluated';
243
+ record_type: 'guardrail_event';
244
+ request_id: string;
245
+ stage: 'prompt' | 'response';
246
+ token_group_id: string;
247
+ token_key_id: string;
248
+ token_user_id: string | null;
249
+ }
250
+ }
251
+ interface Totals {
252
+ cache_hits: number;
253
+ failed_requests: number;
254
+ input_tokens: number;
255
+ output_tokens: number;
256
+ partial_requests: number;
257
+ requests: number;
258
+ /**
259
+ * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
260
+ * never binary float accounting.
261
+ */
262
+ reserved_spend: number;
263
+ /**
264
+ * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
265
+ * never binary float accounting.
266
+ */
267
+ spend: number;
268
+ succeeded_requests: number;
269
+ unknown_requests: number;
270
+ }
271
+ }
272
+ interface Meta {
273
+ end_date: string;
274
+ /**
275
+ * The metadata[<key>] filters applied to every section; {} when unfiltered.
276
+ */
277
+ metadata: {
278
+ [key: string]: string;
279
+ };
280
+ start_date: string;
281
+ token_group_id: string;
282
+ }
283
+ }
284
+ export interface UsageRetrieveSummaryParams {
285
+ end_date: string;
286
+ start_date: string;
287
+ token_group_id: string;
288
+ /**
289
+ * Request tag filters as metadata[<key>]=<value>, at most 5, combined with AND. A
290
+ * value matches the tag's text form exactly (booleans as true/false, integers in
291
+ * decimal), so metadata[flag]=true matches both boolean true and the string
292
+ * "true". Keys are case-sensitive; reserved-prefix keys are rejected. Unindexed:
293
+ * bounded by the account, the date range and the report timeout.
294
+ */
295
+ metadata?: {
296
+ [key: string]: string;
297
+ };
298
+ }
299
+ export interface UsageRetrieveExportParams {
300
+ /**
301
+ * Opaque next_cursor from a previous page; not combinable with start_time. Bound
302
+ * to the requested types; the account always comes from the credential.
303
+ */
304
+ cursor?: string;
305
+ limit?: number;
306
+ /**
307
+ * First page only: RFC 3339 with offset, at most 30 days ago and not in the
308
+ * future; default now - 24h.
309
+ */
310
+ start_time?: string;
311
+ /**
312
+ * Comma-separated subset of inference.request,guardrail.evaluation; default both.
313
+ */
314
+ types?: string;
315
+ }
316
+ export declare namespace Usage {
317
+ export { type GuardrailFinding as GuardrailFinding, type UsageRetrieveExportResponse as UsageRetrieveExportResponse, type UsageRetrieveSummaryResponse as UsageRetrieveSummaryResponse, type UsageRetrieveSummaryParams as UsageRetrieveSummaryParams, type UsageRetrieveExportParams as UsageRetrieveExportParams, };
318
+ }
319
+ //# sourceMappingURL=usage.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usage.d.mts","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/usage.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,319 @@
1
+ import { APIResource } from "../../core/resource.js";
2
+ import * as UsageAPI from "./usage.js";
3
+ import { APIPromise } from "../../core/api-promise.js";
4
+ import { RequestOptions } from "../../internal/request-options.js";
5
+ /**
6
+ * Manage and report AI Gateway usage.
7
+ */
8
+ export declare class Usage extends APIResource {
9
+ /**
10
+ * Gateway reference/enforcement usage, not invoice truth or BYOK provider charges.
11
+ * Requires the dedicated llm_token_gateway.usage.read V2 action for combined spend
12
+ * and guardrail reporting; existing spend.read and guardrail_events.read grants do
13
+ * not grant this endpoint. All totals, UTC daily buckets, models and latest 20
14
+ * guardrail events share one database snapshot. UTC half-open dates, at most 31
15
+ * days. Zero-filled days; at most 1000 models (503 rather than truncation on
16
+ * overflow/timeout). Known tokens sum independently known categories across latest
17
+ * attempt evidence, including corrections; unknown spend is excluded and
18
+ * unknown_requests/reserved_spend remain explicit. Guardrail counts count events,
19
+ * not distinct requests. No raw spend events, prompts or secrets. This read-only
20
+ * report creates no pagination snapshot and accepts no pagination parameters.
21
+ *
22
+ * @example
23
+ * ```ts
24
+ * const response =
25
+ * await client.llmTokenGateway.usage.retrieveSummary({
26
+ * end_date: '2019-12-27',
27
+ * start_date: '2019-12-27',
28
+ * token_group_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
29
+ * });
30
+ * ```
31
+ */
32
+ retrieveSummary(query: UsageRetrieveSummaryParams, options?: RequestOptions): APIPromise<UsageRetrieveSummaryResponse>;
33
+ /**
34
+ * Durable, replayable, content-free usage export for customer pipelines. Requires
35
+ * the dedicated llm_token_gateway.usage_export.read V2 action; spend.read and
36
+ * usage.read do not grant it. Records are inference.request (one per immutable
37
+ * ledger revision; a correction adds a new id with supersedes, keep the highest
38
+ * revision per request_id) and guardrail.evaluation (one per guardrail event,
39
+ * including blocked prompts with no inference record; correlate on request_id).
40
+ * Delivery is at least once in commit order: deduplicate on id. Records appear
41
+ * after settlement and after every older database transaction has finished
42
+ * (meta.horizon_lag_seconds); keep polling with next_cursor, which is always
43
+ * returned and is reusable after has_more is false. After a logical database
44
+ * restore, restart from start_time and deduplicate on id; a cursor from before it
45
+ * may return 409 cursor_expired (no Retry-After). Retention promise 30 days. No
46
+ * prompts, responses, provider credentials, supplier or customer rates. Gateway
47
+ * reference/enforcement usage, not invoice truth or BYOK provider charges.
48
+ *
49
+ * @example
50
+ * ```ts
51
+ * const response =
52
+ * await client.llmTokenGateway.usage.retrieveExport();
53
+ * ```
54
+ */
55
+ retrieveExport(query?: UsageRetrieveExportParams | null | undefined, options?: RequestOptions): APIPromise<UsageRetrieveExportResponse>;
56
+ }
57
+ export interface GuardrailFinding {
58
+ action: 'flag' | 'block';
59
+ code: string;
60
+ count: number;
61
+ detector: 'secrets' | 'dlp' | 'safety';
62
+ }
63
+ export interface UsageRetrieveExportResponse {
64
+ data: Array<UsageRetrieveExportResponse.UsageExportInferenceRequest | UsageRetrieveExportResponse.UsageExportGuardrailEvaluation>;
65
+ meta: UsageRetrieveExportResponse.Meta;
66
+ }
67
+ export declare namespace UsageRetrieveExportResponse {
68
+ interface UsageExportInferenceRequest {
69
+ /**
70
+ * Deterministic: req\_{request_id}\_r{revision}. Deduplicate on id.
71
+ */
72
+ id: string;
73
+ attempts: number;
74
+ biller: 'telnyx' | 'provider' | 'none';
75
+ cache_hit: boolean;
76
+ configuration_version: number;
77
+ /**
78
+ * USD decimal string with exactly 6 places, 0 to 1000000000.000000 (the Money
79
+ * bound); enforcement basis, not invoice truth.
80
+ */
81
+ cost: string | null;
82
+ end_user_id: string | null;
83
+ input_tokens: number | null;
84
+ /**
85
+ * Customer request tags captured at admission; {} when untagged.
86
+ */
87
+ metadata: {
88
+ [key: string]: string | number | boolean;
89
+ };
90
+ model: string;
91
+ output_tokens: number | null;
92
+ protocol: 'openai' | 'anthropic';
93
+ provider: string;
94
+ provider_key_id: string | null;
95
+ provider_model: string;
96
+ rate_version: string;
97
+ request_id: string;
98
+ revision: number;
99
+ route_mode: 'managed' | 'byok' | 'cache';
100
+ schema_version: 1;
101
+ status: 'succeeded' | 'failed' | 'partial' | 'unknown';
102
+ stream: boolean;
103
+ /**
104
+ * Previous revision id; keep the highest revision per request_id.
105
+ */
106
+ supersedes: string | null;
107
+ timings: UsageExportInferenceRequest.Timings;
108
+ token_group_id: string;
109
+ token_key_id: string;
110
+ token_user_id: string | null;
111
+ type: 'inference.request';
112
+ usage_source: 'provider' | 'gateway_tokenizer' | 'operator' | null;
113
+ usage_status: 'known' | 'unknown' | 'reconciled';
114
+ }
115
+ namespace UsageExportInferenceRequest {
116
+ interface Timings {
117
+ admitted_at: string;
118
+ completed_at: string | null;
119
+ first_attempt_at: string | null;
120
+ /**
121
+ * completed_at - admitted_at as recorded by the ledger; not time to first token.
122
+ */
123
+ gateway_duration_ms: number | null;
124
+ settled_at: string;
125
+ }
126
+ }
127
+ interface UsageExportGuardrailEvaluation {
128
+ id: string;
129
+ created_at: string;
130
+ end_user_id: string | null;
131
+ evaluation_input_tokens: number | null;
132
+ evaluation_output_tokens: number | null;
133
+ findings: Array<UsageAPI.GuardrailFinding>;
134
+ /**
135
+ * Customer request tags from the x-ltg-metadata header: up to 5 entries. Keys are
136
+ * case-sensitive; keys starting with ltg*, telnyx*, litellm* or cf* (any case) are
137
+ * reserved. Values are strings (1-256 characters, no control or format
138
+ * characters), integers within +/-9007199254740991, or booleans; floats, null,
139
+ * objects and arrays are rejected. Values that look like credentials are rejected.
140
+ * Tags are attribution only: never forwarded upstream, never part of the response
141
+ * cache key, never used for budgets or routing. An untagged request reports {}.
142
+ */
143
+ metadata: {
144
+ [key: string]: string | number | boolean;
145
+ };
146
+ model: string;
147
+ outcome: 'evaluated' | 'flagged' | 'blocked' | 'unevaluated';
148
+ request_id: string;
149
+ schema_version: 1;
150
+ stage: 'prompt' | 'response';
151
+ token_group_id: string;
152
+ token_key_id: string;
153
+ token_user_id: string | null;
154
+ type: 'guardrail.evaluation';
155
+ }
156
+ interface Meta {
157
+ has_more: boolean;
158
+ horizon_lag_seconds: number;
159
+ next_cursor: string;
160
+ }
161
+ }
162
+ export interface UsageRetrieveSummaryResponse {
163
+ data: UsageRetrieveSummaryResponse.Data;
164
+ meta: UsageRetrieveSummaryResponse.Meta;
165
+ }
166
+ export declare namespace UsageRetrieveSummaryResponse {
167
+ interface Data {
168
+ by_day: Array<Data.ByDay>;
169
+ by_model: Array<Data.ByModel>;
170
+ guardrails: Data.Guardrails;
171
+ totals: Data.Totals;
172
+ }
173
+ namespace Data {
174
+ interface ByDay {
175
+ cache_hits: number;
176
+ date: string;
177
+ failed_requests: number;
178
+ input_tokens: number;
179
+ output_tokens: number;
180
+ partial_requests: number;
181
+ requests: number;
182
+ /**
183
+ * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
184
+ * never binary float accounting.
185
+ */
186
+ reserved_spend: number;
187
+ /**
188
+ * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
189
+ * never binary float accounting.
190
+ */
191
+ spend: number;
192
+ succeeded_requests: number;
193
+ unknown_requests: number;
194
+ }
195
+ interface ByModel {
196
+ cache_hits: number;
197
+ failed_requests: number;
198
+ input_tokens: number;
199
+ model: string;
200
+ output_tokens: number;
201
+ partial_requests: number;
202
+ requests: number;
203
+ /**
204
+ * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
205
+ * never binary float accounting.
206
+ */
207
+ reserved_spend: number;
208
+ /**
209
+ * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
210
+ * never binary float accounting.
211
+ */
212
+ spend: number;
213
+ succeeded_requests: number;
214
+ unknown_requests: number;
215
+ }
216
+ interface Guardrails {
217
+ blocked_events: number;
218
+ flagged_events: number;
219
+ recent_events: Array<Guardrails.RecentEvent>;
220
+ }
221
+ namespace Guardrails {
222
+ interface RecentEvent {
223
+ id: string;
224
+ created_at: string;
225
+ end_user_id: string | null;
226
+ evaluation_input_tokens: number | null;
227
+ evaluation_output_tokens: number | null;
228
+ findings: Array<UsageAPI.GuardrailFinding>;
229
+ /**
230
+ * Customer request tags from the x-ltg-metadata header: up to 5 entries. Keys are
231
+ * case-sensitive; keys starting with ltg*, telnyx*, litellm* or cf* (any case) are
232
+ * reserved. Values are strings (1-256 characters, no control or format
233
+ * characters), integers within +/-9007199254740991, or booleans; floats, null,
234
+ * objects and arrays are rejected. Values that look like credentials are rejected.
235
+ * Tags are attribution only: never forwarded upstream, never part of the response
236
+ * cache key, never used for budgets or routing. An untagged request reports {}.
237
+ */
238
+ metadata: {
239
+ [key: string]: string | number | boolean;
240
+ };
241
+ model: string;
242
+ outcome: 'evaluated' | 'flagged' | 'blocked' | 'unevaluated';
243
+ record_type: 'guardrail_event';
244
+ request_id: string;
245
+ stage: 'prompt' | 'response';
246
+ token_group_id: string;
247
+ token_key_id: string;
248
+ token_user_id: string | null;
249
+ }
250
+ }
251
+ interface Totals {
252
+ cache_hits: number;
253
+ failed_requests: number;
254
+ input_tokens: number;
255
+ output_tokens: number;
256
+ partial_requests: number;
257
+ requests: number;
258
+ /**
259
+ * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
260
+ * never binary float accounting.
261
+ */
262
+ reserved_spend: number;
263
+ /**
264
+ * USD, decimal precision at most 6 places; parse exactly to integer micro-USD,
265
+ * never binary float accounting.
266
+ */
267
+ spend: number;
268
+ succeeded_requests: number;
269
+ unknown_requests: number;
270
+ }
271
+ }
272
+ interface Meta {
273
+ end_date: string;
274
+ /**
275
+ * The metadata[<key>] filters applied to every section; {} when unfiltered.
276
+ */
277
+ metadata: {
278
+ [key: string]: string;
279
+ };
280
+ start_date: string;
281
+ token_group_id: string;
282
+ }
283
+ }
284
+ export interface UsageRetrieveSummaryParams {
285
+ end_date: string;
286
+ start_date: string;
287
+ token_group_id: string;
288
+ /**
289
+ * Request tag filters as metadata[<key>]=<value>, at most 5, combined with AND. A
290
+ * value matches the tag's text form exactly (booleans as true/false, integers in
291
+ * decimal), so metadata[flag]=true matches both boolean true and the string
292
+ * "true". Keys are case-sensitive; reserved-prefix keys are rejected. Unindexed:
293
+ * bounded by the account, the date range and the report timeout.
294
+ */
295
+ metadata?: {
296
+ [key: string]: string;
297
+ };
298
+ }
299
+ export interface UsageRetrieveExportParams {
300
+ /**
301
+ * Opaque next_cursor from a previous page; not combinable with start_time. Bound
302
+ * to the requested types; the account always comes from the credential.
303
+ */
304
+ cursor?: string;
305
+ limit?: number;
306
+ /**
307
+ * First page only: RFC 3339 with offset, at most 30 days ago and not in the
308
+ * future; default now - 24h.
309
+ */
310
+ start_time?: string;
311
+ /**
312
+ * Comma-separated subset of inference.request,guardrail.evaluation; default both.
313
+ */
314
+ types?: string;
315
+ }
316
+ export declare namespace Usage {
317
+ export { type GuardrailFinding as GuardrailFinding, type UsageRetrieveExportResponse as UsageRetrieveExportResponse, type UsageRetrieveSummaryResponse as UsageRetrieveSummaryResponse, type UsageRetrieveSummaryParams as UsageRetrieveSummaryParams, type UsageRetrieveExportParams as UsageRetrieveExportParams, };
318
+ }
319
+ //# sourceMappingURL=usage.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/usage.ts"],"names":[],"mappings":"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"}