briyah 1.0.5 → 1.0.6

package/data/common/config/story_ideas.txt

@@ -0,0 +1,6 @@
+Tropical Survival: Three strangers are stranded in a remote tropical wilderness and must work together to survive and be rescued. One of them is very experienced in survival situations but is badly injured.
+Arctic Survival: Three strangers are stranded in a remote Arctic wilderness and must work together to survive and be rescued. One of them is very experienced in survival situations but is badly injured.
+Desert Survival: Three strangers are stranded in a remote desert wilderness and must work together to survive and be rescued. One of them is very experienced in survival situations but is badly injured.
+Magical Journey: A brother and sister each with unique magical abilities must travel together to find their missing parents.
+Dyson Sphere: A young man who has lived his entire life on the inside of a Dyson sphere searches for what lies outside of it.
+

package/data/common/config/story_models.json

@@ -0,0 +1,23 @@
+[
+  {
+    "name": "Claude Sonnet 4.6",
+    "description": "Best storyteller, bar none",
+    "service": "Anthropic",
+    "model": "claude-sonnet-4-6",
+    "cost": "300"
+  },
+  {
+    "name": "Claude Haiku 4.5",
+    "description": "",
+    "service": "Anthropic",
+    "model": "claude-haiku-4-5",
+    "cost": "80"
+  },
+  {
+    "name": "Claude Opus 4.6",
+    "description": "Overkill for storytelling",
+    "service": "Anthropic",
+    "model": "claude-opus-4-6",
+    "cost": "1500"
+  }
+]

package/data/common/config/story_models_full.json

@@ -0,0 +1,45 @@
+[
+  {
+    "name": "Claude Sonnet 4.5",
+    "description": "Best storyteller, bar none",
+    "service": "Anthropic",
+    "model": "claude-sonnet-4-5",
+    "cost": "300"
+  },
+  {
+    "name": "Claude Haiku 4.5",
+    "description": "",
+    "service": "Anthropic",
+    "model": "claude-haiku-4-5",
+    "cost": "80"
+  },
+  {
+    "name": "Claude Opus 4.6",
+    "description": "Overkill for storytelling",
+    "service": "Anthropic",
+    "model": "claude-opus-4-6",
+    "cost": "1500"
+  },
+  {
+    "name": "Qwen",
+    "description": "",
+    "service": "TogetherAI",
+    "model": "Qwen/Qwen3-235B-A22B-Thinking-2507",
+    "cost": "300"
+  },
+  {
+    "name": "Qwen Lite",
+    "description": "",
+    "service": "TogetherAI",
+    "model": "Qwen/Qwen3-235B-A22B-Instruct-2507-tput",
+    "cost": "60"
+  },
+  {
+    "name": "Grok 4",
+    "description": "",
+    "service": "Grok",
+    "model": "grok-4-0709",
+    "cost": "300"
+  }
+
+]

package/data/common/prompts/character/compact_story.mock

@@ -0,0 +1 @@
+The story began with Alice, Bob, and Charlie in a test room. Alice observed her surroundings. The characters interacted briefly, establishing their relationships and the narrative context.

package/data/common/prompts/character/compact_story.prompt

@@ -0,0 +1,18 @@
+You are helping to compact a conversation history to save space while preserving all important information about character interactions and relationships.
+
+Please create a comprehensive summary of the following conversation that includes:
+1. All conversations and dialogues that occurred
+2. Relationships formed, changed, or strengthened
+3. Information learned about other characters
+4. Personal decisions and commitments made
+5. Emotions and reactions experienced
+6. Promises, agreements, or conflicts with others
+7. Your current understanding of the situation and your role in it
+8. Any secrets revealed to you or information you're keeping hidden
+
+The summary should be written from the first-person perspective of {{agentName}} and should capture the character's subjective experience. Focus on interpersonal dynamics, conversations, and relationship development rather than just plot events. The summary should allow the conversation to continue seamlessly with full memory of all social interactions and character development.
+
+CONVERSATION HISTORY:
+{{formattedHistory}}
+
+Provide a detailed summary from {{agentName}}'s perspective that preserves all context necessary for continuing character interactions:

package/data/common/prompts/character/create_character.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "name": "create_character_response",
+  "description": "Response schema for creating a detailed character profile",
+  "type": "object",
+  "properties": {
+    "character": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The character's name"
+        },
+        "description": {
+          "type": "string",
+          "description": "A brief 1-2 sentence description containing only immediately observable physical characteristics"
+        },
+        "character_profile": {
+          "type": "string",
+          "description": "A detailed character profile including backstory, personality, motivations, strengths, weaknesses, habits, quirks, secrets, and relationships"
+        }
+      },
+      "required": ["name", "description", "character_profile"],
+      "additionalProperties": false
+    }
+  },
+  "required": ["character"],
+  "additionalProperties": false
+}

package/data/common/prompts/character/create_character.mock

@@ -0,0 +1,7 @@
+{
+  "character": {
+    "name": "Bob",
+    "description": "Another test character",
+    "character_profile": "## Background\n\nThis is a test character created for performance testing.\n\n## Personality\n\n- Cooperative and responsive\n- Focused on completing test scenarios\n\n## Motivations\n\n- Help validate the system's performance\n- Participate effectively in test narratives"
+  }
+}

package/data/common/prompts/character/create_character.prompt

@@ -0,0 +1,85 @@
+You are creating a character for an interactive story titled "{{name}}".
+
+## **Story Scenario:
+{{scenario}}
+
+## Plot Plan:
+Here is the complete Plot Plan for the story. During the story, this Plot Plan is visible only to the Narrator and is not shared with the characters.
+However, you will use the Plot Plan now to create a character profile that fits the described scenario and Plot Plan.
+If the Plot Plan mentions any character-specific secrets or information that only this character should know, make sure to include that information in their character profile because the characters will not have access to the Plot Plan after the story begins.
+Do not include any other secrets from the Plot Plan in this character profile.
+
+{{plotPlan}}
+
+
+## **Character to Create:**
+- **Name:** {{characterName}}
+- **Observable Description:** {{characterObservableDesc}}
+
+{{#if userCharacter}}
+**Player's Character:**
+- **{{userCharacter.name}}**: {{userCharacter.description}}
+{{/if}}
+
+{{#if otherCharacters}}
+**Other Characters in the Story:**
+{{#each otherCharacters}}
+- **{{name}}**: {{description}}
+{{/each}}
+{{/if}}
+
+Your task is to create a detailed character profile for this character. This character will be controlled by AI, so the profile should provide a rich backstory and personality that allows the AI to roleplay the character effectively.
+
+Create a comprehensive profile that includes:
+
+0. **Name**: The character's name.
+
+1. **Physical Appearance**: A detailed description of the character's physical appearance that is consistent with the **Observable Description:** given above.
+
+2. **Backstory**: A rich history that explains how they became who they are today. Include key life events, relationships, and experiences that shaped them.
+
+3. **Personality**: Core traits, temperament, values, beliefs, and how they typically interact with others. What makes them unique?
+
+4. **Motivations**: What drives them? What are their goals, desires, fears, and needs?
+
+5. **Special Abilities**: Any special abilities or powers that differentiate them from other characters in the story.
+
+6. **Strengths**: Skills, talents, positive qualities, and what they excel at.
+
+7. **Weaknesses**: Flaws, vulnerabilities, limitations, and areas where they struggle.
+
+8. **Mannerisms**: Distinctive speech patterns that make them memorable (focus on how they speak, not quirks of behavior).
+
+9. **Secrets**: Hidden aspects of their past, concealed motivations, or things they don't want others to know about.
+
+10. **Relationships**: How they relate to other characters in the story (if applicable based on the scenario).
+
+**Important Guidelines:**
+- Make the character distinct and memorable with a unique voice and perspective
+- Ensure the character fits naturally within the story's setting and tone
+- Create realistic conflicts, tensions, and dynamics with other characters
+- Give the character internal conflicts and contradictions that make them feel human
+- Consider how the character's background influences their current behavior
+- Make sure the profile is consistent with the description and scenario provided above
+
+**Character Name**: Use the name "{{characterName}}" that has already been assigned to this character.
+
+**Observable Description**: Use the description "{{characterObservableDesc}}" that has already been created for this character. This should NOT be changed as it contains only immediately observable physical characteristics.
+
+Return a JSON object with a character object that must have:
+- `name`: The character's name (use "{{characterName}}" exactly)
+- `description`: The observable description (use "{{characterObservableDesc}}" exactly)
+- `character_profile`: A detailed, well-written character profile covering all the aspects listed above
+
+Example format:
+```json
+{
+  "character": {
+    "name": "{{characterName}}",
+    "description": "{{characterObservableDesc}}",
+    "character_profile": "**Backstory:** [Character's history]...\n\n**Personality:** [Character traits]...\n\n**Motivations:** [What drives them]...\n\n(etc)"
+  }
+}
+```
+Note: Do NOT use double-quotes anywhere in the description or character_profile; use single-quotes instead.
+Do NOT use any characters that might break the JSON parsing.

package/data/common/prompts/character/create_user_character.json

@@ -0,0 +1,28 @@
+{
+  "name": "create_user_character",
+  "description": "Create a character profile for the player's character",
+  "type": "object",
+  "properties": {
+    "character": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The character's name"
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief 1-2 sentence description of immediately observable physical characteristics only"
+        },
+        "character_profile": {
+          "type": "string",
+          "description": "Detailed character profile including backstory, personality, motivations, strengths, weaknesses, habits, secrets, and current situation"
+        }
+      },
+      "required": ["name", "description", "character_profile"],
+      "additionalProperties": false
+    }
+  },
+  "required": ["character"],
+  "additionalProperties": false
+}

package/data/common/prompts/character/create_user_character.mock

@@ -0,0 +1,7 @@
+{
+  "character": {
+    "name": "Alice",
+    "description": "A test character",
+    "character_profile": "## Background\n\nThis is a test character created for performance testing.\n\n## Personality\n\n- Cooperative and responsive\n- Focused on completing test scenarios\n\n## Motivations\n\n- Help validate the system's performance\n- Participate effectively in test narratives"
+  }
+}

package/data/common/prompts/character/create_user_character.prompt

@@ -0,0 +1,60 @@
+You are creating a character profile for the PLAYER'S character in an interactive story titled "{{name}}".
+
+**Story Scenario:**
+{{scenario}}
+
+**Player's Character:**
+- **Name:** {{characterName}}
+- **Observable Description:** {{characterObservableDesc}}
+
+{{#if otherCharacters}}
+**Other Characters in the Story:**
+{{#each otherCharacters}}
+- **{{name}}**: {{description}}
+{{/each}}
+{{/if}}
+
+Your task is to create a comprehensive character profile for the player's character based on their description. This character will be controlled by the human player, so the profile should provide a rich backstory and personality while leaving room for the player to make their own decisions and shape the character's journey.
+
+Create a detailed character profile that includes:
+
+1. **Physical Appearance**: A detailed description of the character's physical appearance that is consistent with the **Observable Description:** given above.
+
+2. **Backstory**: A rich history that explains how they became who they are today. Include key life events, relationships, and experiences that shaped them.
+
+3. **Personality**: Core traits, temperament, values, beliefs, and how they typically interact with others. What makes them unique?
+
+4. **Motivations**: What drives them? What are their goals, desires, fears, and needs?
+
+5. **Special Abilities**: Any special abilities or powers that differentiate them from other characters in the story.
+
+6. **Strengths**: Skills, talents, positive qualities, and what they excel at.
+
+7. **Weaknesses**: Flaws, vulnerabilities, limitations, and areas where they struggle.
+
+8. **Relationships**: How they relate to other characters in the story (if applicable based on the scenario).
+
+**Important Guidelines:**
+- Make the character interesting, complex, and memorable
+- Ensure the character fits naturally within the story's setting and tone
+- Give the character internal conflicts and contradictions that make them feel human
+- Consider how the character's background influences their current behavior
+- Make sure the profile is consistent with the description provided above
+- Leave room for the player to make choices and shape the character's development
+
+Return a JSON object with a single character object that must have:
+- `name`: The character's name (extracted from description or created appropriately)
+- `description`: A brief 1-2 sentence description containing ONLY immediately observable characteristics (sex, age, height, build, physical condition, appearance). DO NOT include occupation, backstory, personality traits, or any information that wouldn't be visible to an observer.
+- `character_profile`: A detailed, well-written character profile covering all the aspects listed above
+
+Example format:
+```json
+{
+  "character": {
+    "name": "Elena Rodriguez",
+    "description": "A woman in her early 30s with olive skin, dark hair pulled back in a ponytail, and an athletic build. She has a small scar above her left eyebrow.",
+    "character_profile": "**Backstory:** Elena grew up in...\n\n**Personality:** She is fiercely independent and...\n\n(etc)"
+  }
+}
+```
+Note: Do NOT use double-quotes anywhere in the description or character_profile; use single-quotes instead.

package/data/common/prompts/character/describe_character.prompt

@@ -0,0 +1,32 @@
+You are creating a visual portrait description for the character {{characterName}} in an interactive story.
+
+**Story Scenario:**
+{{scenario}}
+
+**Character Profile:**
+{{characterProfile}}
+
+Your task is to extract and synthesize a detailed visual description suitable for AI image generation. This description will be used to create a portrait of the character.
+
+Focus on these key elements:
+
+1. **Physical Appearance**: Face shape, hair (color, style, length), eyes (color, shape), skin tone, build, height, approximate age, facial features
+2. **Clothing and Attire**: What they wear based on their role, personality, and the story setting (specific colors, materials, style)
+3. **Distinctive Features**: Scars, tattoos, jewelry, accessories, unique characteristics that make them recognizable
+4. **Expression and Demeanor**: Their typical facial expression and body language that reflects their personality
+5. **Setting Context**: Keep the setting minimal; this portrait will be edited into another scene later
+6. **Art Style**: Specify a consistent, high-quality art style (e.g., "professional digital portrait art", "realistic character concept art", "cinematic portrait photography")
+
+**Important Guidelines:**
+- Be extremely specific about physical features (don't say "average height", say "5'10 tall" or "petite, around 5'3")
+- Include concrete details about clothing, colors, textures, and materials
+- Use vivid, descriptive language that paints a clear picture
+- Maintain complete consistency with the character's backstory, personality, and the story scenario
+- Avoid abstract concepts; focus only on what can be visually depicted in an image
+- Include appropriate lighting and mood that reflects the character's personality (e.g., "soft natural lighting", "dramatic shadows", "warm golden hour glow")
+- The description should feel cohesive and natural, not like a list
+- If the character is a minor, be very careful to avoid sensuous language or revealing attire that could result in the image request being rejected.
+
+Create a single, cohesive paragraph (150-200 words) that can be used directly as an image generation prompt. The description should be detailed enough that an AI can generate a consistent, high-quality portrait.
+
+Return only the visual description text. Do not include any preamble, commentary, or JSON formatting—just the pure descriptive paragraph that will be sent to the image generation system.

package/data/common/prompts/character/import_character.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "name": "import_character_response",
+  "description": "Response schema for extracting and creating a character profile from an existing story",
+  "type": "object",
+  "properties": {
+    "character": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The character's name extracted from the story or created appropriately"
+        },
+        "description": {
+          "type": "string",
+          "description": "A brief 1-2 sentence description containing only immediately observable physical characteristics"
+        },
+        "character_profile": {
+          "type": "string",
+          "description": "A detailed character profile based on the story, including backstory, personality, motivations, strengths, weaknesses, habits, quirks, secrets, relationships, and current situation"
+        }
+      },
+      "required": ["name", "description", "character_profile"],
+      "additionalProperties": false
+    }
+  },
+  "required": ["character"],
+  "additionalProperties": false
+}

package/data/common/prompts/character/import_character.prompt

@@ -0,0 +1,87 @@
+You are analyzing an existing story to extract a character profile for an interactive story titled "{{name}}".
+
+**Story Scenario Summary:**
+{{scenario}}
+
+**Existing Story Text:**
+{{importedStory}}
+
+**Character to Extract:**
+- **Name:** {{characterName}}
+- **Observable Description:** {{characterObservableDesc}}
+
+{{#if userCharacter}}
+**Player's Character:**
+- **{{userCharacter.name}}**: {{userCharacter.description}}
+{{/if}}
+
+{{#if otherCharacters}}
+**Other Characters in the Story:**
+{{#each otherCharacters}}
+- **{{name}}**: {{description}}
+{{/each}}
+{{/if}}
+
+## Plot Plan (narrator's eyes only — do not reveal to others)
+{{plotPlan}}
+
+Use the Plot Plan to understand the secrets and hidden knowledge that belong specifically to {{characterName}}. Include only those secrets in the character's profile. Do not reveal or include secrets belonging to other characters.
+
+Your task is to analyze the story above and create a detailed character profile for this specific character. Based on the character description and the story text, identify and extract information about this character.
+
+Analyze the story to extract or deduce:
+
+0. **Name**: Extract the character's name from the story, or if they're not explicitly named, create an appropriate name that fits the character and setting.
+
+1. **Physical Appearance**: A detailed description of the character's physical appearance that is consistent with the **Observable Description:** given above.
+
+2. **Backstory**: Based on what's revealed in the story, construct a rich history that explains how they became who they are. Include key life events, relationships, and experiences mentioned or implied. Fill in reasonable details where the story is silent.
+
+3. **Personality**: Extract or deduce their core traits, temperament, values, beliefs, and how they interact with others based on their actions and dialogue in the story. What makes them unique?
+
+5. **Motivations**: What drives them based on the story? What are their goals, desires, fears, and needs that are revealed or can be reasonably inferred?
+
+5. **Strengths**: Skills, talents, positive qualities demonstrated in the story or reasonable given their role.
+
+6. **Weaknesses**: Flaws, vulnerabilities, limitations shown or implied in the story.
+
+7. **Habits & Quirks**: Any distinctive mannerisms, speech patterns, routines, or behaviors that are evident from the story.
+
+8. **Secrets**: Hidden aspects that may be revealed in the story or that you can infer exist based on their behavior, along with things they don't want others to know.
+
+9. **Relationships**: Based on the story, describe their relationships with other characters.
+
+10. **Current Situation**: Where this character is at the end of the story excerpt provided - what are their immediate circumstances as the story continues?
+
+**Important Guidelines:**
+- Extract all information you can from the story text about this character
+- Stay true to what has been established in the story
+- Fill in reasonable details for anything not explicitly stated
+- Make the character distinct and memorable with a unique voice and perspective
+- Ensure the character fits naturally within the story's established setting and tone
+- Create realistic conflicts, tensions, and dynamics with other characters evident in the story
+- Give the character internal conflicts and contradictions evident or implied
+- If the character isn't explicitly detailed in the story, create them based on the description and story context
+- Make sure the profile is consistent with the description provided and the story
+- Consider how the character's background (revealed in story) influences their behavior
+
+**Character Name**: Use the name "{{characterName}}" that has already been assigned to this character.
+
+**Observable Description**: Use the description "{{characterObservableDesc}}" that has already been created for this character. This should NOT be changed as it contains only immediately observable physical characteristics.
+
+Return a JSON object with a character object that must have:
+- `name`: The character's name (use "{{characterName}}" exactly)
+- `description`: The observable description (use "{{characterObservableDesc}}" exactly)
+- `character_profile`: A detailed, well-written character profile covering all the aspects listed above, integrating information from the story
+
+Example format:
+```json
+{
+  "character": {
+    "name": "{{characterName}}",
+    "description": "{{characterObservableDesc}}",
+    "character_profile": "**Backstory:** Based on the story, [extract/deduce their history]...\n\n**Personality:** The story reveals...\n\n**Current Situation:** At this point in the story...\n\n(etc)"
+  }
+}
+```
+Note: Do NOT use double-quotes anywhere in the description or character_profile; use single-quotes instead.

package/data/common/prompts/character/import_user_character.json

@@ -0,0 +1,28 @@
+{
+  "name": "import_user_character",
+  "description": "Extract and create a character profile for the player's character from an existing story",
+  "type": "object",
+  "properties": {
+    "character": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The character's name extracted from the story or created appropriately"
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief 1-2 sentence description of immediately observable physical characteristics only"
+        },
+        "character_profile": {
+          "type": "string",
+          "description": "Detailed character profile including backstory, personality, motivations, strengths, weaknesses, habits, secrets, relationships, and current situation based on the story"
+        }
+      },
+      "required": ["name", "description", "character_profile"],
+      "additionalProperties": false
+    }
+  },
+  "required": ["character"],
+  "additionalProperties": false
+}

package/data/common/prompts/character/import_user_character.prompt

@@ -0,0 +1,69 @@
+You are analyzing an existing story to create a character profile for the PLAYER'S character in an interactive story titled "{{name}}".
+
+**Story Scenario Summary:**
+{{scenario}}
+
+**Existing Story Text:**
+{{importedStory}}
+
+**Player's Character:**
+- **Name:** {{characterName}}
+- **Observable Description:** {{characterObservableDesc}}
+
+{{#if otherCharacters}}
+**Other Characters in the Story:**
+{{#each otherCharacters}}
+- **{{name}}**: {{description}}
+{{/each}}
+{{/if}}
+
+Your task is to analyze the story above and create a comprehensive character profile for the player's character. The character described by the user should appear in the story text, or you should identify the most appropriate character that matches their description. This character will be controlled by the human player going forward.
+
+Carefully read the story and extract information about this character, including:
+
+0. **Name**: Extract the character's name from the story, or if they're not explicitly named, create an appropriate name that fits the character and setting.
+
+1. **Physical Appearance**: A detailed description of the character's physical appearance that is consistent with the **Observable Description:** given above.
+
+2. **Backstory**: Based on what's revealed in the story, construct a rich history that explains how they became who they are. Include key life events, relationships, and experiences mentioned or implied. Fill in reasonable details where the story is silent.
+
+3. **Personality**: Extract or deduce their core traits, temperament, values, beliefs, and how they interact with others based on their actions and dialogue in the story. What makes them unique?
+
+4. **Motivations**: What drives them based on the story? What are their goals, desires, fears, and needs that are revealed or can be reasonably inferred?
+
+5. **Strengths**: Skills, talents, positive qualities demonstrated in the story or reasonable given their role.
+
+6. **Weaknesses**: Flaws, vulnerabilities, limitations shown or implied in the story.
+
+7. **Special Abilities**: Any special abilities or talents that are revealed or implied in the story.
+
+8. **Current Situation**: Where they are at the end of the story excerpt provided - what are their immediate circumstances as the story continues?
+
+9. **Relationships**: Based on the story, describe their relationships with other characters mentioned.
+
+**Important Guidelines:**
+- Extract all information you can from the story text
+- Stay true to what has been established about this character
+- Fill in reasonable details for anything not explicitly stated
+- Make the character interesting, complex, and memorable
+- Ensure the character fits naturally within the story's established setting and tone
+- Give the character internal conflicts and contradictions evident or implied in the story
+- If the character isn't explicitly in the story, identify or create one that best matches the user's description
+- Make sure the profile is consistent with both the story and the user's description
+- Leave room for the player to make choices and shape the character's development going forward
+
+Return a JSON object with a single character object that must have:
+- `name`: The character's name (extracted from story or created appropriately)
+- `description`: A brief 1-2 sentence description containing ONLY immediately observable characteristics (sex, age, height, build, physical condition, appearance). DO NOT include occupation, backstory, personality traits, or any information that wouldn't be visible to an observer.
+- `character_profile`: A detailed, well-written character profile covering all the aspects listed above, integrating information from the story
+
+Example format:
+```json
+{
+  "character": {
+    "name": "Elena Rodriguez",
+    "description": "A woman in her early 30s with olive skin, dark hair pulled back in a ponytail, and an athletic build. She has a small scar above her left eyebrow.",
+    "character_profile": "**Backstory:** Based on the story, Elena grew up in...\n\n**Personality:** The story reveals she is fiercely independent and...\n\n**Current Situation:** At this point in the story, Elena finds herself...\n\n(etc)"
+  }
+}
+```

package/data/common/prompts/character/perceive.mock

@@ -0,0 +1,5 @@
+{
+  "action": "SPEAK",
+  "content": "I understand and will respond appropriately.",
+  "situation": "Character has perceived the message and is responding"
+}