@starreel/mcp 0.1.104 → 0.1.105

package/SKILL.md

@@ -121,6 +121,17 @@ Don't ask the user at every step. Sort work into three tiers:
    `video_style_prompt`) are all free and the foundation that steers every later
    generation. Set them up front via `create_drama` / `update_project_settings`
    — don't build an empty shell, or all downstream generation drifts.
+   **Honor explicit creative requirements.** `creative_contract` on
+   `create_drama` / `update_project_settings` accepts `version: 1`, optional
+   `speech` (`unspecified` / `forbidden` / `required`), `music`
+   (`unspecified` / `forbidden`), and `pacing` (`unspecified` / `quiet`).
+   Set these only from the customer's explicit choice, never infer them from
+   genre. Omission preserves settings; `null` clears; an object replaces the
+   whole contract. Forbidden speech covers dialogue, narration and singing;
+   environmental/action sounds remain allowed. Forbidden music applies to
+   video output and final composition; customers may still generate, save and
+   select music assets. Music already mixed into native clip audio needs
+   separate handling. Quiet pacing suppresses generic climax/valley advice.
    **Set the structured era contract for anything non-contemporary.**
    `setting_brief` is free text: it supplies background but cannot hold the
    frame. The one mechanism that outranks the visual lock is the structured

package/dist/tools/produce.js

@@ -221,6 +221,12 @@ const VIDEO_ENGINES = ['seedance-2.5', 'hailuo-3', 'wan3.0', 'wan3.0-prime'];
 // 后端内部 PUT /dramas 已接受写库,facade 白名单 Wave3 已放行(produce-create-fields.ts)。
 // 不含内部产线/成本开关(strict_mode/best_of_n/shoppable/budget_points 等,需产品决策)。
 const PROJECT_SETTINGS_FIELDS = {
+    creative_contract: z.object({
+        version: z.literal(1),
+        speech: z.enum(['unspecified', 'forbidden', 'required']).optional(),
+        music: z.enum(['unspecified', 'forbidden']).optional(),
+        pacing: z.enum(['unspecified', 'quiet']).optional(),
+    }).strict().nullable().optional().describe('客户明确创作约束：speech=forbidden 禁止对白/旁白/演唱，music=forbidden 仅禁止本片输出混入配乐（允许生成/保存/选择音乐素材），pacing=quiet 保持平静节奏。不推断；整对象替换，null 清除，省略保持。环境声/音效不受禁止人声影响。'),
     // drama 级图片模型(整剧统一画风):默认 ChatGPT Image 2.5 Flare(v0.9.1558)
     image_model: z.string().optional().describe('图片模型(★drama级·整剧统一画风·默认 ChatGPT Image 2.5 Flare)。可选:' +
         'gpt-image-2.5-flare(默认·基础11点+每张参考图18点)/gpt-image-2.5-sunburst(同价·中文字形与细节更准·慢约5秒)/' +

package/openapi.json

@@ -2,8 +2,8 @@
   "openapi": "3.1.0",
   "info": {
     "title": "StarReel Production API",
-    "version": "0.1.104",
-    "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.104 tool surface (operationIds match MCP tool names 1:1)."
+    "version": "0.1.105",
+    "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.105 tool surface (operationIds match MCP tool names 1:1)."
   },
   "servers": [
     {
@@ -722,6 +722,41 @@
                   "director_style": {
                     "type": "string"
                   },
+                  "creative_contract": {
+                    "type": "object",
+                    "properties": {
+                      "version": {
+                        "type": "number",
+                        "const": 1
+                      },
+                      "speech": {
+                        "type": "string",
+                        "enum": [
+                          "unspecified",
+                          "forbidden",
+                          "required"
+                        ]
+                      },
+                      "music": {
+                        "type": "string",
+                        "enum": [
+                          "unspecified",
+                          "forbidden"
+                        ]
+                      },
+                      "pacing": {
+                        "type": "string",
+                        "enum": [
+                          "unspecified",
+                          "quiet"
+                        ]
+                      }
+                    },
+                    "required": [
+                      "version"
+                    ],
+                    "additionalProperties": false
+                  },
                   "image_model": {
                     "type": "string"
                   },
@@ -1022,6 +1057,41 @@
                   "mv_audio_url": {
                     "type": "string"
                   },
+                  "creative_contract": {
+                    "type": "object",
+                    "properties": {
+                      "version": {
+                        "type": "number",
+                        "const": 1
+                      },
+                      "speech": {
+                        "type": "string",
+                        "enum": [
+                          "unspecified",
+                          "forbidden",
+                          "required"
+                        ]
+                      },
+                      "music": {
+                        "type": "string",
+                        "enum": [
+                          "unspecified",
+                          "forbidden"
+                        ]
+                      },
+                      "pacing": {
+                        "type": "string",
+                        "enum": [
+                          "unspecified",
+                          "quiet"
+                        ]
+                      }
+                    },
+                    "required": [
+                      "version"
+                    ],
+                    "additionalProperties": false
+                  },
                   "image_model": {
                     "type": "string"
                   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starreel/mcp",
-  "version": "0.1.104",
+  "version": "0.1.105",
   "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.104",
+  "version": "0.1.105",
   "websiteUrl": "https://starreel.ai",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@starreel/mcp",
-      "version": "0.1.104",
+      "version": "0.1.105",
       "transport": {
         "type": "stdio"
       },