v0.3.0 — Simulation v2: Conversations, Cognition, and Fidelity

v0.3.0 — Simulation v2: Conversations, Cognition, and Fidelity

Major release bringing multi-turn agent conversations, cognitive self-awareness, and fidelity-tiered simulation.

🗣️ Phase D: Conversations & Social Posts

• Agent-agent conversations: Agents can now talk_to each other during simulation, with multi-turn LLM-driven dialogue
• Agent-NPC conversations: Agents talk to household dependents (kids, elderly parents) as NPCs with generated profiles
• Conversation state changes: Conversations update sentiment, conviction, and internal reactions
• Social posts: Agents can broadcast to their network via social media posts
• Priority scoring: Conversations prioritized by relationship weight × edge strength

🧠 Phase E: Cognitive Architecture

• Emotional trajectory: Agents aware of their emotional arc ("I've been getting more anxious")
• Conviction self-awareness: Agents track certainty changes ("I've been firm but my certainty is slipping")
• Repetition detection: Trigram Jaccard similarity detects stale reasoning, nudges agents to go deeper
• THINK vs SAY separation: High-fidelity mode separates internal monologue from public statements

⚡ Phase F: Fidelity Tiers

• Three tiers: low (fast/cheap), medium (balanced), high (full cognitive features)
• Merged-pass reasoning: Single LLM call for low/medium fidelity vs two-pass for high
• Cost optimization: 3-10x cost reduction at lower fidelity with graceful degradation

🔄 Phase C: Contagion & Timeline Events

• Timeline events: Inject events at specific timesteps (protests, counter-petitions, lawsuits)
• Merged-pass schema: Combined role-play + classification in single call
• Conviction-aware sharing: High-conviction agents more likely to spread information

🏠 Household & Identity

• Household sampling: agent_focus controls who is simulated vs NPC (families, couples, individuals)
• LLM-researched configs: NameConfig and HouseholdConfig generated per-population for cultural accuracy
• Partner/dependent relationships: Structural edges and shared attributes within households

🔧 Fixes & Improvements

• Azure OpenAI compatibility: Full schema compliance (additionalProperties: false, complete required arrays)
• Persona rendering: Fixed duplicate sections, added punctuation
• agent_focus prompt: Clarified household sampling mode semantics

Validation

• ruff check . ✓
• ruff format --check . ✓
• pytest -q — 811 passed

Breaking Changes

• Simulation schemas updated for Azure compatibility (no user-facing changes)
• agent_focus keywords now control household sampling modes

Migration

No migration required from v0.2.x. New features are additive.