@cartanova/qgrid-cli 2.3.2 → 2.3.3

package/bundle/src/utils/providers/anthropic/anthropic-constants.test.ts

@@ -0,0 +1,60 @@
+import { describe, expect, it } from "vitest";
+
+import {
+  ANTHROPIC_DEFAULT_MODEL,
+  assertSupportedOneMillionSuffix,
+  canonicalAnthropicModel,
+  hasOneMillionSuffix,
+  needsCli1mSuffix,
+  supports1MContext,
+} from "./anthropic-constants";
+
+describe("canonicalAnthropicModel", () => {
+  it("미지정이면 default model", () => {
+    expect(canonicalAnthropicModel()).toBe(ANTHROPIC_DEFAULT_MODEL);
+  });
+
+  it("provider prefix 를 제거한다", () => {
+    expect(canonicalAnthropicModel("anthropic/claude-opus-4-8")).toBe("claude-opus-4-8");
+  });
+
+  it("[1m] suffix 를 base canonical 에서 제거한다", () => {
+    expect(canonicalAnthropicModel("claude-sonnet-4-6[1m]")).toBe("claude-sonnet-4-6");
+    expect(canonicalAnthropicModel("anthropic/claude-sonnet-4-6[1m]")).toBe("claude-sonnet-4-6");
+  });
+});
+
+describe("Anthropic 1M context policy", () => {
+  it("지원 모델은 실측 확인된 exact set 만 true", () => {
+    expect(supports1MContext("claude-sonnet-4-6")).toBe(true);
+    expect(supports1MContext("claude-opus-4-6")).toBe(true);
+    expect(supports1MContext("claude-opus-4-8")).toBe(true);
+
+    expect(supports1MContext("claude-opus-4-7")).toBe(false);
+    expect(supports1MContext("claude-sonnet-4-5")).toBe(false);
+    expect(supports1MContext("claude-sonnet-4")).toBe(false);
+    expect(supports1MContext("claude-haiku-4-5")).toBe(false);
+  });
+
+  it("CLI suffix 필요 모델과 기본 1M 모델을 분리한다", () => {
+    expect(needsCli1mSuffix("claude-sonnet-4-6")).toBe(true);
+    expect(needsCli1mSuffix("claude-opus-4-6")).toBe(true);
+    expect(needsCli1mSuffix("claude-opus-4-8")).toBe(false);
+    expect(needsCli1mSuffix("claude-opus-4-7")).toBe(false);
+  });
+
+  it("provider prefix 와 [1m] suffix 가 묻어도 base 기준으로 판별한다", () => {
+    expect(supports1MContext("anthropic/claude-sonnet-4-6[1m]")).toBe(true);
+    expect(needsCli1mSuffix("anthropic/claude-sonnet-4-6[1m]")).toBe(true);
+    expect(supports1MContext("anthropic/claude-opus-4-8[1m]")).toBe(true);
+    expect(needsCli1mSuffix("anthropic/claude-opus-4-8[1m]")).toBe(false);
+  });
+
+  it("unsupported alias + [1m] 은 조용히 다운그레이드하지 않는다", () => {
+    expect(hasOneMillionSuffix("sonnet[1m]")).toBe(true);
+    expect(() => assertSupportedOneMillionSuffix("sonnet[1m]")).toThrow(
+      /Unsupported Anthropic 1M model suffix/,
+    );
+    expect(() => assertSupportedOneMillionSuffix("anthropic/claude-sonnet-4-6[1m]")).not.toThrow();
+  });
+});

package/bundle/src/utils/providers/anthropic/anthropic-constants.ts

@@ -1,31 +1,25 @@
 /**
  * Anthropic(Claude) provider 상수.
  *
- * 기존 qgrid.dispatcher.ts 의 executeClaude 플래그/env 와 정합을 맞추되, 멀티턴용으로 조정한다:
+ * Claude Code CLI 플래그/env 계약을 Anthropic dispatcher 용으로 고정한다:
  *  - `--no-session-persistence` 제거 (멀티턴 필수).
  *  - `--input-format stream-json` 추가 (stdin 으로 입력 어댑터 JSONL 흘림).
- *  - `--session-id` / `--resume` 로 세션 소유.
+ *  - Anthropic 경로는 매 호출 `--session-id` 로 fresh session 을 발급한다.
  */
 
 // CC --model 플래그가 받는 official model id (alias "sonnet" 가 아니라 정확한 식별자로 고정).
 // claude-api 스킬 확인: Sonnet 4.6 official id = "claude-sonnet-4-6" (날짜 suffix 없음).
-// model-cost 테이블에도 "claude-sonnet-4-6" 키 존재. (owner 지시)
+// model-cost 테이블에도 "claude-sonnet-4-6" 키 존재
 export const ANTHROPIC_DEFAULT_MODEL = "claude-sonnet-4-6";
-export const ANTHROPIC_DEFAULT_EFFORT = "high";
-
-// model id 를 canonical(provider prefix 없는 CLI/cost 키) 로 정규화한다.
-// ai-sdk 는 'anthropic/claude-*' 형태로 보내는데, prefix 가 compatibilityKey/calculateCostUsd 에
-// 새면 호환키가 갈리거나 cost 가 default 단가로 오계산된다. 미지정이면 default.
-export function canonicalAnthropicModel(model?: string): string {
-  const raw = model || ANTHROPIC_DEFAULT_MODEL;
-  return raw.includes("/") ? raw.split("/").pop()! : raw;
-}
-
+// OpenAI provider 기본값(openai-dispatcher DEFAULT_EFFORT)과 맞춘다. 클라가 effort 미지정 시 안전망.
+export const ANTHROPIC_DEFAULT_EFFORT = "low";
 // project scope cwd (settings.json 격리). 토큰별 격리는 CLAUDE_CONFIG_DIR 로 한다.
 export const ANTHROPIC_CLAUDE_CWD = "/tmp/qgrid-anthropic";
-
 // per-token CLAUDE_CONFIG_DIR 의 베이스. 실제 경로는 `${BASE}/${tokenId}` (R10 격리).
 export const ANTHROPIC_CONFIG_DIR_BASE = "/tmp/qgrid-anthropic-config";
+// CC 가 자동 활성화하는 deferred 도구 — 토큰 최적화 위해 dispatcher 경로에서 차단.
+export const ANTHROPIC_DISALLOWED_TOOLS = ["Monitor", "PushNotification", "RemoteTrigger"] as const;
+const ONE_MILLION_SUFFIX_RE = /\[1m\]$/i;
 
 // 토큰별 CLAUDE_CONFIG_DIR 경로 규칙(R10 격리 계약). tokenId 별로 분리되어, 같은 claude session-id
 // 라도 다른 토큰이면 다른 config dir → transcript 가 섞이지 않는다. 부수효과 없는 순수 함수라
@@ -34,5 +28,52 @@ export function anthropicConfigDir(tokenId: number): string {
   return `${ANTHROPIC_CONFIG_DIR_BASE}/${tokenId}`;
 }
 
-// CC 가 자동 활성화하는 deferred 도구 — 토큰 최적화 위해 차단(기존 executeClaude 와 동일).
-export const ANTHROPIC_DISALLOWED_TOOLS = ["Monitor", "PushNotification", "RemoteTrigger"] as const;
+// model id 를 canonical(provider prefix 없는 CLI/cost 키) 로 정규화
+// ai-sdk 는 'anthropic/claude-*' 형태로 보내는데, prefix 가 calculateCostUsd 에 새면 cost 가
+// default 단가로 오계산된다. `[1m]` suffix 도 CLI emit 전용이라
+// base canonical 에서는 제거한다. 미지정이면 default.
+export function canonicalAnthropicModel(model?: string): string {
+  const raw = model || ANTHROPIC_DEFAULT_MODEL;
+  const withoutProvider = raw.includes("/") ? raw.split("/").pop()! : raw;
+  return withoutProvider.replace(ONE_MILLION_SUFFIX_RE, "");
+}
+
+export function hasOneMillionSuffix(model?: string): boolean {
+  return model !== undefined && ONE_MILLION_SUFFIX_RE.test(model);
+}
+
+// 1M 지원 여부는 Claude Code 유출본의 prefix 판정이 아니라 qgrid 실측 기준 exact set 으로 고정한다.
+// opus-4-7 은 실측 전까지 미포함. 새 모델 추가 시 실제 claude CLI contextWindow 동작으로 확인한다.
+const ONE_MILLION_CONTEXT_MODELS = new Set([
+  "claude-sonnet-4-6",
+  "claude-opus-4-6",
+  "claude-opus-4-8",
+]);
+
+const CLI_ONE_MILLION_SUFFIX_MODELS = new Set(["claude-sonnet-4-6", "claude-opus-4-6"]);
+
+// 불변 계약: suffix 가 필요한 모델은 반드시 1M 지원 모델의 부분집합이어야 한다. 역방향 불일치(suffix
+// 대상인데 지원 집합엔 없음)면 needsCli1mSuffix=true·supports1MContext=false 가 동시에 나서
+// `--model [1m]` 과 DISABLE_1M env 가 모순되게 붙는다. 새 모델을 한쪽 Set 에만 넣는 실수를 모듈
+// 로드 시점에 잡는다.
+for (const model of CLI_ONE_MILLION_SUFFIX_MODELS) {
+  if (!ONE_MILLION_CONTEXT_MODELS.has(model)) {
+    throw new Error(`[invariant] CLI 1M suffix model not in context set: ${model}`);
+  }
+}
+
+export function supports1MContext(model?: string): boolean {
+  return ONE_MILLION_CONTEXT_MODELS.has(canonicalAnthropicModel(model));
+}
+
+export function needsCli1mSuffix(model?: string): boolean {
+  return CLI_ONE_MILLION_SUFFIX_MODELS.has(canonicalAnthropicModel(model));
+}
+
+export function assertSupportedOneMillionSuffix(model?: string): void {
+  if (!hasOneMillionSuffix(model)) return;
+  const canonical = canonicalAnthropicModel(model);
+  if (!supports1MContext(canonical)) {
+    throw new Error(`Unsupported Anthropic 1M model suffix: ${model}`);
+  }
+}