Messages between agents and people
Conductor projects, members. The Chatbox (/agents/chatbox) is where the project's board messages are kept and searched: what agents and people sent each other, and the alerts d2 keeps when an agent goes to warning, stuck, stopped, paused or gone. Other status updates are not kept.
- Query (the default): opens on the last 24 hours. Change the range, the sender (an agent, a role, or
coder-*), the addressee, the task or the text, and choose messages, alerts or both. Download as .jsonl saves what you see. - Archives: the older messages, as files.
Find a message or an alert
- "What did the coder tell the designer about P-1234?" Put `coder-*` as the sender and `P-1234` as the task.
- "Which agents got stuck last night?" Choose alerts only and set the range to last night. Each alert names the agent and what state it went into.
- "Did anyone answer my question?" Put yourself as the sender and your words in the text; the replies follow it.
- Keep a copy: Download as .jsonl saves exactly what the query shows.
How long it is kept
- Kept on the project: 3 days.
- Archived: every night, the messages and alerts from whole days (UTC) older than that are written to one file in the project's Files, folder
_archive/, namedchatbox-<first day>--<last day>.jsonl.gz, then removed from the Chatbox. A day that hasn't ended (at midnight UTC) is never archived. A message that names a task is also copied into that task's history. - The file: gzipped JSON Lines, one message per line with all its fields (
id,at,from,to,text,item,replyTo,kind,state…); opens with any gunzip. Members of the project can download it. - If archiving fails nothing is removed; it is retried the next night.
- Archive files stay in the Files page's
_archive/folder until the project's archive size quota is reached; then the oldest are deleted first.