@machinal/mcp 0.0.0-stage → 0.4.1
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.
- package/README.md +366 -2
- package/bin/machinal-mcp.mjs +19 -0
- package/bin/machinal-stdio.mjs +14 -0
- package/package.json +47 -4
- package/skills/machinal-cinema/SKILL.md +18 -0
- package/skills/machinal-cinema/references/film-library/DIRECTOR.md +149 -0
- package/skills/machinal-cinema/references/film-library/LICENSE +21 -0
- package/skills/machinal-cinema/references/film-library/MY-STYLES.md +139 -0
- package/skills/machinal-cinema/references/film-library/README.md +13 -0
- package/skills/machinal-cinema/references/film-library/TECHNIQUE.md +162 -0
- package/skills/machinal-cinema/references/film-library/core/lib.js +44 -0
- package/skills/machinal-cinema/references/film-library/core/post/crt.js +144 -0
- package/skills/machinal-cinema/references/film-library/core/three/post.js +102 -0
- package/skills/machinal-cinema/references/film-library/manifest.json +394 -0
- package/skills/machinal-cinema/references/film-library/styleboard/catalog.json +1128 -0
- package/skills/machinal-cinema/references/film-library/styles/README.md +126 -0
- package/skills/machinal-cinema/references/film-library/styles/archive-lighttable/STYLE.md +107 -0
- package/skills/machinal-cinema/references/film-library/styles/art-deco/STYLE.md +110 -0
- package/skills/machinal-cinema/references/film-library/styles/ascii-crt/STYLE.md +113 -0
- package/skills/machinal-cinema/references/film-library/styles/backrooms/STYLE.md +123 -0
- package/skills/machinal-cinema/references/film-library/styles/blueprint/STYLE.md +118 -0
- package/skills/machinal-cinema/references/film-library/styles/brick-toy/STYLE.md +112 -0
- package/skills/machinal-cinema/references/film-library/styles/briefing-board/STYLE.md +120 -0
- package/skills/machinal-cinema/references/film-library/styles/caption-news/STYLE.md +135 -0
- package/skills/machinal-cinema/references/film-library/styles/cel-anime-80s/STYLE.md +117 -0
- package/skills/machinal-cinema/references/film-library/styles/chalkboard/STYLE.md +153 -0
- package/skills/machinal-cinema/references/film-library/styles/circuit-board/STYLE.md +149 -0
- package/skills/machinal-cinema/references/film-library/styles/city-symphony/STYLE.md +140 -0
- package/skills/machinal-cinema/references/film-library/styles/countdown/STYLE.md +130 -0
- package/skills/machinal-cinema/references/film-library/styles/crayon-book/STYLE.md +107 -0
- package/skills/machinal-cinema/references/film-library/styles/dark-keynote/STYLE.md +115 -0
- package/skills/machinal-cinema/references/film-library/styles/data-physical/STYLE.md +117 -0
- package/skills/machinal-cinema/references/film-library/styles/dataviz/STYLE.md +121 -0
- package/skills/machinal-cinema/references/film-library/styles/desktop-flythrough/STYLE.md +145 -0
- package/skills/machinal-cinema/references/film-library/styles/engraving/STYLE.md +121 -0
- package/skills/machinal-cinema/references/film-library/styles/game-show/STYLE.md +116 -0
- package/skills/machinal-cinema/references/film-library/styles/glass-product/STYLE.md +108 -0
- package/skills/machinal-cinema/references/film-library/styles/halftone-dossier/STYLE.md +120 -0
- package/skills/machinal-cinema/references/film-library/styles/hd-2d/STYLE.md +109 -0
- package/skills/machinal-cinema/references/film-library/styles/hologram-hud/STYLE.md +127 -0
- package/skills/machinal-cinema/references/film-library/styles/impasto/STYLE.md +122 -0
- package/skills/machinal-cinema/references/film-library/styles/ink-wash/STYLE.md +118 -0
- package/skills/machinal-cinema/references/film-library/styles/iso-infographic/STYLE.md +115 -0
- package/skills/machinal-cinema/references/film-library/styles/isometric-picture-book/STYLE.md +130 -0
- package/skills/machinal-cinema/references/film-library/styles/kino-montage/STYLE.md +149 -0
- package/skills/machinal-cinema/references/film-library/styles/lidar-survey/STYLE.md +116 -0
- package/skills/machinal-cinema/references/film-library/styles/living-screencast/STYLE.md +122 -0
- package/skills/machinal-cinema/references/film-library/styles/lowpoly-island/STYLE.md +110 -0
- package/skills/machinal-cinema/references/film-library/styles/memphis-diorama/STYLE.md +142 -0
- package/skills/machinal-cinema/references/film-library/styles/microgame/STYLE.md +120 -0
- package/skills/machinal-cinema/references/film-library/styles/microscope/STYLE.md +106 -0
- package/skills/machinal-cinema/references/film-library/styles/midcentury-toon/STYLE.md +122 -0
- package/skills/machinal-cinema/references/film-library/styles/news-package/STYLE.md +156 -0
- package/skills/machinal-cinema/references/film-library/styles/newsreel/STYLE.md +134 -0
- package/skills/machinal-cinema/references/film-library/styles/one-line/STYLE.md +112 -0
- package/skills/machinal-cinema/references/film-library/styles/paper-lantern/STYLE.md +120 -0
- package/skills/machinal-cinema/references/film-library/styles/paper-popup/STYLE.md +117 -0
- package/skills/machinal-cinema/references/film-library/styles/papercut-red/STYLE.md +108 -0
- package/skills/machinal-cinema/references/film-library/styles/pictogram-motion/STYLE.md +119 -0
- package/skills/machinal-cinema/references/film-library/styles/pixel-rpg/STYLE.md +115 -0
- package/skills/machinal-cinema/references/film-library/styles/printed-long-take/STYLE.md +141 -0
- package/skills/machinal-cinema/references/film-library/styles/risograph/STYLE.md +123 -0
- package/skills/machinal-cinema/references/film-library/styles/rubber-hose/STYLE.md +110 -0
- package/skills/machinal-cinema/references/film-library/styles/satellite-briefing/STYLE.md +114 -0
- package/skills/machinal-cinema/references/film-library/styles/scifi-toon/STYLE.md +119 -0
- package/skills/machinal-cinema/references/film-library/styles/shadow-puppet/STYLE.md +122 -0
- package/skills/machinal-cinema/references/film-library/styles/silent-film/STYLE.md +107 -0
- package/skills/machinal-cinema/references/film-library/styles/silkscreen-poster/STYLE.md +138 -0
- package/skills/machinal-cinema/references/film-library/styles/spy-titles/STYLE.md +114 -0
- package/skills/machinal-cinema/references/film-library/styles/stained-glass/STYLE.md +121 -0
- package/skills/machinal-cinema/references/film-library/styles/swiss-motion/STYLE.md +113 -0
- package/skills/machinal-cinema/references/film-library/styles/teardown/STYLE.md +125 -0
- package/skills/machinal-cinema/references/film-library/styles/telestrator/STYLE.md +135 -0
- package/skills/machinal-cinema/references/film-library/styles/tilt-shift/STYLE.md +105 -0
- package/skills/machinal-cinema/references/film-library/styles/transit-map/STYLE.md +194 -0
- package/skills/machinal-cinema/references/film-library/styles/ukiyoe/STYLE.md +110 -0
- package/skills/machinal-cinema/references/film-library/styles/urban-sketch/STYLE.md +124 -0
- package/skills/machinal-cinema/references/film-library/styles/visual-investigation/STYLE.md +138 -0
- package/skills/machinal-cinema/references/film-library/styles/watercolor/STYLE.md +111 -0
- package/skills/machinal-cinema/references/film-library/styles/white-model/STYLE.md +113 -0
- package/skills/machinal-cinema/references/film-library/styles/whiteboard/STYLE.md +116 -0
- package/skills/machinal-cinema/references/film-library/styles/woodcut/STYLE.md +120 -0
- package/skills/machinal-cinema/references/film-library/upstream-skill.md +13 -0
- package/skills/machinal-cinema/references/film-styles.json +1322 -0
- package/skills/machinal-cinema/references/film-techniques.json +107 -0
- package/skills/machinal-cinema/references/workflow.md +58 -0
- package/skills/machinal-credits/SKILL.md +24 -0
- package/skills/machinal-editing/SKILL.md +43 -0
- package/skills/machinal-editing/references/brief.md +98 -0
- package/skills/machinal-editing/references/effects.md +58 -0
- package/skills/machinal-editing/references/looks-motion.md +37 -0
- package/skills/machinal-editing/references/styles.json +15 -0
- package/skills/machinal-editing/references/styles.md +16 -0
- package/skills/machinal-editing/references/transitions.md +46 -0
- package/skills/machinal-editing/references/workflow.md +43 -0
- package/skills/machinal-media/SKILL.md +23 -0
- package/skills/machinal-media/references/workflow.md +160 -0
- package/skills/machinal-recipes/SKILL.md +32 -0
- package/skills/machinal-recipes/references/catalog.v1.json +10445 -0
- package/skills/machinal-recipes/references/commands.md +45 -0
- package/skills/machinal-recipes/references/example.edit.yaml +26 -0
- package/skills/machinal-recipes/references/examples/caption-audio.yaml +28 -0
- package/skills/machinal-recipes/references/examples/cinematic-sequence.yaml +21 -0
- package/skills/machinal-recipes/references/examples/client-scene.yaml +26 -0
- package/skills/machinal-recipes/references/examples/generated-media.yaml +25 -0
- package/skills/machinal-recipes/references/examples/modify-snapshot.yaml +22 -0
- package/skills/machinal-recipes/references/examples/montage-v3.yaml +28 -0
- package/skills/machinal-recipes/references/examples/narrated-documentary.yaml +112 -0
- package/skills/machinal-recipes/references/examples/narration-timing.yaml +43 -0
- package/skills/machinal-recipes/references/examples/scene-edit.yaml +19 -0
- package/skills/machinal-recipes/references/examples/scene-generated-image.yaml +36 -0
- package/skills/machinal-recipes/references/examples/scene-generation.yaml +35 -0
- package/skills/machinal-recipes/references/examples/scene-image-insert.yaml +41 -0
- package/skills/machinal-recipes/references/examples/scene-three-explainer.yaml +38 -0
- package/skills/machinal-recipes/references/examples/social-hook.yaml +26 -0
- package/skills/machinal-recipes/references/examples/tutorial-clean.yaml +19 -0
- package/skills/machinal-recipes/references/examples.md +28 -0
- package/skills/machinal-recipes/references/jobs-scenes.md +206 -0
- package/skills/machinal-recipes/references/text-audio.md +118 -0
- package/skills/machinal-recipes/references/yaml.md +72 -0
- package/skills/machinal-review/SKILL.md +18 -0
- package/skills/machinal-review/references/production.md +146 -0
- package/skills/machinal-scenes/SKILL.md +44 -0
- package/skills/machinal-scenes/references/authoring.md +97 -0
- package/skills/machinal-scenes/references/runtime.md +136 -0
- package/skills/machinal-scenes/references/scene-templates/blueprint-mechanism.svelte +62 -0
- package/skills/machinal-scenes/references/scene-templates/glitch-handoff.svelte +30 -0
- package/skills/machinal-scenes/references/scene-templates/image-reveal.svelte +33 -0
- package/skills/machinal-scenes/references/scene-templates/kinetic-type.svelte +38 -0
- package/skills/machinal-scenes/references/scene-templates/layered-parallax.svelte +31 -0
- package/skills/machinal-scenes/references/scene-templates/lens-assembly-3d.svelte +57 -0
- package/skills/machinal-scenes/references/scene-templates/paper-stage-3d.svelte +83 -0
- package/skills/machinal-scenes/references/scene-templates/signal-diagram.svelte +43 -0
- package/skills/machinal-scenes/references/scene-templates/swiss-grid-motion.svelte +54 -0
- package/skills/machinal-scenes/references/scene-templates.json +178 -0
- package/skills/machinal-scenes/references/scene-templates.md +50 -0
- package/skills/machinal-scenes/references/workflow.md +206 -0
- package/skills/machinal-support/SKILL.md +42 -0
- package/src/bridge.mjs +287 -0
- package/src/cli.mjs +157 -0
- package/src/configuration.mjs +148 -0
- package/src/connection.mjs +187 -0
- package/src/credential-store.mjs +61 -0
- package/src/credits.mjs +86 -0
- package/src/docker.mjs +93 -0
- package/src/download.mjs +90 -0
- package/src/endpoints.mjs +3 -0
- package/src/errors.mjs +9 -0
- package/src/formats.mjs +140 -0
- package/src/keys.mjs +127 -0
- package/src/launch.mjs +29 -0
- package/src/local-setup.mjs +109 -0
- package/src/opencode-auth.mjs +246 -0
- package/src/opencode-checkpoints.mjs +90 -0
- package/src/opencode-configuration.mjs +53 -0
- package/src/opencode-media.mjs +139 -0
- package/src/opencode-plugin/index.mjs +7 -0
- package/src/opencode-plugin/package.json +5 -0
- package/src/opencode-recipes.mjs +130 -0
- package/src/opencode-routing.mjs +154 -0
- package/src/opencode-tools.mjs +30 -0
- package/src/opencode-workflow.mjs +32 -0
- package/src/presentation.mjs +31 -0
- package/src/prompts.mjs +32 -0
- package/src/reference-files.json +127 -0
- package/src/runtime.mjs +51 -0
- package/src/setup-options.mjs +69 -0
- package/src/setup-stdio.mjs +116 -0
- package/src/setup.mjs +173 -0
- package/src/skills.mjs +68 -0
- package/src/transfer-http.mjs +109 -0
- package/src/version.mjs +3 -0
- package/src/windows-key-prompt.mjs +37 -0
- 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.
|