pleumrouter 0.5.2 → 0.5.3

package/README.md

@@ -33,7 +33,7 @@ cat error.log | npx pleumrouter run gpt-5.4-mini "원인은?"   # 파이프
 | `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]` | 라우터 전체 모델 리더보드 + 제공자 점유율(공개 통계) |

package/package.json

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

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) {