@cartanova/qgrid-ai-sdk 2.3.7 → 2.3.8

package/dist/index.d.ts

@@ -29,6 +29,20 @@ type QgridProviderOptions = {
   serviceTier?: string;
   /** @todo 향후 qgrid 서버 fallback routing에 사용할 후보 모델 목록. */
   fallbackModels?: string[];
+  /**
+   * codex 내장 image_generation tool 을 켠다. OpenAI/codex route + non-stream 전용.
+   * generateText 결과의 files 로 이미지를 받는다. streaming(streamText)에서는 거부된다.
+   */
+  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.
+   */
+  imageGenerationOptions?: {
+    quality?: "low" | "medium" | "high";
+    size?: "1024x1024" | "1024x1536" | "1536x1024";
+  };
 };
 /**
  * codex thread 좌표

package/dist/index.js

@@ -528,6 +528,8 @@ function qgrid(modelId, config) {
 			const verbosity = qgridOptions.verbosity;
 			const reasoningSummary = qgridOptions.reasoningSummary;
 			const serviceTier = qgridOptions.serviceTier;
+			const imageGeneration = qgridOptions.imageGeneration;
+			const imageGenerationOptions = qgridOptions.imageGenerationOptions;
 			const sessionKey = qgridOptions.sessionKey;
 			const reuseSessionKey = reusableSessionKey(modelId, sessionKey);
 			const rawSchema = options.responseFormat?.type === "json" ? options.responseFormat.schema : void 0;
@@ -572,7 +574,9 @@ function qgrid(modelId, config) {
 					...projectName ? { projectName } : {},
 					...logMode ? { logMode } : {},
 					...runContext ? { runContext } : {},
-					...toolResultsPayload ? { toolResults: toolResultsPayload } : {}
+					...toolResultsPayload ? { toolResults: toolResultsPayload } : {},
+					...imageGeneration ? { imageGeneration } : {},
+					...imageGenerationOptions ? { imageGenerationOptions } : {}
 				} }),
 				signal: options.abortSignal
 			}).then(async (res) => {
@@ -592,7 +596,12 @@ function qgrid(modelId, config) {
 					type: "text",
 					text: item.text
 				});
-				else content.push({
+				else if (item.type === "image") content.push({
+					type: "file",
+					mediaType: "image/png",
+					data: item.data
+				});
+				else if (item.type === "tool-call") content.push({
 					type: "tool-call",
 					toolCallId: item.toolCallId,
 					toolName: item.toolName,
@@ -606,6 +615,7 @@ function qgrid(modelId, config) {
 				type: "text",
 				text: data.text
 			});
+			if (imageGeneration && !content.some((c) => c.type === "file")) throw new Error("qgrid: imageGeneration was requested but the response contained no image — the server may be an older version that does not support image generation.");
 			if (data.runContext && finishReason.unified === "tool-calls") clientRun = {
 				runContext: data.runContext,
 				pendingToolCallIds: new Set(content.filter((c) => c.type === "tool-call").map((c) => c.toolCallId))
@@ -635,6 +645,7 @@ function qgrid(modelId, config) {
 			const verbosity = qgridOptions.verbosity;
 			const reasoningSummary = qgridOptions.reasoningSummary;
 			const serviceTier = qgridOptions.serviceTier;
+			if (qgridOptions.imageGeneration) throw new Error("qgrid: imageGeneration is not supported with streamText — use generateText instead.");
 			const sessionKey = qgridOptions.sessionKey;
 			const reuseSessionKey = reusableSessionKey(modelId, sessionKey);
 			const rawSchema = options.responseFormat?.type === "json" ? options.responseFormat.schema : void 0;

package/package.json

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