videoclaw 3.0.0-alpha.1

package/dist/video/outfit-prompts.js

@@ -0,0 +1,14 @@
+/**
+ * Two-reference outfit swap. Order is FIXED: @image1 = outfit/pose,
+ * @image2 = character/identity. Reversing breaks the swap. Lean prompt only —
+ * NO cinema stack appended (the references carry the photographic register).
+ * Prompt-emitter only: the operator pastes this into the external image tool.
+ */
+export function outfitSwapPrompt() {
+    return 'Replace the character in @image1 with the character in @image2. Keep the outfit and pose from @image1 exactly. Match the face, bone structure, body type, skin tone, and hair from @image2. Even neutral mid-gray seamless background, soft large-source studio lighting, skin and outfit at their true natural tone against the neutral gray, natural film grain, full body framing.';
+}
+/** Step 1 of the two-step build: design the outfit on a bland generic model. */
+export function outfitBuildPrompt(outfit) {
+    return `Build this outfit on a bland generic slim model (no specific identity): ${outfit}. The outfit is the only subject. Even neutral mid-gray seamless background, soft studio lighting, full body framing, natural film grain.`;
+}
+//# sourceMappingURL=outfit-prompts.js.map

package/dist/video/outfit-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outfit-prompts.js","sourceRoot":"","sources":["../../src/video/outfit-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,uXAAuX,CAAC;AACjY,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,2EAA2E,MAAM,2IAA2I,CAAC;AACtO,CAAC"}

package/dist/video/outpaint-keyframe.d.ts

@@ -0,0 +1,95 @@
+/**
+ * outpaint-keyframe — pad a keyframe to a target canvas and build an
+ * inpainting mask for the new border region.
+ *
+ * Core (pad + mask) is pure/deterministic using only sharp.
+ * Fill is optional/scaffold: if a fill() factory is provided it calls the
+ * go-bananas REST edit endpoint; without a key it is inert.
+ */
+export interface OutpaintKeyframeInput {
+    /** Absolute path to the source keyframe image. */
+    inputPath: string;
+    /** Absolute path to write the output PNG. */
+    outputPath: string;
+    /** Target canvas width in pixels (default 1920). */
+    targetWidth?: number;
+    /** Target canvas height in pixels (default 1080). */
+    targetHeight?: number;
+    /**
+     * Dilation of the mask border into the original image region, expressed as
+     * a fraction of the smaller canvas dimension (default 0.03).
+     * E.g. on a 1920×1080 canvas, 0.03 × 1080 ≈ 32 px of feather overlap.
+     */
+    maskDilation?: number;
+    /**
+     * Optional fill function.  When provided it receives the padded PNG buffer
+     * and the mask PNG buffer; its returned Buffer is written to outputPath
+     * (filled:true).  When absent the padded letterbox image is written
+     * (filled:false).
+     */
+    fill?: (req: {
+        paddedPng: Buffer;
+        maskPng: Buffer;
+        env?: NodeJS.ProcessEnv;
+        fetcher?: typeof fetch;
+    }) => Promise<Buffer>;
+    env?: NodeJS.ProcessEnv;
+    fetcher?: typeof fetch;
+}
+export interface OutpaintKeyframeResult {
+    outputPath: string;
+    width: number;
+    height: number;
+    /** true when a fill() was provided and its output was written. */
+    filled: boolean;
+}
+/**
+ * Pad `inputPath` onto a `targetWidth`×`targetHeight` canvas (centred,
+ * letterboxed, transparent background) and produce an L-mode mask PNG where
+ * the original image area is black (known region) and the padded border is
+ * white (region to fill).  An optional `fill()` factory can call an
+ * inpainting backend and receive the filled result.
+ */
+export declare function outpaintKeyframe(input: OutpaintKeyframeInput): Promise<OutpaintKeyframeResult>;
+export declare const DEFAULT_GO_BANANAS_API_BASE = "https://gobananasai.com/api";
+/**
+ * Masked edits go through OpenAI gpt-image-2; go-bananas rejects mask_image_id
+ * for any non-OpenAI model, so this is the only valid default.
+ */
+export declare const DEFAULT_OUTPAINT_MODEL_ID = "openai-gpt-image-2";
+export declare const DEFAULT_OUTPAINT_PROMPT: string;
+export interface GoBananasOutpaintFillOptions {
+    /** Outpaint instruction sent to the edit model (default DEFAULT_OUTPAINT_PROMPT). */
+    prompt?: string;
+    /**
+     * Edit model id. Must be an OpenAI model for masked edits (go-bananas refuses
+     * mask_image_id otherwise). Default DEFAULT_OUTPAINT_MODEL_ID.
+     */
+    modelId?: string;
+    /** Optional explicit output size (e.g. '1536x1024'); omitted = provider default. */
+    size?: string;
+}
+interface GoBananasFillRequest {
+    paddedPng: Buffer;
+    maskPng: Buffer;
+    env?: NodeJS.ProcessEnv;
+    fetcher?: typeof fetch;
+}
+/**
+ * Build a fill() function that performs a go-bananas masked outpaint via the
+ * upload×2 → edit-by-id → download flow (verified against the live API):
+ *
+ *   1. POST {apiBase}/images/upload  (padded source PNG) → image_id
+ *   2. POST {apiBase}/images/upload  (RGBA alpha mask PNG) → mask_image_id
+ *   3. POST {apiBase}/edit-image     { image_id, mask_image_id, model_id, prompt, size? }
+ *        → { fullUrl, ... }
+ *   4. GET  fullUrl → filled image bytes (returned as a Buffer)
+ *
+ *   - apiBase from env GO_BANANAS_API_URL (default https://gobananasai.com/api)
+ *   - apiKey  from env GO_BANANAS_API_KEY (throws env_var_missing when absent,
+ *     so the factory is inert in offline / CI contexts)
+ *   - injectable fetcher for offline testing
+ */
+export declare function goBananasOutpaintFill(options?: GoBananasOutpaintFillOptions): (req: GoBananasFillRequest) => Promise<Buffer>;
+export {};
+//# sourceMappingURL=outpaint-keyframe.d.ts.map

package/dist/video/outpaint-keyframe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outpaint-keyframe.d.ts","sourceRoot":"","sources":["../../src/video/outpaint-keyframe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;QACxB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;KACxB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,OAAO,CAAC;CACjB;AAUD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CA0HjC;AAMD,eAAO,MAAM,2BAA2B,gCAAgC,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAE9D,eAAO,MAAM,uBAAuB,QAKhB,CAAC;AAErB,MAAM,WAAW,4BAA4B;IAC3C,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,oBAAoB;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AA+DD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,CAAC,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAkDhD"}

package/dist/video/outpaint-keyframe.js

@@ -0,0 +1,244 @@
+/**
+ * outpaint-keyframe — pad a keyframe to a target canvas and build an
+ * inpainting mask for the new border region.
+ *
+ * Core (pad + mask) is pure/deterministic using only sharp.
+ * Fill is optional/scaffold: if a fill() factory is provided it calls the
+ * go-bananas REST edit endpoint; without a key it is inert.
+ */
+import sharp from 'sharp';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+// ---------------------------------------------------------------------------
+// Core implementation
+// ---------------------------------------------------------------------------
+const DEFAULT_TARGET_WIDTH = 1920;
+const DEFAULT_TARGET_HEIGHT = 1080;
+const DEFAULT_MASK_DILATION_FRAC = 0.03;
+/**
+ * Pad `inputPath` onto a `targetWidth`×`targetHeight` canvas (centred,
+ * letterboxed, transparent background) and produce an L-mode mask PNG where
+ * the original image area is black (known region) and the padded border is
+ * white (region to fill).  An optional `fill()` factory can call an
+ * inpainting backend and receive the filled result.
+ */
+export async function outpaintKeyframe(input) {
+    const { inputPath, outputPath, targetWidth = DEFAULT_TARGET_WIDTH, targetHeight = DEFAULT_TARGET_HEIGHT, maskDilation = DEFAULT_MASK_DILATION_FRAC, fill, env = process.env, fetcher = fetch, } = input;
+    if (!existsSync(inputPath)) {
+        throw new Error(`outpaint-keyframe: input file not found: ${inputPath}`);
+    }
+    // ------------------------------------------------------------------
+    // 1. Load source image metadata
+    // ------------------------------------------------------------------
+    const src = sharp(inputPath);
+    const meta = await src.metadata();
+    const srcW = meta.width ?? 0;
+    const srcH = meta.height ?? 0;
+    if (srcW === 0 || srcH === 0) {
+        throw new Error(`outpaint-keyframe: could not read dimensions from ${inputPath}`);
+    }
+    // ------------------------------------------------------------------
+    // 2. Compute centred placement on the target canvas
+    // ------------------------------------------------------------------
+    // Scale the source to fit inside the target, preserving aspect ratio.
+    const scaleX = targetWidth / srcW;
+    const scaleY = targetHeight / srcH;
+    const scale = Math.min(scaleX, scaleY, 1); // never upscale beyond 1:1
+    const fittedW = Math.round(srcW * scale);
+    const fittedH = Math.round(srcH * scale);
+    const offsetX = Math.floor((targetWidth - fittedW) / 2);
+    const offsetY = Math.floor((targetHeight - fittedH) / 2);
+    // ------------------------------------------------------------------
+    // 3. Build the padded (letterboxed) PNG
+    // ------------------------------------------------------------------
+    const resizedBuf = await sharp(inputPath)
+        .resize(fittedW, fittedH, { fit: 'fill' })
+        .png()
+        .toBuffer();
+    const paddedPng = await sharp({
+        create: {
+            width: targetWidth,
+            height: targetHeight,
+            channels: 4,
+            background: { r: 0, g: 0, b: 0, alpha: 0 },
+        },
+    })
+        .composite([{ input: resizedBuf, left: offsetX, top: offsetY }])
+        .png()
+        .toBuffer();
+    // ------------------------------------------------------------------
+    // 4. Build the RGBA alpha mask PNG
+    //    alpha 0 (transparent) = border to fill, alpha 255 (opaque) = keep.
+    //    go-bananas proxies masked edits to OpenAI gpt-image-2, which reads ONLY
+    //    the mask's alpha channel (transparent = edit, opaque = preserve), so the
+    //    mask MUST be RGBA — a grayscale luminance mask is ignored by the model.
+    //    dilation shrinks the opaque (known) region by dilationPx on each side.
+    // ------------------------------------------------------------------
+    const dilationPx = Math.max(0, Math.round(maskDilation * Math.min(targetWidth, targetHeight)));
+    // Inner known rectangle (shrunk INWARD by dilationPx so the transparent fill
+    // region bites slightly into the original image, producing a smooth seam —
+    // standard inpainting convention). The known (opaque) rectangle is therefore
+    // smaller than the placed image by dilationPx on each side.
+    const innerLeft = Math.min(targetWidth, offsetX + dilationPx);
+    const innerTop = Math.min(targetHeight, offsetY + dilationPx);
+    const innerRight = Math.max(0, offsetX + fittedW - dilationPx);
+    const innerBottom = Math.max(0, offsetY + fittedH - dilationPx);
+    const innerW = innerRight - innerLeft;
+    const innerH = innerBottom - innerTop;
+    // Build the mask as a raw RGBA buffer: start fully transparent (fill
+    // everywhere), then stamp the inner known rectangle opaque (alpha 255) so the
+    // original image is preserved. RGB is irrelevant to the provider — only the
+    // alpha channel is read — so we leave it black (0,0,0).
+    const maskRaw = Buffer.alloc(targetWidth * targetHeight * 4, 0); // RGBA, transparent
+    for (let row = innerTop; row < innerBottom; row++) {
+        const rowBase = row * targetWidth;
+        for (let col = innerLeft; col < innerRight; col++) {
+            maskRaw[(rowBase + col) * 4 + 3] = 255; // opaque alpha = preserve
+        }
+    }
+    const maskPng = await sharp(maskRaw, {
+        raw: { width: targetWidth, height: targetHeight, channels: 4 },
+    })
+        .png()
+        .toBuffer();
+    // Suppress unused variable warning: innerW / innerH are derived above and
+    // document the composite geometry; kept for future callers.
+    void innerW;
+    void innerH;
+    // ------------------------------------------------------------------
+    // 5. Write output (filled or letterboxed)
+    // ------------------------------------------------------------------
+    await mkdir(dirname(outputPath), { recursive: true });
+    let filled = false;
+    if (fill) {
+        const filledBuf = await fill({ paddedPng, maskPng, env, fetcher });
+        await writeFile(outputPath, filledBuf);
+        filled = true;
+    }
+    else {
+        await writeFile(outputPath, paddedPng);
+    }
+    return { outputPath, width: targetWidth, height: targetHeight, filled };
+}
+// ---------------------------------------------------------------------------
+// go-bananas outpaint fill factory
+// ---------------------------------------------------------------------------
+export const DEFAULT_GO_BANANAS_API_BASE = 'https://gobananasai.com/api';
+/**
+ * Masked edits go through OpenAI gpt-image-2; go-bananas rejects mask_image_id
+ * for any non-OpenAI model, so this is the only valid default.
+ */
+export const DEFAULT_OUTPAINT_MODEL_ID = 'openai-gpt-image-2';
+export const DEFAULT_OUTPAINT_PROMPT = 'Outpaint and naturally extend the scene into the transparent border ' +
+    'region. Seamlessly continue the existing lighting, colour, perspective, ' +
+    'textures and composition out to the new edges. Photorealistic, coherent ' +
+    'continuation with no visible seam, no new subjects, no added text, no ' +
+    'frame or border.';
+/**
+ * Upload one PNG buffer to go-bananas' multipart edit-upload endpoint and
+ * return its stored image id.
+ *
+ * POST {apiBase}/images/upload  (multipart/form-data, field `file`)
+ *   → 201 { image_id, public_url, ... }
+ */
+async function uploadForEditing(png, fileName, apiBase, apiKey, fetcher) {
+    const form = new FormData();
+    // NOTE: do NOT set Content-Type — FormData sets the multipart boundary.
+    form.append('file', new Blob([new Uint8Array(png)], { type: 'image/png' }), fileName);
+    const res = await fetcher(`${apiBase}/images/upload`, {
+        method: 'POST',
+        headers: { 'X-API-Key': apiKey },
+        body: form,
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '(no body)');
+        throw new Error(`go-bananas upload (${fileName}) HTTP ${res.status}: ${text}`);
+    }
+    const json = (await res.json().catch(() => ({})));
+    const id = json.image_id ??
+        json.imageId ??
+        json.data?.image_id;
+    if (typeof id !== 'number' || !Number.isFinite(id)) {
+        throw new Error(`go-bananas upload (${fileName}): no image_id in response: ${JSON.stringify(json).slice(0, 200)}`);
+    }
+    return id;
+}
+/** Pull the downloadable result URL out of the edit-image response (shape-tolerant). */
+function extractOutpaintResultUrl(json) {
+    const data = json.data;
+    const candidates = [
+        json.fullUrl,
+        json.full_url,
+        json.url,
+        json.imageUrl,
+        json.image_url,
+        data?.fullUrl,
+        data?.full_url,
+        data?.url,
+    ];
+    for (const c of candidates) {
+        if (typeof c === 'string' && c.length > 0)
+            return c;
+    }
+    return undefined;
+}
+/**
+ * Build a fill() function that performs a go-bananas masked outpaint via the
+ * upload×2 → edit-by-id → download flow (verified against the live API):
+ *
+ *   1. POST {apiBase}/images/upload  (padded source PNG) → image_id
+ *   2. POST {apiBase}/images/upload  (RGBA alpha mask PNG) → mask_image_id
+ *   3. POST {apiBase}/edit-image     { image_id, mask_image_id, model_id, prompt, size? }
+ *        → { fullUrl, ... }
+ *   4. GET  fullUrl → filled image bytes (returned as a Buffer)
+ *
+ *   - apiBase from env GO_BANANAS_API_URL (default https://gobananasai.com/api)
+ *   - apiKey  from env GO_BANANAS_API_KEY (throws env_var_missing when absent,
+ *     so the factory is inert in offline / CI contexts)
+ *   - injectable fetcher for offline testing
+ */
+export function goBananasOutpaintFill(options = {}) {
+    return async ({ paddedPng, maskPng, env = process.env, fetcher = fetch }) => {
+        const apiKey = env.GO_BANANAS_API_KEY;
+        if (!apiKey) {
+            throw new Error('env_var_missing: GO_BANANAS_API_KEY is required for go-bananas outpaint fill');
+        }
+        const apiBase = env.GO_BANANAS_API_URL?.trim() || DEFAULT_GO_BANANAS_API_BASE;
+        const prompt = options.prompt?.trim() || DEFAULT_OUTPAINT_PROMPT;
+        const modelId = options.modelId?.trim() || DEFAULT_OUTPAINT_MODEL_ID;
+        // 1 + 2. Upload the padded source and the alpha mask, get their stored ids.
+        const imageId = await uploadForEditing(paddedPng, 'padded.png', apiBase, apiKey, fetcher);
+        const maskImageId = await uploadForEditing(maskPng, 'mask.png', apiBase, apiKey, fetcher);
+        // 3. Edit-by-id with the mask. mask_image_id requires an OpenAI model.
+        const editBody = {
+            image_id: imageId,
+            mask_image_id: maskImageId,
+            model_id: modelId,
+            prompt,
+        };
+        if (options.size)
+            editBody.size = options.size;
+        const editRes = await fetcher(`${apiBase}/edit-image`, {
+            method: 'POST',
+            headers: { 'X-API-Key': apiKey, 'Content-Type': 'application/json' },
+            body: JSON.stringify(editBody),
+        });
+        if (!editRes.ok) {
+            const text = await editRes.text().catch(() => '(no body)');
+            throw new Error(`go-bananas edit-image HTTP ${editRes.status}: ${text}`);
+        }
+        const editJson = (await editRes.json().catch(() => ({})));
+        const resultUrl = extractOutpaintResultUrl(editJson);
+        if (!resultUrl) {
+            throw new Error(`go-bananas edit-image: no result URL in response: ${JSON.stringify(editJson).slice(0, 300)}`);
+        }
+        // 4. Download the filled image.
+        const dl = await fetcher(resultUrl, {});
+        if (!dl.ok) {
+            throw new Error(`go-bananas outpaint download HTTP ${dl.status} for ${resultUrl}`);
+        }
+        return Buffer.from(await dl.arrayBuffer());
+    };
+}
+//# sourceMappingURL=outpaint-keyframe.js.map

package/dist/video/outpaint-keyframe.js.map

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

package/dist/video/pipeline-manifest.d.ts

@@ -0,0 +1,4 @@
+import type { VideoPipelineManifest, VideoProductionMode } from './types.js';
+export declare function getBuiltinPipelineManifest(mode: VideoProductionMode): VideoPipelineManifest;
+export declare function listBuiltinPipelineManifests(): VideoPipelineManifest[];
+//# sourceMappingURL=pipeline-manifest.d.ts.map

package/dist/video/pipeline-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-manifest.d.ts","sourceRoot":"","sources":["../../src/video/pipeline-manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAO7E,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,mBAAmB,GAAG,qBAAqB,CAE3F;AAED,wBAAgB,4BAA4B,IAAI,qBAAqB,EAAE,CAEtE"}

package/dist/video/pipeline-manifest.js

@@ -0,0 +1,13 @@
+import storyboardManifest from './pipeline-manifests/storyboard.json' with { type: 'json' };
+import directorManifest from './pipeline-manifests/director.json' with { type: 'json' };
+const BUILTIN_PIPELINE_MANIFESTS = {
+    storyboard: storyboardManifest,
+    director: directorManifest,
+};
+export function getBuiltinPipelineManifest(mode) {
+    return BUILTIN_PIPELINE_MANIFESTS[mode];
+}
+export function listBuiltinPipelineManifests() {
+    return Object.values(BUILTIN_PIPELINE_MANIFESTS);
+}
+//# sourceMappingURL=pipeline-manifest.js.map

package/dist/video/pipeline-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-manifest.js","sourceRoot":"","sources":["../../src/video/pipeline-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,sCAAsC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC5F,OAAO,gBAAgB,MAAM,oCAAoC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAGxF,MAAM,0BAA0B,GAAuD;IACrF,UAAU,EAAE,kBAA2C;IACvD,QAAQ,EAAE,gBAAyC;CACpD,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,IAAyB;IAClE,OAAO,0BAA0B,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;AACnD,CAAC"}

package/dist/video/pipeline-manifests/director.json

@@ -0,0 +1,46 @@
+{
+    "name": "director",
+    "version": "1.0.0",
+    "productionMode": "director",
+    "stages": [
+        {
+            "name": "brief",
+            "produces": ["brief"],
+            "checkpointRequired": true,
+            "humanApprovalDefault": true,
+            "successCriteria": ["brief artifact exists"]
+        },
+        {
+            "name": "storyboard",
+            "requiredArtifactsIn": ["brief"],
+            "produces": ["storyboard"],
+            "checkpointRequired": true,
+            "humanApprovalDefault": true,
+            "successCriteria": ["director beat plan exists"]
+        },
+        {
+            "name": "assets",
+            "requiredArtifactsIn": ["storyboard"],
+            "produces": ["asset-manifest"],
+            "checkpointRequired": true,
+            "humanApprovalDefault": false,
+            "successCriteria": ["asset manifest exists"]
+        },
+        {
+            "name": "review",
+            "requiredArtifactsIn": ["asset-manifest"],
+            "produces": ["review-report"],
+            "checkpointRequired": true,
+            "humanApprovalDefault": true,
+            "successCriteria": ["review verdict is explicit"]
+        },
+        {
+            "name": "publish",
+            "requiredArtifactsIn": ["review-report"],
+            "produces": ["publish-report"],
+            "checkpointRequired": true,
+            "humanApprovalDefault": true,
+            "successCriteria": ["publish readiness is explicit"]
+        }
+    ]
+}

package/dist/video/pipeline-manifests/storyboard.json

@@ -0,0 +1,46 @@
+{
+    "name": "storyboard",
+    "version": "1.0.0",
+    "productionMode": "storyboard",
+    "stages": [
+        {
+            "name": "brief",
+            "produces": ["brief"],
+            "checkpointRequired": true,
+            "humanApprovalDefault": true,
+            "successCriteria": ["brief artifact exists"]
+        },
+        {
+            "name": "storyboard",
+            "requiredArtifactsIn": ["brief"],
+            "produces": ["storyboard"],
+            "checkpointRequired": true,
+            "humanApprovalDefault": true,
+            "successCriteria": ["storyboard scenes exist"]
+        },
+        {
+            "name": "assets",
+            "requiredArtifactsIn": ["storyboard"],
+            "produces": ["asset-manifest"],
+            "checkpointRequired": true,
+            "humanApprovalDefault": false,
+            "successCriteria": ["asset manifest exists"]
+        },
+        {
+            "name": "review",
+            "requiredArtifactsIn": ["asset-manifest"],
+            "produces": ["review-report"],
+            "checkpointRequired": true,
+            "humanApprovalDefault": true,
+            "successCriteria": ["review verdict is explicit"]
+        },
+        {
+            "name": "publish",
+            "requiredArtifactsIn": ["review-report"],
+            "produces": ["publish-report"],
+            "checkpointRequired": true,
+            "humanApprovalDefault": true,
+            "successCriteria": ["publish readiness is explicit"]
+        }
+    ]
+}

package/dist/video/platform-specs.d.ts

@@ -0,0 +1,26 @@
+/**
+ * platform-specs.ts — deterministic per-platform delivery spec table.
+ *
+ * The asset-format analogue of cinematography.ts `--detail` levels: a pure,
+ * no-LLM lookup mapping a social/ad platform id to its aspect ratio and copy
+ * word-caps, so campaign output is correct-by-construction (right dimensions,
+ * platform-appropriate copy length + tone).
+ *
+ * Concept (not code) adapted from the MIT-licensed Open-Pomelli `platforms.ts`.
+ * A `bodyMaxWords`/`ctaMaxWords` of 0 means that surface suppresses that copy
+ * slot (e.g. a thumbnail has a headline but no body).
+ */
+export type PlatformAspect = '16:9' | '9:16' | '1:1' | '4:5';
+export interface PlatformSpec {
+    id: string;
+    label: string;
+    aspect: PlatformAspect;
+    headlineMaxWords: number;
+    bodyMaxWords: number;
+    ctaMaxWords: number;
+    tone: string;
+}
+export declare function getPlatformSpec(id: string): PlatformSpec | undefined;
+export declare function listPlatformSpecs(): PlatformSpec[];
+export declare function platformIds(): string[];
+//# sourceMappingURL=platform-specs.d.ts.map

package/dist/video/platform-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-specs.d.ts","sourceRoot":"","sources":["../../src/video/platform-specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAgBD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEpE;AAED,wBAAgB,iBAAiB,IAAI,YAAY,EAAE,CAElD;AAED,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC"}

package/dist/video/platform-specs.js

@@ -0,0 +1,34 @@
+/**
+ * platform-specs.ts — deterministic per-platform delivery spec table.
+ *
+ * The asset-format analogue of cinematography.ts `--detail` levels: a pure,
+ * no-LLM lookup mapping a social/ad platform id to its aspect ratio and copy
+ * word-caps, so campaign output is correct-by-construction (right dimensions,
+ * platform-appropriate copy length + tone).
+ *
+ * Concept (not code) adapted from the MIT-licensed Open-Pomelli `platforms.ts`.
+ * A `bodyMaxWords`/`ctaMaxWords` of 0 means that surface suppresses that copy
+ * slot (e.g. a thumbnail has a headline but no body).
+ */
+const SPECS = [
+    { id: 'tiktok', label: 'TikTok', aspect: '9:16', headlineMaxWords: 8, bodyMaxWords: 22, ctaMaxWords: 4, tone: 'native, fast, conversational' },
+    { id: 'instagram-reel', label: 'Instagram Reel', aspect: '9:16', headlineMaxWords: 8, bodyMaxWords: 22, ctaMaxWords: 4, tone: 'aspirational, punchy' },
+    { id: 'instagram-post', label: 'Instagram Post', aspect: '1:1', headlineMaxWords: 10, bodyMaxWords: 30, ctaMaxWords: 4, tone: 'aspirational, polished' },
+    { id: 'youtube-short', label: 'YouTube Short', aspect: '9:16', headlineMaxWords: 8, bodyMaxWords: 20, ctaMaxWords: 4, tone: 'hooky, high-energy' },
+    { id: 'youtube-thumb', label: 'YouTube Thumbnail', aspect: '16:9', headlineMaxWords: 6, bodyMaxWords: 0, ctaMaxWords: 0, tone: 'bold, curiosity-driving' },
+    { id: 'linkedin', label: 'LinkedIn', aspect: '1:1', headlineMaxWords: 12, bodyMaxWords: 40, ctaMaxWords: 5, tone: 'credible, professional' },
+    { id: 'facebook', label: 'Facebook', aspect: '1:1', headlineMaxWords: 10, bodyMaxWords: 30, ctaMaxWords: 5, tone: 'clear, friendly' },
+    { id: 'x', label: 'X / Twitter', aspect: '16:9', headlineMaxWords: 10, bodyMaxWords: 28, ctaMaxWords: 4, tone: 'sharp, concise' },
+    { id: 'banner', label: 'Web Banner', aspect: '16:9', headlineMaxWords: 6, bodyMaxWords: 12, ctaMaxWords: 3, tone: 'direct, benefit-led' },
+];
+const BY_ID = new Map(SPECS.map((spec) => [spec.id, spec]));
+export function getPlatformSpec(id) {
+    return BY_ID.get(id.toLowerCase());
+}
+export function listPlatformSpecs() {
+    return SPECS.map((spec) => ({ ...spec }));
+}
+export function platformIds() {
+    return SPECS.map((spec) => spec.id);
+}
+//# sourceMappingURL=platform-specs.js.map

package/dist/video/platform-specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-specs.js","sourceRoot":"","sources":["../../src/video/platform-specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,MAAM,KAAK,GAA4B;IACrC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,8BAA8B,EAAE;IAC9I,EAAE,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE;IACtJ,EAAE,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE;IACxJ,EAAE,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE;IAClJ,EAAE,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE;IAC1J,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE;IAC5I,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE;IACrI,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE;IACjI,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE;CAC1I,CAAC;AAEF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAE5D,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/video/playbooks.d.ts

@@ -0,0 +1,11 @@
+export interface VideoPlaybook {
+    name: string;
+    provider: 'veo' | 'seedance';
+    useWhen: string[];
+    promptFormula: string[];
+    constraints: string[];
+    adaptationChecklist: string[];
+}
+export declare function listPlaybooks(root?: string): Promise<string[]>;
+export declare function readPlaybook(name: string, root?: string): Promise<VideoPlaybook | null>;
+//# sourceMappingURL=playbooks.d.ts.map

package/dist/video/playbooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbooks.d.ts","sourceRoot":"","sources":["../../src/video/playbooks.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,GAAG,UAAU,CAAC;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAMD,wBAAsB,aAAa,CAAC,IAAI,SAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAO3E;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,SAAgB,GACnB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAI/B"}

package/dist/video/playbooks.js

@@ -0,0 +1,22 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+function playbooksDir(root = process.cwd()) {
+    return join(resolve(root), 'playbooks');
+}
+export async function listPlaybooks(root = process.cwd()) {
+    const dir = playbooksDir(root);
+    if (!existsSync(dir))
+        return [];
+    return (await readdir(dir))
+        .filter((entry) => entry.endsWith('.json'))
+        .map((entry) => entry.replace(/\.json$/, ''))
+        .sort();
+}
+export async function readPlaybook(name, root = process.cwd()) {
+    const path = join(playbooksDir(root), `${name}.json`);
+    if (!existsSync(path))
+        return null;
+    return JSON.parse(await readFile(path, 'utf-8'));
+}
+//# sourceMappingURL=playbooks.js.map

package/dist/video/playbooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbooks.js","sourceRoot":"","sources":["../../src/video/playbooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAW1C,SAAS,YAAY,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;IACtD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;SACxB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SAC1C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;SAC5C,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;IAEpB,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAkB,CAAC;AACpE,CAAC"}