@project-ava-supernova/core 0.2.71

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

@@ -0,0 +1,31 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+/**
+ * Emit a finished exercise to the gym's drafts — one call per movement.
+ *
+ * Same construction as write_recipe, and for a sharper reason. A recipe that
+ * cannot be cooked wastes a dinner; a movement written badly hurts someone. So
+ * this does not ASK for a safe, programmable exercise — it makes an unsafe or
+ * unprogrammable one FAIL:
+ *
+ *   - Kit named in the steps but missing from the equipment list is REFUSED.
+ *     Someone filtering for "bodyweight, at home" must never be handed a
+ *     movement whose third step reaches for a barbell.
+ *   - No primary muscle is REFUSED. Without one no plan can ever select it;
+ *     the exercise exists and is unreachable.
+ *   - No movement pattern is REFUSED. Muscle groups cannot tell a press from a
+ *     hinge, so a week cannot be balanced without it.
+ *   - A loaded, overhead or high-impact movement with no contraindications is
+ *     REFUSED. That is the safety floor, not a nice-to-have.
+ *
+ * Everything lands UNPUBLISHED. Ava drafts, the operator publishes.
+ */
+export declare class WriteExerciseTool implements Tool {
+    readonly name = "write_exercise";
+    readonly description = "Emit a finished exercise as a draft. Every piece of equipment the steps name must be in the equipment list, it must have a primary muscle and a movement pattern, and anything loaded or overhead must carry contraindications \u2014 all CHECKED, and a failure comes back with what to fix.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=write-exercise.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-exercise.d.ts","sourceRoot":"","sources":["../../src/tools/write-exercise.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;AAM5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,iBAAkB,YAAW,IAAI;IAC5C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,mSACyQ;IAC7R,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAC5C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAiH7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAmJjG"}

package/dist/tools/write-exercise.js

@@ -0,0 +1,278 @@
+import { MOVEMENT_PATTERNS } from '../exercises/index.js';
+/**
+ * Emit a finished exercise to the gym's drafts — one call per movement.
+ *
+ * Same construction as write_recipe, and for a sharper reason. A recipe that
+ * cannot be cooked wastes a dinner; a movement written badly hurts someone. So
+ * this does not ASK for a safe, programmable exercise — it makes an unsafe or
+ * unprogrammable one FAIL:
+ *
+ *   - Kit named in the steps but missing from the equipment list is REFUSED.
+ *     Someone filtering for "bodyweight, at home" must never be handed a
+ *     movement whose third step reaches for a barbell.
+ *   - No primary muscle is REFUSED. Without one no plan can ever select it;
+ *     the exercise exists and is unreachable.
+ *   - No movement pattern is REFUSED. Muscle groups cannot tell a press from a
+ *     hinge, so a week cannot be balanced without it.
+ *   - A loaded, overhead or high-impact movement with no contraindications is
+ *     REFUSED. That is the safety floor, not a nice-to-have.
+ *
+ * Everything lands UNPUBLISHED. Ava drafts, the operator publishes.
+ */
+export class WriteExerciseTool {
+    name = 'write_exercise';
+    description = 'Emit a finished exercise as a draft. Every piece of equipment the steps name must be in the equipment list, it must have a primary muscle and a movement pattern, and anything loaded or overhead must carry contraindications — all CHECKED, and a failure comes back with what to fix.';
+    riskLevel = 'write';
+    requiresConfirmation = false;
+    schema = {
+        name: 'write_exercise',
+        description: 'Emit the finished exercise as a draft. Call ONCE per movement. The steps are checked against the equipment list, so anything the method reaches for must be listed. It must name what it is FOR (a primary muscle) and how the body moves (a movement pattern), or no plan can select or balance it.',
+        parameters: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'The canonical name of the movement.' },
+                seed_id: { type: 'string', description: 'If written from a seed, pass its id so the seed leaves the backlog.' },
+                movement_pattern: {
+                    type: 'string', enum: MOVEMENT_PATTERNS,
+                    description: 'REQUIRED. How the body moves. This is what balances a training week — muscle groups cannot tell a press from a hinge.',
+                },
+                force_type: { type: 'string', enum: ['push', 'pull', 'static'] },
+                laterality: { type: 'string', enum: ['bilateral', 'unilateral', 'alternating'] },
+                session_role: {
+                    type: 'string', enum: ['main', 'accessory', 'finisher', 'warmup', 'cooldown', 'mobility'],
+                    description: 'Where it sits in a session. Without it a plan cannot order one, and heavy work lands after the finisher.',
+                },
+                exercise_type: { type: 'string', enum: ['compound', 'isolation', 'bodyweight', 'cardio', 'mobility', 'plyometric', 'isometric', 'stretching', 'breathing'] },
+                difficulty: {
+                    type: 'integer', minimum: 1, maximum: 5,
+                    description: '1 = has never trained and is nervous. 5 = advanced and load-bearing. Be honest: if everything is a 3, the number is decoration and beginners get intermediate plans.',
+                },
+                description: { type: 'string', description: 'What the movement is and what it is for. No hype.' },
+                beginner_detail: { type: 'string', description: 'What a nervous first-timer needs to know that an experienced lifter does not.' },
+                common_mistakes: { type: 'string', description: 'What goes wrong in practice, and what it costs.' },
+                muscles: {
+                    type: 'array',
+                    description: 'REQUIRED, and at least one must be primary. Primary = what the exercise is FOR; everything else is secondary.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            muscle: { type: 'string', description: 'Muscle group name, e.g. "Glutes", "Lats", "Triceps".' },
+                            role: { type: 'string', enum: ['primary', 'secondary'] },
+                        },
+                        required: ['muscle', 'role'],
+                    },
+                },
+                equipment: {
+                    type: 'array', items: { type: 'string' },
+                    description: 'REQUIRED. Everything the movement needs. "Bodyweight" is a real and complete answer. Anything your steps reach for must appear here.',
+                },
+                steps: {
+                    type: 'array',
+                    description: 'The movement in order — set-up, then execution. Imperative and specific. Plain strings are fine; use objects with an "action" field only when a step needs notes or a safety flag.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            action: { type: 'string' },
+                            notes: { type: 'string' },
+                            safety_flag: { type: 'boolean', description: 'True when this step is the one that prevents an injury rather than improves a number.' },
+                        },
+                        required: ['action'],
+                    },
+                },
+                coaching_cues: {
+                    type: 'array', items: { type: 'string' },
+                    description: 'Short imperative cues — "chest up", "screw your feet into the floor". What a coach says while someone is under the bar, as distinct from the numbered steps.',
+                },
+                routine: {
+                    type: 'object',
+                    description: 'How to programme it. seconds_per_set INCLUDES the rest — it is what lets a plan answer "will this fit in thirty minutes". rpe or percent_1rm gives effort; sets and reps only give volume.',
+                    properties: {
+                        sets: { type: 'integer' },
+                        reps_target: { type: 'string' },
+                        rest_seconds: { type: 'integer' },
+                        tempo: { type: 'string' },
+                        frequency_per_week: { type: 'string' },
+                        progression: { type: 'string' },
+                        rpe: { type: 'number' },
+                        percent_1rm: { type: 'string' },
+                        seconds_per_set: { type: 'integer' },
+                    },
+                },
+                cardio: {
+                    type: 'object',
+                    description: 'For cardio only. Steady state and intervals are different prescriptions — do not force either into sets and reps.',
+                    properties: {
+                        style: { type: 'string', enum: ['steady', 'interval', 'circuit', 'sprint'] },
+                        duration_minutes: { type: 'integer' },
+                        heart_rate_zone: { type: 'string' },
+                        work_seconds: { type: 'integer' },
+                        rest_seconds: { type: 'integer' },
+                        rounds: { type: 'integer' },
+                    },
+                },
+                contraindications: {
+                    type: 'array',
+                    description: 'Who should not do this, and what to do instead. REQUIRED for anything loaded, overhead or high-impact. Use condition keys a health profile also speaks.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            condition: { type: 'string', description: "e.g. 'knee_pain', 'lower_back_pain', 'shoulder_impingement', 'pregnancy', 'hypertension'." },
+                            severity: { type: 'string', enum: ['avoid', 'caution', 'modify'] },
+                            note: { type: 'string', description: 'Why, and the substitute. "Avoid" with no alternative is a dead end for the reader.' },
+                        },
+                        required: ['condition', 'severity'],
+                    },
+                },
+                regression_of: { type: 'string', description: 'The easier version of the SAME movement, by name.' },
+                progression_to: { type: 'string', description: 'The harder version of the SAME movement, by name.' },
+                substitutions: {
+                    type: 'array', items: { type: 'string' },
+                    description: 'DIFFERENT movements that do the same job when the kit is missing or this one hurts. Not the same as a progression.',
+                },
+                demo_image_prompt: {
+                    type: 'string',
+                    description: 'A PERSON PERFORMING THE MOVEMENT — position, joint angles, camera angle, whole body in frame. Usually the hardest position of the rep, from the angle that makes the form legible. Never a description of the room: the existing library is 170 photographs of empty gyms because they were prompted as places.',
+                },
+            },
+            required: ['name', 'movement_pattern', 'muscles', 'equipment', 'steps'],
+        },
+    };
+    async execute(args, context) {
+        const store = context.sharedState?.exerciseStore;
+        if (!store)
+            return { success: false, output: 'The exercise library is not available in this context.' };
+        const name = String(args.name ?? '').trim();
+        if (!name)
+            return { success: false, output: 'write_exercise requires a name.' };
+        // Same tolerance as steps. A bare string is read as a PRIMARY muscle —
+        // if she names a muscle without qualifying it, what the exercise is for is
+        // the only sensible reading.
+        const rawMuscles = Array.isArray(args.muscles) ? args.muscles : [];
+        const muscles = rawMuscles.map((m) => {
+            if (typeof m === 'string')
+                return { muscle: m.trim(), role: 'primary' };
+            const o = m;
+            return {
+                muscle: String(o?.muscle ?? o?.name ?? o?.muscle_group ?? '').trim(),
+                role: o?.role === 'primary' ? 'primary' : 'secondary',
+            };
+        }).filter((m) => m.muscle);
+        if (!muscles.some((m) => m.role === 'primary')) {
+            return {
+                success: false,
+                output: (rawMuscles.length && !muscles.length
+                    ? `REFUSED: ${rawMuscles.length} muscles were supplied but none could be read. Send them as {"muscle": "Forearms", "role": "primary"}, or as plain names which are taken as primary. `
+                    : '') +
+                    'REFUSED: no primary muscle. Mark at least one muscle as primary — what the exercise is FOR. ' +
+                    'Without it no plan can ever select this movement: it would exist in the library and be unreachable.',
+            };
+        }
+        const equipment = Array.isArray(args.equipment)
+            ? args.equipment.map((e) => String(e).trim()).filter(Boolean)
+            : [];
+        if (!equipment.length) {
+            return {
+                success: false,
+                output: 'REFUSED: no equipment. List everything the movement needs — "Bodyweight" is a complete and correct answer where nothing is used. ' +
+                    'Anything your steps reach for must appear here, or someone filtering for what they own gets handed a movement they cannot do.',
+            };
+        }
+        // Accept a plain string OR an object. The library's 170 existing exercises
+        // store steps as an array of strings, so that is the shape she reaches for;
+        // insisting on {action} objects made this tool refuse eight perfectly good
+        // exercises in a row. Where the meaning is unambiguous, be tolerant of the
+        // shape.
+        const rawSteps = Array.isArray(args.steps) ? args.steps : [];
+        const steps = rawSteps.map((s) => {
+            if (typeof s === 'string')
+                return { action: s.trim(), notes: null, safety_flag: false };
+            const o = s;
+            return {
+                action: String(o?.action ?? o?.step ?? o?.text ?? '').trim(),
+                notes: o?.notes ? String(o.notes) : null,
+                safety_flag: o?.safety_flag === true,
+            };
+        }).filter((s) => s.action);
+        if (!steps.length) {
+            // Distinguish "you sent none" from "you sent some I could not read".
+            // Telling her "no steps" when she supplied eight sent her round the same
+            // loop four times, which is a failure of the ERROR, not of her.
+            return {
+                success: false,
+                output: rawSteps.length
+                    ? `REFUSED: ${rawSteps.length} steps were supplied but none could be read. Send steps as an array of plain strings, e.g. ["Set your feet shoulder-width apart.", "Brace and drive up."], or as objects with an "action" field.`
+                    : 'REFUSED: no steps. A movement with no method cannot be performed or checked.',
+            };
+        }
+        const contraindications = Array.isArray(args.contraindications)
+            ? args.contraindications.map((c) => ({
+                condition: String(c?.condition ?? '').trim(),
+                severity: (['avoid', 'caution', 'modify'].includes(String(c?.severity)) ? c.severity : 'caution'),
+                note: c?.note ? String(c.note) : null,
+            })).filter((c) => c.condition)
+            : [];
+        const exercise = {
+            name,
+            seed_id: args.seed_id ? String(args.seed_id) : null,
+            exercise_type: args.exercise_type ? String(args.exercise_type) : null,
+            movement_pattern: (args.movement_pattern ?? null),
+            force_type: (args.force_type ?? null),
+            laterality: (args.laterality ?? null),
+            session_role: (args.session_role ?? null),
+            difficulty: typeof args.difficulty === 'number' ? args.difficulty : null,
+            description: args.description ? String(args.description) : null,
+            beginner_detail: args.beginner_detail ? String(args.beginner_detail) : null,
+            common_mistakes: args.common_mistakes ? String(args.common_mistakes) : null,
+            muscles,
+            equipment,
+            steps,
+            coaching_cues: Array.isArray(args.coaching_cues) ? args.coaching_cues.map(String) : [],
+            routine: (args.routine ?? null),
+            cardio: (args.cardio ?? null),
+            contraindications,
+            substitutions: Array.isArray(args.substitutions) ? args.substitutions.map(String) : [],
+            regression_of: args.regression_of ? String(args.regression_of) : null,
+            progression_to: args.progression_to ? String(args.progression_to) : null,
+            demo_image_prompt: args.demo_image_prompt ? String(args.demo_image_prompt) : null,
+        };
+        // ── The equipment law, and the safety floor ──
+        const check = await store.check(exercise);
+        if (check.status === 'fail') {
+            const byKind = new Map();
+            for (const f of check.findings) {
+                const arr = byKind.get(f.kind) ?? [];
+                arr.push(f.term);
+                byKind.set(f.kind, arr);
+            }
+            const lines = [...byKind.entries()].map(([kind, terms]) => `${kind}: ${terms.join(', ')}`);
+            return {
+                success: false,
+                output: `REFUSED — this exercise did not pass its checks:\n${lines.join('\n')}\n\n` +
+                    check.findings.map((f) => `· ${f.message}`).join('\n') +
+                    '\n\nFix these and call write_exercise again. If the steps reach for kit, either add it to the equipment list or change the step — do not rewrite the whole movement to dodge one line.',
+            };
+        }
+        const { id, error: saveError } = await store.save(exercise);
+        if (!id) {
+            return {
+                success: false,
+                output: saveError
+                    ? `The exercise passed its checks but COULD NOT BE SAVED: ${saveError}. Nothing was written — do not report it as created.`
+                    : 'The exercise passed its checks but COULD NOT BE SAVED — the store returned no id, so nothing was written. Do not report it as created.',
+            };
+        }
+        return {
+            success: true,
+            output: JSON.stringify({
+                ok: true,
+                id,
+                name,
+                status: 'draft',
+                movement_pattern: exercise.movement_pattern,
+                primary: muscles.filter((m) => m.role === 'primary').map((m) => m.muscle),
+                note: 'Saved as a DRAFT. The operator publishes.',
+            }),
+        };
+    }
+}
+//# sourceMappingURL=write-exercise.js.map

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

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

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

@@ -0,0 +1,31 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+import { imageSizeFor } from '../social/index.js';
+/**
+ * Make the picture that goes with a post — or repair one that nearly works.
+ *
+ * Two things are deliberate here:
+ *
+ * SIZE IS DERIVED, NEVER ASKED FOR. The schema has no width, height or aspect
+ * ratio, because a model that can choose a resolution can choose the wrong one
+ * and a 1:1 image on a Reel is a wasted generation. She names the platform; the
+ * spec map answers.
+ *
+ * EDIT IS THE FIRST INSTINCT, NOT THE FALLBACK. `reference_image` switches the
+ * provider to the edit family so an instruction changes only the part that is
+ * wrong. Re-rolling a picture that is 90% right throws away the 90% and gambles
+ * on getting it back — the same reasoning as repairing a recipe rather than
+ * generating another one.
+ */
+export declare class WritePostImageTool implements Tool {
+    readonly name = "write_post_image";
+    readonly description = "Make the image for a post, sized for its platform \u2014 or edit an existing image instead of replacing it.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+/** Exported for the size table's own sake — hosts and tests resolve sizes the
+ *  same way the tool does, rather than duplicating the map. */
+export { imageSizeFor };
+//# sourceMappingURL=write-post-image.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-post-image.d.ts","sourceRoot":"","sources":["../../src/tools/write-post-image.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;AAC5D,OAAO,EAAE,YAAY,EAA4C,MAAM,oBAAoB,CAAC;AAE5F;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,kBAAmB,YAAW,IAAI;IAC7C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,WAAW,iHACuF;IAC3G,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAC5C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAiC7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CA8CjG;AAED;+DAC+D;AAC/D,OAAO,EAAE,YAAY,EAAE,CAAC"}

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

@@ -0,0 +1,102 @@
+import { imageSizeFor } from '../social/index.js';
+/**
+ * Make the picture that goes with a post — or repair one that nearly works.
+ *
+ * Two things are deliberate here:
+ *
+ * SIZE IS DERIVED, NEVER ASKED FOR. The schema has no width, height or aspect
+ * ratio, because a model that can choose a resolution can choose the wrong one
+ * and a 1:1 image on a Reel is a wasted generation. She names the platform; the
+ * spec map answers.
+ *
+ * EDIT IS THE FIRST INSTINCT, NOT THE FALLBACK. `reference_image` switches the
+ * provider to the edit family so an instruction changes only the part that is
+ * wrong. Re-rolling a picture that is 90% right throws away the 90% and gambles
+ * on getting it back — the same reasoning as repairing a recipe rather than
+ * generating another one.
+ */
+export class WritePostImageTool {
+    name = 'write_post_image';
+    description = 'Make the image for a post, sized for its platform — or edit an existing image instead of replacing it.';
+    riskLevel = 'write';
+    requiresConfirmation = false;
+    schema = {
+        name: 'write_post_image',
+        description: 'Make the picture that goes with a post, sized correctly for its platform. Use when a post needs a visual — you do NOT need to send them to the Design Studio for this. To FIX an image that is nearly right, pass its URL as reference_image and describe only the change: that edits it rather than generating a new one, which keeps everything that already worked. Check the canvas and browse_library first — the image you want may already exist.',
+        parameters: {
+            type: 'object',
+            properties: {
+                prompt: {
+                    type: 'string',
+                    description: 'What the picture shows — subject, composition, style, mood, lighting. Concrete and visual. When editing, describe ONLY the change ("make the headline bigger", "remove the coffee cup"), not the whole picture again.',
+                },
+                platform: {
+                    type: 'string',
+                    enum: ['tweet', 'x', 'linkedin', 'facebook', 'instagram', 'tiktok', 'youtube', 'blog', 'post'],
+                    description: 'Where the post is going. This decides the image size — you never specify dimensions.',
+                },
+                format: {
+                    type: 'string',
+                    enum: ['feed', 'reel', 'story', 'short'],
+                    description: 'The shape within that platform. Facebook and Instagram need this: a feed image and a Reel are different shapes on the same platform. Omit for platforms with only one shape.',
+                },
+                reference_image: {
+                    type: 'string',
+                    description: 'URL of an existing image to EDIT. Pass this whenever you are fixing or adjusting something that already exists — including an image from the Library. Leave empty only when making something genuinely new.',
+                },
+                negative_prompt: {
+                    type: 'string',
+                    description: 'What to keep OUT of the frame.',
+                },
+                title: { type: 'string', description: 'Optional short title for the Library.' },
+            },
+            required: ['prompt', 'platform'],
+        },
+    };
+    async execute(args, context) {
+        const store = context.sharedState?.postImageStore;
+        if (!store) {
+            return {
+                success: false,
+                output: 'Post images are not available in this context. The host must inject `postImageStore` into shared state.',
+            };
+        }
+        const prompt = (args.prompt || '').trim();
+        if (!prompt) {
+            return { success: false, output: 'write_post_image requires a prompt — describe the picture, or the change you want made.' };
+        }
+        const platform = (args.platform || 'post').trim();
+        const format = (args.format || '').trim() || undefined;
+        const referenceImage = (args.reference_image || '').trim() || undefined;
+        const image = {
+            prompt,
+            platform,
+            format,
+            referenceImage,
+            negativePrompt: (args.negative_prompt?.trim()) || undefined,
+            title: (args.title?.trim()) || undefined,
+        };
+        try {
+            const written = await store.write(image);
+            // Say which shape it came out at. She cannot see the picture, so the size
+            // is the one concrete fact about it she is allowed to state.
+            const what = written.edited ? 'Edited the image' : 'Made the image';
+            return {
+                success: true,
+                output: `${what} for ${platform}${format ? ` (${format})` : ''} at ${written.size}. It is on the canvas. ` +
+                    `You have NOT seen it — ask them what to change rather than whether it looks right, and when they tell you, ` +
+                    `edit it with reference_image rather than generating another one.`,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: `Could not make the image: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+}
+/** Exported for the size table's own sake — hosts and tests resolve sizes the
+ *  same way the tool does, rather than duplicating the map. */
+export { imageSizeFor };
+//# sourceMappingURL=write-post-image.js.map

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

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

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

@@ -0,0 +1,20 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+/**
+ * Emit a finished social post to the Social Studio canvas — one call per post.
+ * The card render + Library auto-save happen in the surface-injected
+ * `postStore` (sharedState); this tool does the surface-free work: validate the
+ * body and enforce the platform's hard character cap deterministically (LLMs
+ * can't count reliably), rejecting an over-limit post with the exact overage so
+ * Ava trims and re-calls in the same turn instead of shipping something that
+ * won't publish.
+ */
+export declare class WritePostTool implements Tool {
+    readonly name = "write_post";
+    readonly description = "Emit a finalized social media post to the Social Studio canvas. Call this ONCE PER POST \u2014 for 4 variants, call it 4 times. Never write post content in your narration; only call this tool. Your reply stays brief narration (\"Wrote 3 Monday tweets \u2014 see canvas\").";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=write-post.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-post.d.ts","sourceRoot":"","sources":["../../src/tools/write-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;AAG5D;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,IAAI;IACxC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,sRACqP;IACzQ,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAC5C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAoB7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAoFjG"}

package/dist/tools/write-post.js

@@ -0,0 +1,113 @@
+import { POST_HARD_LIMITS, REDDIT_TITLE_LIMIT } from '../social/index.js';
+/**
+ * Emit a finished social post to the Social Studio canvas — one call per post.
+ * The card render + Library auto-save happen in the surface-injected
+ * `postStore` (sharedState); this tool does the surface-free work: validate the
+ * body and enforce the platform's hard character cap deterministically (LLMs
+ * can't count reliably), rejecting an over-limit post with the exact overage so
+ * Ava trims and re-calls in the same turn instead of shipping something that
+ * won't publish.
+ */
+export class WritePostTool {
+    name = 'write_post';
+    description = 'Emit a finalized social media post to the Social Studio canvas. Call this ONCE PER POST — for 4 variants, call it 4 times. Never write post content in your narration; only call this tool. Your reply stays brief narration ("Wrote 3 Monday tweets — see canvas").';
+    riskLevel = 'write';
+    requiresConfirmation = false;
+    schema = {
+        name: 'write_post',
+        description: 'Emit a finalized social media post to the Social Studio canvas. Call this ONCE PER POST. When you generate 4 post variants, call write_post 4 times. Never write post content in your narration — only call this tool. Your text reply should be brief narration ("Wrote 3 Monday tweets — see canvas").',
+        parameters: {
+            type: 'object',
+            properties: {
+                platform: {
+                    type: 'string',
+                    enum: ['tweet', 'linkedin', 'thread', 'facebook', 'instagram', 'bluesky', 'eurosky', 'reddit', 'discord', 'youtube', 'tiktok', 'producthunt', 'blog', 'post'],
+                    description: 'Target platform. "tweet" for X, "bluesky" for Bluesky (300 char cap), "tiktok" for TikTok, "youtube" for YouTube Shorts. "post" only if none of the above fit.',
+                },
+                content: { type: 'string', description: 'The finalized post content, ready to publish. Include the hashtags and link inline per the platform tag policy — content must be copy-paste ready.' },
+                title: { type: 'string', description: 'Short title for the library (e.g. "Monday Motivation v1"). Auto-generated if omitted — EXCEPT on Reddit, where the title is published content, is REQUIRED, caps at 300 characters, and does most of the work of the post.' },
+                variant: { type: 'string', description: 'Optional variant label when writing multiple versions of the same post (e.g. "punchy", "deeper", "hopeful").' },
+                hashtags: { type: 'array', items: { type: 'string' }, description: 'The hashtags you chose for this post (the same ones present in content), so the UI can show them as an editable chip row. Pulled from research_post and kept within the platform tag policy. Omit for platforms that take no tags (e.g. blog).' },
+                tag_note: { type: 'string', description: 'One short line on why these tags — e.g. "#buildinpublic + #aitools for reach, #localfirst niche". Shown under the chips.' },
+            },
+            required: ['platform', 'content'],
+        },
+    };
+    async execute(args, context) {
+        const store = context.sharedState?.postStore;
+        if (!store) {
+            return {
+                success: false,
+                output: 'Post storage is not available in this context. The host must inject `postStore` into shared state.',
+            };
+        }
+        const platform = (args.platform || 'post').trim();
+        const content = (args.content || '').trim();
+        if (!content || content.length < 2) {
+            return { success: false, output: 'write_post requires non-empty content.' };
+        }
+        // Deterministic char-limit enforcement — count by code point (emoji = 1),
+        // reject over-limit with the exact overage so Ava trims and re-calls.
+        const hardLimit = POST_HARD_LIMITS[platform];
+        if (hardLimit) {
+            const len = Array.from(content).length;
+            if (len > hardLimit) {
+                const over = len - hardLimit;
+                return {
+                    success: false,
+                    output: `This ${platform} post is ${len} characters — ${over} over the ${hardLimit} limit. ` +
+                        `Trim ${over}+ characters and call write_post again. Keep the hook and the point; cut ` +
+                        `filler, not substance. (Hashtags and any link count toward the limit.)`,
+                };
+            }
+        }
+        // Reddit's title is not a library label — it is the headline people vote on,
+        // and a Reddit post without one is not a post. Enforced here rather than left
+        // to the prompt, so the failure is a corrective message Ava can act on.
+        if (platform === 'reddit') {
+            const title = (args.title || '').trim();
+            if (!title) {
+                return {
+                    success: false,
+                    output: 'A Reddit post needs a title — on Reddit the title is published content, not a library ' +
+                        'label. It is what people vote on and often all they read. Write a plain, specific title ' +
+                        '(max 300 characters, no hashtags) and call write_post again.',
+                };
+            }
+            const titleLen = Array.from(title).length;
+            if (titleLen > REDDIT_TITLE_LIMIT) {
+                const over = titleLen - REDDIT_TITLE_LIMIT;
+                return {
+                    success: false,
+                    output: `This Reddit title is ${titleLen} characters — ${over} over the ${REDDIT_TITLE_LIMIT} limit. ` +
+                        `Trim ${over}+ characters and call write_post again.`,
+                };
+            }
+        }
+        const hashtags = Array.isArray(args.hashtags)
+            ? args.hashtags.map(h => String(h).trim().replace(/^#/, '')).filter(Boolean)
+            : [];
+        const post = {
+            platform,
+            content,
+            title: (args.title?.trim()) || null,
+            variant: (args.variant?.trim()) || null,
+            hashtags,
+            tagNote: (args.tag_note?.trim()) || null,
+        };
+        try {
+            const written = await store.write(post);
+            const label = post.variant ? ` (${post.variant})` : '';
+            return {
+                success: true,
+                output: `Posted a ${platform} card${label} to the canvas${written.assetId ? ' — saved to the Library' : ''}.`,
+                metadata: { id: written.id, platform, assetId: written.assetId ?? null },
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { success: false, output: `Failed to write the post: ${msg}` };
+        }
+    }
+}
+//# sourceMappingURL=write-post.js.map

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

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