同じモデルが環境ごとに別名になる問題 — Claude をマルチプロバイダーで呼ぶ識別子リゾルバの設計

// Before: 呼び出し側に物理識別子が直書きされている
const res = await client.messages.create({
  model: "claude-fable-5",        // Bedrock では通らない
  max_tokens: 4096,
  messages,
});

// After: 論理名だけを渡し、解決は resolver に閉じ込める
const m = resolveModel("reasoning-default");
const res = await client.messages.create({
  model: m.id,
  max_tokens: Math.min(4096, m.maxOutputTokens),
  messages,
});

type Provider = "anthropic" | "bedrock" | "vertex";
 
interface ResolvedModel {
  id: string;                  // そのプロバイダーで実際に使う識別子
  provider: Provider;
  maxOutputTokens: number;
  supportsPromptCache: boolean;
  supportsLongCacheTtl: boolean; // 1時間TTLの拡張キャッシュ
}
 
// 物理識別子は env から注入し、コードには焼き付けない
const REGISTRY: Record<string, Partial<Record<Provider, ResolvedModel>>> = {
  "reasoning-default": {
    anthropic: {
      id: "claude-fable-5",
      provider: "anthropic",
      maxOutputTokens: 128_000,
      supportsPromptCache: true,
      supportsLongCacheTtl: true,
    },
    bedrock: {
      id: process.env.BEDROCK_FABLE5_PROFILE ?? "",
      provider: "bedrock",
      maxOutputTokens: 64_000,        // 環境ごとの実上限に合わせる
      supportsPromptCache: true,
      supportsLongCacheTtl: false,
    },
  },
};
 
function currentProvider(): Provider {
  return (process.env.CLAUDE_PROVIDER as Provider) ?? "anthropic";
}
 
export function resolveModel(logical: string): ResolvedModel {
  const p = currentProvider();
  const entry = REGISTRY[logical]?.[p];
  if (!entry || !entry.id) {
    throw new Error(
      `モデル解決に失敗: logical=${logical} provider=${p}（識別子が未設定です）`
    );
  }
  return entry;
}

const m = resolveModel("reasoning-default");
 
const cacheControl = m.supportsLongCacheTtl
  ? { type: "ephemeral", ttl: "1h" as const }
  : m.supportsPromptCache
  ? { type: "ephemeral" as const }       // 既定TTLに自動で縮退
  : undefined;                           // キャッシュ自体が無い環境
 
const system = cacheControl
  ? [{ type: "text", text: SYSTEM_PROMPT, cache_control: cacheControl }]
  : SYSTEM_PROMPT;

export async function preflight(logical: string): Promise<void> {
  const m = resolveModel(logical);
  try {
    await client.messages.create({
      model: m.id,
      max_tokens: 1,
      messages: [{ role: "user", content: "ping" }],
    });
  } catch (e: any) {
    // 404/NotFound 系は「識別子がそのプロバイダーに無い」サイン
    throw new Error(
      `プリフライト失敗: ${logical} → ${m.id} @ ${m.provider} / ${e?.status ?? "?"} ${e?.message ?? e}`
    );
  }
}

// 同じ物理モデルでも、固定と浮動を別の論理名で持つ
// "reasoning-pinned"  → 日付入りスナップショット（本番の安定経路）
// "reasoning-latest"  → 浮動エイリアス（評価・非クリティカル経路）