@slatesvideo/shared 0.6.10 → 0.7.0

package/dist/operations/index.d.ts

@@ -1,3 +1,4 @@
+import { type GuideDepth } from '../prompts/guide-retrieval.js';
 import { type GptQuality, type GptBackground } from '../prompts/model-capabilities.js';
 import { z } from 'zod';
 import { SlatesCloudClient } from '../clients/cloud.js';
@@ -81,10 +82,8 @@ export interface Operation<I> {
      * Which tier of the desktop tool surface this op belongs to.
      *
      * `core` is sent on every Studio Agent turn; `extended` is deferred behind
-     * `slates_load_tools` and appended to the tool list for the rest of the run
-     * once a group loads. The MCP server registers everything as before — hosts
-     * there do their own deferral (Claude Code defers stdio tool schemas through
-     * its tool search) and a stdio server has no run to append to.
+     * `slates_load_tools` and selected until the next named/group load
+     * on either surface. MCP keeps unlisted operations callable for older clients.
      *
      * Defaults to `core` when absent, so a new op is visible until someone
      * deliberately defers it.
@@ -103,7 +102,7 @@ export interface OperationAnnotations {
     openWorldHint: boolean;
 }
 export type OperationTier = 'core' | 'extended';
-export type OperationGroup = 'library' | 'timeline' | 'admin' | 'blender';
+export type OperationGroup = 'script' | 'library' | 'timeline' | 'admin' | 'blender';
 export declare const CONFIRM_CREDITS = 17;
 /**
  * The desktop deviation guard's ceiling multiplier: the Studio Agent pauses and
@@ -153,12 +152,61 @@ export declare const getWorkspaceState: Operation<{
     projectId?: string;
     limit?: number;
 }>;
+/**
+ * What the user has selected in the app RIGHT NOW. The selection band in every
+ * grid (images, clips, audio, storyboard shots) reports its ids to the desktop,
+ * and the image viewer reports what is open; the desktop looks codes and labels
+ * up at request time. Exists so "make these into videos" needs no codes typed.
+ */
+export declare const getSelection: Operation<Record<string, never>>;
+declare const VIEW_LENSES: readonly ["board", "media", "script"];
+declare const VIEW_CUT_SIDES: readonly ["bottom", "left", "right"];
+declare const VIEW_DOCK_SECTIONS: readonly ["storyboards", "library", "folders", "pinned"];
+type DockSection = (typeof VIEW_DOCK_SECTIONS)[number];
+/**
+ * How the Slates window is ARRANGED right now — which lens is showing, where
+ * the timeline sits, which side panels are open. Read it before rearranging
+ * anything, so you change one thing and leave the rest as the user had it.
+ */
+export declare const getView: Operation<Record<string, never>>;
+/**
+ * Rearrange the window. Every field is optional and only what you name moves,
+ * so parking the timeline does not also change the lens.
+ *
+ * 🚨 THE APP ANSWERS, NOT THE REQUEST. Sizes are clamped by the app's own
+ * rules and the reply reports what it settled on — ask for a 10px timeline and
+ * you are told 420, because that is what is on the user's screen. A window too
+ * small to show the timeline beside the board will not split at all; it shows
+ * the timeline full-screen instead, and says so.
+ */
+export declare const setView: Operation<{
+    lens?: (typeof VIEW_LENSES)[number];
+    cut?: {
+        open?: boolean;
+        full?: boolean;
+        side?: (typeof VIEW_CUT_SIDES)[number];
+        height?: number;
+        width?: number;
+    };
+    leftDock?: {
+        open?: boolean;
+        width?: number;
+        folded?: DockSection[];
+    };
+    studioAgent?: {
+        open?: boolean;
+        width?: number;
+    };
+    script?: {
+        details?: boolean;
+    };
+}>;
 export declare const getMe: Operation<Record<string, never>>;
 export declare const getCreditBalance: Operation<Record<string, never>>;
 export declare const listAvailableModels: Operation<{
     filter?: string;
 }>;
-export declare const VIDEO_MODELS: readonly ["kling-v3.0-std", "kling-v3.0-pro", "kling-v3.0-omni", "veo-3.1-fast", "veo-3.1-standard", "seedance-2", "seedance-2.5", "omni-flash", "minimax-h3", "minimax-h3-max", "ltx-2-5", "ltx-2-5-pro"];
+export declare const VIDEO_MODELS: readonly ["kling-v3.0-std", "kling-v3.0-pro", "kling-v3.0-omni", "veo-3.1-fast", "veo-3.1-standard", "seedance-2", "seedance-2.5", "omni-flash", "minimax-h3", "minimax-h3-max", "minimax-h3-max-turbo", "ltx-2-5", "ltx-2-5-pro"];
 type VideoModel = (typeof VIDEO_MODELS)[number];
 /** The exact `model` ids `slates_edit_video` accepts. Edit rows are deliberately
  *  NOT in VIDEO_MODELS — they take a source clip, not frames. */
@@ -208,6 +256,28 @@ export declare const getAssetVideoFrames: Operation<{
     id: string;
     count?: number;
 }>;
+export declare const getChatGptStatus: Operation<Record<string, never>>;
+export declare const connectChatGpt: Operation<Record<string, never>>;
+export declare const generateChatGptImage: Operation<{
+    projectId: string;
+    requestId: string;
+    prompt: string;
+    aspectRatio?: string;
+    referenceAssetIds?: string[];
+    background?: boolean;
+}>;
+export declare const saveExternalImage: Operation<{
+    projectId: string;
+    filePath?: string;
+    dataUrl?: string;
+    assetId?: string;
+    prompt: string;
+    generator: string;
+    model?: string;
+    negativePrompt?: string;
+    referenceAssetIds?: string[];
+    requestedSettings?: Record<string, string | number | boolean>;
+}>;
 export declare const uploadReferenceImage: Operation<{
     projectId: string;
     filePath?: string;
@@ -225,6 +295,25 @@ export declare const moveAssetsToFolder: Operation<{
     assetIds: string[];
     folderId: string | null;
 }>;
+export declare const setAssetFavorite: Operation<{
+    assetId: string;
+    favorite: boolean;
+}>;
+export declare const exportAssets: Operation<{
+    assetIds: string[];
+    directory: string;
+}>;
+export declare const listPins: Operation<{
+    projectId: string;
+}>;
+export declare const pinReferences: Operation<{
+    projectId: string;
+    assetIds: string[];
+}>;
+export declare const unpinReference: Operation<{
+    projectId: string;
+    assetId: string;
+}>;
 export declare const moveAssetsToProject: Operation<{
     sourceProjectId: string;
     assetIds: string[];
@@ -236,7 +325,7 @@ export declare const copyAssetsToProject: Operation<{
     targetProjectId: string;
 }>;
 export declare const moveEntityToProject: Operation<{
-    kind: 'character' | 'environment' | 'style';
+    kind?: 'library' | 'character' | 'environment' | 'style';
     entityId: string;
     targetProjectId: string;
 }>;
@@ -520,11 +609,56 @@ export declare const listGenerations: Operation<{
     status?: 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled';
     limit?: number;
 }>;
+declare const exportCutsInput: z.ZodObject<{
+    projectId: z.ZodString;
+    directory: z.ZodString;
+    manifestId: z.ZodString;
+    action: z.ZodOptional<z.ZodEnum<["start", "status", "cancel"]>>;
+    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        timelineId: z.ZodString;
+        format: z.ZodEnum<["mp4", "xml"]>;
+    }, "strip", z.ZodTypeAny, {
+        timelineId: string;
+        format: "mp4" | "xml";
+    }, {
+        timelineId: string;
+        format: "mp4" | "xml";
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    directory: string;
+    manifestId: string;
+    action?: "start" | "status" | "cancel" | undefined;
+    items?: {
+        timelineId: string;
+        format: "mp4" | "xml";
+    }[] | undefined;
+}, {
+    projectId: string;
+    directory: string;
+    manifestId: string;
+    action?: "start" | "status" | "cancel" | undefined;
+    items?: {
+        timelineId: string;
+        format: "mp4" | "xml";
+    }[] | undefined;
+}>;
+export declare const exportCuts: Operation<z.infer<typeof exportCutsInput>>;
+export declare const listTimelines: Operation<{
+    projectId: string;
+}>;
+export declare const saveTimeline: Operation<{
+    projectId: string;
+    timelineId?: string;
+    name: string;
+}>;
 export declare const getTimeline: Operation<{
     projectId: string;
+    timelineId?: string;
 }>;
 export declare const addClipToTimeline: Operation<{
     projectId: string;
+    timelineId?: string;
     assetId: string;
     trackId?: string;
     startFrame?: number;
@@ -538,8 +672,18 @@ export declare const reorderClips: Operation<{
 export declare const removeClip: Operation<{
     clipId: string;
 }>;
+export declare const manageTimelineMarker: Operation<{
+    action: 'create' | 'update' | 'delete';
+    projectId: string;
+    timelineId?: string;
+    markerId?: string;
+    frame?: number;
+    name?: string;
+    color?: string;
+}>;
 export declare const addTimelineTrack: Operation<{
     projectId: string;
+    timelineId?: string;
     type?: 'video' | 'audio';
     name?: string;
 }>;
@@ -557,6 +701,7 @@ export declare const removeTimelineTrack: Operation<{
 }>;
 export declare const updateTimelineSettings: Operation<{
     projectId: string;
+    timelineId?: string;
     width?: number;
     height?: number;
     frameRate?: 24 | 30 | 60;
@@ -589,6 +734,12 @@ export declare const deleteProject: Operation<{
 export declare const getProjectDirectory: Operation<{
     id: string;
 }>;
+export declare const relocateProject: Operation<{
+    id: string;
+}>;
+export declare const undoRelocateProject: Operation<{
+    id: string;
+}>;
 export declare const deleteAsset: Operation<{
     id: string;
 }>;
@@ -640,6 +791,66 @@ export declare const updateStyle: Operation<{
 export declare const deleteStyle: Operation<{
     styleId: string;
 }>;
+export declare const listLibrary: Operation<{
+    projectId: string;
+}>;
+export declare const createLibraryItem: Operation<{
+    projectId: string;
+    categoryId: string;
+    name: string;
+    description?: string;
+    style?: string;
+    imageAssetId?: string;
+}>;
+export declare const updateLibraryItem: Operation<{
+    projectId: string;
+    itemId: string;
+    name?: string;
+    description?: string;
+    style?: string;
+    categoryId?: string;
+    retagShots?: boolean;
+    imageAssetId?: string | null;
+    voiceAssetId?: string | null;
+}>;
+export declare const deleteLibraryItem: Operation<{
+    itemId: string;
+}>;
+export declare const manageLibraryCategory: Operation<{
+    action: 'create' | 'rename' | 'set-behaviour' | 'reorder' | 'delete';
+    projectId?: string;
+    categoryId?: string;
+    name?: string;
+    kind?: 'thing' | 'look';
+    template?: 'person' | 'location' | null;
+    retagShots?: boolean;
+    orderedIds?: string[];
+}>;
+export declare const copyLibraryItemToProject: Operation<{
+    itemId: string;
+    targetProjectId: string;
+}>;
+export declare const getTemplate: Operation<{
+    path?: string;
+}>;
+export declare const exportTemplate: Operation<{
+    projectId: string;
+    path: string;
+    storyboardId?: string;
+    sceneId?: string;
+    shotId?: string;
+    name?: string;
+    description?: string;
+}>;
+export declare const importTemplate: Operation<{
+    projectId: string;
+    path: string;
+    sceneIndices?: number[];
+    storyboardId?: string;
+    sceneId?: string;
+    swaps?: Record<string, string>;
+    useTemplateCategories?: boolean;
+}>;
 export declare const updateStoryboard: Operation<{
     storyboardId: string;
     name?: string;
@@ -695,6 +906,8 @@ export declare const deleteFrame: Operation<{
     frameId: string;
 }>;
 interface ShotOpScript {
+    recipeMode?: 'script' | 'custom';
+    promptScriptLine?: string | null;
     speaker?: string | null;
     line?: string | null;
     delivery?: string | null;
@@ -713,7 +926,7 @@ interface ShotOpRefs {
     environmentIds?: string[];
     styleIds?: string[];
 }
-type ShotOpParams = Pick<ShotParams, 'aspectRatio' | 'duration' | 'videoResolution' | 'imageResolution' | 'gptQuality' | 'imageQuantity' | 'negativePrompt' | 'sound' | 'seedanceFace' | 'audioDurationSeconds' | 'voiceId' | 'voiceReferenceAssetId' | 'voiceDescription'> & {
+type ShotOpParams = Omit<ShotParams, 'aspectRatio' | 'videoResolution' | 'imageResolution'> & {
     aspectRatio?: AspectRatio;
     videoResolution?: VideoResolution;
     imageResolution?: '1k' | '2k' | '3k' | '4k';
@@ -726,6 +939,8 @@ export declare const createShot: Operation<ShotOpRefs & ShotOpScript & {
     params?: ShotOpParams;
     frameId?: string;
     sceneId?: string;
+    storyboardId?: string;
+    position?: number;
 }>;
 export declare const updateShot: Operation<ShotOpRefs & ShotOpScript & {
     shotId: string;
@@ -773,31 +988,617 @@ export declare const splitShot: Operation<{
     shotId: string;
     caret?: number;
 }>;
+export declare const splitTake: Operation<{
+    shotId: string;
+    assetId: string;
+    sceneId?: string;
+    position?: number;
+    name?: string;
+}>;
+export declare const refileTake: Operation<{
+    assetId: string;
+    fromShotId?: string | null;
+    toShotId: string;
+}>;
 export declare const mergeShots: Operation<{
     firstId: string;
     secondId: string;
 }>;
+export declare const getScript: Operation<{
+    sceneId: string;
+}>;
+declare const variationSchema: z.ZodObject<{
+    storyboardId: z.ZodString;
+    expectedRevision: z.ZodNumber;
+    name: z.ZodString;
+    choices: z.ZodArray<z.ZodObject<{
+        sectionId: z.ZodString;
+        alternativeId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        sectionId: string;
+        alternativeId: string;
+    }, {
+        sectionId: string;
+        alternativeId: string;
+    }>, "many">;
+    arrangement: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        sectionId: z.ZodString;
+        alternativeId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        sectionId: string;
+        alternativeId: string;
+    }, {
+        sectionId: string;
+        alternativeId: string;
+    }>, "many">>;
+    itemOverrides: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        voice: z.ZodEnum<["keep", "replace"]>;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+        voice: "keep" | "replace";
+    }, {
+        from: string;
+        to: string;
+        voice: "keep" | "replace";
+    }>, "many">>;
+    assetOverrides: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+    }, {
+        from: string;
+        to: string;
+    }>, "many">>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    storyboardId: string;
+    expectedRevision: number;
+    name: string;
+    choices: {
+        sectionId: string;
+        alternativeId: string;
+    }[];
+    arrangement?: {
+        sectionId: string;
+        alternativeId: string;
+    }[] | undefined;
+    itemOverrides?: {
+        from: string;
+        to: string;
+        voice: "keep" | "replace";
+    }[] | undefined;
+    assetOverrides?: {
+        from: string;
+        to: string;
+    }[] | undefined;
+    idempotencyKey?: string | undefined;
+}, {
+    storyboardId: string;
+    expectedRevision: number;
+    name: string;
+    choices: {
+        sectionId: string;
+        alternativeId: string;
+    }[];
+    arrangement?: {
+        sectionId: string;
+        alternativeId: string;
+    }[] | undefined;
+    itemOverrides?: {
+        from: string;
+        to: string;
+        voice: "keep" | "replace";
+    }[] | undefined;
+    assetOverrides?: {
+        from: string;
+        to: string;
+    }[] | undefined;
+    idempotencyKey?: string | undefined;
+}>;
+export declare const previewScriptVariation: Operation<z.infer<typeof variationSchema>>;
+export declare const createScriptVariation: Operation<z.infer<typeof variationSchema>>;
+export declare const getScriptUses: Operation<{
+    sectionId: string;
+}>;
+export declare const getShotInputs: Operation<{
+    projectId: string;
+    shotId: string;
+}>;
+export declare const reuseShotTake: Operation<{
+    projectId: string;
+    shotId: string;
+    assetId: string;
+}>;
+export declare const getScriptSections: Operation<{
+    storyboardId: string;
+}>;
+declare const sectionInput: z.ZodObject<{
+    storyboardId: z.ZodString;
+    expectedRevision: z.ZodNumber;
+    action: z.ZodEnum<["create", "alternative", "choose", "save", "reuse", "updateUses", "rename", "archive", "tags"]>;
+    sectionId: z.ZodOptional<z.ZodString>;
+    alternativeId: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    target: z.ZodOptional<z.ZodObject<{
+        sceneId: z.ZodString;
+        at: z.ZodNumber;
+        expectedRevision: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        at: number;
+        expectedRevision: number;
+        sceneId: string;
+    }, {
+        at: number;
+        expectedRevision: number;
+        sceneId: string;
+    }>>;
+    uses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        sectionId: z.ZodString;
+        expectedRevision: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        expectedRevision: number;
+        sectionId: string;
+    }, {
+        expectedRevision: number;
+        sectionId: string;
+    }>, "many">>;
+    fragments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        sceneId: z.ZodString;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        start: number;
+        sceneId: string;
+        end: number;
+    }, {
+        start: number;
+        sceneId: string;
+        end: number;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    action: "create" | "alternative" | "choose" | "save" | "reuse" | "updateUses" | "rename" | "archive" | "tags";
+    storyboardId: string;
+    expectedRevision: number;
+    sectionId?: string | undefined;
+    alternativeId?: string | undefined;
+    tags?: string[] | undefined;
+    parentId?: string | undefined;
+    label?: string | undefined;
+    target?: {
+        at: number;
+        expectedRevision: number;
+        sceneId: string;
+    } | undefined;
+    uses?: {
+        expectedRevision: number;
+        sectionId: string;
+    }[] | undefined;
+    fragments?: {
+        start: number;
+        sceneId: string;
+        end: number;
+    }[] | undefined;
+}, {
+    action: "create" | "alternative" | "choose" | "save" | "reuse" | "updateUses" | "rename" | "archive" | "tags";
+    storyboardId: string;
+    expectedRevision: number;
+    sectionId?: string | undefined;
+    alternativeId?: string | undefined;
+    tags?: string[] | undefined;
+    parentId?: string | undefined;
+    label?: string | undefined;
+    target?: {
+        at: number;
+        expectedRevision: number;
+        sceneId: string;
+    } | undefined;
+    uses?: {
+        expectedRevision: number;
+        sectionId: string;
+    }[] | undefined;
+    fragments?: {
+        start: number;
+        sceneId: string;
+        end: number;
+    }[] | undefined;
+}>;
+export declare const changeScriptSection: Operation<z.infer<typeof sectionInput>>;
+export declare const getScriptSuggestions: Operation<{
+    storyboardId: string;
+}>;
+declare const suggestionInput: z.ZodObject<{
+    storyboardId: z.ZodString;
+    expectedRevision: z.ZodNumber;
+    action: z.ZodEnum<["create", "accept", "dismiss"]>;
+    suggestions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        sceneId: z.ZodString;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        original: z.ZodString;
+        replacement: z.ZodString;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        start: number;
+        sceneId: string;
+        end: number;
+        original: string;
+        replacement: string;
+        note?: string | undefined;
+    }, {
+        start: number;
+        sceneId: string;
+        end: number;
+        original: string;
+        replacement: string;
+        note?: string | undefined;
+    }>, "many">>;
+    suggestionId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    action: "create" | "accept" | "dismiss";
+    storyboardId: string;
+    expectedRevision: number;
+    suggestions?: {
+        start: number;
+        sceneId: string;
+        end: number;
+        original: string;
+        replacement: string;
+        note?: string | undefined;
+    }[] | undefined;
+    suggestionId?: string | undefined;
+}, {
+    action: "create" | "accept" | "dismiss";
+    storyboardId: string;
+    expectedRevision: number;
+    suggestions?: {
+        start: number;
+        sceneId: string;
+        end: number;
+        original: string;
+        replacement: string;
+        note?: string | undefined;
+    }[] | undefined;
+    suggestionId?: string | undefined;
+}>;
+export declare const changeScriptSuggestions: Operation<z.infer<typeof suggestionInput>>;
+export declare const getScriptDocument: Operation<{
+    storyboardId: string;
+}>;
+declare const writeScriptDocumentInput: z.ZodObject<{
+    storyboardId: z.ZodString;
+    expectedRevision: z.ZodNumber;
+    edits: z.ZodArray<z.ZodObject<{
+        sceneId: z.ZodString;
+        at: z.ZodNumber;
+        removed: z.ZodNumber;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        at: number;
+        sceneId: string;
+        removed: number;
+        text: string;
+    }, {
+        at: number;
+        sceneId: string;
+        removed: number;
+        text: string;
+    }>, "many">;
+    structures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        sceneId: z.ZodString;
+        blocks: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<["paragraph", "heading", "direction"]>;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            label: z.ZodOptional<z.ZodString>;
+            level: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+            marks: z.ZodArray<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+                type: z.ZodEnum<["strong", "em"]>;
+            }, "strip", z.ZodTypeAny, {
+                start: number;
+                type: "strong" | "em";
+                end: number;
+            }, {
+                start: number;
+                type: "strong" | "em";
+                end: number;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            start: number;
+            end: number;
+            id: string;
+            kind: "paragraph" | "heading" | "direction";
+            marks: {
+                start: number;
+                type: "strong" | "em";
+                end: number;
+            }[];
+            label?: string | undefined;
+            level?: 3 | 2 | undefined;
+        }, {
+            start: number;
+            end: number;
+            id: string;
+            kind: "paragraph" | "heading" | "direction";
+            marks: {
+                start: number;
+                type: "strong" | "em";
+                end: number;
+            }[];
+            label?: string | undefined;
+            level?: 3 | 2 | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        sceneId: string;
+        blocks: {
+            start: number;
+            end: number;
+            id: string;
+            kind: "paragraph" | "heading" | "direction";
+            marks: {
+                start: number;
+                type: "strong" | "em";
+                end: number;
+            }[];
+            label?: string | undefined;
+            level?: 3 | 2 | undefined;
+        }[];
+    }, {
+        sceneId: string;
+        blocks: {
+            start: number;
+            end: number;
+            id: string;
+            kind: "paragraph" | "heading" | "direction";
+            marks: {
+                start: number;
+                type: "strong" | "em";
+                end: number;
+            }[];
+            label?: string | undefined;
+            level?: 3 | 2 | undefined;
+        }[];
+    }>, "many">>;
+    move: z.ZodOptional<z.ZodObject<{
+        sceneId: z.ZodString;
+        blockId: z.ZodString;
+        delta: z.ZodUnion<[z.ZodLiteral<-1>, z.ZodLiteral<1>]>;
+    }, "strip", z.ZodTypeAny, {
+        sceneId: string;
+        blockId: string;
+        delta: 1 | -1;
+    }, {
+        sceneId: string;
+        blockId: string;
+        delta: 1 | -1;
+    }>>;
+    makeShots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        sceneId: z.ZodString;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        waitingShotId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        start: number;
+        sceneId: string;
+        end: number;
+        waitingShotId?: string | undefined;
+    }, {
+        start: number;
+        sceneId: string;
+        end: number;
+        waitingShotId?: string | undefined;
+    }>, "many">>;
+    restoreRevision: z.ZodOptional<z.ZodNumber>;
+    ensureScene: z.ZodOptional<z.ZodBoolean>;
+    sceneAction: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"split">;
+        sceneId: z.ZodString;
+        at: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        at: number;
+        sceneId: string;
+        kind: "split";
+    }, {
+        at: number;
+        sceneId: string;
+        kind: "split";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"merge">;
+        sceneId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        sceneId: string;
+        kind: "merge";
+    }, {
+        sceneId: string;
+        kind: "merge";
+    }>]>>;
+}, "strip", z.ZodTypeAny, {
+    storyboardId: string;
+    expectedRevision: number;
+    edits: {
+        at: number;
+        sceneId: string;
+        removed: number;
+        text: string;
+    }[];
+    structures?: {
+        sceneId: string;
+        blocks: {
+            start: number;
+            end: number;
+            id: string;
+            kind: "paragraph" | "heading" | "direction";
+            marks: {
+                start: number;
+                type: "strong" | "em";
+                end: number;
+            }[];
+            label?: string | undefined;
+            level?: 3 | 2 | undefined;
+        }[];
+    }[] | undefined;
+    move?: {
+        sceneId: string;
+        blockId: string;
+        delta: 1 | -1;
+    } | undefined;
+    makeShots?: {
+        start: number;
+        sceneId: string;
+        end: number;
+        waitingShotId?: string | undefined;
+    }[] | undefined;
+    restoreRevision?: number | undefined;
+    ensureScene?: boolean | undefined;
+    sceneAction?: {
+        at: number;
+        sceneId: string;
+        kind: "split";
+    } | {
+        sceneId: string;
+        kind: "merge";
+    } | undefined;
+}, {
+    storyboardId: string;
+    expectedRevision: number;
+    edits: {
+        at: number;
+        sceneId: string;
+        removed: number;
+        text: string;
+    }[];
+    structures?: {
+        sceneId: string;
+        blocks: {
+            start: number;
+            end: number;
+            id: string;
+            kind: "paragraph" | "heading" | "direction";
+            marks: {
+                start: number;
+                type: "strong" | "em";
+                end: number;
+            }[];
+            label?: string | undefined;
+            level?: 3 | 2 | undefined;
+        }[];
+    }[] | undefined;
+    move?: {
+        sceneId: string;
+        blockId: string;
+        delta: 1 | -1;
+    } | undefined;
+    makeShots?: {
+        start: number;
+        sceneId: string;
+        end: number;
+        waitingShotId?: string | undefined;
+    }[] | undefined;
+    restoreRevision?: number | undefined;
+    ensureScene?: boolean | undefined;
+    sceneAction?: {
+        at: number;
+        sceneId: string;
+        kind: "split";
+    } | {
+        sceneId: string;
+        kind: "merge";
+    } | undefined;
+}>;
+export declare const writeScriptDocument: Operation<z.infer<typeof writeScriptDocumentInput>>;
+export declare const editScript: Operation<{
+    sceneId: string;
+    at: number;
+    removed: number;
+    text: string;
+    rev?: string;
+    expectedRevision?: number;
+}>;
+export declare const makeShotFromScript: Operation<{
+    sceneId: string;
+    start: number;
+    end: number;
+    waitingShotId?: string | null;
+    perParagraph?: boolean;
+}>;
+export declare const breakScriptIntoShots: Operation<{
+    storyboardId?: string;
+    sceneId?: string;
+}>;
+export declare const splitScene: Operation<{
+    sceneId: string;
+    lineStart: number;
+    lineEnd: number;
+    name?: string | null;
+}>;
+export declare const mergeScene: Operation<{
+    sceneId: string;
+}>;
+export declare const pasteScript: Operation<{
+    storyboardId?: string;
+    sceneId?: string | null;
+    text: string;
+    at?: number;
+}>;
 export declare const generateFromShots: Operation<{
     shotIds: string[];
     confirm?: boolean;
+    fingerprint?: string;
+    draft?: {
+        model?: ImageModelId;
+    };
 }>;
+export declare const quoteBoard: Operation<{
+    projectId: string;
+    storyboardId?: string;
+    sceneId?: string;
+    shotIds?: string[];
+    missingOnly?: boolean;
+    draft?: {
+        model?: ImageModelId;
+    };
+}>;
+export declare const getBoardProgress: Operation<{
+    projectId: string;
+}>;
+export declare const editCut: Operation<{
+    projectId: string;
+    timelineId?: string;
+    action: 'changes' | 'replace' | 'sync' | 'build' | 'restore' | 'undo-build';
+    storyboardId?: string;
+    clipId?: string;
+    assetId?: string;
+    before?: Record<string, unknown>[];
+    clipIds?: string[];
+    markerIds?: string[];
+    skipPresent?: boolean;
+}>;
+export declare function resolveGuideTopic(topic: string): string | null;
 export declare const getPromptingGuide: Operation<{
     topic: string;
-    depth?: 'card' | 'full';
+    depth?: GuideDepth;
     query?: string;
 }>;
 /**
  * The one op that changes what OTHER ops are visible.
  *
  * 🚨 IT EXISTS BECAUSE THE SURFACE IS 112 KB AND EVERY TURN PAYS FOR ALL OF IT.
- * The desktop Studio Agent sends `core` plus this; a group arrives when the
- * work needs it and stays for the rest of the run. On the MCP surface every op
- * is registered up front (a stdio server has no run to append to), so this
- * returns the same definitions as a plain listing — useful either way, since
- * it is also how an agent asks "what else can you do".
+ * Both surfaces start with the shared core set. Search returns compact metadata;
+ * names/group returns exact schemas and replaces the optional selection.
  */
 export declare const loadTools: Operation<{
-    group: OperationGroup;
+    group?: OperationGroup;
+    query?: string;
+    names?: string[];
 }>;
 export declare const blenderStatus: Operation<Record<string, never>>;
 export declare const blenderExecute: Operation<{
@@ -823,5 +1624,5 @@ export declare const blenderRenderBlocking: Operation<{
     basename?: string;
 }>;
 export declare const ALL_OPERATIONS: ReadonlyArray<Operation<unknown>>;
-export { toolDefinitions, toolDefinition, groupFor, tierFor, OPERATION_GROUPS, GROUP_SUMMARY, type ToolDefinition } from './surface.js';
+export { toolDefinitions, toolDefinition, groupFor, tierFor, OPERATION_GROUPS, GROUP_SUMMARY, type ToolDefinition, STARTUP_TOOL_IDS } from './surface.js';
 //# sourceMappingURL=index.d.ts.map