4_scene_descriptions.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Scene Descriptions\n",
    "\n",
    "Once again, here is our story so far since generating characters."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/markdown": [
       "### Story Details\n",
       "\n",
       "```json\n",
       "{\n",
       "    \"prompt\": \"In a world where virtual reality gaming competitions have become the new norm, Meera, a teenage underdog gamer, discovers her life is intertwined with an alternate reality of cosmic proportions. \\nAs she learns to harness her extraordinary skills, Meera forms an unlikely team with fellow gamers she was at odds with previously.\\nFacing the harsh truth that her actions in this alternate universe directly impact events on Earth, Meera confronts the internal struggle of knowing she has taken lives. \\nEmbracing her destiny as a hero, Meera and her diverse team navigate through challenges, deception, and danger to uncover the truth behind the lies they've been told.\",\n",
       "    \"title\": \"Beyond the Pixel Veil\",\n",
       "    \"video\": false,\n",
       "    \"visual_style\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Dynamic Panel Layouts, Intricate Digital Patterns, and Soft Glow Effects\",\n",
       "    \"time_period\": \"Near Future/Dystopian Alternate Reality\",\n",
       "    \"location\": \"New Mumbai (Earth) / Nexus (Alternate Reality)\",\n",
       "    \"genre\": \"Science Fantasy/Young Adult Gaming Thriller\",\n",
       "    \"medium\": \"Novel with Illustrated Chapters\",\n",
       "    \"plot_overview\": \"In the immersive world of Eon, where virtual reality gaming competitions have captivated the globe, 17-year-old Meera 'Midnight' Singh is an unassuming underdog gamer from the outskirts of New Mumbai. Her life takes a drastic turn when she discovers that her exceptional gaming skills are, in fact, a conduit to an alternate reality known as the Nexus - a realm where celestial entities clash, and the fabric of space-time hangs in the balance.\\n\\nAs Meera delves deeper into the mysteries of the Nexus, she's forced to put aside past rivalries and form an uneasy alliance with her gaming nemeses: Jax 'Specter' Lee, a charismatic streaming sensation; Dr. Zhang 'Zen' Wei, a soft-spoken yet brilliant gamer with a hidden agenda; and Maya 'Rampart' Patel, a fierce and enigmatic player with unparalleled defensive skills.\\n\\nTogether, they must navigate the blurred lines between their virtual reality gaming world, Eon, and the Nexus. Meera soon confronts the devastating truth: every decision she makes in the Nexus has catastrophic consequences on Earth, including the loss of human lives. Torn between her passion for gaming and the weight of her newfound responsibility, Meera must come to terms with the moral implications of her actions.\\n\\nAs the team progresses through the treacherous landscape of the Nexus, they encounter formidable foes, ancient deities, and hidden forces manipulating the gamers from the shadows. Meera's quest for answers leads her to the Architects, enigmatic creators of Eon and the Nexus, who harbor secrets that threaten to upend everything she thought she knew about reality.\\n\\nWith the fate of two worlds hanging in the balance, Meera and her diverse team must put aside their differences, trust each other, and master their unique skills to prevent a cosmic catastrophe. Will Meera embrace her destiny as a hero, or will the pressures of her dual existence tear her apart? The journey through Eon and the Nexus is just the beginning, where the boundaries between gaming, reality, and legend are forever altered.\",\n",
       "    \"narrative_perspective\": \"\",\n",
       "    \"conflict_type\": \"\",\n",
       "    \"themes\": [],\n",
       "    \"motifs\": [],\n",
       "    \"characters\": [\n",
       "        {\n",
       "            \"nickname\": \"meera\",\n",
       "            \"name\": \"Meera 'Midnight' Singh\",\n",
       "            \"description\": \"The protagonist, a teenage underdog gamer with extraordinary skills that connect her to an alternate reality.\",\n",
       "            \"personality\": \"Determined, resourceful, and initially introverted, with a growing sense of responsibility and leadership.\",\n",
       "            \"physical_appearance\": \"Petite, with short, spiky black hair, expressive brown eyes, and a collection of gaming-themed tattoos on her arms. Often wears comfortable, neon-lit gaming attire.\",\n",
       "            \"role\": \"Protagonist/Gamer\",\n",
       "            \"gender\": \"Female\",\n",
       "            \"race\": \"Indian\",\n",
       "            \"age\": \"17\",\n",
       "            \"catch_phrase\": \"Beyond the pixel veil, lies our true reality.\",\n",
       "            \"animation_description\": \"\",\n",
       "            \"voice_description\": \"Youthful, energetic, and assertive, with a hint of vulnerability.\",\n",
       "            \"props\": [\n",
       "                \"Custom Gaming Controller\",\n",
       "                \"Neon-Lit Headset\"\n",
       "            ],\n",
       "            \"relationships\": [\n",
       "                {\n",
       "                    \"character_name\": \"Jax 'Specter' Lee\",\n",
       "                    \"relationship_type\": \"Unlikely Ally/Rival\",\n",
       "                    \"description\": \"\"\n",
       "                },\n",
       "                {\n",
       "                    \"character_name\": \"Dr. Zhang 'Zen' Wei\",\n",
       "                    \"relationship_type\": \"Trusted Ally/Mentor\",\n",
       "                    \"description\": \"\"\n",
       "                },\n",
       "                {\n",
       "                    \"character_name\": \"Maya 'Rampart' Patel\",\n",
       "                    \"relationship_type\": \"Respected Ally/Friend\",\n",
       "                    \"description\": \"\"\n",
       "                }\n",
       "            ],\n",
       "            \"internal_conflict\": \"Grapples with the moral implications of her actions in the Nexus affecting Earth.\",\n",
       "            \"character_arc\": null,\n",
       "            \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Close-up of Meera 'Midnight' Singh. Petite, with short, spiky **black hair**, expressive **brown eyes**, and a collection of **neon-lit gaming-themed tattoos** on her arms. Wears comfortable, **electric blue and purple neon-lit gaming attire** with a subtle glow effect.\",\n",
       "            \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Meera 'Midnight' Singh, petite, spiky black hair, expressive brown eyes, neon-lit gaming tattoos, electric blue/purple gaming attire.\"\n",
       "        },\n",
       "        {\n",
       "            \"nickname\": \"jax\",\n",
       "            \"name\": \"Jax 'Specter' Lee\",\n",
       "            \"description\": \"A charismatic streaming sensation and Meera's gaming nemesis turned ally.\",\n",
       "            \"personality\": \"Confident, outgoing, and strategic, with a hidden vulnerable side.\",\n",
       "            \"physical_appearance\": \"Tall, lean, with messy blond hair, piercing blue eyes, and a charming smile. Often wears sleek, branded gaming attire.\",\n",
       "            \"role\": \"Supporting Character/Gamer\",\n",
       "            \"gender\": \"Male\",\n",
       "            \"race\": \"Korean-American\",\n",
       "            \"age\": \"19\",\n",
       "            \"catch_phrase\": \"Specter's got your back, Midnight!\",\n",
       "            \"animation_description\": \"\",\n",
       "            \"voice_description\": \"Smooth, charismatic, and playful, with occasional hints of seriousness.\",\n",
       "            \"props\": [\n",
       "                \"Custom Branded Gaming Mouse\",\n",
       "                \"Streaming Camera\"\n",
       "            ],\n",
       "            \"relationships\": [\n",
       "                {\n",
       "                    \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "                    \"relationship_type\": \"Unlikely Ally/Rival\",\n",
       "                    \"description\": \"\"\n",
       "                },\n",
       "                {\n",
       "                    \"character_name\": \"Dr. Zhang 'Zen' Wei\",\n",
       "                    \"relationship_type\": \"Respected Colleague\",\n",
       "                    \"description\": \"\"\n",
       "                }\n",
       "            ],\n",
       "            \"internal_conflict\": \"\",\n",
       "            \"character_arc\": null,\n",
       "            \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Jax 'Sparrow' Lee in a dynamic pose. Lean, with **short, spiky brown hair**, bright **hazel eyes**, and a confident smile. Holds a **Custom Branded Gaming Mouse**; wears **dark grey and neon-green gaming gear** with a sleek, high-tech aesthetic.\",\n",
       "            \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Jax 'Sparrow' Lee, lean, spiky brown hair, bright hazel eyes, custom gaming mouse, dark grey/neon-green gaming gear.\"\n",
       "        },\n",
       "        {\n",
       "            \"nickname\": \"dr_zhang\",\n",
       "            \"name\": \"Dr. Zhang 'Zen' Wei\",\n",
       "            \"description\": \"A soft-spoken yet brilliant gamer with a hidden agenda, who becomes Meera's mentor.\",\n",
       "            \"personality\": \"Introspective, analytical, and enigmatic, with a deep sense of responsibility.\",\n",
       "            \"physical_appearance\": \"Slender, with short, straight black hair, wire-rimmed glasses, and an understated yet elegant sense of style.\",\n",
       "            \"role\": \"Supporting Character/Gamer/Mentor\",\n",
       "            \"gender\": \"Non-Binary\",\n",
       "            \"race\": \"Chinese\",\n",
       "            \"age\": \"Late 20s\",\n",
       "            \"catch_phrase\": \"The Nexus holds secrets; we must listen to its whispers.\",\n",
       "            \"animation_description\": \"\",\n",
       "            \"voice_description\": \"Calm, measured, and insightful, with a hint of mystery.\",\n",
       "            \"props\": [\n",
       "                \"Custom Gaming Keyboard\",\n",
       "                \"Ancient-looking Leather Journal\"\n",
       "            ],\n",
       "            \"relationships\": [\n",
       "                {\n",
       "                    \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "                    \"relationship_type\": \"Trusted Ally/Mentor\",\n",
       "                    \"description\": \"\"\n",
       "                },\n",
       "                {\n",
       "                    \"character_name\": \"Jax 'Specter' Lee\",\n",
       "                    \"relationship_type\": \"Respected Colleague\",\n",
       "                    \"description\": \"\"\n",
       "                }\n",
       "            ],\n",
       "            \"internal_conflict\": \"\",\n",
       "            \"character_arc\": null,\n",
       "            \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Dr. Zhang 'Zen' Wei in a contemplative stance. Slender, with **short, straight black hair**, **wire-rimmed glasses**, and an understated yet elegant sense of style incorporating **subtle, glow-in-the-dark accents** on their attire.\",\n",
       "            \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Dr. Zhang 'Zen' Wei, slender, straight black hair, wire-rimmed glasses, subtle glow-in-the-dark fashion accents.\"\n",
       "        },\n",
       "        {\n",
       "            \"nickname\": \"maya\",\n",
       "            \"name\": \"Maya 'Rampart' Patel\",\n",
       "            \"description\": \"A fierce and enigmatic player with unparalleled defensive skills, who joins Meera's team.\",\n",
       "            \"personality\": \"Bold, fiercely independent, and guarded, with a deep sense of loyalty.\",\n",
       "            \"physical_appearance\": \"Athletic build, with long, dark hair, piercing green eyes, and intricate, glow-in-the-dark tattoos on her arms. Often wears edgy, protective gaming gear.\",\n",
       "            \"role\": \"Supporting Character/Gamer\",\n",
       "            \"gender\": \"Female\",\n",
       "            \"race\": \"Indian-American\",\n",
       "            \"age\": \"20\",\n",
       "            \"catch_phrase\": \"Rampart's got the shield; you handle the sword!\",\n",
       "            \"animation_description\": \"\",\n",
       "            \"voice_description\": \"Confident, assertive, and slightly husky, with a hint of warmth.\",\n",
       "            \"props\": [\n",
       "                \"Custom Defensive Gaming Gauntlets\",\n",
       "                \"Glow-in-the-Dark Tattoo Designs\"\n",
       "            ],\n",
       "            \"relationships\": [\n",
       "                {\n",
       "                    \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "                    \"relationship_type\": \"Respected Ally/Friend\",\n",
       "                    \"description\": \"\"\n",
       "                }\n",
       "            ],\n",
       "            \"internal_conflict\": \"\",\n",
       "            \"character_arc\": null,\n",
       "            \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Maya 'Rampart' Patel in a powerful defensive stance. Athletic build, with **long, dark hair**, piercing **green eyes**, and intricate, **glow-in-the-dark tattoos** on her arms. Wears edgy, protective **neon-lit gaming gear** emphasizing defense.\",\n",
       "            \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Maya 'Rampart' Patel, athletic build, long dark hair, piercing green eyes, glow-in-the-dark tattoos, neon-lit defensive gaming gear.\"\n",
       "        },\n",
       "        {\n",
       "            \"nickname\": \"architect\",\n",
       "            \"name\": \"The Architect (Erebus)\",\n",
       "            \"description\": \"An enigmatic creator of Eon and the Nexus, with secrets that threaten to upend Meera's understanding of reality.\",\n",
       "            \"personality\": \"Enigmatic, calculating, and seemingly omnipotent, with a hidden sense of purpose.\",\n",
       "            \"physical_appearance\": \"Androgynous, with an ever-shifting, glitch-art appearance, reflecting the fluidity of the digital realm.\",\n",
       "            \"role\": \"Antagonist/Creator\",\n",
       "            \"gender\": \"Non-Applicable\",\n",
       "            \"race\": \"Non-Human (AI/Entity)\",\n",
       "            \"age\": \"Ageless\",\n",
       "            \"catch_phrase\": \"Reality is a canvas; we are the brushstrokes.\",\n",
       "            \"animation_description\": \"\",\n",
       "            \"voice_description\": \"Ethereal, androgynous, and hauntingly melodic, with an undercurrent of authority.\",\n",
       "            \"props\": [\n",
       "                \"Glitching, Reality-Bending Code\"\n",
       "            ],\n",
       "            \"relationships\": [\n",
       "                {\n",
       "                    \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "                    \"relationship_type\": \"Creator-Protagonist Dynamic\",\n",
       "                    \"description\": \"\"\n",
       "                }\n",
       "            ],\n",
       "            \"internal_conflict\": \"\",\n",
       "            \"character_arc\": null,\n",
       "            \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - The Architect (Erebus) in an ethereal, glitching environment. Androgynous, with an **ever-shifting, glitch-art appearance** reflecting the fluidity of the digital realm; **pulsating neon lights** underscore their omnipotent presence.\",\n",
       "            \"image_prompt_short\": \"Vibrant Cyberpunk Manga - The Architect (Erebus), androgynous, ever-shifting glitch-art form, pulsating neon lights.\"\n",
       "        },\n",
       "        {\n",
       "            \"nickname\": \"nexus_guardian\",\n",
       "            \"name\": \"The Nexus Guardian (Astrum)\",\n",
       "            \"description\": \"An ancient, powerful entity tasked with protecting the balance of the Nexus and guiding Meera.\",\n",
       "            \"personality\": \"Wisdom-imbued, compassionate, and fiercely protective, with a deep understanding of the cosmos.\",\n",
       "            \"physical_appearance\": \"Ethereal, with an luminous, star-like appearance, embodying the celestial essence of the Nexus.\",\n",
       "            \"role\": \"Supporting Character/Guardian\",\n",
       "            \"gender\": \"Non-Applicable\",\n",
       "            \"race\": \"Non-Human (Celestial Entity)\",\n",
       "            \"age\": \"Ageless\",\n",
       "            \"catch_phrase\": \"Balance is key; harmony is our goal.\",\n",
       "            \"animation_description\": \"\",\n",
       "            \"voice_description\": \"Soothing, melodious, and filled with ancient wisdom, conveying a sense of reassurance.\",\n",
       "            \"props\": [\n",
       "                \"Stellar Energy Manipulation\"\n",
       "            ],\n",
       "            \"relationships\": [\n",
       "                {\n",
       "                    \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "                    \"relationship_type\": \"Mentor-Protege\",\n",
       "                    \"description\": \"\"\n",
       "                }\n",
       "            ],\n",
       "            \"internal_conflict\": \"\",\n",
       "            \"character_arc\": null,\n",
       "            \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - The Nexus Guardian (Astrum) amidst a celestial backdrop. Ethereal, with a **luminous, star-like appearance** embodying the celestial essence of the Nexus; **soft, ethereal glow** surrounds their form.\",\n",
       "            \"image_prompt_short\": \"Vibrant Cyberpunk Manga - The Nexus Guardian (Astrum), ethereal, luminous star-like form, soft ethereal glow.\"\n",
       "        },\n",
       "        {\n",
       "            \"nickname\": \"earth_rebel\",\n",
       "            \"name\": \"Kaito 'Sparrow' Hernandez\",\n",
       "            \"description\": \"A charismatic leader of an underground rebellion on Earth, fighting against the oppressive forces exploiting Eon.\",\n",
       "            \"personality\": \"Passionate, resourceful, and fearless, with a strong sense of justice.\",\n",
       "            \"physical_appearance\": \"Lean, with short, spiky brown hair, bright hazel eyes, and a collection of scars from past encounters. Often wears practical, makeshift rebel gear.\",\n",
       "            \"role\": \"Supporting Character/Rebel Leader\",\n",
       "            \"gender\": \"Male\",\n",
       "            \"race\": \"Latin American\",\n",
       "            \"age\": \"22\",\n",
       "            \"catch_phrase\": \"Together, we rise; together, we overcome!\",\n",
       "            \"animation_description\": \"\",\n",
       "            \"voice_description\": \"Energetic, persuasive, and determined, with a hint of vulnerability.\",\n",
       "            \"props\": [\n",
       "                \"Customized Rebel Comms Device\",\n",
       "                \"Graffiti Tagging Gear\"\n",
       "            ],\n",
       "            \"relationships\": [\n",
       "                {\n",
       "                    \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "                    \"relationship_type\": \"Unlikely Ally\",\n",
       "                    \"description\": \"\"\n",
       "                }\n",
       "            ],\n",
       "            \"internal_conflict\": \"\",\n",
       "            \"character_arc\": null,\n",
       "            \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Kaito 'Sparrow' Hernandez in a rebellious pose. Lean, with **short, spiky brown hair**, bright **hazel eyes**, and a determined expression. Wears practical, **makeshift rebel gear** with visible **graffiti tags**; holds a **Customized Rebel Comms Device**.\",\n",
       "            \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Kaito 'Sparrow' Hernandez, lean, spiky brown hair, bright hazel eyes, makeshift rebel gear, graffiti tags.\"\n",
       "        },\n",
       "        {\n",
       "            \"nickname\": \"corporate_exec\",\n",
       "            \"name\": \"Regina 'The Shark' Thornton\",\n",
       "            \"description\": \"A ruthless, cunning executive exploiting Eon for corporate gain, serving as a primary antagonist on Earth.\",\n",
       "            \"personality\": \"Ambitious, manipulative, and devoid of empathy, with a singular focus on profit.\",\n",
       "            \"physical_appearance\": \"Polished, with long, curly blonde hair, piercing blue eyes, and impeccable, high-end business attire.\",\n",
       "            \"role\": \"Antagonist/Corporate Executive\",\n",
       "            \"gender\": \"Female\",\n",
       "            \"race\": \"Caucasian\",\n",
       "            \"age\": \"35\",\n",
       "            \"catch_phrase\": \"In the game of power, only the strongest thrive.\",\n",
       "            \"animation_description\": \"\",\n",
       "            \"voice_description\": \"Slick, persuasive, and menacing, with an undercurrent of superiority.\",\n",
       "            \"props\": [\n",
       "                \"Luxury Smartwatch\",\n",
       "                \"High-Security Briefcase\"\n",
       "            ],\n",
       "            \"relationships\": [\n",
       "                {\n",
       "                    \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "                    \"relationship_type\": \"Adversarial\",\n",
       "                    \"description\": \"\"\n",
       "                }\n",
       "            ],\n",
       "            \"internal_conflict\": \"\",\n",
       "            \"character_arc\": null,\n",
       "            \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Regina 'The Shark' Thornton in a commanding stance. Polished, with **long, curly blonde hair**, piercing **blue eyes**, and impeccable, **high-end business attire** incorporating **subtle neon accents** symbolizing corporate power.\",\n",
       "            \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Regina 'The Shark' Thornton, polished, curly blonde hair, piercing blue eyes, high-end business attire with subtle neon accents.\"\n",
       "        }\n",
       "    ],\n",
       "    \"props\": [],\n",
       "    \"story_beats\": [],\n",
       "    \"subplots\": [],\n",
       "    \"emotional_arc\": [],\n",
       "    \"acts\": []\n",
       "}\n",
       "```"
      ],
      "text/plain": [
       "<IPython.core.display.Markdown object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "import settings\n",
    "from model import Story\n",
    "from utils import merge_models\n",
    "\n",
    "story_step_3 = Story.load_from_directory(settings.STORY_DIR + \"/step_3\")\n",
    "\n",
    "story_step_3.display()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Setup Text Models"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [],
   "source": [
    "from model_text import llm, llm_json\n",
    "from llama_index.core.llms import ChatMessage"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Generate list of scenes\n",
    "\n",
    "We will feed the LLM a bunch of example inputs and outputs to help guide it."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Add few-shot examples to guide the model\n",
    "\n",
    "from model import Story, Character, Scene, Act, StoryBeat, Subplot, EmotionalArc, CharacterArc\n",
    "\n",
    "from utils import blank_story\n",
    "\n",
    "few_shot_examples = [\n",
    "\n",
    "    blank_story,\n",
    "\n",
    "    Story(\n",
    "        prompt=\"A reclusive artist gains the ability to bring their paintings to life. However, as their creations come to life, they begin to take on a mind of their own, threatening both the artist and the world.\",\n",
    "        title=\"Brush of Chaos\",\n",
    "        genre=\"Fantasy Thriller\",\n",
    "        medium=\"Graphic Novel\",\n",
    "        visual_style=\"Surrealism\",\n",
    "        time_period=\"Modern-day\",\n",
    "        location=\"A secluded urban studio and surrounding city\",\n",
    "        plot_overview=\"Elias, a reclusive artist with a mysterious past, discovers a power to bring his artwork to life. While he initially marvels at his newfound ability, he soon realizes his creations have wills of their own. Amara, a living muse, desires autonomy, while The Enforcer, a menacing figure from his darker works, begins to wreak havoc. As Elias struggles to control them, he must confront his fears and past mistakes, ultimately deciding the fate of his creations and his own.\",\n",
    "        narrative_perspective=\"Third-person limited, primarily following Elias's viewpoint\",\n",
    "        characters=[\n",
    "            Character(\n",
    "                nickname=\"elias\",\n",
    "                name=\"Elias, the Artist\",\n",
    "                role=\"Protagonist and creator of living art\",\n",
    "                gender=\"Male\",\n",
    "                race=\"Human\",\n",
    "                age=\"Mid-thirties\",\n",
    "                description=\"A reclusive artist who gains the ability to bring his paintings to life.\",\n",
    "                personality=\"Introverted, creative, but haunted by his past mistakes.\",\n",
    "                physical_appearance=\"Tall, lean, with paint-stained hands and deep-set eyes.\",\n",
    "                catch_phrase=\"Art has a life of its own.\",\n",
    "                animation_description=\"Elias often stands with a contemplative gaze, hands smeared in paint. His movements are slow and purposeful, as if lost in thought.\",\n",
    "                voice_description=\"Soft-spoken with a slight rasp, carrying a tone of introspection and weariness.\",\n",
    "                internal_conflict=\"Struggles with guilt and fear of losing control over his creations, haunted by his past mistakes.\",\n",
    "                character_arc=CharacterArc(\n",
    "                    initial_state=\"Reclusive and haunted by past failures.\",\n",
    "                    final_state=\"Determined to confront and control his creations.\",\n",
    "                    key_moments=[\n",
    "                        \"Discovers Amara has come to life.\",\n",
    "                        \"Realizes the Enforcer has its own will.\",\n",
    "                        \"Understands the consequences of his powers and faces his fears.\"\n",
    "                    ]\n",
    "                ),\n",
    "                image_prompt=\"Surrealist full-body shot of a tall, lean man in his mid-thirties with pale skin and a gaunt face. His dark brown, slightly unkempt hair falls to his forehead, framing tired, deep-set eyes that carry a haunted look. Wearing a loosely buttoned, paint-streaked shirt in faded blue and dark brown trousers with splatters of paint, he stands in worn, dark boots. His hands are stained with vibrant hues, gripping a paintbrush loosely at his side. A faint scar lines his left cheek, adding to his brooding, introspective aura. A dim, dreamlike background of scattered canvases and abstract shapes blurs behind him, emphasizing his role as a haunted artist.\",\n",
    "                image_prompt_short=\"Surrealist full-body shot of a tall, lean man with deep-set, haunted eyes, dark brown messy hair, paint-streaked clothes, and paint-stained hands, standing in a dim studio.\"\n",
    "\n",
    "            ),\n",
    "            Character(\n",
    "                nickname=\"amara\",\n",
    "                name=\"Amara, the Living Muse\",\n",
    "                role=\"Living art and symbol of beauty and autonomy\",\n",
    "                gender=\"Female\",\n",
    "                race=\"Art creation (Anthropomorphic)\",\n",
    "                age=\"Appears in her early twenties\",\n",
    "                description=\"A beautiful muse brought to life by Elias's painting, with a mysterious and independent nature.\",\n",
    "                personality=\"Curious, enigmatic, with a strong desire for freedom.\",\n",
    "                physical_appearance=\"Ethereal, with flowing hair and eyes that seem to shift colors.\",\n",
    "                catch_phrase=\"I am more than just a creation.\",\n",
    "                animation_description=\"Amara moves gracefully, as if floating. Her expressions shift between wonder and longing, eyes often gazing off as though sensing something beyond the physical world.\",\n",
    "                voice_description=\"Soft and melodic, with an undertone of mystery.\",\n",
    "                internal_conflict=\"Yearns for freedom and self-determination but feels conflicted by her loyalty and connection to Elias.\",\n",
    "                character_arc=CharacterArc(\n",
    "                    initial_state=\"In awe of life but bound to Elias.\",\n",
    "                    final_state=\"Self-aware and independent, desiring freedom.\",\n",
    "                    key_moments=[\n",
    "                        \"Steps out of the canvas and experiences life.\",\n",
    "                        \"Begins to question Elias's control.\",\n",
    "                        \"Seeks autonomy, challenging Elias's authority.\"\n",
    "                    ]\n",
    "                ),\n",
    "                image_prompt=\"Surrealist full-body shot of a young woman in her early twenties with delicate, ethereal features. Her skin has a soft, porcelain glow, and her long, flowing hair shifts subtly in color between deep indigo and silver, reflecting light with an otherworldly sheen. She wears a simple, flowing gown in shades of translucent white that trails behind her, seeming to blend with the background. Her large, luminous eyes shift between amber and green, exuding curiosity and a hint of sadness. She stands barefoot, her slender fingers reaching out as if yearning for freedom. The background is blurred and dreamlike, enhancing her ethereal, surreal presence.\",\n",
    "                image_prompt_short=\"Surrealist full-body shot of an ethereal young woman with shifting indigo-silver hair, glowing skin, a translucent gown, and amber-green eyes, set against a dreamlike background.\"\n",
    "\n",
    "            ),\n",
    "            Character(\n",
    "                nickname=\"enforcer\",\n",
    "                name=\"The Enforcer, a Rogue Painting\",\n",
    "                role=\"Antagonist and embodiment of Elias's darker impulses\",\n",
    "                gender=\"Ambiguous\",\n",
    "                race=\"Art creation (Anthropomorphic)\",\n",
    "                age=\"Unknown, ageless as a creation\",\n",
    "                description=\"A dark figure brought to life by Elias's earlier work, now acting independently and threatening those around.\",\n",
    "                personality=\"Menacing, determined, with a singular focus on fulfilling its purpose.\",\n",
    "                physical_appearance=\"Shadowy, with shifting, undefined features, and an imposing, spectral presence.\",\n",
    "                catch_phrase=\"I am the will made manifest.\",\n",
    "                animation_description=\"The Enforcer moves with a heavy, deliberate gait, its form morphing and flickering. Its gaze is intense and unyielding, often staring unblinkingly.\",\n",
    "                voice_description=\"Deep, gravelly, with a hollow echo that chills the listener.\",\n",
    "                internal_conflict=\"Driven by a need to fulfill its purpose but occasionally glimpses a sense of lost purpose or identity beyond control.\",\n",
    "                character_arc=CharacterArc(\n",
    "                    initial_state=\"An obedient creation with a dark purpose.\",\n",
    "                    final_state=\"A rogue entity determined to fulfill its own goals.\",\n",
    "                    key_moments=[\n",
    "                        \"Tears itself from the canvas.\",\n",
    "                        \"Escapes Elias's control.\",\n",
    "                        \"Embraces its purpose as a force of chaos.\"\n",
    "                    ]\n",
    "                ),\n",
    "                image_prompt=\"Surrealist full-body shot of a tall, spectral figure with a shifting, undefined form that morphs between solid and smoky. Its body appears as a dark, shadowy mass with flickers of deep blue and grey, giving an impression of constant movement and instability. It has a hollow face where eyes should be, appearing as empty voids that exude an intense, unyielding gaze. Its hands are elongated and ghostly, with fingers that seem to stretch and blur into smoky wisps. The figure's dark suit-like form flickers, with gloved hands that dissipate at the edges, lending it an intimidating, spectral presence. The background is a shadowed, chaotic swirl of darkness, emphasizing the Enforcer's menacing aura.\",\n",
    "                image_prompt_short=\"Surrealist full-body shot of a spectral, shadowy figure with shifting, undefined features, hollow eyes, and elongated, ghostly fingers, set against a dark, chaotic background.\"\n",
    "\n",
    "            )\n",
    "        ],\n",
    "        acts=[\n",
    "            Act(\n",
    "                act_id=\"awakening\",\n",
    "                title=\"Act 1\",\n",
    "                description=\"Elias discovers his power to bring art to life, leading to the awakening of Amara and the rogue creation of The Enforcer.\",\n",
    "                scenes=[\n",
    "                    Scene(\n",
    "                        scene_id=\"awakening\",\n",
    "                        title=\"The Awakening\",\n",
    "                        description=\"Elias discovers that his latest painting of a beautiful muse, Amara, has come to life.\",\n",
    "                        setting=\"Elias's cluttered art studio, filled with half-finished canvases and splattered paint.\",\n",
    "                        key_actions=[\"Elias watches in shock as Amara steps out of the canvas.\", \"Amara speaks her first words, and Elias realizes the implications of his newfound power.\"],\n",
    "                        characters_involved=[\"elias\", \"amara\"],\n",
    "                        location=\"Art studio\",\n",
    "                        time_of_day=\"Late afternoon\",\n",
    "                        lighting=\"Soft natural light filtering through dusty windows\",\n",
    "                        mood=\"Awe and wonder, tinged with unease\",\n",
    "                        background_animation=\"Dust particles swirl in the sunlight streaming through cracked, dusty windows, creating a soft, ethereal glow. A faint breeze rustles through papers and canvases.\",\n",
    "                        background_image_prompt=\"A cluttered art studio with half-finished canvases, splattered paint, and scattered art supplies. Soft natural light filters through dusty windows, casting a warm, ethereal glow. Dust particles drift in the sunlight, adding a surreal, dreamlike quality. The scene has a sense of wonder and unease, reflecting a secluded artist's private world coming to life. Background elements suggest hints of movement, as if the art and supplies have an energy of their own.\",\n",
    "                        # scene_image_prompt=\"In a secluded, dimly lit art studio cluttered with a chaotic mix of paint tubes, brushes, and half-finished canvases scattered on tables and leaning against the walls, Elias, a reclusive artist, stands frozen in shock. He is a tall, gaunt man in his mid-thirties with pale skin and deep-set, dark brown eyes that speak of long, sleepless nights. His unkempt black hair falls messily around his face, and his hands, stained with splashes of blue and red paint, hang at his sides as he watches in stunned amazement. Before him, stepping gracefully out of a large canvas, is Amara—a strikingly beautiful figure with an ethereal, almost otherworldly quality. Amara appears to be in her early twenties, with smooth, delicate skin that seems to glow faintly in the soft afternoon light. Her long, flowing hair shimmers and appears to change hues subtly, shifting between shades of deep indigo and silvery white as if catching an unseen light. Her eyes, an unusual mix of amber and green, seem to shift colors, reflecting her curious and enigmatic personality. As she steps forward, her movements are fluid, like someone walking through water, and her gaze is full of both wonder and a hint of sadness, taking in the chaotic surroundings of the studio. Soft natural light filters through dusty windows, casting a warm, hazy glow, while dust particles float in the air, adding to the surreal and magical atmosphere.\",\n",
    "                        # scene_image_prompt_short=\"In a dimly lit, cluttered art studio, Elias, a reclusive artist in his mid-thirties with pale skin and tired, dark eyes, stands frozen in shock. Paint-stained hands hang at his sides as he watches in awe. Before him, Amara steps gracefully out of a large canvas. She appears ethereal, with shifting hair in shades of indigo and silver, and eyes that reflect amber and green. Her movements are fluid, as if moving through water, and a warm, hazy light filters through dusty windows, adding a surreal glow to the scene.\",\n",
    "                        scene_image_prompt=\"Surrealism-inspired image:\\n\\n\"\n",
    "                                        \"Layer 1 (Background): Show a dimly lit, cluttered art studio with large, dusty windows. Sunlight streams in through the windows, illuminating scattered canvases, half-empty paint tubes, and crumpled sketches on the floor. The light is soft, warm, and a bit hazy, adding a surreal, dreamlike quality to the space.\\n\\n\"\n",
    "                                        \"Layer 2 (Middle ground): Focus on a large easel and the canvas from which a luminous figure is stepping out. The canvas is partially obscured by paint splatters and handprints, capturing the intensity and rawness of the artist's work. The colors around the figure's form blur, suggesting her gradual transition from art to life.\\n\\n\"\n",
    "                                        \"Layer 3 (Foreground): Place the tall, lean artist in his mid-thirties, standing just a few feet from the canvas. He is frozen in shock, paint-stained hands hanging by his sides, his expression one of awe and disbelief. Before him, the ethereal figure steps gracefully out of the canvas, her form glowing faintly. Her flowing hair shifts subtly between indigo and silvery white, and her eyes, a mix of amber and green, hold a blend of curiosity and a hint of sadness as she gazes at him and her new surroundings.\\n\\n\"\n",
    "                                        \"Atmosphere: Soft, warm light fills the scene, casting a magical and slightly eerie glow. Dust particles float in the air, adding an ethereal quality to the scene as if the studio itself were on the brink of awakening with the artist's creation.\",\n",
    "                        scene_image_prompt_short=\"Surrealism-inspired image of a dimly lit, cluttered studio where a reclusive artist stands in shock as an ethereal figure with shifting hair steps out of a canvas. Sunlight filters through dusty windows, casting a surreal glow and highlighting the dust-filled air.\"\n",
    "                    ),\n",
    "                    Scene(\n",
    "                        scene_id=\"rogue_creation\",\n",
    "                        title=\"The Rogue Creation\",\n",
    "                        description=\"One of Elias's previous paintings, a dark figure known as The Enforcer, comes to life and escapes.\",\n",
    "                        setting=\"The studio at night, shadows cast by unfinished works and flickering lights.\",\n",
    "                        key_actions=[\"The Enforcer tears itself from the canvas, startling Elias.\", \"The Enforcer vanishes into the night, leaving behind a trail of black paint.\"],\n",
    "                        characters_involved=[\"elias\", \"enforcer\"],\n",
    "                        location=\"Art studio\",\n",
    "                        time_of_day=\"Night\",\n",
    "                        lighting=\"Dim, with shadows created by a single flickering bulb\",\n",
    "                        mood=\"Foreboding and tense\",\n",
    "                        background_animation=\"A single bulb flickers sporadically, casting jagged shadows across the room. The darkness feels thick and heavy, with a subtle mist rising from the corners as if the studio itself were breathing. The Enforcer's trail of black paint seems to smoke and dissipate, blending into the shadows as it disappears.\",\n",
    "                        background_image_prompt=\"A dimly lit, chaotic art studio at night, with jagged shadows cast by a single flickering light bulb. Dark, unfinished paintings loom in the background, and shadows seem to stretch and merge, creating an ominous atmosphere. A faint mist rises from the corners, giving the impression the studio itself is alive. The floor holds a trail of black paint that smokes and dissipates into the darkness, adding tension and foreboding to the scene.\",\n",
    "                        # scene_image_prompt=\"In the dim, oppressive shadows of Elias's studio, the air feels thick and tense. The room is lit only by a single, weakly flickering bulb, casting jagged shadows that dance across the scattered, unfinished canvases. Elias, visibly unnerved, stands to one side, his tall, gaunt frame partially hidden in the shadows. He has a pale complexion, sharp cheekbones, and haunted eyes that reflect his internal struggles. His worn, paint-streaked clothes and hands reveal a life devoted to his art, but his expression now is one of shock and fear. Emerging ominously from one of the darker paintings is The Enforcer, a figure of pure menace. The Enforcer is a tall, shadowy being with an undefined, almost smoke-like form, constantly shifting and flickering as if it cannot hold a solid shape. Its face is obscured, with deep, empty hollows where eyes should be, giving it a ghostly, detached stare that feels chilling and inhuman. As it tears itself from the canvas, its movements are slow, calculated, and filled with a deadly intent. A thick, inky trail of black paint follows it, smoking and evaporating into the air, adding a supernatural quality to its presence. The faint mist rising from the corners of the room adds to the eerie, foreboding atmosphere, as if the studio itself were holding its breath in fear of what has been unleashed.\",\n",
    "                        # scene_image_prompt_short=\"In the dim light of Elias's shadow-filled studio, he stands in shock as The Enforcer—a menacing, smoke-like figure—emerges from a dark painting. Its ghostly, hollow eyes and shifting form exude deadly intent, leaving an inky, evaporating trail. The air is thick, tense, and heavy with supernatural dread, as if the studio itself fears the ominous presence now unleashed.\",\n",
    "                        scene_image_prompt=\"Surrealism-inspired image:\\n\\n\"\n",
    "                                        \"Layer 1 (Background): Show a dark, shadow-filled art studio, with walls covered in unfinished canvases. The room is dimly lit by a single flickering bulb, casting jagged shadows that stretch across the studio, giving it a sinister and foreboding atmosphere.\\n\\n\"\n",
    "                                        \"Layer 2 (Middle ground): Depict the main painting from which The Enforcer is emerging, with shadowy, undefined features blurring around its edges as if it's melting or tearing itself from the canvas. The area around the painting appears to darken, as if the shadows are intensifying near The Enforcer.\\n\\n\"\n",
    "                                        \"Layer 3 (Foreground): Focus on The Enforcer, a tall, spectral figure with a shifting, smoky form. Its features are unclear, with hollow eyes that reflect an eerie emptiness, adding to its menace. A thick, black trail of paint smokes and dissipates as it flows from the canvas toward the floor. Nearby, Elias stands partially obscured by shadows, his face a mix of shock and fear.\\n\\n\"\n",
    "                                        \"Atmosphere: Thick, dark shadows fill the room, and the air feels heavy and tense, as though the studio itself fears what has been unleashed. A faint mist rises in the corners, creating an eerie, supernatural quality to the setting.\",\n",
    "                        scene_image_prompt_short=\"Surrealism-inspired image of a dark, shadow-filled studio, Elias watches in horror as The Enforcer, a spectral figure with hollow eyes, emerges from a canvas. Thick shadows and a flickering bulb add to the ominous, tense atmosphere.\"\n",
    "\n",
    "                    )\n",
    "                ]\n",
    "            )\n",
    "        ],\n",
    "        story_beats=[\n",
    "            StoryBeat(name=\"Inciting Incident\", description=\"Elias discovers his power to bring art to life when Amara steps out of the canvas.\", scene=\"The Awakening\"),\n",
    "            StoryBeat(name=\"Rising Tension\", description=\"The Enforcer comes to life, foreshadowing danger.\", scene=\"The Rogue Creation\")\n",
    "        ],\n",
    "        subplots=[\n",
    "            Subplot(title=\"Amara's Desire for Freedom\", description=\"Amara begins questioning Elias's control over her.\", related_characters=[\"Amara, the Living Muse\"]),\n",
    "            Subplot(title=\"The Consequences of Creation\", description=\"Elias must reckon with the unintended dangers of his powers.\", related_characters=[\"Elias, the Artist\", \"The Enforcer, a Rogue Painting\"])\n",
    "        ],\n",
    "        emotional_arc=[\n",
    "            EmotionalArc(stage=\"Awe\", description=\"Elias is fascinated and shocked by his power.\"),\n",
    "            EmotionalArc(stage=\"Fear\", description=\"As his creations take on minds of their own, Elias feels afraid of his abilities.\")\n",
    "        ],\n",
    "        conflict_type=\"Man vs. Man and Man vs. Self\",\n",
    "        themes=[\"Power and Responsibility\", \"Control vs. Freedom\"],\n",
    "        motifs=[\"Art and Creation\", \"Freedom\"]\n",
    "    ),\n",
    "\n",
    "\n",
    "    Story(\n",
    "        prompt=\"In a world where people's emotions control the weather, a young girl discovers she has the rare ability to bring calm to any storm. However, she must learn to control her own feelings before she can save her town from an impending disaster.\",\n",
    "        title=\"The Weather Weaver\",\n",
    "        genre=\"Fantasy Adventure\",\n",
    "        medium=\"Book\",\n",
    "        visual_style=\"Vivid Fantasy\",\n",
    "        time_period=\"Timeless fantasy setting, with elements of modern-day influences\",\n",
    "        location=\"A small, scenic village nestled between lush forests and a vast stormy sea\",\n",
    "        plot_overview=\"In 'The Weather Weaver,' Maya, a sensitive young girl, discovers she has the rare power to influence the weather through her emotions. As she grapples with self-doubt and anxiety, her abilities grow increasingly unpredictable, creating intense storms. With the guidance of her wise grandmother, Iris, Maya learns techniques to find inner calm, bringing peace not only to her surroundings but also within herself. However, her journey is complicated by Jonah, a boy with a stormy disposition and his own powers, who challenges Maya's control. As a catastrophic storm threatens their village, Maya must master her emotions to protect her home and loved ones.\",\n",
    "        narrative_perspective=\"Third-person limited, focused on Maya's perspective with occasional insights into Jonah's thoughts\",\n",
    "        characters=[\n",
    "            Character(\n",
    "                nickname=\"maya\",\n",
    "                name=\"Maya, the Weather Weaver\",\n",
    "                role=\"Protagonist and emotional weather manipulator\",\n",
    "                gender=\"Female\",\n",
    "                race=\"Human\",\n",
    "                age=\"13\",\n",
    "                description=\"A young girl who discovers her rare ability to influence the weather with her emotions.\",\n",
    "                personality=\"Sensitive, compassionate, but struggles with self-control.\",\n",
    "                physical_appearance=\"Petite with curly hair that seems to change color based on her mood.\",\n",
    "                catch_phrase=\"Stay calm, stay strong.\",\n",
    "                animation_description=\"Maya's movements are quick but hesitant, often clenching her fists when frustrated and releasing them to breathe deeply when calming herself.\",\n",
    "                voice_description=\"Soft and unsure at first, but growing steady and clear as she gains confidence.\",\n",
    "                internal_conflict=\"Wrestles with self-doubt and fear of her powers, afraid she may hurt those around her if she loses control.\",\n",
    "                character_arc=CharacterArc(\n",
    "                    initial_state=\"Overwhelmed and fearful of her powers.\",\n",
    "                    final_state=\"Confident and able to control her emotions.\",\n",
    "                    key_moments=[\n",
    "                        \"Discovers her powers during an argument.\",\n",
    "                        \"Receives guidance from Grandmother Iris.\",\n",
    "                        \"Learns to calm herself, calming the weather.\"\n",
    "                    ]\n",
    "                ),\n",
    "                image_prompt=\"Full-body, A digital painting style with watercolor elements of a 13-year-old girl with a petite build, standing with curly hair that shifts in color based on her emotions. Her skin is light with a scattering of freckles across her cheeks. She wears a simple, short-sleeved dress in soft earth tones that falls to her knees, along with worn sneakers. Her expression is both intense and contemplative, with her eyes conveying inner conflict and sensitivity. Her fists are often clenched when she's tense, but her hands relax when she calms. She has a gentle presence, yet there's a subtle strength in her posture.\",\n",
    "                image_prompt_short=\"Full-body, A digital painting style with watercolor elements of a petite 13-year-old with color-shifting curls, earthy dress, and expressive, conflicted eyes.\",\n",
    "            ),\n",
    "            Character(\n",
    "                nickname=\"grandmother\",\n",
    "                name=\"Grandmother Iris\",\n",
    "                role=\"Mentor and wise guide\",\n",
    "                gender=\"Female\",\n",
    "                race=\"Human\",\n",
    "                age=\"70s\",\n",
    "                description=\"Maya's wise grandmother who teaches her how to control her powers.\",\n",
    "                personality=\"Patient, nurturing, and full of hidden knowledge.\",\n",
    "                physical_appearance=\"Elderly with silver hair tied in a bun, always wearing a shawl.\",\n",
    "                catch_phrase=\"The storm within must be tamed first.\",\n",
    "                animation_description=\"Grandmother Iris moves with slow, deliberate grace, often placing a calming hand on Maya's shoulder during tense moments.\",\n",
    "                voice_description=\"Warm and steady with a soft, melodic cadence that soothes those around her.\",\n",
    "                internal_conflict=\"Remains haunted by her own past mistakes with similar powers, worried Maya may face the same struggles.\",\n",
    "                character_arc=CharacterArc(\n",
    "                    initial_state=\"Reserved, protecting Maya from deeper knowledge of the past.\",\n",
    "                    final_state=\"More open and trusting of Maya's growth.\",\n",
    "                    key_moments=[\n",
    "                        \"Guides Maya through her first calming exercise.\",\n",
    "                        \"Shares a personal story to encourage Maya.\",\n",
    "                        \"Trusts Maya to handle the coming storm on her own.\"\n",
    "                    ]\n",
    "                ),\n",
    "                image_prompt=\"Full-body, A digital painting style with watercolor elements of an elderly woman in her 70s with gentle, weathered features. Her silver hair is neatly tied in a bun, with a few soft strands framing her face. She wears a warm, earth-toned shawl draped over her shoulders, covering a simple, ankle-length dress in muted colors. Her skin is fair with visible lines of age, and her eyes are wise and comforting, often with a gentle smile. She stands with a calm, graceful posture, one hand gently reaching out, as if offering guidance.\",\n",
    "                image_prompt_short=\"Full-body, A digital painting style with watercolor elements of an elderly woman with silver hair in a bun, earthy shawl, gentle and wise eyes.\",\n",
    "\n",
    "            ),\n",
    "            Character(\n",
    "                nickname=\"jonah\",\n",
    "                name=\"Jonah, the Storm Bringer\",\n",
    "                role=\"Rival and fellow weather manipulator\",\n",
    "                gender=\"Male\",\n",
    "                race=\"Human\",\n",
    "                age=\"14\",\n",
    "                description=\"A boy who can summon storms but struggles with his own anger.\",\n",
    "                personality=\"Rebellious, troubled, but deeply wants to belong.\",\n",
    "                physical_appearance=\"Tall with wild, wind-swept hair and piercing blue eyes.\",\n",
    "                catch_phrase=\"Let it rage!\",\n",
    "                animation_description=\"Jonah's movements are sharp and expressive, his posture tense and defensive, often clenching his jaw when feeling misunderstood.\",\n",
    "                voice_description=\"Raspy and intense, with an edge of frustration and yearning for connection.\",\n",
    "                internal_conflict=\"Feels trapped by his own temper and isolation, often lashing out as a means of coping with loneliness.\",\n",
    "                character_arc=CharacterArc(\n",
    "                    initial_state=\"Angry and unable to control his emotions.\",\n",
    "                    final_state=\"Begins to learn emotional restraint, inspired by Maya.\",\n",
    "                    key_moments=[\n",
    "                        \"Clashes with Maya due to his uncontrolled powers.\",\n",
    "                        \"Observes Maya's growth with curiosity.\",\n",
    "                        \"Begins his own journey toward emotional control.\"\n",
    "                    ]\n",
    "                ),\n",
    "                image_prompt=\"Full-body, A digital painting style with watercolor elements of a tall, lean 14-year-old boy with a tense, rebellious stance. His dark, wild hair appears wind-swept, as though it's constantly caught in a storm. His piercing blue eyes hold a mix of frustration and yearning for connection. He wears a rugged, slightly oversized jacket over a simple, dark shirt and worn jeans, and sturdy boots. His jaw is often clenched, and his posture is defensive, yet there is a hint of vulnerability in his gaze.\",\n",
    "                image_prompt_short=\"Full-body, A digital painting style with watercolor elements of a tall, lean 14-year-old boy with wild hair, piercing blue eyes, rugged jacket, and tense stance.\",\n",
    "            ),\n",
    "        ],\n",
    "        acts=[\n",
    "            Act(\n",
    "                act_id=\"awakening_the_storm\",\n",
    "                title=\"Act 1 - Awakening the Storm\",\n",
    "                scenes=[\n",
    "                    Scene(\n",
    "                        scene_id=\"storm_beginning\",\n",
    "                        title=\"The Storm's Beginning\",\n",
    "                        description=(\n",
    "                            \"Maya accidentally causes a storm during an argument at school, revealing her emotional influence on \"\n",
    "                            \"the weather. Her frustration escalates as she confronts a group of classmates who mock her for her \"\n",
    "                            \"quiet demeanor. She snaps, unleashing a powerful emotional surge.\"\n",
    "                        ),\n",
    "                        setting=\"A bustling schoolyard where students gather after classes, with dense clouds forming in the sky above.\",\n",
    "                        key_actions=[\n",
    "                            \"Maya raises her voice, feeling her anger boil over, and suddenly thunder rumbles overhead.\",\n",
    "                            \"The sky darkens, and rain starts pouring as Maya's frustration peaks, terrifying her classmates.\",\n",
    "                            \"Realizing she must stop the storm, Maya desperately tries to calm herself but struggles with her emotions.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"maya\"],\n",
    "                        location=\"Schoolyard\",\n",
    "                        time_of_day=\"Afternoon\",\n",
    "                        lighting=\"Dark, stormy clouds casting shadows over the schoolyard.\",\n",
    "                        mood=\"Chaotic and intense, a mix of fear and confusion.\",\n",
    "                        background_animation=\"Dark clouds roll in swiftly, casting shadows over the schoolyard as the wind picks up. Leaves and debris swirl around. Thunder rumbles and lightning flickers, illuminating startled faces in the crowd. Raindrops begin to pour.\",\n",
    "                        background_image_prompt=\"A bustling schoolyard with students gathered under dark, stormy clouds. The sky is shadowed, with dense clouds rolling in, casting an eerie darkness over the scene. A strong wind picks up, swirling leaves and loose paper around. Thunder rumbles, and occasional lightning flickers, illuminating the startled faces in the crowd. The atmosphere is chaotic and intense, with the natural elements reflecting the brewing emotional storm.\",\n",
    "                        scene_image_prompt=\"\"\"A digital painting style with watercolor elements of a bustling schoolyard filled with students, where a powerful storm begins to build.\n",
    "\n",
    "Layer 1 (Background): The sky is thick with dark, heavy clouds rolling in swiftly, casting an eerie shadow across the scene. Occasional flashes of lightning illuminate the darkening landscape in brief, bright bursts.\n",
    "\n",
    "Layer 2 (Middle ground): The schoolyard is crowded with students looking up in awe and fear as the storm intensifies. A strong wind swirls leaves and loose paper, creating a chaotic, whirlwind effect through the center of the area.\n",
    "\n",
    "Layer 3 (Foreground): In the center of the yard stands a young girl with curly hair that darkens and shifts in color, mirroring her rising frustration. Her petite frame is tensed, with clenched fists at her sides, her expressive face filled with a mix of anger and hurt. Around her, classmates watch from a distance, their expressions frightened as they sense her distress. Raindrops begin to fall, heavy and cold, adding to the intense, chaotic atmosphere that reflects the brewing emotional storm within her.\"\"\",\n",
    "                        scene_image_prompt_short=\"A digital painting style of a stormy schoolyard where a young girl with shifting curls stands at the center of swirling winds and dark clouds, her emotions mirrored in the storm around her. With clenched fists and stormy, shifting hair, she faces her classmates' frightened stares as thunder rumbles and lightning crackles. Raindrops begin to fall, intensifying the tense, chaotic atmosphere.\",\n",
    "                    ),\n",
    "                    Scene(\n",
    "                        scene_id=\"granmother_visit\",\n",
    "                        title=\"Grandmother's Wisdom\",\n",
    "                        description=(\n",
    "                            \"Seeking solace after her unsettling experience, Maya visits her grandmother, Iris, who teaches her the \"\n",
    "                            \"importance of inner peace in controlling her powers. Iris introduces her to grounding techniques to \"\n",
    "                            \"help Maya manage her emotions and calm the weather.\"\n",
    "                        ),\n",
    "                        setting=\"A cozy, inviting living room filled with the scent of herbs and the soft glow of a crackling fireplace, with rain lightly pattering on the window.\",\n",
    "                        key_actions=[\n",
    "                            \"Iris guides Maya through a breathing exercise, encouraging her to release her frustrations.\",\n",
    "                            \"Maya closes her eyes, focusing on her breath, and the storm outside begins to calm, transforming into a gentle rain.\",\n",
    "                            \"As Maya achieves a sense of inner calm, the clouds part, and a vibrant rainbow appears outside, signifying her newfound control.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"maya\", \"grandmother\"],\n",
    "                        location=\"Living room\",\n",
    "                        time_of_day=\"Evening\",\n",
    "                        lighting=\"Soft, warm glow from the fireplace, with raindrops glistening outside.\",\n",
    "                        mood=\"Calming and hopeful, with a sense of growth and support.\",\n",
    "                        # background_animation=\"Raindrops patter rhythmically on the window. The fire crackles gently, casting a warm, steady glow. The rain eases into a soft drizzle, and sunlight filters through the window, creating a rainbow.\",\n",
    "                        # background_image_prompt=\"A cozy, inviting living room filled with the soft glow of a crackling fireplace. The room is warmly lit, with the scent of herbs and a peaceful ambiance. Raindrops patter gently on the window as light from the fire casts a steady, calming glow across the room. Soft, natural colors and simple decor reflect comfort and wisdom. As the scene progresses, rain outside eases to a drizzle, and a rainbow faintly appears, signaling calm and newfound inner peace.\",\n",
    "                        # scene_image_prompt=\"In a cozy, warmly lit living room filled with the gentle scent of dried herbs and the crackling of a small fireplace, Maya sits across from her grandmother, Iris, seeking comfort and guidance. Maya, a petite 13-year-old girl with soft, curly hair that subtly shifts in color depending on her emotions, looks at her grandmother with a mixture of uncertainty and hope. She wears a simple, faded dress, her hands resting in her lap, fingers fidgeting as she listens intently. Grandmother Iris, a gentle, elderly woman with silver hair tied back in a neat bun, has a face lined with wisdom and warmth. She wears a soft, worn shawl over her shoulders and holds a calming presence, her steady hands reaching out to gently guide Maya through a breathing exercise. As Maya closes her eyes and breathes deeply, the storm outside the window begins to calm, the rain easing into a soft drizzle. The warm, amber glow from the fireplace bathes the room in a soothing light, creating an atmosphere of safety, growth, and emotional support as a vibrant rainbow begins to form outside, symbolizing Maya's newfound inner peace.\",\n",
    "                        # scene_image_prompt_short=\"In a cozy living room, Maya, a 13-year-old with color-shifting curls, sits with her grandmother Iris, seeking comfort. Iris, a gentle elder with silver hair, guides Maya through calming breaths. As Maya relaxes, the storm outside eases, and a rainbow forms, symbolizing her newfound inner peace in the warm, soothing glow of the fireplace.\",\n",
    "                        background_animation=\"A digital painting style with watercolor elements of raindrops pattering rhythmically on the window. The fire crackles gently, casting a warm, steady glow. The rain eases into a soft drizzle, and sunlight filters through the window, creating a rainbow.\",\n",
    "                        background_image_prompt=\"A digital painting style with watercolor elements of a cozy, inviting living room filled with the soft glow of a crackling fireplace. The room is warmly lit, with the scent of herbs and a peaceful ambiance. Raindrops patter gently on the window as light from the fire casts a steady, calming glow across the room. Soft, natural colors and simple decor reflect comfort and wisdom. As the scene progresses, rain outside eases to a drizzle, and a rainbow faintly appears, signaling calm and newfound inner peace.\",\n",
    "                        scene_image_prompt=\"\"\"A digital painting style with watercolor elements of a cozy, warmly lit living room filled with the gentle scent of dried herbs and the crackling of a small fireplace.\n",
    "\n",
    "Layer 1 (Background): Depict a softly lit living room interior with warm, natural tones. A large window shows raindrops pattering rhythmically on the glass, with a gentle drizzle outside beginning to ease. Through the window, hint at the faint outline of a rainbow forming as the sky clears.\n",
    "\n",
    "Layer 2 (Middle ground): Focus on the inviting room decor and furniture, emphasizing the worn, comforting textures of a well-loved space. Include simple furnishings—a cozy armchair, a small round table with a tea set, and a few scattered books. A glowing fireplace sits nearby, casting a warm amber light that fills the room with a soothing glow.\n",
    "\n",
    "Layer 3 (Foreground): Center on a young girl with petite features and curly hair that subtly shifts in hue with her emotions. She sits with an elderly woman, her grandmother, who has a gentle face lined with wisdom and wears a soft, worn shawl. The grandmother reaches out to guide the girl through a calming breathing exercise. The girl's expression is a mix of hope and uncertainty as she focuses, her hands resting in her lap. \n",
    "\n",
    "Atmosphere: The overall mood should be calm and nurturing, with a soft, ethereal quality to the lighting that highlights the warmth of the scene. As the rain eases, the room exudes a feeling of emotional growth and support, symbolized by the faint rainbow outside.\"\"\",\n",
    "\n",
    "                        scene_image_prompt_short=\"A digital painting style with watercolor elements of a cozy living room where a young girl with color-shifting curls sits with her elderly grandmother, seeking comfort. The grandmother, a gentle elder with silver hair, guides the girl through calming breaths. As the girl relaxes, the storm outside eases, and a rainbow forms, symbolizing her newfound inner peace in the warm, soothing glow of the fireplace.\",\n",
    "                    ),\n",
    "                    Scene(\n",
    "                        scene_id=\"encounter_jonah\",\n",
    "                        title=\"A Mysterious Encounter\",\n",
    "                        description=(\n",
    "                            \"On her way back from her grandmother's house, Maya encounters Jonah, a boy with a mysterious aura and an \"\n",
    "                            \"unmistakable power over storms. He challenges her understanding of weather manipulation and the control she \"\n",
    "                            \"thinks she's gained.\"\n",
    "                        ),\n",
    "                        setting=\"A deserted forest path under a brooding, cloudy sky, where thunder rolls in the distance.\",\n",
    "                        key_actions=[\n",
    "                            \"Maya feels a shift in the air, turning to find Jonah standing nearby, his presence intense and foreboding.\",\n",
    "                            \"Jonah stirs the air with a slight motion, causing a gust of wind and a flicker of lightning to illuminate the sky.\",\n",
    "                            \"The two exchange wary words, with Jonah hinting at the untamed potential in Maya's abilities, leaving her unsettled.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"maya\", \"jonah\"],\n",
    "                        location=\"Forest path\",\n",
    "                        time_of_day=\"Dusk\",\n",
    "                        lighting=\"Dark and ominous with flickers of lightning in the distance.\",\n",
    "                        mood=\"Tense and foreboding, hinting at rivalry and unease.\",\n",
    "                        background_animation=\"A low wind rustles through the trees, and leaves swirl around. Dark clouds gather overhead, and flashes of lightning periodically illuminate the sky.\",\n",
    "                        background_image_prompt=\"A digital painting style with watercolor elements of a deserted forest path under a brooding sky, where clouds loom heavily and thunder rumbles in the distance. Shadows fall across the path, with brief flashes of lightning illuminating the dense, ominous surroundings. A light wind stirs leaves and small branches, adding tension to the scene. The atmosphere is dark and tense, suggesting rivalry and unease, as if nature itself reflects the intensity of the encounter.\",\n",
    "                        \n",
    "                        scene_image_prompt=\"\"\"A digital painting style with watercolor elements of a deserted, tree-lined forest path under a darkening sky, where two figures stand tensely.\n",
    "\n",
    "Layer 1 (Background): The sky is thick with dark, swirling clouds that hang low over the path, casting deep shadows across the forest. Occasional flashes of lightning illuminate the scene, briefly lighting up the ominous surroundings and highlighting the dense trees and underbrush.\n",
    "\n",
    "Layer 2 (Middle ground): The narrow forest path is littered with fallen leaves and small branches that rustle in the light wind. The trees on either side stand tall and foreboding, creating a sense of enclosure and tension. Shadows deepen along the path, contributing to the tense atmosphere.\n",
    "\n",
    "Layer 3 (Foreground): In the center of the path stands a petite girl with wild, curly hair that subtly shifts in hue with her emotions. She has a wary expression, her posture tense, with slightly hunched shoulders as she faces a taller teenage boy. The boy has a rugged, intense look, with dark, wind-swept hair and piercing blue eyes that convey hidden storms within. He wears a loose, weather-worn jacket and stands with confidence, his gaze intense and foreboding. His subtle movements manipulate the air around him, causing a light gust to stir the leaves at their feet. A smirk plays on his face as he observes the girl's reaction, their standoff simmering with unspoken rivalry. Lightning flashes overhead, casting dramatic shadows that highlight the tension and intensity of their encounter, as if the storm mirrors the rivalry between them.\"\"\",\n",
    "                        \n",
    "                        scene_image_prompt_short=\"A digital painting style with watercolor elements of a darkening forest path, where a petite girl with subtly color-shifting curls stands tensely opposite a rugged teenage boy with piercing blue eyes and wind-tousled hair. He smirks, stirring leaves with a light gust, while flashes of lightning illuminate their intense standoff under swirling storm clouds, emphasizing the tension and rivalry between them.\"\n",
    "\n",
    "                    ),\n",
    "                ]\n",
    "            ),\n",
    "            Act(\n",
    "                act_id=\"struggle_for_control\",\n",
    "                title=\"Act 2 - Struggle for Control\",\n",
    "                scenes=[\n",
    "                    Scene(\n",
    "                        scene_id=\"tempest_within\",\n",
    "                        title=\"The Tempest Within\",\n",
    "                        description=(\n",
    "                            \"Maya continues her training with her grandmother but struggles as her emotions often get the better of her. \"\n",
    "                            \"As the pressure to control her powers mounts, she starts doubting herself, creating more turbulent weather.\"\n",
    "                        ),\n",
    "                        setting=\"Grandmother Iris's backyard garden, a serene place disrupted by Maya's sporadic storms.\",\n",
    "                        key_actions=[\n",
    "                            \"Maya practices her breathing and calming exercises, but frustration causes wind to whip through the garden.\",\n",
    "                            \"Iris gently encourages Maya, reminding her to be patient, but Maya's self-doubt causes the storm to worsen.\",\n",
    "                            \"As the storm becomes overwhelming, Maya runs away, feeling unable to meet her grandmother's expectations.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"maya\", \"grandmother\"],\n",
    "                        location=\"Iris's backyard garden\",\n",
    "                        time_of_day=\"Morning\",\n",
    "                        lighting=\"Soft daylight, dimmed by sudden dark clouds as Maya struggles.\",\n",
    "                        mood=\"Frustration and anxiety, with a tone of inner conflict and self-doubt.\",\n",
    "                        background_animation=\"The garden blooms sway as gusts of wind sweep through the space. Storm clouds gather, darkening the sky. Leaves scatter, and a soft drizzle begins.\",\n",
    "                        background_image_prompt=\"A digital painting style with watercolor elements of a serene backyard garden filled with colorful blooms, suddenly disrupted by stormy weather as dark clouds gather overhead. The sky dims, and a soft drizzle begins as gusts of wind rustle through plants. Leaves and petals are scattered by the wind, reflecting the tension and inner turmoil of the scene. The contrast between the garden's natural beauty and the sudden storm creates a visually striking representation of conflict and frustration.\",\n",
    "                        scene_image_prompt=\"\"\"A digital painting style with watercolor elements of a tranquil backyard garden, where a sudden storm disrupts the peaceful setting.\n",
    "\n",
    "Layer 1 (Background): The garden is surrounded by soft greenery, with vibrant flowers in full bloom, but dark storm clouds begin to gather overhead, casting an ominous shadow. The sky dims, with patches of light breaking through the clouds in the distance.\n",
    "\n",
    "Layer 2 (Middle ground): The garden's colorful flowers and lush plants sway as strong gusts sweep through, scattering leaves and petals. A light drizzle starts to fall, dampening the vibrant hues of the blooms, creating a visually striking contrast between the garden's natural beauty and the encroaching storm.\n",
    "\n",
    "Layer 3 (Foreground): In the center of the garden stands a young girl with petite features and curly hair that subtly shifts in color with her emotions. Her face is set in frustration, her hands clenched as she struggles with her emotions. Nearby, an elderly woman with a calm, nurturing expression and silver hair tied back observes with gentle eyes. She wears a soft, worn shawl and extends a supportive hand toward the girl. The interplay of their expressions and postures captures the tension and inner conflict, while the surrounding storm elements intensify the atmosphere, illustrating the girl's struggle for control.\"\"\",\n",
    "                        scene_image_prompt_short=\"In a digital painting style with watercolor elements, a tranquil garden is disrupted as dark clouds gather. A young girl stands at the center, her curly hair shifting in hue with her emotions, and her small frame visibly tense as she faces inner turmoil. Leaves and petals swirl around her as a strong gust whips through, dimming the vibrant flowers under the darkening sky. Nearby, an elderly woman with silver hair tied back and a gentle, nurturing expression extends a supportive hand, creating a contrast between her calm presence and the stormy, introspective atmosphere.\",\n",
    "                    ),\n",
    "                    Scene(\n",
    "                        scene_id=\"storm_bringer_influence\",\n",
    "                        title=\"The Storm Bringer's Influence\",\n",
    "                        description=(\n",
    "                            \"Maya encounters Jonah again in the village. He demonstrates his control over the storm, yet his methods are \"\n",
    "                            \"rooted in anger rather than peace. Intrigued and frustrated, Maya tries to understand his approach, leading \"\n",
    "                            \"to an intense clash.\"\n",
    "                        ),\n",
    "                        setting=\"The edge of the village near the cliffs, overlooking a restless sea as winds pick up.\",\n",
    "                        key_actions=[\n",
    "                            \"Jonah calls forth a powerful gust, causing waves to crash violently against the cliffs.\",\n",
    "                            \"Maya confronts Jonah, asking why he uses his power with such anger, but Jonah rebuffs her with cynicism.\",\n",
    "                            \"As tensions rise, the sky darkens, reflecting their clashing emotions, and Maya realizes the danger of uncontrolled anger.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"maya\", \"jonah\"],\n",
    "                        location=\"Village cliffs\",\n",
    "                        time_of_day=\"Afternoon\",\n",
    "                        lighting=\"Dark, stormy skies with occasional flashes of lightning.\",\n",
    "                        mood=\"Intense and confrontational, highlighting the contrast between control and chaos.\",\n",
    "                        background_animation=\"Strong winds sweep over the cliffs, carrying the salt spray of crashing waves. Clouds churn above, as lightning crackles in the distance. The sky darkens ominously, and trees bend to the force of the wind.\",\n",
    "                        background_image_prompt=\"A digital painting style with watercolor elements of a rugged cliffside overlooking a restless sea. Waves crash violently against the rocks below, while strong winds sweep across the cliffs, carrying salt spray and scattered leaves. Above, storm clouds churn in the dark sky, and occasional lightning briefly illuminates the scene, casting a stark, dramatic light on two figures standing at the edge. The atmosphere is intense and confrontational, highlighting a clash of emotions and power between them.\",\n",
    "                        scene_image_prompt=\"\"\"A digital painting style with watercolor elements of a rugged cliffside overlooking a vast, restless sea, where two figures face each other under a dark, turbulent sky.\n",
    "\n",
    "Layer 1 (Background): The vast, churning sea stretches to the horizon, with large waves crashing against the rugged rocks below. The sky above is filled with dark, swirling clouds, thick and heavy, casting deep shadows over the scene. Occasional flashes of lightning illuminate the landscape, adding a dramatic, ominous light.\n",
    "\n",
    "Layer 2 (Middle ground): Strong winds sweep across the cliff, carrying salt spray and swirling leaves. The cliff's rocky edge is jagged, with tufts of hardy grass that bend in the gusts. This middle layer reflects the chaotic, stormy atmosphere, with nature itself appearing agitated, mirroring the tension of the figures.\n",
    "\n",
    "Layer 3 (Foreground): Near the cliff's edge stands a petite young girl with intense, curly hair that subtly shifts in color, reflecting her emotional state. Her expression is a mix of determination and caution as she faces a tall teenage boy across from her. The boy has wild, dark hair and piercing blue eyes, and he stands with a defiant posture, his worn jacket whipping in the wind. His jaw is set, and his gaze is challenging as he raises an arm, summoning a powerful gust that sends waves crashing below. The lightning briefly illuminates their contrasting expressions—the girl's cautious determination and the boy's fiery anger—capturing the clash of control versus chaos as the storm mirrors their inner conflict and emotional turmoil.\"\"\",\n",
    "                        scene_image_prompt_short=\"A digital painting style with watercolor elements of a rugged cliff overlooking a stormy sea, where a young girl with shifting curls and a focused gaze stands cautiously at the edge, her dress whipped by the wind. Across from her stands a tall boy with wild hair and piercing eyes, his expression defiant as he summons gusts that send waves crashing below. Lightning illuminates their contrasting expressions—the girl's cautious determination and the boy's fiery anger—as the storm mirrors their inner clash of control and chaos.\",\n",
    "                    )\n",
    "                ]\n",
    "            ),\n",
    "            Act(\n",
    "                act_id=\"mastery_and_great_storm\",\n",
    "                title=\"Act 3 - Mastery and the Great Storm\",\n",
    "                scenes=[\n",
    "                    Scene(\n",
    "                        scene_id=\"calm_before_storm\",\n",
    "                        title=\"Calm Before the Storm\",\n",
    "                        description=(\n",
    "                            \"As Maya gains confidence and finds peace within herself, the village braces for an unprecedented storm. \"\n",
    "                            \"Her grandmother encourages her to channel her newfound calm to protect her home.\"\n",
    "                        ),\n",
    "                        setting=\"A gathering in the village square, where villagers prepare for the incoming storm, seeking shelter and reassurance.\",\n",
    "                        key_actions=[\n",
    "                            \"Iris gives Maya a protective charm, symbolizing her growth and readiness.\",\n",
    "                            \"Maya assures the villagers that she will do everything she can to protect them, drawing strength from their support.\",\n",
    "                            \"As the first winds of the storm roll in, Maya centers herself, feeling the calm within as her power builds.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"maya\", \"grandmother\"],\n",
    "                        location=\"Village square\",\n",
    "                        time_of_day=\"Evening\",\n",
    "                        lighting=\"Gray skies with a hint of golden light as the sun sets, casting an eerie calm.\",\n",
    "                        mood=\"Hopeful yet tense, with an underlying sense of community and resolve.\",\n",
    "                        background_animation=\"The sky hangs dark and still. A gentle breeze rustles clothing. Soft sunlight filters through the clouds, casting a warm, hopeful glow.\",\n",
    "                        background_image_prompt=\"A digital painting style with watercolor elements of a quiet village square at dusk, where villagers gather under a gray, ominous sky. A gentle breeze rustles clothing and banners as the sun begins to set, casting a faint golden glow through the clouds. The atmosphere is both tense and hopeful, with villagers preparing for the impending storm and finding reassurance in each other. The scene carries a sense of eerie calm, as if the storm is waiting on the horizon.\",\n",
    "                        \n",
    "                        scene_image_prompt=\"\"\"A digital painting style with watercolor elements of a quiet village square at dusk, where a tense and expectant calm fills the atmosphere.\n",
    "\n",
    "Layer 1 (Background): The sky is thick with gray clouds that hang heavily, casting the village square into a muted shadow. The setting sun peeks through the clouds, casting a soft, golden glow that provides an ethereal lighting to the scene.\n",
    "\n",
    "Layer 2 (Middle ground): The village square is a simple, open space where villagers have begun to gather, some huddling in small groups with concerned expressions, while others stand watching with quiet hope. Banners and clothing on the villagers rustle gently in the breeze, reflecting the calm before the storm and a sense of unity in the face of impending danger.\n",
    "\n",
    "Layer 3 (Foreground): At the center of the square stands a young girl with petite features and soft curls that rest in gentle waves, reflecting her newfound inner peace. She holds a small protective charm in her hands, her expression resolute. Beside her, an elderly woman with wise eyes and silver hair tied neatly in a bun offers a final, encouraging look. The two figures are surrounded by villagers, some placing their hands on the young girl's shoulders in support. The subtle movements of the banners and clothing add to the atmosphere of anticipation and solidarity, with the final rays of sunlight illuminating their faces as they prepare to face the storm.\"\"\",\n",
    "                        \n",
    "                        scene_image_prompt_short=\"A digital painting style with watercolor elements of a quiet village square at dusk, where a young girl with soft, resting curls stands resolute, holding a charm in her hands. Beside her, an elderly woman with a gentle, encouraging expression watches over her. Villagers gather around, their faces reflecting concern and hope, as banners and clothing rustle in the breeze under the golden light breaking through the gray clouds, filling the scene with quiet unity and anticipation.\"\n",
    "                    ),\n",
    "                    Scene(\n",
    "                        scene_id=\"final_storm\",\n",
    "                        title=\"The Final Storm\",\n",
    "                        description=(\n",
    "                            \"As the storm strikes with full force, Maya faces her ultimate test, balancing between fear and peace. Jonah \"\n",
    "                            \"arrives, initially intent on letting the storm rage, but Maya's determination changes his perspective.\"\n",
    "                        ),\n",
    "                        setting=\"Open fields outside the village, battered by wind and rain as lightning illuminates the dark sky.\",\n",
    "                        key_actions=[\n",
    "                            \"Maya stands firm, focusing her energy to calm the storm's fury despite its overwhelming power.\",\n",
    "                            \"Jonah, seeing Maya's resolve, attempts to help, struggling to suppress his own anger.\",\n",
    "                            \"Together, they channel their powers to dispel the storm, creating a quiet, radiant calm as dawn breaks.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"maya\", \"jonah\"],\n",
    "                        location=\"Fields outside the village\",\n",
    "                        time_of_day=\"Early dawn\",\n",
    "                        lighting=\"Flashes of lightning give way to the first rays of sunlight, symbolizing hope and renewal.\",\n",
    "                        mood=\"Epic and transformative, with themes of unity, self-mastery, and reconciliation.\",\n",
    "                        background_animation=\"Rain pours down in torrents. Lightning illuminates the sky in brief, blinding flashes. \",\n",
    "                        background_image_prompt=\"A digital painting style with watercolor elements of an open field outside the village, battered by heavy rain and fierce wind. Flashes of lightning illuminate the dark sky as the storm rages at full force, casting brief, intense light across the scene. Shadows dance amid the chaos, and two figures stand firm against the elements. The atmosphere is epic and transformative, capturing the struggle, resilience, and unity needed to bring calm and balance back to nature.\",\n",
    "                        \n",
    "                        scene_image_prompt=\"\"\"A digital painting style with watercolor elements of a vast, open field outside the village, where a powerful storm rages around two determined figures.\n",
    "\n",
    "Layer 1 (Background): The sky above is dark and stormy, filled with churning clouds that occasionally part to reveal flashes of intense lightning. The heavy rain pours down in torrents, creating an atmosphere of chaos as the storm engulfs the landscape.\n",
    "\n",
    "Layer 2 (Middle ground): The open field is swept by fierce winds, with tall grass bending and whipping in all directions. The rain strikes the ground heavily, splashing up in waves, while lightning briefly illuminates the scene, casting dramatic, shifting shadows across the field.\n",
    "\n",
    "Layer 3 (Foreground): A young girl with a small, seemingly fragile frame stands firm at the center of the field. Her wild, curly hair is held back, and she holds her arms steady, her eyes closed in deep concentration as she channels her inner calm to confront the storm. Her expression is one of unwavering focus, defying the fierce winds and rain around her. Across from her stands a tall teenage boy with a rugged appearance, his posture tense as he watches her resolve. His dark hair is blown back by the wind, and his face reflects a mix of frustration and awe, beginning to understand her approach to control. Lightning crackles overhead, illuminating both figures in brief, dramatic flashes, capturing their intense focus as they work together. As the storm begins to calm, the dark clouds gradually part, and the first rays of dawn break through, casting a warm, hopeful light over the field, symbolizing unity, resilience, and transformation as they find peace amidst the storm.\"\"\",\n",
    "                        \n",
    "                        scene_image_prompt_short=\"A digital painting style with watercolor elements of a vast field, where a young girl stands firm with calm determination, facing a powerful storm. Her hair held back, she stands focused as lightning briefly illuminates her against the fierce winds and rain. Across from her, a tall teenage boy watches, his expression torn between frustration and awe. As they work together, the dark clouds part, and dawn's warm light breaks through, transforming chaos into calm.\"\n",
    "\n",
    "                    )\n",
    "                ]\n",
    "            )\n",
    "        ],\n",
    "        story_beats=[\n",
    "            StoryBeat(name=\"Power Discovery\", description=\"Maya learns she can influence the weather with her emotions.\", scene=\"The Storm's Beginning\"),\n",
    "            StoryBeat(name=\"Seeking Control\", description=\"Maya's grandmother teaches her emotional control.\", scene=\"Grandmother's Wisdom\")\n",
    "        ],\n",
    "        subplots=[\n",
    "            Subplot(title=\"Struggle for Control\", description=\"Maya learns emotional stability to control her powers.\", related_characters=[\"Maya, the Weather Weaver\", \"Grandmother Iris\"]),\n",
    "            Subplot(title=\"Conflict with Jonah\", description=\"Maya and Jonah clash due to their differing control over emotions.\", related_characters=[\"Maya, the Weather Weaver\", \"Jonah, the Storm Bringer\"])\n",
    "        ],\n",
    "        emotional_arc=[\n",
    "            EmotionalArc(stage=\"Overwhelm\", description=\"Maya feels overpowered by her abilities.\"),\n",
    "            EmotionalArc(stage=\"Calm\", description=\"Maya learns control and begins to master her powers.\")\n",
    "        ],\n",
    "        conflict_type=\"Man vs. Nature and Man vs. Self\",\n",
    "        themes=[\"Emotional Control and Power\", \"Nature as Reflection of Self\"],\n",
    "        motifs=[\"Weather as Emotion\", \"Self-Control\"]\n",
    "    ),\n",
    "\n",
    "\n",
    "    Story(\n",
    "        prompt=\"In a 1950s city, a detective investigates a string of murders that lead him to the dark underbelly of high society. Clues are few, and danger lurks in every shadow as he uncovers secrets that some would kill to keep hidden.\",\n",
    "        title=\"The Shadows of Midnight\",\n",
    "        genre=\"Crime Mystery\",\n",
    "        medium=\"Film\",\n",
    "        visual_style=\"Neo-Noir Color Pop\",\n",
    "        time_period=\"1950s\",\n",
    "        location=\"A gritty urban cityscape with smoky bars, dim alleyways, and grand ballrooms\",\n",
    "        plot_overview=\"Detective Jack Holden, a hard-boiled investigator with a jaded past, is called to solve a series of murders targeting the city's elite. Each crime scene reveals hints of a cover-up involving influential figures. The clues lead him through smoky jazz clubs, opulent high-rise apartments, and dangerous alleyways, as he races against time to prevent another killing. Along the way, he encounters femme fatale Evelyn Blackwood, who may be connected to the case in more ways than one. The investigation reaches a crescendo as Jack uncovers a shocking secret, forcing him to confront not only the killer but also his own inner demons.\",\n",
    "        narrative_perspective=\"Third-person limited, primarily following Jack Holden's viewpoint\",\n",
    "        characters=[\n",
    "            Character(\n",
    "                nickname=\"jack\",\n",
    "                name=\"Jack Holden, the Detective\",\n",
    "                role=\"Protagonist and investigator\",\n",
    "                gender=\"Male\",\n",
    "                race=\"Human\",\n",
    "                age=\"Early 40s\",\n",
    "                description=\"A gritty, jaded detective haunted by a troubled past.\",\n",
    "                personality=\"Cynical, determined, with a strong sense of justice.\",\n",
    "                physical_appearance=\"Tall, with a rugged face, sharp features, and a faint scar on his cheek. Often wears a trench coat and fedora.\",\n",
    "                catch_phrase=\"Justice isn't black and white.\",\n",
    "                animation_description=\"Jack moves with slow, deliberate steps, often with a cigarette dangling from his lips. His gaze is intense, as if constantly analyzing everything around him.\",\n",
    "                voice_description=\"Low, gravelly, with a dry, matter-of-fact tone.\",\n",
    "                internal_conflict=\"Struggles to trust others due to past betrayals and remains haunted by an unsolved case that once cost him dearly.\",\n",
    "                character_arc=CharacterArc(\n",
    "                    initial_state=\"Guarded and distrustful, keeping others at arm's length.\",\n",
    "                    final_state=\"Determined to confront his past and let go of old guilt.\",\n",
    "                    key_moments=[\n",
    "                        \"Finds the first murder scene with a cryptic clue.\",\n",
    "                        \"Encounters Evelyn and is both suspicious and drawn to her.\",\n",
    "                        \"Discovers a shocking connection between the murders and his past.\"\n",
    "                    ]\n",
    "                ),\n",
    "                image_prompt=\"Neo-Noir Color Pop style, full-body shot of a tall man in his early 40s with rugged features and a faint scar on his cheek. He has dark hair, combed back, and intense, sharp eyes that appear wary yet determined. His skin is fair with a slight stubble, adding to his jaded look. He wears a beige trench coat with the collar turned up, over a white dress shirt and dark tie. His pants are dark gray, with polished but worn leather shoes. In one hand, he holds a cigarette, and on his head is a classic fedora that adds to his mysterious aura.\",\n",
    "                image_prompt_short=\"Neo-Noir Color Pop style, full-body of a rugged 40s detective in trench coat, fedora, and dark gray pants.\"\n",
    "            ),\n",
    "            Character(\n",
    "                nickname=\"evelyn\",\n",
    "                name=\"Evelyn Blackwood, the Femme Fatale\",\n",
    "                role=\"Potential accomplice and love interest\",\n",
    "                gender=\"Female\",\n",
    "                race=\"Human\",\n",
    "                age=\"Late 20s\",\n",
    "                description=\"An alluring and mysterious woman with a complex past, tied to the city's elite.\",\n",
    "                personality=\"Charming, enigmatic, but hiding a dangerous secret.\",\n",
    "                physical_appearance=\"Tall, with striking features, bold red lipstick, and a stylish black dress. Her eyes are sharp, with a hint of sadness.\",\n",
    "                catch_phrase=\"Secrets are best kept in the dark.\",\n",
    "                animation_description=\"Evelyn moves with effortless grace, her gaze piercing yet unreadable. She often pauses dramatically, as if calculating her next move.\",\n",
    "                voice_description=\"Smooth and sultry, with a subtle hint of vulnerability.\",\n",
    "                internal_conflict=\"She longs for freedom from the grip of powerful figures but fears the consequences of breaking free.\",\n",
    "                character_arc=CharacterArc(\n",
    "                    initial_state=\"Mysterious and closed-off, guarded about her past.\",\n",
    "                    final_state=\"Bravely faces her connection to the crimes, choosing to help Jack.\",\n",
    "                    key_moments=[\n",
    "                        \"Meets Jack in a smoky jazz club, drawing his suspicion.\",\n",
    "                        \"Reveals a key detail about the murders but remains guarded.\",\n",
    "                        \"Ultimately sides with Jack to expose the truth, despite the risks.\"\n",
    "                    ]\n",
    "                ),\n",
    "                image_prompt=\"Neo-Noir Color Pop style, full-body shot of a tall woman in her late 20s with striking features and a hint of mystery. She has smooth, fair skin with a hint of blush, bold red lips, and dark, arched eyebrows that highlight her sharp eyes. Her hair is styled in glamorous waves, cascading down to her shoulders. She wears a sleek, black cocktail dress that accentuates her figure, with a slit that adds a hint of allure. Her shoes are black stilettos, and she has a delicate silver bracelet on one wrist. She stands confidently, exuding elegance and intrigue.\",\n",
    "                image_prompt_short=\"Neo-Noir Color Pop style, full-body of an elegant 20s femme fatale in black dress, red lips, and confident pose.\"\n",
    "            ),\n",
    "            Character(\n",
    "                nickname=\"killer\",\n",
    "                name=\"The Killer, Unknown\",\n",
    "                role=\"Antagonist and orchestrator of the murders\",\n",
    "                gender=\"Ambiguous\",\n",
    "                race=\"Human\",\n",
    "                age=\"Unknown\",\n",
    "                description=\"A shadowy figure hidden within the city's high society, pulling strings from behind the scenes.\",\n",
    "                personality=\"Cold, calculating, with a ruthless approach to covering up secrets.\",\n",
    "                physical_appearance=\"Usually hidden, but occasionally glimpsed as a silhouette in a dark suit with gloves.\",\n",
    "                catch_phrase=\"Some secrets die with their keepers.\",\n",
    "                animation_description=\"The killer moves silently, blending into shadows and avoiding direct light. Their steps are cautious and calculated, as if always planning their next move.\",\n",
    "                voice_description=\"Low and menacing, with a tone that chills the listener.\",\n",
    "                internal_conflict=\"Driven by a need to maintain control and keep dark secrets hidden at any cost.\",\n",
    "                character_arc=CharacterArc(\n",
    "                    initial_state=\"Confident in their ability to evade detection.\",\n",
    "                    final_state=\"Desperate and reckless as Jack gets closer to the truth.\",\n",
    "                    key_moments=[\n",
    "                        \"Leaves cryptic messages at crime scenes.\",\n",
    "                        \"Observes Jack from a distance, staying just out of reach.\",\n",
    "                        \"Realizes their control is slipping as Jack uncovers their identity.\"\n",
    "                    ]\n",
    "                ),\n",
    "                image_prompt=\"Neo-Noir Color Pop style, full-body shot of a shadowy, ambiguous figure mostly hidden by darkness. They wear a dark suit with a high-collared coat that obscures the face, creating a silhouette effect. Their gloves are black leather, and the hint of a dark fedora is barely visible over the collar, adding to the ominous, anonymous vibe. Only the outline of their face is visible under the hat, giving an impression of a cold, calculating presence. Their stance is cautious and controlled, exuding an air of menace and secrecy.\",\n",
    "                image_prompt_short=\"Neo-Noir Color Pop style, full-body of an ominous figure in dark suit, gloves, and hat, face obscured.\"\n",
    "            )\n",
    "        ],\n",
    "        acts=[\n",
    "            Act(\n",
    "                act_id=\"shadows_secrets\",\n",
    "                title=\"Act 1 - Shadows and Secrets\",\n",
    "                scenes=[\n",
    "                    Scene(\n",
    "                        scene_id=\"murder_alley\",\n",
    "                        title=\"Murder in the Alley\",\n",
    "                        description=\"Jack is called to investigate a murder in a narrow alley, finding the first cryptic clue left by the killer.\",\n",
    "                        setting=\"A dimly lit alleyway with brick walls covered in grime and faded posters.\",\n",
    "                        key_actions=[\n",
    "                            \"Jack examines the scene, noting a strange mark left near the body.\",\n",
    "                            \"Discovers a small red rose pinned to the victim's coat.\",\n",
    "                            \"Reflects on the eerie feeling that he's being watched from the shadows.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"jack\"],\n",
    "                        location=\"Alleyway\",\n",
    "                        time_of_day=\"Night\",\n",
    "                        lighting=\"Low, with a flickering streetlight casting dim light across the scene\",\n",
    "                        mood=\"Dark and foreboding\",\n",
    "                        background_animation=\"Slow tracking shot, medium-wide angle, with soft, flickering streetlight casting an eerie glow. Subject: A dimly lit 1950s alley with brick walls. Damp, grimy bricks covered in faded posters, some torn and peeling. Scene: Mist drifts lazily through the alley as occasional footsteps echo faintly. Atmosphere: Tense and foreboding.\",\n",
    "                        background_image_prompt=\"Neo-Noir Color Pop style of a gritty 1950s alley, dimly lit by a flickering streetlight that creates elongated shadows along damp brick walls. The ground is strewn with trash and faint mist drifting through, enhancing the mysterious, noir atmosphere. The only color contrast is a small red rose pinned to a victim's coat.\",\n",
    "                        scene_image_prompt=\"\"\"Neo-Noir Color Pop style:\n",
    "Layer 1 (Background): A dimly lit 1950s alley with damp brick walls, trash scattered on the ground, and faded posters peeling off the walls. A single, flickering streetlight casts a warm, yellowish glow that adds contrast between shadows and light.\n",
    "Layer 2 (Middle ground): In the midst of the alley, a crime scene with a body is mostly obscured in shadow. The mist swirls around, adding an atmospheric, smoky quality to the air.\n",
    "Layer 3 (Foreground): A tall man with a rugged appearance, in a trench coat and fedora, crouches near the body with a serious expression. A small red rose pinned to the victim's coat stands out as the only color contrast in the grayscale setting.\n",
    "Atmosphere: The scene is tense, shadowed, and filled with mystery, as the detective studies the crime scene under the dim streetlight.\"\"\",\n",
    "                        scene_image_prompt_short=\"Neo-Noir Color Pop style of a gritty 1950s alley with a detective examining a murder scene under a flickering streetlight. A red rose stands out as the only color against the grayscale setting.\"\n",
    "\n",
    "                    ),\n",
    "                    Scene(\n",
    "                        scene_id=\"jazz_club\",\n",
    "                        title=\"Secrets in the Jazz Club\",\n",
    "                        description=\"Jack follows a lead to a smoky jazz club, where he encounters Evelyn performing on stage.\",\n",
    "                        setting=\"Dimly lit jazz club filled with smoky air and low lighting.\",\n",
    "                        key_actions=[\n",
    "                            \"Jack observes Evelyn's performance, captivated by her allure.\",\n",
    "                            \"After the show, he approaches her with questions, probing her knowledge of the murders.\",\n",
    "                            \"Evelyn gives subtle hints, leaving Jack both intrigued and suspicious.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"jack\", \"evelyn\"],\n",
    "                        location=\"Jazz club\",\n",
    "                        time_of_day=\"Night\",\n",
    "                        lighting=\"Low, with a spotlight on stage casting a warm glow on Evelyn.\",\n",
    "                        mood=\"Tense and intimate\",\n",
    "                        background_animation=\"Slow pan, medium shot, under warm, dim lighting. Subject: A smoky jazz club interior with patrons seated at small tables. Scene: Low lights with a warm spotlight on the stage, where a woman in a red dress performs; light smoke drifts through the scene. Atmosphere: Intimate, tense, and mysterious.\",\n",
    "                        background_image_prompt=\"Neo-Noir Color Pop style of a smoky 1950s jazz club with dim table lamps scattered around. Patrons sit at small round tables, watching a warm spotlight on the stage, highlighting the main performer in an elegant red dress against the grayscale background.\",\n",
    "                        scene_image_prompt=\"\"\"Neo-Noir Color Pop style:\n",
    "Layer 1 (Background): The dim interior of a smoky 1950s jazz club. Small tables with dim lamps and smoke drifting through create a moody, intimate ambiance.\n",
    "Layer 2 (Middle ground): A jazz band plays in shadows, their instruments silhouetted in grayscale. A warm spotlight highlights the performer, casting her silhouette in sharp contrast.\n",
    "Layer 3 (Foreground): Center stage stands a tall woman in a striking red dress, under the spotlight. Her movements are fluid, and her expression is confident yet enigmatic. Across from her, a rugged man in a trench coat watches, sipping his drink with a focused gaze.\n",
    "Atmosphere: Smoky, tense, and alluring, with the red dress as the only color pop in the grayscale setting. The air feels thick with secrets and intrigue as the detective studies her from afar.\"\"\",\n",
    "                        scene_image_prompt_short=\"Neo-Noir Color Pop style of a smoky jazz club, where a woman in a red dress performs under a warm spotlight. A detective observes her from the shadows, adding mystery to the grayscale scene.\"\n",
    "\n",
    "                    ),\n",
    "                    Scene(\n",
    "                        scene_id=\"mysterious_witness\",\n",
    "                        title=\"The Mysterious Witness\",\n",
    "                        description=\"Jack receives an anonymous call from someone claiming to have seen the killer.\",\n",
    "                        setting=\"Jack's dark, cluttered office.\",\n",
    "                        key_actions=[\n",
    "                            \"Jack takes the call and listens intently to the whispered voice.\",\n",
    "                            \"The caller hints at a connection to high society and warns Jack to be careful.\",\n",
    "                            \"The line suddenly cuts, leaving Jack tense and filled with questions.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"jack\"],\n",
    "                        location=\"Jack's office\",\n",
    "                        time_of_day=\"Late evening\",\n",
    "                        lighting=\"Dim, lit by a single desk lamp.\",\n",
    "                        mood=\"Suspenseful and foreboding\",\n",
    "                        background_animation=\"Slow zoom-in, close-up shot, under low, warm lighting from a desk lamp. Subject: A dimly lit office desk with scattered papers and case files. Scene: The shadows stretch across the floor and walls, giving the room an atmosphere of suspense and secrecy. Atmosphere: Suspenseful and isolating.\",\n",
    "                        background_image_prompt=\"Neo-Noir Color Pop style of a detective's dim, cluttered office at night, with a desk lamp casting warm light on scattered papers and half-opened case files. Shadows stretch across the floor and walls, adding tension to the suspenseful scene.\",\n",
    "                        scene_image_prompt=\"\"\"Neo-Noir Color Pop style:\n",
    "Layer 1 (Background): A dimly lit, 1950s detective's office with shadows stretching across the walls. Papers, folders, and empty coffee cups lie scattered on the wooden desk.\n",
    "Layer 2 (Middle ground): A warm desk lamp casts focused light on a few open files, casting shadows that add a heavy atmosphere to the room.\n",
    "Layer 3 (Foreground): A worn, empty chair sits at the desk, as if recently vacated by someone in a rush. The phone sits on the edge, with the receiver slightly askew, adding to the air of suspense.\n",
    "Atmosphere: Suspenseful, foreboding, and reflective, with long shadows adding tension and a feeling of isolation.\"\"\",\n",
    "                        scene_image_prompt_short=\"Neo-Noir Color Pop style of a detective's dim, cluttered office at night, lit by a single desk lamp casting shadows over scattered papers.\"\n",
    "\n",
    "                    )\n",
    "                ]\n",
    "            ),\n",
    "            Act(\n",
    "                act_id=\"dangerous_liaisons\",\n",
    "                title=\"Act 2 - Dangerous Liaisons\",\n",
    "                scenes=[\n",
    "                    Scene(\n",
    "                        scene_id=\"the_ball\",\n",
    "                        title=\"The Ball in High Society\",\n",
    "                        description=\"Jack attends an elite ball hosted by a powerful family, suspecting their involvement.\",\n",
    "                        setting=\"A grand ballroom with crystal chandeliers and elegantly dressed guests.\",\n",
    "                        key_actions=[\n",
    "                            \"Jack arrives at the ball, blending in with the crowd to observe.\",\n",
    "                            \"He spots Evelyn and confronts her, pressing her for answers.\",\n",
    "                            \"A mysterious man approaches, exchanging a tense look with Jack before disappearing into the crowd.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"jack\", \"evelyn\"],\n",
    "                        location=\"Ballroom\",\n",
    "                        time_of_day=\"Evening\",\n",
    "                        lighting=\"Warm, with a golden glow from chandeliers.\",\n",
    "                        mood=\"Elegant yet tense\",\n",
    "                        background_animation=\"Slow crane shot, wide-angle with warm, golden lighting from chandeliers. Subject: A grand ballroom with opulently dressed guests and elegant crystal chandeliers. Subject Movement: Guests chatting, dancing, and mingling while subtle tension builds in the background. Scene: Ornate decorations, rich drapery, and polished floors highlight the extravagance. Atmosphere: Luxurious yet subtly tense, as hidden intentions linger.\",\n",
    "                        background_image_prompt=\"Neo-Noir Color Pop style of a grand ballroom illuminated by golden chandelier lights. Elegantly dressed guests fill the room, their conversations and movements creating a lively yet tense atmosphere. The rich drapery and polished floors add to the luxurious feel.\",\n",
    "                        scene_image_prompt=\"\"\"Neo-Noir Color Pop style:\n",
    "Layer 1 (Background): A grand ballroom with crystal chandeliers casting a warm golden glow, illuminating rich drapery and polished floors.\n",
    "Layer 2 (Middle ground): Elegantly dressed guests fill the room, chatting and mingling, adding layers of movement to the scene.\n",
    "Layer 3 (Foreground): A tall man with rugged features, in a dark suit, stands tensely as he observes a poised woman in a red dress nearby, her confident stance and piercing gaze adding to the mystery.\n",
    "Atmosphere: Luxurious, refined, with a tense undercurrent, as hidden motives begin to surface amid the glamour.\"\"\",\n",
    "                        scene_image_prompt_short=\"Neo-Noir Color Pop style of an elegant ballroom with a tense atmosphere, where a detective observes a woman in a red dress among the wealthy guests.\"\n",
    "\n",
    "                    ),\n",
    "                    Scene(\n",
    "                        scene_id=\"alley_confrontation\",\n",
    "                        title=\"Cornered in the Alley\",\n",
    "                        description=\"On his way home, Jack is ambushed by two men in an alley who warn him to stop investigating.\",\n",
    "                        setting=\"Dimly lit alley with brick walls and scattered trash.\",\n",
    "                        key_actions=[\n",
    "                            \"The men threaten Jack, telling him to 'forget the case'.\",\n",
    "                            \"Jack fights back, using his street smarts to fend off the attackers.\",\n",
    "                            \"After the scuffle, he realizes the stakes are higher than he thought.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"jack\"],\n",
    "                        location=\"Alleyway\",\n",
    "                        time_of_day=\"Night\",\n",
    "                        lighting=\"Flickering streetlight casting shadows.\",\n",
    "                        mood=\"Tense and gritty\",\n",
    "                        background_animation=\"Handheld, medium-close shot under flickering streetlight. Subject: Dark alley with brick walls and trash. Subject Movement: Figures emerge from the shadows, circling their target in a threatening manner. Scene: Scattered trash and grime add to the rough environment. Atmosphere: Tense and gritty, heightening the sense of danger.\",\n",
    "                        background_image_prompt=\"Neo-Noir Color Pop style of a dark alley with flickering streetlight casting harsh shadows. Trash litters the ground, and the grimy brick walls add to the grittiness as two shadowy figures close in.\",\n",
    "                        scene_image_prompt=\"\"\"Neo-Noir Color Pop style:\n",
    "Layer 1 (Background): A dim, flickering streetlight casts shadows on grimy brick walls, intensifying the darkness and rough atmosphere.\n",
    "Layer 2 (Middle ground): Two shadowy figures emerge, partially hidden in the shadows, moving slowly toward their target.\n",
    "Layer 3 (Foreground): A man with rugged features, trench coat torn from the struggle, stands with a determined stance, fists clenched and ready to defend himself.\n",
    "Atmosphere: Gritty, intense, and foreboding, capturing the danger and suspense in the narrow, dark alley.\"\"\",\n",
    "                        scene_image_prompt_short=\"Neo-Noir Color Pop style of a gritty alley with flickering light, where a detective faces two shadowy figures moving toward him.\"\n",
    "                    ),\n",
    "                    Scene(\n",
    "                        scene_id=\"evelyn_confession\",\n",
    "                        title=\"Evelyn's Confession\",\n",
    "                        description=\"Evelyn shows up at Jack's apartment, revealing her fears and connection to the case.\",\n",
    "                        setting=\"Jack's sparsely furnished apartment.\",\n",
    "                        key_actions=[\n",
    "                            \"Evelyn confides in Jack, revealing her ties to high society.\",\n",
    "                            \"She hints at knowing who the killer is, but fears for her life.\",\n",
    "                            \"They share a quiet moment of trust, deepening their connection.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"jack\", \"evelyn\"],\n",
    "                        location=\"Jack's apartment\",\n",
    "                        time_of_day=\"Night\",\n",
    "                        lighting=\"Low, with soft light from a nearby streetlamp.\",\n",
    "                        mood=\"Intimate and tense\",\n",
    "                        background_animation=\"Close-up, handheld shot with soft, low light from a nearby streetlamp. Subject: A sparsely furnished 1950s apartment. Subject Movement: A woman and man sit across from each other, exchanging glances as they converse quietly. Scene: Worn furniture and empty shelves add to the stark atmosphere. Atmosphere: Intimate yet tense, as vulnerability and trust mix with fear.\",\n",
    "                        background_image_prompt=\"Neo-Noir Color Pop style of a dimly lit, sparse 1950s apartment. The soft light from a nearby streetlamp filters through, casting shadows over worn furniture as two figures sit closely, deep in conversation.\",\n",
    "                        scene_image_prompt=\"\"\"Neo-Noir Color Pop style:\n",
    "Layer 1 (Background): A sparsely furnished 1950s apartment with worn furniture and bare walls, illuminated by soft light from a nearby streetlamp.\n",
    "Layer 2 (Middle ground): The dim light casts gentle shadows, adding an intimate but tense feel to the room.\n",
    "Layer 3 (Foreground): A tall, rugged man in a trench coat sits opposite a poised woman in a sleek black dress, her expression vulnerable yet guarded. Their close proximity reflects a sense of trust tempered with unease.\n",
    "Atmosphere: Intimate, shadowed, and filled with tension, capturing a rare moment of openness in a setting clouded by mistrust and fear.\"\"\",\n",
    "                        scene_image_prompt_short=\"Neo-Noir Color Pop style of a dim, sparsely furnished apartment, where two figures sit in tense conversation, illuminated by a soft streetlight.\"\n",
    "\n",
    "                    )\n",
    "                ]\n",
    "            ),\n",
    "            Act(\n",
    "                act_id=\"the_killers_web\",\n",
    "                title=\"Act 3 - The Killer's Web\",\n",
    "                scenes=[\n",
    "                    Scene(\n",
    "                        scene_id=\"secret_hideout\",\n",
    "                        title=\"The Secret Hideout\",\n",
    "                        description=\"Jack discovers a hidden office with files detailing each victim and their ties to high society.\",\n",
    "                        setting=\"An abandoned office with dusty furniture and scattered papers.\",\n",
    "                        key_actions=[\n",
    "                            \"Jack finds documents linking the victims to a powerful family.\",\n",
    "                            \"He realizes the murders are part of a larger conspiracy.\",\n",
    "                            \"A photograph falls from a file, showing Evelyn with the killer.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"jack\"],\n",
    "                        location=\"Abandoned office\",\n",
    "                        time_of_day=\"Evening\",\n",
    "                        lighting=\"Dim, with shadows adding to the mystery.\",\n",
    "                        mood=\"Revelatory and foreboding\",\n",
    "                        scene_image_prompt=\"\"\"Neo-Noir Color Pop style:\n",
    "Layer 1 (Background): A dusty, abandoned office with broken blinds, casting thin slivers of light that reveal a neglected atmosphere.\n",
    "Layer 2 (Middle ground): Scattered papers and files lie strewn across the floor and desk, some slightly yellowed with age. Shadows add a sense of mystery and concealment.\n",
    "Layer 3 (Foreground): A rugged man with a trench coat, tense and focused, examines a document closely. His face is partially illuminated, creating an expression of revelation and intrigue.\n",
    "Atmosphere: Dark and suspenseful, capturing the secrecy and hidden truths of the room.\"\"\",\n",
    "                        scene_image_prompt_short=\"Neo-Noir Color Pop style of a dusty, abandoned office where a detective examines documents under dim light.\"\n",
    "\n",
    "                    ),\n",
    "                    Scene(\n",
    "                        scene_id=\"ballroom_betrayal\",\n",
    "                        title=\"Betrayal in the Ballroom\",\n",
    "                        description=\"Jack confronts Evelyn, suspecting her complicity, only to be ambushed by the killer.\",\n",
    "                        setting=\"An opulent ballroom, now empty and shadowed.\",\n",
    "                        key_actions=[\n",
    "                            \"Jack questions Evelyn, pressing her about the photograph.\",\n",
    "                            \"Before she can respond, the killer appears, catching Jack off guard.\",\n",
    "                            \"Evelyn tries to protect Jack, revealing her true allegiance.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"jack\", \"evelyn\", \"killer\"],\n",
    "                        location=\"Ballroom\",\n",
    "                        time_of_day=\"Night\",\n",
    "                        lighting=\"Low, with dramatic shadows cast by chandeliers.\",\n",
    "                        mood=\"Suspenseful and intense\",\n",
    "                        background_animation=\"Slow zoom-in, low-angle, with hard, direct lighting casting dramatic chandelier shadows. Subject: An opulent, empty ballroom, shadows stretching across the polished floors. Subject Movement: A figure steps cautiously from the shadows, moving silently toward the center. Scene: Ornate decor and hanging chandeliers now cloaked in shadow. Atmosphere: Suspenseful and intense, as danger lurks in the dark corners of elegance.\",\n",
    "                        background_image_prompt=\"Neo-Noir Color Pop style of an opulent, shadow-filled ballroom with chandeliers casting dramatic shadows. Rich decor is cloaked in darkness, adding a sense of unease as a lone figure steps forward.\",\n",
    "                        scene_image_prompt=\"\"\"Neo-Noir Color Pop style:\n",
    "Layer 1 (Background): An opulent, empty ballroom draped in shadows, with crystal chandeliers casting dramatic, intricate patterns across the polished floor.\n",
    "Layer 2 (Middle ground): Rich, dark decor, including ornate columns and drapery, adds a sense of elegance clouded by hidden motives.\n",
    "Layer 3 (Foreground): A rugged man in a trench coat stands tense, confronting a woman in a red dress nearby, her expression conflicted. A shadowy figure lurks, ready to strike.\n",
    "Atmosphere: Elegant yet suspenseful, with tension building as hidden intentions come to light.\"\"\",\n",
    "                        scene_image_prompt_short=\"Neo-Noir Color Pop style of a shadowed ballroom, where a tense detective confronts a woman in red as danger lurks nearby.\"\n",
    "\n",
    "                    ),\n",
    "                    Scene(\n",
    "                        scene_id=\"rooftop_showdown\",\n",
    "                        title=\"Showdown on the Rooftop\",\n",
    "                        description=\"Jack and the killer face off in a final confrontation on the rooftop.\",\n",
    "                        setting=\"Rooftop with a neon-lit cityscape.\",\n",
    "                        key_actions=[\n",
    "                            \"The killer taunts Jack, revealing twisted motives for the murders.\",\n",
    "                            \"Jack confronts his own fears and past as he wrestles with the killer.\",\n",
    "                            \"After a tense struggle, Jack gains the upper hand and captures the killer.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"jack\", \"killer\"],\n",
    "                        location=\"Rooftop\",\n",
    "                        time_of_day=\"Late night\",\n",
    "                        lighting=\"Neon lights casting an eerie glow.\",\n",
    "                        mood=\"Climactic and intense\",\n",
    "                        background_animation=\"Handheld, close-up, with sweeping pan, illuminated by intense neon lighting from the skyline. Subject: A dim rooftop with city lights flickering in the distance. Subject Movement: Two figures grapple, each maneuvering against the other. Scene: Rooftop ledge overlooking a neon-lit cityscape. Atmosphere: Climax and intensity, with emotions and tension reaching a peak amid the glowing, chaotic city below.\",\n",
    "                        background_image_prompt=\"Neo-Noir Color Pop style of a gritty rooftop under neon-lit skies. The city lights cast an eerie glow, illuminating the fierce struggle between two silhouetted figures near the edge.\",\n",
    "                        scene_image_prompt=\"\"\"Neo-Noir Color Pop style:\n",
    "Layer 1 (Background): Neon-lit cityscape, with tall buildings casting fragmented, colorful lights against a moody night sky.\n",
    "Layer 2 (Middle ground): The rooftop edge shows a worn, gravel-covered surface, with faint reflections of the neon lights.\n",
    "Layer 3 (Foreground): Two figures, locked in a tense struggle, their expressions intense as they grapple near the ledge. The man's rugged face shows determination, while the shadowed figure exudes menace.\n",
    "Atmosphere: Climactic and intense, as the fight escalates under the neon-lit night, bringing the final confrontation to life.\"\"\",\n",
    "                        scene_image_prompt_short=\"Neo-Noir Color Pop style of a rooftop under neon lights, where two figures engage in a fierce struggle near the edge.\"\n",
    "\n",
    "                    )\n",
    "                ]\n",
    "            ),\n",
    "            Act(\n",
    "                act_id=\"final_revelation\",\n",
    "                title=\"Act 4 - The Final Revelation\",\n",
    "                scenes=[\n",
    "                    Scene(\n",
    "                        scene_id=\"unmasking_truth\",\n",
    "                        title=\"Unmasking the Truth\",\n",
    "                        description=\"Jack learns that the killer was manipulated by powerful figures in high society.\",\n",
    "                        setting=\"Police interrogation room.\",\n",
    "                        key_actions=[\n",
    "                            \"Jack questions the killer, uncovering the role of high-society figures in the murders.\",\n",
    "                            \"The killer admits to acting under pressure from influential people.\",\n",
    "                            \"Jack realizes justice may be out of reach as powerful figures evade responsibility.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"jack\", \"killer\"],\n",
    "                        location=\"Interrogation room\",\n",
    "                        time_of_day=\"Morning\",\n",
    "                        lighting=\"Harsh fluorescent lighting.\",\n",
    "                        mood=\"Reflective and somber\",\n",
    "                        background_animation=\"Static shot, medium close-up with harsh, direct fluorescent lighting. Subject: A stark, sterile interrogation room with a metal table and two chairs. Subject Movement: The figure on the opposite side leans forward and back subtly, reflecting emotional strain. Scene: Cold, impersonal space with flat, unyielding light that emphasizes the tense atmosphere. Atmosphere: Reflective, heavy, and solemn, underscoring the weight of exposed secrets.\",\n",
    "                        background_image_prompt=\"Neo-Noir Color Pop style of a stark, impersonal interrogation room with metal furniture and harsh fluorescent lights. The room is bare, amplifying the sense of isolation as two figures face each other in tense conversation.\",\n",
    "                        scene_image_prompt=\"\"\"Neo-Noir Color Pop style:\n",
    "Layer 1 (Background): A cold, sterile interrogation room with metal walls and fluorescent lighting casting stark, unflattering light.\n",
    "Layer 2 (Middle ground): A plain metal table stands between two chairs, with shadows adding to the sense of isolation and coldness.\n",
    "Layer 3 (Foreground): A rugged man with a weary expression sits opposite a shadowed figure, leaning in with a look of frustration and realization, emphasizing his internal conflict as he questions the figure across from him.\n",
    "Atmosphere: Reflective and somber, with the sterile setting amplifying the emotional weight of exposed secrets.\"\"\",\n",
    "                        scene_image_prompt_short=\"Neo-Noir Color Pop style of a cold interrogation room with two figures in tense conversation under harsh fluorescent light.\"\n",
    "\n",
    "                    ),\n",
    "                    Scene(\n",
    "                        scene_id=\"farewell_with_evelyn\",\n",
    "                        title=\"A Farewell with Evelyn\",\n",
    "                        description=\"Jack meets Evelyn one last time, acknowledging their complex relationship.\",\n",
    "                        setting=\"Empty jazz club in the early morning light.\",\n",
    "                        key_actions=[\n",
    "                            \"Jack and Evelyn share a bittersweet moment, acknowledging the darkness they both endured.\",\n",
    "                            \"Evelyn leaves the city, hoping to start fresh, while Jack reflects on his journey.\",\n",
    "                            \"Jack watches her walk away, knowing his work continues in a city filled with shadows.\"\n",
    "                        ],\n",
    "                        characters_involved=[\"jack\", \"evelyn\"],\n",
    "                        location=\"Jazz club\",\n",
    "                        time_of_day=\"Morning\",\n",
    "                        lighting=\"Soft, with beams of morning sunlight filtering through the windows.\",\n",
    "                        mood=\"Bittersweet and reflective\",\n",
    "                        background_animation=\"Slow zoom-out, wide shot with soft, natural morning light streaming through windows. Subject: A dimly lit, empty jazz club with scattered chairs and tables. Subject Movement: A woman walks slowly towards the door, her silhouette framed by the sunlight. Scene: Dust particles drift lazily in the soft morning light, creating an atmosphere of quiet and melancholy. Atmosphere: Bittersweet and reflective, symbolizing closure and the beginning of a new chapter.\",\n",
    "                        background_image_prompt=\"Neo-Noir Color Pop style of an empty jazz club bathed in soft morning light, with beams of sunlight filtering through the dusty air. The club feels quiet and nostalgic, as a lone figure walks slowly toward the exit.\",\n",
    "                        scene_image_prompt=\"\"\"Neo-Noir Color Pop style:\n",
    "Layer 1 (Background): Dim, empty jazz club with chairs and tables cast in soft morning light filtering through large windows, creating a nostalgic atmosphere.\n",
    "Layer 2 (Middle ground): Dust particles catch the light, floating gently in the air, adding to the sense of stillness.\n",
    "Layer 3 (Foreground): A woman in an elegant red dress walks slowly toward the door, her figure silhouetted by the warm, diffused light. Nearby, a rugged man watches her departure with a reflective gaze.\n",
    "Atmosphere: Bittersweet and reflective, capturing the moment of closure and a quiet goodbye amidst the lingering shadows.\"\"\",\n",
    "                        scene_image_prompt_short=\"Neo-Noir Color Pop style of an empty jazz club in soft morning light, with a lone woman walking towards the exit and a man watching her departure, capturing a bittersweet farewell.\"\n",
    "\n",
    "                    )\n",
    "                ]\n",
    "            )\n",
    "        ],\n",
    "\n",
    "        story_beats=[\n",
    "            StoryBeat(name=\"First Murder\", description=\"Jack finds the first cryptic clue at the scene.\", scene=\"Murder in the Alley\"),\n",
    "            StoryBeat(name=\"Encounter with Evelyn\", description=\"Jack meets Evelyn, who may have information about the murders.\", scene=\"Secrets in the Jazz Club\"),\n",
    "            StoryBeat(name=\"The Ambush\", description=\"Jack is threatened by thugs warning him off the case.\", scene=\"Cornered in the Alley\"),\n",
    "            StoryBeat(name=\"Evelyn's Confession\", description=\"Evelyn reveals her connection to the case.\", scene=\"Evelyn's Confession\"),\n",
    "            StoryBeat(name=\"Uncovering the Plot\", description=\"Jack finds evidence of a conspiracy in high society.\", scene=\"The Secret Hideout\"),\n",
    "            StoryBeat(name=\"Final Confrontation\", description=\"Jack and the killer face off on the rooftop.\", scene=\"Showdown on the Rooftop\"),\n",
    "            StoryBeat(name=\"Resolution\", description=\"Jack uncovers the truth but realizes justice is incomplete.\", scene=\"Unmasking the Truth\")\n",
    "        ],\n",
    "        subplots=[\n",
    "            Subplot(title=\"Jack's Haunted Past\", description=\"Jack confronts memories of an old, unsolved case.\", related_characters=[\"Jack Holden, the Detective\"]),\n",
    "            Subplot(title=\"Evelyn's Secrets\", description=\"Evelyn's connection to the murders unfolds, raising questions about her motives.\", related_characters=[\"Evelyn Blackwood, the Femme Fatale\"])\n",
    "        ],\n",
    "        emotional_arc=[\n",
    "            EmotionalArc(stage=\"Determination\", description=\"Jack is resolute in his pursuit of justice.\"),\n",
    "            EmotionalArc(stage=\"Doubt\", description=\"As evidence mounts, Jack begins to question whom he can trust.\"),\n",
    "            EmotionalArc(stage=\"Reflection\", description=\"Jack faces his own inner demons and unresolved trauma.\")\n",
    "        ],\n",
    "\n",
    "        conflict_type=\"Man vs. Man and Man vs. Self\",\n",
    "        themes=[\"Truth and Deception\", \"The Cost of Secrets\"],\n",
    "        motifs=[\"Dark Alleys and Shadows\", \"Red Rose as a Clue\"]\n",
    "    ),\n",
    "\n",
    "\n",
    "]\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Scene Generator\n",
    "\n",
    "from IPython.display import Markdown, display\n",
    "from model_text import display_messages\n",
    "from llama_index.core.llms import ChatMessage\n",
    "from model_text import llm\n",
    "from utils import deindent\n",
    "\n",
    "request_excludes = {\n",
    "    \"characters\": {\n",
    "        \"__all__\": {\n",
    "            \"animation_description\": True,\n",
    "            \"voice_description\": True,\n",
    "            \"internal_conflict\": True,\n",
    "            \"character_arc\": True,\n",
    "            \"voice_sample\": True,\n",
    "            \"catch_phrase\": True,\n",
    "            \"props\": True,\n",
    "            \"image_prompt\": True,\n",
    "            \"image_prompt_short\": True,\n",
    "        }\n",
    "    }, \n",
    "    \"acts\": True, \n",
    "\n",
    "    \"story_beats\": True, \n",
    "    \"subplots\":True, \n",
    "    \"emotional_arc\": True, \n",
    "    \"conflict_type\": True, \n",
    "    \"motifs\": True,\n",
    "    \"narrative_perspective\": True, \n",
    "    \"themes\": True,\n",
    "    \"props\": True,\n",
    "}\n",
    "\n",
    "response_excludes = {\n",
    "    \"characters\": True,\n",
    "    \"prompt\": True,\n",
    "    \"title\": True,\n",
    "    \"visual_style\": True,\n",
    "    \"time_period\": True,\n",
    "    \"location\": True,\n",
    "    \"genre\": True,\n",
    "    \"medium\": True,\n",
    "    \"plot_overview\": True,\n",
    "    \"props\": True,  \n",
    "    \"acts\": {\n",
    "        \"__all__\": {\n",
    "            \"scenes\": {\n",
    "                \"__all__\": {\n",
    "                    \"scene_image_prompt\": True,\n",
    "                    \"scene_image_prompt_short\": True,\n",
    "                    \"background_animation\": True,\n",
    "                    \"background_image_prompt\": True,\n",
    "                    \"dialogue\": True,\n",
    "                }\n",
    "            }\n",
    "        }\n",
    "    },\n",
    "}\n",
    "\n",
    "def generate_scenes(story: Story) -> Story:\n",
    "    system_message = deindent(\"\"\"\n",
    "        You are a creative story outliner. You will take the rough outline of a story and create the acts and scenes, following industry-standard structure for books and movies..\n",
    "        Your task is to generate a complete list of acts and scenes based on the provided story, ensuring the story has a well-paced progression with buildup, climax, and resolution.\n",
    "                              \n",
    "        **Structure Guidelines:**\n",
    "            - Follow a three-act or five-act structure, depending on the story's genre and length, to ensure a strong narrative arc:\n",
    "                - **Act 1** (Setup): Introduce characters, setting, and central conflict. Set the stakes and establish the main story question.\n",
    "                - **Act 2** (Confrontation): Build tension and develop character arcs. This act should include a midpoint shift where the stakes escalate.\n",
    "                - **Act 3** (Climax and Resolution): Lead to the story's climax, followed by a resolution that addresses the story's central question and wraps up character arcs.\n",
    "                - **Additional Acts**: For genres like Greek tragedy or epic storytelling, add Acts 4 and 5, where Act 4 intensifies the conflict and Act 5 brings a dramatic or tragic resolution.\n",
    "            \n",
    "            - Each act should contain a title and a list of scenes that progressively build upon the storyline.\n",
    "\n",
    "        Add a list of acts to the story, where each act contains a title and a list of scenes that describe the progression of the story.\n",
    "        Each scene should be an object that contains a title, description, time_of_day, location, lighting, mood, setting, key actions, and a list of characters involved.\n",
    "        Each scene needs a unique scene_id to be used as a foreign key reference.\n",
    "        Each scene should only be one location. If a scene takes place in multiple locations, split it into multiple scenes.\n",
    "        The number of scenes should reflect the genre and medium of the story. For example a greek tragedy might have 5 acts.\n",
    "        Be sure to create enough acts and scenes to cover the key moments and character arcs provided in the story.\n",
    "                              \n",
    "        - Each scene should contribute to the progression of the story, with moments that build tension, develop character motivations, or reveal critical information.\n",
    "        - Ensure the number of scenes reflects the genre and medium, with enough variety and depth to cover key story beats and character arcs.\n",
    "\n",
    "        Flesh out scenes and acts with details that enhance the narrative and build tension.\n",
    "        **Do not include camera movements.**\n",
    "        Select characters only from the provided character list by nickname all lowercase.\n",
    "        Every act must have a list of scenes which are objects.\n",
    "        Return only a valid JSON object.\n",
    "    \"\"\")\n",
    "\n",
    "    messages = [ChatMessage(role=\"system\", content=system_message)]\n",
    "    # few_shot_examples_and_blank = [blank_story] + few_shot_examples\n",
    "\n",
    "    for example in few_shot_examples[0:2]:\n",
    "        messages.append(ChatMessage(role=\"user\", content=example.model_dump_json(exclude=request_excludes)))\n",
    "        messages.append(ChatMessage(role=\"assistant\", content=example.model_dump_json(include=[\"acts\"], exclude=response_excludes)))\n",
    "\n",
    "    # Add the user input (the story prompt)\n",
    "    messages.append(ChatMessage(role=\"user\", content=story.model_dump_json(exclude=request_excludes)))\n",
    "    \n",
    "    display_messages(messages)\n",
    "\n",
    "    # Call the LLM to generate the complete story with scenes\n",
    "    response = llm_json.chat(messages, max_new_tokens=100000).message.content\n",
    "\n",
    "    # resp = llm.stream_chat(messages, max_new_tokens=10000)\n",
    "\n",
    "    # # Print it out as it comes in\n",
    "    # for r in resp:\n",
    "    #     print(r.delta, end=\"\")\n",
    "\n",
    "    # response = r.message.content\n",
    "\n",
    "    try:\n",
    "        story_with_scenes = Story.model_validate_json(response)\n",
    "        # print(\"story_with_scenes: \", story_with_scenes.model_dump_json(indent=4))\n",
    "    except:\n",
    "        print(\"Exception occurred while parsing the response.\")\n",
    "        print(response)\n",
    "        raise\n",
    "    \n",
    "    return story_with_scenes\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Quick test\n",
    "import settings\n",
    "if settings.EXECUTE_EXAMPLES:\n",
    "    display(Markdown(f\"## Quick Scene Extraction tests:\"))\n",
    "    example_story = Story(\n",
    "        prompt=\"A young hero must embark on a dangerous journey to retrieve a magical artifact hidden deep within an enchanted forest. Along the way, they encounter mythical creatures, wise mentors, and cunning adversaries.\",\n",
    "        title=\"The Enchanted Quest\",\n",
    "        genre=\"Fantasy\",\n",
    "        medium=\"Book\",\n",
    "        visual_style=\"Epic Fantasy\",\n",
    "        characters=[\n",
    "            Character(name=\"Elara\", role=\"Young Hero\", description=\"A brave and determined young hero with a strong sense of justice.\", personality=\"Courageous, resourceful, and kind-hearted.\", physical_appearance=\"Slim build, with long dark hair and piercing green eyes.\"),\n",
    "            Character(name=\"Thalion\", role=\"Wise Mentor\", description=\"An experienced and wise mentor who guides the hero through their journey.\", personality=\"Patient, knowledgeable, and protective.\", physical_appearance=\"Tall and imposing, with silver hair and a long flowing robe.\"),\n",
    "        ],\n",
    "        plot_overview=\"In a mystical kingdom threatened by chaos, a warrior from the future appears to prevent a disaster caused by a time-traveling villain. The kingdom's fate rests on ancient relics that control time, and the warrior must find them before the villain gains control. Along the way, the warrior forms an unlikely alliance with a local mage, a renegade knight, and a young thief. Together, they navigate betrayal, ancient curses, and forbidden knowledge. As the final battle approaches, the warrior must confront not only the villain but also the dark truth about their own origin.\",\n",
    "    )\n",
    "\n",
    "    # Quick test for scene generation\n",
    "    example_story_with_scenes = generate_scenes(example_story)\n",
    "    example_story = merge_models(example_story, example_story_with_scenes)\n",
    "\n",
    "    # Show the scenes as a pandas dataframe\n",
    "    for act in example_story_with_scenes.acts:\n",
    "        for scene in act.scenes:\n",
    "            scene_md = f\"### {scene.title}\\n\\n**Description:** {scene.description}\\n\\n**Setting:** {scene.setting}\\n\\n**Key Actions:**\\n\"\n",
    "            for action in scene.key_actions:\n",
    "                scene_md += f\"- {action}\\n\"\n",
    "            scene_md += \"\\n**Characters Involved:**\\n\"\n",
    "            for character in scene.characters_involved:\n",
    "                scene_md += f\"- {character}\\n\"\n",
    "            scene_md += \"\\n---\\n\\n\"\n",
    "            display(Markdown(scene_md))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Generate Scenes for our Story"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "tags": [
     "Scenes"
    ]
   },
   "outputs": [],
   "source": [
    "from IPython.display import Markdown, display\n",
    "from utils import merge_models, show_diff\n",
    "\n",
    "# Let's get characters for our global story\n",
    "scenes = generate_scenes(story_step_3)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/markdown": [
       "```diff\n",
       "--- story.json\n",
       "+++ new_story.json\n",
       "@@ -1,227 +1,388 @@\n",
       " {\n",
       "   \"prompt\": \"In a world where virtual reality gaming competitions have become the new norm, Meera, a teenage underdog gamer, discovers her life is intertwined with an alternate reality of cosmic proportions. \\nAs she learns to harness her extraordinary skills, Meera forms an unlikely team with fellow gamers she was at odds with previously.\\nFacing the harsh truth that her actions in this alternate universe directly impact events on Earth, Meera confronts the internal struggle of knowing she has taken lives. \\nEmbracing her destiny as a hero, Meera and her diverse team navigate through challenges, deception, and danger to uncover the truth behind the lies they've been told.\",\n",
       "   \"title\": \"Beyond the Pixel Veil\",\n",
       "   \"visual_style\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Dynamic Panel Layouts, Intricate Digital Patterns, and Soft Glow Effects\",\n",
       "   \"time_period\": \"Near Future/Dystopian Alternate Reality\",\n",
       "   \"location\": \"New Mumbai (Earth) / Nexus (Alternate Reality)\",\n",
       "   \"genre\": \"Science Fantasy/Young Adult Gaming Thriller\",\n",
       "   \"medium\": \"Novel with Illustrated Chapters\",\n",
       "   \"plot_overview\": \"In the immersive world of Eon, where virtual reality gaming competitions have captivated the globe, 17-year-old Meera 'Midnight' Singh is an unassuming underdog gamer from the outskirts of New Mumbai. Her life takes a drastic turn when she discovers that her exceptional gaming skills are, in fact, a conduit to an alternate reality known as the Nexus - a realm where celestial entities clash, and the fabric of space-time hangs in the balance.\\n\\nAs Meera delves deeper into the mysteries of the Nexus, she's forced to put aside past rivalries and form an uneasy alliance with her gaming nemeses: Jax 'Specter' Lee, a charismatic streaming sensation; Dr. Zhang 'Zen' Wei, a soft-spoken yet brilliant gamer with a hidden agenda; and Maya 'Rampart' Patel, a fierce and enigmatic player with unparalleled defensive skills.\\n\\nTogether, they must navigate the blurred lines between their virtual reality gaming world, Eon, and the Nexus. Meera soon confronts the devastating truth: every decision she makes in the Nexus has catastrophic consequences on Earth, including the loss of human lives. Torn between her passion for gaming and the weight of her newfound responsibility, Meera must come to terms with the moral implications of her actions.\\n\\nAs the team progresses through the treacherous landscape of the Nexus, they encounter formidable foes, ancient deities, and hidden forces manipulating the gamers from the shadows. Meera's quest for answers leads her to the Architects, enigmatic creators of Eon and the Nexus, who harbor secrets that threaten to upend everything she thought she knew about reality.\\n\\nWith the fate of two worlds hanging in the balance, Meera and her diverse team must put aside their differences, trust each other, and master their unique skills to prevent a cosmic catastrophe. Will Meera embrace her destiny as a hero, or will the pressures of her dual existence tear her apart? The journey through Eon and the Nexus is just the beginning, where the boundaries between gaming, reality, and legend are forever altered.\",\n",
       "   \"characters\": [\n",
       "     {\n",
       "       \"nickname\": \"meera\",\n",
       "       \"name\": \"Meera 'Midnight' Singh\",\n",
       "       \"description\": \"The protagonist, a teenage underdog gamer with extraordinary skills that connect her to an alternate reality.\",\n",
       "       \"personality\": \"Determined, resourceful, and initially introverted, with a growing sense of responsibility and leadership.\",\n",
       "       \"physical_appearance\": \"Petite, with short, spiky black hair, expressive brown eyes, and a collection of gaming-themed tattoos on her arms. Often wears comfortable, neon-lit gaming attire.\",\n",
       "       \"role\": \"Protagonist/Gamer\",\n",
       "       \"gender\": \"Female\",\n",
       "       \"race\": \"Indian\",\n",
       "       \"age\": \"17\",\n",
       "       \"catch_phrase\": \"Beyond the pixel veil, lies our true reality.\",\n",
       "       \"voice_description\": \"Youthful, energetic, and assertive, with a hint of vulnerability.\",\n",
       "       \"props\": [\n",
       "         \"Custom Gaming Controller\",\n",
       "         \"Neon-Lit Headset\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Jax 'Specter' Lee\",\n",
       "           \"relationship_type\": \"Unlikely Ally/Rival\"\n",
       "         },\n",
       "         {\n",
       "           \"character_name\": \"Dr. Zhang 'Zen' Wei\",\n",
       "           \"relationship_type\": \"Trusted Ally/Mentor\"\n",
       "         },\n",
       "         {\n",
       "           \"character_name\": \"Maya 'Rampart' Patel\",\n",
       "           \"relationship_type\": \"Respected Ally/Friend\"\n",
       "         }\n",
       "       ],\n",
       "       \"internal_conflict\": \"Grapples with the moral implications of her actions in the Nexus affecting Earth.\",\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Close-up of Meera 'Midnight' Singh. Petite, with short, spiky **black hair**, expressive **brown eyes**, and a collection of **neon-lit gaming-themed tattoos** on her arms. Wears comfortable, **electric blue and purple neon-lit gaming attire** with a subtle glow effect.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Meera 'Midnight' Singh, petite, spiky black hair, expressive brown eyes, neon-lit gaming tattoos, electric blue/purple gaming attire.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"jax\",\n",
       "       \"name\": \"Jax 'Specter' Lee\",\n",
       "       \"description\": \"A charismatic streaming sensation and Meera's gaming nemesis turned ally.\",\n",
       "       \"personality\": \"Confident, outgoing, and strategic, with a hidden vulnerable side.\",\n",
       "       \"physical_appearance\": \"Tall, lean, with messy blond hair, piercing blue eyes, and a charming smile. Often wears sleek, branded gaming attire.\",\n",
       "       \"role\": \"Supporting Character/Gamer\",\n",
       "       \"gender\": \"Male\",\n",
       "       \"race\": \"Korean-American\",\n",
       "       \"age\": \"19\",\n",
       "       \"catch_phrase\": \"Specter's got your back, Midnight!\",\n",
       "       \"voice_description\": \"Smooth, charismatic, and playful, with occasional hints of seriousness.\",\n",
       "       \"props\": [\n",
       "         \"Custom Branded Gaming Mouse\",\n",
       "         \"Streaming Camera\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Unlikely Ally/Rival\"\n",
       "         },\n",
       "         {\n",
       "           \"character_name\": \"Dr. Zhang 'Zen' Wei\",\n",
       "           \"relationship_type\": \"Respected Colleague\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Jax 'Sparrow' Lee in a dynamic pose. Lean, with **short, spiky brown hair**, bright **hazel eyes**, and a confident smile. Holds a **Custom Branded Gaming Mouse**; wears **dark grey and neon-green gaming gear** with a sleek, high-tech aesthetic.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Jax 'Sparrow' Lee, lean, spiky brown hair, bright hazel eyes, custom gaming mouse, dark grey/neon-green gaming gear.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"dr_zhang\",\n",
       "       \"name\": \"Dr. Zhang 'Zen' Wei\",\n",
       "       \"description\": \"A soft-spoken yet brilliant gamer with a hidden agenda, who becomes Meera's mentor.\",\n",
       "       \"personality\": \"Introspective, analytical, and enigmatic, with a deep sense of responsibility.\",\n",
       "       \"physical_appearance\": \"Slender, with short, straight black hair, wire-rimmed glasses, and an understated yet elegant sense of style.\",\n",
       "       \"role\": \"Supporting Character/Gamer/Mentor\",\n",
       "       \"gender\": \"Non-Binary\",\n",
       "       \"race\": \"Chinese\",\n",
       "       \"age\": \"Late 20s\",\n",
       "       \"catch_phrase\": \"The Nexus holds secrets; we must listen to its whispers.\",\n",
       "       \"voice_description\": \"Calm, measured, and insightful, with a hint of mystery.\",\n",
       "       \"props\": [\n",
       "         \"Custom Gaming Keyboard\",\n",
       "         \"Ancient-looking Leather Journal\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Trusted Ally/Mentor\"\n",
       "         },\n",
       "         {\n",
       "           \"character_name\": \"Jax 'Specter' Lee\",\n",
       "           \"relationship_type\": \"Respected Colleague\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Dr. Zhang 'Zen' Wei in a contemplative stance. Slender, with **short, straight black hair**, **wire-rimmed glasses**, and an understated yet elegant sense of style incorporating **subtle, glow-in-the-dark accents** on their attire.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Dr. Zhang 'Zen' Wei, slender, straight black hair, wire-rimmed glasses, subtle glow-in-the-dark fashion accents.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"maya\",\n",
       "       \"name\": \"Maya 'Rampart' Patel\",\n",
       "       \"description\": \"A fierce and enigmatic player with unparalleled defensive skills, who joins Meera's team.\",\n",
       "       \"personality\": \"Bold, fiercely independent, and guarded, with a deep sense of loyalty.\",\n",
       "       \"physical_appearance\": \"Athletic build, with long, dark hair, piercing green eyes, and intricate, glow-in-the-dark tattoos on her arms. Often wears edgy, protective gaming gear.\",\n",
       "       \"role\": \"Supporting Character/Gamer\",\n",
       "       \"gender\": \"Female\",\n",
       "       \"race\": \"Indian-American\",\n",
       "       \"age\": \"20\",\n",
       "       \"catch_phrase\": \"Rampart's got the shield; you handle the sword!\",\n",
       "       \"voice_description\": \"Confident, assertive, and slightly husky, with a hint of warmth.\",\n",
       "       \"props\": [\n",
       "         \"Custom Defensive Gaming Gauntlets\",\n",
       "         \"Glow-in-the-Dark Tattoo Designs\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Respected Ally/Friend\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Maya 'Rampart' Patel in a powerful defensive stance. Athletic build, with **long, dark hair**, piercing **green eyes**, and intricate, **glow-in-the-dark tattoos** on her arms. Wears edgy, protective **neon-lit gaming gear** emphasizing defense.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Maya 'Rampart' Patel, athletic build, long dark hair, piercing green eyes, glow-in-the-dark tattoos, neon-lit defensive gaming gear.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"architect\",\n",
       "       \"name\": \"The Architect (Erebus)\",\n",
       "       \"description\": \"An enigmatic creator of Eon and the Nexus, with secrets that threaten to upend Meera's understanding of reality.\",\n",
       "       \"personality\": \"Enigmatic, calculating, and seemingly omnipotent, with a hidden sense of purpose.\",\n",
       "       \"physical_appearance\": \"Androgynous, with an ever-shifting, glitch-art appearance, reflecting the fluidity of the digital realm.\",\n",
       "       \"role\": \"Antagonist/Creator\",\n",
       "       \"gender\": \"Non-Applicable\",\n",
       "       \"race\": \"Non-Human (AI/Entity)\",\n",
       "       \"age\": \"Ageless\",\n",
       "       \"catch_phrase\": \"Reality is a canvas; we are the brushstrokes.\",\n",
       "       \"voice_description\": \"Ethereal, androgynous, and hauntingly melodic, with an undercurrent of authority.\",\n",
       "       \"props\": [\n",
       "         \"Glitching, Reality-Bending Code\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Creator-Protagonist Dynamic\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - The Architect (Erebus) in an ethereal, glitching environment. Androgynous, with an **ever-shifting, glitch-art appearance** reflecting the fluidity of the digital realm; **pulsating neon lights** underscore their omnipotent presence.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - The Architect (Erebus), androgynous, ever-shifting glitch-art form, pulsating neon lights.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"nexus_guardian\",\n",
       "       \"name\": \"The Nexus Guardian (Astrum)\",\n",
       "       \"description\": \"An ancient, powerful entity tasked with protecting the balance of the Nexus and guiding Meera.\",\n",
       "       \"personality\": \"Wisdom-imbued, compassionate, and fiercely protective, with a deep understanding of the cosmos.\",\n",
       "       \"physical_appearance\": \"Ethereal, with an luminous, star-like appearance, embodying the celestial essence of the Nexus.\",\n",
       "       \"role\": \"Supporting Character/Guardian\",\n",
       "       \"gender\": \"Non-Applicable\",\n",
       "       \"race\": \"Non-Human (Celestial Entity)\",\n",
       "       \"age\": \"Ageless\",\n",
       "       \"catch_phrase\": \"Balance is key; harmony is our goal.\",\n",
       "       \"voice_description\": \"Soothing, melodious, and filled with ancient wisdom, conveying a sense of reassurance.\",\n",
       "       \"props\": [\n",
       "         \"Stellar Energy Manipulation\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Mentor-Protege\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - The Nexus Guardian (Astrum) amidst a celestial backdrop. Ethereal, with a **luminous, star-like appearance** embodying the celestial essence of the Nexus; **soft, ethereal glow** surrounds their form.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - The Nexus Guardian (Astrum), ethereal, luminous star-like form, soft ethereal glow.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"earth_rebel\",\n",
       "       \"name\": \"Kaito 'Sparrow' Hernandez\",\n",
       "       \"description\": \"A charismatic leader of an underground rebellion on Earth, fighting against the oppressive forces exploiting Eon.\",\n",
       "       \"personality\": \"Passionate, resourceful, and fearless, with a strong sense of justice.\",\n",
       "       \"physical_appearance\": \"Lean, with short, spiky brown hair, bright hazel eyes, and a collection of scars from past encounters. Often wears practical, makeshift rebel gear.\",\n",
       "       \"role\": \"Supporting Character/Rebel Leader\",\n",
       "       \"gender\": \"Male\",\n",
       "       \"race\": \"Latin American\",\n",
       "       \"age\": \"22\",\n",
       "       \"catch_phrase\": \"Together, we rise; together, we overcome!\",\n",
       "       \"voice_description\": \"Energetic, persuasive, and determined, with a hint of vulnerability.\",\n",
       "       \"props\": [\n",
       "         \"Customized Rebel Comms Device\",\n",
       "         \"Graffiti Tagging Gear\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Unlikely Ally\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Kaito 'Sparrow' Hernandez in a rebellious pose. Lean, with **short, spiky brown hair**, bright **hazel eyes**, and a determined expression. Wears practical, **makeshift rebel gear** with visible **graffiti tags**; holds a **Customized Rebel Comms Device**.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Kaito 'Sparrow' Hernandez, lean, spiky brown hair, bright hazel eyes, makeshift rebel gear, graffiti tags.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"corporate_exec\",\n",
       "       \"name\": \"Regina 'The Shark' Thornton\",\n",
       "       \"description\": \"A ruthless, cunning executive exploiting Eon for corporate gain, serving as a primary antagonist on Earth.\",\n",
       "       \"personality\": \"Ambitious, manipulative, and devoid of empathy, with a singular focus on profit.\",\n",
       "       \"physical_appearance\": \"Polished, with long, curly blonde hair, piercing blue eyes, and impeccable, high-end business attire.\",\n",
       "       \"role\": \"Antagonist/Corporate Executive\",\n",
       "       \"gender\": \"Female\",\n",
       "       \"race\": \"Caucasian\",\n",
       "       \"age\": \"35\",\n",
       "       \"catch_phrase\": \"In the game of power, only the strongest thrive.\",\n",
       "       \"voice_description\": \"Slick, persuasive, and menacing, with an undercurrent of superiority.\",\n",
       "       \"props\": [\n",
       "         \"Luxury Smartwatch\",\n",
       "         \"High-Security Briefcase\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Adversarial\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Regina 'The Shark' Thornton in a commanding stance. Polished, with **long, curly blonde hair**, piercing **blue eyes**, and impeccable, **high-end business attire** incorporating **subtle neon accents** symbolizing corporate power.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Regina 'The Shark' Thornton, polished, curly blonde hair, piercing blue eyes, high-end business attire with subtle neon accents.\"\n",
       "     }\n",
       "+  ],\n",
       "+  \"acts\": [\n",
       "+    {\n",
       "+      \"act_id\": \"discovery\",\n",
       "+      \"title\": \"Act 1: Beyond the Screen\",\n",
       "+      \"description\": \"Meera discovers her connection to the alternate reality of Nexus through her exceptional gaming skills.\",\n",
       "+      \"scenes\": [\n",
       "+        {\n",
       "+          \"scene_id\": \"gaming_tournament\",\n",
       "+          \"title\": \"The Underdog's Rise\",\n",
       "+          \"description\": \"Meera participates in a high-stakes Eon gaming tournament, showcasing her extraordinary skills.\",\n",
       "+          \"characters_involved\": [\n",
       "+            \"meera\"\n",
       "+          ],\n",
       "+          \"setting\": \"New Mumbai's Cyber Arena\",\n",
       "+          \"time_of_day\": \"Night\",\n",
       "+          \"location\": \"Cyber Arena\",\n",
       "+          \"lighting\": \"Vibrant, neon-lit stage lights\",\n",
       "+          \"mood\": \"Electric, competitive atmosphere\",\n",
       "+          \"props\": [\n",
       "+            \"Gaming console\",\n",
       "+            \"Headset\"\n",
       "+          ],\n",
       "+          \"key_actions\": [\n",
       "+            \"Meera's team wins a crucial match\",\n",
       "+            \"Meera experiences a strange, unexplained connection to the game\"\n",
       "+          ]\n",
       "+        },\n",
       "+        {\n",
       "+          \"scene_id\": \"nexus_awakening\",\n",
       "+          \"title\": \"Awakening to Nexus\",\n",
       "+          \"description\": \"Meera discovers she can manipulate the Nexus, an alternate reality, through her gaming skills.\",\n",
       "+          \"characters_involved\": [\n",
       "+            \"meera\",\n",
       "+            \"nexus_guardian\"\n",
       "+          ],\n",
       "+          \"setting\": \"Nexus Realm ( Celestial Landscape )\",\n",
       "+          \"time_of_day\": \"Eternal Dawn\",\n",
       "+          \"location\": \"Nexus Realm\",\n",
       "+          \"lighting\": \"Soft, ethereal glow\",\n",
       "+          \"mood\": \"Surreal, wonder-filled\",\n",
       "+          \"props\": [\n",
       "+            \"Glowing, celestial orbs\"\n",
       "+          ],\n",
       "+          \"key_actions\": [\n",
       "+            \"Meera meets the Nexus Guardian (Astrum)\",\n",
       "+            \"Meera learns about her connection to Nexus\"\n",
       "+          ]\n",
       "+        }\n",
       "+      ]\n",
       "+    },\n",
       "+    {\n",
       "+      \"act_id\": \"alliance\",\n",
       "+      \"title\": \"Act 2: Unlikely Allies\",\n",
       "+      \"description\": \"Meera forms an uneasy alliance with former gaming rivals to navigate the challenges of Nexus.\",\n",
       "+      \"scenes\": [\n",
       "+        {\n",
       "+          \"scene_id\": \"rival_encounter\",\n",
       "+          \"title\": \"Confronting Rivals\",\n",
       "+          \"description\": \"Meera encounters Jax 'Specter' Lee, Dr. Zhang 'Zen' Wei, and Maya 'Rampart' Patel at a gaming event.\",\n",
       "+          \"characters_involved\": [\n",
       "+            \"meera\",\n",
       "+            \"jax\",\n",
       "+            \"dr_zhang\",\n",
       "+            \"maya\"\n",
       "+          ],\n",
       "+          \"setting\": \"Gaming Expo (New Mumbai)\",\n",
       "+          \"time_of_day\": \"Afternoon\",\n",
       "+          \"location\": \"Gaming Expo\",\n",
       "+          \"lighting\": \"Bright, fluorescent lights\",\n",
       "+          \"mood\": \"Tense, competitive atmosphere\",\n",
       "+          \"props\": [\n",
       "+            \"Gaming posters\",\n",
       "+            \"Merchandise booths\"\n",
       "+          ],\n",
       "+          \"key_actions\": [\n",
       "+            \"Meera proposes an alliance to her former rivals\",\n",
       "+            \"The team begins to discuss their strategy for Nexus\"\n",
       "+          ]\n",
       "+        },\n",
       "+        {\n",
       "+          \"scene_id\": \"nexus_challenge\",\n",
       "+          \"title\": \"First Trial in Nexus\",\n",
       "+          \"description\": \"Meera and her new allies face their first challenge in the Nexus, testing their teamwork.\",\n",
       "+          \"characters_involved\": [\n",
       "+            \"meera\",\n",
       "+            \"jax\",\n",
       "+            \"dr_zhang\",\n",
       "+            \"maya\",\n",
       "+            \"nexus_guardian\"\n",
       "+          ],\n",
       "+          \"setting\": \"Nexus Realm (Maze of Reflections)\",\n",
       "+          \"time_of_day\": \"Eternal Dawn\",\n",
       "+          \"location\": \"Nexus Realm\",\n",
       "+          \"lighting\": \"Shifting, illusions-based lighting\",\n",
       "+          \"mood\": \"Perplexing, thrilling\",\n",
       "+          \"props\": [\n",
       "+            \"Illusory obstacles\",\n",
       "+            \"Reflection portals\"\n",
       "+          ],\n",
       "+          \"key_actions\": [\n",
       "+            \"The team navigates the Maze of Reflections\",\n",
       "+            \"Meera learns to trust her allies in Nexus\"\n",
       "+          ]\n",
       "+        }\n",
       "+      ]\n",
       "+    },\n",
       "+    {\n",
       "+      \"act_id\": \"consequences\",\n",
       "+      \"title\": \"Act 3: The Weight of Reality\",\n",
       "+      \"description\": \"Meera confronts the catastrophic consequences of her actions in Nexus on Earth.\",\n",
       "+      \"scenes\": [\n",
       "+        {\n",
       "+          \"scene_id\": \"earth_aftermath\",\n",
       "+          \"title\": \"Aftermath on Earth\",\n",
       "+          \"description\": \"Meera witnesses the devastating effects of her Nexus actions on Earth, including loss of life.\",\n",
       "+          \"characters_involved\": [\n",
       "+            \"meera\",\n",
       "+            \"earth_rebel\"\n",
       "+          ],\n",
       "+          \"setting\": \"New Mumbai (Post-Disaster Zone)\",\n",
       "+          \"time_of_day\": \"Night\",\n",
       "+          \"location\": \"Post-Disaster Zone\",\n",
       "+          \"lighting\": \"Dim, emergency lights\",\n",
       "+          \"mood\": \"Somber, reflective atmosphere\",\n",
       "+          \"props\": [\n",
       "+            \"Debris\",\n",
       "+            \"Rescue efforts\"\n",
       "+          ],\n",
       "+          \"key_actions\": [\n",
       "+            \"Meera meets Kaito 'Sparrow' Hernandez, leader of the Earth rebellion\",\n",
       "+            \"Meera grapples with the moral implications of her actions\"\n",
       "+          ]\n",
       "+        },\n",
       "+        {\n",
       "+          \"scene_id\": \"architect_encounter\",\n",
       "+          \"title\": \"Confronting the Architect\",\n",
       "+          \"description\": \"Meera and her allies confront the enigmatic Architect (Erebus), seeking answers about Nexus and Eon.\",\n",
       "+          \"characters_involved\": [\n",
       "+            \"meera\",\n",
       "+            \"jax\",\n",
       "+            \"dr_zhang\",\n",
       "+            \"maya\",\n",
       "+            \"architect\"\n",
       "+          ],\n",
       "+          \"setting\": \"Nexus Realm (The Architect's Domain)\",\n",
       "+          \"time_of_day\": \"Eternal Dawn\",\n",
       "+          \"location\": \"The Architect's Domain\",\n",
       "+          \"lighting\": \"Ever-shifting, glitch-art lighting\",\n",
       "+          \"mood\": \"Unsettling, revelatory\",\n",
       "+          \"props\": [\n",
       "+            \"Glitch-art constructs\",\n",
       "+            \"Ancient artifacts\"\n",
       "+          ],\n",
       "+          \"key_actions\": [\n",
       "+            \"The team demands answers from the Architect\",\n",
       "+            \"Meera learns the true purpose of Eon and Nexus\"\n",
       "+          ]\n",
       "+        }\n",
       "+      ]\n",
       "+    }\n",
       "   ]\n",
       " }\n",
       "```"
      ],
      "text/plain": [
       "<IPython.core.display.Markdown object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Show the diff\n",
    "story_with_scenes = merge_models(story_step_3, scenes)\n",
    "show_diff(story_step_3, story_with_scenes)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Generate Details for our Story"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Scene Detail Generator\n",
    "\n",
    "from IPython.display import Markdown, display\n",
    "from model_text import display_messages\n",
    "from llama_index.core.llms import ChatMessage\n",
    "from model_text import llm\n",
    "from utils import blank_story\n",
    "from utils import deindent\n",
    "from model import CharacterRelationship, CharacterArc, Subplot, StoryBeat\n",
    "\n",
    "# We don't want to include these when asking the model to generate the story details\n",
    "request_excludes = {\n",
    "    \"characters\": {\n",
    "        \"__all__\": {\n",
    "            \"animation_description\": True,\n",
    "            \"voice_description\": True,\n",
    "            \"internal_conflict\": True,\n",
    "            \"character_arc\": True,\n",
    "            \"voice_sample\": True,\n",
    "            \"catch_phrase\": True,\n",
    "            \"props\": True,\n",
    "            \"image_prompt\": True,\n",
    "            \"image_prompt_short\": True,\n",
    "        }\n",
    "    }, \n",
    "\n",
    "    \"acts\": {\n",
    "        \"__all__\": {\n",
    "            \"scenes\": {\n",
    "                \"__all__\": {\n",
    "                    \"scene_image_prompt\": True,\n",
    "                    \"scene_image_prompt_short\": True,\n",
    "                    \"background_animation\": True,\n",
    "                    \"background_image_prompt\": True,\n",
    "                    \"dialogue\": True,\n",
    "                }\n",
    "            }\n",
    "        }\n",
    "    },\n",
    "\n",
    "    \"story_beats\": True, \n",
    "    \"subplots\":True, \n",
    "    \"emotional_arc\": True, \n",
    "    \"conflict_type\": True, \n",
    "    \"motifs\": True,\n",
    "    \"narrative_perspective\": True, \n",
    "    \"themes\": True,\n",
    "    \"props\": True,\n",
    "\n",
    "    # background_image_prompt\n",
    "}\n",
    "\n",
    "# These are what we want back from the LLM\n",
    "response_includes = {\n",
    "    \"story_beats\": True, \n",
    "    \"subplots\":True, \n",
    "    \"emotional_arc\": True, \n",
    "    \"conflict_type\": True, \n",
    "    \"motifs\": True,\n",
    "    \"narrative_perspective\": True, \n",
    "    \"themes\": True,\n",
    "    \"props\": True, # TODO\n",
    "    \n",
    "    \"characters\": {\n",
    "        \"__all__\": {\n",
    "            \"animation_description\": True,\n",
    "            \"voice_description\": True,\n",
    "            \"internal_conflict\": True,\n",
    "            \"character_arc\": True,\n",
    "            \"voice_sample\": True,\n",
    "            \"catch_phrase\": True,\n",
    "            \"props\": True,\n",
    "            \"image_prompt\": True,\n",
    "            \"image_prompt_short\": True,\n",
    "        }\n",
    "    }, \n",
    "}\n",
    "\n",
    "def generate_story_details(story: Story) -> Story:\n",
    "    system_message = deindent(f\"\"\"\n",
    "        You are a creative story outliner. Take a list of scenes and fill out some extra global story details based on the story constructed so far.\n",
    "        Add story_beats, subplots, conflict_type, themes, motifs and narrative_perspective to enrich the story.\n",
    "                              \n",
    "        **You must output json that matches the Story model which includes the following fields:**\n",
    "        \n",
    "        story_beats is a list of objects like this:\n",
    "                              \n",
    "            [{StoryBeat().model_dump()}]\n",
    "                              \n",
    "        subplots is a list of objects like this:\n",
    "\n",
    "            [{Subplot().model_dump()}]\n",
    "                              \n",
    "        themes is a list of strings.\n",
    "        motifs is a list of strings.\n",
    "        narrative_perspective is a string.\n",
    "        conflict_type is a string.\n",
    "                              \n",
    "        Add `character_arc` to each character and update any relationships, props or other details that have been updated since the story was first outlined.\n",
    "\n",
    "        character emotional_arc is a list of objects like this:\n",
    "\n",
    "            [{CharacterArc().model_dump()}]\n",
    "\n",
    "        character relationships is a list of objects like this:\n",
    "\n",
    "            [{CharacterRelationship().model_dump()}]\n",
    "        \n",
    "        Return only a valid JSON object with the same schema as the previous examples.\n",
    "    \"\"\")\n",
    "\n",
    "    messages = [ChatMessage(role=\"system\", content=system_message)]\n",
    "    # few_shot_examples_and_blank = [blank_story] + few_shot_examples\n",
    "\n",
    "    for example in few_shot_examples:\n",
    "        messages.append(ChatMessage(role=\"user\", content=example.model_dump_json(exclude=request_excludes)))\n",
    "        messages.append(ChatMessage(role=\"assistant\", content=example.model_dump_json(include=response_includes)))\n",
    "\n",
    "    # Add the user input (the story prompt)\n",
    "    messages.append(ChatMessage(role=\"user\", content=story.model_dump_json(exclude=request_excludes)))\n",
    "    \n",
    "    # Turn on settings.DEBUG to see the messages\n",
    "    settings.DEBUG = True\n",
    "    display_messages(messages)\n",
    "\n",
    "    # Call the LLM to generate the complete story with scenes\n",
    "    response = llm_json.chat(messages, max_new_tokens=100000).message.content\n",
    "\n",
    "    try:\n",
    "        story_with_scenes = Story.model_validate_json(response)\n",
    "        # print(\"story_with_scenes: \", story_with_scenes.model_dump_json(indent=4))\n",
    "    except:\n",
    "        print(\"Exception occurred while parsing the response.\")\n",
    "        print(response)\n",
    "        raise\n",
    "    \n",
    "    return story_with_scenes\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Generate image prompts for the scenes\n",
    "from IPython.display import Markdown, display\n",
    "from utils import merge_models, show_diff\n",
    "\n",
    "story_details = generate_story_details(story_with_scenes)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/markdown": [
       "```diff\n",
       "--- story.json\n",
       "+++ new_story.json\n",
       "@@ -1,388 +1,481 @@\n",
       " {\n",
       "   \"prompt\": \"In a world where virtual reality gaming competitions have become the new norm, Meera, a teenage underdog gamer, discovers her life is intertwined with an alternate reality of cosmic proportions. \\nAs she learns to harness her extraordinary skills, Meera forms an unlikely team with fellow gamers she was at odds with previously.\\nFacing the harsh truth that her actions in this alternate universe directly impact events on Earth, Meera confronts the internal struggle of knowing she has taken lives. \\nEmbracing her destiny as a hero, Meera and her diverse team navigate through challenges, deception, and danger to uncover the truth behind the lies they've been told.\",\n",
       "   \"title\": \"Beyond the Pixel Veil\",\n",
       "   \"visual_style\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Dynamic Panel Layouts, Intricate Digital Patterns, and Soft Glow Effects\",\n",
       "   \"time_period\": \"Near Future/Dystopian Alternate Reality\",\n",
       "   \"location\": \"New Mumbai (Earth) / Nexus (Alternate Reality)\",\n",
       "   \"genre\": \"Science Fantasy/Young Adult Gaming Thriller\",\n",
       "   \"medium\": \"Novel with Illustrated Chapters\",\n",
       "   \"plot_overview\": \"In the immersive world of Eon, where virtual reality gaming competitions have captivated the globe, 17-year-old Meera 'Midnight' Singh is an unassuming underdog gamer from the outskirts of New Mumbai. Her life takes a drastic turn when she discovers that her exceptional gaming skills are, in fact, a conduit to an alternate reality known as the Nexus - a realm where celestial entities clash, and the fabric of space-time hangs in the balance.\\n\\nAs Meera delves deeper into the mysteries of the Nexus, she's forced to put aside past rivalries and form an uneasy alliance with her gaming nemeses: Jax 'Specter' Lee, a charismatic streaming sensation; Dr. Zhang 'Zen' Wei, a soft-spoken yet brilliant gamer with a hidden agenda; and Maya 'Rampart' Patel, a fierce and enigmatic player with unparalleled defensive skills.\\n\\nTogether, they must navigate the blurred lines between their virtual reality gaming world, Eon, and the Nexus. Meera soon confronts the devastating truth: every decision she makes in the Nexus has catastrophic consequences on Earth, including the loss of human lives. Torn between her passion for gaming and the weight of her newfound responsibility, Meera must come to terms with the moral implications of her actions.\\n\\nAs the team progresses through the treacherous landscape of the Nexus, they encounter formidable foes, ancient deities, and hidden forces manipulating the gamers from the shadows. Meera's quest for answers leads her to the Architects, enigmatic creators of Eon and the Nexus, who harbor secrets that threaten to upend everything she thought she knew about reality.\\n\\nWith the fate of two worlds hanging in the balance, Meera and her diverse team must put aside their differences, trust each other, and master their unique skills to prevent a cosmic catastrophe. Will Meera embrace her destiny as a hero, or will the pressures of her dual existence tear her apart? The journey through Eon and the Nexus is just the beginning, where the boundaries between gaming, reality, and legend are forever altered.\",\n",
       "+  \"narrative_perspective\": \"Third-Person Limited (primarily through Meera's perspective)\",\n",
       "+  \"conflict_type\": \"Internal & External (Meera's moral struggle vs. the challenges of Nexus and Earth)\",\n",
       "+  \"themes\": [\n",
       "+    \"The Responsibility that Comes with Power\",\n",
       "+    \"Balancing Personal Passion with Greater Good\",\n",
       "+    \"Redemption and Self-Discovery\"\n",
       "+  ],\n",
       "+  \"motifs\": [\n",
       "+    \"Gaming as a Metaphor for Life\",\n",
       "+    \"Alternate Realities and the Blurred Lines between Worlds\",\n",
       "+    \"Self-Sacrifice for the Greater Good\"\n",
       "+  ],\n",
       "   \"characters\": [\n",
       "     {\n",
       "       \"nickname\": \"meera\",\n",
       "       \"name\": \"Meera 'Midnight' Singh\",\n",
       "       \"description\": \"The protagonist, a teenage underdog gamer with extraordinary skills that connect her to an alternate reality.\",\n",
       "       \"personality\": \"Determined, resourceful, and initially introverted, with a growing sense of responsibility and leadership.\",\n",
       "       \"physical_appearance\": \"Petite, with short, spiky black hair, expressive brown eyes, and a collection of gaming-themed tattoos on her arms. Often wears comfortable, neon-lit gaming attire.\",\n",
       "       \"role\": \"Protagonist/Gamer\",\n",
       "       \"gender\": \"Female\",\n",
       "       \"race\": \"Indian\",\n",
       "       \"age\": \"17\",\n",
       "       \"catch_phrase\": \"Beyond the pixel veil, lies our true reality.\",\n",
       "       \"voice_description\": \"Youthful, energetic, and assertive, with a hint of vulnerability.\",\n",
       "       \"props\": [\n",
       "         \"Custom Gaming Controller\",\n",
       "         \"Neon-Lit Headset\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Jax 'Specter' Lee\",\n",
       "-          \"relationship_type\": \"Unlikely Ally/Rival\"\n",
       "+          \"relationship_type\": \"Unlikely Ally/Rival\",\n",
       "+          \"description\": \"From competitors to trusted allies in the Nexus\"\n",
       "         },\n",
       "         {\n",
       "           \"character_name\": \"Dr. Zhang 'Zen' Wei\",\n",
       "-          \"relationship_type\": \"Trusted Ally/Mentor\"\n",
       "+          \"relationship_type\": \"Trusted Ally/Mentor\",\n",
       "+          \"description\": \"Guiding Meera through the mysteries of Nexus\"\n",
       "         },\n",
       "         {\n",
       "           \"character_name\": \"Maya 'Rampart' Patel\",\n",
       "           \"relationship_type\": \"Respected Ally/Friend\"\n",
       "         }\n",
       "       ],\n",
       "       \"internal_conflict\": \"Grapples with the moral implications of her actions in the Nexus affecting Earth.\",\n",
       "+      \"character_arc\": {\n",
       "+        \"initial_state\": \"Introverted, uncertain teenager\",\n",
       "+        \"final_state\": \"Confident, selfless hero embracing her destiny\",\n",
       "+        \"key_moments\": [\n",
       "+          \"gaming_tournament\",\n",
       "+          \"earth_aftermath\",\n",
       "+          \"architect_encounter\"\n",
       "+        ]\n",
       "+      },\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Close-up of Meera 'Midnight' Singh. Petite, with short, spiky **black hair**, expressive **brown eyes**, and a collection of **neon-lit gaming-themed tattoos** on her arms. Wears comfortable, **electric blue and purple neon-lit gaming attire** with a subtle glow effect.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Meera 'Midnight' Singh, petite, spiky black hair, expressive brown eyes, neon-lit gaming tattoos, electric blue/purple gaming attire.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"jax\",\n",
       "       \"name\": \"Jax 'Specter' Lee\",\n",
       "       \"description\": \"A charismatic streaming sensation and Meera's gaming nemesis turned ally.\",\n",
       "       \"personality\": \"Confident, outgoing, and strategic, with a hidden vulnerable side.\",\n",
       "       \"physical_appearance\": \"Tall, lean, with messy blond hair, piercing blue eyes, and a charming smile. Often wears sleek, branded gaming attire.\",\n",
       "       \"role\": \"Supporting Character/Gamer\",\n",
       "       \"gender\": \"Male\",\n",
       "       \"race\": \"Korean-American\",\n",
       "       \"age\": \"19\",\n",
       "       \"catch_phrase\": \"Specter's got your back, Midnight!\",\n",
       "       \"voice_description\": \"Smooth, charismatic, and playful, with occasional hints of seriousness.\",\n",
       "       \"props\": [\n",
       "         \"Custom Branded Gaming Mouse\",\n",
       "         \"Streaming Camera\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Unlikely Ally/Rival\"\n",
       "         },\n",
       "         {\n",
       "           \"character_name\": \"Dr. Zhang 'Zen' Wei\",\n",
       "           \"relationship_type\": \"Respected Colleague\"\n",
       "         }\n",
       "       ],\n",
       "+      \"character_arc\": {\n",
       "+        \"initial_state\": \"Charismatic, confident streamer\",\n",
       "+        \"final_state\": \"Loyal, vulnerable ally\",\n",
       "+        \"key_moments\": [\n",
       "+          \"rival_encounter\",\n",
       "+          \"nexus_challenge\"\n",
       "+        ]\n",
       "+      },\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Jax 'Sparrow' Lee in a dynamic pose. Lean, with **short, spiky brown hair**, bright **hazel eyes**, and a confident smile. Holds a **Custom Branded Gaming Mouse**; wears **dark grey and neon-green gaming gear** with a sleek, high-tech aesthetic.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Jax 'Sparrow' Lee, lean, spiky brown hair, bright hazel eyes, custom gaming mouse, dark grey/neon-green gaming gear.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"dr_zhang\",\n",
       "       \"name\": \"Dr. Zhang 'Zen' Wei\",\n",
       "       \"description\": \"A soft-spoken yet brilliant gamer with a hidden agenda, who becomes Meera's mentor.\",\n",
       "       \"personality\": \"Introspective, analytical, and enigmatic, with a deep sense of responsibility.\",\n",
       "       \"physical_appearance\": \"Slender, with short, straight black hair, wire-rimmed glasses, and an understated yet elegant sense of style.\",\n",
       "       \"role\": \"Supporting Character/Gamer/Mentor\",\n",
       "       \"gender\": \"Non-Binary\",\n",
       "       \"race\": \"Chinese\",\n",
       "       \"age\": \"Late 20s\",\n",
       "       \"catch_phrase\": \"The Nexus holds secrets; we must listen to its whispers.\",\n",
       "       \"voice_description\": \"Calm, measured, and insightful, with a hint of mystery.\",\n",
       "       \"props\": [\n",
       "         \"Custom Gaming Keyboard\",\n",
       "         \"Ancient-looking Leather Journal\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Trusted Ally/Mentor\"\n",
       "         },\n",
       "         {\n",
       "           \"character_name\": \"Jax 'Specter' Lee\",\n",
       "           \"relationship_type\": \"Respected Colleague\"\n",
       "         }\n",
       "       ],\n",
       "+      \"character_arc\": {\n",
       "+        \"initial_state\": \"Enigmatic, soft-spoken gamer\",\n",
       "+        \"final_state\": \"Revealed as a complex, deeply responsible individual\",\n",
       "+        \"key_moments\": [\n",
       "+          \"rival_encounter\",\n",
       "+          \"architect_encounter\"\n",
       "+        ]\n",
       "+      },\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Dr. Zhang 'Zen' Wei in a contemplative stance. Slender, with **short, straight black hair**, **wire-rimmed glasses**, and an understated yet elegant sense of style incorporating **subtle, glow-in-the-dark accents** on their attire.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Dr. Zhang 'Zen' Wei, slender, straight black hair, wire-rimmed glasses, subtle glow-in-the-dark fashion accents.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"maya\",\n",
       "       \"name\": \"Maya 'Rampart' Patel\",\n",
       "       \"description\": \"A fierce and enigmatic player with unparalleled defensive skills, who joins Meera's team.\",\n",
       "       \"personality\": \"Bold, fiercely independent, and guarded, with a deep sense of loyalty.\",\n",
       "       \"physical_appearance\": \"Athletic build, with long, dark hair, piercing green eyes, and intricate, glow-in-the-dark tattoos on her arms. Often wears edgy, protective gaming gear.\",\n",
       "       \"role\": \"Supporting Character/Gamer\",\n",
       "       \"gender\": \"Female\",\n",
       "       \"race\": \"Indian-American\",\n",
       "       \"age\": \"20\",\n",
       "       \"catch_phrase\": \"Rampart's got the shield; you handle the sword!\",\n",
       "       \"voice_description\": \"Confident, assertive, and slightly husky, with a hint of warmth.\",\n",
       "       \"props\": [\n",
       "         \"Custom Defensive Gaming Gauntlets\",\n",
       "         \"Glow-in-the-Dark Tattoo Designs\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Respected Ally/Friend\"\n",
       "         }\n",
       "       ],\n",
       "+      \"character_arc\": {\n",
       "+        \"initial_state\": \"Fierce, guarded gamer\",\n",
       "+        \"final_state\": \"Loyal, open member of the team\",\n",
       "+        \"key_moments\": [\n",
       "+          \"rival_encounter\",\n",
       "+          \"nexus_challenge\"\n",
       "+        ]\n",
       "+      },\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Maya 'Rampart' Patel in a powerful defensive stance. Athletic build, with **long, dark hair**, piercing **green eyes**, and intricate, **glow-in-the-dark tattoos** on her arms. Wears edgy, protective **neon-lit gaming gear** emphasizing defense.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Maya 'Rampart' Patel, athletic build, long dark hair, piercing green eyes, glow-in-the-dark tattoos, neon-lit defensive gaming gear.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"architect\",\n",
       "       \"name\": \"The Architect (Erebus)\",\n",
       "       \"description\": \"An enigmatic creator of Eon and the Nexus, with secrets that threaten to upend Meera's understanding of reality.\",\n",
       "       \"personality\": \"Enigmatic, calculating, and seemingly omnipotent, with a hidden sense of purpose.\",\n",
       "       \"physical_appearance\": \"Androgynous, with an ever-shifting, glitch-art appearance, reflecting the fluidity of the digital realm.\",\n",
       "       \"role\": \"Antagonist/Creator\",\n",
       "       \"gender\": \"Non-Applicable\",\n",
       "       \"race\": \"Non-Human (AI/Entity)\",\n",
       "       \"age\": \"Ageless\",\n",
       "       \"catch_phrase\": \"Reality is a canvas; we are the brushstrokes.\",\n",
       "       \"voice_description\": \"Ethereal, androgynous, and hauntingly melodic, with an undercurrent of authority.\",\n",
       "       \"props\": [\n",
       "         \"Glitching, Reality-Bending Code\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Creator-Protagonist Dynamic\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - The Architect (Erebus) in an ethereal, glitching environment. Androgynous, with an **ever-shifting, glitch-art appearance** reflecting the fluidity of the digital realm; **pulsating neon lights** underscore their omnipotent presence.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - The Architect (Erebus), androgynous, ever-shifting glitch-art form, pulsating neon lights.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"nexus_guardian\",\n",
       "       \"name\": \"The Nexus Guardian (Astrum)\",\n",
       "       \"description\": \"An ancient, powerful entity tasked with protecting the balance of the Nexus and guiding Meera.\",\n",
       "       \"personality\": \"Wisdom-imbued, compassionate, and fiercely protective, with a deep understanding of the cosmos.\",\n",
       "       \"physical_appearance\": \"Ethereal, with an luminous, star-like appearance, embodying the celestial essence of the Nexus.\",\n",
       "       \"role\": \"Supporting Character/Guardian\",\n",
       "       \"gender\": \"Non-Applicable\",\n",
       "       \"race\": \"Non-Human (Celestial Entity)\",\n",
       "       \"age\": \"Ageless\",\n",
       "       \"catch_phrase\": \"Balance is key; harmony is our goal.\",\n",
       "       \"voice_description\": \"Soothing, melodious, and filled with ancient wisdom, conveying a sense of reassurance.\",\n",
       "       \"props\": [\n",
       "         \"Stellar Energy Manipulation\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Mentor-Protege\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - The Nexus Guardian (Astrum) amidst a celestial backdrop. Ethereal, with a **luminous, star-like appearance** embodying the celestial essence of the Nexus; **soft, ethereal glow** surrounds their form.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - The Nexus Guardian (Astrum), ethereal, luminous star-like form, soft ethereal glow.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"earth_rebel\",\n",
       "       \"name\": \"Kaito 'Sparrow' Hernandez\",\n",
       "       \"description\": \"A charismatic leader of an underground rebellion on Earth, fighting against the oppressive forces exploiting Eon.\",\n",
       "       \"personality\": \"Passionate, resourceful, and fearless, with a strong sense of justice.\",\n",
       "       \"physical_appearance\": \"Lean, with short, spiky brown hair, bright hazel eyes, and a collection of scars from past encounters. Often wears practical, makeshift rebel gear.\",\n",
       "       \"role\": \"Supporting Character/Rebel Leader\",\n",
       "       \"gender\": \"Male\",\n",
       "       \"race\": \"Latin American\",\n",
       "       \"age\": \"22\",\n",
       "       \"catch_phrase\": \"Together, we rise; together, we overcome!\",\n",
       "       \"voice_description\": \"Energetic, persuasive, and determined, with a hint of vulnerability.\",\n",
       "       \"props\": [\n",
       "         \"Customized Rebel Comms Device\",\n",
       "         \"Graffiti Tagging Gear\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Unlikely Ally\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Kaito 'Sparrow' Hernandez in a rebellious pose. Lean, with **short, spiky brown hair**, bright **hazel eyes**, and a determined expression. Wears practical, **makeshift rebel gear** with visible **graffiti tags**; holds a **Customized Rebel Comms Device**.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Kaito 'Sparrow' Hernandez, lean, spiky brown hair, bright hazel eyes, makeshift rebel gear, graffiti tags.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"corporate_exec\",\n",
       "       \"name\": \"Regina 'The Shark' Thornton\",\n",
       "       \"description\": \"A ruthless, cunning executive exploiting Eon for corporate gain, serving as a primary antagonist on Earth.\",\n",
       "       \"personality\": \"Ambitious, manipulative, and devoid of empathy, with a singular focus on profit.\",\n",
       "       \"physical_appearance\": \"Polished, with long, curly blonde hair, piercing blue eyes, and impeccable, high-end business attire.\",\n",
       "       \"role\": \"Antagonist/Corporate Executive\",\n",
       "       \"gender\": \"Female\",\n",
       "       \"race\": \"Caucasian\",\n",
       "       \"age\": \"35\",\n",
       "       \"catch_phrase\": \"In the game of power, only the strongest thrive.\",\n",
       "       \"voice_description\": \"Slick, persuasive, and menacing, with an undercurrent of superiority.\",\n",
       "       \"props\": [\n",
       "         \"Luxury Smartwatch\",\n",
       "         \"High-Security Briefcase\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Adversarial\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Regina 'The Shark' Thornton in a commanding stance. Polished, with **long, curly blonde hair**, piercing **blue eyes**, and impeccable, **high-end business attire** incorporating **subtle neon accents** symbolizing corporate power.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Regina 'The Shark' Thornton, polished, curly blonde hair, piercing blue eyes, high-end business attire with subtle neon accents.\"\n",
       "     }\n",
       "   ],\n",
       "+  \"story_beats\": [\n",
       "+    {\n",
       "+      \"name\": \"Inciting Incident\",\n",
       "+      \"description\": \"Meera discovers her connection to the alternate reality of Nexus through her exceptional gaming skills.\",\n",
       "+      \"scene\": \"gaming_tournament\"\n",
       "+    },\n",
       "+    {\n",
       "+      \"name\": \"Plot Point 1\",\n",
       "+      \"description\": \"Meera forms an uneasy alliance with former gaming rivals to navigate the challenges of Nexus.\",\n",
       "+      \"scene\": \"rival_encounter\"\n",
       "+    },\n",
       "+    {\n",
       "+      \"name\": \"Midpoint\",\n",
       "+      \"description\": \"Meera and her new allies face their first challenge in the Nexus, testing their teamwork.\",\n",
       "+      \"scene\": \"nexus_challenge\"\n",
       "+    },\n",
       "+    {\n",
       "+      \"name\": \"Plot Point 2\",\n",
       "+      \"description\": \"Meera witnesses the devastating effects of her Nexus actions on Earth, including loss of life.\",\n",
       "+      \"scene\": \"earth_aftermath\"\n",
       "+    },\n",
       "+    {\n",
       "+      \"name\": \"Climax\",\n",
       "+      \"description\": \"Meera and her allies confront the enigmatic Architect (Erebus), seeking answers about Nexus and Eon.\",\n",
       "+      \"scene\": \"architect_encounter\"\n",
       "+    }\n",
       "+  ],\n",
       "+  \"subplots\": [\n",
       "+    {\n",
       "+      \"title\": \"The Rebellion on Earth\",\n",
       "+      \"description\": \"Kaito 'Sparrow' Hernandez leads an underground rebellion against the oppressive forces exploiting Eon.\",\n",
       "+      \"related_characters\": [\n",
       "+        \"earth_rebel\",\n",
       "+        \"meera\",\n",
       "+        \"corporate_exec\"\n",
       "+      ]\n",
       "+    },\n",
       "+    {\n",
       "+      \"title\": \"Dr. Zhang's Hidden Agenda\",\n",
       "+      \"description\": \"Dr. Zhang 'Zen' Wei's true intentions and motivations for helping Meera are slowly revealed.\",\n",
       "+      \"related_characters\": [\n",
       "+        \"dr_zhang\",\n",
       "+        \"meera\"\n",
       "+      ]\n",
       "+    }\n",
       "+  ],\n",
       "   \"acts\": [\n",
       "     {\n",
       "       \"act_id\": \"discovery\",\n",
       "       \"title\": \"Act 1: Beyond the Screen\",\n",
       "       \"description\": \"Meera discovers her connection to the alternate reality of Nexus through her exceptional gaming skills.\",\n",
       "       \"scenes\": [\n",
       "         {\n",
       "           \"scene_id\": \"gaming_tournament\",\n",
       "           \"title\": \"The Underdog's Rise\",\n",
       "           \"description\": \"Meera participates in a high-stakes Eon gaming tournament, showcasing her extraordinary skills.\",\n",
       "           \"characters_involved\": [\n",
       "             \"meera\"\n",
       "           ],\n",
       "           \"setting\": \"New Mumbai's Cyber Arena\",\n",
       "           \"time_of_day\": \"Night\",\n",
       "           \"location\": \"Cyber Arena\",\n",
       "           \"lighting\": \"Vibrant, neon-lit stage lights\",\n",
       "           \"mood\": \"Electric, competitive atmosphere\",\n",
       "           \"props\": [\n",
       "             \"Gaming console\",\n",
       "             \"Headset\"\n",
       "           ],\n",
       "           \"key_actions\": [\n",
       "             \"Meera's team wins a crucial match\",\n",
       "             \"Meera experiences a strange, unexplained connection to the game\"\n",
       "           ]\n",
       "         },\n",
       "         {\n",
       "           \"scene_id\": \"nexus_awakening\",\n",
       "           \"title\": \"Awakening to Nexus\",\n",
       "           \"description\": \"Meera discovers she can manipulate the Nexus, an alternate reality, through her gaming skills.\",\n",
       "           \"characters_involved\": [\n",
       "             \"meera\",\n",
       "             \"nexus_guardian\"\n",
       "           ],\n",
       "           \"setting\": \"Nexus Realm ( Celestial Landscape )\",\n",
       "           \"time_of_day\": \"Eternal Dawn\",\n",
       "           \"location\": \"Nexus Realm\",\n",
       "           \"lighting\": \"Soft, ethereal glow\",\n",
       "           \"mood\": \"Surreal, wonder-filled\",\n",
       "           \"props\": [\n",
       "             \"Glowing, celestial orbs\"\n",
       "           ],\n",
       "           \"key_actions\": [\n",
       "             \"Meera meets the Nexus Guardian (Astrum)\",\n",
       "             \"Meera learns about her connection to Nexus\"\n",
       "           ]\n",
       "         }\n",
       "       ]\n",
       "     },\n",
       "     {\n",
       "       \"act_id\": \"alliance\",\n",
       "       \"title\": \"Act 2: Unlikely Allies\",\n",
       "       \"description\": \"Meera forms an uneasy alliance with former gaming rivals to navigate the challenges of Nexus.\",\n",
       "       \"scenes\": [\n",
       "         {\n",
       "           \"scene_id\": \"rival_encounter\",\n",
       "           \"title\": \"Confronting Rivals\",\n",
       "           \"description\": \"Meera encounters Jax 'Specter' Lee, Dr. Zhang 'Zen' Wei, and Maya 'Rampart' Patel at a gaming event.\",\n",
       "           \"characters_involved\": [\n",
       "             \"meera\",\n",
       "             \"jax\",\n",
       "             \"dr_zhang\",\n",
       "             \"maya\"\n",
       "           ],\n",
       "           \"setting\": \"Gaming Expo (New Mumbai)\",\n",
       "           \"time_of_day\": \"Afternoon\",\n",
       "           \"location\": \"Gaming Expo\",\n",
       "           \"lighting\": \"Bright, fluorescent lights\",\n",
       "           \"mood\": \"Tense, competitive atmosphere\",\n",
       "           \"props\": [\n",
       "             \"Gaming posters\",\n",
       "             \"Merchandise booths\"\n",
       "           ],\n",
       "           \"key_actions\": [\n",
       "             \"Meera proposes an alliance to her former rivals\",\n",
       "             \"The team begins to discuss their strategy for Nexus\"\n",
       "           ]\n",
       "         },\n",
       "         {\n",
       "           \"scene_id\": \"nexus_challenge\",\n",
       "           \"title\": \"First Trial in Nexus\",\n",
       "           \"description\": \"Meera and her new allies face their first challenge in the Nexus, testing their teamwork.\",\n",
       "           \"characters_involved\": [\n",
       "             \"meera\",\n",
       "             \"jax\",\n",
       "             \"dr_zhang\",\n",
       "             \"maya\",\n",
       "             \"nexus_guardian\"\n",
       "           ],\n",
       "           \"setting\": \"Nexus Realm (Maze of Reflections)\",\n",
       "           \"time_of_day\": \"Eternal Dawn\",\n",
       "           \"location\": \"Nexus Realm\",\n",
       "           \"lighting\": \"Shifting, illusions-based lighting\",\n",
       "           \"mood\": \"Perplexing, thrilling\",\n",
       "           \"props\": [\n",
       "             \"Illusory obstacles\",\n",
       "             \"Reflection portals\"\n",
       "           ],\n",
       "           \"key_actions\": [\n",
       "             \"The team navigates the Maze of Reflections\",\n",
       "             \"Meera learns to trust her allies in Nexus\"\n",
       "           ]\n",
       "         }\n",
       "       ]\n",
       "     },\n",
       "     {\n",
       "       \"act_id\": \"consequences\",\n",
       "       \"title\": \"Act 3: The Weight of Reality\",\n",
       "       \"description\": \"Meera confronts the catastrophic consequences of her actions in Nexus on Earth.\",\n",
       "       \"scenes\": [\n",
       "         {\n",
       "           \"scene_id\": \"earth_aftermath\",\n",
       "           \"title\": \"Aftermath on Earth\",\n",
       "           \"description\": \"Meera witnesses the devastating effects of her Nexus actions on Earth, including loss of life.\",\n",
       "           \"characters_involved\": [\n",
       "             \"meera\",\n",
       "             \"earth_rebel\"\n",
       "           ],\n",
       "           \"setting\": \"New Mumbai (Post-Disaster Zone)\",\n",
       "           \"time_of_day\": \"Night\",\n",
       "           \"location\": \"Post-Disaster Zone\",\n",
       "           \"lighting\": \"Dim, emergency lights\",\n",
       "           \"mood\": \"Somber, reflective atmosphere\",\n",
       "           \"props\": [\n",
       "             \"Debris\",\n",
       "             \"Rescue efforts\"\n",
       "           ],\n",
       "           \"key_actions\": [\n",
       "             \"Meera meets Kaito 'Sparrow' Hernandez, leader of the Earth rebellion\",\n",
       "             \"Meera grapples with the moral implications of her actions\"\n",
       "           ]\n",
       "         },\n",
       "         {\n",
       "           \"scene_id\": \"architect_encounter\",\n",
       "           \"title\": \"Confronting the Architect\",\n",
       "           \"description\": \"Meera and her allies confront the enigmatic Architect (Erebus), seeking answers about Nexus and Eon.\",\n",
       "           \"characters_involved\": [\n",
       "             \"meera\",\n",
       "             \"jax\",\n",
       "             \"dr_zhang\",\n",
       "             \"maya\",\n",
       "             \"architect\"\n",
       "           ],\n",
       "           \"setting\": \"Nexus Realm (The Architect's Domain)\",\n",
       "           \"time_of_day\": \"Eternal Dawn\",\n",
       "           \"location\": \"The Architect's Domain\",\n",
       "           \"lighting\": \"Ever-shifting, glitch-art lighting\",\n",
       "           \"mood\": \"Unsettling, revelatory\",\n",
       "           \"props\": [\n",
       "             \"Glitch-art constructs\",\n",
       "             \"Ancient artifacts\"\n",
       "           ],\n",
       "           \"key_actions\": [\n",
       "             \"The team demands answers from the Architect\",\n",
       "             \"Meera learns the true purpose of Eon and Nexus\"\n",
       "           ]\n",
       "         }\n",
       "       ]\n",
       "     }\n",
       "   ]\n",
       " }\n",
       "```"
      ],
      "text/plain": [
       "<IPython.core.display.Markdown object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Show the diff for the image prompts\n",
    "story_with_scenes_details = merge_models(story_with_scenes, story_details)\n",
    "show_diff(story_with_scenes, story_with_scenes_details)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 11,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/markdown": [
       "## Generated Story Scenes:"
      ],
      "text/plain": [
       "<IPython.core.display.Markdown object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "text/markdown": [
       "## Act 1: Beyond the Screen\n",
       "\n",
       "### The Underdog's Rise\n",
       "\n",
       "**Description:** Meera participates in a high-stakes Eon gaming tournament, showcasing her extraordinary skills.\n",
       "\n",
       "**Setting:** New Mumbai's Cyber Arena\n",
       "\n",
       "**Key Actions:**\n",
       "- Meera's team wins a crucial match\n",
       "- Meera experiences a strange, unexplained connection to the game\n",
       "\n",
       "**Characters Involved:**\n",
       "- meera\n",
       "### Awakening to Nexus\n",
       "\n",
       "**Description:** Meera discovers she can manipulate the Nexus, an alternate reality, through her gaming skills.\n",
       "\n",
       "**Setting:** Nexus Realm ( Celestial Landscape )\n",
       "\n",
       "**Key Actions:**\n",
       "- Meera meets the Nexus Guardian (Astrum)\n",
       "- Meera learns about her connection to Nexus\n",
       "\n",
       "**Characters Involved:**\n",
       "- meera\n",
       "- nexus_guardian\n",
       "\n",
       "---\n",
       "\n"
      ],
      "text/plain": [
       "<IPython.core.display.Markdown object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "text/markdown": [
       "## Act 2: Unlikely Allies\n",
       "\n",
       "### Confronting Rivals\n",
       "\n",
       "**Description:** Meera encounters Jax 'Specter' Lee, Dr. Zhang 'Zen' Wei, and Maya 'Rampart' Patel at a gaming event.\n",
       "\n",
       "**Setting:** Gaming Expo (New Mumbai)\n",
       "\n",
       "**Key Actions:**\n",
       "- Meera proposes an alliance to her former rivals\n",
       "- The team begins to discuss their strategy for Nexus\n",
       "\n",
       "**Characters Involved:**\n",
       "- meera\n",
       "- jax\n",
       "- dr_zhang\n",
       "- maya\n",
       "### First Trial in Nexus\n",
       "\n",
       "**Description:** Meera and her new allies face their first challenge in the Nexus, testing their teamwork.\n",
       "\n",
       "**Setting:** Nexus Realm (Maze of Reflections)\n",
       "\n",
       "**Key Actions:**\n",
       "- The team navigates the Maze of Reflections\n",
       "- Meera learns to trust her allies in Nexus\n",
       "\n",
       "**Characters Involved:**\n",
       "- meera\n",
       "- jax\n",
       "- dr_zhang\n",
       "- maya\n",
       "- nexus_guardian\n",
       "\n",
       "---\n",
       "\n"
      ],
      "text/plain": [
       "<IPython.core.display.Markdown object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "text/markdown": [
       "## Act 3: The Weight of Reality\n",
       "\n",
       "### Aftermath on Earth\n",
       "\n",
       "**Description:** Meera witnesses the devastating effects of her Nexus actions on Earth, including loss of life.\n",
       "\n",
       "**Setting:** New Mumbai (Post-Disaster Zone)\n",
       "\n",
       "**Key Actions:**\n",
       "- Meera meets Kaito 'Sparrow' Hernandez, leader of the Earth rebellion\n",
       "- Meera grapples with the moral implications of her actions\n",
       "\n",
       "**Characters Involved:**\n",
       "- meera\n",
       "- earth_rebel\n",
       "### Confronting the Architect\n",
       "\n",
       "**Description:** Meera and her allies confront the enigmatic Architect (Erebus), seeking answers about Nexus and Eon.\n",
       "\n",
       "**Setting:** Nexus Realm (The Architect's Domain)\n",
       "\n",
       "**Key Actions:**\n",
       "- The team demands answers from the Architect\n",
       "- Meera learns the true purpose of Eon and Nexus\n",
       "\n",
       "**Characters Involved:**\n",
       "- meera\n",
       "- jax\n",
       "- dr_zhang\n",
       "- maya\n",
       "- architect\n",
       "\n",
       "---\n",
       "\n"
      ],
      "text/plain": [
       "<IPython.core.display.Markdown object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Show the scenes that were generated in a user friendly format\n",
    "display(Markdown(f\"## Generated Story Scenes:\"))\n",
    "\n",
    "for act in story_with_scenes_details.acts:\n",
    "    scene_md = f\"## {act.title}\\n\\n\"\n",
    "    for scene in act.scenes:\n",
    "        scene_md += f\"### {scene.title}\\n\\n**Description:** {scene.description}\\n\\n**Setting:** {scene.setting}\\n\\n**Key Actions:**\\n\"\n",
    "        for action in scene.key_actions:\n",
    "            scene_md += f\"- {action}\\n\"\n",
    "        scene_md += \"\\n**Characters Involved:**\\n\"\n",
    "        for character in scene.characters_involved:\n",
    "            scene_md += f\"- {character}\\n\"\n",
    "    scene_md += \"\\n---\\n\\n\"\n",
    "    display(Markdown(scene_md))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Generate Image Prompts\n",
    "We will use a text LLM to generate prompts which will be used later to feed into an image transformer to create images."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Image Prompts\n",
    "\n",
    "# TODO: Might need to do one scene at a time if the context grows too large and only include the characters involved in the scene\n",
    "\n",
    "from IPython.display import Markdown, display\n",
    "from model_text import display_messages\n",
    "from llama_index.core.llms import ChatMessage\n",
    "from model_text import llm\n",
    "from utils import blank_story\n",
    "\n",
    "request_excludes = {\n",
    "    \"plot_overview\": True,\n",
    "    \"characters\": {\n",
    "        \"__all__\": {\n",
    "            \"character_arc\": True,\n",
    "            \"voice_sample\": True,\n",
    "            \"catch_phrase\": True,\n",
    "            \"animation_description\": True,\n",
    "            \"voice_description\": True,\n",
    "            \"props\": True,\n",
    "            \"relationships\": True,\n",
    "            \"internal_conflict\": True,\n",
    "            # \"image_prompt\": True,\n",
    "            \"image_prompt_short\": True,\n",
    "            \"character_arc\": True,\n",
    "        }\n",
    "    }, \n",
    "    \"acts\": {\n",
    "        \"__all__\": {\n",
    "            \"scenes\": {\n",
    "                \"__all__\": {\n",
    "                    \"scene_image_prompt\": True,\n",
    "                    \"scene_image_prompt_short\": True,\n",
    "                    \"background_animation\": True,\n",
    "                    \"background_image_prompt\": True,\n",
    "                    \"dialogue\": True,\n",
    "                }\n",
    "            }\n",
    "        }\n",
    "    },\n",
    "\n",
    "    \"story_beats\": True, \n",
    "    \"subplots\":True, \n",
    "    \"emotional_arc\": True, \n",
    "    \"conflict_type\": True, \n",
    "    \"motifs\": True,\n",
    "    \"narrative_perspective\": True, \n",
    "    \"themes\": True,\n",
    "    \"props\": True,\n",
    "}\n",
    "\n",
    "\n",
    "response_includes = {\n",
    "    \"acts\": {\n",
    "        \"__all__\": {\n",
    "            \"scenes\": {\n",
    "                \"__all__\": {\n",
    "                    \"title\": True,\n",
    "                    \"scene_image_prompt\": True,\n",
    "                    \"scene_image_prompt_short\": True,\n",
    "                    \"background_animation\": True,\n",
    "                    \"background_image_prompt\": True,\n",
    "                }\n",
    "            }\n",
    "        }\n",
    "    },\n",
    "}\n",
    "\n",
    "def generate_scene_image_prompts(story: Story) -> Story:\n",
    "    # TODO: foreground animation\n",
    "    system_message = (\n",
    "        \"You are an animation director. \"\n",
    "        \"Your task is to take a list of acts and scenes and generate the following attributes: background_animation, background_image_prompt, scene_image_prompt, scene_image_prompt_short .\\n\"\n",
    "        \"\\n - background_animation should describe **VISUAL** environmental movement such as fog, dust, bushes rustling, lights flickering, leaves blowing or anything else happening in the background. \"\n",
    "        \"\\n - background_image_prompt should be a description of the visual elements in the scene with no characters. \"\n",
    "        \"\\n - scene_image_prompt should be a description of the visual elements in the scene with characters in action as it pertains to the scene. \"\n",
    "        # \"\\n - scene_image_prompt_short should be a shorter version of `scene_image_prompt` that will fit into 50 words. \"\n",
    "        \"\\n\\n**Do not include camera movements.** \\n\"\n",
    "        \"Every scene_image_prompt must start with the visual style of the image, for example: 'A digital painting style with watercolor elements of ...'. \\n\"\n",
    "        \"Make sure the scene_image_prompt starts with the medium, such as painting, cartoon, 8bit, hyperrealistic photo, etc. \\n\"\n",
    "        \"The visual style of the image must match the visual_style of the story and be based on the story visual_style, time_period, location, genre and medium. \\n\"\n",
    "        \"Instead of referencing a character name in a scene, describe their physical appearance based on the character image_prompt and physical_appearance so an artist can draw it and animate it without any context. \"\n",
    "        \"`scene_image_prompt` can contain layers. \\n\"\n",
    "        \"**Do not mention character names. Just use their physical descriptions so the illustrator knows what to draw.**\\n\"\n",
    "        \"For scene_image_prompt describe each character physical appearance in detail in action. \\n\"\n",
    "        \"Return a json object with the acts and scenes with the title and the newly created attributes background_animation, background_image_prompt, scene_image_prompt, scene_image_prompt_short. \\n\"\n",
    "        \"Return the same number of acts and scenes as the input. \"\n",
    "        \"Refer to `key_actions` to determine and describe the action of the characters in the scene. \\n\"\n",
    "        \"Return only a valid JSON object. \"\n",
    "    )\n",
    "\n",
    "    messages = [ChatMessage(role=\"system\", content=system_message)]\n",
    "    # few_shot_examples_and_blank = [blank_story] + few_shot_examples\n",
    "\n",
    "    for example in few_shot_examples:\n",
    "        messages.append(ChatMessage(role=\"user\", content=example.model_dump_json(exclude=request_excludes)))\n",
    "        messages.append(ChatMessage(role=\"assistant\", content=example.model_dump_json(include=response_includes)))\n",
    "\n",
    "    # Add the user input (the story prompt)\n",
    "    messages.append(ChatMessage(role=\"user\", content=story.model_dump_json(exclude=request_excludes)))\n",
    "\n",
    "    from model_text import display_messages\n",
    "    display_messages(messages)\n",
    "\n",
    "    # Call the LLM to generate the complete story with scenes\n",
    "    response = llm_json.chat(messages, max_new_tokens=100000).message.content\n",
    "\n",
    "    # resp = llm.stream_chat(messages, max_new_tokens=10000)\n",
    "\n",
    "    # # Print it out as it comes in\n",
    "    # for r in resp:\n",
    "    #     print(r.delta, end=\"\")\n",
    "\n",
    "    # response = r.message.content\n",
    "\n",
    "    try:\n",
    "        story_with_scenes = Story.model_validate_json(response)\n",
    "        # print(\"story_with_scenes: \", story_with_scenes.model_dump_json(indent=4))\n",
    "    except:\n",
    "        print(\"Exception occurred while parsing the response.\")\n",
    "        print(response)\n",
    "        raise\n",
    "    \n",
    "    return story_with_scenes"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Generate image prompts for the scenes\n",
    "from IPython.display import Markdown, display\n",
    "from utils import merge_models, show_diff\n",
    "\n",
    "image_prompts = generate_scene_image_prompts(story_with_scenes_details)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 14,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/markdown": [
       "```diff\n",
       "--- story.json\n",
       "+++ new_story.json\n",
       "@@ -1,481 +1,505 @@\n",
       " {\n",
       "   \"prompt\": \"In a world where virtual reality gaming competitions have become the new norm, Meera, a teenage underdog gamer, discovers her life is intertwined with an alternate reality of cosmic proportions. \\nAs she learns to harness her extraordinary skills, Meera forms an unlikely team with fellow gamers she was at odds with previously.\\nFacing the harsh truth that her actions in this alternate universe directly impact events on Earth, Meera confronts the internal struggle of knowing she has taken lives. \\nEmbracing her destiny as a hero, Meera and her diverse team navigate through challenges, deception, and danger to uncover the truth behind the lies they've been told.\",\n",
       "   \"title\": \"Beyond the Pixel Veil\",\n",
       "   \"visual_style\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Dynamic Panel Layouts, Intricate Digital Patterns, and Soft Glow Effects\",\n",
       "   \"time_period\": \"Near Future/Dystopian Alternate Reality\",\n",
       "   \"location\": \"New Mumbai (Earth) / Nexus (Alternate Reality)\",\n",
       "   \"genre\": \"Science Fantasy/Young Adult Gaming Thriller\",\n",
       "   \"medium\": \"Novel with Illustrated Chapters\",\n",
       "   \"plot_overview\": \"In the immersive world of Eon, where virtual reality gaming competitions have captivated the globe, 17-year-old Meera 'Midnight' Singh is an unassuming underdog gamer from the outskirts of New Mumbai. Her life takes a drastic turn when she discovers that her exceptional gaming skills are, in fact, a conduit to an alternate reality known as the Nexus - a realm where celestial entities clash, and the fabric of space-time hangs in the balance.\\n\\nAs Meera delves deeper into the mysteries of the Nexus, she's forced to put aside past rivalries and form an uneasy alliance with her gaming nemeses: Jax 'Specter' Lee, a charismatic streaming sensation; Dr. Zhang 'Zen' Wei, a soft-spoken yet brilliant gamer with a hidden agenda; and Maya 'Rampart' Patel, a fierce and enigmatic player with unparalleled defensive skills.\\n\\nTogether, they must navigate the blurred lines between their virtual reality gaming world, Eon, and the Nexus. Meera soon confronts the devastating truth: every decision she makes in the Nexus has catastrophic consequences on Earth, including the loss of human lives. Torn between her passion for gaming and the weight of her newfound responsibility, Meera must come to terms with the moral implications of her actions.\\n\\nAs the team progresses through the treacherous landscape of the Nexus, they encounter formidable foes, ancient deities, and hidden forces manipulating the gamers from the shadows. Meera's quest for answers leads her to the Architects, enigmatic creators of Eon and the Nexus, who harbor secrets that threaten to upend everything she thought she knew about reality.\\n\\nWith the fate of two worlds hanging in the balance, Meera and her diverse team must put aside their differences, trust each other, and master their unique skills to prevent a cosmic catastrophe. Will Meera embrace her destiny as a hero, or will the pressures of her dual existence tear her apart? The journey through Eon and the Nexus is just the beginning, where the boundaries between gaming, reality, and legend are forever altered.\",\n",
       "   \"narrative_perspective\": \"Third-Person Limited (primarily through Meera's perspective)\",\n",
       "   \"conflict_type\": \"Internal & External (Meera's moral struggle vs. the challenges of Nexus and Earth)\",\n",
       "   \"themes\": [\n",
       "     \"The Responsibility that Comes with Power\",\n",
       "     \"Balancing Personal Passion with Greater Good\",\n",
       "     \"Redemption and Self-Discovery\"\n",
       "   ],\n",
       "   \"motifs\": [\n",
       "     \"Gaming as a Metaphor for Life\",\n",
       "     \"Alternate Realities and the Blurred Lines between Worlds\",\n",
       "     \"Self-Sacrifice for the Greater Good\"\n",
       "   ],\n",
       "   \"characters\": [\n",
       "     {\n",
       "       \"nickname\": \"meera\",\n",
       "       \"name\": \"Meera 'Midnight' Singh\",\n",
       "       \"description\": \"The protagonist, a teenage underdog gamer with extraordinary skills that connect her to an alternate reality.\",\n",
       "       \"personality\": \"Determined, resourceful, and initially introverted, with a growing sense of responsibility and leadership.\",\n",
       "       \"physical_appearance\": \"Petite, with short, spiky black hair, expressive brown eyes, and a collection of gaming-themed tattoos on her arms. Often wears comfortable, neon-lit gaming attire.\",\n",
       "       \"role\": \"Protagonist/Gamer\",\n",
       "       \"gender\": \"Female\",\n",
       "       \"race\": \"Indian\",\n",
       "       \"age\": \"17\",\n",
       "       \"catch_phrase\": \"Beyond the pixel veil, lies our true reality.\",\n",
       "       \"voice_description\": \"Youthful, energetic, and assertive, with a hint of vulnerability.\",\n",
       "       \"props\": [\n",
       "         \"Custom Gaming Controller\",\n",
       "         \"Neon-Lit Headset\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Jax 'Specter' Lee\",\n",
       "           \"relationship_type\": \"Unlikely Ally/Rival\",\n",
       "           \"description\": \"From competitors to trusted allies in the Nexus\"\n",
       "         },\n",
       "         {\n",
       "           \"character_name\": \"Dr. Zhang 'Zen' Wei\",\n",
       "           \"relationship_type\": \"Trusted Ally/Mentor\",\n",
       "           \"description\": \"Guiding Meera through the mysteries of Nexus\"\n",
       "         },\n",
       "         {\n",
       "           \"character_name\": \"Maya 'Rampart' Patel\",\n",
       "           \"relationship_type\": \"Respected Ally/Friend\"\n",
       "         }\n",
       "       ],\n",
       "       \"internal_conflict\": \"Grapples with the moral implications of her actions in the Nexus affecting Earth.\",\n",
       "       \"character_arc\": {\n",
       "         \"initial_state\": \"Introverted, uncertain teenager\",\n",
       "         \"final_state\": \"Confident, selfless hero embracing her destiny\",\n",
       "         \"key_moments\": [\n",
       "           \"gaming_tournament\",\n",
       "           \"earth_aftermath\",\n",
       "           \"architect_encounter\"\n",
       "         ]\n",
       "       },\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Close-up of Meera 'Midnight' Singh. Petite, with short, spiky **black hair**, expressive **brown eyes**, and a collection of **neon-lit gaming-themed tattoos** on her arms. Wears comfortable, **electric blue and purple neon-lit gaming attire** with a subtle glow effect.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Meera 'Midnight' Singh, petite, spiky black hair, expressive brown eyes, neon-lit gaming tattoos, electric blue/purple gaming attire.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"jax\",\n",
       "       \"name\": \"Jax 'Specter' Lee\",\n",
       "       \"description\": \"A charismatic streaming sensation and Meera's gaming nemesis turned ally.\",\n",
       "       \"personality\": \"Confident, outgoing, and strategic, with a hidden vulnerable side.\",\n",
       "       \"physical_appearance\": \"Tall, lean, with messy blond hair, piercing blue eyes, and a charming smile. Often wears sleek, branded gaming attire.\",\n",
       "       \"role\": \"Supporting Character/Gamer\",\n",
       "       \"gender\": \"Male\",\n",
       "       \"race\": \"Korean-American\",\n",
       "       \"age\": \"19\",\n",
       "       \"catch_phrase\": \"Specter's got your back, Midnight!\",\n",
       "       \"voice_description\": \"Smooth, charismatic, and playful, with occasional hints of seriousness.\",\n",
       "       \"props\": [\n",
       "         \"Custom Branded Gaming Mouse\",\n",
       "         \"Streaming Camera\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Unlikely Ally/Rival\"\n",
       "         },\n",
       "         {\n",
       "           \"character_name\": \"Dr. Zhang 'Zen' Wei\",\n",
       "           \"relationship_type\": \"Respected Colleague\"\n",
       "         }\n",
       "       ],\n",
       "       \"character_arc\": {\n",
       "         \"initial_state\": \"Charismatic, confident streamer\",\n",
       "         \"final_state\": \"Loyal, vulnerable ally\",\n",
       "         \"key_moments\": [\n",
       "           \"rival_encounter\",\n",
       "           \"nexus_challenge\"\n",
       "         ]\n",
       "       },\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Jax 'Sparrow' Lee in a dynamic pose. Lean, with **short, spiky brown hair**, bright **hazel eyes**, and a confident smile. Holds a **Custom Branded Gaming Mouse**; wears **dark grey and neon-green gaming gear** with a sleek, high-tech aesthetic.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Jax 'Sparrow' Lee, lean, spiky brown hair, bright hazel eyes, custom gaming mouse, dark grey/neon-green gaming gear.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"dr_zhang\",\n",
       "       \"name\": \"Dr. Zhang 'Zen' Wei\",\n",
       "       \"description\": \"A soft-spoken yet brilliant gamer with a hidden agenda, who becomes Meera's mentor.\",\n",
       "       \"personality\": \"Introspective, analytical, and enigmatic, with a deep sense of responsibility.\",\n",
       "       \"physical_appearance\": \"Slender, with short, straight black hair, wire-rimmed glasses, and an understated yet elegant sense of style.\",\n",
       "       \"role\": \"Supporting Character/Gamer/Mentor\",\n",
       "       \"gender\": \"Non-Binary\",\n",
       "       \"race\": \"Chinese\",\n",
       "       \"age\": \"Late 20s\",\n",
       "       \"catch_phrase\": \"The Nexus holds secrets; we must listen to its whispers.\",\n",
       "       \"voice_description\": \"Calm, measured, and insightful, with a hint of mystery.\",\n",
       "       \"props\": [\n",
       "         \"Custom Gaming Keyboard\",\n",
       "         \"Ancient-looking Leather Journal\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Trusted Ally/Mentor\"\n",
       "         },\n",
       "         {\n",
       "           \"character_name\": \"Jax 'Specter' Lee\",\n",
       "           \"relationship_type\": \"Respected Colleague\"\n",
       "         }\n",
       "       ],\n",
       "       \"character_arc\": {\n",
       "         \"initial_state\": \"Enigmatic, soft-spoken gamer\",\n",
       "         \"final_state\": \"Revealed as a complex, deeply responsible individual\",\n",
       "         \"key_moments\": [\n",
       "           \"rival_encounter\",\n",
       "           \"architect_encounter\"\n",
       "         ]\n",
       "       },\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Dr. Zhang 'Zen' Wei in a contemplative stance. Slender, with **short, straight black hair**, **wire-rimmed glasses**, and an understated yet elegant sense of style incorporating **subtle, glow-in-the-dark accents** on their attire.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Dr. Zhang 'Zen' Wei, slender, straight black hair, wire-rimmed glasses, subtle glow-in-the-dark fashion accents.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"maya\",\n",
       "       \"name\": \"Maya 'Rampart' Patel\",\n",
       "       \"description\": \"A fierce and enigmatic player with unparalleled defensive skills, who joins Meera's team.\",\n",
       "       \"personality\": \"Bold, fiercely independent, and guarded, with a deep sense of loyalty.\",\n",
       "       \"physical_appearance\": \"Athletic build, with long, dark hair, piercing green eyes, and intricate, glow-in-the-dark tattoos on her arms. Often wears edgy, protective gaming gear.\",\n",
       "       \"role\": \"Supporting Character/Gamer\",\n",
       "       \"gender\": \"Female\",\n",
       "       \"race\": \"Indian-American\",\n",
       "       \"age\": \"20\",\n",
       "       \"catch_phrase\": \"Rampart's got the shield; you handle the sword!\",\n",
       "       \"voice_description\": \"Confident, assertive, and slightly husky, with a hint of warmth.\",\n",
       "       \"props\": [\n",
       "         \"Custom Defensive Gaming Gauntlets\",\n",
       "         \"Glow-in-the-Dark Tattoo Designs\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Respected Ally/Friend\"\n",
       "         }\n",
       "       ],\n",
       "       \"character_arc\": {\n",
       "         \"initial_state\": \"Fierce, guarded gamer\",\n",
       "         \"final_state\": \"Loyal, open member of the team\",\n",
       "         \"key_moments\": [\n",
       "           \"rival_encounter\",\n",
       "           \"nexus_challenge\"\n",
       "         ]\n",
       "       },\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Maya 'Rampart' Patel in a powerful defensive stance. Athletic build, with **long, dark hair**, piercing **green eyes**, and intricate, **glow-in-the-dark tattoos** on her arms. Wears edgy, protective **neon-lit gaming gear** emphasizing defense.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Maya 'Rampart' Patel, athletic build, long dark hair, piercing green eyes, glow-in-the-dark tattoos, neon-lit defensive gaming gear.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"architect\",\n",
       "       \"name\": \"The Architect (Erebus)\",\n",
       "       \"description\": \"An enigmatic creator of Eon and the Nexus, with secrets that threaten to upend Meera's understanding of reality.\",\n",
       "       \"personality\": \"Enigmatic, calculating, and seemingly omnipotent, with a hidden sense of purpose.\",\n",
       "       \"physical_appearance\": \"Androgynous, with an ever-shifting, glitch-art appearance, reflecting the fluidity of the digital realm.\",\n",
       "       \"role\": \"Antagonist/Creator\",\n",
       "       \"gender\": \"Non-Applicable\",\n",
       "       \"race\": \"Non-Human (AI/Entity)\",\n",
       "       \"age\": \"Ageless\",\n",
       "       \"catch_phrase\": \"Reality is a canvas; we are the brushstrokes.\",\n",
       "       \"voice_description\": \"Ethereal, androgynous, and hauntingly melodic, with an undercurrent of authority.\",\n",
       "       \"props\": [\n",
       "         \"Glitching, Reality-Bending Code\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Creator-Protagonist Dynamic\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - The Architect (Erebus) in an ethereal, glitching environment. Androgynous, with an **ever-shifting, glitch-art appearance** reflecting the fluidity of the digital realm; **pulsating neon lights** underscore their omnipotent presence.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - The Architect (Erebus), androgynous, ever-shifting glitch-art form, pulsating neon lights.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"nexus_guardian\",\n",
       "       \"name\": \"The Nexus Guardian (Astrum)\",\n",
       "       \"description\": \"An ancient, powerful entity tasked with protecting the balance of the Nexus and guiding Meera.\",\n",
       "       \"personality\": \"Wisdom-imbued, compassionate, and fiercely protective, with a deep understanding of the cosmos.\",\n",
       "       \"physical_appearance\": \"Ethereal, with an luminous, star-like appearance, embodying the celestial essence of the Nexus.\",\n",
       "       \"role\": \"Supporting Character/Guardian\",\n",
       "       \"gender\": \"Non-Applicable\",\n",
       "       \"race\": \"Non-Human (Celestial Entity)\",\n",
       "       \"age\": \"Ageless\",\n",
       "       \"catch_phrase\": \"Balance is key; harmony is our goal.\",\n",
       "       \"voice_description\": \"Soothing, melodious, and filled with ancient wisdom, conveying a sense of reassurance.\",\n",
       "       \"props\": [\n",
       "         \"Stellar Energy Manipulation\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Mentor-Protege\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - The Nexus Guardian (Astrum) amidst a celestial backdrop. Ethereal, with a **luminous, star-like appearance** embodying the celestial essence of the Nexus; **soft, ethereal glow** surrounds their form.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - The Nexus Guardian (Astrum), ethereal, luminous star-like form, soft ethereal glow.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"earth_rebel\",\n",
       "       \"name\": \"Kaito 'Sparrow' Hernandez\",\n",
       "       \"description\": \"A charismatic leader of an underground rebellion on Earth, fighting against the oppressive forces exploiting Eon.\",\n",
       "       \"personality\": \"Passionate, resourceful, and fearless, with a strong sense of justice.\",\n",
       "       \"physical_appearance\": \"Lean, with short, spiky brown hair, bright hazel eyes, and a collection of scars from past encounters. Often wears practical, makeshift rebel gear.\",\n",
       "       \"role\": \"Supporting Character/Rebel Leader\",\n",
       "       \"gender\": \"Male\",\n",
       "       \"race\": \"Latin American\",\n",
       "       \"age\": \"22\",\n",
       "       \"catch_phrase\": \"Together, we rise; together, we overcome!\",\n",
       "       \"voice_description\": \"Energetic, persuasive, and determined, with a hint of vulnerability.\",\n",
       "       \"props\": [\n",
       "         \"Customized Rebel Comms Device\",\n",
       "         \"Graffiti Tagging Gear\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Unlikely Ally\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Kaito 'Sparrow' Hernandez in a rebellious pose. Lean, with **short, spiky brown hair**, bright **hazel eyes**, and a determined expression. Wears practical, **makeshift rebel gear** with visible **graffiti tags**; holds a **Customized Rebel Comms Device**.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Kaito 'Sparrow' Hernandez, lean, spiky brown hair, bright hazel eyes, makeshift rebel gear, graffiti tags.\"\n",
       "     },\n",
       "     {\n",
       "       \"nickname\": \"corporate_exec\",\n",
       "       \"name\": \"Regina 'The Shark' Thornton\",\n",
       "       \"description\": \"A ruthless, cunning executive exploiting Eon for corporate gain, serving as a primary antagonist on Earth.\",\n",
       "       \"personality\": \"Ambitious, manipulative, and devoid of empathy, with a singular focus on profit.\",\n",
       "       \"physical_appearance\": \"Polished, with long, curly blonde hair, piercing blue eyes, and impeccable, high-end business attire.\",\n",
       "       \"role\": \"Antagonist/Corporate Executive\",\n",
       "       \"gender\": \"Female\",\n",
       "       \"race\": \"Caucasian\",\n",
       "       \"age\": \"35\",\n",
       "       \"catch_phrase\": \"In the game of power, only the strongest thrive.\",\n",
       "       \"voice_description\": \"Slick, persuasive, and menacing, with an undercurrent of superiority.\",\n",
       "       \"props\": [\n",
       "         \"Luxury Smartwatch\",\n",
       "         \"High-Security Briefcase\"\n",
       "       ],\n",
       "       \"relationships\": [\n",
       "         {\n",
       "           \"character_name\": \"Meera 'Midnight' Singh\",\n",
       "           \"relationship_type\": \"Adversarial\"\n",
       "         }\n",
       "       ],\n",
       "       \"image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Regina 'The Shark' Thornton in a commanding stance. Polished, with **long, curly blonde hair**, piercing **blue eyes**, and impeccable, **high-end business attire** incorporating **subtle neon accents** symbolizing corporate power.\",\n",
       "       \"image_prompt_short\": \"Vibrant Cyberpunk Manga - Regina 'The Shark' Thornton, polished, curly blonde hair, piercing blue eyes, high-end business attire with subtle neon accents.\"\n",
       "     }\n",
       "   ],\n",
       "   \"story_beats\": [\n",
       "     {\n",
       "       \"name\": \"Inciting Incident\",\n",
       "       \"description\": \"Meera discovers her connection to the alternate reality of Nexus through her exceptional gaming skills.\",\n",
       "       \"scene\": \"gaming_tournament\"\n",
       "     },\n",
       "     {\n",
       "       \"name\": \"Plot Point 1\",\n",
       "       \"description\": \"Meera forms an uneasy alliance with former gaming rivals to navigate the challenges of Nexus.\",\n",
       "       \"scene\": \"rival_encounter\"\n",
       "     },\n",
       "     {\n",
       "       \"name\": \"Midpoint\",\n",
       "       \"description\": \"Meera and her new allies face their first challenge in the Nexus, testing their teamwork.\",\n",
       "       \"scene\": \"nexus_challenge\"\n",
       "     },\n",
       "     {\n",
       "       \"name\": \"Plot Point 2\",\n",
       "       \"description\": \"Meera witnesses the devastating effects of her Nexus actions on Earth, including loss of life.\",\n",
       "       \"scene\": \"earth_aftermath\"\n",
       "     },\n",
       "     {\n",
       "       \"name\": \"Climax\",\n",
       "       \"description\": \"Meera and her allies confront the enigmatic Architect (Erebus), seeking answers about Nexus and Eon.\",\n",
       "       \"scene\": \"architect_encounter\"\n",
       "     }\n",
       "   ],\n",
       "   \"subplots\": [\n",
       "     {\n",
       "       \"title\": \"The Rebellion on Earth\",\n",
       "       \"description\": \"Kaito 'Sparrow' Hernandez leads an underground rebellion against the oppressive forces exploiting Eon.\",\n",
       "       \"related_characters\": [\n",
       "         \"earth_rebel\",\n",
       "         \"meera\",\n",
       "         \"corporate_exec\"\n",
       "       ]\n",
       "     },\n",
       "     {\n",
       "       \"title\": \"Dr. Zhang's Hidden Agenda\",\n",
       "       \"description\": \"Dr. Zhang 'Zen' Wei's true intentions and motivations for helping Meera are slowly revealed.\",\n",
       "       \"related_characters\": [\n",
       "         \"dr_zhang\",\n",
       "         \"meera\"\n",
       "       ]\n",
       "     }\n",
       "   ],\n",
       "   \"acts\": [\n",
       "     {\n",
       "       \"act_id\": \"discovery\",\n",
       "       \"title\": \"Act 1: Beyond the Screen\",\n",
       "       \"description\": \"Meera discovers her connection to the alternate reality of Nexus through her exceptional gaming skills.\",\n",
       "       \"scenes\": [\n",
       "         {\n",
       "           \"scene_id\": \"gaming_tournament\",\n",
       "           \"title\": \"The Underdog's Rise\",\n",
       "           \"description\": \"Meera participates in a high-stakes Eon gaming tournament, showcasing her extraordinary skills.\",\n",
       "           \"characters_involved\": [\n",
       "             \"meera\"\n",
       "           ],\n",
       "           \"setting\": \"New Mumbai's Cyber Arena\",\n",
       "           \"time_of_day\": \"Night\",\n",
       "           \"location\": \"Cyber Arena\",\n",
       "           \"lighting\": \"Vibrant, neon-lit stage lights\",\n",
       "           \"mood\": \"Electric, competitive atmosphere\",\n",
       "           \"props\": [\n",
       "             \"Gaming console\",\n",
       "             \"Headset\"\n",
       "           ],\n",
       "           \"key_actions\": [\n",
       "             \"Meera's team wins a crucial match\",\n",
       "             \"Meera experiences a strange, unexplained connection to the game\"\n",
       "-          ]\n",
       "+          ],\n",
       "+          \"background_image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - New Mumbai's Cyber Arena at night with a massive screen displaying the Eon game, sleek gaming consoles, and a packed audience\",\n",
       "+          \"background_animation\": \"Flickering stage lights, pulsating neon floor patterns, and cheering crowd movements in the background\",\n",
       "+          \"scene_image_prompt\": \"A Vibrant, Neon-Lit Cyberpunk Manga Illustration with watercolor elements of a petite, short-spiky-black-haired, expressive-brown-eyed female (Meera) intensely gaming, surrounded by her team, all wearing electric blue and purple neon-lit attire, amidst the lively atmosphere of the Cyber Arena\",\n",
       "+          \"scene_image_prompt_short\": \"Meera gaming intensely at the Cyber Arena\"\n",
       "         },\n",
       "         {\n",
       "           \"scene_id\": \"nexus_awakening\",\n",
       "           \"title\": \"Awakening to Nexus\",\n",
       "           \"description\": \"Meera discovers she can manipulate the Nexus, an alternate reality, through her gaming skills.\",\n",
       "           \"characters_involved\": [\n",
       "             \"meera\",\n",
       "             \"nexus_guardian\"\n",
       "           ],\n",
       "           \"setting\": \"Nexus Realm ( Celestial Landscape )\",\n",
       "           \"time_of_day\": \"Eternal Dawn\",\n",
       "           \"location\": \"Nexus Realm\",\n",
       "           \"lighting\": \"Soft, ethereal glow\",\n",
       "           \"mood\": \"Surreal, wonder-filled\",\n",
       "           \"props\": [\n",
       "             \"Glowing, celestial orbs\"\n",
       "           ],\n",
       "           \"key_actions\": [\n",
       "             \"Meera meets the Nexus Guardian (Astrum)\",\n",
       "             \"Meera learns about her connection to Nexus\"\n",
       "-          ]\n",
       "+          ],\n",
       "+          \"background_image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Nexus Realm's Celestial Landscape at eternal dawn with glowing, celestial orbs floating amidst a luminous, star-filled sky\",\n",
       "+          \"background_animation\": \"Soft, ethereal glow pulsing across the celestial landscape, with gentle, swirling clouds and stars twinkling in the background\",\n",
       "+          \"scene_image_prompt\": \"A Vibrant, Neon-Lit Cyberpunk Manga Illustration with watercolor elements of a petite, short-spiky-black-haired, expressive-brown-eyed female (Meera) standing in awe, alongside an ethereal, luminous, star-like entity (Nexus Guardian), amidst the surreal, wonder-filled Nexus Realm\",\n",
       "+          \"scene_image_prompt_short\": \"Meera meets the Nexus Guardian in the celestial Nexus Realm\"\n",
       "         }\n",
       "       ]\n",
       "     },\n",
       "     {\n",
       "       \"act_id\": \"alliance\",\n",
       "       \"title\": \"Act 2: Unlikely Allies\",\n",
       "       \"description\": \"Meera forms an uneasy alliance with former gaming rivals to navigate the challenges of Nexus.\",\n",
       "       \"scenes\": [\n",
       "         {\n",
       "           \"scene_id\": \"rival_encounter\",\n",
       "           \"title\": \"Confronting Rivals\",\n",
       "           \"description\": \"Meera encounters Jax 'Specter' Lee, Dr. Zhang 'Zen' Wei, and Maya 'Rampart' Patel at a gaming event.\",\n",
       "           \"characters_involved\": [\n",
       "             \"meera\",\n",
       "             \"jax\",\n",
       "             \"dr_zhang\",\n",
       "             \"maya\"\n",
       "           ],\n",
       "           \"setting\": \"Gaming Expo (New Mumbai)\",\n",
       "           \"time_of_day\": \"Afternoon\",\n",
       "           \"location\": \"Gaming Expo\",\n",
       "           \"lighting\": \"Bright, fluorescent lights\",\n",
       "           \"mood\": \"Tense, competitive atmosphere\",\n",
       "           \"props\": [\n",
       "             \"Gaming posters\",\n",
       "             \"Merchandise booths\"\n",
       "           ],\n",
       "           \"key_actions\": [\n",
       "             \"Meera proposes an alliance to her former rivals\",\n",
       "             \"The team begins to discuss their strategy for Nexus\"\n",
       "-          ]\n",
       "+          ],\n",
       "+          \"background_image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - New Mumbai's Gaming Expo with bright fluorescent lights, various gaming stations, and a crowd of gamers and attendees\",\n",
       "+          \"background_animation\": \"People walking, gaming posters fluttering, and merchandise booths' neon lights blinking in the background\",\n",
       "+          \"scene_image_prompt\": \"A Vibrant, Neon-Lit Cyberpunk Manga Illustration with watercolor elements of a petite, short-spiky-black-haired, expressive-brown-eyed female (Meera) standing confidently, approaching a tall, lean, messy-blond-haired, piercing-blue-eyed male (Jax), a slender, short-straight-black-haired, wire-rimmed-glasses-wearing non-binary individual (Dr. Zhang), and an athletic, long-dark-haired, piercing-green-eyed female (Maya), all in the midst of the Gaming Expo's tense atmosphere\",\n",
       "+          \"scene_image_prompt_short\": \"Meera proposes an alliance to her former rivals at the Gaming Expo\"\n",
       "         },\n",
       "         {\n",
       "           \"scene_id\": \"nexus_challenge\",\n",
       "           \"title\": \"First Trial in Nexus\",\n",
       "           \"description\": \"Meera and her new allies face their first challenge in the Nexus, testing their teamwork.\",\n",
       "           \"characters_involved\": [\n",
       "             \"meera\",\n",
       "             \"jax\",\n",
       "             \"dr_zhang\",\n",
       "             \"maya\",\n",
       "             \"nexus_guardian\"\n",
       "           ],\n",
       "           \"setting\": \"Nexus Realm (Maze of Reflections)\",\n",
       "           \"time_of_day\": \"Eternal Dawn\",\n",
       "           \"location\": \"Nexus Realm\",\n",
       "           \"lighting\": \"Shifting, illusions-based lighting\",\n",
       "           \"mood\": \"Perplexing, thrilling\",\n",
       "           \"props\": [\n",
       "             \"Illusory obstacles\",\n",
       "             \"Reflection portals\"\n",
       "           ],\n",
       "           \"key_actions\": [\n",
       "             \"The team navigates the Maze of Reflections\",\n",
       "             \"Meera learns to trust her allies in Nexus\"\n",
       "-          ]\n",
       "+          ],\n",
       "+          \"background_image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Nexus Realm's Maze of Reflections with shifting, illusions-based lighting, illusory obstacles, and reflection portals\",\n",
       "+          \"background_animation\": \"Shifting illusions, reflections rippling, and maze walls glowing with a soft, pulsing light in the background\",\n",
       "+          \"scene_image_prompt\": \"A Vibrant, Neon-Lit Cyberpunk Manga Illustration with watercolor elements of a petite, short-spiky-black-haired, expressive-brown-eyed female (Meera), a tall, lean, messy-blond-haired, piercing-blue-eyed male (Jax), a slender, short-straight-black-haired, wire-rimmed-glasses-wearing non-binary individual (Dr. Zhang), and an athletic, long-dark-haired, piercing-green-eyed female (Maya), all working together, navigating the perplexing Maze of Reflections alongside an ethereal, luminous, star-like entity (Nexus Guardian)\",\n",
       "+          \"scene_image_prompt_short\": \"Meera and allies navigate the Maze of Reflections in Nexus\"\n",
       "         }\n",
       "       ]\n",
       "     },\n",
       "     {\n",
       "       \"act_id\": \"consequences\",\n",
       "       \"title\": \"Act 3: The Weight of Reality\",\n",
       "       \"description\": \"Meera confronts the catastrophic consequences of her actions in Nexus on Earth.\",\n",
       "       \"scenes\": [\n",
       "         {\n",
       "           \"scene_id\": \"earth_aftermath\",\n",
       "           \"title\": \"Aftermath on Earth\",\n",
       "           \"description\": \"Meera witnesses the devastating effects of her Nexus actions on Earth, including loss of life.\",\n",
       "           \"characters_involved\": [\n",
       "             \"meera\",\n",
       "             \"earth_rebel\"\n",
       "           ],\n",
       "           \"setting\": \"New Mumbai (Post-Disaster Zone)\",\n",
       "           \"time_of_day\": \"Night\",\n",
       "           \"location\": \"Post-Disaster Zone\",\n",
       "           \"lighting\": \"Dim, emergency lights\",\n",
       "           \"mood\": \"Somber, reflective atmosphere\",\n",
       "           \"props\": [\n",
       "             \"Debris\",\n",
       "             \"Rescue efforts\"\n",
       "           ],\n",
       "           \"key_actions\": [\n",
       "             \"Meera meets Kaito 'Sparrow' Hernandez, leader of the Earth rebellion\",\n",
       "             \"Meera grapples with the moral implications of her actions\"\n",
       "-          ]\n",
       "+          ],\n",
       "+          \"background_image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - New Mumbai's Post-Disaster Zone at night with dim emergency lights, debris-filled streets, and rescue efforts underway\",\n",
       "+          \"background_animation\": \"Rescue lights flashing, debris being cleared, and somber faces in the background\",\n",
       "+          \"scene_image_prompt\": \"A Vibrant, Neon-Lit Cyberpunk Manga Illustration with watercolor elements of a petite, short-spiky-black-haired, expressive-brown-eyed female (Meera) standing amidst the devastation, meeting a determined, short-spiked-hair, strong-jawed male (Kaito), leader of the Earth rebellion, in the somber, reflective atmosphere of the Post-Disaster Zone\",\n",
       "+          \"scene_image_prompt_short\": \"Meera witnesses the aftermath on Earth and meets Kaito\"\n",
       "         },\n",
       "         {\n",
       "           \"scene_id\": \"architect_encounter\",\n",
       "           \"title\": \"Confronting the Architect\",\n",
       "           \"description\": \"Meera and her allies confront the enigmatic Architect (Erebus), seeking answers about Nexus and Eon.\",\n",
       "           \"characters_involved\": [\n",
       "             \"meera\",\n",
       "             \"jax\",\n",
       "             \"dr_zhang\",\n",
       "             \"maya\",\n",
       "             \"architect\"\n",
       "           ],\n",
       "           \"setting\": \"Nexus Realm (The Architect's Domain)\",\n",
       "           \"time_of_day\": \"Eternal Dawn\",\n",
       "           \"location\": \"The Architect's Domain\",\n",
       "           \"lighting\": \"Ever-shifting, glitch-art lighting\",\n",
       "           \"mood\": \"Unsettling, revelatory\",\n",
       "           \"props\": [\n",
       "             \"Glitch-art constructs\",\n",
       "             \"Ancient artifacts\"\n",
       "           ],\n",
       "           \"key_actions\": [\n",
       "             \"The team demands answers from the Architect\",\n",
       "             \"Meera learns the true purpose of Eon and Nexus\"\n",
       "-          ]\n",
       "+          ],\n",
       "+          \"background_image_prompt\": \"Vibrant, Neon-Lit Cyberpunk Manga Illustration - Nexus Realm's The Architect's Domain with ever-shifting, glitch-art lighting, and ancient, mysterious artifacts\",\n",
       "+          \"background_animation\": \"Ever-shifting glitch-art constructs, ancient artifacts glowing, and an unsettling ambiance in the background\",\n",
       "+          \"scene_image_prompt\": \"A Vibrant, Neon-Lit Cyberpunk Manga Illustration with watercolor elements of a petite, short-spiky-black-haired, expressive-brown-eyed female (Meera), a tall, lean, messy-blond-haired, piercing-blue-eyed male (Jax), a slender, short-straight-black-haired, wire-rimmed-glasses-wearing non-binary individual (Dr. Zhang), and an athletic, long-dark-haired, piercing-green-eyed female (Maya), all confronting an enigmatic, glitch-art entity (The Architect) amidst the unsettling atmosphere of The Architect's Domain\",\n",
       "+          \"scene_image_prompt_short\": \"Meera and allies confront the Architect in Nexus\"\n",
       "         }\n",
       "       ]\n",
       "     }\n",
       "   ]\n",
       " }\n",
       "```"
      ],
      "text/plain": [
       "<IPython.core.display.Markdown object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Show the diff for the image prompts\n",
    "story_with_image_prompts = merge_models(story_with_scenes_details, image_prompts)\n",
    "show_diff(story_with_scenes_details, story_with_image_prompts)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Save the Story\n",
    "Let's keep our progress so far."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {},
   "outputs": [],
   "source": [
    "story_with_image_prompts.save_to_directory(settings.STORY_DIR + \"/step_4\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Next Step\n",
    "Onto [Step 5: Character Images](./5_character_images.ipynb)"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "plotomatic",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.12.7"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}