@cliangdev/conductor 0.22.0 → 0.24.0

package/dist/creative/sheet.js

@@ -11,6 +11,11 @@
  *                             // the backend); ignored when the creative has a
  *                             // sequence, which always renders every beat
  *     placements?, layouts?,  // registry overrides (default: the shipped ones)
+ *     times?: number[],       // a MOTION creative's key moments (motion.js's
+ *                             // motionKeyTimes()): one ROW per time, each row
+ *                             // holding every placement in placementKeys at
+ *                             // that time. Ignored for a sequence creative
+ *                             // (MOTION creatives never carry a sequence).
  *   }
  *
  * Result contract: window.__RENDER_RESULT = { ok: true, width, height } |
@@ -21,6 +26,7 @@ import { resolveAd, resolveSequence, renderBoard, fitAll } from './render.js';
 import { placements as DEFAULT_PLACEMENTS } from './placements.js';
 import { layouts as DEFAULT_LAYOUTS } from './layouts/index.js';
 import { ensureBrandFont } from './font.js';
+import { applyMotion } from './motion.js';
 
 const SHEET_SCALE = 0.34;
 
@@ -39,8 +45,9 @@ async function main() {
   const layoutsReg = spec.layouts || DEFAULT_LAYOUTS;
   const sheet = document.getElementById('sheet');
   const boards = [];
+  const motionCells = []; // { board, time }, applied after fitAll (see below)
 
-  function addCell(ad, placementKey, label) {
+  function addCell(ad, placementKey, label, container) {
     const placement = placementsReg[placementKey];
     if (!placement) throw new Error(`unknown placement "${placementKey}"`);
     const cell = document.createElement('div');
@@ -56,17 +63,40 @@ async function main() {
     cap.className = 'cap';
     cap.textContent = label;
     cell.appendChild(cap);
-    sheet.appendChild(cell);
+    (container || sheet).appendChild(cell);
     boards.push(board);
+    return board;
   }
 
   try {
     await ensureBrandFont(spec.brand);
     const isSequence = spec.creative.sequenceKind && Array.isArray(spec.creative.sequence) && spec.creative.sequence.length;
+    const motion = spec.creative.motion;
+    const hasKeyTimes = !isSequence && Array.isArray(spec.times) && spec.times.length && motion;
+
     if (isSequence) {
       const frames = resolveSequence(spec.creative, placementsReg, layoutsReg);
       const key = spec.creative.sequenceKind === 'carousel' ? spec.creative.carouselRatio || '4x5' : 'story';
       frames.forEach((frame, i) => addCell(frame, key, `${i + 1} of ${frames.length}`));
+    } else if (hasKeyTimes) {
+      // One row per key moment, each row holding every enabled placement at that time — lets a human
+      // see how the motion progresses without downloading the full MP4 (see job/render.mjs's
+      // previewOnly MOTION path).
+      sheet.classList.add('sheet--rows');
+      const ad = resolveAd(spec.creative, placementsReg, layoutsReg);
+      const keys = Array.isArray(spec.placementKeys) && spec.placementKeys.length
+        ? spec.placementKeys
+        : Object.keys(placementsReg).filter((k) => placementsReg[k].default);
+      spec.times.forEach((t) => {
+        const row = document.createElement('div');
+        row.className = 'row';
+        sheet.appendChild(row);
+        keys.forEach((key) => {
+          const label = `${(placementsReg[key] && placementsReg[key].label) || key} · ${t.toFixed(1)}s`;
+          const board = addCell(ad, key, label, row);
+          motionCells.push({ board, time: t });
+        });
+      });
     } else {
       const ad = resolveAd(spec.creative, placementsReg, layoutsReg);
       const keys = Array.isArray(spec.placementKeys) && spec.placementKeys.length
@@ -79,6 +109,13 @@ async function main() {
     // shrinks the measured rect and would throw fitBoard's line-count math
     // off), then apply the display scale — the same order mount.js uses.
     await fitAll(sheet, placementsReg);
+
+    // Only after fitting (motion's translateY offsets are fixed px, independent of the fitted
+    // headline size, but applying it before fitBoard risked the word-span wrapping interacting with
+    // the auto-fit measurement — see motion.js).
+    const durationSec = (motion && motion.durationSec) || 8;
+    motionCells.forEach(({ board, time }) => applyMotion(board, motion, time, { durationSec }));
+
     boards.forEach((board) => {
       board.style.transformOrigin = 'top left';
       board.style.transform = `scale(${SHEET_SCALE})`;

package/dist/creative/styles.css

@@ -162,6 +162,27 @@
 .cc-cta__note { font-weight: 600; font-size: var(--cc-note-size); color: var(--cc-note-color); }
 .cc-board--light .cc-cta__note { color: var(--cc-ink-2); }
 
+/* ── Background video (a MOTION clip background) ──────────────────────────── */
+/* One generic rule for every layout: a band/card layout's photo container is
+   already `position:relative; overflow:hidden`, sized to the band/card; a
+   bleed layout has no such container, but `.cc-board` itself is
+   `position:relative; overflow:hidden` (see above), so the video simply
+   covers the whole artboard there instead. render.js always appends this
+   AFTER the still photo (a same-frame fallback while the video loads) and
+   BEFORE the panel/scrim, so plain DOM order — no z-index anywhere in this
+   file — keeps it under the copy and over the photo. `--cc-bg-transform` is
+   motion.js's Ken Burns pan/zoom; unset (a STILL board, which never calls
+   applyMotion) falls back to no transform at all. */
+.cc-bg-video {
+  position: absolute; inset: 0;
+  width: 100%; height: 100%;
+  object-fit: cover;
+  object-position: var(--cc-focal, 50% 50%);
+  transform: var(--cc-bg-transform, none);
+  transform-origin: center center;
+  display: block;
+}
+
 /* ── Safe zones (review guide only, never exported) ───────────────────────── */
 .cc-safe { position: absolute; inset: 0; pointer-events: none; }
 .cc-safe__top    { position: absolute; top: 0; left: 0; right: 0; height: var(--cc-safe-top);
@@ -187,6 +208,9 @@
   width: 100%; height: 100%;
   object-fit: cover;
   object-position: var(--cc-focal, 50% 30%);
+  /* motion.js's Ken Burns pan/zoom (a MOTION creative only); unset for STILL. */
+  transform: var(--cc-bg-transform, none);
+  transform-origin: center center;
 }
 .cc-board__scrim {
   position: absolute; left: 0; right: 0; bottom: 0; height: 220px;
@@ -219,8 +243,12 @@
 
 .cc-board--bleed {
   background-image: var(--cc-photo);
-  background-size: cover;
-  background-position: var(--cc-focal, 50% 50%);
+  /* motion.js's Ken Burns pan/zoom (a MOTION creative only) sets --cc-bg-size/--cc-bg-pos on the
+     board; a background-image has no `transform`, so the zoom/pan is expressed as a growing
+     background-size and a shifting background-position instead. Unset for STILL: falls back to the
+     original fixed cover/focal. */
+  background-size: var(--cc-bg-size, cover);
+  background-position: var(--cc-bg-pos, var(--cc-focal, 50% 50%));
   justify-content: flex-end;
 }
 
@@ -282,6 +310,9 @@
   width: 100%; height: 100%;
   object-fit: cover;
   object-position: var(--cc-focal, 50% 40%);
+  /* motion.js's Ken Burns pan/zoom (a MOTION creative only); unset for STILL. */
+  transform: var(--cc-bg-transform, none);
+  transform-origin: center center;
 }
 .cc-board--card .cc-board__panel {
   flex: 1 1 auto; min-height: 0;
@@ -304,6 +335,9 @@
   width: 100%; height: 100%;
   object-fit: cover;
   object-position: var(--cc-focal, 50% 30%);
+  /* motion.js's Ken Burns pan/zoom (a MOTION creative only); unset for STILL. */
+  transform: var(--cc-bg-transform, none);
+  transform-origin: center center;
 }
 .cc-board--split .cc-board__panel {
   flex: 1 1 auto; min-height: 0;

package/dist/lib/creative-render.d.ts

@@ -9,6 +9,11 @@ export interface RenderFrame {
     height?: number;
     sizeBytes?: number;
     warnings?: string[];
+    /** Video-frame fields — only present on a CLIP creative's frames, which reference a video, not a JPEG. */
+    durationSeconds?: number;
+    hasAudio?: boolean;
+    posterUrl?: string;
+    contentType?: string;
 }
 export interface RenderCreativeParams {
     creativeId: string;
@@ -24,9 +29,14 @@ export interface RenderCreativeResult {
     frames: RenderFrame[];
 }
 /**
- * Renders a Creative end to end: finds a local browser, runs the render core against the external
- * API, and reads back the stored render (frames with signed URLs, final state) whether or not the
- * render itself succeeded — a FAILED render still has an id and an error message worth returning.
+ * Renders a Creative end to end. STILL and MOTION creatives both find a local browser and run the
+ * render core against the external API, reading back the stored render (frames with signed URLs,
+ * final state) whether or not the render itself succeeded — a FAILED render still has an id and an
+ * error message worth returning. A MOTION render (not previewOnly) additionally needs a local ffmpeg
+ * binary — resolved the same way `upload_creative_media`/`media-probe.ts` finds one (a system binary
+ * on PATH first, else the bundled `ffmpeg-static` fallback) — and runs at a fixed 30fps; a previewOnly
+ * MOTION render (the key-moments contact sheet) needs neither ffmpeg nor a video encode, so it skips
+ * this resolution entirely. CLIP creatives never launch a browser — see {@link renderViaApi}.
  */
 export declare function renderCreative(params: RenderCreativeParams, config: Config, log?: (...args: unknown[]) => void): Promise<RenderCreativeResult>;
 //# sourceMappingURL=creative-render.d.ts.map

package/dist/lib/creative-render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"creative-render.d.ts","sourceRoot":"","sources":["../../src/lib/creative-render.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAI9C,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,WAAW,EAAE,CAAA;CACtB;AAwDD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAe,GAC3C,OAAO,CAAC,oBAAoB,CAAC,CAiC/B"}
+{"version":3,"file":"creative-render.d.ts","sourceRoot":"","sources":["../../src/lib/creative-render.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAS9C,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,0GAA0G;IAC1G,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,WAAW,EAAE,CAAA;CACtB;AAkFD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAe,GAC3C,OAAO,CAAC,oBAAoB,CAAC,CAoD/B"}

package/dist/lib/creative-render.js

@@ -10,8 +10,12 @@
 import { existsSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { apiGet } from '../mcp/api.js';
+import { apiGet, apiPost, ApiError } from '../mcp/api.js';
 import { findBrowserFactory } from './creative-browser.js';
+import { resolveFfmpegPath } from './media-probe.js';
+/** Frames per second for a MOTION render's ffmpeg encode — fixed, not user-configurable (see
+ * conductor-creative/README.md's job/render.mjs section). */
+const MOTION_FPS = 30;
 /** Where `npm run build` copies `conductor-creative/`'s runtime files, relative to this file's own
  * compiled location (`dist/lib/creative-render.js` -> `dist/creative/job/`). */
 function jobDir() {
@@ -34,11 +38,47 @@ async function loadRenderCore() {
     return { run: renderMod.run, createApiTransport: transportMod.createApiTransport };
 }
 /**
- * Renders a Creative end to end: finds a local browser, runs the render core against the external
- * API, and reads back the stored render (frames with signed URLs, final state) whether or not the
- * render itself succeeded — a FAILED render still has an id and an error message worth returning.
+ * A CLIP creative has no local browser render path at all — it's a finished video used as-is, and
+ * the backend assembles its frames itself synchronously. This just POSTs the render and relays what
+ * came back — `ApiError`'s `message` is already the server's own plain-English sentence (an RFC 7807
+ * `detail`), so a failure reaches the caller unchanged rather than wrapped in a generic message.
+ */
+async function renderViaApi(params, config) {
+    try {
+        const detail = await apiPost(`/api/v2/projects/${config.projectId}/marketing/creatives/${params.creativeId}/renders`, { previewOnly: !!params.previewOnly, renderer: params.renderer, workflowRunId: params.workflowRunId }, config);
+        return { ok: detail.state === 'SUCCEEDED', renderId: detail.id, state: detail.state, error: detail.error ?? null, frames: detail.frames ?? [] };
+    }
+    catch (err) {
+        if (err instanceof ApiError) {
+            return { ok: false, error: err.message, frames: [] };
+        }
+        throw err;
+    }
+}
+/**
+ * Renders a Creative end to end. STILL and MOTION creatives both find a local browser and run the
+ * render core against the external API, reading back the stored render (frames with signed URLs,
+ * final state) whether or not the render itself succeeded — a FAILED render still has an id and an
+ * error message worth returning. A MOTION render (not previewOnly) additionally needs a local ffmpeg
+ * binary — resolved the same way `upload_creative_media`/`media-probe.ts` finds one (a system binary
+ * on PATH first, else the bundled `ffmpeg-static` fallback) — and runs at a fixed 30fps; a previewOnly
+ * MOTION render (the key-moments contact sheet) needs neither ffmpeg nor a video encode, so it skips
+ * this resolution entirely. CLIP creatives never launch a browser — see {@link renderViaApi}.
  */
 export async function renderCreative(params, config, log = () => { }) {
+    const creative = await apiGet(`/api/v2/projects/${config.projectId}/marketing/creatives/${params.creativeId}`, config);
+    if (creative.kind === 'CLIP') {
+        return renderViaApi(params, config);
+    }
+    let ffmpegPath;
+    if (creative.kind === 'MOTION' && !params.previewOnly) {
+        try {
+            ffmpegPath = await resolveFfmpegPath();
+        }
+        catch (err) {
+            return { ok: false, error: err instanceof Error ? err.message : String(err), frames: [] };
+        }
+    }
     const { run, createApiTransport } = await loadRenderCore();
     const transport = createApiTransport({
         apiUrl: config.apiUrl,
@@ -50,7 +90,9 @@ export async function renderCreative(params, config, log = () => { }) {
         workflowRunId: params.workflowRunId,
     });
     const browserFactory = await findBrowserFactory(log);
-    const ok = await run({ transport, browserFactory, log });
+    // fps only matters on the MOTION encode path (run() ignores it otherwise); passing it
+    // unconditionally keeps this call site simple and matches the engine's own default.
+    const ok = await run({ transport, browserFactory, log, ffmpegPath, fps: MOTION_FPS });
     const renderId = transport.getRenderId();
     if (!renderId) {
         return { ok: false, error: 'The render was never started — the API rejected the request before a render id was assigned.', frames: [] };

package/dist/lib/creative-render.js.map

@@ -1 +1 @@
-{"version":3,"file":"creative-render.js","sourceRoot":"","sources":["../../src/lib/creative-render.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"creative-render.js","sourceRoot":"","sources":["../../src/lib/creative-render.ts"],"names":[],"mappings":"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"}

package/dist/lib/media-probe.d.ts

@@ -0,0 +1,55 @@
+export type MediaKind = 'IMAGE' | 'VIDEO' | 'AUDIO';
+export interface MediaProbeResult {
+    kind: MediaKind;
+    contentType: string;
+    width?: number;
+    height?: number;
+    durationSeconds?: number;
+    hasAudio?: boolean;
+    codec?: string;
+}
+interface FfprobeStream {
+    codec_type?: string;
+    codec_name?: string;
+    width?: number;
+    height?: number;
+    duration?: string;
+    nb_frames?: string;
+    disposition?: {
+        attached_pic?: number;
+    };
+}
+interface FfprobeFormat {
+    duration?: string;
+    format_name?: string;
+}
+export interface FfprobeJson {
+    streams?: FfprobeStream[];
+    format?: FfprobeFormat;
+}
+export declare const NO_FFPROBE_HINT: string;
+export declare const NO_FFMPEG_HINT: string;
+/**
+ * Pure parsing of an already-fetched `ffprobe -show_streams -show_format` JSON document — split out
+ * from `probeMedia` so tests can exercise it against fixture JSON without spawning a real process.
+ *
+ * A video stream marked `disposition.attached_pic` is cover art embedded in an audio file (common in
+ * mp3/m4a), not a picture track — it's excluded from the video-stream check so a song with cover art
+ * doesn't get classified as VIDEO. A video stream with no duration and at most one frame is a still
+ * image ffprobe happened to be pointed at (format `image2`/`png_pipe`/etc.), not a video.
+ */
+export declare function parseProbeJson(json: FfprobeJson, filePath: string): MediaProbeResult;
+export declare function resolveFfprobePath(): Promise<string>;
+export declare function resolveFfmpegPath(): Promise<string>;
+/** Test-only: binary discovery caches its result for the process lifetime (real launches are slow
+ * enough to matter within one CLI/MCP run), so tests that vary system-binary availability need to
+ * reset it between cases. */
+export declare function resetMediaBinaryCache(): void;
+/** Probes a local media file with ffprobe and classifies it as IMAGE, VIDEO or AUDIO. Throws
+ * `NO_FFPROBE_HINT` when no usable ffprobe binary can be found at all. */
+export declare function probeMedia(filePath: string): Promise<MediaProbeResult>;
+/** Extracts a single JPEG poster frame from a video at `atSeconds` (default 1s). Falls back to 0s
+ * when the clip is shorter than that (or the seek otherwise fails) rather than giving up. */
+export declare function extractPoster(videoPath: string, outJpg: string, atSeconds?: number): Promise<void>;
+export {};
+//# sourceMappingURL=media-probe.d.ts.map

package/dist/lib/media-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-probe.d.ts","sourceRoot":"","sources":["../../src/lib/media-probe.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,UAAU,aAAa;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACxC;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IACzB,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;AAED,eAAO,MAAM,eAAe,QAE8D,CAAA;AAC1F,eAAO,MAAM,cAAc,QAEiD,CAAA;AA0B5E;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAmCpF;AA8BD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAiB1D;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAgBzD;AAED;;6BAE6B;AAC7B,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAwBD;0EAC0E;AAC1E,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAI5E;AAgBD;6FAC6F;AAC7F,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQnG"}

package/dist/lib/media-probe.js

@@ -0,0 +1,221 @@
+/**
+ * Inspects and extracts frames from video/audio Creative media with ffprobe/ffmpeg: a system binary
+ * on PATH first (respects whatever the user already has — no bundled Chromium-sized re-download),
+ * else the ones bundled by `ffprobe-static`/`ffmpeg-static` (lazy-imported so requiring them doesn't
+ * add to MCP server startup cost for sessions that never touch a video/audio Creative). Mirrors the
+ * browser discovery in creative-browser.ts.
+ *
+ * `upload_creative_media` uses `probeMedia` for VIDEO/AUDIO (images keep the existing magic-byte
+ * header parse in image-dimensions.ts — no decode needed there); it and `render_creative`/CLIP use
+ * `extractPoster` for a VIDEO's poster JPEG.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { extname } from 'node:path';
+import { createRequire } from 'node:module';
+// ffprobe-static/ffmpeg-static are plain CJS with no published types; `require` (rather than a typed
+// `import`) keeps them lazy (only resolved the first time a binary is actually needed) without fighting
+// TypeScript over declarations for an untyped module.
+const require = createRequire(import.meta.url);
+export const NO_FFPROBE_HINT = 'No ffprobe could be found to inspect this media. Install ffmpeg (it includes ffprobe) system-wide, ' +
+    'or reinstall @cliangdev/conductor so its bundled ffprobe-static dependency is present.';
+export const NO_FFMPEG_HINT = 'No ffmpeg could be found to process this media. Install ffmpeg system-wide, or reinstall ' +
+    '@cliangdev/conductor so its bundled ffmpeg-static dependency is present.';
+const EXTENSION_CONTENT_TYPES = {
+    '.mp4': 'video/mp4',
+    '.m4v': 'video/mp4',
+    '.mov': 'video/quicktime',
+    '.webm': 'video/webm',
+    '.mp3': 'audio/mpeg',
+    '.m4a': 'audio/mp4',
+    '.aac': 'audio/aac',
+    '.wav': 'audio/wav',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+};
+function contentTypeFor(kind, filePath, codecName) {
+    const ext = extname(filePath).toLowerCase();
+    const byExtension = EXTENSION_CONTENT_TYPES[ext];
+    if (byExtension)
+        return byExtension;
+    if (kind === 'VIDEO')
+        return 'video/mp4';
+    if (kind === 'AUDIO')
+        return codecName === 'mp3' ? 'audio/mpeg' : 'audio/mp4';
+    return codecName === 'png' ? 'image/png' : 'image/jpeg';
+}
+/**
+ * Pure parsing of an already-fetched `ffprobe -show_streams -show_format` JSON document — split out
+ * from `probeMedia` so tests can exercise it against fixture JSON without spawning a real process.
+ *
+ * A video stream marked `disposition.attached_pic` is cover art embedded in an audio file (common in
+ * mp3/m4a), not a picture track — it's excluded from the video-stream check so a song with cover art
+ * doesn't get classified as VIDEO. A video stream with no duration and at most one frame is a still
+ * image ffprobe happened to be pointed at (format `image2`/`png_pipe`/etc.), not a video.
+ */
+export function parseProbeJson(json, filePath) {
+    const streams = json.streams ?? [];
+    const format = json.format ?? {};
+    const videoStreams = streams.filter((s) => s.codec_type === 'video' && s.disposition?.attached_pic !== 1);
+    const audioStreams = streams.filter((s) => s.codec_type === 'audio');
+    if (videoStreams.length > 0) {
+        const v = videoStreams[0];
+        const durationRaw = format.duration ?? v.duration;
+        const duration = durationRaw ? parseFloat(durationRaw) : undefined;
+        const nbFrames = v.nb_frames ? parseInt(v.nb_frames, 10) : undefined;
+        const looksLikeStillImage = !duration && (nbFrames === undefined || nbFrames <= 1);
+        if (looksLikeStillImage && audioStreams.length === 0) {
+            return { kind: 'IMAGE', contentType: contentTypeFor('IMAGE', filePath, v.codec_name), width: v.width, height: v.height, codec: v.codec_name };
+        }
+        return {
+            kind: 'VIDEO',
+            contentType: contentTypeFor('VIDEO', filePath, v.codec_name),
+            width: v.width,
+            height: v.height,
+            durationSeconds: duration,
+            hasAudio: audioStreams.length > 0,
+            codec: v.codec_name,
+        };
+    }
+    if (audioStreams.length > 0) {
+        const a = audioStreams[0];
+        const durationRaw = format.duration ?? a.duration;
+        const duration = durationRaw ? parseFloat(durationRaw) : undefined;
+        return { kind: 'AUDIO', contentType: contentTypeFor('AUDIO', filePath, a.codec_name), durationSeconds: duration, codec: a.codec_name };
+    }
+    throw new Error(`ffprobe found no usable video or audio stream in "${filePath}"`);
+}
+let cachedFfprobePath;
+let cachedFfmpegPath;
+/** True once the named command launches at all (any exit code) rather than failing to spawn
+ * (ENOENT) — that's enough to know it's a real binary on PATH, without caring what `-version`
+ * prints. Bounded by a timeout so a binary that launches but hangs doesn't wedge discovery forever. */
+function systemBinaryAvailable(command) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = (ok) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(ok);
+        };
+        let child;
+        try {
+            child = spawn(command, ['-version'], { stdio: 'ignore' });
+        }
+        catch {
+            finish(false);
+            return;
+        }
+        child.on('error', () => finish(false));
+        child.on('exit', (code) => finish(code === 0));
+        const timer = setTimeout(() => finish(false), 5000);
+        timer.unref?.();
+    });
+}
+export async function resolveFfprobePath() {
+    if (cachedFfprobePath)
+        return cachedFfprobePath;
+    if (await systemBinaryAvailable('ffprobe')) {
+        cachedFfprobePath = 'ffprobe';
+        return cachedFfprobePath;
+    }
+    try {
+        const mod = require('ffprobe-static');
+        const bundledPath = mod.path;
+        if (bundledPath && existsSync(bundledPath)) {
+            cachedFfprobePath = bundledPath;
+            return bundledPath;
+        }
+    }
+    catch {
+        // fall through to the error below
+    }
+    throw new Error(NO_FFPROBE_HINT);
+}
+export async function resolveFfmpegPath() {
+    if (cachedFfmpegPath)
+        return cachedFfmpegPath;
+    if (await systemBinaryAvailable('ffmpeg')) {
+        cachedFfmpegPath = 'ffmpeg';
+        return cachedFfmpegPath;
+    }
+    try {
+        const bundledPath = require('ffmpeg-static');
+        if (bundledPath && existsSync(bundledPath)) {
+            cachedFfmpegPath = bundledPath;
+            return bundledPath;
+        }
+    }
+    catch {
+        // fall through to the error below
+    }
+    throw new Error(NO_FFMPEG_HINT);
+}
+/** Test-only: binary discovery caches its result for the process lifetime (real launches are slow
+ * enough to matter within one CLI/MCP run), so tests that vary system-binary availability need to
+ * reset it between cases. */
+export function resetMediaBinaryCache() {
+    cachedFfprobePath = undefined;
+    cachedFfmpegPath = undefined;
+}
+function runFfprobe(ffprobePath, filePath) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(ffprobePath, ['-v', 'error', '-print_format', 'json', '-show_streams', '-show_format', filePath]);
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (d) => (stdout += d));
+        child.stderr.on('data', (d) => (stderr += d));
+        child.on('error', reject);
+        child.on('exit', (code) => {
+            if (code !== 0) {
+                reject(new Error(`ffprobe failed (exit ${code}) for "${filePath}": ${stderr.trim() || 'no error output'}`));
+                return;
+            }
+            try {
+                resolve(JSON.parse(stdout));
+            }
+            catch (err) {
+                reject(new Error(`ffprobe produced unparsable JSON for "${filePath}": ${err instanceof Error ? err.message : String(err)}`));
+            }
+        });
+    });
+}
+/** Probes a local media file with ffprobe and classifies it as IMAGE, VIDEO or AUDIO. Throws
+ * `NO_FFPROBE_HINT` when no usable ffprobe binary can be found at all. */
+export async function probeMedia(filePath) {
+    const ffprobePath = await resolveFfprobePath();
+    const json = await runFfprobe(ffprobePath, filePath);
+    return parseProbeJson(json, filePath);
+}
+function runFfmpegPoster(ffmpegPath, videoPath, outJpg, atSeconds) {
+    return new Promise((resolve, reject) => {
+        const args = ['-y', '-ss', String(atSeconds), '-i', videoPath, '-frames:v', '1', '-q:v', '2', outJpg];
+        const child = spawn(ffmpegPath, args, { stdio: ['ignore', 'ignore', 'pipe'] });
+        let stderr = '';
+        child.stderr.on('data', (d) => (stderr += d));
+        child.on('error', reject);
+        child.on('exit', (code) => {
+            if (code === 0 && existsSync(outJpg))
+                resolve();
+            else
+                reject(new Error(`ffmpeg poster extraction failed (exit ${code}) for "${videoPath}": ${stderr.trim().slice(-2000) || 'no error output'}`));
+        });
+    });
+}
+/** Extracts a single JPEG poster frame from a video at `atSeconds` (default 1s). Falls back to 0s
+ * when the clip is shorter than that (or the seek otherwise fails) rather than giving up. */
+export async function extractPoster(videoPath, outJpg, atSeconds = 1) {
+    const ffmpegPath = await resolveFfmpegPath();
+    try {
+        await runFfmpegPoster(ffmpegPath, videoPath, outJpg, atSeconds);
+    }
+    catch (err) {
+        if (atSeconds === 0)
+            throw err;
+        await runFfmpegPoster(ffmpegPath, videoPath, outJpg, 0);
+    }
+}
+//# sourceMappingURL=media-probe.js.map

package/dist/lib/media-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-probe.js","sourceRoot":"","sources":["../../src/lib/media-probe.ts"],"names":[],"mappings":"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"}

package/dist/lib/poster-sheet.d.ts

@@ -0,0 +1,10 @@
+/** One `scale=-2:360` per input, then an hstack chaining every scaled output left to right. A single
+ * input skips the stack (nothing to stack) and just scales. */
+export declare function buildSheetFilterComplex(count: number): string;
+/**
+ * Composes the given local poster JPEGs left to right into one JPEG sheet, each scaled to ~360px
+ * high. Throws on any ffmpeg failure (no binary, a bad/corrupt poster, etc.) — callers should catch
+ * this and fall back to showing a single poster on its own rather than nothing.
+ */
+export declare function composePosterSheet(posterPaths: string[]): Promise<Buffer>;
+//# sourceMappingURL=poster-sheet.d.ts.map

package/dist/lib/poster-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poster-sheet.d.ts","sourceRoot":"","sources":["../../src/lib/poster-sheet.ts"],"names":[],"mappings":"AAiBA;+DAC+D;AAC/D,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB/E"}