Repository navigation
0.6.0
Breaking changes
This release changes the contract in one place. It is described in full under Changed below.
- Keywords: a replacement list
keywordsinPATCH /v1/accounts/{account_id}/messages/{message_id}and the batches keeps the marks a message has, such as$answered. Name a mark inremove_keywordsto take it off.
The database schema stays the same, no migration runs at the first start.
Added
benethos-mailbox-mcp: the toolserver_status, always offered. It
names the server's version, the transport, Python, the MCP library
and the uptime. Withdetailsit adds the service as the server last
saw it: whether it answered and how long ago, its version and whether
it matches, whether it took the token, and the tools offered. The
server asks/healthfor the service's version as it starts and each
time it asks what its token may do.benethos-mailbox-client:Folder.subscribed, whether the folder is
subscribed on the server, as the API says.benethos-mailbox-mcp:list_accountsnames three more things an
account may lack inunsupported: a mail in several folders,
conversations and a copy in the sent folder.benethos-mailbox-mcp:send_messageandsend_draftanswer
sent_copy_id, the copy in the sent folder where the account keeps
one.benethos-mailbox-mcp:list_accountsnames per account the marks
it writes inmarks_written. A mark outside them is refused.benethos-mailbox-mcp:search_messagesandwhats_newtake
account_ids, several accounts in one call, besideaccount_id.benethos-mailbox-mcp:share_attachmenttakesexpires_in, a
link that lives fewer seconds than the service's default.benethos-mailbox-mcp: each hit ofsearch_messagescarries the
first 120 characters of its text assnippet.get_messagemarks an
inline attachment, such as a logo in a signature, as(inline).benethos-mailbox-client:ApiError.retry_after, the seconds the
Retry-Afterheader of a limit asks to wait, elseNone.benethos-mailbox-client:Sent.sent_copy_id, the copy in the sent
folder where the service put one.Sent.message_id_headeris a
string, as the API always answers one.benethos-mailbox-client:Failed.code, the code of the error a
batch answered for an id, andPage.incomplete, the accounts that did
not answer as recordsNotAnsweringwith their code.not_answering
stays as it was.benethos-mailbox-client:list_changestakessinceandlimit
as optional, as the API does, andlist_messages,list_draftsand
list_threadstheirlimit.
Changed
- Breaking: a replacement list
keywordsin
PATCH /v1/accounts/{account_id}/messages/{message_id}and the
batches keeps the marks a message has, such as$answered. It took
them off on IMAP and JMAP, but not on Microsoft. Name a mark in
remove_keywordsto take it off. GET /v1/messagesreads at most ten pages of an account for one page
of the list. Where the grants reach little of the folder, a page may
hold fewer messages thanlimit, or none, with anext_cursorto
read on. One request read the whole account before.- The help of
keys import,backup verify --recovery-keyand
restore --recovery-keysays the recovery key is asked for at a
hidden prompt, and read from stdin only when piped. - The service runs on FastAPI 0.162 and Starlette 1.10.
- Both images run on Python 3.15.2. It rejects TLS certificate chains
with the compromised eMudhra intermediate CA keys. - The images install pydantic 2.14.2, platformdirs 4.14.0 and dnspython
2.9.1 from the lockfile. benethos-mailbox-serviceneeds dnspython 2.9.0 or newer, the first
version without a known vulnerability. An install from the lockfile,
as the images do, had it already.POST /v1/users/{user_id}/tokensrefuses anexpires_atmore than
3650 days, ten years, ahead with400, as the UI did. A token without
an end stays possible.benethos-mailbox-client: the repr ofEnvironmentleaves the token
out.benethos-mailbox-mcp: the filterstext,sender,toand
subjectofsearch_messagestake one line of 1 to 200 characters,
as the API does, and refuse other values in their own names. The
name ofcreate_folderandupdate_foldertakes at most 200.benethos-mailbox-mcp: the log names why a tool failed when it was
no refused argument: a PDF that took too long, an attachment too large
to hand over, a mail without a thread.benethos-mailbox-client: thecontent_typeof anAttachmentLink
is a media type, elseapplication/octet-stream, as for the bytes of
an attachment. The sender of the mail chose it.benethos-mailbox-clientandbenethos-mailbox-mcprefuse a
MAILBOX_SERVICE_URLwith a user or password in it. The address is
named in the error when the service cannot be reached, which reaches
the model.benethos-mailbox-mcp:share_attachmentnames the content type
inside the marker, beside the file name, since the sender chose it.- The account page of the UI says what the account can do and which
marks it writes. - A sign-in with a code in the UI answers a page of its own, so a reload
starts no second sign-in at the provider. The batch of the Users list
and Set password for another user ask first.
Fixed
benethos-mailbox-mcp:get_messageshowsbccandreply_to
where a mail has them. A draft replaced withupdate_draftafter
reading it lost both.- A list of messages or threads in a folder the account does not have
answers404on every provider. It reached the provider first, and
Microsoft answered400. - A message id that Microsoft cannot read answers
404when the message
is read, fetched raw, deleted or its keywords changed, as on every
other provider. Graph answered400.
Security
- A folder name with a line break or NUL never reaches a command of an
IMAP server. A folder id is not signed:
a caller withmail.readcould build one whose name endedSELECT
and started a command of their choosing, run with the account's
credentials. Python 3.14 and newer refused it already, 3.11 to 3.13
sent it. The images run on 3.15 and were not affected. - An IMAP folder id, message id or cursor whose folder name holds a
control character answers like one of the wrong form:404for an
id,400for a cursor. No server has such a folder.
Full changelog: v0.5.2...v0.6.0