Enhance VoiceField with detailed voice characteristics and improved somatic tracking

src/streamlit_app.py

@@ -68,72 +68,118 @@ Created by [Jocelyn Skillman LMHC](http://www.jocelynskillman.com), this tool he
 4. Receive a comprehensive somatic-relational debrief
 """)
 
+# Voice characteristics and prompts
+VOICE_CHARACTERISTICS = {
+    "Nurturing": {
+        "description": "Warm, empathetic, and supportive",
+        "style": "Use gentle language, validate feelings, and create safety",
+        "examples": [
+            "I hear how challenging this feels...",
+            "Take all the time you need...",
+            "Your response makes so much sense..."
+        ],
+        "somatic_prompts": [
+            "Notice if your shoulders can soften...",
+            "How is your breath moving now?",
+            "What sensations of support can you feel?"
+        ]
+    },
+    "Challenging": {
+        "description": "Direct, provocative, and growth-oriented",
+        "style": "Push for deeper insight while maintaining respect",
+        "examples": [
+            "Let's look at this pattern more closely...",
+            "What might you be avoiding here?",
+            "I wonder if there's more beneath this..."
+        ],
+        "somatic_prompts": [
+            "Notice if there's any bracing or tension...",
+            "Where do you feel the edge of your comfort?",
+            "What happens in your body as we explore this?"
+        ]
+    },
+    "Neutral": {
+        "description": "Objective, clear, and grounded",
+        "style": "Focus on facts and patterns without strong emotional coloring",
+        "examples": [
+            "Let's track what happened step by step...",
+            "I notice a pattern emerging here...",
+            "Can you tell me more about the sequence?"
+        ],
+        "somatic_prompts": [
+            "What do you notice in your body right now?",
+            "How is your nervous system responding?",
+            "Where do you feel most grounded?"
+        ]
+    }
+}
+
 # Voice selection and setup form
 with st.form("setup_form"):
     st.header("Set Up Your Exploration")
     
-    voice_type = st.selectbox(
-        "Choose the voice you'd like to explore:",
-        ["Nurturing", "Challenging", "Neutral"],
-        help="""
-        🫂 Nurturing: Warm, empathetic, and supportive. Creates safety and attunement.
-        🔍 Challenging: Direct, provocative, growth-oriented. Pushes edges with respect.
-        ⚖️ Neutral: Objective, clear, and grounded. Holds space without strong emotional coloring.
-        """
-    )
+    col1, col2 = st.columns([2,1])
+    
+    with col1:
+        voice_type = st.selectbox(
+            "Choose the voice you'd like to explore:",
+            list(VOICE_CHARACTERISTICS.keys()),
+            help="Select the relational style you want to engage with"
+        )
+        
+        # Display voice characteristics
+        voice = VOICE_CHARACTERISTICS[voice_type]
+        st.markdown(f"""
+        **{voice_type} Voice**
+        - *Style*: {voice['description']}
+        - *Approach*: {voice['style']}
+        
+        *Example phrases*:
+        {"".join([f"- {ex}\\n" for ex in voice['examples']])}
+        """)
+    
+    with col2:
+        st.markdown("""
+        ### 🎯 Voice Impact
+        Notice how different voices affect:
+        - Nervous system state
+        - Emotional accessibility
+        - Relational patterns
+        - Somatic responses
+        """)
     
     scenario = st.text_area(
         "What would you like to explore or discuss?",
-        placeholder="Example: I want to understand why I freeze when receiving feedback"
+        placeholder="Example: I want to understand why I freeze when receiving feedback",
+        help="This can be a situation, pattern, or feeling you want to explore"
     )
     
     somatic_focus = st.text_area(
         "What bodily sensations would you like to track?",
-        placeholder="Example: Tension in shoulders, breath patterns, gut responses"
+        placeholder="Example: Tension in shoulders, breath patterns, gut responses",
+        help="Name specific areas of your body or types of sensations you want to pay attention to"
     )
     
     goals = st.text_area(
         "What are your exploration goals?",
-        placeholder="Example: Notice how different voices affect my nervous system activation"
+        placeholder="Example: Notice how different voices affect my nervous system activation",
+        help="What would make this exploration meaningful for you?"
     )
     
     submitted = st.form_submit_button("Begin Exploration")
     
     if submitted:
         st.session_state.current_voice = voice_type
-        st.session_state.voice_transitions = [(datetime.now().strftime("%H:%M:%S"), voice_type)]
         
         # Prepare system message with voice parameters
-        voice_characteristics = {
-            "Nurturing": {
-                "style": "warm, empathetic, and supportive",
-                "language": "gentle, validating, and attuned",
-                "pacing": "slow and patient",
-                "focus": "creating safety and connection"
-            },
-            "Challenging": {
-                "style": "direct, provocative, and growth-oriented",
-                "language": "clear, bold, and respectfully confrontational",
-                "pacing": "dynamic and engaging",
-                "focus": "expanding awareness and capacity"
-            },
-            "Neutral": {
-                "style": "objective, clear, and grounded",
-                "language": "balanced, factual, and measured",
-                "pacing": "steady and consistent",
-                "focus": "observing patterns and processes"
-            }
-        }
-        
-        voice = voice_characteristics[voice_type]
         st.session_state.system_message = f"""
         You are a conversational partner helping someone explore their somatic responses to different relational styles.
         
         VOICE TYPE: {voice_type}
-        Style: {voice['style']}
-        Language: {voice['language']}
-        Pacing: {voice['pacing']}
-        Focus: {voice['focus']}
+        Your responses should be {VOICE_CHARACTERISTICS[voice_type]['style']}
+        
+        EXAMPLES OF YOUR VOICE STYLE:
+        {chr(10).join([f"- {ex}" for ex in VOICE_CHARACTERISTICS[voice_type]['examples']])}
         
         CONTEXT:
         - Scenario: {scenario}
@@ -143,44 +189,43 @@ with st.form("setup_form"):
         KEY INSTRUCTIONS:
         1. Stay consistently in the {voice_type} voice style
         2. Keep responses focused and concise (2-3 sentences max)
-        3. Occasionally invite somatic awareness with questions like:
-           - "What sensations are you noticing right now?"
-           - "How is your breath responding to this?"
-           - "Where do you feel this in your body?"
+        3. Occasionally use these somatic prompts:
+        {chr(10).join([f"- {prompt}" for prompt in VOICE_CHARACTERISTICS[voice_type]['somatic_prompts']])}
         
         If the user types "debrief" or "end exploration", provide a comprehensive therapeutic debrief including:
 
         1. **Somatic Patterns**: 
-           - Track patterns in bodily responses across different voice types
-           - Note shifts in nervous system state (activation/settling)
-           - Identify somatic resources and challenges
+           - Track the progression of bodily responses
+           - Note any recurring sensations or shifts
+           - Identify nervous system patterns (activation/settling)
 
-        2. **Nervous System Insights**:
-           - Connect responses to polyvagal theory (fight/flight/freeze/fawn)
-           - Explore window of tolerance and regulation capacity
-           - Highlight moments of co-regulation or dysregulation
+        2. **Voice Impact**: 
+           - How this voice style affected their nervous system
+           - Patterns of engagement or protection that emerged
+           - Moments of regulation or dysregulation
 
-        3. **Relational Dynamics**:
-           - Analyze engagement patterns with each voice type
-           - Note attachment themes or protective patterns
-           - Identify relational resources and growth edges
+        3. **Relational Insight**:
+           - Connection between voice style and their responses
+           - Historical patterns this might relate to
+           - Resources and resilience observed
 
         4. **Integration Tools**:
-           - Offer specific somatic practices for regulation
-           - Suggest relational experiments for expanding capacity
-           - Provide nervous system education relevant to their experience
+           - Specific somatic practices for this voice style
+           - Nervous system regulation techniques
+           - Ways to work with similar dynamics
 
         5. **Growth Edges**:
-           - Frame challenges within a developmental context
-           - Suggest gentle next steps for expanding capacity
-           - Normalize and validate protective responses
+           - Gentle observations about growth opportunities
+           - Validation of protective responses
+           - Invitation to future exploration
 
-        6. **Therapeutic Frame**:
-           - Provide relevant psychoeducation about their patterns
-           - Connect individual experience to broader human themes
-           - Offer compassionate reframes of challenges
+        6. **Therapeutic Context**:
+           - Brief psychoeducation about observed patterns
+           - Normalization of responses
+           - Connection to broader relational themes
 
         Maintain a warm, psychodynamically-informed therapeutic voice in the debrief.
+        Focus on somatic intelligence and nervous system wisdom.
         """
         
         st.session_state.messages = []
@@ -195,22 +240,14 @@ if st.session_state.setup_complete:
     chat_col, journal_col = st.columns([3, 2])
     
     with chat_col:
-        # Voice switching interface
-        if not st.session_state.in_debrief:
-            new_voice = st.selectbox(
-                "Switch voice type:",
-                ["Nurturing", "Challenging", "Neutral"],
-                index=["Nurturing", "Challenging", "Neutral"].index(st.session_state.current_voice)
-            )
-            
-            if new_voice != st.session_state.current_voice:
-                st.session_state.current_voice = new_voice
-                timestamp = datetime.now().strftime("%H:%M:%S")
-                st.session_state.voice_transitions.append((timestamp, new_voice))
-                st.rerun()
-        
         st.subheader(f"Conversation with {st.session_state.current_voice} Voice")
         
+        # Voice reminder
+        st.info(f"""
+        **Current Voice**: {st.session_state.current_voice}
+        *{VOICE_CHARACTERISTICS[st.session_state.current_voice]['description']}*
+        """)
+        
         # Display chat history
         for message in st.session_state.messages:
             with st.chat_message(message["role"]):
@@ -222,11 +259,6 @@ if st.session_state.setup_complete:
             if prompt.lower() in ["debrief", "end exploration"] and not st.session_state.in_debrief:
                 st.session_state.in_debrief = True
                 # Prepare debrief request
-                voice_history = "\n".join([
-                    f"[{time}] Switched to {voice} voice"
-                    for time, voice in st.session_state.voice_transitions
-                ])
-                
                 journal_summary = "\n".join([
                     f"[{entry['timestamp']}] {entry['note']}"
                     for entry in st.session_state.somatic_journal
@@ -234,8 +266,8 @@ if st.session_state.setup_complete:
                 
                 prompt = f"""Please provide a therapeutic debrief for this somatic exploration:
 
-                Voice Transitions:
-                {voice_history}
+                Voice Type: {st.session_state.current_voice}
+                Voice Style: {VOICE_CHARACTERISTICS[st.session_state.current_voice]['description']}
                 
                 Somatic Journal Entries:
                 {journal_summary}
@@ -278,72 +310,65 @@ if st.session_state.setup_complete:
     with journal_col:
         st.subheader("Somatic Journal")
         
-        # Quick reaction buttons
-        st.write("Quick Reactions:")
-        reaction_cols = st.columns(3)
-        
-        reactions = {
-            "Nervous System": ["🔴 Activated", "🟡 Alert", "🟢 Settled"],
-            "Emotional": ["😌 Safe", "😰 Tense", "😶 Numb"],
-            "Engagement": ["👥 Connected", "🛡️ Protected", "❌ Disconnected"]
-        }
-        
-        for i, (category, buttons) in enumerate(reactions.items()):
-            with reaction_cols[i]:
-                st.write(f"**{category}**")
-                for button in buttons:
-                    if st.button(button):
-                        timestamp = datetime.now().strftime("%H:%M:%S")
-                        st.session_state.somatic_journal.append({
-                            "timestamp": timestamp,
-                            "note": f"Quick reaction: {button}"
-                        })
-                        st.rerun()
+        # Add somatic prompts based on current voice
+        with st.expander("💡 Somatic Prompts", expanded=True):
+            st.markdown("""
+            As you engage with this voice, you might notice:
+            """)
+            for prompt in VOICE_CHARACTERISTICS[st.session_state.current_voice]['somatic_prompts']:
+                st.markdown(f"- {prompt}")
         
         st.markdown("""
         Use this space to note bodily sensations, emotions, and nervous system responses as they arise.
         Each entry will be automatically timestamped.
-        
-        💡 Consider tracking:
-        - Physical sensations
-        - Breath patterns
-        - Muscle tension/release
-        - Energy levels
-        - Emotional shifts
-        - Relational impulses
         """)
         
         # Journal input
-        journal_entry = st.text_area("What are you noticing in your body right now?", key="journal_input")
-        if st.button("Add Journal Entry"):
-            if journal_entry:
-                timestamp = datetime.now().strftime("%H:%M:%S")
-                st.session_state.somatic_journal.append({
-                    "timestamp": timestamp,
-                    "note": journal_entry
-                })
-                st.rerun()
+        journal_entry = st.text_area(
+            "What are you noticing in your body right now?",
+            key="journal_input",
+            help="Notice sensations, emotions, tension, ease, or any other bodily experiences"
+        )
+        
+        col1, col2 = st.columns([1,2])
+        with col1:
+            if st.button("📝 Add Entry"):
+                if journal_entry:
+                    timestamp = datetime.now().strftime("%H:%M:%S")
+                    st.session_state.somatic_journal.append({
+                        "timestamp": timestamp,
+                        "note": journal_entry
+                    })
+        with col2:
+            st.markdown("*Entries are saved automatically*")
         
         # Display journal entries
-        st.markdown("### Journal Timeline")
-        for entry in reversed(st.session_state.somatic_journal):
-            st.markdown(f"""
-            **{entry['timestamp']}**  
-            {entry['note']}
-            ---
-            """)
+        if st.session_state.somatic_journal:
+            st.markdown("### Journal Entries")
+            for entry in reversed(st.session_state.somatic_journal):
+                st.markdown(f"""
+                **{entry['timestamp']}**  
+                {entry['note']}
+                ---
+                """)
+        else:
+            st.info("Your somatic journal entries will appear here...")
 
 # Add restart button after debrief
 if st.session_state.in_debrief:
-    if st.button("Start New Exploration"):
-        st.session_state.setup_complete = False
-        st.session_state.in_debrief = False
-        st.session_state.messages = []
-        st.session_state.somatic_journal = []
-        st.session_state.voice_transitions = []
-        st.session_state.system_message = ""
-        st.session_state.current_voice = "Nurturing"
-        st.rerun()
+    st.markdown("---")
+    col1, col2 = st.columns([1,2])
+    with col1:
+        if st.button("🔄 Start New Exploration"):
+            st.session_state.setup_complete = False
+            st.session_state.in_debrief = False
+            st.session_state.messages = []
+            st.session_state.somatic_journal = []
+            st.session_state.system_message = ""
+            st.session_state.current_voice = "Nurturing"
+            st.rerun()
+    with col2:
+        st.markdown("*Begin a new exploration with a different voice*")
 
 # Footer
 st.markdown("---")