democut 1.0.171 → 1.0.173

package/dist/cli.js

@@ -6916,7 +6916,7 @@ import { realpathSync } from "fs";
 import { fileURLToPath } from "url";
 
 // src/version.ts
-var VERSION = "1.0.171";
+var VERSION = "1.0.173";
 
 // src/device-flow.ts
 var DeviceFlowError = class extends Error {
@@ -11554,7 +11554,7 @@ var GENERATED_TOOLS = [
   },
   {
     "name": "democut_estimate_music",
-    "description": "AI \uBC30\uACBD\uC74C\uC545 \uACAC\uC801(0\uC6D0). 5\uBD84 \uC0C1\uD55C\uC774\uACE0 \uC2E4\uC81C \uAE38\uC774\uB85C \uCC28\uC561\uC744 \uB3CC\uB824\uC900\uB2E4.",
+    "description": "AI \uBC30\uACBD\uC74C\uC545 \uACAC\uC801(0\uC6D0). prompt \uB9CC\uC774\uBA74 5\uBD84 \uC0C1\uD55C, length_s\xB7plan \uC774\uBA74 \uADF8 \uAE38\uC774. \uC2E4\uCE21\uC73C\uB85C \uC815\uC0B0\uD55C\uB2E4.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -11566,8 +11566,43 @@ var GENERATED_TOOLS = [
         },
         "instrumental": {
           "default": true,
-          "description": "\uBCF4\uCEEC \uC5C6\uB294 \uC5F0\uC8FC\uACE1",
+          "description": "\uC5F0\uC8FC\uACE1(prompt \uC77C \uB54C)",
           "type": "boolean"
+        },
+        "length_s": {
+          "anyOf": [
+            {
+              "maximum": 300,
+              "minimum": 3,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "\uCD08(prompt \uC77C \uB54C). \uBE44\uC6B0\uBA74 \uBAA8\uB378\uC774 \uC815\uD55C\uB2E4"
+        },
+        "plan": {
+          "default": null,
+          "type": [
+            "object",
+            "null"
+          ],
+          "description": "prompt \uB300\uC2E0 \uAD6C\uC131\uD45C(democut_plan_music \uAF34) \u2014 \uBAA8\uB378 MusicPlan \u2014 \uBAA8\uC591\uC740 \uC790\uC6D0 democut://guide \uC640 democut_get_options \uAC00 \uB9D0\uD55C\uB2E4(\uC5EC\uAE30\uC11C\uB294 \uC81C\uC57D\uC744 \uAC78\uC9C0 \uC54A\uB294\uB2E4)"
+        },
+        "source_asset_id": {
+          "anyOf": [
+            {
+              "maxLength": 64,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "\uC6D0\uACE1 \u2014 plan \uC758 keep\xB7reference \uAC00 \uAC00\uB9AC\uD0A8\uB2E4"
         }
       },
       "required": [],
@@ -11621,7 +11656,7 @@ var GENERATED_TOOLS = [
   },
   {
     "name": "democut_make_music",
-    "description": "\uACE1\uC744 \uB9CC\uB4E0\uB2E4(\uCCAD\uAD6C\xB7\uC0C1\uD55C). \uACB0\uACFC\uC758 asset_id \uB97C democut_set_cut_bgm \uC5D0 \uC4F4\uB2E4. \uB3C8\uC774 \uB098\uAC00\uB294 \uB3C4\uAD6C\uB2E4 \u2014 \uC9DD\uC774 \uB418\uB294 estimate \uB3C4\uAD6C\uC758 \uAE08\uC561\uC5D0 \uC0AC\uC6A9\uC790\uAC00 \uB3D9\uC758\uD55C \uB4A4 confirmed_*_krw\xB7rate_version \uC744 \uADF8\uB300\uB85C \uB123\uC5B4\uB77C. \uC2E4\uD328\uD574\uB3C4 \uC7AC\uC81C\uCD9C\uD558\uC9C0 \uB9C8\uB77C(\uAC19\uC740 spec \uC774 \uD65C\uC131\uC774\uBA74 \uAE30\uC874 \uC7A1\uC744 \uB3CC\uB824\uC900\uB2E4 \u2014 deduplicated=true). \uB2E4\uC74C \uD638\uCD9C: democut_wait_jobs.",
+    "description": "\uACE1\uC744 \uB9CC\uB4E0\uB2E4(\uCCAD\uAD6C). \uBCC0\uD615\xB7\uAC00\uC0AC \uACE0\uCE58\uAE30\uB294 source_asset_id + plan(\uACE0\uCE60 \uAD6C\uAC04\uB9CC new). \uACB0\uACFC asset_id \uB97C democut_set_cut_bgm \uC5D0. \uB3C8\uC774 \uB098\uAC00\uB294 \uB3C4\uAD6C\uB2E4 \u2014 \uC9DD\uC774 \uB418\uB294 estimate \uB3C4\uAD6C\uC758 \uAE08\uC561\uC5D0 \uC0AC\uC6A9\uC790\uAC00 \uB3D9\uC758\uD55C \uB4A4 confirmed_*_krw\xB7rate_version \uC744 \uADF8\uB300\uB85C \uB123\uC5B4\uB77C. \uC2E4\uD328\uD574\uB3C4 \uC7AC\uC81C\uCD9C\uD558\uC9C0 \uB9C8\uB77C(\uAC19\uC740 spec \uC774 \uD65C\uC131\uC774\uBA74 \uAE30\uC874 \uC7A1\uC744 \uB3CC\uB824\uC900\uB2E4 \u2014 deduplicated=true). \uB2E4\uC74C \uD638\uCD9C: democut_wait_jobs.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -11633,9 +11668,44 @@ var GENERATED_TOOLS = [
         },
         "instrumental": {
           "default": true,
-          "description": "\uBCF4\uCEEC \uC5C6\uB294 \uC5F0\uC8FC\uACE1",
+          "description": "\uC5F0\uC8FC\uACE1(prompt \uC77C \uB54C)",
           "type": "boolean"
         },
+        "length_s": {
+          "anyOf": [
+            {
+              "maximum": 300,
+              "minimum": 3,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "\uCD08(prompt \uC77C \uB54C). \uBE44\uC6B0\uBA74 \uBAA8\uB378\uC774 \uC815\uD55C\uB2E4"
+        },
+        "plan": {
+          "default": null,
+          "type": [
+            "object",
+            "null"
+          ],
+          "description": "prompt \uB300\uC2E0 \uAD6C\uC131\uD45C(democut_plan_music \uAF34) \u2014 \uBAA8\uB378 MusicPlan \u2014 \uBAA8\uC591\uC740 \uC790\uC6D0 democut://guide \uC640 democut_get_options \uAC00 \uB9D0\uD55C\uB2E4(\uC5EC\uAE30\uC11C\uB294 \uC81C\uC57D\uC744 \uAC78\uC9C0 \uC54A\uB294\uB2E4)"
+        },
+        "source_asset_id": {
+          "anyOf": [
+            {
+              "maxLength": 64,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "\uC6D0\uACE1 \u2014 plan \uC758 keep\xB7reference \uAC00 \uAC00\uB9AC\uD0A8\uB2E4"
+        },
         "title": {
           "default": "",
           "maxLength": 100,
@@ -11690,6 +11760,72 @@ var GENERATED_TOOLS = [
       "openWorldHint": false
     }
   },
+  {
+    "name": "democut_plan_music",
+    "description": "\uACE1 \uAD6C\uC131\uD45C(0\uC6D0). prompt \uB85C \uAD6C\uAC04\xB7\uAC00\uC0AC \uCD08\uC548, source_asset_id \uB85C \uADF8 \uACE1\uC758 \uAD6C\uAC04(keep \uAF34)\uC744 \uC900\uB2E4. \uACE0\uCCD0 plan \uC5D0 \uC2E3\uB294\uB2E4. \uB2E4\uC74C \uD638\uCD9C: democut_estimate_music.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "prompt": {
+          "default": "",
+          "description": "\uCD08\uC548\uC744 \uC9E4 \uC124\uBA85",
+          "maxLength": 2e3,
+          "type": "string"
+        },
+        "length_s": {
+          "anyOf": [
+            {
+              "maximum": 300,
+              "minimum": 3,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "\uCD08"
+        },
+        "source_asset_id": {
+          "anyOf": [
+            {
+              "maxLength": 64,
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "\uC774 \uACE1\uC758 \uAD6C\uC131\uC744 \uC77D\uB294\uB2E4"
+        }
+      },
+      "required": [],
+      "additionalProperties": false
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "plan": {},
+        "sections": {
+          "type": "array"
+        },
+        "total_ms": {
+          "type": "integer"
+        },
+        "source_asset_id": {}
+      },
+      "required": [
+        "plan"
+      ]
+    },
+    "annotations": {
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": false
+    }
+  },
   {
     "name": "democut_reorder_cuts",
     "description": "\uC5F0\uACB0 \uC21C\uC11C\uB97C \uD1B5\uC9F8\uB85C \uB2E4\uC2DC \uC4F4\uB2E4(If-Match rev). \uBE60\uC9C4 \uCEF7\uC740 \uB5BC\uC5B4 \uB454 \uCEF7\uC774 \uB41C\uB2E4. \uB2E4\uC74C \uD638\uCD9C: democut_make_export.",
@@ -14175,6 +14311,12 @@ var TOOL_META = {
     "method": "POST",
     "path": "/api/music/generate"
   },
+  "democut_plan_music": {
+    "cost": "none",
+    "group": "storyboard",
+    "method": "POST",
+    "path": "/api/music/plan"
+  },
   "democut_reorder_cuts": {
     "cost": "none",
     "group": "storyboard",
@@ -16985,13 +17127,60 @@ function makeCharacterPhoto(a = {}, deps = {}) {
 }
 function musicBody(a) {
   return {
-    prompt: (a.prompt ?? "").trim(),
-    ...typeof a.instrumental === "boolean" ? { instrumental: a.instrumental } : {}
+    ...a.plan ? {} : { prompt: (a.prompt ?? "").trim() },
+    ...typeof a.instrumental === "boolean" && !a.plan ? { instrumental: a.instrumental } : {},
+    ...typeof a.length_s === "number" ? { length_s: a.length_s } : {},
+    ...a.plan ? { plan: a.plan } : {},
+    ...a.source_asset_id ? { source_asset_id: a.source_asset_id } : {}
   };
 }
+function musicLengthNote(a) {
+  if (a.plan) {
+    const ms = (a.plan.sections ?? []).reduce((sum, s) => {
+      const sec = s;
+      return sum + (sec.kind === "keep" && sec.range ? sec.range.end_ms - sec.range.start_ms : sec.duration_ms ?? 0);
+    }, 0);
+    return `\uAD6C\uC131\uD45C \uAE38\uC774 ${ms / 1e3}\uCD08\uB85C \uB0C5\uB2C8\uB2E4. \uBC1B\uC740 \uACE1 \uAE38\uC774\uB85C \uC815\uC0B0\uD569\uB2C8\uB2E4.`;
+  }
+  if (typeof a.length_s === "number") return `\uACE0\uB978 \uAE38\uC774 ${a.length_s}\uCD08\uB85C \uB0C5\uB2C8\uB2E4. \uBC1B\uC740 \uACE1 \uAE38\uC774\uB85C \uC815\uC0B0\uD569\uB2C8\uB2E4.`;
+  return "5\uBD84 \uC0C1\uD55C\uC785\uB2C8\uB2E4. \uAE38\uC774\uB294 \uBAA8\uB378\uC774 \uC815\uD558\uACE0(\uBCF4\uD1B5 \uC57D 3\uBD84), \uBC1B\uC740 \uACE1 \uAE38\uC774\uB9CC\uD07C \uC815\uC0B0\uD574 \uCC28\uC561\uC744 \uB3CC\uB824\uB4DC\uB9BD\uB2C8\uB2E4.";
+}
+function musicRequestError(a) {
+  if (a.source_asset_id && !a.plan) return "source_asset_id \uB294 plan(\uAD6C\uC131\uD45C)\uACFC \uD568\uAED8 \uC501\uB2C8\uB2E4. \uC6D0\uACE1\uC758 \uAD6C\uAC04\uC740 plan_music \uC73C\uB85C \uBC1B\uC73C\uC138\uC694.";
+  if (!a.plan && !(a.prompt ?? "").trim()) return "prompt(\uACE1 \uC124\uBA85) \uB610\uB294 plan(\uAD6C\uC131\uD45C)\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.";
+  return null;
+}
+function planMusic(a = {}, deps = {}) {
+  return guarded(READ_ONLY, async () => {
+    const prompt = (a.prompt ?? "").trim();
+    if (!prompt === !a.source_asset_id) {
+      return { isError: true, text: "prompt(\uCD08\uC548\uC744 \uC9E4 \uC124\uBA85)\uC640 source_asset_id(\uAD6C\uC131\uC744 \uC77D\uC744 \uACE1) \uC911 \uC815\uD655\uD788 \uD558\uB098\uB97C \uC8FC\uC138\uC694." };
+    }
+    const base = resolveBaseUrl(deps.baseUrl);
+    const out4 = await apiRequest(
+      base,
+      "/api/music/plan",
+      {
+        method: "POST",
+        body: a.source_asset_id ? { source_asset_id: a.source_asset_id } : { prompt, ...typeof a.length_s === "number" ? { length_s: a.length_s } : {} }
+      },
+      deps
+    );
+    const lines = [
+      out4.source_asset_id ? `\uACE1 ${out4.source_asset_id} \uC758 \uAD6C\uC131\uC785\uB2C8\uB2E4` : "\uAD6C\uC131\uD45C \uCD08\uC548\uC785\uB2C8\uB2E4(0\uC6D0)",
+      `\uCD1D ${(out4.total_ms ?? 0) / 1e3}\uCD08 \xB7 \uAD6C\uAC04 ${(out4.sections ?? []).length}\uAC1C`,
+      ...(out4.sections ?? []).map(
+        (s, i) => `  ${i}. [${s.name}] ${s.start_ms}~${s.end_ms}ms \u2014 ${s.lyrics ? s.lyrics.replace(/\n/g, " / ").slice(0, 80) : "(\uC5F0\uC8FC)"}`
+      ),
+      out4.source_asset_id ? "plan \uC740 \uBAA8\uB4E0 \uAD6C\uAC04\uC774 keep(\uC6D0\uACE1 \uADF8\uB300\uB85C)\uC774\uB2E4. \uACE0\uCE60 \uAD6C\uAC04\uB9CC kind=new(name\xB7lyrics\xB7duration_ms\xB7styles)\uB85C \uBC14\uAFD4 source_asset_id \uC640 \uD568\uAED8 estimate_music\xB7make_music \uC5D0 \uC2E3\uB294\uB2E4." : "plan \uC744 \uACE0\uCCD0(\uAC00\uC0AC\xB7\uAE38\uC774\xB7\uC2A4\uD0C0\uC77C) estimate_music\xB7make_music \uC758 plan \uC5D0 \uADF8\uB300\uB85C \uC2E3\uB294\uB2E4."
+    ];
+    return { text: lines.join("\n"), structured: callableStructured(out4) };
+  });
+}
 function estimateMusic(a = {}, deps = {}) {
   return guarded(READ_ONLY, async () => {
-    if (!(a.prompt ?? "").trim()) return { isError: true, text: "prompt(\uACE1 \uC124\uBA85)\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4." };
+    const invalid = musicRequestError(a);
+    if (invalid) return { isError: true, text: invalid };
     const base = resolveBaseUrl(deps.baseUrl);
     const out4 = await apiRequest(base, "/api/music/estimate", { method: "POST", body: musicBody(a) }, deps);
     const item = out4.items?.[0];
@@ -17003,7 +17192,7 @@ function estimateMusic(a = {}, deps = {}) {
     }
     const lines = [
       `AI \uC74C\uC545 \uACAC\uC801 (\uC694\uC728 v${out4.rate_version}) \u2014 \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uC2B5\uB2C8\uB2E4`,
-      `  ${krw(item.total_krw ?? 0)} \u2014 5\uBD84 \uC0C1\uD55C\uC785\uB2C8\uB2E4. \uAE38\uC774\uB294 \uBAA8\uB378\uC774 \uC815\uD558\uACE0, \uBC1B\uC740 \uACE1 \uAE38\uC774\uB9CC\uD07C \uC815\uC0B0\uD574 \uCC28\uC561\uC744 \uB3CC\uB824\uB4DC\uB9BD\uB2C8\uB2E4.`,
+      `  ${krw(item.total_krw ?? 0)} \u2014 ${musicLengthNote(a)}`,
       `\uC794\uC561 ${krw(out4.balance_krw)} \u2192 \uB0A8\uC744 \uC794\uC561 ${krw(out4.balance_after_krw)}`,
       out4.can_afford ? "\uCDA9\uBD84\uD569\uB2C8\uB2E4." : "\u26A0\uFE0F \uC794\uC561\uC774 \uBD80\uC871\uD569\uB2C8\uB2E4 \u2014 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uAD00\uB9AC\uC790\uC5D0\uAC8C \uCDA9\uC804\uC744 \uC694\uCCAD\uD558\uC138\uC694."
     ];
@@ -17013,7 +17202,8 @@ function estimateMusic(a = {}, deps = {}) {
 }
 function makeMusic(a = {}, deps = {}) {
   return guarded(SUBMITTING, async () => {
-    if (!(a.prompt ?? "").trim()) return { isError: true, text: "prompt(\uACE1 \uC124\uBA85)\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4." };
+    const invalid = musicRequestError(a);
+    if (invalid) return { isError: true, text: invalid };
     const base = resolveBaseUrl(deps.baseUrl);
     const out4 = await apiRequest(
       base,
@@ -17034,7 +17224,7 @@ function makeMusic(a = {}, deps = {}) {
     return {
       text: [
         `\uACE1\uC744 \uB9CC\uB4DC\uB294 \uC911\uC785\uB2C8\uB2E4 \u2014 ${out4.job_id}`,
-        `\uCCAD\uAD6C ${krw(out4.quote?.total_krw ?? 0)} \u2014 5\uBD84 \uC0C1\uD55C\uC785\uB2C8\uB2E4. \uBC1B\uC740 \uACE1 \uAE38\uC774\uB9CC\uD07C \uC815\uC0B0\uD574 \uCC28\uC561\uC744 \uB3CC\uB824\uB4DC\uB9BD\uB2C8\uB2E4.`,
+        `\uCCAD\uAD6C ${krw(out4.quote?.total_krw ?? 0)} \u2014 ${musicLengthNote(a)}`,
         "democut_wait_jobs \uB85C \uB05D\uB098\uBA74 \uACB0\uACFC\uC758 asset_id \uAC00 \uACE1\uC785\uB2C8\uB2E4 \u2014 democut_set_cut_bgm \uC5D0 \uADF8\uB300\uB85C \uC4F0\uC138\uC694." + (a.project_slug ? " \uADF8 \uD504\uB85C\uC81D\uD2B8\uC758 \uACE1 \uBAA9\uB85D\uC5D0\uB3C4 \uB4E4\uC5B4\uAC11\uB2C8\uB2E4." : "")
       ].join("\n"),
       structured: callableStructured(out4)
@@ -17845,6 +18035,8 @@ function dispatch(name, args, deps = {}) {
       return estimateCharacterPhoto(args, deps);
     case "democut_make_character_photo":
       return makeCharacterPhoto(args, deps);
+    case "democut_plan_music":
+      return planMusic(args, deps);
     case "democut_estimate_music":
       return estimateMusic(args, deps);
     case "democut_make_music":

package/package.json

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