How gca-americas/way-back-home works
Way Back Home is a narrative AI workshop platform: participants build capabilities across mission levels, while Mission Control manages events and participants and Level 2 presents a survivor network for exploration and chat. The documented journey proceeds from identity generation through location analysis and SOS handling toward rescue coordination. The graph includes the main dashboard, Level 1–5 agent stages, and Level 2’s graph/chat interface and backend. Some later-level capabilities are preserved from the README and tree; relationships are shown only where documented or supported by the supplied source index and excerpts.
Main entry points: App.tsx Network interface · main.py Mission Control API · participants.py Participant records · server.py Formation server
Components 25
Workshop missions
- Explorer identity
level_0/generator.py - Crash analysis
level_1/agent/agent.py - MCP server
level_1/mcp-server/main.py
Mission Control
- Mission Control API
dashboard/backend/app/main.py - Event management
dashboard/backend/app/routes/events.py - Participant records
dashboard/backend/app/routes/participants.py - Avatar storage
dashboard/backend/app/storage.py - Firestore data
dashboard/backend/app/database.py - Mission dashboard
dashboard/frontend/app/page.tsx - Event map
dashboard/frontend/components/EventMapClient.tsx
Survivor network
- Network interface
level_2/frontend/src/App.tsx - Graph state
level_2/frontend/src/stores/graphStore.ts - Chat panel
level_2/frontend/src/components/chat/ChatPanel.tsx - Chat input
level_2/frontend/src/components/chat/ChatInput.tsx - Graph endpoint
level_2/backend/api/routes/graph.py - Graph services
level_2/backend/services/graph_service.py - Chat endpoint
level_2/backend/api/routes/chat.py - Hybrid search
level_2/backend/services/hybrid_search_service.py - SOS uploads
level_2/backend/api/routes/upload.py
Rescue coordination
- Biometric agent
level_3/backend/app/biometric_agent/agent.py - Hazard dispatch
level_4/backend/dispatch_agent/agent.py - Formation server
level_5/agent/server.py - A2A Kafka adapter
level_5/agent/agent_to_kafka_a2a.py - Formation agent
solutions/level_5/agent/formation/agent.py
Other components
- Participant
Connections 23
- Participant → Explorer identity: creates identity
README.md - Explorer identity → Crash analysis: continues mission
README.md - Crash analysis → Network interface: continues mission
README.md - Network interface → Biometric agent: continues mission
README.md - Mission dashboard → Mission Control API: uses API
README.md - Mission Control API → Event management: mounts routes
dashboard/backend/app/main.py - Mission Control API → Participant records: mounts routes
dashboard/backend/app/main.py - Participant records → Avatar storage: uploads avatars
dashboard/backend/app/routes/participants.py - Participant records → Firestore data: uses database
dashboard/backend/app/routes/participants.py - Event management → Firestore data: uses database
dashboard/backend/app/routes/events.py - Mission dashboard → Event map: renders map
README.md - Network interface → Graph state: fetches graph
level_2/frontend/src/App.tsx - Network interface → Chat panel: renders chat
level_2/frontend/src/App.tsx - Chat panel → Chat input: renders input
level_2/frontend/src/components/chat/ChatPanel.tsx - Network interface → Graph endpoint: requests graph
- Graph endpoint → Graph services: calls service
level_2/backend/api/routes/graph.py - Chat input → Chat endpoint: sends query
- Chat endpoint → Hybrid search: searches context
- Network interface → SOS uploads: submits SOS
- Biometric agent → Hazard dispatch: continues mission
README.md - Hazard dispatch → Formation server: continues mission
README.md - Formation server → A2A Kafka adapter: creates server
level_5/agent/server.py - Formation server → Formation agent: serves agent
level_5/agent/server.py