corent-mcp 0.6.0 → 0.8.0

package/dist/prompts.js

@@ -0,0 +1,123 @@
+/**
+ * MCP prompts: five production recipes built ONLY from the tools this server
+ * already exposes. Each is a step list an assistant follows with the user:
+ * plan, confirm the budget, stills with references, clips, narration, poll.
+ *
+ * The long "how to" guidance used to live inside tool descriptions; it lives
+ * here now so every tool description stays under 400 characters (ChatGPT and
+ * other hosts truncate or reject long ones). The same five recipes ship as
+ * markdown in mcp/skills/<name>/SKILL.md for publication as a skills repo.
+ */
+import { z } from "zod";
+// Honest per-unit prices, in the same words the tool descriptions use. Quote
+// these to the user before spending; the exact charge comes back per call.
+export const PRICE_NOTE = "Prices to quote before spending: image premium ~7c each; video premium ~52c per clip, pro ~84c per clip; " +
+    "speech ~25-30c per started block of 1,000 characters (send the whole script in ONE generate_speech call). " +
+    "Failed generations are never billed. The exact charge is in meta.cost_cents on every result.";
+const BUDGET_RULE = "Add the numbers up, show the user the total against their budget, and do NOT call a paid tool until they say yes. " +
+    "Call get_balance first: available_cents is what can actually be spent.";
+const POLLING = "Video is asynchronous: each generate_video returns a job id. Poll get_job every 10-15 seconds until status is " +
+    "completed (a clip usually takes 1-4 minutes); the URL is in videos[0].url. If the user changes their mind, cancel_job releases the hold.";
+const DELIVERY = "Corent does not stitch clips together. Deliver every still, clip and narration URL in order with its cost, " +
+    "so the user can assemble them in any editor. list_media can find these again later by prompt keyword.";
+function user(text) {
+    return { messages: [{ role: "user", content: { type: "text", text } }] };
+}
+export function registerPrompts(server) {
+    server.registerPrompt("product-ugc-reel", {
+        title: "Product UGC reel",
+        description: "A vertical creator-style reel for one product: 3-5 stills that keep the product consistent, one clip per still, and a single narration track.",
+        argsSchema: {
+            product_url: z.string().describe("Public https URL of a product photo (use upload_image for a local file)"),
+            brief: z.string().describe("Who it is for and the one thing the reel must say"),
+            budget_usd: z.string().optional().describe("Spend ceiling in US dollars, e.g. 5"),
+        },
+    }, ({ product_url, brief, budget_usd }) => user([
+        `Make a product UGC reel. Product image: ${product_url}. Brief: ${brief}. Budget: $${budget_usd ?? "ask the user"}.`,
+        "",
+        "1. PLAN. Write a 4-shot vertical (9:16) shot list: hook, product in use, the benefit, call to action. One line of narration per shot; keep the whole script under 1,000 characters.",
+        `2. COST. ${PRICE_NOTE} ${BUDGET_RULE}`,
+        "3. STILLS. For each shot call generate_image with reference_image_urls=[product image], tier premium (never air or lite: references need an edit-capable model), aspect_ratio 9:16, style photorealistic. If the label or logo must be pixel-exact, generate the scene, then inpaint_image with a mask that is BLACK over the product and WHITE elsewhere: pixels outside the mask stay byte-for-byte.",
+        "4. CLIPS. For each approved still call generate_video with image_url = that still, tier premium (pro if the user wants the best), duration_s 5. Omit aspect_ratio when animating a still. Pass audio false; the narration is a separate track.",
+        "5. NARRATION. Call list_voices, let the user pick a voice_id, then ONE generate_speech call with the full script.",
+        `6. POLL. ${POLLING}`,
+        `7. DELIVER. ${DELIVERY}`,
+    ].join("\n")));
+    server.registerPrompt("character-series", {
+        title: "Character series",
+        description: "One consistent character across many scenes: an anchor portrait, then every scene generated as an edit of that anchor.",
+        argsSchema: {
+            character: z.string().describe("Who the character is: age, look, clothing, mood"),
+            scenes: z.string().describe("The scenes, comma separated, e.g. 'at a cafe, on a train, at the beach'"),
+            budget_usd: z.string().optional().describe("Spend ceiling in US dollars"),
+        },
+    }, ({ character, scenes, budget_usd }) => user([
+        `Make a consistent character series. Character: ${character}. Scenes: ${scenes}. Budget: $${budget_usd ?? "ask the user"}.`,
+        "",
+        "1. ANCHOR. One generate_image, tier premium, aspect_ratio 3:4: the character alone, neutral pose, plain background, face clearly visible. Show it to the user and iterate (same seed, one change) until they approve. This is the only image the series is built from.",
+        `2. COST. One image per scene at ~7c (premium). ${BUDGET_RULE}`,
+        "3. SCENES. For each scene call generate_image with reference_image_urls=[anchor URL], tier premium or pro, the scene in the prompt, same style every time. Keep the anchor as the FIRST reference if you add a second (e.g. a product).",
+        "4. OPTIONAL CLIPS. generate_video with image_url = the scene still, duration_s 5, omit aspect_ratio. Quote ~52c (premium) or ~84c (pro) per clip first.",
+        `5. POLL. ${POLLING}`,
+        `6. DELIVER. ${DELIVERY} Tell the user the anchor URL: pass it as a reference any time they want this character again.`,
+    ].join("\n")));
+    server.registerPrompt("storyboard-to-clip", {
+        title: "Storyboard to clips",
+        description: "Turn a numbered storyboard into stills, then one clip per still with a camera move, plus optional narration.",
+        argsSchema: {
+            storyboard: z.string().describe("Numbered shots, one line each: what is in frame and what moves"),
+            style: z.string().optional().describe("Look, e.g. cinematic, anime, documentary"),
+            budget_usd: z.string().optional().describe("Spend ceiling in US dollars"),
+        },
+    }, ({ storyboard, style, budget_usd }) => user([
+        `Turn this storyboard into clips. Style: ${style ?? "cinematic"}. Budget: $${budget_usd ?? "ask the user"}.`,
+        storyboard,
+        "",
+        "1. PLAN. Restate the shots as a table: number, frame, movement, seconds (5 each unless told otherwise), narration line if any.",
+        `2. COST. One still (~7c) plus one clip (~52c premium, ~84c pro) per shot, plus ~30c if there is narration. ${BUDGET_RULE}`,
+        "3. STILLS. generate_image per shot, aspect_ratio 16:9, style cinematic (or the requested style), tier premium. Use reference_image_urls when a character or object recurs across shots, with the first approved still as the reference.",
+        "4. CLIPS. generate_video per approved still: image_url = the still, duration_s 5, a camera value that matches the movement (pan_left, zoom_in, orbit_right, static ...). For an A-to-B shot pass end_image_url = the next shot's still. Omit aspect_ratio when animating a still.",
+        "5. NARRATION. If the storyboard has lines, list_voices then ONE generate_speech with the whole script.",
+        `6. POLL. ${POLLING}`,
+        `7. DELIVER. ${DELIVERY}`,
+    ].join("\n")));
+    server.registerPrompt("ad-variations", {
+        title: "Ad variations",
+        description: "Many versions of one ad visual for testing, in a single batch, with the product kept consistent when a product photo is given.",
+        argsSchema: {
+            concept: z.string().describe("The ad idea in one or two sentences"),
+            count: z.string().optional().describe("How many variations, 2-50 (default 6)"),
+            product_url: z.string().optional().describe("Public https URL of the product photo, if the product must stay consistent"),
+        },
+    }, ({ concept, count, product_url }) => user([
+        `Make ${count ?? "6"} variations of this ad: ${concept}.${product_url ? ` Product image: ${product_url}.` : ""}`,
+        "",
+        "1. PLAN. Choose the axes to vary (setting, angle, time of day, audience, mood) and write one prompt per variation. Same aspect_ratio for all (1:1 for feed, 9:16 for stories). No readable text in the images; headlines go on top in the editor.",
+        `2. COST. ~7c per premium image, so count x 7c. ${BUDGET_RULE}`,
+        product_url
+            ? "3. RENDER. With a product photo, batch items cannot carry references: call generate_image once per variation with reference_image_urls=[product image], tier premium. Use inpaint_image (mask BLACK over the product) when the label must be pixel-exact."
+            : "3. RENDER. One generate_image_batch call with every prompt as an item, tier premium. Poll get_batch, then get_job for each finished item.",
+        "4. REVIEW. Show the user a numbered list with each URL and prompt. Re-render a favourite with the same seed and one change.",
+        "5. OPTIONAL MOTION. For the winners, generate_video with image_url = the still, duration_s 5, quoted at ~52c (premium) per clip first.",
+        `6. DELIVER. ${DELIVERY}`,
+    ].join("\n")));
+    server.registerPrompt("faceless-explainer", {
+        title: "Faceless explainer",
+        description: "A narrated explainer with no presenter: a script, one still and one clip per scene, and a single voice track.",
+        argsSchema: {
+            topic: z.string().describe("What the video explains, and to whom"),
+            duration_s: z.string().optional().describe("Target length in seconds (default 30)"),
+            budget_usd: z.string().optional().describe("Spend ceiling in US dollars"),
+        },
+    }, ({ topic, duration_s, budget_usd }) => user([
+        `Make a faceless explainer about: ${topic}. Target length ${duration_s ?? "30"} seconds. Budget: $${budget_usd ?? "ask the user"}.`,
+        "",
+        "1. SCRIPT. Write it yourself (free): about 2.5 words per second, one scene per 5 seconds, each scene = one sentence of narration + one visual. Keep the whole script under 1,000 characters when you can; it bills per started block.",
+        `2. COST. Per scene one still (~7c) and one clip (~52c premium), plus ~30c narration. ${BUDGET_RULE}`,
+        "3. STILLS. generate_image per scene, aspect_ratio 16:9 (9:16 for shorts), tier premium, one consistent style across scenes. Diagrams and objects rather than faces; no readable text in the image.",
+        "4. CLIPS. generate_video per approved still, image_url = the still, duration_s 5, a gentle camera move (zoom_in or pan_right), audio false. Omit aspect_ratio when animating a still.",
+        "5. NARRATION. list_voices, pick a clear narration voice, then ONE generate_speech call with the whole script.",
+        `6. POLL. ${POLLING}`,
+        `7. DELIVER. ${DELIVERY}`,
+    ].join("\n")));
+}