@starreel/mcp 0.1.11 → 0.1.12

package/SKILL.md

@@ -38,9 +38,16 @@ create_drama → set_script(raw) → rewrite_script(AI draft, user may edit)
 standard extract → storyboards → … flow. Call `list_project_options` first to
 show the user the real project types, aspect ratios, and resolutions.
 
-Free steps: `create_drama`, `set_script`, all `get_*`, edits, `compose_episode`.
-Metered text (post-paid): `rewrite_script`, `extract_assets`. Every image/video
-step is split into `quote_*` + `generate_*`.
+Free (DB + ffmpeg, no vendor call): `create_drama`, `set_script`, all `get_*`,
+edits, `update_project_settings`, `compose_episode`, `render_multi_aspect`,
+`generate_sfx` / `generate_effects` / `generate_transitions` (local-library
+match), `generate_deliverables`, `add_product` / `list_products`.
+Metered (every AI generation): all images, all video, TTS, and all LLM text
+(`rewrite_script`, `extract_assets`, art-bible, visual-lock, setting-brief,
+style/color/motion locks, MV story/script, subtitle translation). Only the
+big-ticket image/video stages (portraits, storyboards, frames, videos,
+scene-images) carry a `quote_*`; the other metered steps have no quote and bill
+by usage — 402 mid-run if the balance can't cover them (never overdraft).
 
 ## The ten disciplines (hard rules)
 
@@ -53,10 +60,12 @@ content that will be rejected.
    and tell the user to recharge. Never loop-retry a 402 — it will never
    succeed and only spins.
 
-2. **Quote before you spend; the quote is the charge.** Every spending step is
-   `quote_*` then `generate_*`. Show the user the quoted cost and get an
-   explicit yes before calling `generate_*`. For video, quote == actual charge.
-   Do not auto-approve large spends on the user's behalf.
+2. **Quote before you spend; the quote is the charge.** Big-ticket stages
+   (portraits, storyboards, frames, videos, scene-images) are `quote_*` then
+   `generate_*` — show the quote and get an explicit yes; for video, quote ==
+   actual charge. Other AI-generation steps (TTS, posters, sheets, style locks,
+   MV story/script …) have no quote and bill by usage — still tell the user
+   before running them. Never auto-approve large spends on the user's behalf.
 
 3. **`retryable` decides retry-vs-change — never blind-retry.** On failure read
    the structured `fail_reason` / `retryable` (from `get_storyboards`) or the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starreel/mcp",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "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",