@orangecatai/adgen-canvas 0.0.26 → 0.0.28

package/dist/prod/subset-shared.chunk.js

@@ -1 +1 @@
-import{a,b,c,d}from"./chunk-Z5NKEFVG.js";import"./chunk-FABLWJ5B.js";import"./chunk-SRAX5OIU.js";export{a as Commands,b as subsetToBase64,c as subsetToBinary,d as toBase64};
+import{a,b,c,d}from"./chunk-Z5NKEFVG.js";import"./chunk-INDX7AB6.js";import"./chunk-SRAX5OIU.js";export{a as Commands,b as subsetToBase64,c as subsetToBinary,d as toBase64};

package/dist/prod/subset-worker.chunk.js

@@ -1 +1 @@
-import{a as r,c as t}from"./chunk-Z5NKEFVG.js";import"./chunk-FABLWJ5B.js";import"./chunk-SRAX5OIU.js";var s=import.meta.url?new URL(import.meta.url):void 0;typeof window>"u"&&typeof self<"u"&&(self.onmessage=async e=>{switch(e.data.command){case r.Subset:let a=await t(e.data.arrayBuffer,e.data.codePoints);self.postMessage(a,{transfer:[a]});break}});export{s as WorkerUrl};
+import{a as r,c as t}from"./chunk-Z5NKEFVG.js";import"./chunk-INDX7AB6.js";import"./chunk-SRAX5OIU.js";var s=import.meta.url?new URL(import.meta.url):void 0;typeof window>"u"&&typeof self<"u"&&(self.onmessage=async e=>{switch(e.data.command){case r.Subset:let a=await t(e.data.arrayBuffer,e.data.codePoints);self.postMessage(a,{transfer:[a]});break}});export{s as WorkerUrl};

package/dist/types/excalidraw/components/AIChatPanel.d.ts

@@ -43,6 +43,21 @@ export type AIChatPanelProps = {
      * `chatUrl`. Keeps the provider key out of the browser.
      */
     imageGenUrl?: string;
+    /**
+     * Host proxy URL for the agent's generate_video / generate_video_chain
+     * tools. Same contract as `imageGenUrl` — the host injects the provider key,
+     * gates credits, and returns a `{ jobId }` to poll. Without this pair the
+     * video tools report themselves as unconfigured instead of failing mid-run.
+     */
+    videoGenUrl?: string;
+    /** Host status endpoint for a submitted video job; the jobId is appended as a path segment. */
+    videoGenStatusUrl?: string;
+    /** Host shot-splitter URL. Required for the agent's generate_video_chain tool. */
+    videoPlanUrl?: string;
+    /** Host upload URL for a stitched long-form video. Falls back to an in-memory object URL. */
+    videoUploadUrl?: string;
+    /** Host proxy that re-fetches presigned S3 video URLs server-side (browser CORS workaround). */
+    videoDownloadProxyUrl?: string;
     excalidrawAPI?: ExcalidrawImperativeAPI;
     initialMessages?: ChatMessage[];
     initialSessionId?: string;
@@ -76,6 +91,16 @@ export type AIChatPanelProps = {
         error?: string;
     }>;
     onAfterImageGen?: () => void;
+    /**
+     * Credit gate for a video generated by the chat agent. Called once per
+     * generated video — and once per segment of a long-form chain, since each
+     * segment is separately billed.
+     */
+    onBeforeVideoGen?: () => Promise<{
+        allowed: boolean;
+        error?: string;
+    }>;
+    onAfterVideoGen?: () => void;
     /**
      * OpenRouter model tag for the chat system (both plain chat and agent loop).
      * @default "minimax/minimax-m3"

package/dist/types/excalidraw/components/App.d.ts

@@ -259,6 +259,15 @@ declare class App extends React.Component<AppProps, AppState> {
     private updateEmbedValidationStatus;
     private updateEmbeddables;
     private renderEmbeddables;
+    /**
+     * True when this video's parent frame already offers Download and Campaign
+     * through the video variant of the frame toolbar. The in-video toolbar is
+     * suppressed in that case so the two actions never appear twice at once.
+     *
+     * Videos with no such frame — pasted, dragged in, agent-placed — keep their
+     * own toolbar as the only way to reach those actions.
+     */
+    private frameToolbarOwnsVideo;
     private renderVideos;
     private getFrameNameDOMId;
     frameNameBoundsCache: FrameNameBoundsCache;

package/dist/types/excalidraw/components/CampaignDropdown.d.ts

@@ -0,0 +1,14 @@
+import "./CampaignDropdown.scss";
+import type { CampaignSummary } from "../types";
+export declare const CampaignDropdown: ({ onFetchCampaigns, onCreateCampaign, onAdd, disabled, disabledReason, }: {
+    onFetchCampaigns?: () => Promise<{
+        campaigns: CampaignSummary[];
+    }>;
+    onCreateCampaign?: (name: string) => Promise<CampaignSummary>;
+    onAdd?: (campaignId: string) => Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    disabled?: boolean;
+    disabledReason?: string;
+}) => import("react/jsx-runtime").JSX.Element | null;

package/dist/types/excalidraw/components/FrameToolbar.d.ts

@@ -1,7 +1,16 @@
 import "./FrameToolbar.scss";
-import type { ExcalidrawFrameLikeElement, NonDeletedExcalidrawElement } from "@orangecatai/element/types";
+import type { FrameToolbarVariant } from "./frameToolbarVariant";
+import type { ExcalidrawFrameLikeElement, ExcalidrawVideoElement, NonDeletedExcalidrawElement } from "@orangecatai/element/types";
 import type { AppClassProperties } from "../types";
-export declare const FrameToolbar: ({ element, app, }: {
+export declare const FrameToolbar: ({ element, app, variant, videoElement, }: {
     element: NonDeletedExcalidrawElement & ExcalidrawFrameLikeElement;
     app: AppClassProperties;
+    /**
+     * "frame" is the full toolbar. "video" drops Resize and Template — both are
+     * image-only — and swaps the export and campaign actions for video ones.
+     * See `getFrameToolbarVariant`, which resolves this from the frame.
+     */
+    variant?: FrameToolbarVariant;
+    /** The frame's ready video child. Required when variant is "video". */
+    videoElement?: ExcalidrawVideoElement | null;
 }) => import("react/jsx-runtime").JSX.Element | null;

package/dist/types/excalidraw/components/ImageGeneratorPanel.d.ts

@@ -65,6 +65,20 @@ export declare const MODEL_CONFIG: {
         readonly supportedResolutions: readonly ["1K", "2K", "4K"];
         readonly supportedRatios: readonly ["1:1", "21:9", "16:9", "3:2", "4:3", "5:4", "4:5", "3:4", "2:3", "9:16"];
     };
+    readonly "gpt image 1 mini": {
+        readonly modelId: "openai/gpt-image-1-mini";
+        readonly textOutput: false;
+        readonly supportsImageSize: false;
+        readonly supportedResolutions: readonly ["1K"];
+        readonly supportedRatios: readonly ["1:1", "2:3", "3:2"];
+    };
+    readonly "gpt image 2": {
+        readonly modelId: "openai/gpt-image-2";
+        readonly textOutput: false;
+        readonly supportsImageSize: false;
+        readonly supportedResolutions: readonly ["1K", "2K"];
+        readonly supportedRatios: readonly ["21:9", "16:9", "4:3", "3:2", "1:1", "9:16", "3:4", "2:3", "5:4", "4:5"];
+    };
 };
 export type ModelName = keyof typeof MODEL_CONFIG;
 export declare const MODEL_NAMES: ModelName[];

package/dist/types/excalidraw/components/VideoChainPanel.d.ts

@@ -0,0 +1,58 @@
+import React from "react";
+import { type VideoJobParams, type ChainSegmentBeat } from "../utils/videoApi";
+import "./VideoChainPanel.scss";
+import type { ExcalidrawFrameLikeElement, NonDeletedExcalidrawElement } from "@orangecatai/element/types";
+import type { AppClassProperties } from "../types";
+export type ChainSegmentStatus = "queued" | "generating" | "done" | "failed";
+export type { ChainSegmentBeat };
+export interface ChainSegmentState {
+    index: number;
+    prompt: string;
+    status: ChainSegmentStatus;
+    beat?: ChainSegmentBeat;
+    jobId?: string;
+    videoS3Key?: string;
+    error?: string;
+}
+export type ChainPhase = "idle" | "planning" | "generating" | "stitching" | "done" | "error";
+export interface VideoChainPanelHandle {
+    /**
+     * Runs the whole plan → generate → stitch pipeline as one motion. If the
+     * last run left a failed segment, resumes from it instead of re-planning.
+     * Otherwise (no prior chain, or a fully-completed one) discards any
+     * previous plan and starts fresh — a changed concept/duration should not
+     * silently resume stale segments.
+     */
+    start: () => void;
+    stop: () => void;
+}
+export interface VideoChainPanelProps {
+    element: NonDeletedExcalidrawElement & ExcalidrawFrameLikeElement;
+    app: AppClassProperties;
+    /** The overall ad concept — sent to the shot-splitter as-is. */
+    concept: string;
+    /** How many segments the currently-selected duration implies (>1, or this panel wouldn't be mounted). */
+    segmentCount: number;
+    /** Every segment's duration — always the model's native single-generation max. */
+    segmentDurationSeconds: number;
+    /** Every video-gen field held fixed across the whole chain (model, ratio, resolution, audio toggle, seed, ...). */
+    baseParams: Omit<VideoJobParams, "prompt" | "firstFrameDataUrl">;
+    /** Applied to each segment's shot-writer prompt before submission (e.g. brand tone wrapping). Defaults to identity. */
+    wrapPrompt?: (segmentPrompt: string) => string;
+    /** First frame for segment 0, e.g. a user-uploaded starting image. */
+    initialFirstFrameDataUrl?: string;
+    videoGenUrl: string;
+    videoGenStatusUrl: string;
+    videoPlanUrl?: string;
+    videoUploadUrl?: string;
+    /** Fetches a presigned S3 video URL server-side to work around browser CORS — see resolveFetchUrl. */
+    videoDownloadProxyUrl?: string;
+    onBeforeVideoGen?: () => Promise<{
+        allowed: boolean;
+        error?: string;
+    }>;
+    onAfterVideoGen?: () => void;
+    /** Lets the parent reflect chain progress in its own Generate/Stop button and shimmer overlay. */
+    onPhaseChange?: (phase: ChainPhase) => void;
+}
+export declare const VideoChainPanel: React.ForwardRefExoticComponent<VideoChainPanelProps & React.RefAttributes<VideoChainPanelHandle>>;

package/dist/types/excalidraw/components/VideoElement.d.ts

@@ -1,9 +1,34 @@
 import type { ExcalidrawVideoElement } from "@orangecatai/element/types";
+import type { CampaignSummary } from "../types";
 import "./VideoElement.scss";
 interface VideoElementProps {
     element: ExcalidrawVideoElement;
     isActive: boolean;
     videoDownloadProxyUrl?: string;
+    /**
+     * Whether to render the in-video Download / Campaign toolbar.
+     *
+     * Defaults to true. `App.tsx` passes false when the video sits inside a
+     * video-generator frame whose frame toolbar already offers both actions, so
+     * the two surfaces never appear at once. Videos with no such frame (pasted,
+     * dragged in, agent-placed) keep this toolbar as their only access.
+     */
+    showToolbar?: boolean;
+    onFetchCampaigns?: () => Promise<{
+        campaigns: CampaignSummary[];
+    }>;
+    onCreateCampaign?: (name: string) => Promise<CampaignSummary>;
+    onAddToCampaign?: (payload: {
+        kind: "video";
+        campaignId: string;
+        videoUrl: string;
+        mimeType: string;
+        width: number;
+        height: number;
+    }) => Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
 }
-export declare const VideoElement: ({ element, videoDownloadProxyUrl, }: VideoElementProps) => import("react/jsx-runtime").JSX.Element;
+export declare const VideoElement: ({ element, videoDownloadProxyUrl, showToolbar, onFetchCampaigns, onCreateCampaign, onAddToCampaign, }: VideoElementProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/excalidraw/components/ai-chat/canvasTools.d.ts

@@ -1,5 +1,85 @@
 import type { ExcalidrawElement } from "@orangecatai/element/types";
-import type { ExcalidrawImperativeAPI } from "../../types";
+import type { ExcalidrawImperativeAPI, BrandContext } from "../../types";
+/** The only video model the chat agent can drive. */
+export declare const CHAT_VIDEO_MODEL = "google/veo-3.1-fast";
+export declare const VIDEO_TOOLS: ({
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                first_frame_element_id: {
+                    readonly type: "string";
+                    readonly description: "ID of an existing IMAGE element already on the canvas to use as the video's opening frame (image-to-video). Use this to animate an image the user can see on the canvas.";
+                };
+                last_frame_element_id: {
+                    readonly type: "string";
+                    readonly description: "ID of an existing IMAGE element on the canvas to use as the video's closing frame. Optional.";
+                };
+                first_frame_attachment_index: {
+                    readonly type: "number";
+                    readonly description: "0-based index of an image the user ATTACHED to the chat, to use as the opening frame. Use this instead of first_frame_element_id when the source image was uploaded in chat rather than placed on the canvas.";
+                };
+                last_frame_attachment_index: {
+                    readonly type: "number";
+                    readonly description: "0-based index of an attached chat image to use as the closing frame. Optional.";
+                };
+                frameId: {
+                    type: string;
+                    description: string;
+                };
+                prompt: {
+                    type: string;
+                    description: string;
+                };
+                duration: {
+                    type: string;
+                    enum: (4 | 6 | 8)[];
+                    description: string;
+                };
+                narrative_prompt?: undefined;
+                total_duration?: undefined;
+            };
+            required: string[];
+            additionalProperties: boolean;
+        };
+    };
+} | {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                frameId: {
+                    type: string;
+                    description: string;
+                };
+                narrative_prompt: {
+                    type: string;
+                    description: string;
+                };
+                total_duration: {
+                    type: string;
+                    description: string;
+                };
+                first_frame_element_id: {
+                    readonly type: "string";
+                    readonly description: "ID of an existing IMAGE element already on the canvas to use as the video's opening frame (image-to-video). Use this to animate an image the user can see on the canvas.";
+                };
+                first_frame_attachment_index: {
+                    readonly type: "number";
+                    readonly description: "0-based index of an image the user ATTACHED to the chat, to use as the opening frame. Use this instead of first_frame_element_id when the source image was uploaded in chat rather than placed on the canvas.";
+                };
+            };
+            required: string[];
+            additionalProperties: boolean;
+        };
+    };
+})[];
 export declare const CANVAS_TOOLS: readonly [{
     readonly type: "function";
     readonly function: {
@@ -167,7 +247,84 @@ export declare const CANVAS_TOOLS: readonly [{
             readonly additionalProperties: false;
         };
     };
-}, {
+}, ...({
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                first_frame_element_id: {
+                    readonly type: "string";
+                    readonly description: "ID of an existing IMAGE element already on the canvas to use as the video's opening frame (image-to-video). Use this to animate an image the user can see on the canvas.";
+                };
+                last_frame_element_id: {
+                    readonly type: "string";
+                    readonly description: "ID of an existing IMAGE element on the canvas to use as the video's closing frame. Optional.";
+                };
+                first_frame_attachment_index: {
+                    readonly type: "number";
+                    readonly description: "0-based index of an image the user ATTACHED to the chat, to use as the opening frame. Use this instead of first_frame_element_id when the source image was uploaded in chat rather than placed on the canvas.";
+                };
+                last_frame_attachment_index: {
+                    readonly type: "number";
+                    readonly description: "0-based index of an attached chat image to use as the closing frame. Optional.";
+                };
+                frameId: {
+                    type: string;
+                    description: string;
+                };
+                prompt: {
+                    type: string;
+                    description: string;
+                };
+                duration: {
+                    type: string;
+                    enum: (4 | 6 | 8)[];
+                    description: string;
+                };
+                narrative_prompt?: undefined;
+                total_duration?: undefined;
+            };
+            required: string[];
+            additionalProperties: boolean;
+        };
+    };
+} | {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                frameId: {
+                    type: string;
+                    description: string;
+                };
+                narrative_prompt: {
+                    type: string;
+                    description: string;
+                };
+                total_duration: {
+                    type: string;
+                    description: string;
+                };
+                first_frame_element_id: {
+                    readonly type: "string";
+                    readonly description: "ID of an existing IMAGE element already on the canvas to use as the video's opening frame (image-to-video). Use this to animate an image the user can see on the canvas.";
+                };
+                first_frame_attachment_index: {
+                    readonly type: "number";
+                    readonly description: "0-based index of an image the user ATTACHED to the chat, to use as the opening frame. Use this instead of first_frame_element_id when the source image was uploaded in chat rather than placed on the canvas.";
+                };
+            };
+            required: string[];
+            additionalProperties: boolean;
+        };
+    };
+})[], {
     readonly type: "function";
     readonly function: {
         readonly name: "update_element";
@@ -268,7 +425,84 @@ export declare const CANVAS_TOOLS: readonly [{
  * agent knows it can use those numbers in `add_text` calls.
  */
 export declare function getCanvasTools(extraFontIds?: number[]): typeof CANVAS_TOOLS;
-export declare const BANNER_TOOLS: readonly [{
+export declare const BANNER_TOOLS: readonly [...({
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                first_frame_element_id: {
+                    readonly type: "string";
+                    readonly description: "ID of an existing IMAGE element already on the canvas to use as the video's opening frame (image-to-video). Use this to animate an image the user can see on the canvas.";
+                };
+                last_frame_element_id: {
+                    readonly type: "string";
+                    readonly description: "ID of an existing IMAGE element on the canvas to use as the video's closing frame. Optional.";
+                };
+                first_frame_attachment_index: {
+                    readonly type: "number";
+                    readonly description: "0-based index of an image the user ATTACHED to the chat, to use as the opening frame. Use this instead of first_frame_element_id when the source image was uploaded in chat rather than placed on the canvas.";
+                };
+                last_frame_attachment_index: {
+                    readonly type: "number";
+                    readonly description: "0-based index of an attached chat image to use as the closing frame. Optional.";
+                };
+                frameId: {
+                    type: string;
+                    description: string;
+                };
+                prompt: {
+                    type: string;
+                    description: string;
+                };
+                duration: {
+                    type: string;
+                    enum: (4 | 6 | 8)[];
+                    description: string;
+                };
+                narrative_prompt?: undefined;
+                total_duration?: undefined;
+            };
+            required: string[];
+            additionalProperties: boolean;
+        };
+    };
+} | {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                frameId: {
+                    type: string;
+                    description: string;
+                };
+                narrative_prompt: {
+                    type: string;
+                    description: string;
+                };
+                total_duration: {
+                    type: string;
+                    description: string;
+                };
+                first_frame_element_id: {
+                    readonly type: "string";
+                    readonly description: "ID of an existing IMAGE element already on the canvas to use as the video's opening frame (image-to-video). Use this to animate an image the user can see on the canvas.";
+                };
+                first_frame_attachment_index: {
+                    readonly type: "number";
+                    readonly description: "0-based index of an image the user ATTACHED to the chat, to use as the opening frame. Use this instead of first_frame_element_id when the source image was uploaded in chat rather than placed on the canvas.";
+                };
+            };
+            required: string[];
+            additionalProperties: boolean;
+        };
+    };
+})[], {
     readonly type: "function";
     readonly function: {
         readonly name: "create_frame";
@@ -696,6 +930,41 @@ export type ToolExecutionContext = {
         name: string;
         dataUrl?: string;
     }>;
+    /**
+     * Full brand identity. The agent already receives this as a system message,
+     * but the video tools also append it to the generation prompt deterministically
+     * via buildVideoBrandPrompt — the same wrapper VideoGeneratorPanel uses — so
+     * chat-generated footage is as on-brand as panel-generated footage instead of
+     * depending on whatever the model chose to restate.
+     */
+    brandContext?: BrandContext;
+    /** Host proxy URL for submitting a video-gen job. Required for generate_video. */
+    videoGenUrl?: string;
+    /** Host proxy URL polled for job status (the jobId is appended as a path segment). */
+    videoGenStatusUrl?: string;
+    /** Host shot-splitter URL. Required for generate_video_chain. */
+    videoPlanUrl?: string;
+    /** Host upload URL for the stitched chain output. Falls back to an object URL. */
+    videoUploadUrl?: string;
+    /** Host proxy that re-fetches presigned S3 video URLs server-side (CORS workaround). */
+    videoDownloadProxyUrl?: string;
+    /**
+     * Credit gate for a single video generation. Called once per generated
+     * video — including once per segment of a chain, since each segment is its
+     * own billed generation (matching the standalone panel's contract).
+     */
+    onBeforeVideoGen?: () => Promise<{
+        allowed: boolean;
+        error?: string;
+    }>;
+    /** Fired after each successful video generation (host persists / refreshes). */
+    onAfterVideoGen?: () => void;
+    /**
+     * Pushes an interim status line to the chat while a long-running tool is
+     * mid-flight. Video generation blocks for minutes, so it repeatedly calls
+     * this to keep the panel's status indicator moving instead of frozen.
+     */
+    onStatus?: (message: string) => void;
     onSearchBrandAssets?: (query: string, type?: string) => Promise<Array<{
         id: string;
         name: string;

package/dist/types/excalidraw/components/frameToolbarVariant.d.ts

@@ -0,0 +1,23 @@
+import type { ElementsMapOrArray, ExcalidrawFrameLikeElement, ExcalidrawVideoElement } from "@orangecatai/element/types";
+export type FrameToolbarVariant = "frame" | "video";
+export type FrameToolbarVariantResult = {
+    variant: FrameToolbarVariant;
+    /** The frame's ready video child. Only ever set for the "video" variant. */
+    videoElement: ExcalidrawVideoElement | null;
+};
+/**
+ * Decides which frame toolbar — if any — a selected frame should show.
+ *
+ * - `"frame"`  plain frames (agent-created, manual): the full toolbar.
+ * - `"video"`  a video-generator frame holding a ready video: sizing, download,
+ *              campaign. No Resize or Template — both are image-only.
+ * - `null`     image-generator frames, and video-generator frames that are
+ *              empty, still generating, or holding a video the host could not
+ *              act on.
+ *
+ * A video counts as ready only when it is saved, has a URL, and that URL is not
+ * a blob: URL. That last condition is the same guard the in-video toolbar
+ * applies: a blob URL cannot be fetched server-side, so offering Download or
+ * Campaign on one would present an action that is guaranteed to fail.
+ */
+export declare const getFrameToolbarVariant: (frame: ExcalidrawFrameLikeElement, elements: ElementsMapOrArray) => FrameToolbarVariantResult | null;

package/dist/types/excalidraw/components/video/videoActions.d.ts

@@ -0,0 +1,37 @@
+import type { ExcalidrawVideoElement } from "@orangecatai/element/types";
+import type { AddToCampaignPayload } from "../../types";
+/**
+ * Video actions shared by the two surfaces that offer them: the in-video
+ * toolbar (`VideoElement`) and the video variant of `FrameToolbar`.
+ *
+ * These live here rather than in either component because the blob-URL rule
+ * below is easy to get wrong and impossible to notice when it drifts — a
+ * blob URL sent to the host surfaces as a server-side failure, not a visible
+ * client error.
+ */
+/**
+ * blob: URLs are local-preview-only. They are assigned while an upload is still
+ * in flight and are resolvable only in the tab that created them, so they must
+ * never be handed to the server — neither the download proxy nor the campaign
+ * copy step can fetch one.
+ */
+export declare const isBlobVideoUrl: (videoUrl: string | null) => boolean;
+/**
+ * Resolves the URL to use for `<video src>`. Routing through the proxy avoids
+ * presigned-URL expiry on long-lived canvases.
+ */
+export declare const resolveVideoPlaybackUrl: (videoUrl: string | null, videoDownloadProxyUrl?: string) => string | null;
+/** Triggers a browser download of the video file itself — never a canvas export. */
+export declare const downloadVideo: ({ videoUrl, mimeType, videoDownloadProxyUrl, }: {
+    videoUrl: string | null;
+    mimeType: ExcalidrawVideoElement["mimeType"];
+    videoDownloadProxyUrl?: string;
+}) => void;
+/**
+ * Builds the host payload for adding a video to a campaign.
+ * Returns null when the video is not in a state the host can accept, so callers
+ * can surface "not ready yet" instead of issuing a request that would fail.
+ */
+export declare const buildVideoCampaignPayload: (element: ExcalidrawVideoElement, campaignId: string) => Extract<AddToCampaignPayload, {
+    kind: "video";
+}> | null;

package/dist/types/excalidraw/index.d.ts

@@ -57,4 +57,5 @@ export type { AppState, BinaryFiles, BinaryFileData, ExcalidrawProps, Excalidraw
 export type { ExcalidrawElement, NonDeletedExcalidrawElement, NonDeleted, OrderedExcalidrawElement, ExcalidrawElementType, ExcalidrawVideoElement, } from "@orangecatai/element/types";
 export type { ImageEditToolbarCallbacks } from "./components/ImageEditToolbar";
 export type { CustomFontSpec, BrandContext } from "./types";
+export type { CampaignSummary, AddToCampaignPayload } from "./types";
 export type { ReviewerFeedback, ReviewIssue, } from "./components/ai-chat/reviewerAgent";

package/dist/types/excalidraw/types.d.ts

@@ -521,6 +521,38 @@ export type BrandContext = {
      */
     headlineFontUrl?: string;
 };
+/** A campaign the user can save a frame/video snapshot into. */
+export type CampaignSummary = {
+    id: string;
+    name: string;
+};
+/**
+ * Payload passed to `onAddToCampaign`. `image` carries a rendered PNG blob
+ * of the exported frame; `video` carries the video element's existing URL
+ * (the host copies the file server-side — it never round-trips the browser).
+ */
+export type AddToCampaignPayload = {
+    kind: "image";
+    campaignId: string;
+    blob: Blob;
+    mimeType: string;
+    width: number;
+    height: number;
+} | {
+    kind: "video";
+    campaignId: string;
+    videoUrl: string;
+    mimeType: string;
+    width: number;
+    height: number;
+    /**
+     * The video element's existing first-frame JPEG data URL, if it has one
+     * (`ExcalidrawVideoElement.thumbnailDataUrl`). The host decodes and
+     * stores this so the campaign preview never has to fall back to a
+     * generic placeholder for canvas-added videos.
+     */
+    thumbnailDataUrl?: string;
+};
 export interface ExcalidrawProps {
     onChange?: (elements: readonly OrderedExcalidrawElement[], appState: AppState, files: BinaryFiles) => void;
     onIncrement?: (event: DurableIncrement | EphemeralIncrement) => void;
@@ -675,6 +707,35 @@ export interface ExcalidrawProps {
     onAfterVideoGen?: () => void;
     /** Host proxy URL for video downloads — works around S3 CORS / presigned-URL expiry. */
     videoDownloadProxyUrl?: string;
+    /**
+     * Host proxy URL for the long-form video shot-splitting LLM call (POST).
+     * Body: `{ concept, segmentCount, segmentDurationSeconds }`. Response:
+     * `{ styleAnchor, segments }`. Without this prop, the "Long-form" chaining
+     * mode is not offered in the video generator panel.
+     */
+    videoPlanUrl?: string;
+    /**
+     * Fetches the user's campaigns for the "Add to campaign" dropdown on the
+     * frame toolbar and the video element toolbar. Without this prop, the
+     * campaign button is not rendered.
+     */
+    onFetchCampaigns?: () => Promise<{
+        campaigns: CampaignSummary[];
+    }>;
+    /**
+     * Creates a new campaign from the inline "New campaign" row in the
+     * dropdown. Returns the created campaign so the SDK can auto-select it.
+     */
+    onCreateCampaign?: (name: string) => Promise<CampaignSummary>;
+    /**
+     * Saves a snapshot of the selected frame (exported to PNG) or video
+     * element (by its existing URL) into the chosen campaign. This is a
+     * free action (no credit gate) since no AI call is involved.
+     */
+    onAddToCampaign?: (payload: AddToCampaignPayload) => Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
     /**
      * Called before a background removal is run (deduct credits, check quota).
      * Return `{ allowed: false, error: "..." }` to block the operation.