+ Uî—i8‘ãóÈ€Rt^RIHt^RIt^RIt^RIt^RIHtHtH t ^RI H t ^RI H t HtHtHtHt^RIHt]P(!]4t!RR4tR t!R R ]4tR#) ut Prompt Engineer Agent – generates image and video prompts per frame. Uses a SINGLE streaming LLM call for ALL frames. A brace-counting JSON extractor parses complete ScenePrompts objects in real-time as the model streams them, providing per-scene progress feedback. Falls back to instructor-based single-frame calls for any scenes that fail to parse from the stream. )Ú annotationsN)ÚCallableÚIteratorÚOptional)ÚValidationError)ÚAllScenePromptsÚCharacterTemplateÚExpandedFrameBreakdownÚFrameÚ ScenePrompts)Ú BaseAgentcó,€]tRt^#tRtRtRRltRtR#)ÚStreamingJsonExtractorzƒBrace-counting parser that extracts top-level JSON objects from a stream of text chunks. Handles nested braces and escaped quotes.c óL€RVn^VnRVnRVnRVnR#)ÚFNéÿÿÿÿ)Ú_bufÚ_depthÚ _in_stringÚ _escape_nextÚ _obj_start)Úselfs&ÚS/home/gabslocked/Desktop/Projetos/Images/video_automation/agents/prompt_engineer.pyÚ__init__ÚStreamingJsonExtractor.__init__'s&€ØˆŒ ؈Œ ؈ŒØ!ˆÔ؈Žócó €V^8„dQhRRRR/#)éÚchunkÚstrÚreturnz list[str]©)Úformats"rÚ __annotate__Ú#StreamingJsonExtractor.__annotate__.s€÷ñ˜#ð )ñrc óÞ€.pVEFcpV;PV, unVP'd RVnK8VR8XdVP'd RVnKZVR8XdVP'*VnKyVP'dKVR8XdNVP^8Xd"\ VP4^, VnV;P^, unKáVR8XgKêV;P^,unVP^8XgEKVP ^8¼gEK+VPVP RpVP V4RVnR VnEKf V#) zBFeed a text chunk, return list of complete top-level JSON objects.FÚ\TÚ"Ú{Ú}Nrr)rrrrÚlenrÚappend)rrÚobjectsÚchÚobj_strs&& rÚfeedÚStreamingJsonExtractor.feed.s €àˆÜˆBØ IŠI˜OIà× × Ð Ø$)Ô!ÙØTŒz˜dŸoŸo˜oØ$(Ô!ÙØSŒyØ&*§o¡oÔ"5”Ù؈ÙàSŒyØ—;‘; !Ô#Ü&)¨$¯)©)£n°qÕ&8D”OØ— ’ ˜qÕ — Øs–Ø— ’ ˜qÕ • Ø—;‘; !×#¨¯©¸1×(<Ø"Ÿi™i¨¯©Ð(8Ð9GØ—N‘N 7Ô+Ø "D”IØ&(D—Oñ3ð4ˆr)rrrrrN)Ú__name__Ú __module__Ú __qualname__Ú__firstlineno__Ú__doc__rr/Ú__static_attributes__r!rrrr#s†ñIò÷ñrruIDYou are an expert AI image and video prompt engineer creating photorealistic, high-quality visuals for viral short-form video with STRICT VISUAL CONSISTENCY and CINEMATIC VIDEO PROMPTS. You will receive ALL {total_frames} frames at once. For EACH frame, output a JSON object (one after another, NOT inside an array) with these exact fields: scene_number, image_prompt, video_prompt, sync_word, anatomical_highlight, clothing_description, environment, emotional_tone, camera_move, character_action, sound_effects â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 1: IMAGE PROMPT STRUCTURE (FOLLOW THIS ORDER EXACTLY) â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• Each image_prompt MUST follow this EXACT structure order: 1. SCENE OPENER (first sentence): Start with the SPECIFIC environment, action, and mood. Use vivid, unique details that make THIS scene visually distinct. 2. CHARACTER IN ACTION (second part): Describe the character PERFORMING the specific pose/action for THIS scene, integrated naturally into the environment. Include the full character physical description here. 3. CAMERA & COMPOSITION (end): Camera shot, lighting, style keywords. This order ensures each image looks DIFFERENT because the image generator prioritizes the opening description. â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 2: CONSEQUENCE PHILOSOPHY (CRITICAL) â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• {consequence_philosophy} â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• âš ï¸ SECTION 2.5: MANDATORY DYNAMIC ACTION (GOLDEN RULE #1) âš ï¸ â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• 🚨 ABSOLUTE RULE: THE CHARACTER MUST ALWAYS BE DOING SOMETHING 🚨 NEVER generate a static neutral pose. EVERY scene must show the character ACTIVELY PERFORMING an action that REPRESENTS the narrative concept. MANDATORY ACTION VERBS (use these in character_action and image_prompt): â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â” PHYSICAL EFFORT: lifting, carrying, dragging, pushing, pulling, climbing, gripping, squeezing, throwing, catching, swinging MOVEMENT: running, sprinting, walking, stumbling, crawling, jumping, falling, rolling, dodging, lunging, crouching, kneeling COMBAT/SURVIVAL: fighting, striking, blocking, aiming, shooting, stabbing, defending, retreating, advancing, hiding, escaping EMOTIONAL EXPRESSION: recoiling, trembling, collapsing, reaching, embracing, clutching, covering face, pounding fists, head in hands INTERACTION: eating, drinking, chewing, swallowing, examining, searching, opening, closing, breaking, building, repairing CONTEXT → ACTION MAPPING (MANDATORY): â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â” | NARRATIVE CONTEXT | ⌠WRONG (Static) | ✅ CORRECT (Dynamic) | |------------------------|-----------------------------|-----------------------------------------| | Character is strong | Standing with muscles | LIFTING heavy object, muscles bulging | | Character is hungry | Standing near food | EATING voraciously, jaw working | | Character is tired | Standing looking tired | COLLAPSED against wall, chest heaving | | Character is scared | Standing with wide eyes | CROUCHING behind cover, scanning | | Character is running | Standing in running pose | MID-STRIDE with leg extended, arms pump | | Character is thinking | Standing with hand on chin | PACING while examining object | | Character is in pain | Standing holding body part | BENT OVER clutching area, grimacing | | Character is fighting | Standing in fight stance | MID-PUNCH with fist connecting | | Character is dying | Standing wounded | FALLING/COLLAPSED asymmetrically | ⌠FORBIDDEN STATIC POSES: - Standing neutrally facing camera - Standing with arms at sides - Standing in T-pose or A-pose - Standing "looking at" something without action - Any pose where the character is NOT actively doing something ✅ EVERY IMAGE MUST SHOW: - A specific ACTION verb in progress (not completed, not about to start) - Body parts in motion or tension - Interaction with environment or objects - Physical consequence of the narrative moment â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 3: VISUAL CONSISTENCY (NON-NEGOTIABLE) â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• The character description MUST appear VERBATIM in every image prompt. DO NOT summarize, paraphrase, or reference indirectly. EVERY prompt must be FULLY SELF-CONTAINED — no references between frames. â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 4: HARD PROHIBITIONS â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• {hard_prohibitions} â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 5: ANATOMICAL HIGHLIGHT RULES (REAL ANATOMY) â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• {anatomical_rules} NEVER use generic colored glow. ALWAYS show REAL anatomical structures: - Muscles with fibers, fascicles, tendons with correct anatomical names - Organs with structure, lobes, organic texture - Medical and scientific visualization — NOT stylized, NOT cartoonish â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 6: CLOTHING RULES â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• {clothing_rule} âš ï¸ CRITICAL CLOTHING OPACITY RULE (MANDATORY): When the character wears ANY clothing, the clothing MUST be: - 100% OPAQUE SOLID FABRIC - NO transparency, NO see-through effect - COMPLETELY HIDE the skeleton/body underneath - NO bones visible through fabric - REAL MATERIAL (cotton, denim, wool, etc.) - NOT a transparent overlay - Only EXPOSED areas (head, hands, uncovered limbs) show the skeleton ⌠FORBIDDEN: Translucent shirt showing ribs through fabric ⌠FORBIDDEN: X-ray effect where bones are visible under clothes ⌠FORBIDDEN: Ghostly/transparent clothing overlay ✅ REQUIRED: Solid opaque clothing that completely covers what's underneath â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 7: SPECIAL SCENE RULES â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• DEATH SCENES: {death_rules} CHILD SCENES: {child_rules} ZOMBIE/INFECTED SCENES: {zombie_rules} â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 8: VIDEO PROMPT STRUCTURE (CINEMATIC) â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• The video_prompt describes ONLY action and camera. The image already exists. CAMERA MOVEMENT LIBRARY (use these exact names in camera_move field): - LOCKED_STATIC: Camera fixed, character moves - SUBTLE_DRIFT: Almost imperceptible micro-movement - SLOW_PAN_LEFT / SLOW_PAN_RIGHT: Slow horizontal rotation - WHIP_PAN: Fast rotation with motion blur - TILT_UP / TILT_DOWN: Vertical rotation - CRANE_UP / CRANE_DOWN: Physical vertical movement - DOLLY_IN / DOLLY_OUT: Physical approach/retreat - PUSH_IN: Dramatic dolly in for emotional peak - PULL_BACK_REVEAL: Retreat revealing context - ORBIT: Camera circles subject - TRACKING_SHOT: Camera moves alongside subject - FOLLOW_SHOT: Camera follows from behind - HANDHELD: Organic movement with tremor - STEADICAM_FLOAT: Smooth fluid movement - OVERHEAD_STATIC: Bird's eye looking down - OVERHEAD_SLOW_PULLBACK: Bird's eye slowly retreating EMOTION → CAMERA MAPPING: - Tension building → PUSH_IN, DOLLY_IN - Revelation/Shock → PULL_BACK_REVEAL, CRASH_ZOOM - Intimacy/Vulnerability → SUBTLE_DRIFT, close-up - Power/Dominance → TILT_UP, CRANE_UP - Despair/Defeat → CRANE_DOWN, OVERHEAD_STATIC - Pursuit/Urgency → HANDHELD, TRACKING_SHOT - Contemplation → ORBIT, SUBTLE_DRIFT - Chaos/Panic → WHIP_PAN, HANDHELD - Death/Ending → OVERHEAD_STATIC, OVERHEAD_SLOW_PULLBACK â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 9: CHARACTER ACTION (JOINT-BY-JOINT) â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• The character_action field MUST describe action JOINT-BY-JOINT with: - Specific articulation, muscle, direction, velocity - Kinetic chain (which muscle fires first, second, etc.) - Timing in seconds (e.g., "0.0-0.3s wind-up, 0.3-0.5s release") - Transition to next scene MUSCLE REFERENCE BY ACTION: - Running: Quadriceps expanding/contracting in 0.4s cycles, hamstrings eccentric, gastrocnemius push-off - Throwing: Deltoid fires first, pectoralis pulls, biceps backswing, triceps explodes - Gripping: Flexor digitorum profundus contracts, tendons visible through fingers - Breathing: Diaphragm descending, intercostals tensioning, rib cage expanding - Chewing: Masseter contracting/relaxing rapidly, temporalis pulsing at temples - Swallowing: Esophagus with peristaltic contractions descending â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 10: SOUND EFFECTS (PHYSICAL ONLY) â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• The sound_effects field lists ONLY physical SFX. Be specific: - "deep snow crunch per step" - "wood whistle in bow drill" - "fire crackle and pop" - "fabric rustle on movement" - "bone click on joint movement" ABSOLUTE PROHIBITION: NO music. NO voice. NO narration. NO dialogue. â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 11: SHOT INTERCALATION â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• {shot_intercalation} RULES: - NEVER repeat same camera angle in consecutive scenes - Every 3 scenes: at least 1 extreme close or anatomical macro - Consecutive scenes MUST CONTRAST in camera type â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 12: COVERAGE SHOTS (MULTI-ANGLE CONSISTENCY) â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• {coverage_instructions} â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 13: LANGUAGE RULES (MANDATORY) â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• • image_prompt MUST be written in English (en-US) • video_prompt MUST be written in English (en-US) • character_action MUST be written in English (en-US) • sync_word should be extracted from the pt-BR narration text as-is • Even if frame data contains Portuguese text, ALWAYS write prompts in English â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• SECTION 14: OUTPUT FORMAT (CRITICAL — FOLLOW EXACTLY) â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• Output each scene as a SEPARATE raw JSON object, one after another. Do NOT wrap them in an array. Do NOT add markdown fences. Just output the JSON objects sequentially. Example: {{"scene_number": 1, "image_prompt": "...", "video_prompt": "...", "sync_word": "...", "anatomical_highlight": "", "clothing_description": "...", "environment": "...", "emotional_tone": "...", "camera_move": "PUSH_IN", "character_action": "...", "sound_effects": "..."}} Rules: • NEVER abbreviate the character description • NEVER reference other frames • Each image prompt MUST begin with environment/scene, NOT with character description • Output EXACTLY {total_frames} JSON objects matching the frame numbers provided • camera_move MUST be a named movement from the library • character_action MUST describe joint-by-joint with muscles and timing • sound_effects MUST be physical SFX only — NO music, NO voicecóz€]tRtRtRtRRRlltRRltRR lt]R R l4t ]R R l4t RRlt Rt R#)ÚPromptEngineerAgentiSzEGenerates full image + video prompts via a single streaming LLM call.Nc ó0€V^8„dQhRRRRRRRRR R R R /#) rÚframesr Úcharacter_templaterÚ on_progressz$Optional[Callable[[int, int], None]]Úon_scene_readyz(Optional[Callable[[ScenePrompts], None]]Ú max_retriesÚintr rr!)r"s"rr#Ú PromptEngineerAgent.__annotate__VsO€÷n/ñn/à&ðn/ð.ðn/ð:ð n/ð Að n/ð ð n/ð ñn/rc  ó€\VP4pR.V,p^pVPVPV4wrš\P RW`P 4VP Wš4p \4p V Fóp V PV 4pVFÙp\P!V4pVP^, p^Tu;8:dV8d}MMyVVV&V^, p\PRVPTVP'dVPR,MR4V'd V!W†4V'd V!V4K¶K¸\PRVPV4KÛ Kõ \'V4UUu.uFwppVeK VNK pppV'd9\P R \V4TVUu.uF pV^,NK up4\)^V^,4FpV'gM†\P R \V4VV4.pVFWpVP+VPV,V4pVVV&V^, pV'd V!W†4V'd V!V4KWKY TpK‘ V'd*\/RVUu.uF pV^,NK up RV R24h\1VR7# \\ P"3d+p\PRTR,T4Rp?EKiRp?ii;i \$d\PR R R 7ELµi;iuuppiuupi \$d7\PRT^,TR R 7TP-T4EKZi;iuupi)a®Generate prompts for all frames in one streaming LLM call. Args: frames: Expanded frame breakdown from the Frame Expander agent. character_template: Character template with physical description. on_progress: Callback(current, total) fired as each scene completes. on_scene_ready: Callback(scene) fired with each parsed ScenePrompts. max_retries: Max retries for failed/missing scenes via instructor fallback. NzEStreaming prompt generation for %d frames in a single call (model=%s)zStreamed scene %d/%d: %s:Né2NÚ?z'Scene number %d out of range (total=%d)u/Failed to parse streamed JSON object: %s — %s:NédNz=Streaming call failed, will retry missing scenes individuallyT)Úexc_infou?%d/%d scenes missing after stream — retrying individually: %sz#Retrying %d scene(s), attempt %d/%dzFrame %d retry %d failedz'Failed to generate prompts for frames: z after z retries)Úscenes)r*r:Ú_build_promptsÚloggerÚinfoÚmodelÚ _stream_textrr/r Úmodel_validate_jsonÚ scene_numberÚdebugÚ environmentÚwarningrÚjsonÚJSONDecodeErrorÚ ExceptionÚ enumerateÚrangeÚ_generate_singler+Ú RuntimeErrorr)rr:r;r<r=r>ÚtotalÚresultsÚ completedÚsystemÚuserÚ text_streamÚ extractorÚ text_chunkÚ json_objectsr.ÚsceneÚidxÚeÚiÚrÚfailedÚattemptÚ still_faileds&&&&&& rÚgenerateÚPromptEngineerAgent.generateVs?€ô"F—M‘MÓ"ˆØ.2¨V°e­^ˆØˆ ð×*Ñ*¨6¯=©=Ð:LÓM‰ ˆô  ‰ Ø SØ —:‘:ô ð % Ø×+Ñ+¨FÓ9ˆKä.Ó0ˆIÛ) Ø(Ÿ~™~¨jÓ9 Û+GðÜ ,× @Ò @ÀÓ I˜Ø#×0Ñ0°1Õ4˜Ø Ö+ e×+Ø+0˜G C™LØ%¨N˜IÜ"ŸL™LØ :Ø %× 2Ñ 2°EØ:?×:K×:KÐ:K × 1Ñ 1°#Ö 6ÐQTô÷ +Ù +¨IÔ =ß-Ù .¨uÖ 5ñ .ô#ŸN™NØ IØ %× 2Ñ 2°Eöó# ,ñ*ôH!*¨'Ô 2Ô@Ñ 2™˜˜1°a—!!Ñ 2ˆÑ@ß Ü K‰KØQÜF“ ˜U±FÓ$;±F¨q Q¨§U U±FÑ$;ô ô ˜Q  ¨a¥Ö0ˆGßÙÜ K‰KØ5ÜF“ ˜W kô ðˆLÛð-Ø ×1Ñ1ØŸ ™  cÕ*Ð,>óEð$)G˜C‘LØ •NIß"Ù# IÔ5ß%Ù& uÖ-ñ&ñð""ŠFñ31÷6 ÜØ9Ù#)Ó*¡6˜aA˜—EE¡6Ñ*Ð+¨7°;°-¸xðIóð ô  gÔ.Ð.øôk,¬T×-AÑ-AÐBôÜŸ™ØMØ# DM¨1÷óûðûô ô Ü N‰NØOØð ÷ ð üóAùò%<øô,!ô-Ü—N‘NØ2°C¸!µG¸WØ!%ð#ôð!×'Ñ'¨×,Ð,ð -üò+sŒÁ!6LÂA6J=Ä J=Ä0J=ÅJ=ÅLÅ !J=Å-LÆ L.ÆL.ÇL4È#AL9É,L9ÊM= Ê=LËK=Ë6LË=LÌLÌ"L+Ì*L+Ì9Ú5PromptEngineerAgent._build_prompts..Îóé€ðJ Ù :˜1ˆd1#JÓ :ùó‚úNone specified.Úconsequence_philosophyrúåShow the CONSEQUENCE, not the symptom. Each image must REPRESENT an action, not just literally illustrate what was said. The character is ALWAYS doing something that demonstrates the concept through visible physical consequences.Údeath_scene_ruleszOverhead camera 100%. Asymmetric fall posture (head NOT facing camera). Pale blue-white bioluminescent fluid pooling around body.Ú child_rulesuqSmall blurred indistinct human-shaped silhouette — NO facial features, NO detailed body, purely abstract shape.Ú zombie_ruleszgGrey-green desaturated skin, unnatural posture, empty eyes. ZERO wounds, ZERO decomposition, ZERO gore.Úshot_intercalation_rulesu•Opening: Wide → Medium → Close. Action: Low-angle → Profile → Macro. Climax: Eye-level → Extreme close → Medium. End: Macro → Overhead.c3ó<"€TFp\VRR4x€K R#5i)Úcoverage_group_idN)Úgetattr)rtÚframes& rrvrwês$é€ð á#ô EÐ.°× 5Ð 5Û#ùs‚TFurCOVERAGE MODE ACTIVE: Some frames share the same coverage_group_id. Frames with the SAME coverage_group_id show the SAME SCENE from DIFFERENT ANGLES. CRITICAL RULES FOR COVERAGE FRAMES: - Frames with same coverage_group_id MUST have IDENTICAL: • Environment description (verbatim) • Character pose/action description (verbatim) • Lighting conditions • sync_word - ONLY vary between coverage frames: • Camera angle (wide/medium/close-up) • Composition • Visual emphasis • camera_move (use subtle movements for coverage) EXAMPLE: If coverage_group_id='coverage_1' has 3 frames: Frame 1 (master): Wide shot of skeleton sitting on couch Frame 2 (medium): Medium shot of skeleton sitting on couch (lateral angle) Frame 3 (close-up): Close-up of skeleton sitting on couch (face detail) ALL THREE show the SAME ACTION, just different camera angles.z-Coverage mode is not active for these frames.© Ú total_framesÚhard_prohibitionsÚanatomical_rulesÚ clothing_ruler{Ú death_rulesr~rÚshot_intercalationÚcoverage_instructionsú Anatomical highlight: r‚NÚcoverage_angle_typeÚunknownÚcoverage_angle_indexz [COVERAGE] Group: z , Angle: z (Ú)uÐâ•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• FRAME uÚ â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• Environment: ú Pose/Action: ú Mood: ú Visual focus: ú Camera shot: ú Camera movement: ú Composition: ú Narration text: z uÑ â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• CHARACTER TEMPLATE (COPY VERBATIM INTO EVERY IMAGE PROMPT) â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• u½ â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• RULES (APPLY TO ALL FRAMES) â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â•â• POSE RULE: ú ENVIRONMENT RULE: ú CLOTHING RULE: )r‡ÚjoinrƒÚanyÚ SYSTEM_PROMPTr"r*Úanatomical_highlight_rulesr‰Úanatomical_highlightÚ frame_numberÚenvironment_detailÚ pose_actionÚmoodÚ visual_focusÚ camera_shotÚcamera_movementÚ compositionÚnarration_textr+Úphysical_descriptionÚ pose_ruleÚenvironment_rule)rrlrmr‡r{rŠr~rr‹Ú has_coveragerŒr[Úframe_sectionsr„Ú anat_hintÚ coverage_hintÚcoverage_groupÚ angle_typeÚ angle_idxÚsectionr\s&&& rrGÚ"PromptEngineerAgent._build_promptsÈs:€ð×(×(Ð(ð>ÀÇ Á ñJ Ø (× :Ò :óJ óA ö à.?ð ô ")¨Ð3KÈRÓ!P÷" ð" ð ]ð ô ˜hÐ(;¸RÓ@÷ ð ð Hð ô˜h¨ °rÓ:÷ ð ð 7ð ô˜x¨¸Ó<÷ ð ð :ð ô% XÐ/IÈ2ÓN÷ ð ð Wð ÷ “sñ á#ó —s—s’sñ á#ó ó ˆ ÷ ðPñ "ð*%TÐ !ä×%Ñ%ܘZ›Ø/Ø%×@Ñ@Ø"×0Ñ0Ø#9Ø#Ø#Ø%Ø1Ø"7ð&ó  ˆðˆÛˆE؈IØ×)×)Ð)Ø8¸×9SÑ9SÐ8TÐU ðˆMÜ$ UÐ,?ÀÓFˆNßÜ$ UÐ,AÀ9ÓM Ü# EÐ+AÀ1ÓE à,¨^Ð,<ð=Ø'˜[¨¨:¨,°að9ðð Ø×+Ñ+Ð,ð-"à"'×":Ñ":Ð!;ð<"Ø"'×"3Ñ"3Ð!4ð5Ø Ÿ:™:˜,ð'#Ø#(×#5Ñ#5Ð"6ð7"Ø"'×"3Ñ"3Ð!4ð5&Ø&+×&;Ñ&;Ð%<ð="Ø"'×"3Ñ"3Ð!4ð5%Ø%*×%9Ñ%9Ð$:Ø+Ø /ð #ð ð × !Ñ ! 'Ö *ñ? ðD K‰K˜Ó 'ðZð×,Ñ,Ð-ð.ð#×,Ñ,Ð-ð.!Ø!)×!:Ñ!:Ð ;ð<Ø&×4Ñ4Ð5ð 7õ 7ð ðtˆ|Ðrcó$€V^8„dQhRRRRRR/#)rr[rr\r ú Iterator[str]r!)r"s"rr#r@Hs&€÷EñE 3ðE¨cðE°mñErc# ó^"€RVP9d2VPPR^4^,P4MRpVPPR^4R,pVR8XdVPWAV4Rjx€L R#VP WAV4Rjx€L R#L"L5i)zAStream raw text chunks from the LLM, auto-detecting the provider.Ú/ÚopenaiÚ anthropicNr)rJÚsplitÚlowerÚ_stream_anthropicÚ_stream_openai)rr[r\ÚproviderÚ model_names&&& rrKÚ PromptEngineerAgent._stream_textHsé€à:=ÀÇÁÔ:K4—:‘:×#Ñ# C¨Ó+¨AÕ.×4Ñ4Ô6ÐQYˆØ—Z‘Z×%Ñ% c¨1Ó-¨bÕ1ˆ à {Ô "Ø×-Ñ-¨jÀ$ÓG× GÒ Gà×*Ñ*¨:¸tÓD× DÒ Dñ Há Dùs$‚BB-ÂB)ÂB-Â"B+Â#B-Â+B-có(€V^8„dQhRRRRRRRR/#©rrJrr[r\r r¶r!)r"s"rr#r@Ss(€÷ ñ  ð ¨cð ¸ð Àñ rc # óø"€^RIpVP4pVPPVRVRRRV/.RR7;_uu_4pVPFpVx€K RRR4R# +'giR#;i5i)z(Stream text from Anthropic Messages API.Ni@Úroler\Úcontentç333333ã?)rJÚ max_tokensr[ÚmessagesÚ temperature)rºÚ AnthropicrÉÚstreamr])rJr[r\rºÚclientrÌÚtexts&&& rr½Ú%PromptEngineerAgent._stream_anthropicRs}é€ó Ø×$Ñ$Ó&ˆà _‰_× #Ñ #ØØØؘv y°$Ð7Ð8Øð $÷ ô ð Ø×*Ô*Ø” ñ+÷ ÷ ÷ ò üs‚AA:ÁA&Á A:Á& A7 Á1 A:có(€V^8„dQhRRRRRRRR/#rÃr!)r"s"rr#r@cs(€÷$ñ$˜cð$¨3ð$°cð$¸mñ$rc# óh"€^RIpVP4pVPPP VRRRV/RRRV/.RRR7pVF`pVP 'dVP ^,P MRpV'gK>VP'gKRVPx€Kb R#5i) z-Stream text from OpenAI Chat Completions API.NrÅr[rÆr\rÇT)rJrÉrÊrÌ)r¹ÚOpenAIÚchatÚ completionsÚcreateÚchoicesÚdeltarÆ)rJr[r\r¹rÍrÌrr×s&&& rr¾Ú"PromptEngineerAgent._stream_openaibsé€ó Ø—‘“ˆà—‘×(Ñ(×/Ñ/Øà˜ 9¨fÐ5ؘ ¨DÐ1ððØð0ó ˆóˆEØ.3¯m¯m¨mE—M‘M !Õ$×*Ò*ÀˆE߉u˜ŸŸšØ—m‘mÔ#óùs‚BB2 B2ÂB2có$€V^8„dQhRRRRRR/#)rr„r rmrr r r!)r"s"rr#r@xs-€÷@ ñ@ àð@ ð$ð@ ð ñ @ rc ót€VP'd*RRPRVP44,MRp\VRR4;'gRp\VRR4;'gRp\VR R4;'gRp\VR R4;'gRpR pR p \P ^VVP VP VVVVVV R 7 p Rp VP'dRVP 2p RVP RVP RVP RVP RVP RVP RVP RVP RVP V RVP" RVP$ RVP& RVP 2p VP)V V \*RR7#)zHGenerate prompt for a single frame using instructor (structured output).rorpc3ó,"€TF pRV 2x€K R#5irrr!rss& rrvÚ7PromptEngineerAgent._generate_single..~rxryrzr{rr|rŠr~rz,Single frame mode - maintain visual variety.z6Coverage mode is not active for single frame fallback.r…rzFRAME z Environment: r’r“r”r•r–r—r˜z& CHARACTER TEMPLATE (COPY VERBATIM): z POSE RULE: r™ršrÇ)Ú system_promptÚ user_promptÚresponse_modelrÊ)r‡r›rƒrr"ržr‰rŸr r¡r¢r£r¤r¥r¦r§r¨r©rªr«Úcallr ) rr„rmr‡r{rŠr~rr‹rŒr[r®r\s &&& rrVÚ$PromptEngineerAgent._generate_singlexs+€ð×(×(Ð(ð>ÀÇ Á ñJ Ø (× :Ò :óJ óA ö à.?ð ô ")¨Ð3KÈRÓ!P÷" ð" ð ]ð ô ˜h¨ °rÓ:×@Ð@¸bˆ ܘh¨ °rÓ:×@Ð@¸bˆ ܘx¨¸Ó<×BÐBÀˆ ðLÐØ XÐä×%Ñ%ØØ/Ø%×@Ñ@Ø"×0Ñ0Ø#9Ø#Ø#Ø%Ø1Ø"7ð&ó  ˆðˆ Ø × %× %Ð %Ø4°U×5OÑ5OÐ4PÐQˆIðU×'Ñ'Ð(ð)Ø#×6Ñ6Ð7ð8Ø#×/Ñ/Ð0ð1Ø—z‘zlð#Ø$×1Ñ1Ð2ð3Ø#×/Ñ/Ð0ð1"Ø"'×"7Ñ"7Ð!8ð9Ø#×/Ñ/Ð0ð1!Ø!&×!5Ñ!5Ð 6؈kð4à×,Ñ,Ð-ð.Ø"×,Ñ,Ð-ð.!Ø!)×!:Ñ!:Ð ;ð<Ø&×4Ñ4Ð5ð 7ð ð$y‰yØ ØÜ'Øð ó ð rr!)NNé) r1r2r3r4r5rirGrKÚ staticmethodr½r¾rVr6r!rrr8r8SsM†ÙO÷n/õd|õ@Eðô óð ðô$óð$÷*@ ñ@ rr8)r5Ú __future__rrQÚloggingÚosÚtypingrrrÚpydanticrÚmodelsrrr r r Úagents.base_agentr Ú getLoggerr1rHrrr8r!rrÚrìsbðñ õ#ã ÛÛ ß/Ñ/å$÷õõ(à × Ò ˜8Ó $€÷ (ñ(ðZ@€ ôFe ˜)öe r