Missing Summary Type on reasoning parameter for reasoning model calls

[rezabrizi]

Confirm this is a Node library issue and not an underlying OpenAI API issue

• This is an issue with the Node library

Describe the bug

Reasoning Summary generation by reasoning models requires the parameter summary to be enabled. However, the current sdk has generate_summary which is not the valid option. This returns a 400 error. When trying to pass summary it causes typescript to yell at you due to invalid types.

export interface Reasoning {
  /**
   * **o-series models only**
   *
   * Constrains effort on reasoning for
   * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
   * supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
   * result in faster responses and fewer tokens used on reasoning in a response.
   */
  effort?: ReasoningEffort | null;

  /**
   * **computer_use_preview only**
   *
   * A summary of the reasoning performed by the model. This can be useful for
   * debugging and understanding the model's reasoning process. One of `concise` or
   * `detailed`.
   */
  generate_summary?: 'concise' | 'detailed' | null;

To Reproduce

const stream = await openai.responses
      .stream({
        model: "o4-mini",
        input: [
          {
            role: "system",
            content: "You are helpful!",
          }
        ],
        text: {
          format: sampleSchema,
        },
        reasoning: {
          effort: "low",
//generate_summary is the invalid parameter
          generate_summary: "concise",
        },
      }).on("response.reasoning_summary_text.delta", (event) => {
        const delta = event.delta;
      });
// this is invalid because response.reasoning_summary_text.delta does not exist on the event types



// To fix I currently do: 


const stream = await openai.responses
      .stream({
        model: "o4-mini",
        input: [
          {
            role: "system",
            content: "You are helpful!",
          }
        ],
        text: {
          format: sampleSchema,
        },
        reasoning: {
          effort: "low",
          summary: "auto",
        } as any,
      }).on("response.reasoning_summary_text.delta" as any, (event: any) => {
        const delta = event.delta as string;
      });

Code snippets

OS

macOS

Node version

v18.20.4

Library version

@4.96.0

[RobertCraigie]

Thanks for the report but it looks like generate_summary is marked as deprecated and that summary does exist? Are you sure you're on the latest version?