@kolbo/mcp 1.93.2 → 1.93.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolbo/mcp",
-  "version": "1.93.2",
+  "version": "1.93.4",
   "description": "Kolbo AI MCP Server - Generate images, videos, music, speech, and sound effects from Claude Code",
   "main": "src/index.js",
   "bin": {

package/skill/GENERATED.md

@@ -1,6 +1,6 @@
 # AUTO-GENERATED — do not edit
 
-This tree is mirrored from kolbo-code@be5ba3e, the single source of truth.
+This tree is mirrored from kolbo-code@54e9713, the single source of truth.
 Canonical source: packages/opencode/skills/kolbo/
 Distribution: .github/workflows/sync-skill-to-plugin.yml
 

package/skill/SKILL.md

@@ -221,11 +221,25 @@ A URL from `generate_*`, `list_media`, `get_media`, or a prior `upload_media` is
 - `upload_media` is only for a **local disk path** or an **external** (non-Kolbo) URL — `files`/`source_images`/`image_url` reject unknown hosts with `400`; a Kolbo URL passes through as-is.
 - Same rule after compaction: pull the URL from `.kolbo/production.md` and reuse it. Never download-then-reupload.
 
-## ⚠️ Assets Before Shots (HARD RULE)
+## ⚠️ Route video per use case (decide — do not cargo-cult)
 
-For any film / ad / scene / episode / campaign the order is **Map → Create → Confirm → Shoot** (the directing guide — load `references/workflows/production-planning.md` + `filmmaking.md` before creating anything). Crack the concept first. Then every character, location, and prop becomes a Visual DNA **from a sheet** (`list_presets` search → `generate_image` with that `preset_id` → `create_visual_dna`). Do **not** register a DNA from a single portrait and skip the sheet. Publish the session plan (`Cast` / `Locations` / `Scene NN — slug`). Get a GATE lock on the asset set. **Only then** video. A shot against an unapproved cast is waste.
+Pick the cheapest route that actually controls what the brief needs. Do not invent a pipeline.
 
-Scene dialogue is **never** `generate_speech` or `generate_lipsync`. Seedance 2 / 2.5 performs quoted lines written into the shot beat itself — English only. Full flow: `references/workflows/production-planning.md`.
+**1. Recurring identity (cast / product / location must match across shots)**  
+Map → Visual DNA sheets → Confirm → `generate_elements` (or DNA-locked Multishot). Asset sheets earn their cost here.
+
+**2. Composition must be locked before motion** (deliberate framing, Pixar-like kids beats, specific staging, hero product plate, user-approved look)  
+Generate the needed keyframe still(s) first, then animate with `generate_video_from_image` / first-last / Elements **using those images as real inputs**. Stills without attaching them to the video call are waste.
+
+**3. Pure text-to-video / Multishot Locked Intro — only when keyframes are 100% unnecessary**  
+Use for generic b-roll, ambient motion, simple stock-like scenes, or any brief where the video model inventing composition is fine and stills would not improve control. If you are not sure keyframes add nothing, prefer route 2.
+
+**Anti-patterns (HARD)**  
+- Do not generate N stills and then run a Multishot T2V that never attaches them.  
+- Do not default every "make a video" to keyframes (generic b-roll does not need them).  
+- Do not default every narration-only brief to T2V when the user asked for tightly designed cute/controlled shots — those often need keyframes.
+
+Scene dialogue is **never** `generate_speech` or `generate_lipsync` on a Seedance shoot. Seedance 2 / 2.5 perform quoted lines written into the shot beat — English or Latin transliteration of Hebrew (`"shalom"`), never Hebrew script. For native Hebrew speech, prefer Gemini Omni Flash 1.1 or Gemini Omni 1. Full flow: `references/workflows/production-planning.md`.
 
 ## ⚠️ Load the matching skill BEFORE generating (HARD RULE)
 
@@ -452,7 +466,7 @@ If at this point you still don't know which `references/` file to load, default
 ## Media selection preferences
 Honor explicit models, presets, budget and inputs. Choose only eligible catalog candidates with all required capabilities. Use requested presets; otherwise use fitting presets when useful. For video generation, editing and lip-sync, when the user has not explicitly selected an output resolution, use the cheapest supported output resolution from the live catalog and pass it explicitly; do not inherit an expensive provider default. Preserve explicit user-selected resolution/settings. Finish fully, cinematic, professional, final, production and available credits are NOT permission to increase resolution. Never infer output resolution from reference media or export settings. A budget is a ceiling, not a spending target. Do not upscale or regenerate at a higher tier without explicit user authorization. If pricing or supported resolutions cannot be verified, inspect the catalog before dispatch; never invent a tier. Models with fixed output resolution use their native output. Never treat a policy refusal as a technical failure or route around safeguards.
 Default images and edits: GPT Image 2.5 Flare/Sunburst; medium for value, high for ordinary maximum quality. Reserve xhigh/max for exceptional dense or difficult multilingual text after medium/high prove insufficient; do not automatically spend on retries. Nano Banana 2 is secondary. Seedream 5.0 Pro favors cinematic aesthetics over complex instruction fidelity; Wan 2.7 Pro is another creative alternative. Z Image/P Image for cheap tests. Midjourney for artistic concepts only, never editing. Soul V2 for realistic people/UGC concepts; derive character sheets before registering finished Visual DNA. Mirage Film 2 for environments and cinematic inspiration.
-Default video: Seedance 2.5. Kling specializes in controlled single-image and first/last-frame shots. Wan 3.0 specializes in motion graphics and Hebrew/dialogue work. MiniMax H3 offers higher resolution; H3 Max favors speed at lower resolution. Gemini Omni Flash is a secondary Hebrew option (up to 10 seconds); Grok Imagine 1.5 and Seedance 2.0 are alternatives. P Video/Draft for cheap fast tests. Use base, edit or extend variants only with their required inputs.
+Default video: Seedance 2.5 for general cinematic work (not Hebrew speech). Kling specializes in controlled single-image and first/last-frame shots. Wan 3.0 specializes in motion graphics and animated typography — native Hebrew speech is poor; attached-audio lip-sync works well. MiniMax H3 offers higher resolution and strong attached-audio lip-sync; H3 Max favors speed at lower resolution with the same audio lip-sync strength. **Native Hebrew dialogue:** Gemini Omni Flash 1.1 or Gemini Omni 1 (best). Seedance 2 / 2.5 do not speak Hebrew — use Latin transliteration in quotes on Seedance, or switch to Gemini Omni. Grok Imagine 1.5 and Seedance 2.0 are non-Hebrew alternatives. P Video/Draft for cheap fast tests. Use base, edit or extend variants only with their required inputs.
 Existing-video lip-sync: Sync 3 for active-speaker handling; PixVerse for cartoons/2D and economical faster work. Portrait lip-sync: Veed Fabric or HeyGen Avatar; P Avatar for budget work. LTX Audio to Video for camera/environment motion with audio-driven performance.
 Default music: Suno v6. ElevenLabs Music is an alternative, especially for duration-directed scoring. Both accept custom duration requests; validate the selected tool schema and inspect actual output duration.
 

package/skill/references/models/seedance.md

@@ -13,7 +13,7 @@ Load this file when the user wants a **Seedance 2 / Seedance 2.0** (ByteDance) v
 
 ## Creative direction takes precedence
 
-The current user brief overrides template defaults and illustrative examples. Keep the two-layer organization, but include only relevant locks. State concrete camera trajectory and visible action prominently; optics numbers, equipment names, repetition and word counts are not guarantees of fidelity. Preserve a continuous-shot exception even when other scenes are multishot. For one shot use `Single continuous shot`, `Total: Xs / 1 shot / AR`, one SHOT heading and `multi_shots: false`; for multiple shots use `Multishot ON` and matching counts. AR comes from the brief, never a copied example. Keep dialogue in the user's requested language or phonetic spelling; test pronunciation rather than claiming guaranteed support or impossibility. Narration reserved for post does not belong in the generation prompt.
+The current user brief overrides template defaults and illustrative examples. Keep the two-layer organization, but include only relevant locks. State concrete camera trajectory and visible action prominently; optics numbers, equipment names, repetition and word counts are not guarantees of fidelity. Preserve a continuous-shot exception even when other scenes are multishot. For one shot use `Single continuous shot`, `Total: Xs / 1 shot / AR`, one SHOT heading and `multi_shots: false`; for multiple shots use `Multishot ON` and matching counts. AR comes from the brief, never a copied example. Seedance does not speak Hebrew — use Latin transliteration in quotes or route native Hebrew to Gemini Omni. Narration reserved for post does not belong in the generation prompt.
 
 ## Universal Rules (apply to EVERY Seedance / Elements prompt)
 
@@ -142,7 +142,7 @@ Appearance locks WHO. Persona locks HOW THEY BEHAVE — without it Seedance rend
 ## Dialogue & expression
 
 - **Dialogue is PERFORMED by the model, never by a TTS tool.** Quoted lines in the prompt come back as synced speech with lip movement and room tone, together with the SFX you name in AUDIO. Scene dialogue therefore never routes through `generate_speech` or `generate_lipsync` — write the line in quotes inside its shot beat and let Seedance act it.
-- **Preserve requested dialogue and its language.** If the user requests Hebrew in Latin letters, preserve that phonetic text as dialogue, not an English translation. Native pronunciation and lip-sync require actual output inspection. Do not promise success or claim the language is impossible without current evidence. Offer a separately authorized dubbing pass only when needed; keep narration reserved for post out of the prompt.
+- **Hebrew (HARD):** Seedance 2 / 2.5 do **not** speak Hebrew. Never put Hebrew-script dialogue in the prompt. Use Latin transliteration in quotes (`שלום` → `"shalom"`), or recommend Gemini Omni Flash 1.1 / Gemini Omni 1 for native Hebrew. Do not promise Seedance Hebrew success. Attached-audio lip-sync on 2.5 is unreliable unless audio length matches the clip and the prompt has no Hebrew script. Keep narration reserved for post out of the prompt.
 - `list_models` reports `sound_generation_type: "none"` for Seedance 2 / 2.5 because there is no in-app sound toggle (`sound_baked_in: true`). That field does NOT mean the model is silent. Do not read it as a reason to add TTS.
 - For silent tension, deliver it as expression, not speech: `He does not speak. His expression clearly says: "…"`.
 

package/skill/references/models/seedance25.md

@@ -11,7 +11,7 @@ Load this file when the user wants a **Seedance 2.5** video (they said "2.5" / "
 
 **Audio:** Seedance 2.5 emits real synced audio. `list_models` shows `sound_generation_type: none` only because there is no in-app toggle (`sound_baked_in: true`) — it does NOT mean the model is silent, and it is never a reason to reach for TTS. Quoted dialogue is PERFORMED (synced voices, lip movement, room tone) alongside the SFX named in AUDIO, so scene dialogue never goes through `generate_speech` or `generate_lipsync`; write the lines in quotes inside their shot beats.
 
-**Dialogue language follows the user.** Preserve requested Hebrew or Hebrew-in-Latin transliteration; do not translate it into English or change the spoken content. Pronunciation and lip-sync must be inspected in the generated output, not guaranteed from the prompt. Keep post-production VO out of the generation prompt. Asset tags always retain their exact stored spelling, including `@אביב` / `#ישראל` literally.
+**Hebrew (HARD):** Seedance 2.5 does **not** speak Hebrew. Never put Hebrew-script dialogue in the prompt. Use Latin transliteration in quotes per speaker (`שלום` → `"shalom"`), or route native Hebrew speech to Gemini Omni Flash 1.1 / Gemini Omni 1. Attached-audio lip-sync sometimes works when audio length matches the clip exactly and the prompt has no Hebrew script; Kolbo accepts native audio uploads (no black-video workaround). Asset tags always retain their exact stored spelling, including `@אביב` / `#ישראל` literally. Keep post-production VO out of the generation prompt.
 
 **Use the cheapest supported tier unless the user selected an output resolution.** Resolution is a credit MULTIPLIER, not a flat rate. Relative to 720p: 480p ×0.44, 1080p ×2.25. A 30s pass costs ~540cr at 480p against ~1230cr at 720p and ~2770cr at 1080p. When no output resolution was selected and 480p is the cheapest supported tier, block the film at 480p, get the user's sign-off on staging, performance and timing, then re-run only the approved cut at a higher delivery resolution if the user explicitly authorizes that resolution increase. Approval of the creative cut alone does not authorize a more expensive resolution. If no output resolution was selected, use the cheapest supported tier from the live catalog even for final work; pass it explicitly.
 

package/skill/references/workflows/adobe.md

@@ -1,70 +1,41 @@
 # Premiere Pro & After Effects Workflow
 
-Use these rules whenever the user wants an agent to inspect, edit or animate an open Premiere Pro or After Effects project through Kolbo. The Kolbo panel inside the Adobe app is a separate desktop authority boundary: a Kolbo account is necessary, but the editor's approval inside the panel is the final gate for every change.
-
-For motion graphics in After Effects (shape layers, animated text, effects, expressions), also read `references/workflows/after-effects-motion.md` before writing any script.
+Use these rules whenever the user wants an agent to inspect or edit an open Premiere Pro or After Effects project through Kolbo. The Kolbo panel inside the Adobe app is a separate desktop authority boundary: a Kolbo account is necessary, but the editor's approval inside the panel is the final gate for every edit.
 
 ## Connect and target safely
 
 1. Call `adobe_list_sessions` before the first Adobe action.
-2. If no session is listed, ask the user to open **Window → Extensions → Kolbo Studio** in Premiere Pro or After Effects and sign in. The **AI agents** switch in the panel header connects automatically when signed in; if its dot is not green, ask them to click it. The panel must be signed into the same Kolbo account as this connector - sessions are private per account.
-3. If one session is active, `session_id` may be omitted. If several are active, show each session's `name` (Premiere Pro / After Effects), `adobe_version` and id, and ask which to target. Never guess.
+2. If no session is listed, ask the user to open **Window → Extensions → Kolbo Studio** in Premiere Pro or After Effects, sign in, and click the **AI agents** (robot) button in the panel header until its dot turns green. Do not substitute any other Kolbo tool for the panel relay.
+3. If one session is active, `session_id` may be omitted. If several are active, show each session's `name` (Premiere Pro / After Effects), `adobe_version`, platform and id, and ask which to target. Never guess.
 4. Keep the chosen `session_id` on every later Adobe call in the task. Re-list after a disconnect or app restart; ids are process-scoped.
 
-There is no MCP logout tool. The editor turns agents off from the panel header.
-
-## Command lifecycle and approval
-
-Every Adobe tool except `adobe_list_sessions` and `adobe_get_command_status` returns a **command record**, not the result. Poll `adobe_get_command_status` with its `command_id` until the status is terminal: `succeeded`, `failed`, `denied` or `canceled`.
-
-- Reads (`adobe_get_project`, `adobe_get_timeline`) run without approval. Everything else waits for **Allow once / Allow for this session / Deny** in the panel.
-- `awaiting_approval` is not a polling state. Tell the user to approve or deny in the Kolbo panel, then check once more after they answer.
-- `denied` is final. Do not retry the same change with cosmetic edits; ask the user what they want instead.
-- "Allow for this session" lives only in the panel's memory and ends on disconnect. Never tell the user it persists and never ask them to enable it for you.
-- Pass a stable `idempotency_key` when a timeout may make you retry the same command. A new intent needs a new key.
-
-## Choosing the right tool
-
-| Goal | Tool |
-|---|---|
-| See the project / active sequence or comp (tracks, clips with start/end, playhead; or comp layers) | `adobe_get_project`, `adobe_get_timeline` |
-| Put a Kolbo clip in the bin, or at the Premiere playhead | `adobe_import_media`, `adobe_place_on_timeline` |
-| New Premiere sequence (no dialog, copies the open sequence's settings) | `adobe_create_sequence` |
-| Captions onto the active Premiere sequence | `transcribe_audio` → `adobe_import_captions` with the `.srt` URL |
-| After Effects edit: comps, timed/trimmed clips, titles, solids, fades, keyframes, music | `adobe_edit_composition` |
-| After Effects motion graphics beyond those operations | `adobe_run_script` (read `after-effects-motion.md`) |
-| Check what it actually looks like | `adobe_capture_frame` → look at the returned `url` |
+There is no MCP logout tool. The editor disconnects from the panel header button.
 
-Prefer `adobe_edit_composition` whenever its operations are enough: it is validated, one undo step, and easier for the editor to approve than code.
+## Inspect before changing
 
-## After Effects composition edits (`adobe_edit_composition`)
+- Start with `adobe_get_project`, then `adobe_get_timeline` for the active Premiere sequence or After Effects composition. Both are read-only and run without approval.
+- Timeline responses are bounded; pass `max_clips` when you only need the first clips.
 
-- One call applies up to 100 operations in order as **one undo step**. It stops at the first failing operation; earlier operations stay applied. Read the error, fix that operation, and continue from there - do not replay the whole batch.
-- Start a new piece with `comp.create` (defaults 1920×1080, 30 fps). Later operations in the same batch target it.
-- Times are **seconds on the composition timeline**. For media: `start_seconds` = where it begins, `trim_start_seconds` = seconds skipped at the head of the source, `duration_seconds` = visible length.
-- Crossfade = overlap two shots by 0.3–1 s and animate the upper shot's opacity 0 → 100 across the overlap. New layers stack on top, so add the later shot after the earlier one.
-- **Name every layer you will address later** and use that exact name in `layer.update` / `layer.animate`. Indexes shift as layers are added (1 = top).
-- `fit: "cover"` fills the frame (default), `"contain"` letterboxes, `"none"` keeps source size. Keyframed `scale` values are absolute percentages, so animate scale on titles and solids, not on fitted media, unless you first read the fitted scale from `adobe_get_timeline`.
-- Titles default to Arial Bold, white, centred. Add `stroke_width` 3–6 (black stroke) whenever text sits over bright or busy footage - white text on a light shot is invisible.
-- Music: add audio with `layer.add_media`, then animate `audio_levels` from 0 dB to about −40 dB over the last 1.5–2 s for a clean fade-out.
-- Solids are sent to the bottom automatically (backgrounds).
+## Command lifecycle and approval
 
-## Media rules
+Every Adobe tool except `adobe_list_sessions` and `adobe_get_command_status` returns a **command record**, not the result. Poll `adobe_get_command_status` with its `command_id` until the status is terminal: `succeeded`, `failed`, `denied` or `canceled`.
 
-- Media accepts exactly one Kolbo `media_id` (preferred) or a Kolbo-owned HTTPS `url`. Third-party hosts, HTTP, private network and guessed URLs are rejected; import third-party files into Kolbo first.
-- Generate first, wait for success, then pass the real media id. Never place a still-running generation.
-- `adobe_place_on_timeline` has no time or track control: it uses the Premiere work sequence playhead or the active After Effects comp. For timed After Effects edits use `adobe_edit_composition`.
-- `adobe_create_sequence` and `adobe_import_captions` are Premiere Pro only; `adobe_edit_composition` is After Effects only. The wrong app fails with `UNSUPPORTED_HOST`.
+- `awaiting_approval` is not a polling state. Stop and tell the user to approve or deny the request in the Kolbo panel, then check once more after they answer.
+- `denied` is final. Do not retry the same edit with cosmetic changes; ask the user what they want instead.
+- "Allow for this session" lives only in the panel's memory and ends when the editor disconnects. Never tell the user it persists, and never ask them to enable it for you.
+- Pass a stable `idempotency_key` when a timeout may cause you to retry the same command. A new intent needs a new key.
 
-## Scripts (`adobe_run_script`)
+## Media, sequences and captions
 
-- `code` is a **function body**: call `log(...)` for progress and `return` a JSON-serialisable summary. In After Effects the whole script is one undo step.
-- The editor reads the exact code before approving. Keep scripts focused, named and commented; give a plain `purpose`.
-- Scripts have full access to the project and the computer. Never read or write files, call `system.callSystem`, or use the network unless the user explicitly asked for exactly that.
-- On `SCRIPT_ERROR` the message includes the line and the last log lines. Fix the specific problem; do not resend the same script.
+- `adobe_import_media` and `adobe_place_on_timeline` accept exactly one Kolbo `media_id` (preferred) or a Kolbo-owned HTTPS `url`. Third-party hosts, HTTP, private network and guessed URLs are rejected; import third-party files into Kolbo first.
+- To generate then edit: run the Kolbo generation tool, wait for its successful result, then pass the real media id. Never place a still-running generation.
+- `adobe_place_on_timeline` drops the clip into a free track at the playhead of the Premiere work sequence, or into the active After Effects composition. There is no time, track, trim or transition control in v1; do not promise one. Ask the user to position the playhead first when placement matters.
+- `adobe_create_sequence` and `adobe_import_captions` are Premiere Pro only. In After Effects they fail with `UNSUPPORTED_HOST`.
+- For captions, create the SRT with `transcribe_audio`, then pass its Kolbo-hosted `.srt` URL to `adobe_import_captions`.
+- There is no raw ExtendScript tool. If the user asks for an edit outside these commands, say it is not available through agents yet and suggest doing it in the panel or the app.
 
 ## Completion proof
 
-1. Re-read with `adobe_get_timeline` after an edit.
-2. For anything visual - titles, motion graphics, layout, crossfades - call `adobe_capture_frame` at 2–4 representative times and **look at the images** before reporting. Check legibility, contrast, framing and timing.
-3. Report what changed, which session was targeted, and that the editor approved it. A command is complete only when `adobe_get_command_status` shows `succeeded`.
+1. Re-read with `adobe_get_timeline` or `adobe_get_project` after an edit.
+2. Report what changed, which session was targeted, and that the editor approved it.
+3. A command is complete only when `adobe_get_command_status` shows `succeeded`. An accepted enqueue is not proof the edit happened.

package/skill/references/workflows/production-planning.md

@@ -9,10 +9,13 @@ starts here, **before** a single video credit is spent. Most users do not know
 this flow exists; they ask for a film and expect a film. Walk them through it
 rather than jumping to a prompt.
 
-Skip it only for a genuine one-off: a single clip, no recurring subject, nothing
-that has to match anything else.
+**Skip asset mapping** only when keyframes and DNA are **100% unnecessary**: generic b-roll,
+ambient motion, simple stock-like scenes where the video model inventing composition is fine.
+For tightly designed kids/educational beats, Pixar-like staging, or any brief where composition
+must be locked, generate keyframes (or DNA) first and attach them to the video call — do not
+invent stills and then run a Multishot T2V that ignores them.
 
-## The order is not negotiable
+## The order is not negotiable (when cast/product identity must lock)
 
 1. **Map** every element the script needs — including the **session plan** (names).
 2. **Create** each one as an asset (Visual DNA), grouped into the planned sessions.

package/src/tools/generate.js

@@ -617,7 +617,7 @@ function registerGenerateTools(server, client, options = {}) {
   // retired textToVideoGeneration path and was stale.
   server.tool(
     'generate_video',
-    'Generate a video from a text prompt using Kolbo AI. For SEVERAL different videos, pass all their prompts in `prompts` in ONE call (one combined widget) — never a series of separate calls. For animating an existing still image into motion, use generate_video_from_image instead. For a coordinated multi-scene video campaign, use generate_creative_director with workflow_type="video". Supports reference images (for style/composition guidance) and Visual DNA for character consistency. Seedance 2/2.5 PERFORM quoted dialogue natively (synced voice, lip movement, room tone) — do not route scene dialogue to generate_speech or generate_lipsync; write it in ENGLISH (other languages, Hebrew included, do not perform reliably). Resolution is a credit MULTIPLIER (vs 720p: 480p x0.44, 1080p x2.25, 4k x4.95), so draft at 480p and re-run only the approved cut at delivery resolution. ROUTE BEFORE CALLING: when reference images anchor IDENTITY (specific characters, a specific product, a location that must match) — especially 2+ of them — that is generate_elements, not this tool; reference_images here are loose style/composition hints. Decide the right tool FIRST: a mis-routed call still starts a PAID generation, and switching tools afterwards without cancel_generation leaves the user paying for both. Returns the final video URL when complete.',
+    'Generate a video from a text prompt using Kolbo AI. For SEVERAL different videos, pass all their prompts in `prompts` in ONE call (one combined widget) — never a series of separate calls. For animating an existing still image into motion, use generate_video_from_image instead. For a coordinated multi-scene video campaign, use generate_creative_director with workflow_type="video". Supports reference images (for style/composition guidance) and Visual DNA for character consistency. Seedance 2/2.5 PERFORM quoted dialogue natively (synced voice, lip movement, room tone) — do not route scene dialogue to generate_speech or generate_lipsync; write it in ENGLISH or Latin transliteration of Hebrew ("shalom"), never Hebrew script — Seedance 2/2.5 do not speak Hebrew; prefer Gemini Omni Flash 1.1 or Gemini Omni 1 for native Hebrew. Resolution is a credit MULTIPLIER (vs 720p: 480p x0.44, 1080p x2.25, 4k x4.95), so draft at 480p and re-run only the approved cut at delivery resolution. ROUTE BEFORE CALLING: when reference images anchor IDENTITY (specific characters, a specific product, a location that must match) — especially 2+ of them — that is generate_elements, not this tool; reference_images here are loose style/composition hints. Decide the right tool FIRST: a mis-routed call still starts a PAID generation, and switching tools afterwards without cancel_generation leaves the user paying for both. Returns the final video URL when complete.',
     {
       prompt: z.string().optional().describe('Text description of the video to generate. Required unless `prompts` is provided.'),
       prompts: promptsField('videos'),
@@ -1427,7 +1427,7 @@ function registerGenerateTools(server, client, options = {}) {
   // ─── generate_elements ─────────────────────────────────────
   server.tool(
     'generate_elements',
-    'Generate a video from reference elements (images, videos, and/or audio) + a text prompt. Use when the user wants to animate specific uploaded/referenced assets — e.g. "animate this product", "put these 3 characters into a scene". PRIMARY ROUTE FOR A DNA-ANCHORED MULTI-SHOT FILM: one call can carry the whole sequence — seedance-2-5 takes 4-30s, up to 30 shots and 20 Visual DNAs in a SINGLE generation (seedance-2: 4-15s, 9 DNAs) — instead of a stack of separate clips. DIALOGUE IS PERFORMED NATIVELY: quoted dialogue in the prompt comes back as synced voices with lip movement, room tone and the SFX named in the AUDIO block — never route scene dialogue to generate_speech or generate_lipsync. Write dialogue in ENGLISH; other languages (Hebrew included) do not perform reliably. COST: resolution is a multiplier. When list_models publishes `video_input_credit` and this call carries videos, charge that rate against nominal input seconds + nominal output seconds; MP4 padding within 0.15s of an integer snaps to that integer and larger fractions round up. Otherwise use the normal output-second rate. PROMPT CONTRACT (Seedance / Elements): Locked Intro only — Total line, then [GLOBAL LOOK] / [CAST] / [LOCATION] / SHOT N. Do NOT write SCENE CONTEXT / OPTICS / ACTION department packs. Every Visual DNA in visual_dna_ids MUST also appear in the prompt as @ExactDNAName (e.g. "@Zohar walks…") — never "Zohar\'s" or "the man on the left" as a substitute. IMPORTANT: different models accept different numbers and durations of inputs — call list_models type="elements" and read elements_max_images / elements_max_videos / elements_max_audio plus min_video_duration / max_video_duration before generating. For text-only → video use generate_video instead. For animating a single still image use generate_video_from_image. Returns the final video URL when complete.',
+    'Generate a video from reference elements (images, videos, and/or audio) + a text prompt. Use when the user wants to animate specific uploaded/referenced assets — e.g. "animate this product", "put these 3 characters into a scene". PRIMARY ROUTE FOR A DNA-ANCHORED MULTI-SHOT FILM: one call can carry the whole sequence — seedance-2-5 takes 4-30s, up to 30 shots and 20 Visual DNAs in a SINGLE generation (seedance-2: 4-15s, 9 DNAs) — instead of a stack of separate clips. DIALOGUE IS PERFORMED NATIVELY: quoted dialogue in the prompt comes back as synced voices with lip movement, room tone and the SFX named in the AUDIO block — never route scene dialogue to generate_speech or generate_lipsync. Write dialogue in ENGLISH or Latin transliteration of Hebrew ("shalom"), never Hebrew script — Seedance does not speak Hebrew; prefer Gemini Omni Flash 1.1 or Gemini Omni 1 for native Hebrew. COST: resolution is a multiplier. When list_models publishes `video_input_credit` and this call carries videos, charge that rate against nominal input seconds + nominal output seconds; MP4 padding within 0.15s of an integer snaps to that integer and larger fractions round up. Otherwise use the normal output-second rate. PROMPT CONTRACT (Seedance / Elements): Locked Intro only — Total line, then [GLOBAL LOOK] / [CAST] / [LOCATION] / SHOT N. Do NOT write SCENE CONTEXT / OPTICS / ACTION department packs. Every Visual DNA in visual_dna_ids MUST also appear in the prompt as @ExactDNAName (e.g. "@Zohar walks…") — never "Zohar\'s" or "the man on the left" as a substitute. IMPORTANT: different models accept different numbers and durations of inputs — call list_models type="elements" and read elements_max_images / elements_max_videos / elements_max_audio plus min_video_duration / max_video_duration before generating. For text-only → video use generate_video instead. For animating a single still image use generate_video_from_image. Returns the final video URL when complete.',
     {
       prompt: z.string().describe('Locked Intro prompt (Seedance/Elements): Total line, [GLOBAL LOOK], [CAST] with @ExactDNAName for every visual_dna_ids entry, [LOCATION], then SHOT N. Not SCENE CONTEXT/OPTICS/ACTION packs. Never substitute "the left man" or "Zohar\'s" for @Name. EVERY attached reference must also be tagged by its 1-based array position — `@Image 1`/`@Image 2` (reference_images), `@Video 1` (reference_videos), `@Audio 1` (reference_audio_urls) — and its job stated ("@Image 1 defines the character\'s face and wardrobe", "@Video 1 defines the camera move"). An untagged attachment is ignored by the engine even though it was uploaded and billed.'),
       model: z.string().optional().describe('Model identifier. If the user already named a family (Grok / Kling / Veo / Seedance / …), pass THAT family — never default to Seedance because Elements often uses it. Use list_models type="elements" for exact ids and elements_max_* caps. Do NOT omit (omitting = Smart Select).'),

package/skill/references/workflows/after-effects-motion.md

@@ -1,193 +0,0 @@
-# After Effects Motion Graphics
-
-Read this before calling `adobe_run_script` for motion graphics. Connection, approval and completion rules are in `references/workflows/adobe.md`; ordinary cuts, titles and fades belong in `adobe_edit_composition` instead of a script.
-
-Every snippet below was run in After Effects 26.3 through `adobe_run_script`.
-
-## Design before code
-
-Plan the piece as beats before writing anything: what the viewer should notice first, second and last, with times.
-
-- **Timing.** UI and title moves: 0.3–0.6 s. Logo builds and reveals: 1–2 s. Hold readable text for at least 1.5 s plus 0.3 s per word. Leave 0.5 s of breathing room before the end.
-- **Easing.** Nothing real moves at constant speed. Ease into rests (`KeyframeEase` influence 70–90). Use linear only for continuous motion (spins, scrolling, constant drift).
-- **Overlap and offset.** Stagger related elements by 2–4 frames (0.07–0.13 s) instead of moving them together. Let secondary elements settle after the primary one.
-- **Overshoot.** A pop reads as alive when scale goes 0 → 115 → 100 within about 0.6 s. Use it sparingly: one hero element per beat.
-- **Hierarchy.** One dominant element per frame. Size, contrast and motion should all agree on what matters.
-- **Legibility.** Text needs contrast: dark scrim, stroke or shadow over busy footage. Keep text inside title-safe (about 10% margin: x 192–1728, y 108–972 at 1080p).
-- **Restraint.** Two typefaces maximum, a palette of 2–4 colours, and one idea per shot. Remove before adding.
-
-## Build loop
-
-1. `adobe_get_timeline` to see what exists.
-2. Write the script in named sections (background, main element, typography, outro). Name every layer.
-3. `adobe_run_script` with a clear `purpose`. Return a small summary (comp name, layer names).
-4. `adobe_capture_frame` at the key beats (mid-reveal, settled, outro) and look at every image.
-5. Fix in a follow-up script that edits the named layers; do not rebuild everything.
-
-## ExtendScript rules
-
-After Effects scripting is ES3: use `var` and `function`. There is no `let`/`const`, arrow functions, template strings, `Array.prototype.forEach/map/indexOf`, or `Object.keys` - use `for` loops. `JSON` is available. The script body receives `log()` and must `return` its result.
-
-Use property **match names** (`'ADBE Transform Group'`, `'ADBE Position'`), not display names; they work in every UI language.
-
-## Foundation
-
-```js
-var W = 1920, H = 1080, DUR = 6, FPS = 30;
-var comp = app.project.items.addComp('Logo Reveal', W, H, 1, DUR, FPS);
-comp.bgColor = [0.02, 0.02, 0.05];
-comp.motionBlur = true;          // also set layer.motionBlur = true on moving layers
-comp.openInViewer();
-
-function tr(layer, name) { return layer.property('ADBE Transform Group').property(name); }
-// 'ADBE Anchor Point', 'ADBE Position', 'ADBE Scale', 'ADBE Rotate Z', 'ADBE Opacity'
-
-// Keys with ease on every dimension (spatial properties take one ease value).
-function ease(prop, times, values, influence) {
-  for (var i = 0; i < times.length; i++) prop.setValueAtTime(times[i], values[i]);
-  var spatial = prop.propertyValueType === PropertyValueType.TwoD_SPATIAL || prop.propertyValueType === PropertyValueType.ThreeD_SPATIAL;
-  var dims = spatial || !(prop.value instanceof Array) ? 1 : prop.value.length;
-  for (var k = 1; k <= prop.numKeys; k++) {
-    var e = [];
-    for (var d = 0; d < dims; d++) e.push(new KeyframeEase(0, influence || 80));
-    prop.setTemporalEaseAtKey(k, e, e);
-  }
-}
-```
-
-## Backgrounds
-
-```js
-var bg = comp.layers.addSolid([0, 0, 0], 'Background', W, H, 1, DUR);
-var ramp = bg.property('ADBE Effect Parade').addProperty('ADBE Ramp');   // Gradient Ramp
-ramp.property('ADBE Ramp-0001').setValue([W / 2, H * 0.4]);       // start point
-ramp.property('ADBE Ramp-0002').setValue([0.16, 0.13, 0.42, 1]);  // start colour (RGBA)
-ramp.property('ADBE Ramp-0003').setValue([W / 2, H * 1.25]);      // end point
-ramp.property('ADBE Ramp-0004').setValue([0.01, 0.01, 0.03, 1]);  // end colour
-ramp.property('ADBE Ramp-0005').setValue(2);                      // 1 linear, 2 radial
-```
-
-## Shape layers
-
-```js
-var ring = comp.layers.addShape();
-ring.name = 'Ring';
-var group = ring.property('ADBE Root Vectors Group').addProperty('ADBE Vector Group');
-var contents = group.property('ADBE Vectors Group');
-
-contents.addProperty('ADBE Vector Shape - Ellipse').property('ADBE Vector Ellipse Size').setValue([380, 380]);
-// Rounded rectangle instead:
-//   var rect = contents.addProperty('ADBE Vector Shape - Rect');
-//   rect.property('ADBE Vector Rect Size').setValue([900, 500]);
-//   rect.property('ADBE Vector Rect Roundness').setValue(48);
-// Custom path:
-//   var shape = new Shape(); shape.vertices = [[-200, 0], [0, -120], [200, 0]]; shape.closed = false;
-//   contents.addProperty('ADBE Vector Shape - Group').property('ADBE Vector Shape').setValue(shape);
-
-var stroke = contents.addProperty('ADBE Vector Graphic - Stroke');
-stroke.property('ADBE Vector Stroke Color').setValue([0.42, 0.55, 1, 1]);
-stroke.property('ADBE Vector Stroke Width').setValue(16);
-stroke.property('ADBE Vector Stroke Line Cap').setValue(2);            // round caps
-// Solid fill: contents.addProperty('ADBE Vector Graphic - Fill').property('ADBE Vector Fill Color').setValue([1, 1, 1, 1]);
-// Gradient fill: contents.addProperty('ADBE Vector Graphic - G-Fill') with 'ADBE Vector Grad Start Pt' / 'ADBE Vector Grad End Pt'
-
-// Draw-on with Trim Paths (add it after the shape and stroke).
-var trim = contents.addProperty('ADBE Vector Filter - Trim');
-ease(trim.property('ADBE Vector Trim End'), [0.2, 1.5], [0, 100], 85);
-// Endless loader: trim.property('ADBE Vector Trim End').setValue(25); trim.property('ADBE Vector Trim Offset').expression = 'time * 180';
-
-tr(ring, 'ADBE Position').setValue([W / 2, 420]);   // shape contents are centred on the layer position
-ring.motionBlur = true;
-```
-
-Overshoot pop on a second shape: `ease(tr(core, 'ADBE Scale'), [1.2, 1.55, 1.8], [[0, 0], [118, 118], [100, 100]], 70);`
-
-## Typography
-
-```js
-var word = comp.layers.addText('KOLBO');                       // use '\r' for line breaks
-var textProp = word.property('ADBE Text Properties').property('ADBE Text Document');
-var doc = textProp.value;
-doc.resetCharStyle();
-doc.font = 'Arial-BoldMT';          // PostScript name
-doc.fontSize = 190;
-doc.tracking = 180;
-doc.autoLeading = false; doc.leading = 110;                    // multi-line spacing
-doc.fontCapsOption = FontCapsOption.FONT_ALL_CAPS;             // doc.allCaps is read-only
-doc.applyFill = true; doc.fillColor = [1, 1, 1];
-// Outline for busy backgrounds: doc.applyStroke = true; doc.strokeColor = [0, 0, 0]; doc.strokeWidth = 5; doc.strokeOverFill = false;
-doc.justification = ParagraphJustification.CENTER_JUSTIFY;
-textProp.setValue(doc);
-
-// Centre the anchor on the visible text so Position means "centre of the text".
-var box = word.sourceRectAtTime(0, false);
-tr(word, 'ADBE Anchor Point').setValue([box.left + box.width / 2, box.top + box.height / 2]);
-tr(word, 'ADBE Position').setValue([W / 2, 760]);
-```
-
-Per-character reveal with a text animator (characters rise and fade in left to right):
-
-```js
-var animator = word.property('ADBE Text Properties').property('ADBE Text Animators').addProperty('ADBE Text Animator');
-var animProps = animator.property('ADBE Text Animator Properties');
-animProps.addProperty('ADBE Text Position 3D').setValue([0, 140, 0]);   // offset while inside the range
-animProps.addProperty('ADBE Text Opacity').setValue(0);
-// Pop instead of rise: animProps.addProperty('ADBE Text Scale 3D').setValue([0, 0, 100]);
-var selector = animator.property('ADBE Text Selectors').addProperty('ADBE Text Selector');
-// Softer falloff: selector.property('ADBE Text Range Advanced').property('ADBE Text Range Shape').setValue(2); // ramp up
-ease(selector.property('ADBE Text Percent Offset'), [1.6, 2.7], [0, 100], 75);
-word.motionBlur = true;
-```
-
-## Effects
-
-```js
-var fx = layer.property('ADBE Effect Parade');
-var glow = fx.addProperty('ADBE Glo2');                         // Glow
-glow.property('ADBE Glo2-0003').setValue(70);                   // radius
-glow.property('ADBE Glo2-0004').setValue(1.6);                  // intensity
-fx.addProperty('ADBE Gaussian Blur 2').property('ADBE Gaussian Blur 2-0001').setValue(8);  // blurriness
-fx.addProperty('ADBE Drop Shadow').property('ADBE Drop Shadow-0005').setValue(40);         // softness
-fx.addProperty('ADBE Fill').property('ADBE Fill-0002').setValue([1, 0.4, 0.2, 1]);         // colour
-```
-
-## Structure, mattes and 3D
-
-```js
-var ctrl = comp.layers.addNull(); ctrl.name = 'Controller';
-card.parent = ctrl;                                            // move everything together
-
-tr(ctrl, 'ADBE Position').expression = 'wiggle(2, 12)';       // organic drift
-tr(card, 'ADBE Rotate Z').expression = 'loopOut("pingpong")';  // after at least two keys
-tr(ring, 'ADBE Rotate Z').expression = 'time * 24';           // constant spin
-
-var pre = comp.layers.precompose([card.index], 'Card Precomp', true);   // returns the new CompItem
-
-fill.moveAfter(matte);
-fill.setTrackMatte(matte, TrackMatteType.ALPHA);              // reveal fill through the matte's alpha
-
-floor.threeDLayer = true;
-var cam = comp.layers.addCamera('Camera', [W / 2, H / 2]);
-ease(tr(cam, 'ADBE Position'), [0, 5], [[W / 2, H / 2, -2400], [W / 2, H / 2, -1800]], 60);   // slow push-in
-```
-
-## Outro
-
-Fade the group together over the last 0.5–0.7 s, holding the current value first so earlier animation is kept:
-
-```js
-var layers = [ring, core, word, tag];
-for (var i = 0; i < layers.length; i++) {
-  var op = tr(layers[i], 'ADBE Opacity');
-  op.setValueAtTime(DUR - 0.7, op.valueAtTime(DUR - 0.7, false));
-  op.setValueAtTime(DUR, 0);
-}
-return { comp: comp.name, layers: comp.numLayers };
-```
-
-## Checklist before reporting
-
-- Captured frames at mid-reveal, settled state and outro, and looked at them.
-- Text is legible over its background and inside title-safe.
-- Every moving element eases; stagger and overshoot are deliberate, not everywhere.
-- Layers are named and the script returned a summary the user can read.

package/skill/references/workflows/davinci-resolve.md

@@ -1,163 +0,0 @@
-# DaVinci Resolve Workflow
-
-Use this when the user wants Kolbo media edited, cut, titled, graded or rendered in DaVinci Resolve. There are two ways to reach Resolve; pick by what is connected.
-
-| Path | Works from | Use it for |
-|---|---|---|
-| **Kolbo Resolve plugin** (`resolve_*` tools, this server) | Any agent, including ChatGPT and claude.ai | Reading the project, importing Kolbo media, building timeline edits, titles, frame checks - every change approved by the editor |
-| **Blackmagic's DaVinci Resolve MCP** (their own server) | Local agents only (Claude Desktop, Claude Code, Codex) | Deep scripting, colour, LUTs/DCTLs, rendering |
-
-Both need **DaVinci Resolve Studio**; the free edition has no plugins and no external scripting. If `resolve_list_sessions` returns a session, prefer the Kolbo plugin.
-
-## Kolbo Resolve plugin
-
-Everything in this section was run end to end through Kolbo MCP against DaVinci Resolve Studio 21.1.
-
-### Connect and target safely
-
-1. Call `resolve_list_sessions` before the first Resolve action.
-2. If no session is listed, ask the user to open **Workspace → Workflow Integrations → Kolbo AI** in Resolve Studio and sign in with the same Kolbo account as this connector. **AI agents** in the plugin header connects automatically; if its dot is not green, ask them to click it.
-3. One session: `session_id` may be omitted. Several: show each and ask. Keep the chosen `session_id` on every later call; re-list after Resolve or the plugin restarts.
-
-Every tool except `resolve_list_sessions` and `resolve_get_command_status` returns a command record. Poll `resolve_get_command_status` until `succeeded`, `failed`, `denied` or `canceled`. Reads run without approval; everything else waits for **Allow once / Allow for this session / Deny** in the plugin window. `awaiting_approval` is not a polling state: tell the user to approve in the Kolbo AI window (it may be behind Resolve), then check again. `denied` is final.
-
-### Tools
-
-| Goal | Tool |
-|---|---|
-| Project name, timelines, frame rate, resolution, playhead | `resolve_get_project` |
-| Clips on every track (position, start/end seconds), markers | `resolve_get_timeline` |
-| Kolbo media into the Media Pool only | `resolve_import_media` |
-| Build or change an edit | `resolve_edit_timeline` |
-| Anything else in Resolve's scripting API | `resolve_run_script` |
-| See the result | `resolve_capture_frame` → look at the returned `url` |
-
-### Timeline edits (`resolve_edit_timeline`)
-
-- Up to 100 operations run in order and stop at the first failure; earlier operations stay applied. Fix the failing one and continue - do not replay the batch.
-- Start new work with `timeline.create` so the user's existing timelines stay untouched. It uses the project's frame rate and resolution.
-- Times are seconds from the timeline start. `clip.append`: `record_seconds` = where it lands (default: end of that track), `trim_start_seconds` = seconds skipped at the head of the source, `duration_seconds` = length on the timeline (stills default to 5 s). media_type "video" keeps a clip's audio off the timeline; audio files always go to audio tracks. Missing tracks are added.
-- Clips are addressed by track plus position (1 = leftmost media clip on that track; transitions do not count) or exact clip name. Clip names are file names, and a file imported again gets a short prefix, so prefer positions. Positions change after inserts and deletes - re-read with `resolve_get_timeline` when unsure.
-- `clip.transition` needs handles: trim the head of the next shot (`trim_start_seconds` ≥ half the transition) or the transition will be refused.
-- `audio.fade` is for clips on audio tracks. `title.add` builds the title inside that clip's Fusion comp (`position` [0.5, 0.5] = centre, y grows upward) with a fade in and out; keep it inside title-safe (x and y between 0.1 and 0.9).
-- `clip.delete` is destructive; only delete what the user asked for.
-- The Kolbo AI window must stay open while you work; it can sit behind Resolve.
-
-### Scripts (`resolve_run_script`)
-
-- `code` is an **async JavaScript function body** with `resolve`, `project`, `timeline` and `log(...)` in scope. Every Resolve call returns a promise - `await` each one - and `return` a JSON-serialisable result.
-- The editor reads the exact code before approving. Give a plain `purpose`. Never touch files, the network or other projects unless the user asked for exactly that.
-
-## Blackmagic's DaVinci Resolve MCP
-
-Verified against DaVinci Resolve Studio 21.1.0.17.
-
-### Requirements - check before promising anything
-
-- **DaVinci Resolve Studio 21.1 or later.** The free edition has no MCP server and no external scripting.
-- A **local** agent: Claude Desktop, Claude Code or Codex on the same computer as Resolve. Browser ChatGPT and claude.ai cannot reach this server; use the Kolbo Resolve plugin from there.
-- Connect Resolve's server from **File → Setup AI Assistants** in Resolve, and set **Preferences → System → General → External scripting using** to **Local**.
-- Resolve must be running; the server's `launch_resolve` tool can start it.
-
-If neither the Kolbo plugin session nor Blackmagic's tools are available, say so and give the setup steps for the path that fits the user. Do not try to control Resolve any other way.
-
-### Blackmagic's tools (not Kolbo's)
-
-| Tool | Use |
-|---|---|
-| `get_resolve_status`, `launch_resolve` | Is Resolve running / start it |
-| `get_whats_new` (`since` is required, e.g. `"21.0"`) | Features newer than your training |
-| `search_scripting_api`, `get_scripting_api`, `get_scripting_docs` | Look up exact API signatures before writing a script |
-| `run_script` | Sandboxed Python: Resolve API only, no files, network or processes |
-| `run_script_unsafe` | Python with full system access - required for importing files or downloading media |
-| `generate_lut`, `update_dctl`, `list_luts`, `list_dctls` | Colour transforms |
-
-Scripts get `resolve` and the current `project` pre-injected and return data by assigning `result`.
-
-### Workflow
-
-1. **Generate or find media with Kolbo** (`generate_video`, `generate_music`, `list_media`, …) and wait for success.
-2. **Get the files onto disk.** In Claude Code or Codex, download the Kolbo URLs with the shell. In Claude Desktop, download inside `run_script_unsafe` with `urllib.request`. Only download Kolbo-hosted URLs.
-3. **Protect the user's work.** Call `pm.SaveProject()` first. For anything experimental, build in a new project (`pm.CreateProject(name)`) and reload the original project at the end. Projects opened in 21.1 cannot be opened in 20.x, so never convert a user's project as a side effect.
-4. **Import, cut and finish** with `run_script_unsafe` (see recipe).
-5. **Verify visually.** Set the playhead and call `project.ExportCurrentFrameAsStill(path)` at representative times, then look at the stills before reporting.
-6. Optionally render (`AddRenderJob` / `StartRendering`) and upload the result back to Kolbo with `upload_media` so it lands in the user's library.
-
-### Verified gotchas
-
-- **`MediaPool.ImportMedia` needs plain path strings.** The dict form in the 21.1 stubs (`[{"FilePath": ...}]`) returned `None`. On Windows, backslash paths worked.
-- **File import fails in `run_script`**; use `run_script_unsafe` for anything that touches files.
-- **`Timeline.InsertFusionTitleIntoTimeline("Text+")` is a ripple insert** into every unlocked track: it splits the clips and music under the playhead. With those tracks locked it inserts nothing. For a title over a shot, build it inside that clip's Fusion comp (recipe below).
-- `AppendToTimeline` `startFrame` / `endFrame` are **source frames** at the clip's own frame rate (`GetClipProperty("FPS")`). `recordFrame` is a timeline frame; timelines start at `timeline.GetStartFrame()` (86400 = 01:00:00:00 at 24 fps).
-- New projects default to 24 fps and UHD output.
-
-### Recipe: cut, transition, music fade, title
-
-```python
-pm = resolve.GetProjectManager()
-original = project.GetName()
-pm.SaveProject()
-proj = pm.CreateProject("Kolbo Edit") or pm.LoadProject("Kolbo Edit")
-mp = proj.GetMediaPool()
-
-paths = [r"C:\media\shot1.mp4", r"C:\media\shot2.mp4", r"C:\media\music.mp3"]
-items = {item.GetName(): item for item in mp.ImportMedia(paths)}
-shot1, shot2, music = items["shot1.mp4"], items["shot2.mp4"], items["music.mp3"]
-
-tl = mp.CreateEmptyTimeline("Kolbo Promo")
-proj.SetCurrentTimeline(tl)
-fps = float(proj.GetSetting("timelineFrameRate"))
-start = tl.GetStartFrame()
-
-def src(item, a, b):
-    clip_fps = float(item.GetClipProperty("FPS") or fps)
-    return int(a * clip_fps), int(b * clip_fps) - 1
-
-s1, e1 = src(shot1, 0.5, 6.5)
-s2, e2 = src(shot2, 1.0, 7.0)
-clips = mp.AppendToTimeline([
-    {"mediaPoolItem": shot1, "startFrame": s1, "endFrame": e1, "mediaType": 1, "trackIndex": 1, "recordFrame": start},
-    {"mediaPoolItem": shot2, "startFrame": s2, "endFrame": e2, "mediaType": 1, "trackIndex": 1, "recordFrame": start + int(6 * fps)},
-])
-audio = mp.AppendToTimeline([{"mediaPoolItem": music, "startFrame": 0, "endFrame": int(12 * fps) - 1,
-                              "mediaType": 2, "trackIndex": 1, "recordFrame": start}])
-
-clips[0].AddTransition({"type": "Cross Dissolve", "category": "simple", "position": "end",
-                        "alignment": "center", "duration": int(fps)})
-audio[0].SetFades({"FadeIn": int(0.5 * fps), "FadeOut": int(2 * fps)})
-
-# Title inside shot 1's Fusion comp, fading in and out (Blend keyframes are clip frames).
-comp = clips[0].AddFusionComp()
-media_in, media_out = comp.FindTool("MediaIn1"), comp.FindTool("MediaOut1")
-text = comp.AddTool("TextPlus", -32768, -32768)
-text.SetInput("StyledText", "KOLBO x DAVINCI RESOLVE")
-text.SetInput("Size", 0.085)
-text.SetInput("Font", "Arial")
-text.SetInput("Style", "Bold")
-merge = comp.AddTool("Merge", -32768, -32768)
-merge.ConnectInput("Background", media_in)
-merge.ConnectInput("Foreground", text)
-media_out.ConnectInput("Input", merge)
-merge.AddModifier("Blend", "BezierSpline")
-for value, frame in ((0.0, 6), (1.0, 24), (1.0, 96), (0.0, 120)):
-    merge.SetInput("Blend", value, frame)
-
-pm.SaveProject()
-result = {"project": proj.GetName(), "timeline": tl.GetName(), "original": original}
-```
-
-Then verify, and restore the user's project when you are done:
-
-```python
-tl = project.GetCurrentTimeline()
-tl.SetCurrentTimecode("01:00:02:00")
-ok = project.ExportCurrentFrameAsStill(r"C:\media\check-2s.png")
-resolve.GetProjectManager().SaveProject()
-resolve.GetProjectManager().LoadProject("<original project name>")
-result = {"still": ok}
-```
-
-### Completion proof
-
-- Look at exported stills at the title, the transition and the end before reporting.
-- Report which project and timeline you built, that the original project was saved and restored, and where any render landed.