openai 0.91.0 → 0.93.0

data/sig/openai/models/batch_create_params.rbs

@@ -14,20 +14,79 @@ module OpenAI
       extend OpenAI::Internal::Type::RequestParameters::Converter
       include OpenAI::Internal::Type::RequestParameters
 
+      # The time frame within which the batch should be processed. Currently only `24h`
+      # is supported.
       attr_accessor completion_window: OpenAI::Models::BatchCreateParams::completion_window
 
+      # The endpoint to be used for all requests in the batch. Currently
+      # `/v1/responses`, `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`,
+      # `/v1/moderations`, `/v1/images/generations`, `/v1/images/edits`, and
+      # `/v1/videos` are supported. Note that `/v1/embeddings` batches are also
+      # restricted to a maximum of 50,000 embedding inputs across all requests in the
+      # batch.
       attr_accessor endpoint: OpenAI::Models::BatchCreateParams::endpoint
 
+      # The ID of an uploaded file that contains requests for the new batch.
+      #
+      # See
+      # [upload file](https://developers.openai.com/api/reference/resources/files/methods/create)
+      # for how to upload a file.
+      #
+      # Your input file must be formatted as a
+      # [JSONL file](https://developers.openai.com/api/docs/guides/batch#1-prepare-your-batch-file),
+      # and must be uploaded with the purpose `batch`. The file can contain up to 50,000
+      # requests, and can be up to 200 MB in size.
       attr_accessor input_file_id: String
 
+      # Set of 16 key-value pairs that can be attached to an object. This can be useful
+      # for storing additional information about the object in a structured format, and
+      # querying for objects via API or the dashboard.
+      #
+      # Keys are strings with a maximum length of 64 characters. Values are strings with
+      # a maximum length of 512 characters.
       attr_accessor metadata: OpenAI::Models::metadata?
 
+      # The expiration policy for the output and/or error file that are generated for a
+      # batch.
       attr_reader output_expires_after: OpenAI::BatchCreateParams::OutputExpiresAfter?
 
+      # The expiration policy for the output and/or error file that are generated for a
+      # batch.
       def output_expires_after=: (
         OpenAI::BatchCreateParams::OutputExpiresAfter
       ) -> OpenAI::BatchCreateParams::OutputExpiresAfter
 
+      # @param completion_window
+      #   The time frame within which the batch should be processed. Currently only `24h`
+      #   is supported.
+      # @param endpoint
+      #   The endpoint to be used for all requests in the batch. Currently
+      #   `/v1/responses`, `/v1/chat/completions`, `/v1/embeddings`, `/v1/completions`,
+      #   `/v1/moderations`, `/v1/images/generations`, `/v1/images/edits`, and
+      #   `/v1/videos` are supported. Note that `/v1/embeddings` batches are also
+      #   restricted to a maximum of 50,000 embedding inputs across all requests in the
+      #   batch.
+      # @param input_file_id
+      #   The ID of an uploaded file that contains requests for the new batch.
+      #
+      #   See
+      #   [upload file](https://developers.openai.com/api/reference/resources/files/methods/create)
+      #   for how to upload a file.
+      #
+      #   Your input file must be formatted as a
+      #   [JSONL file](https://developers.openai.com/api/docs/guides/batch#1-prepare-your-batch-file),
+      #   and must be uploaded with the purpose `batch`. The file can contain up to 50,000
+      #   requests, and can be up to 200 MB in size.
+      # @param metadata
+      #   Set of 16 key-value pairs that can be attached to an object. This can be useful
+      #   for storing additional information about the object in a structured format, and
+      #   querying for objects via API or the dashboard.
+      #
+      #   Keys are strings with a maximum length of 64 characters. Values are strings with
+      #   a maximum length of 512 characters.
+      # @param output_expires_after
+      #   The expiration policy for the output and/or error file that are generated for a
+      #   batch.
       def initialize: (
         completion_window: OpenAI::Models::BatchCreateParams::completion_window,
         endpoint: OpenAI::Models::BatchCreateParams::endpoint,
@@ -84,10 +143,22 @@ module OpenAI
       type output_expires_after = { ?anchor: :created_at, seconds: Integer }
 
       class OutputExpiresAfter < OpenAI::Internal::Type::BaseModel
+        # Anchor timestamp after which the expiration policy applies. Supported anchors:
+        # `created_at`. Note that the anchor is the file creation time, not the time the
+        # batch is created.
         attr_accessor anchor: :created_at
 
+        # The number of seconds after the anchor time that the file will expire. Must be
+        # between 3600 (1 hour) and 2592000 (30 days).
         attr_accessor seconds: Integer
 
+        # @param seconds
+        #   The number of seconds after the anchor time that the file will expire. Must be
+        #   between 3600 (1 hour) and 2592000 (30 days).
+        # @param anchor
+        #   Anchor timestamp after which the expiration policy applies. Supported anchors:
+        #   `created_at`. Note that the anchor is the file creation time, not the time the
+        #   batch is created.
         def initialize: (seconds: Integer, ?anchor: :created_at) -> void
 
         def to_hash: -> { ?anchor: :created_at, seconds: Integer }

data/sig/openai/models/batch_error.rbs

@@ -4,18 +4,32 @@ module OpenAI
       { ?code: String, ?line: Integer?, ?message: String, ?param: String? }
 
     class BatchError < OpenAI::Internal::Type::BaseModel
+      # An error code identifying the error type.
       attr_reader code: String?
 
+      # An error code identifying the error type.
       def code=: (String) -> String
 
+      # The line number of the input file where the error occurred, if applicable.
       attr_accessor line: Integer?
 
+      # A human-readable message providing more details about the error.
       attr_reader message: String?
 
+      # A human-readable message providing more details about the error.
       def message=: (String) -> String
 
+      # The name of the parameter that caused the error, if applicable.
       attr_accessor param: String?
 
+      # @param code
+      #   An error code identifying the error type.
+      # @param line
+      #   The line number of the input file where the error occurred, if applicable.
+      # @param message
+      #   A human-readable message providing more details about the error.
+      # @param param
+      #   The name of the parameter that caused the error, if applicable.
       def initialize: (
         ?code: String,
         ?line: Integer?,

data/sig/openai/models/batch_list_params.rbs

@@ -11,14 +11,34 @@ module OpenAI
       extend OpenAI::Internal::Type::RequestParameters::Converter
       include OpenAI::Internal::Type::RequestParameters
 
+      # A cursor for use in pagination. `after` is an object ID that defines your place
+      # in the list. For instance, if you make a list request and receive 100 objects,
+      # ending with obj_foo, your subsequent call can include after=obj_foo in order to
+      # fetch the next page of the list.
       attr_reader after: String?
 
+      # A cursor for use in pagination. `after` is an object ID that defines your place
+      # in the list. For instance, if you make a list request and receive 100 objects,
+      # ending with obj_foo, your subsequent call can include after=obj_foo in order to
+      # fetch the next page of the list.
       def after=: (String) -> String
 
+      # A limit on the number of objects to be returned. Limit can range between 1 and
+      # 100, and the default is 20.
       attr_reader limit: Integer?
 
+      # A limit on the number of objects to be returned. Limit can range between 1 and
+      # 100, and the default is 20.
       def limit=: (Integer) -> Integer
 
+      # @param after
+      #   A cursor for use in pagination. `after` is an object ID that defines your place
+      #   in the list. For instance, if you make a list request and receive 100 objects,
+      #   ending with obj_foo, your subsequent call can include after=obj_foo in order to
+      #   fetch the next page of the list.
+      # @param limit
+      #   A limit on the number of objects to be returned. Limit can range between 1 and
+      #   100, and the default is 20.
       def initialize: (
         ?after: String,
         ?limit: Integer,

data/sig/openai/models/batch_request_counts.rbs

@@ -4,12 +4,21 @@ module OpenAI
       { completed: Integer, failed: Integer, total: Integer }
 
     class BatchRequestCounts < OpenAI::Internal::Type::BaseModel
+      # Number of requests that have been completed successfully.
       attr_accessor completed: Integer
 
+      # Number of requests that have failed.
       attr_accessor failed: Integer
 
+      # Total number of requests in the batch.
       attr_accessor total: Integer
 
+      # @param completed
+      #   Number of requests that have been completed successfully.
+      # @param failed
+      #   Number of requests that have failed.
+      # @param total
+      #   Total number of requests in the batch.
       def initialize: (
         completed: Integer,
         failed: Integer,

data/sig/openai/models/batch_usage.rbs

@@ -10,16 +10,31 @@ module OpenAI
       }
 
     class BatchUsage < OpenAI::Internal::Type::BaseModel
+      # The number of input tokens.
       attr_accessor input_tokens: Integer
 
+      # A detailed breakdown of the input tokens.
       attr_accessor input_tokens_details: OpenAI::BatchUsage::InputTokensDetails
 
+      # The number of output tokens.
       attr_accessor output_tokens: Integer
 
+      # A detailed breakdown of the output tokens.
       attr_accessor output_tokens_details: OpenAI::BatchUsage::OutputTokensDetails
 
+      # The total number of tokens used.
       attr_accessor total_tokens: Integer
 
+      # @param input_tokens
+      #   The number of input tokens.
+      # @param input_tokens_details
+      #   A detailed breakdown of the input tokens.
+      # @param output_tokens
+      #   The number of output tokens.
+      # @param output_tokens_details
+      #   A detailed breakdown of the output tokens.
+      # @param total_tokens
+      #   The total number of tokens used.
       def initialize: (
         input_tokens: Integer,
         input_tokens_details: OpenAI::BatchUsage::InputTokensDetails,
@@ -39,8 +54,13 @@ module OpenAI
       type input_tokens_details = { cached_tokens: Integer }
 
       class InputTokensDetails < OpenAI::Internal::Type::BaseModel
+        # The number of tokens that were retrieved from the cache.
+        # [More on prompt caching](https://developers.openai.com/api/docs/guides/prompt-caching).
         attr_accessor cached_tokens: Integer
 
+        # @param cached_tokens
+        #   The number of tokens that were retrieved from the cache.
+        #   [More on prompt caching](https://developers.openai.com/api/docs/guides/prompt-caching).
         def initialize: (cached_tokens: Integer) -> void
 
         def to_hash: -> { cached_tokens: Integer }
@@ -49,8 +69,11 @@ module OpenAI
       type output_tokens_details = { reasoning_tokens: Integer }
 
       class OutputTokensDetails < OpenAI::Internal::Type::BaseModel
+        # The number of reasoning tokens.
         attr_accessor reasoning_tokens: Integer
 
+        # @param reasoning_tokens
+        #   The number of reasoning tokens.
         def initialize: (reasoning_tokens: Integer) -> void
 
         def to_hash: -> { reasoning_tokens: Integer }

data/sig/openai/models/beta/agent.rbs

@@ -19,32 +19,73 @@ module OpenAI
         }
 
       class Agent < OpenAI::Internal::Type::BaseModel
+        # The ID of the reusable agent.
         attr_accessor id: String
 
+        # The Unix timestamp, in seconds, when the agent was created.
         attr_accessor created_at: Integer
 
+        # Custom instructions appended to the agent's default base instructions.
         attr_accessor instructions: String?
 
+        # Custom string key-value pairs attached to the agent.
         attr_accessor metadata: ::Hash[Symbol, String]
 
+        # The requested model name used for inference.
         attr_accessor model: String
 
+        # The resolved configuration for creating and coordinating subagents.
         attr_accessor multi_agent: OpenAI::Beta::MultiAgentConfig
 
+        # A human-readable name for the agent, or null if it is unnamed.
         attr_accessor name: String?
 
+        # The object type. Always `agent`.
         attr_accessor object: :agent
 
+        # The resolved reasoning configuration, including the model default for an omitted
+        # effort.
         attr_accessor reasoning: OpenAI::Beta::AgentReasoning
 
+        # The resolved service-tier policy used for model requests.
         attr_accessor service_tier: OpenAI::Models::Beta::Agent::service_tier
 
+        # The resolved configuration for text generated by the agent.
         attr_accessor text: OpenAI::Beta::AgentText
 
+        # Tools available to the agent.
         attr_accessor tools: ::Array[OpenAI::Models::Beta::persisted_agent_tool]
 
+        # The Unix timestamp, in seconds, when the agent was last updated.
         attr_accessor updated_at: Integer
 
+        # @param id
+        #   The ID of the reusable agent.
+        # @param created_at
+        #   The Unix timestamp, in seconds, when the agent was created.
+        # @param instructions
+        #   Custom instructions appended to the agent's default base instructions.
+        # @param metadata
+        #   Custom string key-value pairs attached to the agent.
+        # @param model
+        #   The requested model name used for inference.
+        # @param multi_agent
+        #   The resolved configuration for creating and coordinating subagents.
+        # @param name
+        #   A human-readable name for the agent, or null if it is unnamed.
+        # @param reasoning
+        #   The resolved reasoning configuration, including the model default for an omitted
+        #   effort.
+        # @param service_tier
+        #   The resolved service-tier policy used for model requests.
+        # @param text
+        #   The resolved configuration for text generated by the agent.
+        # @param tools
+        #   Tools available to the agent.
+        # @param updated_at
+        #   The Unix timestamp, in seconds, when the agent was last updated.
+        # @param object
+        #   The object type. Always `agent`.
         def initialize: (
           id: String,
           created_at: Integer,

data/sig/openai/models/beta/agent_close_subagent_call_item.rbs

@@ -12,18 +12,36 @@ module OpenAI
         }
 
       class AgentCloseSubagentCallItem < OpenAI::Internal::Type::BaseModel
+        # The ID of the tool call item.
         attr_accessor id: String
 
+        # The ID of the agent to close.
         attr_accessor recipient_agent_id: String
 
+        # The ID of the agent requesting the close.
         attr_accessor sender_agent_id: String
 
+        # The status of the tool call.
         attr_accessor status: OpenAI::Models::Beta::agent_function_call_status
 
+        # The ID of the turn that contains this item.
         attr_accessor turn_id: String
 
+        # The item type. Always `close_subagent_call`.
         attr_accessor type: :close_subagent_call
 
+        # @param id
+        #   The ID of the tool call item.
+        # @param recipient_agent_id
+        #   The ID of the agent to close.
+        # @param sender_agent_id
+        #   The ID of the agent requesting the close.
+        # @param status
+        #   The status of the tool call.
+        # @param turn_id
+        #   The ID of the turn that contains this item.
+        # @param type
+        #   The item type. Always `close_subagent_call`.
         def initialize: (
           id: String,
           recipient_agent_id: String,

data/sig/openai/models/beta/agent_command_execution_item.rbs

@@ -15,24 +15,51 @@ module OpenAI
         }
 
       class AgentCommandExecutionItem < OpenAI::Internal::Type::BaseModel
+        # The ID of the command execution item.
         attr_accessor id: String
 
+        # The command that was executed.
         attr_accessor command: String
 
+        # The working directory used to execute the command.
         attr_accessor cwd: String?
 
+        # The command duration in milliseconds.
         attr_accessor duration_ms: Integer?
 
+        # The process exit code, if the command completed.
         attr_accessor exit_code: Integer?
 
+        # The command output, if available.
         attr_accessor output: String?
 
+        # The status of the command execution.
         attr_accessor status: OpenAI::Models::Beta::agent_function_call_status
 
+        # The ID of the turn that contains this item.
         attr_accessor turn_id: String
 
+        # The item type. Always `command_execution`.
         attr_accessor type: :command_execution
 
+        # @param id
+        #   The ID of the command execution item.
+        # @param command
+        #   The command that was executed.
+        # @param cwd
+        #   The working directory used to execute the command.
+        # @param duration_ms
+        #   The command duration in milliseconds.
+        # @param exit_code
+        #   The process exit code, if the command completed.
+        # @param output
+        #   The command output, if available.
+        # @param status
+        #   The status of the command execution.
+        # @param turn_id
+        #   The ID of the turn that contains this item.
+        # @param type
+        #   The item type. Always `command_execution`.
         def initialize: (
           id: String,
           command: String,

data/sig/openai/models/beta/agent_content.rbs

@@ -11,10 +11,16 @@ module OpenAI
           { encrypted_content: String, ?type: :encrypted_content }
 
         class EncryptedContent < OpenAI::Internal::Type::BaseModel
+          # The encrypted content payload.
           attr_accessor encrypted_content: String
 
+          # The content type. Always `encrypted_content`.
           attr_accessor type: :encrypted_content
 
+          # @param encrypted_content
+          #   The encrypted content payload.
+          # @param type
+          #   The content type. Always `encrypted_content`.
           def initialize: (
             encrypted_content: String,
             ?type: :encrypted_content

data/sig/openai/models/beta/agent_create_params.rbs

@@ -19,24 +19,59 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # The model to use for the agent. The requested model name is preserved.
         attr_accessor model: String
 
+        # Additional instructions appended to the agent's default base instructions. Omit
+        # or set to null to add no custom instructions.
         attr_accessor instructions: String?
 
+        # Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+        # characters. Omission or null defaults to an empty map.
         attr_accessor metadata: ::Hash[Symbol, String]?
 
+        # Configuration for creating and coordinating subagents. Subagent tools are
+        # disabled by default.
         attr_accessor multi_agent: OpenAI::Beta::MultiAgentConfigParam?
 
+        # A human-readable name for the agent. Omission or null leaves the agent unnamed.
         attr_accessor name: String?
 
+        # Configuration for model reasoning. Omission uses the model's default effort.
         attr_accessor reasoning: OpenAI::Beta::AgentReasoningParam?
 
+        # The service tier used for model requests. Defaults to `auto`.
         attr_accessor service_tier: OpenAI::Models::Beta::AgentCreateParams::service_tier?
 
+        # Configuration for generated text. Defaults to the `text` format and medium
+        # verbosity.
         attr_accessor text: OpenAI::Beta::AgentTextParam?
 
+        # Tools available to the agent. Defaults to an empty list.
         attr_accessor tools: ::Array[OpenAI::Models::Beta::persisted_agent_tool_param]?
 
+        # @param model
+        #   The model to use for the agent. The requested model name is preserved.
+        # @param instructions
+        #   Additional instructions appended to the agent's default base instructions. Omit
+        #   or set to null to add no custom instructions.
+        # @param metadata
+        #   Up to 16 string key-value pairs, with keys up to 64 and values up to 512
+        #   characters. Omission or null defaults to an empty map.
+        # @param multi_agent
+        #   Configuration for creating and coordinating subagents. Subagent tools are
+        #   disabled by default.
+        # @param name
+        #   A human-readable name for the agent. Omission or null leaves the agent unnamed.
+        # @param reasoning
+        #   Configuration for model reasoning. Omission uses the model's default effort.
+        # @param service_tier
+        #   The service tier used for model requests. Defaults to `auto`.
+        # @param text
+        #   Configuration for generated text. Defaults to the `text` format and medium
+        #   verbosity.
+        # @param tools
+        #   Tools available to the agent. Defaults to an empty list.
         def initialize: (
           model: String,
           ?instructions: String?,

data/sig/openai/models/beta/agent_create_subagent_call_item.rbs

@@ -14,22 +14,46 @@ module OpenAI
         }
 
       class AgentCreateSubagentCallItem < OpenAI::Internal::Type::BaseModel
+        # The ID of the tool call item.
         attr_accessor id: String
 
+        # The ID of the agent that requested the subagent.
         attr_accessor agent_id: String
 
+        # The task given to the spawned agent.
         attr_accessor content: ::Array[OpenAI::Models::Beta::agent_content]
 
+        # The model requested for the spawned agent.
         attr_accessor model: String?
 
+        # The reasoning effort requested for the spawned agent.
         attr_accessor reasoning_effort: String?
 
+        # The status of the tool call.
         attr_accessor status: OpenAI::Models::Beta::agent_function_call_status
 
+        # The ID of the turn that contains this item.
         attr_accessor turn_id: String
 
+        # The item type. Always `create_subagent_call`.
         attr_accessor type: :create_subagent_call
 
+        # @param id
+        #   The ID of the tool call item.
+        # @param agent_id
+        #   The ID of the agent that requested the subagent.
+        # @param content
+        #   The task given to the spawned agent.
+        # @param model
+        #   The model requested for the spawned agent.
+        # @param reasoning_effort
+        #   The reasoning effort requested for the spawned agent.
+        # @param status
+        #   The status of the tool call.
+        # @param turn_id
+        #   The ID of the turn that contains this item.
+        # @param type
+        #   The item type. Always `create_subagent_call`.
         def initialize: (
           id: String,
           agent_id: String,

data/sig/openai/models/beta/agent_deleted.rbs

@@ -5,12 +5,21 @@ module OpenAI
         { id: String, deleted: bool, ?object: :"agent.deleted" }
 
       class AgentDeleted < OpenAI::Internal::Type::BaseModel
+        # The ID of the deleted agent.
         attr_accessor id: String
 
+        # Whether the agent was deleted. Always `true`.
         attr_accessor deleted: bool
 
+        # The object type. Always `agent.deleted`.
         attr_accessor object: :"agent.deleted"
 
+        # @param id
+        #   The ID of the deleted agent.
+        # @param deleted
+        #   Whether the agent was deleted. Always `true`.
+        # @param object
+        #   The object type. Always `agent.deleted`.
         def initialize: (
           id: String,
           deleted: bool,

data/sig/openai/models/beta/agent_function_call_item.rbs

@@ -13,20 +13,41 @@ module OpenAI
         }
 
       class AgentFunctionCallItem < OpenAI::Internal::Type::BaseModel
+        # The ID of the function call item.
         attr_accessor id: String
 
+        # The arguments to pass to the function.
         attr_accessor arguments: top
 
+        # The ID used to submit the function result.
         attr_accessor call_id: String
 
+        # The name of the function to call.
         attr_accessor name: String
 
+        # The status of the function call.
         attr_accessor status: OpenAI::Models::Beta::agent_function_call_status
 
+        # The ID of the turn that contains this item.
         attr_accessor turn_id: String
 
+        # The item type. Always `function_call`.
         attr_accessor type: :function_call
 
+        # @param id
+        #   The ID of the function call item.
+        # @param arguments
+        #   The arguments to pass to the function.
+        # @param call_id
+        #   The ID used to submit the function result.
+        # @param name
+        #   The name of the function to call.
+        # @param status
+        #   The status of the function call.
+        # @param turn_id
+        #   The ID of the turn that contains this item.
+        # @param type
+        #   The item type. Always `function_call`.
         def initialize: (
           id: String,
           arguments: top,

data/sig/openai/models/beta/agent_interrupt_subagent_call_item.rbs

@@ -12,18 +12,36 @@ module OpenAI
         }
 
       class AgentInterruptSubagentCallItem < OpenAI::Internal::Type::BaseModel
+        # The ID of the tool call item.
         attr_accessor id: String
 
+        # The ID of the agent to interrupt.
         attr_accessor recipient_agent_id: String
 
+        # The ID of the agent requesting the interrupt.
         attr_accessor sender_agent_id: String
 
+        # The status of the tool call.
         attr_accessor status: OpenAI::Models::Beta::agent_function_call_status
 
+        # The ID of the turn that contains this item.
         attr_accessor turn_id: String
 
+        # The item type. Always `interrupt_subagent_call`.
         attr_accessor type: :interrupt_subagent_call
 
+        # @param id
+        #   The ID of the tool call item.
+        # @param recipient_agent_id
+        #   The ID of the agent to interrupt.
+        # @param sender_agent_id
+        #   The ID of the agent requesting the interrupt.
+        # @param status
+        #   The status of the tool call.
+        # @param turn_id
+        #   The ID of the turn that contains this item.
+        # @param type
+        #   The item type. Always `interrupt_subagent_call`.
         def initialize: (
           id: String,
           recipient_agent_id: String,

data/sig/openai/models/beta/agent_list_params.rbs

@@ -13,18 +13,29 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # Return resources after this resource ID in the selected order.
         attr_reader after: String?
 
+        # Return resources after this resource ID in the selected order.
         def after=: (String) -> String
 
+        # The maximum number of resources to return.
         attr_accessor limit: Integer?
 
+        # The order in which resources are returned. Defaults to `desc`.
         attr_reader order: OpenAI::Models::Beta::AgentListParams::order?
 
+        # The order in which resources are returned. Defaults to `desc`.
         def order=: (
           OpenAI::Models::Beta::AgentListParams::order
         ) -> OpenAI::Models::Beta::AgentListParams::order
 
+        # @param after
+        #   Return resources after this resource ID in the selected order.
+        # @param limit
+        #   The maximum number of resources to return.
+        # @param order
+        #   The order in which resources are returned. Defaults to `desc`.
         def initialize: (
           ?after: String,
           ?limit: Integer?,