@cliangdev/conductor 0.39.2 → 0.40.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.
- package/assets/claude/agents/conductor-content-art-director.md +6 -0
- package/assets/claude/commands/conductor/creative.md +5 -2
- package/assets/claude/skills/conductor-content-studio/SKILL.md +7 -0
- package/assets/claude/skills/conductor-content-studio/references/capabilities.md +9 -4
- package/assets/claude/skills/conductor-content-studio/references/compliance-checklist.md +8 -4
- package/assets/claude/skills/conductor-content-studio/references/publish-pack-template.md +1 -0
- package/assets/claude/skills/conductor-content-studio/references/slideshow-formats.md +5 -0
- package/assets/claude/skills/conductor-creative/SKILL.md +45 -8
- package/assets/claude/skills/conductor-creative/references/slideshow-formats.md +5 -0
- package/assets/claude/skills/conductor-publisher/SKILL.md +20 -0
- package/assets/cli-manifest.json +11 -11
- package/dist/creative/job/media.mjs +368 -0
- package/dist/creative/job/render.mjs +170 -61
- package/dist/lib/creative-local-render.d.ts +11 -0
- package/dist/lib/creative-local-render.d.ts.map +1 -0
- package/dist/lib/creative-local-render.js +16 -0
- package/dist/lib/creative-local-render.js.map +1 -0
- package/dist/lib/creative-render.d.ts +6 -3
- package/dist/lib/creative-render.d.ts.map +1 -1
- package/dist/lib/creative-render.js +14 -6
- package/dist/lib/creative-render.js.map +1 -1
- package/dist/mcp/index.d.ts +137 -17
- package/dist/mcp/index.d.ts.map +1 -1
- package/dist/mcp/index.js +23 -22
- package/dist/mcp/index.js.map +1 -1
- package/dist/mcp/tools/creative-drafts.d.ts +4 -1
- package/dist/mcp/tools/creative-drafts.d.ts.map +1 -1
- package/dist/mcp/tools/creative-drafts.js +39 -7
- package/dist/mcp/tools/creative-drafts.js.map +1 -1
- package/dist/mcp/tools/creatives.d.ts +4 -2
- package/dist/mcp/tools/creatives.d.ts.map +1 -1
- package/dist/mcp/tools/creatives.js +7 -3
- package/dist/mcp/tools/creatives.js.map +1 -1
- package/package.json +1 -1
- package/scripts/build-creative.mjs +1 -0
|
@@ -90,6 +90,12 @@ A single JSON object whose keys are exactly `preview_creative_draft` inputs, and
|
|
|
90
90
|
renders one headline and one optional body plus an end card holding the final frame: no timed
|
|
91
91
|
multi-beat on-screen text (extra beats go in a story or carousel sequence, or the caption). A clip background uses `background.clipMediaId` from `media.json`, or `clipPath` for a
|
|
92
92
|
user-supplied local file.
|
|
93
|
+
- Music: top-level `audio` also applies to a slideshow or other CAROUSEL (`{source: "track", trackId}`,
|
|
94
|
+
which adds a slideshow video; optional `slideshow: {slideDurations, zoom}`) and to a CLIP (`track`
|
|
95
|
+
replaces its sound, `mix` plays the track under it, `none` mutes it). Choose `trackId` from an
|
|
96
|
+
`AUDIO` entry in `media.json` before proposing any new file; a new file goes into the library
|
|
97
|
+
first, with its source and licence, and is referenced by `trackId`. Never write a direction that
|
|
98
|
+
bakes music into an MP4 outside Conductor.
|
|
93
99
|
- A STILL or MOTION always shows the kit's `ctaClaim`. If it is banned, or it is an offer line the
|
|
94
100
|
brief did not opt in to, say so in `direction.md` so the orchestrator stops and asks.
|
|
95
101
|
- Omit any field you do not need. Do not add comments or fields the tool does not take.
|
|
@@ -73,8 +73,11 @@ already covers.
|
|
|
73
73
|
Nothing is saved to Conductor until the person approves what they have seen:
|
|
74
74
|
|
|
75
75
|
1. `preview_creative_draft` with what was gathered (local files go in `photoPath`/`clipPath`/
|
|
76
|
-
`audioPath`; an edit to an existing Creative passes `baseCreativeId`).
|
|
77
|
-
|
|
76
|
+
`audioPath`; an edit to an existing Creative passes `baseCreativeId`). Music is `audio` (a MOTION,
|
|
77
|
+
a CAROUSEL slideshow or a CLIP; reuse a track from `list_creative_media({kind: "AUDIO"})`, else
|
|
78
|
+
`audioPath` and give its source and licence at commit). It renders on this machine and returns
|
|
79
|
+
the image (a CAROUSEL with a track also returns the slideshow video's path to watch) — no Creative
|
|
80
|
+
is created and nothing is uploaded.
|
|
78
81
|
2. Read `passed` and `checks` in the result first. The preview runs the full render's per-placement
|
|
79
82
|
checks (text spill, platform safe zones such as TikTok/Reels' overlay band, contrast, fonts,
|
|
80
83
|
images), so a design that would fail the real render shows up here. If `passed` is false, fix the
|
|
@@ -331,6 +331,13 @@ any placement is fixed now, not shown.
|
|
|
331
331
|
caption, slideAltText})` with the returned `slidePaths` (`9x16` for TikTok, `4x5` for Instagram),
|
|
332
332
|
the caption from `publish-pack.json` and the alt text from `direction.md`. Record the preview's
|
|
333
333
|
`draftDir` as `drafts.final`.
|
|
334
|
+
**Music:** a slideshow or clip with music uses `audio` on the Creative, and a track from
|
|
335
|
+
`context/media.json` (`kind: "AUDIO"`, unblocked) is reused before any new file. A new music file
|
|
336
|
+
is uploaded to the library first with `upload_creative_media` (with `source` and `licence`) and
|
|
337
|
+
referenced by `trackId`; never bake music into an MP4 outside Conductor. A slideshow with
|
|
338
|
+
`audio.source: "track"` previews as its slideshow MP4 too (`slideshowVideoPath`), so give the
|
|
339
|
+
person that path to watch along with the sheet, and put the track's licence in the pack's music
|
|
340
|
+
line (`references/compliance-checklist.md` section 3).
|
|
334
341
|
2. Eye-check the image. Load the `conductor-creative` skill with `Skill(skill: "conductor-creative")` and
|
|
335
342
|
apply its review guidance (step 7 and the silent-failures list), scoring the draft with
|
|
336
343
|
`references/design-critique.md` (the slideshow criteria for a slideshow, the STILL criteria
|
|
@@ -17,15 +17,20 @@ needs changing until it fits.
|
|
|
17
17
|
- Text animation presets: `fade-up`, `word-by-word`, `accent-pop` or `none`.
|
|
18
18
|
- Background: a photo with a slow zoom or pan, or a clip from the library.
|
|
19
19
|
- An end card holds the finished frame for the last 2 s.
|
|
20
|
-
- Audio: the clip's own sound, a library music track, or none.
|
|
20
|
+
- Audio: the clip's own sound, a library music track, or none (`audio.source` `clip`, `track`, `none`).
|
|
21
21
|
- This is the right tool for a motion-text post: **it does not need filming.**
|
|
22
22
|
- **CLIP**: a finished video posted as-is. There is no brand layout and nothing to draft. It only
|
|
23
|
-
applies when the person already has the video.
|
|
23
|
+
applies when the person already has the video. Its sound can be kept, replaced with a library
|
|
24
|
+
track, mixed under, or muted (`audio.source` `clip`, `track`, `mix`, `none`); `mix` needs a clip
|
|
25
|
+
that has sound.
|
|
24
26
|
- **CAROUSEL**: finished images posted as-is (1 to 10 slides for 4:5 and 1:1, up to 35 for 9:16
|
|
25
27
|
TikTok photo posts; one slide is a finished still). No brand layout is applied, so it only applies
|
|
26
28
|
when the slides already exist as image files or library media. Slides are ordered per placement
|
|
27
29
|
(`slides`, with `default` as the fallback) and each must match its placement's aspect. Reels,
|
|
28
|
-
Stories and YouTube cannot take
|
|
30
|
+
Stories and YouTube cannot take its photos. With a library music track (`audio.source` `track`)
|
|
31
|
+
it also gets a 9:16 slideshow video (`slideshow.slideDurations`, 1 to 10 s per slide, default 3 s
|
|
32
|
+
then 2.5 s; `zoom` default on), because no platform accepts a chosen track on photos. Each
|
|
33
|
+
destination then sends the photos (silent) or that video (`carouselAs`: `photos` or `video`).
|
|
29
34
|
|
|
30
35
|
- **Slideshow** (organic posts): native-looking slides made locally by `compose_slideshow` (photo with
|
|
31
36
|
text, app screenshot with callouts, Notes page, chat, photo grid, stacked before/after, tier list,
|
|
@@ -76,7 +81,7 @@ Ask for a mid-tone scene: under `bleed`, a dark or night scene can render almost
|
|
|
76
81
|
## What it cannot do (so the idea needs filming or a rethink)
|
|
77
82
|
|
|
78
83
|
- Footage of people, places, cooking or the product in use. Screen recordings of an app.
|
|
79
|
-
- Voiceover or spoken dialogue:
|
|
84
|
+
- Voiceover or spoken dialogue: Creatives carry music or a clip's sound, not speech.
|
|
80
85
|
- Charts, illustrations, or text inside a generated image. In a STILL each card is one photo plus
|
|
81
86
|
text; grids, stacks and collages exist only as slideshow slides (above).
|
|
82
87
|
- Anything that relies on a product claim the brief can't confirm. That's a copy problem, not a
|
|
@@ -65,10 +65,14 @@ pack: original audio, a library track (with its recorded `licence`), the clip's
|
|
|
65
65
|
idea fails this check and the director may disqualify it.
|
|
66
66
|
- Instagram Reels `audioName` is an attribution label for a Reel's audio; set it only when the
|
|
67
67
|
sound has a credit to give.
|
|
68
|
-
- A library track used
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
68
|
+
- A library track used on any Creative (MOTION, a CAROUSEL's slideshow video, a CLIP's replaced or
|
|
69
|
+
mixed sound) must have its `source` and `licence` recorded (the readiness checklist blocks
|
|
70
|
+
otherwise), and the licence must cover every destination the video goes to. Name the track and its
|
|
71
|
+
licence in the pack for each platform.
|
|
72
|
+
- Photo posts on TikTok: `autoAddMusic` lets TikTok pick a soundtrack. It applies only to photo
|
|
73
|
+
posts, so leave it unset unless the person chose it (the track is not one the team vetted). It is
|
|
74
|
+
not how a vetted track gets onto a carousel: no platform accepts a chosen track on photos, so a
|
|
75
|
+
carousel with a vetted track goes out as its slideshow video (`carouselAs: video`).
|
|
72
76
|
|
|
73
77
|
## 4. Claims (Veto)
|
|
74
78
|
|
|
@@ -126,6 +126,7 @@ Rules:
|
|
|
126
126
|
| Instagram | `altText` (at most 1000 characters) | a single feed image only |
|
|
127
127
|
| Instagram | `audioName`, `shareToFeed`, `collaborators` (at most 3, not on a carousel) | reels only |
|
|
128
128
|
| YouTube | `containsSyntheticMedia` | video |
|
|
129
|
+
| any of TikTok, Instagram, Facebook, YouTube | `carouselAs` (`photos` or `video`) | a CAROUSEL Creative with a music track only |
|
|
129
130
|
|
|
130
131
|
Set only what the compliance check or the plan decided: leave a key out rather than writing a
|
|
131
132
|
default. Keys that need a Post's own asset id (`coverAssetId`, `thumbnailAssetId`,
|
|
@@ -127,4 +127,9 @@ Captions on TikTok and Instagram cannot hold clickable links, so do not rely on
|
|
|
127
127
|
3. `preview_creative_draft({kind: "CAROUSEL", slidePaths, caption, slideAltText})` using the
|
|
128
128
|
returned `slidePaths` (`9x16` for TikTok, `4x5` for Instagram). Look at the contact sheet and show
|
|
129
129
|
it.
|
|
130
|
+
With music (`audio: {source: "track", trackId}`, a library track from
|
|
131
|
+
`list_creative_media({kind: "AUDIO"})`; a new file is uploaded there first with its source and
|
|
132
|
+
licence), the preview also renders the slideshow video and returns `slideshowVideoPath`: watch it
|
|
133
|
+
with the person. No platform accepts a chosen track on photos, so a destination sends the video
|
|
134
|
+
(`carouselAs: "video"`) or the silent photos.
|
|
130
135
|
4. Only after the person approves, `commit_creative_draft`.
|
|
@@ -285,13 +285,20 @@ itself and check it with the person before uploading.
|
|
|
285
285
|
`{"default": mediaId}`. A different cut per placement (e.g. a square edit for feed, a vertical one
|
|
286
286
|
for Reels): `{"9x16": mediaId, "4x5": mediaId}` — `default` still covers any placement without its
|
|
287
287
|
own entry. A reel takes exactly one video, so don't split a reel-eligible placement across two.
|
|
288
|
-
3. `render_creative` — instant for a CLIP (the backend assembles the frames;
|
|
289
|
-
|
|
288
|
+
3. `render_creative` — instant for a CLIP that keeps its own sound (the backend assembles the frames;
|
|
289
|
+
nothing renders in a browser). With `audio` (below) it encodes a new MP4 on this machine with
|
|
290
|
+
ffmpeg instead.
|
|
290
291
|
4. `preview_creative` — returns a small poster sheet across placements instead of the STILL contact
|
|
291
292
|
sheet, plus each placement's duration. Still worth a look: a poster is one frame, not the whole
|
|
292
293
|
cut, so open the actual video before calling a rough or misframed clip done.
|
|
293
294
|
5. `attach_creative_to_post`, same as any other Creative.
|
|
294
295
|
|
|
296
|
+
Music on a CLIP is `audio` on the Creative (see "Music" below): `source: "clip"` keeps the clip's
|
|
297
|
+
own sound (the default), `"track"` replaces it with a library track, `"mix"` plays the track under
|
|
298
|
+
the clip's sound (`volume` defaults to 0.3 and the music ducks under the clip's sound; the clip must have sound,
|
|
299
|
+
or `mix` is refused), `"none"` mutes it. Set it on `create_creative`/`update_creative`, then
|
|
300
|
+
`render_creative`; look at the new MP4 before attaching, since a poster is one frame.
|
|
301
|
+
|
|
295
302
|
Mind each destination's own duration limit (per docs/publishing.md) — a clip that's fine on one
|
|
296
303
|
platform may get rejected or trimmed on another; check before attaching to a Post that fans out
|
|
297
304
|
broadly.
|
|
@@ -323,6 +330,12 @@ thing).
|
|
|
323
330
|
within 2% (4x5 = 1080x1350, 9x16 = 1080x1920, 1x1 = 1080x1080); a mismatch comes back as a
|
|
324
331
|
`slideAspect` violation, so fix the image rather than the list. Limits: 10 slides for 4x5 and
|
|
325
332
|
1x1, 35 for 9x16 (TikTok photo posts); aim for 5 to 7.
|
|
333
|
+
With a music track, `audio: {source: "track", trackId}` plus `audioPath` for a file not yet in the
|
|
334
|
+
library (see "Music" below) also renders a 9:16 slideshow MP4 here: `preview_creative_draft`
|
|
335
|
+
returns it as `slideshowVideoPath` beside the contact sheet, so watch it with the person, not
|
|
336
|
+
just the sheet. `slideshow: {slideDurations, zoom}` sets the pace (one entry per 9x16 slide, 1 to
|
|
337
|
+
10 s; default 3 s for the first slide and 2.5 s for the rest) and the slow push-in (default on).
|
|
338
|
+
Keep the total short: a 20-slide default runs about 40 s.
|
|
326
339
|
4. Alt text: `slideAltText` has one entry per slide, in order (or a single Creative `altText`); readiness
|
|
327
340
|
blocks without it. Slides are never rewritten, so check them for burned-in text, logos and claims
|
|
328
341
|
and approve with `photoChecked: true`.
|
|
@@ -330,7 +343,12 @@ thing).
|
|
|
330
343
|
`attach_creative_to_post` (it renders first if needed). The mapping: Instagram feed gets `4x5`
|
|
331
344
|
(else `1x1`), Facebook feed `1x1` (else `4x5`), TikTok `9x16` (else `4x5`). Reels, Stories and
|
|
332
345
|
YouTube can't take a multi-image post; the preflight blocks with `MULTI_IMAGE_UNSUPPORTED`, so
|
|
333
|
-
switch that destination to Feed or remove it.
|
|
346
|
+
switch that destination to Feed or remove it. A carousel with a track is different: no platform
|
|
347
|
+
accepts a chosen track on photos, so each destination sends it as `carouselAs: "photos"`
|
|
348
|
+
(silent) or `"video"` (the slideshow MP4 with the track). Attach defaults to video for TikTok
|
|
349
|
+
and YouTube and photos for Instagram and Facebook feed, and writes the choice into the target's
|
|
350
|
+
options; change it with `set_publish_targets` (publisher skill). Mind each platform's length limit
|
|
351
|
+
for the video.
|
|
334
352
|
|
|
335
353
|
## Short videos from a photo or clip
|
|
336
354
|
|
|
@@ -353,8 +371,8 @@ destination rewards video over an image.
|
|
|
353
371
|
- `motion.endCard` — default true: the last 2 seconds hold the finished composition, CTA
|
|
354
372
|
included, regardless of how short the preset's own entrance would otherwise leave it.
|
|
355
373
|
- `audio` — `source: "clip"` (the background clip's own recorded sound — the default when there
|
|
356
|
-
is one), `"track"` (a
|
|
357
|
-
|
|
374
|
+
is one), `"track"` (a library track: `trackId`, plus `volume` and `fadeOutSec`; see "Music"
|
|
375
|
+
below), or `"none"`.
|
|
358
376
|
|
|
359
377
|
A MOTION Creative is one animated frame per placement: it cannot also be a story or a carousel
|
|
360
378
|
(`sequenceKind`/`sequence`) — that is refused with a 422 (`motionNoSequence`). For several beats, make
|
|
@@ -368,9 +386,28 @@ destination rewards video over an image.
|
|
|
368
386
|
machine fails with a clear message naming how to get one rather than silently producing nothing.
|
|
369
387
|
5. `attach_creative_to_post`, same as any Creative — one MP4 per placement.
|
|
370
388
|
|
|
371
|
-
A
|
|
372
|
-
|
|
373
|
-
|
|
389
|
+
A reel or other vertical placement takes exactly one video, same as a CLIP.
|
|
390
|
+
|
|
391
|
+
## Music
|
|
392
|
+
|
|
393
|
+
Music works on a MOTION (`clip`, `track` or `none`), a CAROUSEL (`track`, which makes a slideshow video) and
|
|
394
|
+
a CLIP (`track`, `mix`, `none`), through `audio: {source, trackId, volume, fadeOutSec}`. The rules
|
|
395
|
+
are the same for all three:
|
|
396
|
+
|
|
397
|
+
- Before making a video or slideshow with music, call `list_creative_media({kind: "AUDIO"})` and
|
|
398
|
+
reuse a library track that fits.
|
|
399
|
+
- A new music file goes into the library first with `upload_creative_media`, with `source` (where it
|
|
400
|
+
came from) and `licence` (the terms, e.g. "Own work", "Licensed for social use"). Then reference
|
|
401
|
+
it by `trackId`. With `audioPath` the file uploads on commit, so pass `source` and `licence` to
|
|
402
|
+
`commit_creative_draft` (or keep a `.provenance.json` sidecar beside it).
|
|
403
|
+
- Readiness blocks the Creative (`audioProvenance`) until the track's `source` and `licence` are
|
|
404
|
+
recorded, for every kind. Use only music the person has the right to use on the destination
|
|
405
|
+
platforms.
|
|
406
|
+
- Never bake music into an MP4 outside Conductor when `audio` can do it: the track then never reaches
|
|
407
|
+
the library, its licence is unrecorded, and the Creative can't change or drop it later.
|
|
408
|
+
- Volume defaults: 0.8 for MOTION, 1 for a CAROUSEL or a CLIP `track`, 0.3 for `mix`. A CAROUSEL or CLIP encode
|
|
409
|
+
normalises loudness (MOTION does not); if the level is still wrong, adjust `volume` rather than re-exporting.
|
|
410
|
+
- Rendering runs on this machine and needs ffmpeg; without it the tool fails with a clear message.
|
|
374
411
|
|
|
375
412
|
## Cleaning up
|
|
376
413
|
|
|
@@ -127,4 +127,9 @@ Captions on TikTok and Instagram cannot hold clickable links, so do not rely on
|
|
|
127
127
|
3. `preview_creative_draft({kind: "CAROUSEL", slidePaths, caption, slideAltText})` using the
|
|
128
128
|
returned `slidePaths` (`9x16` for TikTok, `4x5` for Instagram). Look at the contact sheet and show
|
|
129
129
|
it.
|
|
130
|
+
With music (`audio: {source: "track", trackId}`, a library track from
|
|
131
|
+
`list_creative_media({kind: "AUDIO"})`; a new file is uploaded there first with its source and
|
|
132
|
+
licence), the preview also renders the slideshow video and returns `slideshowVideoPath`: watch it
|
|
133
|
+
with the person. No platform accepts a chosen track on photos, so a destination sends the video
|
|
134
|
+
(`carouselAs: "video"`) or the silent photos.
|
|
130
135
|
4. Only after the person approves, `commit_creative_draft`.
|
|
@@ -87,6 +87,12 @@ destination can't take one (a carousel's slides are not a story sequence), and t
|
|
|
87
87
|
with `MULTI_IMAGE_UNSUPPORTED` naming the destination: switch it to Feed or remove it, then retry. A one-slide carousel is a single image and
|
|
88
88
|
fits anywhere an image does.
|
|
89
89
|
|
|
90
|
+
A CAROUSEL Creative with a music track is different: no platform accepts a chosen track on photos,
|
|
91
|
+
so it also has a 9:16 slideshow video, and each destination sends either the photos (silent) or that
|
|
92
|
+
one video (`carouselAs`: `photos` or `video`, see Options). Sent as a video it is a single video, so
|
|
93
|
+
it goes anywhere a video does, including a reel or YouTube, and the multi-image restriction above
|
|
94
|
+
does not apply to it.
|
|
95
|
+
|
|
90
96
|
### Scheduling with no time given
|
|
91
97
|
|
|
92
98
|
When nobody names a time, `create_post` schedules for the next five-minute mark at or after the
|
|
@@ -121,6 +127,15 @@ dropped rather than acted on. TikTok needs a `privacyLevel` from that account's
|
|
|
121
127
|
absent a stated preference (a publish pack, below, counts as one), leave every other option unset
|
|
122
128
|
rather than filling in a default.
|
|
123
129
|
|
|
130
|
+
`carouselAs` (`photos` or `video`) is the one option that is Conductor's own rather than the
|
|
131
|
+
platform's. It appears only on a destination whose media comes from a CAROUSEL Creative with a music
|
|
132
|
+
track: attaching the Creative sets it per destination (video for TikTok and YouTube, photos for
|
|
133
|
+
Instagram and Facebook feed). Tell the person which was chosen and why it matters (photos go out
|
|
134
|
+
silent, without the track), and change it with `set_publish_targets` if they want the other. On a
|
|
135
|
+
`video` destination mind the platform's length limits (Facebook reels 3 to 90 s, Instagram reels at
|
|
136
|
+
least 3 s, YouTube Shorts 60 s when a track is attached); the preflight warns. Without a track the
|
|
137
|
+
key is never set.
|
|
138
|
+
|
|
124
139
|
Then run this checklist against the copy, per destination, and **halt on any failure** — report it
|
|
125
140
|
and ask how to proceed. Do not fix content yourself.
|
|
126
141
|
|
|
@@ -159,6 +174,11 @@ set, such as a disclosure toggle or an AI label, whenever any were pre-filled or
|
|
|
159
174
|
|---|---|---|---|---|
|
|
160
175
|
| MK-12 | Instagram | @acme | 2026-09-04 14:15 Europe/Berlin | pending review |
|
|
161
176
|
|
|
177
|
+
Whenever the Post's Creative has a music track (a CAROUSEL's slideshow, a CLIP's new sound), add a
|
|
178
|
+
**Sent as** column with `photos` or `video` per destination (read it from the target's `carouselAs`
|
|
179
|
+
option in `get_post_status`; a MOTION or CLIP is always a video), so the person sees which
|
|
180
|
+
destinations carry the music.
|
|
181
|
+
|
|
162
182
|
Under it, say in one sentence who has to act next — "waiting for a reviewer; approval schedules it
|
|
163
183
|
automatically" — and, where a TikTok destination is involved, that the creator records their consent
|
|
164
184
|
in their own browser, which no tool can do for them (see "TikTok consent" below). A Post ID you cannot show in this table is a Post
|
package/assets/cli-manifest.json
CHANGED
|
@@ -663,7 +663,7 @@
|
|
|
663
663
|
},
|
|
664
664
|
{
|
|
665
665
|
"name": "set_publish_targets",
|
|
666
|
-
"description": "Replace which connected accounts a Work Item publishes to, with per-target format, media and publish options.",
|
|
666
|
+
"description": "Replace which connected accounts a Work Item publishes to, with per-target format, media and publish options (including carouselAs: photos or video, for a carousel with a music track).",
|
|
667
667
|
"category": "marketing",
|
|
668
668
|
"requiredParams": [
|
|
669
669
|
"issueId",
|
|
@@ -712,7 +712,7 @@
|
|
|
712
712
|
},
|
|
713
713
|
{
|
|
714
714
|
"name": "create_post",
|
|
715
|
-
"description": "Create, schedule and submit a Post in one call: caption, media (paths, URLs or Media library ids), destinations by account name and format, fire time, reviewers.",
|
|
715
|
+
"description": "Create, schedule and submit a Post in one call: caption, media (paths, URLs or Media library ids), destinations by account name and format, fire time, reviewers, per-destination options (carouselAs for a carousel with a track).",
|
|
716
716
|
"category": "marketing",
|
|
717
717
|
"requiredParams": [
|
|
718
718
|
"text",
|
|
@@ -816,7 +816,7 @@
|
|
|
816
816
|
},
|
|
817
817
|
{
|
|
818
818
|
"name": "list_creative_media",
|
|
819
|
-
"description": "The project's media library (photos, videos, audio) with review state and provenance. Call before uploading to reuse existing media.",
|
|
819
|
+
"description": "The project's media library (photos, videos, audio) with review state and provenance. Call before uploading to reuse existing media; call with kind AUDIO to reuse a music track.",
|
|
820
820
|
"category": "marketing"
|
|
821
821
|
},
|
|
822
822
|
{
|
|
@@ -826,7 +826,7 @@
|
|
|
826
826
|
},
|
|
827
827
|
{
|
|
828
828
|
"name": "get_creative",
|
|
829
|
-
"description": "One Creative in full: its fields, readiness checklist, and the other lettered variants in its family.",
|
|
829
|
+
"description": "One Creative in full: its fields (audio, slideshow, renderedVideo), readiness checklist, and the other lettered variants in its family.",
|
|
830
830
|
"category": "marketing",
|
|
831
831
|
"requiredParams": [
|
|
832
832
|
"creativeId"
|
|
@@ -850,12 +850,12 @@
|
|
|
850
850
|
},
|
|
851
851
|
{
|
|
852
852
|
"name": "create_creative",
|
|
853
|
-
"description": "Create a Creative, or with variantOf cut a lettered variant of an existing one. Refused with the failing rule's message on a validation or readiness error.",
|
|
853
|
+
"description": "Create a Creative, or with variantOf cut a lettered variant of an existing one. audio adds a library track to a MOTION, CAROUSEL (slideshow video) or CLIP (replace, mix or mute). Refused with the failing rule's message on a validation or readiness error.",
|
|
854
854
|
"category": "marketing"
|
|
855
855
|
},
|
|
856
856
|
{
|
|
857
857
|
"name": "update_creative",
|
|
858
|
-
"description": "Patch a Creative's fields. version must match the current value or the write is refused with a 409 conflict.",
|
|
858
|
+
"description": "Patch a Creative's fields, including audio and slideshow. version must match the current value or the write is refused with a 409 conflict.",
|
|
859
859
|
"category": "marketing",
|
|
860
860
|
"requiredParams": [
|
|
861
861
|
"creativeId",
|
|
@@ -864,7 +864,7 @@
|
|
|
864
864
|
},
|
|
865
865
|
{
|
|
866
866
|
"name": "upload_creative_media",
|
|
867
|
-
"description": "Upload a photo, video or audio file into the project's media library from a local file or a public URL, recording its provenance for the readiness checklist. Kind, dimensions, duration and audio are detected automatically; a video also gets a poster frame.",
|
|
867
|
+
"description": "Upload a photo, video or audio file into the project's media library from a local file or a public URL, recording its provenance (source, licence) for the readiness checklist; a music track needs both before review. Kind, dimensions, duration and audio are detected automatically; a video also gets a poster frame.",
|
|
868
868
|
"category": "marketing"
|
|
869
869
|
},
|
|
870
870
|
{
|
|
@@ -874,7 +874,7 @@
|
|
|
874
874
|
},
|
|
875
875
|
{
|
|
876
876
|
"name": "render_creative",
|
|
877
|
-
"description": "Render a Creative locally
|
|
877
|
+
"description": "Render a Creative locally to upload-ready frames (JPEG per placement; MP4 for MOTION, a CAROUSEL with a track, or a CLIP with new audio, encoded with ffmpeg here), or a contact sheet with previewOnly. Runs synchronously and returns the render id, state and frame URLs.",
|
|
878
878
|
"category": "marketing",
|
|
879
879
|
"requiredParams": [
|
|
880
880
|
"creativeId"
|
|
@@ -903,12 +903,12 @@
|
|
|
903
903
|
},
|
|
904
904
|
{
|
|
905
905
|
"name": "preview_creative_draft",
|
|
906
|
-
"description": "Look at a Creative before anything is saved: renders a draft locally from the create_creative fields plus local files (photoPath, clipPath, audioPath) and returns the contact sheet as an image. Never writes to Conductor; commit only after the person approves.",
|
|
906
|
+
"description": "Look at a Creative before anything is saved: renders a draft locally from the create_creative fields plus local files (photoPath, clipPath, audioPath) and returns the contact sheet as an image; a CAROUSEL with a track also renders its slideshow MP4 and returns the path. Never writes to Conductor; commit only after the person approves.",
|
|
907
907
|
"category": "marketing"
|
|
908
908
|
},
|
|
909
909
|
{
|
|
910
910
|
"name": "commit_creative_draft",
|
|
911
|
-
"description": "Save an approved draft: uploads its local files, creates (or updates) the Creative, and renders the real frames. The first write to Conductor; a draft commits once. Call get_creative to verify.",
|
|
911
|
+
"description": "Save an approved draft: uploads its local files, creates (or updates) the Creative, and renders the real frames (a CAROUSEL with a track also gets its slideshow MP4). The first write to Conductor; a draft commits once. Call get_creative to verify.",
|
|
912
912
|
"category": "marketing",
|
|
913
913
|
"requiredParams": [
|
|
914
914
|
"draftDir"
|
|
@@ -916,7 +916,7 @@
|
|
|
916
916
|
},
|
|
917
917
|
{
|
|
918
918
|
"name": "attach_creative_to_post",
|
|
919
|
-
"description": "Attach a Creative's rendered frames to a Post as its media, placement to platform, for every destination without its own custom media. Call get_post_status (postId) to verify.",
|
|
919
|
+
"description": "Attach a Creative's rendered frames to a Post as its media, placement to platform, for every destination without its own custom media. A CAROUSEL with a track is sent per target as photos or its slideshow video (carouselAs). Call get_post_status (postId) to verify.",
|
|
920
920
|
"category": "marketing",
|
|
921
921
|
"requiredParams": [
|
|
922
922
|
"creativeId",
|