pleumrouter 0.5.27 → 0.5.29

package/README.md

@@ -41,8 +41,8 @@ SSH/CI에서는 `pleum login --device`를 쓰세요.
 | `pleum models [query] [--json]` | 모델 목록(공개) — provider·컨텍스트·가격(₩/1M) 컬럼, `--json`은 스크립트용 |
 | `pleum models <id> --info` | 모델 상세 — 가격·컨텍스트·provider별 지연/처리량/업타임·주간 사용량·형제 모델 |
 | `pleum top [--period daily\|weekly\|monthly]` | 라우터 전체 모델 리더보드 + 제공자 점유율(공개 통계) |
-| `pleum balance` | 크레딧 잔액 조회 |
-| `pleum usage [--by model\|provider\|api_key\|day] [--days N]` | 내 지출 리포트(막대 차트) — OAuth 로그인 세션 필요 |
+| `pleum balance [--switch]` | 크레딧 잔액 조회 · 워크스페이스(개인/팀) 전환 |
+| `pleum usage [--by model\|provider\|api_key\|day\|tag\|user] [--days N]` | 내 지출 리포트(막대 차트) — OAuth 로그인 세션 필요 |
 | `pleum health` | 게이트웨이 연결·DB·Redis·환율·로그인 상태 점검(셀프호스트 진단용) |
 | `pleum lang [code]` | 표시 언어 조회/변경 — `en`(기본)·`ko`·`ja`·`zh`·`es`. 인자 없이 TTY면 화살표로 선택, `PLEUM_LANG` 환경변수로도 덮어쓰기 가능 |
 | `pleum completion <zsh\|bash>` | 셸 자동완성 스크립트 출력 |
@@ -74,9 +74,9 @@ SSH/CI에서는 `pleum login --device`를 쓰세요.
 
 ## 자동 실행 지원 도구
 
-`claude` · `codex` · `aider` · `goose` · `openhands` · `opencode` · `omp` · `hermes` · `qwen` · `copilot` · `gemini` · `agy` · `pi` · `crush` —
+`claude` · `codex` · `aider` · `goose` · `openhands` · `opencode` · `omp` · `hermes` · `qwen` · `copilot` · `gemini` · `agy` · `pi` · `crush` · `minimax` · `mimo` · `openclaw` · `plandex` · `interpreter` —
 env 또는 격리 홈(`CODEX_HOME` / `PI_CODING_AGENT_DIR` / `CRUSH_GLOBAL_CONFIG`)만 세팅하고 바로 실행한다.
-별칭: `antigravity`→`agy`, `picode`→`pi`, `ohmypi`→`omp`.
+별칭: `antigravity`→`agy`, `picode`→`pi`, `ohmypi`/`oh-my-pi`→`omp`, `qwencode`/`qwen-code`→`qwen`, `minimax-code`/`mcode`→`minimax`, `mimocode`/`mimo-code`→`mimo`, `open-interpreter`→`interpreter`.
 
 `agy`만 사용자 `~/.gemini/antigravity-cli/settings.json`에 `modelProvider=gemini`를 병합한다(제품이 이 파일 없이 키를 무시함). Kiro는 공식 BYOK가 없어 지원하지 않는다.
 

package/bin/pleum.mjs

@@ -34,8 +34,8 @@ function buildHelp() {
     ["pleum models [query] [--json]", t("Model list (price, context included)")],
     ["pleum models <id> --info", t("Model detail (price, perf, per-provider uptime)")],
     ["pleum top [--period weekly]", t("Model leaderboard · provider share (daily|weekly|monthly)")],
-    ["pleum balance", t("Check your credit balance")],
-    ["pleum usage [--by model] [--days 30]", t("Your spend report (model|provider|api_key|day)")],
+    ["pleum balance [--switch]", t("Check your credit balance")],
+    ["pleum usage [--by model] [--days 30]", t("Your spend report (model|provider|api_key|day|tag|user)")],
     ["pleum health", t("Check gateway connectivity and login status")],
     ["pleum lang [code]", t("Show/change display language (en|ko|ja|zh|es)")],
     ["pleum completion <zsh|bash>", t("Print a shell completion script")],

package/package.json

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

package/src/balance.mjs

@@ -14,7 +14,7 @@ export async function fetchCreditSummary() {
   const res = await authFetch("/credits");
   if (!res.ok) {
     const body = await res.text().catch(() => "");
-    throw new Error(`잔액 조회 실패 (HTTP ${res.status})${body ? `: ${body}` : ""}`);
+    throw new Error(t("Failed to fetch balance ({status})", { status: res.status }) + (body ? `: ${body}` : ""));
   }
   const personal = await res.json();
 
@@ -26,24 +26,26 @@ export async function fetchCreditSummary() {
     }
   } catch {}
 
-  const teamWallets = [];
+  let teamWallets = [];
   if (Array.isArray(orgs) && orgs.length > 0) {
-    await Promise.all(
+    const results = await Promise.all(
       orgs.map(async (org) => {
         try {
           const wRes = await authFetch(`/orgs/${org.id}/wallet`);
           if (wRes.ok) {
             const wallet = await wRes.json();
-            teamWallets.push({
+            return {
               id: String(org.id),
               name: org.name,
               role: org.role,
               balance_krw: wallet.available_krw ?? wallet.balance_krw ?? 0,
-            });
+            };
           }
         } catch {}
+        return null;
       })
     );
+    teamWallets = results.filter(Boolean);
   }
 
   return {
@@ -92,7 +94,13 @@ export function buildCreditOptions({ personal, teams = [], activeContext = { typ
 }
 
 export async function switchCreditWorkspace({ summary, selectFn = select } = {}) {
-  const data = summary || (await fetchCreditSummary());
+  let data;
+  try {
+    data = summary || (await fetchCreditSummary());
+  } catch (e) {
+    console.error(`✗ ${e.message}`);
+    return getActiveContext();
+  }
   const active = getActiveContext();
   const options = buildCreditOptions({
     personal: data.personal,
@@ -141,13 +149,14 @@ export async function switchCreditWorkspace({ summary, selectFn = select } = {})
   return newContext;
 }
 
-export async function balance({ interactive = false, switchOnly = false } = {}) {
+export async function balance({ interactive = false, switchOnly = false, exitOnError = true } = {}) {
   let summary;
   try {
     summary = await fetchCreditSummary();
   } catch (e) {
-    console.error(e.message);
-    process.exit(1);
+    console.error(`✗ ${e.message}`);
+    if (exitOnError) process.exit(1);
+    return;
   }
 
   if (switchOnly) {

package/src/completion.mjs

@@ -14,9 +14,14 @@ _pleum() {
     COMPREPLY=( $(compgen -W "${COMMANDS}" -- "$cur") ); return
   fi
   case "$prev" in
-    launch)     COMPREPLY=( $(compgen -W "${TOOLS}" -- "$cur") );;
-    wire|unwire) COMPREPLY=( $(compgen -W "claude codex" -- "$cur") );;
-    run)        COMPREPLY=( $(compgen -W "$(pleum models 2>/dev/null | awk 'NR>1{print $1}')" -- "$cur") );;
+    launch)     COMPREPLY=( $(compgen -W "${TOOLS} --model" -- "$cur") );;
+    wire|unwire) COMPREPLY=( $(compgen -W "claude codex --revoke-key" -- "$cur") );;
+    run|models) COMPREPLY=( $(compgen -W "$(pleum models 2>/dev/null | awk 'NR>1{print $1}') --json --info" -- "$cur") );;
+    balance)    COMPREPLY=( $(compgen -W "--switch" -- "$cur") );;
+    usage)      COMPREPLY=( $(compgen -W "--by --days" -- "$cur") );;
+    --by)       COMPREPLY=( $(compgen -W "model provider api_key day tag user" -- "$cur") );;
+    lang)       COMPREPLY=( $(compgen -W "en ko ja zh es" -- "$cur") );;
+    top)        COMPREPLY=( $(compgen -W "daily weekly monthly --period" -- "$cur") );;
     completion) COMPREPLY=( $(compgen -W "zsh bash" -- "$cur") );;
   esac
 }
@@ -31,9 +36,13 @@ _pleum() {
     compadd ${COMMANDS}; return
   fi
   case \${words[2]} in
-    launch)     compadd ${TOOLS};;
-    wire|unwire) compadd claude codex;;
-    run)        compadd \${(f)"$(pleum models 2>/dev/null | awk 'NR>1{print \$1}')"};;
+    launch)     compadd ${TOOLS} --model;;
+    wire|unwire) compadd claude codex --revoke-key;;
+    run|models) compadd \${(f)"$(pleum models 2>/dev/null | awk 'NR>1{print \$1}')"} --json --info;;
+    balance)    compadd --switch;;
+    usage)      compadd --by --days model provider api_key day tag user;;
+    lang)       compadd en ko ja zh es;;
+    top)        compadd daily weekly monthly --period;;
     completion) compadd zsh bash;;
   esac
 }

package/src/health.mjs

@@ -37,7 +37,7 @@ export function renderHealth({ root, health, error, ms, keyPrefix }, styler = st
   return lines.join("\n");
 }
 
-export async function health() {
+export async function health({ exitOnError = true } = {}) {
   const cfg = readConfig();
   const keyPrefix = isLoggedIn(cfg)
     ? "oauth"
@@ -56,5 +56,5 @@ export async function health() {
   }
   const ms = Date.now() - t0;
   console.log(renderHealth({ root: ROOT, health: data, error, ms, keyPrefix }));
-  if (error) process.exit(1);
+  if (error && exitOnError) process.exit(1);
 }

package/src/interactive.mjs

@@ -155,7 +155,8 @@ export async function select(items, {
         if (key.type === "ctrlc" || key.type === "escape") return finish(null);
         if (key.type === "enter") {
           const pool = matches(items, query);
-          return finish(pool[cursor] ?? null);
+          const safeCursor = Math.max(0, Math.min(cursor, pool.length - 1));
+          return finish(pool[safeCursor] ?? null);
         }
         if (key.type === "up") cursor = Math.max(0, cursor - 1);
         else if (key.type === "down") cursor = Math.min(limit - 1, cursor + 1);

package/src/locales/es.mjs

@@ -203,7 +203,7 @@ export const ES = {
   "Usage: pleum models <model-id> --info": "Uso: pleum models <model-id> --info",
   "Usage: pleum run <model> [\"prompt\"]\nModel list: pleum models": "Uso: pleum run <model> [\"prompt\"]\nLista de modelos: pleum models",
   "Use default (clear)": "Usar predeterminado (borrar)",
-  "Your spend report (model|provider|api_key|day)": "Tu informe de gasto (model|provider|api_key|day)",
+  "Your spend report (model|provider|api_key|day|tag|user)": "Tu informe de gasto (model|provider|api_key|day|tag|user)",
   "by day": "por día",
   "by key": "por clave",
   "by model": "por modelo",
@@ -274,5 +274,10 @@ export const ES = {
   "Failed to update credit context": "Error al actualizar el contexto de crédito",
   "You are not a member of any team. Using personal credit.": "No eres miembro de ningún equipo. Usando crédito personal.",
   "Run `pleum balance --switch` to switch credit workspace.": "Ejecuta `pleum balance --switch` para cambiar de espacio de crédito.",
+  "Example: pleum launch claude --model claude-sonnet-5": "Ejemplo: pleum launch claude --model claude-sonnet-5",
+  "supported (reasoning_effort: minimal|none|low|medium|high|xhigh|max)": "compatible (reasoning_effort: minimal|none|low|medium|high|xhigh|max)",
+  "by tag": "por etiqueta",
+  "by user": "por usuario",
+  "Failed to fetch balance ({status})": "Error al obtener el saldo ({status})",
 };
 

package/src/locales/ja.mjs

@@ -203,7 +203,7 @@ export const JA = {
   "Usage: pleum unwire [claude|codex] [--revoke-key]\n": "使い方: pleum unwire [claude|codex] [--revoke-key]\n",
   "Usage: pleum wire [claude|codex]\n": "使い方: pleum wire [claude|codex]\n",
   "Use default (clear)": "デフォルトを使用(解除)",
-  "Your spend report (model|provider|api_key|day)": "支出レポート (model|provider|api_key|day)",
+  "Your spend report (model|provider|api_key|day|tag|user)": "支出レポート (model|provider|api_key|day|tag|user)",
   "by day": "日別",
   "by key": "キー別",
   "by model": "モデル別",
@@ -274,5 +274,10 @@ export const JA = {
   "Failed to update credit context": "クレジットコンテキストの更新に失敗しました",
   "You are not a member of any team. Using personal credit.": "所属しているチームがありません。個人クレジットを使用します。",
   "Run `pleum balance --switch` to switch credit workspace.": "`pleum balance --switch` でクレジットワークスペースを変更できます。",
+  "Example: pleum launch claude --model claude-sonnet-5": "例: pleum launch claude --model claude-sonnet-5",
+  "supported (reasoning_effort: minimal|none|low|medium|high|xhigh|max)": "対応 (reasoning_effort: minimal|none|low|medium|high|xhigh|max)",
+  "by tag": "タグ別",
+  "by user": "ユーザー別",
+  "Failed to fetch balance ({status})": "残高の取得に失敗しました ({status})",
 };
 

package/src/locales/ko.mjs

@@ -263,7 +263,7 @@ export const KO = {
   "Model list (price, context included)": "모델 목록(가격·컨텍스트 포함)",
   "Model detail (price, perf, per-provider uptime)": "모델 상세(가격·성능·provider별 uptime)",
   "Model leaderboard · provider share (daily|weekly|monthly)": "모델 리더보드·제공자 점유율(daily|weekly|monthly)",
-  "Your spend report (model|provider|api_key|day)": "내 지출 리포트(model|provider|api_key|day)",
+  "Your spend report (model|provider|api_key|day|tag|user)": "내 지출 리포트(model|provider|api_key|day|tag|user)",
   "Check gateway connectivity and login status": "게이트웨이 연결·로그인 상태 점검",
   "Show/change display language (en|ko|ja|zh|es)": "표시 언어 조회/변경 (en|ko|ja|zh|es)",
   "Print a shell completion script": "셸 자동완성 스크립트 출력",
@@ -337,5 +337,10 @@ export const KO = {
   "Failed to update credit context": "크레딧 컨텍스트 변경 실패",
   "You are not a member of any team. Using personal credit.": "소속된 팀이 없습니다. 개인 크레딧을 사용합니다.",
   "Run `pleum balance --switch` to switch credit workspace.": "`pleum balance --switch` 명령으로 크레딧 워크스페이스를 변경할 수 있습니다.",
+  "Example: pleum launch claude --model claude-sonnet-5": "예시: pleum launch claude --model claude-sonnet-5",
+  "supported (reasoning_effort: minimal|none|low|medium|high|xhigh|max)": "지원됨 (reasoning_effort: minimal|none|low|medium|high|xhigh|max)",
+  "by tag": "태그별",
+  "by user": "사용자별",
+  "Failed to fetch balance ({status})": "잔액 조회 실패 ({status})",
 };
 

package/src/locales/zh.mjs

@@ -203,7 +203,7 @@ export const ZH = {
   "Usage: pleum models <model-id> --info": "用法：pleum models <model-id> --info",
   "Usage: pleum run <model> [\"prompt\"]\nModel list: pleum models": "用法：pleum run <model> [\"prompt\"]\n模型列表：pleum models",
   "Use default (clear)": "使用默认值（清除）",
-  "Your spend report (model|provider|api_key|day)": "你的花费报告（model|provider|api_key|day）",
+  "Your spend report (model|provider|api_key|day|tag|user)": "你的花费报告（model|provider|api_key|day|tag|user）",
   "by day": "按天",
   "by key": "按密钥",
   "by model": "按模型",
@@ -274,5 +274,10 @@ export const ZH = {
   "Failed to update credit context": "更新额度上下文失败",
   "You are not a member of any team. Using personal credit.": "您不属于任何团队。使用个人额度。",
   "Run `pleum balance --switch` to switch credit workspace.": "运行 `pleum balance --switch` 可切换额度工作区。",
+  "Example: pleum launch claude --model claude-sonnet-5": "示例：pleum launch claude --model claude-sonnet-5",
+  "supported (reasoning_effort: minimal|none|low|medium|high|xhigh|max)": "支持 (reasoning_effort: minimal|none|low|medium|high|xhigh|max)",
+  "by tag": "按标签",
+  "by user": "按用户",
+  "Failed to fetch balance ({status})": "获取余额失败 ({status})",
 };
 

package/src/menu.mjs

@@ -374,19 +374,39 @@ export async function mainMenu() {
         return true;
       }
       case "models":
-        await listModels([]);
+        try {
+          await listModels([]);
+        } catch (e) {
+          console.error(`✗ ${sanitizeTerminalText(e.message)}`);
+        }
         continue;
       case "top":
-        await top([]);
+        try {
+          await top([]);
+        } catch (e) {
+          console.error(`✗ ${sanitizeTerminalText(e.message)}`);
+        }
         continue;
       case "usage":
-        await usage([]);
+        try {
+          await usage([]);
+        } catch (e) {
+          console.error(`✗ ${sanitizeTerminalText(e.message)}`);
+        }
         continue;
       case "balance":
-        await balance({ interactive: true });
+        try {
+          await balance({ interactive: true, exitOnError: false });
+        } catch (e) {
+          console.error(`✗ ${sanitizeTerminalText(e.message)}`);
+        }
         continue;
       case "health":
-        await health();
+        try {
+          await health({ exitOnError: false });
+        } catch (e) {
+          console.error(`✗ ${sanitizeTerminalText(e.message)}`);
+        }
         continue;
       case "settings": {
         const r = await runSettings();

package/src/models.mjs

@@ -45,7 +45,7 @@ export function fmtPrice(model) {
     if (v == null) return "—";
     const n = Number(v) * 1_000_000;
     if (!Number.isFinite(n)) return "—";
-    return sym === "₩" ? `${Math.round(n).toLocaleString("en-US")} 크레딧` : `$${n.toFixed(2)}`;
+    return sym === "₩" ? `${Math.round(n).toLocaleString("en-US")} ${t("credits")}` : `$${n.toFixed(2)}`;
   };
   const kr = model.pricing_krw || {};
   if (kr.prompt != null || kr.completion != null) return [per1m(kr.prompt, "₩"), per1m(kr.completion, "₩")];

package/src/run.mjs

@@ -165,7 +165,7 @@ export function buildContent(text, { attachments = [], lstat = lstatSync, read =
 // 응답 후 한 줄 통계(순수 함수 — 테스트 대상). verbose일 때만 토큰/속도 표시.
 export function formatStats({ cost, usage, ms, tokPerSec, verbose }) {
   const bits = [];
-  if (cost != null && cost !== "") bits.push(`${fmtCost(cost)} 크레딧`);
+  if (cost != null && cost !== "") bits.push(`${fmtCost(cost)} ${t("credits")}`);
   if (verbose && usage) {
     bits.push(`↑${sanitizeTerminalText(usage.prompt_tokens ?? "?")} ↓${sanitizeTerminalText(usage.completion_tokens ?? "?")} tok`);
     if (tokPerSec) bits.push(`${tokPerSec.toFixed(1)} tok/s`);

package/src/usage.mjs

@@ -5,7 +5,7 @@ import { authFetch } from "./config.mjs";
 import { style, padDisplay, barChart, divider } from "./ansi.mjs";
 import { t } from "./i18n.mjs";
 
-const GROUPS = ["model", "provider", "api_key", "day"];
+const GROUPS = ["model", "provider", "api_key", "day", "tag", "user"];
 
 export function parseUsageArgs(rest = []) {
   let by = "model";
@@ -21,12 +21,19 @@ export function parseUsageArgs(rest = []) {
 
 // 원장 눈금 0.1 — Math.round로 자르면 소액 사용이 0으로 보인다.
 const fmtKrw = (n) =>
-  `${Number(n).toLocaleString("en-US", { minimumFractionDigits: 1, maximumFractionDigits: 1 })} 크레딧`;
+  `${Number(n).toLocaleString("en-US", { minimumFractionDigits: 1, maximumFractionDigits: 1 })} ${t("credits")}`;
 
 // report 응답 → 표시 문자열(순수 함수 — fixture 테스트 대상).
 export function renderUsage(data, styler = style) {
   const lines = [];
-  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;
+  const byLabel = {
+    model: t("by model"),
+    provider: t("by provider"),
+    api_key: t("by key"),
+    day: t("by day"),
+    tag: t("by tag"),
+    user: t("by user"),
+  }[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 || [];

package/src/wire.mjs

@@ -15,6 +15,8 @@ const CLAUDE_ENV_KEYS = [
   "ANTHROPIC_AUTH_TOKEN",
   "ANTHROPIC_API_KEY",
   "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY",
+  "API_TIMEOUT_MS",
+  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
 ];
 
 export function wirePaths(home = homedir()) {
@@ -87,6 +89,8 @@ export function wireClaudeSettings(existingJson, { root, key }) {
     ANTHROPIC_AUTH_TOKEN: key,
     ANTHROPIC_API_KEY: key,
     CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY: "1",
+    API_TIMEOUT_MS: "3000000",
+    CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: "1",
   };
   return `${JSON.stringify(obj, null, 2)}\n`;
 }