@ai-sdk/openai 4.0.41 → 4.0.42

package/docs/03-openai.mdx

@@ -264,6 +264,9 @@ The following provider options are available:
   - `type`: `'compaction'`
   - `compactThreshold`: _number_ — the token count at which compaction is triggered
 
+- **compactionTrigger** _boolean_
+  Request explicit server-side compaction. When `true`, the provider appends a terminal `{ type: 'compaction_trigger' }` item to the Responses input. Support depends on the configured Responses-compatible endpoint and model.
+
 The OpenAI responses provider also returns provider-specific metadata:
 
 For Responses models, you can type this metadata using `OpenaiResponsesProviderMetadata`:
@@ -1776,6 +1779,38 @@ const result = await generateText({
   requests.
 </Note>
 
+##### Explicit Compaction
+
+For Responses-compatible endpoints that support explicit compaction, set
+`compactionTrigger: true`. The provider appends the required
+`{ type: 'compaction_trigger' }` request control after all converted messages
+and input items.
+
+```ts highlight="9"
+import {
+  openai,
+  type OpenAILanguageModelResponsesOptions,
+} from '@ai-sdk/openai';
+import { generateText } from 'ai';
+
+const result = await generateText({
+  model: openai.responses('gpt-5.3-codex'),
+  messages: conversationHistory,
+  providerOptions: {
+    openai: {
+      store: false,
+      compactionTrigger: true,
+    } satisfies OpenAILanguageModelResponsesOptions,
+  },
+});
+```
+
+This is distinct from `contextManagement`, which configures automatic,
+threshold-based compaction. When omitted or `false`, `compactionTrigger` does
+not add an input item. The resulting compaction output uses the existing
+`openai.compaction` custom part representation. Endpoint and model support can
+vary.
+
 ##### Detecting Compaction in Streams
 
 When using `streamText`, you can detect compaction by checking the `providerMetadata` on `text-start` and `text-end` events:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/openai",
-  "version": "4.0.41",
+  "version": "4.0.42",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -43,8 +43,8 @@
     "tsup": "^8.5.1",
     "typescript": "5.8.3",
     "zod": "3.25.76",
-    "@vercel/ai-tsconfig": "0.0.0",
-    "@ai-sdk/test-server": "2.0.1"
+    "@ai-sdk/test-server": "2.0.1",
+    "@vercel/ai-tsconfig": "0.0.0"
   },
   "peerDependencies": {
     "zod": "^3.25.76 || ^4.1.8"

package/src/responses/openai-responses-api.ts

@@ -133,7 +133,8 @@ export type OpenAIResponsesInputItem =
   | OpenAIResponsesToolSearchOutput
   | OpenAIResponsesReasoning
   | OpenAIResponsesItemReference
-  | OpenAIResponsesCompactionItem;
+  | OpenAIResponsesCompactionItem
+  | OpenAIResponsesCompactionTrigger;
 
 export type OpenAIResponsesIncludeValue =
   | 'web_search_call.action.sources'
@@ -431,6 +432,10 @@ export type OpenAIResponsesCompactionItem = {
   encrypted_content: string;
 };
 
+export type OpenAIResponsesCompactionTrigger = {
+  type: 'compaction_trigger';
+};
+
 /**
  * A filter used to compare a specified attribute key to a given value using a defined comparison operation.
  */

package/src/responses/openai-responses-language-model-options.ts

@@ -375,6 +375,12 @@ export const openaiLanguageModelResponsesOptionsSchema = lazySchema(() =>
         )
         .nullish(),
 
+      /**
+       * Request explicit server-side compaction by appending a
+       * `compaction_trigger` item to the Responses input.
+       */
+      compactionTrigger: z.boolean().optional(),
+
       /**
        * Restrict the callable tools to a subset while keeping the full tools
        * list intact, so prompt caching is preserved across requests with

package/src/responses/openai-responses-language-model.ts

@@ -369,6 +369,13 @@ export class OpenAIResponsesLanguageModel implements LanguageModelV4 {
 
     warnings.push(...inputWarnings);
 
+    // A compaction trigger is a request control, not conversation history.
+    // OpenAI requires it to be the final input item, so append it only after
+    // the complete prompt has been converted.
+    if (openaiOptions?.compactionTrigger) {
+      input.push({ type: 'compaction_trigger' });
+    }
+
     const strictJsonSchema = openaiOptions?.strictJsonSchema ?? true;
 
     let include: OpenAIResponsesIncludeOptions = openaiOptions?.include;