Timmy Time
dbabe0e6ae
agent/crisis_resources.py provides all 988 Lifeline contact methods: phone (988), text (HOME to 988), chat, Spanish line. Also Crisis Text Line (741741) and 911. Closes #673
150 lines
3.8 KiB
Python
150 lines
3.8 KiB
Python
"""
|
|
988 Suicide & Crisis Lifeline Integration (#673).
|
|
|
|
When crisis is detected, provides immediate access to help:
|
|
- Phone: 988 (call or text)
|
|
- Text: Text HOME to 988
|
|
- Chat: 988lifeline.org/chat
|
|
- Spanish: 1-888-628-9454
|
|
- Emergency: 911
|
|
|
|
This module provides the resource data. agent/crisis_protocol.py
|
|
handles detection. This module formats the resources for display.
|
|
"""
|
|
|
|
from dataclasses import dataclass
|
|
from typing import List
|
|
|
|
|
|
@dataclass
|
|
class CrisisResource:
|
|
"""A crisis support contact method."""
|
|
name: str
|
|
contact: str
|
|
description: str
|
|
url: str = ""
|
|
available: str = "24/7"
|
|
language: str = "English"
|
|
|
|
|
|
# 988 Suicide & Crisis Lifeline — all channels
|
|
LIFELINE_988 = CrisisResource(
|
|
name="988 Suicide and Crisis Lifeline",
|
|
contact="Call or text 988",
|
|
description="Free, confidential support for people in suicidal crisis or emotional distress.",
|
|
url="https://988lifeline.org",
|
|
available="24/7",
|
|
language="English",
|
|
)
|
|
|
|
LIFELINE_988_TEXT = CrisisResource(
|
|
name="988 Crisis Text Line",
|
|
contact="Text HOME to 988",
|
|
description="Free, 24/7 crisis support via text message.",
|
|
url="",
|
|
available="24/7",
|
|
language="English",
|
|
)
|
|
|
|
LIFELINE_988_CHAT = CrisisResource(
|
|
name="988 Lifeline Chat",
|
|
contact="988lifeline.org/chat",
|
|
description="Free, confidential online chat with a trained crisis counselor.",
|
|
url="https://988lifeline.org/chat",
|
|
available="24/7",
|
|
language="English",
|
|
)
|
|
|
|
LIFELINE_988_SPANISH = CrisisResource(
|
|
name="988 Lifeline (Spanish)",
|
|
contact="1-888-628-9454",
|
|
description="Línea de prevención del suicidio en español.",
|
|
url="https://988lifeline.org/help-yourself/en-espanol/",
|
|
available="24/7",
|
|
language="Spanish",
|
|
)
|
|
|
|
CRISIS_TEXT_LINE = CrisisResource(
|
|
name="Crisis Text Line",
|
|
contact="Text HOME to 741741",
|
|
description="Free, 24/7 crisis support via text message.",
|
|
url="https://www.crisistextline.org",
|
|
available="24/7",
|
|
language="English",
|
|
)
|
|
|
|
EMERGENCY_911 = CrisisResource(
|
|
name="Emergency Services",
|
|
contact="911",
|
|
description="Immediate danger — police, fire, ambulance.",
|
|
url="",
|
|
available="24/7",
|
|
language="Any",
|
|
)
|
|
|
|
# All resources in priority order
|
|
ALL_RESOURCES: List[CrisisResource] = [
|
|
EMERGENCY_911,
|
|
LIFELINE_988,
|
|
LIFELINE_988_TEXT,
|
|
LIFELINE_988_CHAT,
|
|
CRISIS_TEXT_LINE,
|
|
LIFELINE_988_SPANISH,
|
|
]
|
|
|
|
|
|
def get_crisis_resources(language: str = None) -> List[CrisisResource]:
|
|
"""Get crisis resources, optionally filtered by language.
|
|
|
|
Args:
|
|
language: Filter by language ("English", "Spanish", or None for all)
|
|
|
|
Returns:
|
|
List of CrisisResource objects
|
|
"""
|
|
if language:
|
|
return [r for r in ALL_RESOURCES if r.language.lower() == language.lower()]
|
|
return ALL_RESOURCES
|
|
|
|
|
|
def format_crisis_resources(resources: List[CrisisResource] = None) -> str:
|
|
"""Format crisis resources as a user-facing message.
|
|
|
|
Args:
|
|
resources: List of resources to format. Defaults to all resources.
|
|
|
|
Returns:
|
|
Formatted string suitable for displaying to a user in crisis.
|
|
"""
|
|
if resources is None:
|
|
resources = ALL_RESOURCES
|
|
|
|
lines = ["**Please reach out — help is available right now:**
|
|
"]
|
|
|
|
for r in resources:
|
|
if r.url:
|
|
lines.append(f"- **{r.name}:** {r.contact} ({r.url})")
|
|
else:
|
|
lines.append(f"- **{r.name}:** {r.contact}")
|
|
|
|
lines.append("")
|
|
lines.append("All services are free, confidential, and available 24/7.")
|
|
lines.append("You are not alone.")
|
|
|
|
return "
|
|
".join(lines)
|
|
|
|
|
|
def get_immediate_help_message() -> str:
|
|
"""Get the most urgent crisis help message.
|
|
|
|
Used when crisis is detected at CRITICAL level.
|
|
"""
|
|
return (
|
|
"If you are in immediate danger, call **911** right now.
|
|
|
|
"
|
|
+ format_crisis_resources()
|
|
)
|