openai 0.99.0 → 0.100.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (157) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +19 -0
  3. data/README.md +1 -1
  4. data/bedrock.md +17 -1
  5. data/lib/openai/client.rb +9 -0
  6. data/lib/openai/helpers/agents/session_stream.rb +11 -36
  7. data/lib/openai/helpers/agents/tools.rb +34 -4
  8. data/lib/openai/helpers/beta/agents/creation_stream.rb +26 -0
  9. data/lib/openai/helpers/beta/agents/function_tool.rb +11 -4
  10. data/lib/openai/helpers/beta/agents/tool_dispatcher.rb +74 -0
  11. data/lib/openai/helpers/beta/agents/tool_error.rb +28 -0
  12. data/lib/openai/models/admin/organization/usage_audio_speeches_response.rb +125 -3
  13. data/lib/openai/models/admin/organization/usage_audio_transcriptions_response.rb +125 -3
  14. data/lib/openai/models/admin/organization/usage_code_interpreter_sessions_response.rb +125 -3
  15. data/lib/openai/models/admin/organization/usage_completions_params.rb +9 -4
  16. data/lib/openai/models/admin/organization/usage_completions_response.rb +125 -3
  17. data/lib/openai/models/admin/organization/usage_costs_params.rb +16 -4
  18. data/lib/openai/models/admin/organization/usage_costs_response.rb +125 -3
  19. data/lib/openai/models/admin/organization/usage_embeddings_response.rb +125 -3
  20. data/lib/openai/models/admin/organization/usage_file_search_calls_response.rb +125 -3
  21. data/lib/openai/models/admin/organization/usage_images_response.rb +125 -3
  22. data/lib/openai/models/admin/organization/usage_moderations_response.rb +125 -3
  23. data/lib/openai/models/admin/organization/usage_vector_stores_response.rb +125 -3
  24. data/lib/openai/models/admin/organization/usage_web_search_calls_params.rb +9 -4
  25. data/lib/openai/models/admin/organization/usage_web_search_calls_response.rb +125 -3
  26. data/lib/openai/models/beta/agents/environments/template_create_params.rb +6 -6
  27. data/lib/openai/models/beta/agents/environments/template_update_params.rb +3 -6
  28. data/lib/openai/models/beta/agents/sessions/turns/item_list_params.rb +79 -0
  29. data/lib/openai/models/beta/beta_response_computer_tool_call_output_item.rb +2 -2
  30. data/lib/openai/models/beta/beta_response_error.rb +12 -1
  31. data/lib/openai/models/beta/beta_responses_server_event.rb +12 -1
  32. data/lib/openai/models/beta/beta_tool.rb +12 -9
  33. data/lib/openai/models/beta/environment_param.rb +6 -6
  34. data/lib/openai/models/beta/session_turn_error.rb +9 -0
  35. data/lib/openai/models/chat/chat_completion_chunk.rb +85 -18
  36. data/lib/openai/models/error_object.rb +12 -1
  37. data/lib/openai/models/eval_create_params.rb +1 -1
  38. data/lib/openai/models/eval_create_response.rb +1 -1
  39. data/lib/openai/models/eval_list_response.rb +1 -1
  40. data/lib/openai/models/eval_retrieve_response.rb +1 -1
  41. data/lib/openai/models/eval_update_response.rb +1 -1
  42. data/lib/openai/models/fine_tuning/job_list_params.rb +14 -4
  43. data/lib/openai/models/graders/score_model_grader.rb +2 -2
  44. data/lib/openai/models/image_edit_params.rb +12 -9
  45. data/lib/openai/models/realtime/realtime_client_event.rb +9 -0
  46. data/lib/openai/models/realtime/session_update_event.rb +16 -0
  47. data/lib/openai/models/responses/response_computer_tool_call_output_item.rb +2 -2
  48. data/lib/openai/models/responses/response_error.rb +12 -1
  49. data/lib/openai/models/responses/responses_server_event.rb +12 -1
  50. data/lib/openai/models/responses/tool.rb +12 -9
  51. data/lib/openai/models/video_create_error.rb +12 -1
  52. data/lib/openai/providers/bedrock.rb +20 -1
  53. data/lib/openai/resources/admin/organization/usage.rb +15 -6
  54. data/lib/openai/resources/beta/agents/environments/templates.rb +3 -4
  55. data/lib/openai/resources/beta/agents/sessions/turns/items.rb +68 -0
  56. data/lib/openai/resources/beta/agents/sessions/turns.rb +4 -0
  57. data/lib/openai/resources/beta/agents/sessions.rb +22 -2
  58. data/lib/openai/resources/fine_tuning/jobs.rb +7 -2
  59. data/lib/openai/resources/images.rb +8 -6
  60. data/lib/openai/version.rb +1 -1
  61. data/lib/openai.rb +2 -0
  62. data/rbi/openai/helpers/agents.rbi +2 -0
  63. data/rbi/openai/helpers/beta/agents/function_tool.rbi +8 -3
  64. data/rbi/openai/helpers/beta/agents/tool_error.rbi +19 -0
  65. data/rbi/openai/helpers/beta/agents.rbi +12 -0
  66. data/rbi/openai/models/admin/organization/usage_audio_speeches_response.rbi +194 -1
  67. data/rbi/openai/models/admin/organization/usage_audio_transcriptions_response.rbi +194 -1
  68. data/rbi/openai/models/admin/organization/usage_code_interpreter_sessions_response.rbi +194 -1
  69. data/rbi/openai/models/admin/organization/usage_completions_params.rbi +9 -4
  70. data/rbi/openai/models/admin/organization/usage_completions_response.rbi +194 -1
  71. data/rbi/openai/models/admin/organization/usage_costs_params.rbi +16 -4
  72. data/rbi/openai/models/admin/organization/usage_costs_response.rbi +194 -1
  73. data/rbi/openai/models/admin/organization/usage_embeddings_response.rbi +194 -1
  74. data/rbi/openai/models/admin/organization/usage_file_search_calls_response.rbi +194 -1
  75. data/rbi/openai/models/admin/organization/usage_images_response.rbi +194 -1
  76. data/rbi/openai/models/admin/organization/usage_moderations_response.rbi +194 -1
  77. data/rbi/openai/models/admin/organization/usage_vector_stores_response.rbi +194 -1
  78. data/rbi/openai/models/admin/organization/usage_web_search_calls_params.rbi +12 -4
  79. data/rbi/openai/models/admin/organization/usage_web_search_calls_response.rbi +194 -1
  80. data/rbi/openai/models/beta/agents/environments/template_create_params.rbi +6 -6
  81. data/rbi/openai/models/beta/agents/environments/template_update_params.rbi +3 -6
  82. data/rbi/openai/models/beta/agents/sessions/turns/item_list_params.rbi +139 -0
  83. data/rbi/openai/models/beta/beta_response_computer_tool_call_output_item.rbi +2 -2
  84. data/rbi/openai/models/beta/beta_response_error.rbi +12 -0
  85. data/rbi/openai/models/beta/beta_responses_server_event.rbi +12 -0
  86. data/rbi/openai/models/beta/beta_tool.rbi +12 -9
  87. data/rbi/openai/models/beta/environment_param.rbi +6 -6
  88. data/rbi/openai/models/beta/session_turn_error.rbi +18 -0
  89. data/rbi/openai/models/chat/chat_completion_chunk.rbi +123 -17
  90. data/rbi/openai/models/error_object.rbi +12 -0
  91. data/rbi/openai/models/eval_create_params.rbi +1 -1
  92. data/rbi/openai/models/eval_create_response.rbi +1 -1
  93. data/rbi/openai/models/eval_list_response.rbi +1 -1
  94. data/rbi/openai/models/eval_retrieve_response.rbi +1 -1
  95. data/rbi/openai/models/eval_update_response.rbi +1 -1
  96. data/rbi/openai/models/fine_tuning/job_list_params.rbi +14 -4
  97. data/rbi/openai/models/graders/score_model_grader.rbi +2 -2
  98. data/rbi/openai/models/image_edit_params.rbi +12 -9
  99. data/rbi/openai/models/realtime/session_update_event.rbi +16 -0
  100. data/rbi/openai/models/responses/response_computer_tool_call_output_item.rbi +2 -2
  101. data/rbi/openai/models/responses/response_error.rbi +12 -0
  102. data/rbi/openai/models/responses/responses_server_event.rbi +12 -0
  103. data/rbi/openai/models/responses/tool.rbi +12 -9
  104. data/rbi/openai/models/video_create_error.rbi +12 -0
  105. data/rbi/openai/resources/admin/organization/usage.rbi +15 -6
  106. data/rbi/openai/resources/beta/agents/environments/templates.rbi +3 -4
  107. data/rbi/openai/resources/beta/agents/sessions/turns/items.rbi +62 -0
  108. data/rbi/openai/resources/beta/agents/sessions/turns.rbi +3 -0
  109. data/rbi/openai/resources/beta/agents/sessions.rbi +2 -0
  110. data/rbi/openai/resources/fine_tuning/jobs.rbi +7 -2
  111. data/rbi/openai/resources/images.rbi +8 -6
  112. data/sig/openai/helpers/agents.rbs +3 -0
  113. data/sig/openai/helpers/beta/agents/function_tool.rbs +5 -2
  114. data/sig/openai/helpers/beta/agents/tool_error.rbs +17 -0
  115. data/sig/openai/helpers/beta/agents.rbs +5 -0
  116. data/sig/openai/models/admin/organization/usage_audio_speeches_response.rbs +87 -2
  117. data/sig/openai/models/admin/organization/usage_audio_transcriptions_response.rbs +87 -2
  118. data/sig/openai/models/admin/organization/usage_code_interpreter_sessions_response.rbs +87 -2
  119. data/sig/openai/models/admin/organization/usage_completions_params.rbs +14 -6
  120. data/sig/openai/models/admin/organization/usage_completions_response.rbs +87 -2
  121. data/sig/openai/models/admin/organization/usage_costs_params.rbs +25 -7
  122. data/sig/openai/models/admin/organization/usage_costs_response.rbs +87 -2
  123. data/sig/openai/models/admin/organization/usage_embeddings_response.rbs +87 -2
  124. data/sig/openai/models/admin/organization/usage_file_search_calls_response.rbs +87 -2
  125. data/sig/openai/models/admin/organization/usage_images_response.rbs +87 -2
  126. data/sig/openai/models/admin/organization/usage_moderations_response.rbs +87 -2
  127. data/sig/openai/models/admin/organization/usage_vector_stores_response.rbs +87 -2
  128. data/sig/openai/models/admin/organization/usage_web_search_calls_params.rbs +19 -7
  129. data/sig/openai/models/admin/organization/usage_web_search_calls_response.rbs +87 -2
  130. data/sig/openai/models/beta/agents/environments/template_create_params.rbs +4 -4
  131. data/sig/openai/models/beta/agents/environments/template_update_params.rbs +2 -4
  132. data/sig/openai/models/beta/agents/sessions/turns/item_list_params.rbs +91 -0
  133. data/sig/openai/models/beta/beta_response_computer_tool_call_output_item.rbs +2 -2
  134. data/sig/openai/models/beta/beta_response_error.rbs +10 -0
  135. data/sig/openai/models/beta/beta_responses_server_event.rbs +10 -0
  136. data/sig/openai/models/beta/beta_tool.rbs +8 -6
  137. data/sig/openai/models/beta/environment_param.rbs +4 -4
  138. data/sig/openai/models/beta/session_turn_error.rbs +12 -0
  139. data/sig/openai/models/chat/chat_completion_chunk.rbs +96 -12
  140. data/sig/openai/models/error_object.rbs +10 -0
  141. data/sig/openai/models/eval_create_params.rbs +1 -1
  142. data/sig/openai/models/eval_create_response.rbs +1 -1
  143. data/sig/openai/models/eval_list_response.rbs +1 -1
  144. data/sig/openai/models/eval_retrieve_response.rbs +1 -1
  145. data/sig/openai/models/eval_update_response.rbs +1 -1
  146. data/sig/openai/models/fine_tuning/job_list_params.rbs +14 -4
  147. data/sig/openai/models/graders/score_model_grader.rbs +3 -3
  148. data/sig/openai/models/image_edit_params.rbs +8 -6
  149. data/sig/openai/models/responses/response_computer_tool_call_output_item.rbs +2 -2
  150. data/sig/openai/models/responses/response_error.rbs +10 -0
  151. data/sig/openai/models/responses/responses_server_event.rbs +10 -0
  152. data/sig/openai/models/responses/tool.rbs +8 -6
  153. data/sig/openai/models/video_create_error.rbs +10 -0
  154. data/sig/openai/resources/beta/agents/sessions/turns/items.rbs +24 -0
  155. data/sig/openai/resources/beta/agents/sessions/turns.rbs +2 -0
  156. data/sig/openai/resources/beta/agents/sessions.rbs +1 -0
  157. metadata +11 -1
@@ -177,58 +177,65 @@ module OpenAI
177
177
  type choice =
178
178
  {
179
179
  delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta,
180
- finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?,
181
180
  index: Integer,
181
+ ?finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?,
182
182
  ?logprobs: OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs?
183
183
  }
184
184
 
185
185
  class Choice < OpenAI::Internal::Type::BaseModel
186
- # A chat completion delta generated by streamed model responses.
186
+ # A chat completion delta generated by streamed model responses. Streamed audio
187
+ # can arrive in partial updates with an ID, base64 data, or transcript text. The
188
+ # final audio update contains only its expiry timestamp.
187
189
  attr_accessor delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta
188
190
 
191
+ # The index of the choice in the list of choices.
192
+ attr_accessor index: Integer
193
+
189
194
  # The reason the model stopped generating tokens. This will be `stop` if the model
190
195
  # hit a natural stop point or a provided stop sequence, `length` if the maximum
191
196
  # number of tokens specified in the request was reached, `content_filter` if
192
197
  # content was omitted due to a flag from our content filters, `tool_calls` if the
193
198
  # model called a tool, or `function_call` (deprecated) if the model called a
194
- # function.
199
+ # function. Omitted from the final audio update containing only
200
+ # `delta.audio.expires_at`.
195
201
  attr_accessor finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?
196
202
 
197
- # The index of the choice in the list of choices.
198
- attr_accessor index: Integer
199
-
200
203
  # Log probability information for the choice.
201
204
  attr_accessor logprobs: OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs?
202
205
 
203
206
  # @param delta
204
- # A chat completion delta generated by streamed model responses.
207
+ # A chat completion delta generated by streamed model responses. Streamed audio
208
+ # can arrive in partial updates with an ID, base64 data, or transcript text. The
209
+ # final audio update contains only its expiry timestamp.
210
+ # @param index
211
+ # The index of the choice in the list of choices.
205
212
  # @param finish_reason
206
213
  # The reason the model stopped generating tokens. This will be `stop` if the model
207
214
  # hit a natural stop point or a provided stop sequence, `length` if the maximum
208
215
  # number of tokens specified in the request was reached, `content_filter` if
209
216
  # content was omitted due to a flag from our content filters, `tool_calls` if the
210
217
  # model called a tool, or `function_call` (deprecated) if the model called a
211
- # function.
212
- # @param index
213
- # The index of the choice in the list of choices.
218
+ # function. Omitted from the final audio update containing only
219
+ # `delta.audio.expires_at`.
214
220
  # @param logprobs
215
221
  # Log probability information for the choice.
216
222
  def initialize: (
217
223
  delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta,
218
- finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?,
219
224
  index: Integer,
225
+ ?finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?,
220
226
  ?logprobs: OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs?
221
227
  ) -> void
222
228
 
223
229
  def to_hash: -> {
224
230
  delta: OpenAI::Chat::ChatCompletionChunk::Choice::Delta,
225
- finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?,
226
231
  index: Integer,
232
+ ?finish_reason: OpenAI::Models::Chat::ChatCompletionChunk::Choice::finish_reason?,
227
233
  ?logprobs: OpenAI::Chat::ChatCompletionChunk::Choice::Logprobs?
228
234
  }
229
235
 
230
236
  type delta =
231
237
  {
238
+ ?audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio,
232
239
  ?content: String?,
233
240
  ?function_call: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::FunctionCall,
234
241
  ?refusal: String?,
@@ -237,6 +244,16 @@ module OpenAI
237
244
  }
238
245
 
239
246
  class Delta < OpenAI::Internal::Type::BaseModel
247
+ # A partial audio response. Audio chunks may carry an ID, base64 data, or
248
+ # transcript text; the final audio update contains only its expiry timestamp.
249
+ attr_reader audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio?
250
+
251
+ # A partial audio response. Audio chunks may carry an ID, base64 data, or
252
+ # transcript text; the final audio update contains only its expiry timestamp.
253
+ def audio=: (
254
+ OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio
255
+ ) -> OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio
256
+
240
257
  # The contents of the chunk message.
241
258
  attr_accessor content: String?
242
259
 
@@ -267,6 +284,9 @@ module OpenAI
267
284
  ::Array[OpenAI::Chat::ChatCompletionChunk::Choice::Delta::ToolCall]
268
285
  ) -> ::Array[OpenAI::Chat::ChatCompletionChunk::Choice::Delta::ToolCall]
269
286
 
287
+ # @param audio
288
+ # A partial audio response. Audio chunks may carry an ID, base64 data, or
289
+ # transcript text; the final audio update contains only its expiry timestamp.
270
290
  # @param content
271
291
  # The contents of the chunk message.
272
292
  # @param function_call
@@ -277,6 +297,7 @@ module OpenAI
277
297
  # @param role
278
298
  # The role of the author of this message.
279
299
  def initialize: (
300
+ ?audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio,
280
301
  ?content: String?,
281
302
  ?function_call: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::FunctionCall,
282
303
  ?refusal: String?,
@@ -285,6 +306,7 @@ module OpenAI
285
306
  ) -> void
286
307
 
287
308
  def to_hash: -> {
309
+ ?audio: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::Audio,
288
310
  ?content: String?,
289
311
  ?function_call: OpenAI::Chat::ChatCompletionChunk::Choice::Delta::FunctionCall,
290
312
  ?refusal: String?,
@@ -292,6 +314,68 @@ module OpenAI
292
314
  ?tool_calls: ::Array[OpenAI::Chat::ChatCompletionChunk::Choice::Delta::ToolCall]
293
315
  }
294
316
 
317
+ type audio =
318
+ {
319
+ ?id: String,
320
+ ?data: String,
321
+ ?expires_at: Integer,
322
+ ?transcript: String
323
+ }
324
+
325
+ class Audio < OpenAI::Internal::Type::BaseModel
326
+ # Unique identifier for this audio response.
327
+ attr_reader id: String?
328
+
329
+ # Unique identifier for this audio response.
330
+ def id=: (String) -> String
331
+
332
+ # Base64 encoded audio bytes generated by the model, in the format specified in
333
+ # the request.
334
+ attr_reader data: String?
335
+
336
+ # Base64 encoded audio bytes generated by the model, in the format specified in
337
+ # the request.
338
+ def data=: (String) -> String
339
+
340
+ # The Unix timestamp (in seconds) for when this audio response will no longer be
341
+ # accessible on the server for use in multi-turn conversations.
342
+ attr_reader expires_at: Integer?
343
+
344
+ # The Unix timestamp (in seconds) for when this audio response will no longer be
345
+ # accessible on the server for use in multi-turn conversations.
346
+ def expires_at=: (Integer) -> Integer
347
+
348
+ # Transcript text from this audio chunk.
349
+ attr_reader transcript: String?
350
+
351
+ # Transcript text from this audio chunk.
352
+ def transcript=: (String) -> String
353
+
354
+ # @param id
355
+ # Unique identifier for this audio response.
356
+ # @param data
357
+ # Base64 encoded audio bytes generated by the model, in the format specified in
358
+ # the request.
359
+ # @param expires_at
360
+ # The Unix timestamp (in seconds) for when this audio response will no longer be
361
+ # accessible on the server for use in multi-turn conversations.
362
+ # @param transcript
363
+ # Transcript text from this audio chunk.
364
+ def initialize: (
365
+ ?id: String,
366
+ ?data: String,
367
+ ?expires_at: Integer,
368
+ ?transcript: String
369
+ ) -> void
370
+
371
+ def to_hash: -> {
372
+ ?id: String,
373
+ ?data: String,
374
+ ?expires_at: Integer,
375
+ ?transcript: String
376
+ }
377
+ end
378
+
295
379
  type function_call = { ?arguments: String, ?name: String }
296
380
 
297
381
  class FunctionCall < OpenAI::Internal::Type::BaseModel
@@ -44,6 +44,7 @@ module OpenAI
44
44
  {
45
45
  ?detailed_explanation: String,
46
46
  ?error_type: OpenAI::Models::ErrorObject::Misalignment::error_type,
47
+ ?review_target: String?,
47
48
  ?steer: OpenAI::ErrorObject::Misalignment::Steer
48
49
  }
49
50
 
@@ -62,6 +63,10 @@ module OpenAI
62
63
  OpenAI::Models::ErrorObject::Misalignment::error_type
63
64
  ) -> OpenAI::Models::ErrorObject::Misalignment::error_type
64
65
 
66
+ # An opaque target for explicitly continuing this review, or null when
67
+ # unavailable.
68
+ attr_accessor review_target: String?
69
+
65
70
  # An optional public continuation instruction.
66
71
  attr_reader steer: OpenAI::ErrorObject::Misalignment::Steer?
67
72
 
@@ -74,17 +79,22 @@ module OpenAI
74
79
  # The public explanation for this block.
75
80
  # @param error_type
76
81
  # An optional classification; clients must accept additional values.
82
+ # @param review_target
83
+ # An opaque target for explicitly continuing this review, or null when
84
+ # unavailable.
77
85
  # @param steer
78
86
  # An optional public continuation instruction.
79
87
  def initialize: (
80
88
  ?detailed_explanation: String,
81
89
  ?error_type: OpenAI::Models::ErrorObject::Misalignment::error_type,
90
+ ?review_target: String?,
82
91
  ?steer: OpenAI::ErrorObject::Misalignment::Steer
83
92
  ) -> void
84
93
 
85
94
  def to_hash: -> {
86
95
  ?detailed_explanation: String,
87
96
  ?error_type: OpenAI::Models::ErrorObject::Misalignment::error_type,
97
+ ?review_target: String?,
88
98
  ?steer: OpenAI::ErrorObject::Misalignment::Steer
89
99
  }
90
100
 
@@ -528,7 +528,7 @@ module OpenAI
528
528
  # @param name
529
529
  # The name of the grader.
530
530
  # @param range
531
- # The range of the score. Defaults to `[0, 1]`.
531
+ # The service requires two numbers for the score range. Defaults to `[0, 1]`.
532
532
  # @param sampling_params
533
533
  # The sampling parameters for the model.
534
534
  # @param pass_threshold
@@ -264,7 +264,7 @@ module OpenAI
264
264
  # @param name
265
265
  # The name of the grader.
266
266
  # @param range
267
- # The range of the score. Defaults to `[0, 1]`.
267
+ # The service requires two numbers for the score range. Defaults to `[0, 1]`.
268
268
  # @param sampling_params
269
269
  # The sampling parameters for the model.
270
270
  # @param pass_threshold
@@ -264,7 +264,7 @@ module OpenAI
264
264
  # @param name
265
265
  # The name of the grader.
266
266
  # @param range
267
- # The range of the score. Defaults to `[0, 1]`.
267
+ # The service requires two numbers for the score range. Defaults to `[0, 1]`.
268
268
  # @param sampling_params
269
269
  # The sampling parameters for the model.
270
270
  # @param pass_threshold
@@ -264,7 +264,7 @@ module OpenAI
264
264
  # @param name
265
265
  # The name of the grader.
266
266
  # @param range
267
- # The range of the score. Defaults to `[0, 1]`.
267
+ # The service requires two numbers for the score range. Defaults to `[0, 1]`.
268
268
  # @param sampling_params
269
269
  # The sampling parameters for the model.
270
270
  # @param pass_threshold
@@ -264,7 +264,7 @@ module OpenAI
264
264
  # @param name
265
265
  # The name of the grader.
266
266
  # @param range
267
- # The range of the score. Defaults to `[0, 1]`.
267
+ # The service requires two numbers for the score range. Defaults to `[0, 1]`.
268
268
  # @param sampling_params
269
269
  # The sampling parameters for the model.
270
270
  # @param pass_threshold
@@ -25,8 +25,13 @@ module OpenAI
25
25
  # Number of fine-tuning jobs to retrieve.
26
26
  def limit=: (Integer) -> Integer
27
27
 
28
- # Optional metadata filter. To filter, use the syntax `metadata[k]=v`.
29
- # Alternatively, set `metadata=null` to indicate no metadata.
28
+ # Optional metadata filter. To filter, use the syntax `metadata[k]=v`. Omitting
29
+ # the parameter or passing an empty object applies no metadata filter. An empty
30
+ # value, such as `metadata[k]=`, filters for that key with an empty string value.
31
+ # To select jobs with null metadata, send the literal query string
32
+ # `metadata=null`. Nullable caller types do not specify how a client serializes
33
+ # null for a deep-object parameter. Use a raw query parameter if the client omits
34
+ # null. Do not combine the two query forms.
30
35
  attr_accessor metadata: ::Hash[Symbol, String]?
31
36
 
32
37
  # @param after
@@ -34,8 +39,13 @@ module OpenAI
34
39
  # @param limit
35
40
  # Number of fine-tuning jobs to retrieve.
36
41
  # @param metadata
37
- # Optional metadata filter. To filter, use the syntax `metadata[k]=v`.
38
- # Alternatively, set `metadata=null` to indicate no metadata.
42
+ # Optional metadata filter. To filter, use the syntax `metadata[k]=v`. Omitting
43
+ # the parameter or passing an empty object applies no metadata filter. An empty
44
+ # value, such as `metadata[k]=`, filters for that key with an empty string value.
45
+ # To select jobs with null metadata, send the literal query string
46
+ # `metadata=null`. Nullable caller types do not specify how a client serializes
47
+ # null for a deep-object parameter. Use a raw query parameter if the client omits
48
+ # null. Do not combine the two query forms.
39
49
  def initialize: (
40
50
  ?after: String,
41
51
  ?limit: Integer,
@@ -27,10 +27,10 @@ module OpenAI
27
27
  # The object type, which is always `score_model`.
28
28
  attr_accessor type: :score_model
29
29
 
30
- # The range of the score. Defaults to `[0, 1]`.
30
+ # The service requires two numbers for the score range. Defaults to `[0, 1]`.
31
31
  attr_reader range: ::Array[Float]?
32
32
 
33
- # The range of the score. Defaults to `[0, 1]`.
33
+ # The service requires two numbers for the score range. Defaults to `[0, 1]`.
34
34
  def range=: (::Array[Float]) -> ::Array[Float]
35
35
 
36
36
  # The sampling parameters for the model.
@@ -49,7 +49,7 @@ module OpenAI
49
49
  # @param name
50
50
  # The name of the grader.
51
51
  # @param range
52
- # The range of the score. Defaults to `[0, 1]`.
52
+ # The service requires two numbers for the score range. Defaults to `[0, 1]`.
53
53
  # @param sampling_params
54
54
  # The sampling parameters for the model.
55
55
  # @param type
@@ -52,9 +52,10 @@ module OpenAI
52
52
  # set the output format to `png` or `webp`.
53
53
  attr_accessor background: OpenAI::Models::ImageEditParams::background?
54
54
 
55
- # Controls fidelity to the original input image(s). This parameter is supported
56
- # for GPT image models that support input fidelity. `gpt-image-2` and
57
- # `gpt-image-2-2026-04-21` ignore this parameter.
55
+ # Control how much effort the model will exert to match the style and features,
56
+ # especially facial features, of input images. Supports `high` and `low` on
57
+ # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
58
+ # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
58
59
  attr_accessor input_fidelity: OpenAI::Models::ImageEditParams::input_fidelity?
59
60
 
60
61
  # An additional image whose fully transparent areas (e.g. where alpha is zero)
@@ -165,9 +166,10 @@ module OpenAI
165
166
  # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
166
167
  # set the output format to `png` or `webp`.
167
168
  # @param input_fidelity
168
- # Controls fidelity to the original input image(s). This parameter is supported
169
- # for GPT image models that support input fidelity. `gpt-image-2` and
170
- # `gpt-image-2-2026-04-21` ignore this parameter.
169
+ # Control how much effort the model will exert to match the style and features,
170
+ # especially facial features, of input images. Supports `high` and `low` on
171
+ # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
172
+ # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
171
173
  # @param mask
172
174
  # An additional image whose fully transparent areas (e.g. where alpha is zero)
173
175
  # indicate where `image` should be edited. If there are multiple images provided,
@@ -13,7 +13,7 @@ module OpenAI
13
13
  }
14
14
 
15
15
  class ResponseComputerToolCallOutputItem < OpenAI::Internal::Type::BaseModel
16
- # The unique ID of the computer call tool output.
16
+ # The ID of the computer tool call output.
17
17
  attr_accessor id: String
18
18
 
19
19
  # The ID of the computer tool call that produced the output.
@@ -46,7 +46,7 @@ module OpenAI
46
46
  def created_by=: (String) -> String
47
47
 
48
48
  # @param id
49
- # The unique ID of the computer call tool output.
49
+ # The ID of the computer tool call output.
50
50
  # @param call_id
51
51
  # The ID of the computer tool call that produced the output.
52
52
  # @param output
@@ -92,6 +92,7 @@ module OpenAI
92
92
  {
93
93
  ?detailed_explanation: String,
94
94
  ?error_type: OpenAI::Models::Responses::ResponseError::Misalignment::error_type,
95
+ ?review_target: String?,
95
96
  ?steer: OpenAI::Responses::ResponseError::Misalignment::Steer
96
97
  }
97
98
 
@@ -110,6 +111,10 @@ module OpenAI
110
111
  OpenAI::Models::Responses::ResponseError::Misalignment::error_type
111
112
  ) -> OpenAI::Models::Responses::ResponseError::Misalignment::error_type
112
113
 
114
+ # An opaque target for explicitly continuing this review, or null when
115
+ # unavailable.
116
+ attr_accessor review_target: String?
117
+
113
118
  # An optional public continuation instruction.
114
119
  attr_reader steer: OpenAI::Responses::ResponseError::Misalignment::Steer?
115
120
 
@@ -122,17 +127,22 @@ module OpenAI
122
127
  # The public explanation for this block.
123
128
  # @param error_type
124
129
  # An optional classification; clients must accept additional values.
130
+ # @param review_target
131
+ # An opaque target for explicitly continuing this review, or null when
132
+ # unavailable.
125
133
  # @param steer
126
134
  # An optional public continuation instruction.
127
135
  def initialize: (
128
136
  ?detailed_explanation: String,
129
137
  ?error_type: OpenAI::Models::Responses::ResponseError::Misalignment::error_type,
138
+ ?review_target: String?,
130
139
  ?steer: OpenAI::Responses::ResponseError::Misalignment::Steer
131
140
  ) -> void
132
141
 
133
142
  def to_hash: -> {
134
143
  ?detailed_explanation: String,
135
144
  ?error_type: OpenAI::Models::Responses::ResponseError::Misalignment::error_type,
145
+ ?review_target: String?,
136
146
  ?steer: OpenAI::Responses::ResponseError::Misalignment::Steer
137
147
  }
138
148
 
@@ -3074,6 +3074,7 @@ module OpenAI
3074
3074
  {
3075
3075
  ?detailed_explanation: String,
3076
3076
  ?error_type: OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::error_type,
3077
+ ?review_target: String?,
3077
3078
  ?steer: OpenAI::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::Steer
3078
3079
  }
3079
3080
 
@@ -3092,6 +3093,10 @@ module OpenAI
3092
3093
  OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::error_type
3093
3094
  ) -> OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::error_type
3094
3095
 
3096
+ # An opaque target for explicitly continuing this review, or null when
3097
+ # unavailable.
3098
+ attr_accessor review_target: String?
3099
+
3095
3100
  # An optional public continuation instruction.
3096
3101
  attr_reader steer: OpenAI::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::Steer?
3097
3102
 
@@ -3104,17 +3109,22 @@ module OpenAI
3104
3109
  # The public explanation for this block.
3105
3110
  # @param error_type
3106
3111
  # An optional classification; clients must accept additional values.
3112
+ # @param review_target
3113
+ # An opaque target for explicitly continuing this review, or null when
3114
+ # unavailable.
3107
3115
  # @param steer
3108
3116
  # An optional public continuation instruction.
3109
3117
  def initialize: (
3110
3118
  ?detailed_explanation: String,
3111
3119
  ?error_type: OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::error_type,
3120
+ ?review_target: String?,
3112
3121
  ?steer: OpenAI::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::Steer
3113
3122
  ) -> void
3114
3123
 
3115
3124
  def to_hash: -> {
3116
3125
  ?detailed_explanation: String,
3117
3126
  ?error_type: OpenAI::Models::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::error_type,
3127
+ ?review_target: String?,
3118
3128
  ?steer: OpenAI::Responses::ResponsesServerEvent::ResponseWsError::Error::Misalignment::Steer
3119
3129
  }
3120
3130
 
@@ -641,9 +641,10 @@ module OpenAI
641
641
  OpenAI::Models::Responses::Tool::ImageGeneration::background
642
642
  ) -> OpenAI::Models::Responses::Tool::ImageGeneration::background
643
643
 
644
- # Controls fidelity to the original input image(s). This parameter is supported
645
- # for GPT image models that support input fidelity. `gpt-image-2` and
646
- # `gpt-image-2-2026-04-21` ignore this parameter.
644
+ # Control how much effort the model will exert to match the style and features,
645
+ # especially facial features, of input images. Supports `high` and `low` on
646
+ # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
647
+ # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
647
648
  attr_accessor input_fidelity: OpenAI::Models::Responses::Tool::ImageGeneration::input_fidelity?
648
649
 
649
650
  # Optional mask for inpainting. Contains `image_url` (string, optional) and
@@ -757,9 +758,10 @@ module OpenAI
757
758
  # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
758
759
  # set the output format to `png` or `webp`.
759
760
  # @param input_fidelity
760
- # Controls fidelity to the original input image(s). This parameter is supported
761
- # for GPT image models that support input fidelity. `gpt-image-2` and
762
- # `gpt-image-2-2026-04-21` ignore this parameter.
761
+ # Control how much effort the model will exert to match the style and features,
762
+ # especially facial features, of input images. Supports `high` and `low` on
763
+ # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
764
+ # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
763
765
  # @param input_image_mask
764
766
  # Optional mask for inpainting. Contains `image_url` (string, optional) and
765
767
  # `file_id` (string, optional).
@@ -54,6 +54,7 @@ module OpenAI
54
54
  {
55
55
  ?detailed_explanation: String,
56
56
  ?error_type: OpenAI::Models::VideoCreateError::Misalignment::error_type,
57
+ ?review_target: String?,
57
58
  ?steer: OpenAI::VideoCreateError::Misalignment::Steer
58
59
  }
59
60
 
@@ -72,6 +73,10 @@ module OpenAI
72
73
  OpenAI::Models::VideoCreateError::Misalignment::error_type
73
74
  ) -> OpenAI::Models::VideoCreateError::Misalignment::error_type
74
75
 
76
+ # An opaque target for explicitly continuing this review, or null when
77
+ # unavailable.
78
+ attr_accessor review_target: String?
79
+
75
80
  # An optional public continuation instruction.
76
81
  attr_reader steer: OpenAI::VideoCreateError::Misalignment::Steer?
77
82
 
@@ -84,17 +89,22 @@ module OpenAI
84
89
  # The public explanation for this block.
85
90
  # @param error_type
86
91
  # An optional classification; clients must accept additional values.
92
+ # @param review_target
93
+ # An opaque target for explicitly continuing this review, or null when
94
+ # unavailable.
87
95
  # @param steer
88
96
  # An optional public continuation instruction.
89
97
  def initialize: (
90
98
  ?detailed_explanation: String,
91
99
  ?error_type: OpenAI::Models::VideoCreateError::Misalignment::error_type,
100
+ ?review_target: String?,
92
101
  ?steer: OpenAI::VideoCreateError::Misalignment::Steer
93
102
  ) -> void
94
103
 
95
104
  def to_hash: -> {
96
105
  ?detailed_explanation: String,
97
106
  ?error_type: OpenAI::Models::VideoCreateError::Misalignment::error_type,
107
+ ?review_target: String?,
98
108
  ?steer: OpenAI::VideoCreateError::Misalignment::Steer
99
109
  }
100
110
 
@@ -0,0 +1,24 @@
1
+ module OpenAI
2
+ module Resources
3
+ class Beta
4
+ class Agents
5
+ class Sessions
6
+ class Turns
7
+ class Items
8
+ def list: (
9
+ String turn_id,
10
+ session_id: String,
11
+ ?after: String,
12
+ ?limit: Integer,
13
+ ?order: OpenAI::Models::Beta::Agents::Sessions::Turns::ItemListParams::order,
14
+ ?request_options: OpenAI::request_opts
15
+ ) -> OpenAI::Internal::ConversationCursorPage[OpenAI::Models::Beta::agent_session_item]
16
+
17
+ def initialize: (client: OpenAI::Client) -> void
18
+ end
19
+ end
20
+ end
21
+ end
22
+ end
23
+ end
24
+ end
@@ -4,6 +4,8 @@ module OpenAI
4
4
  class Agents
5
5
  class Sessions
6
6
  class Turns
7
+ attr_reader items: OpenAI::Resources::Beta::Agents::Sessions::Turns::Items
8
+
7
9
  def retrieve: (
8
10
  String turn_id,
9
11
  session_id: String,
@@ -29,6 +29,7 @@ module OpenAI
29
29
  environment: OpenAI::Models::Beta::environment_param,
30
30
  ?agent: OpenAI::Beta::Agents::SessionCreateParams::Agent,
31
31
  ?agent_id: String,
32
+ ?tool_handlers: ::Hash[String, OpenAI::Helpers::Agents::tool_handler],
32
33
  ?output_type: singleton(OpenAI::Helpers::StructuredOutput::BaseModel)?,
33
34
  ?input: OpenAI::Models::Beta::Agents::SessionCreateParams::input?,
34
35
  ?metadata: ::Hash[Symbol, String]?,