@songtonyli/dsh-cli 0.1.56 → 0.1.58

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 (1301) hide show
  1. package/README.md +1 -1
  2. package/bin/dsh.mjs +1 -1
  3. package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/package.json +6 -6
  4. package/node_modules/@aws-sdk/token-providers/package.json +6 -6
  5. package/node_modules/@deepseek-ai/dsh-client-ui-sidebar/lib/client.js +1 -1
  6. package/node_modules/@deepseek-ai/dsh-client-ui-slots/package.json +2 -2
  7. package/node_modules/@deepseek-ai/dsh-llm-pi-ai/README.i18n.yaml +2 -2
  8. package/node_modules/@deepseek-ai/dsh-llm-pi-ai/README.md +1 -1
  9. package/node_modules/@deepseek-ai/dsh-llm-pi-ai/README.zh.md +1 -1
  10. package/node_modules/@deepseek-ai/dsh-llm-pi-ai/lib/index.js +1 -182
  11. package/node_modules/@deepseek-ai/dsh-llm-pi-ai/package.json +1 -1
  12. package/node_modules/@deepseek-ai/dsh-tui-app/README.i18n.yaml +6 -6
  13. package/node_modules/@deepseek-ai/dsh-tui-app/README.md +6 -5
  14. package/node_modules/@deepseek-ai/dsh-tui-app/README.zh.md +6 -5
  15. package/node_modules/@deepseek-ai/dsh-tui-app/lib/index.js +43 -32
  16. package/node_modules/@earendil-works/pi-ai/README.md +207 -27
  17. package/node_modules/@earendil-works/pi-ai/dist/api/anthropic-messages.js +6 -0
  18. package/node_modules/@earendil-works/pi-ai/dist/api/azure-openai-responses.js +6 -5
  19. package/node_modules/@earendil-works/pi-ai/dist/api/bedrock-converse-stream.js +1 -0
  20. package/node_modules/@earendil-works/pi-ai/dist/api/cloudflare-workers-ai-system-one.js +43 -0
  21. package/node_modules/@earendil-works/pi-ai/dist/api/cloudflare-workers-ai-system-one.lazy.js +4 -0
  22. package/node_modules/@earendil-works/pi-ai/dist/api/cloudflare.js +2 -0
  23. package/node_modules/@earendil-works/pi-ai/dist/api/google-generative-ai.js +1 -0
  24. package/node_modules/@earendil-works/pi-ai/dist/api/google-vertex.js +1 -0
  25. package/node_modules/@earendil-works/pi-ai/dist/api/llama-cpp-classify.js +365 -0
  26. package/node_modules/@earendil-works/pi-ai/dist/api/llama-cpp-classify.lazy.js +4 -0
  27. package/node_modules/@earendil-works/pi-ai/dist/api/mistral-conversations.js +18 -17
  28. package/node_modules/@earendil-works/pi-ai/dist/api/openai-codex-responses.js +20 -4
  29. package/node_modules/@earendil-works/pi-ai/dist/api/openai-completions.js +4 -4
  30. package/node_modules/@earendil-works/pi-ai/dist/api/openai-responses-shared.js +14 -0
  31. package/node_modules/@earendil-works/pi-ai/dist/api/openai-responses.js +26 -9
  32. package/node_modules/@earendil-works/pi-ai/dist/api/openrouter-images.js +1 -0
  33. package/node_modules/@earendil-works/pi-ai/dist/api/pi-messages.js +1 -0
  34. package/node_modules/@earendil-works/pi-ai/dist/api/simple-options.js +2 -4
  35. package/node_modules/@earendil-works/pi-ai/dist/api/system-one-shared.js +183 -0
  36. package/node_modules/@earendil-works/pi-ai/dist/api/typesafe-system-one.js +19 -0
  37. package/node_modules/@earendil-works/pi-ai/dist/api/typesafe-system-one.lazy.js +4 -0
  38. package/node_modules/@earendil-works/pi-ai/dist/auth/helpers.js +1 -1
  39. package/node_modules/@earendil-works/pi-ai/dist/auth/oauth/anthropic.js +19 -128
  40. package/node_modules/@earendil-works/pi-ai/dist/auth/oauth/callback-server.js +146 -0
  41. package/node_modules/@earendil-works/pi-ai/dist/auth/oauth/load.js +5 -0
  42. package/node_modules/@earendil-works/pi-ai/dist/auth/oauth/openai-chatgpt.js +266 -0
  43. package/node_modules/@earendil-works/pi-ai/dist/auth/oauth/openai-codex.js +20 -124
  44. package/node_modules/@earendil-works/pi-ai/dist/auth/oauth/openrouter.js +19 -138
  45. package/node_modules/@earendil-works/pi-ai/dist/auth/oauth/radius.js +21 -89
  46. package/node_modules/@earendil-works/pi-ai/dist/auth/resolve.js +3 -19
  47. package/node_modules/@earendil-works/pi-ai/dist/bun-oauth.js +2 -0
  48. package/node_modules/@earendil-works/pi-ai/dist/cli.js +3 -1
  49. package/node_modules/@earendil-works/pi-ai/dist/env-api-keys.js +1 -0
  50. package/node_modules/@earendil-works/pi-ai/dist/image-models.js +14 -13
  51. package/node_modules/@earendil-works/pi-ai/dist/images.js +5 -0
  52. package/node_modules/@earendil-works/pi-ai/dist/index.js +0 -1
  53. package/node_modules/@earendil-works/pi-ai/dist/model-catalog.js +14 -2
  54. package/node_modules/@earendil-works/pi-ai/dist/models.generated.js +131 -41
  55. package/node_modules/@earendil-works/pi-ai/dist/models.js +157 -30
  56. package/node_modules/@earendil-works/pi-ai/dist/providers/all.js +25 -21
  57. package/node_modules/@earendil-works/pi-ai/dist/providers/amazon-bedrock.models.js +4 -2
  58. package/node_modules/@earendil-works/pi-ai/dist/providers/ant-ling.models.js +4 -2
  59. package/node_modules/@earendil-works/pi-ai/dist/providers/anthropic.models.js +4 -2
  60. package/node_modules/@earendil-works/pi-ai/dist/providers/azure-openai-responses.models.js +4 -2
  61. package/node_modules/@earendil-works/pi-ai/dist/providers/baseten.models.js +4 -2
  62. package/node_modules/@earendil-works/pi-ai/dist/providers/cerebras.models.js +4 -2
  63. package/node_modules/@earendil-works/pi-ai/dist/providers/cloudflare-ai-gateway.models.js +4 -2
  64. package/node_modules/@earendil-works/pi-ai/dist/providers/cloudflare-stream.js +6 -0
  65. package/node_modules/@earendil-works/pi-ai/dist/providers/cloudflare-workers-ai.js +10 -3
  66. package/node_modules/@earendil-works/pi-ai/dist/providers/cloudflare-workers-ai.models.js +4 -2
  67. package/node_modules/@earendil-works/pi-ai/dist/providers/data/.manifest.json +1 -1
  68. package/node_modules/@earendil-works/pi-ai/dist/providers/data/amazon-bedrock.json +1 -1
  69. package/node_modules/@earendil-works/pi-ai/dist/providers/data/ant-ling.json +1 -1
  70. package/node_modules/@earendil-works/pi-ai/dist/providers/data/anthropic.json +1 -1
  71. package/node_modules/@earendil-works/pi-ai/dist/providers/data/azure-openai-responses.json +1 -1
  72. package/node_modules/@earendil-works/pi-ai/dist/providers/data/baseten.json +1 -1
  73. package/node_modules/@earendil-works/pi-ai/dist/providers/data/cerebras.json +1 -1
  74. package/node_modules/@earendil-works/pi-ai/dist/providers/data/cloudflare-ai-gateway.json +1 -1
  75. package/node_modules/@earendil-works/pi-ai/dist/providers/data/cloudflare-workers-ai.json +1 -1
  76. package/node_modules/@earendil-works/pi-ai/dist/providers/data/deepseek.json +1 -1
  77. package/node_modules/@earendil-works/pi-ai/dist/providers/data/fireworks.json +1 -1
  78. package/node_modules/@earendil-works/pi-ai/dist/providers/data/github-copilot.json +1 -1
  79. package/node_modules/@earendil-works/pi-ai/dist/providers/data/google-vertex.json +1 -1
  80. package/node_modules/@earendil-works/pi-ai/dist/providers/data/google.json +1 -1
  81. package/node_modules/@earendil-works/pi-ai/dist/providers/data/groq.json +1 -1
  82. package/node_modules/@earendil-works/pi-ai/dist/providers/data/huggingface.json +1 -1
  83. package/node_modules/@earendil-works/pi-ai/dist/providers/data/kimi-coding.json +1 -1
  84. package/node_modules/@earendil-works/pi-ai/dist/providers/data/meta.json +1 -1
  85. package/node_modules/@earendil-works/pi-ai/dist/providers/data/minimax-cn.json +1 -1
  86. package/node_modules/@earendil-works/pi-ai/dist/providers/data/minimax.json +1 -1
  87. package/node_modules/@earendil-works/pi-ai/dist/providers/data/mistral.json +1 -1
  88. package/node_modules/@earendil-works/pi-ai/dist/providers/data/moonshotai-cn.json +1 -1
  89. package/node_modules/@earendil-works/pi-ai/dist/providers/data/moonshotai.json +1 -1
  90. package/node_modules/@earendil-works/pi-ai/dist/providers/data/nvidia.json +1 -1
  91. package/node_modules/@earendil-works/pi-ai/dist/providers/data/openai-codex.json +1 -1
  92. package/node_modules/@earendil-works/pi-ai/dist/providers/data/openai.json +1 -1
  93. package/node_modules/@earendil-works/pi-ai/dist/providers/data/opencode-go.json +1 -1
  94. package/node_modules/@earendil-works/pi-ai/dist/providers/data/opencode.json +1 -1
  95. package/node_modules/@earendil-works/pi-ai/dist/providers/data/openrouter.json +1 -1
  96. package/node_modules/@earendil-works/pi-ai/dist/providers/data/qwen-token-plan-cn.json +1 -1
  97. package/node_modules/@earendil-works/pi-ai/dist/providers/data/qwen-token-plan-individual.json +1 -1
  98. package/node_modules/@earendil-works/pi-ai/dist/providers/data/qwen-token-plan.json +1 -1
  99. package/node_modules/@earendil-works/pi-ai/dist/providers/data/radius.json +1 -1
  100. package/node_modules/@earendil-works/pi-ai/dist/providers/data/together.json +1 -1
  101. package/node_modules/@earendil-works/pi-ai/dist/providers/data/typesafe.json +1 -0
  102. package/node_modules/@earendil-works/pi-ai/dist/providers/data/vercel-ai-gateway.json +1 -1
  103. package/node_modules/@earendil-works/pi-ai/dist/providers/data/xai.json +1 -1
  104. package/node_modules/@earendil-works/pi-ai/dist/providers/data/xiaomi-token-plan-ams.json +1 -1
  105. package/node_modules/@earendil-works/pi-ai/dist/providers/data/xiaomi-token-plan-cn.json +1 -1
  106. package/node_modules/@earendil-works/pi-ai/dist/providers/data/xiaomi-token-plan-sgp.json +1 -1
  107. package/node_modules/@earendil-works/pi-ai/dist/providers/data/xiaomi.json +1 -1
  108. package/node_modules/@earendil-works/pi-ai/dist/providers/data/zai-coding-cn.json +1 -1
  109. package/node_modules/@earendil-works/pi-ai/dist/providers/data/zai.json +1 -1
  110. package/node_modules/@earendil-works/pi-ai/dist/providers/deepseek.models.js +4 -2
  111. package/node_modules/@earendil-works/pi-ai/dist/providers/fireworks.models.js +4 -2
  112. package/node_modules/@earendil-works/pi-ai/dist/providers/github-copilot.models.js +4 -2
  113. package/node_modules/@earendil-works/pi-ai/dist/providers/google-vertex.models.js +4 -2
  114. package/node_modules/@earendil-works/pi-ai/dist/providers/google.models.js +4 -2
  115. package/node_modules/@earendil-works/pi-ai/dist/providers/groq.models.js +4 -2
  116. package/node_modules/@earendil-works/pi-ai/dist/providers/huggingface.models.js +4 -2
  117. package/node_modules/@earendil-works/pi-ai/dist/providers/kimi-coding.models.js +4 -2
  118. package/node_modules/@earendil-works/pi-ai/dist/providers/meta.models.js +4 -2
  119. package/node_modules/@earendil-works/pi-ai/dist/providers/minimax-cn.models.js +4 -2
  120. package/node_modules/@earendil-works/pi-ai/dist/providers/minimax.models.js +4 -2
  121. package/node_modules/@earendil-works/pi-ai/dist/providers/mistral.models.js +4 -2
  122. package/node_modules/@earendil-works/pi-ai/dist/providers/moonshotai-cn.models.js +4 -2
  123. package/node_modules/@earendil-works/pi-ai/dist/providers/moonshotai.models.js +4 -2
  124. package/node_modules/@earendil-works/pi-ai/dist/providers/nvidia.models.js +4 -2
  125. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-codex.js +1 -1
  126. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-codex.models.js +4 -2
  127. package/node_modules/@earendil-works/pi-ai/dist/providers/openai.js +11 -2
  128. package/node_modules/@earendil-works/pi-ai/dist/providers/openai.models.js +4 -2
  129. package/node_modules/@earendil-works/pi-ai/dist/providers/opencode-go.models.js +4 -2
  130. package/node_modules/@earendil-works/pi-ai/dist/providers/opencode.js +5 -2
  131. package/node_modules/@earendil-works/pi-ai/dist/providers/opencode.models.js +4 -2
  132. package/node_modules/@earendil-works/pi-ai/dist/providers/openrouter.js +11 -2
  133. package/node_modules/@earendil-works/pi-ai/dist/providers/openrouter.models.js +4 -2
  134. package/node_modules/@earendil-works/pi-ai/dist/providers/qwen-token-plan-cn.models.js +4 -2
  135. package/node_modules/@earendil-works/pi-ai/dist/providers/qwen-token-plan-individual.models.js +4 -2
  136. package/node_modules/@earendil-works/pi-ai/dist/providers/qwen-token-plan.models.js +4 -2
  137. package/node_modules/@earendil-works/pi-ai/dist/providers/radius.models.js +4 -2
  138. package/node_modules/@earendil-works/pi-ai/dist/providers/together.models.js +4 -2
  139. package/node_modules/@earendil-works/pi-ai/dist/providers/typesafe.js +18 -0
  140. package/node_modules/@earendil-works/pi-ai/dist/providers/typesafe.models.js +8 -0
  141. package/node_modules/@earendil-works/pi-ai/dist/providers/vercel-ai-gateway.js +5 -2
  142. package/node_modules/@earendil-works/pi-ai/dist/providers/vercel-ai-gateway.models.js +4 -2
  143. package/node_modules/@earendil-works/pi-ai/dist/providers/xai.models.js +4 -2
  144. package/node_modules/@earendil-works/pi-ai/dist/providers/xiaomi-token-plan-ams.models.js +4 -2
  145. package/node_modules/@earendil-works/pi-ai/dist/providers/xiaomi-token-plan-cn.models.js +4 -2
  146. package/node_modules/@earendil-works/pi-ai/dist/providers/xiaomi-token-plan-sgp.models.js +4 -2
  147. package/node_modules/@earendil-works/pi-ai/dist/providers/xiaomi.models.js +4 -2
  148. package/node_modules/@earendil-works/pi-ai/dist/providers/zai-coding-cn.models.js +4 -2
  149. package/node_modules/@earendil-works/pi-ai/dist/providers/zai.models.js +4 -2
  150. package/node_modules/@earendil-works/pi-ai/dist/utils/headers.js +10 -8
  151. package/node_modules/@earendil-works/pi-ai/dist/utils/model-operations.js +47 -0
  152. package/node_modules/@earendil-works/pi-ai/dist/utils/models-error.js +19 -0
  153. package/node_modules/@earendil-works/pi-ai/dist/utils/retry.js +7 -0
  154. package/node_modules/@earendil-works/pi-ai/package.json +4 -4
  155. package/node_modules/@earendil-works/pi-telemetry/package.json +2 -2
  156. package/node_modules/openai/CHANGELOG.md +1089 -1
  157. package/node_modules/openai/README.md +201 -102
  158. package/node_modules/openai/_vendor/partial-json-parser/parser.js +55 -38
  159. package/node_modules/openai/_vendor/partial-json-parser/parser.mjs +55 -38
  160. package/node_modules/openai/_vendor/zod-to-json-schema/Options.js +11 -2
  161. package/node_modules/openai/_vendor/zod-to-json-schema/Options.mjs +11 -2
  162. package/node_modules/openai/_vendor/zod-to-json-schema/Refs.js +4 -4
  163. package/node_modules/openai/_vendor/zod-to-json-schema/Refs.mjs +4 -4
  164. package/node_modules/openai/_vendor/zod-to-json-schema/errorMessages.js +2 -1
  165. package/node_modules/openai/_vendor/zod-to-json-schema/errorMessages.mjs +2 -1
  166. package/node_modules/openai/_vendor/zod-to-json-schema/index.js +1 -1
  167. package/node_modules/openai/_vendor/zod-to-json-schema/index.mjs +1 -1
  168. package/node_modules/openai/_vendor/zod-to-json-schema/parseDef.js +139 -54
  169. package/node_modules/openai/_vendor/zod-to-json-schema/parseDef.mjs +139 -54
  170. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/array.js +1 -1
  171. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/array.mjs +1 -1
  172. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/bigint.js +10 -4
  173. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/bigint.mjs +10 -4
  174. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/branded.js +2 -2
  175. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/branded.mjs +2 -2
  176. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/catch.js +1 -3
  177. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/catch.mjs +1 -3
  178. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/date.js +10 -5
  179. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/date.mjs +10 -5
  180. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/default.js +2 -2
  181. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/default.mjs +2 -2
  182. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/intersection.js +6 -5
  183. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/intersection.mjs +6 -5
  184. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/literal.js +5 -0
  185. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/literal.mjs +5 -0
  186. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/nativeEnum.js +7 -9
  187. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/nativeEnum.mjs +7 -9
  188. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/null.js +3 -2
  189. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/null.mjs +3 -2
  190. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/nullable.js +8 -3
  191. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/nullable.mjs +8 -3
  192. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/number.js +12 -5
  193. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/number.mjs +12 -5
  194. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/object.js +43 -38
  195. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/object.mjs +43 -38
  196. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/optional.js +11 -12
  197. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/optional.mjs +11 -12
  198. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/pipeline.js +3 -3
  199. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/pipeline.mjs +3 -3
  200. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/promise.js +2 -2
  201. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/promise.mjs +2 -2
  202. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/readonly.js +1 -3
  203. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/readonly.mjs +1 -3
  204. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/record.js +7 -5
  205. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/record.mjs +7 -5
  206. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/string.js +57 -34
  207. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/string.mjs +57 -34
  208. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/tuple.js +24 -19
  209. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/tuple.mjs +24 -19
  210. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/union.js +46 -24
  211. package/node_modules/openai/_vendor/zod-to-json-schema/parsers/union.mjs +46 -24
  212. package/node_modules/openai/_vendor/zod-to-json-schema/util.js +7 -5
  213. package/node_modules/openai/_vendor/zod-to-json-schema/util.mjs +7 -5
  214. package/node_modules/openai/_vendor/zod-to-json-schema/zodToJsonSchema.js +110 -38
  215. package/node_modules/openai/_vendor/zod-to-json-schema/zodToJsonSchema.mjs +110 -38
  216. package/node_modules/openai/auth/subject-token-providers.js +235 -10
  217. package/node_modules/openai/auth/subject-token-providers.mjs +235 -10
  218. package/node_modules/openai/auth/workload-identity-auth.js +185 -24
  219. package/node_modules/openai/auth/workload-identity-auth.mjs +186 -25
  220. package/node_modules/openai/auth/x509-transport.js +273 -0
  221. package/node_modules/openai/auth/x509-transport.mjs +268 -0
  222. package/node_modules/openai/azure.js +74 -21
  223. package/node_modules/openai/azure.mjs +75 -22
  224. package/node_modules/openai/bedrock.js +174 -0
  225. package/node_modules/openai/bedrock.mjs +169 -0
  226. package/node_modules/openai/beta/realtime/internal-base.js +71 -10
  227. package/node_modules/openai/beta/realtime/internal-base.mjs +70 -10
  228. package/node_modules/openai/beta/realtime/websocket.js +180 -33
  229. package/node_modules/openai/beta/realtime/websocket.mjs +181 -34
  230. package/node_modules/openai/beta/realtime/ws.js +93 -14
  231. package/node_modules/openai/beta/realtime/ws.mjs +94 -15
  232. package/node_modules/openai/client.js +745 -99
  233. package/node_modules/openai/client.mjs +747 -101
  234. package/node_modules/openai/core/EventEmitter.js +127 -16
  235. package/node_modules/openai/core/EventEmitter.mjs +128 -17
  236. package/node_modules/openai/core/api-promise.js +0 -1
  237. package/node_modules/openai/core/api-promise.mjs +0 -1
  238. package/node_modules/openai/core/error.js +5 -5
  239. package/node_modules/openai/core/error.mjs +5 -5
  240. package/node_modules/openai/core/pagination.js +33 -3
  241. package/node_modules/openai/core/pagination.mjs +31 -2
  242. package/node_modules/openai/core/resource.js +0 -1
  243. package/node_modules/openai/core/resource.mjs +0 -1
  244. package/node_modules/openai/core/streaming.js +453 -88
  245. package/node_modules/openai/core/streaming.mjs +454 -89
  246. package/node_modules/openai/core/uploads.js +3 -1
  247. package/node_modules/openai/core/uploads.mjs +1 -0
  248. package/node_modules/openai/helpers/audio.js +198 -28
  249. package/node_modules/openai/helpers/audio.mjs +199 -29
  250. package/node_modules/openai/helpers/live.js +6 -0
  251. package/node_modules/openai/helpers/live.mjs +2 -0
  252. package/node_modules/openai/helpers/standard-schema.js +393 -0
  253. package/node_modules/openai/helpers/standard-schema.mjs +387 -0
  254. package/node_modules/openai/helpers/zod-v3-strict-schema.js +408 -0
  255. package/node_modules/openai/helpers/zod-v3-strict-schema.mjs +404 -0
  256. package/node_modules/openai/helpers/zod.js +221 -24
  257. package/node_modules/openai/helpers/zod.mjs +222 -26
  258. package/node_modules/openai/index.js +8 -7
  259. package/node_modules/openai/index.mjs +2 -2
  260. package/node_modules/openai/internal/assistant-stream-delta.js +316 -0
  261. package/node_modules/openai/internal/assistant-stream-delta.mjs +308 -0
  262. package/node_modules/openai/internal/auth/x509-api-origin.js +28 -0
  263. package/node_modules/openai/internal/auth/x509-api-origin.mjs +24 -0
  264. package/node_modules/openai/internal/auth/x509-credential-options.js +125 -0
  265. package/node_modules/openai/internal/auth/x509-credential-options.mjs +121 -0
  266. package/node_modules/openai/internal/auth/x509-token-exchange.js +248 -0
  267. package/node_modules/openai/internal/auth/x509-token-exchange.mjs +245 -0
  268. package/node_modules/openai/internal/auth/x509-transport-capability.js +171 -0
  269. package/node_modules/openai/internal/auth/x509-transport-capability.mjs +166 -0
  270. package/node_modules/openai/internal/auth/x509-transport-registry.js +53 -0
  271. package/node_modules/openai/internal/auth/x509-transport-registry.mjs +48 -0
  272. package/node_modules/openai/internal/auth/x509-transport-state-browser.js +35 -0
  273. package/node_modules/openai/internal/auth/x509-transport-state-browser.mjs +32 -0
  274. package/node_modules/openai/internal/auth/x509-transport-state.cjs +35 -0
  275. package/node_modules/openai/internal/auth/x509-transport-state.js +36 -0
  276. package/node_modules/openai/internal/auth/x509-transport-state.mjs +20 -0
  277. package/node_modules/openai/internal/auth/x509-workload-identity-auth.js +787 -0
  278. package/node_modules/openai/internal/auth/x509-workload-identity-auth.mjs +778 -0
  279. package/node_modules/openai/internal/bedrock.js +438 -0
  280. package/node_modules/openai/internal/bedrock.mjs +424 -0
  281. package/node_modules/openai/internal/builtin-types.js +0 -1
  282. package/node_modules/openai/internal/builtin-types.mjs +0 -1
  283. package/node_modules/openai/internal/data-residency.js +34 -0
  284. package/node_modules/openai/internal/data-residency.mjs +30 -0
  285. package/node_modules/openai/internal/decoders/line.js +140 -54
  286. package/node_modules/openai/internal/decoders/line.mjs +141 -55
  287. package/node_modules/openai/internal/detect-platform.js +3 -4
  288. package/node_modules/openai/internal/detect-platform.mjs +3 -4
  289. package/node_modules/openai/internal/errors.js +3 -3
  290. package/node_modules/openai/internal/errors.mjs +3 -3
  291. package/node_modules/openai/internal/headers.js +11 -9
  292. package/node_modules/openai/internal/headers.mjs +11 -9
  293. package/node_modules/openai/internal/multipart-encoding.js +51 -0
  294. package/node_modules/openai/internal/multipart-encoding.mjs +48 -0
  295. package/node_modules/openai/internal/parse.js +35 -11
  296. package/node_modules/openai/internal/parse.mjs +35 -11
  297. package/node_modules/openai/internal/provider.js +50 -0
  298. package/node_modules/openai/internal/provider.mjs +46 -0
  299. package/node_modules/openai/internal/qs/formats.js +1 -2
  300. package/node_modules/openai/internal/qs/formats.mjs +1 -1
  301. package/node_modules/openai/internal/qs/stringify.js +60 -51
  302. package/node_modules/openai/internal/qs/stringify.mjs +60 -51
  303. package/node_modules/openai/internal/qs/utils.js +368 -50
  304. package/node_modules/openai/internal/qs/utils.mjs +368 -50
  305. package/node_modules/openai/internal/realtime-credentials.js +23 -0
  306. package/node_modules/openai/internal/realtime-credentials.mjs +19 -0
  307. package/node_modules/openai/internal/request-options.js +43 -2
  308. package/node_modules/openai/internal/request-options.mjs +42 -2
  309. package/node_modules/openai/internal/responses/canonical-output-text.js +123 -0
  310. package/node_modules/openai/internal/responses/canonical-output-text.mjs +115 -0
  311. package/node_modules/openai/internal/responses/output-text-index.js +77 -0
  312. package/node_modules/openai/internal/responses/output-text-index.mjs +73 -0
  313. package/node_modules/openai/internal/responses/response-accumulator.js +942 -0
  314. package/node_modules/openai/internal/responses/response-accumulator.mjs +938 -0
  315. package/node_modules/openai/internal/shim-types.js +6 -1
  316. package/node_modules/openai/internal/shim-types.mjs +6 -1
  317. package/node_modules/openai/internal/shims.js +6 -1
  318. package/node_modules/openai/internal/shims.mjs +6 -1
  319. package/node_modules/openai/internal/stream-utils.js +35 -7
  320. package/node_modules/openai/internal/stream-utils.mjs +35 -7
  321. package/node_modules/openai/internal/to-file.js +47 -24
  322. package/node_modules/openai/internal/to-file.mjs +47 -24
  323. package/node_modules/openai/internal/tslib.js +6 -0
  324. package/node_modules/openai/internal/tslib.mjs +6 -1
  325. package/node_modules/openai/internal/types.js +0 -1
  326. package/node_modules/openai/internal/types.mjs +0 -1
  327. package/node_modules/openai/internal/uploads.js +377 -43
  328. package/node_modules/openai/internal/uploads.mjs +376 -44
  329. package/node_modules/openai/internal/utils/abort.js +94 -0
  330. package/node_modules/openai/internal/utils/abort.mjs +90 -0
  331. package/node_modules/openai/internal/utils/base64.js +3 -1
  332. package/node_modules/openai/internal/utils/base64.mjs +3 -1
  333. package/node_modules/openai/internal/utils/bytes.js +5 -0
  334. package/node_modules/openai/internal/utils/bytes.mjs +5 -0
  335. package/node_modules/openai/internal/utils/env.js +9 -5
  336. package/node_modules/openai/internal/utils/env.mjs +9 -5
  337. package/node_modules/openai/internal/utils/log.js +73 -11
  338. package/node_modules/openai/internal/utils/log.mjs +70 -11
  339. package/node_modules/openai/internal/utils/path.js +50 -30
  340. package/node_modules/openai/internal/utils/path.mjs +50 -30
  341. package/node_modules/openai/internal/utils/query.js +0 -1
  342. package/node_modules/openai/internal/utils/query.mjs +0 -1
  343. package/node_modules/openai/internal/utils/sleep.js +51 -2
  344. package/node_modules/openai/internal/utils/sleep.mjs +51 -2
  345. package/node_modules/openai/internal/utils/uuid.js +0 -1
  346. package/node_modules/openai/internal/utils/uuid.mjs +0 -1
  347. package/node_modules/openai/internal/utils/values.js +0 -1
  348. package/node_modules/openai/internal/utils/values.mjs +0 -1
  349. package/node_modules/openai/internal/utils.js +0 -1
  350. package/node_modules/openai/internal/utils.mjs +0 -1
  351. package/node_modules/openai/internal/ws-adapter-browser.js +66 -21
  352. package/node_modules/openai/internal/ws-adapter-browser.mjs +66 -21
  353. package/node_modules/openai/internal/ws-adapter-node.js +90 -24
  354. package/node_modules/openai/internal/ws-adapter-node.mjs +90 -24
  355. package/node_modules/openai/internal/ws-adapter.js +4 -0
  356. package/node_modules/openai/internal/ws-adapter.mjs +4 -0
  357. package/node_modules/openai/internal/ws.js +193 -48
  358. package/node_modules/openai/internal/ws.mjs +188 -49
  359. package/node_modules/openai/lib/AbstractChatCompletionRunner.js +254 -72
  360. package/node_modules/openai/lib/AbstractChatCompletionRunner.mjs +256 -74
  361. package/node_modules/openai/lib/AssistantStream.js +430 -259
  362. package/node_modules/openai/lib/AssistantStream.mjs +432 -261
  363. package/node_modules/openai/lib/ChatCompletionRunner.js +12 -5
  364. package/node_modules/openai/lib/ChatCompletionRunner.mjs +13 -6
  365. package/node_modules/openai/lib/ChatCompletionStream.js +1430 -189
  366. package/node_modules/openai/lib/ChatCompletionStream.mjs +1433 -193
  367. package/node_modules/openai/lib/ChatCompletionStreamingRunner.js +40 -2
  368. package/node_modules/openai/lib/ChatCompletionStreamingRunner.mjs +41 -3
  369. package/node_modules/openai/lib/EventEmitter.js +124 -16
  370. package/node_modules/openai/lib/EventEmitter.mjs +125 -17
  371. package/node_modules/openai/lib/EventStream.js +1533 -55
  372. package/node_modules/openai/lib/EventStream.mjs +1534 -56
  373. package/node_modules/openai/lib/ResponsesParser.js +68 -29
  374. package/node_modules/openai/lib/ResponsesParser.mjs +69 -30
  375. package/node_modules/openai/lib/RunnableFunction.js +3 -0
  376. package/node_modules/openai/lib/RunnableFunction.mjs +3 -0
  377. package/node_modules/openai/lib/Util.js +7 -4
  378. package/node_modules/openai/lib/Util.mjs +7 -4
  379. package/node_modules/openai/lib/agents/agent-session-stream.js +274 -0
  380. package/node_modules/openai/lib/agents/agent-session-stream.mjs +270 -0
  381. package/node_modules/openai/lib/agents/output-text.js +8 -0
  382. package/node_modules/openai/lib/agents/output-text.mjs +5 -0
  383. package/node_modules/openai/lib/agents/turn-state.js +62 -0
  384. package/node_modules/openai/lib/agents/turn-state.mjs +58 -0
  385. package/node_modules/openai/lib/assistant-run-polling.js +17 -0
  386. package/node_modules/openai/lib/assistant-run-polling.mjs +14 -0
  387. package/node_modules/openai/lib/chatCompletionUtils.js +5 -6
  388. package/node_modules/openai/lib/chatCompletionUtils.mjs +5 -6
  389. package/node_modules/openai/lib/embeddings.js +58 -0
  390. package/node_modules/openai/lib/embeddings.mjs +55 -0
  391. package/node_modules/openai/lib/file-processing.js +31 -0
  392. package/node_modules/openai/lib/file-processing.mjs +28 -0
  393. package/node_modules/openai/lib/live/transcript-grouper.js +229 -0
  394. package/node_modules/openai/lib/live/transcript-grouper.mjs +225 -0
  395. package/node_modules/openai/lib/live/transcript-grouping.js +309 -0
  396. package/node_modules/openai/lib/live/transcript-grouping.mjs +305 -0
  397. package/node_modules/openai/lib/live/webrtc.js +16 -0
  398. package/node_modules/openai/lib/live/webrtc.mjs +10 -0
  399. package/node_modules/openai/lib/parser.js +142 -42
  400. package/node_modules/openai/lib/parser.mjs +140 -42
  401. package/node_modules/openai/lib/polling.js +131 -0
  402. package/node_modules/openai/lib/polling.mjs +128 -0
  403. package/node_modules/openai/lib/realtime/webrtc.js +16 -0
  404. package/node_modules/openai/lib/realtime/webrtc.mjs +10 -0
  405. package/node_modules/openai/lib/responses/ResponseAccumulator.js +15 -0
  406. package/node_modules/openai/lib/responses/ResponseAccumulator.mjs +12 -0
  407. package/node_modules/openai/lib/responses/ResponseInputItems.js +139 -0
  408. package/node_modules/openai/lib/responses/ResponseInputItems.mjs +135 -0
  409. package/node_modules/openai/lib/responses/ResponseStream.js +85 -159
  410. package/node_modules/openai/lib/responses/ResponseStream.mjs +86 -160
  411. package/node_modules/openai/lib/responses/responses-websocket-lane.js +314 -0
  412. package/node_modules/openai/lib/responses/responses-websocket-lane.mjs +309 -0
  413. package/node_modules/openai/lib/responses/responses-websocket-session.js +268 -0
  414. package/node_modules/openai/lib/responses/responses-websocket-session.mjs +263 -0
  415. package/node_modules/openai/lib/transform.js +1608 -82
  416. package/node_modules/openai/lib/transform.mjs +1602 -82
  417. package/node_modules/openai/lib/vector-store-polling.js +24 -0
  418. package/node_modules/openai/lib/vector-store-polling.mjs +20 -0
  419. package/node_modules/openai/lib/vector-store-upload.js +41 -0
  420. package/node_modules/openai/lib/vector-store-upload.mjs +38 -0
  421. package/node_modules/openai/lib/webhook-signature.js +125 -0
  422. package/node_modules/openai/lib/webhook-signature.mjs +121 -0
  423. package/node_modules/openai/lib/webrtc/connection.js +233 -0
  424. package/node_modules/openai/lib/webrtc/connection.mjs +229 -0
  425. package/node_modules/openai/lib/webrtc/data-channel.js +133 -0
  426. package/node_modules/openai/lib/webrtc/data-channel.mjs +129 -0
  427. package/node_modules/openai/lib/webrtc/errors.js +18 -0
  428. package/node_modules/openai/lib/webrtc/errors.mjs +14 -0
  429. package/node_modules/openai/lib/webrtc/subscriptions.js +64 -0
  430. package/node_modules/openai/lib/webrtc/subscriptions.mjs +60 -0
  431. package/node_modules/openai/lib/webrtc/types.js +3 -0
  432. package/node_modules/openai/lib/webrtc/types.mjs +2 -0
  433. package/node_modules/openai/live/webrtc.js +8 -0
  434. package/node_modules/openai/live/webrtc.mjs +2 -0
  435. package/node_modules/openai/package.json +71 -11
  436. package/node_modules/openai/providers/bedrock/aws.js +211 -0
  437. package/node_modules/openai/providers/bedrock/aws.mjs +207 -0
  438. package/node_modules/openai/providers/bedrock.js +43 -0
  439. package/node_modules/openai/providers/bedrock.mjs +39 -0
  440. package/node_modules/openai/realtime/internal-base.js +118 -11
  441. package/node_modules/openai/realtime/internal-base.mjs +116 -11
  442. package/node_modules/openai/realtime/webrtc.js +8 -0
  443. package/node_modules/openai/realtime/webrtc.mjs +2 -0
  444. package/node_modules/openai/realtime/websocket.js +174 -39
  445. package/node_modules/openai/realtime/websocket.mjs +175 -40
  446. package/node_modules/openai/realtime/ws.js +86 -18
  447. package/node_modules/openai/realtime/ws.mjs +87 -19
  448. package/node_modules/openai/resources/admin/admin.js +1 -1
  449. package/node_modules/openai/resources/admin/admin.mjs +1 -1
  450. package/node_modules/openai/resources/admin/index.js +1 -1
  451. package/node_modules/openai/resources/admin/index.mjs +1 -1
  452. package/node_modules/openai/resources/admin/organization/admin-api-keys.js +1 -1
  453. package/node_modules/openai/resources/admin/organization/admin-api-keys.mjs +1 -1
  454. package/node_modules/openai/resources/admin/organization/audit-logs.js +1 -1
  455. package/node_modules/openai/resources/admin/organization/audit-logs.mjs +1 -1
  456. package/node_modules/openai/resources/admin/organization/certificates.js +1 -1
  457. package/node_modules/openai/resources/admin/organization/certificates.mjs +1 -1
  458. package/node_modules/openai/resources/admin/organization/data-retention.js +1 -1
  459. package/node_modules/openai/resources/admin/organization/data-retention.mjs +1 -1
  460. package/node_modules/openai/resources/admin/organization/groups/groups.js +1 -1
  461. package/node_modules/openai/resources/admin/organization/groups/groups.mjs +1 -1
  462. package/node_modules/openai/resources/admin/organization/groups/index.js +1 -1
  463. package/node_modules/openai/resources/admin/organization/groups/index.mjs +1 -1
  464. package/node_modules/openai/resources/admin/organization/groups/roles.js +1 -1
  465. package/node_modules/openai/resources/admin/organization/groups/roles.mjs +1 -1
  466. package/node_modules/openai/resources/admin/organization/groups/users.js +1 -1
  467. package/node_modules/openai/resources/admin/organization/groups/users.mjs +1 -1
  468. package/node_modules/openai/resources/admin/organization/groups.js +1 -1
  469. package/node_modules/openai/resources/admin/organization/groups.mjs +1 -1
  470. package/node_modules/openai/resources/admin/organization/index.js +4 -2
  471. package/node_modules/openai/resources/admin/organization/index.mjs +2 -1
  472. package/node_modules/openai/resources/admin/organization/invites.js +1 -1
  473. package/node_modules/openai/resources/admin/organization/invites.mjs +1 -1
  474. package/node_modules/openai/resources/admin/organization/organization.js +5 -1
  475. package/node_modules/openai/resources/admin/organization/organization.mjs +5 -1
  476. package/node_modules/openai/resources/admin/organization/projects/api-keys.js +1 -1
  477. package/node_modules/openai/resources/admin/organization/projects/api-keys.mjs +1 -1
  478. package/node_modules/openai/resources/admin/organization/projects/certificates.js +1 -1
  479. package/node_modules/openai/resources/admin/organization/projects/certificates.mjs +1 -1
  480. package/node_modules/openai/resources/admin/organization/projects/data-retention.js +1 -1
  481. package/node_modules/openai/resources/admin/organization/projects/data-retention.mjs +1 -1
  482. package/node_modules/openai/resources/admin/organization/projects/groups/groups.js +1 -1
  483. package/node_modules/openai/resources/admin/organization/projects/groups/groups.mjs +1 -1
  484. package/node_modules/openai/resources/admin/organization/projects/groups/index.js +1 -1
  485. package/node_modules/openai/resources/admin/organization/projects/groups/index.mjs +1 -1
  486. package/node_modules/openai/resources/admin/organization/projects/groups/roles.js +1 -1
  487. package/node_modules/openai/resources/admin/organization/projects/groups/roles.mjs +1 -1
  488. package/node_modules/openai/resources/admin/organization/projects/groups.js +1 -1
  489. package/node_modules/openai/resources/admin/organization/projects/groups.mjs +1 -1
  490. package/node_modules/openai/resources/admin/organization/projects/hosted-tool-permissions.js +1 -1
  491. package/node_modules/openai/resources/admin/organization/projects/hosted-tool-permissions.mjs +1 -1
  492. package/node_modules/openai/resources/admin/organization/projects/index.js +8 -6
  493. package/node_modules/openai/resources/admin/organization/projects/index.mjs +3 -2
  494. package/node_modules/openai/resources/admin/organization/projects/model-permissions.js +1 -1
  495. package/node_modules/openai/resources/admin/organization/projects/model-permissions.mjs +1 -1
  496. package/node_modules/openai/resources/admin/organization/projects/projects.js +7 -3
  497. package/node_modules/openai/resources/admin/organization/projects/projects.mjs +7 -3
  498. package/node_modules/openai/resources/admin/organization/projects/rate-limits.js +1 -1
  499. package/node_modules/openai/resources/admin/organization/projects/rate-limits.mjs +1 -1
  500. package/node_modules/openai/resources/admin/organization/projects/roles.js +1 -1
  501. package/node_modules/openai/resources/admin/organization/projects/roles.mjs +1 -1
  502. package/node_modules/openai/resources/admin/organization/projects/service-accounts/api-keys.js +26 -0
  503. package/node_modules/openai/resources/admin/organization/projects/service-accounts/api-keys.mjs +22 -0
  504. package/node_modules/openai/resources/admin/organization/projects/service-accounts/index.js +9 -0
  505. package/node_modules/openai/resources/admin/organization/projects/service-accounts/index.mjs +4 -0
  506. package/node_modules/openai/resources/admin/organization/projects/service-accounts/service-accounts.js +109 -0
  507. package/node_modules/openai/resources/admin/organization/projects/service-accounts/service-accounts.mjs +104 -0
  508. package/node_modules/openai/resources/admin/organization/projects/service-accounts.js +3 -98
  509. package/node_modules/openai/resources/admin/organization/projects/service-accounts.mjs +2 -96
  510. package/node_modules/openai/resources/admin/organization/projects/spend-alerts.js +20 -1
  511. package/node_modules/openai/resources/admin/organization/projects/spend-alerts.mjs +20 -1
  512. package/node_modules/openai/resources/admin/organization/projects/spend-limit.js +67 -0
  513. package/node_modules/openai/resources/admin/organization/projects/spend-limit.mjs +63 -0
  514. package/node_modules/openai/resources/admin/organization/projects/users/index.js +1 -1
  515. package/node_modules/openai/resources/admin/organization/projects/users/index.mjs +1 -1
  516. package/node_modules/openai/resources/admin/organization/projects/users/roles.js +1 -1
  517. package/node_modules/openai/resources/admin/organization/projects/users/roles.mjs +1 -1
  518. package/node_modules/openai/resources/admin/organization/projects/users/users.js +1 -1
  519. package/node_modules/openai/resources/admin/organization/projects/users/users.mjs +1 -1
  520. package/node_modules/openai/resources/admin/organization/projects/users.js +1 -1
  521. package/node_modules/openai/resources/admin/organization/projects/users.mjs +1 -1
  522. package/node_modules/openai/resources/admin/organization/projects.js +1 -1
  523. package/node_modules/openai/resources/admin/organization/projects.mjs +1 -1
  524. package/node_modules/openai/resources/admin/organization/roles.js +1 -1
  525. package/node_modules/openai/resources/admin/organization/roles.mjs +1 -1
  526. package/node_modules/openai/resources/admin/organization/spend-alerts.js +18 -1
  527. package/node_modules/openai/resources/admin/organization/spend-alerts.mjs +18 -1
  528. package/node_modules/openai/resources/admin/organization/spend-limit.js +59 -0
  529. package/node_modules/openai/resources/admin/organization/spend-limit.mjs +55 -0
  530. package/node_modules/openai/resources/admin/organization/usage.js +1 -1
  531. package/node_modules/openai/resources/admin/organization/usage.mjs +1 -1
  532. package/node_modules/openai/resources/admin/organization/users/index.js +1 -1
  533. package/node_modules/openai/resources/admin/organization/users/index.mjs +1 -1
  534. package/node_modules/openai/resources/admin/organization/users/roles.js +1 -1
  535. package/node_modules/openai/resources/admin/organization/users/roles.mjs +1 -1
  536. package/node_modules/openai/resources/admin/organization/users/users.js +1 -1
  537. package/node_modules/openai/resources/admin/organization/users/users.mjs +1 -1
  538. package/node_modules/openai/resources/admin/organization/users.js +1 -1
  539. package/node_modules/openai/resources/admin/organization/users.mjs +1 -1
  540. package/node_modules/openai/resources/admin/organization.js +1 -1
  541. package/node_modules/openai/resources/admin/organization.mjs +1 -1
  542. package/node_modules/openai/resources/admin.js +1 -1
  543. package/node_modules/openai/resources/admin.mjs +1 -1
  544. package/node_modules/openai/resources/audio/audio.js +1 -1
  545. package/node_modules/openai/resources/audio/audio.mjs +1 -1
  546. package/node_modules/openai/resources/audio/index.js +1 -1
  547. package/node_modules/openai/resources/audio/index.mjs +1 -1
  548. package/node_modules/openai/resources/audio/speech.js +1 -1
  549. package/node_modules/openai/resources/audio/speech.mjs +1 -1
  550. package/node_modules/openai/resources/audio/transcriptions.js +1 -1
  551. package/node_modules/openai/resources/audio/transcriptions.mjs +1 -1
  552. package/node_modules/openai/resources/audio/translations.js +1 -1
  553. package/node_modules/openai/resources/audio/translations.mjs +1 -1
  554. package/node_modules/openai/resources/audio.js +1 -1
  555. package/node_modules/openai/resources/audio.mjs +1 -1
  556. package/node_modules/openai/resources/batches.js +1 -1
  557. package/node_modules/openai/resources/batches.mjs +1 -1
  558. package/node_modules/openai/resources/beta/agents/agents.js +118 -0
  559. package/node_modules/openai/resources/beta/agents/agents.mjs +113 -0
  560. package/node_modules/openai/resources/beta/agents/environments/environments.js +43 -0
  561. package/node_modules/openai/resources/beta/agents/environments/environments.mjs +38 -0
  562. package/node_modules/openai/resources/beta/agents/environments/files.js +61 -0
  563. package/node_modules/openai/resources/beta/agents/environments/files.mjs +57 -0
  564. package/node_modules/openai/resources/beta/agents/environments/index.js +11 -0
  565. package/node_modules/openai/resources/beta/agents/environments/index.mjs +5 -0
  566. package/node_modules/openai/resources/beta/agents/environments/templates.js +112 -0
  567. package/node_modules/openai/resources/beta/agents/environments/templates.mjs +108 -0
  568. package/node_modules/openai/resources/beta/agents/environments.js +6 -0
  569. package/node_modules/openai/resources/beta/agents/environments.mjs +3 -0
  570. package/node_modules/openai/resources/beta/agents/index.js +13 -0
  571. package/node_modules/openai/resources/beta/agents/index.mjs +6 -0
  572. package/node_modules/openai/resources/beta/agents/sessions/artifacts.js +106 -0
  573. package/node_modules/openai/resources/beta/agents/sessions/artifacts.mjs +102 -0
  574. package/node_modules/openai/resources/beta/agents/sessions/events.js +75 -0
  575. package/node_modules/openai/resources/beta/agents/sessions/events.mjs +71 -0
  576. package/node_modules/openai/resources/beta/agents/sessions/index.js +17 -0
  577. package/node_modules/openai/resources/beta/agents/sessions/index.mjs +8 -0
  578. package/node_modules/openai/resources/beta/agents/sessions/items.js +35 -0
  579. package/node_modules/openai/resources/beta/agents/sessions/items.mjs +31 -0
  580. package/node_modules/openai/resources/beta/agents/sessions/sessions.js +127 -0
  581. package/node_modules/openai/resources/beta/agents/sessions/sessions.mjs +122 -0
  582. package/node_modules/openai/resources/beta/agents/sessions/subagents/index.js +11 -0
  583. package/node_modules/openai/resources/beta/agents/sessions/subagents/index.mjs +5 -0
  584. package/node_modules/openai/resources/beta/agents/sessions/subagents/items.js +36 -0
  585. package/node_modules/openai/resources/beta/agents/sessions/subagents/items.mjs +32 -0
  586. package/node_modules/openai/resources/beta/agents/sessions/subagents/subagents.js +67 -0
  587. package/node_modules/openai/resources/beta/agents/sessions/subagents/subagents.mjs +62 -0
  588. package/node_modules/openai/resources/beta/agents/sessions/subagents/turns/index.js +9 -0
  589. package/node_modules/openai/resources/beta/agents/sessions/subagents/turns/index.mjs +4 -0
  590. package/node_modules/openai/resources/beta/agents/sessions/subagents/turns/items.js +36 -0
  591. package/node_modules/openai/resources/beta/agents/sessions/subagents/turns/items.mjs +32 -0
  592. package/node_modules/openai/resources/beta/agents/sessions/subagents/turns/turns.js +68 -0
  593. package/node_modules/openai/resources/beta/agents/sessions/subagents/turns/turns.mjs +63 -0
  594. package/node_modules/openai/resources/beta/agents/sessions/subagents/turns.js +6 -0
  595. package/node_modules/openai/resources/beta/agents/sessions/subagents/turns.mjs +3 -0
  596. package/node_modules/openai/resources/beta/agents/sessions/subagents.js +6 -0
  597. package/node_modules/openai/resources/beta/agents/sessions/subagents.mjs +3 -0
  598. package/node_modules/openai/resources/beta/agents/sessions/turns.js +57 -0
  599. package/node_modules/openai/resources/beta/agents/sessions/turns.mjs +53 -0
  600. package/node_modules/openai/resources/beta/agents/sessions.js +6 -0
  601. package/node_modules/openai/resources/beta/agents/sessions.mjs +3 -0
  602. package/node_modules/openai/resources/beta/agents/vaults/credentials.js +132 -0
  603. package/node_modules/openai/resources/beta/agents/vaults/credentials.mjs +128 -0
  604. package/node_modules/openai/resources/beta/agents/vaults/index.js +9 -0
  605. package/node_modules/openai/resources/beta/agents/vaults/index.mjs +4 -0
  606. package/node_modules/openai/resources/beta/agents/vaults/vaults.js +93 -0
  607. package/node_modules/openai/resources/beta/agents/vaults/vaults.mjs +88 -0
  608. package/node_modules/openai/resources/beta/agents/vaults.js +6 -0
  609. package/node_modules/openai/resources/beta/agents/vaults.mjs +3 -0
  610. package/node_modules/openai/resources/beta/agents.js +6 -0
  611. package/node_modules/openai/resources/beta/agents.mjs +3 -0
  612. package/node_modules/openai/resources/beta/assistants.js +1 -1
  613. package/node_modules/openai/resources/beta/assistants.mjs +1 -1
  614. package/node_modules/openai/resources/beta/beta.js +9 -1
  615. package/node_modules/openai/resources/beta/beta.mjs +9 -1
  616. package/node_modules/openai/resources/beta/chatkit/chatkit.js +1 -1
  617. package/node_modules/openai/resources/beta/chatkit/chatkit.mjs +1 -1
  618. package/node_modules/openai/resources/beta/chatkit/index.js +1 -1
  619. package/node_modules/openai/resources/beta/chatkit/index.mjs +1 -1
  620. package/node_modules/openai/resources/beta/chatkit/sessions.js +1 -1
  621. package/node_modules/openai/resources/beta/chatkit/sessions.mjs +1 -1
  622. package/node_modules/openai/resources/beta/chatkit/threads.js +1 -1
  623. package/node_modules/openai/resources/beta/chatkit/threads.mjs +1 -1
  624. package/node_modules/openai/resources/beta/chatkit.js +1 -1
  625. package/node_modules/openai/resources/beta/chatkit.mjs +1 -1
  626. package/node_modules/openai/resources/beta/index.js +12 -8
  627. package/node_modules/openai/resources/beta/index.mjs +3 -1
  628. package/node_modules/openai/resources/beta/realtime/index.js +0 -1
  629. package/node_modules/openai/resources/beta/realtime/index.mjs +0 -1
  630. package/node_modules/openai/resources/beta/realtime/realtime.js +0 -1
  631. package/node_modules/openai/resources/beta/realtime/realtime.mjs +0 -1
  632. package/node_modules/openai/resources/beta/realtime/sessions.js +0 -1
  633. package/node_modules/openai/resources/beta/realtime/sessions.mjs +0 -1
  634. package/node_modules/openai/resources/beta/realtime/transcription-sessions.js +0 -1
  635. package/node_modules/openai/resources/beta/realtime/transcription-sessions.mjs +0 -1
  636. package/node_modules/openai/resources/beta/realtime.js +0 -1
  637. package/node_modules/openai/resources/beta/realtime.mjs +0 -1
  638. package/node_modules/openai/resources/beta/responses/index.js +11 -0
  639. package/node_modules/openai/resources/beta/responses/index.mjs +5 -0
  640. package/node_modules/openai/resources/beta/responses/input-items.js +37 -0
  641. package/node_modules/openai/resources/beta/responses/input-items.mjs +33 -0
  642. package/node_modules/openai/resources/beta/responses/input-tokens.js +34 -0
  643. package/node_modules/openai/resources/beta/responses/input-tokens.mjs +30 -0
  644. package/node_modules/openai/resources/beta/responses/internal-base.js +66 -0
  645. package/node_modules/openai/resources/beta/responses/internal-base.mjs +60 -0
  646. package/node_modules/openai/resources/beta/responses/responses.js +121 -0
  647. package/node_modules/openai/resources/beta/responses/responses.mjs +116 -0
  648. package/node_modules/openai/resources/beta/responses/ws-base.js +566 -0
  649. package/node_modules/openai/resources/beta/responses/ws-base.mjs +560 -0
  650. package/node_modules/openai/resources/beta/responses/ws.js +47 -0
  651. package/node_modules/openai/resources/beta/responses/ws.mjs +42 -0
  652. package/node_modules/openai/resources/beta/responses.js +6 -0
  653. package/node_modules/openai/resources/beta/responses.mjs +3 -0
  654. package/node_modules/openai/resources/beta/threads/index.js +1 -1
  655. package/node_modules/openai/resources/beta/threads/index.mjs +1 -1
  656. package/node_modules/openai/resources/beta/threads/messages.js +1 -1
  657. package/node_modules/openai/resources/beta/threads/messages.mjs +1 -1
  658. package/node_modules/openai/resources/beta/threads/runs/index.js +1 -1
  659. package/node_modules/openai/resources/beta/threads/runs/index.mjs +1 -1
  660. package/node_modules/openai/resources/beta/threads/runs/runs.js +3 -44
  661. package/node_modules/openai/resources/beta/threads/runs/runs.mjs +3 -44
  662. package/node_modules/openai/resources/beta/threads/runs/steps.js +1 -1
  663. package/node_modules/openai/resources/beta/threads/runs/steps.mjs +1 -1
  664. package/node_modules/openai/resources/beta/threads/runs.js +1 -1
  665. package/node_modules/openai/resources/beta/threads/runs.mjs +1 -1
  666. package/node_modules/openai/resources/beta/threads/threads.js +1 -1
  667. package/node_modules/openai/resources/beta/threads/threads.mjs +1 -1
  668. package/node_modules/openai/resources/beta/threads.js +1 -1
  669. package/node_modules/openai/resources/beta/threads.mjs +1 -1
  670. package/node_modules/openai/resources/beta.js +1 -1
  671. package/node_modules/openai/resources/beta.mjs +1 -1
  672. package/node_modules/openai/resources/chat/chat.js +1 -1
  673. package/node_modules/openai/resources/chat/chat.mjs +1 -1
  674. package/node_modules/openai/resources/chat/completions/completions.js +2 -5
  675. package/node_modules/openai/resources/chat/completions/completions.mjs +2 -5
  676. package/node_modules/openai/resources/chat/completions/index.js +1 -1
  677. package/node_modules/openai/resources/chat/completions/index.mjs +1 -1
  678. package/node_modules/openai/resources/chat/completions/messages.js +1 -1
  679. package/node_modules/openai/resources/chat/completions/messages.mjs +1 -1
  680. package/node_modules/openai/resources/chat/completions.js +1 -1
  681. package/node_modules/openai/resources/chat/completions.mjs +1 -1
  682. package/node_modules/openai/resources/chat/index.js +1 -1
  683. package/node_modules/openai/resources/chat/index.mjs +1 -1
  684. package/node_modules/openai/resources/chat.js +1 -1
  685. package/node_modules/openai/resources/chat.mjs +1 -1
  686. package/node_modules/openai/resources/completions.js +1 -1
  687. package/node_modules/openai/resources/completions.mjs +1 -1
  688. package/node_modules/openai/resources/containers/containers.js +1 -1
  689. package/node_modules/openai/resources/containers/containers.mjs +1 -1
  690. package/node_modules/openai/resources/containers/files/content.js +1 -1
  691. package/node_modules/openai/resources/containers/files/content.mjs +1 -1
  692. package/node_modules/openai/resources/containers/files/files.js +1 -1
  693. package/node_modules/openai/resources/containers/files/files.mjs +1 -1
  694. package/node_modules/openai/resources/containers/files/index.js +1 -1
  695. package/node_modules/openai/resources/containers/files/index.mjs +1 -1
  696. package/node_modules/openai/resources/containers/files.js +1 -1
  697. package/node_modules/openai/resources/containers/files.mjs +1 -1
  698. package/node_modules/openai/resources/containers/index.js +1 -1
  699. package/node_modules/openai/resources/containers/index.mjs +1 -1
  700. package/node_modules/openai/resources/containers.js +1 -1
  701. package/node_modules/openai/resources/containers.mjs +1 -1
  702. package/node_modules/openai/resources/content-provenance-checks.js +24 -0
  703. package/node_modules/openai/resources/content-provenance-checks.mjs +20 -0
  704. package/node_modules/openai/resources/conversations/conversations.js +1 -1
  705. package/node_modules/openai/resources/conversations/conversations.mjs +1 -1
  706. package/node_modules/openai/resources/conversations/index.js +1 -1
  707. package/node_modules/openai/resources/conversations/index.mjs +1 -1
  708. package/node_modules/openai/resources/conversations/items.js +1 -1
  709. package/node_modules/openai/resources/conversations/items.mjs +1 -1
  710. package/node_modules/openai/resources/conversations.js +1 -1
  711. package/node_modules/openai/resources/conversations.mjs +1 -1
  712. package/node_modules/openai/resources/embeddings.js +3 -47
  713. package/node_modules/openai/resources/embeddings.mjs +3 -47
  714. package/node_modules/openai/resources/evals/evals.js +2 -2
  715. package/node_modules/openai/resources/evals/evals.mjs +2 -2
  716. package/node_modules/openai/resources/evals/index.js +1 -1
  717. package/node_modules/openai/resources/evals/index.mjs +1 -1
  718. package/node_modules/openai/resources/evals/runs/index.js +1 -1
  719. package/node_modules/openai/resources/evals/runs/index.mjs +1 -1
  720. package/node_modules/openai/resources/evals/runs/output-items.js +1 -1
  721. package/node_modules/openai/resources/evals/runs/output-items.mjs +1 -1
  722. package/node_modules/openai/resources/evals/runs/runs.js +1 -1
  723. package/node_modules/openai/resources/evals/runs/runs.mjs +1 -1
  724. package/node_modules/openai/resources/evals/runs.js +1 -1
  725. package/node_modules/openai/resources/evals/runs.mjs +1 -1
  726. package/node_modules/openai/resources/evals.js +1 -1
  727. package/node_modules/openai/resources/evals.mjs +1 -1
  728. package/node_modules/openai/resources/files.js +9 -22
  729. package/node_modules/openai/resources/files.mjs +9 -22
  730. package/node_modules/openai/resources/fine-tuning/alpha/alpha.js +1 -1
  731. package/node_modules/openai/resources/fine-tuning/alpha/alpha.mjs +1 -1
  732. package/node_modules/openai/resources/fine-tuning/alpha/graders.js +1 -1
  733. package/node_modules/openai/resources/fine-tuning/alpha/graders.mjs +1 -1
  734. package/node_modules/openai/resources/fine-tuning/alpha/index.js +1 -1
  735. package/node_modules/openai/resources/fine-tuning/alpha/index.mjs +1 -1
  736. package/node_modules/openai/resources/fine-tuning/alpha.js +1 -1
  737. package/node_modules/openai/resources/fine-tuning/alpha.mjs +1 -1
  738. package/node_modules/openai/resources/fine-tuning/checkpoints/checkpoints.js +1 -1
  739. package/node_modules/openai/resources/fine-tuning/checkpoints/checkpoints.mjs +1 -1
  740. package/node_modules/openai/resources/fine-tuning/checkpoints/index.js +1 -1
  741. package/node_modules/openai/resources/fine-tuning/checkpoints/index.mjs +1 -1
  742. package/node_modules/openai/resources/fine-tuning/checkpoints/permissions.js +9 -5
  743. package/node_modules/openai/resources/fine-tuning/checkpoints/permissions.mjs +9 -5
  744. package/node_modules/openai/resources/fine-tuning/checkpoints.js +1 -1
  745. package/node_modules/openai/resources/fine-tuning/checkpoints.mjs +1 -1
  746. package/node_modules/openai/resources/fine-tuning/fine-tuning.js +1 -1
  747. package/node_modules/openai/resources/fine-tuning/fine-tuning.mjs +1 -1
  748. package/node_modules/openai/resources/fine-tuning/index.js +1 -1
  749. package/node_modules/openai/resources/fine-tuning/index.mjs +1 -1
  750. package/node_modules/openai/resources/fine-tuning/jobs/checkpoints.js +1 -1
  751. package/node_modules/openai/resources/fine-tuning/jobs/checkpoints.mjs +1 -1
  752. package/node_modules/openai/resources/fine-tuning/jobs/index.js +1 -1
  753. package/node_modules/openai/resources/fine-tuning/jobs/index.mjs +1 -1
  754. package/node_modules/openai/resources/fine-tuning/jobs/jobs.js +3 -3
  755. package/node_modules/openai/resources/fine-tuning/jobs/jobs.mjs +3 -3
  756. package/node_modules/openai/resources/fine-tuning/jobs.js +1 -1
  757. package/node_modules/openai/resources/fine-tuning/jobs.mjs +1 -1
  758. package/node_modules/openai/resources/fine-tuning/methods.js +1 -1
  759. package/node_modules/openai/resources/fine-tuning/methods.mjs +1 -1
  760. package/node_modules/openai/resources/fine-tuning.js +1 -1
  761. package/node_modules/openai/resources/fine-tuning.mjs +1 -1
  762. package/node_modules/openai/resources/graders/grader-models.js +1 -1
  763. package/node_modules/openai/resources/graders/grader-models.mjs +1 -1
  764. package/node_modules/openai/resources/graders/graders.js +1 -1
  765. package/node_modules/openai/resources/graders/graders.mjs +1 -1
  766. package/node_modules/openai/resources/graders/index.js +1 -1
  767. package/node_modules/openai/resources/graders/index.mjs +1 -1
  768. package/node_modules/openai/resources/graders.js +1 -1
  769. package/node_modules/openai/resources/graders.mjs +1 -1
  770. package/node_modules/openai/resources/images.js +8 -2
  771. package/node_modules/openai/resources/images.mjs +8 -2
  772. package/node_modules/openai/resources/index.js +9 -3
  773. package/node_modules/openai/resources/index.mjs +5 -2
  774. package/node_modules/openai/resources/live/forks/forks.js +9 -0
  775. package/node_modules/openai/resources/live/forks/forks.mjs +5 -0
  776. package/node_modules/openai/resources/live/forks/index.js +7 -0
  777. package/node_modules/openai/resources/live/forks/index.mjs +3 -0
  778. package/node_modules/openai/resources/live/forks/internal-base.js +65 -0
  779. package/node_modules/openai/resources/live/forks/internal-base.mjs +59 -0
  780. package/node_modules/openai/resources/live/forks/ws-base.js +547 -0
  781. package/node_modules/openai/resources/live/forks/ws-base.mjs +543 -0
  782. package/node_modules/openai/resources/live/forks/ws.js +32 -0
  783. package/node_modules/openai/resources/live/forks/ws.mjs +27 -0
  784. package/node_modules/openai/resources/live/forks.js +6 -0
  785. package/node_modules/openai/resources/live/forks.mjs +3 -0
  786. package/node_modules/openai/resources/live/index.js +13 -0
  787. package/node_modules/openai/resources/live/index.mjs +6 -0
  788. package/node_modules/openai/resources/live/internal-base.js +64 -0
  789. package/node_modules/openai/resources/live/internal-base.mjs +58 -0
  790. package/node_modules/openai/resources/live/live.js +40 -0
  791. package/node_modules/openai/resources/live/live.mjs +35 -0
  792. package/node_modules/openai/resources/live/sessions.js +124 -0
  793. package/node_modules/openai/resources/live/sessions.mjs +120 -0
  794. package/node_modules/openai/resources/live/sideband/index.js +7 -0
  795. package/node_modules/openai/resources/live/sideband/index.mjs +3 -0
  796. package/node_modules/openai/resources/live/sideband/internal-base.js +65 -0
  797. package/node_modules/openai/resources/live/sideband/internal-base.mjs +59 -0
  798. package/node_modules/openai/resources/live/sideband/sideband.js +9 -0
  799. package/node_modules/openai/resources/live/sideband/sideband.mjs +5 -0
  800. package/node_modules/openai/resources/live/sideband/ws-base.js +547 -0
  801. package/node_modules/openai/resources/live/sideband/ws-base.mjs +543 -0
  802. package/node_modules/openai/resources/live/sideband/ws.js +32 -0
  803. package/node_modules/openai/resources/live/sideband/ws.mjs +27 -0
  804. package/node_modules/openai/resources/live/sideband.js +6 -0
  805. package/node_modules/openai/resources/live/sideband.mjs +3 -0
  806. package/node_modules/openai/resources/live/ws-base.js +547 -0
  807. package/node_modules/openai/resources/live/ws-base.mjs +543 -0
  808. package/node_modules/openai/resources/live/ws.js +32 -0
  809. package/node_modules/openai/resources/live/ws.mjs +27 -0
  810. package/node_modules/openai/resources/live.js +6 -0
  811. package/node_modules/openai/resources/live.mjs +3 -0
  812. package/node_modules/openai/resources/models.js +1 -1
  813. package/node_modules/openai/resources/models.mjs +1 -1
  814. package/node_modules/openai/resources/moderations.js +3 -2
  815. package/node_modules/openai/resources/moderations.mjs +3 -2
  816. package/node_modules/openai/resources/realtime/calls.js +25 -1
  817. package/node_modules/openai/resources/realtime/calls.mjs +25 -1
  818. package/node_modules/openai/resources/realtime/client-secrets.js +2 -2
  819. package/node_modules/openai/resources/realtime/client-secrets.mjs +2 -2
  820. package/node_modules/openai/resources/realtime/index.js +1 -1
  821. package/node_modules/openai/resources/realtime/index.mjs +2 -2
  822. package/node_modules/openai/resources/realtime/realtime.js +1 -1
  823. package/node_modules/openai/resources/realtime/realtime.mjs +1 -1
  824. package/node_modules/openai/resources/realtime.js +1 -1
  825. package/node_modules/openai/resources/realtime.mjs +1 -1
  826. package/node_modules/openai/resources/responses/index.js +1 -1
  827. package/node_modules/openai/resources/responses/index.mjs +1 -1
  828. package/node_modules/openai/resources/responses/input-items.js +1 -1
  829. package/node_modules/openai/resources/responses/input-items.mjs +1 -1
  830. package/node_modules/openai/resources/responses/input-tokens.js +1 -1
  831. package/node_modules/openai/resources/responses/input-tokens.mjs +1 -1
  832. package/node_modules/openai/resources/responses/internal-base.js +24 -6
  833. package/node_modules/openai/resources/responses/internal-base.mjs +24 -6
  834. package/node_modules/openai/resources/responses/responses.js +5 -5
  835. package/node_modules/openai/resources/responses/responses.mjs +5 -5
  836. package/node_modules/openai/resources/responses/ws-base.js +115 -23
  837. package/node_modules/openai/resources/responses/ws-base.mjs +115 -25
  838. package/node_modules/openai/resources/responses/ws.js +23 -7
  839. package/node_modules/openai/resources/responses/ws.mjs +23 -7
  840. package/node_modules/openai/resources/responses.js +1 -1
  841. package/node_modules/openai/resources/responses.mjs +1 -1
  842. package/node_modules/openai/resources/safety/alerts.js +16 -0
  843. package/node_modules/openai/resources/safety/alerts.mjs +12 -0
  844. package/node_modules/openai/resources/safety/index.js +9 -0
  845. package/node_modules/openai/resources/safety/index.mjs +4 -0
  846. package/node_modules/openai/resources/safety/safety.js +17 -0
  847. package/node_modules/openai/resources/safety/safety.mjs +12 -0
  848. package/node_modules/openai/resources/safety.js +6 -0
  849. package/node_modules/openai/resources/safety.mjs +3 -0
  850. package/node_modules/openai/resources/shared.js +1 -1
  851. package/node_modules/openai/resources/shared.mjs +1 -1
  852. package/node_modules/openai/resources/skills/content.js +1 -1
  853. package/node_modules/openai/resources/skills/content.mjs +1 -1
  854. package/node_modules/openai/resources/skills/index.js +1 -1
  855. package/node_modules/openai/resources/skills/index.mjs +1 -1
  856. package/node_modules/openai/resources/skills/skills.js +4 -2
  857. package/node_modules/openai/resources/skills/skills.mjs +4 -2
  858. package/node_modules/openai/resources/skills/versions/content.js +1 -1
  859. package/node_modules/openai/resources/skills/versions/content.mjs +1 -1
  860. package/node_modules/openai/resources/skills/versions/index.js +1 -1
  861. package/node_modules/openai/resources/skills/versions/index.mjs +1 -1
  862. package/node_modules/openai/resources/skills/versions/versions.js +4 -2
  863. package/node_modules/openai/resources/skills/versions/versions.mjs +4 -2
  864. package/node_modules/openai/resources/skills/versions.js +1 -1
  865. package/node_modules/openai/resources/skills/versions.mjs +1 -1
  866. package/node_modules/openai/resources/skills.js +1 -1
  867. package/node_modules/openai/resources/skills.mjs +1 -1
  868. package/node_modules/openai/resources/uploads/index.js +1 -1
  869. package/node_modules/openai/resources/uploads/index.mjs +1 -1
  870. package/node_modules/openai/resources/uploads/parts.js +6 -5
  871. package/node_modules/openai/resources/uploads/parts.mjs +6 -5
  872. package/node_modules/openai/resources/uploads/uploads.js +10 -10
  873. package/node_modules/openai/resources/uploads/uploads.mjs +10 -10
  874. package/node_modules/openai/resources/uploads.js +1 -1
  875. package/node_modules/openai/resources/uploads.mjs +1 -1
  876. package/node_modules/openai/resources/vector-stores/file-batches.js +6 -63
  877. package/node_modules/openai/resources/vector-stores/file-batches.mjs +6 -63
  878. package/node_modules/openai/resources/vector-stores/files.js +6 -39
  879. package/node_modules/openai/resources/vector-stores/files.mjs +6 -39
  880. package/node_modules/openai/resources/vector-stores/index.js +1 -1
  881. package/node_modules/openai/resources/vector-stores/index.mjs +1 -1
  882. package/node_modules/openai/resources/vector-stores/vector-stores.js +1 -1
  883. package/node_modules/openai/resources/vector-stores/vector-stores.mjs +1 -1
  884. package/node_modules/openai/resources/vector-stores.js +1 -1
  885. package/node_modules/openai/resources/vector-stores.mjs +1 -1
  886. package/node_modules/openai/resources/videos.js +24 -1
  887. package/node_modules/openai/resources/videos.mjs +24 -1
  888. package/node_modules/openai/resources/webhooks/event-types.js +21 -0
  889. package/node_modules/openai/resources/webhooks/event-types.mjs +17 -0
  890. package/node_modules/openai/resources/webhooks/index.js +4 -1
  891. package/node_modules/openai/resources/webhooks/index.mjs +2 -1
  892. package/node_modules/openai/resources/webhooks/webhooks.js +127 -43
  893. package/node_modules/openai/resources/webhooks/webhooks.mjs +127 -43
  894. package/node_modules/openai/resources/webhooks.js +1 -1
  895. package/node_modules/openai/resources/webhooks.mjs +1 -1
  896. package/node_modules/openai/src/_vendor/partial-json-parser/LICENSE +21 -0
  897. package/node_modules/openai/src/_vendor/partial-json-parser/README.md +11 -1
  898. package/node_modules/openai/src/_vendor/partial-json-parser/parser.ts +66 -35
  899. package/node_modules/openai/src/_vendor/zod-to-json-schema/Options.ts +32 -18
  900. package/node_modules/openai/src/_vendor/zod-to-json-schema/Refs.ts +7 -6
  901. package/node_modules/openai/src/_vendor/zod-to-json-schema/errorMessages.ts +5 -3
  902. package/node_modules/openai/src/_vendor/zod-to-json-schema/index.ts +3 -1
  903. package/node_modules/openai/src/_vendor/zod-to-json-schema/parseDef.ts +194 -79
  904. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/array.ts +8 -5
  905. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/bigint.ts +20 -12
  906. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/branded.ts +4 -4
  907. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/catch.ts +4 -5
  908. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/date.ts +16 -10
  909. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/default.ts +10 -5
  910. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/effects.ts +4 -3
  911. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/enum.ts +1 -1
  912. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/intersection.ts +12 -9
  913. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/literal.ts +12 -2
  914. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/map.ts +6 -4
  915. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/nativeEnum.ts +10 -11
  916. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/null.ts +4 -3
  917. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/nullable.ts +25 -10
  918. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/number.ts +17 -8
  919. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/object.ts +57 -54
  920. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/optional.ts +25 -17
  921. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/pipeline.ts +8 -6
  922. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/promise.ts +10 -5
  923. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/readonly.ts +4 -5
  924. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/record.ts +22 -19
  925. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/set.ts +6 -4
  926. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/string.ts +62 -37
  927. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/tuple.ts +32 -25
  928. package/node_modules/openai/src/_vendor/zod-to-json-schema/parsers/union.ts +51 -33
  929. package/node_modules/openai/src/_vendor/zod-to-json-schema/util.ts +11 -6
  930. package/node_modules/openai/src/_vendor/zod-to-json-schema/zodToJsonSchema.ts +133 -52
  931. package/node_modules/openai/src/auth/index.ts +7 -1
  932. package/node_modules/openai/src/auth/subject-token-providers.ts +281 -16
  933. package/node_modules/openai/src/auth/types.ts +48 -5
  934. package/node_modules/openai/src/auth/workload-identity-auth.ts +227 -26
  935. package/node_modules/openai/src/auth/x509-transport.ts +369 -0
  936. package/node_modules/openai/src/azure.ts +127 -28
  937. package/node_modules/openai/src/bedrock.ts +294 -0
  938. package/node_modules/openai/src/beta/realtime/internal-base.ts +136 -16
  939. package/node_modules/openai/src/beta/realtime/websocket.ts +264 -48
  940. package/node_modules/openai/src/beta/realtime/ws.ts +138 -25
  941. package/node_modules/openai/src/client.ts +975 -124
  942. package/node_modules/openai/src/core/EventEmitter.ts +162 -26
  943. package/node_modules/openai/src/core/api-promise.ts +0 -2
  944. package/node_modules/openai/src/core/error.ts +6 -8
  945. package/node_modules/openai/src/core/pagination.ts +67 -7
  946. package/node_modules/openai/src/core/resource.ts +0 -2
  947. package/node_modules/openai/src/core/streaming.ts +490 -100
  948. package/node_modules/openai/src/core/uploads.ts +6 -1
  949. package/node_modules/openai/src/helpers/audio.ts +215 -32
  950. package/node_modules/openai/src/helpers/live.ts +8 -0
  951. package/node_modules/openai/src/helpers/standard-schema.ts +819 -0
  952. package/node_modules/openai/src/helpers/zod-v3-strict-schema.ts +520 -0
  953. package/node_modules/openai/src/helpers/zod.ts +418 -56
  954. package/node_modules/openai/src/index.ts +4 -5
  955. package/node_modules/openai/src/internal/assistant-stream-delta.ts +440 -0
  956. package/node_modules/openai/src/internal/auth/x509-api-origin.ts +27 -0
  957. package/node_modules/openai/src/internal/auth/x509-credential-options.ts +149 -0
  958. package/node_modules/openai/src/internal/auth/x509-token-exchange.ts +319 -0
  959. package/node_modules/openai/src/internal/auth/x509-transport-capability.ts +227 -0
  960. package/node_modules/openai/src/internal/auth/x509-transport-registry.ts +127 -0
  961. package/node_modules/openai/src/internal/auth/x509-transport-state-browser.ts +43 -0
  962. package/node_modules/openai/src/internal/auth/x509-transport-state.cts +43 -0
  963. package/node_modules/openai/src/internal/auth/x509-workload-identity-auth.ts +972 -0
  964. package/node_modules/openai/src/internal/bedrock.ts +586 -0
  965. package/node_modules/openai/src/internal/builtin-types.ts +0 -2
  966. package/node_modules/openai/src/internal/data-residency.ts +44 -0
  967. package/node_modules/openai/src/internal/decoders/line.ts +145 -61
  968. package/node_modules/openai/src/internal/detect-platform.ts +3 -5
  969. package/node_modules/openai/src/internal/errors.ts +3 -4
  970. package/node_modules/openai/src/internal/headers.ts +14 -10
  971. package/node_modules/openai/src/internal/multipart-encoding.ts +53 -0
  972. package/node_modules/openai/src/internal/parse.ts +47 -19
  973. package/node_modules/openai/src/internal/provider.ts +92 -0
  974. package/node_modules/openai/src/internal/qs/formats.ts +1 -1
  975. package/node_modules/openai/src/internal/qs/stringify.ts +57 -53
  976. package/node_modules/openai/src/internal/qs/types.ts +1 -1
  977. package/node_modules/openai/src/internal/qs/utils.ts +443 -54
  978. package/node_modules/openai/src/internal/realtime-credentials.ts +27 -0
  979. package/node_modules/openai/src/internal/request-options.ts +52 -3
  980. package/node_modules/openai/src/internal/responses/canonical-output-text.ts +160 -0
  981. package/node_modules/openai/src/internal/responses/output-text-index.ts +84 -0
  982. package/node_modules/openai/src/internal/responses/response-accumulator.ts +1263 -0
  983. package/node_modules/openai/src/internal/shim-types.ts +3 -4
  984. package/node_modules/openai/src/internal/shims.ts +0 -2
  985. package/node_modules/openai/src/internal/stream-utils.ts +37 -5
  986. package/node_modules/openai/src/internal/to-file.ts +90 -35
  987. package/node_modules/openai/src/internal/types.ts +21 -29
  988. package/node_modules/openai/src/internal/uploads.ts +533 -59
  989. package/node_modules/openai/src/internal/utils/abort.ts +116 -0
  990. package/node_modules/openai/src/internal/utils/base64.ts +3 -2
  991. package/node_modules/openai/src/internal/utils/bytes.ts +7 -0
  992. package/node_modules/openai/src/internal/utils/env.ts +9 -7
  993. package/node_modules/openai/src/internal/utils/log.ts +77 -14
  994. package/node_modules/openai/src/internal/utils/path.ts +53 -32
  995. package/node_modules/openai/src/internal/utils/query.ts +0 -2
  996. package/node_modules/openai/src/internal/utils/sleep.ts +51 -2
  997. package/node_modules/openai/src/internal/utils/uuid.ts +0 -2
  998. package/node_modules/openai/src/internal/utils/values.ts +0 -2
  999. package/node_modules/openai/src/internal/utils.ts +0 -2
  1000. package/node_modules/openai/src/internal/ws-adapter-browser.ts +83 -24
  1001. package/node_modules/openai/src/internal/ws-adapter-node.ts +105 -26
  1002. package/node_modules/openai/src/internal/ws-adapter.ts +23 -0
  1003. package/node_modules/openai/src/internal/ws.ts +250 -51
  1004. package/node_modules/openai/src/lib/.keep +2 -2
  1005. package/node_modules/openai/src/lib/AbstractChatCompletionRunner.ts +349 -102
  1006. package/node_modules/openai/src/lib/AssistantStream.ts +537 -268
  1007. package/node_modules/openai/src/lib/ChatCompletionRunner.ts +75 -22
  1008. package/node_modules/openai/src/lib/ChatCompletionStream.ts +2016 -268
  1009. package/node_modules/openai/src/lib/ChatCompletionStreamingRunner.ts +115 -17
  1010. package/node_modules/openai/src/lib/EventEmitter.ts +171 -26
  1011. package/node_modules/openai/src/lib/EventStream.ts +1979 -64
  1012. package/node_modules/openai/src/lib/ResponsesParser.ts +153 -56
  1013. package/node_modules/openai/src/lib/RunnableFunction.ts +99 -37
  1014. package/node_modules/openai/src/lib/Util.ts +7 -5
  1015. package/node_modules/openai/src/lib/agents/agent-session-stream.ts +328 -0
  1016. package/node_modules/openai/src/lib/agents/output-text.ts +6 -0
  1017. package/node_modules/openai/src/lib/agents/turn-state.ts +61 -0
  1018. package/node_modules/openai/src/lib/assistant-run-polling.ts +27 -0
  1019. package/node_modules/openai/src/lib/chatCompletionUtils.ts +9 -10
  1020. package/node_modules/openai/src/lib/embeddings.ts +73 -0
  1021. package/node_modules/openai/src/lib/file-processing.ts +37 -0
  1022. package/node_modules/openai/src/lib/jsonschema.ts +77 -34
  1023. package/node_modules/openai/src/lib/live/transcript-grouper.ts +307 -0
  1024. package/node_modules/openai/src/lib/live/transcript-grouping.ts +394 -0
  1025. package/node_modules/openai/src/lib/live/webrtc.ts +23 -0
  1026. package/node_modules/openai/src/lib/parser.ts +247 -69
  1027. package/node_modules/openai/src/lib/polling.ts +145 -0
  1028. package/node_modules/openai/src/lib/realtime/webrtc.ts +20 -0
  1029. package/node_modules/openai/src/lib/responses/EventTypes.ts +9 -60
  1030. package/node_modules/openai/src/lib/responses/ResponseAccumulator.ts +27 -0
  1031. package/node_modules/openai/src/lib/responses/ResponseInputItems.ts +167 -0
  1032. package/node_modules/openai/src/lib/responses/ResponseStream.ts +135 -179
  1033. package/node_modules/openai/src/lib/responses/responses-websocket-lane.ts +388 -0
  1034. package/node_modules/openai/src/lib/responses/responses-websocket-session.ts +317 -0
  1035. package/node_modules/openai/src/lib/transform.ts +2015 -100
  1036. package/node_modules/openai/src/lib/vector-store-polling.ts +46 -0
  1037. package/node_modules/openai/src/lib/vector-store-upload.ts +57 -0
  1038. package/node_modules/openai/src/lib/webhook-signature.ts +164 -0
  1039. package/node_modules/openai/src/lib/webrtc/connection.ts +313 -0
  1040. package/node_modules/openai/src/lib/webrtc/data-channel.ts +151 -0
  1041. package/node_modules/openai/src/lib/webrtc/errors.ts +38 -0
  1042. package/node_modules/openai/src/lib/webrtc/subscriptions.ts +65 -0
  1043. package/node_modules/openai/src/lib/webrtc/types.ts +110 -0
  1044. package/node_modules/openai/src/live/webrtc.ts +10 -0
  1045. package/node_modules/openai/src/providers/bedrock/aws.ts +331 -0
  1046. package/node_modules/openai/src/providers/bedrock.ts +51 -0
  1047. package/node_modules/openai/src/realtime/internal-base.ts +265 -17
  1048. package/node_modules/openai/src/realtime/webrtc.ts +10 -0
  1049. package/node_modules/openai/src/realtime/websocket.ts +259 -54
  1050. package/node_modules/openai/src/realtime/ws.ts +135 -29
  1051. package/node_modules/openai/src/resources/admin/admin.ts +1 -1
  1052. package/node_modules/openai/src/resources/admin/index.ts +1 -1
  1053. package/node_modules/openai/src/resources/admin/organization/admin-api-keys.ts +18 -2
  1054. package/node_modules/openai/src/resources/admin/organization/audit-logs.ts +327 -4
  1055. package/node_modules/openai/src/resources/admin/organization/certificates.ts +1 -1
  1056. package/node_modules/openai/src/resources/admin/organization/data-retention.ts +1 -1
  1057. package/node_modules/openai/src/resources/admin/organization/groups/groups.ts +1 -1
  1058. package/node_modules/openai/src/resources/admin/organization/groups/index.ts +1 -1
  1059. package/node_modules/openai/src/resources/admin/organization/groups/roles.ts +1 -1
  1060. package/node_modules/openai/src/resources/admin/organization/groups/users.ts +1 -1
  1061. package/node_modules/openai/src/resources/admin/organization/groups.ts +1 -1
  1062. package/node_modules/openai/src/resources/admin/organization/index.ts +9 -1
  1063. package/node_modules/openai/src/resources/admin/organization/invites.ts +1 -1
  1064. package/node_modules/openai/src/resources/admin/organization/organization.ts +21 -1
  1065. package/node_modules/openai/src/resources/admin/organization/projects/api-keys.ts +22 -2
  1066. package/node_modules/openai/src/resources/admin/organization/projects/certificates.ts +1 -1
  1067. package/node_modules/openai/src/resources/admin/organization/projects/data-retention.ts +1 -1
  1068. package/node_modules/openai/src/resources/admin/organization/projects/groups/groups.ts +1 -1
  1069. package/node_modules/openai/src/resources/admin/organization/projects/groups/index.ts +1 -1
  1070. package/node_modules/openai/src/resources/admin/organization/projects/groups/roles.ts +1 -1
  1071. package/node_modules/openai/src/resources/admin/organization/projects/groups.ts +1 -1
  1072. package/node_modules/openai/src/resources/admin/organization/projects/hosted-tool-permissions.ts +1 -1
  1073. package/node_modules/openai/src/resources/admin/organization/projects/index.ts +10 -2
  1074. package/node_modules/openai/src/resources/admin/organization/projects/model-permissions.ts +1 -1
  1075. package/node_modules/openai/src/resources/admin/organization/projects/projects.ts +70 -19
  1076. package/node_modules/openai/src/resources/admin/organization/projects/rate-limits.ts +1 -1
  1077. package/node_modules/openai/src/resources/admin/organization/projects/roles.ts +1 -1
  1078. package/node_modules/openai/src/resources/admin/organization/projects/service-accounts/api-keys.ts +91 -0
  1079. package/node_modules/openai/src/resources/admin/organization/projects/service-accounts/index.ts +15 -0
  1080. package/node_modules/openai/src/resources/admin/organization/projects/service-accounts/service-accounts.ts +299 -0
  1081. package/node_modules/openai/src/resources/admin/organization/projects/service-accounts.ts +2 -265
  1082. package/node_modules/openai/src/resources/admin/organization/projects/spend-alerts.ts +33 -1
  1083. package/node_modules/openai/src/resources/admin/organization/projects/spend-limit.ts +156 -0
  1084. package/node_modules/openai/src/resources/admin/organization/projects/users/index.ts +1 -1
  1085. package/node_modules/openai/src/resources/admin/organization/projects/users/roles.ts +1 -1
  1086. package/node_modules/openai/src/resources/admin/organization/projects/users/users.ts +1 -1
  1087. package/node_modules/openai/src/resources/admin/organization/projects/users.ts +1 -1
  1088. package/node_modules/openai/src/resources/admin/organization/projects.ts +1 -1
  1089. package/node_modules/openai/src/resources/admin/organization/roles.ts +1 -1
  1090. package/node_modules/openai/src/resources/admin/organization/spend-alerts.ts +19 -1
  1091. package/node_modules/openai/src/resources/admin/organization/spend-limit.ts +144 -0
  1092. package/node_modules/openai/src/resources/admin/organization/usage.ts +706 -89
  1093. package/node_modules/openai/src/resources/admin/organization/users/index.ts +1 -1
  1094. package/node_modules/openai/src/resources/admin/organization/users/roles.ts +1 -1
  1095. package/node_modules/openai/src/resources/admin/organization/users/users.ts +1 -1
  1096. package/node_modules/openai/src/resources/admin/organization/users.ts +1 -1
  1097. package/node_modules/openai/src/resources/admin/organization.ts +1 -1
  1098. package/node_modules/openai/src/resources/admin.ts +1 -1
  1099. package/node_modules/openai/src/resources/audio/audio.ts +4 -1
  1100. package/node_modules/openai/src/resources/audio/index.ts +2 -1
  1101. package/node_modules/openai/src/resources/audio/speech.ts +4 -3
  1102. package/node_modules/openai/src/resources/audio/transcriptions.ts +51 -13
  1103. package/node_modules/openai/src/resources/audio/translations.ts +5 -3
  1104. package/node_modules/openai/src/resources/audio.ts +1 -1
  1105. package/node_modules/openai/src/resources/batches.ts +10 -9
  1106. package/node_modules/openai/src/resources/beta/agents/agents.ts +4627 -0
  1107. package/node_modules/openai/src/resources/beta/agents/environments/environments.ts +111 -0
  1108. package/node_modules/openai/src/resources/beta/agents/environments/files.ts +169 -0
  1109. package/node_modules/openai/src/resources/beta/agents/environments/index.ts +19 -0
  1110. package/node_modules/openai/src/resources/beta/agents/environments/templates.ts +535 -0
  1111. package/node_modules/openai/src/resources/beta/agents/environments.ts +3 -0
  1112. package/node_modules/openai/src/resources/beta/agents/index.ts +127 -0
  1113. package/node_modules/openai/src/resources/beta/agents/sessions/artifacts.ts +249 -0
  1114. package/node_modules/openai/src/resources/beta/agents/sessions/events.ts +94 -0
  1115. package/node_modules/openai/src/resources/beta/agents/sessions/index.ts +24 -0
  1116. package/node_modules/openai/src/resources/beta/agents/sessions/items.ts +59 -0
  1117. package/node_modules/openai/src/resources/beta/agents/sessions/sessions.ts +403 -0
  1118. package/node_modules/openai/src/resources/beta/agents/sessions/subagents/index.ts +5 -0
  1119. package/node_modules/openai/src/resources/beta/agents/sessions/subagents/items.ts +65 -0
  1120. package/node_modules/openai/src/resources/beta/agents/sessions/subagents/subagents.ts +113 -0
  1121. package/node_modules/openai/src/resources/beta/agents/sessions/subagents/turns/index.ts +4 -0
  1122. package/node_modules/openai/src/resources/beta/agents/sessions/subagents/turns/items.ts +70 -0
  1123. package/node_modules/openai/src/resources/beta/agents/sessions/subagents/turns/turns.ts +111 -0
  1124. package/node_modules/openai/src/resources/beta/agents/sessions/subagents/turns.ts +3 -0
  1125. package/node_modules/openai/src/resources/beta/agents/sessions/subagents.ts +3 -0
  1126. package/node_modules/openai/src/resources/beta/agents/sessions/turns.ts +159 -0
  1127. package/node_modules/openai/src/resources/beta/agents/sessions.ts +3 -0
  1128. package/node_modules/openai/src/resources/beta/agents/vaults/credentials.ts +693 -0
  1129. package/node_modules/openai/src/resources/beta/agents/vaults/index.ts +29 -0
  1130. package/node_modules/openai/src/resources/beta/agents/vaults/vaults.ts +243 -0
  1131. package/node_modules/openai/src/resources/beta/agents/vaults.ts +3 -0
  1132. package/node_modules/openai/src/resources/beta/agents.ts +3 -0
  1133. package/node_modules/openai/src/resources/beta/assistants.ts +154 -172
  1134. package/node_modules/openai/src/resources/beta/beta.ts +578 -3
  1135. package/node_modules/openai/src/resources/beta/chatkit/chatkit.ts +1 -1
  1136. package/node_modules/openai/src/resources/beta/chatkit/index.ts +1 -1
  1137. package/node_modules/openai/src/resources/beta/chatkit/sessions.ts +1 -1
  1138. package/node_modules/openai/src/resources/beta/chatkit/threads.ts +1 -1
  1139. package/node_modules/openai/src/resources/beta/chatkit.ts +1 -1
  1140. package/node_modules/openai/src/resources/beta/index.ts +290 -1
  1141. package/node_modules/openai/src/resources/beta/realtime/index.ts +0 -2
  1142. package/node_modules/openai/src/resources/beta/realtime/realtime.ts +0 -2
  1143. package/node_modules/openai/src/resources/beta/realtime/sessions.ts +0 -2
  1144. package/node_modules/openai/src/resources/beta/realtime/transcription-sessions.ts +0 -2
  1145. package/node_modules/openai/src/resources/beta/realtime.ts +0 -2
  1146. package/node_modules/openai/src/resources/beta/responses/index.ts +189 -0
  1147. package/node_modules/openai/src/resources/beta/responses/input-items.ts +105 -0
  1148. package/node_modules/openai/src/resources/beta/responses/input-tokens.ts +249 -0
  1149. package/node_modules/openai/src/resources/beta/responses/internal-base.ts +136 -0
  1150. package/node_modules/openai/src/resources/beta/responses/responses.ts +15060 -0
  1151. package/node_modules/openai/src/resources/beta/responses/ws-base.ts +729 -0
  1152. package/node_modules/openai/src/resources/beta/responses/ws.ts +62 -0
  1153. package/node_modules/openai/src/resources/beta/responses.ts +3 -0
  1154. package/node_modules/openai/src/resources/beta/threads/index.ts +1 -1
  1155. package/node_modules/openai/src/resources/beta/threads/messages.ts +30 -24
  1156. package/node_modules/openai/src/resources/beta/threads/runs/index.ts +2 -2
  1157. package/node_modules/openai/src/resources/beta/threads/runs/runs.ts +47 -93
  1158. package/node_modules/openai/src/resources/beta/threads/runs/steps.ts +15 -16
  1159. package/node_modules/openai/src/resources/beta/threads/runs.ts +1 -1
  1160. package/node_modules/openai/src/resources/beta/threads/threads.ts +54 -51
  1161. package/node_modules/openai/src/resources/beta/threads.ts +1 -1
  1162. package/node_modules/openai/src/resources/beta.ts +1 -1
  1163. package/node_modules/openai/src/resources/chat/chat.ts +1 -1
  1164. package/node_modules/openai/src/resources/chat/completions/completions.ts +762 -108
  1165. package/node_modules/openai/src/resources/chat/completions/index.ts +1 -1
  1166. package/node_modules/openai/src/resources/chat/completions/messages.ts +1 -1
  1167. package/node_modules/openai/src/resources/chat/completions.ts +1 -1
  1168. package/node_modules/openai/src/resources/chat/index.ts +1 -1
  1169. package/node_modules/openai/src/resources/chat.ts +1 -1
  1170. package/node_modules/openai/src/resources/completions.ts +36 -15
  1171. package/node_modules/openai/src/resources/containers/containers.ts +1 -1
  1172. package/node_modules/openai/src/resources/containers/files/content.ts +1 -1
  1173. package/node_modules/openai/src/resources/containers/files/files.ts +1 -1
  1174. package/node_modules/openai/src/resources/containers/files/index.ts +1 -1
  1175. package/node_modules/openai/src/resources/containers/files.ts +1 -1
  1176. package/node_modules/openai/src/resources/containers/index.ts +1 -1
  1177. package/node_modules/openai/src/resources/containers.ts +1 -1
  1178. package/node_modules/openai/src/resources/content-provenance-checks.ts +132 -0
  1179. package/node_modules/openai/src/resources/conversations/conversations.ts +23 -2
  1180. package/node_modules/openai/src/resources/conversations/index.ts +1 -1
  1181. package/node_modules/openai/src/resources/conversations/items.ts +93 -5
  1182. package/node_modules/openai/src/resources/conversations.ts +1 -1
  1183. package/node_modules/openai/src/resources/embeddings.ts +22 -49
  1184. package/node_modules/openai/src/resources/evals/evals.ts +6 -6
  1185. package/node_modules/openai/src/resources/evals/index.ts +1 -1
  1186. package/node_modules/openai/src/resources/evals/runs/index.ts +1 -1
  1187. package/node_modules/openai/src/resources/evals/runs/output-items.ts +1 -1
  1188. package/node_modules/openai/src/resources/evals/runs/runs.ts +119 -191
  1189. package/node_modules/openai/src/resources/evals/runs.ts +1 -1
  1190. package/node_modules/openai/src/resources/evals.ts +1 -1
  1191. package/node_modules/openai/src/resources/files.ts +9 -26
  1192. package/node_modules/openai/src/resources/fine-tuning/alpha/alpha.ts +1 -1
  1193. package/node_modules/openai/src/resources/fine-tuning/alpha/graders.ts +6 -5
  1194. package/node_modules/openai/src/resources/fine-tuning/alpha/index.ts +1 -1
  1195. package/node_modules/openai/src/resources/fine-tuning/alpha.ts +1 -1
  1196. package/node_modules/openai/src/resources/fine-tuning/checkpoints/checkpoints.ts +1 -1
  1197. package/node_modules/openai/src/resources/fine-tuning/checkpoints/index.ts +1 -1
  1198. package/node_modules/openai/src/resources/fine-tuning/checkpoints/permissions.ts +9 -5
  1199. package/node_modules/openai/src/resources/fine-tuning/checkpoints.ts +1 -1
  1200. package/node_modules/openai/src/resources/fine-tuning/fine-tuning.ts +1 -1
  1201. package/node_modules/openai/src/resources/fine-tuning/index.ts +1 -1
  1202. package/node_modules/openai/src/resources/fine-tuning/jobs/checkpoints.ts +1 -1
  1203. package/node_modules/openai/src/resources/fine-tuning/jobs/index.ts +1 -1
  1204. package/node_modules/openai/src/resources/fine-tuning/jobs/jobs.ts +14 -13
  1205. package/node_modules/openai/src/resources/fine-tuning/jobs.ts +1 -1
  1206. package/node_modules/openai/src/resources/fine-tuning/methods.ts +1 -1
  1207. package/node_modules/openai/src/resources/fine-tuning.ts +1 -1
  1208. package/node_modules/openai/src/resources/graders/grader-models.ts +7 -14
  1209. package/node_modules/openai/src/resources/graders/graders.ts +1 -1
  1210. package/node_modules/openai/src/resources/graders/index.ts +1 -1
  1211. package/node_modules/openai/src/resources/graders.ts +1 -1
  1212. package/node_modules/openai/src/resources/images.ts +100 -85
  1213. package/node_modules/openai/src/resources/index.ts +9 -2
  1214. package/node_modules/openai/src/resources/live/api.md +87 -0
  1215. package/node_modules/openai/src/resources/live/forks/forks.ts +169 -0
  1216. package/node_modules/openai/src/resources/live/forks/index.ts +5 -0
  1217. package/node_modules/openai/src/resources/live/forks/internal-base.ts +126 -0
  1218. package/node_modules/openai/src/resources/live/forks/ws-base.ts +700 -0
  1219. package/node_modules/openai/src/resources/live/forks/ws.ts +47 -0
  1220. package/node_modules/openai/src/resources/live/forks.ts +3 -0
  1221. package/node_modules/openai/src/resources/live/index.ts +20 -0
  1222. package/node_modules/openai/src/resources/live/internal-base.ts +123 -0
  1223. package/node_modules/openai/src/resources/live/live.ts +2296 -0
  1224. package/node_modules/openai/src/resources/live/sessions.ts +343 -0
  1225. package/node_modules/openai/src/resources/live/sideband/index.ts +10 -0
  1226. package/node_modules/openai/src/resources/live/sideband/internal-base.ts +126 -0
  1227. package/node_modules/openai/src/resources/live/sideband/sideband.ts +58 -0
  1228. package/node_modules/openai/src/resources/live/sideband/ws-base.ts +710 -0
  1229. package/node_modules/openai/src/resources/live/sideband/ws.ts +47 -0
  1230. package/node_modules/openai/src/resources/live/sideband.ts +3 -0
  1231. package/node_modules/openai/src/resources/live/ws-base.ts +696 -0
  1232. package/node_modules/openai/src/resources/live/ws.ts +43 -0
  1233. package/node_modules/openai/src/resources/live.ts +3 -0
  1234. package/node_modules/openai/src/resources/models.ts +6 -1
  1235. package/node_modules/openai/src/resources/moderations.ts +6 -5
  1236. package/node_modules/openai/src/resources/realtime/api.md +1 -0
  1237. package/node_modules/openai/src/resources/realtime/calls.ts +50 -2
  1238. package/node_modules/openai/src/resources/realtime/client-secrets.ts +27 -10
  1239. package/node_modules/openai/src/resources/realtime/index.ts +8 -2
  1240. package/node_modules/openai/src/resources/realtime/realtime.ts +93 -35
  1241. package/node_modules/openai/src/resources/realtime.ts +1 -1
  1242. package/node_modules/openai/src/resources/responses/api.md +20 -0
  1243. package/node_modules/openai/src/resources/responses/index.ts +1 -1
  1244. package/node_modules/openai/src/resources/responses/input-items.ts +1 -1
  1245. package/node_modules/openai/src/resources/responses/input-tokens.ts +26 -16
  1246. package/node_modules/openai/src/resources/responses/internal-base.ts +33 -14
  1247. package/node_modules/openai/src/resources/responses/responses.ts +4150 -792
  1248. package/node_modules/openai/src/resources/responses/ws-base.ts +147 -31
  1249. package/node_modules/openai/src/resources/responses/ws.ts +33 -9
  1250. package/node_modules/openai/src/resources/responses.ts +1 -1
  1251. package/node_modules/openai/src/resources/safety/alerts.ts +51 -0
  1252. package/node_modules/openai/src/resources/safety/index.ts +4 -0
  1253. package/node_modules/openai/src/resources/safety/safety.ts +15 -0
  1254. package/node_modules/openai/src/resources/safety.ts +3 -0
  1255. package/node_modules/openai/src/resources/shared.ts +98 -41
  1256. package/node_modules/openai/src/resources/skills/content.ts +1 -1
  1257. package/node_modules/openai/src/resources/skills/index.ts +1 -1
  1258. package/node_modules/openai/src/resources/skills/skills.ts +4 -2
  1259. package/node_modules/openai/src/resources/skills/versions/content.ts +1 -1
  1260. package/node_modules/openai/src/resources/skills/versions/index.ts +1 -1
  1261. package/node_modules/openai/src/resources/skills/versions/versions.ts +4 -2
  1262. package/node_modules/openai/src/resources/skills/versions.ts +1 -1
  1263. package/node_modules/openai/src/resources/skills.ts +1 -1
  1264. package/node_modules/openai/src/resources/uploads/index.ts +1 -1
  1265. package/node_modules/openai/src/resources/uploads/parts.ts +6 -5
  1266. package/node_modules/openai/src/resources/uploads/uploads.ts +12 -12
  1267. package/node_modules/openai/src/resources/uploads.ts +1 -1
  1268. package/node_modules/openai/src/resources/vector-stores/file-batches.ts +24 -89
  1269. package/node_modules/openai/src/resources/vector-stores/files.ts +12 -52
  1270. package/node_modules/openai/src/resources/vector-stores/index.ts +1 -1
  1271. package/node_modules/openai/src/resources/vector-stores/vector-stores.ts +4 -4
  1272. package/node_modules/openai/src/resources/vector-stores.ts +1 -1
  1273. package/node_modules/openai/src/resources/videos.ts +63 -2
  1274. package/node_modules/openai/src/resources/webhooks/api.md +40 -17
  1275. package/node_modules/openai/src/resources/webhooks/event-types.ts +21 -0
  1276. package/node_modules/openai/src/resources/webhooks/index.ts +2 -1
  1277. package/node_modules/openai/src/resources/webhooks/webhooks.ts +694 -69
  1278. package/node_modules/openai/src/resources/webhooks.ts +1 -1
  1279. package/node_modules/openai/src/tsconfig.json +6 -3
  1280. package/node_modules/openai/src/version.ts +2 -1
  1281. package/node_modules/openai/version.js +2 -1
  1282. package/node_modules/openai/version.mjs +2 -1
  1283. package/package.json +5 -5
  1284. package/node_modules/@earendil-works/pi-ai/dist/image-models.generated.js +0 -832
  1285. package/node_modules/@earendil-works/pi-ai/dist/images-models.js +0 -143
  1286. package/node_modules/@earendil-works/pi-ai/dist/providers/openrouter-images.js +0 -22
  1287. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/LICENSE +0 -0
  1288. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/README.md +0 -0
  1289. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/dist-cjs/index.js +0 -0
  1290. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/dist-es/constants.js +0 -0
  1291. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/dist-es/fromEnvSigningName.js +0 -0
  1292. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/dist-es/fromSso.js +0 -0
  1293. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/dist-es/fromStatic.js +0 -0
  1294. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/dist-es/getNewSsoOidcToken.js +0 -0
  1295. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/dist-es/getSsoOidcClient.js +0 -0
  1296. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/dist-es/index.js +0 -0
  1297. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/dist-es/nodeProvider.js +0 -0
  1298. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/dist-es/validateTokenExpiry.js +0 -0
  1299. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/dist-es/validateTokenKey.js +0 -0
  1300. /package/node_modules/@aws-sdk/{credential-provider-sso → client-bedrock-runtime}/node_modules/@aws-sdk/token-providers/dist-es/writeSSOTokenToFile.js +0 -0
  1301. /package/node_modules/@earendil-works/pi-ai/dist/{auth/oauth → utils}/oauth-page.js +0 -0
@@ -1,25 +1,1422 @@
1
- import { APIUserAbortError, OpenAIError } from '../error';
1
+ import {
2
+ APIConnectionError,
3
+ APIConnectionTimeoutError,
4
+ APIError,
5
+ APIUserAbortError,
6
+ AuthenticationError,
7
+ BadRequestError,
8
+ ConflictError,
9
+ ContentFilterFinishReasonError,
10
+ InternalServerError,
11
+ InvalidWebhookSignatureError,
12
+ LengthFinishReasonError,
13
+ NotFoundError,
14
+ OAuthError,
15
+ OpenAIError,
16
+ PermissionDeniedError,
17
+ RateLimitError,
18
+ SubjectTokenProviderError,
19
+ UnprocessableEntityError,
20
+ } from '../error';
21
+ import type { EmittedEventResult } from './EventEmitter';
2
22
 
23
+ const MAX_BUFFERED_ITERATOR_EVENTS = 4096;
24
+ const MAX_BUFFERED_ITERATOR_BYTES = 8 * 1024 * 1024;
25
+ // Typed-array own-key enumeration materializes every dense index before custom keys.
26
+ const MAX_INSPECTABLE_TYPED_ARRAY_ELEMENTS = 4096;
27
+ // Structured JSON may nest 128 levels before stream-event wrappers are added.
28
+ const MAX_BUFFERED_EVENT_DEPTH = 256;
29
+ const bufferedJSONStringify = JSON.stringify;
30
+ const bufferedJSONParse = JSON.parse;
31
+ const sdkOwnedBufferedEventArguments = new WeakSet<object>();
32
+
33
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
34
+ const typedArrayBufferGetter = Object.getOwnPropertyDescriptor(
35
+ Object.getPrototypeOf(Uint8Array.prototype) as object,
36
+ 'buffer',
37
+ )?.get;
38
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
39
+ const typedArrayLengthGetter = Object.getOwnPropertyDescriptor(
40
+ Object.getPrototypeOf(Uint8Array.prototype) as object,
41
+ 'length',
42
+ )?.get;
43
+ const dataViewBufferGetter = Object.getOwnPropertyDescriptor(DataView.prototype, 'buffer')?.get;
44
+ const symbolDescriptionGetter = Object.getOwnPropertyDescriptor(Symbol.prototype, 'description')?.get;
45
+ const dateTimestampGetter = Date.prototype.getTime;
46
+ const arrayBufferByteLengthGetter = Object.getOwnPropertyDescriptor(ArrayBuffer.prototype, 'byteLength')?.get;
47
+ const sharedArrayBufferByteLengthGetter =
48
+ typeof SharedArrayBuffer === 'function'
49
+ ? Object.getOwnPropertyDescriptor(SharedArrayBuffer.prototype, 'byteLength')?.get
50
+ : undefined;
51
+ // V8 uses the same trusted lazy-stack accessor pair for native Error instances.
52
+ const errorStackDescriptor = Object.getOwnPropertyDescriptor(new Error('native stack descriptor'), 'stack');
53
+ const functionToString = Function.prototype.toString;
54
+ const objectToString = Object.prototype.toString;
55
+ const errorBrandDescriptor = Object.getOwnPropertyDescriptor(Error, 'isError');
56
+ // The native Error.isError predicate brands arbitrary values before an Error contract can be assumed.
57
+ // SAFETY: The captured native Error.isError property was checked to be a function before it is used as a brand predicate.
58
+ const nativeErrorBrand =
59
+ errorBrandDescriptor && 'value' in errorBrandDescriptor && typeof errorBrandDescriptor.value === 'function'
60
+ ? (errorBrandDescriptor.value as (value: unknown) => boolean)
61
+ : undefined;
62
+ const nativeErrorConstructorSource = functionToString.call(Error);
63
+ const nativeDateConstructorSource = functionToString.call(Date);
64
+ const nativeFunctionConstructorSource = functionToString.call(Function);
65
+ const trustedIntrinsicPrototypes = new Set<object>([
66
+ APIConnectionError.prototype,
67
+ APIConnectionTimeoutError.prototype,
68
+ APIError.prototype,
69
+ OpenAIError.prototype,
70
+ APIUserAbortError.prototype,
71
+ AuthenticationError.prototype,
72
+ BadRequestError.prototype,
73
+ ConflictError.prototype,
74
+ ContentFilterFinishReasonError.prototype,
75
+ InternalServerError.prototype,
76
+ InvalidWebhookSignatureError.prototype,
77
+ LengthFinishReasonError.prototype,
78
+ NotFoundError.prototype,
79
+ OAuthError.prototype,
80
+ PermissionDeniedError.prototype,
81
+ RateLimitError.prototype,
82
+ SubjectTokenProviderError.prototype,
83
+ UnprocessableEntityError.prototype,
84
+ ]);
85
+ const trustedNativeConstructorSources = new Set<string>();
86
+ const canonicalIntrinsicDescriptors = new Map<string, ReadonlyMap<PropertyKey, PropertyDescriptor>>();
87
+ const foreignErrorStackDescriptors = new WeakMap<object, PropertyDescriptor>();
88
+
89
+ // oxlint-disable-next-line anti-slop/no-unknown-returns -- Native and cross-realm constructor identities are inspected without assuming an unvalidated result type.
90
+ type NativeErrorConstructor = (...args: never[]) => unknown;
91
+
92
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- The native proxy predicate accepts arbitrary object identities without invoking their handlers.
93
+ function captureNativeProxyDetector(): ((value: object) => boolean) | undefined {
94
+ if (typeof process === 'undefined') {
95
+ return undefined;
96
+ }
97
+
98
+ try {
99
+ const loader = Object.getOwnPropertyDescriptor(process, 'getBuiltinModule');
100
+ if (!loader || !('value' in loader) || typeof loader.value !== 'function') {
101
+ return undefined;
102
+ }
103
+ // oxlint-disable-next-line anti-slop/no-reflect-apply -- Invoke the descriptor value without reading a potentially overridden call property.
104
+ const util: unknown = Reflect.apply(loader.value, process, ['node:util']);
105
+ if (typeof util !== 'object' || util === null) {
106
+ return undefined;
107
+ }
108
+ const types = Object.getOwnPropertyDescriptor(util, 'types');
109
+ if (!types || !('value' in types) || typeof types.value !== 'object' || types.value === null) {
110
+ return undefined;
111
+ }
112
+ const detector = Object.getOwnPropertyDescriptor(types.value, 'isProxy');
113
+ if (!detector || !('value' in detector) || typeof detector.value !== 'function') {
114
+ return undefined;
115
+ }
116
+ // SAFETY: The native detector data property was checked to be callable; it is invoked only to test the corresponding intrinsic object brand.
117
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- The captured native predicate is called only for objects, before their properties are inspected.
118
+ return detector.value as (value: object) => boolean;
119
+ } catch {
120
+ return undefined;
121
+ }
122
+ }
123
+
124
+ // Transparent proxies have no portable ECMAScript brand. Newer Node runtimes
125
+ // expose one without adding a Node-only import to browser-compatible bundles.
126
+ const nativeProxyDetector = captureNativeProxyDetector();
127
+
128
+ function rememberTrustedIntrinsic(constructor: unknown): void {
129
+ if (typeof constructor !== 'function') {
130
+ return;
131
+ }
132
+
133
+ const prototypeDescriptor = Object.getOwnPropertyDescriptor(constructor, 'prototype');
134
+ if (
135
+ !prototypeDescriptor ||
136
+ !('value' in prototypeDescriptor) ||
137
+ (typeof prototypeDescriptor.value !== 'object' && typeof prototypeDescriptor.value !== 'function')
138
+ ) {
139
+ return;
140
+ }
141
+
142
+ // SAFETY: The prototype data descriptor was checked as a non-null object before adding its identity to the trusted-intrinsic set.
143
+ trustedIntrinsicPrototypes.add(prototypeDescriptor.value as object);
144
+ const source = functionToString.call(constructor);
145
+ if (
146
+ /^function [A-Za-z_$][\w$]*\(\) \{ \[native code\] \}$/u.test(source) &&
147
+ prototypeDescriptor.configurable === false &&
148
+ prototypeDescriptor.writable === false
149
+ ) {
150
+ trustedNativeConstructorSources.add(source);
151
+ const descriptors = new Map<PropertyKey, PropertyDescriptor>();
152
+ for (const key of Reflect.ownKeys(prototypeDescriptor.value)) {
153
+ const descriptor = Object.getOwnPropertyDescriptor(prototypeDescriptor.value, key);
154
+ if (descriptor) {
155
+ descriptors.set(key, descriptor);
156
+ }
157
+ }
158
+ canonicalIntrinsicDescriptors.set(source, descriptors);
159
+ }
160
+ }
161
+
162
+ for (const constructor of [
163
+ Object,
164
+ Function,
165
+ Array,
166
+ Date,
167
+ Map,
168
+ Set,
169
+ ArrayBuffer,
170
+ DataView,
171
+ Error,
172
+ EvalError,
173
+ RangeError,
174
+ ReferenceError,
175
+ SyntaxError,
176
+ TypeError,
177
+ URIError,
178
+ Uint8Array,
179
+ Uint8ClampedArray,
180
+ Uint16Array,
181
+ Uint32Array,
182
+ Int8Array,
183
+ Int16Array,
184
+ Int32Array,
185
+ Float32Array,
186
+ Float64Array,
187
+ ]) {
188
+ rememberTrustedIntrinsic(constructor);
189
+ }
190
+
191
+ for (const name of [
192
+ 'SharedArrayBuffer',
193
+ 'AggregateError',
194
+ 'Float16Array',
195
+ 'BigInt64Array',
196
+ 'BigUint64Array',
197
+ 'Blob',
198
+ 'File',
199
+ 'Headers',
200
+ ] as const) {
201
+ const descriptor = Object.getOwnPropertyDescriptor(globalThis, name);
202
+ if (descriptor && 'value' in descriptor) {
203
+ rememberTrustedIntrinsic(descriptor.value);
204
+ }
205
+ }
206
+
207
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
208
+ const typedArrayConstructorDescriptor = Object.getOwnPropertyDescriptor(
209
+ Object.getPrototypeOf(Uint8Array.prototype) as object,
210
+ 'constructor',
211
+ );
212
+ if (typedArrayConstructorDescriptor && 'value' in typedArrayConstructorDescriptor) {
213
+ rememberTrustedIntrinsic(typedArrayConstructorDescriptor.value);
214
+ }
215
+
216
+ if (typeof Buffer === 'function') {
217
+ rememberTrustedIntrinsic(Buffer);
218
+ }
219
+
220
+ const blobInternalHandlePrototype = (() => {
221
+ if (typeof Blob !== 'function') {
222
+ return undefined;
223
+ }
224
+
225
+ try {
226
+ const blob = new Blob([]);
227
+ for (const key of Object.getOwnPropertySymbols(blob)) {
228
+ const descriptor = Object.getOwnPropertyDescriptor(blob, key);
229
+ if (descriptor && 'value' in descriptor && typeof descriptor.value === 'object' && descriptor.value) {
230
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
231
+ return Object.getPrototypeOf(descriptor.value) as object;
232
+ }
233
+ }
234
+ } catch {
235
+ return undefined;
236
+ }
237
+
238
+ return undefined;
239
+ })();
240
+ const mapEntries = Map.prototype.entries;
241
+ const setValues = Set.prototype.values;
242
+ const headersEntriesDescriptor =
243
+ typeof Headers === 'function' ? Object.getOwnPropertyDescriptor(Headers.prototype, 'entries') : undefined;
244
+ // SAFETY: The own Headers entries data property was checked to be callable and retains the native method signature.
245
+ const headersEntries =
246
+ headersEntriesDescriptor &&
247
+ 'value' in headersEntriesDescriptor &&
248
+ typeof headersEntriesDescriptor.value === 'function'
249
+ ? (headersEntriesDescriptor.value as typeof Headers.prototype.entries)
250
+ : undefined;
251
+ const retainedStorageBrands = new Set([
252
+ 'ArrayBuffer',
253
+ 'SharedArrayBuffer',
254
+ 'Blob',
255
+ 'File',
256
+ 'Map',
257
+ 'Date',
258
+ 'Set',
259
+ 'Headers',
260
+ ]);
261
+
262
+ interface TrustedForeignIntrinsic {
263
+ constructor: NativeErrorConstructor;
264
+ descriptors: ReadonlyMap<PropertyKey, PropertyDescriptor>;
265
+ functionPrototype: object;
266
+ }
267
+
268
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Foreign prototypes are untrusted objects until their constructor descriptors are verified.
269
+ function getTrustedForeignIntrinsic(prototype: object): TrustedForeignIntrinsic | undefined {
270
+ const descriptor = Object.getOwnPropertyDescriptor(prototype, 'constructor');
271
+ if (!descriptor || !('value' in descriptor) || typeof descriptor.value !== 'function') {
272
+ return undefined;
273
+ }
274
+
275
+ // SAFETY: The descriptor contains a function; the following native-source and prototype checks verify the Error constructor before use.
276
+ const constructor = descriptor.value as NativeErrorConstructor;
277
+ const source = functionToString.call(constructor);
278
+ const descriptors = canonicalIntrinsicDescriptors.get(source);
279
+ if (!trustedNativeConstructorSources.has(source) || !descriptors) {
280
+ return undefined;
281
+ }
282
+
283
+ const constructorPrototype = Object.getOwnPropertyDescriptor(constructor, 'prototype');
284
+ if (
285
+ !constructorPrototype ||
286
+ !('value' in constructorPrototype) ||
287
+ constructorPrototype.value !== prototype ||
288
+ constructorPrototype.configurable !== false ||
289
+ constructorPrototype.writable !== false
290
+ ) {
291
+ return undefined;
292
+ }
293
+
294
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
295
+ return { constructor, descriptors, functionPrototype: Object.getPrototypeOf(constructor) as object };
296
+ }
297
+
298
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Intrinsic trust is established by object identity or verified cross-realm descriptors.
299
+ function isTrustedIntrinsicPrototype(prototype: object): boolean {
300
+ return trustedIntrinsicPrototypes.has(prototype) || getTrustedForeignIntrinsic(prototype) !== undefined;
301
+ }
302
+
303
+ function isCanonicalIntrinsicFunction(
304
+ value: unknown,
305
+ canonical: unknown,
306
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Cross-realm function prototypes are compared by identity without trusting a callable signature.
307
+ functionPrototype: object,
308
+ ): boolean {
309
+ if (canonical === undefined) {
310
+ return value === undefined;
311
+ }
312
+
313
+ if (typeof value !== 'function' || typeof canonical !== 'function') {
314
+ return false;
315
+ }
316
+
317
+ const source = functionToString.call(canonical);
318
+ if (functionToString.call(value) !== source) {
319
+ return false;
320
+ }
321
+
322
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
323
+ const actualFunctionPrototype = Object.getPrototypeOf(value) as object;
324
+ if (actualFunctionPrototype === functionPrototype) {
325
+ return true;
326
+ }
327
+ if (!/^function [A-Za-z_$][\w$]*\(\) \{ \[native code\] \}$/u.test(source)) {
328
+ return false;
329
+ }
330
+
331
+ const intrinsic = getTrustedForeignIntrinsic(actualFunctionPrototype);
332
+ return (
333
+ intrinsic !== undefined &&
334
+ functionToString.call(intrinsic.constructor) === nativeFunctionConstructorSource
335
+ );
336
+ }
337
+
338
+ function isCanonicalIntrinsicDescriptor(
339
+ descriptor: PropertyDescriptor,
340
+ canonical: PropertyDescriptor | undefined,
341
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Descriptor validation compares the verified function-prototype identity without reading its fields.
342
+ functionPrototype: object,
343
+ ): boolean {
344
+ if (
345
+ !canonical ||
346
+ descriptor.configurable !== canonical.configurable ||
347
+ descriptor.enumerable !== canonical.enumerable ||
348
+ 'value' in descriptor !== 'value' in canonical
349
+ ) {
350
+ return false;
351
+ }
352
+
353
+ if ('value' in descriptor && 'value' in canonical) {
354
+ if (descriptor.writable !== canonical.writable) {
355
+ return false;
356
+ }
357
+ if (typeof canonical.value === 'function') {
358
+ return isCanonicalIntrinsicFunction(descriptor.value, canonical.value, functionPrototype);
359
+ }
360
+ if (canonical.value !== null && typeof canonical.value === 'object') {
361
+ return false;
362
+ }
363
+ return Object.is(descriptor.value, canonical.value);
364
+ }
365
+
366
+ return (
367
+ isCanonicalIntrinsicFunction(descriptor.get, canonical.get, functionPrototype) &&
368
+ isCanonicalIntrinsicFunction(descriptor.set, canonical.set, functionPrototype)
369
+ );
370
+ }
371
+
372
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Native error branding must inspect arbitrary objects before assuming an Error contract.
373
+ function hasNativeErrorBrand(current: object): boolean {
374
+ if (nativeErrorBrand) {
375
+ return nativeErrorBrand.call(Error, current);
376
+ }
377
+
378
+ let prototype: object | null = current;
379
+ for (let depth = 0; prototype !== null && depth < MAX_BUFFERED_EVENT_DEPTH; depth += 1) {
380
+ if (Object.getOwnPropertyDescriptor(prototype, Symbol.toStringTag)) {
381
+ return false;
382
+ }
383
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
384
+ prototype = Object.getPrototypeOf(prototype) as object | null;
385
+ }
386
+
387
+ return prototype === null && objectToString.call(current) === '[object Error]';
388
+ }
389
+
390
+ function getVerifiedForeignErrorConstructor(
391
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Foreign error constructors are verified from descriptors of an otherwise untrusted object.
392
+ current: object,
393
+ stackDescriptor: PropertyDescriptor,
394
+ ): { constructor: NativeErrorConstructor; prototype: object } | undefined {
395
+ if (typeof stackDescriptor.get !== 'function' || typeof stackDescriptor.set !== 'function') {
396
+ return undefined;
397
+ }
398
+
399
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
400
+ let prototype = Object.getPrototypeOf(current) as object | null;
401
+ for (let depth = 0; prototype !== null && depth < MAX_BUFFERED_EVENT_DEPTH; depth += 1) {
402
+ const descriptor = Object.getOwnPropertyDescriptor(prototype, 'constructor');
403
+ if (descriptor && 'value' in descriptor && typeof descriptor.value === 'function') {
404
+ // SAFETY: The descriptor contains a function; the following intrinsic and constructor-prototype checks decide whether it is a trusted Error constructor.
405
+ const constructor = descriptor.value as NativeErrorConstructor;
406
+ if (
407
+ functionToString.call(constructor) === nativeErrorConstructorSource &&
408
+ isTrustedIntrinsicPrototype(prototype)
409
+ ) {
410
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
411
+ const functionPrototype = Object.getPrototypeOf(constructor) as object;
412
+ if (
413
+ Object.getPrototypeOf(stackDescriptor.get) === functionPrototype &&
414
+ Object.getPrototypeOf(stackDescriptor.set) === functionPrototype
415
+ ) {
416
+ return { constructor, prototype };
417
+ }
418
+ return undefined;
419
+ }
420
+ }
421
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
422
+ prototype = Object.getPrototypeOf(prototype) as object | null;
423
+ }
424
+
425
+ return undefined;
426
+ }
427
+
428
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Stack accessors are trusted only after the object passes native error branding.
429
+ function isTrustedNativeErrorStack(current: object, descriptor: PropertyDescriptor): boolean {
430
+ if (!hasNativeErrorBrand(current)) {
431
+ return false;
432
+ }
433
+
434
+ if (
435
+ errorStackDescriptor &&
436
+ !('value' in errorStackDescriptor) &&
437
+ typeof errorStackDescriptor.get === 'function' &&
438
+ Object.prototype.isPrototypeOf.call(Error.prototype, current) &&
439
+ descriptor.get === errorStackDescriptor.get &&
440
+ descriptor.set === errorStackDescriptor.set
441
+ ) {
442
+ return true;
443
+ }
444
+
445
+ const verified = getVerifiedForeignErrorConstructor(current, descriptor);
446
+ if (!verified) {
447
+ return false;
448
+ }
449
+
450
+ let canonicalDescriptor = foreignErrorStackDescriptors.get(verified.prototype);
451
+ if (!canonicalDescriptor) {
452
+ // SAFETY: Reflect.construct returns an untyped value; unknown preserves that uncertainty for the descriptor checks below.
453
+ const canonical = Reflect.construct(verified.constructor, []) as unknown;
454
+ if (
455
+ typeof canonical !== 'object' ||
456
+ canonical === null ||
457
+ !hasNativeErrorBrand(canonical) ||
458
+ Object.getPrototypeOf(canonical) !== verified.prototype
459
+ ) {
460
+ return false;
461
+ }
462
+
463
+ canonicalDescriptor = Object.getOwnPropertyDescriptor(canonical, 'stack');
464
+ if (
465
+ !canonicalDescriptor ||
466
+ 'value' in canonicalDescriptor ||
467
+ typeof canonicalDescriptor.get !== 'function' ||
468
+ typeof canonicalDescriptor.set !== 'function'
469
+ ) {
470
+ return false;
471
+ }
472
+ foreignErrorStackDescriptors.set(verified.prototype, canonicalDescriptor);
473
+ }
474
+
475
+ return descriptor.get === canonicalDescriptor.get && descriptor.set === canonicalDescriptor.set;
476
+ }
477
+
478
+ type RetainedStorage = {
479
+ bytes: number;
480
+ kind: 'typed-array' | 'data-view' | 'buffer' | 'blob' | 'map' | 'date' | 'set' | 'headers';
481
+ };
482
+
483
+ type EventQueue<Value> = {
484
+ readonly length: number;
485
+ enqueue: (value: Value) => void;
486
+ dequeue: () => Value | undefined;
487
+ clear: () => void;
488
+ };
489
+
490
+ function createEventQueue<Value>(): EventQueue<Value> {
491
+ let entries: (Value | undefined)[] = [];
492
+ let head = 0;
493
+
494
+ return {
495
+ get length() {
496
+ return entries.length - head;
497
+ },
498
+ enqueue(value) {
499
+ entries.push(value);
500
+ },
501
+ dequeue() {
502
+ if (head === entries.length) {
503
+ return undefined;
504
+ }
505
+
506
+ const value = entries[head];
507
+ entries[head] = undefined;
508
+ head += 1;
509
+
510
+ if (head === entries.length) {
511
+ entries = [];
512
+ head = 0;
513
+ } else if (head >= 1024 && head * 2 >= entries.length) {
514
+ entries = entries.slice(head);
515
+ head = 0;
516
+ }
517
+
518
+ return value;
519
+ },
520
+ clear() {
521
+ entries = [];
522
+ head = 0;
523
+ },
524
+ };
525
+ }
526
+
527
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Retained storage branding walks arbitrary object prototypes without assuming their native type.
528
+ function getRetainedStorageBrand(current: object): string | undefined {
529
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
530
+ let prototype = Object.getPrototypeOf(current) as object | null;
531
+
532
+ for (let depth = 0; prototype !== null && depth < MAX_BUFFERED_EVENT_DEPTH; depth += 1) {
533
+ if (prototype === Date.prototype) {
534
+ return 'Date';
535
+ }
536
+ if (!trustedIntrinsicPrototypes.has(prototype)) {
537
+ const constructor = Object.getOwnPropertyDescriptor(prototype, 'constructor');
538
+ if (
539
+ constructor &&
540
+ 'value' in constructor &&
541
+ typeof constructor.value === 'function' &&
542
+ functionToString.call(constructor.value) === nativeDateConstructorSource &&
543
+ getTrustedForeignIntrinsic(prototype)
544
+ ) {
545
+ return 'Date';
546
+ }
547
+ }
548
+
549
+ const descriptor = Object.getOwnPropertyDescriptor(prototype, Symbol.toStringTag);
550
+ if (
551
+ descriptor &&
552
+ 'value' in descriptor &&
553
+ typeof descriptor.value === 'string' &&
554
+ retainedStorageBrands.has(descriptor.value)
555
+ ) {
556
+ return descriptor.value;
557
+ }
558
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
559
+ prototype = Object.getPrototypeOf(prototype) as object | null;
560
+ }
561
+
562
+ return undefined;
563
+ }
564
+
565
+ function estimateRetainedBufferBytes(
566
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Memory accounting inspects arbitrary retained objects and detects native backing storage at runtime.
567
+ current: object,
568
+ visit: (value: unknown, depth: number) => void,
569
+ depth: number,
570
+ ): RetainedStorage | undefined {
571
+ if (ArrayBuffer.isView(current)) {
572
+ let buffer: unknown;
573
+ let kind: RetainedStorage['kind'] = 'typed-array';
574
+
575
+ try {
576
+ // SAFETY: The captured intrinsic getter performs its own receiver brand check; its result stays unknown until the ArrayBuffer validation below.
577
+ buffer = typedArrayBufferGetter?.call(current) as unknown;
578
+ } catch {
579
+ kind = 'data-view';
580
+ // SAFETY: The DataView intrinsic getter performs its receiver brand check; its result stays unknown until the ArrayBuffer validation below.
581
+ buffer = dataViewBufferGetter?.call(current) as unknown;
582
+ }
583
+
584
+ if (typeof buffer !== 'object' || buffer === null) {
585
+ return { bytes: Number.POSITIVE_INFINITY, kind };
586
+ }
587
+
588
+ // Even a one-byte cross-realm view retains its complete backing allocation.
589
+ visit(buffer, depth + 1);
590
+ return { bytes: 0, kind };
591
+ }
592
+
593
+ const brand = getRetainedStorageBrand(current);
594
+ if (!brand) {
595
+ return undefined;
596
+ }
597
+
598
+ // oxlint-disable-next-line anti-slop/no-unknown-returns -- Captured native accessors are checked for a finite numeric result before retained-size accounting.
599
+ let getter: (() => unknown) | undefined;
600
+ const kind: RetainedStorage['kind'] = 'buffer';
601
+ switch (brand) {
602
+ case 'ArrayBuffer': {
603
+ getter = arrayBufferByteLengthGetter;
604
+ break;
605
+ }
606
+ case 'SharedArrayBuffer': {
607
+ getter = sharedArrayBufferByteLengthGetter;
608
+ break;
609
+ }
610
+ case 'Blob':
611
+ case 'File': {
612
+ // Blob slices can retain an arbitrarily larger native backing allocation,
613
+ // and neither browser nor Node exposes its extent or ownership. Detached
614
+ // queues must fail closed; waiting readers bypass retained-size inspection.
615
+ return { bytes: Number.POSITIVE_INFINITY, kind: 'blob' };
616
+ }
617
+ case 'Map': {
618
+ return { bytes: 0, kind: 'map' };
619
+ }
620
+ case 'Date': {
621
+ // oxlint-disable-next-line anti-slop/no-reflect-apply -- Invoke the captured intrinsic without reading its mutable call property.
622
+ Reflect.apply(dateTimestampGetter, current, []);
623
+ return { bytes: 8, kind: 'date' };
624
+ }
625
+ case 'Set': {
626
+ return { bytes: 0, kind: 'set' };
627
+ }
628
+ case 'Headers': {
629
+ return { bytes: 0, kind: 'headers' };
630
+ }
631
+ default: {
632
+ return undefined;
633
+ }
634
+ }
635
+
636
+ const bytes = getter?.call(current);
637
+ return {
638
+ bytes:
639
+ typeof bytes === 'number' && Number.isSafeInteger(bytes) && bytes >= 0
640
+ ? bytes
641
+ : Number.POSITIVE_INFINITY,
642
+ kind,
643
+ };
644
+ }
645
+
646
+ function visitHiddenEventValues(
647
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Native collection contents are inspected only after storage branding, without trusting structural fields.
648
+ current: object,
649
+ kind: RetainedStorage['kind'] | undefined,
650
+ visit: (value: unknown, overhead: number) => boolean,
651
+ ): boolean {
652
+ if (kind === 'map') {
653
+ for (const [key, entry] of mapEntries.call(current)) {
654
+ if (!visit(key, 8) || !visit(entry, 8)) {
655
+ return false;
656
+ }
657
+ }
658
+ }
659
+
660
+ if (kind === 'set') {
661
+ for (const entry of setValues.call(current)) {
662
+ if (!visit(entry, 8)) {
663
+ return false;
664
+ }
665
+ }
666
+ }
667
+
668
+ if (kind === 'headers') {
669
+ if (!headersEntries) {
670
+ return false;
671
+ }
672
+ // SAFETY: The captured native Headers.entries method performs its receiver brand check inside the enclosing try/catch.
673
+ for (const [name, value] of headersEntries.call(current as Headers)) {
674
+ if (!visit(name, 8) || !visit(value, 8)) {
675
+ return false;
676
+ }
677
+ }
678
+ }
679
+
680
+ return true;
681
+ }
682
+
683
+ function getInspectableEventKeys(
684
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Event key inspection must accept arbitrary retained objects, arrays, and native storage views.
685
+ current: object,
686
+ kind: RetainedStorage['kind'] | undefined,
687
+ availableBytes: number,
688
+ ): (string | symbol)[] | undefined {
689
+ if (Array.isArray(current)) {
690
+ const descriptor = Object.getOwnPropertyDescriptor(current, 'length');
691
+ const length: unknown = descriptor && 'value' in descriptor ? descriptor.value : undefined;
692
+ if (
693
+ typeof length !== 'number' ||
694
+ !Number.isSafeInteger(length) ||
695
+ length < 0 ||
696
+ length > Math.floor(availableBytes / 16)
697
+ ) {
698
+ return undefined;
699
+ }
700
+ }
701
+
702
+ if (kind !== 'typed-array') {
703
+ return Reflect.ownKeys(current);
704
+ }
705
+
706
+ const length: unknown = typedArrayLengthGetter?.call(current);
707
+ if (
708
+ typeof length !== 'number' ||
709
+ !Number.isSafeInteger(length) ||
710
+ length < 0 ||
711
+ length > MAX_INSPECTABLE_TYPED_ARRAY_ELEMENTS
712
+ ) {
713
+ return undefined;
714
+ }
715
+
716
+ return Reflect.ownKeys(current).filter((key) => {
717
+ if (typeof key !== 'string') {
718
+ return true;
719
+ }
720
+
721
+ const index = Number(key);
722
+ return !Number.isInteger(index) || index < 0 || index >= length || String(index) !== key;
723
+ });
724
+ }
725
+
726
+ function visitInspectableEventProperties(
727
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Retained event properties are inspected through descriptors on arbitrary object identities.
728
+ current: object,
729
+ kind: RetainedStorage['kind'] | undefined,
730
+ depth: number,
731
+ availableBytes: () => number,
732
+ charge: (bytes: number) => boolean,
733
+ visit: (value: unknown, depth: number, isBlobInternalHandle?: boolean) => void,
734
+ ): boolean {
735
+ const keys = getInspectableEventKeys(current, kind, availableBytes());
736
+ if (keys === undefined) {
737
+ return false;
738
+ }
739
+
740
+ for (const key of keys) {
741
+ if (!charge(typeof key === 'string' ? key.length * 2 + 8 : 8)) {
742
+ return false;
743
+ }
744
+ if (typeof key === 'symbol') {
745
+ visit(key, depth + 1);
746
+ }
747
+
748
+ const descriptor = Object.getOwnPropertyDescriptor(current, key);
749
+ if (!descriptor) {
750
+ return false;
751
+ }
752
+ if (!('value' in descriptor)) {
753
+ if (key === 'stack' && isTrustedNativeErrorStack(current, descriptor)) {
754
+ continue;
755
+ }
756
+ return false;
757
+ }
758
+ visit(descriptor.value, depth + 1, kind === 'blob');
759
+ }
760
+
761
+ return true;
762
+ }
763
+
764
+ function visitRetainedEventPrototypes(
765
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Retention accounting follows arbitrary object prototypes without assuming their properties.
766
+ current: object,
767
+ depth: number,
768
+ isBlobInternalHandle: boolean,
769
+ visited: WeakSet<object>,
770
+ availableBytes: () => number,
771
+ charge: (bytes: number) => boolean,
772
+ visit: (value: unknown, depth: number, isBlobInternalHandle?: boolean) => void,
773
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- The retention callback records prototype identity before inspecting its descriptors.
774
+ retainPrototype: (prototype: object, inspect: () => boolean) => boolean,
775
+ ): boolean {
776
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
777
+ let prototype = Object.getPrototypeOf(current) as object | null;
778
+
779
+ for (let prototypeDepth = depth + 1; prototype !== null; prototypeDepth += 1) {
780
+ if (prototypeDepth >= MAX_BUFFERED_EVENT_DEPTH) {
781
+ return false;
782
+ }
783
+ if (
784
+ trustedIntrinsicPrototypes.has(prototype) ||
785
+ (isBlobInternalHandle && prototype === blobInternalHandlePrototype)
786
+ ) {
787
+ return true;
788
+ }
789
+ if (visited.has(prototype)) {
790
+ visit(prototype, prototypeDepth);
791
+ return availableBytes() >= 0;
792
+ }
793
+
794
+ visited.add(prototype);
795
+ const retainedPrototype = prototype;
796
+ const retained = retainPrototype(retainedPrototype, () => {
797
+ if (!charge(16)) {
798
+ return false;
799
+ }
800
+
801
+ const intrinsic = getTrustedForeignIntrinsic(retainedPrototype);
802
+ if (!intrinsic) {
803
+ return visitInspectableEventProperties(
804
+ retainedPrototype,
805
+ undefined,
806
+ prototypeDepth,
807
+ availableBytes,
808
+ charge,
809
+ visit,
810
+ );
811
+ }
812
+
813
+ for (const key of Reflect.ownKeys(retainedPrototype)) {
814
+ const descriptor = Object.getOwnPropertyDescriptor(retainedPrototype, key);
815
+ if (!descriptor) {
816
+ return false;
817
+ }
818
+ if (
819
+ isCanonicalIntrinsicDescriptor(
820
+ descriptor,
821
+ intrinsic.descriptors.get(key),
822
+ intrinsic.functionPrototype,
823
+ )
824
+ ) {
825
+ continue;
826
+ }
827
+ if (!charge(typeof key === 'string' ? key.length * 2 + 8 : 8) || !('value' in descriptor)) {
828
+ return false;
829
+ }
830
+ if (typeof key === 'symbol') {
831
+ visit(key, prototypeDepth + 1);
832
+ }
833
+ visit(descriptor.value, prototypeDepth + 1);
834
+ }
835
+
836
+ return availableBytes() >= 0;
837
+ });
838
+ if (!retained) {
839
+ return false;
840
+ }
841
+
842
+ // SAFETY: Object.getPrototypeOf returns an object or null; this native-prototype inspection does not assume an application-specific instance type.
843
+ prototype = Object.getPrototypeOf(retainedPrototype) as object | null;
844
+ }
845
+
846
+ return true;
847
+ }
848
+
849
+ type BufferedRetainedIdentity = object | symbol;
850
+
851
+ type BufferedInspectedNode = {
852
+ bytes: number;
853
+ edges: Set<BufferedRetainedIdentity>;
854
+ };
855
+
856
+ type BufferedInspectedGraph = {
857
+ scalarBytes: number;
858
+ roots: Set<BufferedRetainedIdentity>;
859
+ nodes: Map<BufferedRetainedIdentity, BufferedInspectedNode>;
860
+ };
861
+
862
+ type BufferedLedgerEntry = {
863
+ scalarBytes: number;
864
+ roots: Set<BufferedRetainedIdentity>;
865
+ identities: Set<BufferedRetainedIdentity>;
866
+ };
867
+
868
+ type BufferedLedgerRecord = BufferedInspectedNode & {
869
+ owners: Set<BufferedLedgerEntry>;
870
+ };
871
+
872
+ type BufferedLedgerChange = {
873
+ node: BufferedInspectedNode;
874
+ ownerDelta: number;
875
+ };
876
+
877
+ const BUFFERED_LEDGER_ENTRY_BYTES = 32;
878
+ const BUFFERED_LEDGER_NODE_BYTES = 32;
879
+ const BUFFERED_LEDGER_EDGE_BYTES = 8;
880
+ const BUFFERED_LEDGER_OWNER_BYTES = 16;
881
+ const MAX_BUFFERED_LEDGER_RECONCILIATION_WORK = 128 * 1024;
882
+
883
+ function inspectBufferedEventGraph(
884
+ value: unknown,
885
+ remainingBytes: number,
886
+ ): BufferedInspectedGraph | undefined {
887
+ let bytes = 0;
888
+ let scalarBytes = 0;
889
+ const visited = new WeakSet<object>();
890
+ const visitedSymbols = new Set<symbol>();
891
+ const roots = new Set<BufferedRetainedIdentity>();
892
+ const nodes = new Map<BufferedRetainedIdentity, BufferedInspectedNode>();
893
+ let activeNode: BufferedInspectedNode | undefined;
894
+ const availableBytes = (): number => remainingBytes - bytes;
895
+ const charge = (amount: number): boolean => {
896
+ if (!Number.isSafeInteger(amount) || amount < 0) {
897
+ bytes = remainingBytes + 1;
898
+ return false;
899
+ }
900
+
901
+ bytes += amount;
902
+ if (activeNode) {
903
+ activeNode.bytes += amount;
904
+ } else {
905
+ scalarBytes += amount;
906
+ }
907
+ return bytes <= remainingBytes;
908
+ };
909
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- The ledger records object and symbol identities, which have no shared structural contract.
910
+ const addIdentity = (identity: BufferedRetainedIdentity): void => {
911
+ if (activeNode) {
912
+ activeNode.edges.add(identity);
913
+ } else {
914
+ roots.add(identity);
915
+ }
916
+ };
917
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Retained graph nodes are identified by object or symbol identity independently of their fields.
918
+ const retainIdentity = (identity: BufferedRetainedIdentity, inspect: () => boolean): boolean => {
919
+ addIdentity(identity);
920
+ const node: BufferedInspectedNode = { bytes: 0, edges: new Set() };
921
+ nodes.set(identity, node);
922
+ const previous = activeNode;
923
+ activeNode = node;
924
+ try {
925
+ return inspect();
926
+ } finally {
927
+ activeNode = previous;
928
+ }
929
+ };
930
+
931
+ const visitSymbol = (current: symbol): void => {
932
+ if (visitedSymbols.has(current)) {
933
+ addIdentity(current);
934
+ charge(8);
935
+ return;
936
+ }
937
+ visitedSymbols.add(current);
938
+
939
+ if (
940
+ !retainIdentity(current, () => {
941
+ if (!symbolDescriptionGetter) {
942
+ return false;
943
+ }
944
+ // SAFETY: The captured Symbol description getter is called after the symbol branch and returns a string or undefined by its native contract.
945
+ // oxlint-disable-next-line anti-slop/no-reflect-apply -- Invoke the captured intrinsic without reading its mutable call property.
946
+ const description = Reflect.apply(symbolDescriptionGetter, current, []) as string | undefined;
947
+ return charge(8 + (description?.length ?? 0) * 2);
948
+ })
949
+ ) {
950
+ bytes = remainingBytes + 1;
951
+ }
952
+ };
953
+
954
+ const visit = (current: unknown, depth: number, isBlobInternalHandle = false): void => {
955
+ if (bytes > remainingBytes) {
956
+ return;
957
+ }
958
+
959
+ if (typeof current === 'string') {
960
+ charge(current.length * 2);
961
+ return;
962
+ }
963
+
964
+ if (typeof current === 'symbol') {
965
+ visitSymbol(current);
966
+ return;
967
+ }
968
+
969
+ if (typeof current === 'function') {
970
+ bytes = remainingBytes + 1;
971
+ return;
972
+ }
973
+
974
+ if (current === null || typeof current !== 'object') {
975
+ charge(8);
976
+ return;
977
+ }
978
+
979
+ if (nativeProxyDetector?.(current)) {
980
+ bytes = remainingBytes + 1;
981
+ return;
982
+ }
983
+
984
+ if (depth >= MAX_BUFFERED_EVENT_DEPTH) {
985
+ bytes = remainingBytes + 1;
986
+ return;
987
+ }
988
+
989
+ if (visited.has(current)) {
990
+ addIdentity(current);
991
+ charge(8);
992
+ return;
993
+ }
994
+ visited.add(current);
995
+
996
+ if (
997
+ !retainIdentity(current, () => {
998
+ if (!charge(16)) {
999
+ return false;
1000
+ }
1001
+
1002
+ const retainedStorage = estimateRetainedBufferBytes(current, visit, depth);
1003
+ if (
1004
+ !visitRetainedEventPrototypes(
1005
+ current,
1006
+ depth,
1007
+ isBlobInternalHandle,
1008
+ visited,
1009
+ availableBytes,
1010
+ charge,
1011
+ visit,
1012
+ retainIdentity,
1013
+ )
1014
+ ) {
1015
+ return false;
1016
+ }
1017
+ if (retainedStorage !== undefined && !charge(retainedStorage.bytes)) {
1018
+ return false;
1019
+ }
1020
+
1021
+ if (
1022
+ !visitHiddenEventValues(current, retainedStorage?.kind, (hiddenValue, overhead) => {
1023
+ if (!charge(overhead)) {
1024
+ return false;
1025
+ }
1026
+ visit(hiddenValue, depth + 1);
1027
+ return bytes <= remainingBytes;
1028
+ })
1029
+ ) {
1030
+ return false;
1031
+ }
1032
+
1033
+ return visitInspectableEventProperties(
1034
+ current,
1035
+ retainedStorage?.kind,
1036
+ depth,
1037
+ availableBytes,
1038
+ charge,
1039
+ visit,
1040
+ );
1041
+ })
1042
+ ) {
1043
+ bytes = remainingBytes + 1;
1044
+ }
1045
+ };
1046
+
1047
+ try {
1048
+ visit(value, 0);
1049
+ } catch {
1050
+ return undefined;
1051
+ }
1052
+
1053
+ return bytes <= remainingBytes ? { scalarBytes, roots, nodes } : undefined;
1054
+ }
1055
+
1056
+ function areBufferedRetainedEdgesEqual(
1057
+ first: Set<BufferedRetainedIdentity>,
1058
+ second: Set<BufferedRetainedIdentity>,
1059
+ ): boolean {
1060
+ if (first.size !== second.size) {
1061
+ return false;
1062
+ }
1063
+ for (const identity of first) {
1064
+ if (!second.has(identity)) {
1065
+ return false;
1066
+ }
1067
+ }
1068
+ return true;
1069
+ }
1070
+
1071
+ function getBufferedLedgerNodeBytes(node: BufferedInspectedNode, owners: number): number {
1072
+ return (
1073
+ node.bytes +
1074
+ BUFFERED_LEDGER_NODE_BYTES +
1075
+ node.edges.size * BUFFERED_LEDGER_EDGE_BYTES +
1076
+ owners * BUFFERED_LEDGER_OWNER_BYTES
1077
+ );
1078
+ }
1079
+
1080
+ function getBufferedLedgerEntryBytes(entry: Pick<BufferedLedgerEntry, 'scalarBytes' | 'roots'>): number {
1081
+ return BUFFERED_LEDGER_ENTRY_BYTES + entry.scalarBytes + entry.roots.size * BUFFERED_LEDGER_EDGE_BYTES;
1082
+ }
1083
+
1084
+ function collectBufferedLedgerIdentities(
1085
+ roots: Set<BufferedRetainedIdentity>,
1086
+ candidate: Map<BufferedRetainedIdentity, BufferedInspectedNode>,
1087
+ records: Map<BufferedRetainedIdentity, BufferedLedgerRecord>,
1088
+ work: { remaining: number },
1089
+ ): Set<BufferedRetainedIdentity> | undefined {
1090
+ const identities = new Set<BufferedRetainedIdentity>();
1091
+ const pending = [...roots];
1092
+
1093
+ while (pending.length) {
1094
+ work.remaining -= 1;
1095
+ if (work.remaining < 0) {
1096
+ return undefined;
1097
+ }
1098
+
1099
+ const identity = pending.pop()!;
1100
+ if (identities.has(identity)) {
1101
+ continue;
1102
+ }
1103
+ const node = candidate.get(identity) ?? records.get(identity);
1104
+ if (!node) {
1105
+ return undefined;
1106
+ }
1107
+ identities.add(identity);
1108
+ for (const edge of node.edges) {
1109
+ pending.push(edge);
1110
+ }
1111
+ }
1112
+
1113
+ return identities;
1114
+ }
1115
+
1116
+ function getBufferedLedgerChange(
1117
+ // oxlint-disable-next-line anti-slop/no-object-parameters -- Ledger changes are keyed by object or symbol identity, not a structural event type.
1118
+ identity: BufferedRetainedIdentity,
1119
+ graph: BufferedInspectedGraph,
1120
+ records: Map<BufferedRetainedIdentity, BufferedLedgerRecord>,
1121
+ changes: Map<BufferedRetainedIdentity, BufferedLedgerChange>,
1122
+ node?: BufferedInspectedNode,
1123
+ ): BufferedLedgerChange | undefined {
1124
+ const existing = changes.get(identity);
1125
+ if (existing) {
1126
+ if (node) {
1127
+ existing.node = node;
1128
+ }
1129
+ return existing;
1130
+ }
1131
+
1132
+ const current = node ?? graph.nodes.get(identity) ?? records.get(identity);
1133
+ if (!current) {
1134
+ return undefined;
1135
+ }
1136
+ const update = { node: current, ownerDelta: 0 };
1137
+ changes.set(identity, update);
1138
+ return update;
1139
+ }
1140
+
1141
+ function findBufferedLedgerAffectedOwners(
1142
+ entry: BufferedLedgerEntry,
1143
+ graph: BufferedInspectedGraph,
1144
+ records: Map<BufferedRetainedIdentity, BufferedLedgerRecord>,
1145
+ changes: Map<BufferedRetainedIdentity, BufferedLedgerChange>,
1146
+ work: { remaining: number },
1147
+ ): Set<BufferedLedgerEntry> | undefined {
1148
+ const affected = new Set<BufferedLedgerEntry>([entry]);
1149
+
1150
+ for (const [identity, node] of graph.nodes) {
1151
+ work.remaining -= 1;
1152
+ if (work.remaining < 0) {
1153
+ return undefined;
1154
+ }
1155
+
1156
+ const previous = records.get(identity);
1157
+ if (!previous) {
1158
+ continue;
1159
+ }
1160
+ const changedEdges = !areBufferedRetainedEdgesEqual(previous.edges, node.edges);
1161
+ if (previous.bytes !== node.bytes || changedEdges) {
1162
+ getBufferedLedgerChange(identity, graph, records, changes, node);
1163
+ }
1164
+ if (!changedEdges) {
1165
+ continue;
1166
+ }
1167
+ for (const owner of previous.owners) {
1168
+ work.remaining -= 1;
1169
+ if (work.remaining < 0) {
1170
+ return undefined;
1171
+ }
1172
+ affected.add(owner);
1173
+ }
1174
+ }
1175
+
1176
+ return affected;
1177
+ }
1178
+
1179
+ function updateBufferedLedgerMembershipChanges(
1180
+ owner: BufferedLedgerEntry,
1181
+ next: Set<BufferedRetainedIdentity>,
1182
+ graph: BufferedInspectedGraph,
1183
+ records: Map<BufferedRetainedIdentity, BufferedLedgerRecord>,
1184
+ changes: Map<BufferedRetainedIdentity, BufferedLedgerChange>,
1185
+ work: { remaining: number },
1186
+ ): boolean {
1187
+ for (const identity of owner.identities) {
1188
+ work.remaining -= 1;
1189
+ if (work.remaining < 0) {
1190
+ return false;
1191
+ }
1192
+ if (!next.has(identity)) {
1193
+ const update = getBufferedLedgerChange(identity, graph, records, changes);
1194
+ if (!update) {
1195
+ return false;
1196
+ }
1197
+ update.ownerDelta -= 1;
1198
+ }
1199
+ }
1200
+
1201
+ for (const identity of next) {
1202
+ work.remaining -= 1;
1203
+ if (work.remaining < 0) {
1204
+ return false;
1205
+ }
1206
+ if (!owner.identities.has(identity)) {
1207
+ const update = getBufferedLedgerChange(identity, graph, records, changes);
1208
+ if (!update) {
1209
+ return false;
1210
+ }
1211
+ update.ownerDelta += 1;
1212
+ }
1213
+ }
1214
+
1215
+ return true;
1216
+ }
1217
+
1218
+ function collectBufferedLedgerMemberships(
1219
+ entry: BufferedLedgerEntry,
1220
+ graph: BufferedInspectedGraph,
1221
+ affected: Set<BufferedLedgerEntry>,
1222
+ records: Map<BufferedRetainedIdentity, BufferedLedgerRecord>,
1223
+ changes: Map<BufferedRetainedIdentity, BufferedLedgerChange>,
1224
+ work: { remaining: number },
1225
+ ): Map<BufferedLedgerEntry, Set<BufferedRetainedIdentity>> | undefined {
1226
+ const memberships = new Map<BufferedLedgerEntry, Set<BufferedRetainedIdentity>>();
1227
+
1228
+ for (const owner of affected) {
1229
+ const roots = owner === entry ? graph.roots : owner.roots;
1230
+ const next = collectBufferedLedgerIdentities(roots, graph.nodes, records, work);
1231
+ if (!next || !updateBufferedLedgerMembershipChanges(owner, next, graph, records, changes, work)) {
1232
+ return undefined;
1233
+ }
1234
+ memberships.set(owner, next);
1235
+ }
1236
+
1237
+ return memberships;
1238
+ }
1239
+
1240
+ function projectBufferedLedgerBytes(
1241
+ currentBytes: number,
1242
+ entry: BufferedLedgerEntry,
1243
+ graph: BufferedInspectedGraph,
1244
+ isNew: boolean,
1245
+ changes: Map<BufferedRetainedIdentity, BufferedLedgerChange>,
1246
+ records: Map<BufferedRetainedIdentity, BufferedLedgerRecord>,
1247
+ ): number | undefined {
1248
+ let projected =
1249
+ currentBytes - (isNew ? 0 : getBufferedLedgerEntryBytes(entry)) + getBufferedLedgerEntryBytes(graph);
1250
+
1251
+ for (const [identity, update] of changes) {
1252
+ const previous = records.get(identity);
1253
+ const owners = (previous?.owners.size ?? 0) + update.ownerDelta;
1254
+ if (owners < 0) {
1255
+ return undefined;
1256
+ }
1257
+ if (previous) {
1258
+ projected -= getBufferedLedgerNodeBytes(previous, previous.owners.size);
1259
+ }
1260
+ if (owners) {
1261
+ projected += getBufferedLedgerNodeBytes(update.node, owners);
1262
+ }
1263
+ }
1264
+
1265
+ return Number.isSafeInteger(projected) && projected >= 0 && projected <= MAX_BUFFERED_ITERATOR_BYTES
1266
+ ? projected
1267
+ : undefined;
1268
+ }
1269
+
1270
+ function applyBufferedLedgerChanges(
1271
+ records: Map<BufferedRetainedIdentity, BufferedLedgerRecord>,
1272
+ changes: Map<BufferedRetainedIdentity, BufferedLedgerChange>,
1273
+ memberships: Map<BufferedLedgerEntry, Set<BufferedRetainedIdentity>>,
1274
+ ): void {
1275
+ for (const [identity, update] of changes) {
1276
+ const previous = records.get(identity);
1277
+ const owners = (previous?.owners.size ?? 0) + update.ownerDelta;
1278
+ if (!owners) {
1279
+ continue;
1280
+ }
1281
+ if (previous) {
1282
+ previous.bytes = update.node.bytes;
1283
+ previous.edges = update.node.edges;
1284
+ } else {
1285
+ records.set(identity, {
1286
+ bytes: update.node.bytes,
1287
+ edges: update.node.edges,
1288
+ owners: new Set(),
1289
+ });
1290
+ }
1291
+ }
1292
+
1293
+ for (const [owner, next] of memberships) {
1294
+ for (const identity of owner.identities) {
1295
+ if (!next.has(identity)) {
1296
+ records.get(identity)?.owners.delete(owner);
1297
+ }
1298
+ }
1299
+ for (const identity of next) {
1300
+ if (!owner.identities.has(identity)) {
1301
+ records.get(identity)!.owners.add(owner);
1302
+ }
1303
+ }
1304
+ owner.identities = next;
1305
+ }
1306
+
1307
+ for (const identity of changes.keys()) {
1308
+ if (records.get(identity)?.owners.size === 0) {
1309
+ records.delete(identity);
1310
+ }
1311
+ }
1312
+ }
1313
+
1314
+ /**
1315
+ * Account for queue-owned identities once while charging bounded ownership and
1316
+ * edge metadata. Shared topology changes are reconciled for every queued owner.
1317
+ */
1318
+ function createBufferedEventLedger(): {
1319
+ retain: (graph: BufferedInspectedGraph) => BufferedLedgerEntry | undefined;
1320
+ refresh: (entry: BufferedLedgerEntry, graph: BufferedInspectedGraph) => boolean;
1321
+ release: (entry: BufferedLedgerEntry) => void;
1322
+ clear: () => void;
1323
+ } {
1324
+ const records = new Map<BufferedRetainedIdentity, BufferedLedgerRecord>();
1325
+ let bytes = 0;
1326
+
1327
+ const reconcile = (entry: BufferedLedgerEntry, graph: BufferedInspectedGraph, isNew: boolean): boolean => {
1328
+ const work = { remaining: MAX_BUFFERED_LEDGER_RECONCILIATION_WORK };
1329
+ const changes = new Map<BufferedRetainedIdentity, BufferedLedgerChange>();
1330
+ const affected = findBufferedLedgerAffectedOwners(entry, graph, records, changes, work);
1331
+ if (!affected) {
1332
+ return false;
1333
+ }
1334
+ const memberships = collectBufferedLedgerMemberships(entry, graph, affected, records, changes, work);
1335
+ if (!memberships) {
1336
+ return false;
1337
+ }
1338
+ const projectedBytes = projectBufferedLedgerBytes(bytes, entry, graph, isNew, changes, records);
1339
+ if (projectedBytes === undefined) {
1340
+ return false;
1341
+ }
1342
+
1343
+ applyBufferedLedgerChanges(records, changes, memberships);
1344
+ entry.scalarBytes = graph.scalarBytes;
1345
+ entry.roots = graph.roots;
1346
+ bytes = projectedBytes;
1347
+ return true;
1348
+ };
1349
+
1350
+ const release = (entry: BufferedLedgerEntry): void => {
1351
+ bytes -= getBufferedLedgerEntryBytes(entry);
1352
+ for (const identity of entry.identities) {
1353
+ const record = records.get(identity);
1354
+ if (!record?.owners.delete(entry)) {
1355
+ continue;
1356
+ }
1357
+ bytes -= BUFFERED_LEDGER_OWNER_BYTES;
1358
+ if (record.owners.size === 0) {
1359
+ bytes -= getBufferedLedgerNodeBytes(record, 0);
1360
+ records.delete(identity);
1361
+ }
1362
+ }
1363
+ entry.identities.clear();
1364
+ };
1365
+
1366
+ // oxlint-disable-next-line anti-slop/no-known-value-widening -- The ledger contract contextually types its callbacks and keeps retained-identity internals private.
1367
+ return {
1368
+ retain(graph) {
1369
+ const entry: BufferedLedgerEntry = { scalarBytes: 0, roots: new Set(), identities: new Set() };
1370
+ return reconcile(entry, graph, true) ? entry : undefined;
1371
+ },
1372
+ refresh(entry, graph) {
1373
+ return reconcile(entry, graph, false);
1374
+ },
1375
+ release,
1376
+ clear() {
1377
+ records.clear();
1378
+ bytes = 0;
1379
+ },
1380
+ };
1381
+ }
1382
+
1383
+ /** An abortable event stream with typed listeners, asynchronous iteration, and lifecycle state. */
3
1384
  export class EventStream<EventTypes extends BaseEvents> {
1385
+ /** Controls the underlying request; aborting this controller cancels the stream. */
4
1386
  controller: AbortController = new AbortController();
5
1387
 
6
1388
  #connectedPromise: Promise<void>;
7
- #resolveConnectedPromise: () => void = () => {};
8
- #rejectConnectedPromise: (error: OpenAIError) => void = () => {};
1389
+ // oxlint-disable class-methods-use-this -- Deferred promise resolvers are intentionally per-instance mutable callbacks.
1390
+ #resolveConnectedPromise: () => void = () => undefined;
1391
+ #rejectConnectedPromise: (error: OpenAIError) => void = () => undefined;
9
1392
 
10
1393
  #endPromise: Promise<void>;
11
- #resolveEndPromise: () => void = () => {};
12
- #rejectEndPromise: (error: OpenAIError) => void = () => {};
1394
+ #resolveEndPromise: () => void = () => undefined;
1395
+ #rejectEndPromise: (error: OpenAIError) => void = () => undefined;
1396
+ // oxlint-enable class-methods-use-this
13
1397
 
14
1398
  #listeners: {
15
1399
  [Event in keyof EventTypes]?: EventListeners<EventTypes, Event>;
16
- } = {};
1400
+ } = Object.create(null);
1401
+ #abortListeners: { signal: AbortSignal; listener: () => void }[] = [];
1402
+ #emittedListenerRegistrations = new WeakMap<
1403
+ object,
1404
+ { event: PropertyKey; registration: { removed?: boolean; detached?: boolean } }
1405
+ >();
1406
+ #pendingListenerCleanup = new Set<PropertyKey>();
1407
+ #pendingBufferedEventChecks = new Set<() => void>();
1408
+ #listenerDispatchDepth = 0;
17
1409
 
18
1410
  #ended = false;
19
1411
  #errored = false;
20
1412
  #aborted = false;
21
1413
  #catchingPromiseCreated = false;
1414
+ // Terminal failure recorded during settlement, before `end` is emitted, so
1415
+ // iterators can surface it even when a throwing user listener prevented
1416
+ // their internal failure listeners from running.
1417
+ #terminalFailure: { kind: 'error' | 'abort'; error: OpenAIError } | undefined;
22
1418
 
1419
+ /** Creates an unstarted stream with independent connection and completion lifecycle promises. */
23
1420
  constructor() {
24
1421
  this.#connectedPromise = new Promise<void>((resolve, reject) => {
25
1422
  this.#resolveConnectedPromise = resolve;
@@ -35,53 +1432,120 @@ export class EventStream<EventTypes extends BaseEvents> {
35
1432
  // we will manually cause an unhandled rejection error later
36
1433
  // if the user hasn't registered any error listener or called
37
1434
  // any promise-returning method.
38
- this.#connectedPromise.catch(() => {});
39
- this.#endPromise.catch(() => {});
1435
+ this.#connectedPromise.catch(() => undefined);
1436
+ this.#endPromise.catch(() => undefined);
40
1437
  }
41
1438
 
42
1439
  protected _run(this: EventStream<EventTypes>, executor: () => Promise<any>) {
43
1440
  // Unfortunately if we call `executor()` immediately we get runtime errors about
44
1441
  // references to `this` before the `super()` constructor call returns.
45
1442
  setTimeout(() => {
46
- executor().then(() => {
47
- this._emitFinal();
48
- this._emit('end');
49
- }, this.#handleError.bind(this));
1443
+ let failed = false;
1444
+
1445
+ Promise.resolve()
1446
+ .then(executor)
1447
+ .catch((error) => {
1448
+ failed = true;
1449
+ this.#handleError(error);
1450
+ })
1451
+ .then(() => {
1452
+ if (failed) {
1453
+ return;
1454
+ }
1455
+
1456
+ try {
1457
+ this._emitFinal();
1458
+ } catch (error) {
1459
+ this.#handleError(error);
1460
+ return;
1461
+ }
1462
+ this._emit('end');
1463
+ });
50
1464
  }, 0);
51
1465
  }
52
1466
 
53
1467
  protected _connected(this: EventStream<EventTypes>) {
54
- if (this.ended) return;
1468
+ if (this.ended) {
1469
+ return;
1470
+ }
55
1471
  this.#resolveConnectedPromise();
56
1472
  this._emit('connect');
57
1473
  }
58
1474
 
1475
+ /** Whether the stream has finished successfully, failed, or been aborted. */
59
1476
  get ended(): boolean {
60
1477
  return this.#ended;
61
1478
  }
62
1479
 
1480
+ /** Whether an error or user cancellation has been observed. */
63
1481
  get errored(): boolean {
64
1482
  return this.#errored;
65
1483
  }
66
1484
 
1485
+ /** Whether the stream ended because its request was cancelled. */
67
1486
  get aborted(): boolean {
68
1487
  return this.#aborted;
69
1488
  }
70
1489
 
1490
+ /**
1491
+ * Cancels the underlying request; {@link done} and {@link events} observe cancellation.
1492
+ * Promises returned by {@link emitted} for other events may remain pending.
1493
+ */
71
1494
  abort() {
72
1495
  this.controller.abort();
73
1496
  }
74
1497
 
1498
+ /** Creates a user-abort error retaining this runner's cancellation reason. */
1499
+ protected _userAbortError(): APIUserAbortError {
1500
+ const error = new APIUserAbortError();
1501
+ Object.defineProperty(error, 'cause', {
1502
+ value: this.controller.signal.reason,
1503
+ writable: true,
1504
+ configurable: true,
1505
+ });
1506
+ return error;
1507
+ }
1508
+
1509
+ #abortFromSignal(signal: AbortSignal) {
1510
+ try {
1511
+ this.controller.abort(signal.reason);
1512
+ } catch {
1513
+ this.controller.abort();
1514
+ }
1515
+ }
1516
+
1517
+ protected _listenForAbort(signal: AbortSignal | null | undefined) {
1518
+ if (!signal || this.ended) {
1519
+ return;
1520
+ }
1521
+ if (signal.aborted) {
1522
+ this.#abortFromSignal(signal);
1523
+ return;
1524
+ }
1525
+ if (this.#abortListeners.some((registration) => registration.signal === signal)) {
1526
+ return;
1527
+ }
1528
+
1529
+ const listener = () => this.#abortFromSignal(signal);
1530
+ signal.addEventListener('abort', listener, { once: true });
1531
+ this.#abortListeners.push({ signal, listener });
1532
+ }
1533
+
1534
+ #removeAbortListeners() {
1535
+ for (const { signal, listener } of this.#abortListeners.splice(0)) {
1536
+ signal.removeEventListener('abort', listener);
1537
+ }
1538
+ }
1539
+
75
1540
  /**
76
1541
  * Adds the listener function to the end of the listeners array for the event.
77
1542
  * No checks are made to see if the listener has already been added. Multiple calls passing
78
1543
  * the same combination of event and listener will result in the listener being added, and
79
1544
  * called, multiple times.
80
- * @returns this ChatCompletionStream, so that calls can be chained
1545
+ * @returns This stream, so that listener registration calls can be chained.
81
1546
  */
82
1547
  on<Event extends keyof EventTypes>(event: Event, listener: EventListener<EventTypes, Event>): this {
83
- const listeners: EventListeners<EventTypes, Event> =
84
- this.#listeners[event] || (this.#listeners[event] = []);
1548
+ const listeners: EventListeners<EventTypes, Event> = (this.#listeners[event] ||= []);
85
1549
  listeners.push({ listener });
86
1550
  return this;
87
1551
  }
@@ -91,34 +1555,105 @@ export class EventStream<EventTypes extends BaseEvents> {
91
1555
  * off() will remove, at most, one instance of a listener from the listener array. If any single
92
1556
  * listener has been added multiple times to the listener array for the specified event, then
93
1557
  * off() must be called multiple times to remove each instance.
94
- * @returns this ChatCompletionStream, so that calls can be chained
1558
+ * @returns This stream, so that listener registration calls can be chained.
95
1559
  */
96
1560
  off<Event extends keyof EventTypes>(event: Event, listener: EventListener<EventTypes, Event>): this {
97
1561
  const listeners = this.#listeners[event];
98
- if (!listeners) return this;
99
- const index = listeners.findIndex((l) => l.listener === listener);
100
- if (index >= 0) listeners.splice(index, 1);
1562
+ if (!listeners) {
1563
+ return this;
1564
+ }
1565
+
1566
+ // SAFETY: Listener functions are object identities used as WeakMap keys; registration and removal use the same function instance.
1567
+ const emittedRegistration = this.#emittedListenerRegistrations.get(listener as object);
1568
+ if (
1569
+ emittedRegistration?.event === event &&
1570
+ !emittedRegistration.registration.removed &&
1571
+ !emittedRegistration.registration.detached
1572
+ ) {
1573
+ // SAFETY: The stored registration event was compared with this event above, preserving the event/listener type correlation.
1574
+ this.#removeEmittedListener(
1575
+ event,
1576
+ emittedRegistration.registration as EventListeners<EventTypes, Event>[number],
1577
+ );
1578
+ return this;
1579
+ }
1580
+
1581
+ const index = listeners.findIndex((l) => !l.removed && l.listener === listener);
1582
+ if (index !== -1) {
1583
+ listeners.splice(index, 1);
1584
+ }
101
1585
  return this;
102
1586
  }
103
1587
 
104
1588
  /**
105
1589
  * Adds a one-time listener function for the event. The next time the event is triggered,
106
1590
  * this listener is removed and then invoked.
107
- * @returns this ChatCompletionStream, so that calls can be chained
1591
+ * @returns This stream, so that listener registration calls can be chained.
108
1592
  */
109
1593
  once<Event extends keyof EventTypes>(event: Event, listener: EventListener<EventTypes, Event>): this {
110
- const listeners: EventListeners<EventTypes, Event> =
111
- this.#listeners[event] || (this.#listeners[event] = []);
1594
+ const listeners: EventListeners<EventTypes, Event> = (this.#listeners[event] ||= []);
112
1595
  listeners.push({ listener, once: true });
113
1596
  return this;
114
1597
  }
115
1598
 
1599
+ #onceForEmitted<Event extends keyof EventTypes>(
1600
+ event: Event,
1601
+ listener: EventListener<EventTypes, Event>,
1602
+ ): void {
1603
+ const previousListeners = this.#listeners[event];
1604
+ const previousLength = previousListeners?.length ?? 0;
1605
+ this.once(event, listener);
1606
+ const listeners = this.#listeners[event];
1607
+ const [registration] = listeners?.slice(-1) ?? [];
1608
+ if (
1609
+ (previousListeners === undefined || listeners === previousListeners) &&
1610
+ listeners?.length === previousLength + 1 &&
1611
+ registration?.listener === listener &&
1612
+ registration.once
1613
+ ) {
1614
+ // SAFETY: Listener functions are object identities used as WeakMap keys; registration and removal use the same function instance.
1615
+ this.#emittedListenerRegistrations.set(listener as object, { event, registration });
1616
+ }
1617
+ }
1618
+
1619
+ #removeEmittedListener<Event extends keyof EventTypes>(
1620
+ event: Event,
1621
+ registration: EventListeners<EventTypes, Event>[number],
1622
+ ): void {
1623
+ if (registration.removed) {
1624
+ return;
1625
+ }
1626
+
1627
+ registration.removed = true;
1628
+ // SAFETY: Listener functions are object identities used as WeakMap keys; registration and removal use the same function instance.
1629
+ this.#emittedListenerRegistrations.delete(registration.listener as object);
1630
+ this.#pendingListenerCleanup.add(event);
1631
+ if (this.#listenerDispatchDepth === 0) {
1632
+ this.#cleanupEmittedListeners();
1633
+ }
1634
+ }
1635
+
1636
+ #cleanupEmittedListeners(): void {
1637
+ for (const event of this.#pendingListenerCleanup) {
1638
+ // SAFETY: Pending cleanup keys are added only from registered EventTypes events; the key retains its event-map membership.
1639
+ const eventType = event as keyof EventTypes;
1640
+ const listeners = this.#listeners[eventType];
1641
+ if (listeners) {
1642
+ // SAFETY: Filtering only removes registrations from the same event bucket and preserves the listener signatures for that event.
1643
+ this.#listeners[eventType] = listeners.filter((listener) => !listener.removed) as any;
1644
+ }
1645
+ }
1646
+ this.#pendingListenerCleanup.clear();
1647
+ }
1648
+
116
1649
  /**
117
1650
  * This is similar to `.once()`, but returns a Promise that resolves the next time
118
1651
  * the event is triggered, instead of calling a listener callback.
119
- * @returns a Promise that resolves the next time given event is triggered,
120
- * or rejects if an error is emitted. (If you request the 'error' event,
121
- * returns a promise that resolves with the error).
1652
+ * Events without arguments resolve to `undefined`, single-argument events resolve
1653
+ * to that argument, and events with multiple arguments resolve to an argument tuple.
1654
+ *
1655
+ * @returns A promise for the next event, or a rejection if an error occurs first.
1656
+ * Requesting the `error` event resolves with the emitted error instead.
122
1657
  *
123
1658
  * Example:
124
1659
  *
@@ -126,18 +1661,319 @@ export class EventStream<EventTypes extends BaseEvents> {
126
1661
  */
127
1662
  emitted<Event extends keyof EventTypes>(
128
1663
  event: Event,
129
- ): Promise<
130
- EventParameters<EventTypes, Event> extends [infer Param] ? Param
131
- : EventParameters<EventTypes, Event> extends [] ? void
132
- : EventParameters<EventTypes, Event>
133
- > {
1664
+ ): Promise<EmittedEventResult<EventParameters<EventTypes, Event>>> {
134
1665
  return new Promise((resolve, reject) => {
135
1666
  this.#catchingPromiseCreated = true;
136
- if (event !== 'error') this.once('error', reject);
137
- this.once(event, resolve as any);
1667
+ const onError = (error: OpenAIError) => {
1668
+ // SAFETY: This callback is paired with the same event when registered and removed; its variadic body forwards the event tuple or captured error.
1669
+ this.off(event, onEvent as EventListener<EventTypes, Event>);
1670
+ reject(error);
1671
+ };
1672
+ const onEvent = (...values: unknown[]) => {
1673
+ if (event !== 'error') {
1674
+ this.off('error', onError);
1675
+ }
1676
+ // SAFETY: The emitted API returns the sole argument or the full tuple according to its existing EventTypes-dependent result contract.
1677
+ resolve((values.length > 1 ? values : values[0]) as any);
1678
+ };
1679
+
1680
+ if (event !== 'error') {
1681
+ // SAFETY: This callback is paired with the same event when registered and removed; its variadic body forwards the event tuple or captured error.
1682
+ this.#onceForEmitted('error', onError as EventListener<EventTypes, 'error'>);
1683
+ }
1684
+ // SAFETY: This callback is paired with the same event when registered and removed; its variadic body forwards the event tuple or captured error.
1685
+ this.#onceForEmitted(event, onEvent as EventListener<EventTypes, Event>);
138
1686
  });
139
1687
  }
140
1688
 
1689
+ /**
1690
+ * Returns an async iterator that yields every time the event is triggered.
1691
+ * The iterator ends when the stream ends and rejects if the stream errors
1692
+ * or is aborted. If you request the 'error' or 'abort' event, the iterator
1693
+ * yields that event instead of rejecting.
1694
+ *
1695
+ * Example:
1696
+ *
1697
+ * for await (const [message] of stream.events('message')) {
1698
+ * await processMessage(message);
1699
+ * }
1700
+ */
1701
+ events<Event extends keyof EventTypes>(
1702
+ event: Event,
1703
+ ): AsyncIterableIterator<EventParameters<EventTypes, Event>> {
1704
+ type Parameters = EventParameters<EventTypes, Event>;
1705
+ return this._createIterator<Parameters>(
1706
+ (push) => {
1707
+ const onEvent = (...args: Parameters) => {
1708
+ sdkOwnedBufferedEventArguments.add(args);
1709
+ try {
1710
+ push(args);
1711
+ } finally {
1712
+ sdkOwnedBufferedEventArguments.delete(args);
1713
+ }
1714
+ };
1715
+ // SAFETY: This callback is paired with the same event when registered and removed; its variadic body forwards the event tuple or captured error.
1716
+ this.on(event, onEvent as EventListener<EventTypes, Event>);
1717
+ // SAFETY: This callback is paired with the same event when registered and removed; its variadic body forwards the event tuple or captured error.
1718
+ return () => this.off(event, onEvent as EventListener<EventTypes, Event>);
1719
+ },
1720
+ {
1721
+ // When iterating the 'error' or 'abort' event itself, yield it as a
1722
+ // value instead of rejecting the iterator.
1723
+ rejectOnError: event !== 'error',
1724
+ rejectOnAbort: event !== 'abort',
1725
+ },
1726
+ );
1727
+ }
1728
+
1729
+ /**
1730
+ * Shared buffered async-iterator adapter over this stream's events.
1731
+ *
1732
+ * `attach` registers the producer listener(s) with the given `push` and
1733
+ * returns a cleanup function that removes them. Termination is handled
1734
+ * here: the iterator ends when the stream ends, listeners are removed on
1735
+ * end/return, and a terminal error is retained until buffered values have
1736
+ * drained so it is surfaced even when no reader was waiting when it fired.
1737
+ * Detached consumers have bounded event and byte queues; exceeding either
1738
+ * limit fails the stream and aborts its underlying request. Detached queues
1739
+ * also reject accessor-backed payloads because getter closures cannot be
1740
+ * safely sized without executing untrusted code.
1741
+ */
1742
+ protected _createIterator<T>(
1743
+ attach: (push: (value: T) => void) => () => void,
1744
+ {
1745
+ rejectOnError = true,
1746
+ rejectOnAbort = true,
1747
+ onReturn,
1748
+ }: { rejectOnError?: boolean; rejectOnAbort?: boolean; onReturn?: () => void } = {},
1749
+ ): AsyncIterableIterator<T> {
1750
+ type Result = IteratorResult<T>;
1751
+ type Reader = {
1752
+ resolve: (result: Result) => void;
1753
+ reject: (error: OpenAIError) => void;
1754
+ };
1755
+ type BufferedEvent = {
1756
+ retention: BufferedLedgerEntry;
1757
+ active: boolean;
1758
+ check: (() => void) | undefined;
1759
+ };
1760
+
1761
+ const pushQueue = createEventQueue<T>();
1762
+ const bufferedEventSizes = createEventQueue<BufferedEvent>();
1763
+ const readQueue = createEventQueue<Reader>();
1764
+ const bufferedLedger = createBufferedEventLedger();
1765
+ let ended = this.ended;
1766
+ let failure: OpenAIError | undefined;
1767
+ let failureDelivered = false;
1768
+ let detach: () => void = () => undefined;
1769
+
1770
+ // SAFETY: A completed iterator result has no yielded value; never preserves the iterator public result type for done: true.
1771
+ const doneResult = (): Result => ({ value: undefined as never, done: true });
1772
+ const finishReaders = () => {
1773
+ while (readQueue.length) {
1774
+ readQueue.dequeue()!.resolve(doneResult());
1775
+ }
1776
+ };
1777
+ const rejectReader = () => {
1778
+ if (!failure || failureDelivered || !readQueue.length) {
1779
+ return;
1780
+ }
1781
+ failureDelivered = true;
1782
+ readQueue.dequeue()!.reject(failure);
1783
+ };
1784
+ const cleanup = () => {
1785
+ detach();
1786
+ this.off('end', onEnd);
1787
+ if (rejectOnError) {
1788
+ this.off('error', onFailure);
1789
+ }
1790
+ if (rejectOnAbort) {
1791
+ this.off('abort', onFailure);
1792
+ }
1793
+ };
1794
+ const deactivateBufferedEvent = (entry: BufferedEvent): void => {
1795
+ entry.active = false;
1796
+ if (entry.check) {
1797
+ this.#pendingBufferedEventChecks.delete(entry.check);
1798
+ entry.check = undefined;
1799
+ }
1800
+ };
1801
+ const failBufferedEvents = (discardRetained = false): OpenAIError => {
1802
+ if (discardRetained) {
1803
+ while (bufferedEventSizes.length) {
1804
+ deactivateBufferedEvent(bufferedEventSizes.dequeue()!);
1805
+ }
1806
+ pushQueue.clear();
1807
+ bufferedLedger.clear();
1808
+ }
1809
+
1810
+ const error = new OpenAIError(
1811
+ `Event stream iterator buffer limit exceeded (${MAX_BUFFERED_ITERATOR_EVENTS} events or ${MAX_BUFFERED_ITERATOR_BYTES} bytes); consume events as they arrive.`,
1812
+ );
1813
+ try {
1814
+ this.#handleError(error);
1815
+ } finally {
1816
+ this.controller.abort();
1817
+ }
1818
+ return error;
1819
+ };
1820
+
1821
+ const revalidateBufferedEvent = (value: T, entry: BufferedEvent): void => {
1822
+ if (!entry.active || this.#ended) {
1823
+ return;
1824
+ }
1825
+
1826
+ const graph = inspectBufferedEventGraph(value, MAX_BUFFERED_ITERATOR_BYTES);
1827
+ if (!graph || !bufferedLedger.refresh(entry.retention, graph)) {
1828
+ failBufferedEvents(true);
1829
+ }
1830
+ };
1831
+
1832
+ const push = (value: T) => {
1833
+ if (ended) {
1834
+ return;
1835
+ }
1836
+ const reader = readQueue.dequeue();
1837
+ if (reader) {
1838
+ reader.resolve({ value, done: false });
1839
+ } else {
1840
+ if (pushQueue.length >= MAX_BUFFERED_ITERATOR_EVENTS) {
1841
+ failBufferedEvents();
1842
+ return;
1843
+ }
1844
+ const graph = inspectBufferedEventGraph(value, MAX_BUFFERED_ITERATOR_BYTES);
1845
+ const retention = graph && bufferedLedger.retain(graph);
1846
+ if (!retention) {
1847
+ failBufferedEvents();
1848
+ return;
1849
+ }
1850
+
1851
+ if (typeof value === 'object' && value !== null && sdkOwnedBufferedEventArguments.has(value)) {
1852
+ // SAFETY: Only SDK-created argument tuples are inserted into this private WeakSet, so membership establishes the array identity.
1853
+ const argumentsTuple = value as unknown[];
1854
+ for (let index = 0; index < argumentsTuple.length; index += 1) {
1855
+ const argument = argumentsTuple[index];
1856
+ if (typeof argument === 'string') {
1857
+ // SAFETY: The branch checked argument is a string; JSON stringify/parse returns that same string value while detaching retained storage.
1858
+ argumentsTuple[index] = bufferedJSONParse(bufferedJSONStringify(argument)) as string;
1859
+ }
1860
+ }
1861
+ }
1862
+
1863
+ const entry: BufferedEvent = { retention, active: true, check: undefined };
1864
+ pushQueue.enqueue(value);
1865
+ bufferedEventSizes.enqueue(entry);
1866
+ const check = () => {
1867
+ entry.check = undefined;
1868
+ revalidateBufferedEvent(value, entry);
1869
+ };
1870
+ entry.check = check;
1871
+ this.#pendingBufferedEventChecks.add(check);
1872
+ }
1873
+ };
1874
+ const onFailure = (error: OpenAIError) => {
1875
+ failure = error;
1876
+ if (!pushQueue.length) {
1877
+ rejectReader();
1878
+ }
1879
+ };
1880
+ // A throwing user listener registered before this iterator stops dispatch
1881
+ // before onFailure runs; adopt the failure the stream recorded during
1882
+ // settlement so terminal errors are never converted into clean completion.
1883
+ const adoptTerminalFailure = () => {
1884
+ if (failure) {
1885
+ return;
1886
+ }
1887
+ const terminal = this.#terminalFailure;
1888
+ if (!terminal) {
1889
+ return;
1890
+ }
1891
+ if (terminal.kind === 'error' ? rejectOnError : rejectOnAbort) {
1892
+ failure = terminal.error;
1893
+ }
1894
+ };
1895
+ const onEnd = () => {
1896
+ ended = true;
1897
+ adoptTerminalFailure();
1898
+ cleanup();
1899
+ if (!pushQueue.length) {
1900
+ rejectReader();
1901
+ finishReaders();
1902
+ }
1903
+ };
1904
+
1905
+ if (!ended) {
1906
+ detach = attach(push);
1907
+ this.on('end', onEnd);
1908
+ if (rejectOnError) {
1909
+ this.on('error', onFailure);
1910
+ }
1911
+ if (rejectOnAbort) {
1912
+ this.on('abort', onFailure);
1913
+ }
1914
+ }
1915
+
1916
+ return {
1917
+ next: (): Promise<Result> => {
1918
+ if (pushQueue.length) {
1919
+ const value = pushQueue.dequeue()!;
1920
+ const entry = bufferedEventSizes.dequeue()!;
1921
+ deactivateBufferedEvent(entry);
1922
+ const graph = inspectBufferedEventGraph(value, MAX_BUFFERED_ITERATOR_BYTES);
1923
+ if (!graph || !bufferedLedger.refresh(entry.retention, graph)) {
1924
+ const error = failBufferedEvents(true);
1925
+ failureDelivered = true;
1926
+ return Promise.reject(error);
1927
+ }
1928
+ bufferedLedger.release(entry.retention);
1929
+ return Promise.resolve({ value, done: false });
1930
+ }
1931
+
1932
+ if (ended || this.ended) {
1933
+ adoptTerminalFailure();
1934
+ }
1935
+ if (failure && !failureDelivered) {
1936
+ failureDelivered = true;
1937
+ return Promise.reject(failure);
1938
+ }
1939
+
1940
+ if (ended) {
1941
+ return Promise.resolve(doneResult());
1942
+ }
1943
+
1944
+ return new Promise<Result>((resolve, reject) => {
1945
+ readQueue.enqueue({ resolve, reject });
1946
+ });
1947
+ },
1948
+ return: () => {
1949
+ ended = true;
1950
+ // The consumer walked away; terminal failures recorded later must not
1951
+ // resurface through this iterator.
1952
+ failureDelivered = true;
1953
+ while (bufferedEventSizes.length) {
1954
+ deactivateBufferedEvent(bufferedEventSizes.dequeue()!);
1955
+ }
1956
+ pushQueue.clear();
1957
+ bufferedLedger.clear();
1958
+ cleanup();
1959
+ finishReaders();
1960
+ if (onReturn) {
1961
+ // The consumer explicitly ended iteration, so any failure the
1962
+ // onReturn callback triggers (e.g. aborting the stream) is
1963
+ // self-inflicted; mark the stream's terminal promise as handled so
1964
+ // it does not surface as an unhandled rejection.
1965
+ void this.done().catch(() => undefined);
1966
+ onReturn();
1967
+ }
1968
+ return Promise.resolve(doneResult());
1969
+ },
1970
+ [Symbol.asyncIterator]() {
1971
+ return this;
1972
+ },
1973
+ };
1974
+ }
1975
+
1976
+ /** Resolves when the stream ends successfully or rejects when it fails or is aborted. */
141
1977
  async done(): Promise<void> {
142
1978
  this.#catchingPromiseCreated = true;
143
1979
  await this.#endPromise;
@@ -146,7 +1982,7 @@ export class EventStream<EventTypes extends BaseEvents> {
146
1982
  #handleError(this: EventStream<EventTypes>, error: unknown) {
147
1983
  this.#errored = true;
148
1984
  if (error instanceof Error && error.name === 'AbortError') {
149
- error = new APIUserAbortError();
1985
+ error = this._userAbortError();
150
1986
  }
151
1987
  if (error instanceof APIUserAbortError) {
152
1988
  this.#aborted = true;
@@ -164,32 +2000,21 @@ export class EventStream<EventTypes extends BaseEvents> {
164
2000
  return this._emit('error', new OpenAIError(String(error)));
165
2001
  }
166
2002
 
167
- _emit<Event extends keyof BaseEvents>(event: Event, ...args: EventParameters<BaseEvents, Event>): void;
168
- _emit<Event extends keyof EventTypes>(event: Event, ...args: EventParameters<EventTypes, Event>): void;
169
- _emit<Event extends keyof EventTypes>(
170
- this: EventStream<EventTypes>,
171
- event: Event,
172
- ...args: EventParameters<EventTypes, Event>
173
- ) {
174
- // make sure we don't emit any events after end
175
- if (this.#ended) {
176
- return;
177
- }
178
-
179
- if (event === 'end') {
180
- this.#ended = true;
181
- this.#resolveEndPromise();
182
- }
183
-
184
- const listeners: EventListeners<EventTypes, Event> | undefined = this.#listeners[event];
185
- if (listeners) {
186
- this.#listeners[event] = listeners.filter((l) => !l.once) as any;
187
- listeners.forEach(({ listener }: any) => listener(...(args as any)));
188
- }
2003
+ /** Returns whether an event currently has one or more registered listeners. */
2004
+ protected _hasListeners<Event extends keyof EventTypes>(event: Event): boolean {
2005
+ return Boolean(this.#listeners[event]?.some((listener) => !listener.removed));
2006
+ }
189
2007
 
2008
+ #settleTerminalEvent<Event extends keyof EventTypes>(
2009
+ event: Event,
2010
+ args: EventParameters<EventTypes, Event>,
2011
+ hasListeners: boolean,
2012
+ ): void {
190
2013
  if (event === 'abort') {
2014
+ // SAFETY: The abort event key selects the APIUserAbortError argument tuple established by the typed emit contract.
191
2015
  const error = args[0] as APIUserAbortError;
192
- if (!this.#catchingPromiseCreated && !listeners?.length) {
2016
+ this.#terminalFailure ??= { kind: 'abort', error };
2017
+ if (!this.#catchingPromiseCreated && !hasListeners) {
193
2018
  Promise.reject(error);
194
2019
  }
195
2020
  this.#rejectConnectedPromise(error);
@@ -201,8 +2026,10 @@ export class EventStream<EventTypes extends BaseEvents> {
201
2026
  if (event === 'error') {
202
2027
  // NOTE: _emit('error', error) should only be called from #handleError().
203
2028
 
2029
+ // SAFETY: The error event is emitted by the error-normalization path, which supplies an OpenAIError as its first argument.
204
2030
  const error = args[0] as OpenAIError;
205
- if (!this.#catchingPromiseCreated && !listeners?.length) {
2031
+ this.#terminalFailure ??= { kind: 'error', error };
2032
+ if (!this.#catchingPromiseCreated && !hasListeners) {
206
2033
  // Trigger an unhandled rejection if the user hasn't registered any error handlers.
207
2034
  // If you are seeing stack traces here, make sure to handle errors via either:
208
2035
  // - runner.on('error', () => ...)
@@ -217,23 +2044,111 @@ export class EventStream<EventTypes extends BaseEvents> {
217
2044
  }
218
2045
  }
219
2046
 
220
- protected _emitFinal(): void {}
2047
+ /** Dispatches a connection, failure, cancellation, or completion lifecycle event. */
2048
+ _emit<Event extends keyof BaseEvents>(event: Event, ...args: EventParameters<BaseEvents, Event>): void;
2049
+ /** Dispatches a typed stream event to all listeners registered for that event. */
2050
+ _emit<Event extends keyof EventTypes>(event: Event, ...args: EventParameters<EventTypes, Event>): void;
2051
+ /** Dispatches a stream event and performs the associated lifecycle transitions. */
2052
+ _emit<Event extends keyof EventTypes>(
2053
+ this: EventStream<EventTypes>,
2054
+ event: Event,
2055
+ ...args: EventParameters<EventTypes, Event>
2056
+ ) {
2057
+ // make sure we don't emit any events after end
2058
+ if (this.#ended) {
2059
+ return;
2060
+ }
2061
+
2062
+ if (event === 'end') {
2063
+ this.#removeAbortListeners();
2064
+ this.#ended = true;
2065
+ this.#resolveEndPromise();
2066
+ }
2067
+
2068
+ const listeners: EventListeners<EventTypes, Event> | undefined = this.#listeners[event];
2069
+ let dispatchError: unknown;
2070
+ let dispatchThrew = false;
2071
+ try {
2072
+ if (listeners) {
2073
+ // SAFETY: Filtering only removes registrations from the same event bucket and preserves the listener signatures for that event.
2074
+ this.#listeners[event] = listeners.filter((listener) => {
2075
+ if (listener.once) {
2076
+ listener.detached = true;
2077
+ }
2078
+ return !listener.once && !listener.removed;
2079
+ }) as any;
2080
+ this.#listenerDispatchDepth += 1;
2081
+ try {
2082
+ // SAFETY: The listener bucket and argument tuple come from the same EventTypes key; this bridges TypeScript generic indexed-access correlation.
2083
+ for (const registration of listeners as any) {
2084
+ if (!registration.removed) {
2085
+ const { listener } = registration;
2086
+ // SAFETY: The listener bucket and argument tuple come from the same EventTypes key; this bridges TypeScript generic indexed-access correlation.
2087
+ listener(...(args as any));
2088
+ }
2089
+ }
2090
+ } finally {
2091
+ this.#listenerDispatchDepth -= 1;
2092
+ if (this.#listenerDispatchDepth === 0) {
2093
+ this.#cleanupEmittedListeners();
2094
+ for (const check of this.#pendingBufferedEventChecks) {
2095
+ this.#pendingBufferedEventChecks.delete(check);
2096
+ if (!this.#ended) {
2097
+ check();
2098
+ }
2099
+ }
2100
+ }
2101
+ }
2102
+ }
2103
+ } catch (error) {
2104
+ dispatchError = error;
2105
+ dispatchThrew = true;
2106
+ }
2107
+
2108
+ try {
2109
+ this.#settleTerminalEvent(event, args, Boolean(listeners?.length));
2110
+ } catch (error) {
2111
+ if (!dispatchThrew) {
2112
+ dispatchError = error;
2113
+ dispatchThrew = true;
2114
+ }
2115
+ }
2116
+
2117
+ if (dispatchThrew) {
2118
+ throw dispatchError;
2119
+ }
2120
+ }
2121
+
2122
+ // oxlint-disable-next-line class-methods-use-this -- Subclasses override this instance hook.
2123
+ protected _emitFinal(): void {
2124
+ // Hook for subclasses.
2125
+ }
221
2126
  }
222
2127
 
2128
+ /** The listener callback associated with one event name in a stream event map. */
223
2129
  type EventListener<Events, EventType extends keyof Events> = Events[EventType];
224
2130
 
225
- type EventListeners<Events, EventType extends keyof Events> = Array<{
2131
+ type EventListeners<Events, EventType extends keyof Events> = {
226
2132
  listener: EventListener<Events, EventType>;
227
2133
  once?: boolean;
228
- }>;
2134
+ removed?: boolean;
2135
+ detached?: boolean;
2136
+ }[];
229
2137
 
230
- export type EventParameters<Events, EventType extends keyof Events> = {
231
- [Event in EventType]: EventListener<Events, EventType> extends (...args: infer P) => any ? P : never;
232
- }[EventType];
2138
+ /** The positional listener arguments associated with a named event. */
2139
+ export type EventParameters<Events, EventType extends keyof Events> = Record<
2140
+ EventType,
2141
+ EventListener<Events, EventType> extends (...args: infer P) => any ? P : never
2142
+ >[EventType];
233
2143
 
2144
+ /** Lifecycle events shared by all SDK streaming helpers. */
234
2145
  export interface BaseEvents {
2146
+ /** Called when the underlying request or readable stream is ready to produce events. */
235
2147
  connect: () => void;
2148
+ /** Called when the stream fails for a reason other than user cancellation. */
236
2149
  error: (error: OpenAIError) => void;
2150
+ /** Called when the underlying request is cancelled. */
237
2151
  abort: (error: APIUserAbortError) => void;
2152
+ /** Called after a successful completion, failure, or cancellation. */
238
2153
  end: () => void;
239
2154
  }