Documentation

V2 EQ Dimensions

Synapse SDK V2 introduces 6 EQ (Emotional Intelligence) dimensions that provide deeper insight into emotional states beyond basic emotion categories. These dimensions enable more nuanced understanding and better response adaptation.

The 6 Core Emotions

Every V2 analysis returns scores (0.0-1.0) for these foundational emotions in the raw object:

Joy

Happiness, excitement, enthusiasm

Love

Affection, care, empathy, gratitude

Sadness

Sorrow, disappointment, grief

Anger

Frustration, irritation, hostility

Fear

Anxiety, worry, nervousness

Surprise

Astonishment, unexpectedness

The 6 EQ Dimensions

V2 adds these dimensions for richer emotional understanding:

1. Intensity (0.0-1.0)

The overall strength of the dominant emotion.

{
  "intensity": 0.85,
  "intensityLevel": "high"
}

// Intensity Levels:
// critical:  >= 0.9   - Overwhelming emotion
// high:      0.75-0.89 - Strong emotional response
// moderate:  0.55-0.74 - Clear but controlled
// subtle:    0.35-0.54 - Mild emotional presence
// minimal:   < 0.35   - Barely detectable

2. Valence (-1.0 to +1.0)

The emotional tone from negative to positive.

{
  "valence": 0.78  // Range: -1.0 to +1.0
}

// Interpretation:
// +1.0  = Extremely positive
// +0.5  = Moderately positive
//  0.0  = Neutral
// -0.5  = Moderately negative
// -1.0  = Extremely negative

3. Arousal (0.0-1.0)

The energy level from calm to excited.

Range	State
0.0-0.3	Calm, peaceful, low energy
0.4-0.6	Neutral, balanced energy
0.7-1.0	Excited, energized, high activity

4. Complexity

How many emotions are active simultaneously (threshold > 0.25).

{
  "complexity": "layered"
}

// Complexity Levels (based on emotions > 0.25 threshold):
// simple:       1 emotion  - Clear, focused emotion
// layered:      2 emotions - Mixed feelings
// paradoxical:  3 emotions - Complex emotional state
// transcendent: 4+ emotions - Deep, nuanced experience

5. Wonder Index (0.0-1.0)

Curiosity, openness, and desire for discovery.

Range	Meaning
0.7-1.0	High curiosity, eager to learn
0.4-0.69	Moderate interest
0.0-0.39	Low curiosity, disengaged

6. Discovery Level

The significance of the emotional moment.

Level	Intensity	Meaning
transcendent	>= 0.9	Life-changing moment
breakthrough	0.75-0.89	Significant positive shift
significant	0.55-0.74	Important emotional event
normal	0.35-0.54	Regular engagement
routine	< 0.35	Everyday emotion

Advanced V2 Features

Trajectory Tracking

Track emotional changes over time with automatic baseline analysis. Available when using context-based analysis.

{
  "trajectory": {
    "baseline": {
      "window": "week",
      "dominantEmotions": { "joy": 0.65, "love": 0.45 },
      "averageIntensity": 0.55,
      "baselineValence": 0.35,
      "emotionalVolatility": 0.18
    },
    "trend": {
      "direction": "improving",
      "valenceTrend": 0.05,
      "intensityTrend": -0.03
    },
    "breakthrough": {
      "detected": true,
      "type": "discovery_level",
      "significance": 0.85
    }
  }
}

Conversation Mode Detection

Automatically detect the appropriate conversation mode and receive response strategy guidance.

{
  "conversationMode": {
    "mode": "emotional_support",
    "confidence": 0.85,
    "responseStrategy": {
      "tone": "empathetic",
      "approach": "validation_first",
      "suggestedPhrases": ["I understand how you feel..."]
    }
  }
}

// Available Modes:
// crisis_intervention - High fear/anger, escalating
// emotional_support   - Sadness, vulnerability
// analytical_deep_dive - High complexity, curiosity
// goal_strategy       - Joy + anticipation
// task_execution      - Focused arousal
// information_retrieval - Curiosity, questions
// conversational      - Balanced state

Additional V2 Features

Growth Tracking:Measure emotional intelligence development over time with dimension-specific progress.
Pattern Detection:Identify temporal, trigger-based, cyclical, sequential, and recovery patterns.
Belief Detection:Extract user beliefs (identity, value, capability, relational) from conversation.
Hostility Detection:Safety monitoring with recommended response strategies for escalating situations.

Next: See Emotion APIs for full endpoint documentation, or Guides for practical implementation examples.