@cartanova/qgrid-ai-sdk 2.1.0 → 2.2.0

package/dist/index.d.ts

@@ -22,11 +22,23 @@ type QgridOpenAIProviderOptions = {
   /** 응답 텍스트의 상세도. */
   textVerbosity?: "low" | "medium" | "high";
 };
+/**
+ * codex thread 좌표
+ * 멀티턴 대화에서 같은 대화를 같은 codex thread 로 라우팅 → conversation_id 고정 → 캐시 적중
+ * provider 내부 threadCoordStore 가 sessionKey 별로 관리
+ */
+
 /**
  * {@link QgridOpenAIProviderOptions}
  */
 type QgridProviderOptions = {
   openai?: QgridOpenAIProviderOptions;
+  /**
+   * 멀티턴 대화 식별자. 호출자가 자기 도메인 ID(예: 게임 세션 ID) 하나만 넘기면, provider 가
+   * 같은 sessionKey 의 thread 좌표를 내부에서 회송해 prompt cache 를 적중시킨다.
+   * 좌표는 sessionKey 별로 격리된다.
+   */
+  sessionKey?: string;
 };
 type QgridSupportedModel = "openai/gpt-5.5" | "openai/gpt-5.4" | "openai/gpt-5.2" | "openai/gpt-5.4-mini" | "openai/gpt-5.3-codex" | "openai/gpt-5.3-codex-spark" | "anthropic/claude-haiku-4-5" | "anthropic/claude-sonnet-4" | "anthropic/claude-sonnet-4-5" | "anthropic/claude-sonnet-4-6" | "anthropic/claude-sonnet-4-7" | "anthropic/claude-opus-4" | "anthropic/claude-opus-4-1" | "anthropic/claude-opus-4-5" | "anthropic/claude-opus-4-6" | "anthropic/claude-opus-4-7" | "anthropic/claude-opus-4-8";
 type QgridLoggerConfig = {

package/dist/index.js

@@ -461,6 +461,23 @@ function createQgridLogger(config = {}) {
 //#region src/index.ts
 const DEFAULT_SERVER_URL = "http://localhost:44900";
 const DEFAULT_EFFORT = "low";
+const THREAD_COORD_TTL_MS = 10 * 6e4;
+const threadCoordStore = /* @__PURE__ */ new Map();
+function getThreadCoord(sessionKey) {
+	const entry = threadCoordStore.get(sessionKey);
+	if (!entry) return void 0;
+	if (entry.expiresAt <= Date.now()) {
+		threadCoordStore.delete(sessionKey);
+		return;
+	}
+	return entry.coord;
+}
+function setThreadCoord(sessionKey, coord) {
+	threadCoordStore.set(sessionKey, {
+		coord,
+		expiresAt: Date.now() + THREAD_COORD_TTL_MS
+	});
+}
 function qgrid(modelId, config) {
 	const serverUrl = config?.serverUrl ?? process.env.QGRID_URL ?? DEFAULT_SERVER_URL;
 	const effort = config?.defaultEffort ?? DEFAULT_EFFORT;
@@ -478,6 +495,7 @@ function qgrid(modelId, config) {
 			const effectiveEffort = openaiOpts?.reasoningEffort ?? effort;
 			const verbosity = openaiOpts?.textVerbosity ?? openaiOpts?.verbosity;
 			const reasoningSummary = openaiOpts?.reasoningSummary;
+			const sessionKey = (options.providerOptions?.qgrid)?.sessionKey;
 			const rawSchema = options.responseFormat?.type === "json" ? options.responseFormat.schema : void 0;
 			const schemaType = rawSchema ? rawSchema.type : void 0;
 			if (rawSchema && !hasTools && schemaType !== "object") console.warn(`[qgrid] responseFormat.schema top-level type is "${schemaType ?? "unknown"}". OpenAI structured output requires "object". Falling back to client-side parsing.`);
@@ -500,6 +518,8 @@ function qgrid(modelId, config) {
 					clientRun = null;
 				}
 			}
+			const storedCoord = sessionKey ? getThreadCoord(sessionKey) : void 0;
+			if (!runContext && storedCoord) runContext = { threadCoord: storedCoord };
 			if (!logMode && hasTools) logMode = "run";
 			const data = await fetch(`${serverUrl}/api/qgrid/query`, {
 				method: "POST",
@@ -555,6 +575,7 @@ function qgrid(modelId, config) {
 				pendingToolCallIds: new Set(content.filter((c) => c.type === "tool-call").map((c) => c.toolCallId))
 			};
 			else clientRun = null;
+			if (sessionKey && data.runContext?.threadCoord) setThreadCoord(sessionKey, data.runContext.threadCoord);
 			return {
 				content,
 				finishReason,
@@ -589,6 +610,7 @@ function qgrid(modelId, config) {
 			const effectiveEffort = openaiOpts?.reasoningEffort ?? effort;
 			const verbosity = openaiOpts?.textVerbosity ?? openaiOpts?.verbosity;
 			const reasoningSummary = openaiOpts?.reasoningSummary;
+			const sessionKey = (options.providerOptions?.qgrid)?.sessionKey;
 			const rawSchema = options.responseFormat?.type === "json" ? options.responseFormat.schema : void 0;
 			const jsonSchema = !hasTools && rawSchema && rawSchema.type === "object" ? JSON.stringify(rawSchema) : void 0;
 			let runContext;
@@ -609,6 +631,8 @@ function qgrid(modelId, config) {
 					clientRun = null;
 				}
 			}
+			const storedCoord = sessionKey ? getThreadCoord(sessionKey) : void 0;
+			if (!runContext && storedCoord) runContext = { threadCoord: storedCoord };
 			if (!logMode && hasTools) logMode = "run";
 			const prepRes = await fetch(`${serverUrl}/api/qgrid/prepareStream`, {
 				method: "POST",
@@ -675,6 +699,7 @@ function qgrid(modelId, config) {
 							pendingToolCallIds: new Set((done.content ?? []).filter((c) => c.type === "tool-call").map((c) => c.toolCallId))
 						};
 						else clientRun = null;
+						if (sessionKey && done.runContext?.threadCoord) setThreadCoord(sessionKey, done.runContext.threadCoord);
 						if (done.content) {
 							for (const item of done.content) if (item.type === "text" && !deltaTextEmitted) {
 								const tid = `text_${Math.random().toString(36).slice(2, 10)}`;

package/package.json

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