@cliangdev/conductor 0.20.6 → 0.22.0

package/dist/mcp/tools/creatives.d.ts

@@ -0,0 +1,93 @@
+import { Config } from '../config.js';
+export declare function getBrandKit(params: {
+    kitId?: string;
+}, config: Config): Promise<Record<string, unknown>>;
+export declare function listCreatives(params: {
+    state?: string;
+    brandKitId?: string;
+}, config: Config): Promise<Array<Record<string, unknown>>>;
+export declare function getCreative(params: {
+    creativeId: string;
+}, config: Config): Promise<Record<string, unknown>>;
+/**
+ * Starts a hook experiment on a Creative family (>= 2 lettered variants; one RUNNING experiment per
+ * family at a time — a second attempt is refused with a 409). It settles on its own once every variant
+ * has published and reported (or via the weekly "what's working" job) — nothing further to call. Read
+ * the result through get_creative, whose experiment field carries the current state, and once DECIDED,
+ * the winner and its numbers.
+ */
+export declare function createExperiment(params: {
+    creativeId: string;
+    metric?: string;
+    windowHours?: number;
+}, config: Config): Promise<Record<string, unknown>>;
+export interface CreativeLayoutOverrides {
+    band?: Record<string, number>;
+    padBottom?: Record<string, number>;
+}
+export interface CreativeFields {
+    brandKitId?: string;
+    name?: string;
+    state?: string;
+    layout?: string;
+    theme?: string;
+    photoId?: string;
+    focalOverride?: Record<string, string>;
+    headline?: string;
+    body?: string;
+    caption?: string;
+    altText?: string;
+    placements?: string[];
+    sequenceKind?: string;
+    sequence?: Array<Record<string, unknown>>;
+    carouselRatio?: string;
+    /** 'plain' (default) or 'chip' — puts the logo lockup on a white pill, for busy photography. */
+    lockup?: string;
+    /** Per-placement overrides of layout-derived numbers, in pixels — see conductor-creative/README.md. */
+    layoutOverrides?: CreativeLayoutOverrides;
+}
+export interface CreateCreativeParams extends CreativeFields {
+    /** Cuts a lettered variant of this existing Creative instead of creating a fresh one — everything
+     * else on this call except `headline` and `name` is ignored, matching the variants endpoint. */
+    variantOf?: string;
+}
+export declare function createCreative(params: CreateCreativeParams, config: Config): Promise<Record<string, unknown>>;
+export interface UpdateCreativeParams extends CreativeFields {
+    creativeId: string;
+    version: number;
+}
+export declare function updateCreative(params: UpdateCreativeParams, config: Config): Promise<Record<string, unknown>>;
+export declare function uploadCreativePhoto(params: {
+    filePath?: string;
+    url?: string;
+    label?: string;
+    source?: string;
+    licence?: string;
+    aiGenerated?: boolean;
+}, config: Config): Promise<Record<string, unknown>>;
+export declare function renderCreativeTool(params: {
+    creativeId: string;
+    previewOnly?: boolean;
+    renderer?: string;
+    workflowRunId?: string;
+}, config: Config): Promise<Record<string, unknown>>;
+export interface PreviewCreativeResult {
+    renderId?: string;
+    state?: string;
+    url?: string;
+    image?: {
+        data: Buffer;
+        mimeType: string;
+    };
+    note?: string;
+}
+export declare function previewCreative(params: {
+    creativeId: string;
+}, config: Config): Promise<PreviewCreativeResult>;
+export declare function attachCreativeToPost(params: {
+    creativeId: string;
+    postId?: string;
+    workItemId?: string;
+    renderId?: string;
+}, config: Config): Promise<Record<string, unknown>>;
+//# sourceMappingURL=creatives.d.ts.map

package/dist/mcp/tools/creatives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creatives.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/creatives.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/creatives.js

@@ -0,0 +1,291 @@
+import { readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
+import { apiGet, apiPost, apiPatch, putBytes, ApiError } from '../api.js';
+import { readImageDimensions } from '../../lib/image-dimensions.js';
+import { renderCreative as runLocalRender } from '../../lib/creative-render.js';
+/**
+ * Conductor Creatives: a Brand Kit (tokens, copy rules, approved lines) governs one or more
+ * Creatives (photo + headline + layout, optionally a story/carousel sequence and lettered
+ * variants), which render locally (Playwright, driven by this MCP server) to upload-ready JPEGs
+ * that attach to a Post like any other media. See docs/mcp-tool-guidelines.md's action-verify and
+ * dispatch-status patterns, both used below.
+ */
+const V2_PROJECT = (config) => `/api/v2/projects/${config.projectId}`;
+const creativesBase = (config) => `${V2_PROJECT(config)}/marketing/creatives`;
+const experimentsBase = (config) => `${V2_PROJECT(config)}/marketing/experiments`;
+/** Rounds a rate-like number to 4 decimals; leaves null/undefined alone. */
+function round4(n) {
+    if (typeof n !== 'number')
+        return n;
+    return Math.round(n * 10000) / 10000;
+}
+/** The fields worth an agent's context for one variant's performance — a subset of CreativePerformanceEntry. */
+function trimPerformanceEntry(entry) {
+    return {
+        creativeId: entry['creativeId'],
+        label: entry['label'],
+        headline: entry['headline'],
+        posts: entry['posts'],
+        views: entry['views'],
+        engagementRate: round4(entry['engagementRate']),
+        avgViewPct: round4(entry['avgViewPct']),
+        views72h: entry['views72h'],
+    };
+}
+/** The fields worth an agent's context for the family's active/last experiment. */
+function trimExperiment(experiment) {
+    return {
+        id: experiment['id'],
+        state: experiment['state'],
+        metric: experiment['metric'],
+        windowHours: experiment['windowHours'],
+        winnerCreativeId: experiment['winnerCreativeId'],
+        decidedAt: experiment['decidedAt'],
+        summary: experiment['summary'],
+        winnerLineConfirmedAt: experiment['winnerLineConfirmedAt'],
+    };
+}
+/**
+ * The backend's 422 body for a Creative validation failure is `{ message, violations: [{ field,
+ * ruleId, message }] }` — not the RFC 7807 `detail`/`title` shape `ApiError` otherwise expects, so
+ * its `message` ends up holding the raw JSON text. This re-parses that into one readable string
+ * (`[field] message`, one per violation) so the model gets something it can act on directly rather
+ * than a JSON string to parse itself. A 409 (stale `version`) already carries a plain-English
+ * `detail` and passes through unchanged.
+ */
+async function withCreativeErrors(fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        if (err instanceof ApiError && (err.status === 422 || err.status === 409)) {
+            let violations;
+            try {
+                const parsed = JSON.parse(err.message);
+                if (Array.isArray(parsed.violations))
+                    violations = parsed.violations;
+            }
+            catch {
+                // Not JSON (e.g. a plain 409 conflict message) — use it as-is below.
+            }
+            const message = violations
+                ? violations.map((v) => `[${v.field ?? v.ruleId ?? '?'}] ${v.message}`).join('; ')
+                : err.message;
+            throw new ApiError(err.status, message, { code: err.code, title: err.title });
+        }
+        throw err;
+    }
+}
+// --- Brand Kit ------------------------------------------------------------
+export async function getBrandKit(params, config) {
+    if (params.kitId) {
+        return apiGet(`${V2_PROJECT(config)}/marketing/brand-kits/${params.kitId}`, config);
+    }
+    const kits = await apiGet(`${V2_PROJECT(config)}/marketing/brand-kits`, config);
+    const found = kits.find((k) => k['isDefault']) ?? kits[0];
+    if (!found) {
+        throw new Error('This project has no Brand Kit yet — one is created for every workspace by default; check Settings.');
+    }
+    return found;
+}
+// --- Creatives --------------------------------------------------------------
+export async function listCreatives(params, config) {
+    const query = new URLSearchParams();
+    if (params.state)
+        query.set('state', params.state);
+    if (params.brandKitId)
+        query.set('brandKitId', params.brandKitId);
+    const qs = query.toString();
+    return apiGet(`${creativesBase(config)}${qs ? `?${qs}` : ''}`, config);
+}
+export async function getCreative(params, config) {
+    const [creative, readiness, all, performance] = await Promise.all([
+        apiGet(`${creativesBase(config)}/${params.creativeId}`, config),
+        apiGet(`${creativesBase(config)}/${params.creativeId}/readiness`, config),
+        apiGet(creativesBase(config), config),
+        apiGet(`${creativesBase(config)}/${params.creativeId}/performance`, config),
+    ]);
+    const variants = all
+        .filter((c) => c['number'] === creative['number'] && c['id'] !== creative['id'])
+        .map((c) => ({ id: c['id'], displayId: c['displayId'], state: c['state'], headline: c['headline'] }));
+    const activeExperimentId = creative['activeExperimentId'];
+    let experiment;
+    if (activeExperimentId) {
+        experiment = await apiGet(`${experimentsBase(config)}/${activeExperimentId}`, config);
+    }
+    else {
+        const experiments = await apiGet(`${experimentsBase(config)}?creativeId=${params.creativeId}`, config);
+        experiment = experiments[0];
+    }
+    const family = performance['family'] ?? [];
+    return {
+        ...creative,
+        readiness,
+        variants,
+        performance: family.map(trimPerformanceEntry),
+        experiment: experiment ? trimExperiment(experiment) : null,
+    };
+}
+/**
+ * Starts a hook experiment on a Creative family (>= 2 lettered variants; one RUNNING experiment per
+ * family at a time — a second attempt is refused with a 409). It settles on its own once every variant
+ * has published and reported (or via the weekly "what's working" job) — nothing further to call. Read
+ * the result through get_creative, whose experiment field carries the current state, and once DECIDED,
+ * the winner and its numbers.
+ */
+export async function createExperiment(params, config) {
+    return withCreativeErrors(() => apiPost(experimentsBase(config), { creativeId: params.creativeId, metric: params.metric, windowHours: params.windowHours }, config));
+}
+export async function createCreative(params, config) {
+    return withCreativeErrors(async () => {
+        if (params.variantOf) {
+            return apiPost(`${creativesBase(config)}/${params.variantOf}/variants`, { headline: params.headline, name: params.name }, config);
+        }
+        return apiPost(creativesBase(config), { ...params, variantOf: undefined }, config);
+    });
+}
+export async function updateCreative(params, config) {
+    const { creativeId, ...patch } = params;
+    return withCreativeErrors(() => apiPatch(`${creativesBase(config)}/${creativeId}`, patch, config));
+}
+// --- Photos -----------------------------------------------------------------
+async function readPhotoSource(params) {
+    if (params.filePath) {
+        return { bytes: new Uint8Array(await readFile(params.filePath)), filename: basename(params.filePath) };
+    }
+    const raw = params.url;
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        throw new Error(`"${raw}" is not a valid URL`);
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new Error(`Only http(s) URLs can be fetched, not ${parsed.protocol}`);
+    }
+    const response = await fetch(parsed);
+    if (!response.ok) {
+        throw new Error(`Fetching ${raw} failed: HTTP ${response.status}`);
+    }
+    const bytes = new Uint8Array(await response.arrayBuffer());
+    return { bytes, filename: basename(parsed.pathname) || 'photo' };
+}
+export async function uploadCreativePhoto(params, config) {
+    if (!params.filePath && !params.url) {
+        throw new Error('Pass filePath (a file on this machine) or url (a public http(s) URL).');
+    }
+    const { bytes, filename } = await readPhotoSource(params);
+    const info = readImageDimensions(bytes);
+    if (!info) {
+        throw new Error(`Could not read "${filename}" as a PNG, JPEG or WebP — Creative photos accept only those three formats.`);
+    }
+    const mint = await apiPost(`${V2_PROJECT(config)}/marketing/photos`, {
+        label: params.label ?? filename,
+        contentType: info.contentType,
+        sizeBytes: bytes.byteLength,
+        width: info.width,
+        height: info.height,
+        source: params.source ?? null,
+        licence: params.licence ?? null,
+        aiGenerated: !!params.aiGenerated,
+    }, config);
+    if (!mint.uploadUrl) {
+        throw new Error('The mint response carried no uploadUrl — cannot upload bytes.');
+    }
+    await putBytes(mint.uploadUrl, info.contentType, bytes);
+    return apiPost(`${V2_PROJECT(config)}/marketing/photos/${mint.id}/confirm`, { sizeBytes: bytes.byteLength }, config);
+}
+export async function renderCreativeTool(params, config) {
+    const result = await runLocalRender({ creativeId: params.creativeId, previewOnly: !!params.previewOnly, renderer: params.renderer ?? 'mcp', workflowRunId: params.workflowRunId }, config);
+    return {
+        renderId: result.renderId,
+        state: result.state,
+        ok: result.ok,
+        error: result.error,
+        frames: result.frames,
+        nextStep: result.ok
+            ? 'Call preview_creative to look at the render, or get_creative for the stored frame list.'
+            : 'Fix what `error` names and call render_creative again.',
+    };
+}
+const MAX_INLINE_IMAGE_BYTES = 1000000; // ~1MB — no downscale available without an image library
+// Only a sheet rendered from the creative as it is now is worth showing: an older one would show the model
+// an ad it has since edited. One too large to inline is skipped too, so a fresh (small) one is rendered.
+function findCurrentSheetFrame(renders, version) {
+    for (const render of renders) {
+        if (render.state !== 'SUCCEEDED')
+            continue;
+        if (version !== undefined && render.creativeVersion !== version)
+            continue;
+        const frame = (render.frames ?? []).find((f) => f.placementKey === 'sheet');
+        if (frame && (frame.sizeBytes ?? 0) <= MAX_INLINE_IMAGE_BYTES)
+            return { render, frame };
+    }
+    return undefined;
+}
+export async function previewCreative(params, config) {
+    const [creative, renders] = await Promise.all([
+        apiGet(`${creativesBase(config)}/${params.creativeId}`, config),
+        apiGet(`${creativesBase(config)}/${params.creativeId}/renders`, config),
+    ]);
+    let found = findCurrentSheetFrame(renders, creative?.version);
+    if (!found) {
+        const rendered = await runLocalRender({ creativeId: params.creativeId, previewOnly: true, renderer: 'mcp' }, config);
+        if (!rendered.ok || !rendered.renderId) {
+            return {
+                renderId: rendered.renderId,
+                state: rendered.state,
+                note: `Rendering a preview failed${rendered.error ? `: ${rendered.error}` : '.'} There is nothing to show.`,
+            };
+        }
+        const sheetFrame = rendered.frames.find((f) => f.placementKey === 'sheet');
+        if (!sheetFrame) {
+            return { renderId: rendered.renderId, state: rendered.state, note: 'The preview render produced no contact sheet frame.' };
+        }
+        found = { render: { id: rendered.renderId, state: rendered.state ?? 'SUCCEEDED' }, frame: sheetFrame };
+    }
+    const { render, frame } = found;
+    if (!frame.url) {
+        return { renderId: render.id, state: render.state, note: 'The contact sheet frame has no download URL yet.' };
+    }
+    if ((frame.sizeBytes ?? 0) > MAX_INLINE_IMAGE_BYTES) {
+        return {
+            renderId: render.id,
+            state: render.state,
+            url: frame.url,
+            note: `The rendered image is ${Math.round((frame.sizeBytes ?? 0) / 1024)} KB, larger than this tool can inline (~1 MB) — open the URL directly instead.`,
+        };
+    }
+    const response = await fetch(frame.url);
+    if (!response.ok) {
+        return { renderId: render.id, state: render.state, url: frame.url, note: `Could not download the frame (HTTP ${response.status}) — open the URL directly instead.` };
+    }
+    const bytes = new Uint8Array(await response.arrayBuffer());
+    if (bytes.byteLength > MAX_INLINE_IMAGE_BYTES) {
+        return { renderId: render.id, state: render.state, url: frame.url, note: 'The rendered image is larger than this tool can inline — open the URL directly instead.' };
+    }
+    // The `sheet` contact sheet is a 1x JPEG; the mime type comes off the response rather than being
+    // hardcoded so an older PNG sheet is never mislabelled (see docs/creatives.md).
+    const mimeType = (response.headers.get('content-type') || 'image/jpeg').split(';')[0].trim();
+    return { renderId: render.id, state: render.state, url: frame.url, image: { data: Buffer.from(bytes), mimeType } };
+}
+export async function attachCreativeToPost(params, config) {
+    // `postId` is the primary name (it matches get_post_status's own param); `workItemId` is kept as a
+    // deprecated alias so existing callers don't break.
+    const postId = params.postId ?? params.workItemId;
+    if (!postId) {
+        throw new Error('postId is required (the Post\'s Work Item id).');
+    }
+    let renderId = params.renderId;
+    if (!renderId) {
+        const renders = await apiGet(`${creativesBase(config)}/${params.creativeId}/renders`, config);
+        const latest = renders.find((r) => r.state === 'SUCCEEDED' && !r.previewOnly);
+        if (!latest) {
+            throw new Error('No SUCCEEDED render exists for this Creative yet — call render_creative (previewOnly: false) first, or pass an explicit renderId.');
+        }
+        renderId = latest.id;
+    }
+    return apiPost(`${creativesBase(config)}/${params.creativeId}/attach`, { renderId, workItemId: postId }, config);
+}
+//# sourceMappingURL=creatives.js.map

package/dist/mcp/tools/creatives.js.map

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

package/dist/mcp/tools/insights.d.ts

@@ -0,0 +1,11 @@
+import { Config } from '../config.js';
+/**
+ * What is working across the project's published Posts, trimmed to what an agent needs to reason from:
+ * totals and per-platform/per-format engagement, the best hours and weekdays to post, the best and worst
+ * destinations, and movers vs. the prior window of the same length.
+ */
+export declare function getMarketingInsights(config: Config, params: {
+    window?: '7d' | '30d' | '90d';
+    platform?: string;
+}): Promise<Record<string, unknown>>;
+//# sourceMappingURL=insights.d.ts.map

package/dist/mcp/tools/insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/insights.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AA6JrC;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyBlC"}

package/dist/mcp/tools/insights.js

@@ -0,0 +1,85 @@
+import { apiGet } from '../api.js';
+/** Rounds a rate-like number to 4 decimals; leaves null/undefined alone. */
+function round4(n) {
+    if (n === null || n === undefined)
+        return n;
+    return Math.round(n * 10000) / 10000;
+}
+/** Drops null/undefined fields from an object, keeping the key order of what remains. */
+function omitNulls(obj) {
+    const out = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== null && value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}
+function trimGroup(group) {
+    return omitNulls({
+        ...group,
+        engagementRate: round4(group.engagementRate),
+        avgViewPct: round4(group.avgViewPct),
+    });
+}
+/** The fields worth an agent's context for one destination — a subset of the backend's InsightsPost. */
+function trimPost(post) {
+    return omitNulls({
+        displayId: post.displayId,
+        title: post.title,
+        platform: post.platform,
+        format: post.format,
+        captionExcerpt: post.captionExcerpt,
+        views: post.views,
+        engagementRate: round4(post.engagementRate),
+        permalink: post.permalink,
+    });
+}
+/** Groups with at least two posts and a computed engagement rate, best rate first, capped at three. */
+function topGroups(groups) {
+    return groups
+        .filter((g) => g.posts >= 2 && g.engagementRate !== null && g.engagementRate !== undefined)
+        .sort((a, b) => b.engagementRate - a.engagementRate)
+        .slice(0, 3)
+        .map(trimGroup);
+}
+/** The fields worth an agent's context for one Creative variant's attributed performance. */
+function trimCreative(entry) {
+    return omitNulls({
+        creativeId: entry.creativeId,
+        label: entry.label,
+        headline: entry.headline,
+        posts: entry.posts,
+        views: entry.views,
+        engagementRate: round4(entry.engagementRate),
+        avgViewPct: round4(entry.avgViewPct),
+        views72h: entry.views72h,
+    });
+}
+/**
+ * What is working across the project's published Posts, trimmed to what an agent needs to reason from:
+ * totals and per-platform/per-format engagement, the best hours and weekdays to post, the best and worst
+ * destinations, and movers vs. the prior window of the same length.
+ */
+export async function getMarketingInsights(config, params) {
+    const query = new URLSearchParams();
+    if (params.window)
+        query.set('window', params.window);
+    if (params.platform)
+        query.set('platform', params.platform);
+    const qs = query.toString();
+    const data = await apiGet(`/api/v2/projects/${config.projectId}/marketing/insights${qs ? `?${qs}` : ''}`, config);
+    return {
+        window: data.window,
+        totals: trimGroup(data.totals),
+        byPlatform: data.byPlatform.map(trimGroup),
+        byFormat: data.byFormat.map(trimGroup),
+        bestHoursUtc: topGroups(data.byHour),
+        bestWeekdays: topGroups(data.byWeekday),
+        topPosts: data.topPosts.slice(0, 5).map(trimPost),
+        bottomPosts: data.bottomPosts.slice(0, 3).map(trimPost),
+        movers: data.movers.map((m) => omitNulls({ metric: m.metric, current: round4(m.current), previous: round4(m.previous), deltaPct: round4(m.deltaPct) })),
+        coverage: data.coverage,
+        topCreatives: (data.creatives ?? []).slice(0, 5).map(trimCreative),
+    };
+}
+//# sourceMappingURL=insights.js.map

package/dist/mcp/tools/insights.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cliangdev/conductor",
-  "version": "0.20.6",
+  "version": "0.22.0",
   "description": "Agentic software development platform — AI-driven PRD, implementation, and beyond",
   "license": "SEE LICENSE IN ../LICENSE",
   "repository": {
@@ -23,7 +23,7 @@
     "scripts/"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/build-creative.mjs",
     "typecheck:fast": "tsgo --noEmit",
     "dev": "ts-node src/index.ts",
     "test": "vitest run",
@@ -36,7 +36,8 @@
     "chokidar": "^5.0.0",
     "commander": "^15.0.0",
     "open": "^11.0.0",
-    "ora": "^9.4.0"
+    "ora": "^9.4.0",
+    "playwright-core": "1.63.0"
   },
   "devDependencies": {
     "@types/node": "^26.0.0",

package/scripts/build-creative.mjs

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+/* build-creative.mjs — copies the runtime files of the sibling
+ * `conductor-creative/` package into this package's `dist/creative/`, run by
+ * `npm run build` alongside `tsc`.
+ *
+ * Why a copy rather than a dependency: conductor-tools is published to npm
+ * (`@cliangdev/conductor`), so it cannot `file:`-depend on a sibling
+ * directory that only exists in this monorepo checkout at runtime — the
+ * published package has to carry what it needs itself. `conductor-creative/`
+ * has no build step of its own (plain ESM, no bundler), so "build" here just
+ * means "select the files the render job actually needs and lay them out at
+ * the same relative paths dist/creative/job/render.mjs's own
+ * `PACKAGE_ROOT = join(HERE, '..')` expects".
+ *
+ * Deliberately excluded: `mount.js`/`copy-rules.js` (editor-only, not
+ * imported by frame.js/sheet.js — the render core never reaches for them),
+ * `test/`, `node_modules/`, `job/package.json` (its `playwright` dependency
+ * is for running the job directly out of that repo; conductor-tools drives
+ * the same `run()` with its own `playwright-core`-based browser discovery —
+ * see src/lib/creative-browser.ts), and `README.md`.
+ *
+ * Kept in one explicit list (rather than "copy everything except...") so a
+ * new file added to conductor-creative/ has to be a deliberate decision here
+ * too, and `src/__tests__/build-creative.test.ts` asserts every listed file
+ * actually lands in dist/creative/ after this runs.
+ */
+import { existsSync, mkdirSync, copyFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const REPO_ROOT = join(__dirname, '..', '..')
+export const SOURCE_ROOT = join(REPO_ROOT, 'conductor-creative')
+export const DEST_ROOT = join(__dirname, '..', 'dist', 'creative')
+
+/** Relative paths (from conductor-creative/) this build needs. Order doesn't matter. */
+export const CREATIVE_RUNTIME_FILES = [
+  'render.js',
+  'assertions.js',
+  'placements.js',
+  'placements.json',
+  'styles.css',
+  'tokens.css',
+  'frame.css',
+  'frame.html',
+  'font.js',
+  'frame.js',
+  'sheet.html',
+  'sheet.js',
+  'layouts/index.js',
+  'layouts/index.json',
+  'layouts/stacked/layout.json',
+  'layouts/stacked/layout.css',
+  'layouts/bleed/layout.json',
+  'layouts/bleed/layout.css',
+  'layouts/card/layout.json',
+  'layouts/card/layout.css',
+  'layouts/split/layout.json',
+  'layouts/split/layout.css',
+  'job/render.mjs',
+  'job/server.mjs',
+  'job/transport.mjs',
+]
+
+export function copyCreativeRuntime(sourceRoot = SOURCE_ROOT, destRoot = DEST_ROOT) {
+  const missing = []
+  for (const rel of CREATIVE_RUNTIME_FILES) {
+    const src = join(sourceRoot, rel)
+    if (!existsSync(src)) {
+      missing.push(rel)
+      continue
+    }
+    const dest = join(destRoot, rel)
+    mkdirSync(dirname(dest), { recursive: true })
+    copyFileSync(src, dest)
+  }
+  if (missing.length > 0) {
+    throw new Error(
+      `build-creative.mjs: expected file(s) missing from ${sourceRoot}:\n` +
+        missing.map((f) => `  - ${f}`).join('\n')
+    )
+  }
+  return CREATIVE_RUNTIME_FILES.map((rel) => join(destRoot, rel))
+}
+
+function isMain() {
+  return process.argv[1] && import.meta.url === `file://${process.argv[1]}`
+}
+
+if (isMain()) {
+  const written = copyCreativeRuntime()
+  console.log(`build-creative: copied ${written.length} file(s) into ${DEST_ROOT}`)
+}