democut 1.0.76 → 1.0.77

package/dist/cli.js

@@ -6916,7 +6916,7 @@ import { realpathSync } from "fs";
 import { fileURLToPath } from "url";
 
 // src/version.ts
-var VERSION = "1.0.76";
+var VERSION = "1.0.77";
 
 // src/device-flow.ts
 var DeviceFlowError = class extends Error {
@@ -9144,7 +9144,7 @@ var GENERATED_TOOLS = [
   },
   {
     "name": "democut_credit_ledger",
-    "description": "\uD06C\uB808\uB527 \uC0AC\uC6A9 \uB0B4\uC5ED(\uCD5C\uC2E0\uC21C, keyset). \u300C\uC65C \uC794\uC561\uC774 \uC774\uB9CC\uD07C \uC904\uC5C8\uB098\u300D \uB97C \uB2F5\uD560 \uB54C \uC4F4\uB2E4 \u2014 \uD589\uB9C8\uB2E4 \uBB34\uC5C7\uC5D0\xB7\uC5B8\uC81C\xB7\uC5BC\uB9C8\uC778\uC9C0\uAC00 \uC788\uB2E4.",
+    "description": "\uD06C\uB808\uB527 \uC0AC\uC6A9 \uB0B4\uC5ED(\uCD5C\uC2E0\uC21C, keyset). \u300C\uC65C \uC794\uC561\uC774 \uC774\uB9CC\uD07C \uC904\uC5C8\uB098\u300D \uB97C \uB2F5\uD560 \uB54C \uC4F4\uB2E4 \u2014 \uD589\uB9C8\uB2E4 \uBB34\uC5C7\uC5D0\xB7\uC5B8\uC81C\xB7\uC5BC\uB9C8\uC778\uC9C0\uAC00 \uC788\uB2E4. project(slug)\xB7category(democut_credit_summary \uC758 categories[].key)\uB85C \uAC70\uB97C \uC218 \uC788\uB2E4.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -9164,6 +9164,41 @@ var GENERATED_TOOLS = [
           "maximum": 200,
           "minimum": 1,
           "type": "integer"
+        },
+        "project": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "\uC774 \uD504\uB85C\uC81D\uD2B8(slug)\uC758 \uD589\uB9CC"
+        },
+        "category": {
+          "anyOf": [
+            {
+              "enum": [
+                "ai_video",
+                "ai_image",
+                "avatar",
+                "voice",
+                "subtitle",
+                "motion",
+                "agent",
+                "publish",
+                "other"
+              ],
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "\uC774 \uC0AC\uC6A9 \uD56D\uBAA9 \uBB36\uC74C\uC758 \uD589\uB9CC(democut_credit_summary \uC758 categories[].key)"
         }
       },
       "required": [],
@@ -9191,6 +9226,110 @@ var GENERATED_TOOLS = [
       "openWorldHint": false
     }
   },
+  {
+    "name": "democut_credit_summary",
+    "description": "\uD06C\uB808\uB527 \uC0AC\uC6A9 \uD1B5\uACC4(0\uC6D0, \uBD80\uC791\uC6A9 \uC5C6\uC74C). \u300C\uC774\uBC88 \uB2EC \uC5BC\uB9C8 \uC37C\uB098\xB7\uBB34\uC5C7\uC5D0\xB7\uC5B4\uB290 \uD504\uB85C\uC81D\uD2B8\uC5D0\xB7\uC5B8\uC81C \uBC14\uB2E5\uB098\uB098\u300D \uB97C \uB2F5\uD560 \uB54C \uC4F4\uB2E4 \u2014 \uC21C\uC0AC\uC6A9\uC561(\uC0AC\uC6A9 \u2212 \uD658\uBD88), \uBE44\uAD50 \uAE30\uAC04, \uCD5C\uADFC 14\uC77C \uD3C9\uADE0\uACFC \uC18C\uC9C4 \uC608\uC0C1 \uC77C\uC218, \uC77C\uBCC4\xB7\uD56D\uBAA9\uBCC4\xB7\uD504\uB85C\uC81D\uD2B8\uBCC4 \uD569\uACC4. range: current(\uC774\uBC88 \uB2EC, \uAE30\uBCF8)\xB7previous(\uC9C0\uB09C\uB2EC)\xB730d. \uB0A0\uC9DC\uB294 \uD55C\uAD6D \uC2DC\uAC04\uC774\uB2E4. \uB204\uAC00 \uC37C\uB294\uC9C0\uB294 \uB2F5\uD558\uC9C0 \uBABB\uD55C\uB2E4.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "range": {
+          "default": "current",
+          "description": "current = \uC774\uBC88 \uB2EC 1\uC77C\uBD80\uD130 \uC624\uB298, previous = \uC9C0\uB09C\uB2EC \uC804\uCCB4, 30d = \uC624\uB298\uAE4C\uC9C0 30\uC77C(\uB0A0\uC9DC\uB294 \uD55C\uAD6D \uC2DC\uAC04)",
+          "enum": [
+            "current",
+            "previous",
+            "30d"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [],
+      "additionalProperties": false
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "range": {
+          "type": "string"
+        },
+        "start_date": {
+          "type": "string"
+        },
+        "end_date": {
+          "type": "string"
+        },
+        "net_spent_krw": {
+          "type": "integer"
+        },
+        "spent_krw": {
+          "type": "integer"
+        },
+        "refunded_krw": {
+          "type": "integer"
+        },
+        "granted_krw": {
+          "type": "integer"
+        },
+        "compare_start_date": {
+          "type": "string"
+        },
+        "compare_end_date": {
+          "type": "string"
+        },
+        "compare_net_spent_krw": {
+          "type": "integer"
+        },
+        "balance_krw": {
+          "type": "integer"
+        },
+        "avg_daily_krw": {
+          "type": "integer"
+        },
+        "runway_days": {},
+        "daily": {
+          "type": "array"
+        },
+        "categories": {
+          "type": "array"
+        },
+        "projects": {
+          "type": "array"
+        },
+        "projects_other_krw": {
+          "type": "integer"
+        },
+        "unassigned_krw": {
+          "type": "integer"
+        }
+      },
+      "required": [
+        "range",
+        "start_date",
+        "end_date",
+        "net_spent_krw",
+        "spent_krw",
+        "refunded_krw",
+        "granted_krw",
+        "compare_start_date",
+        "compare_end_date",
+        "compare_net_spent_krw",
+        "balance_krw",
+        "avg_daily_krw",
+        "daily",
+        "categories",
+        "projects"
+      ]
+    },
+    "annotations": {
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
   {
     "name": "democut_list_characters",
     "description": "\uC544\uBC14\uD0C0 \uBAA9\uB85D.",
@@ -12597,6 +12736,12 @@ var TOOL_META = {
     "method": "GET",
     "path": "/api/workspaces/{workspace_id}/credits/ledger"
   },
+  "democut_credit_summary": {
+    "cost": "none",
+    "group": "credits",
+    "method": "GET",
+    "path": "/api/workspaces/{workspace_id}/credits/summary"
+  },
   "democut_list_characters": {
     "cost": "none",
     "group": "character",
@@ -12938,7 +13083,16 @@ function classifyApiError(e, ctx) {
       );
     }
     return {
-      safety: e.status >= 500 && ctx.submitted ? "unsafe" : e.retriable === false ? "fixable" : "safe",
+      // ★★ **재과금 안전성과 재시도 유효성은 다른 축이다**(GitLab #43). 서버의 `retry_safe` 는
+      //    「다시 보내도 **두 번 청구되지 않는다**」 는 뜻이지 「그대로 다시 하면 **된다**」 가 아니다.
+      //    그 둘을 섞어 쓰던 동안 없는 프로젝트(404·`retry_safe=True`)가 TRANSIENT(3)로 나갔고,
+      //    에이전트는 같은 슬러그로 재시도해 같은 404 를 다시 받았다. 슬러그를 고쳐야 하는 오류다.
+      //    그래서 **상태로 가른다** — 4xx 는 요청 문제라 FIXABLE, 5xx 만 TRANSIENT 다.
+      //    (`api-client.ts` 도 `retriable` 을 「사람에게 보여줄 정보이지 자동 행동의 근거가 아니다」
+      //     라고 적어 둔다. 과금 축은 아래 `notCharged` 가 그대로 든다.)
+      // ⚠️ 429·408 이 생기면 그때는 「기다렸다 그대로」 가 맞으므로 여기 예외를 더한다 —
+      //    지금 계약(`contracts/error_codes.py`)에는 둘 다 없다.
+      safety: e.status >= 500 ? ctx.submitted ? "unsafe" : "safe" : "fixable",
       notCharged: e.status < 500,
       lines
     };
@@ -13295,6 +13449,8 @@ function ledger(baseUrl, workspaceId, opts = {}, deps = {}) {
   const q = new URLSearchParams();
   q.set("limit", String(opts.limit ?? LEDGER_DEFAULT_LIMIT));
   if (opts.cursor !== void 0) q.set("cursor", opts.cursor);
+  if (opts.project) q.set("project", opts.project);
+  if (opts.category) q.set("category", opts.category);
   return apiRequest(
     baseUrl,
     `/api/workspaces/${encodeURIComponent(workspaceId)}/credits/ledger?${q}`,
@@ -13302,6 +13458,14 @@ function ledger(baseUrl, workspaceId, opts = {}, deps = {}) {
     deps
   );
 }
+function summary(baseUrl, workspaceId, range, deps = {}) {
+  return apiRequest(
+    baseUrl,
+    `/api/workspaces/${encodeURIComponent(workspaceId)}/credits/summary?range=${range}`,
+    {},
+    deps
+  );
+}
 
 // src/projects.ts
 var PROJECTS_DEFAULT_LIMIT = 30;
@@ -13486,7 +13650,12 @@ function creditLedger(a = {}, deps = {}) {
     const out4 = await ledger(
       base,
       ws,
-      { limit, ...pageNum !== void 0 ? { cursor: String(pageNum) } : {} },
+      {
+        limit,
+        ...pageNum !== void 0 ? { cursor: String(pageNum) } : {},
+        ...typeof a.project === "string" && a.project ? { project: a.project } : {},
+        ...typeof a.category === "string" && a.category ? { category: a.category } : {}
+      },
       deps
     );
     if (out4.entries.length === 0) {
@@ -13500,7 +13669,7 @@ function creditLedger(a = {}, deps = {}) {
       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.project_slug) parts.push(e.project_title ? `${e.project_title} (${e.project_slug})` : e.project_slug);
       if (e.reason) parts.push(e.reason);
       const sign = e.amount_krw > 0 ? "+" : "";
       lines.push(
@@ -13514,6 +13683,38 @@ function creditLedger(a = {}, deps = {}) {
     return { text: lines.join("\n"), structured: callableStructured(out4) };
   });
 }
+var SUMMARY_RANGES = ["current", "previous", "30d"];
+var RANGE_LABEL = {
+  current: "\uC774\uBC88 \uB2EC",
+  previous: "\uC9C0\uB09C\uB2EC",
+  "30d": "\uCD5C\uADFC 30\uC77C"
+};
+function creditSummary(a = {}, deps = {}) {
+  return guarded(READ_ONLY, async () => {
+    const range = a.range ?? "current";
+    if (!SUMMARY_RANGES.includes(range)) {
+      return { isError: true, text: `range \uB294 ${SUMMARY_RANGES.join(", ")} \uC911 \uD558\uB098\uC785\uB2C8\uB2E4: ${JSON.stringify(range)}` };
+    }
+    const r = range;
+    const base = resolveBaseUrl(deps.baseUrl);
+    const ws = await resolveWorkspace(base, deps);
+    if (!ws) return NO_WORKSPACE;
+    const out4 = await summary(base, ws, r, deps);
+    const lines = [
+      `${RANGE_LABEL[r]}(${out4.start_date} ~ ${out4.end_date}) \uC21C\uC0AC\uC6A9 ${krw(out4.net_spent_krw)} (\uC0AC\uC6A9 ${krw(out4.spent_krw)} \xB7 \uD658\uBD88 ${krw(out4.refunded_krw)})`,
+      `\uBE44\uAD50 \uAE30\uAC04(${out4.compare_start_date} ~ ${out4.compare_end_date}) ${krw(out4.compare_net_spent_krw)}`,
+      `\uC794\uC561 ${krw(out4.balance_krw)} \xB7 \uCD5C\uADFC 14\uC77C \uD558\uB8E8 \uD3C9\uADE0 ${krw(out4.avg_daily_krw)}` + (out4.runway_days != null ? ` \xB7 \uC774 \uC18D\uB3C4\uBA74 \uC57D ${out4.runway_days}\uC77C \uB4A4 \uBC14\uB2E5` : "")
+    ];
+    if (out4.categories.length) {
+      lines.push("", "\uD56D\uBAA9\uBCC4: " + out4.categories.map((c) => `${c.label} ${krw(c.net_spent_krw)}`).join(" \xB7 "));
+    }
+    if (out4.projects.length) {
+      lines.push("\uD504\uB85C\uC81D\uD2B8\uBCC4(\uC0C1\uC704): " + out4.projects.map((p) => `${p.title ?? p.slug} ${krw(p.net_spent_krw)}`).join(" \xB7 "));
+    }
+    lines.push("", "\uD589 \uB2E8\uC704\uB85C \uBCF4\uB824\uBA74 credit_ledger \uC5D0 project\xB7category \uB85C \uAC70\uB974\uC138\uC694.");
+    return { text: lines.join("\n"), structured: callableStructured(out4) };
+  });
+}
 function projectLine(p) {
   const parts = [p.slug, p.title || "(\uC81C\uBAA9 \uC5C6\uC74C)", `\uCEF7 ${p.cut_count ?? 0}\uAC1C`];
   const updated = (p.updated_at ?? "").slice(0, 10);
@@ -15475,6 +15676,8 @@ function dispatch(name, args, deps = {}) {
       return creditBalance(deps);
     case "democut_credit_ledger":
       return creditLedger(args, deps);
+    case "democut_credit_summary":
+      return creditSummary(args, deps);
     case "democut_list_projects":
       return listProjects(args, deps);
     case "democut_get_project":
@@ -15839,8 +16042,10 @@ function exitForSafety(safety) {
       return EXIT.TRANSIENT;
     case "unsafe":
       return EXIT.UPSTREAM_REJECTED;
-    default:
+    case "unknown":
       return EXIT.GENERAL;
+    default:
+      return EXIT.FIXABLE;
   }
 }
 function emit(result, json) {

package/package.json

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