lukasandClaude Opus 5.5
b88855931e
Hosted mailboxes (SPEC App. D), behind HOSTED_MAILBOXES (off: unchanged):
- Stalwart mail server, provisioned by `python -m app.hosted.provision`;
directory read from a Postgres view, app passwords only for mail apps
- native account per user, the worker signs in as master for the user
- raw messages of hosted mailboxes only cached, fetched back on demand
- migrations 0025 (accounts.kind, directory view), 0026 (IMAP ids bigint)
Mail:
- dark message mode switch in the reading pane (Thunderbird's algorithm)
- moves and folder creation quote the folder name ("Deleted Items"):
swipe-to-delete / Trash no longer bounce back
- thread unread counters: lock before recount, sorted lock order,
UIDVALIDITY re-import recounts, nightly repair_threads
- sidebar accounts sorted alphabetically, more space above headings
Settings: Security headings renamed; antispam accounts are explicit
(none ticked = none filtered), input widths, Activity hidden.
Plugin bundles served with Cache-Control: no-cache.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
119 lines
2.8 KiB
Python
119 lines
2.8 KiB
Python
"""Shared API response models (SPEC §9.1)."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import datetime as dt
|
|
import uuid
|
|
|
|
from pydantic import BaseModel
|
|
|
|
|
|
class Address(BaseModel):
|
|
name: str = ""
|
|
email: str = ""
|
|
|
|
|
|
class ThreadSummary(BaseModel):
|
|
id: uuid.UUID
|
|
subject: str
|
|
snippet: str
|
|
participants: list[Address]
|
|
# Distinct From addresses of the thread's visible messages, oldest first —
|
|
# what the list's sender column shows (recipients excluded).
|
|
senders: list[Address] = []
|
|
account_ids: list[uuid.UUID]
|
|
message_count: int
|
|
unread_count: int
|
|
has_attachments: bool
|
|
pinned: bool
|
|
last_message_at: dt.datetime
|
|
|
|
|
|
class ThreadListOut(BaseModel):
|
|
threads: list[ThreadSummary]
|
|
cursor: str | None = None
|
|
total: int = 0
|
|
|
|
|
|
class AttachmentOut(BaseModel):
|
|
id: uuid.UUID
|
|
filename: str
|
|
mime_type: str
|
|
size_bytes: int
|
|
|
|
|
|
class MessageEnvelope(BaseModel):
|
|
id: uuid.UUID
|
|
account_id: uuid.UUID
|
|
mailbox_id: uuid.UUID
|
|
thread_id: uuid.UUID | None
|
|
subject: str
|
|
from_addr: list[Address]
|
|
to_addr: list[Address]
|
|
cc_addr: list[Address]
|
|
bcc_addr: list[Address]
|
|
date: dt.datetime
|
|
flags: list[str]
|
|
is_unread: bool
|
|
is_starred: bool
|
|
has_attachments: bool
|
|
has_remote_images: bool
|
|
# The sender is on the user's trusted list, so remote images load without a prompt.
|
|
images_allowed: bool = False
|
|
size_bytes: int
|
|
snippet: str
|
|
# Other accounts this same delivery also landed in (collapsed duplicates).
|
|
also_in_account_ids: list[uuid.UUID] = []
|
|
|
|
|
|
class ThreadDetail(BaseModel):
|
|
id: uuid.UUID
|
|
subject: str
|
|
order: str # "asc" | "desc"
|
|
pinned: bool
|
|
messages: list[MessageEnvelope] # always ASC (SPEC §9.4)
|
|
|
|
|
|
class FlagChangeRequest(BaseModel):
|
|
add: list[str] = []
|
|
remove: list[str] = []
|
|
|
|
|
|
class MarkReadRequest(BaseModel):
|
|
view: str = "unified" # unified | folder:<special> | account:<uuid>
|
|
|
|
|
|
class MoveRequest(BaseModel):
|
|
mailbox_id: uuid.UUID
|
|
|
|
|
|
class AccountOut(BaseModel):
|
|
id: uuid.UUID
|
|
email: str
|
|
display_name: str
|
|
color: str
|
|
state: str
|
|
signature: str = ""
|
|
sync_window: str = "all"
|
|
backfill_total: int = 0
|
|
backfill_done: int = 0
|
|
# "unreachable" while the mail server has not answered for a while.
|
|
sync_error: str | None = None
|
|
sync_error_since: str | None = None
|
|
# Why the state is what it is (e.g. the server's reply to a refused sign-in).
|
|
state_detail: str = ""
|
|
# "native": the user's own hosted mailbox — cannot be removed (App. D §D.4).
|
|
kind: str = "external"
|
|
|
|
|
|
class SearchThreadHit(BaseModel):
|
|
thread: ThreadSummary
|
|
highlights: dict[str, str]
|
|
|
|
|
|
class SearchOut(BaseModel):
|
|
threads: list[SearchThreadHit]
|
|
cursor: str | None = None
|
|
# Conversations matching in all (first page only; None where not counted).
|
|
total: int | None = None
|