pleumrouter 0.5.0 → 0.5.3

package/README.md

@@ -18,11 +18,11 @@ bun install -g pleumrouter                          # bun
 
 ```bash
 npx pleumrouter login                          # 브라우저 로그인 + 키 자동 저장
-npx pleumrouter launch claude --model claude-sonnet-4
-npx pleumrouter launch codex  --model gpt-4.1
-npx pleumrouter run gpt-4.1                     # 터미널 채팅
-npx pleumrouter run gpt-4.1 "한 줄 요약: ..."   # 1회 실행(스크립트용)
-cat error.log | npx pleumrouter run gpt-4.1 "원인은?"   # 파이프
+npx pleumrouter launch claude --model claude-sonnet-5
+npx pleumrouter launch codex  --model gpt-5.3-codex
+npx pleumrouter run gpt-5.4-mini                     # 터미널 채팅
+npx pleumrouter run gpt-5.4-mini "한 줄 요약: ..."   # 1회 실행(스크립트용)
+cat error.log | npx pleumrouter run gpt-5.4-mini "원인은?"   # 파이프
 ```
 
 ## 명령
@@ -33,7 +33,7 @@ cat error.log | npx pleumrouter run gpt-4.1 "원인은?"   # 파이프
 | `pleum login [--device]` | 브라우저로 로그인 → CLI가 API 키를 자동 발급·저장(`~/.pleum/config.json`). `--device`는 SSH·CI |
 | `pleum logout` | 저장된 API 키만 삭제(언어·기본 모델 등 나머지 설정은 유지) |
 | `pleum launch [tool] [--model id] [-- args]` | 에이전트 실행. `--` 뒤 인자는 도구로 그대로 전달. 도구 생략 시 지원 목록·설치 여부 표시 |
-| `pleum run [model] ["프롬프트"]` | 채팅 — 대화형 REPL, 1회 실행, stdin 파이프. 모델 생략 시 화살표로 선택 |
+| `pleum run [model] ["프롬프트"]` | 채팅 — 대화형 REPL, 1회 실행, stdin 파이프. 모델 생략 시 화살표로 선택. `--skip-cache`(이번 요청 응답 캐시 스킵), `--tag a,b`(리포팅 태그, ≤10) |
 | `pleum models [query] [--json]` | 모델 목록(공개) — provider·컨텍스트·가격(₩/1M) 컬럼, `--json`은 스크립트용 |
 | `pleum models <id> --info` | 모델 상세 — 가격·컨텍스트·provider별 지연/처리량/업타임·주간 사용량·형제 모델 |
 | `pleum top [--period daily\|weekly\|monthly]` | 라우터 전체 모델 리더보드 + 제공자 점유율(공개 통계) |
@@ -61,7 +61,7 @@ cat error.log | npx pleumrouter run gpt-4.1 "원인은?"   # 파이프
 | `/exit`, `/quit` | 종료 |
 
 - 응답은 **마크다운 스트리밍 렌더**(굵게·코드블록 하이라이트·리스트) — 파이프로 빼면 자동으로 원문 그대로
-- 응답 후 비용이 PLM으로 표시(스트리밍 마지막 청크 기준)
+- 응답 후 비용이 현지 통화(한국 ₩)로 표시(스트리밍 마지막 청크 기준)
 - **Ctrl+C**: 생성 중엔 1회로 중단(대화 유지), 대기 중엔 2초 내 2회로 종료
 - 여러 줄 입력: `"""` 한 줄 → 본문 → `"""` 한 줄
 - 이미지: 메시지에 이미지 파일 경로를 그대로 포함 (예: `이 그림 설명해줘 ./shot.png`)

package/bin/pleum.mjs

@@ -43,12 +43,12 @@ function buildHelp() {
   const body = rows.map(([cmd, desc]) => `  ${cmd.padEnd(width)}${desc}`).join("\n");
 
   const examples = [
-    ["pleum launch claude --model claude-sonnet-4", null],
-    ["pleum launch codex --model gpt-4.1 -- --full-auto", null],
-    ["pleum run gpt-4.1", t("interactive")],
-    [`pleum run gpt-4.1 "${t("Summarize in one line: ...")}"`, t("one-shot")],
-    [`cat error.log | pleum run gpt-4.1 "${t("what caused this?")}"`, t("pipe")],
-    ["pleum models deepseek/deepseek-chat --info", t("model detail")],
+    ["pleum launch claude --model claude-sonnet-5", null],
+    ["pleum launch codex --model gpt-5.3-codex -- --full-auto", null],
+    ["pleum run gpt-5.4-mini", t("interactive")],
+    [`pleum run gpt-5.4-mini "${t("Summarize in one line: ...")}"`, t("one-shot")],
+    [`cat error.log | pleum run gpt-5.4-mini "${t("what caused this?")}"`, t("pipe")],
+    ["pleum models deepseek/deepseek-v4-flash --info", t("model detail")],
     ["pleum usage --by day --days 7", t("last 7 days, by day")],
     ["pleum login --device", t("SSH/CI environment")],
   ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pleumrouter",
-  "version": "0.5.0",
+  "version": "0.5.3",
   "description": "Official PleumRouter terminal CLI — launch any coding agent against PleumRouter.",
   "type": "module",
   "bin": {

package/src/balance.mjs

@@ -1,6 +1,5 @@
-import { V1, requireKey } from "./config.mjs";
-import { style } from "./ansi.mjs";
-import { t } from "./i18n.mjs";
+import { V1 } from "./config.mjs";
+import { requireKey } from "./config.mjs";
 
 export async function balance() {
   const key = requireKey();
@@ -9,18 +8,11 @@ export async function balance() {
   });
   if (!res.ok) {
     const body = await res.text().catch(() => "");
-    console.error(`${t("Failed to check balance (HTTP {status})", { status: res.status })}${body ? `: ${body.slice(0, 200)}` : ""}`);
-    if (res.status === 401) {
-      console.error(style.dim(t("The server may not support API-key balance checks yet, or the key may have expired — try pleum login again.")));
-    }
+    console.error(`잔액 조회 실패 (HTTP ${res.status})${body ? `: ${body}` : ""}`);
     process.exit(1);
   }
   const data = await res.json();
   const plm = data.balance_krw;
-  const usd = data.balance_usd != null ? style.dim(` / $${data.balance_usd.toFixed(4)}`) : "";
-  console.log(`${t("Balance:")} ${style.bold(style.plum(`${plm.toLocaleString("ko-KR")} PLM`))}${usd}`);
-  const threshold = data.auto_charge_threshold_krw;
-  if (threshold != null && plm < threshold) {
-    console.log(style.yellow(`⚠ ${t("Balance is below the auto-charge threshold ({threshold} PLM).", { threshold: threshold.toLocaleString("ko-KR") })}`));
-  }
+  const usd = data.balance_usd != null ? ` / $${data.balance_usd.toFixed(4)}` : "";
+  console.log(`잔액: ₩${plm.toLocaleString("ko-KR")}${usd}`);
 }

package/src/launch.mjs

@@ -27,7 +27,7 @@ export function launchHelp() {
     const ok = onPath(m.bin) ? t("✓ installed") : `${t("✗ not installed —")} ${m.install}`;
     console.log(`  ${name.padEnd(11)} ${m.label.padEnd(13)} ${ok}`);
   }
-  console.log(`\n${t("Example: pleum launch claude --model claude-sonnet-4")}`);
+  console.log(`\n${t("Example: pleum launch claude --model claude-sonnet-5")}`);
 }
 
 // exit:false면 process.exit 대신 자식 종료 코드를 반환 — 런처 메뉴의 실행 후 복귀용.

package/src/locales/es.mjs

@@ -22,7 +22,7 @@ export const ES = {
   "GitHub's terminal coding agent": "Agente de codificación de terminal de GitHub",
   "Available: {list}": "Disponibles: {list}",
   "Balance": "Saldo",
-  "Balance is below the auto-charge threshold ({threshold} PLM).": "El saldo está por debajo del umbral de recarga automática ({threshold} PLM).",
+  "Balance is below the auto-charge threshold ({threshold} ₩).": "El saldo está por debajo del umbral de recarga automática ({threshold} ₩).",
   "Balance:": "Saldo:",
   "Block's local-first agent": "Agente local-first de Block",
   "Chat with a model": "Chatear con un modelo",

package/src/locales/ja.mjs

@@ -22,7 +22,7 @@ export const JA = {
   "GitHub's terminal coding agent": "GitHub のターミナルコーディングエージェント",
   "Available: {list}": "利用可能: {list}",
   "Balance": "残高",
-  "Balance is below the auto-charge threshold ({threshold} PLM).": "残高が自動チャージのしきい値 ({threshold} PLM) を下回っています。",
+  "Balance is below the auto-charge threshold ({threshold} ₩).": "残高が自動チャージのしきい値 ({threshold} ₩) を下回っています。",
   "Balance:": "残高:",
   "Block's local-first agent": "Block のローカルファーストエージェント",
   "Chat with a model": "モデルとチャット",

package/src/locales/ko.mjs

@@ -101,7 +101,7 @@ export const KO = {
   "The server may not support API-key balance checks yet, or the key may have expired — try pleum login again.":
     "서버가 아직 API 키 잔액 조회를 지원하지 않거나 키가 만료됐을 수 있습니다 — pleum login 재시도.",
   "Balance:": "잔액:",
-  "Balance is below the auto-charge threshold ({threshold} PLM).": "잔액이 자동충전 임계값({threshold} PLM) 아래입니다.",
+  "Balance is below the auto-charge threshold ({threshold} ₩).": "잔액이 자동충전 임계값({threshold} ₩) 아래입니다.",
 
   // health.mjs
   "Gateway connection failed: {error}": "게이트웨이 연결 실패: {error}",

package/src/locales/zh.mjs

@@ -22,7 +22,7 @@ export const ZH = {
   "GitHub's terminal coding agent": "GitHub 的终端编程代理",
   "Available: {list}": "可用：{list}",
   "Balance": "余额",
-  "Balance is below the auto-charge threshold ({threshold} PLM).": "余额低于自动充值阈值（{threshold} PLM）。",
+  "Balance is below the auto-charge threshold ({threshold} ₩).": "余额低于自动充值阈值（{threshold} ₩）。",
   "Balance:": "余额：",
   "Block's local-first agent": "Block 的本地优先代理",
   "Chat with a model": "与模型对话",

package/src/recipes.mjs

@@ -75,12 +75,12 @@ export const RECIPES = {
             npm: "@ai-sdk/openai-compatible",
             name: "PleumRouter",
             options: { baseURL: V1, apiKey: "{env:PLEUM_API_KEY}" },
-            models: { [model || "gpt-4.1"]: {} },
+            models: { [model || "gpt-5.4-mini"]: {} },
           },
         },
       }),
     }),
-    args: (m) => ["--model", `pleum/${m || "gpt-4.1"}`],
+    args: (m) => ["--model", `pleum/${m || "gpt-5.4-mini"}`],
   },
   omp: {
     label: "omp (Oh My Pi)",
@@ -107,7 +107,7 @@ export const RECIPES = {
     bin: "qwen",
     type: "env",
     install: "npm install -g @qwen-code/qwen-code@latest",
-    env: (key, model) => ({ OPENAI_BASE_URL: V1, OPENAI_API_KEY: key, OPENAI_MODEL: model || "gpt-4.1" }),
+    env: (key, model) => ({ OPENAI_BASE_URL: V1, OPENAI_API_KEY: key, OPENAI_MODEL: model || "gpt-5.4-mini" }),
     args: () => [],
   },
   copilot: {
@@ -120,7 +120,7 @@ export const RECIPES = {
       COPILOT_PROVIDER_BASE_URL: V1,
       COPILOT_PROVIDER_TYPE: "openai",
       COPILOT_PROVIDER_API_KEY: key,
-      COPILOT_MODEL: model || "gpt-4.1",
+      COPILOT_MODEL: model || "gpt-5.4-mini",
     }),
     args: () => [],
   },
@@ -129,7 +129,7 @@ export const RECIPES = {
 // Codex는 Chat Completions가 제거돼 Responses API(wire_api="responses")만 지원.
 // 사용자의 ~/.codex/config.toml을 건드리지 않도록 격리 CODEX_HOME에 이 파일을 쓴다.
 export function codexToml(model) {
-  const m = model || "gpt-4.1";
+  const m = model || "gpt-5.4-mini";
   return `# Generated by pleum CLI. Isolated CODEX_HOME — your ~/.codex is untouched.
 model = "${m}"
 model_provider = "pleum"
@@ -155,7 +155,7 @@ export const MANUAL = {
       "type": "openai-compat",
       "base_url": "${V1}",
       "api_key": "$PLEUM_API_KEY",
-      "models": [{ "id": "gpt-4.1", "name": "gpt-4.1" }]
+      "models": [{ "id": "gpt-5.4-mini", "name": "gpt-5.4-mini" }]
     }
   }
 }`,

package/src/run.mjs

@@ -10,15 +10,26 @@ import { t } from "./i18n.mjs";
 
 const IMG_EXT = /\.(png|jpe?g|gif|webp|bmp)$/i;
 
-// `pleum run [model] ["프롬프트"...] [--verbose]` 인자 파싱(순수 함수 — 테스트 대상).
+// `pleum run [model] ["프롬프트"...] [--verbose] [--skip-cache] [--tag a,b]`
+// 인자 파싱(순수 함수 — 테스트 대상).
 export function parseRunArgs(rest = []) {
   let verbose = false;
+  let skipCache = false;
+  let tags = [];
   const pos = [];
-  for (const a of rest) {
+  for (let i = 0; i < rest.length; i++) {
+    const a = rest[i];
     if (a === "--verbose" || a === "-v") verbose = true;
-    else pos.push(a);
+    else if (a === "--skip-cache") skipCache = true;
+    else if (a === "--tag" || a === "--tags") {
+      const v = rest[i + 1];
+      if (typeof v === "string") {
+        tags = v.split(",").map((s) => s.trim()).filter(Boolean).slice(0, 10);
+        i++;
+      }
+    } else pos.push(a);
   }
-  return { model: pos[0], prompt: pos.slice(1).join(" "), verbose };
+  return { model: pos[0], prompt: pos.slice(1).join(" "), verbose, skipCache, tags };
 }
 
 // 입력에서 존재하는 이미지 파일 경로를 찾아 멀티모달 content로 만든다(없으면 문자열 그대로).
@@ -59,7 +70,7 @@ function isAbort(e) {
 
 export async function run(rest) {
   const args = Array.isArray(rest) ? rest : rest == null ? [] : [rest];
-  const { verbose, prompt: inlinePrompt, model: argModel } = parseRunArgs(args);
+  const { verbose, prompt: inlinePrompt, model: argModel, skipCache, tags } = parseRunArgs(args);
   let model = argModel;
   const piped = await readStdin();
   const oneShot = Boolean(inlinePrompt || piped);
@@ -84,12 +95,12 @@ export async function run(rest) {
     const content = buildContent(prompt);
     if (Array.isArray(content)) {
       const n = content.filter((p) => p.type === "image_url").length;
-      // 프롬프트 내 로컬 이미지 경로를 자동 첨부·업로드하므로 조용히 올리지 않고 명시 고지한다(M8).
+      // 프롬프트 내 로컬 이미지 경로를 자동 첨부·업송하므로 조용히 올리지 않고 명시 고지한다(M8).
       console.error(`ℹ ${t("Attaching and uploading {n} local image(s) from the prompt.", { n })}`);
     }
     const messages = [{ role: "user", content }];
     try {
-      await streamChat(key, model, messages, { verbose, quiet: true });
+      await streamChat(key, model, messages, { verbose, quiet: true, tags, skipCache });
     } catch (e) {
       console.error(`${style.red("✗")} ${e.message}`);
       process.exit(1);
@@ -97,10 +108,10 @@ export async function run(rest) {
     process.exit(0);
   }
 
-  await repl(key, model, verbose);
+  await repl(key, model, verbose, { tags, skipCache });
 }
 
-async function repl(key, initialModel, initialVerbose) {
+async function repl(key, initialModel, initialVerbose, { tags = [], skipCache = false } = {}) {
   let model = initialModel;
   let system = "";
   let verbose = initialVerbose;
@@ -117,7 +128,7 @@ async function repl(key, initialModel, initialVerbose) {
     const ac = new AbortController();
     currentAbort = ac;
     try {
-      const reply = await streamChat(key, model, req, { verbose, signal: ac.signal });
+      const reply = await streamChat(key, model, req, { verbose, signal: ac.signal, tags, skipCache });
       if (reply) messages.push({ role: "assistant", content: reply });
       else messages.pop(); // 응답 없음(즉시 중단 등) — user 턴 되돌림
     } catch (e) {
@@ -333,15 +344,20 @@ async function handleSlash(text, ctx) {
 
 // SSE 스트리밍 채팅. fetchImpl 주입 가능(테스트용 — 네트워크 없이 SSE 파싱 검증).
 // 비용은 마지막 SSE 청크의 cost.krw — 스트리밍 응답엔 X-Cost-Krw 헤더가 없다(백엔드 계약).
-export async function streamChat(key, model, messages, { verbose = false, quiet = false, signal, fetchImpl = fetch } = {}) {
+export async function streamChat(key, model, messages, { verbose = false, quiet = false, signal, tags = [], skipCache = false, fetchImpl = fetch } = {}) {
   const t0 = Date.now();
   const sp = spinner(t("{model} thinking…", { model }));
   let res;
   try {
+    // 게이트웨이 패리티(0095): X-Pleum-Skip-Cache 헤더 + bounded tags 본문.
+    const headers = { "Content-Type": "application/json", Authorization: `Bearer ${key}` };
+    if (skipCache) headers["X-Pleum-Skip-Cache"] = "1";
+    const bodyObj = { model, messages, stream: true, stream_options: { include_usage: true } };
+    if (tags.length > 0) bodyObj.tags = tags.slice(0, 10);
     res = await fetchImpl(`${V1}/chat/completions`, {
       method: "POST",
-      headers: { "Content-Type": "application/json", Authorization: `Bearer ${key}` },
-      body: JSON.stringify({ model, messages, stream: true, stream_options: { include_usage: true } }),
+      headers,
+      body: JSON.stringify(bodyObj),
       signal,
     });
   } catch (e) {