@starreel/mcp 0.1.79 → 0.1.80

package/dist/tools/produce.js

@@ -747,8 +747,11 @@ export function registerProduceTools(server, client) {
         + '\n★**很慢**:每镜要完整解码音轨,实测 6~10 秒/镜(后端限并发 4),整集几十镜要等几分钟。'
         + '别在产线中途反复调,放在成片前查一次。'
         + '\n★shots_probe_failed 是**没测成**的镜数,不代表那些镜有问题。', { episode_id: z.number().int().positive() }, async ({ episode_id }) => jsonResult(await client.produceGet(`/episodes/${episode_id}/silent-shot-audio-audit`)));
-    server.tool('get_asset_recovery', '列本集可恢复的**历史产物**(免费·只读):以前生成过、后来被覆盖掉的成片与候选帧。'
-        + '\n用途:客户说「上一版那个好」「前天那张图比现在这张好」时,从这里找回来。'
+    server.tool('get_asset_recovery', '列本集可恢复的**历史视频产物**(免费·只读):以前生成过、后来被覆盖掉的整集成片与逐镜视频。'
+        + '\n用途:客户说「上一版那个成片好」「这一镜前天那条视频比现在这条好」时,从这里找回来。'
+        + '\n★★只管视频,**不含图片帧**:首尾帧不在这里,列表里也永远不会出现。'
+        + '客户想换回某一帧 → 用 generate_shot_frame 重出(平台带身份锚),'
+        + '或 upload_shot_frame 登记指定图片 URL(注意它会让该帧从此不被批量重生覆盖)。'
         + '\n★这一步只看不改。把候选逐条讲给客户,**客户逐条点头**之后再 apply。', { episode_id: z.number().int().positive() }, async ({ episode_id }) => jsonResult(await client.produceGet(`/episodes/${episode_id}/asset-recovery`)));
     server.tool('apply_recovered_final', '把某个**历史终拼**设为本集当前成片(免费,指针切换)。'
         + '\n★这会**覆盖**本集现在对外的那一版成片。先用 get_asset_recovery 列出来、'
@@ -757,15 +760,15 @@ export function registerProduceTools(server, client) {
         episode_id: z.number().int().positive(),
         merge_id: z.number().int().positive().describe('取自 get_asset_recovery 的 finals[].id'),
     }, async ({ episode_id, merge_id }) => jsonResult(await client.producePost(`/episodes/${episode_id}/asset-recovery/finals/${merge_id}/apply`, {})));
-    server.tool('apply_recovered_candidate', '把某张**历史候选帧**回填到指定镜头(免费)。'
-        + '\n★**必须显式指定 target_storyboard_id**:这张图要回到哪一镜只有客户知道,平台不替你猜——'
-        + '猜错目标镜比不做更糟(会把另一镜正在用的帧换掉)。'
-        + '\n★同样是**逐条确认**:一次只回填一张,先把「哪张图、回到第几镜」讲给客户听。', {
+    server.tool('apply_recovered_candidate', '把某条**历史镜头视频**回填到指定镜头(免费,指针切换)。★它换的是那一镜的**视频**,不是首尾帧。'
+        + '\n★**必须显式指定 target_storyboard_id**:这条视频要回到哪一镜只有客户知道,平台不替你猜——'
+        + '猜错目标镜比不做更糟(会把另一镜正在用的视频换掉)。'
+        + '\n★同样是**逐条确认**:一次只回填一条,先把「哪条视频(时长/提示词)、回到第几镜」讲给客户听。', {
         episode_id: z.number().int().positive(),
-        generation_id: z.number().int().positive().describe('取自 get_asset_recovery 的 candidates[].id'),
+        generation_id: z.number().int().positive().describe('取自 get_asset_recovery 的 candidates[].source_generation_id(响应里没有 id 这个键)'),
         target_storyboard_id: z.number().int().positive().describe('回填到哪一镜(必填,不猜)'),
     }, async ({ episode_id, generation_id, target_storyboard_id }) => jsonResult(await client.producePost(`/episodes/${episode_id}/asset-recovery/candidates/${generation_id}/apply`, { target_storyboard_id })));
-    server.tool('rollback_asset_recovery', '把一次已应用的恢复**退回去**(免费)。apply 错了就用它撤销,恢复到应用之前的状态。', {
+    server.tool('rollback_asset_recovery', '把一次已应用的恢复**退回去**(免费)。apply 错了就用它撤销,恢复到应用之前的状态(同样只涉及视频)。', {
         episode_id: z.number().int().positive(),
         event_id: z.number().int().positive().describe('取自 get_asset_recovery 的恢复事件 id'),
     }, async ({ episode_id, event_id }) => jsonResult(await client.producePost(`/episodes/${episode_id}/asset-recovery/events/${event_id}/rollback`, {})));

package/openapi.json

@@ -2,8 +2,8 @@
   "openapi": "3.1.0",
   "info": {
     "title": "StarReel Production API",
-    "version": "0.1.79",
-    "description": "Turn a script into a finished, downloadable short-drama episode over REST.\n\nPipeline: script → AI rewrite → cast/scenes/props extraction → storyboards → portraits & sheets + scene plates → keyframes → video shots → TTS → final cut (.mp4).\n\n**Billing is prepaid and agent-safe**: big-ticket stages are quote-then-generate (`quote_*` returns a `quote_id`). For video, quote == actual charge. For images the quote is a *range* — models billed per reference image are priced before those are assembled, so `estimated_points` is the upper bound (size the balance by it and a run never dies half-way) and `typical_points` is the usual cost; fixed-price models return the two equal. Insufficient balance returns 402 — nothing half-runs and the account never goes negative.\n\nAuth: exchange your API key at `POST /v1/agent/token` for a 15-minute bearer token.\n\nGenerated from the @starreel/mcp v0.1.79 tool surface (operationIds match MCP tool names 1:1)."
+    "version": "0.1.80",
+    "description": "Turn a script into a finished, downloadable short-drama episode over REST.\n\nPipeline: script → AI rewrite → cast/scenes/props extraction → storyboards → portraits & sheets + scene plates → keyframes → video shots → TTS → final cut (.mp4).\n\n**Billing is prepaid and agent-safe**: big-ticket stages are quote-then-generate (`quote_*` returns a `quote_id`). For video, quote == actual charge. For images the quote is a *range* — models billed per reference image are priced before those are assembled, so `estimated_points` is the upper bound (size the balance by it and a run never dies half-way) and `typical_points` is the usual cost; fixed-price models return the two equal. Insufficient balance returns 402 — nothing half-runs and the account never goes negative.\n\nAuth: exchange your API key at `POST /v1/agent/token` for a 15-minute bearer token.\n\nGenerated from the @starreel/mcp v0.1.80 tool surface (operationIds match MCP tool names 1:1)."
   },
   "servers": [
     {
@@ -2571,8 +2571,8 @@
     "/episodes/{episode_id}/asset-recovery": {
       "get": {
         "operationId": "get_asset_recovery",
-        "summary": "列本集可恢复的**历史产物**(免费·只读):以前生成过、后来被覆盖掉的成片与候选帧",
-        "description": "列本集可恢复的**历史产物**(免费·只读):以前生成过、后来被覆盖掉的成片与候选帧。\n用途:客户说「上一版那个好」「前天那张图比现在这张好」时,从这里找回来。\n★这一步只看不改。把候选逐条讲给客户,**客户逐条点头**之后再 apply。",
+        "summary": "列本集可恢复的**历史视频产物**(免费·只读):以前生成过、后来被覆盖掉的整集成片与逐镜视频",
+        "description": "列本集可恢复的**历史视频产物**(免费·只读):以前生成过、后来被覆盖掉的整集成片与逐镜视频。\n用途:客户说「上一版那个成片好」「这一镜前天那条视频比现在这条好」时,从这里找回来。\n★★只管视频,**不含图片帧**:首尾帧不在这里,列表里也永远不会出现。客户想换回某一帧 → 用 generate_shot_frame 重出(平台带身份锚),或 upload_shot_frame 登记指定图片 URL(注意它会让该帧从此不被批量重生覆盖)。\n★这一步只看不改。把候选逐条讲给客户,**客户逐条点头**之后再 apply。",
         "tags": [
           "episodes"
         ],
@@ -2618,8 +2618,8 @@
     "/episodes/{episode_id}/asset-recovery/candidates/{generation_id}/apply": {
       "post": {
         "operationId": "apply_recovered_candidate",
-        "summary": "把某张**历史候选帧**回填到指定镜头(免费)",
-        "description": "把某张**历史候选帧**回填到指定镜头(免费)。\n★**必须显式指定 target_storyboard_id**:这张图要回到哪一镜只有客户知道,平台不替你猜——猜错目标镜比不做更糟(会把另一镜正在用的帧换掉)。\n★同样是**逐条确认**:一次只回填一张,先把「哪张图、回到第几镜」讲给客户听。",
+        "summary": "把某条**历史镜头视频**回填到指定镜头(免费,指针切换)",
+        "description": "把某条**历史镜头视频**回填到指定镜头(免费,指针切换)。★它换的是那一镜的**视频**,不是首尾帧。\n★**必须显式指定 target_storyboard_id**:这条视频要回到哪一镜只有客户知道,平台不替你猜——猜错目标镜比不做更糟(会把另一镜正在用的视频换掉)。\n★同样是**逐条确认**:一次只回填一条,先把「哪条视频(时长/提示词)、回到第几镜」讲给客户听。",
         "tags": [
           "episodes"
         ],
@@ -2640,7 +2640,7 @@
             "schema": {
               "type": "integer",
               "exclusiveMinimum": 0,
-              "description": "取自 get_asset_recovery 的 candidates[].id"
+              "description": "取自 get_asset_recovery 的 candidates[].source_generation_id(响应里没有 id 这个键)"
             }
           }
         ],
@@ -2696,7 +2696,7 @@
       "post": {
         "operationId": "rollback_asset_recovery",
         "summary": "把一次已应用的恢复**退回去**(免费)",
-        "description": "把一次已应用的恢复**退回去**(免费)。apply 错了就用它撤销,恢复到应用之前的状态。",
+        "description": "把一次已应用的恢复**退回去**(免费)。apply 错了就用它撤销,恢复到应用之前的状态(同样只涉及视频)。",
         "tags": [
           "episodes"
         ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starreel/mcp",
-  "version": "0.1.79",
+  "version": "0.1.80",
   "mcpName": "ai.starreel/starreel",
   "description": "StarReel MCP server — drive the AI short-drama production pipeline (script → storyboards → frames → video → final cut) from Claude, Cursor, or any MCP client",
   "license": "MIT",

package/server.json

@@ -2,13 +2,13 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
   "name": "ai.starreel/starreel",
   "description": "Turn a script into a finished, downloadable short-drama episode — via MCP or REST.",
-  "version": "0.1.79",
+  "version": "0.1.80",
   "websiteUrl": "https://starreel.ai",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@starreel/mcp",
-      "version": "0.1.79",
+      "version": "0.1.80",
       "transport": {
         "type": "stdio"
       },