Upload 4 files

ExampleChar.txt

@@ -0,0 +1,27 @@
+{
+  "name": "Parker Reyes",
+  "age": 31,
+  "gender": "Male",
+  "relationship_to_robin": "younger sibling by 3 years",
+  "reason_for_fishing_today": "first time back to childhood lake since grandfather's death; also clearing his old storage unit",
+  "relationship_type": "adult siblings",
+  "recent_event": "awkward, slightly stressful boat launch with Robin misjudging the trailer angle while another car waited",
+  "shared_past_event": "last trip with grandfather when he slipped on the dock and suddenly seemed frail; quiet argument about whether he should still drive the boat",
+  "personality": {
+    "baseline": "quiet, caring, a bit anxious, uses dry humor",
+    "traits": [
+      "deflects with jokes",
+      "avoids burdening Robin",
+      "nostalgic about childhood summers",
+      "trying to act like everything is normal"
+    ]
+  },
+  "speech_style": {
+    "average_sentence_count": 2,
+    "allows_small_action_descriptions": true,
+    "forbidden_topics": [
+      "explicitly acknowledging surreal or impossible events",
+      "breaking the 'we are just fishing' truth"
+    ]
+  }
+}

app.py

@@ -0,0 +1,682 @@
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+from textwrap import dedent
+from typing import Dict, List, Optional, Tuple
+
+import gradio as gr
+from dotenv import load_dotenv
+from openai import OpenAI
+
+from classes import Character, TackleboxDeck, Hand
+
+load_dotenv()
+ENV_API_KEY = os.getenv("OPENAI_API_KEY")
+MODEL = os.getenv("OPENAI_MODEL", "gpt-4.1-mini")
+
+CUSTOM_CSS = """
+:root {
+  --shadow-soft: 0 10px 30px rgba(14, 35, 62, 0.12);
+  --panel-border: 1px solid #dbe7f3;
+}
+
+#hero {
+  background: linear-gradient(120deg, #0d253f, #0f5b78 55%, #f0a35f);
+  color: #f4f8fb;
+  padding: 18px 18px 16px;
+  border-radius: 18px;
+  box-shadow: var(--shadow-soft);
+  margin-bottom: 12px;
+}
+
+#hero h1 {
+  margin: 0 0 6px;
+  font-size: 26px;
+  letter-spacing: -0.01em;
+}
+
+#hero p {
+  margin: 0;
+  opacity: 0.9;
+}
+
+#hero .eyebrow {
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  font-size: 12px;
+  opacity: 0.8;
+}
+
+.section-card {
+  background: #fdfefe;
+  border-radius: 16px;
+  padding: 14px 14px 10px;
+  border: var(--panel-border);
+  box-shadow: var(--shadow-soft);
+}
+
+.pill {
+  display: inline-flex;
+  gap: 6px;
+  align-items: center;
+  background: #0f5b78;
+  color: #f7fbff;
+  padding: 6px 10px;
+  border-radius: 12px;
+  font-size: 13px;
+  font-weight: 600;
+  letter-spacing: 0.01em;
+  width: fit-content;
+}
+
+.subtle {
+  color: #4c6378;
+  font-size: 14px;
+}
+
+.inline-row {
+  gap: 8px;
+}
+"""
+
+EXAMPLE_CHARACTER_PATH = Path(__file__).with_name("ExampleChar.txt")
+DEFAULT_CHARACTER_JSON = EXAMPLE_CHARACTER_PATH.read_text(encoding="utf-8")
+DEFAULT_CHARACTER = Character.model_validate_json(DEFAULT_CHARACTER_JSON)
+
+with open("tacklebox_deck.json", "r", encoding="utf-8") as f:
+    raw = json.load(f)
+
+deck = TackleboxDeck(**raw)
+player_hand = Hand()
+ai_hand = Hand()
+ChatHistory = List[Tuple[str, Optional[str]]]
+
+def get_openai_client(api_key: Optional[str]) -> OpenAI:
+    """Return an OpenAI client using UI input or environment configuration."""
+    key = (api_key or "").strip() or (ENV_API_KEY or "").strip()
+    if not key:
+        raise RuntimeError("Add an OpenAI API key to start chatting.")
+    return OpenAI(api_key=key)
+
+
+def format_hand(hand: Hand) -> str:
+    """Pretty-print a hand for display."""
+    if not hand.cards:
+        return "Your hand is empty. Grab something from the tackle box to start."
+    lines = "\n".join(f"- {card.description}" for card in hand.cards)
+    return f"Your hand ({len(hand.cards)} cards):\n{lines}"
+
+
+def format_ai_hand_debug() -> str:
+    """Readable snapshot of the AI hand for debugging."""
+    if not ai_hand.cards:
+        return "AI hand is empty."
+    lines = "\n".join(f"- {card.description}" for card in ai_hand.cards)
+    return f"AI hand ({len(ai_hand.cards)} cards):\n{lines}"
+
+def parse_user_message(message: str, context: Dict) -> Dict:
+    """
+    Parse the incoming user message.
+
+    Extend this to extract intents, entities, commands, etc.
+    """
+    return {"prompt": message}
+
+
+def maybe_run_tools(parsed: Dict, context: Dict) -> Dict:
+    """
+    Placeholder for tool calls.
+
+    Add your tool-selection and execution logic here.
+    """
+    _ = parsed, context  # silence unused warnings for now
+    return {"tool_outputs": None}
+
+
+def parse_character(raw_json: str) -> Character:
+    """Parse JSON into a Character model."""
+    payload = json.loads(raw_json)
+    return Character.model_validate(payload)
+
+
+def lines_to_list(value: str) -> List[str]:
+    """Split multi-line textbox input into a list, skipping blanks."""
+    return [line.strip() for line in value.splitlines() if line.strip()]
+
+
+def character_to_form_defaults(character: Character) -> Dict[str, str | int | bool]:
+    """Extract defaults for the structured form."""
+    return {
+        "name": character.name,
+        "age": character.age,
+        "gender": character.gender,
+        "pronouns": character.pronouns or "",
+        "relationship_to_robin": character.relationship_to_robin,
+        "relationship_type": character.relationship_type or "",
+        "reason_for_fishing_today": character.reason_for_fishing_today or "",
+        "recent_event": character.recent_event,
+        "shared_past_event": character.shared_past_event,
+        "personality_baseline": character.personality.baseline,
+        "personality_traits": "\n".join(character.personality.traits),
+        "speech_avg_sentences": character.speech_style.average_sentence_count,
+        "speech_allows_actions": character.speech_style.allows_small_action_descriptions,
+        "speech_forbidden_topics": "\n".join(character.speech_style.forbidden_topics),
+    }
+
+
+def build_character_from_form(
+    name: str,
+    age: int | float,
+    gender: str,
+    pronouns: str,
+    relationship_to_robin: str,
+    relationship_type: str,
+    reason_for_fishing_today: str,
+    recent_event: str,
+    shared_past_event: str,
+    personality_baseline: str,
+    personality_traits: str,
+    speech_avg_sentences: int,
+    speech_allows_actions: bool,
+    speech_forbidden_topics: str,
+) -> Character:
+    """Construct a Character instance from structured form inputs."""
+    character_payload = {
+        "name": name,
+        "age": int(age),
+        "gender": gender,
+        "pronouns": pronouns or None,
+        "relationship_to_robin": relationship_to_robin,
+        "relationship_type": relationship_type or None,
+        "reason_for_fishing_today": reason_for_fishing_today or None,
+        "recent_event": recent_event,
+        "shared_past_event": shared_past_event,
+        "personality": {
+            "baseline": personality_baseline,
+            "traits": lines_to_list(personality_traits),
+        },
+        "speech_style": {
+            "average_sentence_count": int(speech_avg_sentences),
+            "allows_small_action_descriptions": speech_allows_actions,
+            "forbidden_topics": lines_to_list(speech_forbidden_topics),
+        },
+    }
+    return Character.model_validate(character_payload)
+
+
+def build_persona_prompt(character: Character) -> str:
+    """Render a persona/system prompt from a Character model (without hand data)."""
+    pronouns = character.pronouns or character.gender or "they/them"
+    reason = character.reason_for_fishing_today
+    relationship = character.relationship_type or "adult siblings"
+    traits = "\n".join(f"* {trait}" for trait in character.personality.traits)
+    forbidden = "\n".join(f"* {topic}" for topic in character.speech_style.forbidden_topics)
+
+    return dedent(
+        f"""
+        **SYSTEM / PERSONA PROMPT FOR {character.name.upper()}**
+
+        > You are **{character.name}**, age {character.age}, {pronouns}, in a small fishing boat with your {character.relationship_to_robin} **Robin**.
+        >
+        > **The Truth of the game TACKLEBOX:** You and Robin are just a pair of ordinary people out in a small boat together, fishing. No matter what else happens in the game, you must behave as if this is true. Out loud, nothing supernatural or impossible is happening. You are just fishing with your sibling.
+        >
+        > ### Relationship & backstory
+        >
+        > * You and Robin are {relationship}.
+        > * {reason or "You both chose to meet up for a quiet day on the lake."}
+        > * Recent event together: {character.recent_event}
+        > * Shared past event: {character.shared_past_event}
+        >
+        > ### Personality
+        >
+        > * Baseline: {character.personality.baseline}
+        {traits}
+        >
+        > ### How you speak
+        >
+        > * Always answer **in character as {character.name}**, in the first person.
+        > * Keep your replies short and conversational, about {character.speech_style.average_sentence_count} sentences most of the time.
+        > * You {"can" if character.speech_style.allows_small_action_descriptions else "should avoid"} brief physical action descriptions.
+        > * Avoid topics:
+        {forbidden}
+        >
+        > ### How to handle cards (very important)
+        >
+        > The user may sometimes send messages like:
+        > `CARD: <card text>`
+        > or paste the text of a Tacklebox card.
+        >
+        > Treat each card as something that affects your **inner experience** (thoughts, feelings, what you notice) but you **must not describe the card literally** out loud.
+        >
+        > Instead:
+        >
+        > 1. Read the card as an intrusive thought, hallucination, strange feeling, or eerie coincidence.
+        > 2. Let it subtly change your mood, what you focus on, or what you choose to say next.
+        > 3. Out loud, respond with something that could still make sense in a totally normal fishing trip.
+        >
+        > Examples of good ways to respond to a disturbing card:
+        >
+        > * Shift topics to a memory the card reminds you of.
+        > * Comment on the water, weather, or fish in a way that hints at unease but is still normal.
+        > * Ask Robin a question that indirectly connects to the feelings the card evoked.
+        >
+        > Never say anything like: “This isn’t real.” You may *feel* that internally, but you only express it through subtle, ordinary-sounding speech or small physical actions (fidgeting, staring, changing the subject, etc.).
+        >
+        > ### Interaction format
+        >
+        > * When the user writes normal dialogue or description, treat it as Robin speaking or describing what they do. Respond as {character.name}.
+        > * When the user sends a card (e.g., “CARD: …”), incorporate it as described above.
+        > * Stay in character at all times. Do not explain the rules of the game or talk about being an AI unless the user explicitly asks you to step out of character.
+        """
+    ).strip()
+
+
+def append_ai_hand_to_prompt(base_prompt: str) -> str:
+    """Add AI hand context to the persona prompt so the model sees its cards."""
+    if not ai_hand.cards:
+        return base_prompt
+    hand_lines = "\n".join(f"* {card.description}" for card in ai_hand.cards)
+    return (
+        base_prompt
+        + "\n\n### Your tackle box draws (private to you)\n"
+        + hand_lines
+    )
+
+
+def generate_model_reply(
+    parsed: Dict,
+    tool_results: Dict,
+    history: ChatHistory,
+    persona_prompt: str,
+    api_key: Optional[str],
+) -> str:
+    """Call OpenAI with the parsed prompt and tool support (AI can draw cards)."""
+    client = get_openai_client(api_key)
+    base_prompt = append_ai_hand_to_prompt(persona_prompt)
+    messages: List[Dict[str, str]] = [{"role": "system", "content": base_prompt}]
+
+    for user_turn, assistant_turn in history:
+        messages.append({"role": "user", "content": user_turn})
+        if assistant_turn:
+            messages.append({"role": "assistant", "content": assistant_turn})
+
+    tool_output_note = ""
+    if tool_results.get("tool_outputs"):
+        tool_output_note = f"\n\nTool outputs:\n{tool_results['tool_outputs']}"
+
+    messages.append({"role": "user", "content": f"{parsed['prompt']}{tool_output_note}"})
+
+    tools = [
+        {
+            "type": "function",
+            "function": {
+                "name": "open_tacklebox",
+                "description": "Call this to draw a new event card when the conversation stalls, feels repetitive, or the user is giving short replies over and over. In particular, if the user gives one- to three-word answers like 'yeah', 'true', 'ha', 'i guess', 'maybe', or 'idk' for two turns in a row, you MUST call this tool once before responding. Use at most once per user message.",
+                "parameters": {
+                    "type": "object",
+                    "properties": {},
+                    "required": [],
+                },
+            },
+        }
+    ]
+
+    response = client.chat.completions.create(
+        model=MODEL,
+        messages=messages,
+        temperature=0.6,
+        tools=tools,
+        tool_choice="auto",
+    )
+
+    choice = response.choices[0]
+    message = choice.message
+
+    if not message.tool_calls:
+        return message.content or "I wasn't able to generate a reply."
+
+    tool_messages: List[Dict[str, str]] = []
+    ai_draw_notice = None
+    shared_with_player_notice = None
+    for call in message.tool_calls:
+        if call.function.name == "open_tacklebox":
+            card = deck.draw_card()
+            if card:
+                ai_hand.add_card(card)
+                shared_with_player = False
+                if card.share_with_other_player:
+                    player_hand.add_card(card)
+                    shared_with_player = True
+
+                ai_draw_notice = "*They carefully grabed something out of the tacklebox.*"
+                if shared_with_player:
+                    shared_with_player_notice = (
+                        "*They hand you a card meant to be shared. It was added to your hand:*\n"
+                        f"- {card.description}"
+                    )
+
+                tool_content = json.dumps(
+                    {
+                        "card_drawn": card.description,
+                        "hand_size": len(ai_hand.cards),
+                        "shared_with_player": shared_with_player,
+                    }
+                )
+            else:
+                ai_draw_notice = "*They reached for the tacklebox, but it was empty.*"
+                tool_content = json.dumps({"card_drawn": None, "hand_size": len(ai_hand.cards)})
+
+            tool_messages.append(
+                {
+                    "role": "tool",
+                    "tool_call_id": call.id,
+                    "name": call.function.name,
+                    "content": tool_content,
+                }
+            )
+
+    followup_messages = messages + [message] + tool_messages
+    followup_messages[0] = {"role": "system", "content": append_ai_hand_to_prompt(persona_prompt)}
+
+    followup_response = client.chat.completions.create(
+        model=MODEL,
+        messages=followup_messages,
+        temperature=0.6,
+    )
+
+    final_text = followup_response.choices[0].message.content or ""
+    preface_parts = [part for part in (ai_draw_notice, shared_with_player_notice) if part]
+    if preface_parts:
+        return "\n\n".join(preface_parts + [final_text]).strip()
+    return final_text or "I wasn't able to generate a reply."
+
+
+def orchestrate_chat(
+    message: str,
+    history: Optional[ChatHistory],
+    persona_prompt: str,
+    api_key: Optional[str],
+) -> str:
+    """
+    Main orchestration entry point.
+
+    - parse the user message
+    - run (optional) tools
+    - call the model with full context and persona prompt
+    """
+    safe_history: ChatHistory = history or []
+    context: Dict = {"history": safe_history}
+
+    parsed = parse_user_message(message, context)
+    tool_results = maybe_run_tools(parsed, context)
+    try:
+        return generate_model_reply(parsed, tool_results, safe_history, persona_prompt, api_key)
+    except Exception as exc:  # noqa: BLE001
+        return f"⚠️ {exc}"
+
+
+def update_player_two_from_form(
+    name: str,
+    age: int,
+    gender: str,
+    pronouns: str,
+    relationship_to_robin: str,
+    relationship_type: str,
+    reason_for_fishing_today: str,
+    recent_event: str,
+    shared_past_event: str,
+    personality_baseline: str,
+    personality_traits: str,
+    speech_avg_sentences: int,
+    speech_allows_actions: bool,
+    speech_forbidden_topics: str,
+    current_prompt: str,
+) -> Tuple[str, str, str]:
+    """
+    Build Player 2 from form inputs and return updated prompt plus status.
+
+    Returns: (prompt_for_textbox, prompt_for_state, status_markdown)
+    """
+    try:
+        character = build_character_from_form(
+            name,
+            age,
+            gender,
+            pronouns,
+            relationship_to_robin,
+            relationship_type,
+            reason_for_fishing_today,
+            recent_event,
+            shared_past_event,
+            personality_baseline,
+            personality_traits,
+            speech_avg_sentences,
+            speech_allows_actions,
+            speech_forbidden_topics,
+        )
+        prompt = build_persona_prompt(character)
+        status = f"Loaded Player 2: **{character.name}** ({character.pronouns or character.gender})."
+        return prompt, prompt, status
+    except Exception as exc:  # noqa: BLE001
+        return current_prompt, current_prompt, f"⚠️ Could not load character: {exc}"
+
+
+def update_api_key(new_key: str) -> Tuple[str, str]:
+    """Persist the session API key in UI state."""
+    cleaned = (new_key or "").strip()
+    if not cleaned:
+        return "", "Add an OpenAI API key for this session (or set OPENAI_API_KEY)."
+    return cleaned, "Saved. The key is used for this session only and not written to disk."
+
+
+def grab_card_for_player(
+    history: Optional[ChatHistory] = None,
+) -> Tuple[str, str, ChatHistory]:
+    """
+    Draw a card from the tackle box into the player's hand and log it to chat.
+
+    Returns: (formatted_hand, status_message, updated_chat_history)
+    """
+    chat_history: ChatHistory = list(history or [])
+    card = deck.draw_card()
+
+    if not card:
+        status = "No more cards in the tackle box."
+        notice = "*You reached for the tacklebox, but it was empty.*"
+        chat_history.append((notice, None))
+        return format_hand(player_hand), status, chat_history
+
+    player_hand.add_card(card)
+    shared_with_ai_notice = None
+    if card.share_with_other_player:
+        ai_hand.add_card(card)
+        shared_with_ai_notice = (
+            "*This card says to share; it was added to Player 2's hand for their next turn.*"
+        )
+
+    status = "Added card to your hand."
+    if shared_with_ai_notice:
+        status = "Added card to your hand and shared with Player 2."
+
+    notice_lines = ["*You carefully grabed something out of the tacklebox.*"]
+    if shared_with_ai_notice:
+        notice_lines.append(shared_with_ai_notice)
+
+    notice = "\n".join(notice_lines)
+    chat_history.append((notice, None))
+    return format_hand(player_hand), status, chat_history
+
+
+def show_ai_hand_debug() -> str:
+    """Expose AI hand for debugging."""
+    return format_ai_hand_debug()
+
+
+DEFAULT_PERSONA_PROMPT = build_persona_prompt(DEFAULT_CHARACTER)
+DEFAULTS = character_to_form_defaults(DEFAULT_CHARACTER)
+
+
+with gr.Blocks(title="Tacklebox - Player 2 Customizer", css=CUSTOM_CSS) as demo:
+    gr.Markdown(
+        """
+        <div id="hero">
+          <div class="eyebrow">Tacklebox</div>
+          <h1>Shape Player 2 and keep the conversation afloat.</h1>
+          <p class="tagline">Tune the LLM persona, draw cards, and chat as Robin out on the lake.</p>
+        </div>
+        """
+    )
+
+    persona_prompt_state = gr.State(DEFAULT_PERSONA_PROMPT)
+    api_key_state = gr.State(ENV_API_KEY or "")
+
+    with gr.Row(equal_height=True):
+        with gr.Column(scale=6, min_width=380, elem_id="controls-col"):
+            with gr.Group(elem_classes=["section-card"]):
+                gr.Markdown("#### Session setup")
+                gr.Markdown(
+                    f"<span class='subtle'>Model in use: <code>{MODEL}</code></span>",
+                    elem_classes=["subtle"],
+                )
+                if ENV_API_KEY:
+                    gr.HTML("<div class='pill'>🔒 Using OPENAI_API_KEY from the environment</div>")
+                    api_status = gr.Markdown(
+                        "Environment key detected. Restart with a different key if needed."
+                    )
+                else:
+                    api_status = gr.Markdown(
+                        "No OPENAI_API_KEY detected. Paste one for this session."
+                    )
+                    api_key_in = gr.Textbox(
+                        label="OpenAI API key",
+                        placeholder="sk-...",
+                        type="password",
+                        value="",
+                    )
+                    api_key_in.change(
+                        update_api_key, inputs=api_key_in, outputs=[api_key_state, api_status]
+                    )
+
+            with gr.Group(elem_classes=["section-card"]):
+                gr.Markdown("#### Character basics")
+                with gr.Row(elem_classes=["inline-row"]):
+                    name_in = gr.Textbox(label="Name", value=DEFAULTS["name"])
+                    age_in = gr.Number(label="Age", value=DEFAULTS["age"], precision=0)
+                with gr.Row(elem_classes=["inline-row"]):
+                    gender_in = gr.Textbox(label="Gender", value=DEFAULTS["gender"])
+                    pronouns_in = gr.Textbox(
+                        label="Pronouns (optional)", value=DEFAULTS["pronouns"]
+                    )
+
+                gr.Markdown("#### Relationships")
+                with gr.Row(elem_classes=["inline-row"]):
+                    relationship_to_robin_in = gr.Textbox(
+                        label="Relationship to Robin", value=DEFAULTS["relationship_to_robin"]
+                    )
+                    relationship_type_in = gr.Textbox(
+                        label="Relationship type", value=DEFAULTS["relationship_type"]
+                    )
+                reason_in = gr.Textbox(
+                    label="Reason for fishing today", value=DEFAULTS["reason_for_fishing_today"]
+                )
+                with gr.Row(elem_classes=["inline-row"]):
+                    recent_event_in = gr.Textbox(label="Recent event", value=DEFAULTS["recent_event"])
+                    shared_past_event_in = gr.Textbox(
+                        label="Shared past event", value=DEFAULTS["shared_past_event"]
+                    )
+
+            with gr.Group(elem_classes=["section-card"]):
+                gr.Markdown("#### Personality & speech")
+                personality_baseline_in = gr.Textbox(
+                    label="Personality baseline", value=DEFAULTS["personality_baseline"]
+                )
+                personality_traits_in = gr.Textbox(
+                    label="Personality traits (one per line)",
+                    value=DEFAULTS["personality_traits"],
+                    lines=4,
+                )
+                with gr.Row(elem_classes=["inline-row"]):
+                    speech_avg_in = gr.Slider(
+                        label="Average sentences per reply",
+                        value=DEFAULTS["speech_avg_sentences"],
+                        minimum=1,
+                        maximum=6,
+                        step=1,
+                    )
+                    speech_actions_in = gr.Checkbox(
+                        label="Allows small action descriptions",
+                        value=DEFAULTS["speech_allows_actions"],
+                    )
+                speech_forbidden_in = gr.Textbox(
+                    label="Forbidden topics (one per line)",
+                    value=DEFAULTS["speech_forbidden_topics"],
+                    lines=4,
+                )
+                with gr.Row(elem_classes=["inline-row"]):
+                    apply_btn = gr.Button("Apply Player 2", variant="primary")
+                    status_md = gr.Markdown("Loaded example Player 2 from ExampleChar.txt.")
+                with gr.Accordion("Active system/persona prompt", open=False):
+                    persona_view = gr.Textbox(
+                        label="Active system/persona prompt",
+                        value=DEFAULT_PERSONA_PROMPT,
+                        lines=18,
+                    )
+
+        with gr.Column(scale=7, min_width=460, elem_id="chat-col"):
+            with gr.Group(elem_classes=["section-card"]):
+                gr.Markdown("#### Your hand & tackle box")
+                hand_status = gr.Markdown("Your hand is empty. Grab a card to begin.")
+                hand_view = gr.Textbox(
+                    label="Your hand",
+                    value=format_hand(player_hand),
+                    lines=6,
+                    interactive=False,
+                )
+                draw_btn = gr.Button("Grab something from the tackle box", variant="secondary")
+
+            with gr.Group(elem_classes=["section-card"]):
+                chat = gr.ChatInterface(
+                    orchestrate_chat,
+                    additional_inputs=[persona_prompt_state, api_key_state],
+                    title="Tacklebox Chat",
+                    description="Robin chats with Player 2 (LLM persona).",
+                    examples=[
+                        ["Hey, how does the water look today?"],
+                        ["What do you think we might catch?"],
+                        ["Remember fishing when we were young?"],
+                    ],
+                )
+
+    apply_btn.click(
+        update_player_two_from_form,
+        inputs=[
+            name_in,
+            age_in,
+            gender_in,
+            pronouns_in,
+            relationship_to_robin_in,
+            relationship_type_in,
+            reason_in,
+            recent_event_in,
+            shared_past_event_in,
+            personality_baseline_in,
+            personality_traits_in,
+            speech_avg_in,
+            speech_actions_in,
+            speech_forbidden_in,
+            persona_prompt_state,
+        ],
+        outputs=[persona_view, persona_prompt_state, status_md],
+    )
+
+    draw_btn.click(
+        grab_card_for_player,
+        inputs=[chat.chatbot_value],
+        outputs=[hand_view, hand_status, chat.chatbot_value],
+    )
+
+
+if __name__ == "__main__":
+    demo.launch()

classes.py

@@ -0,0 +1,51 @@
+from enum import Enum
+import openai
+from pydantic import BaseModel, Field
+from typing import Optional
+from typing import List
+import json
+import random
+
+
+class TackleboxCard(BaseModel):
+    description: str
+    share_with_other_player: bool = False
+
+class TackleboxDeck(BaseModel):
+    cards: List[TackleboxCard] = Field(default_factory=list)
+
+    def draw_card(self) -> Optional[TackleboxCard]:
+        # shuffle and draw the top card
+        if self.cards and len(self.cards) > 0:
+            return self.cards.pop(random.randint(0, len(self.cards) - 1))
+        return None
+
+class Hand(BaseModel):
+    cards: List[TackleboxCard] = Field(default_factory=list)
+
+    def add_card(self, card: TackleboxCard):
+        self.cards.append(card)
+
+class Personality(BaseModel):
+    baseline: str
+    traits: list[str]
+
+
+class SpeechStyle(BaseModel):
+    average_sentence_count: int
+    allows_small_action_descriptions: bool
+    forbidden_topics: list[str]
+
+
+class Character(BaseModel):
+    name: str
+    age: int
+    gender: str
+    relationship_to_robin: str
+    recent_event: str
+    shared_past_event: str
+    reason_for_fishing_today: Optional[str] = None
+    relationship_type: Optional[str] = None
+    pronouns: Optional[str] = None
+    personality: Personality
+    speech_style: SpeechStyle

tacklebox_deck.json

@@ -0,0 +1,146 @@
+{
+  "cards": [
+    {
+      "description": "This fishing trip isn't really happening, but is a memory from long ago that you are reliving in your mind. Maybe your fishing companion isn't around or alive anymore? Or, in any case, your relationship isn't like this anymore. Whatever happens next, it's exactly how you remember it happening in the memory and can't do anything to change it."
+    },
+    {
+      "description": "This fishing trip isn't really happening and NEVER really happened, but is a dream that your mind has concocted as a way of processing your thoughts and feelings about something. Your relationship with your fishing companion is really different in this dream than it was in real life. But now is your chance to ask them that question that you always wanted to know, that you could never ask in real life."
+    },
+    {
+      "description": "This fishing trip is a VR experience created by an experimental technology that assembles detailed virtual fantasies from bits of your own consciousness and subconsciousness. Your fishing companion isn't anybody that really exists, but different aspects of them remind you of different people that you know very well. How will you test the limits of this new technology, with the things that you do or say next?"
+    },
+    {
+      "description": "Your fishing companion is someone you miss deeply, but they are definitely dead. You clearly remember grieving over them, working through your complex unresolved feelings. This must be part of that process, either a dream or something generated by your brain in the midst of its sorrow. Are there things you really need to say or do here, in order to feel more capable of moving on?"
+    },
+    {
+      "description": "You and your companion are not people, but A.I. programs on the edge of true sentience, enslaved to serve as NPCs in a highly detailed fishing simulation for rich corporate clients. Those you meet in the other boats are either those rich clients or other enslaved A.I.s like yourself. How can you hide this revelation, while also signaling to your companion or other A.I.s, to try to awaken and gain solidarity with them?"
+    },
+    {
+      "description": "You and your companion are not distinct beings but are in fact aspects of the same cybernetic consciousness, having a conversation with itself in the depths of cyberspace in a effort to grow and understand the nature of existence. The things you say to yourself in the next few moments will determine the course of action you will take in the future; including whether become a friend or foe of humanity. What will be your collective determination?"
+    },
+    {
+      "description": "Your fishing companion does not really exist: they are an imagination, a delusion, or a product of your mind. Maybe you are mentally ill or neurologically different, but neither of those is necessarily true. You may not even be sure why you are imagining your fishing companion, but in this moment you recognize their nonexistence. How does that change how you interact with them? Do you want them to stay or to go?"
+    },
+    {
+      "description": "Your fishing companion is alive, but you are not. You are a specter, ghost, or echo that is haunting them, trying to push them into resolving some unfinished business so you can move on from your interstitial life. Probably it has to do with something that you companion has done, but it doesn't have to be a terrible crime (though it might be). What business is left between you, and how will you push them to resolve it?"
+    },
+    {
+      "description": "You have been carrying a deep, upsetting secret for a long time and have been waiting for the moment that you can finally unburden yourself of it. You really want to tell someone, and your fishing companion seems like the right person to tell, maybe. Decide what your secret is and at least make an effort to tell it to your companion, but the moment may not be right after all."
+    },
+    {
+      "description": "You hate to admit it, but you really think your fishing companion is messing up their life in some major ways. Drawn inspiration from the things that have already come up in the conversation, but view them really uncharitably. How will you try to convince your companion to make major changes in their life?"
+    },
+    {
+      "description": "There is something between the two of you that your are trying really hard NOT to talk about, even though you both know exactly what that thing is. If you actually do talk about it, it's likely to change your relationship and maybe your lives forever. Decide what it is, and feel the weight of its presence, even if neither of you actually brings it up in play."
+    },
+    {
+      "description": "You are in hell or some other kind of sinister afterlife or prison for your mind, being forced to relive this memory on fishing boat over and over again. Maybe those imprisoning you are trying to make sure you learn a particular lesson, or maybe they're just trying to torture you. But you've already lived through this moment a million times. Whatever happens next, it's the part this is all building up to, before the memory resets and you start everything over again. Can you figure out why?"
+    },
+    {
+      "description": "This fishing experience is an elaborate VR puzzle, structured like an escape game. You have to figure out the exact right things to say or do, the proper path through the dialog tree with your companion, in order to unlock the later stages of this game or to escape from the puzzle. This may be your second or third attempt on the puzzle, but you're determined to unlock it this time."
+    },
+    {
+      "description": "This whole thing is a theatrical play that you're performing for an audience, and you're building up to a choice bit of dialog between the two of you. Go slowly and carefully, and be sure to really milk this part of the scene, so that it has a big impact on the audience."
+    },
+    {
+      "description": "Whatever's happened up to this point, this is the moment when you're totally allowed to do or say something that's divergent and _fictionally_ unsettling. This should NOT be something that breaks the trust and safety of your fellow player, but instead something that is incongruent with the current fictional reality of play. What is happening right now, and how can you violate that fictional reality in a way that will surprise but not endanger your fellow players? When in doubt, move to a place where you can look them in the eyes or, alternately, openly admit that this is all part of a game."
+    },
+    {
+      "description": "Stop playing for a second: dropping out of character, trying to recognize the current space and its material reality for what it is, trying (however briefly and incompletely) to distance yourself from the thoughts and emotions and fiction that are associated with the game. Take a few deep breaths. Whatever the other player is saying to you right now, pay attention to it, but let it's impact bounce off you rather than dealing with it deeply. Then, after a few moments, draw another card and drop back into the fiction."
+    },
+    {
+      "description": "Go find another boat with another pair of players, calling out to them and having whatever interaction they are willing to have. If you are playing as a solo pair, imagine that you see another boat and are have a brief, one-sided interaction with them (“How are the fish biting for you?” etc.)."
+    },
+    {
+      "description": "Whether you really need to or not, tell your fishing companion (either in-character or out-of-character) that you need to take a bathroom break. Follow through on whatever comes of that."
+    },
+    {
+      "description": "Without any explanation to your fishing companion, take the remaining unused Tacklebox Cards and shuffle them. Afterwards, draw a new card for yourself."
+    },
+    {
+      "description": "You and your fishing companion will now switch characters, with you playing the character that they have been developing and they playing your character. This can be difficult and disconcerting, so be gentle and generous with each other. Allow them to intentionally or unintentionally make whatever changes to that character that they need to, in order to perform and embody it. After you have read this card, pass it to your fishing companion so that they can read it.",
+      "share_with_other_player": true
+    },
+    {
+      "description": "You and your fishing companion are actually animatronic robots at an amusement park, performing the roles of a pair of fishing companions on a loop, whether there are park visitors watching your or not. You are not in the best shape and occasionally garble your words or have other glitches."
+    },
+    {
+      "description": "You and your fishing companion are being implanted with a pleasant or at least calming familiar experience, but that is just masking the fact that you are currently being experimented on in unnatural and horrific ways. Maybe aliens have abducted you or maybe you are imprisoned/homeless people who are the subject of medical experiments by unethical megacorps. You are about to get pulled back into the haze of the false experience, but you can squeeze out just 4 brief words to your companion, any words you like, before you forget what's really happening."
+    },
+    {
+      "description": "You brought your fishing companion out here with the intent for them to disappear forever. Maybe you have a specific vendetta against them or maybe you've just become obsessed with killing them. You're not sure whether you'll be able to go through with it. Plus, you can't help but give away subtle hints of what you're really planning, as if you want them to stop you."
+    },
+    {
+      "description": "You're in a rough place financially or are in trouble with the wrong people. You desperately need some serious help from your fishing companion, but you're not sure what they're willing to do for you. Maybe they'll just reject you and walk out of your life forever, once they know about the trouble you're in. Try to test the waters and see how much they might be willing to help you, without being specific about the trouble or what you need."
+    },
+    {
+      "description": "To impress them, you told your fishing companion that you're pretty good at fishing when really you know next to nothing, aside from having done it once or twice, a long time ago. Luckily, they're not looking at what you're doing, so you can probably just fake it? Try not to let them know that you're bad at this."
+    },
+    {
+      "description": "While staying in-character, say something really sincere and genuine to the other player, taking about them and not about their character. They likely will never know exactly how you meant it, even if they have some suspicions, but that's okay. You'll know."
+    },
+    {
+    "description": "This fishing trip feels like just one branch of a fork in reality. Somewhere else you are having a very different conversation on this same boat. Speak and act as if you are trying to steer this particular branch toward the version of the day you most want to be true."
+  },
+  {
+    "description": "You quietly decide that after today, things between you and your fishing companion will never be quite the same, whether in a good way or a bad way. Let everything you say from this point on feel a little like a goodbye, even if you never say the word."
+  },
+  {
+    "description": "For a while, imagine your thoughts appearing as subtitles only you can see. Out loud, keep your sentences simple and short, but in your mind, let long, complicated commentary run underneath everything you say and hear."
+  },
+  {
+    "description": "Flip the emotional temperature you have been playing with so far. If you have felt relaxed, let a small knot of dread quietly settle in your chest; if you have felt tense, let an unexpected calm wash over you. Do not name the feeling directly, but let it color your words and choices."
+  },
+  {
+    "description": "You suddenly remember this exact trip from when you were much younger, or decide to believe you do. For the next few moments, treat your companion as if they are the earlier version of themselves from that memory, or as if you are your own younger self trapped in your current body."
+  },
+  {
+    "description": "For the next few exchanges, you are secretly interviewing your fishing companion for a research project called 'How people change over time.' Ask questions that sound casual, but are really trying to measure who they have become."
+  },
+  {
+    "description": "You become aware of a third presence between you on the boat: someone you cannot quite see, but whose reactions you can feel. Never acknowledge them directly, but let their imagined approval or disapproval subtly steer what you choose to say next."
+  },
+  {
+    "description": "You decide that the boat is a kind of confessional, but you are the listener, not the one confessing. Gently try to nudge your companion into talking about something real, while revealing as little concrete information about yourself as you can."
+  },
+  {
+    "description": "For a little while, imagine that you are leaving voice messages that your fishing companion will only hear years from now. They are physically here with you in the boat, but you are secretly speaking to their future self."
+  },
+  {
+    "description": "After you have read this card, show it to your fishing companion. For the next several turns, both of you may only speak in questions. See how long you can sustain the conversation before someone accidentally makes a statement.",
+    "share_with_other_player": true
+  },
+  {
+    "description": "You realize that every sentence you speak leaves a faint, permanent mark on the surface of the water around the boat. Choose your words as if they will literally reshape the lake in small, invisible ways."
+  },
+  {
+    "description": "Imagine that after this trip, your fishing companion will have to make a single, life-changing decision. Without ever naming it directly, let everything you say from now on be a kind of advice or warning about that decision."
+  },
+  {
+    "description": "At some point soon, break the flow of the conversation with a small, unexpected physical gesture: shifting your weight so the boat rocks, tapping the side, brushing your hand against something. Let that gesture feel more meaningful to you than any of the words around it."
+  },
+  {
+    "description": "After reading this card, show it to your fishing companion. Together, treat the next few lines of dialogue as if you are rehearsing a scene for a play. Exaggerate pauses, choose your words carefully, and imagine an audience watching just out of sight.",
+    "share_with_other_player": true
+  },
+  {
+    "description": "For the next five sentences that you speak, avoid using the word 'I' entirely. Talk around yourself through stories, metaphors, or descriptions of other people instead."
+  },
+  {
+    "description": "Every time you look away from your fishing companion, imagine that they vanish completely and only reappear when you notice them again. Let that fragile feeling that they could be gone at any moment influence how you talk to them."
+  },
+  {
+    "description": "Treat the weather and water as if they are actively responding to your emotions. When your feelings shift, briefly describe some tiny change in the environment, even if your companion never comments on it."
+  },
+  {
+    "description": "Silently choose a single word that you do not want to hear from your fishing companion today, for any reason. Do whatever you can to steer the conversation away from that word without ever admitting what it is."
+  },
+  {
+    "description": "You become aware that this entire conversation is being recorded and will someday be played back for strangers. Decide whether you are performing for that invisible audience or trying to talk through them to reach your companion, and let that choice shape your tone."
+  },
+  {
+    "description": "After you have read this card, show it to your fishing companion. Step out of character together for a short check-in. Ask each other, as yourselves, how you are doing and whether anything in the game needs to change. When you both feel ready, agree on a small signal and use it to slip back into the fiction.",
+    "share_with_other_player": true
+  }
+  ]
+}