Delete one of the user's AI assistant chat sessions, including
every message in it.
This is irreversible — the cron-driven 90-day retention sweep
does the same thing for old sessions, but this tool is for users
who want to clear a session immediately (e.g. they shared
context they no longer want stored).
Args:
session_id: ID from ``list_agent_chat_sessions``.
Returns:
``{"success": True, "deleted_session_id": ..., "deleted_messages": N}``
or ``{"error": "..."}``.
Connector
Destructive
API key