State Mapping

Unified State Labels

Nefesh maps the fused stress score (0-100) to five states with default LLM behavior recommendations:

ScoreStatesuggested_actionDefault Recommendation
0–19Calmmaintain_engagementFull complexity permitted. Push deeper, challenge assumptions.
20–39Relaxedmaintain_engagement3-5 sentences, maintain complexity.
40–59Focusedsimplify_and_focus2-3 sentences, actionable only.
60–79Stressedde-escalate_and_shortenMax 2 sentences, direct.
80–100Acute Stresspause_and_groundMax 1 sentence, single directive.

Custom Behavior Profiles

Override the default recommendation by setting set_behavior_profile in your application logic. The state label and score remain consistent — only the recommended LLM behavior changes.

Closed-loop feedback: On the 2nd+ call in a session, the response includes adaptation_effectiveness showing whether the previous suggested_action reduced stress. Your agent can use this to self-correct in real time.