@slatesvideo/shared 0.7.1 → 0.7.3

package/dist/operations/index.d.ts

@@ -159,9 +159,25 @@ export declare const getWorkspaceState: Operation<{
  * up at request time. Exists so "make these into videos" needs no codes typed.
  */
 export declare const getSelection: Operation<Record<string, never>>;
+declare const SELECTION_TARGETS: readonly ["media", "board"];
+declare const SELECTION_MODES: readonly ["replace", "add", "remove", "clear", "all"];
+/**
+ * SET what is selected, as the user's clicks do: the cards ticked in Media, the Shots ticked on the Board.
+ * Pairs with `slates_get_selection`, which reads it: "tick the shots with no clip, then price them" is this op
+ * and then the quote. The desktop applies it through the stores the grids write and answers with what SETTLED.
+ */
+export declare const setSelection: Operation<{
+    surface: (typeof SELECTION_TARGETS)[number];
+    mode: (typeof SELECTION_MODES)[number];
+    ids?: string[];
+}>;
 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"];
+declare const VIEW_BOARD_LEVELS: readonly ["film", "scenes", "shot"];
+declare const VIEW_BOARD_FILTERS: readonly ["all", "with-clip", "without-clip"];
+declare const VIEW_MEDIA_TABS: readonly ["all", "images", "videos", "audio"];
+declare const VIEW_SETTINGS_PANES: readonly ["account", "ai", "storage", "logs", "general", "keys"];
 type DockSection = (typeof VIEW_DOCK_SECTIONS)[number];
 /**
  * How the Slates window is ARRANGED right now — which lens is showing, where
@@ -180,6 +196,7 @@ export declare const getView: Operation<Record<string, never>>;
  * the timeline full-screen instead, and says so.
  */
 export declare const setView: Operation<{
+    projectId?: string | null;
     lens?: (typeof VIEW_LENSES)[number];
     cut?: {
         open?: boolean;
@@ -187,6 +204,7 @@ export declare const setView: Operation<{
         side?: (typeof VIEW_CUT_SIDES)[number];
         height?: number;
         width?: number;
+        timelineId?: string;
     };
     leftDock?: {
         open?: boolean;
@@ -199,14 +217,151 @@ export declare const setView: Operation<{
     };
     script?: {
         details?: boolean;
+        textScale?: number;
+        panelShotId?: string | null;
+    };
+    board?: {
+        id?: string;
+        sceneId?: string;
+        level?: (typeof VIEW_BOARD_LEVELS)[number];
+        cardWidth?: number;
+        filter?: (typeof VIEW_BOARD_FILTERS)[number];
+        linkedClips?: boolean;
+        scriptFollowsDrag?: boolean;
+        collapsedSceneIds?: string[];
+    };
+    media?: {
+        tab?: (typeof VIEW_MEDIA_TABS)[number];
+        folderId?: string | null;
+        unfiledOnly?: boolean;
+        search?: string;
+        favoritesOnly?: boolean;
+        linkedOnly?: boolean;
+        rounds?: boolean;
+        cardSize?: number;
+        revealAssetId?: string;
+    };
+    library?: {
+        categoryId: string | null;
+    };
+    viewer?: {
+        assetId: string | null;
+    };
+    compare?: {
+        open?: boolean;
+        assetIds?: string[];
+    };
+    animatic?: {
+        open: boolean;
+        fromShotId?: string;
+    };
+    settings?: {
+        open: boolean;
+        pane?: (typeof VIEW_SETTINGS_PANES)[number];
+    };
+    composer?: {
+        open: boolean;
+    };
+}>;
+/**
+ * SHOW AND POINT (1.6.1). The manual's pictures and a ring around a live control, so an agent can
+ * answer "where is it?" with the thing itself instead of a paragraph. Neither changes the project or
+ * the view. The pictures come from the INSTALLED app (it ships them), so they show the user's version;
+ * the public URL is for a client that renders only links. Decisions 13-16 in second-brain
+ * plans/2026-09-30-slates-manual-for-llms-1-6-1-decisions.md.
+ */
+export declare const getManualPicture: Operation<{
+    id?: string;
+}>;
+export declare const highlightControl: Operation<{
+    target?: string;
+    caption?: string;
+    list?: boolean;
+}>;
+export declare const getComposer: Operation<Record<string, never>>;
+export declare const setComposer: Operation<{
+    projectId?: string;
+    bindShotId?: string | null;
+    clear?: boolean;
+    restoreDraft?: boolean;
+    restoreSetup?: boolean;
+    fromAssetId?: string;
+    editSourceAssetId?: string;
+    lane?: 'image' | 'video' | 'audio';
+    model?: string;
+    prompt?: string;
+    addMentions?: string[];
+    attach?: Array<{
+        assetId: string;
+        role?: string;
+    }>;
+    detach?: string[];
+    setRole?: Array<{
+        assetId: string;
+        role: string;
+    }>;
+    params?: Record<string, string | number | boolean>;
+    voice?: {
+        presetId: string;
+    } | {
+        clipAssetId: string;
+    } | {
+        description: string;
+    };
+    tool?: {
+        sourceAssetId?: string | null;
+        speechText?: string;
+        drivingVideoAssetId?: string | null;
+        characterImageAssetId?: string | null;
     };
 }>;
+/**
+ * AGENT PARITY (1.6.1): what a user could do in the window and an agent could not. Each calls a desktop
+ * route that runs the window's own function (`slate/src/main/agent/routes-parity.ts`). Plan step 5b,
+ * second-brain plans/2026-09-30-slates-manual-for-llms-1-6-1.md.
+ */
+export declare const reorderFolders: Operation<{
+    projectId: string;
+    folderIds: string[];
+}>;
+export declare const reorderPins: Operation<{
+    projectId: string;
+    assetIds: string[];
+}>;
+export declare const getUsage: Operation<{
+    period?: 'week' | 'month' | 'all';
+}>;
+export declare const getAppSettings: Operation<Record<string, never>>;
+type AppSettingsPatch = {
+    newProjectLens?: 'media' | 'script' | 'board';
+    chatGptImagesEnabled?: boolean;
+    studioAgentHost?: 'slates' | 'codex' | 'claude';
+    studioAgentCodexModel?: string;
+    studioAgentCodexEffort?: string;
+    studioAgentClaudeModel?: string;
+    studioAgentClaudeEffort?: string;
+};
+export declare const setAppSettings: Operation<AppSettingsPatch>;
+export declare const getAsset: Operation<{
+    projectId: string;
+    assetId: string;
+}>;
+export declare const linkAssetSource: Operation<{
+    projectId: string;
+    assetId: string;
+    imageAssetId: string | null;
+}>;
+export declare const extractVideoFrame: Operation<{
+    projectId: string;
+    assetId: string;
+    at?: 'first' | 'last' | number;
+}>;
 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", "minimax-h3-max-turbo", "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", "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. */
@@ -265,6 +420,7 @@ export declare const generateChatGptImage: Operation<{
     aspectRatio?: string;
     referenceAssetIds?: string[];
     background?: boolean;
+    folderId?: string | null;
 }>;
 export declare const saveExternalImage: Operation<{
     projectId: string;
@@ -283,6 +439,7 @@ export declare const uploadReferenceImage: Operation<{
     filePath?: string;
     dataUrl?: string;
     type?: 'image' | 'video' | 'audio';
+    folderId?: string | null;
 }>;
 export declare const listFolders: Operation<{
     projectId: string;
@@ -435,6 +592,7 @@ export declare const generateImage: Operation<{
     referenceAssetIds?: string[];
     background?: boolean;
     confirm?: boolean;
+    folderId?: string | null;
 }>;
 export declare const editImage: Operation<{
     projectId: string;
@@ -449,6 +607,27 @@ export declare const editImage: Operation<{
     confirm?: boolean;
     background?: boolean;
 }>;
+/**
+ * The picture viewer's EXTRACT (its Cells tab): a 2x2 or 3x3 grid picture, cells cropped out and re-rendered
+ * at full resolution, each as its own new picture. BILLABLE, and priced by the DESKTOP: its quote is the
+ * `imageCost` the viewer's Extract button prints, for this seat, rung and cell count, so the price an agent
+ * is shown cannot differ from the button's. The confirm gate is every billable op's: above CONFIRM_CREDITS
+ * with no `confirm`, the op answers with the price and the exact prompt, and spends nothing.
+ */
+/** The seats the viewer's Cells box offers. Mirrors slate's `GRID_EXTRACT_MODELS` (`shared/prompts/storyboard-grids.ts`), which this package cannot import. */
+declare const GRID_EXTRACT_SEATS: readonly ["nano-banana-2", "flux-2-max", "seedream-5-lite"];
+export declare const extractGridCells: Operation<{
+    projectId: string;
+    assetId: string;
+    cells: string[];
+    model?: (typeof GRID_EXTRACT_SEATS)[number];
+    resolution?: '1k' | '2k' | '3k' | '4k';
+    aspectRatio?: string;
+    prompt?: string;
+    referenceAssetIds?: string[];
+    confirm?: boolean;
+    background?: boolean;
+}>;
 export declare function videoCostKey(input: {
     model: VideoModel;
     duration: number;
@@ -522,6 +701,7 @@ export declare const generateVideo: Operation<{
     negativePrompt?: string;
     background?: boolean;
     confirm?: boolean;
+    folderId?: string | null;
 }>;
 /**
  * AGENT PARITY for the voice picker. The desktop browses stock voices by
@@ -554,6 +734,7 @@ export declare const generateAudio: Operation<{
     imageReferenceAssetId?: string;
     background?: boolean;
     confirm?: boolean;
+    folderId?: string | null;
 }>;
 export declare const generateLipSync: Operation<{
     projectId: string;
@@ -593,12 +774,18 @@ export declare const editVideo: Operation<{
     seedanceFace?: boolean;
     background?: boolean;
     confirm?: boolean;
+    folderId?: string | null;
 }>;
 export declare const trimVideo: Operation<{
     projectId: string;
     assetId: string;
     inSec?: number;
     outSec: number;
+    pieces?: {
+        splitsAtSec?: number[];
+        longestSec?: number;
+        shareSec?: number;
+    };
 }>;
 export declare const getGenerationStatus: Operation<{
     generationId: string;
@@ -628,7 +815,7 @@ declare const exportCutsInput: z.ZodObject<{
     projectId: string;
     directory: string;
     manifestId: string;
-    action?: "status" | "start" | "cancel" | undefined;
+    action?: "start" | "status" | "cancel" | undefined;
     items?: {
         timelineId: string;
         format: "mp4" | "xml";
@@ -637,7 +824,7 @@ declare const exportCutsInput: z.ZodObject<{
     projectId: string;
     directory: string;
     manifestId: string;
-    action?: "status" | "start" | "cancel" | undefined;
+    action?: "start" | "status" | "cancel" | undefined;
     items?: {
         timelineId: string;
         format: "mp4" | "xml";
@@ -878,6 +1065,7 @@ export declare const updateFrame: Operation<{
     assetId?: string | null;
     sceneId?: string | null;
     position?: number;
+    preferredClipId?: string | null;
 }>;
 /**
  * Batch form of `slates_update_frame`.
@@ -900,6 +1088,7 @@ export declare const batchUpdateFrames: Operation<{
         assetId?: string | null;
         sceneId?: string | null;
         position?: number;
+        preferredClipId?: string | null;
     }[];
 }>;
 export declare const deleteFrame: Operation<{
@@ -934,7 +1123,8 @@ type ShotOpParams = Omit<ShotParams, 'aspectRatio' | 'videoResolution' | 'imageR
 export declare const createShot: Operation<ShotOpRefs & ShotOpScript & {
     projectId: string;
     name?: string;
-    prompt: string;
+    prompt?: string;
+    fromAssetId?: string;
     model?: string;
     params?: ShotOpParams;
     frameId?: string;
@@ -969,6 +1159,15 @@ export declare const listShots: Operation<{
 export declare const getShot: Operation<{
     shotId: string;
 }>;
+/**
+ * The Board's "Use pictures as first frames": each video Shot with a picture and no first frame starts its
+ * video from that picture. The desktop runs the command's own pick and write (`firstFrameCandidate`,
+ * `withFirstFrame`), so the recipe changes exactly as a click changes it. Free: nothing is generated.
+ */
+export declare const usePicturesAsFirstFrames: Operation<{
+    projectId: string;
+    shotIds?: string[];
+}>;
 /**
  * SPLIT and MERGE — the chop decision, and the only two cross-row operations on
  * this surface.
@@ -1036,13 +1235,13 @@ declare const variationSchema: z.ZodObject<{
         to: z.ZodString;
         voice: z.ZodEnum<["keep", "replace"]>;
     }, "strip", z.ZodTypeAny, {
-        voice: "replace" | "keep";
         from: string;
         to: string;
+        voice: "keep" | "replace";
     }, {
-        voice: "replace" | "keep";
         from: string;
         to: string;
+        voice: "keep" | "replace";
     }>, "many">>;
     assetOverrides: z.ZodOptional<z.ZodArray<z.ZodObject<{
         from: z.ZodString;
@@ -1056,9 +1255,9 @@ declare const variationSchema: z.ZodObject<{
     }>, "many">>;
     idempotencyKey: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    name: string;
     storyboardId: string;
     expectedRevision: number;
+    name: string;
     choices: {
         sectionId: string;
         alternativeId: string;
@@ -1068,9 +1267,9 @@ declare const variationSchema: z.ZodObject<{
         alternativeId: string;
     }[] | undefined;
     itemOverrides?: {
-        voice: "replace" | "keep";
         from: string;
         to: string;
+        voice: "keep" | "replace";
     }[] | undefined;
     assetOverrides?: {
         from: string;
@@ -1078,9 +1277,9 @@ declare const variationSchema: z.ZodObject<{
     }[] | undefined;
     idempotencyKey?: string | undefined;
 }, {
-    name: string;
     storyboardId: string;
     expectedRevision: number;
+    name: string;
     choices: {
         sectionId: string;
         alternativeId: string;
@@ -1090,9 +1289,9 @@ declare const variationSchema: z.ZodObject<{
         alternativeId: string;
     }[] | undefined;
     itemOverrides?: {
-        voice: "replace" | "keep";
         from: string;
         to: string;
+        voice: "keep" | "replace";
     }[] | undefined;
     assetOverrides?: {
         from: string;
@@ -1132,12 +1331,12 @@ declare const sectionInput: z.ZodObject<{
         expectedRevision: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
         at: number;
-        sceneId: string;
         expectedRevision: number;
+        sceneId: string;
     }, {
         at: number;
-        sceneId: string;
         expectedRevision: number;
+        sceneId: string;
     }>>;
     uses: z.ZodOptional<z.ZodArray<z.ZodObject<{
         sectionId: z.ZodString;
@@ -1154,59 +1353,59 @@ declare const sectionInput: z.ZodObject<{
         start: z.ZodNumber;
         end: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        end: number;
-        sceneId: string;
         start: number;
-    }, {
-        end: number;
         sceneId: string;
+        end: number;
+    }, {
         start: number;
+        sceneId: string;
+        end: number;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
-    action: "tags" | "create" | "rename" | "alternative" | "choose" | "save" | "reuse" | "updateUses" | "archive";
+    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;
-        sceneId: string;
         expectedRevision: number;
+        sceneId: string;
     } | undefined;
-    tags?: string[] | undefined;
-    sectionId?: string | undefined;
-    alternativeId?: string | undefined;
-    parentId?: string | undefined;
     uses?: {
         expectedRevision: number;
         sectionId: string;
     }[] | undefined;
     fragments?: {
-        end: number;
-        sceneId: string;
         start: number;
+        sceneId: string;
+        end: number;
     }[] | undefined;
 }, {
-    action: "tags" | "create" | "rename" | "alternative" | "choose" | "save" | "reuse" | "updateUses" | "archive";
+    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;
-        sceneId: string;
         expectedRevision: number;
+        sceneId: string;
     } | undefined;
-    tags?: string[] | undefined;
-    sectionId?: string | undefined;
-    alternativeId?: string | undefined;
-    parentId?: string | undefined;
     uses?: {
         expectedRevision: number;
         sectionId: string;
     }[] | undefined;
     fragments?: {
-        end: number;
-        sceneId: string;
         start: number;
+        sceneId: string;
+        end: number;
     }[] | undefined;
 }>;
 export declare const changeScriptSection: Operation<z.infer<typeof sectionInput>>;
@@ -1225,16 +1424,16 @@ declare const suggestionInput: z.ZodObject<{
         replacement: z.ZodString;
         note: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        end: number;
-        sceneId: string;
         start: number;
+        sceneId: string;
+        end: number;
         original: string;
         replacement: string;
         note?: string | undefined;
     }, {
-        end: number;
-        sceneId: string;
         start: number;
+        sceneId: string;
+        end: number;
         original: string;
         replacement: string;
         note?: string | undefined;
@@ -1245,9 +1444,9 @@ declare const suggestionInput: z.ZodObject<{
     storyboardId: string;
     expectedRevision: number;
     suggestions?: {
-        end: number;
-        sceneId: string;
         start: number;
+        sceneId: string;
+        end: number;
         original: string;
         replacement: string;
         note?: string | undefined;
@@ -1258,9 +1457,9 @@ declare const suggestionInput: z.ZodObject<{
     storyboardId: string;
     expectedRevision: number;
     suggestions?: {
-        end: number;
-        sceneId: string;
         start: number;
+        sceneId: string;
+        end: number;
         original: string;
         replacement: string;
         note?: string | undefined;
@@ -1281,14 +1480,14 @@ declare const writeScriptDocumentInput: z.ZodObject<{
         text: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         at: number;
-        text: string;
         sceneId: string;
         removed: number;
+        text: string;
     }, {
         at: number;
-        text: string;
         sceneId: string;
         removed: number;
+        text: string;
     }>, "many">;
     structures: z.ZodOptional<z.ZodArray<z.ZodObject<{
         sceneId: z.ZodString;
@@ -1304,68 +1503,68 @@ declare const writeScriptDocumentInput: z.ZodObject<{
                 end: z.ZodNumber;
                 type: z.ZodEnum<["strong", "em"]>;
             }, "strip", z.ZodTypeAny, {
-                end: number;
-                type: "strong" | "em";
                 start: number;
-            }, {
-                end: 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";
-            start: number;
             marks: {
-                end: number;
-                type: "strong" | "em";
                 start: number;
+                type: "strong" | "em";
+                end: number;
             }[];
-            label?: string | undefined;
             level?: 2 | 3 | undefined;
+            label?: string | undefined;
         }, {
+            start: number;
             end: number;
             id: string;
             kind: "paragraph" | "heading" | "direction";
-            start: number;
             marks: {
-                end: number;
-                type: "strong" | "em";
                 start: number;
+                type: "strong" | "em";
+                end: number;
             }[];
-            label?: string | undefined;
             level?: 2 | 3 | undefined;
+            label?: string | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         sceneId: string;
         blocks: {
+            start: number;
             end: number;
             id: string;
             kind: "paragraph" | "heading" | "direction";
-            start: number;
             marks: {
-                end: number;
-                type: "strong" | "em";
                 start: number;
+                type: "strong" | "em";
+                end: number;
             }[];
-            label?: string | undefined;
             level?: 2 | 3 | undefined;
+            label?: string | undefined;
         }[];
     }, {
         sceneId: string;
         blocks: {
+            start: number;
             end: number;
             id: string;
             kind: "paragraph" | "heading" | "direction";
-            start: number;
             marks: {
-                end: number;
-                type: "strong" | "em";
                 start: number;
+                type: "strong" | "em";
+                end: number;
             }[];
-            label?: string | undefined;
             level?: 2 | 3 | undefined;
+            label?: string | undefined;
         }[];
     }>, "many">>;
     move: z.ZodOptional<z.ZodObject<{
@@ -1387,14 +1586,14 @@ declare const writeScriptDocumentInput: z.ZodObject<{
         end: z.ZodNumber;
         waitingShotId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        end: number;
-        sceneId: string;
         start: number;
+        sceneId: string;
+        end: number;
         waitingShotId?: string | undefined;
     }, {
-        end: number;
-        sceneId: string;
         start: number;
+        sceneId: string;
+        end: number;
         waitingShotId?: string | undefined;
     }>, "many">>;
     restoreRevision: z.ZodOptional<z.ZodNumber>;
@@ -1405,45 +1604,45 @@ declare const writeScriptDocumentInput: z.ZodObject<{
         at: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
         at: number;
-        kind: "split";
         sceneId: string;
+        kind: "split";
     }, {
         at: number;
-        kind: "split";
         sceneId: string;
+        kind: "split";
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"merge">;
         sceneId: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        kind: "merge";
         sceneId: string;
-    }, {
         kind: "merge";
+    }, {
         sceneId: string;
+        kind: "merge";
     }>]>>;
 }, "strip", z.ZodTypeAny, {
     storyboardId: string;
     expectedRevision: number;
     edits: {
         at: number;
-        text: string;
         sceneId: string;
         removed: number;
+        text: string;
     }[];
     structures?: {
         sceneId: string;
         blocks: {
+            start: number;
             end: number;
             id: string;
             kind: "paragraph" | "heading" | "direction";
-            start: number;
             marks: {
-                end: number;
-                type: "strong" | "em";
                 start: number;
+                type: "strong" | "em";
+                end: number;
             }[];
-            label?: string | undefined;
             level?: 2 | 3 | undefined;
+            label?: string | undefined;
         }[];
     }[] | undefined;
     move?: {
@@ -1452,44 +1651,44 @@ declare const writeScriptDocumentInput: z.ZodObject<{
         delta: 1 | -1;
     } | undefined;
     makeShots?: {
-        end: number;
-        sceneId: string;
         start: number;
+        sceneId: string;
+        end: number;
         waitingShotId?: string | undefined;
     }[] | undefined;
     restoreRevision?: number | undefined;
     ensureScene?: boolean | undefined;
     sceneAction?: {
         at: number;
-        kind: "split";
         sceneId: string;
+        kind: "split";
     } | {
-        kind: "merge";
         sceneId: string;
+        kind: "merge";
     } | undefined;
 }, {
     storyboardId: string;
     expectedRevision: number;
     edits: {
         at: number;
-        text: string;
         sceneId: string;
         removed: number;
+        text: string;
     }[];
     structures?: {
         sceneId: string;
         blocks: {
+            start: number;
             end: number;
             id: string;
             kind: "paragraph" | "heading" | "direction";
-            start: number;
             marks: {
-                end: number;
-                type: "strong" | "em";
                 start: number;
+                type: "strong" | "em";
+                end: number;
             }[];
-            label?: string | undefined;
             level?: 2 | 3 | undefined;
+            label?: string | undefined;
         }[];
     }[] | undefined;
     move?: {
@@ -1498,20 +1697,20 @@ declare const writeScriptDocumentInput: z.ZodObject<{
         delta: 1 | -1;
     } | undefined;
     makeShots?: {
-        end: number;
-        sceneId: string;
         start: number;
+        sceneId: string;
+        end: number;
         waitingShotId?: string | undefined;
     }[] | undefined;
     restoreRevision?: number | undefined;
     ensureScene?: boolean | undefined;
     sceneAction?: {
         at: number;
-        kind: "split";
         sceneId: string;
+        kind: "split";
     } | {
-        kind: "merge";
         sceneId: string;
+        kind: "merge";
     } | undefined;
 }>;
 export declare const writeScriptDocument: Operation<z.infer<typeof writeScriptDocumentInput>>;
@@ -1584,16 +1783,15 @@ export declare const editCut: Operation<{
 }>;
 export declare function resolveGuideTopic(topic: string): string | null;
 export declare const getPromptingGuide: Operation<{
-    topic: string;
+    topic?: string;
     depth?: GuideDepth;
     query?: string;
+    limit?: number;
+    offset?: number;
 }>;
 /**
- * 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.
- * Both surfaces start with the shared core set. Search returns compact metadata;
- * names/group returns exact schemas and replaces the optional selection.
+ * Task discovery and exact schemas share one operation. The desktop uses
+ * names/group to replace its optional selection; MCP keeps its full list fixed.
  */
 export declare const loadTools: Operation<{
     group?: OperationGroup;