fix(api): readd phase

stainless-app[bot] · stainless-app[bot] · commit 4a0cf2974865 · 2026-02-24T20:16:30.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 147
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-a0aa54a302fbd7fff4ed7ad8a8547587d37b63324fc4af652bfa685ee9f8da44.yml
-openapi_spec_hash: e45c5af19307cfc8b9baa4b8f8e865a0
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-ca4985bc94b25eac84a5d7538d1bdf134c9b99dae9e95f1eae0aae90130c4bf8.yml
+openapi_spec_hash: 855db4b2dbaf3f8f83afe0df66397c02
 config_hash: 7f49c38fa3abe9b7038ffe62262c4912
diff --git a/src/resources/responses/responses.ts b/src/resources/responses/responses.ts
@@ -421,6 +421,14 @@ export interface EasyInputMessage {
    */
   role: 'user' | 'assistant' | 'system' | 'developer';
 
+  /**
+   * Labels an `assistant` message as intermediate commentary (`commentary`) or the
+   * final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+   * sending follow-up requests, preserve and resend phase on all assistant messages
+   * — dropping it can degrade performance. Not used for user messages.
+   */
+  phase?: 'commentary' | null;
+
   /**
    * The type of the message input. Always `message`.
    */
@@ -4741,6 +4749,14 @@ export interface ResponseOutputMessage {
    * The type of the output message. Always `message`.
    */
   type: 'message';
+
+  /**
+   * Labels an `assistant` message as intermediate commentary (`commentary`) or the
+   * final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+   * sending follow-up requests, preserve and resend phase on all assistant messages
+   * — dropping it can degrade performance. Not used for user messages.
+   */
+  phase?: 'commentary' | null;
 }
 
 /**
@@ -7273,6 +7289,11 @@ export interface ResponseCompactParams {
    * Cannot be used in conjunction with `conversation`.
    */
   previous_response_id?: string | null;
+
+  /**
+   * A key to use when reading from or writing to the prompt cache.
+   */
+  prompt_cache_key?: string | null;
 }
 
 Responses.InputItems = InputItems;
diff --git a/tests/api-resources/conversations/conversations.test.ts b/tests/api-resources/conversations/conversations.test.ts
@@ -28,6 +28,7 @@ describe('resource conversations', () => {
             {
               content: 'string',
               role: 'user',
+              phase: 'commentary',
               type: 'message',
             },
           ],
diff --git a/tests/api-resources/conversations/items.test.ts b/tests/api-resources/conversations/items.test.ts
@@ -33,6 +33,7 @@ describe('resource items', () => {
         {
           content: 'string',
           role: 'user',
+          phase: 'commentary',
           type: 'message',
         },
       ],
diff --git a/tests/api-resources/responses/responses.test.ts b/tests/api-resources/responses/responses.test.ts
@@ -91,6 +91,7 @@ describe('resource responses', () => {
       input: 'string',
       instructions: 'instructions',
       previous_response_id: 'resp_123',
+      prompt_cache_key: 'prompt_cache_key',
     });
   });
 });

Original file line number	Diff line number	Diff line change
`@@ -28,6 +28,7 @@ describe('resource conversations', () => {`
`28`	`28`	`{`
`29`	`29`	`content: 'string',`
`30`	`30`	`role: 'user',`
	`31`	`+ phase: 'commentary',`
`31`	`32`	`type: 'message',`
`32`	`33`	`},`
`33`	`34`	`],`
Original file line number	Diff line number	Diff line change
`@@ -33,6 +33,7 @@ describe('resource items', () => {`
`33`	`33`	`{`
`34`	`34`	`content: 'string',`
`35`	`35`	`role: 'user',`
	`36`	`+ phase: 'commentary',`
`36`	`37`	`type: 'message',`
`37`	`38`	`},`
`38`	`39`	`],`