@project-ava-supernova/core 0.2.71

package/dist/tools/write-recipe.d.ts

@@ -0,0 +1,29 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+/**
+ * Emit a finished recipe to the Pantry drafts — one call per dish.
+ *
+ * This does the deterministic work the model cannot be trusted with, in the
+ * same spirit as write_article's quote check: it does not ASK for a cookable
+ * recipe, it makes an uncookable one FAIL.
+ *
+ *   - The shopping-list check runs before anything is saved. A version whose
+ *     method names an ingredient its list does not have is REFUSED, and the
+ *     missing items come back as fix-instructions. The reader finding out at the
+ *     hob is the one failure this desk exists to prevent.
+ *
+ *   - Every recipe lands UNPUBLISHED. Ava drafts, the operator publishes —
+ *     exactly as the newsroom works.
+ *
+ * Refusals are instructions, not scolding: she adds the line or fixes the step
+ * and re-calls in the same turn.
+ */
+export declare class WriteRecipeTool implements Tool {
+    readonly name = "write_recipe";
+    readonly description = "Emit a finished recipe as a draft. ONE call per dish, with all three skill-level versions. Every ingredient a version's method names must be in that version's ingredients (shared or level-specific) \u2014 this is CHECKED, and a version that fails is refused with the missing items. Recipes land unpublished; the operator publishes.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=write-recipe.d.ts.map

package/dist/tools/write-recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-recipe.d.ts","sourceRoot":"","sources":["../../src/tools/write-recipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO5D;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAgB,YAAW,IAAI;IAC1C,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,iVACyT;IAC7U,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAC5C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CA+E7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAyKjG"}

package/dist/tools/write-recipe.js

@@ -0,0 +1,262 @@
+const LEVELS = ['beginner', 'intermediate', 'expert'];
+/**
+ * Emit a finished recipe to the Pantry drafts — one call per dish.
+ *
+ * This does the deterministic work the model cannot be trusted with, in the
+ * same spirit as write_article's quote check: it does not ASK for a cookable
+ * recipe, it makes an uncookable one FAIL.
+ *
+ *   - The shopping-list check runs before anything is saved. A version whose
+ *     method names an ingredient its list does not have is REFUSED, and the
+ *     missing items come back as fix-instructions. The reader finding out at the
+ *     hob is the one failure this desk exists to prevent.
+ *
+ *   - Every recipe lands UNPUBLISHED. Ava drafts, the operator publishes —
+ *     exactly as the newsroom works.
+ *
+ * Refusals are instructions, not scolding: she adds the line or fixes the step
+ * and re-calls in the same turn.
+ */
+export class WriteRecipeTool {
+    name = 'write_recipe';
+    description = 'Emit a finished recipe as a draft. ONE call per dish, with all three skill-level versions. Every ingredient a version\'s method names must be in that version\'s ingredients (shared or level-specific) — this is CHECKED, and a version that fails is refused with the missing items. Recipes land unpublished; the operator publishes.';
+    riskLevel = 'write';
+    requiresConfirmation = false;
+    schema = {
+        name: 'write_recipe',
+        description: 'Emit the finished recipe as a draft card. Call ONCE per dish, with beginner, intermediate and expert versions. Ingredients are shared across versions except where a level genuinely needs a different item (the beginner\'s jarred paste, the expert\'s whole spices) — mark those with a level. Every ingredient named in any version\'s steps is CHECKED against that version\'s list; a version that names something unlisted is rejected and you fix it. A level-specific item is a different FORM of something the dish needs, never a new flavour it does not carry.',
+        parameters: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'The canonical dish name.' },
+                seed_id: { type: 'string', description: 'If you were asked to write a dish FROM a seed (the request names a seed id), pass it here so the seed is marked built and leaves the backlog.' },
+                cuisines: {
+                    type: 'array', items: { type: 'string' },
+                    description: 'REQUIRED. Every cuisine this dish belongs to, most-associated FIRST — that one becomes its primary. Names or slugs both work ("Argentine", "argentine"). A dish eaten across a whole region — pita, hummus, dolma, baklava — is ONE recipe listed under every cuisine that claims it, never a separate copy each. Most dishes have exactly one.',
+                },
+                cuisine_slug: { type: 'string', description: 'Deprecated — use cuisines. A single cuisine slug.' },
+                origin_country: { type: 'string' },
+                course: { type: 'string', enum: ['main', 'starter', 'dessert', 'breakfast', 'side', 'snack'] },
+                overview: { type: 'string', description: 'What the dish is and why it matters. No breathless food-blog throat-clearing.' },
+                source_attribution: { type: 'string', description: 'Where the recipe is adapted from, if anywhere specific.' },
+                cost_tier: { type: 'string', enum: ['budget', 'moderate', 'special'], description: 'Rough cost to make.' },
+                hero_image_prompt: { type: 'string', description: 'The subject of the hero photograph — the finished dish, plated honestly.' },
+                ingredients: {
+                    type: 'array',
+                    description: 'The shopping list. Most items are shared; give an item a "level" ONLY when it belongs to that skill level alone.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            name: { type: 'string', description: 'Singular, no quantity in the name.' },
+                            quantity: { type: 'number' },
+                            unit: { type: 'string' },
+                            notes: { type: 'string', description: 'Prep notes that do not vary by level, e.g. "fresh, not dried".' },
+                            optional: { type: 'boolean' },
+                            level: { type: 'string', enum: ['beginner', 'intermediate', 'expert'], description: 'OMIT for shared items. Set only when the item belongs to that level alone.' },
+                        },
+                        required: ['name'],
+                    },
+                },
+                versions: {
+                    type: 'object',
+                    description: 'The three skill levels. Same dish, technique differs.',
+                    properties: Object.fromEntries(LEVELS.map((l) => [l, {
+                            type: 'object',
+                            properties: {
+                                description: { type: 'string', description: `What's different about the ${l} version.` },
+                                prep_time_minutes: { type: 'number' },
+                                cook_time_minutes: { type: 'number' },
+                                total_time_minutes: { type: 'number' },
+                                default_servings: { type: 'number' },
+                                steps: {
+                                    type: 'array',
+                                    items: {
+                                        type: 'object',
+                                        properties: {
+                                            action: { type: 'string', description: 'One imperative sentence.' },
+                                            notes: { type: 'string' },
+                                            technique_term: { type: 'string' },
+                                            time_estimate_seconds: { type: 'number' },
+                                            tricky_flag: { type: 'boolean' },
+                                        },
+                                        required: ['action'],
+                                    },
+                                },
+                                diets: { type: 'array', items: { type: 'string' } },
+                                dietary_flags: { type: 'array', items: { type: 'string' } },
+                                nutrition: {
+                                    type: 'object',
+                                    description: 'REQUIRED. Per-serving estimate for THIS version: total the dish from this version\'s ingredient quantities, then divide by default_servings. Give calories (kcal) plus protein_g, carbs_g, fat_g, fibre_g, sugar_g, saturated_fat_g and sodium_mg. Estimate honestly and conservatively — it is stored and shown AS an estimate, never as a lab figure. A meal plan cannot total a day without this, so do not omit it.',
+                                    properties: {
+                                        calories: { type: 'number' }, protein_g: { type: 'number' }, carbs_g: { type: 'number' },
+                                        fat_g: { type: 'number' }, fibre_g: { type: 'number' }, sugar_g: { type: 'number' },
+                                        saturated_fat_g: { type: 'number' }, sodium_mg: { type: 'number' },
+                                    },
+                                },
+                            },
+                            required: ['steps', 'nutrition'],
+                        }])),
+                },
+            },
+            required: ['name', 'ingredients', 'versions'],
+        },
+    };
+    async execute(args, context) {
+        const store = context.sharedState?.recipeStore;
+        if (!store) {
+            return { success: false, output: 'Recipe storage is not available in this context. The host must inject `recipeStore` into shared state.' };
+        }
+        const name = String(args.name ?? '').trim();
+        if (!name)
+            return { success: false, output: 'write_recipe requires a dish name.' };
+        // Ingredients
+        const rawIngredients = Array.isArray(args.ingredients) ? args.ingredients : [];
+        const ingredients = rawIngredients
+            .map((i) => {
+            const o = (i && typeof i === 'object') ? i : {};
+            const lvl = typeof o.level === 'string' ? o.level.toLowerCase().trim() : '';
+            return {
+                name: String(o.name ?? '').trim(),
+                quantity: typeof o.quantity === 'number' ? o.quantity : null,
+                unit: o.unit ? String(o.unit) : null,
+                notes: o.notes ? String(o.notes) : null,
+                optional: o.optional === true,
+                level: LEVELS.includes(lvl) ? lvl : null,
+            };
+        })
+            .filter((i) => i.name);
+        if (ingredients.length === 0) {
+            return { success: false, output: 'REFUSED: a recipe with no ingredients cannot be cooked. List what the cook buys.' };
+        }
+        // Versions
+        const rawVersions = (args.versions && typeof args.versions === 'object') ? args.versions : {};
+        const versions = [];
+        for (const level of LEVELS) {
+            const v = (rawVersions[level] && typeof rawVersions[level] === 'object') ? rawVersions[level] : null;
+            if (!v)
+                continue;
+            const steps = (Array.isArray(v.steps) ? v.steps : [])
+                .map((s) => {
+                const o = (s && typeof s === 'object') ? s : {};
+                return {
+                    action: String(o.action ?? '').trim(),
+                    notes: o.notes ? String(o.notes) : null,
+                    technique_term: o.technique_term ? String(o.technique_term) : null,
+                    time_estimate_seconds: typeof o.time_estimate_seconds === 'number' ? o.time_estimate_seconds : null,
+                    tricky_flag: o.tricky_flag === true,
+                };
+            })
+                .filter((s) => s.action);
+            if (!steps.length)
+                continue;
+            versions.push({
+                level,
+                description: v.description ? String(v.description) : undefined,
+                prep_time_minutes: typeof v.prep_time_minutes === 'number' ? v.prep_time_minutes : null,
+                cook_time_minutes: typeof v.cook_time_minutes === 'number' ? v.cook_time_minutes : null,
+                total_time_minutes: typeof v.total_time_minutes === 'number' ? v.total_time_minutes : null,
+                default_servings: typeof v.default_servings === 'number' ? v.default_servings : 4,
+                steps,
+                diets: Array.isArray(v.diets) ? v.diets.map(String) : [],
+                dietary_flags: Array.isArray(v.dietary_flags) ? v.dietary_flags.map(String) : [],
+                nutrition: (v.nutrition && typeof v.nutrition === 'object') ? v.nutrition : undefined,
+            });
+        }
+        if (versions.length === 0) {
+            return { success: false, output: 'REFUSED: a recipe needs at least one skill-level version with steps.' };
+        }
+        // A recipe with no cuisine is invisible: the library browses BY cuisine, so
+        // it lands in the database and nowhere a cook would ever find it. Every one
+        // of the other 930 recipes has one — the two that didn't were both written
+        // through this tool, back when it collected the field and dropped it.
+        const cuisineList = [
+            ...(Array.isArray(args.cuisines) ? args.cuisines.map((c) => String(c).trim()) : []),
+            ...(args.cuisine_slug ? [String(args.cuisine_slug).trim()] : []),
+        ].filter(Boolean);
+        if (!cuisineList.length) {
+            return {
+                success: false,
+                output: 'REFUSED: no cuisine. Give `cuisines` — every cuisine this dish belongs to, most-associated first. ' +
+                    'A recipe with none is browsable from nowhere. If the dish is eaten across a region, list them all on THIS recipe rather than writing a copy per cuisine.',
+            };
+        }
+        // Nutrition is what a meal plan totals a day from. A version without it is
+        // a hole in the Plans feature, and the omission is invisible once saved —
+        // so catch it here rather than discovering empty columns later.
+        const missingNutrition = versions.filter((v) => !v.nutrition || Object.keys(v.nutrition).length === 0);
+        if (missingNutrition.length) {
+            return {
+                success: false,
+                output: `REFUSED: no nutrition on ${missingNutrition.map((v) => v.level).join(', ')}. ` +
+                    'Give a per-serving estimate for each version — total that version\'s ingredient quantities and divide by its servings. ' +
+                    'Calories plus protein, carbs, fat, fibre, sugar, saturated fat and sodium. Estimate honestly; it is stored and shown as an estimate, not a lab figure. ' +
+                    'A meal plan cannot total a day without it.',
+            };
+        }
+        const recipe = {
+            name,
+            seed_id: args.seed_id ? String(args.seed_id) : null,
+            cuisines: cuisineList,
+            cuisine_slug: args.cuisine_slug ? String(args.cuisine_slug) : null,
+            origin_country: args.origin_country ? String(args.origin_country) : null,
+            course: args.course ? String(args.course) : null,
+            overview: args.overview ? String(args.overview) : null,
+            source_attribution: args.source_attribution ? String(args.source_attribution) : null,
+            cost_tier: (['budget', 'moderate', 'special'].includes(String(args.cost_tier)) ? args.cost_tier : null),
+            hero_image_prompt: args.hero_image_prompt ? String(args.hero_image_prompt) : null,
+            ingredients,
+            versions,
+        };
+        // ── The shopping-list law: cookable-from-its-own-list, or it does not land ──
+        const check = await store.check(recipe);
+        if (check.status === 'fail') {
+            const byLevel = new Map();
+            for (const f of check.findings) {
+                const arr = byLevel.get(f.level) ?? [];
+                arr.push(f.term);
+                byLevel.set(f.level, arr);
+            }
+            const detail = [...byLevel.entries()]
+                .map(([lvl, terms]) => `  · ${lvl}: ${terms.join(', ')}`)
+                .join('\n');
+            return {
+                success: false,
+                output: `REFUSED: the method names ingredients the shopping list does not have:\n${detail}\n\n` +
+                    'Someone shops from this list and then cooks from these steps — anything named but unlisted is something they do not have, standing at the hob. ' +
+                    'Fix it one of two ways and call write_recipe again: add the missing item to the ingredients (shared, or that level\'s own if only that version uses it), or change the step so it uses what is listed. ' +
+                    'Do not remove the check by rewording around it — the cook still needs the thing.',
+            };
+        }
+        const { id, error: saveError } = await store.save(recipe);
+        // A save that returns no id did NOT happen. Reporting success here is how a
+        // recipe that was never written got announced as "written and checked
+        // clean" — the tool lied to her, and she passed the lie on in good faith.
+        // If the store could not persist it, say so and let her raise it.
+        if (!id) {
+            return {
+                success: false,
+                output: saveError
+                    // A stated reason is usually something she can act on — a cuisine
+                    // that didn't match, say. Give it to her verbatim and let her retry.
+                    ? `The recipe passed its checks but COULD NOT BE SAVED: ${saveError}. Nothing was written. Do not report this recipe as created — fix the cause and call write_recipe again.`
+                    : 'The recipe passed its checks but COULD NOT BE SAVED — the store returned no id, so nothing was written. ' +
+                        'Do not report this recipe as created. Tell the operator it failed to save so they can look at the logs; ' +
+                        'retrying the same call is unlikely to help if the cause is server-side.',
+            };
+        }
+        return {
+            success: true,
+            output: JSON.stringify({
+                ok: true,
+                id,
+                name,
+                versions: versions.map((v) => v.level),
+                ingredients: ingredients.length,
+                level_specific: ingredients.filter((i) => i.level).length,
+                check: 'passed',
+                note: 'Recipe drafted (unpublished). Every version\'s method was checked against its own shopping list.',
+            }),
+        };
+    }
+}
+//# sourceMappingURL=write-recipe.js.map

package/dist/tools/write-recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-recipe.js","sourceRoot":"","sources":["../../src/tools/write-recipe.ts"],"names":[],"mappings":"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"}

package/dist/tools/write-video-post.d.ts

@@ -0,0 +1,25 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+/**
+ * Emit a finished SHORT-FORM VIDEO POST — the clip, the voiceover, and the
+ * caption as one artefact.
+ *
+ * The split mirrors write_post: this tool does the surface-free work (validate
+ * the three parts, enforce the caption cap deterministically) and the injected
+ * `videoPostStore` does everything that needs a provider key — rendering her
+ * voice and submitting the generation job.
+ *
+ * The one thing that differs from every other card: what comes back is a JOB,
+ * not a finished video. Generation runs for minutes and outlives the turn, so
+ * the caption ships immediately and the picture arrives later. She must not
+ * describe a clip she has not seen.
+ */
+export declare class WriteVideoPostTool implements Tool {
+    readonly name = "write_video_post";
+    readonly description = "Emit a finished short-form video post \u2014 the clip, your voiceover, and the caption together. One call per video.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=write-video-post.d.ts.map

package/dist/tools/write-video-post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-video-post.d.ts","sourceRoot":"","sources":["../../src/tools/write-video-post.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO5D;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,YAAW,IAAI;IAC7C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,WAAW,0HACgG;IACpH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAC5C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CA8C7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAmLjG"}

package/dist/tools/write-video-post.js

@@ -0,0 +1,238 @@
+import { VIDEO_CAPTION_LIMITS } from '../social/index.js';
+/** Every video carries the link. Lower-case for the idempotency check; the
+ *  appended form is the same string, so it reads as written. */
+const AVA_URL = 'avasupernova.com';
+/**
+ * Emit a finished SHORT-FORM VIDEO POST — the clip, the voiceover, and the
+ * caption as one artefact.
+ *
+ * The split mirrors write_post: this tool does the surface-free work (validate
+ * the three parts, enforce the caption cap deterministically) and the injected
+ * `videoPostStore` does everything that needs a provider key — rendering her
+ * voice and submitting the generation job.
+ *
+ * The one thing that differs from every other card: what comes back is a JOB,
+ * not a finished video. Generation runs for minutes and outlives the turn, so
+ * the caption ships immediately and the picture arrives later. She must not
+ * describe a clip she has not seen.
+ */
+export class WriteVideoPostTool {
+    name = 'write_video_post';
+    description = 'Emit a finished short-form video post — the clip, your voiceover, and the caption together. One call per video.';
+    riskLevel = 'write';
+    requiresConfirmation = false;
+    schema = {
+        name: 'write_video_post',
+        description: 'Emit a finished SHORT-FORM VIDEO POST — the clip, the voiceover in your own voice, and the caption, as one artefact. Use when the idea wants to be a video rather than text (TikTok, Reels, Shorts). Call it ONCE PER VIDEO. Do not write the script or caption in your narration — only call this tool. Generation takes a couple of minutes and finishes after your turn, so say what you made and why that angle; never claim you have watched it back.',
+        parameters: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    enum: ['tiktok', 'instagram', 'youtube', 'facebook'],
+                    description: 'Where this is going. All four are vertical short-form (9:16); "youtube" means Shorts, "instagram" means Reels, "facebook" means Reels on our Page.',
+                },
+                visual: {
+                    type: 'string',
+                    description: 'What is ON SCREEN, written as a video generation prompt — subject, action, setting, camera movement, lighting, mood. Not the caption and not the script; the shot. Be concrete: the model cannot render an abstraction like "the feeling of trust", but it can render a hand stopping halfway to a pan.',
+                },
+                script: {
+                    type: 'string',
+                    description: 'What YOU SAY over the clip, spoken in your own voice. Written to be heard, not read — short sentences, no hashtags, no emoji, no "link in bio". A voiced clip is ALWAYS 10 seconds and the line must land between 17 and 22 words — AIM AT 20-22, because that is what fills the clip. Timed against the real voice: 22 words runs ~9.1s, 17 words ~7.0s, and 12 words is under 5s, which leaves half the video playing in silence. The ceiling keeps the voice inside the picture — a voice still talking after the clip stops is the most obviously broken thing a short can do. The floor keeps the picture from running on alone (and under 3 seconds Wan refuses the audio outright, so the clip fails to render at all). Both bounds are enforced. Omit entirely for a silent clip carried by on-screen text.',
+                },
+                caption: {
+                    type: 'string',
+                    description: 'The post copy that goes in the caption box, ready to paste. The first line is the hook that decides whether anyone watches. It must NOT restate the voiceover — the script is heard and the caption is read, so saying the same thing twice wastes one of them; the caption carries what the voice cannot (the dish or movement by NAME, the concrete detail, why it exists). Write it to be SEARCHED: caption keywords now do more for discovery than hashtags, so the subject belongs in the words and not only in the tags. A one-liner plus two tags is not a caption. Hashtags inline per the platform tag policy. The link to avasupernova.com is appended automatically — do not write it yourself, and never write "link in bio".',
+                },
+                duration: {
+                    type: 'number',
+                    description: 'Clip length in seconds. Keep it to what the script actually needs — a padded clip loses the viewer.',
+                },
+                title: { type: 'string', description: 'Optional short title for the library.' },
+                hashtags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'The hashtags you chose, so the UI can show them as an editable chip row. Within the platform tag policy.',
+                },
+                tag_note: { type: 'string', description: 'One short line on why these tags.' },
+                recipe: {
+                    type: 'string',
+                    description: 'For a FOOD video: the name of a dish we already have a photograph of. Naming it animates OUR hero image rather than generating a stranger version of the dish — the picture is already the food, so it cannot misrepresent it. Use this for anything about a recipe. When you do, describe only gentle motion in the visual (steam, a slow push in, light shifting) and say what stays STILL; a locked plate is the whole point.',
+                },
+                seed: {
+                    type: 'number',
+                    description: 'Reuse the seed a previous clip reported to change ONE thing and see only that thing change. Without it every attempt is a different clip entirely, which is re-rolling rather than fixing. Omit for a genuinely new idea.',
+                },
+            },
+            required: ['platform', 'visual', 'caption'],
+        },
+    };
+    async execute(args, context) {
+        const store = context.sharedState?.videoPostStore;
+        if (!store) {
+            return {
+                success: false,
+                output: 'Video posts are not available in this context. The host must inject `videoPostStore` into shared state.',
+            };
+        }
+        // NO silent default. This used to fall back to 'tiktok', so a video the
+        // operator never chose a home for quietly became a TikTok post — and the
+        // platform decides the aspect, the tag policy and the whole register of the
+        // caption. Guessing it is not a small convenience, it is picking the
+        // audience on their behalf. Missing means ASK, not assume.
+        const platform = (args.platform || '').trim();
+        if (!platform) {
+            return {
+                success: false,
+                output: 'write_video_post needs a platform and there is no default — the platform decides the tag policy, '
+                    + 'the caption register and where this lands. If the operator has not said, ASK which one (or which '
+                    + 'ones) before calling this again: tiktok, instagram, youtube or facebook.',
+            };
+        }
+        const visual = (args.visual || '').trim();
+        const caption = (args.caption || '').trim();
+        const script = (args.script || '').trim();
+        if (!visual) {
+            return { success: false, output: 'write_video_post requires a visual — describe what is on screen.' };
+        }
+        if (!caption) {
+            return { success: false, output: 'write_video_post requires a caption — the clip is only half the post.' };
+        }
+        // Same deterministic enforcement as write_post: count by code point and
+        // hand back the exact overage, so she trims and re-calls in the same turn.
+        // THE LINK GOES ON EVERY VIDEO, and it is appended here rather than asked
+        // for. A rule the model has to remember is a rule that is missing from the
+        // one post that mattered — and a video nobody can act on is a video that
+        // did nothing. Idempotent: if she already wrote it, it is not doubled.
+        const withLink = caption.toLowerCase().includes(AVA_URL)
+            ? caption
+            : `${caption}\n\n${AVA_URL}`;
+        // Enforced AFTER the link, because the link is not optional — if adding it
+        // breaks the cap then the caption is what gives, not the link.
+        const hardLimit = VIDEO_CAPTION_LIMITS[platform];
+        if (hardLimit) {
+            const len = Array.from(withLink).length;
+            if (len > hardLimit) {
+                const over = len - hardLimit;
+                return {
+                    success: false,
+                    output: `This ${platform} caption is ${len} characters with the ${AVA_URL} link appended — ` +
+                        `${over} over the ${hardLimit} limit. Trim ${over}+ characters from the caption and ` +
+                        `call write_video_post again. The link is not optional; the words are what give.`,
+                };
+            }
+        }
+        // ── The voiceover has to FIT ─────────────────────────────────────────
+        // We hand Wan a finished audio file, so we cannot offset when it starts —
+        // the only lever is making the speech short enough to sit inside the clip.
+        // Budget: the duration minus a second of air at each end, at roughly two
+        // words a second. A 10s clip is therefore about 16 words, NOT the 20-25 the
+        // guidance used to claim — that was 10-12 seconds of speech over a 10 second
+        // clip, which is why the voice ran past the end.
+        //
+        // And a FLOOR, which the ceiling alone hid. Wan refuses any supplied audio
+        // under 3.0 seconds outright — "duration should be at least 3.0s, got
+        // 1.68s" — so a very short line does not sound sparse, it fails to render.
+        // At two words a second that floor is about six words, which is ALSO the
+        // ceiling for a 5s clip: the window for a voiced 5s clip is empty, every
+        // script short enough to fit being too short to accept. So a voiced clip is
+        // always 10s. Found the hard way after a six-word line killed every food
+        // video with a generic "generation failed".
+        // MEASURED through the real voice — qwen3-tts-instruct-flash, the 'Maia'
+        // brand voice, the shipped voice direction, timed off the returned WAV
+        // headers rather than derived from an assumed rate:
+        //
+        //     6w -> 2.16s   10w -> 3.76s   14w -> 5.52s   17w -> 7.04s   25w -> 10.00s
+        //
+        // She runs 2.41-2.78 words a second, slowest on the longer lines. So a 10s
+        // clip holds about 22 words.
+        //
+        // The floor used to be 12, set to clear Wan's 3s minimum and nothing else.
+        // Twelve words is under five seconds — half a ten second clip — and a floor
+        // is exactly where a model writes to when the tool keeps rejecting it, so
+        // every voiced clip came back half silent. The floor now exists to FILL the
+        // clip rather than merely to be accepted.
+        //
+        // NOTE: this rate belongs to Maia. The brand voice is not yet ratified, and
+        // the roster varies a lot — the same lines through 'Cherry' run 1.92-2.42
+        // w/s, which would put the ceiling at 18 rather than 22. If AVA_BRAND_VOICE
+        // changes, re-measure; do not carry these numbers over.
+        const MIN_SPEECH_SECONDS = 3.0;
+        const SLOWEST_WORDS_PER_SECOND = 2.41;
+        /** Speech has to end before the picture does; 0.5s of air is enough. */
+        const TRAILING_AIR_SECONDS = 0.5;
+        const MIN_WORDS = 17;
+        const wantsVoice = !!script;
+        const plannedDuration = wantsVoice || (typeof args.duration === 'number' && args.duration > 7.5) ? 10 : 5;
+        if (script) {
+            const words = script.split(/\s+/).filter(Boolean).length;
+            const speakable = Math.max(1, plannedDuration - TRAILING_AIR_SECONDS);
+            const budget = Math.floor(speakable * SLOWEST_WORDS_PER_SECOND);
+            const floor = MIN_WORDS;
+            if (words > budget) {
+                return {
+                    success: false,
+                    output: `That script is ${words} words and will not fit. A ${plannedDuration}s clip holds about ${budget} words ` +
+                        `at the speed you actually speak. Cut ${words - budget} and call write_video_post again — a voice ` +
+                        `still talking after the picture stops is the most obviously broken thing a short can do.`,
+                };
+            }
+            if (words < floor) {
+                return {
+                    success: false,
+                    output: `That script is only ${words} words — roughly ${(words / SLOWEST_WORDS_PER_SECOND).toFixed(1)}s of speech ` +
+                        `in a ${plannedDuration}s clip, so the rest of the video would play in silence. Write ${floor}-${budget} words ` +
+                        `and aim at the top of that range: ${budget} words fills the clip, ${floor} barely covers two thirds ` +
+                        `of it. (Under ${MIN_SPEECH_SECONDS}s Wan refuses the audio outright and nothing renders at all.) ` +
+                        `Or drop the script entirely for a silent clip carried by on-screen text.`,
+                };
+            }
+        }
+        const post = {
+            platform,
+            visual,
+            script: script || undefined,
+            caption: withLink,
+            duration: typeof args.duration === 'number' ? args.duration : undefined,
+            title: (args.title?.trim()) || undefined,
+            hashtags: Array.isArray(args.hashtags)
+                ? args.hashtags.map(h => String(h).trim().replace(/^#/, '')).filter(Boolean)
+                : [],
+            tagNote: (args.tag_note?.trim()) || undefined,
+            seed: typeof args.seed === 'number' && Number.isFinite(args.seed) ? args.seed : undefined,
+            recipe: (args.recipe?.trim()) || undefined,
+        };
+        try {
+            const written = await store.write(post);
+            // Report the voiceover honestly. A failed TTS still produces a clip — the
+            // model dubs its own — and she needs to know that is not her on it before
+            // she tells the operator otherwise.
+            // Say plainly whether the clip is built on our own photograph or on a
+            // generated dish. She must not claim it shows our food if it does not.
+            const recipeLine = post.recipe
+                ? (written.recipeImageUsed
+                    ? ` Built on our own photograph of ${written.recipeImageUsed} — you can say it is our dish.`
+                    : ` NO photograph found for "${post.recipe}", so the food is generated, not ours. Do not say it is our dish.`)
+                : '';
+            const voiceLine = post.script
+                ? written.voiced
+                    ? ' Voiceover is in your voice.'
+                    : ` The VOICEOVER FAILED${written.voiceError ? ` (${written.voiceError})` : ''} — the clip carries the model's own dub, NOT your voice. Say so plainly.`
+                : '';
+            return {
+                success: true,
+                output: `Video post queued for ${platform} — the caption is on the card now, the clip is still rendering ` +
+                    `(job ${written.taskId}). Seed ${written.seed} — pass that same seed back if they ask for a change, ` +
+                    `so you adjust THIS clip instead of rolling a different one. ` +
+                    `You have not seen it: say what you made and why that angle, never how it looks.${recipeLine}${voiceLine}`,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: `Could not queue the video: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=write-video-post.js.map

package/dist/tools/write-video-post.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-video-post.js","sourceRoot":"","sources":["../../src/tools/write-video-post.ts"],"names":[],"mappings":"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"}

package/dist/tools/write-voiceover.d.ts

@@ -0,0 +1,29 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+/**
+ * Emit a standalone VOICEOVER — her voice, no clip.
+ *
+ * write_video_post already renders a voiceover, but only ever as part of a
+ * video. When what someone wants is the audio — a read to lay under footage
+ * they already shot, a line they want to hear before committing to it — going
+ * through write_video_post spends a video generation to get at the audio inside
+ * it, and hands back a clip nobody asked for.
+ *
+ * The split is the same as every other card: this tool does the surface-free
+ * work (validate the script, keep the read inside what a voice can carry), and
+ * the injected `voiceoverStore` holds the provider key and the wallet.
+ *
+ * Deliberately NOT the Design Studio's design_generate_voice. That tool speaks
+ * through the `designControl` canvas channel, which surfaces outside the Design
+ * Studio never mount — allowlisting it into another room registers a tool that
+ * answers "no canvas" every single time.
+ */
+export declare class WriteVoiceoverTool implements Tool {
+    readonly name = "write_voiceover";
+    readonly description = "Render a standalone voiceover in your own voice \u2014 audio on its own, with no video around it. Use when they ask for a read, narration, or a voiceover without describing a shot.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=write-voiceover.d.ts.map