pleumrouter 0.1.0

package/README.md

@@ -0,0 +1,38 @@
+# pleumrouter
+
+PleumRouter 공식 터미널 CLI. 쓰던 코딩 에이전트를 한 줄로 PleumRouter에 붙여 실행한다.
+
+```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                     # 터미널 채팅
+```
+
+## 명령
+
+| 명령 | 설명 |
+|------|------|
+| `pleum login` | 브라우저로 로그인 → CLI가 API 키를 자동 발급·저장(`~/.pleum/config.json`) |
+| `pleum logout` | 저장된 키 삭제 |
+| `pleum launch <tool> [--model id] [-- args]` | 에이전트 실행. `--` 뒤 인자는 도구로 그대로 전달 |
+| `pleum run <model>` | 스트리밍 채팅 REPL |
+| `pleum models [query]` | 모델 목록(공개) |
+
+## 자동 실행 지원 도구
+
+`claude` · `aider` · `codex` · `goose` · `openhands` — env(또는 격리된 `CODEX_HOME`)만
+세팅하고 바로 실행한다. 사용자의 기존 설정 파일은 건드리지 않는다.
+
+`opencode` · `crush` 는 provider 정의가 파일에 필요해 설정 스니펫만 안내한다.
+
+## 환경변수
+
+- `PLEUM_BASE_URL` — 게이트웨이 루트 덮어쓰기(기본 `https://router.pleum.ai`). 셀프호스트/스테이징용.
+
+## 개발
+
+```bash
+npm test          # node --test (의존성 0)
+npm link          # 로컬에서 pleum 명령 노출
+```

package/bin/pleum.mjs

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+import { login, loginDevice } from "../src/login.mjs";
+import { launch } from "../src/launch.mjs";
+import { run } from "../src/run.mjs";
+import { listModels } from "../src/models.mjs";
+import { balance } from "../src/balance.mjs";
+import { clearConfig } from "../src/config.mjs";
+
+const HELP = `pleum — PleumRouter 터미널 CLI
+
+  pleum login [--device]             브라우저로 로그인 + 키 자동 저장
+                                     --device: 브라우저 없는 환경(SSH·CI)
+  pleum logout                       저장된 키 삭제
+  pleum launch <tool> [--model id]   코딩 에이전트를 PleumRouter로 실행
+                                     (claude · aider · codex · goose · openhands)
+  pleum run <model>                  터미널 채팅
+  pleum models [query]               모델 목록
+  pleum balance                      크레딧 잔액 조회
+
+예:
+  pleum launch claude --model claude-sonnet-4
+  pleum launch codex --model gpt-4.1 -- --full-auto
+  pleum run gpt-4.1
+  pleum login --device               # SSH/CI 환경
+
+base_url 덮어쓰기: PLEUM_BASE_URL 환경변수`;
+
+// `--model id`/`-m id`를 뽑고, 나머지는 도구로 그대로 넘긴다. `--` 이후는 전부 패스스루.
+function parseLaunchArgs(args) {
+  const out = { model: undefined, passthrough: [] };
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--model" || args[i] === "-m") out.model = args[++i];
+    else if (args[i] === "--") {
+      out.passthrough.push(...args.slice(i + 1));
+      break;
+    } else out.passthrough.push(args[i]);
+  }
+  return out;
+}
+
+const [cmd, ...rest] = process.argv.slice(2);
+
+try {
+  switch (cmd) {
+    case "login":
+      if (rest.includes("--device")) await loginDevice();
+      else await login();
+      break;
+    case "logout":
+      clearConfig();
+      console.log("✓ 로그아웃됨");
+      break;
+    case "launch": {
+      const tool = rest[0];
+      if (!tool) {
+        console.error("사용법: pleum launch <tool> [--model id]");
+        process.exit(1);
+      }
+      const { model, passthrough } = parseLaunchArgs(rest.slice(1));
+      await launch(tool, model, passthrough);
+      break;
+    }
+    case "run":
+      await run(rest[0]);
+      break;
+    case "models":
+      await listModels(rest[0]);
+      break;
+    case "balance":
+      await balance();
+      break;
+    case undefined:
+    case "-h":
+    case "--help":
+    case "help":
+      console.log(HELP);
+      break;
+    default:
+      console.error(`알 수 없는 명령: ${cmd}\n\n${HELP}`);
+      process.exit(1);
+  }
+} catch (e) {
+  console.error(`✗ ${e.message}`);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "pleumrouter",
+  "version": "0.1.0",
+  "description": "Official PleumRouter terminal CLI — launch any coding agent against PleumRouter.",
+  "type": "module",
+  "bin": {
+    "pleum": "./bin/pleum.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": ["pleum", "ai", "llm", "openai", "claude", "coding-agent", "cli"],
+  "homepage": "https://router.pleum.ai/docs/cli",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gachon-star-want/PleumRouter.git",
+    "directory": "cli"
+  }
+}

package/src/balance.mjs

@@ -0,0 +1,18 @@
+import { V1 } from "./config.mjs";
+import { requireKey } from "./config.mjs";
+
+export async function balance() {
+  const key = requireKey();
+  const res = await fetch(`${V1}/credits`, {
+    headers: { Authorization: `Bearer ${key}` },
+  });
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    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 ? ` / $${data.balance_usd.toFixed(4)}` : "";
+  console.log(`잔액: ${plm.toLocaleString("ko-KR")} PLM${usd}`);
+}

package/src/config.mjs

@@ -0,0 +1,42 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { readFileSync, writeFileSync, mkdirSync, rmSync } from "node:fs";
+
+// 공개 게이트웨이 루트. 셀프호스트/스테이징은 PLEUM_BASE_URL로 덮어쓴다.
+export const ROOT = (process.env.PLEUM_BASE_URL ?? "https://router.pleum.ai").replace(/\/+$/, "");
+// OpenAI 호환 엔드포인트는 /v1. (Claude Code만 루트를 쓴다 — recipes 참고)
+export const V1 = `${ROOT}/v1`;
+
+const DIR = join(homedir(), ".pleum");
+const FILE = join(DIR, "config.json");
+
+export function readConfig() {
+  try {
+    return JSON.parse(readFileSync(FILE, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+export function writeConfig(cfg) {
+  mkdirSync(DIR, { recursive: true, mode: 0o700 });
+  writeFileSync(FILE, JSON.stringify(cfg, null, 2), { mode: 0o600 });
+}
+
+export function clearConfig() {
+  try {
+    rmSync(FILE);
+  } catch {
+    // 이미 없음 — 무시
+  }
+}
+
+// 키가 필요한 명령의 공통 가드. 없으면 안내 후 종료.
+export function requireKey() {
+  const cfg = readConfig();
+  if (!cfg?.key) {
+    console.error("로그인이 필요합니다. 먼저 실행하세요:\n  pleum login");
+    process.exit(1);
+  }
+  return cfg.key;
+}

package/src/launch.mjs

@@ -0,0 +1,61 @@
+import { spawn } from "node:child_process";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { requireKey } from "./config.mjs";
+import { RECIPES, MANUAL, codexToml } from "./recipes.mjs";
+
+export async function launch(tool, model, passthrough) {
+  const key = requireKey();
+  const r = RECIPES[tool];
+
+  if (!r) {
+    if (MANUAL[tool]) {
+      printManual(tool, key);
+      return;
+    }
+    console.error(
+      `지원하지 않는 도구: ${tool}\n` +
+        `  자동 실행: ${Object.keys(RECIPES).join(", ")}\n` +
+        `  설정 안내: ${Object.keys(MANUAL).join(", ")}`,
+    );
+    process.exit(1);
+  }
+
+  const env = { ...process.env, ...r.env(key) };
+
+  // Codex는 격리 CODEX_HOME에 config.toml을 써서 사용자 ~/.codex를 보존한다.
+  if (r.type === "codex-home") {
+    const home = join(homedir(), ".pleum", "codex-home");
+    mkdirSync(home, { recursive: true });
+    writeFileSync(join(home, "config.toml"), codexToml(model), { mode: 0o600 });
+    env.CODEX_HOME = home;
+  }
+
+  const args = [...r.args(model), ...passthrough];
+  if (r.note) console.log(`ℹ ${r.note}`);
+  console.log(`▶ ${r.label} 실행: ${r.bin} ${args.join(" ")}\n`);
+
+  const child = spawn(r.bin, args, {
+    env,
+    stdio: "inherit",
+    shell: process.platform === "win32",
+  });
+  child.on("error", (e) => {
+    if (e.code === "ENOENT") {
+      console.error(`✗ '${r.bin}'를 찾을 수 없습니다. 설치:\n  ${r.install}`);
+      process.exit(127);
+    }
+    console.error(`✗ ${e.message}`);
+    process.exit(1);
+  });
+  child.on("exit", (code) => process.exit(code ?? 0));
+}
+
+function printManual(tool, key) {
+  const m = MANUAL[tool];
+  console.log(`${m.label}는 provider 정의가 파일에 필요해 자동 실행 대신 설정만 안내합니다.\n`);
+  console.log(`1) ${m.file} 에 추가:\n`);
+  console.log(m.snippet());
+  console.log(`\n2) 키 export 후 실행:\n   export PLEUM_API_KEY=${key}\n`);
+}

package/src/login.mjs

@@ -0,0 +1,110 @@
+import { createServer } from "node:http";
+import { randomUUID } from "node:crypto";
+import { spawn } from "node:child_process";
+import { ROOT, V1, writeConfig } from "./config.mjs";
+
+function openBrowser(url) {
+  const cmd =
+    process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+  spawn(cmd, [url], {
+    stdio: "ignore",
+    detached: true,
+    shell: process.platform === "win32",
+  }).unref();
+}
+
+// 브라우저 핸드오프: 로컬 콜백 서버를 열고 대시보드 /cli-auth로 보낸다.
+// 프론트가 로그인 확인 후 키를 발급해 127.0.0.1:PORT/cb 로 POST 한다(URL에 키 미노출).
+export async function login() {
+  const state = randomUUID();
+
+  const key = await new Promise((resolve, reject) => {
+    const server = createServer((req, res) => {
+      // 로컬 콜백만 받으므로 CORS는 전부 허용(브라우저→127.0.0.1 cross-origin POST).
+      res.setHeader("Access-Control-Allow-Origin", "*");
+      res.setHeader("Access-Control-Allow-Methods", "POST, OPTIONS");
+      res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+      if (req.method === "OPTIONS") {
+        res.writeHead(204).end();
+        return;
+      }
+      const url = new URL(req.url, "http://127.0.0.1");
+      if (url.pathname !== "/cb" || req.method !== "POST") {
+        res.writeHead(404).end();
+        return;
+      }
+      let body = "";
+      req.on("data", (c) => (body += c));
+      req.on("end", () => {
+        let payload = {};
+        try {
+          payload = JSON.parse(body);
+        } catch {
+          // 잘못된 본문 — 아래 검증에서 걸러짐
+        }
+        const ok = payload.state === state && typeof payload.key === "string" && payload.key;
+        res.writeHead(ok ? 200 : 400, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ ok: Boolean(ok) }));
+        server.close();
+        if (ok) resolve(payload.key);
+        else reject(new Error("state 불일치 또는 키 누락"));
+      });
+    });
+
+    server.on("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const { port } = server.address();
+      const authUrl = `${ROOT}/cli-auth?port=${port}&state=${state}`;
+      console.log("브라우저에서 로그인하세요. 자동으로 안 열리면 아래 URL을 여세요:\n  " + authUrl + "\n");
+      openBrowser(authUrl);
+    });
+
+    setTimeout(() => {
+      server.close();
+      reject(new Error("로그인 시간 초과(2분)"));
+    }, 120_000).unref();
+  });
+
+  writeConfig({ key, base_url: ROOT });
+  console.log("✓ 로그인 완료. 키를 ~/.pleum/config.json 에 저장했습니다.");
+}
+
+// device-code 로그인 — 브라우저 없는 환경(SSH·CI).
+// 1) code 발급 → 2) 사용자가 /device에서 확인 → 3) CLI가 폴링으로 키 수신.
+export async function loginDevice() {
+  const res = await fetch(`${V1}/auth/device/code`, { method: "POST" });
+  if (!res.ok) {
+    console.error("device code 발급 실패 (서버 응답 " + res.status + ")");
+    process.exit(1);
+  }
+  const { device_code, user_code, verification_url, interval, expires_in } = await res.json();
+
+  console.log(
+    `\n  코드: \x1b[1;32m${user_code}\x1b[0m\n` +
+    `  URL : ${verification_url}\n\n` +
+    `  위 URL에서 로그인 후 코드를 입력하세요 (${expires_in / 60}분 내).\n`
+  );
+
+  const deadline = Date.now() + expires_in * 1000;
+  while (Date.now() < deadline) {
+    await new Promise((r) => setTimeout(r, interval * 1000));
+    const poll = await fetch(`${V1}/auth/device/token`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ device_code }),
+    });
+    if (poll.status === 202) continue; // authorization_pending
+    if (!poll.ok) {
+      const e = await poll.json().catch(() => ({}));
+      if (e.detail === "expired_token") { console.error("코드가 만료되었습니다."); process.exit(1); }
+      console.error("오류:", e.detail ?? poll.status);
+      process.exit(1);
+    }
+    const { key } = await poll.json();
+    writeConfig({ key, base_url: ROOT });
+    console.log("✓ 로그인 완료. 키를 ~/.pleum/config.json 에 저장했습니다.");
+    return;
+  }
+  console.error("시간 초과: 코드가 만료되었습니다.");
+  process.exit(1);
+}

package/src/models.mjs

@@ -0,0 +1,26 @@
+import { V1 } from "./config.mjs";
+
+// GET /v1/models 는 공개(인증 불필요). 슬러그는 provider/model 형식.
+export async function fetchModels() {
+  const res = await fetch(`${V1}/models`);
+  if (!res.ok) throw new Error(`모델 목록 조회 실패 (${res.status})`);
+  const data = await res.json();
+  return data.data ?? [];
+}
+
+export async function listModels(query) {
+  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),
+  );
+  for (const m of rows) {
+    const parts = [m.id, m.modality || "text"];
+    if (m.display_name) parts.push(m.display_name);
+    console.log(parts.join("\t"));
+  }
+  console.log(`\n${rows.length} models`);
+}

package/src/recipes.mjs

@@ -0,0 +1,103 @@
+import { ROOT, V1 } from "./config.mjs";
+
+// 도구별 설정의 진실 원천. 출처: frontend .../docs/cookbook/agent-integration.
+// type "env"        → 환경변수만 세팅하고 바로 실행.
+// type "codex-home" → 격리된 CODEX_HOME에 config.toml을 써서 실행(사용자 ~/.codex 보존).
+export const RECIPES = {
+  claude: {
+    label: "Claude Code",
+    bin: "claude",
+    type: "env",
+    install: "npm i -g @anthropic-ai/claude-code",
+    // 함정: ANTHROPIC_BASE_URL은 반드시 루트(/v1 없이) — CLI가 /v1/messages를 스스로 덧붙인다.
+    // /v1을 넣으면 /v1/v1/messages가 되어 실패.
+    env: (key) => ({
+      ANTHROPIC_BASE_URL: ROOT,
+      ANTHROPIC_API_KEY: key,
+      ANTHROPIC_AUTH_TOKEN: key,
+    }),
+    args: (m) => (m ? ["--model", `anthropic/${m}`] : []),
+  },
+  aider: {
+    label: "Aider",
+    bin: "aider",
+    type: "env",
+    install: "python -m pip install aider-install && aider-install",
+    env: (key) => ({ OPENAI_API_BASE: V1, OPENAI_API_KEY: key }),
+    args: (m) => (m ? ["--model", `openai/${m}`] : []),
+  },
+  goose: {
+    label: "Goose",
+    bin: "goose",
+    type: "env",
+    install: "https://block.github.io/goose/docs/getting-started/installation",
+    note: "Goose는 모델을 설정에서 지정합니다 — `goose configure`에서 openai/<id> 형식 사용.",
+    env: (key) => ({ OPENAI_API_BASE: V1, OPENAI_API_KEY: key }),
+    args: () => [],
+  },
+  openhands: {
+    label: "OpenHands",
+    bin: "openhands",
+    type: "env",
+    install: "python -m pip install openhands-ai",
+    note: "OpenHands는 모델명 앞에 openai/ 접두사를 붙여 설정하세요.",
+    env: (key) => ({ OPENAI_API_BASE: V1, OPENAI_API_KEY: key }),
+    args: () => [],
+  },
+  codex: {
+    label: "Codex CLI",
+    bin: "codex",
+    type: "codex-home",
+    install: "npm i -g @openai/codex",
+    env: (key) => ({ PLEUM_API_KEY: key }),
+    args: () => [],
+  },
+};
+
+// Codex는 Chat Completions가 제거돼 Responses API(wire_api="responses")만 지원.
+// 사용자의 ~/.codex/config.toml을 건드리지 않도록 격리 CODEX_HOME에 이 파일을 쓴다.
+export function codexToml(model) {
+  const m = model || "gpt-4.1";
+  return `# Generated by pleum CLI. Isolated CODEX_HOME — your ~/.codex is untouched.
+model = "${m}"
+model_provider = "pleum"
+
+[model_providers.pleum]
+name = "PleumRouter"
+base_url = "${V1}"
+env_key = "PLEUM_API_KEY"
+wire_api = "responses"
+`;
+}
+
+// provider 정의가 파일에 있어야 하는 도구 — 자동 실행 대신 설정 스니펫만 안내.
+export const MANUAL = {
+  opencode: {
+    label: "OpenCode",
+    file: "opencode.json",
+    snippet: () => `{
+  "provider": {
+    "pleum": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "PleumRouter",
+      "options": { "baseURL": "${V1}", "apiKey": "{env:PLEUM_API_KEY}" },
+      "models": { "gpt-4.1": {} }
+    }
+  }
+}`,
+  },
+  crush: {
+    label: "Crush",
+    file: "crush.json",
+    snippet: () => `{
+  "providers": {
+    "pleum": {
+      "type": "openai-compat",
+      "base_url": "${V1}",
+      "api_key": "$PLEUM_API_KEY",
+      "models": [{ "id": "gpt-4.1", "name": "gpt-4.1" }]
+    }
+  }
+}`,
+  },
+};

package/src/run.mjs

@@ -0,0 +1,83 @@
+import { createInterface } from "node:readline";
+import { V1, requireKey } from "./config.mjs";
+
+// 터미널 채팅 REPL — /v1/chat/completions 스트리밍을 토큰 단위로 출력.
+export async function run(model) {
+  if (!model) {
+    console.error("사용법: pleum run <model>\n모델 목록: pleum models");
+    process.exit(1);
+  }
+  const key = requireKey();
+  const messages = [];
+  const rl = createInterface({ input: process.stdin, output: process.stdout, prompt: "you> " });
+
+  console.log(`PleumRouter · ${model} · /exit 로 종료\n`);
+  rl.prompt();
+
+  rl.on("line", async (line) => {
+    const text = line.trim();
+    if (text === "/exit" || text === "/quit") {
+      rl.close();
+      return;
+    }
+    if (!text) {
+      rl.prompt();
+      return;
+    }
+    messages.push({ role: "user", content: text });
+    try {
+      const reply = await streamChat(key, model, messages);
+      messages.push({ role: "assistant", content: reply });
+    } catch (e) {
+      console.error(`\n✗ ${e.message}`);
+      messages.pop(); // 실패한 user 턴은 히스토리에서 제거
+    }
+    rl.prompt();
+  });
+
+  rl.on("close", () => {
+    console.log("\n안녕히 가세요.");
+    process.exit(0);
+  });
+}
+
+async function streamChat(key, model, messages) {
+  const res = await fetch(`${V1}/chat/completions`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", Authorization: `Bearer ${key}` },
+    body: JSON.stringify({ model, messages, stream: true }),
+  });
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    throw new Error(`${res.status} ${body.slice(0, 300)}`);
+  }
+
+  process.stdout.write("bot> ");
+  let full = "";
+  let buf = "";
+  const decoder = new TextDecoder();
+  for await (const chunk of res.body) {
+    buf += decoder.decode(chunk, { stream: true });
+    const lines = buf.split("\n");
+    buf = lines.pop() ?? "";
+    for (const l of lines) {
+      const s = l.trim();
+      if (!s.startsWith("data:")) continue;
+      const data = s.slice(5).trim();
+      if (data === "[DONE]") continue;
+      try {
+        const delta = JSON.parse(data).choices?.[0]?.delta?.content;
+        if (delta) {
+          process.stdout.write(delta);
+          full += delta;
+        }
+      } catch {
+        // 부분 청크 — 무시
+      }
+    }
+  }
+  process.stdout.write("\n");
+  const cost = res.headers.get("x-cost-krw");
+  if (cost) console.log(`  (₩${cost})`);
+  return full;
+}