pleumrouter 0.3.0 → 0.4.0

package/src/run.mjs

@@ -6,6 +6,7 @@ import { fetchModels, formatTable, matchModels } from "./models.mjs";
 import { style, divider } from "./ansi.mjs";
 import { createMarkdownStream } from "./markdown.mjs";
 import { spinner, select } from "./interactive.mjs";
+import { t } from "./i18n.mjs";
 
 const IMG_EXT = /\.(png|jpe?g|gif|webp|bmp)$/i;
 
@@ -67,14 +68,14 @@ export async function run(rest) {
   if (!model && !oneShot) {
     if (!process.stdin.isTTY) {
       // 비대화형(non-TTY) stdin이면 인터랙티브 모델 선택이 멈춰버리므로 명확히 안내하고 종료(L10).
-      console.error('모델을 지정하세요: pleum run <model> ["프롬프트"]  (비대화형 stdin에선 모델 선택 불가)');
+      console.error(t('Specify a model: pleum run <model> ["prompt"]  (model selection isn\'t available on non-interactive stdin)'));
       process.exit(1);
     }
     model = await pickModel(); // 인터랙티브 모델 선택
     if (!model) process.exit(1);
   }
   if (!model) {
-    console.error('사용법: pleum run <model> ["프롬프트"]\n모델 목록: pleum models');
+    console.error(t('Usage: pleum run <model> ["prompt"]\nModel list: pleum models'));
     process.exit(1);
   }
 
@@ -84,7 +85,7 @@ export async function run(rest) {
     if (Array.isArray(content)) {
       const n = content.filter((p) => p.type === "image_url").length;
       // 프롬프트 내 로컬 이미지 경로를 자동 첨부·업로드하므로 조용히 올리지 않고 명시 고지한다(M8).
-      console.error(`ℹ 프롬프트의 로컬 이미지 ${n}개를 첨부해 업로드합니다.`);
+      console.error(`ℹ ${t("Attaching and uploading {n} local image(s) from the prompt.", { n })}`);
     }
     const messages = [{ role: "user", content }];
     try {
@@ -204,7 +205,7 @@ async function repl(key, initialModel, initialVerbose) {
   const onClose = () => {
     if (pickerActive) return;
     saveHistory(rl.history);
-    console.log(`\n${style.dim("안녕히 가세요.")}`);
+    console.log(`\n${style.dim(t("Goodbye."))}`);
     process.exit(0);
   };
 
@@ -220,7 +221,7 @@ async function repl(key, initialModel, initialVerbose) {
       return;
     }
     lastSigint = now;
-    console.log(`\n${style.dim("한 번 더 Ctrl+C 하면 종료 (/exit 도 가능)")}`);
+    console.log(`\n${style.dim(t("Ctrl+C again to quit (or /exit)"))}`);
     rl.prompt();
   };
 
@@ -240,23 +241,23 @@ async function repl(key, initialModel, initialVerbose) {
 
   makeRl(loadHistory());
   console.log(`${style.bold(style.plum("PleumRouter"))} ${style.dim("·")} ${model}`);
-  console.log(style.dim('/help 명령 · /exit 종료 · 여러 줄은 """ 감싸기 · 생성 중 Ctrl+C=중단'));
+  console.log(style.dim(t('/help for commands · /exit to quit · wrap multi-line input in """ · Ctrl+C to stop generation')));
   console.log(divider());
   rl.prompt();
 }
 
-const SLASH_HELP = `명령:
-  /help, /?           이 도움말
-  /clear              대화 컨텍스트 초기화(시스템 프롬프트는 유지)
-  /system [텍스트]    시스템 프롬프트 설정(인자 없으면 현재값 표시)
-  /model [id]         세션 유지한 채 모델 전환(인자 없으면 화살표 선택)
-  /models [검색어]    모델 목록 보기
-  /save [이름]        현재 세션 저장(기본 last)
-  /load [이름]        세션 불러오기
-  /verbose            토큰·속도 통계 표시 토글
-  /exit, /quit        종료
-  여러 줄 입력: """ 한 줄 → 본문 → """ 한 줄
-  이미지: 메시지에 이미지 파일 경로를 그대로 포함(예: 이 그림 설명해줘 ./shot.png)`;
+const SLASH_HELP = t(`Commands:
+  /help, /?           this help
+  /clear              reset the conversation context (keeps the system prompt)
+  /system [text]      set the system prompt (no arg shows the current value)
+  /model [id]         switch models mid-session (no arg = arrow-key picker)
+  /models [query]     browse the model list
+  /save [name]        save the current session (default: last)
+  /load [name]        load a saved session
+  /verbose            toggle token/speed stats
+  /exit, /quit        quit
+  Multi-line input: a line with """ → body → a line with """
+  Images: include an image file path right in the message (e.g. describe this ./shot.png)`);
 
 async function handleSlash(text, ctx) {
   const [cmd] = text.slice(1).split(/\s+/);
@@ -268,37 +269,37 @@ async function handleSlash(text, ctx) {
       break;
     case "clear":
       ctx.clear();
-      console.log(`${style.green("✓")} 컨텍스트 초기화`);
+      console.log(`${style.green("✓")} ${t("Context cleared")}`);
       break;
     case "system":
       if (arg) {
         ctx.system = arg;
-        console.log(`${style.green("✓")} 시스템 프롬프트 설정`);
+        console.log(`${style.green("✓")} ${t("System prompt set")}`);
       } else {
-        console.log(ctx.system ? `현재 시스템 프롬프트:\n${ctx.system}` : "시스템 프롬프트 없음");
+        console.log(ctx.system ? `${t("Current system prompt:")}\n${ctx.system}` : t("No system prompt"));
       }
       break;
     case "model":
       if (arg) {
         ctx.model = arg;
-        console.log(`${style.green("✓")} 모델 전환 → ${style.plum(arg)}`);
+        console.log(`${style.green("✓")} ${t("Switched model →")} ${style.plum(arg)}`);
       } else if (ctx.pickModel) {
         const picked = await ctx.pickModel();
         if (picked) {
           ctx.model = picked;
-          console.log(`${style.green("✓")} 모델 전환 → ${style.plum(picked)}`);
+          console.log(`${style.green("✓")} ${t("Switched model →")} ${style.plum(picked)}`);
         } else {
-          console.log(`현재 모델: ${style.plum(ctx.model)}`);
+          console.log(`${t("Current model:")} ${style.plum(ctx.model)}`);
         }
       } else {
-        console.log(`현재 모델: ${ctx.model}\n전환: /model <id>  ·  목록: /models`);
+        console.log(`${t("Current model:")} ${ctx.model}\n${t("switch: /model <id>  ·  list: /models")}`);
       }
       break;
     case "models":
       try {
         const models = await fetchModels();
         const rows = matchModels(models, arg);
-        console.log(rows.length ? formatTable(rows) : "일치하는 모델 없음");
+        console.log(rows.length ? formatTable(rows) : t("No matching models"));
       } catch (e) {
         console.error(`${style.red("✗")} ${e.message}`);
       }
@@ -306,25 +307,25 @@ async function handleSlash(text, ctx) {
     case "save":
       try {
         const name = saveSession(arg || "last", ctx.snapshot());
-        console.log(`${style.green("✓")} 세션 저장: ${name}`);
+        console.log(`${style.green("✓")} ${t("Session saved:")} ${name}`);
       } catch (e) {
-        console.error(`${style.red("✗")} 저장 실패: ${e.message}`);
+        console.error(`${style.red("✗")} ${t("Save failed: {error}", { error: e.message })}`);
       }
       break;
     case "load":
       try {
         ctx.restore(loadSession(arg || "last"));
-        console.log(`${style.green("✓")} 세션 불러옴 (모델: ${ctx.model})`);
+        console.log(`${style.green("✓")} ${t("Session loaded (model: {model})", { model: ctx.model })}`);
       } catch {
-        console.error(`${style.red("✗")} 세션 없음: ${arg || "last"}`);
+        console.error(`${style.red("✗")} ${t("No such session: {name}", { name: arg || "last" })}`);
       }
       break;
     case "verbose":
       ctx.verbose = !ctx.verbose;
-      console.log(`${style.green("✓")} 통계 ${ctx.verbose ? "켜짐" : "꺼짐"}`);
+      console.log(`${style.green("✓")} ${t("Stats {state}", { state: ctx.verbose ? t("on") : t("off") })}`);
       break;
     default:
-      console.log(`알 수 없는 명령: /${cmd}  (/help)`);
+      console.log(t("Unknown command: /{cmd}  (/help)", { cmd }));
   }
 }
 
@@ -332,7 +333,7 @@ async function handleSlash(text, ctx) {
 // 비용은 마지막 SSE 청크의 cost.krw — 스트리밍 응답엔 X-Cost-Krw 헤더가 없다(백엔드 계약).
 export async function streamChat(key, model, messages, { verbose = false, quiet = false, signal, fetchImpl = fetch } = {}) {
   const t0 = Date.now();
-  const sp = spinner(`${model} 생각 중…`);
+  const sp = spinner(t("{model} thinking…", { model }));
   let res;
   try {
     res = await fetchImpl(`${V1}/chat/completions`, {
@@ -344,7 +345,7 @@ export async function streamChat(key, model, messages, { verbose = false, quiet
   } catch (e) {
     sp.stop();
     if (isAbort(e)) {
-      console.error(style.dim("⏹ 중단됨"));
+      console.error(style.dim(t("⏹ aborted")));
       return "";
     }
     throw e;
@@ -400,7 +401,7 @@ export async function streamChat(key, model, messages, { verbose = false, quiet
   }
   sp.stop();
   md.finish();
-  if (aborted) console.error(style.dim("⏹ 생성 중단됨 — 부분 응답은 컨텍스트에 유지"));
+  if (aborted) console.error(style.dim(t("⏹ generation aborted — the partial reply stays in context")));
 
   const ms = Date.now() - t0;
   const genSec = (Date.now() - (firstAt || t0)) / 1000;
@@ -421,13 +422,13 @@ async function pickModel() {
   try {
     models = await fetchModels();
   } catch (e) {
-    console.error(`${style.red("✗")} 모델 목록 조회 실패: ${e.message}`);
+    console.error(`${style.red("✗")} ${t("Failed to fetch model list: {error}", { error: e.message })}`);
     return null;
   }
   if (!models.length) return null;
   if (process.stdin.isTTY && process.stdout.isTTY) {
     return select(models, {
-      message: "모델 선택",
+      message: t("Select a model"),
       formatItem: (m) => `${m.id}${m.display_name ? `  ${style.dim(m.display_name)}` : ""}`,
       matches: matchModels,
       limit: 12,
@@ -447,14 +448,14 @@ async function pickModelNumbered(models) {
       shown.forEach((m, i) =>
         console.log(`  ${String(i + 1).padStart(2)}. ${m.id}${m.display_name ? `  (${m.display_name})` : ""}`),
       );
-      if (pool.length > shown.length) console.log(`  … ${pool.length - shown.length}개 더 — 검색어로 좁히기`);
-      const ans = (await ask("\n번호 선택 또는 검색어 (Enter=취소): ")).trim();
+      if (pool.length > shown.length) console.log(`  ${t("… {n} more — narrow with a search term", { n: pool.length - shown.length })}`);
+      const ans = (await ask(`\n${t("Choose a number, or search (Enter to cancel): ")}`)).trim();
       if (!ans) return null;
       const n = Number(ans);
       if (Number.isInteger(n) && n >= 1 && n <= shown.length) return shown[n - 1].id;
       const next = matchModels(models, ans);
       pool = next.length ? next : models;
-      if (!next.length) console.log("일치 없음 — 전체 목록으로.");
+      if (!next.length) console.log(t("No matches — showing the full list."));
     }
   } finally {
     rl.close();

package/src/top.mjs

@@ -3,6 +3,7 @@
 
 import { V1 } from "./config.mjs";
 import { style, padDisplay, barChart, divider } from "./ansi.mjs";
+import { t } from "./i18n.mjs";
 
 export function parseTopArgs(rest = []) {
   let period = "weekly";
@@ -11,7 +12,7 @@ export function parseTopArgs(rest = []) {
     else if (["daily", "weekly", "monthly"].includes(rest[i])) period = rest[i];
   }
   if (!["daily", "weekly", "monthly"].includes(period)) {
-    throw new Error(`period는 daily|weekly|monthly 중 하나: ${period}`);
+    throw new Error(t("period must be one of daily|weekly|monthly: {period}", { period }));
   }
   return { period };
 }
@@ -25,14 +26,14 @@ const fmtTok = (n) => {
 
 // rankings 응답 → 표시 문자열(순수 함수 — fixture 테스트 대상).
 export function renderTop(data, styler = style) {
-  const periodKo = { daily: "일간", weekly: "주간", monthly: "월간" }[data.period] || data.period;
+  const periodLabel = { daily: t("daily"), weekly: t("weekly"), monthly: t("monthly") }[data.period] || data.period;
   const lines = [];
-  lines.push(`${styler.bold(styler.plum("모델 리더보드"))} ${styler.dim(`· ${periodKo} · 토큰 ${fmtTok(data.total_tokens ?? 0)}`)}`);
+  lines.push(`${styler.bold(styler.plum(t("Model leaderboard")))} ${styler.dim(`· ${periodLabel} · ${t("tokens")} ${fmtTok(data.total_tokens ?? 0)}`)}`);
   lines.push(divider(undefined, styler));
 
   const board = data.leaderboard || [];
   if (!board.length) {
-    lines.push(styler.dim("데이터 없음"));
+    lines.push(styler.dim(t("No data")));
   } else {
     const idW = Math.max(...board.map((r) => r.model.length), 5);
     for (const r of board) {
@@ -53,7 +54,7 @@ export function renderTop(data, styler = style) {
   const share = data.market_share || [];
   if (share.length) {
     lines.push("");
-    lines.push(styler.bold("제공자 점유율"));
+    lines.push(styler.bold(t("Provider share")));
     const nameW = Math.max(...share.map((s) => s.provider.length), 8);
     for (const s of share) {
       lines.push(
@@ -67,6 +68,6 @@ export function renderTop(data, styler = style) {
 export async function top(rest) {
   const { period } = parseTopArgs(rest);
   const res = await fetch(`${V1}/stats/rankings?period=${period}`);
-  if (!res.ok) throw new Error(`리더보드 조회 실패 (${res.status})`);
+  if (!res.ok) throw new Error(t("Failed to fetch leaderboard ({status})", { status: res.status }));
   console.log(renderTop(await res.json()));
 }

package/src/usage.mjs

@@ -3,6 +3,7 @@
 
 import { V1, requireKey } from "./config.mjs";
 import { style, padDisplay, barChart, divider } from "./ansi.mjs";
+import { t } from "./i18n.mjs";
 
 const GROUPS = ["model", "provider", "api_key", "day"];
 
@@ -13,8 +14,8 @@ export function parseUsageArgs(rest = []) {
     if (rest[i] === "--by") by = rest[++i];
     else if (rest[i] === "--days") days = Number(rest[++i]);
   }
-  if (!GROUPS.includes(by)) throw new Error(`--by 는 ${GROUPS.join("|")} 중 하나: ${by}`);
-  if (!Number.isInteger(days) || days < 1 || days > 365) throw new Error(`--days 는 1~365 정수: ${days}`);
+  if (!GROUPS.includes(by)) throw new Error(t("--by must be one of {groups}: {by}", { groups: GROUPS.join("|"), by }));
+  if (!Number.isInteger(days) || days < 1 || days > 365) throw new Error(t("--days must be an integer 1-365: {days}", { days }));
   return { by, days };
 }
 
@@ -23,12 +24,12 @@ const fmtKrw = (n) => `₩${Math.round(n).toLocaleString("en-US")}`;
 // report 응답 → 표시 문자열(순수 함수 — fixture 테스트 대상).
 export function renderUsage(data, styler = style) {
   const lines = [];
-  const byKo = { model: "모델별", provider: "제공자별", api_key: "키별", day: "일별" }[data.group_by] || data.group_by;
-  lines.push(`${styler.bold(styler.plum("사용량"))} ${styler.dim(`· ${byKo} · 최근 ${data.days}일`)}`);
+  const byLabel = { model: t("by model"), provider: t("by provider"), api_key: t("by key"), day: t("by day") }[data.group_by] || data.group_by;
+  lines.push(`${styler.bold(styler.plum(t("Usage")))} ${styler.dim(`· ${byLabel} · ${t("last {days} days", { days: data.days })}`)}`);
   lines.push(divider(undefined, styler));
   const items = data.items || [];
   if (!items.length) {
-    lines.push(styler.dim("사용 내역 없음"));
+    lines.push(styler.dim(t("No usage history")));
     return lines.join("\n");
   }
   const max = Math.max(...items.map((i) => i.cost_krw), 1);
@@ -43,7 +44,7 @@ export function renderUsage(data, styler = style) {
     );
   }
   lines.push(divider(undefined, styler));
-  lines.push(`${padDisplay("합계", keyW)}  ${" ".repeat(20)} ${styler.bold(fmtKrw(total.cost))}${styler.dim(`  ${total.calls} calls`)}`);
+  lines.push(`${padDisplay(t("Total"), keyW)}  ${" ".repeat(20)} ${styler.bold(fmtKrw(total.cost))}${styler.dim(`  ${total.calls} calls`)}`);
   return lines.join("\n");
 }
 
@@ -56,14 +57,14 @@ export async function usage(rest) {
   if (res.status === 403) {
     // 구버전 로그인 키(usage:read 스코프 없음) — 재로그인으로 새 키를 받으면 해결.
     console.error(
-      `${style.red("✗")} 이 API 키에는 usage:read 권한이 없습니다.\n` +
-        `  ${style.dim("pleum login 을 다시 실행해 새 키를 발급받으세요 (최신 키에는 기본 포함).")}`,
+      `${style.red("✗")} ${t("This API key doesn't have usage:read permission.")}\n` +
+        `  ${style.dim(t("Run pleum login again to get a new key (recent keys include it by default)."))}`,
     );
     process.exit(1);
   }
   if (!res.ok) {
     const body = await res.text().catch(() => "");
-    throw new Error(`사용량 조회 실패 (${res.status})${body ? `: ${body.slice(0, 200)}` : ""}`);
+    throw new Error(`${t("Failed to fetch usage ({status})", { status: res.status })}${body ? `: ${body.slice(0, 200)}` : ""}`);
   }
   console.log(renderUsage(await res.json()));
 }