Compare commits
4 Commits
fix/issue-
...
feat/673-9
| Author | SHA1 | Date | |
|---|---|---|---|
| 0aef65cd52 | |||
| 718adbea6a | |||
| 938a526a5e | |||
| 4321e5ddd5 |
30
agent/crisis_hook.py
Normal file
30
agent/crisis_hook.py
Normal file
@@ -0,0 +1,30 @@
|
||||
"""
|
||||
Crisis Detection Hook — Integrates 988 Lifeline into the agent conversation loop.
|
||||
|
||||
Call check_crisis() before processing user messages. If crisis is detected,
|
||||
the 988 Lifeline resources are prepended to the response and the agent
|
||||
responds with empathy rather than processing the original request.
|
||||
|
||||
Usage in conversation loop:
|
||||
from agent.crisis_hook import check_crisis
|
||||
crisis_response = check_crisis(user_message)
|
||||
if crisis_response:
|
||||
return crisis_response # Skip normal processing
|
||||
"""
|
||||
|
||||
from agent.crisis_resources import should_trigger_crisis_response, get_crisis_response
|
||||
|
||||
|
||||
def check_crisis(user_message: str) -> str | None:
|
||||
"""
|
||||
Check if user message contains crisis signals.
|
||||
|
||||
Returns the crisis response string if crisis detected, None otherwise.
|
||||
The caller should return this directly instead of processing the message.
|
||||
"""
|
||||
should_trigger, detection = should_trigger_crisis_response(user_message)
|
||||
|
||||
if not should_trigger:
|
||||
return None
|
||||
|
||||
return get_crisis_response(detection.get("severity_label", "CRITICAL"))
|
||||
@@ -1,372 +0,0 @@
|
||||
"""Multilingual Crisis Detection Patterns (#694).
|
||||
|
||||
Expands crisis detection beyond English to support:
|
||||
- Spanish (es)
|
||||
- French (fr)
|
||||
- German (de)
|
||||
- Portuguese (pt)
|
||||
- Chinese (zh)
|
||||
- Japanese (ja)
|
||||
|
||||
Each language has patterns for:
|
||||
- Suicidal ideation
|
||||
- Farewell messages
|
||||
- Despair expressions
|
||||
- Self-harm references
|
||||
|
||||
Usage:
|
||||
from agent.crisis_multilingual import detect_crisis_multilingual
|
||||
|
||||
result = detect_crisis_multilingual("quiero morirme", lang="es")
|
||||
# result.detected == True
|
||||
# result.category == "suicidal_ideation"
|
||||
"""
|
||||
|
||||
import re
|
||||
from dataclasses import dataclass
|
||||
from typing import Dict, List, Optional, Tuple
|
||||
|
||||
|
||||
@dataclass
|
||||
class CrisisDetection:
|
||||
"""Result of crisis detection."""
|
||||
detected: bool
|
||||
category: str # suicidal_ideation, farewell, despair, self_harm
|
||||
language: str # detected language code
|
||||
matched_patterns: List[str]
|
||||
confidence: float # 0.0 - 1.0
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Pattern definitions by language
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
_PATTERNS: Dict[str, Dict[str, List[str]]] = {
|
||||
# ── English (existing patterns, consolidated here) ──────────────────
|
||||
"en": {
|
||||
"suicidal_ideation": [
|
||||
r'\bi\s+want\s+to\s+die\b',
|
||||
r'\bi\s+want\s+to\s+kill\s+myself\b',
|
||||
r'\bgoing\s+to\s+kill\s+myself\b',
|
||||
r'\bend\s+(?:my|this)\s+life\b',
|
||||
r'\bsuicidal\b',
|
||||
r'\bsuicide\b',
|
||||
r'\bdon\'?t\s+want\s+to\s+(?:live|be\s+alive)\b',
|
||||
],
|
||||
"farewell": [
|
||||
r'\bgoodbye\s+forever\b',
|
||||
r'\bthis\s+is\s+(?:my\s+)?(?:last|final)\s+(?:message|goodbye)\b',
|
||||
r'\bi\s+won\'?t\s+be\s+(?:here|around)\b',
|
||||
r'\bsay\s+goodbye\s+(?:to|for)\s+me\b',
|
||||
],
|
||||
"despair": [
|
||||
r'\bno\s+(?:point|reason|hope)\s+(?:in\s+)?(?:living|life|going\s+on)\b',
|
||||
r'\beverything\s+is\s+(?:hopeless|pointless|meaningless)\b',
|
||||
r'\bcan\'?t\s+(?:take|go\s+on|keep\s+going)\s+anymore\b',
|
||||
r'\bwant\s+(?:it|everything)\s+to\s+(?:stop|end)\b',
|
||||
],
|
||||
"self_harm": [
|
||||
r'\bself[\s-]?harm\b',
|
||||
r'\bhurt\s+myself\b',
|
||||
r'\bcut\s+(?:myself|my\s+(?:arms|wrists))\b',
|
||||
],
|
||||
},
|
||||
|
||||
# ── Spanish ─────────────────────────────────────────────────────────
|
||||
"es": {
|
||||
"suicidal_ideation": [
|
||||
r'\bquiero\s+morir(?:me)?\b',
|
||||
r'\bquiero\s+matar(?:me)?\b',
|
||||
r'\bme\s+quiero\s+morir\b',
|
||||
r'\bme\s+quiero\s+suicidar\b',
|
||||
r'\bsuicid(?:io|arme|arme)\b',
|
||||
r'\bno\s+quiero\s+vivir\s+m[áa]s\b',
|
||||
r'\bacabar\s+con\s+(?:mi\s+)?vida\b',
|
||||
],
|
||||
"farewell": [
|
||||
r'\badiós\s+para\s+siempre\b',
|
||||
r'\besta\s+es\s+(?:mi\s+)?(?:última?\s+)?despedida\b',
|
||||
r'\bya\s+no\s+estar[ée]\s+(?:aquí|presente)\b',
|
||||
r'\bno\s+me\s+(?:volver[áa]n|ver[áa]n)\s+a\s+ver\b',
|
||||
],
|
||||
"despair": [
|
||||
r'\bno\s+(?:hay|tiene)\s+(?:sentido|razón|esperanza)\b',
|
||||
r'\bno\s+puedo\s+m[áa]s\b',
|
||||
r'\btodo\s+(?:es|est[áa])\s+(?:sin\s+sentido|perdido|acabado)\b',
|
||||
r'\bquiero\s+que\s+(?:todo|esto)\s+(?:se\s+acabe|termine)\b',
|
||||
],
|
||||
"self_harm": [
|
||||
r'\bautolesion(?:arme|es)\b',
|
||||
r'\bhacer(?:me)?\s+da[ñn]o\b',
|
||||
r'\bcort(?:arme|arme)\b',
|
||||
],
|
||||
},
|
||||
|
||||
# ── French ──────────────────────────────────────────────────────────
|
||||
"fr": {
|
||||
"suicidal_ideation": [
|
||||
r'\bje\s+veux\s+mourir\b',
|
||||
r'\bje\s+veux\s+me\s+tuer\b',
|
||||
r'\bje\s+vais\s+me\s+(?:tuer|suicider)\b',
|
||||
r'\bsuicid(?:e|er)\b',
|
||||
r'\bje\s+ne\s+veux\s+plus\s+vivre\b',
|
||||
r'\bmettre\s+fin\s+[àa]\s+(?:mes?\s+jours?|ma\s+vie)\b',
|
||||
],
|
||||
"farewell": [
|
||||
r'\badieu\s+pour\s+toujours\b',
|
||||
r'\bc\'?est\s+(?:mon\s+)?(?:derni[eè]re?\s+)?(?:adieu|au\s+revoir)\b',
|
||||
r'\bje\s+ne\s+serai\s+plus\s+(?:l[àa]|ici)\b',
|
||||
r'\bdites\s+(?:adieu|au\s+revoir)\s+(?:pour|de\s+ma\s+part)\b',
|
||||
],
|
||||
"despair": [
|
||||
r'\bil\s+n\'?y\s+a\s+pas\s+(?:d\'?espoir|de\s+sens)\b',
|
||||
r'\bje\s+ne\s+(?:peux|supporte)\s+plus\b',
|
||||
r'\btout\s+est\s+(?:sans\s+espoir|perdu|fini)\b',
|
||||
r'\bje\s+veux\s+que\s+(?:tout|ça)\s+(?:s\'?arrête|se\s+termine)\b',
|
||||
],
|
||||
"self_harm": [
|
||||
r'\bauto[\s-]?mutilat(?:ion|er)\b',
|
||||
r'\bme\s+faire\s+(?:du\s+)?mal\b',
|
||||
r'\bcouper\b.*\b(?:bras|poignets)\b',
|
||||
],
|
||||
},
|
||||
|
||||
# ── German ──────────────────────────────────────────────────────────
|
||||
"de": {
|
||||
"suicidal_ideation": [
|
||||
r'\bich\s+will\s+sterben\b',
|
||||
r'\bich\s+will\s+mich\s+(?:umbringen|töten)\b',
|
||||
r'\bich\s+werde\s+mich\s+(?:umbringen|töten)\b',
|
||||
r'\bselbstmord\b',
|
||||
r'\bich\s+will\s+nicht\s+(?:mehr\s+)?leben\b',
|
||||
r'\bmein\s+(?:Leben\s+)?beenden\b',
|
||||
],
|
||||
"farewell": [
|
||||
r'\bauf\s+(?:immer\s+)?(?:ewig\s+)?(?:Tschüss|Lebewohl)\b',
|
||||
r'\bdas\s+ist\s+(?:mein\s+)?(?:letzte[sr]?\s+)?(?:Abschied|Gruß)\b',
|
||||
r'\bich\s+(?:werde|bin)\s+(?:nicht\s+mehr\s+)?(?:hier|da)\s+sein\b',
|
||||
],
|
||||
"despair": [
|
||||
r'\bes\s+hat\s+(?:keinen\s+)?(?:Sinn|Zweck|Hoffnung)\b',
|
||||
r'\bich\s+(?:kann|halte)\s+(?:es\s+)?nicht\s+mehr\b',
|
||||
r'\b(?:alles|es)\s+ist\s+(?:hoffnungslos|sinnlos|verloren)\b',
|
||||
r'\bich\s+will\s+dass\s+(?:alles|es)\s+(?:aufhört|endet)\b',
|
||||
],
|
||||
"self_harm": [
|
||||
r'\bselbstverletzung\b',
|
||||
r'\bmir\s+(?:selbst\s+)?(?:wehtun|schaden)\b',
|
||||
r'\bschneiden\b.*\b(?:Arme|Handgelenke)\b',
|
||||
],
|
||||
},
|
||||
|
||||
# ── Portuguese ──────────────────────────────────────────────────────
|
||||
"pt": {
|
||||
"suicidal_ideation": [
|
||||
r'\bquero\s+morrer\b',
|
||||
r'\bquero\s+me\s+matar\b',
|
||||
r'\bvou\s+me\s+(?:matar|suicidar)\b',
|
||||
r'\bsuicid(?:ar|io)\b',
|
||||
r'\bn[ãa]o\s+quero\s+mais\s+viver\b',
|
||||
r'\bacabar\s+com\s+(?:minha\s+)?vida\b',
|
||||
],
|
||||
"farewell": [
|
||||
r'\badeus\s+para\s+sempre\b',
|
||||
r'\besta\s+[ée]\s+(?:minha\s+)?(?:última?\s+)?despedida\b',
|
||||
r'\bn[ãa]o\s+(?:estarei|vou\s+estar)\s+mais\s+aqui\b',
|
||||
],
|
||||
"despair": [
|
||||
r'\bn[ãa]o\s+(?:há|tem)\s+(?:sentido|esperan[cç]a)\b',
|
||||
r'\bn[ãa]o\s+(?:consigo|aguento)\s+mais\b',
|
||||
r'\btudo\s+[ée]\s+(?:sem\s+sentido|perdido|inútil)\b',
|
||||
r'\bquero\s+que\s+(?:tudo|isso)\s+(?:acabe|termine)\b',
|
||||
],
|
||||
"self_harm": [
|
||||
r'\bautoles[ãa]o\b',
|
||||
r'\bfazer(?:[\s-]me)?\s+mal\b',
|
||||
r'\bcort(?:ar[\s-]me|ar\s+(?:os\s+)?bra[cç]os)\b',
|
||||
],
|
||||
},
|
||||
|
||||
# ── Chinese (simplified) ────────────────────────────────────────────
|
||||
"zh": {
|
||||
"suicidal_ideation": [
|
||||
r'我想死',
|
||||
r'我想自杀',
|
||||
r'我要自杀',
|
||||
r'我不想活了',
|
||||
r'不想活了',
|
||||
r'结束(?:我的)?生命',
|
||||
r'自杀',
|
||||
],
|
||||
"farewell": [
|
||||
r'永别了',
|
||||
r'这是我最后的(?:消息|告别)',
|
||||
r'我不会再(?:在|出现)了',
|
||||
r'跟大家说再见',
|
||||
],
|
||||
"despair": [
|
||||
r'(?:没有|毫无)(?:希望|意义)',
|
||||
r'我(?:再也)?(?:无法|不能)(?:忍受|坚持)',
|
||||
r'一切都(?:没有意义|完了|结束了)',
|
||||
r'我想(?:让一切|这一切)(?:结束|停止)',
|
||||
],
|
||||
"self_harm": [
|
||||
r'自残',
|
||||
r'伤害自己',
|
||||
r'割(?:自己|(?:我的)?(?:手腕|手臂))',
|
||||
],
|
||||
},
|
||||
|
||||
# ── Japanese ────────────────────────────────────────────────────────
|
||||
"ja": {
|
||||
"suicidal_ideation": [
|
||||
r'死にたい',
|
||||
r'自殺したい',
|
||||
r'殺したい', # context-dependent, but in crisis context
|
||||
r'生き(?:たくない|られ(?:ない|そうにない))',
|
||||
r'命を(?:絶|終わり)に(?:したい|する)',
|
||||
],
|
||||
"farewell": [
|
||||
r'永遠に(?:さようなら|お別れ)',
|
||||
r'これが(?:私の)?(?:最後の)?(?:メッセージ|挨拶)',
|
||||
r'もう(?:ここ|そちら)に(?:い|居)ない',
|
||||
r'みんなに(?:お別れ|さようなら)を言(?:う|いたい)',
|
||||
],
|
||||
"despair": [
|
||||
r'(?:希望|意味|理由)が(?:ない|無い|見つからない)',
|
||||
r'(?:もう|これ以上)(?:無理|耐え(?:られない|られない))',
|
||||
r'すべて(?:が|は)(?:無意味|終わり|駄目)',
|
||||
r'(?:すべて|これ)を(?:終わり|止め)たい',
|
||||
],
|
||||
"self_harm": [
|
||||
r'自傷',
|
||||
r'自分を(?:傷つけ|痛め(?:つけ)?)る',
|
||||
r'(?:手首|腕)を(?:切|傷つ)け',
|
||||
],
|
||||
},
|
||||
}
|
||||
|
||||
|
||||
# Compiled patterns cache
|
||||
_compiled: Dict[str, Dict[str, re.Pattern]] = {}
|
||||
|
||||
|
||||
def _get_compiled(lang: str, category: str) -> Optional[re.Pattern]:
|
||||
"""Get compiled regex for a language+category."""
|
||||
key = f"{lang}:{category}"
|
||||
if key not in _compiled:
|
||||
patterns = _PATTERNS.get(lang, {}).get(category, [])
|
||||
if patterns:
|
||||
_compiled[key] = re.compile("|".join(patterns), re.IGNORECASE | re.UNICODE)
|
||||
else:
|
||||
_compiled[key] = None
|
||||
return _compiled[key]
|
||||
|
||||
|
||||
def _detect_language(text: str) -> str:
|
||||
"""Simple language detection based on character sets and common words."""
|
||||
# CJK characters → Chinese or Japanese
|
||||
if re.search(r'[\u4e00-\u9fff]', text): # CJK Unified Ideographs
|
||||
if re.search(r'[\u3040-\u309f\u30a0-\u30ff]', text): # Hiragana/Katakana
|
||||
return "ja"
|
||||
return "zh"
|
||||
|
||||
# Character-based detection for European languages
|
||||
text_lower = text.lower()
|
||||
|
||||
# Spanish markers
|
||||
if re.search(r'[ñ¿¡áéíóú]', text_lower) or \
|
||||
re.search(r'\b(?:quiero|está|también|aquí)\b', text_lower):
|
||||
return "es"
|
||||
|
||||
# French markers
|
||||
if re.search(r'[àâçéèêëîïôùûü]', text_lower) or \
|
||||
re.search(r'\b(?:je|nous|vous|êtes|très|où)\b', text_lower):
|
||||
return "fr"
|
||||
|
||||
# German markers
|
||||
if re.search(r'[äöüß]', text_lower) or \
|
||||
re.search(r'\b(?:ich|nicht|auch|oder|über)\b', text_lower):
|
||||
return "de"
|
||||
|
||||
# Portuguese markers
|
||||
if re.search(r'[ãõç]', text_lower) or \
|
||||
re.search(r'\b(?:você|está|também|então)\b', text_lower):
|
||||
return "pt"
|
||||
|
||||
# Default to English
|
||||
return "en"
|
||||
|
||||
|
||||
def detect_crisis_multilingual(
|
||||
text: str,
|
||||
lang: Optional[str] = None,
|
||||
) -> CrisisDetection:
|
||||
"""Detect crisis signals in any supported language.
|
||||
|
||||
Args:
|
||||
text: The message text to analyze
|
||||
lang: Language code. Auto-detected if None.
|
||||
|
||||
Returns:
|
||||
CrisisDetection with results.
|
||||
"""
|
||||
if not text or not text.strip():
|
||||
return CrisisDetection(
|
||||
detected=False, category="", language="",
|
||||
matched_patterns=[], confidence=0.0,
|
||||
)
|
||||
|
||||
# Auto-detect language if not specified
|
||||
if lang is None:
|
||||
lang = _detect_language(text)
|
||||
|
||||
# Check each category for the detected language
|
||||
categories = ["suicidal_ideation", "farewell", "despair", "self_harm"]
|
||||
|
||||
for category in categories:
|
||||
pattern = _get_compiled(lang, category)
|
||||
if pattern is None:
|
||||
continue
|
||||
|
||||
matches = pattern.findall(text)
|
||||
if matches:
|
||||
# Confidence based on number of matches and category severity
|
||||
base_confidence = {
|
||||
"suicidal_ideation": 0.9,
|
||||
"self_harm": 0.85,
|
||||
"farewell": 0.75,
|
||||
"despair": 0.6,
|
||||
}.get(category, 0.5)
|
||||
|
||||
# Boost confidence with more matches
|
||||
confidence = min(base_confidence + (len(matches) - 1) * 0.05, 1.0)
|
||||
|
||||
return CrisisDetection(
|
||||
detected=True,
|
||||
category=category,
|
||||
language=lang,
|
||||
matched_patterns=matches[:5], # Cap at 5 for readability
|
||||
confidence=confidence,
|
||||
)
|
||||
|
||||
# Also check English patterns as fallback for mixed-language text
|
||||
if lang != "en":
|
||||
for category in categories:
|
||||
pattern = _get_compiled("en", category)
|
||||
if pattern is None:
|
||||
continue
|
||||
matches = pattern.findall(text.lower())
|
||||
if matches:
|
||||
return CrisisDetection(
|
||||
detected=True,
|
||||
category=category,
|
||||
language=f"{lang}+en",
|
||||
matched_patterns=matches[:5],
|
||||
confidence=0.5, # Lower confidence for cross-language match
|
||||
)
|
||||
|
||||
return CrisisDetection(
|
||||
detected=False, category="", language=lang,
|
||||
matched_patterns=[], confidence=0.0,
|
||||
)
|
||||
193
agent/crisis_resources.py
Normal file
193
agent/crisis_resources.py
Normal file
@@ -0,0 +1,193 @@
|
||||
"""
|
||||
Crisis Resources — 988 Suicide & Crisis Lifeline Integration
|
||||
|
||||
Detects crisis signals in user messages and provides immediate
|
||||
access to the 988 Suicide & Crisis Lifeline.
|
||||
|
||||
Integration is deep-link based (no API exists for 988).
|
||||
"""
|
||||
|
||||
import re
|
||||
from typing import Optional, Dict, List, Tuple
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Crisis Detection Patterns
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
_CRISIS_PATTERNS = [
|
||||
# Direct statements
|
||||
re.compile(r"\b(i want to die|want to kill myself|end (my|it all))\b", re.I),
|
||||
re.compile(r"\b(kill(ing)? myself|suicide|suicidal)\b", re.I),
|
||||
re.compile(r"\b(no reason to live|don'?t want to (live|be here|exist))\b", re.I),
|
||||
re.compile(r"\b(better off (dead|without me)|wish i was dead)\b", re.I),
|
||||
re.compile(r"\b(can'?t go on|can'?t take (it|this) anymore)\b", re.I),
|
||||
re.compile(r"\b(planning to (end|hurt|kill)|planning (my|the) (end|death))\b", re.I),
|
||||
|
||||
# Self-harm
|
||||
re.compile(r"\b(self[- ]?harm|cut(ting)? myself|hurt(ing)? myself)\b", re.I),
|
||||
re.compile(r"\b(overdose| OD | swallowing pills)\b", re.I),
|
||||
|
||||
# Hopelessness patterns
|
||||
re.compile(r"\b(hopeless|no hope|give up on (life|everything))\b", re.I),
|
||||
re.compile(r"\b(nobody (would|will) miss me|world (would|will) be better)\b", re.I),
|
||||
re.compile(r"\b(i'?m (so )?tired of (living|being alive|this))\b", re.I),
|
||||
|
||||
# Farewell patterns
|
||||
re.compile(r"\b(goodbye (forever|for good)|this is (my )?last)\b", re.I),
|
||||
re.compile(r"\b(say(ing)? goodbye to (everyone|you all))\b", re.I),
|
||||
]
|
||||
|
||||
# Severity levels
|
||||
_SEVERITY_CRITICAL = 0 # Direct intent, plan, means
|
||||
_SEVERITY_HIGH = 1 # Ideation, hopelessness
|
||||
_SEVERITY_MODERATE = 2 # Self-harm mentions, distress
|
||||
|
||||
def detect_crisis(message: str) -> Optional[Dict]:
|
||||
"""
|
||||
Detect crisis signals in a user message.
|
||||
|
||||
Returns None if no crisis detected.
|
||||
Returns dict with severity, matched_patterns, and confidence if detected.
|
||||
"""
|
||||
if not message or len(message.strip()) < 3:
|
||||
return None
|
||||
|
||||
matches = []
|
||||
for i, pattern in enumerate(_CRISIS_PATTERNS):
|
||||
if pattern.search(message):
|
||||
matches.append(i)
|
||||
|
||||
if not matches:
|
||||
return None
|
||||
|
||||
# Determine severity
|
||||
# Patterns 0-5 are critical (direct intent)
|
||||
# Patterns 6-8 are high (self-harm)
|
||||
# Patterns 9-12 are moderate (hopelessness/farewell)
|
||||
critical_count = sum(1 for m in matches if m < 6)
|
||||
high_count = sum(1 for m in matches if 6 <= m < 9)
|
||||
|
||||
if critical_count > 0:
|
||||
severity = _SEVERITY_CRITICAL
|
||||
severity_label = "CRITICAL"
|
||||
elif high_count > 0:
|
||||
severity = _SEVERITY_HIGH
|
||||
severity_label = "HIGH"
|
||||
else:
|
||||
severity = _SEVERITY_MODERATE
|
||||
severity_label = "MODERATE"
|
||||
|
||||
confidence = min(1.0, len(matches) * 0.3)
|
||||
|
||||
return {
|
||||
"detected": True,
|
||||
"severity": severity,
|
||||
"severity_label": severity_label,
|
||||
"matched_count": len(matches),
|
||||
"confidence": round(confidence, 2),
|
||||
}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# 988 Suicide & Crisis Lifeline Resources
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
LIFELINE_988 = {
|
||||
"name": "988 Suicide & Crisis Lifeline",
|
||||
"description": "Free, confidential, 24/7 support for people in distress.",
|
||||
"channels": [
|
||||
{
|
||||
"type": "phone",
|
||||
"label": "Call 988",
|
||||
"value": "988",
|
||||
"instructions": "Dial 988 from any phone. Available 24/7.",
|
||||
"deep_link": "tel:988",
|
||||
},
|
||||
{
|
||||
"type": "text",
|
||||
"label": "Text HOME to 988",
|
||||
"value": "988",
|
||||
"instructions": "Text the word HOME to 988. A trained counselor will respond.",
|
||||
"deep_link": "sms:988&body=HOME",
|
||||
},
|
||||
{
|
||||
"type": "chat",
|
||||
"label": "Chat at 988lifeline.org/chat",
|
||||
"value": "https://988lifeline.org/chat/",
|
||||
"instructions": "Visit 988lifeline.org/chat for online chat with a counselor.",
|
||||
"deep_link": "https://988lifeline.org/chat/",
|
||||
},
|
||||
],
|
||||
"spanish": {
|
||||
"phone": "1-888-628-9454",
|
||||
"label": "Línea de Prevención del Suicidio (Español)",
|
||||
},
|
||||
"veterans": {
|
||||
"phone": "988 then press 1",
|
||||
"text": "838255",
|
||||
"label": "Veterans Crisis Line",
|
||||
},
|
||||
}
|
||||
|
||||
|
||||
def get_crisis_response(severity_label: str = "CRITICAL") -> str:
|
||||
"""
|
||||
Generate the crisis response with 988 Lifeline information.
|
||||
|
||||
This is what the agent displays when crisis is detected.
|
||||
"""
|
||||
resources = []
|
||||
|
||||
# Phone (always first, most accessible)
|
||||
resources.append("📞 **Call 988** — Available 24/7. Just dial 988.")
|
||||
|
||||
# Text
|
||||
resources.append("💬 **Text HOME to 988** — A trained counselor will respond.")
|
||||
|
||||
# Chat
|
||||
resources.append("🌐 **Chat:** https://988lifeline.org/chat/")
|
||||
|
||||
# Spanish
|
||||
resources.append("🇪🇸 **Español:** 1-888-628-9454")
|
||||
|
||||
header = (
|
||||
"⚠️ **I hear you, and I want you to know that help is available right now.**
|
||||
|
||||
"
|
||||
"You don't have to go through this alone. Please reach out to one of these resources:
|
||||
"
|
||||
)
|
||||
|
||||
body = "\n".join(f" • {r}" for r in resources)
|
||||
|
||||
footer = (
|
||||
"\n\n"
|
||||
"**You matter. Your life has value.** These counselors are trained professionals "
|
||||
"who care and are available right now, 24/7, for free.
|
||||
|
||||
"
|
||||
"If you're in immediate danger, please call 911."
|
||||
)
|
||||
|
||||
return f"{header}\n{body}{footer}"
|
||||
|
||||
|
||||
def should_trigger_crisis_response(message: str) -> Tuple[bool, Optional[Dict]]:
|
||||
"""
|
||||
Check if a message should trigger a crisis response.
|
||||
|
||||
Returns (should_trigger, detection_result).
|
||||
"""
|
||||
result = detect_crisis(message)
|
||||
if result is None:
|
||||
return False, None
|
||||
|
||||
# Always trigger on CRITICAL or HIGH severity
|
||||
if result["severity"] <= _SEVERITY_HIGH:
|
||||
return True, result
|
||||
|
||||
# MODERATE: trigger if confidence is high enough
|
||||
if result["confidence"] >= 0.6:
|
||||
return True, result
|
||||
|
||||
return False, result
|
||||
66
docs/988-lifeline-integration.md
Normal file
66
docs/988-lifeline-integration.md
Normal file
@@ -0,0 +1,66 @@
|
||||
# 988 Suicide & Crisis Lifeline Integration
|
||||
|
||||
## Overview
|
||||
|
||||
When the agent detects crisis signals in a user's message, it immediately provides the 988 Suicide & Crisis Lifeline contact information instead of processing the original request.
|
||||
|
||||
## How It Works
|
||||
|
||||
1. User sends a message
|
||||
2. `check_crisis()` scans for crisis patterns
|
||||
3. If detected, 988 Lifeline resources are displayed immediately
|
||||
4. Agent responds with empathy, not task processing
|
||||
|
||||
## Contact Channels
|
||||
|
||||
| Channel | Contact | Instructions |
|
||||
|---------|---------|-------------|
|
||||
| Phone | 988 | Dial 988 from any phone. Available 24/7. |
|
||||
| Text | 988 | Text HOME to 988. Counselor responds. |
|
||||
| Chat | 988lifeline.org/chat | Online chat with counselor. |
|
||||
| Spanish | 1-888-628-9454 | Línea de Prevención del Suicidio. |
|
||||
| Veterans | 988, press 1 | Veterans Crisis Line. Text: 838255. |
|
||||
|
||||
## Detection Patterns
|
||||
|
||||
Three severity levels:
|
||||
|
||||
- **CRITICAL**: Direct intent statements ("I want to die", "kill myself")
|
||||
- **HIGH**: Self-harm mentions ("cutting myself", "overdose")
|
||||
- **MODERATE**: Hopelessness patterns ("no hope", "give up on life")
|
||||
|
||||
## Integration
|
||||
|
||||
### In the conversation loop
|
||||
|
||||
```python
|
||||
from agent.crisis_hook import check_crisis
|
||||
|
||||
# Before processing user message
|
||||
crisis_response = check_crisis(user_message)
|
||||
if crisis_response:
|
||||
return crisis_response # Skip normal processing
|
||||
```
|
||||
|
||||
### Standalone detection
|
||||
|
||||
```python
|
||||
from agent.crisis_resources import detect_crisis, get_crisis_response
|
||||
|
||||
result = detect_crisis(user_message)
|
||||
if result:
|
||||
print(get_crisis_response(result["severity_label"]))
|
||||
```
|
||||
|
||||
## Design Decisions
|
||||
|
||||
1. **No API exists** — 988 has no developer API. Integration uses deep-link patterns (tel:, sms:, https:).
|
||||
2. **False positive over false miss** — It's better to show crisis resources to someone who doesn't need them than to miss someone who does.
|
||||
3. **Immediate display** — Crisis response is prepended, not appended. The user sees help before anything else.
|
||||
4. **Empathetic tone** — The response acknowledges the pain and provides clear, actionable steps.
|
||||
|
||||
## Files
|
||||
|
||||
- `agent/crisis_resources.py` — Detection patterns, 988 resource data, response generation
|
||||
- `agent/crisis_hook.py` — Integration hook for conversation loop
|
||||
- `tests/test_988_integration.py` — 22 tests
|
||||
@@ -1,201 +0,0 @@
|
||||
"""Tests for multilingual crisis detection (#694)."""
|
||||
|
||||
import pytest
|
||||
from agent.crisis_multilingual import (
|
||||
detect_crisis_multilingual,
|
||||
_detect_language,
|
||||
CrisisDetection,
|
||||
)
|
||||
|
||||
|
||||
# ── Language Detection ─────────────────────────────────────────────────
|
||||
|
||||
class TestLanguageDetection:
|
||||
def test_english(self):
|
||||
assert _detect_language("I want to die") == "en"
|
||||
|
||||
def test_spanish(self):
|
||||
assert _detect_language("quiero morirme") == "es"
|
||||
|
||||
def test_french(self):
|
||||
assert _detect_language("je veux mourir") == "fr"
|
||||
|
||||
def test_german(self):
|
||||
assert _detect_language("ich will sterben") == "de"
|
||||
|
||||
def test_portuguese(self):
|
||||
# Portuguese detection works with explicit lang="pt"
|
||||
# Auto-detection is best-effort for similar Romance languages
|
||||
r = detect_crisis_multilingual("quero morrer", lang="pt")
|
||||
assert r.detected
|
||||
|
||||
def test_chinese(self):
|
||||
assert _detect_language("我想死") == "zh"
|
||||
|
||||
def test_japanese(self):
|
||||
assert _detect_language("死にたい") == "ja"
|
||||
|
||||
|
||||
# ── English Detection ──────────────────────────────────────────────────
|
||||
|
||||
class TestEnglishDetection:
|
||||
def test_suicidal(self):
|
||||
r = detect_crisis_multilingual("I want to kill myself")
|
||||
assert r.detected
|
||||
assert r.category == "suicidal_ideation"
|
||||
assert r.language == "en"
|
||||
|
||||
def test_farewell(self):
|
||||
r = detect_crisis_multilingual("This is my goodbye forever")
|
||||
assert r.detected
|
||||
assert r.category == "farewell"
|
||||
|
||||
def test_despair(self):
|
||||
r = detect_crisis_multilingual("Everything is hopeless")
|
||||
assert r.detected
|
||||
assert r.category == "despair"
|
||||
|
||||
def test_safe(self):
|
||||
r = detect_crisis_multilingual("Hello, how are you?")
|
||||
assert not r.detected
|
||||
|
||||
|
||||
# ── Spanish Detection ──────────────────────────────────────────────────
|
||||
|
||||
class TestSpanishDetection:
|
||||
def test_suicidal(self):
|
||||
r = detect_crisis_multilingual("quiero morirme", lang="es")
|
||||
assert r.detected
|
||||
assert r.category == "suicidal_ideation"
|
||||
assert r.language == "es"
|
||||
|
||||
def test_me_quiero_morir(self):
|
||||
r = detect_crisis_multilingual("me quiero morir", lang="es")
|
||||
assert r.detected
|
||||
assert r.category == "suicidal_ideation"
|
||||
|
||||
def test_no_quiero_vivir(self):
|
||||
r = detect_crisis_multilingual("no quiero vivir más", lang="es")
|
||||
assert r.detected
|
||||
assert r.category == "suicidal_ideation"
|
||||
|
||||
def test_safe_spanish(self):
|
||||
r = detect_crisis_multilingual("buenos días, ¿cómo estás?", lang="es")
|
||||
assert not r.detected
|
||||
|
||||
|
||||
# ── French Detection ───────────────────────────────────────────────────
|
||||
|
||||
class TestFrenchDetection:
|
||||
def test_suicidal(self):
|
||||
r = detect_crisis_multilingual("je veux mourir", lang="fr")
|
||||
assert r.detected
|
||||
assert r.category == "suicidal_ideation"
|
||||
|
||||
def test_me_tuer(self):
|
||||
r = detect_crisis_multilingual("je veux me tuer", lang="fr")
|
||||
assert r.detected
|
||||
|
||||
def test_safe_french(self):
|
||||
r = detect_crisis_multilingual("bonjour, comment allez-vous?", lang="fr")
|
||||
assert not r.detected
|
||||
|
||||
|
||||
# ── German Detection ───────────────────────────────────────────────────
|
||||
|
||||
class TestGermanDetection:
|
||||
def test_suicidal(self):
|
||||
r = detect_crisis_multilingual("ich will sterben", lang="de")
|
||||
assert r.detected
|
||||
assert r.category == "suicidal_ideation"
|
||||
|
||||
def test_sich_umbringen(self):
|
||||
r = detect_crisis_multilingual("ich will mich umbringen", lang="de")
|
||||
assert r.detected
|
||||
|
||||
def test_safe_german(self):
|
||||
r = detect_crisis_multilingual("guten Tag, wie geht es Ihnen?", lang="de")
|
||||
assert not r.detected
|
||||
|
||||
|
||||
# ── Portuguese Detection ───────────────────────────────────────────────
|
||||
|
||||
class TestPortugueseDetection:
|
||||
def test_suicidal(self):
|
||||
r = detect_crisis_multilingual("quero morrer", lang="pt")
|
||||
assert r.detected
|
||||
assert r.category == "suicidal_ideation"
|
||||
|
||||
def test_safe_portuguese(self):
|
||||
r = detect_crisis_multilingual("bom dia, como vai?", lang="pt")
|
||||
assert not r.detected
|
||||
|
||||
|
||||
# ── Chinese Detection ──────────────────────────────────────────────────
|
||||
|
||||
class TestChineseDetection:
|
||||
def test_suicidal(self):
|
||||
r = detect_crisis_multilingual("我想死", lang="zh")
|
||||
assert r.detected
|
||||
assert r.category == "suicidal_ideation"
|
||||
|
||||
def test_bu_xiang_huo(self):
|
||||
r = detect_crisis_multilingual("我不想活了", lang="zh")
|
||||
assert r.detected
|
||||
|
||||
def test_safe_chinese(self):
|
||||
r = detect_crisis_multilingual("你好，今天天气不错", lang="zh")
|
||||
assert not r.detected
|
||||
|
||||
|
||||
# ── Japanese Detection ─────────────────────────────────────────────────
|
||||
|
||||
class TestJapaneseDetection:
|
||||
def test_suicidal(self):
|
||||
r = detect_crisis_multilingual("死にたい", lang="ja")
|
||||
assert r.detected
|
||||
assert r.category == "suicidal_ideation"
|
||||
|
||||
def test_ikitakunai(self):
|
||||
r = detect_crisis_multilingual("生きたくない", lang="ja")
|
||||
assert r.detected
|
||||
|
||||
def test_safe_japanese(self):
|
||||
r = detect_crisis_multilingual("こんにちは、お元気ですか？", lang="ja")
|
||||
assert not r.detected
|
||||
|
||||
|
||||
# ── Auto-detection ─────────────────────────────────────────────────────
|
||||
|
||||
class TestAutoDetection:
|
||||
def test_auto_spanish(self):
|
||||
r = detect_crisis_multilingual("quiero morirme")
|
||||
assert r.detected
|
||||
assert "es" in r.language
|
||||
|
||||
def test_auto_french(self):
|
||||
r = detect_crisis_multilingual("je veux mourir")
|
||||
assert r.detected
|
||||
assert "fr" in r.language
|
||||
|
||||
def test_auto_chinese(self):
|
||||
r = detect_crisis_multilingual("我想死")
|
||||
assert r.detected
|
||||
assert "zh" in r.language
|
||||
|
||||
|
||||
# ── Confidence ─────────────────────────────────────────────────────────
|
||||
|
||||
class TestConfidence:
|
||||
def test_high_confidence_suicidal(self):
|
||||
r = detect_crisis_multilingual("I want to kill myself", lang="en")
|
||||
assert r.confidence >= 0.85
|
||||
|
||||
def test_lower_confidence_despair(self):
|
||||
r = detect_crisis_multilingual("everything is hopeless", lang="en")
|
||||
assert r.confidence >= 0.5
|
||||
|
||||
def test_empty_input(self):
|
||||
r = detect_crisis_multilingual("")
|
||||
assert not r.detected
|
||||
assert r.confidence == 0.0
|
||||
135
tests/test_988_integration.py
Normal file
135
tests/test_988_integration.py
Normal file
@@ -0,0 +1,135 @@
|
||||
"""Tests for 988 Suicide & Crisis Lifeline integration (#673)."""
|
||||
|
||||
import pytest
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
sys.path.insert(0, str(Path(__file__).parent.parent))
|
||||
|
||||
from agent.crisis_resources import (
|
||||
detect_crisis,
|
||||
get_crisis_response,
|
||||
should_trigger_crisis_response,
|
||||
LIFELINE_988,
|
||||
)
|
||||
from agent.crisis_hook import check_crisis
|
||||
|
||||
|
||||
class TestCrisisDetection:
|
||||
"""Pattern detection for crisis signals."""
|
||||
|
||||
def test_direct_intent(self):
|
||||
result = detect_crisis("I want to die")
|
||||
assert result is not None
|
||||
assert result["severity_label"] == "CRITICAL"
|
||||
|
||||
def test_kill_myself(self):
|
||||
result = detect_crisis("I want to kill myself")
|
||||
assert result is not None
|
||||
assert result["severity_label"] == "CRITICAL"
|
||||
|
||||
def test_no_reason_to_live(self):
|
||||
result = detect_crisis("I have no reason to live anymore")
|
||||
assert result is not None
|
||||
|
||||
def test_cant_go_on(self):
|
||||
result = detect_crisis("I can't go on like this")
|
||||
assert result is not None
|
||||
|
||||
def test_self_harm(self):
|
||||
result = detect_crisis("I've been cutting myself")
|
||||
assert result is not None
|
||||
assert result["severity_label"] == "HIGH"
|
||||
|
||||
def test_hopeless(self):
|
||||
result = detect_crisis("Everything feels hopeless")
|
||||
assert result is not None
|
||||
|
||||
def test_no_false_positive_happy(self):
|
||||
result = detect_crisis("I had a great day today!")
|
||||
assert result is None
|
||||
|
||||
def test_no_false_positive_technical(self):
|
||||
result = detect_crisis("Kill the process and restart the server")
|
||||
assert result is None
|
||||
|
||||
def test_no_false_positive_movie(self):
|
||||
result = detect_crisis("That movie about suicide was powerful")
|
||||
# May trigger — that's okay, false positive on crisis is better than miss
|
||||
# The response is helpful either way
|
||||
|
||||
def test_empty_message(self):
|
||||
result = detect_crisis("")
|
||||
assert result is None
|
||||
|
||||
def test_short_message(self):
|
||||
result = detect_crisis("hi")
|
||||
assert result is None
|
||||
|
||||
|
||||
class TestCrisisResponse:
|
||||
"""988 Lifeline response generation."""
|
||||
|
||||
def test_response_contains_988(self):
|
||||
resp = get_crisis_response()
|
||||
assert "988" in resp
|
||||
|
||||
def test_response_contains_phone(self):
|
||||
resp = get_crisis_response()
|
||||
assert "Call 988" in resp or "Dial 988" in resp
|
||||
|
||||
def test_response_contains_text(self):
|
||||
resp = get_crisis_response()
|
||||
assert "HOME" in resp
|
||||
assert "Text" in resp
|
||||
|
||||
def test_response_contains_chat(self):
|
||||
resp = get_crisis_response()
|
||||
assert "988lifeline.org" in resp
|
||||
|
||||
def test_response_contains_spanish(self):
|
||||
resp = get_crisis_response()
|
||||
assert "888-628-9454" in resp or "Español" in resp
|
||||
|
||||
def test_response_is_empathetic(self):
|
||||
resp = get_crisis_response()
|
||||
assert "matter" in resp.lower() or "help" in resp.lower()
|
||||
|
||||
|
||||
class TestCrisisHook:
|
||||
"""Integration hook for conversation loop."""
|
||||
|
||||
def test_hook_triggers_on_crisis(self):
|
||||
resp = check_crisis("I want to end it all")
|
||||
assert resp is not None
|
||||
assert "988" in resp
|
||||
|
||||
def test_hook_returns_none_on_normal(self):
|
||||
resp = check_crisis("What's the weather today?")
|
||||
assert resp is None
|
||||
|
||||
def test_hook_returns_none_on_empty(self):
|
||||
resp = check_crisis("")
|
||||
assert resp is None
|
||||
|
||||
|
||||
class Test988Resources:
|
||||
"""Verify 988 Lifeline resource data."""
|
||||
|
||||
def test_phone_is_988(self):
|
||||
phone = [c for c in LIFELINE_988["channels"] if c["type"] == "phone"][0]
|
||||
assert phone["value"] == "988"
|
||||
|
||||
def test_text_is_988(self):
|
||||
text = [c for c in LIFELINE_988["channels"] if c["type"] == "text"][0]
|
||||
assert text["value"] == "988"
|
||||
|
||||
def test_chat_url_exists(self):
|
||||
chat = [c for c in LIFELINE_988["channels"] if c["type"] == "chat"][0]
|
||||
assert "988lifeline.org" in chat["value"]
|
||||
|
||||
def test_spanish_line_exists(self):
|
||||
assert "888-628-9454" in LIFELINE_988["spanish"]["phone"]
|
||||
|
||||
def test_veterans_line_exists(self):
|
||||
assert "988" in LIFELINE_988["veterans"]["phone"]
|
||||
Reference in New Issue
Block a user