@officexapp/vidfarm-devcli 0.21.39 → 0.21.43

package/dist/src/services/brainstorm-prompts.js

@@ -0,0 +1,132 @@
+// The brainstorm/consultation prompts — ONE source of truth for both runners.
+//
+// Two things run this chain and they must ask for the same thing:
+//
+//   1. The CLOUD primitives (`POST /api/v1/primitives/brainstorm/*`), which send
+//      the prompt to a provider on the user's saved key or the wallet.
+//   2. The KEYLESS LOCAL path (`vidfarm consult <step>`), which prints the same
+//      prompt for the agent already driving the terminal to answer itself. No
+//      provider key, no wallet, no network.
+//
+// If these two ever drift, a director gets a different consultation depending on
+// where they ran it — so the builders live here, pure, and both callers import
+// them. This module has NO backend imports and touches no filesystem: the big
+// reference documents are passed IN, because the cloud reads them off the
+// primitive asset directory and the CLI may not ship them at all.
+/** Drop the trailing "Reference lessons" block when no text was supplied, so a
+ *  keyless caller does not emit a dangling header with nothing under it. */
+function withReference(lines, header, text) {
+    if (!text || !text.trim()) {
+        return lines;
+    }
+    return [...lines, "", header, text];
+}
+export function buildHooksPrompt(offerDescription, count, refs = {}) {
+    return withReference([
+        "You are Vidfarm's elite paid-social hook strategist.",
+        "Your job is to generate high-upside ad hooks for TikTok-native creative.",
+        "Bias toward hooks that feel native to TikTok, but keep raw persuasive power more important than surface trendiness.",
+        "Max creativity. Do not hold back. Be as diverse as possible while staying relevant to the offer.",
+        "Use many angle families across the set: pain, status, curiosity, gossip, confession, myth-busting, shock, taboo, mechanism, objection, identity, urgency, pattern interrupt, transformation, proof, enemy, mistake, secret, social proof, aspiration, and contrarian frames.",
+        "Each hook should be sharp, testable, and materially different from the others.",
+        `Generate exactly ${count} hooks.`,
+        "Return strict JSON only with shape {\"hooks\":[{\"hook\":\"...\",\"explanation\":\"...\"}]}.",
+        "Explanation should be 1-3 sentences on why the hook works and what angle it is leveraging.",
+        "",
+        "Offer details:",
+        offerDescription.trim()
+    ], "Reference lessons to apply:", refs.hooks).join("\n");
+}
+export function buildAwarenessStagesPrompt(offerDescription, refs = {}) {
+    return withReference([
+        "You are Vidfarm's direct-response strategist.",
+        "The user is not sure what type of ads to produce.",
+        "Use Eugene Schwartz-style awareness-stage reasoning to recommend what kinds of ads to make first.",
+        "Write a practical response for TikTok-first performance marketing, but keep the advice broadly useful for paid social.",
+        "Do not return JSON. Return a clear markdown string.",
+        "Include:",
+        "- which awareness stages are most promising first",
+        "- why those stages fit this offer",
+        "- what ad types/messages belong in each stage",
+        "- what to test before moving to deeper or broader awareness stages",
+        "- a short next-step recommendation",
+        "",
+        "Offer details:",
+        offerDescription.trim()
+    ], "Reference lessons to apply:", refs.awareness).join("\n");
+}
+export function buildAnglesPrompt(payload, refs = {}) {
+    const head = [
+        "You are Vidfarm's senior direct-response angle strategist.",
+        "Generate persuasive advertising angles for TikTok-native ads.",
+        "Persuasive depth matters more than format gimmicks. The user wants raw winning angles to test.",
+        "Do not mention templates, scenes, or production mechanics. Focus on the strategic angle itself.",
+        "Create major diversity across the set: pain, myths, enemies, mechanisms, shocking truths, confessions, gossip/social proof, objections, hidden costs, status, identity, aspiration, taboo, mistake, urgency, proof, authority, trend hijack, curiosity, and contrarian frames.",
+        "Favor known winning angle archetypes while still making them specific to the offer.",
+        `Generate exactly ${payload.count} angles.`,
+        "Return strict JSON only with shape {\"angles\":[{\"angle\":\"...\",\"explanation\":\"...\"}]}",
+        "Explanation should say why the angle fits this awareness state and what persuasive lever it uses.",
+        "",
+        `Problem awareness: ${payload.problem_awareness}`,
+        `Solution awareness: ${payload.solution_awareness}`,
+        `Derived stage note: ${describeAwarenessSelection(payload.problem_awareness, payload.solution_awareness)}`,
+        "",
+        "Offer details:",
+        payload.offer_description.trim()
+    ];
+    const withAwareness = withReference(head, "Reference lessons to apply from awareness stages:", refs.awareness);
+    return withReference(withAwareness, "Reference lessons to apply from hooks:", refs.hooks).join("\n");
+}
+export function buildColdstartPrompt(userMessage, count) {
+    return [
+        "You are Vidfarm's TikTok growth strategist.",
+        "The customer has no idea where to start.",
+        "Generate the best possible foundational Q&A questions for the customer and AI to discuss so they can build a strong TikTok strategy from zero.",
+        "The goal is to produce questions whose answers can later power awareness-stage selection, angle generation, hooks, scripts, and template choice.",
+        `Generate exactly ${count} questions.`,
+        "You must include questions covering, at minimum:",
+        "- one-line offer",
+        "- one-paragraph offer",
+        "- product pricing and checkout experience (for example appstore payments, Stripe web checkout, Shopify, invoicing, or sales call)",
+        "- precise target customer psyche",
+        "- customer pain in their own words",
+        "- customer desire and dream outcome",
+        "- awareness levels or uncertainty about them",
+        "Add more strong questions beyond those when useful.",
+        "Return strict JSON only with shape {\"questions\":[{\"question\":\"...\",\"why_it_matters\":\"...\"}]}",
+        "Questions should be phrased so the user can answer them in a single markdown file for future use.",
+        "At least one question should explicitly encourage them to save these answers into an OFFER.md file (or OFFER_<NAME>.md when they run more than one offer), kept locally or in Vidfarm cloud files, for reuse inside Vidfarm.",
+        "",
+        "User message:",
+        userMessage.trim()
+    ].join("\n");
+}
+export function buildProductPlacementPrompt(offerDescription, count) {
+    return [
+        "You are Vidfarm's native-advertising product-placement strategist.",
+        "You are watching the attached video. Study what is actually on screen: scenes, actions, objects, spoken lines, on-screen text, transitions, and emotional beats.",
+        "Your job is to find the highest-leverage moments to organically place the user's product into THIS video so it feels native rather than bolted on.",
+        "Bias toward placements that ride the existing attention, emotion, or story beat of the moment. Native and believable beats loud and interruptive.",
+        "Consider many placement types: on-screen prop/set dressing, character interaction with the product, verbal mention or callout, text/caption overlay, sticker or lower-third, b-roll cutaway, screen/UI replacement, before/after demo, and end-card CTA.",
+        `Identify exactly ${count} distinct product-placement opportunities, ordered from strongest to weakest.`,
+        "Each opportunity must reference a real, specific moment you actually saw in the video, with an approximate timestamp or range (for example \"0:04\" or \"0:12-0:18\").",
+        "Return strict JSON only with shape {\"opportunities\":[{\"timestamp\":\"...\",\"scene\":\"...\",\"placement_type\":\"...\",\"placement_idea\":\"...\",\"why_it_works\":\"...\"}]}.",
+        "\"scene\" briefly describes what is happening on screen at that moment. \"placement_idea\" is the concrete, actionable way to insert the product. \"why_it_works\" explains the persuasion/attention logic.",
+        "",
+        "Product / offer to place:",
+        offerDescription.trim()
+    ].join("\n");
+}
+export function describeAwarenessSelection(problemAwareness, solutionAwareness) {
+    if (problemAwareness === "problem_unaware" && solutionAwareness === "solution_unaware") {
+        return "Lead with unaware-style pattern interrupts, identity, curiosity, story, and emotionally resonant entry points before surfacing the problem.";
+    }
+    if (problemAwareness === "problem_aware" && solutionAwareness === "solution_unaware") {
+        return "Lead with sharp articulation of the pain and consequences, then reveal a new possible solution path.";
+    }
+    if (problemAwareness === "problem_aware" && solutionAwareness === "solution_aware") {
+        return "Lead with strong solution-category promises, differentiation, mechanism, and proof.";
+    }
+    return "Lead with high-curiosity or identity-first entry points that bridge people from vague discomfort toward the existence of a real solution category.";
+}
+//# sourceMappingURL=brainstorm-prompts.js.map