democut 0.3.0 → 0.4.0

package/README.md

@@ -80,7 +80,7 @@ democut video status <job_id> [--wait] [--output <경로>]
 - **생성이 성공하면 과금된다** — 서버는 성공을 처음 관측한 시점에 원장에 기록한다(폴링을 반복해도 한 번).
   실패한 생성은 원장에 남지 않지만, 제출이 업스트림에 접수된 뒤의 재시도는 별개 생성이라 다시 과금된다.
 - **산출물 URL 은 24시간 후 만료된다** — `--output` 으로 즉시 받아두지 않으면 재생성해야 한다(재과금).
-- **CLI 는 제출을 자동 재시도하지 않는다** — BytePlus 가 멱등키(Idempotency-Key)를 지원하지 않아 재시도가 곧 재과금이다.
+- **CLI 는 제출을 자동 재시도하지 않는다** — 공급자가 멱등키(Idempotency-Key)를 지원하지 않아 재시도가 곧 재과금이다.
   실패해 보여도 먼저 `democut video status <job_id>` 로 확인할 것.
 - **`--wait` 시한 초과는 실패가 아니다** — 작업은 서버에서 계속 진행된다(종료 코드 5). 새로 제출하지 말고 `status` 로 확인한다.
 
@@ -123,9 +123,15 @@ npm run build      # dist/cli.js (bin: democut) 번들
 에이전트가 도구로 직접 영상을 만든다.
 
 ```bash
-claude mcp add democut -- democut mcp
+claude mcp add democut -- npx -y democut mcp
 ```
 
+`npx -y` 를 붙이는 이유는 전역 설치가 **연결의 선행 조건이 되지 않게** 하기 위해서다.
+설치가 빠지면 등록은 성립하는데(등록은 바이너리 존재를 검사하지 않는다) 연결만 실패하고,
+그 실패는 클라이언트의 `Failed to reconnect …` 한 줄로만 드러난다 — 서버가 뜨지 못하므로
+진단을 낼 주체가 없다. 자격증명은 패키지가 아니라 `~/.democut/credentials.json` 에 있어
+실행 방식을 바꿔도 로그인 상태는 그대로다. 전역 설치는 선택이다.
+
 노출 도구 4개:
 
 | 도구 | 부작용 |
@@ -145,18 +151,29 @@ CLI 는 TTY 에 `y/N` 을 물어 사람을 막지만 MCP 에는 물어볼 화면
    보내야 하고, 서버가 방금 계산한 값과 대조해 어긋나면 거부한다. 모델이 추정을 건너뛰고
    바로 생성하는 것을 막고, 사람에게 보여준 금액과 실제 청구액이 갈라지지 않게 한다.
 
-### 왜 원격 HTTP 가 아니라 stdio 인가
+### stdio 와 원격 HTTP — 대체가 아니라 병존
+
+**stdio(이 CLI)가 기본이다.** 이 프로세스가 `~/.democut/credentials.json` 을 읽고 만료 시
+refresh 로 회전하므로 **클라이언트 설정 파일에 토큰이 남지 않는다.** 그 장점은 원격이
+생겨도 사라지지 않는다.
+
+**원격 HTTP 도 이미 있다** — `https://democut.ai/mcp` (2026-08-25 배포). 로컬 바이너리를 못
+띄우는 클라이언트용이다:
 
-원격 MCP 서버로 만들면 클라이언트가 OAuth 2.1 discovery(RFC 9728 + RFC 8414 + PKCE +
-동적 클라이언트 등록)를 요구한다. 우리가 가진 것은 device flow(RFC 8628)라 그 체인을 새로
-쌓아야 하고, 정적 Bearer 를 클라이언트 설정에 박는 우회는 **access token 이 1시간이면
-만료**돼 곧 깨진다.
+```bash
+claude mcp add --transport http --client-id <client_id> --callback-port <포트> \
+    democut https://democut.ai/mcp
+```
 
-stdio 는 그 문제가 통째로 사라진다 — 이 프로세스가 이미 `~/.democut/credentials.json` 을
-읽고 만료 시 refresh 로 회전한다. **클라이언트 설정에 토큰이 남지 않고**, 서버에 새 인증
-표면을 만들지 않으며, CLI 가 이미 검증해 둔 경로를 그대로 쓴다.
+`--client-id` 와 `--callback-port` 가 필요한 이유는 서버 쪽 설계에서 온다 — 동적 클라이언트
+등록(DCR)을 **일부러 꺼 두고**, Clerk 이 loopback redirect 의 포트를 정확 일치로 요구하기
+때문이다. 근거는 `apps/api/app/mcp/auth.py` docstring 이 SSOT.
 
-원격 HTTP 는 로컬 바이너리를 못 돌리는 클라이언트를 위해 나중에 별도로 얹는다.
+> ⚠️ 이 문단은 원래 "원격은 동적 클라이언트 등록을 요구해서 체인을 새로 쌓아야 한다" 고
+> 적혀 있었는데 **틀렸다.** DCR 은 MCP 명세에서 MUST 가 아니라 SHOULD 이고, 무엇보다 우리
+> 인증 공급자(Clerk)가 이미 완전한 OAuth 2.1 인가서버라 **우리가 만든 AS 는 0줄**이다.
+> 오류의 모양이 재발 포인트라 남긴다 — *우리 코드*만 재고 조사하고 **이미 구입한 SaaS
+> 기능은 세지 않았다.**
 
 ## 게시 (npm publish)
 

package/dist/cli.js

@@ -6885,8 +6885,8 @@ var require_dist = __commonJS({
         return ajv;
       }
       const [formats, exportName] = opts.mode === "fast" ? [formats_1.fastFormats, fastName] : [formats_1.fullFormats, fullName];
-      const list = opts.formats || formats_1.formatNames;
-      addFormats(ajv, list, formats, exportName);
+      const list2 = opts.formats || formats_1.formatNames;
+      addFormats(ajv, list2, formats, exportName);
       if (opts.keywords)
         (0, limit_1.default)(ajv);
       return ajv;
@@ -6898,11 +6898,11 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list, fs, exportName) {
+    function addFormats(ajv, list2, fs, exportName) {
       var _a3;
       var _b;
       (_a3 = (_b = ajv.opts.code).formats) !== null && _a3 !== void 0 ? _a3 : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
-      for (const f of list)
+      for (const f of list2)
         ajv.addFormat(f, fs[f]);
     }
     module.exports = exports = formatsPlugin;
@@ -7362,6 +7362,16 @@ function classifyApiError(e, ctx) {
       ]
     };
   }
+  if (e.status === 404) {
+    const lines = [];
+    if (e.code === "VIDEOGEN_PROJECT_NOT_FOUND") {
+      lines.push(
+        "democut_list_projects \uB85C \uC774 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC758 \uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D\uC744 \uD655\uC778\uD558\uACE0 \uADF8\uC911 \uD558\uB098\uC758 \uC2AC\uB7EC\uADF8\uB97C \uC4F0\uC138\uC694. \uBAA9\uB85D\uC774 \uBE44\uC5B4 \uC788\uC73C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD504\uB85C\uC81D\uD2B8\uB97C \uBA3C\uC800 \uB9CC\uB4E4\uC5B4 \uB2EC\uB77C\uACE0 \uC54C\uB9AC\uC138\uC694."
+      );
+    }
+    lines.push("\uC544\uC9C1 \uACFC\uAE08\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4 \u2014 \uAC12\uC744 \uACE0\uCCD0 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694.");
+    return { safety: "fixable", notCharged: true, lines };
+  }
   if (e.status === 403) {
     return {
       safety: "unknown",
@@ -7437,13 +7447,14 @@ async function download(videoUrl, outPath, fetchImpl = fetch) {
   const res = await fetchImpl(videoUrl);
   if (!res.ok) {
     throw new Error(
-      `\uC0B0\uCD9C\uBB3C \uB0B4\uB824\uBC1B\uAE30 \uC2E4\uD328 (HTTP ${res.status}). \uC11C\uBA85 URL \uC740 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB429\uB2C8\uB2E4.`
+      `\uC0B0\uCD9C\uBB3C \uB0B4\uB824\uBC1B\uAE30 \uC2E4\uD328 (HTTP ${res.status}).`
     );
   }
   await writeFile(outPath, Buffer.from(await res.arrayBuffer()));
 }
 
 // src/commands/video.ts
+var MOCK_NOTICE = "\u26A0\uFE0F mock \uBAA8\uB4DC \u2014 \uC774 \uBC30\uD3EC\uB294 \uC601\uC0C1\uC744 \uC2E4\uC81C\uB85C \uC0DD\uC131\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 (API \uD0A4 \uBBF8\uC124\uC815). \uC544\uB798 \uAE08\uC561\xB7job id\xB7URL \uC740 \uC804\uBD80 \uAC00\uC9DC\uC774\uBA70 \uACFC\uAE08\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.";
 var EXIT = {
   OK: 0,
   /** 일반 오류 — 미로그인·사용자 취소·생성 실패·알 수 없음. */
@@ -7550,8 +7561,9 @@ function estimateCommand(opts, deps = {}) {
     const base = resolveBaseUrl(opts.baseUrl);
     const r = await estimate(base, buildEstimateIn(opts), deps);
     if (opts.json) {
-      emit(opts, true, { tokens: r.tokens, cost_usd: r.cost_usd, model: r.model });
+      emit(opts, true, { tokens: r.tokens, cost_usd: r.cost_usd, model: r.model, mock: r.mock });
     } else {
+      if (r.mock) err2(MOCK_NOTICE);
       out2(`\uC608\uC0C1 \uBE44\uC6A9: ${usd2(r.cost_usd)}  (${r.tokens.toLocaleString()} tokens \xB7 ${r.model})`);
     }
     return EXIT.OK;
@@ -7562,10 +7574,16 @@ function generateCommand(prompt, opts, deps = {}) {
     if (!prompt || !prompt.trim()) {
       throw new UsageError('\uD504\uB86C\uD504\uD2B8\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. \uC608: democut video generate "\uACE0\uC591\uC774\uAC00 \uCDA4\uCD98\uB2E4"');
     }
+    if (!opts.project || !opts.project.trim()) {
+      throw new UsageError(
+        "--project <slug> \uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. \uBE44\uC6A9\uC774 \uADC0\uC18D\uB420 \uBCF8\uC778 \uC18C\uC720 \uD504\uB85C\uC81D\uD2B8\uB97C \uC9C0\uC815\uD558\uC138\uC694. \uC2AC\uB7EC\uADF8\uB294 \uC6F9\uC758 \uD504\uB85C\uC81D\uD2B8 \uC8FC\uC18C `/projects/<\uC2AC\uB7EC\uADF8>` \uC5D0\uC11C \uD655\uC778\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4."
+      );
+    }
     const base = resolveBaseUrl(opts.baseUrl);
     const est = buildEstimateIn(opts);
     const quote = await estimate(base, est, deps);
     if (!opts.json) {
+      if (quote.mock) err2(MOCK_NOTICE);
       out2(`\uC608\uC0C1 \uBE44\uC6A9: ${usd2(quote.cost_usd)}  (${quote.tokens.toLocaleString()} tokens \xB7 ${quote.model})`);
       out2(`  ${est.duration_s}\uCD08 \xB7 ${est.resolution} \xB7 ${est.ratio}`);
     }
@@ -7591,7 +7609,8 @@ function generateCommand(prompt, opts, deps = {}) {
         return EXIT.FIXABLE;
       }
       const ask = deps.confirmImpl ?? confirm;
-      if (!await ask(`${usd2(quote.cost_usd)} \uAC00 \uCCAD\uAD6C\uB429\uB2C8\uB2E4. \uC0DD\uC131\uD560\uAE4C\uC694?`)) {
+      const question = quote.mock ? "mock \uBAA8\uB4DC\uC785\uB2C8\uB2E4 \u2014 \uC2E4\uC81C \uC601\uC0C1\uC740 \uC0DD\uC131\uB418\uC9C0 \uC54A\uACE0 \uACFC\uAE08\uB3C4 \uC5C6\uC2B5\uB2C8\uB2E4. \uADF8\uB798\uB3C4 \uC9C4\uD589\uD560\uAE4C\uC694?" : `${usd2(quote.cost_usd)} \uAC00 \uCCAD\uAD6C\uB429\uB2C8\uB2E4. \uC0DD\uC131\uD560\uAE4C\uC694?`;
+      if (!await ask(question)) {
         out2("\uCDE8\uC18C\uD588\uC2B5\uB2C8\uB2E4. \uACFC\uAE08\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
         return EXIT.GENERAL;
       }
@@ -7606,7 +7625,7 @@ function generateCommand(prompt, opts, deps = {}) {
       ...opts.model ? { model: opts.model } : {},
       ...opts.seed !== void 0 ? { seed: parseIntOpt(opts.seed, "seed") } : {},
       ...opts.imageUrls?.length ? { image_urls: opts.imageUrls } : {},
-      ...opts.project ? { project_slug: opts.project } : {}
+      project_slug: opts.project
     };
     const job = await submit(base, body, deps);
     if (job.duplicate) {
@@ -7618,6 +7637,7 @@ function generateCommand(prompt, opts, deps = {}) {
       }
       if (!opts.json) out2(`\uAC19\uC740 \uC694\uCCAD\uC774 \uC774\uBBF8 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4 (job ${job.job_id}). \uC0C8\uB85C \uACFC\uAE08\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`);
     } else if (!opts.json) {
+      if (job.mock) err2(MOCK_NOTICE);
       out2(`\uC81C\uCD9C\uB428: job ${job.job_id}  (\uC608\uC0C1 ${usd2(job.estimated_cost_usd)})`);
     }
     if (!opts.wait) {
@@ -7628,11 +7648,11 @@ function generateCommand(prompt, opts, deps = {}) {
           model: job.model,
           estimated_cost_usd: job.estimated_cost_usd,
           duplicate: job.duplicate,
-          pending: job.pending
+          pending: job.pending,
+          mock: job.mock
         });
       } else {
-        const projectFlag = opts.project ? ` --project ${opts.project}` : "";
-        out2(`\uC644\uB8CC \uD655\uC778: democut video status ${job.job_id}${projectFlag}`);
+        out2(`\uC644\uB8CC \uD655\uC778: democut video status ${job.job_id}`);
       }
       return EXIT.OK;
     }
@@ -7669,6 +7689,24 @@ async function report(job, opts, deps = {}) {
     }
     return EXIT.GENERAL;
   }
+  if (job.mock) {
+    if (opts.json) {
+      emit(opts, true, {
+        job_id: job.job_id,
+        status: job.status,
+        model: job.model,
+        video_url: job.video_url ?? null,
+        saved_to: null,
+        mock: true
+      });
+    } else {
+      err2(MOCK_NOTICE);
+      out2(`\uC0C1\uD0DC: ${job.status} (\uAC00\uC9DC)`);
+      if (job.video_url) out2(`  URL : ${job.video_url}  \u2190 \uC2E4\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`);
+      out2("  \uB0B4\uB824\uBC1B\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uC2E4\uC81C \uC0DD\uC131\uC744 \uD558\uB824\uBA74 \uC6B4\uC601\uC790\uC5D0\uAC8C API \uD0A4 \uC124\uC815\uC744 \uC694\uCCAD\uD558\uC138\uC694.");
+    }
+    return EXIT.OK;
+  }
   let saved = null;
   let downloadError = null;
   if (job.video_url && opts.output) {
@@ -7699,9 +7737,9 @@ async function report(job, opts, deps = {}) {
       out2(`  URL : ${job.video_url}`);
       if (downloadError) {
         err2(`  \uB0B4\uB824\uBC1B\uAE30 \uC2E4\uD328: ${downloadError}`);
-        err2("  \u26A0\uFE0F \uC704 URL \uB85C \uC9C1\uC811 \uBC1B\uC73C\uC138\uC694 \u2014 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB418\uBA70, \uB2E4\uC2DC \uB9CC\uB4E4\uBA74 \uB610 \uACFC\uAE08\uB429\uB2C8\uB2E4.");
+        err2("  \u26A0\uFE0F \uC704 URL \uB85C \uC9C1\uC811 \uBC1B\uC73C\uC138\uC694 \u2014 \uC11C\uBC84\uB294 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC73C\uBA70, \uB2E4\uC2DC \uB9CC\uB4E4\uBA74 \uB610 \uACFC\uAE08\uB429\uB2C8\uB2E4.");
       } else {
-        out2("  \u26A0\uFE0F \uC774 URL \uC740 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB429\uB2C8\uB2E4 \u2014 \uC9C0\uAE08 \uB0B4\uB824\uBC1B\uC73C\uC138\uC694 (--output <\uACBD\uB85C>).");
+        out2("  \u26A0\uFE0F \uC11C\uBC84\uB294 \uC774 \uC0B0\uCD9C\uBB3C\uC744 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2014 \uC9C0\uAE08 \uB0B4\uB824\uBC1B\uC73C\uC138\uC694 (--output <\uACBD\uB85C>).");
       }
     }
   }
@@ -16275,10 +16313,42 @@ var StdioServerTransport = class {
 };
 
 // src/version.ts
-var VERSION = "0.3.0";
+var VERSION = "0.4.0";
 
 // src/mcp/tools.ts
 import { existsSync as existsSync2 } from "fs";
+
+// src/credits.ts
+var LEDGER_MAX_LIMIT = 200;
+var LEDGER_DEFAULT_LIMIT = 10;
+function balance(baseUrl, workspaceId, deps = {}) {
+  return apiRequest(
+    baseUrl,
+    `/api/workspaces/${encodeURIComponent(workspaceId)}/credits`,
+    {},
+    deps
+  );
+}
+function ledger(baseUrl, workspaceId, opts = {}, deps = {}) {
+  const q = new URLSearchParams();
+  q.set("limit", String(opts.limit ?? LEDGER_DEFAULT_LIMIT));
+  if (opts.beforeId !== void 0) q.set("before_id", String(opts.beforeId));
+  return apiRequest(
+    baseUrl,
+    `/api/workspaces/${encodeURIComponent(workspaceId)}/credits/ledger?${q}`,
+    {},
+    deps
+  );
+}
+
+// src/projects.ts
+var PROJECTS_DEFAULT_LIMIT = 30;
+var PROJECTS_MAX_LIMIT = 100;
+function list(baseUrl, deps = {}) {
+  return apiRequest(baseUrl, "/api/projects", {}, deps);
+}
+
+// src/mcp/tools.ts
 var COST_TOLERANCE_USD = 5e-3;
 function usd3(v) {
   return v < 0.01 ? `$${v.toFixed(4)}` : `$${v.toFixed(2)}`;
@@ -16330,10 +16400,22 @@ function toEstimateIn(a) {
     ...a.model ? { model: a.model } : {}
   };
 }
+var MOCK_BANNER = "\u26A0\uFE0F \uC774 \uBC30\uD3EC\uB294 mock \uBAA8\uB4DC\uC785\uB2C8\uB2E4 \u2014 \uC601\uC0C1\uC774 **\uC2E4\uC81C\uB85C \uC0DD\uC131\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4**. \uC544\uB798 \uAE08\uC561\xB7job_id\xB7URL \uC740 \uC804\uBD80 \uAC00\uC9DC\uC774\uBA70 \uC2E4\uC81C\uB85C \uACFC\uAE08\uB418\uC9C0\uB3C4 \uC54A\uC2B5\uB2C8\uB2E4. \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC0DD\uC131\uC774 \uB418\uC5C8\uB2E4\uACE0 \uBCF4\uACE0\uD558\uC9C0 \uB9C8\uC138\uC694.";
 function estimateCost(a, deps = {}) {
   return guarded2(READ_ONLY, async () => {
     const base = resolveBaseUrl(deps.baseUrl);
     const r = await estimate(base, toEstimateIn(a), deps);
+    if (r.mock) {
+      return {
+        text: [
+          MOCK_BANNER,
+          "",
+          `(\uCC38\uACE0\uC6A9 \uCD94\uC815\uCE58: ${usd3(r.cost_usd)} \xB7 ${r.model})`,
+          "",
+          "\uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBE44\uC6A9 \uB3D9\uC758\uB97C \uAD6C\uD558\uC9C0 \uB9C8\uC138\uC694 \u2014 \uC774 \uBC30\uD3EC\uC5D0\uC11C\uB294 \uC81C\uCD9C\uD574\uB3C4 \uC2E4\uC81C \uC601\uC0C1\uC774 \uB9CC\uB4E4\uC5B4\uC9C0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC6B4\uC601\uC790\uC5D0\uAC8C API \uD0A4 \uC124\uC815\uC744 \uC694\uCCAD\uD558\uC138\uC694."
+        ].join("\n")
+      };
+    }
     return {
       text: [
         `\uC608\uC0C1 \uBE44\uC6A9: ${usd3(r.cost_usd)} (${r.tokens.toLocaleString()} tokens \xB7 ${r.model})`,
@@ -16349,6 +16431,12 @@ function generateVideo(a, deps = {}) {
     if (!a.prompt?.trim()) {
       return { isError: true, text: "prompt \uAC00 \uBE44\uC5B4 \uC788\uC2B5\uB2C8\uB2E4." };
     }
+    if (typeof a.project_slug !== "string" || !a.project_slug.trim()) {
+      return {
+        isError: true,
+        text: "project_slug \uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. \uBE44\uC6A9\uC744 \uADC0\uC18D\uC2DC\uD0AC \uBCF8\uC778 \uC18C\uC720 \uD504\uB85C\uC81D\uD2B8\uC758 \uC2AC\uB7EC\uADF8\uB97C \uB123\uC5B4 \uB2E4\uC2DC \uD638\uCD9C\uD558\uC138\uC694. \uC544\uC9C1 \uACFC\uAE08\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.\n\uC2AC\uB7EC\uADF8\uB97C \uBAA8\uB974\uBA74 democut_list_projects \uB85C \uC774 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC758 \uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D\uC744 \uD655\uC778\uD558\uC138\uC694. \uBAA9\uB85D\uC774 \uBE44\uC5B4 \uC788\uC73C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD504\uB85C\uC81D\uD2B8\uB97C \uBA3C\uC800 \uB9CC\uB4E4\uC5B4 \uB2EC\uB77C\uACE0 \uC54C\uB9AC\uC138\uC694."
+      };
+    }
     const base = resolveBaseUrl(deps.baseUrl);
     const est = toEstimateIn(a);
     const quote = await estimate(base, est, deps);
@@ -16374,7 +16462,7 @@ function generateVideo(a, deps = {}) {
       ...a.model ? { model: a.model } : {},
       ...a.seed !== void 0 ? { seed: a.seed } : {},
       ...a.image_urls?.length ? { image_urls: a.image_urls } : {},
-      ...a.project_slug ? { project_slug: a.project_slug } : {}
+      project_slug: a.project_slug.trim()
     };
     const job = await submit(base, body, deps);
     if (job.duplicate) {
@@ -16382,6 +16470,17 @@ function generateVideo(a, deps = {}) {
         text: job.pending ? "\uAC19\uC740 \uC694\uCCAD\uC774 \uBC29\uAE08 \uC81C\uCD9C\uB418\uC5B4 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4. job_id \uAC00 \uC544\uC9C1 \uC5C6\uC73C\uB2C8 \uC7A0\uC2DC \uD6C4 \uAC19\uC740 \uD30C\uB77C\uBBF8\uD130\uB85C \uB2E4\uC2DC \uD638\uCD9C\uD558\uC9C0 \uB9D0\uACE0 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC54C\uB9AC\uC138\uC694(\uC0C8\uB85C \uB9CC\uB4E4\uBA74 \uB2E4\uC2DC \uACFC\uAE08\uB429\uB2C8\uB2E4)." : `\uAC19\uC740 \uC694\uCCAD\uC774 \uC774\uBBF8 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4 (job_id: ${job.job_id}). \uC0C8\uB85C \uACFC\uAE08\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. get_video_status \uB85C \uD655\uC778\uD558\uC138\uC694.`
       };
     }
+    if (job.mock) {
+      return {
+        text: [
+          MOCK_BANNER,
+          "",
+          `(\uAC00\uC9DC job_id: ${job.job_id} \xB7 \uBAA8\uB378 ${job.model})`,
+          "",
+          "\uC2E4\uC81C\uB85C \uC81C\uCD9C\uB418\uC9C0 \uC54A\uC558\uACE0 \uACFC\uAE08\uB3C4 \uC5C6\uC2B5\uB2C8\uB2E4. \uC774 job_id \uB85C \uC0C1\uD0DC\uB97C \uC870\uD68C\uD558\uBA74 \uAC00\uC9DC URL \uC774 \uB098\uC635\uB2C8\uB2E4 \u2014 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC601\uC0C1\uC774 \uB9CC\uB4E4\uC5B4\uC84C\uB2E4\uACE0 \uB9D0\uD558\uC9C0 \uB9C8\uC138\uC694."
+        ].join("\n")
+      };
+    }
     return {
       text: [
         `\uC81C\uCD9C\uB428 \u2014 job_id: ${job.job_id}`,
@@ -16398,6 +16497,17 @@ function videoStatus(a, deps = {}) {
     if (!a.job_id?.trim()) return { isError: true, text: "job_id \uAC00 \uD544\uC694\uD569\uB2C8\uB2E4." };
     const base = resolveBaseUrl(deps.baseUrl);
     const job = await status(base, a.job_id, a.project_slug, deps);
+    if (job.mock) {
+      return {
+        text: [
+          MOCK_BANNER,
+          "",
+          `(\uAC00\uC9DC \uC0C1\uD0DC: ${job.status} \xB7 \uAC00\uC9DC \uACB0\uACFC: ${job.video_url ?? "\uC5C6\uC74C"})`,
+          "",
+          "\uC774 URL \uC740 \uC2E4\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uB0B4\uB824\uBC1B\uC9C0 \uC54A\uC558\uACE0, \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC804\uB2EC\uD558\uC9C0 \uB9C8\uC138\uC694. \uC644\uB8CC\uB97C \uAE30\uB2E4\uB9AC\uBA70 \uB2E4\uC2DC \uC870\uD68C\uD558\uC9C0\uB3C4 \uB9C8\uC138\uC694."
+        ].join("\n")
+      };
+    }
     if (job.status === "failed" || job.status === "cancelled") {
       return {
         isError: true,
@@ -16417,7 +16527,7 @@ function videoStatus(a, deps = {}) {
       if (existsSync2(a.output_path)) {
         lines.push(`\uC800\uC7A5\uD558\uC9C0 \uC54A\uC74C: ${a.output_path} \uC5D0 \uC774\uBBF8 \uD30C\uC77C\uC774 \uC788\uC2B5\uB2C8\uB2E4(\uB36E\uC5B4\uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4).`);
         lines.push(`URL: ${job.video_url}`);
-        lines.push("\uB2E4\uB978 \uACBD\uB85C\uB97C \uC9C0\uC815\uD558\uAC70\uB098 \uC704 URL \uB85C \uC9C1\uC811 \uBC1B\uC73C\uC138\uC694 \u2014 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB429\uB2C8\uB2E4.");
+        lines.push("\uB2E4\uB978 \uACBD\uB85C\uB97C \uC9C0\uC815\uD558\uAC70\uB098 \uC704 URL \uB85C \uC9C1\uC811 \uBC1B\uC73C\uC138\uC694 \u2014 \uC11C\uBC84\uB294 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
         return { text: lines.join("\n") };
       }
       try {
@@ -16426,15 +16536,153 @@ function videoStatus(a, deps = {}) {
       } catch (e) {
         lines.push(`\uB0B4\uB824\uBC1B\uAE30 \uC2E4\uD328: ${e?.message ?? String(e)}`);
         lines.push(`URL: ${job.video_url}`);
-        lines.push("\u26A0\uFE0F \uC704 URL \uB85C \uC9C1\uC811 \uBC1B\uC73C\uC138\uC694 \u2014 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB418\uBA70 \uB2E4\uC2DC \uB9CC\uB4E4\uBA74 \uB610 \uACFC\uAE08\uB429\uB2C8\uB2E4.");
+        lines.push("\u26A0\uFE0F \uC704 URL \uB85C \uC9C1\uC811 \uBC1B\uC73C\uC138\uC694 \u2014 \uC11C\uBC84\uB294 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC73C\uBA70 \uB2E4\uC2DC \uB9CC\uB4E4\uBA74 \uB610 \uACFC\uAE08\uB429\uB2C8\uB2E4.");
       }
     } else if (job.video_url) {
       lines.push(`URL: ${job.video_url}`);
-      lines.push("\u26A0\uFE0F \uC774 URL \uC740 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB429\uB2C8\uB2E4 \u2014 output_path \uB97C \uC8FC\uBA74 \uBC14\uB85C \uC800\uC7A5\uD569\uB2C8\uB2E4.");
+      lines.push("\u26A0\uFE0F \uC11C\uBC84\uB294 \uC774 \uC0B0\uCD9C\uBB3C\uC744 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2014 output_path \uB97C \uC8FC\uBA74 \uBC14\uB85C \uC800\uC7A5\uD569\uB2C8\uB2E4.");
+    }
+    return { text: lines.join("\n") };
+  });
+}
+var krw = (v) => `${v.toLocaleString("ko-KR")}\uC6D0`;
+var NO_WORKSPACE = {
+  isError: true,
+  text: "\uD65C\uC131 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. democut_auth_status \uB85C \uB85C\uADF8\uC778 \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uACE0, \uC18C\uC18D\uB41C \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uAC00 \uC5C6\uB2E4\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uCD08\uB300\uB97C \uBC1B\uC544\uC57C \uD55C\uB2E4\uACE0 \uC54C\uB9AC\uC138\uC694."
+};
+async function resolveWorkspace(base, deps) {
+  const token = await getValidAccessToken(base, deps);
+  const me = await whoami(base, token, deps.fetchImpl);
+  return me.workspace_id ?? null;
+}
+function creditBalance(deps = {}) {
+  return guarded2(READ_ONLY, async () => {
+    const base = resolveBaseUrl(deps.baseUrl);
+    const ws = await resolveWorkspace(base, deps);
+    if (!ws) return NO_WORKSPACE;
+    const b = await balance(base, ws, deps);
+    if (b.total_krw == null) {
+      return {
+        text: "\uC774 \uBC30\uD3EC\uC5D0\uB294 \uD06C\uB808\uB527 \uAE30\uB2A5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uC794\uC561\uC774\uB77C\uB294 \uAC1C\uB150 \uC790\uCCB4\uAC00 \uC5C6\uACE0, \uC794\uC561 \uBD80\uC871\uC73C\uB85C \uC791\uC5C5\uC774 \uB9C9\uD788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC794\uC561\uC744 0\uC6D0\uC73C\uB85C \uC77D\uC9C0 \uB9C8\uC138\uC694."
+      };
+    }
+    const lines = [
+      `\uC794\uC561: ${krw(b.total_krw)} (\uAD6C\uB3C5 ${krw(b.subscription_krw ?? 0)} \xB7 \uCDA9\uC804 ${krw(b.topup_krw ?? 0)})`,
+      `\uC694\uAE08\uC81C: ${b.tier ?? "-"} \xB7 \uC9C0\uAE09 \uC8FC\uAE30: ${b.period_key ?? "\uC5C6\uC74C"}`,
+      ""
+    ];
+    if (!b.enabled) {
+      lines.push(
+        "\uACFC\uAE08 \uCC28\uB2E8\uC774 **\uAEBC\uC838 \uC788\uC2B5\uB2C8\uB2E4** \u2014 \uC794\uC561\uC774 \uBAA8\uC790\uB77C\uB3C4 \uC791\uC5C5\uC774 \uAC70\uBD80\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC704 \uC794\uC561\uC740 \uCC38\uACE0\uC6A9\uC774\uBA70, \uC794\uC561 \uBD80\uC871\uC744 \uC774\uC720\uB85C \uC791\uC5C5\uC744 \uD3EC\uAE30\uD558\uC9C0 \uB9C8\uC138\uC694."
+      );
+    } else if (b.total_krw <= 0) {
+      lines.push(
+        "\uC794\uC561\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uB3C8\uC774 \uB098\uAC00\uB294 \uC791\uC5C5\uC740 402 \uB85C \uAC70\uBD80\uB429\uB2C8\uB2E4. \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC54C\uB9AC\uACE0 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uAD00\uB9AC\uC790\uC5D0\uAC8C \uCDA9\uC804\uC744 \uC694\uCCAD\uD558\uB3C4\uB85D \uC548\uB0B4\uD558\uC138\uC694. \uC81C\uCD9C\uC744 \uBC18\uBCF5\uD558\uC9C0 \uB9C8\uC138\uC694."
+      );
+    } else {
+      lines.push(
+        "\uB3C8\uC774 \uB098\uAC00\uB294 \uC791\uC5C5 \uC804\uC5D0 democut_estimate_video_cost \uB85C \uAE08\uC561\uC744 \uD655\uC778\uD558\uACE0 \uC774 \uC794\uC561\uACFC \uACAC\uC8FC\uC138\uC694. \uD06C\uB808\uB527\uC740 \uC6D0(KRW)\uC774\uACE0 \uACAC\uC801\uC740 USD \uB77C \uB2E8\uC704\uAC00 \uB2E4\uB985\uB2C8\uB2E4 \u2014 \uD655\uC2E4\uD558\uC9C0 \uC54A\uC73C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uB450 \uAC12\uC744 \uADF8\uB300\uB85C \uBCF4\uC5EC \uC8FC\uC138\uC694."
+      );
     }
     return { text: lines.join("\n") };
   });
 }
+function creditLedger(a = {}, deps = {}) {
+  return guarded2(READ_ONLY, async () => {
+    if (a.limit !== void 0 && !Number.isFinite(a.limit)) {
+      return { isError: true, text: `limit \uC740 \uC22B\uC790\uC5EC\uC57C \uD569\uB2C8\uB2E4: ${JSON.stringify(a.limit)}` };
+    }
+    if (a.before_id !== void 0 && !Number.isFinite(a.before_id)) {
+      return {
+        isError: true,
+        text: `before_id \uB294 \uC22B\uC790\uC5EC\uC57C \uD569\uB2C8\uB2E4: ${JSON.stringify(a.before_id)}`
+      };
+    }
+    const limit = Math.max(
+      1,
+      Math.min(Math.trunc(a.limit ?? LEDGER_DEFAULT_LIMIT), LEDGER_MAX_LIMIT)
+    );
+    if (a.before_id !== void 0 && a.before_id < 1) {
+      return { isError: true, text: "before_id \uB294 1 \uC774\uC0C1\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4." };
+    }
+    const base = resolveBaseUrl(deps.baseUrl);
+    const ws = await resolveWorkspace(base, deps);
+    if (!ws) return NO_WORKSPACE;
+    const out3 = await ledger(
+      base,
+      ws,
+      { limit, ...a.before_id !== void 0 ? { beforeId: Math.trunc(a.before_id) } : {} },
+      deps
+    );
+    if (out3.entries.length === 0) {
+      return {
+        text: !out3.enabled && out3.next_before_id == null ? "\uC774 \uBC30\uD3EC\uC5D0\uB294 \uD06C\uB808\uB527 \uAE30\uB2A5\uC774 \uC5C6\uC5B4 \uC0AC\uC6A9 \uB0B4\uC5ED\uC774 \uC5C6\uC2B5\uB2C8\uB2E4(0\uAC74\uC774 \uC544\uB2C8\uB77C \uAC1C\uB150 \uBD80\uC7AC)." : "\uC0AC\uC6A9 \uB0B4\uC5ED\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."
+      };
+    }
+    const lines = ["\uD06C\uB808\uB527 \uC0AC\uC6A9 \uB0B4\uC5ED (\uCD5C\uC2E0\uC21C)", ""];
+    for (const e of out3.entries) {
+      const when = (e.created_at ?? "").slice(0, 16).replace("T", " ");
+      const parts = [e.display_name];
+      if (e.units_label) parts.push(e.units_label);
+      if (e.project_slug) parts.push(e.project_slug);
+      if (e.reason) parts.push(e.reason);
+      const sign = e.amount_krw > 0 ? "+" : "";
+      lines.push(
+        `${when} \xB7 ${parts.join(" \xB7 ")} \xB7 ${sign}${e.amount_krw.toLocaleString("ko-KR")}\uC6D0 (\uC794\uC561 ${e.balance_after_krw.toLocaleString("ko-KR")}\uC6D0)`
+      );
+    }
+    if (out3.next_before_id != null) {
+      lines.push("", `\uB354 \uC788\uC2B5\uB2C8\uB2E4 \u2014 before_id=${out3.next_before_id} \uB85C \uB2E4\uC2DC \uD638\uCD9C\uD558\uC138\uC694.`);
+    }
+    return { text: lines.join("\n") };
+  });
+}
+function projectLine(p) {
+  const parts = [p.slug ?? "?", p.title || "(\uC81C\uBAA9 \uC5C6\uC74C)"];
+  if (p.status) parts.push(p.status);
+  if (p.kind === "shorts") parts.push("shorts");
+  const updated = (p.updated_at ?? "").slice(0, 10);
+  if (updated) parts.push(updated);
+  return parts.join(" \xB7 ");
+}
+function listProjects(a = {}, deps = {}) {
+  return guarded2(READ_ONLY, async () => {
+    if (a.limit !== void 0 && !Number.isFinite(a.limit)) {
+      return { isError: true, text: `limit \uC740 \uC22B\uC790\uC5EC\uC57C \uD569\uB2C8\uB2E4: ${JSON.stringify(a.limit)}` };
+    }
+    const limit = Math.max(
+      1,
+      Math.min(Math.trunc(a.limit ?? PROJECTS_DEFAULT_LIMIT), PROJECTS_MAX_LIMIT)
+    );
+    const query = (a.query ?? "").trim().toLowerCase();
+    const base = resolveBaseUrl(deps.baseUrl);
+    const out3 = await list(base, deps);
+    const all = out3.projects ?? [];
+    const total = all.length;
+    const matched = query ? all.filter(
+      (p) => (p.slug ?? "").toLowerCase().includes(query) || (p.title ?? "").toLowerCase().includes(query)
+    ) : all.slice();
+    matched.sort((x, y) => (y.updated_at ?? "").localeCompare(x.updated_at ?? ""));
+    const shown = matched.slice(0, limit);
+    if (shown.length === 0) {
+      return {
+        text: query ? `'${query}' \uC640 \uC77C\uCE58\uD558\uB294 \uD504\uB85C\uC81D\uD2B8\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. (\uC774 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC5D0 \uD504\uB85C\uC81D\uD2B8 ${total}\uAC1C) query \uB97C \uBE7C\uACE0 \uB2E4\uC2DC \uD638\uCD9C\uD574 \uC804\uCCB4\uB97C \uBCF4\uC138\uC694.` : "\uC774 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC5D0\uB294 \uC544\uC9C1 \uD504\uB85C\uC81D\uD2B8\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uC0AC\uC6A9\uC790\uC5D0\uAC8C democut.ai \uC5D0\uC11C \uD504\uB85C\uC81D\uD2B8\uB97C \uD558\uB098 \uB9CC\uB4E0 \uB4A4 \uB2E4\uC2DC \uC694\uCCAD\uD574 \uB2EC\uB77C\uACE0 \uC54C\uB9AC\uC138\uC694 \u2014 \uB124\uAC00 \uC9C1\uC811 \uB9CC\uB4E4 \uC218\uB294 \uC5C6\uC2B5\uB2C8\uB2E4. \uC601\uC0C1 \uC0DD\uC131\uC740 \uADC0\uC18D\uC2DC\uD0AC \uD504\uB85C\uC81D\uD2B8\uAC00 \uC788\uC5B4\uC57C \uD569\uB2C8\uB2E4."
+      };
+    }
+    const lines = ["\uD504\uB85C\uC81D\uD2B8 (\uCD5C\uADFC \uC218\uC815\uC21C) \u2014 slug \xB7 \uC81C\uBAA9 \xB7 \uC0C1\uD0DC \xB7 \uC218\uC815\uC77C", ""];
+    for (const p of shown) lines.push(projectLine(p));
+    lines.push("");
+    if (matched.length > shown.length) {
+      lines.push(
+        `\uCD1D ${matched.length}\uAC1C \uC911 ${shown.length}\uAC1C\uB9CC \uD45C\uC2DC\uD588\uC2B5\uB2C8\uB2E4 \u2014 limit \uC744 \uC62C\uB9AC\uAC70\uB098 query \uB85C \uC881\uD788\uC138\uC694.`
+      );
+    }
+    lines.push(
+      "democut_generate_video \uC758 project_slug \uC5D0\uB294 \uC704 **slug**(\uB9E8 \uC55E \uAC12)\uB97C \uADF8\uB300\uB85C \uB123\uC73C\uC138\uC694. \uC5B4\uB290 \uAC83\uC5D0 \uADC0\uC18D\uC2DC\uD0AC\uC9C0 \uBD84\uBA85\uD558\uC9C0 \uC54A\uC73C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBB3C\uC73C\uC138\uC694."
+    );
+    return { text: lines.join("\n") };
+  });
+}
 
 // src/mcp/server.ts
 var RESOLUTIONS = ["480p", "720p", "1080p", "4k"];
@@ -16451,7 +16699,7 @@ var GENERATION_PARAMS = {
 var TOOLS = [
   {
     name: "democut_auth_status",
-    description: "DemoCut \uB85C\uADF8\uC778 \uC0C1\uD0DC\uC640 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\xB7\uC5ED\uD560\xB7\uD2F0\uC5B4\uB97C \uD655\uC778\uD55C\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. \uB2E4\uB978 \uB3C4\uAD6C\uAC00 '\uB85C\uADF8\uC778 \uD544\uC694' \uB85C \uC2E4\uD328\uD558\uBA74 \uC774\uAC78\uB85C \uC0C1\uD0DC\uB97C \uBA3C\uC800 \uD655\uC778\uD558\uB77C.",
+    description: "DemoCut \uB85C\uADF8\uC778 \uC0C1\uD0DC\uC640 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\xB7\uC5ED\uD560\xB7\uD2F0\uC5B4\uB97C \uD655\uC778\uD55C\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. \uB2E4\uB978 \uB3C4\uAD6C\uAC00 '\uAD8C\uD55C \uC5C6\uC74C' \uC73C\uB85C \uC2E4\uD328\uD558\uBA74 \uC774\uAC78\uB85C \uC0C1\uD0DC\uB97C \uBA3C\uC800 \uD655\uC778\uD558\uB77C.",
     inputSchema: { type: "object", properties: {}, additionalProperties: false }
   },
   {
@@ -16465,7 +16713,7 @@ var TOOLS = [
   },
   {
     name: "democut_generate_video",
-    description: "\uC601\uC0C1 \uC0DD\uC131\uC744 \uC81C\uCD9C\uD55C\uB2E4. **\uC2E4\uC81C\uB85C \uB3C8\uC774 \uB098\uAC04\uB2E4.** \uBA3C\uC800 democut_estimate_video_cost \uB85C \uAE08\uC561\uC744 \uD655\uC778\uD558\uACE0 \uC0AC\uC6A9\uC790 \uB3D9\uC758\uB97C \uBC1B\uC740 \uB4A4, \uADF8 \uAE08\uC561\uC744 confirmed_cost_usd \uC5D0 \uADF8\uB300\uB85C \uB123\uC5B4 \uD638\uCD9C\uD558\uB77C \u2014 \uC11C\uBC84\uAC00 \uB2E4\uC2DC \uACC4\uC0B0\uD574 \uB300\uC870\uD558\uACE0 \uC5B4\uAE0B\uB098\uBA74 \uAC70\uBD80\uD55C\uB2E4. \uC2E4\uD328\uD574\uB3C4 **\uB2E4\uC2DC \uC81C\uCD9C\uD558\uC9C0 \uB9C8\uB77C**: \uC7AC\uC81C\uCD9C\uC740 \uBCC4\uAC1C \uC0DD\uC131\uC774\uB77C \uB2E4\uC2DC \uACFC\uAE08\uB41C\uB2E4.",
+    description: "\uC601\uC0C1 \uC0DD\uC131\uC744 \uC81C\uCD9C\uD55C\uB2E4. **\uC2E4\uC81C\uB85C \uB3C8\uC774 \uB098\uAC04\uB2E4.** \uBA3C\uC800 democut_estimate_video_cost \uB85C \uAE08\uC561\uC744 \uD655\uC778\uD558\uACE0 \uC0AC\uC6A9\uC790 \uB3D9\uC758\uB97C \uBC1B\uC740 \uB4A4, \uADF8 \uAE08\uC561\uC744 confirmed_cost_usd \uC5D0 \uADF8\uB300\uB85C \uB123\uC5B4 \uD638\uCD9C\uD558\uB77C \u2014 \uC11C\uBC84\uAC00 \uB2E4\uC2DC \uACC4\uC0B0\uD574 \uB300\uC870\uD558\uACE0 \uC5B4\uAE0B\uB098\uBA74 \uAC70\uBD80\uD55C\uB2E4. \uC2E4\uD328\uD574\uB3C4 **\uB2E4\uC2DC \uC81C\uCD9C\uD558\uC9C0 \uB9C8\uB77C**: \uC7AC\uC81C\uCD9C\uC740 \uBCC4\uAC1C \uC0DD\uC131\uC774\uB77C \uB2E4\uC2DC \uACFC\uAE08\uB41C\uB2E4. \uC911\uBCF5 \uC81C\uCD9C \uBC29\uC5B4\uB294 \uC11C\uBC84 \uD504\uB85C\uC138\uC2A4 \uC548\uC5D0\uC11C\uB9CC \uB3D9\uC791\uD558\uBBC0\uB85C, \uAC19\uC740 \uC694\uCCAD\uC744 \uB3D9\uC2DC\uC5D0 \uB450 \uBC88 \uBCF4\uB0B4\uBA74 \uB450 \uAC74\uC774 \uC81C\uCD9C\uB420 \uC218 \uC788\uB2E4 \u2014 \uD55C \uBC88\uB9CC \uBCF4\uB0B4\uACE0 \uACB0\uACFC\uB97C \uC870\uD68C\uD558\uB77C.",
     inputSchema: {
       type: "object",
       properties: {
@@ -16483,25 +16731,66 @@ var TOOLS = [
         },
         generate_audio: { type: "boolean", description: "\uC624\uB514\uC624 \uD568\uAED8 \uC0DD\uC131. \uAE30\uBCF8 false." },
         watermark: { type: "boolean", description: "\uC6CC\uD130\uB9C8\uD06C. \uAE30\uBCF8 false." },
-        project_slug: { type: "string", description: "\uBE44\uC6A9\uC744 \uC774 \uD504\uB85C\uC81D\uD2B8\uB85C \uADC0\uC18D(\uC120\uD0DD)." }
+        project_slug: {
+          type: "string",
+          description: "\uBE44\uC6A9\uC774 \uADC0\uC18D\uB420 \uD504\uB85C\uC81D\uD2B8 \uC2AC\uB7EC\uADF8 \u2014 **\uD544\uC218**. \uBCF8\uC778 \uC18C\uC720\uAC00 \uC544\uB2C8\uBA74 404. \uC601\uC0C1 \uC0DD\uC131\uC740 \uACFC\uAE08 \uB300\uC0C1\uC774\uB77C \uADC0\uC18D \uC5C6\uB294 \uC9C0\uCD9C\uC740 \uB300\uC870\xB7\uC815\uC0B0\uC774 \uBD88\uAC00\uB2A5\uD558\uB2E4. \uC2AC\uB7EC\uADF8\uB97C \uBAA8\uB974\uBA74 democut_list_projects \uB85C \uBA3C\uC800 \uD655\uC778\uD558\uB77C \u2014 \uCD94\uCE21\uD558\uC9C0 \uB9C8\uB77C."
+        }
       },
-      required: ["prompt", "confirmed_cost_usd"],
+      required: ["prompt", "confirmed_cost_usd", "project_slug"],
       additionalProperties: false
     }
   },
   {
     name: "democut_get_video_status",
-    description: "\uC0DD\uC131 \uC791\uC5C5 \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uACE0, \uC644\uB8CC\uB410\uC73C\uBA74 \uC0B0\uCD9C\uBB3C\uC744 \uB0B4\uB824\uBC1B\uB294\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. \uC0B0\uCD9C\uBB3C URL \uC740 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB418\uBBC0\uB85C \uC644\uB8CC \uC989\uC2DC output_path \uB85C \uC800\uC7A5\uD558\uB77C.",
+    description: "\uC0DD\uC131 \uC791\uC5C5 \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uACE0, \uC644\uB8CC\uB410\uC73C\uBA74 \uC0B0\uCD9C\uBB3C\uC744 \uB0B4\uB824\uBC1B\uB294\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. \uC11C\uBC84\uB294 \uC0B0\uCD9C\uBB3C\uC744 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC73C\uBBC0\uB85C \uC644\uB8CC \uC989\uC2DC output_path \uB85C \uC800\uC7A5\uD558\uB77C.",
     inputSchema: {
       type: "object",
       properties: {
         job_id: { type: "string", description: "democut_generate_video \uAC00 \uB3CC\uB824\uC900 job_id." },
         output_path: { type: "string", description: "\uC800\uC7A5\uD560 \uB85C\uCEEC \uACBD\uB85C(\uC808\uB300\uACBD\uB85C \uAD8C\uC7A5)." },
-        project_slug: { type: "string", description: "\uBE44\uC6A9 \uADC0\uC18D \uD504\uB85C\uC81D\uD2B8(\uC81C\uCD9C \uB54C\uC640 \uAC19\uAC8C)." }
+        project_slug: {
+          type: "string",
+          description: "(\uBB34\uC2DC\uB428) \uADC0\uC18D\uC740 \uC81C\uCD9C \uC2DC\uC810 \uAC12\uC73C\uB85C \uC11C\uBC84\uAC00 \uACB0\uC815\uD55C\uB2E4."
+        }
       },
       required: ["job_id"],
       additionalProperties: false
     }
+  },
+  {
+    name: "democut_credit_balance",
+    description: "DemoCut \uD06C\uB808\uB527 \uC794\uC561\uC744 \uD655\uC778\uD55C\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. \uB3C8\uC774 \uB098\uAC00\uB294 \uC791\uC5C5(democut_generate_video)\uC744 \uC81C\uCD9C\uD558\uAE30 **\uC804\uC5D0** \uD638\uCD9C\uD574 \uC794\uC561\uC774 \uCDA9\uBD84\uD55C\uC9C0 \uBCF4\uB77C \u2014 \uBD80\uC871\uD558\uBA74 \uC81C\uCD9C\uC774 402 \uB85C \uAC70\uBD80\uB418\uACE0, \uADF8\uAC83\uC744 \uBBF8\uB9AC \uC544\uB294 \uD3B8\uC774 \uB0AB\uB2E4. \uC794\uC561\uC774 \uBAA8\uC790\uB77C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC54C\uB9AC\uACE0 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uAD00\uB9AC\uC790\uC5D0\uAC8C \uCDA9\uC804\uC744 \uC694\uCCAD\uD558\uB3C4\uB85D \uC548\uB0B4\uD558\uB77C. \uB124\uAC00 \uC9C1\uC811 \uCDA9\uC804\uD560 \uC218\uB294 \uC5C6\uB2E4.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false }
+  },
+  {
+    name: "democut_credit_ledger",
+    description: '\uD06C\uB808\uB527 \uC0AC\uC6A9 \uB0B4\uC5ED\uC744 \uCD5C\uC2E0\uC21C\uC73C\uB85C \uD655\uC778\uD55C\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. "\uC65C \uC794\uC561\uC774 \uC774\uB9CC\uD07C \uC904\uC5C8\uB098" \uB97C \uB2F5\uD560 \uB54C \uC4F4\uB2E4 \u2014 \uAC01 \uD589\uC740 \uBB34\uC5C7\uC5D0\xB7\uC5B8\uC81C\xB7\uC5BC\uB9C8\uC640, \uAC00\uB2A5\uD558\uBA74 \uC0AC\uC6A9\uB7C9(\uC608: 40,594 tokens)\uAE4C\uC9C0 \uB9D0\uD55C\uB2E4.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: { type: "number", description: "\uAC00\uC838\uC62C \uAC74\uC218 1~200. \uAE30\uBCF8 10." },
+        before_id: {
+          type: "number",
+          description: "\uC774\uC804 \uD638\uCD9C\uC774 \uB3CC\uB824\uC900 next_before_id. \uB2E4\uC74C \uD398\uC774\uC9C0\uB97C \uBCFC \uB54C\uB9CC \uB123\uC5B4\uB77C."
+        }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: "democut_list_projects",
+    description: "\uC774 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC758 \uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D\uC744 \uCD5C\uADFC \uC218\uC815\uC21C\uC73C\uB85C \uD655\uC778\uD55C\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. democut_generate_video \uC758 project_slug \uB294 **\uC2E4\uC7AC\uD558\uB294 \uBCF8\uC778 \uD504\uB85C\uC81D\uD2B8\uC5EC\uC57C** \uD558\uACE0 \uD2C0\uB9AC\uBA74 404 \uB2E4 \u2014 \uC2AC\uB7EC\uADF8\uB97C \uBAA8\uB974\uBA74 \uCD94\uCE21\uD558\uC9C0 \uB9D0\uACE0 \uC774\uAC78\uB85C \uBA3C\uC800 \uD655\uC778\uD558\uB77C. \uBAA9\uB85D\uC774 \uBE44\uC5B4 \uC788\uC73C\uBA74 \uC544\uC9C1 \uD504\uB85C\uC81D\uD2B8\uAC00 \uC5C6\uB2E4\uB294 \uB73B\uC774\uB2C8, \uC0AC\uC6A9\uC790\uC5D0\uAC8C democut.ai \uC5D0\uC11C \uD558\uB098 \uB9CC\uB4E0 \uB4A4 \uB2E4\uC2DC \uC694\uCCAD\uD574 \uB2EC\uB77C\uACE0 \uC54C\uB824\uB77C(\uB124\uAC00 \uC9C1\uC811 \uB9CC\uB4E4 \uC218\uB294 \uC5C6\uB2E4).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: { type: "number", description: "\uAC00\uC838\uC62C \uAC74\uC218 1~100. \uAE30\uBCF8 30." },
+        query: {
+          type: "string",
+          description: "\uC2AC\uB7EC\uADF8\xB7\uC81C\uBAA9\uC5D0 \uC774 \uBB38\uC790\uC5F4\uC774 \uB4E0 \uAC83\uB9CC (\uB300\uC18C\uBB38\uC790 \uBB34\uC2DC). \uCC3E\uB294 \uD504\uB85C\uC81D\uD2B8 \uC774\uB984\uC744 \uC54C \uB54C\uB9CC \uC4F0\uB77C \u2014 \uBE44\uC6B0\uBA74 \uCD5C\uADFC \uC218\uC815\uC21C \uC804\uCCB4\uB2E4."
+        }
+      },
+      additionalProperties: false
+    }
   }
 ];
 function dispatch(name, args, deps = {}) {
@@ -16514,6 +16803,12 @@ function dispatch(name, args, deps = {}) {
       return generateVideo(args, deps);
     case "democut_get_video_status":
       return videoStatus(args, deps);
+    case "democut_credit_balance":
+      return creditBalance(deps);
+    case "democut_credit_ledger":
+      return creditLedger(args, deps);
+    case "democut_list_projects":
+      return listProjects(args, deps);
     default:
       return Promise.resolve({ isError: true, text: `\uC54C \uC218 \uC5C6\uB294 \uB3C4\uAD6C: ${name}` });
   }
@@ -16549,11 +16844,11 @@ var HELP = `democut \u2014 DemoCut \uC5D0\uC774\uC804\uD2B8 CLI (OAuth2 device f
   democut auth logout [--base-url <url>]
 
   democut video estimate [--duration <\uCD08>] [--resolution <\uD574\uC0C1\uB3C4>] [--ratio <\uBE44\uC728>] [--model <id>]
-  democut video generate "<\uD504\uB86C\uD504\uD2B8>" [--yes] [--wait] [--output <\uACBD\uB85C>] [\uC0DD\uC131 \uC635\uC158\u2026]
-  democut video status <job_id> [--wait] [--output <\uACBD\uB85C>] [--project <slug>]
+  democut video generate "<\uD504\uB86C\uD504\uD2B8>" --project <slug> [--yes] [--wait] [--output <\uACBD\uB85C>] [\uC0DD\uC131 \uC635\uC158\u2026]
+  democut video status <job_id> [--wait] [--output <\uACBD\uB85C>]
 
   democut mcp                                  MCP \uC11C\uBC84(stdio) \u2014 \uC5D0\uC774\uC804\uD2B8\uC5D0 \uB3C4\uAD6C\uB85C \uBD99\uC778\uB2E4
-                                               \uB4F1\uB85D: claude mcp add democut -- democut mcp
+                                               \uB4F1\uB85D: claude mcp add democut -- npx -y democut mcp
 
 \uC0DD\uC131 \uC635\uC158:
   --duration <\uCD08>     \uAE30\uBCF8 5 (\uBAA8\uB378\uBCC4 \uD5C8\uC6A9 \uBC94\uC704 \uB2E4\uB984: 2.0=4~15, 2.5=4~30)
@@ -16564,13 +16859,13 @@ var HELP = `democut \u2014 DemoCut \uC5D0\uC774\uC804\uD2B8 CLI (OAuth2 device f
   --image-url <url>   image\u2192video \uCC38\uC870 (\uACF5\uAC1C HTTPS URL, \uCD5C\uB300 4\uD68C \uBC18\uBCF5)
   --audio             \uC624\uB514\uC624 \uD568\uAED8 \uC0DD\uC131
   --watermark         \uC6CC\uD130\uB9C8\uD06C \uB123\uAE30
-  --project <slug>    \uBE44\uC6A9\uC744 \uC774 \uD504\uB85C\uC81D\uD2B8\uB85C \uADC0\uC18D
+  --project <slug>    \uBE44\uC6A9\uC744 \uC774 \uD504\uB85C\uC81D\uD2B8\uB85C \uADC0\uC18D (generate \uD544\uC218 \u2014 \uBCF8\uC778 \uC18C\uC720 \uC2AC\uB7EC\uADF8)
 
 \uACF5\uD1B5 \uC635\uC158:
   -y, --yes           \uBE44\uC6A9 \uD655\uC778 \uC5C6\uC774 \uC9C4\uD589 (\uBE44\uB300\uD654\uD615\uC5D0\uC11C\uB294 \uD544\uC218)
       --wait          \uC644\uB8CC\uAE4C\uC9C0 \uAE30\uB2E4\uB9BC
       --timeout <\uCD08>  --wait \uC2DC\uD55C (\uAE30\uBCF8 900)
-  -o, --output <\uACBD\uB85C> \uC0B0\uCD9C\uBB3C \uC800\uC7A5 (\uC11C\uBA85 URL \uC740 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC \u2014 \uBC1B\uC544 \uB450\uC138\uC694)
+  -o, --output <\uACBD\uB85C> \uC0B0\uCD9C\uBB3C \uC800\uC7A5 (\uC11C\uBC84\uB294 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2014 \uBC1B\uC544 \uB450\uC138\uC694)
       --json          \uAE30\uACC4 \uD310\uB3C5\uC6A9 JSON \uD55C \uC904
       --base-url <u>  DemoCut \uC11C\uBC84 URL (\uAE30\uBCF8: $DEMOCUT_BASE_URL \uB610\uB294 prod)
   -h, --help          \uB3C4\uC6C0\uB9D0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "democut",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "DemoCut 에이전트 CLI — device flow 로그인(RFC 8628) + 영상 생성",
   "license": "MIT",
   "author": "InfoGrab",