@cliangdev/conductor 0.21.0 → 0.23.0

package/dist/creative/styles.css

@@ -0,0 +1,314 @@
+/* styles.css — the single stylesheet a consumer needs: tokens.css + frame.css
+ * + every layouts/<name>/layout.css, concatenated in registry order so a
+ * layout can rely on frame.css cascading first. This file is generated by
+ * hand-concatenation (no build step); if you edit tokens.css, frame.css, or
+ * a layout.css, re-run the same concatenation (or copy the change into both
+ * the source file and here) and let test/registry.test.mjs catch drift on
+ * the individual files it checks. A consumer that only ever wants one board
+ * on the page can import this single file; components/layouts.js callers
+ * that want to import files individually still can (see README).
+ */
+
+/* ── from tokens.css ── */
+/* tokens.css — neutral fallback tokens for the creative artboard.
+ *
+ * This package renders no brand: every color and font here is a plain,
+ * unbranded default so a board with no brand tokens applied still renders
+ * something legible. The real values come from a workspace's Brand Kit,
+ * applied at render time as inline custom properties on the board's own root
+ * element (see render.js's applyBrandTokens / mount.js's mountBoard) — never
+ * written here and never on `:root`, so two different kits can render on the
+ * same page (e.g. two creatives side by side) without colliding.
+ *
+ * Scoped to .cc-board so it cannot collide with the host app's own styles.
+ * All custom properties are prefixed --cc- for the same reason.
+ */
+
+.cc-board {
+  --cc-accent: #6B7280;    /* neutral accent; a kit's `tokens.accent` overrides this */
+  --cc-accent-2: #4B5563;  /* a kit's `tokens.accent2` overrides this */
+
+  --cc-d-bg: #1C1C1E;      /* dark artboard background and scrim end stop */
+  --cc-d-ink: #FFFFFF;     /* headline on dark */
+
+  --cc-l-bg: #F2F2F7;      /* light artboard background */
+  --cc-l-card: #FFFFFF;    /* light-ground card/chip background */
+  --cc-ink: #222222;       /* headline on light */
+  --cc-ink-2: #717171;     /* body on light */
+
+  --cc-sky: #4AADDB;       /* safe-zone review guide only, never in an export */
+
+  --cc-elev-overlay: 0 8px 24px rgba(0,0,0,0.12);
+  --cc-elev-high: 0 8px 32px rgba(0,0,0,0.10);
+
+  --cc-font: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+}
+
+/* ── from frame.css ── */
+/* frame.css — the shared creative artboard rules: everything a layout does
+ * not own. Ratios and layouts are both data, not hardcoded here.
+ *
+ *   Placements (artboard sizes and per-placement numbers: lockup, body, cta,
+ *   card padding) live in placements.json / placements.js. render.js reads
+ *   them and sets CSS custom properties on the board (--cc-board-w,
+ *   --cc-lockup-gap, --cc-body-size, ...).
+ *
+ *   Layouts (structural families: stacked, bleed, card, split, and any added
+ *   later) live in layouts/<name>/layout.json + layout.css. This file keeps
+ *   only what every layout shares: the artboard, the lockup, the headline,
+ *   the body, the cta row, sequence anchoring, and the safe-zone review
+ *   guide.
+ *
+ * NOTHING structural here may be position:absolute. A PNG exporter that
+ * screenshots this DOM (the future render job) can drop absolutely
+ * positioned layers, so every photo and scrim stays in normal flow: photos
+ * are painted as background-image on the artboard or a band, scrims are
+ * background-image on the text panel.
+ *
+ * This file has no @import and no font-face: fonts are brand data (a kit's
+ * `fontUrl`), loaded by mount.js's loadFont(), never bundled here.
+ */
+
+/* ── Artboard ─────────────────────────────────────────────────────────────── */
+.cc-board {
+  position: relative;
+  overflow: hidden;
+  box-sizing: border-box;
+  font-family: var(--cc-font);
+  background-color: var(--cc-d-bg);
+  -webkit-font-smoothing: antialiased;
+  flex: none;
+  display: flex;
+  flex-direction: column;
+  width: var(--cc-board-w);
+  height: var(--cc-board-h);
+}
+.cc-board--light { background-color: var(--cc-l-bg); }
+
+.cc-board__panel {
+  position: relative; /* keeps the panel above the glow */
+  box-sizing: border-box;
+  display: flex; flex-direction: column; align-items: flex-start;
+}
+
+/* ── Sequence frames (stories and carousels) ──────────────────────────────── */
+/* Anchored to the bottom on every frame so the eye does not have to re-find the
+   copy between taps or swipes. The CTA appears only on the last frame. */
+.cc-board--seq .cc-lockup { position: absolute; top: var(--cc-safe-top, 48px); left: 88px; }
+
+/* ── Lockup ───────────────────────────────────────────────────────────────── */
+/* Renders only when the brand kit has a mark and/or a wordmark image; a kit
+   with neither renders no lockup at all (see render.js's buildLockup). */
+.cc-lockup { display: inline-flex; align-items: center; flex: none; align-self: flex-start; gap: var(--cc-lockup-gap); }
+.cc-lockup__icon { display: block; width: var(--cc-icon-size); height: var(--cc-icon-size); border-radius: var(--cc-icon-radius); }
+.cc-lockup__mark { display: block; height: var(--cc-mark-height); }
+.cc-lockup--spacer { visibility: hidden; }
+
+/* Chip variant: a white pill behind the lockup, for busy photography (ported
+   from nexus's schema.json `lockup: "chip"` / render.js). `--cc-l-card` and
+   `--cc-elev-overlay` are tokens.css's neutral light-ground surface and
+   shadow — brand-agnostic, so a white pill works over any brand's photo. */
+.cc-lockup--chip {
+  border-radius: 999px;
+  background: var(--cc-l-card);
+  box-shadow: var(--cc-elev-overlay);
+  padding: var(--cc-chip-pad);
+  gap: var(--cc-chip-gap);
+}
+.cc-lockup--chip .cc-lockup__icon {
+  width: var(--cc-chip-icon, var(--cc-icon-size));
+  height: var(--cc-chip-icon, var(--cc-icon-size));
+  border-radius: var(--cc-chip-icon-radius, var(--cc-icon-radius));
+}
+.cc-lockup--chip .cc-lockup__mark { height: var(--cc-chip-mark, var(--cc-mark-height)); }
+
+/* ── Headline ─────────────────────────────────────────────────────────────── */
+.cc-headline {
+  margin: 0;
+  font-size: var(--cc-h-size);
+  line-height: var(--cc-h-leading, 1.04);
+  font-weight: 800;
+  letter-spacing: var(--cc-h-track, -2.3px);
+  color: var(--cc-d-ink);
+  text-wrap: balance;
+}
+.cc-board--light .cc-headline { color: var(--cc-ink); }
+.cc-headline em { font-style: italic; color: var(--cc-accent); }
+
+/* ── Body ─────────────────────────────────────────────────────────────────── */
+.cc-body {
+  margin: 0;
+  font-weight: 500;
+  text-wrap: pretty;
+  font-size: var(--cc-body-size);
+  line-height: var(--cc-body-lh);
+  max-width: var(--cc-body-max-w);
+  color: var(--cc-body-color);
+}
+.cc-board--light .cc-body { font-size: var(--cc-light-body-size, var(--cc-body-size)); color: var(--cc-ink-2); }
+
+/* ── CTA row ──────────────────────────────────────────────────────────────── */
+/* Renders only when the kit has a badge image and/or a ctaClaim string; a kit
+   with neither renders no cta row at all (see render.js's buildCta). */
+.cc-cta { display: flex; align-items: center; flex-wrap: wrap; flex: none; gap: var(--cc-cta-gap); margin-top: var(--cc-cta-margin-top, 0); }
+
+/* The badge is brand artwork (a kit's `logos.badge`): sized by height only in
+   render.js, its own intrinsic aspect ratio preserved. Nothing here may
+   restyle it — no border, no border-radius, no filter, no shadow, no overlay —
+   since a store badge (Apple's, Google's, or a kit's own) typically comes with
+   guidelines against exactly that. */
+.cc-badge { display: block; flex: none; width: auto; }
+
+.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); }
+
+/* ── 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);
+                   background: rgba(74,173,219,0.28); border-bottom: 2px dashed var(--cc-sky); }
+.cc-safe__bottom { position: absolute; bottom: 0; left: 0; right: 0; height: var(--cc-safe-bottom);
+                   background: rgba(74,173,219,0.28); border-top: 2px dashed var(--cc-sky); }
+.cc-safe__right  { position: absolute; bottom: var(--cc-safe-bottom); top: var(--cc-safe-top); right: 0;
+                   width: var(--cc-safe-right);
+                   background: rgba(74,173,219,0.20); border-left: 2px dashed var(--cc-sky); }
+
+/* ── from layouts/stacked/layout.css ── */
+/* stacked — photo band pinned top over a solid text panel. */
+
+.cc-board__band {
+  position: relative;
+  flex: 0 0 auto;
+  height: var(--cc-band-h);
+  overflow: hidden;
+  margin-bottom: -2px; /* hides a subpixel seam against the panel below */
+}
+.cc-board__band img {
+  position: absolute; inset: 0;
+  width: 100%; height: 100%;
+  object-fit: cover;
+  object-position: var(--cc-focal, 50% 30%);
+}
+.cc-board__scrim {
+  position: absolute; left: 0; right: 0; bottom: 0; height: 220px;
+  background: linear-gradient(to top,
+    var(--cc-d-bg) 0%, var(--cc-d-bg) 18%,
+    rgba(28,28,30,0.75) 42%, rgba(28,28,30,0.25) 72%, rgba(28,28,30,0) 100%);
+}
+.cc-board__glow {
+  position: absolute; right: -200px; bottom: -260px;
+  width: 720px; height: 720px; border-radius: 50%;
+  background: radial-gradient(circle, color-mix(in srgb, var(--cc-accent) 13%, transparent), transparent 68%);
+  pointer-events: none;
+}
+
+.cc-board--stacked .cc-board__panel { flex: 1 1 auto; min-height: 0; }
+.cc-r-9x16.cc-board--stacked .cc-board__panel,
+.cc-r-story.cc-board--stacked .cc-board__panel {
+  padding: 88px 88px var(--cc-pad-b, var(--cc-safe-bottom, 430px));
+  justify-content: space-between;
+  gap: 26px;
+}
+.cc-r-4x5.cc-board--stacked .cc-board__panel {
+  padding: 0 88px 88px;
+  justify-content: center;
+  gap: 20px;
+}
+
+/* ── from layouts/bleed/layout.css ── */
+/* bleed — photo covers the whole artboard, text sits over a scrim. */
+
+.cc-board--bleed {
+  background-image: var(--cc-photo);
+  background-size: cover;
+  background-position: var(--cc-focal, 50% 50%);
+  justify-content: flex-end;
+}
+
+/* Fill variant (9x16, 4x5, story): the scrim covers the artboard and the
+   copy is distributed from top to bottom over it. */
+.cc-board__panel--fill {
+  flex: 1 1 auto;
+  height: 100%;
+  justify-content: space-between;
+}
+.cc-r-9x16 .cc-board__panel--fill,
+.cc-r-story .cc-board__panel--fill {
+  padding: 48px 88px var(--cc-safe-bottom, 430px);
+  background-image: linear-gradient(to top,
+    rgba(0,0,0,0.94) 0%, rgba(0,0,0,0.88) 42%,
+    rgba(0,0,0,0.68) 62%, rgba(0,0,0,0.34) 80%, rgba(0,0,0,0.55) 100%);
+}
+.cc-r-4x5 .cc-board__panel--fill {
+  padding: 48px 88px 96px;
+  background-image: linear-gradient(to top,
+    rgba(0,0,0,0.94) 0%, rgba(0,0,0,0.88) 48%,
+    rgba(0,0,0,0.62) 70%, rgba(0,0,0,0.30) 86%, rgba(0,0,0,0.50) 100%);
+}
+/* The chip's own padding already reads as a visual left inset over a full-bleed photo; nudge it back
+   flush with the panel's other content (ported from nexus's bleed layout.css). */
+.cc-board__panel--fill .cc-lockup--chip { margin-left: -40px; }
+
+/* Sequence frames (stories and carousels): anchored bottom so the eye does
+   not have to re-find the copy between taps or swipes. */
+.cc-board--seq .cc-board__panel--fill { justify-content: flex-end; gap: 28px; }
+.cc-board--story.cc-board--bleed .cc-board__panel--fill { padding-top: var(--cc-safe-top, 250px); }
+
+/* Bottom variant (every 1x1, forced via perPlacement). */
+.cc-board__panel--bottom {
+  flex: 0 0 auto;
+  padding: 220px 72px 48px;
+  gap: 14px;
+  background-image: linear-gradient(to top,
+    rgba(28,28,30,0.97) 0%, rgba(28,28,30,0.95) 42%,
+    rgba(28,28,30,0.74) 66%, rgba(28,28,30,0.26) 88%, rgba(28,28,30,0) 100%);
+}
+
+/* ── from layouts/card/layout.css ── */
+/* card — the light layout: inset rounded photo card on a light page. */
+
+.cc-board--card { padding: var(--cc-card-pad); gap: var(--cc-card-gap); }
+
+.cc-board__card {
+  position: relative;
+  width: 100%;
+  height: var(--cc-band-h);
+  flex: 0 0 auto;
+  border-radius: 24px;
+  overflow: hidden;
+  box-shadow: var(--cc-elev-high);
+}
+.cc-board__card img {
+  position: absolute; inset: 0;
+  width: 100%; height: 100%;
+  object-fit: cover;
+  object-position: var(--cc-focal, 50% 40%);
+}
+.cc-board--card .cc-board__panel {
+  flex: 1 1 auto; min-height: 0;
+  justify-content: center;
+  gap: 28px;
+}
+
+/* ── from layouts/split/layout.css ── */
+/* split — photo on the top half, plain panel below, no scrim. Proves a fourth
+   layout needs only this folder plus an entry in layouts/index.json. */
+
+.cc-board--split .cc-board__band {
+  position: relative;
+  flex: 0 0 auto;
+  height: var(--cc-band-h);
+  overflow: hidden;
+}
+.cc-board--split .cc-board__band img {
+  position: absolute; inset: 0;
+  width: 100%; height: 100%;
+  object-fit: cover;
+  object-position: var(--cc-focal, 50% 30%);
+}
+.cc-board--split .cc-board__panel {
+  flex: 1 1 auto; min-height: 0;
+  padding: 72px 88px;
+  justify-content: center;
+  gap: 24px;
+  background-color: var(--cc-d-bg);
+}

package/dist/creative/tokens.css

@@ -0,0 +1,33 @@
+/* tokens.css — neutral fallback tokens for the creative artboard.
+ *
+ * This package renders no brand: every color and font here is a plain,
+ * unbranded default so a board with no brand tokens applied still renders
+ * something legible. The real values come from a workspace's Brand Kit,
+ * applied at render time as inline custom properties on the board's own root
+ * element (see render.js's applyBrandTokens / mount.js's mountBoard) — never
+ * written here and never on `:root`, so two different kits can render on the
+ * same page (e.g. two creatives side by side) without colliding.
+ *
+ * Scoped to .cc-board so it cannot collide with the host app's own styles.
+ * All custom properties are prefixed --cc- for the same reason.
+ */
+
+.cc-board {
+  --cc-accent: #6B7280;    /* neutral accent; a kit's `tokens.accent` overrides this */
+  --cc-accent-2: #4B5563;  /* a kit's `tokens.accent2` overrides this */
+
+  --cc-d-bg: #1C1C1E;      /* dark artboard background and scrim end stop */
+  --cc-d-ink: #FFFFFF;     /* headline on dark */
+
+  --cc-l-bg: #F2F2F7;      /* light artboard background */
+  --cc-l-card: #FFFFFF;    /* light-ground card/chip background */
+  --cc-ink: #222222;       /* headline on light */
+  --cc-ink-2: #717171;     /* body on light */
+
+  --cc-sky: #4AADDB;       /* safe-zone review guide only, never in an export */
+
+  --cc-elev-overlay: 0 8px 24px rgba(0,0,0,0.12);
+  --cc-elev-high: 0 8px 32px rgba(0,0,0,0.10);
+
+  --cc-font: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+}

package/dist/index.js

@@ -14,6 +14,7 @@ import { registerConfig } from './commands/config.js';
 import { registerDashboard } from './commands/dashboard.js';
 import { registerStatus } from './commands/status.js';
 import { registerLint } from './commands/lint.js';
+import { registerCreative } from './commands/creative.js';
 const program = new Command();
 program
     .name('conductor')
@@ -30,5 +31,6 @@ registerConfig(program);
 registerDashboard(program);
 registerStatus(program);
 registerLint(program);
+registerCreative(program);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,qDAAqD,CAAC;KAClE,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,aAAa,CAAC,OAAO,CAAC,CAAA;AACtB,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,YAAY,CAAC,OAAO,CAAC,CAAA;AACrB,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,aAAa,CAAC,OAAO,CAAC,CAAA;AACtB,YAAY,CAAC,OAAO,CAAC,CAAA;AACrB,WAAW,CAAC,OAAO,CAAC,CAAA;AACpB,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,iBAAiB,CAAC,OAAO,CAAC,CAAA;AAC1B,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,YAAY,CAAC,OAAO,CAAC,CAAA;AAErB,OAAO,CAAC,KAAK,EAAE,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEzD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,qDAAqD,CAAC;KAClE,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,aAAa,CAAC,OAAO,CAAC,CAAA;AACtB,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,YAAY,CAAC,OAAO,CAAC,CAAA;AACrB,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,aAAa,CAAC,OAAO,CAAC,CAAA;AACtB,YAAY,CAAC,OAAO,CAAC,CAAA;AACrB,WAAW,CAAC,OAAO,CAAC,CAAA;AACpB,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,iBAAiB,CAAC,OAAO,CAAC,CAAA;AAC1B,cAAc,CAAC,OAAO,CAAC,CAAA;AACvB,YAAY,CAAC,OAAO,CAAC,CAAA;AACrB,gBAAgB,CAAC,OAAO,CAAC,CAAA;AAEzB,OAAO,CAAC,KAAK,EAAE,CAAA"}

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

@@ -0,0 +1,25 @@
+/**
+ * Finds a locally-installed browser to render Creatives with, using `playwright-core` (a dependency
+ * of this package, not the browser-bundling `playwright`). `conductor-creative/job/render.mjs`'s own
+ * CLI bootstrap depends on full `playwright` (it ships its own Chromium download) because it's meant
+ * to run inside a container built for that purpose; the CLI/MCP server run on a user's own machine,
+ * so they discover whatever Chromium-family browser is already there instead of bundling one — the
+ * same shape nexus-marketing's `rexipe-social` MCP server used.
+ *
+ * `playwright-core` itself is lazy-imported (see `findBrowserFactory`) so requiring it doesn't add
+ * to MCP server startup cost for sessions that never call a creative tool.
+ */
+import type { Browser } from 'playwright-core';
+export type BrowserFactory = () => Promise<Browser>;
+export declare const CHROME_INSTALL_HINT: string;
+/**
+ * Returns a factory that, when the render core first asks for a browser, launches the first one it can
+ * find in the order above. Launching is deferred to that call on purpose: `run()` fetches the spec before
+ * it asks for a browser, and a browser launched ahead of a spec fetch that then fails is never closed —
+ * it keeps the CLI process alive and leaks a Chrome process from the MCP server.
+ *
+ * The factory throws `CHROME_INSTALL_HINT` plus what each attempt failed with when nothing launches;
+ * `run()` catches that and reports it as the render's failure.
+ */
+export declare function findBrowserFactory(log?: (...args: unknown[]) => void): Promise<BrowserFactory>;
+//# sourceMappingURL=creative-browser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"creative-browser.d.ts","sourceRoot":"","sources":["../../src/lib/creative-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,iBAAiB,CAAA;AAE7D,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnD,eAAO,MAAM,mBAAmB,QAI4C,CAAA;AAa5E;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,GAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAe9G"}

package/dist/lib/creative-browser.js

@@ -0,0 +1,36 @@
+export const CHROME_INSTALL_HINT = 'No installed browser could be launched for creative rendering. Try one of:\n' +
+    '  - Google Chrome (launched via Playwright channel "chrome")\n' +
+    '  - Microsoft Edge (launched via Playwright channel "msedge")\n' +
+    '  - a Playwright-managed Chromium: run `npx playwright install chromium`';
+const ATTEMPTS = [
+    { label: 'system Chrome (channel: chrome)', options: { channel: 'chrome' } },
+    { label: 'system Edge (channel: msedge)', options: { channel: 'msedge' } },
+    { label: 'Playwright-managed Chromium', options: {} },
+];
+/**
+ * Returns a factory that, when the render core first asks for a browser, launches the first one it can
+ * find in the order above. Launching is deferred to that call on purpose: `run()` fetches the spec before
+ * it asks for a browser, and a browser launched ahead of a spec fetch that then fails is never closed —
+ * it keeps the CLI process alive and leaks a Chrome process from the MCP server.
+ *
+ * The factory throws `CHROME_INSTALL_HINT` plus what each attempt failed with when nothing launches;
+ * `run()` catches that and reports it as the render's failure.
+ */
+export async function findBrowserFactory(log = () => { }) {
+    const { chromium } = await import('playwright-core');
+    return async () => {
+        const errors = [];
+        for (const attempt of ATTEMPTS) {
+            try {
+                const browser = await chromium.launch(attempt.options);
+                log(`using ${attempt.label}`);
+                return browser;
+            }
+            catch (err) {
+                errors.push(`${attempt.label}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        throw new Error(`${CHROME_INSTALL_HINT}\n\nTried:\n${errors.map((e) => `  - ${e}`).join('\n')}`);
+    };
+}
+//# sourceMappingURL=creative-browser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"creative-browser.js","sourceRoot":"","sources":["../../src/lib/creative-browser.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,mBAAmB,GAC9B,8EAA8E;IAC9E,gEAAgE;IAChE,iEAAiE;IACjE,0EAA0E,CAAA;AAO5E,MAAM,QAAQ,GAAc;IAC1B,EAAE,KAAK,EAAE,iCAAiC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;IAC5E,EAAE,KAAK,EAAE,+BAA+B,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;IAC1E,EAAE,KAAK,EAAE,6BAA6B,EAAE,OAAO,EAAE,EAAE,EAAE;CACtD,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAoC,GAAG,EAAE,GAAE,CAAC;IACnF,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAA;IACpD,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;gBACtD,GAAG,CAAC,SAAS,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;gBAC7B,OAAO,OAAO,CAAA;YAChB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACtF,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,mBAAmB,eAAe,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClG,CAAC,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Creatives are shown to people by display id — "12a", "12b" — on the web page, in list_creatives and in
+ * the copyable "render this" commands, while the API addresses them by UUID. Tools and the CLI accept
+ * either and resolve a display id here, so a model or a person can pass what they were shown.
+ */
+import type { Config } from '../mcp/config.js';
+export declare function resolveCreativeId(idOrDisplayId: string, config: Config): Promise<string>;
+//# sourceMappingURL=creative-id.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"creative-id.d.ts","sourceRoot":"","sources":["../../src/lib/creative-id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAM9C,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU9F"}

package/dist/lib/creative-id.js

@@ -0,0 +1,14 @@
+import { apiGet } from '../mcp/api.js';
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const DISPLAY_ID = /^\d+[a-z]$/i;
+export async function resolveCreativeId(idOrDisplayId, config) {
+    const value = idOrDisplayId.trim();
+    if (UUID.test(value) || !DISPLAY_ID.test(value))
+        return value;
+    const creatives = await apiGet(`/api/v2/projects/${config.projectId}/marketing/creatives`, config);
+    const match = creatives.find((c) => (c.displayId ?? '').toLowerCase() === value.toLowerCase());
+    if (!match)
+        throw new Error(`No Creative ${value} in this workspace — call list_creatives for the ids that exist.`);
+    return match.id;
+}
+//# sourceMappingURL=creative-id.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"creative-id.js","sourceRoot":"","sources":["../../src/lib/creative-id.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,MAAM,IAAI,GAAG,iEAAiE,CAAA;AAC9E,MAAM,UAAU,GAAG,aAAa,CAAA;AAEhC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,aAAqB,EAAE,MAAc;IAC3E,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,CAAA;IAClC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC7D,MAAM,SAAS,GAAG,MAAM,MAAM,CAC5B,oBAAoB,MAAM,CAAC,SAAS,sBAAsB,EAC1D,MAAM,CACP,CAAA;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;IAC9F,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,kEAAkE,CAAC,CAAA;IACnH,OAAO,KAAK,CAAC,EAAE,CAAA;AACjB,CAAC"}

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

@@ -0,0 +1,38 @@
+import type { Config } from '../mcp/config.js';
+export interface RenderFrame {
+    id?: string;
+    placementKey: string;
+    platform?: string;
+    sequenceIndex?: number | null;
+    url?: string;
+    width?: number;
+    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;
+    previewOnly?: boolean;
+    renderer?: string;
+    workflowRunId?: string;
+}
+export interface RenderCreativeResult {
+    ok: boolean;
+    renderId?: string;
+    state?: string;
+    error?: string | null;
+    frames: RenderFrame[];
+}
+/**
+ * Renders a Creative end to end. STILL creatives 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. CLIP (and MOTION) 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

@@ -0,0 +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;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;AA+ED;;;;;GAKG;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,CAyC/B"}

package/dist/lib/creative-render.js

@@ -0,0 +1,95 @@
+/**
+ * Runs a Creative render locally: loads the render core copied into `dist/creative/` at build time
+ * (see `scripts/build-creative.mjs`), drives it against the external v2 creatives API with this
+ * project's own API key, and reads back the stored result. Shared by the `conductor creative render`
+ * CLI command and the `render_creative` MCP tool so the two never drift.
+ *
+ * The render core itself (`conductor-creative/job/render.mjs`'s `run()`) knows nothing about how it's
+ * launched or what browser it gets — that's `job/transport.mjs`'s and this file's job respectively.
+ */
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { apiGet, apiPost, ApiError } from '../mcp/api.js';
+import { findBrowserFactory } from './creative-browser.js';
+/** 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() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return join(here, '..', 'creative', 'job');
+}
+async function loadRenderCore() {
+    const dir = jobDir();
+    const renderPath = join(dir, 'render.mjs');
+    const transportPath = join(dir, 'transport.mjs');
+    if (!existsSync(renderPath) || !existsSync(transportPath)) {
+        throw new Error(`Creative render core not found under ${dir}. This is a packaging bug in @cliangdev/conductor ` +
+            '(the build step that copies conductor-creative/ into dist/creative/ did not run) — ' +
+            'reinstall the CLI, or in this repo run `npm run build`.');
+    }
+    const [renderMod, transportMod] = await Promise.all([
+        import(renderPath),
+        import(transportPath),
+    ]);
+    return { run: renderMod.run, createApiTransport: transportMod.createApiTransport };
+}
+/**
+ * A CLIP (or, once PR 2 lands, MOTION) creative has no local browser render path — the backend either
+ * assembles the frames itself synchronously (CLIP) or refuses with a 422 explaining why (MOTION, until
+ * its renderer ships). Either way 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 MOTION 422
+ * reaches the caller unchanged rather than wrapped in a generic "never started" 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 creatives 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. CLIP (and MOTION) 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 && creative.kind !== 'STILL') {
+        return renderViaApi(params, config);
+    }
+    const { run, createApiTransport } = await loadRenderCore();
+    const transport = createApiTransport({
+        apiUrl: config.apiUrl,
+        apiKey: config.apiKey,
+        projectId: config.projectId,
+        creativeId: params.creativeId,
+        previewOnly: !!params.previewOnly,
+        renderer: params.renderer,
+        workflowRunId: params.workflowRunId,
+    });
+    const browserFactory = await findBrowserFactory(log);
+    const ok = await run({ transport, browserFactory, log });
+    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: [] };
+    }
+    try {
+        const detail = await apiGet(`/api/v2/projects/${config.projectId}/marketing/creatives/${params.creativeId}/renders/${renderId}`, config);
+        return { ok, renderId, state: detail.state, error: detail.error ?? null, frames: detail.frames ?? [] };
+    }
+    catch (err) {
+        return {
+            ok,
+            renderId,
+            error: `Render finished (${ok ? 'succeeded' : 'failed'}) but reading the result back failed: ${err instanceof Error ? err.message : String(err)}`,
+            frames: [],
+        };
+    }
+}
+//# sourceMappingURL=creative-render.js.map

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

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

package/dist/lib/image-dimensions.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Reads an image's format and pixel dimensions straight from its file header — no decode, no
+ * external image library. Used by `upload_creative_photo`, which needs width/height and content
+ * type before minting an upload (the backend's `CreateCreativePhotoRequest` requires both, since
+ * Conductor has no server-side image pipeline and WebP in particular cannot be probed there).
+ *
+ * Covers exactly the three formats the Creative photo API accepts (image/png, image/jpeg,
+ * image/webp). Returns `null` for anything else or a header that doesn't parse — callers should
+ * treat that as "not a usable photo" rather than guessing.
+ */
+export type CreativePhotoContentType = 'image/png' | 'image/jpeg' | 'image/webp';
+export interface ImageInfo {
+    contentType: CreativePhotoContentType;
+    width: number;
+    height: number;
+}
+/** Sniffs the format from magic bytes and parses width/height from the header. `null` when the
+ * bytes aren't a recognizable PNG, JPEG or WebP, or the header is truncated/malformed. */
+export declare function readImageDimensions(bytes: Uint8Array): ImageInfo | null;
+//# sourceMappingURL=image-dimensions.d.ts.map

package/dist/lib/image-dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-dimensions.d.ts","sourceRoot":"","sources":["../../src/lib/image-dimensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,CAAA;AAEhF,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,wBAAwB,CAAA;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAuGD;0FAC0F;AAC1F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAEvE"}