@slatesvideo/shared 0.5.0 → 0.5.2

package/dist/operations/index.js

@@ -28,6 +28,29 @@ function ok(data, text) {
         data,
     };
 }
+// ── Credits (2026-07-07 re-denomination) ────────────────────────
+// Costs are ABSTRACT CREDITS now, not dollars. The API's model registry
+// returns `cost_credits` (with `cost_cents` kept as a legacy alias carrying
+// the same credit value); balances the same. Read via creditCost(); display
+// via fmtCredits(). The confirm gate fires above CONFIRM_CREDITS (≈ the old
+// $0.50 gate at the 3¢/credit peg).
+const CONFIRM_CREDITS = 17;
+const CENTS_PER_CREDIT = 3; // peg: 1 credit = 3¢ billed = 2¢ COGS (mirror of slates-api)
+function creditCost(m) {
+    if (!m)
+        return 0;
+    return m.cost_credits ?? m.cost_cents ?? 0;
+}
+function fmtCredits(credits) {
+    return `${Math.round(credits).toLocaleString('en-US')} credits`;
+}
+/** Convert a legacy desktop dollar estimate (COGS × markup) to billed credits,
+ *  mirroring the server's toCredits(round(dollars × 100)). The desktop's
+ *  generations.cost column still stores dollars, so status reads convert. */
+function creditsFromDollars(dollars) {
+    const cents = Math.round(dollars * 100);
+    return cents <= 0 ? 0 : Math.max(1, Math.ceil(cents / CENTS_PER_CREDIT));
+}
 // Shared describe-text for the background flag on every generate_* op.
 const BACKGROUND_DESCRIBE = 'Submit and return immediately with generationId(s) instead of blocking until the file is saved. ' +
     'Poll with slates_get_generation_status. Recommended for video (1-5 min renders).';
@@ -71,16 +94,17 @@ export const getMe = {
 };
 export const getCreditBalance = {
     id: 'slates_get_credit_balance',
-    description: 'Current Slates credit balance, in cents and dollars. Call before any generation that costs credits.',
+    description: 'Current Slates credit balance (abstract credits — never expire). Call before any generation that costs credits.',
     input: z.object({}).strict(),
     async run(_input, ctx) {
         const r = await ctx.cloud().get('/api/agent/credits/balance');
-        return ok(r);
+        const credits = r.credit_balance ?? r.credit_balance_cents ?? 0;
+        return ok({ success: r.success, credit_balance: credits }, `Balance: ${fmtCredits(credits)}.`);
     },
 };
 export const listAvailableModels = {
     id: 'slates_list_available_models',
-    description: 'Registry of generation model cost keys with per-call credit cost in cents, as a compact "key cents" table. Optional `filter` substring (e.g. "kling" or "nano-banana") keeps the result small — prefer it. For a single known model, slates_estimate_generation_cost is cheaper still.',
+    description: 'Registry of generation model cost keys with per-call credit cost, as a compact "key credits" table. Optional `filter` substring (e.g. "kling" or "nano-banana") keeps the result small — prefer it. For a single known model, slates_estimate_generation_cost is cheaper still.',
     input: z.object({
         filter: z.string().optional().describe('Substring match on the model key, e.g. "kling-v3" or "seedance"'),
     }),
@@ -91,21 +115,21 @@ export const listAvailableModels = {
             const q = input.filter.toLowerCase();
             models = models.filter((m) => m.model.toLowerCase().includes(q));
         }
-        // Compact text table — "key cents" lines are ~5x denser than the raw
+        // Compact text table — "key credits" lines are ~5x denser than the raw
         // JSON registry (the full pretty-printed dump was an ~8k-token leak).
-        const table = models.map((m) => `${m.model} ${m.cost_cents}`).join('\n');
+        const table = models.map((m) => `${m.model} ${creditCost(m)}`).join('\n');
         return {
-            text: `${models.length} COST keys (cents per generation)${input.filter ? ` matching "${input.filter}"` : ''}. ` +
+            text: `${models.length} COST keys (credits per generation)${input.filter ? ` matching "${input.filter}"` : ''}. ` +
                 `NOTE: these are billing keys for cost lookup ONLY — the \`model\` param on slates_generate_video takes a BASE id ` +
                 `(kling-v3.0-std | kling-v3.0-pro | kling-v3.0-omni | seedance-2 | veo-3.1-fast | veo-3.1-standard) with duration/videoResolution as separate params:\n` +
                 table,
-            data: { count: models.length, credit_markup: r.credit_markup },
+            data: { count: models.length },
         };
     },
 };
 export const estimateGenerationCost = {
     id: 'slates_estimate_generation_cost',
-    description: 'Pre-flight cost estimate. Call before any generate_* op so the user sees "this will cost N credits" up front. Takes the SAME base model ids as the generate ops (video: "seedance-2" + duration + videoResolution; image: "nano-banana-2" + resolution) — exact registry cost keys also work. Pairs with the >$0.50 confirm gate.',
+    description: 'Pre-flight cost estimate. Call before any generate_* op so the user sees "this will cost N credits" up front. Takes the SAME base model ids as the generate ops (video: "seedance-2" + duration + videoResolution; image: "nano-banana-2" + resolution) — exact registry cost keys also work. Pairs with the confirm gate.',
     input: z.object({
         model: z.string().describe('Base model id as passed to the generate op (e.g. "seedance-2", "kling-v3.0-std", "nano-banana-2") or an exact registry cost key ("nano-banana-2-2k", "seedance-2-1080p-8s")'),
         quantity: z.number().int().min(1).max(10).optional().describe('Number of generations (default 1)'),
@@ -119,7 +143,7 @@ export const estimateGenerationCost = {
     }),
     async run(input, ctx) {
         const registry = await ctx.cloud().get('/api/agent/models');
-        const byKey = new Map(registry.models.map((m) => [m.model, m.cost_cents]));
+        const byKey = new Map(registry.models.map((m) => [m.model, creditCost(m)]));
         // 1) exact registry cost key
         let key = byKey.has(input.model) ? input.model : null;
         // 2) image base id + resolution (+ quality for gpt-image-2)
@@ -164,21 +188,20 @@ export const estimateGenerationCost = {
                 });
             }
         }
-        const cents = key != null ? byKey.get(key) : undefined;
-        if (key == null || cents == null) {
+        const perCredits = key != null ? byKey.get(key) : undefined;
+        if (key == null || perCredits == null) {
             throw new Error(`Unknown model: ${input.model}. Pass a base id (${VIDEO_MODELS.join(' | ')} | nano-banana-2 | flux-2-max | seedream-5-lite) plus duration/resolution params, or use slates_list_available_models with a filter.`);
         }
         const qty = input.quantity ?? 1;
-        const totalCents = cents * qty;
+        const totalCredits = perCredits * qty;
         return ok({
             model: input.model,
             cost_key: key,
             quantity: qty,
-            cost_per_cents: cents,
-            total_cents: totalCents,
-            total_dollars: (totalCents / 100).toFixed(2),
-            requires_confirm: totalCents > 50,
-        });
+            cost_per_credits: perCredits,
+            total_credits: totalCredits,
+            requires_confirm: totalCredits > CONFIRM_CREDITS,
+        }, `${input.model}${qty > 1 ? ` ×${qty}` : ''}: ${fmtCredits(totalCredits)} (${key}).`);
     },
 };
 // ── Projects ────────────────────────────────────────────────────
@@ -416,12 +439,16 @@ export const getAssetVideoFrames = {
 };
 export const uploadReferenceImage = {
     id: 'slates_upload_reference_image',
-    description: 'Add a reference image to a Slates project. Pass either filePath (absolute path to a local file) or dataUrl (base64 data: URL) — exactly one.',
+    description: 'Add a reference image OR video clip to a Slates project. Pass either filePath (absolute path to a local file) or dataUrl (base64 data: URL) — exactly one. Set type:"video" on a filePath import to bring in a clip (the user\'s own footage to edit/relocate/trim); imported videos are probed on ingest, so duration + dimensions are available immediately. Default type is "image". dataUrl is image-only.',
     input: z
         .object({
         projectId: z.string().uuid(),
         filePath: z.string().optional(),
         dataUrl: z.string().optional(),
+        type: z
+            .enum(['image', 'video'])
+            .optional()
+            .describe('Asset kind for a filePath import — "image" (default) or "video". A dataUrl is always an image.'),
     })
         .refine((d) => !!d.filePath !== !!d.dataUrl, {
         message: 'Pass exactly one of filePath or dataUrl',
@@ -432,10 +459,13 @@ export const uploadReferenceImage = {
             const r = await desktop.post('/agent/assets/upload', {
                 projectId: input.projectId,
                 filePath: input.filePath,
-                type: 'image',
+                type: input.type ?? 'image',
             });
             return ok(r);
         }
+        if (input.type === 'video') {
+            throw new Error('dataUrl uploads are image-only — pass a filePath to import a video clip.');
+        }
         const r = await desktop.post('/agent/assets/upload-base64', {
             projectId: input.projectId,
             dataUrl: input.dataUrl,
@@ -573,7 +603,7 @@ export const generateCharacterSheets = {
 };
 export const generateEnvironmentPlate = {
     id: 'slates_generate_environment_plate',
-    description: "Generate an environment's single clean establishing plate (Nano Banana 2, 2K) from an optional base image, and bind it as the environment's reference. THE real environment-building workflow — call right after slates_create_environment. Afterward, pass the plate asset id as environmentAssetIds to slates_generate_video (or referenceAssetIds to slates_generate_image) so the location stays consistent across shots. Cost ~$0.18.",
+    description: "Generate an environment's single clean establishing plate (Nano Banana 2, 2K) from an optional base image, and bind it as the environment's reference. THE real environment-building workflow — call right after slates_create_environment. Afterward, pass the plate asset id as environmentAssetIds to slates_generate_video (or referenceAssetIds to slates_generate_image) so the location stays consistent across shots. Cost ~6 credits.",
     input: z.object({
         environmentId: z.string().uuid(),
         projectId: z.string().uuid(),
@@ -765,7 +795,7 @@ export const generateImage = {
         referenceImageUrls: z.array(z.string().url()).max(14).optional().describe('Headless (no-projectId) nano-banana-2 only: up to 14 ref URLs. For projectId runs, upload refs with slates_upload_reference_image first. Always label each image\'s role in the prompt text.'),
         referenceAssetIds: z.array(z.string()).max(14).optional().describe("Project assets to use as reference/ingredient images — asset UUIDs or badge codes (\"IMG-A8\"); codes resolve against the project at call time. Requires projectId. For nano-banana-2 up to 14 refs; FLUX/Seedream route to their edit endpoints with lower per-model caps. Label each reference's role in the prompt text."),
         background: z.boolean().optional().describe(BACKGROUND_DESCRIBE),
-        confirm: z.boolean().optional().describe('Set true to bypass the >$0.50 cost confirm gate.'),
+        confirm: z.boolean().optional().describe('Set true to bypass the confirm gate.'),
     }),
     async run(input, ctx) {
         // Clarification gate: aspectRatio + resolution must be deliberate.
@@ -852,26 +882,26 @@ export const generateImage = {
         const entry = registry.models.find((m) => m.model === costKey);
         if (!entry)
             throw new Error(`Model not in registry: ${costKey}`);
-        const totalCents = entry.cost_cents * (input.count ?? 1);
+        const totalCents = creditCost(entry) * (input.count ?? 1);
         // Confirm gate. Fires on cost > $0.50, AND (look-first, mirroring
         // slates_generate_video) whenever reference assets are involved
         // regardless of cost — the LLM must see what it's referencing before
         // committing spend.
-        if ((totalCents > 50 || referenceAssetIds.length > 0) && !input.confirm) {
+        if ((totalCents > CONFIRM_CREDITS || referenceAssetIds.length > 0) && !input.confirm) {
             if (referenceAssetIds.length === 0) {
                 return ok({
                     requires_confirm: true,
                     model: costKey,
                     estimated_cents: totalCents,
-                    estimated_dollars: (totalCents / 100).toFixed(2),
-                    message: 'Cost exceeds $0.50. Re-call with confirm=true to proceed, or pick a smaller resolution / count.',
+                    estimated_credits: totalCents,
+                    message: `Cost exceeds ${CONFIRM_CREDITS} credits. Re-call with confirm=true to proceed, or pick a smaller resolution / count.`,
                 });
             }
             const previews = await previewAssets(ctx, referenceAssetIds.map((id) => ({ id, type: 'image', role: 'reference' })));
             const refLines = previews.map((p) => `  - ${p.role}: ${p.ref}`).join('\n');
             return {
                 text: `Pre-flight for ${imageModel} (${costKey}): ` +
-                    `$${(totalCents / 100).toFixed(2)} (${totalCents}¢).` +
+                    `${fmtCredits(totalCents)}.` +
                     `\n\nReference images attached above:\n${refLines}\n\n` +
                     `Review them against your prompt — every reference's role must be labeled in the prompt text. ` +
                     `If the references suggest a different composition / style than the current prompt captures, REVISE the prompt before confirming. ` +
@@ -883,7 +913,7 @@ export const generateImage = {
                     model: imageModel,
                     variant: costKey,
                     estimated_cents: totalCents,
-                    estimated_dollars: (totalCents / 100).toFixed(2),
+                    estimated_credits: totalCents,
                     references: previews.map((p) => ({
                         role: p.role,
                         ref: p.ref,
@@ -931,7 +961,7 @@ export const generateImage = {
                     costKey,
                     projectId: input.projectId,
                     cost_cents: totalCents,
-                    cost_dollars: (totalCents / 100).toFixed(2),
+                    cost_credits: totalCents,
                 }, refEcho);
             }
             const assetList = result.assets
@@ -957,7 +987,7 @@ export const generateImage = {
                         `The saved assets are in data.assets — re-generate only the missing count, don't redo the whole batch. ` +
                         `Prompt: "${input.prompt.slice(0, 60)}${input.prompt.length > 60 ? '...' : ''}"`
                     : `Generated ${assetList.length} image(s) into project ${input.projectId} ` +
-                        `for $${(totalCents / 100).toFixed(2)} (${totalCents}¢). ` +
+                        `for ${fmtCredits(totalCents)}. ` +
                         `Prompt: "${input.prompt.slice(0, 60)}${input.prompt.length > 60 ? '...' : ''}"` +
                         (refEcho ? ` ${refEcho}` : ''),
                 images,
@@ -968,7 +998,7 @@ export const generateImage = {
                     aspectRatio: input.aspectRatio,
                     resolution,
                     cost_cents: totalCents,
-                    cost_dollars: (totalCents / 100).toFixed(2),
+                    cost_credits: totalCents,
                     // Compact refs only — the full rows (prompt/settings/paths) were a
                     // multi-KB leak per generation and everything needed downstream is
                     // the id/code/label.
@@ -1027,7 +1057,7 @@ export const generateImage = {
             images.push({ data: buf.toString('base64'), mimeType: mt });
         }
         return {
-            text: `Generated ${urls.length} image(s) for $${(totalCents / 100).toFixed(2)} (${totalCents}¢). ` +
+            text: `Generated ${urls.length} image(s) for ${fmtCredits(totalCents)}. ` +
                 `Prompt: "${input.prompt.slice(0, 60)}${input.prompt.length > 60 ? '...' : ''}"`,
             images,
             data: {
@@ -1037,7 +1067,7 @@ export const generateImage = {
                 aspectRatio: input.aspectRatio,
                 resolution,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
             },
         };
     },
@@ -1076,7 +1106,7 @@ export const editImage = {
         resolution: z.enum(['1k', '2k', '3k', '4k']).optional().describe('3k (1440p class) is gpt-image-2 only; nano-banana-2-lite is 1k only.'),
         quality: z.enum(['medium', 'high']).optional().describe('gpt-image-2 only — quality tier (default medium).'),
         aspectRatio: z.string().optional(),
-        confirm: z.boolean().optional().describe('Set true to bypass the >$0.50 cost confirm gate.'),
+        confirm: z.boolean().optional().describe('Set true to bypass the confirm gate.'),
         background: z.boolean().optional().describe(BACKGROUND_DESCRIBE),
     }),
     async run(input, ctx) {
@@ -1100,16 +1130,16 @@ export const editImage = {
         const entry = registry.models.find((m) => m.model === costKey);
         if (!entry)
             throw new Error(`Model not in registry: ${costKey}`);
-        const totalCents = entry.cost_cents;
-        if (totalCents > 50 && !input.confirm) {
+        const totalCents = creditCost(entry);
+        if (totalCents > CONFIRM_CREDITS && !input.confirm) {
             const sourceRef = await lookupAssetRef(desktop, input.sourceAssetId);
             return ok({
                 requires_confirm: true,
                 variant: costKey,
                 estimated_cents: totalCents,
-                estimated_dollars: (totalCents / 100).toFixed(2),
+                estimated_credits: totalCents,
                 source_ref: sourceRef,
-                message: `Cost: $${(totalCents / 100).toFixed(2)} to edit ${sourceRef} with ${editModel} (${costKey}). ` +
+                message: `Cost: ${fmtCredits(totalCents)} to edit ${sourceRef} with ${editModel} (${costKey}). ` +
                     `Re-call with confirm=true after the user explicitly OKs the spend. ` +
                     `When discussing with the user, refer to the source by its code (matches the gallery badge).`,
             });
@@ -1135,7 +1165,7 @@ export const editImage = {
                 projectId: input.projectId,
                 sourceAssetId: input.sourceAssetId,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
             });
         }
         // Inline the edited result so the LLM sees whether the surgery landed —
@@ -1153,7 +1183,7 @@ export const editImage = {
         }
         return {
             text: `Edited image saved as a new asset in project ${input.projectId} ` +
-                `for $${(totalCents / 100).toFixed(2)} (${totalCents}¢) via ${editModel}. ` +
+                `for ${fmtCredits(totalCents)} via ${editModel}. ` +
                 `Edit: "${input.prompt.slice(0, 60)}${input.prompt.length > 60 ? '...' : ''}"`,
             images,
             data: {
@@ -1163,7 +1193,7 @@ export const editImage = {
                 sourceAssetId: input.sourceAssetId,
                 resolution,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
                 asset: result.asset,
                 generationId: result.generationId,
             },
@@ -1181,6 +1211,7 @@ export const VIDEO_MODELS = [
     'veo-3.1-fast',
     'veo-3.1-standard',
     'seedance-2',
+    'omni-flash',
 ];
 // Model → registry cost-key. Each provider's keys ship with their own
 // shape (verified against /api/agent/models):
@@ -1241,6 +1272,11 @@ export function videoCostKey(input) {
         }
         return `${tier}-${input.duration}s${input.sound === true ? '-audio' : ''}`;
     }
+    if (input.model === 'omni-flash') {
+        // Mirrors omniFlashCreditKey() in slate/src/shared/pricing.ts — flat 720p
+        // rate, audio native + included, no resolution/audio key dimension.
+        return `omni-flash-${input.duration}s`;
+    }
     throw new Error(`Unknown video model: ${input.model}`);
 }
 // Kling O3 video-to-video edit cost key — mirrors klingEditCreditKey() in
@@ -1251,6 +1287,12 @@ export function klingEditCostKey(model, duration) {
     const tier = model === 'kling-v3.0-omni-pro-edit' ? 'kling-v3-omni-pro-edit' : 'kling-v3-omni-edit';
     return `${tier}-${duration}s`;
 }
+// Omni Flash video-edit cost key — mirrors omniFlashCreditKey() in
+// slate/src/shared/pricing.ts (must byte-match; checked by the slates-api
+// pricing-consistency script). Duration is the CEILED source-clip length.
+export function omniFlashEditCostKey(duration) {
+    return `omni-flash-edit-${duration}s`;
+}
 /**
  * Forgiving model-id resolver. Agents routinely paste registry COST keys
  * ("kling-v3-standard-8s", "seedance-2-1080p-8s") into the `model` param —
@@ -1298,6 +1340,9 @@ function resolveVideoModel(raw) {
         seedance: 'seedance-2',
         'veo-3.1': 'veo-3.1-fast',
         'veo-3': 'veo-3.1-fast',
+        'gemini-omni-flash': 'omni-flash',
+        'gemini-omni-flash-preview': 'omni-flash',
+        'omni-flash-preview': 'omni-flash',
     };
     if (aliases[s]) {
         out.model = aliases[s];
@@ -1316,6 +1361,8 @@ function promptingSkillFor(model) {
         return 'slates-prompting-veo-3';
     if (model.startsWith('seedance'))
         return 'slates-prompting-seedance';
+    if (model.startsWith('omni-flash'))
+        return 'slates-prompting-omni-flash';
     return 'slates-cost-discipline';
 }
 export const generateVideo = {
@@ -1323,14 +1370,14 @@ export const generateVideo = {
     description: 'Generate video via Slates credits. REQUIRED before calling: read slates-model-selection (the routing doctrine), slates-cost-discipline, and the matching per-model prompting skill (slates-prompting-seedance / slates-prompting-kling-v3 / slates-prompting-veo-3) — video models prompt very differently; load them via slates_get_prompting_guide if no skill files are installed. Read slates-content-policy when the scene involves conflict, creatures, crowds, destruction, weapons, or young characters. projectId, aspectRatio, and duration are required (requires_clarification otherwise). Cost > $0.50 returns requires_confirm — pass confirm=true after explicit user OK. Image-to-video via firstFrameAssetId; first+last frames = Veo/Seedance only; ingredients via ingredientAssetIds (Kling Omni / Seedance). Asset params take UUIDs or badge codes ("IMG-A8").',
     input: z.object({
         prompt: z.string().min(1).max(4000),
-        model: z.string().describe('One of: kling-v3.0-std | kling-v3.0-pro | kling-v3.0-omni | seedance-2 | veo-3.1-fast | veo-3.1-standard. Pass the BASE id — duration and videoResolution are separate params (registry cost keys like "kling-v3-standard-8s" auto-resolve). Route per the slates-model-selection skill: Kling std = general-purpose DEFAULT, Seedance 2 = premium physics/effects/hero tier, Veo = native-synced-audio niche only (16:9, 4/6/8s) — never the default. All are VIDEO-only. For per-call cost, call slates_estimate_generation_cost — never quote prices from memory.'),
+        model: z.string().describe('One of: kling-v3.0-std | kling-v3.0-pro | kling-v3.0-omni | seedance-2 | veo-3.1-fast | veo-3.1-standard | omni-flash. Pass the BASE id — duration and videoResolution are separate params (registry cost keys like "kling-v3-standard-8s" auto-resolve). Route per the slates-model-selection skill: Kling std = general-purpose DEFAULT, Seedance 2 = premium physics/effects/hero tier, Veo = native-synced-audio niche only (16:9, 4/6/8s) — never the default, omni-flash = cheap 720p tier with audio included (3-10s, 16:9/9:16; t2v, single-start-frame i2v, or up to 7 reference images; no last frame / video / audio refs). All are VIDEO-only. For per-call cost, call slates_estimate_generation_cost — never quote prices from memory.'),
         projectId: z.string().uuid().optional().describe('Save into this Slates project. Strongly recommended — the desktop UI shows a progress card live and the asset appears when complete.'),
         aspectRatio: z.enum(['1:1', '16:9', '9:16', '4:3', '3:4', '21:9', '9:21', '4:5', '5:4', '2:3', '3:2']).optional().describe('Veo locks to 16:9 — passing anything else will be ignored or fail. Kling/Seedance support all.'),
-        duration: z.number().int().min(4).max(15).optional().describe('Seconds. Kling: 5-15. Veo: 4, 6, or 8 only (4K only at 8s). Seedance: 4-15. Default 5 if omitted but always be explicit (cost scales linearly).'),
+        duration: z.number().int().min(3).max(15).optional().describe('Seconds. Kling: 5-15. Veo: 4, 6, or 8 only (4K only at 8s). Seedance: 4-15. Omni Flash: 3-10. Default 5 if omitted but always be explicit (cost scales linearly).'),
         videoResolution: z.enum(['480p', '720p', '1080p', '4k']).optional().describe('Veo + Seedance. Seedance: 480p/720p/1080p/4K (default 1080p; 4K is native, the most expensive). Veo: 720p/1080p same price, 4K more (8s only).'),
         firstFrameAssetId: z.string().optional().describe('Starting frame for image-to-video: asset UUID or badge code ("IMG-A8") — codes resolve against the project at call time, so a code the user just spoke is always safe to pass.'),
         lastFrameAssetId: z.string().optional().describe('Ending frame (UUID or badge code). Veo and Seedance only. Pairs with firstFrameAssetId for guided transitions.'),
-        ingredientAssetIds: z.array(z.string()).max(9).optional().describe('Visual reference / ingredient assets (UUIDs or badge codes) for Kling Omni or Seedance. Up to 9 (Seedance) or 4 (Kling).'),
+        ingredientAssetIds: z.array(z.string()).max(9).optional().describe('Visual reference / ingredient assets (UUIDs or badge codes) for Kling Omni, Seedance, or Omni Flash. Up to 9 (Seedance), 4 (Kling), or 7 (Omni Flash, combined across all ref params).'),
         characterAssetIds: z.array(z.string()).optional().describe('Character sheet assets (UUIDs or badge codes) — keeps a character consistent across the shot.'),
         environmentAssetIds: z.array(z.string()).optional().describe('Environment grid assets (UUIDs or badge codes) — keeps a location/setting consistent across the shot.'),
         styleAssetIds: z.array(z.string()).optional().describe('Style reference assets (UUIDs or badge codes) — locks the visual style of the shot.'),
@@ -1345,7 +1392,7 @@ export const generateVideo = {
         realFaceConsent: z.boolean().optional().describe('MANDATORY with seedanceRealFace: set true ONLY after the user has explicitly confirmed they hold the rights/consent to this person\'s likeness and it doesn\'t impersonate or misrepresent them. The generation is refused without it. Public figures/celebrities fail on every route.'),
         negativePrompt: z.string().optional(),
         background: z.boolean().optional().describe(BACKGROUND_DESCRIBE),
-        confirm: z.boolean().optional().describe('Set true after explicit user OK to bypass the >$0.50 cost confirm gate (which fires for almost every video gen since they\'re expensive).'),
+        confirm: z.boolean().optional().describe('Set true after explicit user OK to bypass the confirm gate (which fires for almost every video gen since they\'re expensive).'),
     }),
     async run(input, ctx) {
         // Resolve the model FIRST — forgiving normalization (cost keys, alias
@@ -1375,7 +1422,7 @@ export const generateVideo = {
             return ok({
                 requires_clarification: true,
                 missing: ['projectId'],
-                message: 'projectId is required for video generation. Use slates_list_projects to find one or slates_create_project to make a new one. Video gens cost $0.50-$2.00+ per call — they need to land in a project so the user sees the progress card and the result.',
+                message: 'projectId is required for video generation. Use slates_list_projects to find one or slates_create_project to make a new one. Video gens cost tens to a few hundred credits per call — they need to land in a project so the user sees the progress card and the result.',
             });
         }
         if (!input.aspectRatio || !input.duration) {
@@ -1389,10 +1436,41 @@ export const generateVideo = {
                 missing,
                 message: `Missing required field(s): ${missing.join(', ')}. ` +
                     `Read the slates-cost-discipline + ${promptingSkillFor(input.model)} skills, ` +
-                    `or ask the user. Veo locks to 16:9. Kling/Seedance support 1:1 16:9 9:16 4:3 3:4 21:9. ` +
-                    `Duration: Kling 5-15s, Veo 4/6/8s (4K only at 8s), Seedance 4-15s. Cost scales linearly with duration.`,
+                    `or ask the user. Veo locks to 16:9. Kling/Seedance support 1:1 16:9 9:16 4:3 3:4 21:9. Omni Flash: 16:9/9:16 only. ` +
+                    `Duration: Kling 5-15s, Veo 4/6/8s (4K only at 8s), Seedance 4-15s, Omni Flash 3-10s. Cost scales linearly with duration.`,
             });
         }
+        // Omni Flash: 3-10s, 720p only — t2v, single-start-frame i2v, or ref2v
+        // with up to 7 reference IMAGES. No last frame, no video/audio refs.
+        // Validate up front so the agent gets an actionable message instead of
+        // a registry throw.
+        if (input.model === 'omni-flash') {
+            if (input.duration < 3 || input.duration > 10) {
+                return ok({
+                    requires_clarification: true,
+                    missing: ['duration'],
+                    message: `Omni Flash supports 3-10 seconds (you passed ${input.duration}s). Pick a duration in that range.`,
+                });
+            }
+            if (input.lastFrameAssetId || input.videoReferenceAssetId || input.audioReferenceAssetId) {
+                return ok({
+                    requires_clarification: true,
+                    missing: [],
+                    message: 'Omni Flash takes a prompt, an optional start frame, and up to 7 reference IMAGES — last frames and video/audio references are not supported. Drop those, or switch to seedance-2 (video/audio refs, last frame) or veo (last frame).',
+                });
+            }
+            const refCount = (input.ingredientAssetIds?.length ?? 0) +
+                (input.characterAssetIds?.length ?? 0) +
+                (input.environmentAssetIds?.length ?? 0) +
+                (input.styleAssetIds?.length ?? 0);
+            if (refCount > 7) {
+                return ok({
+                    requires_clarification: true,
+                    missing: [],
+                    message: `Omni Flash takes at most 7 reference images combined (you passed ${refCount}). Trim the list.`,
+                });
+            }
+        }
         // Veo exists only at discrete durations 4/6/8s, and 4K only at 8s.
         // Validate up front so the agent gets an actionable message instead of
         // a generic "Model variant not in registry" throw from the cost lookup.
@@ -1480,9 +1558,9 @@ export const generateVideo = {
         const entry = registry.models.find((m) => m.model === costKey);
         if (!entry) {
             throw new Error(`Model variant not in registry: ${costKey}. ` +
-                `Available video models: ${registry.models.filter((m) => m.model.startsWith('kling') || m.model.startsWith('veo') || m.model.startsWith('seedance')).map((m) => m.model).slice(0, 20).join(', ')}`);
+                `Available video models: ${registry.models.filter((m) => m.model.startsWith('kling') || m.model.startsWith('veo') || m.model.startsWith('seedance') || m.model.startsWith('omni-flash')).map((m) => m.model).slice(0, 20).join(', ')}`);
         }
-        const totalCents = entry.cost_cents;
+        const totalCents = creditCost(entry);
         // Pre-flight confirm gate. Fires when:
         //   (a) cost > $0.50 (the cost gate), OR
         //   (b) any reference assets are involved (the look-first gate)
@@ -1511,7 +1589,7 @@ export const generateVideo = {
             referenceRefs.push({ id, type: 'image', role: 'style' });
         }
         const hasReferences = referenceRefs.length > 0;
-        if ((totalCents > 50 || hasReferences) && !input.confirm) {
+        if ((totalCents > CONFIRM_CREDITS || hasReferences) && !input.confirm) {
             const previews = hasReferences ? await previewAssets(ctx, referenceRefs) : [];
             const refLines = previews.map((p) => `  - ${p.role}: ${p.ref}`).join('\n');
             const refSummary = hasReferences
@@ -1521,7 +1599,7 @@ export const generateVideo = {
             const refImages = previews.flatMap((p) => p.images);
             return {
                 text: `Pre-flight for ${input.duration}s ${input.model} (${costKey}): ` +
-                    `$${(totalCents / 100).toFixed(2)} (${totalCents}¢).` +
+                    `${fmtCredits(totalCents)}.` +
                     refSummary +
                     `\n\nWhen ready, re-call slates_generate_video with confirm=true and the (possibly revised) prompt.`,
                 images: refImages,
@@ -1530,7 +1608,7 @@ export const generateVideo = {
                     model: input.model,
                     variant: costKey,
                     estimated_cents: totalCents,
-                    estimated_dollars: (totalCents / 100).toFixed(2),
+                    estimated_credits: totalCents,
                     references: previews.map((p) => ({
                         role: p.role,
                         ref: p.ref,
@@ -1581,7 +1659,7 @@ export const generateVideo = {
                 variant: costKey,
                 projectId: input.projectId,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
                 references: refInputs.map(({ ref, role }) => ({
                     role,
                     ...(resolvedRefs.get(ref) ?? { id: ref, code: null, label: null }),
@@ -1590,7 +1668,7 @@ export const generateVideo = {
         }
         return {
             text: `Generated ${input.duration}s ${input.model} video into project ${input.projectId} ` +
-                `for $${(totalCents / 100).toFixed(2)} (${totalCents}¢). ` +
+                `for ${fmtCredits(totalCents)}. ` +
                 `Prompt: "${input.prompt.slice(0, 60)}${input.prompt.length > 60 ? '...' : ''}"` +
                 (refEcho ? ` ${refEcho}` : ''),
             data: {
@@ -1600,7 +1678,7 @@ export const generateVideo = {
                 aspectRatio: input.aspectRatio,
                 duration: input.duration,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
                 asset: result.asset,
                 generationId: result.generationId,
             },
@@ -1621,8 +1699,8 @@ export const generateLipSync = {
         ttsLanguage: z.enum(['EN', 'ZH', 'JA', 'KO', 'ES']).optional().describe('Kling engine only — TTS language. Default EN.'),
         ttsSpeed: z.number().min(0.5).max(2).optional().describe('Kling engine only — TTS speech rate. Default 1.0. Range 0.5-2.0.'),
         audioFilePath: z.string().optional().describe('Required when audioMethod=upload. Absolute path to the audio file on the user\'s machine (mp3, wav, m4a).'),
-        avatarModel: z.enum(['avatar-standard', 'avatar-pro']).optional().describe('Kling engine, image-source only. avatar-standard ($0.42/5s) for general use. avatar-pro ($0.86/5s) for sharper face fidelity.'),
-        klingProvider: z.enum(['fal', 'kling']).optional().describe('Kling engine only — provider routing. "fal" (default) uses Slates credits. "kling" uses the user\'s own BYOK Kling key if configured.'),
+        avatarModel: z.enum(['avatar-standard', 'avatar-pro']).optional().describe('Kling engine, image-source only. avatar-standard (~14 credits/5s) for general use. avatar-pro (~29 credits/5s) for sharper face fidelity.'),
+        klingProvider: z.enum(['fal', 'kling']).optional().describe('Kling engine only — provider routing. Leave unset: all agent generations bill Slates credits (BYOK is retired).'),
         engine: z.enum(['kling', 'seedance-2']).optional().describe('Default kling (cheap utility). seedance-2 = premium single-pass: natural speech generated in the video, voice cloned from a video source, audio included. Credits only.'),
         videoResolution: z.enum(['480p', '720p', '1080p', '4k']).optional().describe('Seedance engine only. Default 1080p.'),
         aspectRatio: z.string().optional().describe('Seedance engine only. Default 16:9.'),
@@ -1632,7 +1710,7 @@ export const generateLipSync = {
         sourceSeconds: z.number().optional().describe('Seedance engine + sourceType=video: the source clip\'s duration in seconds (from the asset listing). Feeds the vref cost key (input+output billing).'),
         audioSeconds: z.number().optional().describe('Seedance engine + audioMethod=upload: the audio file\'s duration in seconds — sets the output length (4-15s).'),
         background: z.boolean().optional().describe(BACKGROUND_DESCRIBE),
-        confirm: z.boolean().optional().describe('Set true to bypass the >$0.50 cost confirm gate. Required for avatar-pro.'),
+        confirm: z.boolean().optional().describe('Set true to bypass the confirm gate. Required for avatar-pro.'),
     }),
     async run(input, ctx) {
         if (input.audioMethod === 'tts' && !input.ttsText) {
@@ -1696,12 +1774,12 @@ export const generateLipSync = {
         const entry = registry.models.find((m) => m.model === costKey);
         if (!entry)
             throw new Error(`Model variant not in registry: ${costKey}`);
-        const totalCents = entry.cost_cents;
+        const totalCents = creditCost(entry);
         // Cost confirm gate. Lip-sync is mechanical — the model re-syncs the
         // user-chosen source to the user-chosen audio. The agent doesn't
         // write a prompt that depends on what the source looks like, so we
         // skip the inline preview and just announce the source code in text.
-        if (totalCents > 50 && !input.confirm) {
+        if (totalCents > CONFIRM_CREDITS && !input.confirm) {
             const sourceRef = await lookupAssetRef(ctx.desktop(), input.sourceAssetId);
             const audioPreview = input.audioMethod === 'tts'
                 ? `Audio: TTS — "${(input.ttsText ?? '').slice(0, 120)}"`
@@ -1710,9 +1788,9 @@ export const generateLipSync = {
                 requires_confirm: true,
                 variant: costKey,
                 estimated_cents: totalCents,
-                estimated_dollars: (totalCents / 100).toFixed(2),
+                estimated_credits: totalCents,
                 source_ref: sourceRef,
-                message: `Cost: $${(totalCents / 100).toFixed(2)} for ${isSeedance ? `${seedanceDuration}s Seedance` : '5s'} lip-sync (${costKey}). ` +
+                message: `Cost: ${fmtCredits(totalCents)} for ${isSeedance ? `${seedanceDuration}s Seedance` : '5s'} lip-sync (${costKey}). ` +
                     `Source: ${sourceRef}. ${audioPreview}. ` +
                     `Re-call with confirm=true after the user explicitly OKs the spend. ` +
                     `When discussing with the user, refer to the source by its code (matches the gallery badge).`,
@@ -1761,12 +1839,12 @@ export const generateLipSync = {
                 projectId: input.projectId,
                 sourceAssetId: input.sourceAssetId,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
             });
         }
         return {
             text: `Generated ${isSeedance ? `${seedanceDuration}s` : '5s'} lip-sync (${costKey}) into project ${input.projectId} ` +
-                `for $${(totalCents / 100).toFixed(2)} (${totalCents}¢). ` +
+                `for ${fmtCredits(totalCents)}. ` +
                 (input.audioMethod === 'tts'
                     ? `Spoken: "${(input.ttsText ?? '').slice(0, 60)}${(input.ttsText ?? '').length > 60 ? '...' : ''}"`
                     : `Audio: ${input.audioFilePath}`),
@@ -1776,7 +1854,7 @@ export const generateLipSync = {
                 sourceType: input.sourceType,
                 sourceAssetId: input.sourceAssetId,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
                 asset: result.asset,
                 generationId: result.generationId,
             },
@@ -1791,7 +1869,7 @@ export const generateMotionTransfer = {
         projectId: z.string().uuid().describe('Slates project. Both source and target assets must live here.'),
         sourceVideoAssetId: z.string().uuid().describe('Asset id of the reference video — its motion will be retargeted onto the target image. Must already exist in the project. Seedance engine: 2-15s clips only.'),
         targetImageAssetId: z.string().uuid().describe('Asset id of the target image (the character that will perform the motion). Must already exist in the project.'),
-        motionModel: z.enum(['kling-mc-std', 'kling-mc-pro', 'seedance-2']).optional().describe('kling-mc-std ($0.95) general motion; kling-mc-pro ($1.26) cleaner anatomy — default. seedance-2 = premium single-pass lane (prompt-driven, native audio, input+output-second billing) — pick when motion fidelity or audio matters.'),
+        motionModel: z.enum(['kling-mc-std', 'kling-mc-pro', 'seedance-2']).optional().describe('kling-mc-std (~32 credits) general motion; kling-mc-pro (~42 credits) cleaner anatomy — default. seedance-2 = premium single-pass lane (prompt-driven, native audio, input+output-second billing) — pick when motion fidelity or audio matters.'),
         characterOrientation: z.enum(['video', 'image']).optional().describe('Kling only. "video" = use the source video\'s framing. "image" = use the target image\'s framing. Default video.'),
         prompt: z.string().optional().describe('Kling: optional refinement. Seedance: THE driver — describe what the character does with the motion from the clip (ordinal references: "the character from image 1 performs the motion from video 1"). A sensible default recipe is used if omitted. Read slates-prompting-motion-transfer.'),
         klingProvider: z.enum(['fal', 'kling']).optional().describe('Kling engine only — provider routing. "fal" (default) uses Slates credits.'),
@@ -1803,7 +1881,7 @@ export const generateMotionTransfer = {
         realFaceConsent: z.boolean().optional().describe('MANDATORY with seedanceRealFace — set true only after the user explicitly confirms they hold rights/consent to the likeness.'),
         sourceVideoSeconds: z.number().optional().describe('Seedance engine: the driving clip\'s duration in seconds (from the asset listing, 2-15s). Feeds the vref cost key (input+output billing).'),
         background: z.boolean().optional().describe(BACKGROUND_DESCRIBE),
-        confirm: z.boolean().optional().describe('Set true to bypass the >$0.50 confirm gate. Required — both tiers exceed.'),
+        confirm: z.boolean().optional().describe('Set true to bypass the confirm gate. Required — both tiers exceed.'),
     }),
     async run(input, ctx) {
         const motionModel = input.motionModel ?? 'kling-mc-pro';
@@ -1843,12 +1921,12 @@ export const generateMotionTransfer = {
         const entry = registry.models.find((m) => m.model === costKey);
         if (!entry)
             throw new Error(`Model variant not in registry: ${costKey}`);
-        const totalCents = entry.cost_cents;
+        const totalCents = creditCost(entry);
         // Cost confirm gate. Motion transfer is mechanical — the model
         // applies source motion to target image deterministically. We don't
         // burn tokens previewing assets the user already chose; codes in the
         // text are enough to keep the chat unambiguous.
-        if (totalCents > 50 && !input.confirm) {
+        if (totalCents > CONFIRM_CREDITS && !input.confirm) {
             const desktop = ctx.desktop();
             const [source, target] = await Promise.all([
                 lookupAssetRef(desktop, input.sourceVideoAssetId),
@@ -1858,12 +1936,12 @@ export const generateMotionTransfer = {
                 requires_confirm: true,
                 variant: costKey,
                 estimated_cents: totalCents,
-                estimated_dollars: (totalCents / 100).toFixed(2),
+                estimated_credits: totalCents,
                 source_ref: source,
                 target_ref: target,
-                message: `Cost: $${(totalCents / 100).toFixed(2)} for ${isSeedance ? `${seedanceDuration}s Seedance motion transfer` : `5s ${motionModel}`} (${costKey}). ` +
+                message: `Cost: ${fmtCredits(totalCents)} for ${isSeedance ? `${seedanceDuration}s Seedance motion transfer` : `5s ${motionModel}`} (${costKey}). ` +
                     `Transferring motion from ${source} onto ${target}. ` +
-                    `Re-call with confirm=true after the user explicitly OKs the spend${isSeedance ? '' : ', or pick kling-mc-std to save $0.31'}. ` +
+                    `Re-call with confirm=true after the user explicitly OKs the spend${isSeedance ? '' : ', or pick kling-mc-std to save ~10 credits'}. ` +
                     `When discussing with the user, refer to the assets by those codes — they'll match the gallery badges.`,
             });
         }
@@ -1908,12 +1986,12 @@ export const generateMotionTransfer = {
                 sourceVideoAssetId: input.sourceVideoAssetId,
                 targetImageAssetId: input.targetImageAssetId,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
             });
         }
         return {
             text: `Generated ${isSeedance ? `${seedanceDuration}s` : '5s'} motion transfer (${motionModel}) into project ${input.projectId} ` +
-                `for $${(totalCents / 100).toFixed(2)} (${totalCents}¢).` +
+                `for ${fmtCredits(totalCents)}.` +
                 (input.prompt ? ` Prompt: "${input.prompt.slice(0, 60)}${input.prompt.length > 60 ? '...' : ''}"` : ''),
             data: {
                 variant: costKey,
@@ -1922,7 +2000,7 @@ export const generateMotionTransfer = {
                 sourceVideoAssetId: input.sourceVideoAssetId,
                 targetImageAssetId: input.targetImageAssetId,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
                 asset: result.asset,
                 generationId: result.generationId,
             },
@@ -1932,15 +2010,15 @@ export const generateMotionTransfer = {
 // ── Edit video (Kling O3 video-to-video) ────────────────────────
 export const editVideo = {
     id: 'slates_edit_video',
-    description: 'Edit an EXISTING video clip with one instruction via Kling O3 video-to-video edit — character swap, environment change, style transfer — in one pass, no masking. Original motion, camera, and audio are preserved; only what the prompt names changes. Use when a clip is ~90% right (fix it, don\'t re-roll it) or to AI-edit the user\'s own footage. Source clip constraints: 3–15s, 720–3840px, MP4/MOV. Cost = per second of OUTPUT (≈ clip length, rounded UP to the next second): kling-v3.0-omni-edit ≈ 19¢/s, kling-v3.0-omni-pro-edit ≈ 25¢/s. Subjects to swap IN go as characterAssetIds (frontal + angle images become Kling elements); style refs as styleAssetIds; max 4 combined. The edited clip saves as a NEW asset linked to its parent (chain edits freely). Routing: Kling edit is the default edit tool (element lock + audio intact); prefer Seedance edit/relocate only for style-transfer-heavy jobs — see slates-model-selection. Prompting: slates-prompting-kling-v3 §Edit.',
+    description: 'Edit an EXISTING video clip with one instruction — character swap, environment change, style transfer — in one pass, no masking. Original motion, camera, and audio are preserved; only what the prompt names changes. Use when a clip is ~90% right (fix it, don\'t re-roll it) or to AI-edit the user\'s own footage. Engines: Kling O3 edit (default; 3–15s clips, 720–3840px, subject/style refs via elements) or omni-flash-edit (Gemini Omni Flash; 3–10s clips, 720p output, PROMPT-ONLY — no refs, cheapest seat). Cost = per second of OUTPUT (≈ clip length, rounded UP to the next second): omni-flash-edit ≈ 19¢/s ≈ kling-v3.0-omni-edit ≈ 19¢/s, kling-v3.0-omni-pro-edit ≈ 25¢/s. Subjects to swap IN go as characterAssetIds (frontal + angle images become Kling elements — Kling models only); style refs as styleAssetIds; max 4 combined. The edited clip saves as a NEW asset linked to its parent (chain edits freely). Routing: Kling edit is the default edit tool (element lock + audio intact); omni-flash-edit for cheap prompt-only footage-synced swaps; prefer Seedance edit/relocate only for style-transfer-heavy jobs — see slates-model-selection. Prompting: slates-prompting-kling-v3 §Edit / slates-prompting-omni-flash.',
     input: z.object({
         projectId: z.string().uuid().describe('Project the source clip lives in.'),
-        sourceVideoAssetId: z.string().describe('The VIDEO asset to edit — UUID or badge code ("VID-V3", bare "V3"); codes resolve against the project at call time. 3–15s clips only.'),
-        prompt: z.string().min(1).max(2500).describe('The change, not the whole scene — e.g. "replace the man with @marcus", "make it a rainy night", "turn the street into a neon Tokyo alley". Mention subjects with @name; the transport compiles them to Kling\'s @ElementN notation.'),
-        model: z.enum(['kling-v3.0-omni-edit', 'kling-v3.0-omni-pro-edit']).optional().describe('Default kling-v3.0-omni-edit. Pro (~25¢/s vs ~19¢/s) only for hero shots where fidelity matters.'),
-        characterAssetIds: z.array(z.string()).max(4).optional().describe('Subject/element image assets to swap IN (UUIDs or badge codes). Each becomes a Kling element (@ElementN).'),
-        styleAssetIds: z.array(z.string()).max(4).optional().describe('Style/appearance reference images (@ImageN). Max 4 combined with characterAssetIds.'),
-        keepAudio: z.boolean().optional().describe('Preserve the original audio track (default true).'),
+        sourceVideoAssetId: z.string().describe('The VIDEO asset to edit — UUID or badge code ("VID-V3", bare "V3"); codes resolve against the project at call time. Kling: 3–15s clips; omni-flash-edit: 3–10s.'),
+        prompt: z.string().min(1).max(2500).describe('The change, not the whole scene — e.g. "replace the man with @marcus", "make it a rainy night", "turn the street into a neon Tokyo alley". Mention subjects with @name; the transport compiles them to Kling\'s @ElementN notation (Kling models). For omni-flash-edit keep it simple and add "Keep everything else the same."'),
+        model: z.enum(['kling-v3.0-omni-edit', 'kling-v3.0-omni-pro-edit', 'omni-flash-edit']).optional().describe('Default kling-v3.0-omni-edit. Pro (~25¢/s vs ~19¢/s) only for hero shots where fidelity matters. omni-flash-edit (~19¢/s, 720p, 3–10s) for prompt-only edits — it takes NO character/style refs.'),
+        characterAssetIds: z.array(z.string()).max(4).optional().describe('Subject/element image assets to swap IN (UUIDs or badge codes). Each becomes a Kling element (@ElementN). KLING MODELS ONLY — rejected on omni-flash-edit.'),
+        styleAssetIds: z.array(z.string()).max(4).optional().describe('Style/appearance reference images (@ImageN). Max 4 combined with characterAssetIds. KLING MODELS ONLY — rejected on omni-flash-edit.'),
+        keepAudio: z.boolean().optional().describe('Preserve the original audio track (default true; Kling models only — omni-flash-edit output carries its own audio).'),
         background: z.boolean().optional().describe(BACKGROUND_DESCRIBE),
         confirm: z.boolean().optional().describe('Set true to bypass the cost confirm gate after the user OKs the spend.'),
     }),
@@ -1951,6 +2029,12 @@ export const editVideo = {
             await desktop.requireCapability('background-generation', 'background generation');
         }
         const model = input.model ?? 'kling-v3.0-omni-edit';
+        const isOmniFlashEdit = model === 'omni-flash-edit';
+        // Kling edit: 3–15s source clips; Omni Flash edit: 3–10s.
+        const maxClipSeconds = isOmniFlashEdit ? 10 : 15;
+        if (isOmniFlashEdit && ((input.characterAssetIds?.length ?? 0) > 0 || (input.styleAssetIds?.length ?? 0) > 0)) {
+            throw new Error('omni-flash-edit is prompt-only — it takes no character/style reference images. Drop the refs, or switch to kling-v3.0-omni-edit which supports elements.');
+        }
         // Resolve refs (UUIDs or badge codes) against the project AT CALL TIME.
         const refInputs = [
             { ref: input.sourceVideoAssetId, role: 'source clip' },
@@ -1978,27 +2062,28 @@ export const editVideo = {
         if (!Number.isFinite(clipSeconds) || clipSeconds <= 0) {
             throw new Error('Source clip has no recorded duration — cannot quote the edit. Re-import the clip or pick another.');
         }
-        if (clipSeconds > 15.05 || clipSeconds < 2.95) {
-            throw new Error(`Source clip is ${clipSeconds.toFixed(1)}s — Kling O3 edit accepts 3–15s. Trim it first (agents can pre-trim on the timeline).`);
+        if (clipSeconds > maxClipSeconds + 0.05 || clipSeconds < 2.95) {
+            throw new Error(`Source clip is ${clipSeconds.toFixed(1)}s — ${model} accepts 3–${maxClipSeconds}s. ` +
+                `Trim it first with slates_trim_video (e.g. inSec 0, outSec ${maxClipSeconds}), then edit the trimmed clip.`);
         }
-        const billedSeconds = Math.min(15, Math.max(3, Math.ceil(clipSeconds - 0.05)));
-        const costKey = klingEditCostKey(model, billedSeconds);
+        const billedSeconds = Math.min(maxClipSeconds, Math.max(3, Math.ceil(clipSeconds - 0.05)));
+        const costKey = isOmniFlashEdit ? omniFlashEditCostKey(billedSeconds) : klingEditCostKey(model, billedSeconds);
         const cloud = ctx.cloud();
         const registry = await cloud.get('/api/agent/models');
         const entry = registry.models.find((m) => m.model === costKey);
         if (!entry)
             throw new Error(`Model variant not in registry: ${costKey}`);
-        const totalCents = entry.cost_cents;
+        const totalCents = creditCost(entry);
         // Confirm gate — look-first: preview the source clip + refs so the LLM
         // sees what it's editing before committing spend (mirrors generateVideo).
-        if ((totalCents > 50 || refInputs.length > 1) && !input.confirm) {
+        if ((totalCents > CONFIRM_CREDITS || refInputs.length > 1) && !input.confirm) {
             const previews = await previewAssets(ctx, [
                 { id: sourceId, type: 'video', role: 'source clip' },
                 ...characterAssetIds.map((id) => ({ id, type: 'image', role: 'subject element' })),
                 ...styleAssetIds.map((id) => ({ id, type: 'image', role: 'style' })),
             ]);
             return {
-                text: `Cost: $${(totalCents / 100).toFixed(2)} (${totalCents}¢) to edit a ${billedSeconds}s clip with ${model} (${costKey}). ` +
+                text: `Cost: ${fmtCredits(totalCents)} to edit a ${billedSeconds}s clip with ${model} (${costKey}). ` +
                     `${refEcho} Re-call with confirm=true after the user explicitly OKs the spend.`,
                 images: previews.flatMap((p) => p.images),
                 data: {
@@ -2008,7 +2093,7 @@ export const editVideo = {
                     billed_seconds: billedSeconds,
                     clip_seconds: clipSeconds,
                     estimated_cents: totalCents,
-                    estimated_dollars: (totalCents / 100).toFixed(2),
+                    estimated_credits: totalCents,
                     references: previews.map((p) => ({ ref: p.ref, role: p.role, ...p.meta })),
                 },
             };
@@ -2033,12 +2118,12 @@ export const editVideo = {
                 projectId: input.projectId,
                 sourceVideoAssetId: sourceId,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
             }, refEcho);
         }
         return {
             text: `Edited ${billedSeconds}s clip saved as a new asset in project ${input.projectId} ` +
-                `for $${(totalCents / 100).toFixed(2)} (${totalCents}¢) via ${model}. ` +
+                `for ${fmtCredits(totalCents)} via ${model}. ` +
                 `Edit: "${input.prompt.slice(0, 60)}${input.prompt.length > 60 ? '...' : ''}"` +
                 (refEcho ? ` ${refEcho}` : ''),
             data: {
@@ -2048,13 +2133,48 @@ export const editVideo = {
                 sourceVideoAssetId: sourceId,
                 billed_seconds: billedSeconds,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
                 asset: result.asset,
                 generationId: result.generationId,
             },
         };
     },
 };
+// ── Trim a video to an exact window (fit-to-model primitive) ────
+export const trimVideo = {
+    id: 'slates_trim_video',
+    description: 'Trim a video asset to an exact [inSec, outSec] window and save the result as a NEW clip linked to the original (the original is untouched). This is the fit-to-model primitive: an 11s clip will not run on omni-flash-edit (3–10s) or Kling edit (3–15s), and a Seedance video reference must be 2–15s — trim it first, then edit/relocate the trimmed clip. EXACT re-encode (not a keyframe-snapped cut) so the result honors hard duration caps to the frame; any phone rotation flag is baked into the pixels in the same pass. The new clip lands with correct duration/width/height immediately. inSec defaults to 0.',
+    input: z.object({
+        projectId: z.string().uuid().describe('Project the clip lives in.'),
+        assetId: z
+            .string()
+            .describe('The VIDEO asset to trim — UUID or badge code ("VID-V3", bare "V3"); resolves against the project at call time.'),
+        inSec: z.number().min(0).optional().describe('Trim start in seconds (default 0).'),
+        outSec: z.number().positive().describe('Trim end in seconds. Must be greater than inSec.'),
+    }),
+    async run(input, ctx) {
+        const desktop = ctx.desktop();
+        const resolved = await resolveAssetRefs(ctx, input.projectId, [input.assetId]);
+        const assetId = resolved.get(input.assetId)?.id ?? input.assetId;
+        const inSec = input.inSec ?? 0;
+        if (input.outSec - inSec < 0.05) {
+            throw new Error('outSec must be at least ~0.1s after inSec.');
+        }
+        const r = await desktop.post('/agent/assets/trim-video', {
+            assetId,
+            inSec,
+            outSec: input.outSec,
+        });
+        const a = r.asset;
+        const name = a?.code ?? a?.id ?? 'new clip';
+        return {
+            text: `Trimmed clip saved as ${name}${a?.label ? ` — ${a.label}` : ''} ` +
+                `(${(input.outSec - inSec).toFixed(1)}s, ${inSec.toFixed(1)}–${input.outSec.toFixed(1)}s). ` +
+                `Edit or generate from it by its new id/code.`,
+            data: { asset: r.asset },
+        };
+    },
+};
 // ── Generation status (background mode) ─────────────────────────
 export const getGenerationStatus = {
     id: 'slates_get_generation_status',
@@ -2086,7 +2206,7 @@ export const getGenerationStatus = {
                 // agent acts on, with the EXACT billed cost front and center.
                 return ok({
                     status,
-                    cost_cents: g.cost ?? null,
+                    cost_credits: g.cost != null ? creditsFromDollars(g.cost) : null,
                     error: g.error ?? null,
                     model: g.model,
                     completed_at: g.completedAt ?? null,
@@ -2561,6 +2681,8 @@ function resolveGuideTopic(topic) {
         return 'slates-prompting-seedream-5-lite';
     if (t.startsWith('veo'))
         return 'slates-prompting-veo-3';
+    if (t.startsWith('omni-flash') || t.startsWith('gemini-omni') || t === 'omni flash')
+        return 'slates-prompting-omni-flash';
     if (t.startsWith('kling-mc'))
         return 'slates-prompting-motion-transfer';
     if (t === 'edit-video' || t === 'video-edit' || t === 'edit video' || t === 'video edit')
@@ -2643,6 +2765,7 @@ export const ALL_OPERATIONS = [
     generateLipSync,
     generateMotionTransfer,
     editVideo,
+    trimVideo,
     editImage,
     getGenerationStatus,
     listGenerations,