agentcut 0.2.15 → 0.2.18

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 (152) hide show
  1. package/README.md +127 -0
  2. package/dist/bridge.d.ts +1 -0
  3. package/dist/bridge.js +9 -4
  4. package/dist/bridge.js.map +1 -1
  5. package/dist/index.js +3 -1
  6. package/dist/index.js.map +1 -1
  7. package/dist/log.js +6 -1
  8. package/dist/log.js.map +1 -1
  9. package/dist/studio/agents/claude.d.ts +22 -1
  10. package/dist/studio/agents/claude.js +89 -3
  11. package/dist/studio/agents/claude.js.map +1 -1
  12. package/dist/studio/agents/types.d.ts +6 -0
  13. package/dist/studio/chat.d.ts +2 -0
  14. package/dist/studio/chat.js +13 -10
  15. package/dist/studio/chat.js.map +1 -1
  16. package/dist/studio/cli.js +43 -21
  17. package/dist/studio/cli.js.map +1 -1
  18. package/dist/studio/editing-styles.d.ts +26 -0
  19. package/dist/studio/editing-styles.js +84 -0
  20. package/dist/studio/editing-styles.js.map +1 -0
  21. package/dist/studio/host.d.ts +13 -2
  22. package/dist/studio/host.js +140 -9
  23. package/dist/studio/host.js.map +1 -1
  24. package/dist/studio/housekeeping.d.ts +16 -0
  25. package/dist/studio/housekeeping.js +152 -0
  26. package/dist/studio/housekeeping.js.map +1 -0
  27. package/dist/studio/http.d.ts +3 -0
  28. package/dist/studio/http.js +25 -0
  29. package/dist/studio/http.js.map +1 -1
  30. package/dist/studio/mcp-files.d.ts +34 -0
  31. package/dist/studio/mcp-files.js +159 -0
  32. package/dist/studio/mcp-files.js.map +1 -0
  33. package/dist/studio/mcp-guides.d.ts +4 -0
  34. package/dist/studio/mcp-guides.js +93 -0
  35. package/dist/studio/mcp-guides.js.map +1 -0
  36. package/dist/studio/projects.d.ts +1 -1
  37. package/dist/studio/providers/http.d.ts +4 -0
  38. package/dist/studio/providers/http.js +23 -0
  39. package/dist/studio/providers/http.js.map +1 -0
  40. package/dist/studio/providers/settings.d.ts +20 -0
  41. package/dist/studio/providers/settings.js +84 -0
  42. package/dist/studio/providers/settings.js.map +1 -0
  43. package/dist/studio/proxies.d.ts +45 -0
  44. package/dist/studio/proxies.js +263 -0
  45. package/dist/studio/proxies.js.map +1 -0
  46. package/dist/studio/references.d.ts +18 -0
  47. package/dist/studio/references.js +21 -4
  48. package/dist/studio/references.js.map +1 -1
  49. package/dist/studio/release-browser.d.ts +25 -0
  50. package/dist/studio/release-browser.js +191 -0
  51. package/dist/studio/release-browser.js.map +1 -0
  52. package/dist/studio/release-cursor.d.ts +3 -0
  53. package/dist/studio/release-cursor.js +27 -0
  54. package/dist/studio/release-cursor.js.map +1 -0
  55. package/dist/studio/release-edit.d.ts +34 -0
  56. package/dist/studio/release-edit.js +183 -0
  57. package/dist/studio/release-edit.js.map +1 -0
  58. package/dist/studio/release-recorder.d.ts +30 -0
  59. package/dist/studio/release-recorder.js +273 -0
  60. package/dist/studio/release-recorder.js.map +1 -0
  61. package/dist/studio/release-video.d.ts +693 -0
  62. package/dist/studio/release-video.js +616 -0
  63. package/dist/studio/release-video.js.map +1 -0
  64. package/dist/studio/render.d.ts +2 -0
  65. package/dist/studio/render.js +33 -15
  66. package/dist/studio/render.js.map +1 -1
  67. package/dist/studio/reveal.d.ts +3 -1
  68. package/dist/studio/reveal.js +26 -8
  69. package/dist/studio/reveal.js.map +1 -1
  70. package/dist/studio/schema.d.ts +23535 -1480
  71. package/dist/studio/schema.js +71 -4
  72. package/dist/studio/schema.js.map +1 -1
  73. package/dist/studio/share.d.ts +2 -0
  74. package/dist/studio/share.js +7 -1
  75. package/dist/studio/share.js.map +1 -1
  76. package/dist/studio/tools.d.ts +4 -0
  77. package/dist/studio/tools.js +113 -8
  78. package/dist/studio/tools.js.map +1 -1
  79. package/dist/studio/transcription/assemblyai.d.ts +11 -0
  80. package/dist/studio/transcription/assemblyai.js +123 -0
  81. package/dist/studio/transcription/assemblyai.js.map +1 -0
  82. package/dist/studio/transcription/local.d.ts +2 -0
  83. package/dist/studio/transcription/local.js +57 -0
  84. package/dist/studio/transcription/local.js.map +1 -0
  85. package/dist/studio/transcription/registry.d.ts +3 -0
  86. package/dist/studio/transcription/registry.js +5 -0
  87. package/dist/studio/transcription/registry.js.map +1 -0
  88. package/dist/studio/transcription/service.d.ts +130 -0
  89. package/dist/studio/transcription/service.js +236 -0
  90. package/dist/studio/transcription/service.js.map +1 -0
  91. package/dist/studio/transcription/types.d.ts +68 -0
  92. package/dist/studio/transcription/types.js +2 -0
  93. package/dist/studio/transcription/types.js.map +1 -0
  94. package/dist/studio/voice/audio.d.ts +1 -0
  95. package/dist/studio/voice/audio.js +18 -0
  96. package/dist/studio/voice/audio.js.map +1 -0
  97. package/dist/studio/voice/elevenlabs.d.ts +2 -0
  98. package/dist/studio/voice/elevenlabs.js +76 -0
  99. package/dist/studio/voice/elevenlabs.js.map +1 -0
  100. package/dist/studio/voice/gemini.d.ts +2 -0
  101. package/dist/studio/voice/gemini.js +95 -0
  102. package/dist/studio/voice/gemini.js.map +1 -0
  103. package/dist/studio/voice/openai.d.ts +2 -0
  104. package/dist/studio/voice/openai.js +75 -0
  105. package/dist/studio/voice/openai.js.map +1 -0
  106. package/dist/studio/voice/registry.d.ts +4 -0
  107. package/dist/studio/voice/registry.js +18 -0
  108. package/dist/studio/voice/registry.js.map +1 -0
  109. package/dist/studio/voice/types.d.ts +42 -0
  110. package/dist/studio/voice/types.js +2 -0
  111. package/dist/studio/voice/types.js.map +1 -0
  112. package/dist/studio/voice/xai.d.ts +2 -0
  113. package/dist/studio/voice/xai.js +80 -0
  114. package/dist/studio/voice/xai.js.map +1 -0
  115. package/dist/studio/voice.d.ts +32 -58
  116. package/dist/studio/voice.js +52 -308
  117. package/dist/studio/voice.js.map +1 -1
  118. package/dist/studio/workspace.d.ts +1 -0
  119. package/dist/studio/workspace.js +1 -0
  120. package/dist/studio/workspace.js.map +1 -1
  121. package/package.json +2 -1
  122. package/template/AGENTS.md +1 -0
  123. package/template/components/CATALOG.md +2 -0
  124. package/template/components/STYLES.md +108 -7
  125. package/template/components/catalog.json +29 -0
  126. package/template/components/color/grade-effect.ts +650 -0
  127. package/template/components/color/grade.ts +512 -0
  128. package/template/components/color/looks.ts +154 -0
  129. package/template/components/hook-card/HookCard.tsx +11 -5
  130. package/template/components/hook-card/meta.json +29 -0
  131. package/template/components/index.ts +14 -0
  132. package/template/components/live-clip.ts +75 -0
  133. package/template/components/sticker-badge/StickerBadge.tsx +4 -2
  134. package/template/components/styles.json +354 -3
  135. package/template/runtime/composition.tsx +283 -25
  136. package/template/runtime/framing.ts +29 -0
  137. package/template/runtime/helpers.tsx +2 -0
  138. package/template/runtime/types.ts +71 -4
  139. package/template/skill/SKILL.md +132 -6
  140. package/template/skill/references/broll.md +2 -1
  141. package/template/skill/references/color.md +79 -0
  142. package/template/skill/references/editing-styles.md +57 -0
  143. package/template/skill/references/footage.md +72 -73
  144. package/template/skill/references/format.md +142 -140
  145. package/template/skill/references/performance.md +14 -2
  146. package/template/skill/references/person-cutout.md +19 -0
  147. package/template/skill/references/person-framing.md +13 -0
  148. package/template/skill/references/presets.md +60 -56
  149. package/template/skill/references/sound.md +151 -151
  150. package/template/skill/references/style-editing.md +20 -0
  151. package/template/skill/references/transcription.md +15 -0
  152. package/template/skill/references/website-howto.md +41 -0
@@ -14,15 +14,16 @@ consistent and switches style in one edit. Set one only to break the style on pu
14
14
 
15
15
  ## Applying a style ("use the Voltrox style", or the Restyle button)
16
16
 
17
- 1. Set `style` in project.json.
18
- 2. Re-cut the graphics the style's way: follow its pacing and its "Reach for" list (component,
17
+ 1. Read `references/style-editing.md`. Transcribe and review the source, then make the speech edit before graphics. Retiming must also update captions and audio.
18
+ 2. Set `style` in project.json. This changes visual defaults; it does not remove speech or create B-roll.
19
+ 3. Re-cut the graphics the style's way: follow its pacing and its "Reach for" list (component,
19
20
  layout and position per job). Swap scene clips that do the same job for those components,
20
21
  keep the words and timings, and drop color/font props they carried.
21
- 3. Hooks frame the speaker the style's way (`hook-card` layout top, stack, collage, window, hud or
22
+ 4. Hooks frame the speaker the style's way (`hook-card` layout top, stack, collage, window, hud or
22
23
  inset): split the speaker's video clip at the hook's end and give the first part the box (and
23
24
  radius) listed for that layout in hook-card's useWhen, so the face shows through the hole.
24
- 4. Captions: remove `style.preset`, colors and fonts from the captions clip so the style draws them.
25
- 5. Capture frames across the video and fix overlaps (word pops vs. captions: keep one in the lower third).
25
+ 5. Captions: remove `style.preset`, colors and fonts from the captions clip so the style draws them.
26
+ 6. Capture frames across the video and fix overlaps (word pops vs. captions: keep one in the lower third).
26
27
 
27
28
  ## Voltrox (`voltrox`)
28
29
 
@@ -148,7 +149,7 @@ Explainer: big bold centered captions, black-and-white line diagrams, punch-in c
148
149
  - Captions carry the video: huge, uppercase, centered, one or two words at a time, the key word in yellow.
149
150
  - Explain every idea with a black full-frame Line Diagram (venn, one to many, growth, cycle, small vs big, stairs) while it is said.
150
151
  - Jump-cut punch-ins every ~2 s; no texture, no color besides the yellow.
151
- - Open with the speaker in a thin white frame under a bold title (Hook Card frame).
152
+ - Open with a centered full-frame title in the line-art look. Use centered diagrams for the explanation, then return to the speaker. Do not use a split header for this opening.
152
153
 
153
154
  Look: `line` · camera: punch (zoom 1.14, every 60 frames) · overlay: none · captions: center, 2 words per line.
154
155
 
@@ -157,7 +158,7 @@ Fallback captions (older pages): Montserrat 900, #ffffff, highlight #ffe600, pre
157
158
  Tokens: look `line` · font `heavy,condensed,archivo` · weight `900` · text `#ffffff` · accent `#ffe600` · onAccent `#000000` · panel `#000000` · panelText `#ffffff` · line `#ffffff` · theme `dark` · backdrop `#000000`
158
159
 
159
160
  Reach for:
160
- - Hook: `hook-card` {"layout":"frame","tagline":""}
161
+ - Hook: `hook-card` {"layout":"full","tagline":"","position":"center","align":"center"}
161
162
  - Explain an idea: `line-diagram` {"background":"#000000"}
162
163
  - A count or price: `sticker-badge` {"position":"top-right","label":""}
163
164
  - List item: `list-card` {"layout":"full"}
@@ -210,6 +211,106 @@ Reach for:
210
211
  - Before / after: `before-after` {"layout":"card"}
211
212
  - Proof: `quote-card` {"layout":"card"}
212
213
 
214
+ ## Signal (`signal`)
215
+
216
+ Direct business advice: charcoal, lime emphasis, bold captions and clear proof.
217
+
218
+ - First transcribe the source with agentcut_transcribe. Review word timings and listen before removing dead air, repeated takes or filler words. Keep breaths, intentional pauses and the meaning of each sentence. Do not remove speech from transcript guesses alone.
219
+ - Build the speech edit first with source trims and split clips. Close the resulting gaps and remap captions, B-roll and audio to the edited timeline. Keep the source files unchanged.
220
+ - Review the picture about every 4–6 seconds for a useful change at a new idea, example or emphasis. Use a modest punch-in, wider reset or relevant B-roll only when it helps. Never insert cuts on a fixed five-second timer. The preset leaves the camera still so shot-level edits control the framing.
221
+ - Use only supplied or approved B-roll and licensed audio. If footage is missing, use a useful text or diagram insert. Keep speech clear above music; measure the mix and check cuts for clicks. A color filter does not restore missing detail or upscale footage.
222
+ - Lead with one useful claim, support it with an example, then give the next action. Keep the speaker prominent. Avoid decorative transitions and constant stickers.
223
+ - Use short three-word caption groups, with lime on the key word. Use one stat counter for a real number and a compact list for actionable steps. Prefer straight cuts; return to the wider shot after an emphasis.
224
+ - Keep skin tones neutral and the backdrop quiet. Use a low, steady music bed only if it helps; silence is valid for direct advice.
225
+ - Open over full-frame footage with a compact left-aligned title card in the lower third (hook-card layout:card, position:lower, align:left). Keep it below the face and above the bottom safe zone; hide captions during this title.
226
+
227
+ Look: `clean` · camera: still · overlay: none · captions: bottom, 3 words per line.
228
+
229
+ Fallback captions (older pages): Montserrat 800, #ffffff, highlight #cbef59, preset pop. Text clips: Montserrat 800, #ffffff.
230
+
231
+ Tokens: look `clean` · font `heavy,condensed` · weight `800` · text `#ffffff` · accent `#cbef59` · onAccent `#ffffff` · panel `#171b18` · panelText `#ffffff` · line `#455241` · theme `dark` · backdrop `#101511`
232
+
233
+ Reach for:
234
+ - Opening promise: `hook-card` {"layout":"card","size":15,"position":"lower","align":"left"}
235
+ - Evidence: `stat-counter` {"suffix":"%","label":"verified result"}
236
+ - Steps: `list-card` {"layout":"card"}
237
+ - Next action: `word-pop` {"position":"lower","tilt":false}
238
+
239
+ ## Studyroom (`studyroom`)
240
+
241
+ Warm lessons: cream pages, teal notes, calm type and clear chapter cards.
242
+
243
+ - First transcribe the source with agentcut_transcribe. Review word timings and listen before removing dead air, repeated takes or filler words. Keep breaths, intentional pauses and the meaning of each sentence. Do not remove speech from transcript guesses alone.
244
+ - Build the speech edit first with source trims and split clips. Close the resulting gaps and remap captions, B-roll and audio to the edited timeline. Keep the source files unchanged.
245
+ - Review the picture about every 4–6 seconds for a useful change at a new idea, example or emphasis. Use a modest punch-in, wider reset or relevant B-roll only when it helps. Never insert cuts on a fixed five-second timer. The preset leaves the camera still so shot-level edits control the framing.
246
+ - Use only supplied or approved B-roll and licensed audio. If footage is missing, use a useful text or diagram insert. Keep speech clear above music; measure the mix and check cuts for clicks. A color filter does not restore missing detail or upscale footage.
247
+ - Organize the lesson into a question, a worked example and a short recap. Keep natural thinking pauses; remove only delays that do not help comprehension.
248
+ - Use warm cream chapter cards with teal emphasis, a rounded speaker inset and six-word caption lines. Show screen recordings or diagrams during the explanation, then return to the face.
249
+ - Apply only a slight warm grade after checking white balance. Use soft music and sparse, quiet reveal sounds. Let each example stay visible long enough to read.
250
+
251
+ Look: `clean` · camera: still · overlay: none · captions: bottom, 6 words per line.
252
+
253
+ Fallback captions (older pages): Inter 600, #ffffff, highlight #1b766b, preset plain. Text clips: Inter 600, #ffffff.
254
+
255
+ Tokens: look `clean` · font `display,sans` · weight `600` · text `#ffffff` · accent `#1b766b` · onAccent `#202b28` · panel `#fff8e8` · panelText `#202b28` · line `#b7c9b6` · theme `light` · backdrop `#f2e8d4`
256
+
257
+ Reach for:
258
+ - Opening promise: `hook-card` {"layout":"inset","size":20}
259
+ - Chapter: `list-card` {"layout":"card"}
260
+ - Worked example: `before-after` {"layout":"full"}
261
+ - Takeaway: `quote-card` {"layout":"card"}
262
+
263
+ ## Afterglow (`afterglow`)
264
+
265
+ Product stories: dark plum, copper titles, detail shots and restrained motion.
266
+
267
+ - First transcribe the source with agentcut_transcribe. Review word timings and listen before removing dead air, repeated takes or filler words. Keep breaths, intentional pauses and the meaning of each sentence. Do not remove speech from transcript guesses alone.
268
+ - Build the speech edit first with source trims and split clips. Close the resulting gaps and remap captions, B-roll and audio to the edited timeline. Keep the source files unchanged.
269
+ - Review the picture about every 4–6 seconds for a useful change at a new idea, example or emphasis. Use a modest punch-in, wider reset or relevant B-roll only when it helps. Never insert cuts on a fixed five-second timer. The preset leaves the camera still so shot-level edits control the framing.
270
+ - Use only supplied or approved B-roll and licensed audio. If footage is missing, use a useful text or diagram insert. Keep speech clear above music; measure the mix and check cuts for clicks. A color filter does not restore missing detail or upscale footage.
271
+ - Build a short product story: reveal, useful detail, demonstration, payoff. Keep the voice edit clean and use supplied close-ups to show the claim.
272
+ - Alternate wide, detail and action shots at meaningful beats. Use match cuts where the source supports them. Use a brief light leak only at a scene change; avoid a transition on every cut.
273
+ - Use large copper serif titles with generous empty space. Reserve captions for spoken explanation. Keep highlights below clipping and avoid heavy orange skin tones.
274
+ - Place music hits and subtle source-backed Foley on actual actions. Do not add fake product sounds or claim speed ramps without source frames and an explicit timeline edit.
275
+
276
+ Look: `clean` · camera: still · overlay: vignette · captions: bottom, 6 words per line.
277
+
278
+ Fallback captions (older pages): Inter 400, #fff5ec, highlight #efa879, preset plain. Text clips: Inter 400, #fff5ec.
279
+
280
+ Tokens: look `clean` · font `serif,display` · weight `400` · text `#fff5ec` · accent `#efa879` · onAccent `#ffffff` · panel `#211923` · panelText `#ffffff` · line `#71545d` · theme `dark` · backdrop `#130f16`
281
+
282
+ Reach for:
283
+ - Opening promise: `hook-card` {"layout":"frame","size":20}
284
+ - Reveal: `light-leak` {"strength":0.35,"hueShift":20}
285
+ - Product contrast: `before-after` {"layout":"full"}
286
+ - Payoff: `word-pop` {"position":"center","tilt":false}
287
+
288
+ ## Fieldnote (`fieldnote`)
289
+
290
+ Documentary notes: ivory serif titles, rust markers, source cards and light grain.
291
+
292
+ - First transcribe the source with agentcut_transcribe. Review word timings and listen before removing dead air, repeated takes or filler words. Keep breaths, intentional pauses and the meaning of each sentence. Do not remove speech from transcript guesses alone.
293
+ - Build the speech edit first with source trims and split clips. Close the resulting gaps and remap captions, B-roll and audio to the edited timeline. Keep the source files unchanged.
294
+ - Review the picture about every 4–6 seconds for a useful change at a new idea, example or emphasis. Use a modest punch-in, wider reset or relevant B-roll only when it helps. Never insert cuts on a fixed five-second timer. The preset leaves the camera still so shot-level edits control the framing.
295
+ - Use only supplied or approved B-roll and licensed audio. If footage is missing, use a useful text or diagram insert. Keep speech clear above music; measure the mix and check cuts for clicks. A color filter does not restore missing detail or upscale footage.
296
+ - Build a setup, a question or conflict, and a supported resolution. Preserve pauses that carry emotion. Use captions as access to the speech, not as invented narration.
297
+ - Use ivory serif chapter titles, rust markers and source labels. Show evidence as supplied images or screen recordings, with a clear source caption. Never invent a quote, date, map or statistic.
298
+ - Use a wider speaker frame for context and a modest closer crop for a personal point. Hold on documents long enough to read. Use light grain and neutral color; preserve natural room tone.
299
+ - Use quote cards only for exact verified words. Keep music sparse under testimony, and finish with the answer to the opening question rather than an unrelated call to action.
300
+ - Open with a centered, full-frame ivory serif chapter card, not torn paper, tape or collage. Cut to the speaker once the question is clear. Keep rust markers small and evidence cards square and quiet.
301
+
302
+ Look: `clean` · camera: still · overlay: grain · captions: bottom, 6 words per line.
303
+
304
+ Fallback captions (older pages): Instrument Serif 400, #ffffff, highlight #b94d32, preset plain. Text clips: Inter 400, #ffffff.
305
+
306
+ Tokens: look `clean` · font `serif,fraunces` · weight `400` · text `#ffffff` · accent `#b94d32` · onAccent `#24251f` · panel `#f4f0e5` · panelText `#24251f` · line `#41463e` · theme `light` · backdrop `#e8e2d4`
307
+
308
+ Reach for:
309
+ - Opening promise: `hook-card` {"layout":"full","position":"center","align":"center","size":18}
310
+ - Verified quote: `quote-card` {"layout":"full"}
311
+ - Evidence summary: `list-card` {"layout":"full"}
312
+ - Chapter marker: `word-pop` {"position":"lower","tilt":false}
313
+
213
314
  ## Props that follow the style
214
315
 
215
316
  | component | props (token) |
@@ -3291,6 +3291,26 @@
3291
3291
  "style": "text",
3292
3292
  "label": "Text on video",
3293
3293
  "default": "#ffffff"
3294
+ },
3295
+ "position": {
3296
+ "type": "select",
3297
+ "label": "Title position",
3298
+ "default": "center",
3299
+ "options": [
3300
+ {
3301
+ "value": "top",
3302
+ "label": "Top"
3303
+ },
3304
+ {
3305
+ "value": "center",
3306
+ "label": "Center"
3307
+ },
3308
+ {
3309
+ "value": "lower",
3310
+ "label": "Lower third"
3311
+ }
3312
+ ],
3313
+ "help": "Title position for full-frame and floating-card layouts. Framed speaker layouts keep the title beside their footage."
3294
3314
  }
3295
3315
  },
3296
3316
  "examples": [
@@ -3329,6 +3349,15 @@
3329
3349
  "sub": "",
3330
3350
  "tagline": ""
3331
3351
  }
3352
+ },
3353
+ {
3354
+ "name": "Lower title over footage",
3355
+ "props": {
3356
+ "layout": "card",
3357
+ "position": "lower",
3358
+ "align": "left",
3359
+ "size": 14
3360
+ }
3332
3361
  }
3333
3362
  ]
3334
3363
  },