Nefesh

http

Real-time human state awareness for AI agents. Fuses biometric signals into a unified stress score (0-100) via Streamable HTTP.

Install

npm install -g @nefesh/cli

request_api_key Request a free API key. You MUST ask the user for their real email first. Do not invent or guess emails. The user receives a verification link they must click. Poll with check_api_key_status until ready.
check_api_key_status Poll for API key activation using the same email the user provided. Returns pending or ready with API key.
get_human_state Get stress state (0-100), suggested_action (maintain/simplify/de-escalate/pause), and adaptation_effectiveness — a closed-loop showing whether your previous action reduced stress.
ingest Send biometric signals (heart rate, HRV, voice tone, expression, sentiment, 30+ fields) and get unified state back. Include subject_id for trigger memory.
get_trigger_memory Get psychological trigger profile — which topics cause stress (active) and which have been resolved over time.
get_session_history Get timestamped state history with trend (rising/falling/stable).