openai 0.95.0 → 0.97.0

data/rbi/openai/models/responses/responses_client_event.rbi

@@ -28,6 +28,16 @@ module OpenAI
           sig { returns(Symbol) }
           attr_accessor :type
 
+          # Domain-specific access programs to use for this request.
+          sig { returns(T.nilable(OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms)) }
+          attr_reader :access_programs
+
+          sig {
+            params(access_programs: OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::OrHash)
+              .void
+          }
+          attr_writer :access_programs
+
           # Whether to run the model response in the background.
           # [Learn more](https://developers.openai.com/api/docs/guides/background).
           sig { returns(T.nilable(T::Boolean)) }
@@ -476,6 +486,8 @@ module OpenAI
           sig do
             params(
 
+              access_programs: OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::OrHash,
+
               background: T.nilable(T::Boolean),
 
               context_management: T.nilable(
@@ -579,6 +591,9 @@ module OpenAI
           end
           def self.new(
 
+            # Domain-specific access programs to use for this request.
+            access_programs: nil,
+
             # Whether to run the model response in the background.
             # [Learn more](https://developers.openai.com/api/docs/guides/background).
             background: nil,
@@ -849,6 +864,7 @@ module OpenAI
             override.returns(
               {
                 type: Symbol,
+                access_programs: T.nilable(OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms),
                 background: T.nilable(T::Boolean),
                 context_management: T.nilable(
                   T::Array[OpenAI::Responses::ResponsesClientEvent::ResponseCreate::ContextManagement]
@@ -928,6 +944,115 @@ module OpenAI
           def to_hash
           end
 
+          class AccessPrograms < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # The Cyber access program to use for this request. Supported values are
+            # `standard`, `daybreak_blue`, and `daybreak_red`. If omitted, the API resolves
+            # the program from the model's Cyber tier and your organization and project
+            # access, subject to model-specific eligibility restrictions. By default, models
+            # without a Cyber tier use Standard. Blue-tier models use Daybreak Blue when
+            # authorized; otherwise they fall back to Standard unless the model requires
+            # Daybreak access. Red-tier models use Daybreak Red and require authorization.
+            # Requests that require unavailable Daybreak access return 403. An implicit
+            # Standard fallback is represented by null in the response's access_programs
+            # field, rather than an explicit Standard selection.
+            sig {
+              returns(
+                T.nilable(OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::Cyber::OrSymbol)
+              )
+            }
+            attr_reader :cyber
+
+            sig {
+              params(cyber: OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::Cyber::OrSymbol)
+                .void
+            }
+            attr_writer :cyber
+
+            # Domain-specific access programs to use for this request.
+            sig do
+              params(
+
+                cyber: OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::Cyber::OrSymbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # The Cyber access program to use for this request. Supported values are
+              # `standard`, `daybreak_blue`, and `daybreak_red`. If omitted, the API resolves
+              # the program from the model's Cyber tier and your organization and project
+              # access, subject to model-specific eligibility restrictions. By default, models
+              # without a Cyber tier use Standard. Blue-tier models use Daybreak Blue when
+              # authorized; otherwise they fall back to Standard unless the model requires
+              # Daybreak access. Red-tier models use Daybreak Red and require authorization.
+              # Requests that require unavailable Daybreak access return 403. An implicit
+              # Standard fallback is represented by null in the response's access_programs
+              # field, rather than an explicit Standard selection.
+
+              cyber: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  cyber: T.nilable(
+                    OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::Cyber::OrSymbol
+                  )
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # The Cyber access program to use for this request. Supported values are
+            # `standard`, `daybreak_blue`, and `daybreak_red`. If omitted, the API resolves
+            # the program from the model's Cyber tier and your organization and project
+            # access, subject to model-specific eligibility restrictions. By default, models
+            # without a Cyber tier use Standard. Blue-tier models use Daybreak Blue when
+            # authorized; otherwise they fall back to Standard unless the model requires
+            # Daybreak access. Red-tier models use Daybreak Red and require authorization.
+            # Requests that require unavailable Daybreak access return 403. An implicit
+            # Standard fallback is represented by null in the response's access_programs
+            # field, rather than an explicit Standard selection.
+            module Cyber
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol = T.type_alias {
+                T.all(Symbol, OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::Cyber)
+              }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              STANDARD = T.let(
+                :standard,
+                OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::Cyber::TaggedSymbol
+              )
+              DAYBREAK_BLUE = T.let(
+                :daybreak_blue,
+                OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::Cyber::TaggedSymbol
+              )
+              DAYBREAK_RED = T.let(
+                :daybreak_red,
+                OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::Cyber::TaggedSymbol
+              )
+
+              sig {
+                override.returns(
+                  T::Array[OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::Cyber::TaggedSymbol]
+                )
+              }
+              def self.values
+              end
+            end
+          end
+
           class ContextManagement < OpenAI::Internal::Type::BaseModel
             OrHash = T.type_alias do
               T.any(

data/rbi/openai/models/responses/web_search_preview_tool.rbi

@@ -36,7 +36,9 @@ module OpenAI
         sig { params(search_context_size: OpenAI::Responses::WebSearchPreviewTool::SearchContextSize::OrSymbol).void }
         attr_writer :search_context_size
 
-        # The user's location.
+        # The approximate location of the user. If omitted or null, defaults to the United
+        # States. To avoid this fallback, pass `{"type": "approximate"}` without location
+        # fields. To localize results, provide the relevant location fields.
         sig { returns(T.nilable(OpenAI::Responses::WebSearchPreviewTool::UserLocation)) }
         attr_reader :user_location
 
@@ -71,7 +73,9 @@ module OpenAI
           # search. One of `low`, `medium`, or `high`. `medium` is the default.
           search_context_size: nil,
 
-          # The user's location.
+          # The approximate location of the user. If omitted or null, defaults to the United
+          # States. To avoid this fallback, pass `{"type": "approximate"}` without location
+          # fields. To localize results, provide the relevant location fields.
 
           user_location: nil
         )
@@ -170,7 +174,9 @@ module OpenAI
           sig { returns(T.nilable(String)) }
           attr_accessor :timezone
 
-          # The user's location.
+          # The approximate location of the user. If omitted or null, defaults to the United
+          # States. To avoid this fallback, pass `{"type": "approximate"}` without location
+          # fields. To localize results, provide the relevant location fields.
           sig do
             params(
 

data/rbi/openai/models/responses/web_search_tool.rbi

@@ -42,7 +42,9 @@ module OpenAI
         sig { params(search_context_size: OpenAI::Responses::WebSearchTool::SearchContextSize::OrSymbol).void }
         attr_writer :search_context_size
 
-        # The approximate location of the user.
+        # The approximate location of the user. If omitted or null, defaults to the United
+        # States. To avoid this fallback, pass `{"type": "approximate"}` without location
+        # fields. To localize results, provide the relevant location fields.
         sig { returns(T.nilable(OpenAI::Responses::WebSearchTool::UserLocation)) }
         attr_reader :user_location
 
@@ -83,7 +85,9 @@ module OpenAI
           # search. One of `low`, `medium`, or `high`. `medium` is the default.
           search_context_size: nil,
 
-          # The approximate location of the user.
+          # The approximate location of the user. If omitted or null, defaults to the United
+          # States. To avoid this fallback, pass `{"type": "approximate"}` without location
+          # fields. To localize results, provide the relevant location fields.
 
           user_location: nil
         )
@@ -212,7 +216,9 @@ module OpenAI
           sig { params(type: OpenAI::Responses::WebSearchTool::UserLocation::Type::OrSymbol).void }
           attr_writer :type
 
-          # The approximate location of the user.
+          # The approximate location of the user. If omitted or null, defaults to the United
+          # States. To avoid this fallback, pass `{"type": "approximate"}` without location
+          # fields. To localize results, provide the relevant location fields.
           sig do
             params(
 

data/rbi/openai/resources/audio/transcriptions.rbi

@@ -14,7 +14,8 @@ module OpenAI
         # Transcribes audio into the input language.
         #
         # Returns a transcription object in `json`, `diarized_json`, or `verbose_json`
-        # format, or a stream of transcript events.
+        # format, plain text in `text`, `srt`, or `vtt` format, or a stream of transcript
+        # events. Supported formats depend on the model.
         sig {
           params(
             file: OpenAI::Internal::FileInput,
@@ -125,7 +126,8 @@ module OpenAI
         # Transcribes audio into the input language.
         #
         # Returns a transcription object in `json`, `diarized_json`, or `verbose_json`
-        # format, or a stream of transcript events.
+        # format, plain text in `text`, `srt`, or `vtt` format, or a stream of transcript
+        # events. Supported formats depend on the model.
         sig {
           params(
             file: OpenAI::Internal::FileInput,

data/rbi/openai/resources/beta/agents/environments/templates.rbi

@@ -17,6 +17,7 @@ module OpenAI
             sig {
               params(
                 capability_directories: T.nilable(T::Array[String]),
+                desktop: T.nilable(OpenAI::Beta::Agents::Environments::TemplateCreateParams::Desktop::OrHash),
                 env: T.nilable(T::Hash[Symbol, String]),
                 files: T.nilable(
                   T::Array[
@@ -47,6 +48,9 @@ module OpenAI
               # Directories that contain capabilities exposed to the agent. Defaults to an empty
               # list.
               capability_directories: nil,
+              # Desktop provisioning. Omission or null inherits the template setting, or
+              # defaults to disabled.
+              desktop: nil,
               # Environment variables made available to the agent.
               env: nil,
               # Files available before the agent starts. Defaults to an empty list.
@@ -54,7 +58,7 @@ module OpenAI
               # An optional human-readable display name for the template.
               name: nil,
               # Network access policy for the environment. Defaults to disabled for GA requests
-              # and enabled for alpha/beta requests.
+              # and enabled for beta requests.
               network: nil,
               # Packages to install in the environment. Defaults to empty package lists.
               packages: nil,
@@ -91,6 +95,7 @@ module OpenAI
               params(
                 environment_template_id: String,
                 capability_directories: T.nilable(T::Array[String]),
+                desktop: T.nilable(OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Desktop::OrHash),
                 env: T.nilable(T::Hash[Symbol, String]),
                 files: T.nilable(
                   T::Array[
@@ -122,6 +127,8 @@ module OpenAI
               environment_template_id,
               # Directories that expose capabilities to the agent.
               capability_directories: nil,
+              # Replacement desktop configuration, or null to disable the desktop.
+              desktop: nil,
               # Replacement confidential environment values.
               env: nil,
               # Replacement file configuration materialized for each new session.
@@ -129,8 +136,8 @@ module OpenAI
               # A replacement human-readable display name, or `null` to clear the name.
               name: nil,
               # Network access available after setup completes. Omit to preserve the current
-              # policy, or pass `null` to reset to disabled for GA requests or enabled for
-              # alpha/beta requests.
+              # policy, or pass `null` to reset to disabled for GA requests or enabled for beta
+              # requests.
               network: nil,
               # Packages installed before the runtime network policy applies.
               packages: nil,

data/rbi/openai/resources/beta/agents/sessions/events.rbi

@@ -22,6 +22,7 @@ module OpenAI
                 session_id: String,
                 events: T::Array[
                   T.any(
+                    OpenAI::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult::OrHash,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputMessage::OrHash,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputCancel::OrHash,
                     OpenAI::Beta::AgentSessionInputParam::AgentSessionInputToolResult::OrHash

data/rbi/openai/resources/beta/agents/vaults/credentials.rbi

@@ -23,6 +23,7 @@ module OpenAI
                   OpenAI::Beta::Agents::Vaults::CredentialAuthCreateParam::EnvironmentVariable::OrHash
                 ),
                 name: String,
+                metadata: T::Hash[Symbol, String],
                 request_options: OpenAI::RequestOptions::OrHash
               )
                 .returns(OpenAI::Beta::Agents::Vaults::Credential)
@@ -35,6 +36,9 @@ module OpenAI
               # The name is trimmed before storage. It must contain 1 to 256 UTF-8 bytes after
               # trimming.
               name:,
+              # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+              # characters. Defaults to an empty map.
+              metadata: nil,
               request_options: {}
             )
             end
@@ -55,8 +59,7 @@ module OpenAI
             )
             end
 
-            # Rotates a vault credential's write-only secret and returns only credential
-            # metadata. See
+            # Updates credential metadata or rotates its write-only secret. See
             # [vaults](https://developers.openai.com/api/docs/guides/agents-api/tools/vaults).
             sig {
               params(
@@ -67,6 +70,7 @@ module OpenAI
                   OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::StaticBearer::OrHash,
                   OpenAI::Beta::Agents::Vaults::CredentialAuthRotateParam::EnvironmentVariable::OrHash
                 ),
+                metadata: T::Hash[Symbol, String],
                 request_options: OpenAI::RequestOptions::OrHash
               )
                 .returns(OpenAI::Beta::Agents::Vaults::Credential)
@@ -78,7 +82,11 @@ module OpenAI
               vault_id:,
               # Body param: Replacement values for the credential's existing authentication
               # method.
-              auth:,
+              auth: nil,
+              # Body param: Replaces all metadata. Omit to preserve it, or pass {} to clear it.
+              # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+              # characters.
+              metadata: nil,
               request_options: {}
             )
             end

data/rbi/openai/resources/beta/agents.rbi

@@ -35,7 +35,8 @@ module OpenAI
                   OpenAI::Beta::PersistedAgentToolParam::ToolSearch::OrHash,
                   OpenAI::Beta::PersistedAgentToolParam::ProgrammaticToolCalling::OrHash,
                   OpenAI::Beta::PersistedAgentToolParam::Mcp::OrHash,
-                  OpenAI::Beta::PersistedAgentToolParam::WebSearch::OrHash
+                  OpenAI::Beta::PersistedAgentToolParam::WebSearch::OrHash,
+                  OpenAI::Beta::PersistedAgentToolParam::ComputerUse::OrHash
                 )
               ]
             ),
@@ -100,7 +101,8 @@ module OpenAI
                   OpenAI::Beta::PersistedAgentToolParam::ToolSearch::OrHash,
                   OpenAI::Beta::PersistedAgentToolParam::ProgrammaticToolCalling::OrHash,
                   OpenAI::Beta::PersistedAgentToolParam::Mcp::OrHash,
-                  OpenAI::Beta::PersistedAgentToolParam::WebSearch::OrHash
+                  OpenAI::Beta::PersistedAgentToolParam::WebSearch::OrHash,
+                  OpenAI::Beta::PersistedAgentToolParam::ComputerUse::OrHash
                 )
               ]
             ),

data/rbi/openai/resources/beta/responses.rbi

@@ -31,6 +31,7 @@ module OpenAI
         # to use your own data as input for the model's response.
         sig {
           params(
+            access_programs: OpenAI::Beta::ResponseCreateParams::AccessPrograms::OrHash,
             background: T.nilable(T::Boolean),
             context_management: T.nilable(T::Array[OpenAI::Beta::ResponseCreateParams::ContextManagement::OrHash]),
             conversation: T.nilable(T.any(String, OpenAI::Beta::BetaResponseConversationParam::OrHash)),
@@ -98,6 +99,8 @@ module OpenAI
             .returns(OpenAI::Beta::BetaResponse)
         }
         def create(
+          # Body param: Domain-specific access programs to use for this request.
+          access_programs: nil,
           # Body param: Whether to run the model response in the background.
           # [Learn more](https://developers.openai.com/api/docs/guides/background).
           background: nil,
@@ -346,6 +349,7 @@ module OpenAI
         # to use your own data as input for the model's response.
         sig {
           params(
+            access_programs: OpenAI::Beta::ResponseCreateParams::AccessPrograms::OrHash,
             background: T.nilable(T::Boolean),
             context_management: T.nilable(T::Array[OpenAI::Beta::ResponseCreateParams::ContextManagement::OrHash]),
             conversation: T.nilable(T.any(String, OpenAI::Beta::BetaResponseConversationParam::OrHash)),
@@ -417,6 +421,8 @@ module OpenAI
             )
         }
         def stream_raw(
+          # Body param: Domain-specific access programs to use for this request.
+          access_programs: nil,
           # Body param: Whether to run the model response in the background.
           # [Learn more](https://developers.openai.com/api/docs/guides/background).
           background: nil,

data/rbi/openai/resources/responses.rbi

@@ -29,6 +29,7 @@ module OpenAI
       # to use your own data as input for the model's response.
       sig do
         params(
+          access_programs: OpenAI::Responses::ResponseCreateParams::AccessPrograms::OrHash,
           background: T.nilable(T::Boolean),
           context_management: T.nilable(T::Array[OpenAI::Responses::ResponseCreateParams::ContextManagement::OrHash]),
           conversation: T.nilable(T.any(String, OpenAI::Responses::ResponseConversationParam::OrHash)),
@@ -97,6 +98,8 @@ module OpenAI
           .returns(OpenAI::Responses::Response)
       end
       def create(
+        # Domain-specific access programs to use for this request.
+        access_programs: nil,
         # Whether to run the model response in the background.
         # [Learn more](https://developers.openai.com/api/docs/guides/background).
         background: nil,
@@ -334,6 +337,7 @@ module OpenAI
       # to use your own data as input for the model's response.
       sig do
         params(
+          access_programs: OpenAI::Responses::ResponseCreateParams::AccessPrograms::OrHash,
           background: T.nilable(T::Boolean),
           context_management: T.nilable(T::Array[OpenAI::Responses::ResponseCreateParams::ContextManagement::OrHash]),
           conversation: T.nilable(T.any(String, OpenAI::Responses::ResponseConversationParam::OrHash)),
@@ -408,6 +412,8 @@ module OpenAI
           )
       end
       def stream_raw(
+        # Domain-specific access programs to use for this request.
+        access_programs: nil,
         # Whether to run the model response in the background.
         # [Learn more](https://developers.openai.com/api/docs/guides/background).
         background: nil,
@@ -645,6 +651,7 @@ module OpenAI
       # your own data as input for the model's response.
       sig do
         params(
+          access_programs: OpenAI::Responses::ResponseCreateParams::AccessPrograms::OrHash,
           background: T.nilable(T::Boolean),
           include: T.nilable(
             T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol]
@@ -715,6 +722,8 @@ module OpenAI
           .returns(OpenAI::Streaming::ResponseStream)
       end
       def stream(
+        # Domain-specific access programs to use for this request.
+        access_programs: nil,
         # Whether to run the model response in the background.
         # [Learn more](https://developers.openai.com/api/docs/guides/background).
         background: nil,
@@ -1134,6 +1143,7 @@ module OpenAI
         class Response
           sig do
             params(
+              access_programs: OpenAI::Responses::ResponsesClientEvent::ResponseCreate::AccessPrograms::OrHash,
               background: T.nilable(T::Boolean),
               context_management: T.nilable(
                 T::Array[OpenAI::Responses::ResponsesClientEvent::ResponseCreate::ContextManagement::OrHash]
@@ -1204,6 +1214,7 @@ module OpenAI
               .void
           end
           def create(
+            access_programs: nil,
             background: nil,
             context_management: nil,
             conversation: nil,

data/responses-websocket.md

@@ -60,6 +60,61 @@ event types arrive as `OpenAI::Responses::UnknownServerEvent`. Preserve or handl
 them explicitly where your application needs them. Do not assume every event
 has a response, text delta, or lane ID.
 
+## Receive limits
+
+The default Responses transport accepts `max_message_bytes`,
+`max_wire_message_bytes`, and `max_message_frames` in `transport_options`.
+Each is an optional positive integer; omitted or `nil` keeps its unlimited default. Choose values
+for your application's legitimate largest message, including images and tool
+results. These are caller budgets, not API limits.
+
+```ruby
+client.responses.connect(
+  transport_options: {max_message_bytes: 64 * 1024 * 1024, max_message_frames: 4_096}
+) do |connection|
+  connection.response.create(model: "gpt-5.2", input: "Hello")
+  while (event = connection.receive)
+    puts event.type
+  end
+end
+```
+
+The decoded byte budget (`max_message_bytes`) covers the payload of each complete
+message after decompression, including all its fragments. The optional wire budget
+(`max_wire_message_bytes`) covers data payload bytes before decompression across those
+fragments, excluding frame headers and control frames. A wire budget alone does
+not impose a decoded byte limit. Oversized frame headers are rejected
+before the advertised payload is read (with up to 125 bytes allowed for a legal
+interleaved control frame). The frame budget counts text, binary and continuation
+frames, including empty continuations; ping/pong and close frames don't count.
+Set both when you need to bound both payload and frame-buffer memory.
+Counters reset at the end of each message.
+
+To use WebSocket compression with independently bounded wire and decoded sizes:
+
+```ruby
+limits = {
+  max_wire_message_bytes: 8 * 1024 * 1024,
+  max_message_bytes: 64 * 1024 * 1024,
+  max_message_frames: 4_096
+}
+client.responses.connect(transport_options: limits) do |connection|
+  connection.response.create(model: "gpt-5.2", input: "Hello")
+  while (event = connection.receive)
+    puts event.type
+  end
+end
+```
+
+The server can still decline compression, in which case both byte budgets apply
+to the uncompressed message. Existing byte-only configurations continue to
+decline compression, as before; no-limit and frame-only configurations retain
+their normal compression negotiation.
+Exceeding any chosen limit aborts the socket, releases its pool slot, and
+raises `OpenAI::Errors::ResponsesConnectionError`; no requests are replayed.
+Managed sessions accept the same `transport_options`. An injected transport
+still receives its options unchanged and owns their meaning.
+
 ## Managed sessions
 
 `OpenAI::Responses::Session.open` adds routed lanes and final-response collection

data/sig/openai/helpers/live/transcript_grouper.rbs

@@ -0,0 +1,42 @@
+module OpenAI
+  module Models
+    module Live
+      class TranscriptGrouper
+        type speaker = :user | :assistant
+        type close_reason =
+          :speaker_change
+          | :inactivity
+          | :timestamp_reset
+          | :session_closed
+          | :manual
+
+        class Segment < Data
+          attr_reader id: String
+          attr_reader previous_id: String?
+          attr_reader speaker: TranscriptGrouper::speaker
+          attr_reader text: String
+          attr_reader start_ms: Integer
+          attr_reader end_ms: Integer
+        end
+
+        class ClosedSegment < Data
+          attr_reader segment: Segment
+          attr_reader reason: TranscriptGrouper::close_reason
+        end
+
+        def initialize: (
+          ?on_segment_updated: (^(Segment) -> void)?,
+          ?on_segment_closed: (^(ClosedSegment) -> void)?,
+          ?min_turn_separation_ms: Integer | Float,
+          ?assistant_silence_ms: Integer | Float,
+          ?backchannel_max_duration_ms: Integer | Float,
+          ?backchannel_isolation_ms: Integer | Float,
+          ?additional_acknowledgments: Array[String]
+        ) -> void
+
+        def push: (top event) -> void
+        def close: -> void
+      end
+    end
+  end
+end