How harshendram/firstcommit-hack works
Suraksha is a consent-aware home-care companion: watch and tablet signals or conversations enter its API, which coordinates agent responses, memory, proactive checks and policy-gated family escalation. Parents use the companion and privacy/audit views; family members get a calm dashboard, evidence-based Q&A and escalation responses. The README documents major subsystems and AWS integrations; sampled excerpts confirm selected API, escalation, state-refresh and watch messaging behavior, but do not expose every runtime call path, so uncertain wiring is omitted. The Explore world is a separate demo experience.
Main entry points: app.py Agent API · orchestrator.py Turn orchestrator · service.py Family escalation · repo.py Single-table memory
Components 25
Care surfaces
- Wear OS watch
wear-os/app/src/main/java/com/rakshak/wear - Parent web
web/src/app/parent - Family web
web/src/app/family - Command views
web/src/app/command - Explore demo
web/src/app/explore
Care runtime
- Agent API
ally/app.py - Turn orchestrator
ally/agents/orchestrator.py - Voice companion
ally/agents/companion.py - Family Q&A
ally/agents/family_qa.py - Voice processing
ally/voice
Policy and escalation
- Consent guard
ally/policy - Signal judgement
ally/scoring - Proactive care
ally/proactive - Family escalation
ally/escalation/service.py
Memory and care
- Single-table memory
ally/store/repo.py
External services
- Amazon Bedrock
- Amazon Transcribe
- Amazon Polly
- Amazon DynamoDB
- Amazon EventBridge
- AWS Step Functions
- Web Push
Other components
- Parent
- Family
- Nearby help
Connections 31
- Parent → Wear OS watch: wears and speaks
- Parent → Parent web: uses
- Family → Family web: uses
- Nearby help → Family web: responds through
- Wear OS watch → Agent API: sends signals
- Parent web → Agent API: sends turns
- Family web → Agent API: asks and replies
- Command views → Agent API: views care status
- Agent API → Turn orchestrator: dispatches turns
- Turn orchestrator → Voice companion: runs companion
- Turn orchestrator → Family Q&A: runs family Q&A
- Turn orchestrator → Voice processing: processes speech
- Voice companion → Amazon Bedrock: invokes agent model
- Family Q&A → Amazon Bedrock: invokes agent model
- Voice processing → Amazon Transcribe: transcribes speech
- Voice processing → Amazon Polly: speaks replies
- Turn orchestrator → Consent guard: guards tool calls
- Agent API → Consent guard: authorizes dashboard
- Consent guard → Single-table memory: records audit
- Turn orchestrator → Single-table memory: reads and writes facts
- Agent API → Single-table memory: reads care records
- Amazon EventBridge → Proactive care: triggers sweep
- Proactive care → Single-table memory: checks due care
- Proactive care → Signal judgement: judges signals
- Signal judgement → Amazon Bedrock: requests judgement
- Proactive care → Family escalation: starts escalation
- Family escalation → AWS Step Functions: starts workflow
- AWS Step Functions → Family escalation: dispatches callbacks
- Family escalation → Web Push: notifies contacts
- Family escalation → Single-table memory: updates lifecycle
- Explore demo → Explore demo: hosts gallery demo