| Name | Type | Description |
|---|---|---|
thread_id* | str | Thread whose offloaded history should be removed. |
Remove a thread's offloaded conversation-history archive.
Deletes the per-thread markdown file written by the local-mode
conversation_history backend ({root}/conversation_history/{thread_id}.md),
resolving root with _offload_fallback_root so the persistent
~/.deepagents location and any temporary fallback are both covered.
Best-effort: filesystem failures are logged and swallowed rather than
raised, so a failed cleanup never blocks thread deletion. Resolving the
offload root is not side-effect-free -- it creates (and hardens) the
conversation_history directory and writes a short-lived probe file -- so a
call for a thread that has no archive still touches the filesystem before
returning False.
In server/sandbox mode the archive lives on the sandbox backend rather than
the local ~/.deepagents directory, so there is no local archive to remove.
