Skip to content

Estate mail archive

The company-mail workspace is a read-only view of Estate Data Hub’s archive. Toolora indexes a bounded projection, applies company/mailbox policy and links messages to internal business records. It does not operate an IMAP/Gmail client, send replies or turn an address match into a confirmed customer relationship. Original preservation owns byte identity and coverage; this reference owns connection, reader and projection behavior.

An archive binding names the Toolora company, archive account, cell, connection and attested fingerprint. The setup page lists only accounts allowlisted and mapped by the archive owner. Tenant administrators cannot supply arbitrary external account identifiers. Adding or reindexing rechecks the directory and live attestation. A changed account/cell/connection stops the operation; a stale fingerprint with unchanged verified identity can be refreshed without resetting the sync cursor.

Managing this policy requires tenant:update and roles:manage. Enabling reads records a purpose, one responsible active company administrator and the archive’s retention policy. The responsible person is accountable; that selection does not exclude the other eligible administrator readers.

Operation or setting Reviewed boundary
List/read mailbox messages Staff mail:read, active company, enabled/read-enabled binding and current active non-worker company-admin reader
Open from customer, opportunity or project The same mailbox checks plus read authority over the named target
Add/remove internal link Mailbox authority and the target operation’s resource/capability checks; no source-mailbox mutation
Add a communications mailbox Archive-attested setup; bounded projection sync; document copying/intake and agent tools remain disabled
Enable AI quote proposal use Explicit mailbox policy plus quote permissions, current source links and reader access

Current reader eligibility is checked on each request. Previously returned text or downloaded files cannot be recalled by revoking the role. Source deletion is observed when its tombstone reaches the projection, not at the instant an external mailbox changes. The recorded mail-source-policy and source_observation.lifecycle contract supplies retention/deletion meaning; Toolora must not invent a fixed expiry interval.

Projection records preserve source lifecycle, readable body text, attachment metadata, email-date status and coverage. Archive event kind values identify observations such as metadata/original verification or gaps; they are not separate message categories that search may silently discard. Indexed body text is bounded. On-demand original extraction can improve the detail view without rewriting the search index.

Address matches are suggestions. A staff member explicitly links a message to a customer, opportunity or project; removing that link changes Toolora’s association, not the source message. Customer and project views reuse the reader, so linking does not publish the message in the customer portal. A standalone mail proposal and an opportunity proposal also retain their distinct identities and source permissions. AI context explains bounded attachment selection.

For synthetic Company A, a mailbox row with mail_read_enabled=false is not readable merely because indexing succeeded. Conversely, a readable projection may still report incomplete original coverage. Diagnose those separately: verify the reader, binding/policy, attestation, projection checkpoint and byte availability. Never repair a mismatch by allowing an arbitrary source account or broadening the reader set.

Mail routes return unavailable/not-found results for inaccessible bindings and unverifiable attachments. The response does not establish whether a provider lost a message or the projection simply lacks verified bytes. Reindex using the existing attested identity and preserve checkpoint semantics. Test fixtures should exercise active-reader allow, foreign company/disabled-reader deny, source tombstone and hash/MIME mismatch using synthetic mail. The delivery PR records executions; this source review performs no real-mail read, link change or send.