@slatesvideo/shared 0.4.8 → 0.5.1

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,41 +115,53 @@ 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)'),
         duration: z.number().int().min(3).max(15).optional().describe('Video only — seconds. Cost scales linearly; required with a video base id.'),
         videoResolution: z.enum(['480p', '720p', '1080p', '4k']).optional().describe('Video only. Seedance defaults to 1080p.'),
-        resolution: z.enum(['1k', '2k', '4k']).optional().describe('Image only (default 2k).'),
+        resolution: z.enum(['1k', '2k', '3k', '4k']).optional().describe('Image only (default 2k; 3k = gpt-image-2 1440p class).'),
+        quality: z.enum(['medium', 'high']).optional().describe('gpt-image-2 only — quality tier (default medium).'),
         sound: z.boolean().optional().describe('Veo only — audio flag changes the cost key.'),
         seedanceFace: z.boolean().optional().describe('Seedance AI-face route (pricier key).'),
         seedanceRealFace: z.boolean().optional().describe('Seedance consented real-face route (premium key).'),
     }),
     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
+        // 2) image base id + resolution (+ quality for gpt-image-2)
         if (!key) {
-            const img = ['nano-banana-2', 'flux-2-max', 'seedream-5-lite'].find((m) => m === input.model);
+            const img = ['nano-banana-2', 'nano-banana-2-lite', 'nano-banana-pro', 'gpt-image-2', 'flux-2-max', 'seedream-5-lite'].find((m) => m === input.model);
             if (img)
-                key = imageCostKey(img, input.resolution ?? '2k');
+                key = imageCostKey(img, input.resolution ?? (img === 'nano-banana-2-lite' ? '1k' : '2k'), input.quality ?? 'medium');
+        }
+        // 2b) Kling O3 edit base id + duration (ceiled source-clip length)
+        if (!key && (input.model === 'kling-v3.0-omni-edit' || input.model === 'kling-v3.0-omni-pro-edit')) {
+            if (!input.duration) {
+                return ok({
+                    requires_clarification: true,
+                    missing: ['duration'],
+                    message: 'Kling O3 edit bills per second of output (≈ the source clip length, rounded up) — pass duration.',
+                });
+            }
+            key = klingEditCostKey(input.model, input.duration);
         }
         // 3) video base id (or cost-key spelling) → the same forgiving resolver
         //    the generate op uses, so the two can never disagree about a model.
@@ -152,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 ────────────────────────────────────────────────────
@@ -561,7 +596,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(),
@@ -721,31 +756,39 @@ async function previewAssets(ctx, refs) {
     }
     return out;
 }
-// ── Generation (cloud-routed, credits-default) ──────────────────
 // Registry cost-key for an image model+resolution. Mirrors imageCreditKey()
-// in slate/src/shared/pricing.ts: NB2 prices per resolution, FLUX.2 Max prices
-// per resolution (1k is the bare key), Seedream is flat (one key).
-function imageCostKey(model, resolution) {
+// in slate/src/shared/pricing.ts — MUST byte-match it (the same hard rule as
+// videoCostKey): NB2/NB Pro price per resolution, FLUX.2 Max prices per
+// resolution (1k is the bare key), NB2 Lite/Seedream are flat, GPT Image 2 is
+// quality × resolution-class (med|high; low deliberately not exposed).
+function imageCostKey(model, resolution, quality = 'medium') {
     if (model === 'flux-2-max')
         return resolution === '1k' ? 'flux-2-max' : `flux-2-max-${resolution}`;
     if (model === 'seedream-5-lite')
         return 'seedream-5-lite';
+    if (model === 'nano-banana-2-lite')
+        return 'nano-banana-2-lite';
+    if (model === 'nano-banana-pro')
+        return `nano-banana-pro-${resolution}`;
+    if (model === 'gpt-image-2')
+        return `gpt-image-2-${quality === 'high' ? 'high' : 'med'}-${resolution}`;
     return `nano-banana-2-${resolution}`;
 }
 export const generateImage = {
     id: 'slates_generate_image',
-    description: 'Generate an image via Slates credits. Three models: nano-banana-2 (Google Gemini 3 Image — default, strongest general image model, well-censored), flux-2-max (FLUX.2 Max — photoreal, less censored, up to 4MP), seedream-5-lite (cheapest at ~$0.05 flat, less censored). Pass projectId to save into a Slates project (recommended — asset appears live in the desktop UI). FLUX.2 Max and Seedream 5 Lite REQUIRE projectId (no headless path). REQUIRED before calling: read the slates-cost-discipline skill (and slates-prompting-nano-banana-2 when using nano-banana-2). You MUST pass aspectRatio and resolution explicitly (the server returns requires_clarification when missing — defaults waste credits). Cost > $0.50 returns requires_confirm — pass confirm=true after explicit user OK. MCP/CLI generation always charges credits. No skill files installed? Call slates_get_prompting_guide with the model\'s topic (and \'slates-cost-discipline\') before first use.',
+    description: 'Generate an image via Slates credits. Models: nano-banana-2 (default), nano-banana-2-lite (fast/cheap drafts, 1K only), nano-banana-pro (hero-frame/typography premium), gpt-image-2 (sharp text / character sheets / grids; quality medium|high), flux-2-max (photoreal, less censored), seedream-5-lite (cheapest flat, less censored). Which model for which job: read the slates-model-selection skill. Pass projectId to save into a Slates project (recommended — asset appears live in the desktop UI). All models except nano-banana-2 REQUIRE projectId (no headless path). REQUIRED before calling: read the slates-cost-discipline skill (and the model\'s slates-prompting-* skill). You MUST pass aspectRatio and resolution explicitly (the server returns requires_clarification when missing — defaults waste credits). Cost > $0.50 returns requires_confirm — pass confirm=true after explicit user OK. MCP/CLI generation always charges credits. No skill files installed? Call slates_get_prompting_guide with the model\'s topic (and \'slates-cost-discipline\') before first use.',
     input: z.object({
         prompt: z.string().min(1).max(4000),
-        model: z.enum(['nano-banana-2', 'flux-2-max', 'seedream-5-lite']).optional().describe('Image model. Default nano-banana-2. Use flux-2-max for photoreal / less-censored, seedream-5-lite for cheapest. flux-2-max & seedream-5-lite require projectId.'),
-        projectId: z.string().uuid().optional().describe('Save into this Slates project. Renderer refreshes live. Required for flux-2-max / seedream-5-lite.'),
-        resolution: z.enum(['1k', '2k', '4k']).optional().describe('Pick deliberately: 1k drafts, 2k hero shots, 4k print/final. (Seedream is flat-priced regardless; FLUX & NB2 price by resolution.) Never default this.'),
+        model: z.enum(['nano-banana-2', 'nano-banana-2-lite', 'nano-banana-pro', 'gpt-image-2', 'flux-2-max', 'seedream-5-lite']).optional().describe('Image model. Default nano-banana-2. Routing doctrine: slates-model-selection skill. All except nano-banana-2 require projectId.'),
+        projectId: z.string().uuid().optional().describe('Save into this Slates project. Renderer refreshes live. Required for every model except nano-banana-2.'),
+        resolution: z.enum(['1k', '2k', '3k', '4k']).optional().describe('Pick deliberately: 1k drafts, 2k hero shots, 4k print/final. nano-banana-2-lite is 1k-only. gpt-image-2 classes: 1k=1024², 2k=1080p, 3k=1440p, 4k=2160p (3k is gpt-image-2 only). Never default this.'),
+        quality: z.enum(['medium', 'high']).optional().describe('gpt-image-2 only. medium (default) = sharp text, fast, the value seat; high = max text precision + reasoning at ~4× the price. Ignored by other models.'),
         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('Pick deliberately from the use case. Cinematic → 16:9. TikTok/Reels/Story → 9:16. IG square → 1:1. Ultra-wide → 21:9. Ask the user when ambiguous.'),
         count: z.number().int().min(1).max(4).optional(),
         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.
@@ -769,7 +812,16 @@ export const generateImage = {
         }
         const resolution = input.resolution;
         const imageModel = input.model ?? 'nano-banana-2';
-        // FLUX.2 Max / Seedream 5 Lite have no headless path — they route through
+        // The '3k' class exists only on gpt-image-2 (2560×1440); other models
+        // would mis-key the registry lookup.
+        if (resolution === '3k' && imageModel !== 'gpt-image-2') {
+            return ok({
+                requires_clarification: true,
+                missing: ['resolution'],
+                message: `3k (1440p) is a gpt-image-2 resolution class — pick 1k/2k/4k for ${imageModel}.`,
+            });
+        }
+        // Only nano-banana-2 has a headless path — everything else routes through
         // the desktop generation pipeline, which needs a project.
         if (imageModel !== 'nano-banana-2' && !input.projectId) {
             return ok({
@@ -810,32 +862,39 @@ export const generateImage = {
         if (input.background) {
             await ctx.desktop().requireCapability('background-generation', 'background generation');
         }
-        const costKey = imageCostKey(imageModel, resolution);
+        // New-roster models need a desktop that knows them — an older desktop's
+        // allowlist would silently fall back to nano-banana-2 while we quote the
+        // new model's price.
+        if (input.projectId &&
+            (imageModel === 'gpt-image-2' || imageModel === 'nano-banana-pro' || imageModel === 'nano-banana-2-lite')) {
+            await ctx.desktop().requireCapability('image-models-v2', `${imageModel} generation`);
+        }
+        const costKey = imageCostKey(imageModel, resolution, input.quality ?? 'medium');
         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 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. ` +
@@ -847,7 +906,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,
@@ -876,6 +935,7 @@ export const generateImage = {
                 resolution,
                 aspectRatio: input.aspectRatio ?? '1:1',
                 count: input.count ?? 1,
+                ...(imageModel === 'gpt-image-2' ? { gptQuality: input.quality ?? 'medium' } : {}),
                 ...(referenceAssetIds.length > 0 ? { referenceAssetIds } : {}),
                 background: input.background,
             });
@@ -894,7 +954,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
@@ -920,7 +980,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,
@@ -931,7 +991,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.
@@ -990,7 +1050,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: {
@@ -1000,7 +1060,7 @@ export const generateImage = {
                 aspectRatio: input.aspectRatio,
                 resolution,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
             },
         };
     },
@@ -1034,11 +1094,12 @@ export const editImage = {
         projectId: z.string().uuid(),
         sourceAssetId: z.string().uuid().describe('Image asset to edit. Must already exist in the project.'),
         prompt: z.string().min(1).max(4000).describe('The edit instruction — describe the change, not the whole image.'),
-        editModel: z.enum(['nano-banana-2', 'flux-2-max', 'seedream-5-lite']).optional(),
-        referenceAssetIds: z.array(z.string().uuid()).max(13).optional().describe('nano-banana-2 only: extra reference images.'),
-        resolution: z.enum(['1k', '2k', '4k']).optional(),
+        editModel: z.enum(['nano-banana-2', 'nano-banana-2-lite', 'nano-banana-pro', 'gpt-image-2', 'flux-2-max', 'seedream-5-lite']).optional(),
+        referenceAssetIds: z.array(z.string().uuid()).max(13).optional().describe('Nano-Banana family only: extra reference images (NB Pro takes up to 13, NB2 Lite up to 3).'),
+        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) {
@@ -1048,27 +1109,30 @@ export const editImage = {
             await desktop.requireCapability('background-generation', 'background generation');
         }
         const editModel = input.editModel ?? 'nano-banana-2';
-        const resolution = input.resolution ?? '2k';
-        // NB2 edits charge the normal per-resolution NB2 key; FLUX / Seedream
-        // route to their dedicated edit endpoints, priced under '-edit' keys.
-        const costKey = editModel === 'nano-banana-2'
-            ? imageCostKey('nano-banana-2', resolution)
-            : `${imageCostKey(editModel, resolution)}-edit`;
+        const resolution = input.resolution ?? (editModel === 'nano-banana-2-lite' ? '1k' : '2k');
+        if ((editModel === 'gpt-image-2' || editModel === 'nano-banana-pro' || editModel === 'nano-banana-2-lite')) {
+            await desktop.requireCapability('image-models-v2', `${editModel} editing`);
+        }
+        // Nano-Banana family + GPT Image 2 edits charge the same key as gen;
+        // FLUX / Seedream route to dedicated edit endpoints priced under '-edit' keys.
+        const costKey = editModel === 'flux-2-max' || editModel === 'seedream-5-lite'
+            ? `${imageCostKey(editModel, resolution)}-edit`
+            : imageCostKey(editModel, resolution, input.quality ?? 'medium');
         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 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).`,
             });
@@ -1080,6 +1144,7 @@ export const editImage = {
             editModel,
             referenceAssetIds: input.referenceAssetIds,
             resolution,
+            ...(editModel === 'gpt-image-2' ? { gptQuality: input.quality ?? 'medium' } : {}),
             aspectRatio: input.aspectRatio,
             background: input.background,
         });
@@ -1093,7 +1158,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 —
@@ -1111,7 +1176,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: {
@@ -1121,7 +1186,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,
             },
@@ -1152,16 +1217,27 @@ const KLING_TIER_MAP = {
     'kling-v3.0-std': 'kling-v3-standard',
     'kling-v3.0-pro': 'kling-v3-pro',
     'kling-v3.0-omni': 'kling-v3-omni',
+    // Missing until 2026-07-05 — the fallthrough quoted a nonexistent
+    // 'kling-v3.0-omni-pro-…' key for O3 Pro (caught by the consistency check
+    // the day omni-pro was added to its coverage).
+    'kling-v3.0-omni-pro': 'kling-v3-omni-pro',
 };
 // Exported for scripts/pricing-consistency-check.mjs (slates-api repo), which
 // asserts this builder byte-matches the desktop's klingCreditKey/seedanceCreditKey.
 export function videoCostKey(input) {
     if (input.model.startsWith('seedance')) {
-        // Mirrors seedanceCreditKey() in slate/src/shared/pricing.ts (face × res × duration).
-        // AI-face route bills the `-face-` key (~45% over faceless); consented
-        // real-person route bills the premium `-realface-` key (fal partner endpoint).
+        // Mirrors seedanceCreditKey() in slate/src/shared/pricing.ts (face × vref ×
+        // res × duration). AI-face route bills the `-face-` key (~45% over faceless);
+        // consented real-person route bills the premium `-realface-` key (fal partner
+        // endpoint). A reference video flips to `-vref-{res}-{T}s`, T = in + out (6..30).
         const res = input.videoResolution ?? '1080p';
         const face = input.seedanceRealFace ? '-realface' : input.seedanceFace ? '-face' : '';
+        const vrefSecs = input.videoRefSeconds ?? 0;
+        if (vrefSecs > 0) {
+            // ceil(x - 0.05) matches the server's probe rounding — quote = bill.
+            const total = Math.min(30, Math.max(6, Math.ceil(vrefSecs - 0.05) + input.duration));
+            return `${input.model}${face}-vref-${res}-${total}s`;
+        }
         return `${input.model}${face}-${res}-${input.duration}s`;
     }
     if (input.model.startsWith('veo')) {
@@ -1178,16 +1254,26 @@ export function videoCostKey(input) {
     if (input.model.startsWith('kling-v3.0')) {
         // Mirrors klingCreditKey() in slate/src/shared/pricing.ts. Kling native 4K
         // bills flat-rate keys: std/pro/omni all get a `-4k` tier key, and omni-pro
-        // shares kling-v3-omni-4k (the o3/4k endpoint has one flat rate).
+        // shares kling-v3-omni-4k (the o3/4k endpoint has one flat rate, audio
+        // included). At 1080p AUDIO IS A KEY DIMENSION (credits = COGS × markup,
+        // locked 2026-07-05): sound → `-audio` variant. Kling sound defaults OFF.
         const tier = KLING_TIER_MAP[input.model] ?? input.model;
         if (input.videoResolution === '4k') {
             const tier4k = tier === 'kling-v3-omni-pro' ? 'kling-v3-omni' : tier;
             return `${tier4k}-4k-${input.duration}s`;
         }
-        return `${tier}-${input.duration}s`;
+        return `${tier}-${input.duration}s${input.sound === true ? '-audio' : ''}`;
     }
     throw new Error(`Unknown video model: ${input.model}`);
 }
+// Kling O3 video-to-video edit cost key — mirrors klingEditCreditKey() in
+// slate/src/shared/pricing.ts (must byte-match; checked by the slates-api
+// pricing-consistency script). Duration is the CEILED source-clip length —
+// billing is per second of output ≈ source length, always rounded up.
+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`;
+}
 /**
  * Forgiving model-id resolver. Agents routinely paste registry COST keys
  * ("kling-v3-standard-8s", "seedance-2-1080p-8s") into the `model` param —
@@ -1271,7 +1357,9 @@ export const generateVideo = {
         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.'),
-        videoReferenceAssetId: z.string().optional().describe('Seedance ONLY: an existing VIDEO asset (UUID or badge code) to use as a reference (edit / relocate an existing clip — Seedance ref-to-video). 2-15s. If the clip contains a human/AI character, pair with seedanceFace=true so it routes to the face-capable provider (the default Seedance route blocks people). Ignored by Kling/Veo.'),
+        videoReferenceAssetId: z.string().optional().describe('Seedance ONLY: an existing VIDEO asset (UUID or badge code) to use as a reference — edit/relocate a clip, or MOTION TRANSFER (pair with a subject in ingredientAssetIds and a prompt like "the character from image 1 performs the motion from video 1"). 2-15s. Billing switches to input+output seconds (the vref key) — pass videoReferenceSeconds so the quote is right. If the clip contains a human/AI character, pair with seedanceFace=true (the default Seedance route blocks people). Ignored by Kling/Veo.'),
+        videoReferenceSeconds: z.number().optional().describe('REQUIRED with videoReferenceAssetId: the reference clip\'s duration in seconds (from the asset listing). Feeds the vref cost key — a video-reference gen bills combined input+output seconds; the server re-derives this by probing the clip, so an understated value just gets corrected upward.'),
+        audioReferenceAssetId: z.string().optional().describe('Seedance ONLY: an AUDIO asset (UUID or badge code), ≤15s, used as a reference — e.g. lip-sync a character to this audio ("the character in image 1 speaks the dialogue from audio 1"). No billing surcharge (Seedance audio is included). Requires at least one image or video reference alongside.'),
         sound: z.boolean().optional().describe('Kling Omni / Veo / Seedance: enable audio generation. Default true.'),
         audioLanguage: z.enum(['EN', 'ZH', 'JA', 'KO', 'ES']).optional().describe('Kling Omni only — language for dialogue.'),
         generateMusic: z.boolean().optional().describe('Kling Omni only — auto-generate background music.'),
@@ -1280,7 +1368,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
@@ -1310,7 +1398,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) {
@@ -1368,17 +1456,30 @@ export const generateVideo = {
             refInputs.push({ ref: r, role: 'style' });
         if (input.videoReferenceAssetId)
             refInputs.push({ ref: input.videoReferenceAssetId, role: 'video reference' });
+        if (input.audioReferenceAssetId)
+            refInputs.push({ ref: input.audioReferenceAssetId, role: 'audio reference' });
         const resolvedRefs = await resolveAssetRefs(ctx, input.projectId, refInputs.map((r) => r.ref));
         const rid = (v) => v ? (resolvedRefs.get(v)?.id ?? v) : v;
         const rids = (a) => a?.map((v) => resolvedRefs.get(v)?.id ?? v);
         input.firstFrameAssetId = rid(input.firstFrameAssetId);
         input.lastFrameAssetId = rid(input.lastFrameAssetId);
         input.videoReferenceAssetId = rid(input.videoReferenceAssetId);
+        input.audioReferenceAssetId = rid(input.audioReferenceAssetId);
         input.ingredientAssetIds = rids(input.ingredientAssetIds);
         input.characterAssetIds = rids(input.characterAssetIds);
         input.environmentAssetIds = rids(input.environmentAssetIds);
         input.styleAssetIds = rids(input.styleAssetIds);
         const refEcho = describeResolvedRefs(refInputs, resolvedRefs);
+        // A video reference bills combined input+output seconds (the vref key) —
+        // the quote needs the clip's length. The server probes the uploaded ref
+        // and corrects the key anyway, so this only gates quote accuracy.
+        if (input.videoReferenceAssetId && input.model.startsWith('seedance') && !input.videoReferenceSeconds) {
+            return ok({
+                requires_clarification: true,
+                missing: ['videoReferenceSeconds'],
+                message: 'A Seedance video reference bills on combined input+output seconds. Pass videoReferenceSeconds (the reference clip\'s duration, shown in slates_list_assets) so the pre-flight quote matches the bill.',
+            });
+        }
         const cloud = ctx.cloud();
         const registry = await cloud.get('/api/agent/models');
         const costKey = videoCostKey({
@@ -1388,6 +1489,7 @@ export const generateVideo = {
             sound: input.sound,
             seedanceFace: input.seedanceFace,
             seedanceRealFace: input.seedanceRealFace,
+            videoRefSeconds: input.videoReferenceAssetId ? input.videoReferenceSeconds : 0,
         });
         // Hard consent gate, checked before any spend: the real-face route is
         // consent-attested by design (the desktop enforces it too).
@@ -1403,7 +1505,7 @@ export const generateVideo = {
             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(', ')}`);
         }
-        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)
@@ -1432,7 +1534,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
@@ -1442,7 +1544,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,
@@ -1451,7 +1553,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,
@@ -1482,6 +1584,7 @@ export const generateVideo = {
             environmentAssetIds: input.environmentAssetIds ?? [],
             styleAssetIds: input.styleAssetIds ?? [],
             videoReferenceAssetId: input.videoReferenceAssetId,
+            audioReferenceAssetId: input.audioReferenceAssetId,
             sound: input.sound,
             audioLanguage: input.audioLanguage,
             generateMusic: input.generateMusic,
@@ -1501,7 +1604,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 }),
@@ -1510,7 +1613,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: {
@@ -1520,7 +1623,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,
             },
@@ -1530,21 +1633,29 @@ export const generateVideo = {
 // ── Generate lip-sync ───────────────────────────────────────────
 export const generateLipSync = {
     id: 'slates_generate_lip_sync',
-    description: 'Lip-sync a still image (avatar) or a video clip to audio via Kling. REQUIRED before calling: read the slates-cost-discipline + slates-prompting-lip-sync skills. projectId is REQUIRED — the source asset must already exist in the project. Two flows: (1) sourceType=video → lip-syncs an existing talking-head clip to new audio (~$0.11 / 5s, no confirm gate); (2) sourceType=image → animates a still portrait into a talking avatar (avatar-standard ~$0.42 / 5s; avatar-pro ~$0.86 / 5s, hits the >$0.50 confirm gate). Audio comes from either TTS (pass ttsText) or an uploaded file (pass audioFilePath). Always 5 seconds — Kling lip-sync does not support other durations. No skill files installed? Call slates_get_prompting_guide with \'slates-prompting-lip-sync\' (and \'slates-cost-discipline\') before first use.',
+    description: 'Lip-sync a still image (avatar) or a video clip to audio. Two engines — route per slates-model-selection: (1) engine=kling (default, cheap utility lane): sourceType=video re-syncs a clip (~$0.11 / 5s); sourceType=image animates a still avatar (avatar-standard ~$0.42 / 5s; avatar-pro ~$0.86 / 5s). Audio from TTS (ttsText + ttsVoice) or an uploaded file. Always 5 seconds. (2) engine=seedance-2 (premium single-pass): the speech is generated IN the video itself — natural delivery, a video source keeps its OWN voice (native voice clone), audio included; ttsText becomes the spoken line (no voice/speed params), or an uploaded ≤15s audio file drives the speech as a reference. Seedance sources must be 2-15s videos or images; bills seedance keys (video sources bill input+output seconds — pass sourceSeconds). Faces route via seedanceFace (default true) / seedanceRealFace+realFaceConsent for real people. REQUIRED before calling: slates-cost-discipline + slates-prompting-lip-sync skills. projectId is REQUIRED.',
     input: z.object({
         projectId: z.string().uuid().describe('Slates project the source asset lives in. The new lip-synced video lands here.'),
         sourceAssetId: z.string().uuid().describe('Asset id of the still image (avatar flow) or video clip (lip-sync flow). Must already exist in the project — use slates_upload_reference_image or slates_generate_image / slates_generate_video first if needed.'),
         sourceType: z.enum(['image', 'video']).describe('"image" = animate a still portrait (avatar). "video" = re-sync an existing talking-head clip. Determines pricing — be deliberate.'),
-        audioMethod: z.enum(['tts', 'upload']).describe('"tts" = generate speech from ttsText. "upload" = use the file at audioFilePath (absolute path on the user\'s machine).'),
+        audioMethod: z.enum(['tts', 'upload']).describe('"tts" = generate speech from ttsText (on Seedance the line is spoken natively in the generation). "upload" = use the file at audioFilePath (absolute path on the user\'s machine; ≤15s on Seedance).'),
         ttsText: z.string().min(1).max(2000).optional().describe('Required when audioMethod=tts. The exact words the avatar/clip will speak.'),
-        ttsVoice: z.string().optional().describe('Kling voice id (e.g. "oversea_male1"). See slates-prompting-lip-sync skill for the voice catalog.'),
-        ttsLanguage: z.enum(['EN', 'ZH', 'JA', 'KO', 'ES']).optional().describe('TTS language. Default EN.'),
-        ttsSpeed: z.number().min(0.5).max(2).optional().describe('TTS speech rate. Default 1.0. Range 0.5-2.0.'),
+        ttsVoice: z.string().optional().describe('Kling engine only — voice id (e.g. "oversea_male1"). See slates-prompting-lip-sync skill for the voice catalog. Ignored on Seedance (a video source keeps its own voice; otherwise describe the voice in ttsText context).'),
+        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('Image-source only. avatar-standard ($0.42/5s) for general use. avatar-pro ($0.86/5s) for sharper face fidelity. Ignored when sourceType=video.'),
-        klingProvider: z.enum(['fal', 'kling']).optional().describe('Provider routing for the Kling call. "fal" (default) uses Slates credits. "kling" uses the user\'s own BYOK Kling key if configured — omit unless the user explicitly wants BYOK.'),
+        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.'),
+        seedanceFace: z.boolean().optional().describe('Seedance engine only — a character\'s face is in the source (default TRUE for lip-sync; the faceless route would reject it). Bills the -face key.'),
+        seedanceRealFace: z.boolean().optional().describe('Seedance engine only — the source shows a REAL person. Premium -realface key; REQUIRES realFaceConsent=true.'),
+        realFaceConsent: z.boolean().optional().describe('MANDATORY with seedanceRealFace — set true only after the user explicitly confirms they hold rights/consent to the likeness.'),
+        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) {
@@ -1561,8 +1672,41 @@ export const generateLipSync = {
                 message: 'audioMethod=upload requires audioFilePath. Pass an absolute path to the audio file on the user\'s machine.',
             });
         }
+        const isSeedance = input.engine === 'seedance-2';
         let costKey;
-        if (input.sourceType === 'video') {
+        let seedanceDuration = 0;
+        if (isSeedance) {
+            // Consent gate before any spend, mirroring slates_generate_video.
+            if (input.seedanceRealFace && !input.realFaceConsent) {
+                return ok({
+                    requires_clarification: true,
+                    missing: ['realFaceConsent'],
+                    message: 'Real-person lip-sync needs consent: confirm with the user that they hold the rights/consent to this likeness, then retry with realFaceConsent=true.',
+                });
+            }
+            if (input.sourceType === 'video' && !input.sourceSeconds) {
+                return ok({
+                    requires_clarification: true,
+                    missing: ['sourceSeconds'],
+                    message: 'Seedance lip-sync on a video source bills combined input+output seconds. Pass sourceSeconds (the clip\'s duration from slates_list_assets, must be 2-15s).',
+                });
+            }
+            const clamp = (n) => Math.min(15, Math.max(4, Math.ceil(n)));
+            seedanceDuration = clamp(input.sourceType === 'video' && input.sourceSeconds
+                ? input.sourceSeconds
+                : input.audioSeconds ?? (input.ttsText ? input.ttsText.length / 13 : 5));
+            costKey = videoCostKey({
+                model: 'seedance-2',
+                duration: seedanceDuration,
+                videoResolution: input.videoResolution ?? '1080p',
+                // Lip-sync sources are faces by definition — face route unless
+                // explicitly disabled or escalated to realface.
+                seedanceFace: input.seedanceFace !== false && input.seedanceRealFace !== true,
+                seedanceRealFace: input.seedanceRealFace === true,
+                videoRefSeconds: input.sourceType === 'video' ? input.sourceSeconds ?? 0 : 0,
+            });
+        }
+        else if (input.sourceType === 'video') {
             costKey = 'kling-lip-sync-video-5s';
         }
         else {
@@ -1575,12 +1719,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)}"`
@@ -1589,9 +1733,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 5s ${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).`,
@@ -1614,22 +1758,38 @@ export const generateLipSync = {
             klingProvider: input.klingProvider,
             estimatedCost: totalCents,
             background: input.background,
+            // Seedance engine passthrough — the desktop delegates to the seedance
+            // ref-to-video path (vref billing, face cascade, consent gate). The
+            // durations ride along so the desktop bills exactly what was quoted.
+            ...(isSeedance
+                ? {
+                    lipSyncEngine: 'seedance-2',
+                    duration: seedanceDuration,
+                    videoResolution: input.videoResolution,
+                    aspectRatio: input.aspectRatio,
+                    seedanceFace: input.seedanceFace !== false && input.seedanceRealFace !== true,
+                    seedanceRealFace: input.seedanceRealFace === true,
+                    realFaceConsent: input.realFaceConsent === true,
+                    sourceDurationSeconds: input.sourceSeconds,
+                    audioDurationSeconds: input.audioSeconds,
+                }
+                : {}),
         });
         if (!result.success)
             throw new Error(result.error ?? 'Lip-sync generation failed');
         if (result.background) {
             const ids = result.generationIds ?? (result.generationId ? [result.generationId] : []);
-            return backgroundSubmitted(`5s lip-sync (${costKey})`, ids, {
+            return backgroundSubmitted(`${isSeedance ? `${seedanceDuration}s` : '5s'} lip-sync (${costKey})`, ids, {
                 variant: costKey,
                 projectId: input.projectId,
                 sourceAssetId: input.sourceAssetId,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
             });
         }
         return {
-            text: `Generated 5s lip-sync (${costKey}) into project ${input.projectId} ` +
-                `for $${(totalCents / 100).toFixed(2)} (${totalCents}¢). ` +
+            text: `Generated ${isSeedance ? `${seedanceDuration}s` : '5s'} lip-sync (${costKey}) into project ${input.projectId} ` +
+                `for ${fmtCredits(totalCents)}. ` +
                 (input.audioMethod === 'tts'
                     ? `Spoken: "${(input.ttsText ?? '').slice(0, 60)}${(input.ttsText ?? '').length > 60 ? '...' : ''}"`
                     : `Audio: ${input.audioFilePath}`),
@@ -1639,7 +1799,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,
             },
@@ -1649,32 +1809,69 @@ export const generateLipSync = {
 // ── Generate motion transfer ────────────────────────────────────
 export const generateMotionTransfer = {
     id: 'slates_generate_motion_transfer',
-    description: 'Transfer the motion from a reference video onto a target image character via Kling Motion Control. REQUIRED before calling: read the slates-cost-discipline + slates-prompting-motion-transfer skills. projectId is REQUIRED — both source video and target image must already exist as assets in the project. Two tiers: kling-mc-std ($0.95 / 5s) and kling-mc-pro ($1.26 / 5s) — both hit the >$0.50 confirm gate. Always 5 seconds. No skill files installed? Call slates_get_prompting_guide with \'slates-prompting-motion-transfer\' (and \'slates-cost-discipline\') before first use.',
+    description: 'Transfer the motion from a reference video onto a target image character. Two engines — route per slates-model-selection: (1) kling-mc-std ($0.95 / 5s) / kling-mc-pro ($1.26 / 5s) — the cheap utility lane, structured skeleton/depth retargeting, always 5s. (2) motionModel=seedance-2 — the PREMIUM lane: single-pass generation with the driving clip as a native conditioning signal (better motion fidelity + native audio), prompt-driven (write what the character does, e.g. "the character from image 1 performs the exact motion from video 1"), bills input+output seconds on seedance vref keys (pass sourceVideoSeconds; driving clip must be 2-15s). Faces: seedanceFace defaults true; a REAL person needs seedanceRealFace+realFaceConsent (premium route). REQUIRED before calling: slates-cost-discipline + slates-prompting-motion-transfer skills. projectId is REQUIRED — both assets must exist in the project. All tiers hit the >$0.50 confirm gate.',
     input: z.object({
         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.'),
+        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']).optional().describe('std ($0.95) for general motion. pro ($1.26) for cleaner anatomy + identity preservation. Default pro — pick std deliberately for cost savings.'),
-        characterOrientation: z.enum(['video', 'image']).optional().describe('"video" = use the source video\'s framing. "image" = use the target image\'s framing. Default video.'),
-        prompt: z.string().optional().describe('Optional refinement prompt. Read slates-prompting-motion-transfer for guidance.'),
-        klingProvider: z.enum(['fal', 'kling']).optional().describe('Provider routing for the Kling call. "fal" (default) uses Slates credits. "kling" uses the user\'s own BYOK Kling key if configured — omit unless the user explicitly wants BYOK.'),
+        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.'),
+        duration: z.number().int().min(4).max(15).optional().describe('Seedance engine only — output duration in seconds (4-15). Defaults to the driving clip\'s length.'),
+        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.'),
+        seedanceFace: z.boolean().optional().describe('Seedance engine only — a character\'s face is in the clip/image (default TRUE for motion transfer). Bills the -face key.'),
+        seedanceRealFace: z.boolean().optional().describe('Seedance engine only — the driving clip/subject shows a REAL person. Premium -realface key; REQUIRES realFaceConsent=true.'),
+        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';
-        const costKey = motionModel === 'kling-mc-std' ? 'kling-mc-std-5s' : 'kling-mc-pro-5s';
+        const isSeedance = motionModel === 'seedance-2';
+        let costKey;
+        let seedanceDuration = 0;
+        if (isSeedance) {
+            if (input.seedanceRealFace && !input.realFaceConsent) {
+                return ok({
+                    requires_clarification: true,
+                    missing: ['realFaceConsent'],
+                    message: 'Real-person motion transfer needs consent: confirm with the user that they hold the rights/consent to this likeness, then retry with realFaceConsent=true.',
+                });
+            }
+            if (!input.sourceVideoSeconds) {
+                return ok({
+                    requires_clarification: true,
+                    missing: ['sourceVideoSeconds'],
+                    message: 'Seedance motion transfer bills combined input+output seconds. Pass sourceVideoSeconds (the driving clip\'s duration from slates_list_assets, must be 2-15s).',
+                });
+            }
+            seedanceDuration = input.duration ?? Math.min(15, Math.max(4, Math.ceil(input.sourceVideoSeconds)));
+            costKey = videoCostKey({
+                model: 'seedance-2',
+                duration: seedanceDuration,
+                videoResolution: input.videoResolution ?? '1080p',
+                seedanceFace: input.seedanceFace !== false && input.seedanceRealFace !== true,
+                seedanceRealFace: input.seedanceRealFace === true,
+                videoRefSeconds: input.sourceVideoSeconds,
+            });
+        }
+        else {
+            costKey = motionModel === 'kling-mc-std' ? 'kling-mc-std-5s' : 'kling-mc-pro-5s';
+        }
         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);
         // 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),
@@ -1684,12 +1881,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 5s ${motionModel}. ` +
+                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, 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.`,
             });
         }
@@ -1707,24 +1904,39 @@ export const generateMotionTransfer = {
             klingProvider: input.klingProvider,
             estimatedCost: totalCents,
             background: input.background,
+            // Seedance engine passthrough — the desktop delegates to the seedance
+            // ref-to-video path (vref billing, face cascade, consent gate).
+            ...(isSeedance
+                ? {
+                    duration: seedanceDuration,
+                    videoResolution: input.videoResolution,
+                    aspectRatio: input.aspectRatio,
+                    seedanceFace: input.seedanceFace !== false && input.seedanceRealFace !== true,
+                    seedanceRealFace: input.seedanceRealFace === true,
+                    realFaceConsent: input.realFaceConsent === true,
+                    // Ride the caller-supplied clip duration through — the asset row's
+                    // duration can be null for imported clips.
+                    sourceVideoDurationSeconds: input.sourceVideoSeconds,
+                }
+                : {}),
         });
         if (!result.success)
             throw new Error(result.error ?? 'Motion transfer generation failed');
         if (result.background) {
             const ids = result.generationIds ?? (result.generationId ? [result.generationId] : []);
-            return backgroundSubmitted(`5s motion transfer (${motionModel})`, ids, {
+            return backgroundSubmitted(`${isSeedance ? `${seedanceDuration}s` : '5s'} motion transfer (${motionModel})`, ids, {
                 variant: costKey,
                 motionModel,
                 projectId: input.projectId,
                 sourceVideoAssetId: input.sourceVideoAssetId,
                 targetImageAssetId: input.targetImageAssetId,
                 cost_cents: totalCents,
-                cost_dollars: (totalCents / 100).toFixed(2),
+                cost_credits: totalCents,
             });
         }
         return {
-            text: `Generated 5s motion transfer (${motionModel}) into project ${input.projectId} ` +
-                `for $${(totalCents / 100).toFixed(2)} (${totalCents}¢).` +
+            text: `Generated ${isSeedance ? `${seedanceDuration}s` : '5s'} motion transfer (${motionModel}) into project ${input.projectId} ` +
+                `for ${fmtCredits(totalCents)}.` +
                 (input.prompt ? ` Prompt: "${input.prompt.slice(0, 60)}${input.prompt.length > 60 ? '...' : ''}"` : ''),
             data: {
                 variant: costKey,
@@ -1733,7 +1945,133 @@ 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,
+            },
+        };
+    },
+};
+// ── 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.',
+    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).'),
+        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.'),
+    }),
+    async run(input, ctx) {
+        const desktop = ctx.desktop();
+        await desktop.requireCapability('edit-video', 'video editing (Kling O3 edit)');
+        if (input.background) {
+            await desktop.requireCapability('background-generation', 'background generation');
+        }
+        const model = input.model ?? 'kling-v3.0-omni-edit';
+        // Resolve refs (UUIDs or badge codes) against the project AT CALL TIME.
+        const refInputs = [
+            { ref: input.sourceVideoAssetId, role: 'source clip' },
+            ...(input.characterAssetIds ?? []).map((ref) => ({ ref, role: 'subject element' })),
+            ...(input.styleAssetIds ?? []).map((ref) => ({ ref, role: 'style' })),
+        ];
+        const resolved = await resolveAssetRefs(ctx, input.projectId, refInputs.map((r) => r.ref));
+        const rid = (ref) => resolved.get(ref)?.id ?? ref;
+        const sourceId = rid(input.sourceVideoAssetId);
+        const characterAssetIds = (input.characterAssetIds ?? []).map(rid);
+        const styleAssetIds = (input.styleAssetIds ?? []).map(rid);
+        const refEcho = describeResolvedRefs(refInputs, resolved);
+        if (characterAssetIds.length + styleAssetIds.length > 4) {
+            throw new Error('Kling O3 edit takes max 4 combined subject + style references.');
+        }
+        // The billed key needs the clip's duration (ceiled). Read it from the
+        // project's asset records — the desktop route independently re-validates.
+        const { assets } = await desktop.get('/agent/assets', { projectId: input.projectId });
+        const sourceRow = (assets ?? []).find((a) => String(a.id).toLowerCase() === sourceId.toLowerCase());
+        if (!sourceRow)
+            throw new Error(`Source asset not found in project: ${input.sourceVideoAssetId}`);
+        if (sourceRow.type !== 'video')
+            throw new Error('sourceVideoAssetId must reference a VIDEO asset.');
+        const clipSeconds = Number(sourceRow.duration);
+        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).`);
+        }
+        const billedSeconds = Math.min(15, Math.max(3, Math.ceil(clipSeconds - 0.05)));
+        const costKey = 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 = 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 > 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: ${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: {
+                    requires_confirm: true,
+                    model,
+                    variant: costKey,
+                    billed_seconds: billedSeconds,
+                    clip_seconds: clipSeconds,
+                    estimated_cents: totalCents,
+                    estimated_credits: totalCents,
+                    references: previews.map((p) => ({ ref: p.ref, role: p.role, ...p.meta })),
+                },
+            };
+        }
+        const result = await desktop.post('/agent/generation/edit-video', {
+            projectId: input.projectId,
+            model,
+            prompt: input.prompt,
+            sourceVideoAssetId: sourceId,
+            characterAssetIds,
+            styleAssetIds,
+            keepAudio: input.keepAudio !== false,
+            background: input.background,
+        });
+        if (!result.success)
+            throw new Error(result.error ?? 'Video edit failed');
+        if (result.background) {
+            const ids = result.generationId ? [result.generationId] : [];
+            return backgroundSubmitted(`${billedSeconds}s video edit (${model})`, ids, {
+                model,
+                variant: costKey,
+                projectId: input.projectId,
+                sourceVideoAssetId: sourceId,
+                cost_cents: totalCents,
+                cost_credits: totalCents,
+            }, refEcho);
+        }
+        return {
+            text: `Edited ${billedSeconds}s clip saved as a new asset in project ${input.projectId} ` +
+                `for ${fmtCredits(totalCents)} via ${model}. ` +
+                `Edit: "${input.prompt.slice(0, 60)}${input.prompt.length > 60 ? '...' : ''}"` +
+                (refEcho ? ` ${refEcho}` : ''),
+            data: {
+                model,
+                variant: costKey,
+                projectId: input.projectId,
+                sourceVideoAssetId: sourceId,
+                billed_seconds: billedSeconds,
+                cost_cents: totalCents,
+                cost_credits: totalCents,
                 asset: result.asset,
                 generationId: result.generationId,
             },
@@ -1771,7 +2109,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,
@@ -2238,6 +2576,8 @@ function resolveGuideTopic(topic) {
     }
     if (t.startsWith('nano-banana'))
         return 'slates-prompting-nano-banana-2';
+    if (t.startsWith('gpt-image') || t.startsWith('gpt image'))
+        return 'slates-prompting-gpt-image-2';
     if (t.startsWith('flux'))
         return 'slates-prompting-flux-2-max';
     if (t.startsWith('seedream'))
@@ -2246,6 +2586,8 @@ function resolveGuideTopic(topic) {
         return 'slates-prompting-veo-3';
     if (t.startsWith('kling-mc'))
         return 'slates-prompting-motion-transfer';
+    if (t === 'edit-video' || t === 'video-edit' || t === 'edit video' || t === 'video edit')
+        return 'slates-prompting-kling-v3';
     if (t.startsWith('kling-v3'))
         return 'slates-prompting-kling-v3';
     if (t.startsWith('seedance'))
@@ -2323,6 +2665,7 @@ export const ALL_OPERATIONS = [
     generateVideo,
     generateLipSync,
     generateMotionTransfer,
+    editVideo,
     editImage,
     getGenerationStatus,
     listGenerations,