calle-ai/awesome-phone-call-agents/call-cognitive-load-monitor

python3 scripts/monitor_cognitive_load.py \
  --transcript path/to/transcript.json \
  --dry-run \
  --out /tmp/load_report.json

python3 scripts/validate_load_report.py --report /tmp/load_report.json

[
  {"role": "agent",  "text": "Under the terms of sub-clause 4(b)(ii) of the agreement..."},
  {"role": "callee", "text": "Sorry, could you say that again? I'm not following."},
  {"role": "agent",  "text": "Of course. Regarding the billing section specifically..."},
  {"role": "callee", "text": "I still don't understand. What does that mean for me?"}
]

{
  "call_id": "calle-001",
  "analysis_timestamp": "2026-09-17T08:00:00Z",
  "overall_cognitive_load": "HIGH",
  "load_score": 0.78,
  "load_by_phase": {
    "opening":  0.12,
    "middle":   0.45,
    "closing":  0.78
  },
  "peak_phase": "closing",
  "overload_signals": [
    {
      "type": "repetition_request",
      "evidence": "Sorry, could you say that again?",
      "turn": 4,
      "phase": "middle",
      "weight": 0.30
    },
    {
      "type": "confusion_phrase",
      "evidence": "I still don't understand. What does that mean for me?",
      "turn": 6,
      "phase": "middle",
      "weight": 0.25
    },
    {
      "type": "jargon_density_spike",
      "evidence": "sub-clause 4(b)(ii) of the agreement",
      "turn": 3,
      "phase": "middle",
      "weight": 0.18
    }
  ],
  "interaction_dynamics": {
    "turn_imbalance_score": 0.62,
    "avg_silence_gap_ms": 2800,
    "overlap_count": 0,
    "participation_ratio": {"agent": 0.74, "callee": 0.26}
  },
  "script_patches": [
    {
      "original": "Under the terms of sub-clause 4(b)(ii) of the agreement",
      "suggested": "According to our billing rules",
      "rationale": "Legal jargon removed; Flesch-Kincaid grade reduced from 18 to 6"
    }
  ],
  "consent_validity_flag": "AT_RISK",
  "consent_validity_reason": "Load score 0.78 exceeded threshold 0.65 during closing phase where commitment was recorded.",
  "recommended_action": "SEND_WRITTEN_CONFIRMATION",
  "false_positive_disclaimer": "Cognitive load inference is probabilistic. A flagged call does not constitute a legal finding. Human review is required before any adverse action.",
  "flags": ["REQUIRES_HUMAN_REVIEW", "JARGON_DENSITY_HIGH"],
  "analysis_mode": "heuristic",
  "schema_version": "1.0"
}

usage: monitor_cognitive_load.py [-h] --transcript TRANSCRIPT
                                 [--threshold THRESHOLD]
                                 [--dry-run]
                                 [--out OUT]
 
options:
  --transcript   Path to the transcript JSON file (required)
  --threshold    Load score above which level is HIGH (default: 0.65)
  --dry-run      Analyse without side effects
  --out          Write report JSON to this path (default: stdout)

[call ends] → [transcribe] → [monitor_cognitive_load.py]
                                        ↓
                   load=HIGH → send written confirmation email
                   load=CRITICAL → schedule follow-up call with simplified script

skills/call-cognitive-load-monitor/
├── SKILL.md
├── scripts/
│   ├── monitor_cognitive_load.py      ← Main analysis runner
│   ├── validate_load_report.py        ← Output schema validator
│   └── test_cognitive_load.py         ← Test suite (50+ assertions)
└── references/
    ├── example-transcript.json        ← High-load example transcript
    ├── examples.md                    ← Usage examples
    ├── research-papers.md             ← Full citations
    └── safety.md                      ← Consent-validity ethics guide