Skip to content

0.6.0

Choose a tag to compare

@BeneODev BeneODev released this 29 Oct 20:41
· 92 commits to main since this release
21530f5

Breaking changes

This release changes the contract in one place. It is described in full under Changed below.

  • Keywords: a replacement list keywords in PATCH /v1/accounts/{account_id}/messages/{message_id} and the batches keeps the marks a message has, such as $answered. Name a mark in remove_keywords to take it off.

The database schema stays the same, no migration runs at the first start.

Added

  • benethos-mailbox-mcp: the tool server_status, always offered. It
    names the server's version, the transport, Python, the MCP library
    and the uptime. With details it 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 /health for 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_accounts names three more things an
    account may lack in unsupported: a mail in several folders,
    conversations and a copy in the sent folder.
  • benethos-mailbox-mcp: send_message and send_draft answer
    sent_copy_id, the copy in the sent folder where the account keeps
    one.
  • benethos-mailbox-mcp: list_accounts names per account the marks
    it writes in marks_written. A mark outside them is refused.
  • benethos-mailbox-mcp: search_messages and whats_new take
    account_ids, several accounts in one call, beside account_id.
  • benethos-mailbox-mcp: share_attachment takes expires_in, a
    link that lives fewer seconds than the service's default.
  • benethos-mailbox-mcp: each hit of search_messages carries the
    first 120 characters of its text as snippet. get_message marks an
    inline attachment, such as a logo in a signature, as (inline).
  • benethos-mailbox-client: ApiError.retry_after, the seconds the
    Retry-After header of a limit asks to wait, else None.
  • benethos-mailbox-client: Sent.sent_copy_id, the copy in the sent
    folder where the service put one. Sent.message_id_header is a
    string, as the API always answers one.
  • benethos-mailbox-client: Failed.code, the code of the error a
    batch answered for an id, and Page.incomplete, the accounts that did
    not answer as records NotAnswering with their code. not_answering
    stays as it was.
  • benethos-mailbox-client: list_changes takes since and limit
    as optional, as the API does, and list_messages, list_drafts and
    list_threads their limit.

Changed

  • Breaking: a replacement list keywords in
    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_keywords to take it off.
  • GET /v1/messages reads 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 than limit, or none, with a next_cursor to
    read on. One request read the whole account before.
  • The help of keys import, backup verify --recovery-key and
    restore --recovery-key says 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-service needs 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}/tokens refuses an expires_at more than
    3650 days, ten years, ahead with 400, as the UI did. A token without
    an end stays possible.
  • benethos-mailbox-client: the repr of Environment leaves the token
    out.
  • benethos-mailbox-mcp: the filters text, sender, to and
    subject of search_messages take one line of 1 to 200 characters,
    as the API does, and refuse other values in their own names. The
    name of create_folder and update_folder takes 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: the content_type of an AttachmentLink
    is a media type, else application/octet-stream, as for the bytes of
    an attachment. The sender of the mail chose it.
  • benethos-mailbox-client and benethos-mailbox-mcp refuse a
    MAILBOX_SERVICE_URL with 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_attachment names 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_message shows bcc and reply_to
    where a mail has them. A draft replaced with update_draft after
    reading it lost both.
  • A list of messages or threads in a folder the account does not have
    answers 404 on every provider. It reached the provider first, and
    Microsoft answered 400.
  • A message id that Microsoft cannot read answers 404 when the message
    is read, fetched raw, deleted or its keywords changed, as on every
    other provider. Graph answered 400.

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 with mail.read could build one whose name ended SELECT
    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: 404 for an
    id, 400 for a cursor. No server has such a folder.

Full changelog: v0.5.2...v0.6.0