openai 0.127.0 → 0.128.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 (54) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +17 -0
  3. data/README.md +1 -1
  4. data/lib/openai/helpers/agents/session_stream.rb +8 -3
  5. data/lib/openai/helpers/beta/agents/result.rb +12 -4
  6. data/lib/openai/models/beta/agent_session.rb +1 -43
  7. data/lib/openai/models/beta/agent_session_event.rb +1 -4
  8. data/lib/openai/models/beta/agents/session_create_params.rb +1 -33
  9. data/lib/openai/models/beta/agents/session_update_params.rb +1 -33
  10. data/lib/openai/models/beta/session_turn_error.rb +0 -3
  11. data/lib/openai/models/csam_moderation.rb +131 -0
  12. data/lib/openai/models/csam_moderation_response.rb +27 -0
  13. data/lib/openai/models/live/mcp_require_approval_filter.rb +28 -0
  14. data/lib/openai/models/live/mcp_tool.rb +181 -0
  15. data/lib/openai/models/live/mcp_tool_filter.rb +28 -0
  16. data/lib/openai/models/live/responses_delegation_config.rb +7 -14
  17. data/lib/openai/models/live/responses_delegation_update_config.rb +7 -14
  18. data/lib/openai/models.rb +4 -0
  19. data/lib/openai/resources/beta/agents/sessions/events.rb +1 -1
  20. data/lib/openai/resources/beta/agents/sessions.rb +3 -15
  21. data/lib/openai/version.rb +1 -1
  22. data/lib/openai.rb +5 -1
  23. data/rbi/openai/models/beta/agent_session.rbi +1 -70
  24. data/rbi/openai/models/beta/agent_session_event.rbi +0 -1
  25. data/rbi/openai/models/beta/agents/session_create_params.rbi +0 -56
  26. data/rbi/openai/models/beta/agents/session_update_params.rbi +0 -56
  27. data/rbi/openai/models/beta/session_turn_error.rbi +0 -3
  28. data/rbi/openai/models/csam_moderation.rbi +248 -0
  29. data/rbi/openai/models/csam_moderation_response.rbi +56 -0
  30. data/rbi/openai/models/live/mcp_require_approval_filter.rbi +64 -0
  31. data/rbi/openai/models/live/mcp_tool.rbi +253 -0
  32. data/rbi/openai/models/live/mcp_tool_filter.rbi +58 -0
  33. data/rbi/openai/models/live/responses_delegation_config.rbi +7 -39
  34. data/rbi/openai/models/live/responses_delegation_update_config.rbi +7 -39
  35. data/rbi/openai/models.rbi +4 -0
  36. data/rbi/openai/resources/beta/agents/sessions.rbi +0 -12
  37. data/sig/openai/models/beta/agent_session.rbs +3 -44
  38. data/sig/openai/models/beta/agent_session_event.rbs +0 -1
  39. data/sig/openai/models/beta/agents/session_create_params.rbs +0 -23
  40. data/sig/openai/models/beta/agents/session_update_params.rbs +0 -23
  41. data/sig/openai/models/beta/session_turn_error.rbs +0 -4
  42. data/sig/openai/models/csam_moderation.rbs +113 -0
  43. data/sig/openai/models/csam_moderation_response.rbs +30 -0
  44. data/sig/openai/models/live/mcp_require_approval_filter.rbs +33 -0
  45. data/sig/openai/models/live/mcp_tool.rbs +159 -0
  46. data/sig/openai/models/live/mcp_tool_filter.rbs +27 -0
  47. data/sig/openai/models/live/responses_delegation_config.rbs +5 -11
  48. data/sig/openai/models/live/responses_delegation_update_config.rbs +5 -11
  49. data/sig/openai/models.rbs +4 -0
  50. data/sig/openai/resources/beta/agents/sessions.rbs +0 -3
  51. metadata +16 -4
  52. data/lib/openai/models/beta/agent_session_budget_reached_event.rb +0 -48
  53. data/rbi/openai/models/beta/agent_session_budget_reached_event.rbi +0 -83
  54. data/sig/openai/models/beta/agent_session_budget_reached_event.rbs +0 -52
@@ -0,0 +1,181 @@
1
+ # frozen_string_literal: true
2
+
3
+ module OpenAI
4
+ module Models
5
+ module Live
6
+ class McpTool < OpenAI::Internal::Type::BaseModel
7
+ # @!attribute type
8
+ #
9
+ # @return [Symbol, :mcp]
10
+ required :type, const: :mcp
11
+
12
+ # @!attribute allowed_callers
13
+ # The tool invocation context(s).
14
+ #
15
+ # @return [Array<Symbol, OpenAI::Models::Live::McpTool::AllowedCaller>, nil]
16
+ optional(
17
+ :allowed_callers,
18
+ -> { OpenAI::Internal::Type::ArrayOf[enum: OpenAI::Live::McpTool::AllowedCaller] },
19
+ nil?: true
20
+ )
21
+
22
+ # @!attribute allowed_tools
23
+ # A list of MCP tool names that are allowed for this server.
24
+ #
25
+ # @return [Array<String>, OpenAI::Models::Live::McpToolFilter, nil]
26
+ optional :allowed_tools, union: -> { OpenAI::Live::McpTool::AllowedTools }, nil?: true
27
+
28
+ # @!attribute connector_id
29
+ # @deprecated
30
+ #
31
+ # The ID of a built-in MCP connector. This field is deprecated for models released
32
+ # after September 1, 2026. Use `server_url` to connect to a remote MCP server, or
33
+ # `tunnel_id` to connect to a local MCP server.
34
+ #
35
+ # @return [String, nil]
36
+ optional :connector_id, String, nil?: true
37
+
38
+ # @!attribute defer_loading
39
+ # Whether this MCP tool should be deferred and discovered via tool search.
40
+ #
41
+ # @return [Boolean, nil]
42
+ optional :defer_loading, OpenAI::Internal::Type::Boolean, nil?: true
43
+
44
+ # @!attribute require_approval
45
+ # Controls which MCP tools require explicit user approval before execution.
46
+ #
47
+ # @return [OpenAI::Models::Live::McpRequireApprovalFilter, Symbol, OpenAI::Models::Live::McpTool::RequireApproval::LiveMCPRequireApprovalAPIEnum, nil]
48
+ optional :require_approval, union: -> { OpenAI::Live::McpTool::RequireApproval }, nil?: true
49
+
50
+ # @!attribute server_description
51
+ # An optional human-readable description of the MCP server.
52
+ #
53
+ # @return [String, nil]
54
+ optional :server_description, String, nil?: true
55
+
56
+ # @!attribute server_label
57
+ # A label used to identify the MCP server.
58
+ #
59
+ # @return [String, nil]
60
+ optional :server_label, String
61
+
62
+ # @!attribute server_url
63
+ # The URL of the MCP server to connect to.
64
+ #
65
+ # @return [String, nil]
66
+ optional :server_url, String, nil?: true
67
+
68
+ # @!attribute tunnel_id
69
+ # The Secure MCP Tunnel ID to use instead of a direct server URL.
70
+ #
71
+ # @return [String, nil]
72
+ optional :tunnel_id, String, nil?: true
73
+
74
+ request_only do
75
+ # @!attribute authorization
76
+ # This value is omitted from returned Live session data.
77
+ #
78
+ # @return [String, nil]
79
+ optional :authorization, String, nil?: true
80
+
81
+ # @!attribute headers
82
+ # Optional HTTP headers to send when connecting to the MCP server.
83
+ #
84
+ # @return [Hash{Symbol=>String}, nil]
85
+ optional :headers, OpenAI::Internal::Type::HashOf[String], nil?: true
86
+ end
87
+
88
+ # @!method initialize(allowed_callers: nil, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_label: nil, server_url: nil, tunnel_id: nil, type: :mcp)
89
+ # @param allowed_callers [Array<Symbol, OpenAI::Models::Live::McpTool::AllowedCaller>, nil]
90
+ # The tool invocation context(s).
91
+ #
92
+ # @param allowed_tools [Array<String>, OpenAI::Models::Live::McpToolFilter, nil]
93
+ # A list of MCP tool names that are allowed for this server.
94
+ #
95
+ # @param authorization [String, nil]
96
+ # This value is omitted from returned Live session data.
97
+ #
98
+ # @param connector_id [String, nil]
99
+ # The ID of a built-in MCP connector. This field is deprecated for models released
100
+ # after September 1, 2026. Use `server_url` to connect to a remote MCP server, or
101
+ # `tunnel_id` to connect to a local MCP server.
102
+ #
103
+ # @param defer_loading [Boolean, nil]
104
+ # Whether this MCP tool should be deferred and discovered via tool search.
105
+ #
106
+ # @param headers [Hash{Symbol=>String}, nil]
107
+ # Optional HTTP headers to send when connecting to the MCP server.
108
+ #
109
+ # @param require_approval [OpenAI::Models::Live::McpRequireApprovalFilter, Symbol, OpenAI::Models::Live::McpTool::RequireApproval::LiveMCPRequireApprovalAPIEnum, nil]
110
+ # Controls which MCP tools require explicit user approval before execution.
111
+ #
112
+ # @param server_description [String, nil]
113
+ # An optional human-readable description of the MCP server.
114
+ #
115
+ # @param server_label [String]
116
+ # A label used to identify the MCP server.
117
+ #
118
+ # @param server_url [String, nil]
119
+ # The URL of the MCP server to connect to.
120
+ #
121
+ # @param tunnel_id [String, nil]
122
+ # The Secure MCP Tunnel ID to use instead of a direct server URL.
123
+ #
124
+ # @param type [Symbol, :mcp]
125
+
126
+ module AllowedCaller
127
+ extend OpenAI::Internal::Type::Enum
128
+
129
+ DIRECT = :direct
130
+ PROGRAMMATIC = :programmatic
131
+
132
+ # @!method self.values
133
+ # @return [Array<Symbol>]
134
+ end
135
+
136
+ # A list of MCP tool names that are allowed for this server.
137
+ #
138
+ # @see OpenAI::Models::Live::McpTool#allowed_tools
139
+ module AllowedTools
140
+ extend OpenAI::Internal::Type::Union
141
+
142
+ variant -> { OpenAI::Models::Live::McpTool::AllowedTools::StringArray }
143
+
144
+ variant -> { OpenAI::Live::McpToolFilter }
145
+
146
+ # @!method self.variants
147
+ # @return [Array(Array<String>, OpenAI::Models::Live::McpToolFilter)]
148
+
149
+ # @type [OpenAI::Internal::Type::Converter]
150
+ StringArray = OpenAI::Internal::Type::ArrayOf[String]
151
+ end
152
+
153
+ # Controls which MCP tools require explicit user approval before execution.
154
+ #
155
+ # @see OpenAI::Models::Live::McpTool#require_approval
156
+ module RequireApproval
157
+ extend OpenAI::Internal::Type::Union
158
+
159
+ variant -> { OpenAI::Live::McpRequireApprovalFilter }
160
+
161
+ # Default approval behavior for MCP tool calls.
162
+ variant enum: -> { OpenAI::Live::McpTool::RequireApproval::LiveMCPRequireApprovalAPIEnum }
163
+
164
+ # Default approval behavior for MCP tool calls.
165
+ module LiveMCPRequireApprovalAPIEnum
166
+ extend OpenAI::Internal::Type::Enum
167
+
168
+ ALWAYS = :always
169
+ NEVER = :never
170
+
171
+ # @!method self.values
172
+ # @return [Array<Symbol>]
173
+ end
174
+
175
+ # @!method self.variants
176
+ # @return [Array(OpenAI::Models::Live::McpRequireApprovalFilter, Symbol, OpenAI::Models::Live::McpTool::RequireApproval::LiveMCPRequireApprovalAPIEnum)]
177
+ end
178
+ end
179
+ end
180
+ end
181
+ end
@@ -0,0 +1,28 @@
1
+ # frozen_string_literal: true
2
+
3
+ module OpenAI
4
+ module Models
5
+ module Live
6
+ class McpToolFilter < OpenAI::Internal::Type::BaseModel
7
+ # @!attribute read_only
8
+ # Whether to allow only read-only tools for matching entries.
9
+ #
10
+ # @return [Boolean, nil]
11
+ optional :read_only, OpenAI::Internal::Type::Boolean, nil?: true
12
+
13
+ # @!attribute tool_names
14
+ # A list of tool names to match against.
15
+ #
16
+ # @return [Array<String>, nil]
17
+ optional :tool_names, OpenAI::Internal::Type::ArrayOf[String], nil?: true
18
+
19
+ # @!method initialize(read_only: nil, tool_names: nil)
20
+ # @param read_only [Boolean, nil]
21
+ # Whether to allow only read-only tools for matching entries.
22
+ #
23
+ # @param tool_names [Array<String>, nil]
24
+ # A list of tool names to match against.
25
+ end
26
+ end
27
+ end
28
+ end
@@ -60,7 +60,7 @@ module OpenAI
60
60
  # Tools available to the Responses backend while it handles tasks delegated by the
61
61
  # Live model.
62
62
  #
63
- # @return [Array<OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::WebSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::FileSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::CodeInterpreter, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Shell, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ImageGeneration, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Mcp, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Custom, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Namespace, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ToolSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ProgrammaticToolCalling, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Computer, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ApplyPatch>, nil]
63
+ # @return [Array<OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::WebSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::FileSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::CodeInterpreter, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Shell, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ImageGeneration, OpenAI::Models::Live::McpTool, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Custom, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Namespace, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ToolSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ProgrammaticToolCalling, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Computer, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ApplyPatch>, nil]
64
64
  optional(
65
65
  :tools,
66
66
  -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Live::ResponsesDelegationConfig::Tool] }
@@ -98,7 +98,7 @@ module OpenAI
98
98
  # Controls which tool the Responses backend uses when handling a task delegated by
99
99
  # the Live model.
100
100
  #
101
- # @param tools [Array<OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::WebSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::FileSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::CodeInterpreter, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Shell, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ImageGeneration, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Mcp, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Custom, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Namespace, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ToolSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ProgrammaticToolCalling, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Computer, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ApplyPatch>]
101
+ # @param tools [Array<OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::WebSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::FileSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::CodeInterpreter, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Shell, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ImageGeneration, OpenAI::Models::Live::McpTool, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Custom, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Namespace, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ToolSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ProgrammaticToolCalling, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Computer, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ApplyPatch>]
102
102
  # Tools available to the Responses backend while it handles tasks delegated by the
103
103
  # Live model.
104
104
 
@@ -772,6 +772,9 @@ module OpenAI
772
772
  module Tool
773
773
  extend OpenAI::Internal::Type::Union
774
774
 
775
+ require_relative "mcp_tool"
776
+ Mcp = ::OpenAI::Models::Live::McpTool
777
+
775
778
  discriminator :type
776
779
 
777
780
  # A function tool available to the Responses backend when the Live model delegates a task.
@@ -789,7 +792,7 @@ module OpenAI
789
792
 
790
793
  variant :image_generation, -> { OpenAI::Live::ResponsesDelegationConfig::Tool::ImageGeneration }
791
794
 
792
- variant :mcp, -> { OpenAI::Live::ResponsesDelegationConfig::Tool::Mcp }
795
+ variant :mcp, -> { OpenAI::Live::McpTool }
793
796
 
794
797
  variant :custom, -> { OpenAI::Live::ResponsesDelegationConfig::Tool::Custom }
795
798
 
@@ -1246,16 +1249,6 @@ module OpenAI
1246
1249
  # @param type [Symbol, :image_generation]
1247
1250
  end
1248
1251
 
1249
- class Mcp < OpenAI::Internal::Type::BaseModel
1250
- # @!attribute type
1251
- #
1252
- # @return [Symbol, :mcp]
1253
- required :type, const: :mcp
1254
-
1255
- # @!method initialize(type: :mcp)
1256
- # @param type [Symbol, :mcp]
1257
- end
1258
-
1259
1252
  class Custom < OpenAI::Internal::Type::BaseModel
1260
1253
  # @!attribute type
1261
1254
  #
@@ -1317,7 +1310,7 @@ module OpenAI
1317
1310
  end
1318
1311
 
1319
1312
  # @!method self.variants
1320
- # @return [Array(OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::WebSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::FileSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::CodeInterpreter, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Shell, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ImageGeneration, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Mcp, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Custom, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Namespace, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ToolSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ProgrammaticToolCalling, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Computer, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ApplyPatch)]
1313
+ # @return [Array(OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::WebSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::FileSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::CodeInterpreter, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Shell, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ImageGeneration, OpenAI::Models::Live::McpTool, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Custom, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Namespace, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ToolSearch, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ProgrammaticToolCalling, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::Computer, OpenAI::Models::Live::ResponsesDelegationConfig::Tool::ApplyPatch)]
1321
1314
  end
1322
1315
  end
1323
1316
  end
@@ -65,7 +65,7 @@ module OpenAI
65
65
  # Tools available to the Responses backend while it handles tasks delegated by the
66
66
  # Live model.
67
67
  #
68
- # @return [Array<OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::WebSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::FileSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::CodeInterpreter, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Shell, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ImageGeneration, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Mcp, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Custom, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Namespace, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ToolSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ProgrammaticToolCalling, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Computer, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ApplyPatch>, nil]
68
+ # @return [Array<OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::WebSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::FileSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::CodeInterpreter, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Shell, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ImageGeneration, OpenAI::Models::Live::McpTool, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Custom, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Namespace, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ToolSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ProgrammaticToolCalling, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Computer, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ApplyPatch>, nil]
69
69
  optional(
70
70
  :tools,
71
71
  -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Live::ResponsesDelegationUpdateConfig::Tool] }
@@ -104,7 +104,7 @@ module OpenAI
104
104
  # Controls which tool the Responses backend uses when handling a task delegated by
105
105
  # the Live model.
106
106
  #
107
- # @param tools [Array<OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::WebSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::FileSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::CodeInterpreter, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Shell, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ImageGeneration, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Mcp, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Custom, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Namespace, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ToolSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ProgrammaticToolCalling, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Computer, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ApplyPatch>]
107
+ # @param tools [Array<OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::WebSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::FileSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::CodeInterpreter, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Shell, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ImageGeneration, OpenAI::Models::Live::McpTool, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Custom, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Namespace, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ToolSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ProgrammaticToolCalling, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Computer, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ApplyPatch>]
108
108
  # Tools available to the Responses backend while it handles tasks delegated by the
109
109
  # Live model.
110
110
 
@@ -782,6 +782,9 @@ module OpenAI
782
782
  module Tool
783
783
  extend OpenAI::Internal::Type::Union
784
784
 
785
+ require_relative "mcp_tool"
786
+ Mcp = ::OpenAI::Models::Live::McpTool
787
+
785
788
  discriminator :type
786
789
 
787
790
  # A function tool available to the Responses backend when the Live model delegates a task.
@@ -799,7 +802,7 @@ module OpenAI
799
802
 
800
803
  variant :image_generation, -> { OpenAI::Live::ResponsesDelegationUpdateConfig::Tool::ImageGeneration }
801
804
 
802
- variant :mcp, -> { OpenAI::Live::ResponsesDelegationUpdateConfig::Tool::Mcp }
805
+ variant :mcp, -> { OpenAI::Live::McpTool }
803
806
 
804
807
  variant :custom, -> { OpenAI::Live::ResponsesDelegationUpdateConfig::Tool::Custom }
805
808
 
@@ -1290,16 +1293,6 @@ module OpenAI
1290
1293
  # @param type [Symbol, :image_generation]
1291
1294
  end
1292
1295
 
1293
- class Mcp < OpenAI::Internal::Type::BaseModel
1294
- # @!attribute type
1295
- #
1296
- # @return [Symbol, :mcp]
1297
- required :type, const: :mcp
1298
-
1299
- # @!method initialize(type: :mcp)
1300
- # @param type [Symbol, :mcp]
1301
- end
1302
-
1303
1296
  class Custom < OpenAI::Internal::Type::BaseModel
1304
1297
  # @!attribute type
1305
1298
  #
@@ -1361,7 +1354,7 @@ module OpenAI
1361
1354
  end
1362
1355
 
1363
1356
  # @!method self.variants
1364
- # @return [Array(OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::WebSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::FileSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::CodeInterpreter, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Shell, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ImageGeneration, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Mcp, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Custom, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Namespace, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ToolSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ProgrammaticToolCalling, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Computer, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ApplyPatch)]
1357
+ # @return [Array(OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::WebSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::FileSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::CodeInterpreter, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Shell, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ImageGeneration, OpenAI::Models::Live::McpTool, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Custom, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Namespace, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ToolSearch, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ProgrammaticToolCalling, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::Computer, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::ApplyPatch)]
1365
1358
  end
1366
1359
  end
1367
1360
  end
data/lib/openai/models.rb CHANGED
@@ -111,6 +111,10 @@ module OpenAI
111
111
 
112
112
  CreateEmbeddingResponse = OpenAI::Models::CreateEmbeddingResponse
113
113
 
114
+ CsamModeration = OpenAI::Models::CsamModeration
115
+
116
+ CsamModerationResponse = OpenAI::Models::CsamModerationResponse
117
+
114
118
  CustomToolInputFormat = OpenAI::Models::CustomToolInputFormat
115
119
 
116
120
  Decision = OpenAI::Models::Decision
@@ -61,7 +61,7 @@ module OpenAI
61
61
  #
62
62
  # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
63
63
  #
64
- # @return [OpenAI::Internal::Stream<OpenAI::Models::Beta::AgentSessionErrorEvent, OpenAI::Models::Beta::AgentSessionEnvironmentReadyEvent, OpenAI::Models::Beta::AgentSessionEnvironmentSuspendedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentExpiredEvent, OpenAI::Models::Beta::AgentSessionEnvironmentResetEvent, OpenAI::Models::Beta::AgentOutputCommandExecutionOutputDeltaEvent, OpenAI::Models::Beta::AgentSessionCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnInProgressEvent, OpenAI::Models::Beta::AgentSessionTurnCompletedEvent, OpenAI::Models::Beta::AgentSessionTurnFailedEvent, OpenAI::Models::Beta::AgentSessionTurnCancelledEvent, OpenAI::Models::Beta::AgentSessionTurnItemAddedEvent, OpenAI::Models::Beta::AgentSessionIdleEvent, OpenAI::Models::Beta::AgentSessionBudgetReachedEvent, OpenAI::Models::Beta::AgentSessionInProgressEvent, OpenAI::Models::Beta::AgentSessionRequiresActionEvent, OpenAI::Models::Beta::AgentSessionFailedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentPendingEvent, OpenAI::Models::Beta::AgentSessionEnvironmentConnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentDisconnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentFailedEvent, OpenAI::Models::Beta::AgentSessionSubagentCreatedEvent, OpenAI::Models::Beta::AgentSessionSubagentActiveEvent, OpenAI::Models::Beta::AgentSessionSubagentClosedEvent, OpenAI::Models::Beta::AgentSessionTurnItemDoneEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDoneEvent>]
64
+ # @return [OpenAI::Internal::Stream<OpenAI::Models::Beta::AgentSessionErrorEvent, OpenAI::Models::Beta::AgentSessionEnvironmentReadyEvent, OpenAI::Models::Beta::AgentSessionEnvironmentSuspendedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentExpiredEvent, OpenAI::Models::Beta::AgentSessionEnvironmentResetEvent, OpenAI::Models::Beta::AgentOutputCommandExecutionOutputDeltaEvent, OpenAI::Models::Beta::AgentSessionCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnCreatedEvent, OpenAI::Models::Beta::AgentSessionTurnInProgressEvent, OpenAI::Models::Beta::AgentSessionTurnCompletedEvent, OpenAI::Models::Beta::AgentSessionTurnFailedEvent, OpenAI::Models::Beta::AgentSessionTurnCancelledEvent, OpenAI::Models::Beta::AgentSessionTurnItemAddedEvent, OpenAI::Models::Beta::AgentSessionIdleEvent, OpenAI::Models::Beta::AgentSessionInProgressEvent, OpenAI::Models::Beta::AgentSessionRequiresActionEvent, OpenAI::Models::Beta::AgentSessionFailedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentPendingEvent, OpenAI::Models::Beta::AgentSessionEnvironmentConnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentDisconnectedEvent, OpenAI::Models::Beta::AgentSessionEnvironmentFailedEvent, OpenAI::Models::Beta::AgentSessionSubagentCreatedEvent, OpenAI::Models::Beta::AgentSessionSubagentActiveEvent, OpenAI::Models::Beta::AgentSessionSubagentClosedEvent, OpenAI::Models::Beta::AgentSessionTurnItemDoneEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnContentPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnOutputTextDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartAddedEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryPartDoneEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDeltaEvent, OpenAI::Models::Beta::AgentSessionTurnReasoningSummaryTextDoneEvent>]
65
65
  #
66
66
  # @see OpenAI::Models::Beta::Agents::Sessions::EventStreamParams
67
67
  def stream_streaming(session_id, params = {})
@@ -32,7 +32,7 @@ module OpenAI
32
32
  # the session or streams its events when stream is true. See
33
33
  # [running sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions).
34
34
  #
35
- # @overload create(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, prompt_cache_options: nil, review: nil, spend_control: nil, stream_options: nil, vault_ids: nil, request_options: {})
35
+ # @overload create(environment:, agent: nil, agent_id: nil, input: nil, metadata: nil, prompt_cache_options: nil, review: nil, stream_options: nil, vault_ids: nil, request_options: {})
36
36
  #
37
37
  # @param environment [OpenAI::Models::Beta::EnvironmentParam::None, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted, OpenAI::Models::Beta::EnvironmentParam::SelfHosted]
38
38
  # An inline execution environment or a reference to an environment template.
@@ -62,10 +62,6 @@ module OpenAI
62
62
  # @param review [Symbol, OpenAI::Models::Beta::Agents::SessionCreateParams::Review]
63
63
  # Action review mode. Omit to use none.
64
64
  #
65
- # @param spend_control [OpenAI::Models::Beta::Agents::SessionCreateParams::SpendControl, nil]
66
- # Optional spending limit in USD cents. Omission or null creates an unlimited
67
- # session.
68
- #
69
65
  # @param stream_options [OpenAI::Models::Beta::Agents::SessionCreateParams::StreamOptions]
70
66
  # Options for the event stream. Only allowed when `stream` is `true`.
71
67
  #
@@ -102,7 +98,7 @@ module OpenAI
102
98
  # the session or streams its events when stream is true. See
103
99
  # [running sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions).
104
100
  #
105
- # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, output_type: nil, tool_handlers: {}, metadata: nil, prompt_cache_options: nil, review: nil, spend_control: nil, stream_options: nil, vault_ids: nil, request_options: {})
101
+ # @overload create_streaming(environment:, agent: nil, agent_id: nil, input: nil, output_type: nil, tool_handlers: {}, metadata: nil, prompt_cache_options: nil, review: nil, stream_options: nil, vault_ids: nil, request_options: {})
106
102
  #
107
103
  # @param environment [OpenAI::Models::Beta::EnvironmentParam::None, OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted, OpenAI::Models::Beta::EnvironmentParam::SelfHosted]
108
104
  # An inline execution environment or a reference to an environment template.
@@ -132,10 +128,6 @@ module OpenAI
132
128
  # @param review [Symbol, OpenAI::Models::Beta::Agents::SessionCreateParams::Review]
133
129
  # Action review mode. Omit to use none.
134
130
  #
135
- # @param spend_control [OpenAI::Models::Beta::Agents::SessionCreateParams::SpendControl, nil]
136
- # Optional spending limit in USD cents. Omission or null creates an unlimited
137
- # session.
138
- #
139
131
  # @param stream_options [OpenAI::Models::Beta::Agents::SessionCreateParams::StreamOptions]
140
132
  # Options for the event stream. Only allowed when `stream` is `true`.
141
133
  #
@@ -214,7 +206,7 @@ module OpenAI
214
206
  # fields are unchanged. See
215
207
  # [managing sessions](https://developers.openai.com/api/docs/guides/agents-api/sessions/manage).
216
208
  #
217
- # @overload update(session_id, agent: nil, metadata: nil, prompt_cache_options: nil, review: nil, spend_control: nil, request_options: {})
209
+ # @overload update(session_id, agent: nil, metadata: nil, prompt_cache_options: nil, review: nil, request_options: {})
218
210
  #
219
211
  # @param session_id [String]
220
212
  # The ID of the session.
@@ -235,10 +227,6 @@ module OpenAI
235
227
  # Default action review for new root turns. Existing turns and their subagents
236
228
  # keep their review mode.
237
229
  #
238
- # @param spend_control [OpenAI::Models::Beta::Agents::SessionUpdateParams::SpendControl, nil]
239
- # Omit to retain the limit; null or a null limit removes it without resetting
240
- # spend.
241
- #
242
230
  # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
243
231
  #
244
232
  # @return [OpenAI::Models::Beta::AgentSession]
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module OpenAI
4
- VERSION = "0.127.0"
4
+ VERSION = "0.128.0"
5
5
  end
data/lib/openai.rb CHANGED
@@ -624,7 +624,6 @@ require_relative "openai/models/beta/agents/vault_update_params"
624
624
  require_relative "openai/models/beta/agent_send_subagent_input_call_item"
625
625
  require_relative "openai/models/beta/agent_session"
626
626
  require_relative "openai/models/beta/agent_session_assistant_message"
627
- require_relative "openai/models/beta/agent_session_budget_reached_event"
628
627
  require_relative "openai/models/beta/agent_session_created_event"
629
628
  require_relative "openai/models/beta/agent_session_deleted"
630
629
  require_relative "openai/models/beta/agent_session_environment_connected_event"
@@ -1024,6 +1023,8 @@ require_relative "openai/models/conversations/refusal_content"
1024
1023
  require_relative "openai/models/conversations/summary_text_content"
1025
1024
  require_relative "openai/models/conversations/text_content"
1026
1025
  require_relative "openai/models/create_embedding_response"
1026
+ require_relative "openai/models/csam_moderation"
1027
+ require_relative "openai/models/csam_moderation_response"
1027
1028
  require_relative "openai/models/custom_tool_input_format"
1028
1029
  require_relative "openai/models/decision"
1029
1030
  require_relative "openai/models/decision_create_params"
@@ -1182,6 +1183,9 @@ require_relative "openai/models/live/instructions_appended_event"
1182
1183
  require_relative "openai/models/live/instructions_append_event"
1183
1184
  require_relative "openai/models/live/live_create_params"
1184
1185
  require_relative "openai/models/live/live_create_response"
1186
+ require_relative "openai/models/live/mcp_require_approval_filter"
1187
+ require_relative "openai/models/live/mcp_tool"
1188
+ require_relative "openai/models/live/mcp_tool_filter"
1185
1189
  require_relative "openai/models/live/media_session_config"
1186
1190
  require_relative "openai/models/live/media_session_fork_config"
1187
1191
  require_relative "openai/models/live/output_audio_delta_event"
@@ -84,15 +84,6 @@ module OpenAI
84
84
  sig { params(review: OpenAI::Beta::AgentSession::Review::OrSymbol).void }
85
85
  attr_writer :review
86
86
 
87
- # Spending limit and best-effort consumption, in USD cents. Present when
88
- # spending-control visibility is enabled; limit is null without a cap. Older
89
- # server responses may omit this object.
90
- sig { returns(T.nilable(OpenAI::Beta::AgentSession::SpendControl)) }
91
- attr_reader :spend_control
92
-
93
- sig { params(spend_control: OpenAI::Beta::AgentSession::SpendControl::OrHash).void }
94
- attr_writer :spend_control
95
-
96
87
  # A Managed Agents session.
97
88
  sig do
98
89
  params(
@@ -134,8 +125,6 @@ module OpenAI
134
125
 
135
126
  review: OpenAI::Beta::AgentSession::Review::OrSymbol,
136
127
 
137
- spend_control: OpenAI::Beta::AgentSession::SpendControl::OrHash,
138
-
139
128
  object: Symbol
140
129
  )
141
130
  .returns(T.attached_class)
@@ -183,11 +172,6 @@ module OpenAI
183
172
  # and automatic review is not enabled. Omission means none.
184
173
  review: nil,
185
174
 
186
- # Spending limit and best-effort consumption, in USD cents. Present when
187
- # spending-control visibility is enabled; limit is null without a cap. Older
188
- # server responses may omit this object.
189
- spend_control: nil,
190
-
191
175
  # The object type. Always `agent.session`.
192
176
 
193
177
  object: :"agent.session"
@@ -210,8 +194,7 @@ module OpenAI
210
194
  usage: T.nilable(OpenAI::Beta::TokenUsage),
211
195
  vault_ids: T::Array[String],
212
196
  prompt_cache_options: T.nilable(OpenAI::Beta::AgentSession::PromptCacheOptions),
213
- review: OpenAI::Beta::AgentSession::Review::TaggedSymbol,
214
- spend_control: OpenAI::Beta::AgentSession::SpendControl
197
+ review: OpenAI::Beta::AgentSession::Review::TaggedSymbol
215
198
  }
216
199
  )
217
200
  end
@@ -1150,9 +1133,6 @@ module OpenAI
1150
1133
  # The session failed.
1151
1134
  FAILED = T.let(:failed, OpenAI::Beta::AgentSession::Status::TaggedSymbol)
1152
1135
 
1153
- # The session is paused because its spending limit was reached.
1154
- BUDGET_REACHED = T.let(:budget_reached, OpenAI::Beta::AgentSession::Status::TaggedSymbol)
1155
-
1156
1136
  sig { override.returns(T::Array[OpenAI::Beta::AgentSession::Status::TaggedSymbol]) }
1157
1137
  def self.values
1158
1138
  end
@@ -1222,55 +1202,6 @@ module OpenAI
1222
1202
  end
1223
1203
  end
1224
1204
 
1225
- class SpendControl < OpenAI::Internal::Type::BaseModel
1226
- OrHash = T.type_alias do
1227
- T.any(
1228
- OpenAI::Beta::AgentSession::SpendControl,
1229
- OpenAI::Internal::AnyHash
1230
- )
1231
- end
1232
-
1233
- # Best-effort recorded spend floored to whole USD cents, or null when unavailable.
1234
- sig { returns(T.nilable(Integer)) }
1235
- attr_accessor :consumed
1236
-
1237
- # The configured positive limit in USD cents, or null when unlimited.
1238
- sig { returns(T.nilable(Integer)) }
1239
- attr_accessor :limit
1240
-
1241
- # Spending limit and best-effort consumption, in USD cents. Present when
1242
- # spending-control visibility is enabled; limit is null without a cap. Older
1243
- # server responses may omit this object.
1244
- sig do
1245
- params(
1246
-
1247
- consumed: T.nilable(Integer),
1248
-
1249
- limit: T.nilable(Integer)
1250
- )
1251
- .returns(T.attached_class)
1252
- end
1253
- def self.new(
1254
-
1255
- # Best-effort recorded spend floored to whole USD cents, or null when unavailable.
1256
- consumed:,
1257
-
1258
- # The configured positive limit in USD cents, or null when unlimited.
1259
-
1260
- limit:
1261
- )
1262
- end
1263
-
1264
- sig do
1265
- override.returns(
1266
- {consumed: T.nilable(Integer), limit: T.nilable(Integer)}
1267
- )
1268
- end
1269
- def to_hash
1270
- end
1271
-
1272
- end
1273
-
1274
1205
  end
1275
1206
 
1276
1207
  end
@@ -25,7 +25,6 @@ module OpenAI
25
25
  OpenAI::Beta::AgentSessionTurnCancelledEvent,
26
26
  OpenAI::Beta::AgentSessionTurnItemAddedEvent,
27
27
  OpenAI::Beta::AgentSessionIdleEvent,
28
- OpenAI::Beta::AgentSessionBudgetReachedEvent,
29
28
  OpenAI::Beta::AgentSessionInProgressEvent,
30
29
  OpenAI::Beta::AgentSessionRequiresActionEvent,
31
30
  OpenAI::Beta::AgentSessionFailedEvent,