@starreel/mcp 0.1.163 → 0.1.165

package/SKILL.md

@@ -136,6 +136,14 @@ Right after `create_drama`, before any paid step:
    package's `effect`, live `estimate` (typical and upper bound), `warnings`,
    `substitutions` and the `not_included` list. `estimate: null` means live
    prices are unreachable — say so, don't invent numbers.
+   For a professional customer picking their own models, call it again with
+   `custom` (image model + video engine + resolution): the response gains a
+   `custom` preview (availability + live estimate) to relay before confirming.
+   `overrun_history` tells how often past dramas needed the overrun allowance
+   (from the billing ledger). Quote its percentages only when
+   `sufficient: true`, as history rather than a promise; when it is `false`,
+   give no percentage at all — just explain the allowance covers QC re-takes
+   and re-runs after vendor rejections, and is not charged if unused.
 3. Let the customer pick an execution mode (`pro` — they control every step;
    `auto` — one-click; `custom` — they pick which stages to delegate), a budget
    (`budget_points`, required for auto/custom) and an automatic overrun cap
@@ -143,7 +151,9 @@ Right after `create_drama`, before any paid step:
 4. Summarize everything; only after the customer explicitly agrees call
    `confirm_production_plan` with `customer_confirmed: true`, passing the
    chosen package's `combo` back as `expected_combo` and its
-   `estimate.total.upper` as `expected_total_upper`. Never confirm on their
+   `estimate.total.upper` as `expected_total_upper` (for a custom combo, pass
+   `custom.estimate.total.upper`; without it you get
+   `409 CUSTOM_ESTIMATE_UNCONFIRMED`). Never confirm on their
    behalf. `409 PACKAGE_CHANGED` means the package changed after the menu was
    shown (fallback model or a price rise above 5%) — present the new combo and
    estimate from the response and ask again.
@@ -153,8 +163,33 @@ must still be available (`409 MODEL_UNAVAILABLE`) and quote upper bound + spent
 must stay within budget × (1 + overrun %) (`402 BUDGET_WOULD_EXCEED`). Nothing
 is charged when blocked — stop and ask the customer; don't switch models or
 raise the budget yourself. `get_production_plan` shows the plan, budget headroom
-and whether the overrun allowance is in use. The execution mode is recorded only
-for now: review gates and agent QC behave exactly as before.
+and whether the overrun allowance is in use.
+
+### Executing by mode (`get_production_plan` → `autopilot`)
+
+Read `autopilot` before working on a confirmed drama. `enabled: false` (rollout
+`AUTOPILOT_DRAMAS` not open for this drama), `pro`, or no plan → every quote,
+review verdict and suggestion goes to the customer first, exactly as below.
+In a **delegated stage** (`auto` = all stages; `custom` = stages whose
+`stage_control` is `agent`) don't ask the customer:
+
+- follow `get_pipeline_status` → `next_action` (`run` / `wait_customer` /
+  `ask_customer` / `done`); confirm quotes yourself while they fit the hard cap;
+- review + agent QC every layer as usual, then do what `autopilot.next_step`
+  says: errors that are all in `auto_ack_codes` (heuristics) → pass
+  `auto_acknowledge: true` to the next paid step; anything else → fix and
+  re-review, at most `max_fix_rounds` rounds (default 3, counted server-side);
+- decisions follow `default_decisions` (adopt only `must` suggestions that keep
+  the customer's lines, apply precheck proposals, first BGM candidate,
+  auto-assigned voices, never delete characters); `never_auto_actions`
+  (`mode=replace`, deleting assets, overwriting customer uploads,
+  `allow_era_ref_conflict`, voice cloning, `confirm_delivery_acceptance`) always
+  need the customer;
+- `402` / `409` / `400 AUTOPILOT_MUST_ASK` / non-empty `pending_questions` →
+  pause and ask everything in `get_autopilot_log` → `pending_questions` **at
+  once**. The log is written by the server; your own claims don't count.
+- When done, present `get_autopilot_log` → `report`: spend, fix rounds per
+  layer, what was auto-acknowledged, leftover defects.
 `403 PRODUCTION_PLAN_NOT_OPEN` means the drama isn't in the rollout yet —
 follow the normal step-by-step flow.