Understand usersObserve

User state across sessions

Ten signals per user, carried from one session to the next.

Humane keeps a running state for every end user, from mood and energy to trust and grudge, each with its own behaviour over time. Your model finally knows whether it is talking to someone on a good day or at the end of a bad week.

user_42 · interaction 47

HumanState

  • energy0.32
  • mood0.28
  • fatigue0.71
  • boredom0.00
  • social_load0.45
  • focus0.50

Relationship

  • trust0.62
  • sentiment0.41
  • grudge0.15
  • familiarity0.58
Mood decays to neutral (5h half-life) · grudge fades twice as slowly as sentiment
Illustration of the ten signals Humane tracks per user
How it works

State that moves the way people do

Each message nudges the signals, and time pulls them back. Mood drifts to neutral with a five-hour half-life, a grudge fades at half the speed of sentiment, and trust only grows with interactions. A sudden swing is detected as a snap rather than averaged away.

  • Six HumanState variables: energy, mood, fatigue, boredom, social load and focus
  • Four relational variables: trust, sentiment, grudge and familiarity
  • Values kept between 0 and 1, stored per user and per tenant
  • Snapshots over time feed trends and anomaly baselines
user_42 · session 47

User state

  • Mood0.28
  • Trust0.71
  • Energy0.34
  • Familiarity0.82

Mood down 38% over 3 weeks

Risk

ELEVATED

“don’t know why I keep trying” → hopelessness

Safety

HOLD

Operator alerted · reply held for review

Timing

base +800ms · low_mood +1500ms

Illustration of Humane’s response for one message
The signals

What each one tells you

Every value comes back on process() responses and drives tone, timing and safety decisions.

  • Mood: how the user feels, decaying toward neutral
  • Energy: falls over time; low energy means shorter replies
  • Fatigue: builds up over time and with each response
  • Boredom: rises between messages and resets on any interaction
  • Social load: rises within a conversation and eases when idle
  • Focus: drifts back to the middle when nothing happens
  • Trust: grows a little with every interaction and never decays
  • Sentiment: how the user feels about the AI, reverting to neutral
  • Grudge: recent frustration that lingers longer than sentiment
  • Familiarity: how well the AI knows this user
In code

Read the state on every turn

The typed fields cover the most-used signals. The full set, including fatigue and grudge, is in the raw response.

python
r = client.process(user_id="user_42", message="long day. just tired.")

print(r.user.mood, r.user.energy)         # HumanState
print(r.user.trust, r.user.familiarity)   # relationship
print(r.user.interaction_count)           # e.g. 47

full = r.raw["user"]                      # all ten signals
print(full["fatigue"], full["grudge"])

User state questions

Something else? Ask us.

Every AI should know who it's talking to.

The safety and human-oversight layer for emotional AI: user state across sessions, risk alerts, safety gates and human takeover, with every decision explained.