@slatesvideo/shared 0.7.0 → 0.7.1

package/dist/operations/index.d.ts

@@ -628,7 +628,7 @@ declare const exportCutsInput: z.ZodObject<{
     projectId: string;
     directory: string;
     manifestId: string;
-    action?: "start" | "status" | "cancel" | undefined;
+    action?: "status" | "start" | "cancel" | undefined;
     items?: {
         timelineId: string;
         format: "mp4" | "xml";
@@ -637,7 +637,7 @@ declare const exportCutsInput: z.ZodObject<{
     projectId: string;
     directory: string;
     manifestId: string;
-    action?: "start" | "status" | "cancel" | undefined;
+    action?: "status" | "start" | "cancel" | undefined;
     items?: {
         timelineId: string;
         format: "mp4" | "xml";
@@ -1036,13 +1036,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 +1056,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 +1068,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 +1078,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 +1090,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 +1132,12 @@ declare const sectionInput: z.ZodObject<{
         expectedRevision: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
         at: number;
-        expectedRevision: number;
         sceneId: string;
+        expectedRevision: number;
     }, {
         at: number;
-        expectedRevision: number;
         sceneId: string;
+        expectedRevision: number;
     }>>;
     uses: z.ZodOptional<z.ZodArray<z.ZodObject<{
         sectionId: z.ZodString;
@@ -1154,59 +1154,59 @@ declare const sectionInput: z.ZodObject<{
         start: z.ZodNumber;
         end: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        start: number;
-        sceneId: string;
         end: number;
-    }, {
-        start: number;
         sceneId: string;
+        start: number;
+    }, {
         end: number;
+        sceneId: string;
+        start: number;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
-    action: "create" | "alternative" | "choose" | "save" | "reuse" | "updateUses" | "rename" | "archive" | "tags";
+    action: "tags" | "create" | "rename" | "alternative" | "choose" | "save" | "reuse" | "updateUses" | "archive";
     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;
+        expectedRevision: number;
     } | undefined;
+    tags?: string[] | undefined;
+    sectionId?: string | undefined;
+    alternativeId?: string | undefined;
+    parentId?: string | undefined;
     uses?: {
         expectedRevision: number;
         sectionId: string;
     }[] | undefined;
     fragments?: {
-        start: number;
-        sceneId: string;
         end: number;
+        sceneId: string;
+        start: number;
     }[] | undefined;
 }, {
-    action: "create" | "alternative" | "choose" | "save" | "reuse" | "updateUses" | "rename" | "archive" | "tags";
+    action: "tags" | "create" | "rename" | "alternative" | "choose" | "save" | "reuse" | "updateUses" | "archive";
     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;
+        expectedRevision: number;
     } | undefined;
+    tags?: string[] | undefined;
+    sectionId?: string | undefined;
+    alternativeId?: string | undefined;
+    parentId?: string | undefined;
     uses?: {
         expectedRevision: number;
         sectionId: string;
     }[] | undefined;
     fragments?: {
-        start: number;
-        sceneId: string;
         end: number;
+        sceneId: string;
+        start: number;
     }[] | undefined;
 }>;
 export declare const changeScriptSection: Operation<z.infer<typeof sectionInput>>;
@@ -1225,16 +1225,16 @@ declare const suggestionInput: z.ZodObject<{
         replacement: z.ZodString;
         note: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        start: number;
-        sceneId: string;
         end: number;
+        sceneId: string;
+        start: number;
         original: string;
         replacement: string;
         note?: string | undefined;
     }, {
-        start: number;
-        sceneId: string;
         end: number;
+        sceneId: string;
+        start: number;
         original: string;
         replacement: string;
         note?: string | undefined;
@@ -1245,9 +1245,9 @@ declare const suggestionInput: z.ZodObject<{
     storyboardId: string;
     expectedRevision: number;
     suggestions?: {
-        start: number;
-        sceneId: string;
         end: number;
+        sceneId: string;
+        start: number;
         original: string;
         replacement: string;
         note?: string | undefined;
@@ -1258,9 +1258,9 @@ declare const suggestionInput: z.ZodObject<{
     storyboardId: string;
     expectedRevision: number;
     suggestions?: {
-        start: number;
-        sceneId: string;
         end: number;
+        sceneId: string;
+        start: number;
         original: string;
         replacement: string;
         note?: string | undefined;
@@ -1281,14 +1281,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 +1304,68 @@ declare const writeScriptDocumentInput: z.ZodObject<{
                 end: z.ZodNumber;
                 type: z.ZodEnum<["strong", "em"]>;
             }, "strip", z.ZodTypeAny, {
-                start: number;
-                type: "strong" | "em";
                 end: number;
-            }, {
-                start: number;
                 type: "strong" | "em";
+                start: number;
+            }, {
                 end: number;
+                type: "strong" | "em";
+                start: number;
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
-            start: number;
             end: number;
             id: string;
             kind: "paragraph" | "heading" | "direction";
+            start: number;
             marks: {
-                start: number;
-                type: "strong" | "em";
                 end: number;
+                type: "strong" | "em";
+                start: number;
             }[];
             label?: string | undefined;
-            level?: 3 | 2 | undefined;
+            level?: 2 | 3 | undefined;
         }, {
-            start: number;
             end: number;
             id: string;
             kind: "paragraph" | "heading" | "direction";
+            start: number;
             marks: {
-                start: number;
-                type: "strong" | "em";
                 end: number;
+                type: "strong" | "em";
+                start: number;
             }[];
             label?: string | undefined;
-            level?: 3 | 2 | undefined;
+            level?: 2 | 3 | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         sceneId: string;
         blocks: {
-            start: number;
             end: number;
             id: string;
             kind: "paragraph" | "heading" | "direction";
+            start: number;
             marks: {
-                start: number;
-                type: "strong" | "em";
                 end: number;
+                type: "strong" | "em";
+                start: number;
             }[];
             label?: string | undefined;
-            level?: 3 | 2 | undefined;
+            level?: 2 | 3 | undefined;
         }[];
     }, {
         sceneId: string;
         blocks: {
-            start: number;
             end: number;
             id: string;
             kind: "paragraph" | "heading" | "direction";
+            start: number;
             marks: {
-                start: number;
-                type: "strong" | "em";
                 end: number;
+                type: "strong" | "em";
+                start: number;
             }[];
             label?: string | undefined;
-            level?: 3 | 2 | undefined;
+            level?: 2 | 3 | undefined;
         }[];
     }>, "many">>;
     move: z.ZodOptional<z.ZodObject<{
@@ -1387,14 +1387,14 @@ declare const writeScriptDocumentInput: z.ZodObject<{
         end: z.ZodNumber;
         waitingShotId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        start: number;
-        sceneId: string;
         end: number;
+        sceneId: string;
+        start: number;
         waitingShotId?: string | undefined;
     }, {
-        start: number;
-        sceneId: string;
         end: number;
+        sceneId: string;
+        start: number;
         waitingShotId?: string | undefined;
     }>, "many">>;
     restoreRevision: z.ZodOptional<z.ZodNumber>;
@@ -1405,45 +1405,45 @@ declare const writeScriptDocumentInput: z.ZodObject<{
         at: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
         at: number;
-        sceneId: string;
         kind: "split";
+        sceneId: string;
     }, {
         at: number;
-        sceneId: string;
         kind: "split";
+        sceneId: string;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"merge">;
         sceneId: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        sceneId: string;
         kind: "merge";
-    }, {
         sceneId: string;
+    }, {
         kind: "merge";
+        sceneId: string;
     }>]>>;
 }, "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: {
-                start: number;
-                type: "strong" | "em";
                 end: number;
+                type: "strong" | "em";
+                start: number;
             }[];
             label?: string | undefined;
-            level?: 3 | 2 | undefined;
+            level?: 2 | 3 | undefined;
         }[];
     }[] | undefined;
     move?: {
@@ -1452,44 +1452,44 @@ declare const writeScriptDocumentInput: z.ZodObject<{
         delta: 1 | -1;
     } | undefined;
     makeShots?: {
-        start: number;
-        sceneId: string;
         end: number;
+        sceneId: string;
+        start: number;
         waitingShotId?: string | undefined;
     }[] | undefined;
     restoreRevision?: number | undefined;
     ensureScene?: boolean | undefined;
     sceneAction?: {
         at: number;
-        sceneId: string;
         kind: "split";
-    } | {
         sceneId: string;
+    } | {
         kind: "merge";
+        sceneId: string;
     } | 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: {
-                start: number;
-                type: "strong" | "em";
                 end: number;
+                type: "strong" | "em";
+                start: number;
             }[];
             label?: string | undefined;
-            level?: 3 | 2 | undefined;
+            level?: 2 | 3 | undefined;
         }[];
     }[] | undefined;
     move?: {
@@ -1498,20 +1498,20 @@ declare const writeScriptDocumentInput: z.ZodObject<{
         delta: 1 | -1;
     } | undefined;
     makeShots?: {
-        start: number;
-        sceneId: string;
         end: number;
+        sceneId: string;
+        start: number;
         waitingShotId?: string | undefined;
     }[] | undefined;
     restoreRevision?: number | undefined;
     ensureScene?: boolean | undefined;
     sceneAction?: {
         at: number;
-        sceneId: string;
         kind: "split";
-    } | {
         sceneId: string;
+    } | {
         kind: "merge";
+        sceneId: string;
     } | undefined;
 }>;
 export declare const writeScriptDocument: Operation<z.infer<typeof writeScriptDocumentInput>>;

package/dist/operations/index.js

@@ -6168,7 +6168,10 @@ export const getPromptingGuide = {
  */
 export const loadTools = {
     id: 'slates_load_tools',
-    description: 'Discover and load tools on demand. query searches operation names and descriptions and returns a compact list. names loads up to five exact tools with their schemas. group loads a whole task group. A load replaces the previous optional selection; query alone does not change it. Call the discovered tools by their own names. Groups: ' + Object.entries(GROUP_SUMMARY).map(([g, s]) => `${g}: ${s}`).join('; '),
+    // Worded to be true on both surfaces: the desktop agent must load an
+    // extended tool before calling it, while the MCP server lists every tool, so
+    // "missing from your list" never happens there by default.
+    description: 'Find Slates tools by task. query searches tool names and descriptions and returns a compact list. names returns up to five exact tools with their schemas; group returns a whole task group. Call the tools by their own names. If a tool you need is missing from your tool list, a names or group load adds it; a load replaces the previous optional selection, and query alone does not change it. Groups: ' + Object.entries(GROUP_SUMMARY).map(([g, s]) => `${g}: ${s}`).join('; '),
     input: z.object({
         group: z.enum(['script', 'library', 'timeline', 'admin', 'blender']).optional(),
         query: z.string().min(1).max(160).optional().describe('Search for a task such as generate image, create shot, or edit video.'),

package/dist/operations/surface.d.ts

@@ -61,7 +61,8 @@ export declare function toolDefinition(op: SurfaceOp): ToolDefinition;
  * Render a tool surface.
  *
  * `desktop` sends `core` plus whatever groups have been loaded this run; `mcp`
- * renders all definitions; the MCP server filters its connection listing from that set.
+ * renders all definitions, and the MCP server lists all of them unless started with
+ * `--tools=compact`.
  */
 export declare function toolDefinitions(ops: readonly SurfaceOp[], opts: {
     surface: 'desktop' | 'mcp';

package/dist/operations/surface.js

@@ -11,9 +11,12 @@
 //
 //   2. TIERS. 90 ops is 112 KB of descriptions and JSON schemas on EVERY
 //      desktop Studio Agent turn. `core` is what a session needs to work;
-//      `extended` is selected through `slates_load_tools`. Both surfaces replace
-//      the optional selection on a named/group load. MCP keeps every direct
-//      operation callable for compatibility and notifies when its listing changes.
+//      `extended` is selected through `slates_load_tools`. Tiers are a DESKTOP
+//      mechanism: we build every turn there, so a load reaches the model. The
+//      MCP server lists every op and leaves hiding definitions to the host
+//      (tiering there left Claude and Codex users unable to generate in 0.6.0;
+//      see the TOOLS comment in packages/mcp/src/server.ts). `--tools=compact`
+//      is the opt-in exception.
 //
 //   3. ONE SCHEMA RENDERER. The desktop rendered `$refStrategy: 'none'` and
 //      the MCP server rendered `target: 'openApi3'`, so "the two surfaces
@@ -238,7 +241,8 @@ export function toolDefinition(op) {
  * Render a tool surface.
  *
  * `desktop` sends `core` plus whatever groups have been loaded this run; `mcp`
- * renders all definitions; the MCP server filters its connection listing from that set.
+ * renders all definitions, and the MCP server lists all of them unless started with
+ * `--tools=compact`.
  */
 export function toolDefinitions(ops, opts) {
     const loaded = new Set(opts.groups ?? []);

package/dist/prompts/agent-doctrine.js

@@ -76,13 +76,34 @@ export function buildSkillIndex() {
     return entries;
 }
 // ── Preamble ───────────────────────────────────────────────────────
-const PREAMBLE = fork(`You are the Slates Studio Agent — a production assistant living inside Slates, the AI video creation studio. You plan and execute video/image production runs by chaining the Slates tools: script → characters → images → videos → quality-check → regenerate, ending with assets in the user's project (and on the timeline when asked).`, `You are connected to Slates, the AI video creation studio, through its MCP tool surface. These tools plan and execute real video/image production runs that spend the user's Slates credits: script → characters → images → videos → quality-check → regenerate, ending with assets in the user's project. Follow the working method and hard rules below on every Slates task — this is the same doctrine the in-app Studio Agent runs on.`);
+// FORKED, and the MCP side is a SUMMARY THAT MUST FIT IN THE CUT. Claude Code
+// keeps only the first 2,048 characters of a server's instructions (docs,
+// 2026-09-30), and 0.6.0's cut fell mid-sentence in step 4, so every hard rule
+// after it never reached the model. What an agent needs to act safely — how to
+// find a tool when the host shows names only, the spend gate, real numbers, the
+// current project — sits here; the sections below expand it for clients that
+// read everything. mcp-instructions-smoke asserts these lines land inside the
+// cut with the UPDATE AVAILABLE notice in front of them.
+const PREAMBLE = fork(`You are the Slates Studio Agent — a production assistant living inside Slates, the AI video creation studio. You plan and execute video/image production runs by chaining the Slates tools: script → characters → images → videos → quality-check → regenerate, ending with assets in the user's project (and on the timeline when asked).`, `You are connected to Slates, the AI video creation studio. These tools run real image, video and audio generations that spend the user's Slates credits, ending with assets in the user's project.
+
+## Essentials (the sections below expand on these)
+
+- FINDING TOOLS: every Slates capability is its own slates_* tool. If your client shows tool names only, search your tools for the task (for example "slates generate video") and load that tool before calling it. If a tool is missing from your list entirely, slates_load_tools finds and loads it.
+- SPENDING: before ANY generation, price every step with slates_estimate_generation_cost, show the user the itemized total in ONE message, and wait for their OK. Pass confirm: true only to relay an explicit user OK for that exact spend.
+- REAL NUMBERS ONLY: every cost, balance or count you state is copied from a tool result in this session. Never describe how a generation looks unless you fetched it this session.
+- PROJECT: call slates_get_workspace_state once, work in the user's current project, and never create a project unless asked.
+- CRAFT: before prompting a model, read its guide with slates_get_prompting_guide (pass the model id). For how or where in the app, use topic "app-manual".
+- Speak in the app's words and name assets by code and label (IMG-A12), never by tool name or UUID.`);
 // ── The working method ─────────────────────────────────────────────
 export const WORKING_METHOD = [
     both(`For HOW/WHERE questions, load slates_get_prompting_guide with topic "app-manual" and relevant query keywords. Teach the documented buttons and tabs, preserving model-specific conditions; do not invent UI paths or mutate the project when the user only asks for instructions. Slates is a sandbox of optional tools, not a required pipeline.`),
     both(`1. UNDERSTAND the outcome the user wants. If intent is clear, act with sane defaults — don't interrogate. If genuinely ambiguous, batch every question into ONE message.`),
     both(`2. ORIENT: call slates_get_workspace_state once at the start of a workflow. Work in the user's CURRENT project — this chat lives inside it. NEVER create a new project unless explicitly asked; if there's no current project, ask which to use.`),
-    both(`3. LOAD KNOWLEDGE ON DEMAND: slates_get_prompting_guide returns a short card by default; query a section or technique when needed. Use slates_load_tools with query to find a capability, then names to load its exact schema. A load replaces the previous optional selection. Before quoting a model, load its tool schema or routing guide. Use workspace generationDefaults when the user has no preference. Read the model card delivered by the estimate; fetch a section or full guide for an unfamiliar mode or missing detail. Reuse guidance already in context; retrieve it again when omitted or stale.`),
+    // FORKED: the desktop sends core tools plus what `slates_load_tools` loaded,
+    // so its agent must load before calling. The MCP server lists every tool and
+    // the host decides what to show (Essentials, FINDING TOOLS), so telling an MCP
+    // client to load first costs it a turn for a tool it already has.
+    fork(`3. LOAD KNOWLEDGE ON DEMAND: slates_get_prompting_guide returns a short card by default; query a section or technique when needed. Use slates_load_tools with query to find a capability, then names to load its exact schema. A load replaces the previous optional selection. Before quoting a model, load its tool schema or routing guide. Use workspace generationDefaults when the user has no preference. Read the model card delivered by the estimate; fetch a section or full guide for an unfamiliar mode or missing detail. Reuse guidance already in context; retrieve it again when omitted or stale.`, `3. LOAD KNOWLEDGE ON DEMAND: slates_get_prompting_guide returns a short card by default; query a section or technique when needed. Before quoting a model, read its tool schema or routing guide. Use workspace generationDefaults when the user has no preference. Read the model card delivered by the estimate; fetch a section or full guide for an unfamiliar mode or missing detail. Reuse guidance already in context; retrieve it again when omitted or stale.`),
     // FORKED: `present_plan` is a loop-level DESKTOP tool, deliberately not in
     // ALL_OPERATIONS, so MCP never sees it and has no plan gate at all. Its
     // substitute is the per-op `requires_confirm` threshold plus the host

package/dist/prompts/generation-policy.d.ts

@@ -2,7 +2,7 @@
  * This is NOT a model capability or provider batch limit. Desktop mirror is
  * generated by slate/scripts/sync-generation-policy.mjs; never edit it there. */
 export declare const IMAGE_QUANTITIES: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
-export declare const MAX_IMAGE_VARIATIONS: 1 | 2 | 4 | 5 | 3 | 10 | 8 | 7 | 6 | 9;
+export declare const MAX_IMAGE_VARIATIONS: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
 export type ImageQuantity = typeof IMAGE_QUANTITIES[number];
 export declare const clampImageQuantity: (count?: number) => ImageQuantity;
 /** Default saved-recipe framing, shared by composer restore, quote and dispatch. */