@cartanova/qgrid-ai-sdk 0.1.0 → 2.0.2

package/dist/index.d.ts

@@ -30,7 +30,8 @@ type QgridProviderOptions = {
 };
 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";
 type QgridLoggerConfig = {
-  serverUrl: string;
+  /** qgrid 서버 주소. 기본값: QGRID_URL 환경변수 또는 http://localhost:44900 */
+  serverUrl?: string;
   projectName?: string;
   tokenName?: string;
   /**
@@ -51,7 +52,7 @@ type QgridLoggerConfig = {
 };
 //#endregion
 //#region src/logger.d.ts
-declare function createQgridLogger(config: QgridLoggerConfig): TelemetrySettings;
+declare function createQgridLogger(config?: QgridLoggerConfig): TelemetrySettings;
 //#endregion
 //#region src/index.d.ts
 declare function qgrid(modelId: QgridSupportedModel, config?: QgridProviderConfig): LanguageModelV3;

package/dist/index.js

@@ -237,7 +237,9 @@ function timedKeySet() {
 		}
 	};
 }
-function createQgridLogger(config) {
+function createQgridLogger(config = {}) {
+	const serverUrl = config.serverUrl ?? process.env.QGRID_URL ?? "http://localhost:44900";
+	const onLogError = config.onLogError ?? ((e) => console.warn(`[qgrid-logger] ${e.message}`));
 	const runs = /* @__PURE__ */ new Map();
 	const keyTtl = typeof config.staleRunTimeoutMs === "number" && config.staleRunTimeoutMs > 0 ? config.staleRunTimeoutMs : DEFAULT_STALE_RUN_TIMEOUT_MS;
 	const suppressedQgrid = timedKeySet();
@@ -249,7 +251,7 @@ function createQgridLogger(config) {
 		runs.delete(runKey);
 		if (run.watchdog) clearTimeout(run.watchdog);
 		run.cleanupAbortListener?.();
-		for (const pending of run.pendingToolCalls) run.pendingSteps.push(appendStep(config.serverUrl, {
+		for (const pending of run.pendingToolCalls) run.pendingSteps.push(appendStep(serverUrl, {
 			requestLogId: run.requestLogId,
 			stepIndex: pending.stepIndex,
 			type: "tool_call",
@@ -258,10 +260,10 @@ function createQgridLogger(config) {
 			toolName: pending.toolName,
 			toolArgs: pending.toolArgs,
 			toolDurationMs: run.toolDurations.get(pending.toolCallId)
-		}).catch((e) => config.onLogError?.(e instanceof Error ? e : new Error(String(e)))));
+		}).catch((e) => onLogError(e instanceof Error ? e : new Error(String(e)))));
 		run.pendingToolCalls = [];
 		await Promise.allSettled(run.pendingSteps);
-		await finishRun(config.serverUrl, {
+		await finishRun(serverUrl, {
 			requestLogId: run.requestLogId,
 			status: result.status,
 			response: result.response,
@@ -273,7 +275,7 @@ function createQgridLogger(config) {
 			totalDurationMs: Date.now() - run.startTime,
 			history: run.history,
 			...result.errorMessage ? { errorMessage: result.errorMessage } : {}
-		}).catch((e) => config.onLogError?.(e instanceof Error ? e : new Error(String(e))));
+		}).catch((e) => onLogError(e instanceof Error ? e : new Error(String(e))));
 	};
 	let autoRunIdCounter = 0;
 	const resolveRunKey = (event) => {
@@ -289,7 +291,7 @@ function createQgridLogger(config) {
 				if (!event.metadata?.qgridRunId && !event.functionId && event.metadata) event.metadata.qgridRunId = `auto-${++autoRunIdCounter}`;
 				const runKey = resolveRunKey(event);
 				if (quarantined.has(runKey)) {
-					config.onLogError?.(/* @__PURE__ */ new Error("createQgridLogger: telemetry key is quarantined after overlap"));
+					onLogError(/* @__PURE__ */ new Error("createQgridLogger: telemetry key is quarantined after overlap"));
 					return;
 				}
 				if (event.model.provider === "qgrid") {
@@ -303,12 +305,12 @@ function createQgridLogger(config) {
 						errorMessage: msg
 					});
 					quarantined.add(runKey, keyTtl);
-					config.onLogError?.(new Error(msg));
+					onLogError(new Error(msg));
 					return;
 				}
 				try {
 					const messages = event.messages ?? (Array.isArray(event.prompt) ? event.prompt : void 0);
-					const result = await createRun(config.serverUrl, {
+					const result = await createRun(serverUrl, {
 						userPrompt: extractUserPrompt(event.prompt, messages),
 						systemPrompt: extractSystemPrompt(event.system),
 						modelName: event.model.modelId,
@@ -358,7 +360,7 @@ function createQgridLogger(config) {
 						finishing: false
 					});
 				} catch (e) {
-					config.onLogError?.(e instanceof Error ? e : new Error(String(e)));
+					onLogError(e instanceof Error ? e : new Error(String(e)));
 				}
 			},
 			onToolCallFinish(event) {
@@ -379,7 +381,7 @@ function createQgridLogger(config) {
 					const tr = content.find((p) => p.type === "tool-result" && p.toolCallId === pending.toolCallId);
 					const te = content.find((p) => p.type === "tool-error" && p.toolCallId === pending.toolCallId);
 					if (tr || te) {
-						run.pendingSteps.push(appendStep(config.serverUrl, {
+						run.pendingSteps.push(appendStep(serverUrl, {
 							requestLogId: run.requestLogId,
 							stepIndex: pending.stepIndex,
 							type: "tool_call",
@@ -390,12 +392,12 @@ function createQgridLogger(config) {
 							toolResult: tr && "output" in tr ? safeStringify(tr.output) : void 0,
 							toolDurationMs: run.toolDurations.get(pending.toolCallId),
 							error: te && "error" in te ? safeStringify(te.error) : void 0
-						}).catch((e) => config.onLogError?.(e instanceof Error ? e : new Error(String(e)))));
+						}).catch((e) => onLogError(e instanceof Error ? e : new Error(String(e)))));
 						run.toolDurations.delete(pending.toolCallId);
 					} else remainingPending.push(pending);
 				}
 				run.pendingToolCalls = remainingPending;
-				run.pendingSteps.push(appendStep(config.serverUrl, {
+				run.pendingSteps.push(appendStep(serverUrl, {
 					requestLogId: run.requestLogId,
 					stepIndex: stepNumber,
 					type: "generate",
@@ -406,13 +408,13 @@ function createQgridLogger(config) {
 					finishReason,
 					reasoningText: typeof reasoningText === "string" && reasoningText.length > 0 ? reasoningText : void 0,
 					reasoningTokens: usage.outputTokenDetails?.reasoningTokens
-				}).catch((e) => config.onLogError?.(e instanceof Error ? e : new Error(String(e)))));
+				}).catch((e) => onLogError(e instanceof Error ? e : new Error(String(e)))));
 				const toolCalls = content.filter((p) => p.type === "tool-call");
 				for (const [i, tc] of toolCalls.entries()) {
 					const tr = content.find((p) => p.type === "tool-result" && p.toolCallId === tc.toolCallId);
 					const te = content.find((p) => p.type === "tool-error" && p.toolCallId === tc.toolCallId);
 					if (tr || te) {
-						run.pendingSteps.push(appendStep(config.serverUrl, {
+						run.pendingSteps.push(appendStep(serverUrl, {
 							requestLogId: run.requestLogId,
 							stepIndex: stepNumber,
 							type: "tool_call",
@@ -423,7 +425,7 @@ function createQgridLogger(config) {
 							toolResult: tr && "output" in tr ? safeStringify(tr.output) : void 0,
 							toolDurationMs: run.toolDurations.get(tc.toolCallId),
 							error: te && "error" in te ? safeStringify(te.error) : void 0
-						}).catch((e) => config.onLogError?.(e instanceof Error ? e : new Error(String(e)))));
+						}).catch((e) => onLogError(e instanceof Error ? e : new Error(String(e)))));
 						run.toolDurations.delete(tc.toolCallId);
 					} else run.pendingToolCalls.push({
 						stepIndex: stepNumber,

package/package.json

@@ -1,7 +1,14 @@
 {
   "name": "@cartanova/qgrid-ai-sdk",
-  "version": "0.1.0",
+  "version": "2.0.2",
   "description": "AI SDK LanguageModelV3 provider for qgrid",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cartanova-ai/qgrid"
+  },
+  "files": [
+    "dist"
+  ],
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,21 +18,21 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "scripts": {
-    "build": "tsdown && mv dist/index-*.d.ts dist/index.d.ts",
-    "test": "vitest run",
-    "e2e": "tsx e2e/e2e.ts",
-    "e2e:logger": "tsx e2e/e2e-logger.ts"
-  },
   "devDependencies": {
-    "@ai-sdk/provider": "catalog:",
-    "ai": "catalog:",
-    "tsdown": "catalog:",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
+    "@ai-sdk/provider": "^3.0.0",
+    "ai": "^6.0.190",
+    "tsdown": "^0.12.9",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.10"
   },
   "peerDependencies": {
     "@ai-sdk/provider": "^3.0.0",
     "ai": "^6.0.0"
+  },
+  "scripts": {
+    "build": "tsdown && mv dist/index-*.d.ts dist/index.d.ts",
+    "test": "vitest run",
+    "e2e": "tsx e2e/e2e.ts",
+    "e2e:logger": "tsx e2e/e2e-logger.ts"
   }
-}
+}

package/e2e/e2e-logger.ts

@@ -1,112 +0,0 @@
-/**
- * @cartanova/qgrid-ai-sdk Logger E2E Test
- *
- * TelemetryIntegration 기반 logger가 실서버에 run lifecycle을 기록하는지 검증.
- * qgrid 서버(localhost:44900)가 떠 있어야 합니다.
- *
- * 사용법: pnpm --filter @cartanova/qgrid-ai-sdk e2e:logger
- */
-import { generateText, stepCountIs, tool } from "ai";
-import { z } from "zod";
-
-import { createQgridLogger, qgrid } from "../src/index";
-
-const SERVER = process.env.QGRID_URL ?? "http://localhost:44900";
-const MODEL = (process.env.QGRID_MODEL ?? "openai/gpt-5.5") as Parameters<typeof qgrid>[0];
-
-let passed = 0;
-let failed = 0;
-
-async function test(name: string, fn: () => Promise<void>) {
-  try {
-    await fn();
-    passed++;
-    console.log(`  ✓ ${name}`);
-  } catch (e) {
-    failed++;
-    console.error(`  ✗ ${name}`);
-    console.error(`    ${(e as Error).message}`);
-  }
-}
-
-function assert(condition: unknown, message: string): asserts condition {
-  if (!condition) throw new Error(message);
-}
-
-const WEATHER_DB: Record<string, { temperature: number; condition: string }> = {
-  Seoul: { temperature: 22, condition: "sunny" },
-  Busan: { temperature: 26, condition: "partly cloudy" },
-};
-
-async function main() {
-  console.log(`\n@cartanova/qgrid-ai-sdk Logger E2E (server: ${SERVER}, model: ${MODEL})\n`);
-
-  // 1. 단순 텍스트 + logger
-  await test("logger: simple text generation", async () => {
-    const logger = createQgridLogger({
-      serverUrl: SERVER,
-      projectName: "e2e-logger",
-      tokenName: "e2e-test",
-    });
-
-    const result = await generateText({
-      model: qgrid(MODEL),
-      prompt: 'Say exactly: "logger-ok"',
-      experimental_telemetry: { integrations: [logger] },
-    });
-
-    assert(result.text.length > 0, "empty response");
-    console.log(`    text="${result.text.slice(0, 50)}"`);
-
-    // 대기 후 DB 검증
-    await new Promise((r) => setTimeout(r, 1500));
-
-    const logRes = await fetch(
-      `${SERVER}/api/requestLog/findMany?subset=A&rawParams%5Bnum%5D=1&rawParams%5Bpage%5D=1&rawParams%5BorderBy%5D=id-desc`,
-    );
-    const logData = (await logRes.json()) as { rows: Array<Record<string, unknown>> };
-    const log = logData.rows[0];
-
-    // qgrid provider가 이미 lifecycle을 관리하므로 logger는 skip해야 함
-    // 하지만 단순 호출이라 qgrid provider의 runState도 생성 안 됨 (tools 없음)
-    // 이 경우 둘 다 기록하지 않거나, qgrid provider만 기록
-    console.log(`    latest log id=${log?.id}, status=${log?.status}`);
-  });
-
-  // 2. tool calling + logger (qgrid provider 사용 — logger가 skip하는지 검증)
-  await test("logger: skips when qgrid provider is used", async () => {
-    const errors: Error[] = [];
-    const logger = createQgridLogger({
-      serverUrl: SERVER,
-      projectName: "e2e-logger",
-      onLogError: (err) => errors.push(err),
-    });
-
-    const result = await generateText({
-      model: qgrid(MODEL),
-      prompt: "What is the weather in Seoul? Use the getWeather tool.",
-      tools: {
-        getWeather: tool({
-          description: "Get weather for a city",
-          inputSchema: z.object({ city: z.string() }),
-          execute: async ({ city }) => WEATHER_DB[city] ?? { temperature: 0, condition: "unknown" },
-        }),
-      },
-      stopWhen: stepCountIs(3),
-      experimental_telemetry: { integrations: [logger] },
-    });
-
-    assert(result.text.length > 0, "empty response");
-    assert(errors.length === 0, `logger errors: ${errors.map((e) => e.message).join(", ")}`);
-    console.log(`    text="${result.text.slice(0, 80)}"`);
-    console.log(`    logger skipped (qgrid provider detected)`);
-  });
-
-  console.log(`\n  ${passed} passed, ${failed} failed\n`);
-  if (failed > 0) process.exit(1);
-}
-
-main().catch((e) => {
-  console.error("E2E failed:", e);
-  process.exit(1);
-});

package/e2e/e2e.ts

@@ -1,217 +0,0 @@
-/**
- * @cartanova/qgrid-ai-sdk E2E Test Suite
- *
- * 실제 qgrid 서버(localhost:44900)에 요청을 보내는 통합 테스트.
- * 서버가 떠 있어야 합니다.
- *
- * 사용법: pnpm --filter @cartanova/qgrid-ai-sdk e2e
- */
-import { generateText, stepCountIs, tool } from "ai";
-import { z } from "zod";
-
-import { qgrid } from "../src/index";
-
-const SERVER = process.env.QGRID_URL ?? "http://localhost:44900";
-const MODEL = (process.env.QGRID_MODEL ?? "openai/gpt-5.5") as Parameters<typeof qgrid>[0];
-
-// ── Test runner ────────────────────────────────────────────────────
-
-let passed = 0;
-let failed = 0;
-
-async function test(name: string, fn: () => Promise<void>) {
-  try {
-    await fn();
-    passed++;
-    console.log(`  ✓ ${name}`);
-  } catch (e) {
-    failed++;
-    console.error(`  ✗ ${name}`);
-    console.error(`    ${(e as Error).message}`);
-  }
-}
-
-function assert(condition: unknown, message: string): asserts condition {
-  if (!condition) throw new Error(message);
-}
-
-// ── Mock data ──────────────────────────────────────────────────────
-
-const WEATHER_DB: Record<string, { temperature: number; condition: string }> = {
-  Seoul: { temperature: 22, condition: "sunny" },
-  Busan: { temperature: 26, condition: "partly cloudy" },
-  Daegu: { temperature: 28, condition: "hot" },
-  Jeju: { temperature: 24, condition: "rainy" },
-};
-
-const RESTAURANT_DB: Record<
-  string,
-  Array<{ id: string; name: string; cuisine: string; rating: number }>
-> = {
-  Daegu: [
-    { id: "r6", name: "대구 막창", cuisine: "BBQ", rating: 4.4 },
-    { id: "r7", name: "안지랑 곱창", cuisine: "Korean", rating: 4.7 },
-  ],
-  Busan: [
-    { id: "r3", name: "해운대 회센터", cuisine: "Seafood", rating: 4.7 },
-    { id: "r4", name: "서면 돼지국밥", cuisine: "Korean", rating: 4.9 },
-  ],
-};
-
-// ── Tests ──────────────────────────────────────────────────────────
-
-async function main() {
-  console.log(`\n@cartanova/qgrid-ai-sdk E2E (server: ${SERVER}, model: ${MODEL})\n`);
-
-  // 1. 단순 텍스트
-  await test("simple text generation", async () => {
-    const result = await generateText({
-      model: qgrid(MODEL),
-      prompt: 'Respond with exactly: "hello-e2e"',
-    });
-    assert(result.text.length > 0, "empty response");
-    assert(result.finishReason === "stop", `unexpected finishReason: ${result.finishReason}`);
-    assert(result.usage?.inputTokens, "missing input token usage");
-    console.log(`    text="${result.text.slice(0, 80)}"`);
-  });
-
-  // 2. system prompt
-  await test("system prompt", async () => {
-    const result = await generateText({
-      model: qgrid(MODEL),
-      system: "You must reply in exactly one word.",
-      prompt: "What color is the sky?",
-    });
-    assert(result.text.length > 0, "empty response");
-    console.log(`    text="${result.text.slice(0, 80)}"`);
-  });
-
-  // 3. single tool call
-  await test("single tool call", async () => {
-    const result = await generateText({
-      model: qgrid(MODEL),
-      prompt: "What is the weather in Seoul? Use the getWeather tool.",
-      tools: {
-        getWeather: tool({
-          description: "Get current weather for a city",
-          inputSchema: z.object({ city: z.string() }),
-          execute: async ({ city }) => WEATHER_DB[city] ?? { temperature: 0, condition: "unknown" },
-        }),
-      },
-      stopWhen: stepCountIs(3),
-    });
-    assert(result.steps.length >= 2, `expected at least 2 steps, got ${result.steps.length}`);
-    assert(result.steps[0].toolCalls.length > 0, "step 0 should have tool calls");
-    assert(result.finishReason === "stop", `unexpected finishReason: ${result.finishReason}`);
-    assert(result.text.length > 0, "empty final text");
-    console.log(`    steps=${result.steps.length}, text="${result.text.slice(0, 80)}"`);
-  });
-
-  // 4. multi-tool, multi-step
-  await test("multi-tool multi-step", async () => {
-    const result = await generateText({
-      model: qgrid(MODEL),
-      prompt:
-        "Step 1: Use the getWeather tool for Seoul, Busan, and Daegu. Step 2: Identify the warmest city. Step 3: Use the searchRestaurants tool for that warmest city. Then give a final summary.",
-      tools: {
-        getWeather: tool({
-          description: "Get weather for a city (English name: Seoul, Busan, Daegu, Jeju)",
-          inputSchema: z.object({ city: z.string() }),
-          execute: async ({ city }) => WEATHER_DB[city] ?? { temperature: 0, condition: "unknown" },
-        }),
-        searchRestaurants: tool({
-          description: "Search restaurants in a city",
-          inputSchema: z.object({ city: z.string() }),
-          execute: async ({ city }) => RESTAURANT_DB[city] ?? [],
-        }),
-      },
-      stopWhen: stepCountIs(5),
-    });
-
-    const allToolCalls = result.steps.flatMap((s) => s.toolCalls);
-    const weatherCalls = allToolCalls.filter((tc) => tc.toolName === "getWeather");
-    const restaurantCalls = allToolCalls.filter((tc) => tc.toolName === "searchRestaurants");
-    const toolNames = [...new Set(allToolCalls.map((tc) => tc.toolName))];
-
-    assert(
-      allToolCalls.length >= 2,
-      `expected at least 2 total tool calls, got ${allToolCalls.length}`,
-    );
-    assert(
-      weatherCalls.length >= 2,
-      `expected at least 2 getWeather calls, got ${weatherCalls.length}`,
-    );
-    assert(result.steps.length >= 2, `expected at least 2 steps, got ${result.steps.length}`);
-    assert(result.finishReason === "stop", `unexpected finishReason: ${result.finishReason}`);
-    console.log(
-      `    steps=${result.steps.length}, tools=${toolNames.join(",")}, weatherCalls=${weatherCalls.length}, restaurantCalls=${restaurantCalls.length}`,
-    );
-    console.log(`    text="${result.text.slice(0, 100)}"`);
-  });
-
-  // 5. auto lifecycle — run이 DB에 기록되었는지 검증
-  await test("auto lifecycle (createRun → appendStep → finishRun)", async () => {
-    const result = await generateText({
-      model: qgrid(MODEL),
-      prompt: "What is the weather in Busan? Use the getWeather tool.",
-      tools: {
-        getWeather: tool({
-          description: "Get weather for a city",
-          inputSchema: z.object({ city: z.string() }),
-          execute: async ({ city }) => WEATHER_DB[city] ?? { temperature: 0, condition: "unknown" },
-        }),
-      },
-      stopWhen: stepCountIs(3),
-    });
-    assert(result.finishReason === "stop", `unexpected finishReason: ${result.finishReason}`);
-
-    // fire-and-forget appendStep 완료 대기
-    await new Promise((r) => setTimeout(r, 1500));
-
-    // 가장 최근 request_log 조회
-    const logRes = await fetch(
-      `${SERVER}/api/requestLog/findMany?subset=A&rawParams%5Bnum%5D=1&rawParams%5Bpage%5D=1&rawParams%5BorderBy%5D=id-desc`,
-    );
-    const logData = (await logRes.json()) as { rows: Array<Record<string, unknown>> };
-    const log = logData.rows[0];
-    assert(log, "no request_log found");
-    assert(log.status === "succeeded", `expected status=succeeded, got ${log.status}`);
-    assert((log.input_tokens as number) > 0, "input_tokens should be > 0");
-    assert(
-      (log.tool_call_count as number) >= 1,
-      `expected tool_call_count >= 1, got ${log.tool_call_count}`,
-    );
-    assert((log.response as string)?.length > 0, "response should not be empty");
-
-    // steps 검증
-    const stepsRes = await fetch(
-      `${SERVER}/api/requestLogStep/findMany?subset=A&rawParams%5Bnum%5D=50&rawParams%5Bpage%5D=1&rawParams%5Brequest_log_id%5D=${log.id}&rawParams%5BorderBy%5D=id-asc`,
-    );
-    const stepsData = (await stepsRes.json()) as {
-      rows: Array<Record<string, unknown>>;
-      total: number;
-    };
-    const generateSteps = stepsData.rows.filter((s) => s.type === "generate");
-    const toolSteps = stepsData.rows.filter((s) => s.type === "tool_call");
-
-    assert(
-      generateSteps.length >= 2,
-      `expected at least 2 generate steps, got ${generateSteps.length}`,
-    );
-    assert(toolSteps.length >= 1, `expected at least 1 tool_call step, got ${toolSteps.length}`);
-
-    console.log(
-      `    requestLogId=${log.id}, status=${log.status}, tool_call_count=${log.tool_call_count}, steps=${stepsData.total}`,
-    );
-  });
-
-  // ── Summary ──────────────────────────────────────────────────────
-
-  console.log(`\n  ${passed} passed, ${failed} failed\n`);
-  if (failed > 0) process.exit(1);
-}
-
-main().catch((e) => {
-  console.error("E2E failed:", e);
-  process.exit(1);
-});