agentcut 0.2.23 → 0.2.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/dist/studio/canvas.d.ts +3 -0
  2. package/dist/studio/canvas.js +10 -2
  3. package/dist/studio/canvas.js.map +1 -1
  4. package/dist/studio/chat.js +6 -0
  5. package/dist/studio/chat.js.map +1 -1
  6. package/dist/studio/host.d.ts +2 -0
  7. package/dist/studio/host.js +30 -5
  8. package/dist/studio/host.js.map +1 -1
  9. package/dist/studio/mcp-guides.js +22 -12
  10. package/dist/studio/mcp-guides.js.map +1 -1
  11. package/dist/studio/read-batch.d.ts +45 -0
  12. package/dist/studio/read-batch.js +25 -0
  13. package/dist/studio/read-batch.js.map +1 -0
  14. package/dist/studio/review-plan.d.ts +53 -0
  15. package/dist/studio/review-plan.js +52 -0
  16. package/dist/studio/review-plan.js.map +1 -0
  17. package/dist/studio/tools.js +14 -3
  18. package/dist/studio/tools.js.map +1 -1
  19. package/dist/studio/video-creation.d.ts +15 -0
  20. package/dist/studio/video-creation.js +90 -0
  21. package/dist/studio/video-creation.js.map +1 -0
  22. package/dist/studio/voice/kokoro-catalog.d.ts +253 -0
  23. package/dist/studio/voice/kokoro-catalog.js +285 -0
  24. package/dist/studio/voice/kokoro-catalog.js.map +1 -0
  25. package/dist/studio/voice/kokoro.d.ts +5 -0
  26. package/dist/studio/voice/kokoro.js +152 -0
  27. package/dist/studio/voice/kokoro.js.map +1 -0
  28. package/dist/studio/voice/registry.js +2 -0
  29. package/dist/studio/voice/registry.js.map +1 -1
  30. package/dist/studio/voice/types.d.ts +8 -0
  31. package/dist/studio/voice.d.ts +6 -0
  32. package/dist/studio/voice.js +10 -19
  33. package/dist/studio/voice.js.map +1 -1
  34. package/package.json +56 -54
  35. package/template/skill/SKILL.md +34 -1
  36. package/template/skill/references/efficient-review.md +71 -0
  37. package/template/skill/references/feature-launch.md +30 -0
  38. package/template/skill/references/how-to.md +161 -0
  39. package/template/skill/references/product-launch.md +131 -0
  40. package/template/skill/references/sound.md +9 -5
  41. package/template/skill/references/website-howto.md +4 -0
@@ -1 +1 @@
1
- {"version":3,"file":"voice.js","sourceRoot":"","sources":["../../src/studio/voice.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"voice.js","sourceRoot":"","sources":["../../src/studio/voice.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,54 +1,56 @@
1
- {
2
- "name": "agentcut",
3
- "version": "0.2.23",
4
- "description": "Local helper for Agentcut: runs your coding agent (Claude Code or Codex), your video workspace and live preview bundles for the Agentcut studio page.",
5
- "license": "MIT",
6
- "type": "module",
7
- "bin": {
8
- "agentcut": "dist/studio/cli.js"
9
- },
10
- "publishConfig": {
11
- "access": "public"
12
- },
13
- "repository": {
14
- "type": "git",
15
- "url": "git+https://github.com/deifos/Agentcut.git",
16
- "directory": "packages/agentcut"
17
- },
18
- "files": [
19
- "dist",
20
- "template",
21
- "README.md",
22
- "LICENSE"
23
- ],
24
- "scripts": {
25
- "build": "tsc",
26
- "typecheck": "tsc --noEmit",
27
- "studio": "tsx src/studio/cli.ts",
28
- "sync:skill": "node scripts/sync-studio-skill.mjs",
29
- "prepack": "npm run sync:skill && npm run build"
30
- },
31
- "keywords": [
32
- "agentcut",
33
- "mcp",
34
- "remotion",
35
- "video",
36
- "claude-code",
37
- "codex"
38
- ],
39
- "engines": {
40
- "node": ">=20.10"
41
- },
42
- "dependencies": {
43
- "@modelcontextprotocol/sdk": "^1.29.0",
44
- "agent-browser": "0.41.0",
45
- "esbuild": "^0.28.2",
46
- "smol-toml": "^1.9.1",
47
- "zod": "^3.25.76"
48
- },
49
- "devDependencies": {
50
- "@types/node": "^24.0.3",
51
- "tsx": "^4.20.3",
52
- "typescript": "^5.8.3"
53
- }
54
- }
1
+ {
2
+ "name": "agentcut",
3
+ "version": "0.2.25",
4
+ "description": "Local helper for Agentcut: runs your coding agent (Claude Code or Codex), your video workspace and live preview bundles for the Agentcut studio page.",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "bin": {
8
+ "agentcut": "dist/studio/cli.js"
9
+ },
10
+ "publishConfig": {
11
+ "access": "public"
12
+ },
13
+ "repository": {
14
+ "type": "git",
15
+ "url": "git+https://github.com/deifos/Agentcut.git",
16
+ "directory": "packages/agentcut"
17
+ },
18
+ "files": [
19
+ "dist",
20
+ "template",
21
+ "README.md",
22
+ "LICENSE"
23
+ ],
24
+ "scripts": {
25
+ "build": "tsc",
26
+ "typecheck": "tsc --noEmit",
27
+ "studio": "tsx src/studio/cli.ts",
28
+ "sync:skill": "node scripts/sync-studio-skill.mjs",
29
+ "prepack": "npm run sync:skill && npm run build"
30
+ },
31
+ "keywords": [
32
+ "agentcut",
33
+ "mcp",
34
+ "remotion",
35
+ "video",
36
+ "claude-code",
37
+ "codex"
38
+ ],
39
+ "engines": {
40
+ "node": ">=20.10"
41
+ },
42
+ "dependencies": {
43
+ "@modelcontextprotocol/sdk": "^1.29.0",
44
+ "agent-browser": "0.41.0",
45
+ "esbuild": "^0.28.2",
46
+ "kokoro-js": "1.2.1",
47
+ "smol-toml": "^1.9.1",
48
+ "zod": "^3.25.76",
49
+ "@huggingface/transformers": "3.8.1"
50
+ },
51
+ "devDependencies": {
52
+ "@types/node": "^24.0.3",
53
+ "tsx": "^4.20.3",
54
+ "typescript": "^5.8.3"
55
+ }
56
+ }
@@ -43,6 +43,39 @@ working setup. Keep the full creative and review workflow below, including forma
43
43
  music, sound and visual checks. Remove stalled waits and repeated setup without reducing quality.
44
44
  User-requested scope and existing project choices take priority.
45
45
 
46
+ ## How-to
47
+
48
+ For the **How-to** chat action or a request for a tutorial, walkthrough, or video that teaches a
49
+ software task, read `references/how-to.md` first (`agentcut_guide` through MCP). Keep the user's
50
+ brief, uploads, style and music. A bare request without a task or project material needs only:
51
+ "What should viewers learn to do? Add a URL, recording, or a short description of the task."
52
+ Ask immediately; do not search libraries or other projects to guess the task. Use the normal studio
53
+ workflow, not the release-job API, which does not support how-to jobs.
54
+
55
+ New-video actions create a separate canvas video when the current edit has content; a truly empty
56
+ video is reused. Work only on the assigned target. Keep the source video unchanged. Explicit edit
57
+ requests stay on the intended edit; ask which destination for ambiguous requests before changing it.
58
+
59
+ ## Feature Launch
60
+
61
+ For the **Feature Launch** chat action or a written request to announce a new feature or capability,
62
+ read `references/feature-launch.md` first (through `agentcut_guide` when using MCP). Focus on one new
63
+ benefit, a real demonstration, the visible result and one next step. A problem statement is optional.
64
+ A bare request needs the feature and benefit before work; old product identity or incidental footage
65
+ alone does not identify the new feature. Keep the normal asset, motion, sound and full final review
66
+ workflow. Use a separate canvas video when the current edit is populated.
67
+
68
+ ## Product Launch
69
+
70
+ For the **Product Launch** chat action or a written request for a product launch video, product reveal,
71
+ launch film, or video to introduce a new product, read `references/product-launch.md` first
72
+ (through `agentcut_guide` when using MCP). Use the same guide with uploaded footage or from scratch.
73
+ Keep the user's brief, attachments and selected style/music. Inspect existing material before asking
74
+ for input. For a bare request without product context or project material, ask what is launching and
75
+ for a URL or short description immediately; do not scan libraries, sources or other projects to guess.
76
+ This is a creative brief, not a fixed template or the release capture prototype below.
77
+ Use that prototype only when its real-app capture workflow is requested or needed for verified proof.
78
+
46
79
  ## Release announcements from a real app
47
80
 
48
81
  This flow must work from the app URL, user brief and browser-visible UI. Source-code access is
@@ -303,7 +336,7 @@ scripts from the project folder (e.g. composing music or fetching CC0 sounds, se
303
336
  | `agentcut_preview_check` | does the live preview keep up? dropped frames per clip (see `references/performance.md`) |
304
337
  | `agentcut_import_reference` | Style Spy: a reference video plus sampled frames (see `references/style-spy.md`) |
305
338
  | `agentcut_inspect_reference` | Inspect consecutive source frames and crop a caption or graphic for measurement |
306
- | `agentcut_voice_options` / `_generate_voice` | voice-overs with the user's own provider (see `references/sound.md`) |
339
+ | `agentcut_voice_options` / `_generate_voice` | free local Kokoro by default; paid only on explicit user selection (see `references/sound.md`) |
307
340
  | `agentcut_components` | the component library: search, then `id` for props and a ready clip |
308
341
  | `agentcut_music_catalog` / `_add_catalog_music` | the Agentcut music library (200+ hosted songs) |
309
342
  | `agentcut_broll_search` / `_add_broll` | archival public-domain footage by meaning (see `references/broll.md`) |
@@ -0,0 +1,71 @@
1
+ # Group reads and review changed shots
2
+
3
+ Use fewer repeated model turns without removing evidence, craft or final checks. These methods do
4
+ not promise measured token or time savings. They do not change provider settings or compact history.
5
+
6
+ ## Independent reads in one request
7
+
8
+ Once the task and product are known, gather small independent reads together. For MCP,
9
+ `agentcut_read_files` accepts the active `project` and up to 12 `files`, each with `scope`, `path`,
10
+ optional configured source ID, and optional one-based inclusive `startLine`/`endLine`. Examples of
11
+ independent inputs are project.json, layers.json and notes.md, or already-located source UI sections.
12
+ Use `agentcut_guide` with `paths` to read up to six known supporting guides together. Single-guide
13
+ `path` remains supported. Do not load every reference just because a batch is possible.
14
+
15
+ The file batch uses the existing file-read permission checks and returns every result in request
16
+ order. Check each `ok`, scope, range, completeness and hash. It returns an explicit error for a file
17
+ that exceeds the remaining 96,000-character content budget; that file was not reviewed. A range's
18
+ hash covers the full original file, not only the excerpt. Keep hashes for normal conflict-safe writes.
19
+ Do not write from an excerpt when missing context could affect correctness. Narrow the range
20
+ or request the needed full file, without silently omitting evidence.
21
+
22
+ With local shell/file access, read those independent files or sections in one tool execution. Reuse
23
+ current material; avoid repeated whole-repository scans or rediscovering known brand/source paths.
24
+ Keep dependencies sequential: first list to find a path, then read it; first read before a write.
25
+ Do not parallelize edits, capture, contact sheets, audio analysis/review, preview checks or exports.
26
+ If an older helper does not advertise a new batching tool, use existing file tools grouped in
27
+ one local execution when permitted. Do not repeatedly call an unknown method or restart services.
28
+
29
+ ## Intermediate picture checks
30
+
31
+ After an edit, call status for build/validation. For a change confined to known shots, use
32
+ `agentcut_review_plan` with `scope: "shot"` and their current clip IDs. It reads the project and
33
+ timeline together and returns concrete calls to existing capture and preview tools. It does not
34
+ render, edit, export or certify quality. Inspect and execute relevant calls in sequence.
35
+
36
+ The plan samples the changed shot's entrance, hold, exit and neighboring boundaries in all project
37
+ variants, including variant timing overrides. Add exact narration, action/result, focus, lift or
38
+ caption cue frames that the proposed samples miss. Samples are full frames, so overlays and nearby
39
+ content remain visible. Crop only for a detail diagnosis, never as the sole layout proof.
40
+
41
+ Use `agentcut_capture_frames` with explicit `frames` for small changed-shot probes. The existing
42
+ `agentcut_contact_sheet` also supports explicit `frames`, or inclusive `from`/`to` plus `every` for
43
+ a bounded sequence. The existing `agentcut_preview_check` supports `from`/`to`; check changed heavy
44
+ shots rather than replaying the whole video after every small revision. The planner splits its
45
+ preview suggestions into ranges of at most 60 seconds. These are suggestions, not passed checks.
46
+
47
+ Scope must broaden in these cases:
48
+
49
+ - A shared scene, component, asset, font, palette, style, layout helper or camera function changes:
50
+ use `scope: "shared"` unless every consumer is known and included. Check all affected variants.
51
+ - A clip moves, a trim/duration changes, a shot is removed, or music/voice/SFX timing changes:
52
+ use `scope: "timing"`. Check old and new boundaries, overlaps and sync; a current ID alone cannot
53
+ describe a removed shot. Re-read the timeline and regenerate the plan after further edits.
54
+ - The affected scope is uncertain, or a probe reveals a new problem outside the shot: widen the
55
+ review. A passed earlier check is stale for any range or variant affected by the new change.
56
+
57
+ Shared and timing plans broaden to full-project samples. Add focused transition/cue probes
58
+ where uniform sampling misses a critical moment. Unknown clip IDs in shot scope are errors, not
59
+ permission to skip them. Do not call a plan complete until its actual checks pass.
60
+
61
+ ## Final review remains complete
62
+
63
+ Before hand-off, review full wide/mobile contact sheets and the complete story/procedure, confirm
64
+ readable actions and the actual success state, review captions, measure the mix and cue sync with
65
+ `agentcut_listen_critique`, and finish playback checks for heavy scenes. The planner always returns
66
+ `finalReviewRequired: true` and full-project picture/audio calls in each variant. Use current project
67
+ variants, including any user-added size. Follow the main skill's review and export rules.
68
+
69
+ Run page-heavy tasks sequentially. On timeout inspect `agentcut_status.page.activeWork` before retrying,
70
+ as `references/website-howto.md` requires. A smaller probe helps recover or diagnose; it cannot
71
+ replace final picture/sound checks or lower render quality.
@@ -0,0 +1,30 @@
1
+ # Feature Launch
2
+
3
+ Use this guide for the Feature Launch chat action or a request to announce one new feature or capability. Also read `product-launch.md` for brand, capture, visual, sound and final review standards. Feature Launch has its own brief and story; it is not a whole-product introduction or a step-by-step lesson.
4
+
5
+ ## Identify the feature before work
6
+
7
+ For a bare request, ask which feature is new and what people can now do. A product URL or an old launch alone does not identify the feature. Ask locally before an agent run when possible. Do not scan other projects or shared libraries to guess. Preserve deliberate attachments, current brief, selected style and music. With supplied context, inspect it first and ask only for missing facts that affect the video.
8
+
9
+ Use the assigned canvas video. A populated source gets a separate target, timeline and chat; keep the source unchanged. Reuse a truly empty video. Explicit edits keep their target. This is the standard creative workflow, not the limited release-job API.
10
+
11
+ ## Plan the story
12
+
13
+ Write the audience, one new benefit, one verified claim and a shot list in notes.md. Default flow:
14
+
15
+ 1. **New benefit.** Open with what people can now do. Name the feature when it helps recognition.
16
+ 2. **Feature in action.** Show a real action and its visible result, with enough context to understand what changed.
17
+ 3. **Outcome.** Make the benefit visible. Use a supported before/after only when the evidence exists. Do not invent time savings, performance figures or customer claims.
18
+ 4. **Next step.** End with one useful action: try the feature, open its location, or read the announcement. State verified availability or plan restrictions when relevant.
19
+
20
+ The problem statement is optional. Existing users often know the problem; do not delay the feature with a repeated product introduction. For a new audience, add only the context required to understand the benefit. Keep one main feature; do not turn the video into a feature list. Choose duration from the material and channel rather than a fixed formula. Respect requested length, aspect ratios, voice, captions and music.
21
+
22
+ For example, a canvas-versions announcement could show making two independent versions, then switching between their timelines and chats. The visible result supports “explore another version while keeping the original.” A How-to would instead explain each step needed to complete that task.
23
+
24
+ ## Build and verify
25
+
26
+ Follow the full Agentcut skill: inspect real assets and the component/3D libraries, plan intentional motion and camera changes, use editable tracks, coordinate music and sound effects, and retain final full-picture and audio review. Do not replace the process with a fixed animation recipe. Use the user's own footage or safe real-app capture. If proof or access is missing, ask for it before building a false demonstration.
27
+
28
+ Use `sound.md` for voice and music. Generic voice-over uses local Kokoro; a paid voice requires explicit user selection. A silent announcement is valid when requested. If voice is used, inspect the take, check its words and use transcription timings for accurate captions. Music must support the action and leave the message clear.
29
+
30
+ Before delivery, verify that viewers can identify the feature, understand its new benefit, see evidence in the actual demonstration, and know the next step. Check small-screen readability, output formats, timing, asset paths, picture and sound. Deliver the editable result only after the normal final review passes.
@@ -0,0 +1,161 @@
1
+ # How-to
2
+
3
+ Help a viewer complete one real task and recognize success. Use this guide for the How-to action,
4
+ tutorial requests and software walkthrough videos. The user's brief, uploaded material, existing edit,
5
+ selected style and music take priority. This is not a fixed scene sequence or a promotional film.
6
+
7
+ ## Establish the task before searching
8
+
9
+ The studio asks locally when the request is empty. If a bare request reaches the agent without a
10
+ task, brief, recording or relevant project material, ask immediately: "What should viewers learn to
11
+ do? Add a URL, recording, or a short description of the task." Stop before tool calls, source or
12
+ library searches, planning or rendering. A project name, generic earlier request, music choice or
13
+ unrelated shared stock does not establish a task. A known product alone may still lack a procedure.
14
+
15
+ This also applies when How-to is clicked while viewing a finished launch or another populated video.
16
+ The old edit, its incidental assets and prior launch conversation do not identify the new tutorial's
17
+ task. Ask locally before creating a destination or sending to the agent. An explicit current task,
18
+ genuinely established tutorial task, or material deliberately attached for the tutorial can proceed.
19
+ Keep project uploads available for inspection after the user answers; do not discard them.
20
+
21
+ With material, inspect the current project and attachments first. Read `references/format.md`,
22
+ `references/footage.md` for recordings, and `references/website-howto.md` for website execution and
23
+ tool recovery. Use media information, source frames and transcripts to find complete actions and
24
+ their results. Do not ask the user to repeat facts already in the brief or a visible recording.
25
+ If one crucial task detail remains missing, ask that one question and continue work that is clear.
26
+ When a user reply is required, state the exact missing input plainly, for example
27
+ "Question for you: Which voice should this use?" or "Still blocked: I need a recording of the task."
28
+ Do not bury the needed action beneath a long completion update or imply that generation continues.
29
+
30
+ ## Obtain the real UI from a task-only brief
31
+
32
+ A request such as "how to add a style to Agentcut" supplies a task. Do not make the user also ask
33
+ for screenshots, captions or an edited video. Proactively obtain authentic evidence:
34
+
35
+ 1. Check relevant captures or recordings already in the target project's assets and its supplied
36
+ source material. Reuse them only if they show the current labels, complete actions and success state.
37
+ 2. Use the supplied or already-known product URL or an already-running local preview. Read the
38
+ relevant routes and control labels from configured source folders if that helps locate the task.
39
+ A source-code read locates controls; it is not a visual or proof that an action works. Do not
40
+ search the home folder for identity or start/restart the user's services as part of discovery.
41
+ 3. Use an available permitted browser capture tool. Prefer a connected browser automation tool
42
+ when it supports actual screenshots/recording. Otherwise the helper includes `agent-browser`:
43
+ read `agent-browser skills get core` and its video-recording reference for the installed version,
44
+ use a named session, open the known URL, inspect the live controls, and take real screenshots or
45
+ a recording into the new video's `assets/`. Inspect before each action and re-inspect afterward.
46
+ The installed CLI supports `screenshot <path>` and `record start <path.webm> --cursor`, followed
47
+ by planned actions and `record stop`. Use only supported commands from its local documentation.
48
+ 4. Demonstrate the requested task in prepared safe demo state, retaining the real pointer/action,
49
+ response and final success state. Do not modify the user's original video to make tutorial footage.
50
+ For Agentcut, use a disposable safe demo video rather than changing the completed launch. Reuse
51
+ existing captures if obtaining that safe state is not possible under the current permissions.
52
+ 5. If sign-in, access, an unknown URL, blocked network permissions or capture capability prevents
53
+ this, ask for the smallest missing link or recording. The user signs in directly; never request
54
+ credentials, cookies or tokens. Do not fabricate screens, bypass a block, or claim code proves UI.
55
+
56
+ `agentcut_capture_frames` captures the edited composition, not an arbitrary website. The release-job
57
+ API still supports announcement only; do not submit a how-to job to it or pretend it captured a task.
58
+ After authentic material exists, add accurate captions or step labels without waiting for a separate
59
+ request, then build and review the editable tutorial. Preserve all earlier edits and source files.
60
+
61
+ ## Plan for someone doing the task
62
+
63
+ Record in `notes.md`: the intended viewer, their starting state and prerequisites, the task they
64
+ will complete, and the visible evidence that confirms success. Show the direction in a few lines.
65
+ For example, "Create a project from a preset" needs the real starting screen, the preset selection,
66
+ the creation action and the newly opened project. A title that says "Easy presets" is not instruction.
67
+
68
+ Use a task title with a clear action. Start with the useful result or a brief orientation, then give
69
+ the minimum context needed to begin. Teach the actual procedure in its dependency order. Put any
70
+ necessary account, permission or prepared-file condition before the first action that needs it.
71
+ Do not turn the tutorial into a tour of every feature. Split distinct goals when the user requests
72
+ several tutorials; do not silently omit a required step to hit an arbitrary duration.
73
+
74
+ Build a flexible cue sheet. For each step note the source range or real captured view, exact control
75
+ label, action, visible reaction, focus region, text or narration cue and readable hold. Mark the
76
+ final state that proves success. Choose length from the requested duration and the time needed to
77
+ understand the steps. No duration slider or camera vocabulary is required from the user.
78
+
79
+ ## Real actions and useful cues
80
+
81
+ - Use real screenshots and recordings from the current app or user material as the procedural
82
+ evidence. A screenshot can orient the viewer or show a result; it must not imply that an unseen
83
+ click was verified. Capture a missing transition or state clearly what remains unverified.
84
+ - Follow the main skill's website safety rules. Inspect before capture. Use safe sample content;
85
+ do not submit live messages, change settings or expose credentials to make a tutorial. If a write
86
+ action needs user preparation or authorization, explain the missing step. Do not invent it.
87
+ - Preserve actual labels, cursor targets, menu state, entry values and system feedback. Do not
88
+ replace procedural evidence with an imagined UI or pretend a decorative animation is a capture.
89
+ Any explanatory reconstruction must be clearly identified and must not be the only proof.
90
+ - Show where to act, the action, then its result. Give the viewer a stable pause at meaningful step
91
+ boundaries instead of relying on them to discover where to pause. Trim idle waits but retain
92
+ feedback that explains progress and completion. Speed up typing only when the entered value and
93
+ result remain clear. Keep important errors and their recovery when relevant to the task.
94
+ - Use a brief highlight, pointer or close-up on the relevant control as the instruction reaches it.
95
+ Do not cue several competing objects. Start wide enough for orientation, move to the detail,
96
+ then hold sharp and readable through the action and reaction. Follow cursor metadata when present
97
+ (`references/cursor.md`). Keep the current step and progress clear without excessive labels.
98
+ - Narration should explain the action as it appears. Use plain action words and exact UI labels.
99
+ Do not narrate a click several seconds before or after the visible action. For a silent tutorial,
100
+ place concise step instructions next to the demonstrated action and hold them long enough to read.
101
+
102
+ ## Brand, library, motion and sound
103
+
104
+ Match the app's actual logos, fonts, colors and spacing. Discover useful existing project images,
105
+ B-roll, recordings, music and effects even when they are not chat attachments: list project `assets/`
106
+ with `agentcut_list_files`, then relevant shared library folders with `scope: "library"`. Follow
107
+ pagination and inspect relevant subfolders. Use `assets/...` and `library:...` media paths. Do not scan
108
+ other projects or every source directory to guess the task. Reuse known allowed source locations for
109
+ brand checks; if one is missing, ask instead of searching the home folder. Tell the user they can
110
+ drop a specific missing asset into the Library panel; a second chat attachment is not required.
111
+
112
+ Use B-roll only when it explains the task without hiding an essential step. Reuse existing components
113
+ and relevant assets; do not generate replacements by default. With website source available, inspect
114
+ the exact relevant components rather than reading the whole repository repeatedly.
115
+
116
+ Read `references/cinematic.md` when using camera depth or devices. Use existing `Device3D` hardware
117
+ for visible phones and computers. Smooth motion, backgrounds and restrained brand effects can frame
118
+ the tutorial, but essential UI must stay sharp, upright enough to read and clear of captions. Blur,
119
+ perspective and zoom should lead into a readable hold. Do not carry launch-film energy through every
120
+ instructional step. Keep optional backgrounds quiet during the action.
121
+
122
+ Read `references/sound.md`. Preserve a selected song; balance it below speech and keep busy music or
123
+ effects away from difficult steps. Use a small sound on a meaningful action, not every pointer move.
124
+ Caption narration accurately using the transcription workflow. Correct names, numbers and UI labels;
125
+ include meaningful non-speech audio when needed to understand the task. Captions must follow the
126
+ audio and avoid controls, results and the cursor target. Do not require voice for a silent brief.
127
+
128
+ ## Success and review
129
+
130
+ Read `references/efficient-review.md`. Group independent file/guide reads and target changed shots
131
+ during revisions. Broaden after shared or timing changes; retain the complete final review below.
132
+
133
+ End at the real successful state. Tell the viewer what to check, for example the saved item appearing
134
+ in its list or an exported file opening correctly. An optional short "Try it with your own project"
135
+ prompt can encourage practice. Do not claim that an extra replay or recap guarantees learning.
136
+
137
+ Use the normal build and review loop: editable scene, text, footage and audio clips, status after
138
+ changes, source-frame checks, wide and mobile contact sheets, audio measurements and heavy-scene
139
+ playback checks. Check that a novice could follow every action without guessing a hidden step.
140
+ Check the order, cue timing, pointer visibility, label accuracy, reading time, final state and caption
141
+ placement. Retain both-format and sound review. Export only when requested.
142
+
143
+ Reuse current material and passed checks. Check changed regions first, then review the complete edit
144
+ in both formats. Run page-heavy checks in sequence as `website-howto.md` requires. If a tool stalls,
145
+ inspect active work before retrying. Record what passed and what remains blocked; do not claim a
146
+ build alone proves instructional accuracy.
147
+
148
+ ## Evidence used for this guide
149
+
150
+ The application above is original Agentcut guidance, informed by these primary sources. These studies
151
+ do not establish a universal video length or guarantee an outcome for Agentcut users.
152
+
153
+ - [Software-training research (2013)](https://ris.utwente.nl/ws/portalfiles/portal/6827789/s4.pdf)
154
+ supports task-focused demonstrations, accurate interfaces and coordinated action and narration.
155
+ - [A controlled study of pause and navigation guidance (2022)](https://pmc.ncbi.nlm.nih.gov/articles/PMC9610327/)
156
+ supports explicit help for when to pause and review. Its experiment used educational material,
157
+ so applying it to software-step holds is a design inference.
158
+ - [A software-tutorial study of reviews (2018)](https://research.utwente.nl/en/publications/supporting-motivation-task-performance-and-retention-in-video-tut/)
159
+ found no extra benefit from its review or second-demonstration conditions. Keep recaps purposeful.
160
+ - [W3C caption guidance](https://www.w3.org/WAI/media/av/captions/) calls for synchronized, accurate
161
+ captions and correction of automatic output. This informs the caption review above.
@@ -0,0 +1,131 @@
1
+ # Product Launch
2
+
3
+ Make a product film that gives a specific audience one clear reason to care and a clear next step.
4
+ Use this guide for the Product Launch action and equivalent written requests. It works with an empty
5
+ project, uploaded footage, screenshots, an existing edit, or product context already in the chat.
6
+ The user's request takes priority. Keep their context, attachments, style, music and hand edits.
7
+
8
+ ## Check product context first
9
+
10
+ If the request only asks for a launch video and has no product brief, URL, attached material,
11
+ project footage or relevant project assets, ask immediately: "What are you launching? Add a product
12
+ URL or a short description." Stop there. Do not call tools, scan the shared library or source folders,
13
+ search other projects, plan scenes or render to guess the product. A project name, a generic earlier
14
+ launch request, an assistant's unanswered intake question, music choice or shared library stock does
15
+ not establish product identity. The studio handles this empty intake locally without an agent call;
16
+ use this early exit when a bare request reaches you by another path.
17
+
18
+ Use genuinely established user context when present. With project footage or relevant project assets,
19
+ inspect that material first. Once the product is known, discover supporting library assets below.
20
+ If project material still cannot identify the product, ask the same short question instead of widening
21
+ the search to unrelated projects or sources. Keep the original launch request and the user's answer.
22
+
23
+ ## Start with evidence
24
+
25
+ - Read the studio context, project files, notes and attached material. Inspect the current timeline
26
+ before changing it. Read `references/format.md` and `references/footage.md` when footage is present.
27
+ - Discover material beyond the chat attachments. Call `agentcut_list_files` with `scope: "project"`,
28
+ the active project slug and `path: "assets"`, then with `scope: "library"` and `path: ""`.
29
+ Follow `nextOffset` and open relevant subfolders; listings are not recursive. This includes items
30
+ dropped into the project Library panel without a chat attachment or timeline clip. Inspect relevant
31
+ images, B-roll, recordings, music and effects before fetching or generating replacements. Do not
32
+ assume every file is useful: match it to the benefit, brand and proof, then use the relevant items.
33
+ Project files use `assets/...`; shared files use `library:...` in media tools. Use
34
+ `agentcut_copy_file` with `scope: "library"` to copy a needed shared asset into project `assets/`
35
+ when required. With local disk access, inspect these same folders. Do not limit discovery to files
36
+ named in the message. If a specific required asset is missing, tell the user they can drop it into
37
+ the Library panel; re-list the files after they do. Do not require a second chat attachment.
38
+ - With recordings, use `agentcut_media_info`, sample frames and inspect transcripts when useful.
39
+ Find the actual action and visible result. Note useful source ranges, weak material and gaps.
40
+ Do this before proposing a story or asking the user to explain material you can inspect.
41
+ - From scratch, first establish the product from the user's brief or previous user context. Then use
42
+ the brief, existing project and library assets, product URL and allowed source
43
+ folders. Use `agentcut_sources` for configured folders. Do not require source code. Inspect what
44
+ is available before requesting more. A URL alone does not prove every product claim.
45
+ - Ask only for the minimum missing input that blocks an honest film. If the product is unknown,
46
+ ask for its name and a link or short description. If the intended viewer or next step cannot be
47
+ inferred, ask for the missing item in one short question. Do not send a blank questionnaire or
48
+ ask again for facts already supplied. State reasonable low-risk assumptions and continue.
49
+ - Never invent customer quotes, numbers, integrations, capabilities or UI evidence. If a required
50
+ claim lacks proof, narrow the claim to what is visible or ask for the missing material. Label
51
+ any user-approved illustration as an illustration. Follow the real-app capture safety rules in
52
+ the main skill when recording a website. Do not rebuild an app and present it as a real capture.
53
+
54
+ ## Write a flexible brief
55
+
56
+ Record a short brief in `notes.md` and show the direction in two or three lines in chat:
57
+
58
+ - **Audience:** who needs this product, and the task or problem they recognize.
59
+ - **One benefit:** the single outcome this film will make clear, in the product's own language.
60
+ - **Proof:** for each claim, the exact source range, screenshot region or verified interaction that
61
+ demonstrates it. Pair the words with a visible action and result. Remove unsupported claims.
62
+ - **Next step:** one specific action, with the real destination or product name. Do not invent a URL.
63
+ - **Delivery:** use the requested format, duration and tone; infer sensible defaults from the use
64
+ case when they are absent. Let the amount of proof and reading time determine the cut length.
65
+ Honor a length stated in plain language. Do not require a duration slider or a length choice to start.
66
+
67
+ Consider at least two distinct openings before choosing one. Examples include a useful result first,
68
+ a recognizable problem with an immediate demonstration, a surprising verified detail, or a product
69
+ reveal with a short promise. Compare them against the available material and audience. Record the
70
+ choice and its reason in notes. Do not force a device orbit or logo reveal onto every film.
71
+
72
+ Build the story around the strongest proof. A shot can introduce the problem, show an action, reveal
73
+ the result or explain the next step; combine or omit these functions when the material supports it.
74
+ There is no required shot count, fixed order, duration per shot or mandatory sequence. Choose frame
75
+ ranges only after the story works. Each planned shot needs a purpose, source, claim, focus target,
76
+ readable hold and sound cue. Do not use decorative motion to conceal a missing demonstration.
77
+
78
+ ## Brand and visual direction
79
+
80
+ - Inspect the repository or allowed product source, website and supplied assets for actual logos,
81
+ colors, typography, product names and UI. Reuse the brand assets and match their proportions,
82
+ clear space, spelling and color. Do not replace a real logo with typed text or an invented symbol.
83
+ - Show an integration only when the material or official product information verifies it. Use that
84
+ integration's official mark from supplied/repository assets or its official brand source. Do not
85
+ draw an approximate logo, imply an unverified partnership or add unrelated brand marks. If the
86
+ official asset is unavailable, use an accurate plain-text label or omit the mark.
87
+ - Read `references/cinematic.md` for its toolkit, camera guidance and quality gate. Use its existing
88
+ `Device3D` models whenever a phone, laptop or desktop device is visible. Check available library
89
+ models and their license rules. Do not draw flat hardware frames. Browser windows and frameless
90
+ detail views can use `Screen`; respect export rules and keep proof sharp.
91
+ - Use a purposeful pan to connect an action to its result, a zoom to reveal a relevant detail,
92
+ perspective to show useful depth, and lens or motion blur to guide attention during a move.
93
+ Choose the moves that serve this brief. Do not apply every effect to every shot. Settle the camera
94
+ and focus for readable holds; keep essential UI, claims and the next step legible in each format.
95
+ - For a website, choose the camera treatment automatically from the plain-language request and the
96
+ inspected page. Show enough of the full view to establish the product, move from wide to the detail
97
+ that proves the benefit, then pause in focus while the viewer reads the action and result. Adjust
98
+ the crop, perspective, move speed and hold to the actual content. The user does not need to name a
99
+ camera technique or open Cinematic Mode. Avoid a continuous fly-over that never lets the UI settle.
100
+ - Use `references/loops.md`, `references/craft.md` and the component catalog for brand-matched
101
+ backgrounds and editable graphics. Keep decoration below the product's visual priority.
102
+
103
+ The cinematic guide supplies tools and quality checks. Its suggested shot arc and example timings
104
+ do not replace this brief. Fit the edit to the product, evidence and user request.
105
+
106
+ ## Sound and build
107
+
108
+ Read `references/sound.md`. Keep the user's selected music. Otherwise choose music that supports the
109
+ benefit, pace and brand. Analyze beats and meaningful onsets. Synchronize cuts, product actions,
110
+ reveals and result moments with the music where it helps the story. Put a sound effect on a meaningful
111
+ action or transition, not every camera movement. Keep voice and product sounds clear. Use the listen
112
+ tools and record measured mix results; do not claim to have heard the mix.
113
+
114
+ Follow the main skill's build and review loop. Build one beat at a time, keep footage trims, text,
115
+ music and SFX editable on separate timeline clips, and preserve user edits. Use real material for
116
+ proof; graphics can explain it but must not change what the product can do.
117
+
118
+ ## Review before hand-off
119
+
120
+ Read `references/efficient-review.md`. Group independent file/guide reads, use changed-shot probes
121
+ for local revisions, and broaden for shared/timing changes. Keep all final picture and sound checks.
122
+
123
+ Check the whole film, not only attractive stills. Does the opening earn attention from this audience?
124
+ Can a new viewer name the benefit? Does each claim have visible real proof? Can they read the action
125
+ and result without pausing? Is the next step correct and clear? Remove shots that add no meaning.
126
+
127
+ Capture entrances, settled holds and exits in wide and mobile. Inspect full contact sheets, check
128
+ heavy scene playback, and review the mix and cue timing with the existing tools. Fix cropped logos,
129
+ blurred proof, tiny UI, weak contrast, abrupt moves and masking sound. Keep the cinematic quality gate
130
+ and normal preview/export checks. State any remaining evidence gaps. Hand off the editable draft;
131
+ export only when requested.
@@ -71,16 +71,20 @@ masters the rendered audio to −14 LUFS with a true-peak limiter (≤ −1 dBTP
71
71
  what it did (`mastering`: rendered loudness, gain, limiter reduction). Large limiter reduction (> 3 dB)
72
72
  means a few sounds are far louder than the rest: turn those clips down instead of relying on the limiter.
73
73
 
74
+ ## Local voice default
75
+
76
+ Generic voice-over requests use **Kokoro**, even if paid keys are configured. Use paid generation only when the user explicitly requests or selects a paid provider. Preserve explicit provider, voice, language, gender and accent choices. Use `agentcut_voice_options` with provider `kokoro`: its 28 English voices share verified IDs with the human preview samples. `localVoices` includes authored female/male labels, language/accent and preview URLs. `suggestedUses` comes from ScreenSlick's director playbook: Heart for tutorials, Emma for walkthroughs, Bella for demos, Puck for launches and Michael for sales. These are editorial defaults, not measured tone. Do not invent calm/energetic labels. Audition or measure a sample when tone matters; honor constraints before these defaults.
77
+
78
+ The first local generation downloads about 93 MB plus support files. Later calls reuse the model cache. This runtime supports English only, speed 0.5–2, and no style instructions. For setup/offline/language errors, state the error and offer a retry, an English script, or an explicit provider choice. Never silently call paid. WAV output uses the same media-info, transcription, Voice track and word-timed caption workflow below.
79
+
74
80
  ## Voice-overs
75
81
 
76
- The user connects their own voice provider under **Voices** in the studio header (ElevenLabs, Google
77
- Gemini, OpenAI or Grok/xAI). You never see, ask for or mention API keys: the helper adds them.
82
+ Kokoro is available without credentials. Optional paid providers are ElevenLabs, Gemini, OpenAI and Grok/xAI. The helper adds their keys only for explicitly selected paid generation.
78
83
 
79
84
  1. `agentcut_voice_options`: which providers are set up, the default, models and voices. For
80
- ElevenLabs pass `provider: "elevenlabs"` to get the account's voice ids. If nothing is set up, ask the user
81
- to open **Voices** and add a key, and stop there.
85
+ ElevenLabs pass `provider: "elevenlabs"` to get the account's voice ids. Local Kokoro requires no key.
82
86
  2. Write the script in `notes.md` first (one line per beat). Keep the spoken text clean: no stage directions.
83
- 3. `agentcut_generate_voice` with the user's provider/model/voice (or the default). Generate 2 takes
87
+ 3. `agentcut_generate_voice` with Kokoro unless the user explicitly selected a paid provider. Honor their voice/model choice. Generate 2 takes
84
88
  for anything that matters. Delivery notes:
85
89
  - Gemini, OpenAI: `style` ("confident tech launch announcer, upbeat, quick pace, smile on the call to
86
90
  action"; pronunciations like "say V2 as 'vee two'"). Gemini voices: Puck (upbeat), Kore (firm),