@cliangdev/conductor 0.21.0 → 0.22.0

package/dist/lib/creative-render.js

@@ -0,0 +1,71 @@
+/**
+ * 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 } 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 };
+}
+/**
+ * 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.
+ */
+export async function renderCreative(params, config, log = () => { }) {
+    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"}

package/dist/lib/image-dimensions.js

@@ -0,0 +1,115 @@
+/**
+ * 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.
+ */
+function readUInt32BE(bytes, offset) {
+    return ((bytes[offset] << 24) | (bytes[offset + 1] << 16) | (bytes[offset + 2] << 8) | bytes[offset + 3]) >>> 0;
+}
+function readUInt16BE(bytes, offset) {
+    return ((bytes[offset] << 8) | bytes[offset + 1]) >>> 0;
+}
+function readUInt24LE(bytes, offset) {
+    return (bytes[offset] | (bytes[offset + 1] << 8) | (bytes[offset + 2] << 16)) >>> 0;
+}
+const PNG_SIGNATURE = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
+function readPng(bytes) {
+    if (bytes.length < 24)
+        return null;
+    if (!PNG_SIGNATURE.every((b, i) => bytes[i] === b))
+        return null;
+    // IHDR is always the first chunk: 4-byte length, 4-byte type "IHDR", then width/height (4 bytes
+    // each, big-endian) at offsets 16 and 20.
+    return { contentType: 'image/png', width: readUInt32BE(bytes, 16), height: readUInt32BE(bytes, 20) };
+}
+// SOFn (start-of-frame) markers that carry dimensions. Excludes 0xC4 (DHT), 0xC8 (JPG extension,
+// unused in practice) and 0xCC (DAC) — those share the 0xC0-0xCF range but aren't SOF markers.
+const JPEG_SOF_MARKERS = new Set([0xc0, 0xc1, 0xc2, 0xc3, 0xc5, 0xc6, 0xc7, 0xc9, 0xca, 0xcb, 0xcd, 0xce, 0xcf]);
+// Standalone markers with no length-prefixed payload following them.
+const JPEG_NO_PAYLOAD_MARKERS = new Set([0x01, 0xd8, 0xd9]);
+function readJpeg(bytes) {
+    if (bytes.length < 4 || bytes[0] !== 0xff || bytes[1] !== 0xd8)
+        return null;
+    let offset = 2;
+    while (offset + 4 <= bytes.length) {
+        if (bytes[offset] !== 0xff) {
+            offset += 1; // resync on a stray fill byte (0xFF00 stuffing, etc.)
+            continue;
+        }
+        const marker = bytes[offset + 1];
+        if (marker === 0xd9)
+            break; // EOI, no dimensions found
+        if (JPEG_NO_PAYLOAD_MARKERS.has(marker) || (marker >= 0xd0 && marker <= 0xd7)) {
+            offset += 2;
+            continue;
+        }
+        const segmentLength = readUInt16BE(bytes, offset + 2);
+        if (JPEG_SOF_MARKERS.has(marker)) {
+            const payloadStart = offset + 4;
+            if (payloadStart + 5 > bytes.length)
+                return null;
+            const height = readUInt16BE(bytes, payloadStart + 1);
+            const width = readUInt16BE(bytes, payloadStart + 3);
+            return { contentType: 'image/jpeg', width, height };
+        }
+        if (segmentLength < 2)
+            return null; // malformed — refuse to loop forever
+        offset += 2 + segmentLength;
+    }
+    return null;
+}
+function isRiffWebp(bytes) {
+    return (bytes.length >= 21 && // enough to read the fourCC at 12-15 and reach the chunk data at 20
+        bytes[0] === 0x52 &&
+        bytes[1] === 0x49 &&
+        bytes[2] === 0x46 &&
+        bytes[3] === 0x46 && // "RIFF"
+        bytes[8] === 0x57 &&
+        bytes[9] === 0x45 &&
+        bytes[10] === 0x42 &&
+        bytes[11] === 0x50 // "WEBP"
+    );
+}
+function readWebp(bytes) {
+    if (!isRiffWebp(bytes))
+        return null;
+    const fourCc = String.fromCharCode(bytes[12], bytes[13], bytes[14], bytes[15]);
+    const chunkStart = 20; // after the 8-byte RIFF header, "WEBP", fourCC and 4-byte chunk size
+    if (fourCc === 'VP8X') {
+        // flags (1 byte) + reserved (3 bytes), then 3-byte little-endian (width-1) and (height-1).
+        if (bytes.length < chunkStart + 10)
+            return null;
+        return {
+            contentType: 'image/webp',
+            width: readUInt24LE(bytes, chunkStart + 4) + 1,
+            height: readUInt24LE(bytes, chunkStart + 7) + 1,
+        };
+    }
+    if (fourCc === 'VP8 ') {
+        // 3-byte frame tag + 3-byte start code (0x9d 0x01 0x2a), then 14-bit width/height, little-endian.
+        if (bytes.length < chunkStart + 10)
+            return null;
+        const widthRaw = bytes[chunkStart + 6] | (bytes[chunkStart + 7] << 8);
+        const heightRaw = bytes[chunkStart + 8] | (bytes[chunkStart + 9] << 8);
+        return { contentType: 'image/webp', width: widthRaw & 0x3fff, height: heightRaw & 0x3fff };
+    }
+    if (fourCc === 'VP8L') {
+        // 1-byte signature (0x2f), then a little-endian 32-bit field: 14-bit (width-1), 14-bit (height-1).
+        if (bytes.length < chunkStart + 5)
+            return null;
+        const bits = (bytes[chunkStart + 1] | (bytes[chunkStart + 2] << 8) | (bytes[chunkStart + 3] << 16) | (bytes[chunkStart + 4] << 24)) >>> 0;
+        return { contentType: 'image/webp', width: (bits & 0x3fff) + 1, height: ((bits >>> 14) & 0x3fff) + 1 };
+    }
+    return null;
+}
+/** 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 function readImageDimensions(bytes) {
+    return readPng(bytes) ?? readJpeg(bytes) ?? readWebp(bytes);
+}
+//# sourceMappingURL=image-dimensions.js.map

package/dist/lib/image-dimensions.js.map

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

package/dist/lib/plugin-assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-assets.d.ts","sourceRoot":"","sources":["../../src/lib/plugin-assets.ts"],"names":[],"mappings":"AA2CA,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAmCD,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAA;AAE/D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,CA4Cf;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB;IAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CA0B9D"}
+{"version":3,"file":"plugin-assets.d.ts","sourceRoot":"","sources":["../../src/lib/plugin-assets.ts"],"names":[],"mappings":"AA4CA,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAmCD,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAA;AAE/D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,CA4Cf;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB;IAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CA0B9D"}

package/dist/lib/plugin-assets.js

@@ -11,6 +11,7 @@ const PLUGIN_FILES = [
     'skills/conductor-ux-ui-design/references/design-tokens.md',
     'skills/conductor-coder/SKILL.md',
     'skills/conductor-publisher/SKILL.md',
+    'skills/conductor-creative/SKILL.md',
 ];
 // Paths removed in previous versions — deleted on `conductor init` to clean up stale installs.
 const LEGACY_PATHS = [

package/dist/lib/plugin-assets.js.map

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

package/dist/mcp/index.d.ts

@@ -1,3 +1,21 @@
 #!/usr/bin/env node
+/**
+ * An image content block (base64-encoded bytes + MIME type) plus an optional text block of
+ * metadata — the shape a client needs to actually render the image rather than just read about it.
+ * `preview_creative` is the first tool to need this; every other tool emits text only.
+ */
+export declare function imageResponse(image: {
+    data: Buffer;
+    mimeType: string;
+}, meta?: unknown): {
+    content: ({
+        type: "image";
+        data: string;
+        mimeType: string;
+    } | {
+        type: "text";
+        text: string;
+    })[];
+};
 export declare function runMcpServer(): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAkkCA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAiuBlD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAywCA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,CAAC,EAAE,OAAO;;cACxD,OAAO;cAAQ,MAAM;kBAAY,MAAM;;cAAa,MAAM;cAAQ,MAAM;;EAOtG;AAoBD,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA4zBlD"}

package/dist/mcp/index.js

@@ -15,6 +15,17 @@ import { submitKnowledgeSource, readKnowledgeSources, searchKnowledge, readKnowl
 import { listPublishTargets, setPublishTargets, uploadAsset, retryFailedPublishTargets, completeManualPublish, } from './tools/marketing.js';
 import { createPost, getPostStatus, submitPost, listPosts, submitReview, listAssets, getPostAnalytics, listTopPosts, } from './tools/posts.js';
 import { getMarketingInsights } from './tools/insights.js';
+import { getBrandKit, listCreatives, getCreative, createCreative, updateCreative, uploadCreativePhoto, renderCreativeTool, previewCreative, attachCreativeToPost, createExperiment, } from './tools/creatives.js';
+import { resolveCreativeId } from '../lib/creative-id.js';
+const CREATIVE_TOOLS = [
+    'get_creative',
+    'create_creative',
+    'update_creative',
+    'render_creative',
+    'preview_creative',
+    'attach_creative_to_post',
+    'create_experiment',
+];
 import { listProjectDocs, readProjectDoc, writeProjectDoc, moveProjectDoc, deleteProjectDoc, setProjectDocTask, listProjectDocComments, commentOnProjectDoc, respondToProjectDocComment, listProjectDocVersions, restoreProjectDocVersion, uploadProjectDocImage, moveProjectFolder, deleteProjectFolder, } from './tools/project-docs.js';
 const TOOLS = [
     // --- Canonical Work Item tools (v2 /work-items surface) ---
@@ -957,7 +968,7 @@ const TOOLS = [
     },
     {
         name: 'get_marketing_insights',
-        description: 'What is working across the project\'s published Posts: totals, engagement rate by platform, format and time, best and worst posts, and movers vs the prior window. Read-only. Use get_post_analytics for one Post\'s series and list_top_posts for a full ranking by one metric.',
+        description: 'What is working across the project\'s published Posts: totals, engagement rate by platform, format and time, best and worst posts, top-performing Creatives, and movers vs the prior window. Read-only. Use get_post_analytics for one Post\'s series and list_top_posts for a full ranking by one metric.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -979,6 +990,198 @@ const TOOLS = [
             required: ['postId', 'verdict'],
         },
     },
+    // --- Creatives: Brand Kit + Creative library + local rendering ---
+    {
+        name: 'get_brand_kit',
+        description: "Read a workspace Brand Kit: colour tokens, font, logo/wordmark/badge URLs, CTA claim, copy rules, approved lines, enabled placements, and the Knowledge page path holding its prose context. Omit kitId for the project's default kit.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                kitId: { type: 'string', description: "Brand Kit id (optional — omit for the project's default kit)" },
+            },
+        },
+    },
+    {
+        name: 'list_creatives',
+        description: "List the project's Creatives (photo + headline + layout), newest display number first, lettered variants grouped together. Filter by state or brandKitId.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                state: { type: 'string', enum: ['DRAFT', 'READY', 'ARCHIVED'], description: 'Filter by state (optional)' },
+                brandKitId: { type: 'string', description: 'Filter to Creatives on one Brand Kit (optional)' },
+            },
+        },
+    },
+    {
+        name: 'get_creative',
+        description: "One Creative in full: its fields, its readiness checklist (what still blocks it going to review), the other lettered variants in its family, each variant's attributed performance (posts, views, engagement rate, average view percentage, 72h views), and the family's active or most recent hook experiment (state, and once decided, the winner and its numbers). Call after create_creative/update_creative/create_experiment to verify.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                creativeId: { type: 'string', description: 'Creative id, or its display id such as 12a' },
+            },
+            required: ['creativeId'],
+        },
+    },
+    {
+        name: 'create_creative',
+        description: "Create a Creative (photo, headline, layout, theme, body, caption, alt text, optional story/carousel sequence), or, with variantOf, cut a lettered variant of an existing one instead (inherits everything but headline/name — every other field here is ignored). Refused with the failing rule's message on a bad layout/theme/placement, the kit's accent-phrase rule, a copy rule, or (when state is READY) a readiness rule. Call get_creative after to verify.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                variantOf: { type: 'string', description: 'Cut a lettered variant of this existing Creative instead of creating a fresh one (optional)' },
+                brandKitId: { type: 'string', description: "Brand Kit this Creative renders with (optional — defaults to the project's default kit)" },
+                name: { type: 'string', description: 'Internal name, not shown on the artwork (optional)' },
+                state: { type: 'string', enum: ['DRAFT', 'READY', 'ARCHIVED'], description: 'Defaults to DRAFT (optional)' },
+                layout: { type: 'string', description: "Layout key from the creative registry, e.g. stacked/bleed/card/split (optional — defaults to the registry's first layout)" },
+                theme: { type: 'string', enum: ['dark', 'light'], description: 'Optional — defaults to dark' },
+                photoId: { type: 'string', description: 'A photo from upload_creative_photo (optional)' },
+                focalOverride: { type: 'object', additionalProperties: { type: 'string' }, description: 'Per-placement focal point override, e.g. {"9x16":"50% 30%"} (optional)' },
+                headline: { type: 'string', description: 'Exactly one *accent phrase* marked with asterisks, when the Brand Kit requires one (optional)' },
+                body: { type: 'string', description: 'Body copy (optional)' },
+                caption: { type: 'string', description: "The post caption this Creative is meant for, carried through but never rendered onto the artwork (optional)" },
+                altText: { type: 'string', description: 'Accessibility description of the photo, not the copy (optional)' },
+                placements: { type: 'array', items: { type: 'string' }, description: "Extra placement keys this Creative opts into beyond the Brand Kit's enabled set (optional)" },
+                sequenceKind: { type: 'string', enum: ['story', 'carousel'], description: 'Set to render a multi-beat sequence instead of one frame (optional)' },
+                sequence: {
+                    type: 'array',
+                    description: 'Story beats (2-7) or carousel cards (2-10); each inherits the Creative and overrides only what changes (optional)',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            headline: { type: 'string' },
+                            body: { type: 'string' },
+                            photoId: { type: 'string' },
+                            cta: { type: 'boolean', description: 'Forces the CTA row on/off for this beat (optional — default: only the last beat shows it)' },
+                        },
+                    },
+                },
+                carouselRatio: { type: 'string', description: 'Aspect ratio key for a carousel sequence, e.g. 4x5 or 1x1 (optional)' },
+                lockup: { type: 'string', enum: ['plain', 'chip'], description: 'Optional — defaults to plain. "chip" puts the logo lockup on a white pill, for busy photography.' },
+                layoutOverrides: {
+                    type: 'object',
+                    description: 'Per-placement overrides of layout-derived numbers, in pixels (optional). A placement key not named here keeps the layout\'s own default.',
+                    properties: {
+                        band: { type: 'object', additionalProperties: { type: 'integer' }, description: 'Overrides the stacked layout\'s photo band height per placement, e.g. {"9x16": 1200}' },
+                        padBottom: { type: 'object', additionalProperties: { type: 'integer' }, description: "Overrides the 9x16 panel's bottom safe-zone clearance per placement" },
+                    },
+                },
+            },
+        },
+    },
+    {
+        name: 'update_creative',
+        description: "Patch a Creative's fields. version must equal its current value (from get_creative) or the write is refused with a 409 conflict — reread and reapply on top of the newer version rather than retrying blind. A failing structural or readiness rule is refused with the rule's own message. Call get_creative after to verify.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                creativeId: { type: 'string', description: 'Creative id, or its display id such as 12a' },
+                version: { type: 'number', description: "The Creative's current version, from get_creative" },
+                brandKitId: { type: 'string' },
+                name: { type: 'string' },
+                state: { type: 'string', enum: ['DRAFT', 'READY', 'ARCHIVED'] },
+                layout: { type: 'string' },
+                theme: { type: 'string', enum: ['dark', 'light'] },
+                photoId: { type: 'string' },
+                focalOverride: { type: 'object', additionalProperties: { type: 'string' } },
+                headline: { type: 'string' },
+                body: { type: 'string' },
+                caption: { type: 'string' },
+                altText: { type: 'string' },
+                placements: { type: 'array', items: { type: 'string' } },
+                sequenceKind: { type: 'string', enum: ['story', 'carousel'] },
+                sequence: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            headline: { type: 'string' },
+                            body: { type: 'string' },
+                            photoId: { type: 'string' },
+                            cta: { type: 'boolean' },
+                        },
+                    },
+                },
+                carouselRatio: { type: 'string' },
+                lockup: { type: 'string', enum: ['plain', 'chip'] },
+                layoutOverrides: {
+                    type: 'object',
+                    properties: {
+                        band: { type: 'object', additionalProperties: { type: 'integer' } },
+                        padBottom: { type: 'object', additionalProperties: { type: 'integer' } },
+                    },
+                },
+            },
+            required: ['creativeId', 'version'],
+        },
+    },
+    {
+        name: 'upload_creative_photo',
+        description: "Upload a photo into the project's photo library from a local file or a public URL, recording its provenance (source, licence, aiGenerated) for the readiness checklist. Width and height are read from the file itself. Use the returned photo's id as a Creative's photoId.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                filePath: { type: 'string', description: 'A file on this machine (use this or url)' },
+                url: { type: 'string', description: 'A public http(s) URL (use this or filePath)' },
+                label: { type: 'string', description: 'Human label (optional — defaults to the filename)' },
+                source: { type: 'string', description: 'Provenance note, e.g. a URL or "Generated with <model> on <date>" (optional)' },
+                licence: { type: 'string', description: 'e.g. "Own work", "Unsplash Licence", "Generated, house use" (optional)' },
+                aiGenerated: { type: 'boolean', description: 'Whether the photo is AI-generated (optional, informational only)' },
+            },
+        },
+    },
+    {
+        name: 'render_creative',
+        description: 'Render a Creative locally (Playwright on this machine) to upload-ready JPEG frames (one per placement), or a small contact sheet with previewOnly. Runs synchronously — typically well under a minute — and returns the render id, state, frame URLs and any warnings. Call preview_creative to actually look at the result.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                creativeId: { type: 'string', description: 'Creative id, or its display id such as 12a' },
+                previewOnly: { type: 'boolean', description: 'Render one small contact sheet instead of full-size placement frames (optional, default false)' },
+                renderer: { type: 'string', description: 'Attribution tag stored on the render (optional, default "mcp")' },
+                workflowRunId: { type: 'string', description: 'Attribute this render to a Workflow run (optional)' },
+            },
+            required: ['creativeId'],
+        },
+    },
+    {
+        name: 'preview_creative',
+        description: "Look at a Creative: returns its latest contact sheet as an image (rendering a fresh previewOnly one first if none exists yet). Use this to judge the actual artwork — does the headline read at a glance, is the copy sitting on the subject's face — not just the data. If the image is too large to inline it returns the URL instead, with a note saying so.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                creativeId: { type: 'string', description: 'Creative id, or its display id such as 12a' },
+            },
+            required: ['creativeId'],
+        },
+    },
+    {
+        name: 'attach_creative_to_post',
+        description: "Attach a Creative's rendered frames to a Post as its media — placement to platform (9x16 to TikTok/Instagram Reels, 4x5 to Instagram feed, 1x1 to Facebook, story to story targets; sequence frames in order) — for every destination that has not set its own custom media. Uses the latest SUCCEEDED, non-preview render unless renderId is given. Call get_post_status (postId) to verify.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                creativeId: { type: 'string', description: 'Creative id, or its display id such as 12a' },
+                postId: { type: 'string', description: "The Post's Work Item id — same value get_post_status takes as postId" },
+                workItemId: { type: 'string', description: 'Deprecated alias for postId' },
+                renderId: { type: 'string', description: 'A specific render to attach (optional — defaults to the latest SUCCEEDED render)' },
+            },
+            required: ['creativeId'],
+        },
+    },
+    {
+        name: 'create_experiment',
+        description: "Start a hook experiment comparing every lettered variant of a Creative's family (needs at least two; only one RUNNING experiment per family at a time — refused with a conflict otherwise). It settles itself once every variant has published and reported, or via the weekly insights job — nothing to poll. Call get_creative to see its state and, once decided, the winner and numbers.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                creativeId: { type: 'string', description: 'Any Creative in the family — a lettered variant or the root; resolved automatically' },
+                metric: { type: 'string', enum: ['views', 'engagement_rate', 'avg_view_pct'], description: 'Optional — defaults to views. The decision prefers avg_view_pct whenever every variant reports it, regardless of this choice.' },
+                windowHours: { type: 'number', description: 'Hours after each variant fires before it counts toward the decision (optional, default 72)' },
+            },
+            required: ['creativeId'],
+        },
+    },
 ];
 function authErrorResponse() {
     return {
@@ -1000,6 +1203,20 @@ function successResponse(data) {
         ],
     };
 }
+/**
+ * An image content block (base64-encoded bytes + MIME type) plus an optional text block of
+ * metadata — the shape a client needs to actually render the image rather than just read about it.
+ * `preview_creative` is the first tool to need this; every other tool emits text only.
+ */
+export function imageResponse(image, meta) {
+    const content = [
+        { type: 'image', data: image.data.toString('base64'), mimeType: image.mimeType },
+    ];
+    if (meta !== undefined) {
+        content.push({ type: 'text', text: JSON.stringify(meta) });
+    }
+    return { content };
+}
 /**
  * A shorthand string keeps every existing call site working; the richer object form lets the dispatch
  * catch hand back the server's own status/code/title alongside its message, without changing the
@@ -1045,6 +1262,12 @@ export async function runMcpServer() {
         const { name, arguments: args } = request.params;
         const params = (args ?? {});
         try {
+            // Creative tools accept a display id ("12a") wherever they take a Creative.
+            for (const key of ['creativeId', 'variantOf']) {
+                if (typeof params[key] === 'string' && CREATIVE_TOOLS.includes(name)) {
+                    params[key] = await resolveCreativeId(params[key], config);
+                }
+            }
             switch (name) {
                 case 'create_work_item': {
                     const workflow = params['workflow'];
@@ -1504,6 +1727,66 @@ export async function runMcpServer() {
                 case 'retry_failed_publish_targets': {
                     return successResponse(await retryFailedPublishTargets({ issueId: params['issueId'] }, config));
                 }
+                case 'get_brand_kit': {
+                    return successResponse(await getBrandKit({ kitId: params['kitId'] }, config));
+                }
+                case 'list_creatives': {
+                    return successResponse(await listCreatives({ state: params['state'], brandKitId: params['brandKitId'] }, config));
+                }
+                case 'get_creative': {
+                    return successResponse(await getCreative({ creativeId: params['creativeId'] }, config));
+                }
+                case 'create_creative': {
+                    return successResponse(await createCreative(params, config));
+                }
+                case 'update_creative': {
+                    return successResponse(await updateCreative(params, config));
+                }
+                case 'upload_creative_photo': {
+                    return successResponse(await uploadCreativePhoto({
+                        filePath: params['filePath'],
+                        url: params['url'],
+                        label: params['label'],
+                        source: params['source'],
+                        licence: params['licence'],
+                        aiGenerated: params['aiGenerated'],
+                    }, config));
+                }
+                case 'render_creative': {
+                    return successResponse(await renderCreativeTool({
+                        creativeId: params['creativeId'],
+                        previewOnly: params['previewOnly'],
+                        renderer: params['renderer'],
+                        workflowRunId: params['workflowRunId'],
+                    }, config));
+                }
+                case 'preview_creative': {
+                    const result = await previewCreative({ creativeId: params['creativeId'] }, config);
+                    if (result.image) {
+                        return imageResponse(result.image, {
+                            renderId: result.renderId,
+                            state: result.state,
+                            url: result.url,
+                            note: result.note,
+                        });
+                    }
+                    return successResponse(result);
+                }
+                case 'attach_creative_to_post': {
+                    return successResponse(await attachCreativeToPost({
+                        creativeId: params['creativeId'],
+                        postId: params['postId'],
+                        workItemId: params['workItemId'],
+                        renderId: params['renderId'],
+                    }, config));
+                }
+                case 'create_experiment': {
+                    return successResponse(await createExperiment({
+                        creativeId: params['creativeId'],
+                        metric: params['metric'],
+                        windowHours: params['windowHours'],
+                    }, config));
+                }
                 case 'upload_project_doc_image': {
                     const result = await uploadProjectDocImage({
                         path: params['path'],