@cartanova/qgrid-ai-sdk 2.9.5 → 2.9.6

package/README.md

@@ -220,7 +220,7 @@ const { text } = await generateText({
 | `serviceTier` | `string` | OpenAI only | OpenAI/codex service tier |
 | `timeoutMs` | positive integer, max `1_800_000` | Anthropic only | Server-side Claude Code process timeout in milliseconds. The SDK's non-stream HTTP budget is 60 seconds longer. Defaults to 240 seconds |
 | `imageGeneration` | `boolean` | OpenAI only, non-stream | Enables codex's built-in `image_generation` tool (see [below](#image-generation)) |
-| `imageGenerationOptions` | `{ quality?, size?, background? }` | OpenAI only | Image controls; `background: "transparent"` selects standalone Images. Read actual size/quality from response metadata ([below](#image-generation)). |
+| `imageGenerationOptions` | `{ quality?, size?, background?, outputFormat? }` | OpenAI only | Image controls; `outputFormat` selects PNG/JPEG/WebP on Responses. `background: "transparent"` selects standalone Images (PNG only). Read actual size/quality from response metadata ([below](#image-generation)). |
 | `fallbackModels` | `string[]` | reserved | Reserved for future qgrid server-side fallback routing. Not functional yet and unrelated to Claude Code's Fable refusal fallback |
 
 ```typescript
@@ -270,14 +270,16 @@ const result = await generateText({
   providerOptions: {
     qgrid: {
       imageGeneration: true,
-      imageGenerationOptions: { quality: "medium", size: "1536x1024" },
+      imageGenerationOptions: { quality: "medium", size: "1536x1024", outputFormat: "webp" },
     },
   },
 });
 
-const image = result.files[0]; // mediaType: "image/png", base64
+const image = result.files[0]; // mediaType: "image/webp", base64
 ```
 
+Since 2.9.6, `imageGenerationOptions.outputFormat` accepts `"png" | "jpeg" | "webp"`; omission keeps PNG. qgrid preserves the returned image format in `mediaType` rather than converting the image. Save files with the matching extension. Transparent background requests only support PNG and reject JPEG/WebP before generation. `result.files[].mediaType` retains the AI SDK standard `string` type; no qgrid-specific wrapper or type assertion is needed.
+
 Reference images can be passed through normal AI SDK multimodal message parts:
 
 ```typescript

package/dist/index.d.ts

@@ -66,11 +66,12 @@ type QgridOpenAIProviderOptions = QgridCommonProviderOptions & {
    */
   imageGeneration?: boolean;
   /**
-   * Image generation hint and cost-estimation basis. The image model is fixed
-   * to gpt-image-2; qgrid accepts supported quality/size pairs from OpenAI's
-   * public calculator table.
+   * Image generation controls. The Responses backend selects the image model;
+   * quality/size cost estimates use the GPT Image 2 public calculator table.
    */
   imageGenerationOptions?: {
+    /** Responses output format. Defaults to PNG; transparent output only supports PNG. */
+    outputFormat?: "png" | "jpeg" | "webp";
     quality?: "low" | "medium" | "high";
     size?: "1024x1024" | "1024x1536" | "1536x1024";
     /** Transparent uses Codex standalone Images and validates PNG alpha. See README for limits. */

package/dist/index.js

@@ -1237,7 +1237,7 @@ function qgrid(modelId, config) {
 				});
 				else if (item.type === "image") content.push({
 					type: "file",
-					mediaType: "image/png",
+					mediaType: item.mediaType ?? "image/png",
 					data: item.data,
 					...item.generation ? { providerMetadata: { qgrid: { imageGeneration: item.generation } } } : {}
 				});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cartanova/qgrid-ai-sdk",
-  "version": "2.9.5",
+  "version": "2.9.6",
   "description": "AI SDK LanguageModelV3 provider for qgrid",
   "repository": {
     "type": "git",