pleumrouter 0.5.2 → 0.5.4

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.4",
   "description": "Official PleumRouter terminal CLI — launch any coding agent against PleumRouter.",
   "type": "module",
   "bin": {

package/src/recipes.mjs

@@ -16,6 +16,11 @@ export const RECIPES = {
     bin: "claude",
     type: "env",
     install: "npm i -g @anthropic-ai/claude-code",
+    // 앱 랭킹 귀속 메타 — 백엔드 featured_agents / UA fallback과 동기화.
+    attribution: {
+      title: "Claude Code",
+      referer: "https://docs.anthropic.com/en/docs/claude-code",
+    },
     // 함정: ANTHROPIC_BASE_URL은 반드시 루트(/v1 없이) — CLI가 /v1/messages를 스스로 덧붙인다.
     // /v1을 넣으면 /v1/v1/messages가 되어 실패.
     env: (key) => ({
@@ -30,6 +35,10 @@ export const RECIPES = {
     bin: "codex",
     type: "codex-home",
     install: "npm i -g @openai/codex",
+    attribution: {
+      title: "Codex",
+      referer: "https://github.com/openai/codex",
+    },
     env: (key) => ({ PLEUM_API_KEY: key }),
     args: () => [],
   },
@@ -38,6 +47,10 @@ export const RECIPES = {
     bin: "aider",
     type: "env",
     install: "python -m pip install aider-install && aider-install",
+    attribution: {
+      title: "Aider",
+      referer: "https://aider.chat",
+    },
     env: (key) => ({ OPENAI_API_BASE: V1, OPENAI_API_KEY: key }),
     args: (m) => (m ? ["--model", `openai/${m}`] : []),
   },
@@ -47,6 +60,10 @@ export const RECIPES = {
     type: "env",
     install: "https://block.github.io/goose/docs/getting-started/installation",
     note: "Goose sets its model in its own config — use the openai/<id> format in `goose configure`.",
+    attribution: {
+      title: "Goose",
+      referer: "https://block.github.io/goose",
+    },
     env: (key) => ({ OPENAI_API_BASE: V1, OPENAI_API_KEY: key }),
     args: () => [],
   },
@@ -56,6 +73,10 @@ export const RECIPES = {
     type: "env",
     install: "python -m pip install openhands-ai",
     note: "For OpenHands, prefix the model name with openai/ in its config.",
+    attribution: {
+      title: "OpenHands",
+      referer: "https://www.all-hands.dev",
+    },
     env: (key) => ({ OPENAI_API_BASE: V1, OPENAI_API_KEY: key }),
     args: () => [],
   },
@@ -67,6 +88,10 @@ export const RECIPES = {
     // opencode는 커스텀 엔드포인트를 opencode.json provider 블록으로만 읽는다 — env var는 없다.
     // 대신 OPENCODE_CONFIG_CONTENT(파일 대신 JSON 문자열을 그대로 읽는 env var)로 파일 없이 주입한다.
     note: "Generates a temporary PleumRouter provider config for this run only — your own opencode.json is untouched.",
+    attribution: {
+      title: "opencode",
+      referer: "https://opencode.ai",
+    },
     env: (key, model) => ({
       PLEUM_API_KEY: key,
       OPENCODE_CONFIG_CONTENT: JSON.stringify({
@@ -90,6 +115,10 @@ export const RECIPES = {
     // omp는 커스텀 OpenAI 호환 엔드포인트는 YAML 설정 파일로만 읽지만, 내장 anthropic
     // provider만은 claude와 동일한 ANTHROPIC_BASE_URL env var로 리디렉션된다.
     note: "Needs the Bun runtime (bun >= 1.3.14) on PATH. Only Claude-family models are routed via env vars.",
+    attribution: {
+      title: "omp (Oh My Pi)",
+      referer: "https://omp.sh",
+    },
     env: (key) => ({ ANTHROPIC_BASE_URL: ROOT, ANTHROPIC_API_KEY: key }),
     args: (m) => (m ? ["--model", `anthropic/${m}`] : []),
   },
@@ -99,6 +128,10 @@ export const RECIPES = {
     type: "env",
     install: "curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash",
     note: "Pick the model after it starts with the `hermes model` command.",
+    attribution: {
+      title: "Hermes Agent",
+      referer: "https://hermes-agent.nousresearch.com",
+    },
     env: (key) => ({ OPENAI_BASE_URL: V1, OPENAI_API_KEY: key }),
     args: () => [],
   },
@@ -107,6 +140,10 @@ export const RECIPES = {
     bin: "qwen",
     type: "env",
     install: "npm install -g @qwen-code/qwen-code@latest",
+    attribution: {
+      title: "Qwen Code",
+      referer: "https://github.com/QwenLM/qwen-code",
+    },
     env: (key, model) => ({ OPENAI_BASE_URL: V1, OPENAI_API_KEY: key, OPENAI_MODEL: model || "gpt-5.4-mini" }),
     args: () => [],
   },
@@ -116,6 +153,10 @@ export const RECIPES = {
     type: "env",
     install: "npm install -g @github/copilot",
     note: "Needs GitHub Copilot CLI 2026-04 or later for BYOK provider routing support.",
+    attribution: {
+      title: "GitHub Copilot CLI",
+      referer: "https://docs.github.com/en/copilot/how-tos/use-copilot-agents/use-copilot-cli",
+    },
     env: (key, model) => ({
       COPILOT_PROVIDER_BASE_URL: V1,
       COPILOT_PROVIDER_TYPE: "openai",

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