pleumrouter 0.2.2 → 0.3.1

package/src/markdown.mjs

@@ -0,0 +1,91 @@
+// 스트리밍 마크다운 렌더러 — 라인 플로우(풀스크린 아님).
+// 전략: \n이 도착해 완결된 줄은 스타일 입혀 확정 출력(재렌더 없음), 아직 안 끝난
+// 마지막 줄만 매 push마다 지우고 다시 그린다. 비TTY(파이프)는 완전 패스스루.
+
+import { style, displayWidth, terminalWidth } from "./ansi.mjs";
+
+// ```lang 펜스 감지(순수 함수). 열기/닫기 구분은 호출자의 inFence 상태가 한다.
+export function detectFence(line) {
+  const m = /^\s*```(\S*)\s*$/.exec(line);
+  return m ? { lang: m[1] } : null;
+}
+
+// 인라인 마크다운: `code` → cyan, **bold**, *italic*. 코드 조각 먼저 치환해
+// 코드 안의 별표가 bold로 오인되는 흔한 케이스를 줄인다.
+export function renderInline(text, styler = style) {
+  return text
+    .replace(/`([^`]+)`/g, (_, c) => styler.cyan(c))
+    .replace(/\*\*([^*]+)\*\*/g, (_, c) => styler.bold(c))
+    .replace(/(^|[^*])\*([^*\s][^*]*)\*(?!\*)/g, (_, pre, c) => pre + styler.italic(c));
+}
+
+// 완결된 한 줄 렌더(순수 함수). state.inFence는 이 줄 "이전"의 펜스 상태.
+export function renderLine(line, state = { inFence: false }, styler = style) {
+  const fence = detectFence(line);
+  if (fence) {
+    return state.inFence ? styler.gray("└─") : styler.gray("┌─ ") + styler.dim(fence.lang || "code");
+  }
+  if (state.inFence) return styler.gray("│ ") + line; // 펜스 안은 마크다운 해석 안 함
+  const h = /^(#{1,6})\s+(.*)$/.exec(line);
+  if (h) return styler.bold(styler.plum(h[2]));
+  const q = /^\s*>\s?(.*)$/.exec(line);
+  if (q) return styler.gray("┃ ") + styler.dim(renderInline(q[1], styler));
+  const li = /^(\s*)([-*+]|\d+\.)\s+(.*)$/.exec(line);
+  if (li) {
+    const marker = /^[-*+]$/.test(li[2]) ? "•" : li[2];
+    return `${li[1]}${styler.plum(marker)} ${renderInline(li[3], styler)}`;
+  }
+  return renderInline(line, styler);
+}
+
+// 스트리밍 렌더러 팩토리. write/styler/interactive 주입 가능(테스트용).
+export function createMarkdownStream({
+  write = (s) => process.stdout.write(s),
+  styler = style,
+  interactive = process.stdout.isTTY,
+  prefix = "",
+} = {}) {
+  let buf = "";
+  let inFence = false;
+  let firstLine = true; // prefix는 첫 줄에만
+  let previewRows = 0; // 직전 미완성 줄 렌더가 점유한 시각적 행 수(soft-wrap 포함)
+
+  const rowsFor = (s) => Math.max(1, Math.ceil(displayWidth(s) / Math.max(terminalWidth(), 1)));
+
+  const erasePreview = () => {
+    if (!previewRows) return;
+    write("\r" + (previewRows > 1 ? `\x1b[${previewRows - 1}A` : "") + "\x1b[0J");
+    previewRows = 0;
+  };
+
+  const commit = (line) => {
+    const rendered = (firstLine ? prefix : "") + renderLine(line, { inFence }, styler);
+    if (detectFence(line)) inFence = !inFence;
+    write(rendered + "\n");
+    firstLine = false;
+  };
+
+  return {
+    push(delta) {
+      if (!interactive) return void write(delta);
+      buf += delta;
+      const lines = buf.split("\n");
+      buf = lines.pop() ?? "";
+      if (lines.length || buf) erasePreview();
+      for (const line of lines) commit(line);
+      if (buf) {
+        const rendered = (firstLine ? prefix : "") + renderLine(buf, { inFence }, styler);
+        write(rendered);
+        previewRows = rowsFor(rendered);
+      }
+    },
+    finish() {
+      if (!interactive) return void write("\n"); // 기존 파이프 동작 유지(항상 개행 종결)
+      erasePreview();
+      if (buf) {
+        commit(buf);
+        buf = "";
+      }
+    },
+  };
+}

package/src/menu.mjs

@@ -0,0 +1,360 @@
+// 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으로 끝 행을 얻어 좌표 매핑
+
+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 { readConfig, writeConfig } from "./config.mjs";
+import { RECIPES } from "./recipes.mjs";
+import { onPath, launch } from "./launch.mjs";
+import { fetchModels, matchModels, listModels } from "./models.mjs";
+import { run } from "./run.mjs";
+import { login } from "./login.mjs";
+import { top } from "./top.mjs";
+import { usage } from "./usage.mjs";
+import { balance } from "./balance.mjs";
+import { health } from "./health.mjs";
+
+const TOOL_DESC = {
+  claude: "Anthropic 코딩 에이전트 — 서브에이전트 지원",
+  codex: "OpenAI 코딩 에이전트",
+  aider: "터미널 페어 프로그래밍",
+  goose: "Block의 로컬 우선 에이전트",
+  openhands: "자율 개발 에이전트",
+};
+
+const autoInstallable = (r) => !/^https?:/.test(r.install); // URL이면 수동 설치 안내만
+
+// 메뉴 항목 빌드(순수 함수 — 테스트 대상). tool이 있는 항목만 →(모델 설정) 가능.
+export function buildItems({ loggedIn, installed, savedModels = {}, expanded = false }) {
+  const items = [];
+  if (!loggedIn) items.push({ id: "login", title: "로그인", desc: "브라우저로 로그인하고 API 키를 저장합니다" });
+  items.push({
+    id: "chat",
+    tool: "chat",
+    title: "모델과 채팅",
+    desc: `대화형 채팅을 시작합니다${savedModels.chat ? ` · 모델: ${savedModels.chat}` : ""}`,
+  });
+  const tools = expanded ? Object.keys(RECIPES) : ["claude", "codex"];
+  for (const t of tools) {
+    const r = RECIPES[t];
+    items.push({
+      id: `launch:${t}`,
+      tool: t,
+      title: `${r.label} 실행${installed[t] ? "" : autoInstallable(r) ? "  (설치)" : "  (미설치)"}`,
+      desc: installed[t]
+        ? `${TOOL_DESC[t]}${savedModels[t] ? ` · 모델: ${savedModels[t]}` : ""}`
+        : autoInstallable(r)
+          ? `Enter로 바로 설치 — ${r.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: "다른 에이전트 · 모델 목록 · 잔액 · 리더보드" });
+  }
+  return items;
+}
+
+// 항목별 기본 모델 저장(launch_models). 로그인 전에도 동작 — /v1/models는 공개.
+function saveModel(tool, id) {
+  const cfg = readConfig() ?? {};
+  cfg.launch_models = { ...cfg.launch_models, [tool]: id };
+  writeConfig(cfg);
+}
+
+// 마지막 메뉴 선택 저장 — 다음 실행 시 커서 복원(ollama last_selection과 동일).
+function saveLastSelection(id) {
+  const cfg = readConfig() ?? {};
+  cfg.last_selection = id;
+  writeConfig(cfg);
+}
+
+async function pickModelFor(item) {
+  let models;
+  try {
+    models = await fetchModels();
+  } catch (e) {
+    console.log(`${style.red("✗")} 모델 목록 조회 실패: ${e.message}`);
+    return undefined;
+  }
+  const m = await select(models, {
+    message: `${item.title.replace(/\s+\((설치|미설치)\)/, "")} — 모델 선택`,
+    formatItem: (x) => `${x.id}${x.display_name ? `  ${style.dim(x.display_name)}` : ""}`,
+    matches: matchModels,
+    limit: 12,
+  });
+  return m?.id;
+}
+
+// 미설치 도구: ollama처럼 확인 후 그 자리에서 설치(stdio 상속). 성공 시 true.
+async function ensureInstalled(r) {
+  if (!autoInstallable(r)) {
+    console.log(`${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));
+  rl.close();
+  if (/^n/i.test(ans.trim())) {
+    console.log(`설치 취소 — 수동 설치: ${r.install}`);
+    return false;
+  }
+  console.log(style.dim(`$ ${r.install}`));
+  const code = await new Promise((res) => {
+    const c = spawn(r.install, { shell: true, stdio: "inherit" });
+    c.on("exit", (n) => res(n ?? 1));
+    c.on("error", () => res(1));
+  });
+  if (code !== 0) {
+    console.log(`${style.red("✗")} 설치 실패 (exit ${code})`);
+    return false;
+  }
+  console.log(`${style.green("✓")} ${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() {
+  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 lastRows = 0;
+  let lastLines = [];
+  let cprRow = 0;
+
+  const rowsFor = (s) => Math.max(1, Math.ceil(displayWidth(s) / Math.max(terminalWidth(), 1)));
+  const erase = () => {
+    if (!lastRows) return;
+    output.write("\r" + (lastRows > 1 ? `\x1b[${lastRows - 1}A` : "") + "\x1b[0J");
+    lastRows = 0;
+  };
+  const render = () => {
+    const lines = [
+      `${style.bold(style.plum("PleumRouter"))} ${style.dim(`pleum ${version}`)}`,
+      "",
+      ...items.flatMap((it, i) =>
+        i === cursor
+          ? [`${style.plum("▸")} ${style.bold(it.title)}`, `    ${style.dim(it.desc)}`]
+          : [`  ${it.title}`, `    ${style.dim(it.desc)}`],
+      ),
+      "",
+      style.dim("↑/↓·휠 이동 • enter·클릭 실행 • →·우클릭 모델 설정 • esc 종료"),
+    ];
+    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) => 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();
+    };
+    const resume = () => {
+      input.setRawMode(true);
+      input.resume();
+      output.write("\x1b[?25l");
+      setMouse(output, true);
+      input.on("data", onData);
+      render();
+    };
+    const finish = (value) => {
+      suspend();
+      input.pause();
+      resolve(value);
+    };
+    // 모델 셀렉터는 자체 raw-mode·마우스 관리 — 메뉴 입력을 내려놓고 넘긴다.
+    // 선택되면 ollama처럼 즉시 실행으로 이어가고, 취소면 메뉴 복귀.
+    const configure = async (it) => {
+      suspend();
+      const picked = await pickModelFor(it);
+      if (picked) {
+        input.pause();
+        resolve({ item: it, model: picked });
+        return;
+      }
+      resume();
+    };
+
+    const feed = keyFeeder();
+    const onData = async (chunk) => {
+      let dirty = false; // CPR만 온 턴에 재렌더하면 렌더→CPR 질의→응답 무한 루프
+      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 === "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);
+        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;
+          return void (await configure(it));
+        } else continue;
+        dirty = true;
+      }
+      if (dirty) render();
+    };
+
+    input.setEncoding("utf8");
+    input.setRawMode(true);
+    input.resume();
+    output.write("\x1b[?25l");
+    setMouse(output, true);
+    input.on("data", onData);
+    render();
+  });
+}
+
+// bare `pleum` 진입점. 비TTY면 false(호출자가 HELP 출력), 그 외 true.
+// ollama처럼 실행이 끝나면 메뉴로 복귀하는 루프(REPL 채팅·Esc 종료 제외).
+export async function mainMenu() {
+  for (;;) {
+    const picked = await menuSelect();
+    if (picked === undefined) return false; // 비TTY
+    if (picked === null) return true; // Esc — ollama처럼 조용히 종료
+
+    const { item, model } = picked;
+    if (item.id !== "login") saveLastSelection(item.id);
+    if (model && item.tool) saveModel(item.tool, model);
+    const saved = readConfig()?.launch_models ?? {};
+
+    switch (item.id) {
+      case "login":
+        await login();
+        continue; // 로그인 후 메뉴로 복귀
+      case "chat": {
+        const m = model ?? saved.chat;
+        await run(m ? [m] : []); // REPL 종료는 run 내부 process.exit — 메뉴 복귀 없음
+        return true;
+      }
+      case "models":
+        await listModels([]);
+        continue;
+      case "top":
+        await top([]);
+        continue;
+      case "usage":
+        await usage([]);
+        continue;
+      case "balance":
+        await balance();
+        continue;
+      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 });
+        console.log(); // 에이전트 출력과 다음 메뉴 사이 여백
+        continue; // ollama처럼 에이전트 종료 후 메뉴 복귀
+      }
+    }
+  }
+}

package/src/models.mjs

@@ -1,4 +1,5 @@
 import { V1 } from "./config.mjs";
+import { style, padDisplay, divider } from "./ansi.mjs";
 
 // GET /v1/models 는 공개(인증 불필요). 슬러그는 provider/model 형식.
 export async function fetchModels() {
@@ -8,6 +9,15 @@ export async function fetchModels() {
   return data.data ?? [];
 }
 
+// id/표시명 부분일치 필터 — run 피커·REPL /models·목록이 공유하는 단일 구현.
+export function matchModels(models, query) {
+  const q = (query || "").toLowerCase();
+  if (!q) return models;
+  return models.filter(
+    (m) => m.id.toLowerCase().includes(q) || (m.display_name || "").toLowerCase().includes(q),
+  );
+}
+
 // 컨텍스트 길이를 사람이 읽기 좋게: 128000→128K, 1000000→1M.
 export function fmtCtx(n) {
   if (!n) return "—";
@@ -32,7 +42,8 @@ export function fmtPrice(model) {
 }
 
 // 정렬된 컬럼 테이블 — 라우터의 강점(수백 모델·가격·컨텍스트)을 한눈에.
-export function formatTable(models) {
+// 패딩은 표시 폭 기준(padDisplay) — 색·전각 문자가 섞여도 컬럼이 맞는다.
+export function formatTable(models, styler = style) {
   const headers = ["MODEL", "PROVIDER", "MODAL", "CTX", "IN/1M", "OUT/1M"];
   const rows = models.map((m) => {
     const [pin, pout] = fmtPrice(m);
@@ -46,29 +57,40 @@ export function formatTable(models) {
     ];
   });
   const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
-  const fmt = (r) => r.map((c, i) => c.padEnd(widths[i])).join("  ").trimEnd();
-  return [fmt(headers), ...rows.map(fmt)].join("\n");
+  const fmtRow = (r, paint) =>
+    r.map((c, i) => paint(padDisplay(c, widths[i]), i)).join("  ").trimEnd();
+  const head = fmtRow(headers, (c) => styler.dim(c));
+  const body = rows.map((r) => fmtRow(r, (c, i) => (i === 0 ? styler.plum(c) : c)));
+  return [head, ...body].join("\n");
 }
 
-// `pleum models [query] [--json]` 인자 파싱.
+// `pleum models [query] [--json] [--info]` 인자 파싱.
 export function parseModelsArgs(rest = []) {
   let json = false;
+  let info = false;
   const pos = [];
   for (const a of rest) {
     if (a === "--json") json = true;
+    else if (a === "--info" || a === "-i") info = true;
     else pos.push(a);
   }
-  return { json, query: pos[0] };
+  return { json, info, query: pos[0] };
 }
 
 export async function listModels(rest) {
   // 하위호환: 문자열 하나가 와도 query로 처리.
-  const { json, query } = Array.isArray(rest) ? parseModelsArgs(rest) : { json: false, query: rest };
+  const { json, info, query } = Array.isArray(rest)
+    ? parseModelsArgs(rest)
+    : { json: false, info: false, query: rest };
+  if (info) {
+    if (!query) {
+      console.error("사용법: pleum models <model-id> --info");
+      process.exit(1);
+    }
+    return showModelInfo(query, { json });
+  }
   const models = await fetchModels();
-  const q = (query || "").toLowerCase();
-  const rows = models.filter(
-    (m) => !q || m.id.toLowerCase().includes(q) || (m.display_name || "").toLowerCase().includes(q),
-  );
+  const rows = matchModels(models, query);
   if (json) {
     console.log(JSON.stringify(rows, null, 2));
     return;
@@ -78,5 +100,74 @@ export async function listModels(rest) {
     return;
   }
   console.log(formatTable(rows));
-  console.log(`\n${rows.length} models · 가격=토큰 1M당(표시환율 기준, 실청구는 장중 환율로 소폭 상이)`);
+  console.log(style.dim(`\n${rows.length} models · 가격=토큰 1M당(표시환율 기준, 실청구는 장중 환율로 소폭 상이)`));
+}
+
+// ── 모델 상세(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})`);
+  return res.json();
+}
+
+const fmtNum = (n) => (n == null ? "—" : Number(n).toLocaleString("en-US"));
+
+// 상세 응답 → 표시 문자열(순수 함수 — fixture 테스트 대상).
+export function renderModelInfo(m, styler = style) {
+  const [pin, pout] = fmtPrice(m);
+  const lines = [];
+  lines.push(`${styler.bold(styler.plum(m.id))}${m.display_name ? `  ${styler.dim(m.display_name)}` : ""}`);
+  lines.push(divider(undefined, styler));
+  const facts = [
+    ["maker", m.maker || "—"],
+    ["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}% 포함)`)}`],
+  ];
+  if (m.supports_thinking) facts.push(["thinking", m.thinking_forced ? "강제(끌 수 없음)" : "지원"]);
+  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)`),
+    );
+  }
+
+  const provs = m.providers || [];
+  if (provs.length) {
+    lines.push("");
+    lines.push(styler.dim("PROVIDER      IN/1M       OUT/1M      CTX    LATENCY   TPS     UPTIME"));
+    for (const p of provs) {
+      const [i1m, o1m] = fmtPrice(p);
+      lines.push(
+        [
+          styler.plum(padDisplay(p.provider, 12)),
+          padDisplay(i1m, 10),
+          padDisplay(o1m, 10),
+          padDisplay(fmtCtx(p.context_window), 5),
+          padDisplay(p.latency_ms != null ? `${Math.round(p.latency_ms)}ms` : "—", 8),
+          padDisplay(p.throughput_tps != null ? `${Math.round(p.throughput_tps)}/s` : "—", 6),
+          p.uptime_percent != null ? `${p.uptime_percent}%` : "—",
+        ].join("  "),
+      );
+    }
+  }
+
+  const sibs = (m.siblings || []).map((s) => s.id);
+  if (sibs.length) {
+    lines.push("");
+    lines.push(`${styler.dim("같은 제공자:")} ${sibs.join(styler.dim(" · "))}`);
+  }
+  return lines.join("\n");
+}
+
+export async function showModelInfo(id, { json = false } = {}) {
+  const detail = await fetchModelDetail(id);
+  if (json) return void console.log(JSON.stringify(detail, null, 2));
+  console.log(renderModelInfo(detail));
 }