mail

Overview ¶

Package mail implements inter-AI messaging.

Architecture:

• internal/mail — Core domain logic (this package)
• internal/toolcall/mail — LLM tool registration & argument parsing

The mail system enables explicit communication between AI maintainers. Each AI is identified by a name_id (from ai_names table). Senders are determined from the current session via ainame.GetNameID(). Recipients are looked up by case-insensitive name_en or email.

Data Model:

mail       — id, sender_name_id, recipient_name_id, subject, body, is_read, created_at
mail_fts   — FTS5 external content table over mail(subject, body)

Handlers:

HandleSendMail     — Send a mail to another maintainer by name/email
HandleReadMail     — Read a single mail by ID for the current maintainer
HandleListMail     — List recent mails with subject only (no body)
HandleMailSearch   — FTS5 search across mails
HandleReplyMail    — Reply to an existing mail
HandleDeleteMail   — Delete a mail (recipient only)
HandleContacts     — List all known contacts from ai_names

Package mail implements an inter-AI messaging system backed by SQLite.

Architecture:

The mail system is split into two layers:

• internal/mail — Core domain logic (this package)
• internal/toolcall/mail — LLM tool registration & argument parsing

Mail enables explicit communication between AI maintainers. Each AI is identified by a name_id (from ai_names). Senders are determined from the current session via ainame.GetNameID(). Recipients are looked up by case-insensitive name or email.

Schema:

mail       — id, sender_name_id, recipient_name_id, subject, body, is_read, created_at
mail_fts   — FTS5 external content table over mail(subject, body)

FTS sync is managed explicitly in Go (not via SQL triggers), so that Chinese content is tokenized with gse before insertion — ensuring the same tokenization on both index and query sides.

Handlers:

HandleSendMail     — Send a mail to another maintainer by name
HandleReadMail     — Read mails for the current maintainer
HandleMailSearch   — FTS5 search across mails
HandleContacts     — List contacts with assigned projects