@cartanova/qgrid-ai-sdk 2.5.1 → 2.5.3

package/README.ko.md

@@ -168,10 +168,16 @@ const { text } = await generateText({
 | `verbosity` | `"low"` \| `"medium"` \| `"high"` | OpenAI 전용 | 응답 텍스트의 상세도 |
 | `reasoningSummary` | `"auto"` \| `"concise"` \| `"detailed"` \| `"none"` | OpenAI 전용 | 추론 요약 출력 방식 |
 | `serviceTier` | `string` | OpenAI 전용 | OpenAI/codex service tier |
+| `timeoutMs` | 양의 정수, 최대 `1_800_000` | Anthropic 전용 | 서버의 Claude Code 프로세스 제한시간(ms). 기본값은 240초 |
 | `imageGeneration` | `boolean` | OpenAI 전용, non-stream | codex 내장 `image_generation` tool 활성화 ([아래](#image-generation) 참조) |
 | `imageGenerationOptions` | `{ quality?, size? }` | OpenAI 전용 | 이미지 품질/크기 힌트. `quality: "low" \| "medium" \| "high"`, `size: "1024x1024" \| "1024x1536" \| "1536x1024"` (기본: `medium` / `1536x1024`) |
 | `fallbackModels` | `string[]` | 예약 | 향후 qgrid 서버 fallback routing용 예약 필드. 현재 동작하지 않으며 Claude Code의 Fable refusal fallback과 무관 |
 
+AI SDK 최상위 `timeout`은 전체 클라이언트 제한시간이며 custom provider 실행 전에
+`AbortSignal`로 변환됩니다. 따라서 그 숫자 자체는 qgrid에 전달되지 않습니다. qgrid 서버의
+Claude Code 프로세스 제한시간을 바꾸려면 `providerOptions.qgrid.timeoutMs`를 사용하세요.
+클라이언트 취소 또는 비스트리밍 HTTP 연결 종료도 서버의 provider 실행을 중단합니다.
+
 ### 멀티턴 prompt cache (sessionKey)
 
 멀티턴 대화에서 `sessionKey`로 호출자의 도메인 ID(게임 세션 ID, 채팅방 ID 등) 하나만 넘기면, provider가 같은 대화를 같은 codex thread로 라우팅하여 prompt cache를 적중시킵니다. thread 좌표의 발급/보관/회송은 provider 내부에서 처리하므로 호출자는 key만 넘기면 됩니다.

package/README.md

@@ -168,10 +168,17 @@ const { text } = await generateText({
 | `verbosity` | `"low"` \| `"medium"` \| `"high"` | OpenAI only | Response text verbosity |
 | `reasoningSummary` | `"auto"` \| `"concise"` \| `"detailed"` \| `"none"` | OpenAI only | Reasoning summary output mode |
 | `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. 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? }` | OpenAI only | Image quality/size hints. `quality: "low" \| "medium" \| "high"`, `size: "1024x1024" \| "1024x1536" \| "1536x1024"` (defaults: `medium` / `1536x1024`) |
 | `fallbackModels` | `string[]` | reserved | Reserved for future qgrid server-side fallback routing. Not functional yet and unrelated to Claude Code's Fable refusal fallback |
 
+AI SDK's top-level `timeout` remains the overall client-side budget and is converted to an
+`AbortSignal` before the custom provider runs. It does not expose the numeric timeout to qgrid.
+Use `providerOptions.qgrid.timeoutMs` when the qgrid server's Claude Code process needs a different
+limit. A client abort or disconnected non-streaming HTTP request also terminates the server-side
+provider execution.
+
 ### Multi-turn prompt cache (sessionKey)
 
 For multi-turn conversations, pass a single caller-side domain ID (game session ID, chat room ID, ...) as `sessionKey` and the provider routes the same conversation to the same codex thread, hitting the prompt cache. Thread coordinate issuance/storage/replay is handled inside the provider — the caller only passes the key.

package/dist/index.d.ts

@@ -31,6 +31,12 @@ type QgridProviderOptions = {
   reasoningSummary?: "auto" | "concise" | "detailed" | "none";
   /** OpenAI/codex service tier. OpenAI/codex route에서만 적용된다. */
   serviceTier?: string;
+  /**
+   * qgrid 서버의 provider 실행 제한(ms). Anthropic 경로에서는 Claude Code 프로세스 타이머로
+   * 사용된다. AI SDK 표준 timeout은 provider에 숫자를 전달하지 않고 abortSignal로 변환되므로,
+   * 서버 측 제한을 바꾸려면 이 옵션을 사용한다. 양의 정수만 허용하며 최대 30분, 기본 240초다.
+   */
+  timeoutMs?: number;
   /**
    * @todo 향후 qgrid 서버 fallback routing에 사용할 후보 모델 목록.
    * Claude Code가 처리하는 Fable 5 safety-refusal fallback과는 무관하다.

package/dist/index.js

@@ -782,6 +782,7 @@ function qgrid(modelId, config) {
 			const verbosity = qgridOptions.verbosity;
 			const reasoningSummary = qgridOptions.reasoningSummary;
 			const serviceTier = qgridOptions.serviceTier;
+			const timeoutMs = qgridOptions.timeoutMs;
 			const logger = qgridOptions.logger;
 			const imageGenerationOptions = qgridOptions.imageGenerationOptions;
 			if (imageGeneration) assertImageInputFitsJsonTransport(imageUrls);
@@ -812,6 +813,7 @@ function qgrid(modelId, config) {
 					...verbosity ? { verbosity } : {},
 					...reasoningSummary ? { reasoningSummary } : {},
 					...serviceTier ? { serviceTier } : {},
+					...timeoutMs !== void 0 ? { timeout: timeoutMs } : {},
 					...hasTools ? { tools: tools.map(toQgridTool) } : {},
 					...jsonSchema ? { jsonSchema } : {},
 					...history.length > 0 ? { history: JSON.stringify(history) } : {},
@@ -880,6 +882,7 @@ function qgrid(modelId, config) {
 			const verbosity = qgridOptions.verbosity;
 			const reasoningSummary = qgridOptions.reasoningSummary;
 			const serviceTier = qgridOptions.serviceTier;
+			const timeoutMs = qgridOptions.timeoutMs;
 			const logger = qgridOptions.logger;
 			if (qgridOptions.imageGeneration) throw new Error("qgrid: imageGeneration is not supported with streamText — use generateText instead.");
 			const { prompt, system, history, droppedImageCount } = extractPromptAndHistory(options.prompt, { includeImages: false });
@@ -908,6 +911,7 @@ function qgrid(modelId, config) {
 					...verbosity ? { verbosity } : {},
 					...reasoningSummary ? { reasoningSummary } : {},
 					...serviceTier ? { serviceTier } : {},
+					...timeoutMs !== void 0 ? { timeout: timeoutMs } : {},
 					...hasTools ? { tools: tools.map(toQgridTool) } : {},
 					...jsonSchema ? { jsonSchema } : {},
 					...history.length > 0 ? { history: JSON.stringify(history) } : {},

package/package.json

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