pleumrouter 0.3.1 → 0.5.0

package/src/menu.mjs

@@ -1,22 +1,20 @@
 // Ollama 0.31 런처풍 시작 메뉴 — bare `pleum`(TTY)에서 뜬다. 비TTY면 false 반환(호출자가 HELP 폴백).
 // 동작 패리티(ollama cmd/tui/tui.go·cmd/launch 소스 분석 기반):
 //   · 인라인 렌더(대체 화면 아님), ▸ 커서 + dim 설명 2줄 항목, 하단 키 안내
-//   · "더 보기…"는 커서가 닿는 순간 그 자리에서 펼쳐지고, pinned 구간으로 올라가면 접힘
 //   · →(configure) = 모델 피커를 강제로 띄우고 선택 즉시 실행(+ launch_models에 저장)
 //   · Enter = 저장된 모델(launch_models)로 바로 실행, 미설치면 Y/n 확인 후 자동 설치
 //   · 실행 종료 후 메뉴로 복귀(ollama runInteractiveTUI 루프), last_selection 커서 복원
-//   · 키: ↑/k ↓/j · enter/space 실행 · →/l 모델 설정 · esc/q/ctrl+c 종료
-// 마우스(ollama엔 없음 — SGR 1002/1003/1006 직접 구현):
-//   · 호버=하이라이트 · 좌클릭=바로 실행 · 우클릭=모델 설정 · 휠=이동
-//   · 인라인 렌더라 프레임 상단 행이 가변 — 렌더마다 DSR \x1b[6n으로 끝 행을 얻어 좌표 매핑
+//   · 키보드 전용: ↑/k ↓/j 이동 · enter/space 실행 · →/l 모델 설정 · esc/q 뒤로(최상위에선 종료) · ctrl+c 즉시 종료
+// 에이전트는 최상위에 나열하지 않고 "에이전트 실행" 한 항목으로 묶어 서브메뉴(agentSelect)로 진입한다 —
+// 지원 에이전트가 많아질수록 최상위 목록이 늘어지는 것을 막기 위함(runList는 두 메뉴가 공유하는 렌더 루프).
 
 import { readFileSync } from "node:fs";
 import { spawn } from "node:child_process";
 import { createInterface } from "node:readline";
 import { style, displayWidth, terminalWidth, hyperlink } from "./ansi.mjs";
-import { keyFeeder, select, setMouse, lineIndexAt } from "./interactive.mjs";
+import { keyFeeder, select } from "./interactive.mjs";
 import { readConfig, writeConfig } from "./config.mjs";
-import { RECIPES } from "./recipes.mjs";
+import { RECIPES, MANUAL } from "./recipes.mjs";
 import { onPath, launch } from "./launch.mjs";
 import { fetchModels, matchModels, listModels } from "./models.mjs";
 import { run } from "./run.mjs";
@@ -25,57 +23,81 @@ import { top } from "./top.mjs";
 import { usage } from "./usage.mjs";
 import { balance } from "./balance.mjs";
 import { health } from "./health.mjs";
+import { runSettings } from "./settings.mjs";
+import { t } from "./i18n.mjs";
 
-const TOOL_DESC = {
-  claude: "Anthropic 코딩 에이전트 — 서브에이전트 지원",
-  codex: "OpenAI 코딩 에이전트",
-  aider: "터미널 페어 프로그래밍",
-  goose: "Block의 로컬 우선 에이전트",
-  openhands: "자율 개발 에이전트",
+// 값은 t() 키(영어 원문)만 담는다 — 여기서 t()를 호출하면 모듈 로드 시점(import 1회)에
+// 번역이 확정돼, 같은 프로세스 안에서 언어를 바꿔도(Settings) 이 설명들만 예전 언어로 남는다.
+// 실제 번역은 소비 지점(buildAgentItems)에서 매번 t()를 호출해 얻는다.
+const AGENT_DESC = {
+  claude: "Anthropic's coding agent — supports subagents",
+  codex: "OpenAI's coding agent",
+  aider: "Terminal pair programming",
+  goose: "Block's local-first agent",
+  openhands: "Autonomous dev agent",
+  opencode: "Multi-provider terminal coding agent",
+  omp: "Bun-based coding agent — Claude routing only",
+  hermes: "Nous Research's general-purpose agent",
+  qwen: "Alibaba's terminal coding agent",
+  copilot: "GitHub's terminal coding agent",
 };
 
 const autoInstallable = (r) => !/^https?:/.test(r.install); // URL이면 수동 설치 안내만
 
-// 메뉴 항목 빌드(순수 함수 — 테스트 대상). tool이 있는 항목만 →(모델 설정) 가능.
-export function buildItems({ loggedIn, installed, savedModels = {}, expanded = false }) {
+// 최상위 메뉴 항목(순수 함수 — 테스트 대상). 에이전트는 없음 — "agents" 한 항목으로 서브메뉴 진입.
+export function buildItems({ loggedIn, savedModels = {} }) {
   const items = [];
-  if (!loggedIn) items.push({ id: "login", title: "로그인", desc: "브라우저로 로그인하고 API 키를 저장합니다" });
+  if (!loggedIn) items.push({ id: "login", title: t("Log in"), desc: t("Log in via browser and save the API key") });
   items.push({
     id: "chat",
     tool: "chat",
-    title: "모델과 채팅",
-    desc: `대화형 채팅을 시작합니다${savedModels.chat ? ` · 모델: ${savedModels.chat}` : ""}`,
+    title: t("Chat with a model"),
+    desc: `${t("Start an interactive chat")}${savedModels.chat ? ` · ${t("model")}: ${savedModels.chat}` : ""}`,
   });
-  const tools = expanded ? Object.keys(RECIPES) : ["claude", "codex"];
-  for (const t of tools) {
-    const r = RECIPES[t];
+  items.push({ id: "agents", title: t("Run an agent"), desc: t("Pick a coding agent to run through PleumRouter") });
+  items.push(
+    { id: "models", title: t("Model list"), desc: t("All models — price and context included") },
+    { id: "top", title: t("Leaderboard"), desc: t("Model rankings · provider share") },
+    { id: "usage", title: t("Usage report"), desc: t("Spend over the last 30 days") },
+    { id: "balance", title: t("Balance"), desc: t("Check your credit balance") },
+    { id: "health", title: t("Health check"), desc: t("Gateway connectivity · login status") },
+    { id: "settings", title: t("Settings"), desc: t("Language, default models, account, updates") },
+  );
+  return items;
+}
+
+// 에이전트 서브메뉴 항목(순수 함수 — 테스트 대상). RECIPES(자동 실행) + MANUAL(설정 안내만) 전부 포함.
+export function buildAgentItems({ installed, savedModels = {} }) {
+  const items = [];
+  for (const [tool, r] of Object.entries(RECIPES)) {
     items.push({
-      id: `launch:${t}`,
-      tool: t,
-      title: `${r.label} 실행${installed[t] ? "" : autoInstallable(r) ? "  (설치)" : "  (미설치)"}`,
-      desc: installed[t]
-        ? `${TOOL_DESC[t]}${savedModels[t] ? ` · 모델: ${savedModels[t]}` : ""}`
+      id: `launch:${tool}`,
+      tool,
+      title: `${r.label}${installed[tool] ? "" : autoInstallable(r) ? `  (${t("install")})` : `  (${t("not installed")})`}`,
+      desc: installed[tool]
+        ? `${t(AGENT_DESC[tool] ?? "")}${savedModels[tool] ? ` · ${t("model")}: ${savedModels[tool]}` : ""}`
         : autoInstallable(r)
-          ? `Enter로 바로 설치 — ${r.install}`
-          : `수동 설치: ${hyperlink(r.install)}`,
+          ? `${t("Press Enter to install now")} — ${r.install}`
+          : `${t("Manual install:")} ${hyperlink(r.install)}`,
     });
   }
-  if (expanded) {
-    items.push(
-      { id: "models", title: "모델 목록", desc: "전체 모델 — 가격·컨텍스트 포함" },
-      { id: "top", title: "리더보드", desc: "모델 랭킹·제공자 점유율" },
-      { id: "usage", title: "지출 리포트", desc: "최근 30일 내 지출" },
-      { id: "balance", title: "잔액", desc: "크레딧 잔액 조회" },
-      { id: "health", title: "상태 점검", desc: "게이트웨이 연결·로그인 상태" },
-    );
-  } else {
-    items.push({ id: "more", title: "더 보기…", desc: "다른 에이전트 · 모델 목록 · 잔액 · 리더보드" });
+  for (const [tool, m] of Object.entries(MANUAL)) {
+    items.push({
+      id: `launch:${tool}`,
+      tool,
+      manual: true,
+      title: `${m.label}  (${t("setup required")})`,
+      desc: installed[tool]
+        ? t("Installed — press Enter for the {file} setup snippet", { file: m.file })
+        : `${t("✗ not installed —")} ${m.install}`,
+    });
   }
   return items;
 }
 
 // 항목별 기본 모델 저장(launch_models). 로그인 전에도 동작 — /v1/models는 공개.
-function saveModel(tool, id) {
+// settings.mjs의 "Default models" 화면도 재사용(순환 import — 아래 runList 주석 참고).
+export function saveModel(tool, id) {
   const cfg = readConfig() ?? {};
   cfg.launch_models = { ...cfg.launch_models, [tool]: id };
   writeConfig(cfg);
@@ -93,11 +115,11 @@ async function pickModelFor(item) {
   try {
     models = await fetchModels();
   } catch (e) {
-    console.log(`${style.red("✗")} 모델 목록 조회 실패: ${e.message}`);
+    console.log(`${style.red("✗")} ${t("Failed to fetch model list: {error}", { error: e.message })}`);
     return undefined;
   }
   const m = await select(models, {
-    message: `${item.title.replace(/\s+\((설치|미설치)\)/, "")} — 모델 선택`,
+    message: `${item.title} — ${t("select a model")}`,
     formatItem: (x) => `${x.id}${x.display_name ? `  ${style.dim(x.display_name)}` : ""}`,
     matches: matchModels,
     limit: 12,
@@ -108,14 +130,14 @@ async function pickModelFor(item) {
 // 미설치 도구: ollama처럼 확인 후 그 자리에서 설치(stdio 상속). 성공 시 true.
 async function ensureInstalled(r) {
   if (!autoInstallable(r)) {
-    console.log(`${r.label}는 수동 설치가 필요합니다:\n  ${style.bold(hyperlink(r.install))}`);
+    console.log(`${t("{label} needs manual installation:", { label: r.label })}\n  ${style.bold(hyperlink(r.install))}`);
     return false;
   }
   const rl = createInterface({ input: process.stdin, output: process.stdout });
-  const ans = await new Promise((res) => rl.question(`${r.label}가 설치되어 있지 않습니다. 지금 설치할까요? [Y/n] `, res));
+  const ans = await new Promise((res) => rl.question(t("{label} isn't installed. Install it now? [Y/n] ", { label: r.label }), res));
   rl.close();
   if (/^n/i.test(ans.trim())) {
-    console.log(`설치 취소 — 수동 설치: ${r.install}`);
+    console.log(t("Install canceled — manual install: {install}", { install: r.install }));
     return false;
   }
   console.log(style.dim(`$ ${r.install}`));
@@ -125,59 +147,26 @@ async function ensureInstalled(r) {
     c.on("error", () => res(1));
   });
   if (code !== 0) {
-    console.log(`${style.red("✗")} 설치 실패 (exit ${code})`);
+    console.log(`${style.red("✗")} ${t("Install failed (exit {code})", { code })}`);
     return false;
   }
-  console.log(`${style.green("✓")} ${r.label} 설치 완료`);
+  console.log(`${style.green("✓")} ${t("{label} installed", { label: r.label })}`);
   return true;
 }
 
-// 클릭 y좌표 → 항목 인덱스(순수 함수 — 테스트 대상).
-// 프레임 구조: [헤더, 공백, 항목별 2줄…, 공백, 푸터]. 항목 밖(헤더/공백/푸터)이면 -1.
-export function itemIndexAt(y, cprRow, lines, itemCount, rowsFor) {
-  const li = lineIndexAt(y, cprRow, lines, rowsFor);
-  if (li < 2) return -1;
-  const idx = (li - 2) >> 1;
-  return idx < itemCount ? idx : -1;
-}
-
-// 화살표+마우스 메뉴 루프 — {item, model?} 또는 null(Esc) 반환. 비TTY면 undefined.
-async function menuSelect() {
+// 화살표 메뉴 루프(키보드 전용) — {item, model?} · "quit"(ctrl+c) · null(esc/q) 반환. 비TTY면 undefined.
+// 메인 메뉴·에이전트 서브메뉴·Settings 서브메뉴(settings.mjs)가 공유하는 렌더 루프 —
+// header/footer/초기 커서만 다르다. settings.mjs가 이 함수를 import하고 menu.mjs가
+// settings.mjs의 runSettings를 import하는 순환 참조가 생기지만, 둘 다 모듈 최상위가 아니라
+// 사용자가 실제로 메뉴를 조작하는 async 함수 안에서만 서로를 참조하므로 안전하다
+// (모듈 최상위에서 즉시 호출하면 "Cannot access before initialization"이 난다 — 이 제약 유지 필수).
+export async function runList(items, { header, footer, initialCursor = 0 } = {}) {
   const input = process.stdin;
   const output = process.stdout;
   if (!input.isTTY || !output.isTTY || typeof input.setRawMode !== "function") return undefined;
 
-  const installed = Object.fromEntries(Object.entries(RECIPES).map(([t, r]) => [t, onPath(r.bin)]));
-  const version = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
-  let expanded = false;
-  const rebuild = () => {
-    const cfg = readConfig();
-    return buildItems({ loggedIn: Boolean(cfg?.key), installed, savedModels: cfg?.launch_models ?? {}, expanded });
-  };
-
-  let items = rebuild();
-  const pinnedCount = items.length - 1; // "더 보기…" 자리 — 여기 닿으면 펼침, 위로 벗어나면 접힘
-  let cursor = 0;
-
-  // last_selection 커서 복원 — 더 보기 그룹에 있었으면 펼친 채 시작(ollama shouldExpandOthers).
-  const last = readConfig()?.last_selection;
-  if (last) {
-    let idx = items.findIndex((it) => it.id === last);
-    if (idx < 0) {
-      expanded = true;
-      items = rebuild();
-      idx = items.findIndex((it) => it.id === last);
-      if (idx < 0) {
-        expanded = false;
-        items = rebuild();
-      }
-    }
-    if (idx >= 0) cursor = idx;
-  }
-
+  let cursor = Math.max(0, Math.min(initialCursor, items.length - 1));
   let lastRows = 0;
-  let lastLines = [];
-  let cprRow = 0;
 
   const rowsFor = (s) => Math.max(1, Math.ceil(displayWidth(s) / Math.max(terminalWidth(), 1)));
   const erase = () => {
@@ -187,7 +176,7 @@ async function menuSelect() {
   };
   const render = () => {
     const lines = [
-      `${style.bold(style.plum("PleumRouter"))} ${style.dim(`pleum ${version}`)}`,
+      header,
       "",
       ...items.flatMap((it, i) =>
         i === cursor
@@ -195,38 +184,20 @@ async function menuSelect() {
           : [`  ${it.title}`, `    ${style.dim(it.desc)}`],
       ),
       "",
-      style.dim("↑/↓·휠 이동 • enter·클릭 실행 • →·우클릭 모델 설정 • esc 종료"),
+      style.dim(footer),
     ];
     erase();
     output.write(lines.join("\n"));
     lastRows = lines.reduce((n, l) => n + rowsFor(l), 0);
-    lastLines = lines;
-    output.write("\x1b[6n"); // CPR 질의 — 마우스 좌표 매핑용
   };
-
-  const moveTo = (next) => {
-    if (!expanded && next === pinnedCount) {
-      expanded = true; // "더 보기…"에 커서가 닿으면 그 자리에서 펼침
-      items = rebuild();
-      cursor = next;
-      return;
-    }
-    if (expanded && next < pinnedCount) {
-      expanded = false; // pinned 구간으로 돌아가면 접힘
-      items = rebuild();
-      cursor = next;
-      return;
-    }
-    cursor = next;
+  const move = (dir) => {
+    cursor = Math.max(0, Math.min(items.length - 1, cursor + dir));
   };
-  const move = (dir) => moveTo(Math.max(0, Math.min(items.length - 1, cursor + dir)));
-  const itemAt = (y) => itemIndexAt(y, cprRow, lastLines, items.length, rowsFor);
 
   return new Promise((resolve) => {
     const suspend = () => {
       input.off("data", onData);
       input.setRawMode(false);
-      setMouse(output, false);
       output.write("\x1b[?25h");
       erase();
     };
@@ -234,7 +205,6 @@ async function menuSelect() {
       input.setRawMode(true);
       input.resume();
       output.write("\x1b[?25l");
-      setMouse(output, true);
       input.on("data", onData);
       render();
     };
@@ -243,7 +213,7 @@ async function menuSelect() {
       input.pause();
       resolve(value);
     };
-    // 모델 셀렉터는 자체 raw-mode·마우스 관리 — 메뉴 입력을 내려놓고 넘긴다.
+    // 모델 셀렉터는 자체 raw-mode 관리 — 메뉴 입력을 내려놓고 넘긴다.
     // 선택되면 ollama처럼 즉시 실행으로 이어가고, 취소면 메뉴 복귀.
     const configure = async (it) => {
       suspend();
@@ -258,42 +228,18 @@ async function menuSelect() {
 
     const feed = keyFeeder();
     const onData = async (chunk) => {
-      let dirty = false; // CPR만 온 턴에 재렌더하면 렌더→CPR 질의→응답 무한 루프
+      let dirty = false;
       for (const key of feed(chunk)) {
-        if (key.type === "ctrlc" || key.type === "escape" || (key.type === "char" && key.value === "q")) {
-          return finish(null);
-        }
-        if (key.type === "cpr") {
-          cprRow = key.row;
-          continue;
-        }
+        if (key.type === "ctrlc") return finish("quit"); // 어느 메뉴에 있든 즉시 전체 종료
+        if (key.type === "escape" || (key.type === "char" && key.value === "q")) return finish(null); // 서브메뉴면 상위로, 최상위면 종료
         if (key.type === "enter" || (key.type === "char" && key.value === " ")) {
           return finish({ item: items[cursor] });
         }
-        if (key.type === "mouse") {
-          if (key.wheel === "up") move(-1);
-          else if (key.wheel === "down") move(1);
-          else if (key.motion) {
-            const idx = itemAt(key.y);
-            if (idx < 0 || idx === cursor) continue;
-            moveTo(idx);
-          } else if (!key.release && key.btn === 0) {
-            const idx = itemAt(key.y);
-            if (idx < 0) continue;
-            const wasMore = !expanded && items[idx]?.id === "more";
-            moveTo(idx);
-            if (!wasMore) return finish({ item: items[cursor] });
-          } else if (!key.release && key.btn === 2) {
-            const idx = itemAt(key.y);
-            if (idx < 0 || !items[idx].tool) continue;
-            moveTo(idx);
-            return void (await configure(items[cursor]));
-          } else continue;
-        } else if (key.type === "up" || (key.type === "char" && key.value === "k")) move(-1);
+        if (key.type === "up" || (key.type === "char" && key.value === "k")) move(-1);
         else if (key.type === "down" || (key.type === "char" && key.value === "j")) move(1);
         else if (key.type === "right" || (key.type === "char" && key.value === "l")) {
           const it = items[cursor];
-          if (!it.tool) continue;
+          if (!it.tool || it.manual) continue; // 도구 없는 항목·수동 설정 항목은 모델 설정 불가
           return void (await configure(it));
         } else continue;
         dirty = true;
@@ -305,19 +251,42 @@ async function menuSelect() {
     input.setRawMode(true);
     input.resume();
     output.write("\x1b[?25l");
-    setMouse(output, true);
     input.on("data", onData);
     render();
   });
 }
 
+async function menuSelect() {
+  const version = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+  const cfg = readConfig();
+  const items = buildItems({ loggedIn: Boolean(cfg?.key), savedModels: cfg?.launch_models ?? {} });
+  const last = cfg?.last_selection;
+  const initialCursor = last ? Math.max(0, items.findIndex((it) => it.id === last)) : 0;
+  return runList(items, {
+    header: `${style.bold(style.plum("PleumRouter"))} ${style.dim(`pleum ${version}`)}`,
+    footer: t("↑/↓ move • enter run • → set model • esc quit"),
+    initialCursor,
+  });
+}
+
+async function agentSelect() {
+  const installed = Object.fromEntries(
+    [...Object.entries(RECIPES), ...Object.entries(MANUAL)].map(([tool, r]) => [tool, onPath(r.bin)]),
+  );
+  const items = buildAgentItems({ installed, savedModels: readConfig()?.launch_models ?? {} });
+  return runList(items, {
+    header: style.bold(style.plum(t("Run an agent via PleumRouter"))),
+    footer: t("↑/↓ move • enter run • → set model • esc back"),
+  });
+}
+
 // bare `pleum` 진입점. 비TTY면 false(호출자가 HELP 출력), 그 외 true.
-// ollama처럼 실행이 끝나면 메뉴로 복귀하는 루프(REPL 채팅·Esc 종료 제외).
+// ollama처럼 실행이 끝나면 메뉴로 복귀하는 루프(REPL 채팅·ctrl+c 종료 제외).
 export async function mainMenu() {
   for (;;) {
     const picked = await menuSelect();
     if (picked === undefined) return false; // 비TTY
-    if (picked === null) return true; // Esc — ollama처럼 조용히 종료
+    if (picked === null || picked === "quit") return true; // esc/q/ctrl+c — ollama처럼 조용히 종료
 
     const { item, model } = picked;
     if (item.id !== "login") saveLastSelection(item.id);
@@ -348,10 +317,23 @@ export async function mainMenu() {
       case "health":
         await health();
         continue;
-      default: {
-        const r = RECIPES[item.tool];
-        if (!onPath(r.bin) && !(await ensureInstalled(r))) continue;
-        await launch(item.tool, model ?? saved[item.tool], [], { exit: false });
+      case "settings": {
+        const r = await runSettings();
+        if (r === "quit") return true; // ctrl+c 또는 재설치(upgrade) 시작 — 전체 종료
+        continue; // esc/q — 메인 메뉴로 복귀
+      }
+      case "agents": {
+        const agentPicked = await agentSelect();
+        if (agentPicked === "quit") return true; // 서브메뉴에서 ctrl+c → 전체 종료
+        if (!agentPicked) continue; // esc/q — 메인 메뉴로 복귀
+        const { item: agentItem, model: agentModel } = agentPicked;
+        if (agentModel && !agentItem.manual) saveModel(agentItem.tool, agentModel);
+        if (!agentItem.manual) {
+          const r = RECIPES[agentItem.tool];
+          if (!onPath(r.bin) && !(await ensureInstalled(r))) continue;
+        }
+        const agentSaved = readConfig()?.launch_models ?? {};
+        await launch(agentItem.tool, agentModel ?? agentSaved[agentItem.tool], [], { exit: false });
         console.log(); // 에이전트 출력과 다음 메뉴 사이 여백
         continue; // ollama처럼 에이전트 종료 후 메뉴 복귀
       }

package/src/models.mjs

@@ -1,10 +1,11 @@
 import { V1 } from "./config.mjs";
 import { style, padDisplay, divider } from "./ansi.mjs";
+import { t } from "./i18n.mjs";
 
 // GET /v1/models 는 공개(인증 불필요). 슬러그는 provider/model 형식.
 export async function fetchModels() {
   const res = await fetch(`${V1}/models`);
-  if (!res.ok) throw new Error(`모델 목록 조회 실패 (${res.status})`);
+  if (!res.ok) throw new Error(t("Failed to fetch model list ({status})", { status: res.status }));
   const data = await res.json();
   return data.data ?? [];
 }
@@ -84,7 +85,7 @@ export async function listModels(rest) {
     : { json: false, info: false, query: rest };
   if (info) {
     if (!query) {
-      console.error("사용법: pleum models <model-id> --info");
+      console.error(t("Usage: pleum models <model-id> --info"));
       process.exit(1);
     }
     return showModelInfo(query, { json });
@@ -96,19 +97,19 @@ export async function listModels(rest) {
     return;
   }
   if (!rows.length) {
-    console.log("일치하는 모델 없음");
+    console.log(t("No matching models"));
     return;
   }
   console.log(formatTable(rows));
-  console.log(style.dim(`\n${rows.length} models · 가격=토큰 1M당(표시환율 기준, 실청구는 장중 환율로 소폭 상이)`));
+  console.log(style.dim(`\n${rows.length} models · ${t("price = per 1M tokens (display rate; actual billing may vary slightly with the intraday rate)")}`));
 }
 
 // ── 모델 상세(ollama show 대응) — GET /v1/models/{id} ────────────────────
 // id는 provider/model 형식이라 슬래시를 그대로 둔다(백엔드 :path 컨버터).
 export async function fetchModelDetail(id) {
   const res = await fetch(`${V1}/models/${id}`);
-  if (res.status === 404) throw new Error(`모델을 찾을 수 없음: ${id}  (목록: pleum models)`);
-  if (!res.ok) throw new Error(`모델 상세 조회 실패 (${res.status})`);
+  if (res.status === 404) throw new Error(t("Model not found: {id}  (list: pleum models)", { id }));
+  if (!res.ok) throw new Error(t("Failed to fetch model detail ({status})", { status: res.status }));
   return res.json();
 }
 
@@ -125,16 +126,16 @@ export function renderModelInfo(m, styler = style) {
     ["modality", m.modality || "text"],
     ["context", fmtCtx(m.context_length || m.context_window)],
     ["max output", fmtCtx(m.max_output_tokens || m.max_output)],
-    ["가격/1M", `입력 ${pin} · 출력 ${pout} ${styler.dim(`(마크업 ${m.effective_markup_percent ?? 0}% 포함)`)}`],
+    [t("price/1M"), `${t("in")} ${pin} · ${t("out")} ${pout} ${styler.dim(t("(incl. {pct}% markup)", { pct: m.effective_markup_percent ?? 0 }))}`],
   ];
-  if (m.supports_thinking) facts.push(["thinking", m.thinking_forced ? "강제(끌 수 없음)" : "지원"]);
+  if (m.supports_thinking) facts.push(["thinking", m.thinking_forced ? t("forced (can't be turned off)") : t("supported")]);
   for (const [k, v] of facts) lines.push(`${styler.dim(padDisplay(k, 10))} ${v}`);
 
   const u = m.usage;
   if (u) {
     lines.push(
-      `${styler.dim(padDisplay("사용량", 10))} 주간 ${fmtNum(u.weekly_calls)} calls · ${fmtNum(u.weekly_tokens)} tok` +
-        styler.dim(`  (누적 ${fmtNum(u.total_calls)} calls)`),
+      `${styler.dim(padDisplay(t("usage"), 10))} ${t("weekly")} ${fmtNum(u.weekly_calls)} calls · ${fmtNum(u.weekly_tokens)} tok` +
+        styler.dim(`  (${t("total")} ${fmtNum(u.total_calls)} calls)`),
     );
   }
 
@@ -161,7 +162,7 @@ export function renderModelInfo(m, styler = style) {
   const sibs = (m.siblings || []).map((s) => s.id);
   if (sibs.length) {
     lines.push("");
-    lines.push(`${styler.dim("같은 제공자:")} ${sibs.join(styler.dim(" · "))}`);
+    lines.push(`${styler.dim(t("Same provider:"))} ${sibs.join(styler.dim(" · "))}`);
   }
   return lines.join("\n");
 }