@machinal/mcp 0.0.0-stage → 0.4.0

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 (173) hide show
  1. package/README.md +361 -2
  2. package/bin/machinal-mcp.mjs +19 -0
  3. package/bin/machinal-stdio.mjs +14 -0
  4. package/package.json +47 -4
  5. package/skills/machinal-cinema/SKILL.md +18 -0
  6. package/skills/machinal-cinema/references/film-library/DIRECTOR.md +149 -0
  7. package/skills/machinal-cinema/references/film-library/LICENSE +21 -0
  8. package/skills/machinal-cinema/references/film-library/MY-STYLES.md +139 -0
  9. package/skills/machinal-cinema/references/film-library/README.md +13 -0
  10. package/skills/machinal-cinema/references/film-library/TECHNIQUE.md +162 -0
  11. package/skills/machinal-cinema/references/film-library/core/lib.js +44 -0
  12. package/skills/machinal-cinema/references/film-library/core/post/crt.js +144 -0
  13. package/skills/machinal-cinema/references/film-library/core/three/post.js +102 -0
  14. package/skills/machinal-cinema/references/film-library/manifest.json +394 -0
  15. package/skills/machinal-cinema/references/film-library/styleboard/catalog.json +1128 -0
  16. package/skills/machinal-cinema/references/film-library/styles/README.md +126 -0
  17. package/skills/machinal-cinema/references/film-library/styles/archive-lighttable/STYLE.md +107 -0
  18. package/skills/machinal-cinema/references/film-library/styles/art-deco/STYLE.md +110 -0
  19. package/skills/machinal-cinema/references/film-library/styles/ascii-crt/STYLE.md +113 -0
  20. package/skills/machinal-cinema/references/film-library/styles/backrooms/STYLE.md +123 -0
  21. package/skills/machinal-cinema/references/film-library/styles/blueprint/STYLE.md +118 -0
  22. package/skills/machinal-cinema/references/film-library/styles/brick-toy/STYLE.md +112 -0
  23. package/skills/machinal-cinema/references/film-library/styles/briefing-board/STYLE.md +120 -0
  24. package/skills/machinal-cinema/references/film-library/styles/caption-news/STYLE.md +135 -0
  25. package/skills/machinal-cinema/references/film-library/styles/cel-anime-80s/STYLE.md +117 -0
  26. package/skills/machinal-cinema/references/film-library/styles/chalkboard/STYLE.md +153 -0
  27. package/skills/machinal-cinema/references/film-library/styles/circuit-board/STYLE.md +149 -0
  28. package/skills/machinal-cinema/references/film-library/styles/city-symphony/STYLE.md +140 -0
  29. package/skills/machinal-cinema/references/film-library/styles/countdown/STYLE.md +130 -0
  30. package/skills/machinal-cinema/references/film-library/styles/crayon-book/STYLE.md +107 -0
  31. package/skills/machinal-cinema/references/film-library/styles/dark-keynote/STYLE.md +115 -0
  32. package/skills/machinal-cinema/references/film-library/styles/data-physical/STYLE.md +117 -0
  33. package/skills/machinal-cinema/references/film-library/styles/dataviz/STYLE.md +121 -0
  34. package/skills/machinal-cinema/references/film-library/styles/desktop-flythrough/STYLE.md +145 -0
  35. package/skills/machinal-cinema/references/film-library/styles/engraving/STYLE.md +121 -0
  36. package/skills/machinal-cinema/references/film-library/styles/game-show/STYLE.md +116 -0
  37. package/skills/machinal-cinema/references/film-library/styles/glass-product/STYLE.md +108 -0
  38. package/skills/machinal-cinema/references/film-library/styles/halftone-dossier/STYLE.md +120 -0
  39. package/skills/machinal-cinema/references/film-library/styles/hd-2d/STYLE.md +109 -0
  40. package/skills/machinal-cinema/references/film-library/styles/hologram-hud/STYLE.md +127 -0
  41. package/skills/machinal-cinema/references/film-library/styles/impasto/STYLE.md +122 -0
  42. package/skills/machinal-cinema/references/film-library/styles/ink-wash/STYLE.md +118 -0
  43. package/skills/machinal-cinema/references/film-library/styles/iso-infographic/STYLE.md +115 -0
  44. package/skills/machinal-cinema/references/film-library/styles/isometric-picture-book/STYLE.md +130 -0
  45. package/skills/machinal-cinema/references/film-library/styles/kino-montage/STYLE.md +149 -0
  46. package/skills/machinal-cinema/references/film-library/styles/lidar-survey/STYLE.md +116 -0
  47. package/skills/machinal-cinema/references/film-library/styles/living-screencast/STYLE.md +122 -0
  48. package/skills/machinal-cinema/references/film-library/styles/lowpoly-island/STYLE.md +110 -0
  49. package/skills/machinal-cinema/references/film-library/styles/memphis-diorama/STYLE.md +142 -0
  50. package/skills/machinal-cinema/references/film-library/styles/microgame/STYLE.md +120 -0
  51. package/skills/machinal-cinema/references/film-library/styles/microscope/STYLE.md +106 -0
  52. package/skills/machinal-cinema/references/film-library/styles/midcentury-toon/STYLE.md +122 -0
  53. package/skills/machinal-cinema/references/film-library/styles/news-package/STYLE.md +156 -0
  54. package/skills/machinal-cinema/references/film-library/styles/newsreel/STYLE.md +134 -0
  55. package/skills/machinal-cinema/references/film-library/styles/one-line/STYLE.md +112 -0
  56. package/skills/machinal-cinema/references/film-library/styles/paper-lantern/STYLE.md +120 -0
  57. package/skills/machinal-cinema/references/film-library/styles/paper-popup/STYLE.md +117 -0
  58. package/skills/machinal-cinema/references/film-library/styles/papercut-red/STYLE.md +108 -0
  59. package/skills/machinal-cinema/references/film-library/styles/pictogram-motion/STYLE.md +119 -0
  60. package/skills/machinal-cinema/references/film-library/styles/pixel-rpg/STYLE.md +115 -0
  61. package/skills/machinal-cinema/references/film-library/styles/printed-long-take/STYLE.md +141 -0
  62. package/skills/machinal-cinema/references/film-library/styles/risograph/STYLE.md +123 -0
  63. package/skills/machinal-cinema/references/film-library/styles/rubber-hose/STYLE.md +110 -0
  64. package/skills/machinal-cinema/references/film-library/styles/satellite-briefing/STYLE.md +114 -0
  65. package/skills/machinal-cinema/references/film-library/styles/scifi-toon/STYLE.md +119 -0
  66. package/skills/machinal-cinema/references/film-library/styles/shadow-puppet/STYLE.md +122 -0
  67. package/skills/machinal-cinema/references/film-library/styles/silent-film/STYLE.md +107 -0
  68. package/skills/machinal-cinema/references/film-library/styles/silkscreen-poster/STYLE.md +138 -0
  69. package/skills/machinal-cinema/references/film-library/styles/spy-titles/STYLE.md +114 -0
  70. package/skills/machinal-cinema/references/film-library/styles/stained-glass/STYLE.md +121 -0
  71. package/skills/machinal-cinema/references/film-library/styles/swiss-motion/STYLE.md +113 -0
  72. package/skills/machinal-cinema/references/film-library/styles/teardown/STYLE.md +125 -0
  73. package/skills/machinal-cinema/references/film-library/styles/telestrator/STYLE.md +135 -0
  74. package/skills/machinal-cinema/references/film-library/styles/tilt-shift/STYLE.md +105 -0
  75. package/skills/machinal-cinema/references/film-library/styles/transit-map/STYLE.md +194 -0
  76. package/skills/machinal-cinema/references/film-library/styles/ukiyoe/STYLE.md +110 -0
  77. package/skills/machinal-cinema/references/film-library/styles/urban-sketch/STYLE.md +124 -0
  78. package/skills/machinal-cinema/references/film-library/styles/visual-investigation/STYLE.md +138 -0
  79. package/skills/machinal-cinema/references/film-library/styles/watercolor/STYLE.md +111 -0
  80. package/skills/machinal-cinema/references/film-library/styles/white-model/STYLE.md +113 -0
  81. package/skills/machinal-cinema/references/film-library/styles/whiteboard/STYLE.md +116 -0
  82. package/skills/machinal-cinema/references/film-library/styles/woodcut/STYLE.md +120 -0
  83. package/skills/machinal-cinema/references/film-library/upstream-skill.md +13 -0
  84. package/skills/machinal-cinema/references/film-styles.json +1322 -0
  85. package/skills/machinal-cinema/references/film-techniques.json +107 -0
  86. package/skills/machinal-cinema/references/workflow.md +58 -0
  87. package/skills/machinal-credits/SKILL.md +24 -0
  88. package/skills/machinal-editing/SKILL.md +43 -0
  89. package/skills/machinal-editing/references/brief.md +98 -0
  90. package/skills/machinal-editing/references/effects.md +58 -0
  91. package/skills/machinal-editing/references/looks-motion.md +37 -0
  92. package/skills/machinal-editing/references/styles.json +15 -0
  93. package/skills/machinal-editing/references/styles.md +16 -0
  94. package/skills/machinal-editing/references/transitions.md +46 -0
  95. package/skills/machinal-editing/references/workflow.md +43 -0
  96. package/skills/machinal-media/SKILL.md +23 -0
  97. package/skills/machinal-media/references/workflow.md +160 -0
  98. package/skills/machinal-recipes/SKILL.md +32 -0
  99. package/skills/machinal-recipes/references/catalog.v1.json +10445 -0
  100. package/skills/machinal-recipes/references/commands.md +45 -0
  101. package/skills/machinal-recipes/references/example.edit.yaml +26 -0
  102. package/skills/machinal-recipes/references/examples/caption-audio.yaml +28 -0
  103. package/skills/machinal-recipes/references/examples/cinematic-sequence.yaml +21 -0
  104. package/skills/machinal-recipes/references/examples/client-scene.yaml +26 -0
  105. package/skills/machinal-recipes/references/examples/generated-media.yaml +25 -0
  106. package/skills/machinal-recipes/references/examples/modify-snapshot.yaml +22 -0
  107. package/skills/machinal-recipes/references/examples/montage-v3.yaml +28 -0
  108. package/skills/machinal-recipes/references/examples/narrated-documentary.yaml +112 -0
  109. package/skills/machinal-recipes/references/examples/narration-timing.yaml +43 -0
  110. package/skills/machinal-recipes/references/examples/scene-edit.yaml +19 -0
  111. package/skills/machinal-recipes/references/examples/scene-generated-image.yaml +36 -0
  112. package/skills/machinal-recipes/references/examples/scene-generation.yaml +35 -0
  113. package/skills/machinal-recipes/references/examples/scene-image-insert.yaml +41 -0
  114. package/skills/machinal-recipes/references/examples/scene-three-explainer.yaml +38 -0
  115. package/skills/machinal-recipes/references/examples/social-hook.yaml +26 -0
  116. package/skills/machinal-recipes/references/examples/tutorial-clean.yaml +19 -0
  117. package/skills/machinal-recipes/references/examples.md +28 -0
  118. package/skills/machinal-recipes/references/jobs-scenes.md +206 -0
  119. package/skills/machinal-recipes/references/text-audio.md +118 -0
  120. package/skills/machinal-recipes/references/yaml.md +72 -0
  121. package/skills/machinal-review/SKILL.md +18 -0
  122. package/skills/machinal-review/references/production.md +146 -0
  123. package/skills/machinal-scenes/SKILL.md +44 -0
  124. package/skills/machinal-scenes/references/authoring.md +97 -0
  125. package/skills/machinal-scenes/references/runtime.md +136 -0
  126. package/skills/machinal-scenes/references/scene-templates/blueprint-mechanism.svelte +62 -0
  127. package/skills/machinal-scenes/references/scene-templates/glitch-handoff.svelte +30 -0
  128. package/skills/machinal-scenes/references/scene-templates/image-reveal.svelte +33 -0
  129. package/skills/machinal-scenes/references/scene-templates/kinetic-type.svelte +38 -0
  130. package/skills/machinal-scenes/references/scene-templates/layered-parallax.svelte +31 -0
  131. package/skills/machinal-scenes/references/scene-templates/lens-assembly-3d.svelte +57 -0
  132. package/skills/machinal-scenes/references/scene-templates/paper-stage-3d.svelte +83 -0
  133. package/skills/machinal-scenes/references/scene-templates/signal-diagram.svelte +43 -0
  134. package/skills/machinal-scenes/references/scene-templates/swiss-grid-motion.svelte +54 -0
  135. package/skills/machinal-scenes/references/scene-templates.json +178 -0
  136. package/skills/machinal-scenes/references/scene-templates.md +50 -0
  137. package/skills/machinal-scenes/references/workflow.md +206 -0
  138. package/skills/machinal-support/SKILL.md +42 -0
  139. package/src/bridge.mjs +285 -0
  140. package/src/cli.mjs +155 -0
  141. package/src/configuration.mjs +148 -0
  142. package/src/connection.mjs +187 -0
  143. package/src/credential-store.mjs +61 -0
  144. package/src/credits.mjs +86 -0
  145. package/src/docker.mjs +93 -0
  146. package/src/download.mjs +90 -0
  147. package/src/errors.mjs +9 -0
  148. package/src/formats.mjs +140 -0
  149. package/src/keys.mjs +127 -0
  150. package/src/launch.mjs +29 -0
  151. package/src/local-setup.mjs +109 -0
  152. package/src/opencode-auth.mjs +246 -0
  153. package/src/opencode-checkpoints.mjs +90 -0
  154. package/src/opencode-configuration.mjs +53 -0
  155. package/src/opencode-media.mjs +139 -0
  156. package/src/opencode-plugin/index.mjs +7 -0
  157. package/src/opencode-plugin/package.json +5 -0
  158. package/src/opencode-recipes.mjs +130 -0
  159. package/src/opencode-routing.mjs +154 -0
  160. package/src/opencode-tools.mjs +30 -0
  161. package/src/opencode-workflow.mjs +32 -0
  162. package/src/presentation.mjs +30 -0
  163. package/src/prompts.mjs +32 -0
  164. package/src/reference-files.json +127 -0
  165. package/src/runtime.mjs +51 -0
  166. package/src/setup-options.mjs +64 -0
  167. package/src/setup-stdio.mjs +114 -0
  168. package/src/setup.mjs +173 -0
  169. package/src/skills.mjs +68 -0
  170. package/src/transfer-http.mjs +109 -0
  171. package/src/version.mjs +3 -0
  172. package/src/windows-key-prompt.mjs +37 -0
  173. package/src/windows-key-prompt.ps1 +77 -0
@@ -0,0 +1,45 @@
1
+ # Selectors, overrides and edit commands
2
+
3
+ Read the deployed command list from `get_capabilities` or this tool's `commands` topic. Exact IDs and operand semantics matter; no free-form “apply effect” command exists.
4
+
5
+ Selectors have `{kind, ids?, trackId?, position?, index?, selected?}`. `kind` is clip/video/audio/image/track/transition (rules only video/image; montage only video). `position` is all/first/last/nth; `index` is 1-based. `selected: true` uses captured snapshot `selectedIds`, not a new selection invented by the model. Explicit IDs must all resolve. Commands resolve all their targets against the captured base timeline before execution; do not target a new ID created by an earlier command in the same batch.
6
+
7
+ | Command | Target / operands |
8
+ | --- | --- |
9
+ | `clip.move` | Clip selector, `patch.start`; optional destination `trackId` must be compatible/unlocked. |
10
+ | `clip.trim` | Clip selector, `patch.from` (source time) and/or `patch.duration` (timeline time). |
11
+ | `clip.duration` | Clip selector, `patch.duration`; must fit source at current playback rate. |
12
+ | `clip.speed` | Clip selector, `patch.rate` 0.25–4; supply intended duration explicitly if needed and compile source/timeline geometry. |
13
+ | `clip.delete` | Clip selector; also removes linked clips/attached effects, text and transitions. Ask before destructive edits. |
14
+ | `clip.duplicate` | Clip selector, `time` for duplicate start. Links/keyframes/attachments are not supported by this shortcut; author explicit items instead. |
15
+ | `clip.split` | Clip selector, `time` timeline split position. Links/keyframes/transitions/attachments require explicit items rather than this shortcut. |
16
+ | `clip.source_audio.remove` | Video clip with actual reciprocal linked audio; not a general mute command for arbitrary media. |
17
+ | `track.create` | `track: {id, name?, type: video|audio, clips: []}`; no selector needed. Subsequent commands in the same batch cannot select its new IDs. |
18
+ | `track.delete` | Track selector; removes its media/attachments, subject to locks. |
19
+ | `track.mute` | Track selector, explicit boolean `value`. |
20
+ | `track.hide` | Track selector, explicit boolean `value`. |
21
+ | `track.lock` | Track selector, explicit boolean `value`. Do not silently unlock protected edits. |
22
+ | `look.apply` | Clip selector, exact look `preset`; may replace treatment-owned effects and auto keyframes. |
23
+ | `look.remove` | Clip selector; removes the look and its owned look effects, not arbitrary independent effects. |
24
+ | `motion.apply` | Clip selector, exact motion `preset`; replaces motion keyframes. |
25
+ | `transform.set` | Clip selector, `patch.transform` or supported patch geometry; use full intended transform/default identity values where needed. |
26
+ | `transform.reset` | Clip selector; identity transform, clears keyframes and motion. |
27
+ | `keyframe.clear` | Clip selector; clears keyframes/motion, without promising reset of the base transform. |
28
+ | `transition.set` | Existing transition selector, exact transition `preset`. It changes a real pair, not arbitrary two clips. |
29
+ | `transition.duration` | Existing transition selector, `duration` matching valid overlap; retimes following clips. |
30
+ | `transition.remove` | Existing transition selector, optional `closeGap`; false retains an overlap as cross-dissolve, true removes overlap/repositions followers. |
31
+
32
+ Example fragment for an actual selected clip:
33
+ ```yaml
34
+ commands:
35
+ - type: clip.trim
36
+ target: {kind: video, ids: [clip-a]}
37
+ patch: {from: 1s, duration: 4s}
38
+ - type: motion.apply
39
+ target: {kind: video, ids: [clip-a]}
40
+ preset: settle
41
+ ```
42
+
43
+ `overrides` patches one real clip via `target: clip-id` directly; commands use `target` as a selector. Do not interchange these shapes. Order is montage, overrides, commands, rules and treatment expansion; look/motion may replace auto transforms. Validate final source bounds, linked audio alignment, locks, transition overlaps and text/effect anchors.
44
+
45
+ For `mode: modify`, supply a current compiler snapshot with a real revision; for `assemble`, commands can target explicit/compiled sequence IDs. A successful compile does not save the user's editor state; `save_project` is separately version checked.
@@ -0,0 +1,26 @@
1
+ # Example only: replace clip.mp4 with an uploaded project filename.
2
+ # The source must contain at least four seconds. Read the live schema first.
3
+ # Include assets returned by get_asset_metadata for validation/compilation;
4
+ # request id=clip.mp4, file=clip.mp4 so the metadata matches this binding.
5
+ document:
6
+ version: 1
7
+ mode: assemble
8
+ inputs:
9
+ shots:
10
+ kind: video
11
+ multiple: true
12
+ sequence:
13
+ use: shots
14
+ each:
15
+ take:
16
+ from: 0s
17
+ duration: 4s
18
+ source_audio: remove
19
+ output:
20
+ aspect: landscape
21
+ resolution: 720p
22
+ fps: 30
23
+ format: mp4
24
+ bindings:
25
+ shots:
26
+ - clip.mp4
@@ -0,0 +1,28 @@
1
+ # Synthetic verified-word fixture; real captions need measured/supplied timings.
2
+ document:
3
+ version: 2
4
+ mode: assemble
5
+ inputs:
6
+ demo: {kind: video}
7
+ music: {kind: audio}
8
+ sequence:
9
+ use: demo
10
+ each: {take: {from: 0s, duration: 6s}, source_audio: keep}
11
+ audio:
12
+ - {id: music-bed, use: music, start: 0s, from: 0s, fit: sequence, repeat: true, volume: 18}
13
+ texts:
14
+ - id: spoken-phrase
15
+ text: 'Hello world'
16
+ start: 1s
17
+ duration: 1200ms
18
+ preset: active-word
19
+ words:
20
+ - {text: Hello, start: 0s, end: 500ms}
21
+ - {text: world, start: 500ms, end: 1200ms}
22
+ output: {aspect: portrait, resolution: 1080p, fps: 30, format: mp4}
23
+ bindings:
24
+ demo: [demo]
25
+ music: [bed]
26
+ assets:
27
+ - {id: demo, file: demonstration.mp4, version: example-only, kind: video, duration: 8s, width: 1080, height: 1920, hasAudio: true}
28
+ - {id: bed, file: licensed-music.mp3, version: example-only, kind: audio, duration: 4s, hasAudio: true}
@@ -0,0 +1,21 @@
1
+ # Synthetic metadata: replace with get_asset_metadata results before real use.
2
+ document:
3
+ version: 2
4
+ mode: assemble
5
+ instanceId: film
6
+ inputs:
7
+ shots: {kind: video, multiple: true}
8
+ sequence:
9
+ use: shots
10
+ each:
11
+ take: {from: 0s, duration: 4s}
12
+ source_audio: remove
13
+ look: fine-film
14
+ motion: none
15
+ between: {preset: cross-dissolve, duration: 600ms, policy: error}
16
+ output: {aspect: landscape, resolution: 1080p, fps: 30, format: mp4}
17
+ bindings:
18
+ shots: [shot-a, shot-b]
19
+ assets:
20
+ - {id: shot-a, file: shot-a.mp4, version: example-only, kind: video, duration: 8s, width: 1920, height: 1080}
21
+ - {id: shot-b, file: shot-b.mp4, version: example-only, kind: video, duration: 8s, width: 1920, height: 1080}
@@ -0,0 +1,26 @@
1
+ # Synthetic compiler fixture only. Replace this asset with the exact asset returned
2
+ # by a successful compile_scene job; this is not an existing user scene.
3
+ document:
4
+ version: 2
5
+ mode: assemble
6
+ tracks:
7
+ - id: client-scenes
8
+ type: video
9
+ clips:
10
+ - id: opener
11
+ assetId: compiled-scene
12
+ start: 0s
13
+ inPoint: 0s
14
+ outPoint: 6s
15
+ playbackRate: 1
16
+ volume: 0
17
+ output: {aspect: landscape, resolution: 1080p, fps: 30, format: mp4}
18
+ bindings: {}
19
+ assets:
20
+ - id: compiled-scene
21
+ file: ai_scene_0123456789abcdef0123456789abcdef_01.scene.json
22
+ version: synthetic-client-scene-fixture
23
+ kind: video
24
+ duration: 6s
25
+ width: 1920
26
+ height: 1080
@@ -0,0 +1,25 @@
1
+ # Pending paid requirements only. Inspect actual speech duration after generation.
2
+ document:
3
+ version: 2
4
+ mode: assemble
5
+ before:
6
+ - id: illustration
7
+ type: image.generate
8
+ prompt: 'A clean editorial illustration of a seed becoming a small plant, no text.'
9
+ imageStyle: 'Restrained flat illustration, cobalt and warm cream, clear negative space.'
10
+ aspect: '9:16'
11
+ - id: narration
12
+ type: speech.generate
13
+ text: 'Every process starts with one small step.'
14
+ placements:
15
+ - {job: illustration, track: {type: video, role: illustration}, start: 0s, duration: 8s}
16
+ - {job: narration, track: {type: audio, role: narration}, start: 0s}
17
+ after:
18
+ - id: captions
19
+ type: captions.generate
20
+ language: en
21
+ maxWords: 4
22
+ style: {fontFamily: montserrat, fontSize: 58, highlightMode: word}
23
+ output: {aspect: portrait, resolution: 1080p, fps: 30, format: mp4}
24
+ bindings: {}
25
+ assets: []
@@ -0,0 +1,22 @@
1
+ # A real request must use a current compiler snapshot, never this fixture revision.
2
+ document:
3
+ version: 3
4
+ mode: modify
5
+ commands:
6
+ - {type: clip.trim, target: {kind: video, ids: [clip-a]}, patch: {from: 1s, duration: 4s}}
7
+ - {type: motion.apply, target: {kind: video, ids: [clip-a]}, preset: settle}
8
+ output: {aspect: landscape, resolution: 1080p, fps: 30, format: mp4}
9
+ bindings: {}
10
+ assets:
11
+ - {id: a, file: source-a.mp4, version: example-only, kind: video, duration: 8s, width: 1920, height: 1080}
12
+ snapshot:
13
+ revision: synthetic-snapshot-only
14
+ tracks:
15
+ - id: main
16
+ type: video
17
+ clips:
18
+ - {id: clip-a, assetId: a, start: 0s, inPoint: 0s, outPoint: 6s}
19
+ effects: []
20
+ transitions: []
21
+ textItems: []
22
+ selectedIds: [clip-a]
@@ -0,0 +1,28 @@
1
+ document:
2
+ version: 3
3
+ mode: assemble
4
+ tracks:
5
+ - id: main
6
+ type: video
7
+ clips:
8
+ - {id: source-a, assetId: a, start: 0s, inPoint: 0s, outPoint: 4s}
9
+ - {id: source-b, assetId: b, start: 4s, inPoint: 0s, outPoint: 4s}
10
+ montage:
11
+ target: {kind: video, trackId: main}
12
+ ranges:
13
+ - {clipId: source-a, from: 0s, to: 2s}
14
+ - {clipId: source-b, from: 1s, to: 3s}
15
+ targetDuration: 3.7s
16
+ tolerance: 100ms
17
+ seed: editorial-example
18
+ between: {preset: film-dissolve-fast, duration: 300ms, policy: error}
19
+ motion: {preset: zoom-in}
20
+ rules:
21
+ - id: natural-documentary
22
+ target: {kind: video, trackId: main}
23
+ apply: {look: documentary-16mm}
24
+ output: {aspect: landscape, resolution: 1080p, fps: 30, format: mp4}
25
+ bindings: {}
26
+ assets:
27
+ - {id: a, file: source-a.mp4, version: example-only, kind: video, duration: 8s, width: 1920, height: 1080}
28
+ - {id: b, file: source-b.mp4, version: example-only, kind: video, duration: 8s, width: 1920, height: 1080}
@@ -0,0 +1,112 @@
1
+ # Pass 2, after narration-timing completes. All resolved audio/caption values
2
+ # below are synthetic test fixtures, NOT real output to copy into a project.
3
+ # Use the actual returned recipeYaml/assets/word times. Only visuals are pending.
4
+ document:
5
+ version: 2
6
+ mode: assemble
7
+ instanceId: narrated-documentary
8
+ before:
9
+ - id: woodland-art
10
+ type: image.generate
11
+ aspect: 16:9
12
+ prompt: >-
13
+ A restrained poetic woodland and calm lake in blue-green evening light.
14
+ An illustrative landscape, not a literal historical reconstruction.
15
+ Leave the upper quarter and bottom 24 percent clear of important detail.
16
+ No lettering.
17
+ - id: childhood-scene
18
+ type: scene.generate
19
+ narrationJob: childhood-voice
20
+ narrationFrom: 4.6s
21
+ duration: 3.8s
22
+ visualMode: 3d
23
+ images:
24
+ - {id: image_1, job: woodland-art, name: Woodland and lake}
25
+ prompt: >-
26
+ Illustrate only the measured excerpt about moonlight completing the
27
+ landscape. Use genuine SceneThree: keep image_1 visible on a textured
28
+ woodland plane and reveal a softly lit moon mesh above the lake as
29
+ Lumina lunii is spoken. Follow the supplied scene-local narration cues,
30
+ not invented word times. Drift the camera gently, hold the complete
31
+ scene through the remaining phrase, and settle without hiding the art.
32
+ Reserve the bottom 24 percent for captions. No on-screen copy.
33
+ # Materialized jobs are retained from pass 1; do not recreate pending speech.
34
+ jobs:
35
+ - id: childhood-voice
36
+ type: speech.generate
37
+ language: ro
38
+ text: >-
39
+ Codrul și lacul inspiră poezia. Lumina lunii completează peisajul.
40
+ resultAssetId: example-voice
41
+ - id: captions-ro
42
+ type: captions.generate
43
+ language: ro
44
+ maxWords: 4
45
+ resultTextIds: [captions-ro/caption/0, captions-ro/caption/1, captions-ro/caption/2]
46
+ tracks:
47
+ - id: recipe/audio/narration
48
+ type: audio
49
+ name: narration
50
+ clips:
51
+ - {id: example-voice-clip, assetId: example-voice, start: 0s, inPoint: 0s, outPoint: 8.4s, playbackRate: 1, volume: 100}
52
+ placements:
53
+ - job: woodland-art
54
+ track: {type: video, role: main}
55
+ start: 0s
56
+ duration: 4.6s
57
+ - job: childhood-scene
58
+ track: {type: video, role: main}
59
+ start: 4.6s
60
+ duration: 3.8s
61
+ texts:
62
+ - id: chapter-heading
63
+ text: Copilăria la Ipotești
64
+ start: 0s
65
+ duration: 4s
66
+ anchor: left
67
+ align: left
68
+ x: 150
69
+ y: 64
70
+ fontFamily: montserrat
71
+ fontSize: 24
72
+ color: '#FFFFFF'
73
+ strokeColor: '#10151C'
74
+ strokeWidth: 1
75
+ - id: captions-ro/caption/0
76
+ text: Codrul și lacul inspiră
77
+ start: 0.2s
78
+ duration: 2.2s
79
+ isCaption: true
80
+ highlightMode: word
81
+ words:
82
+ - {text: Codrul, start: 0s, end: 0.5s}
83
+ - {text: și, start: 0.6s, end: 0.8s}
84
+ - {text: lacul, start: 0.9s, end: 1.4s}
85
+ - {text: inspiră, start: 1.5s, end: 2.2s}
86
+ - id: captions-ro/caption/1
87
+ text: poezia.
88
+ start: 2.8s
89
+ duration: 0.8s
90
+ isCaption: true
91
+ highlightMode: word
92
+ words:
93
+ - {text: poezia., start: 0s, end: 0.8s}
94
+ - id: captions-ro/caption/2
95
+ text: Lumina lunii completează peisajul.
96
+ start: 4.8s
97
+ duration: 3.3s
98
+ isCaption: true
99
+ highlightMode: word
100
+ words:
101
+ - {text: Lumina, start: 0s, end: 0.6s}
102
+ - {text: lunii, start: 0.7s, end: 1.3s}
103
+ - {text: completează, start: 1.5s, end: 2.3s}
104
+ - {text: peisajul., start: 2.5s, end: 3.3s}
105
+ output:
106
+ aspect: landscape
107
+ resolution: 1080p
108
+ fps: 30
109
+ format: mp4
110
+ bindings: {}
111
+ assets:
112
+ - {id: example-voice, file: example-voice.wav, kind: audio, version: synthetic-timing-fixture, duration: 8.4s, hasAudio: true}
@@ -0,0 +1,43 @@
1
+ # Pass 1: speech and requested captions only. This is not the final video.
2
+ # After completion, edit the returned recipeYaml, not this unresolved input.
3
+ document:
4
+ version: 2
5
+ mode: assemble
6
+ instanceId: narrated-documentary
7
+ before:
8
+ - id: childhood-voice
9
+ type: speech.generate
10
+ language: ro
11
+ model: google/gemini-3.8-flash-tts
12
+ voice: Kore
13
+ instructions: Calm documentary narration with native Romanian pronunciation.
14
+ text: >-
15
+ Codrul și lacul inspiră poezia. Lumina lunii completează peisajul.
16
+ placements:
17
+ - job: childhood-voice
18
+ track: {type: audio, role: narration}
19
+ start: 0s
20
+ after:
21
+ - id: captions-ro
22
+ type: captions.generate
23
+ language: ro
24
+ maxWords: 4
25
+ style:
26
+ fontFamily: montserrat
27
+ fontSize: 48
28
+ x: 960
29
+ y: 925
30
+ anchor: center
31
+ align: center
32
+ color: '#FFFFFF'
33
+ strokeColor: '#10151C'
34
+ strokeWidth: 2
35
+ highlightMode: word
36
+ highlightAnimation: none
37
+ output:
38
+ aspect: landscape
39
+ resolution: 1080p
40
+ fps: 30
41
+ format: mp4
42
+ bindings: {}
43
+ assets: []
@@ -0,0 +1,19 @@
1
+ # Replace the synthetic existing scene with an owned uploaded/live scene asset.
2
+ document:
3
+ version: 2
4
+ mode: assemble
5
+ before:
6
+ - id: revised-scene
7
+ type: scene.edit
8
+ assetId: existing-scene
9
+ duration: 6s
10
+ prompt: >-
11
+ Keep the existing copy, layout, attached media, narration and timing.
12
+ Change only the accent color to cobalt and make the ending settle
13
+ more gently. Preserve everything else.
14
+ placements:
15
+ - {job: revised-scene, track: {type: video, role: revised}, start: 0s, duration: 6s}
16
+ output: {aspect: landscape, resolution: 1080p, fps: 30, format: mp4}
17
+ bindings: {}
18
+ assets:
19
+ - {id: existing-scene, file: existing.scene.json, version: example-only, kind: video, duration: 6s, width: 1920, height: 1080}
@@ -0,0 +1,36 @@
1
+ document:
2
+ version: 2
3
+ mode: assemble
4
+ before:
5
+ - id: fox-art
6
+ type: image.generate
7
+ prompt: 'An original detailed editorial fox cutout, isolated on transparent background, no text.'
8
+ aspect: '1:1'
9
+ background: transparent
10
+ - id: fox-scene
11
+ type: scene.generate
12
+ visualMode: 3d
13
+ duration: 8s
14
+ width: 1080
15
+ height: 1920
16
+ fps: 30
17
+ images:
18
+ - id: image_1
19
+ job: fox-art
20
+ name: Fox illustration
21
+ description: Keep the real attached fox visible in an independently moving image layer; preserve its alpha.
22
+ prompt: >-
23
+ Create a portrait literary illustration using the attached fox image,
24
+ not a CSS/SVG redraw. Keep it visible in a moving foreground card.
25
+ Behind it use genuine SceneThree geometry: a small low-poly planet,
26
+ soft lighting and an orbiting gold point, with deterministic frame-derived
27
+ transforms. Keep the text Friendship readable as a DOM overlay and
28
+ reserve the lower safe area for separate captions. No narration.
29
+ placements:
30
+ - job: fox-scene
31
+ track: {type: video, role: illustration}
32
+ start: 0s
33
+ duration: 8s
34
+ output: {aspect: portrait, resolution: 1080p, fps: 30, format: mp4}
35
+ bindings: {}
36
+ assets: []
@@ -0,0 +1,35 @@
1
+ # Pending, paid scene job: fetching or compiling this example executes nothing.
2
+ document:
3
+ version: 2
4
+ mode: assemble
5
+ before:
6
+ - id: process-opener
7
+ type: scene.generate
8
+ duration: 6s
9
+ width: 1080
10
+ height: 1920
11
+ fps: 30
12
+ visualMode: 2d
13
+ prompt: >-
14
+ A six-second portrait editorial process explanation, not a title card.
15
+ Exact labels: Prepare, Demonstrate, Review. Use a warm ivory background,
16
+ cobalt primary objects, charcoal type and one amber active-state accent.
17
+ Compose three vertically aligned stations in the upper 72% of the frame,
18
+ with a subtle background grid, a continuous route behind the stations
19
+ and distinct foreground icons: organized tools, a demonstration stage,
20
+ and a review check. Draw deliberate geometric SVG objects, not generic
21
+ cards. Local 0-0.7s: reveal the route and first subject. 0.7-2.8s:
22
+ a marker travels the route and each station changes independently as
23
+ it arrives; reveal the matching label beside its object, never on top.
24
+ 2.8-5.3s: keep all subjects and labels fully visible for the reading hold,
25
+ with only restrained marker motion. 5.3-6s: settle and dim the route,
26
+ retaining readable subjects rather than fading the whole scene early.
27
+ Derive SVG stroke reveal, marker position, transforms and opacity from
28
+ frame time with separate clamped entrance/exit. Maintain safe margins,
29
+ visible contrast and a reserved bottom caption band. No invented data,
30
+ external assets, production labels, disclaimers or watermarks.
31
+ placements:
32
+ - {job: process-opener, track: {type: video, role: opener}, start: 0s, duration: 6s}
33
+ output: {aspect: portrait, resolution: 1080p, fps: 30, format: mp4}
34
+ bindings: {}
35
+ assets: []
@@ -0,0 +1,41 @@
1
+ # Synthetic mixed edit: inspect/replace both source files before real use.
2
+ # Pure compilation reports one pending scene; it never calls a paid provider.
3
+ document:
4
+ version: 2
5
+ mode: assemble
6
+ tracks:
7
+ - id: footage
8
+ type: video
9
+ clips:
10
+ - {id: opening, assetId: demonstration, start: 0s, inPoint: 0s, outPoint: 4s}
11
+ - {id: return, assetId: demonstration, start: 10s, inPoint: 4s, outPoint: 10s}
12
+ before:
13
+ - id: moving-explainer
14
+ type: scene.generate
15
+ duration: 6s
16
+ width: 1920
17
+ height: 1080
18
+ fps: 30
19
+ images:
20
+ - id: image_1
21
+ file: supplied-product.png
22
+ name: Supplied product image
23
+ description: Use the original image inside the central card; preserve proportions and existing alpha.
24
+ prompt: >-
25
+ Create an animated Svelte explainer, not a static image with a camera zoom.
26
+ Use image_1 inside a central product card with a quiet cobalt/white background
27
+ and safe margins. Exact supplied labels are Prepare, Connect, Ready.
28
+ Scene-local 0-1s: bring the card in from the left and settle it at center.
29
+ At 1-3s, move two procedural circles independently along short paths toward
30
+ the card, draw connecting arrows and reveal the first two labels in order.
31
+ Keep labels attached to their related objects. At 3-5s, reveal Ready and
32
+ hold the completed diagram for reading. At 5-6s, settle the surrounding
33
+ objects without hiding the product. Derive animation from the scene runtime.
34
+ Preserve the supplied image; no invented numbers, logos, claims or external media.
35
+ placements:
36
+ - {job: moving-explainer, track: {type: video, role: explanation}, start: 4s, duration: 6s}
37
+ output: {aspect: landscape, resolution: 1080p, fps: 30, format: mp4}
38
+ bindings: {}
39
+ assets:
40
+ - {id: demonstration, file: demonstration.mp4, version: example-only, kind: video, duration: 10s, width: 1920, height: 1080}
41
+ - {id: product, file: supplied-product.png, version: example-only, kind: image, width: 1000, height: 1000}
@@ -0,0 +1,38 @@
1
+ # Pending paid procedural 3D scene. Reading/compiling this example executes nothing.
2
+ document:
3
+ version: 2
4
+ mode: assemble
5
+ before:
6
+ - id: spatial-mechanism
7
+ type: scene.generate
8
+ duration: 8s
9
+ width: 1920
10
+ height: 1080
11
+ fps: 30
12
+ visualMode: 3d
13
+ prompt: >-
14
+ An eight-second genuine Three.js editorial explanation of a simple
15
+ mechanical linkage, not a generic spinning cube or CSS perspective.
16
+ Build three connected procedural joints, connecting rods and a small
17
+ base plate with visible spacing and rounded metallic edges. This is a
18
+ schematic mechanism, not a claim of engineering precision. Use a dark
19
+ navy environment, brushed warm metal, a cobalt active joint and one
20
+ amber motion cue. Separate foreground mechanism, midground base and
21
+ quiet background; use an ambient fill plus soft key and rim lights.
22
+ Aim a perspective camera at the assembly center and frame the whole
23
+ object inside the central 75% with no near-plane clipping.
24
+ Local 0-1s: the mechanism assembles from a short readable exploded view.
25
+ 1-3.5s: the active joint turns and connected rods respond independently;
26
+ keep the base still. 3.5-6.5s: hold the working mechanism in clear view
27
+ while the camera makes a restrained quarter-orbit showing its depth.
28
+ 6.5-8s: settle into a stable three-quarter view, never fade to an empty
29
+ screen. Derive mesh transforms and camera positions directly from
30
+ frame.time; backward seeking must reconstruct the same state.
31
+ Use SceneThree setup/update, real geometry and lights, no external
32
+ models, loaders, textures or extra render loops. No on-screen text,
33
+ production badges, AI notices, disclaimers or watermarks.
34
+ placements:
35
+ - {job: spatial-mechanism, track: {type: video, role: explanation}, start: 0s, duration: 8s}
36
+ output: {aspect: landscape, resolution: 1080p, fps: 30, format: mp4}
37
+ bindings: {}
38
+ assets: []
@@ -0,0 +1,26 @@
1
+ # Example title copy is supplied content, not an invented transcript.
2
+ document:
3
+ version: 2
4
+ mode: assemble
5
+ tracks:
6
+ - id: main
7
+ type: video
8
+ clips:
9
+ - {id: first, assetId: shot-a, start: 0s, inPoint: 0s, outPoint: 3s}
10
+ - {id: second, assetId: shot-b, start: 2.7s, inPoint: 0s, outPoint: 3s}
11
+ transitions:
12
+ - {id: first-to-second, trackId: main, leftClipId: first, rightClipId: second, preset: whip-pan-left, duration: 300ms}
13
+ rules:
14
+ - id: base-look
15
+ target: {kind: video, trackId: main}
16
+ apply: {look: clean-social-pop}
17
+ - id: opening-emphasis
18
+ target: {kind: video, ids: [first]}
19
+ apply: {motion: punch}
20
+ texts:
21
+ - {id: hook, text: 'A simpler way to begin', start: 0s, duration: 2s, preset: social-hook, x: 540, y: 350}
22
+ output: {aspect: portrait, resolution: 1080p, fps: 30, format: mp4}
23
+ bindings: {}
24
+ assets:
25
+ - {id: shot-a, file: shot-a.mp4, version: example-only, kind: video, duration: 8s, width: 1080, height: 1920}
26
+ - {id: shot-b, file: shot-b.mp4, version: example-only, kind: video, duration: 8s, width: 1080, height: 1920}
@@ -0,0 +1,19 @@
1
+ document:
2
+ version: 2
3
+ mode: assemble
4
+ inputs:
5
+ demo: {kind: video}
6
+ sequence:
7
+ use: demo
8
+ each:
9
+ take: {from: 0s, duration: 6s}
10
+ source_audio: keep
11
+ look: clean-tutorial
12
+ motion: none
13
+ texts:
14
+ - {id: step-one, text: '01 / Prepare the ingredients', start: 0s, duration: 3s, preset: step-label, x: 400, y: 220}
15
+ output: {aspect: landscape, resolution: 1080p, fps: 30, format: mp4}
16
+ bindings:
17
+ demo: [demo]
18
+ assets:
19
+ - {id: demo, file: demonstration.mp4, version: example-only, kind: video, duration: 8s, width: 1920, height: 1080, hasAudio: true}
@@ -0,0 +1,28 @@
1
+ # Complete, compiler-tested recipe examples
2
+
3
+ Topic `examples` returns complete YAML composition strings; use `id` to retrieve one. Resource URIs are `machinal://examples/<id>`. They demonstrate authoring contracts, not media in a user's account. All filenames, immutable asset versions, source durations, copy/word timings and snapshot revisions are **synthetic**: replace them with uploaded project media, measured metadata and current state. Never pretend an example transcript or visual description is observed source content.
4
+
5
+ | ID | Demonstrates | Expected pure compile |
6
+ | --- | --- | --- |
7
+ | `cinematic-sequence` | v2 sequence, fine-film look, explicit no-motion override, cross-dissolve geometry | Finished composition, no generation |
8
+ | `social-hook` | Explicit video tracks, short named transition, first-clip motion rule, readable title | Finished composition, no generation |
9
+ | `tutorial-clean` | Step label, deliberate static treatment and real source audio | Finished composition, no generation |
10
+ | `caption-audio` | Verified example word timings, active-word preset, percent music volume/fit/repeat | Finished composition, no generation |
11
+ | `montage-v3` | Complete source ranges, exact duration tolerance, seeded deterministic choices | Finished composition, no generation |
12
+ | `modify-snapshot` | Real-shaped compiler snapshot, selector commands, trim and motion | Finished composition, synthetic snapshot only |
13
+ | `scene-generation` | Paid scene brief in before, portrait size/fps, staged placement | Pending scene.generate requirement, no provider call |
14
+ | `scene-three-explainer` | Detailed procedural Three.js storyboard, assembly, independent mesh action, lighting, camera orbit and stable hold | Pending scene.generate requirement, no provider call |
15
+ | `scene-image-insert` | Footage at 0–4s and 10–16s, six-second Svelte scene inserted at 4s, real image attachment and independently moving objects | Pending scene.generate requirement, no provider call |
16
+ | `scene-generated-image` | Complex subject generated first, referenced by images[].job, then embedded inside a genuine Three.js scene | Pending image.generate + scene.generate, no provider call |
17
+ | `scene-edit` | Existing server .scene.json asset, preservation-directed edit and placement | Pending scene.edit requirement, no provider call |
18
+ | `generated-media` | Single-request stage syntax: image + speech before and captions after; not a timing-first visual-planning workflow | Pending image/speech/captions requirements, no provider call |
19
+ | `narration-timing` | Pass 1: Romanian speech, audio placement and requested captions only; wait and retrieve the result before authoring visuals | Pending speech/captions requirements, no provider call |
20
+ | `narrated-documentary` | Pass 2: retain synthetic resolved voice/caption fixtures, then add an image and a partial-narration Three.js scene at measured times, plus a safe FHD heading | Pending image/scene requirements only, no provider call |
21
+
22
+ Read the relevant topical reference for the demonstrated fields and fetch current catalog entries before adopting exact values. Returned examples **never execute**. Unit tests parse them through the same strict API parser and run the real compiler with synthetic metadata; pending examples assert requirements rather than generating assets. No test requires a real API key, paid provider or renderer.
23
+
24
+ For narrated edits, start with `narration-timing`, call `generate_assets` only after approval, wait for completion and read `get_job_result` once. Build the visual pass by editing that returned resolved YAML, following `narrated-documentary`; never copy its synthetic result IDs, transcript, word times or assets. Preserve materialized narration/captions and submit edited `composition` to add visuals; `sourceJobId` is only for unchanged continuation. Do not put visual jobs in the timing pass or use `render_video` to discover narration duration. Existing approved audio/captions can satisfy the timing checkpoint; do not add unrequested TTS/captions.
25
+
26
+ Scene prompts are concrete storyboards, not vague CSS requests. The 2D/3D examples specify subject/action, visual hierarchy, palette/material/light and local reveal/action/hold/exit. Do not copy a generic heading or demo primitive instead of the requested scene, and never add AI-production labels, disclaimers or watermarks on screen.
27
+
28
+ After paid materialization, keep the returned resolved document/assets and add/verify the intended effects, transitions and rules against existing track/clip IDs. An empty pre-generation timeline may not accept rules for future clips; that is not a reason to silently remove the user's requested final treatments.