Module agent_mail 

Canonical protocol contract for durable communication between Codewhale tasks.

Agent Mail is distinct from same-session subagent control messages. An envelope is persisted by the runtime, scoped to an owner and workspace, and projected into a destination turn only at an explicit safe boundary. The summary is the complete model-visible payload: runtimes must sanitize it before constructing an envelope, and this module enforces the wire-size and control-character boundary.

Structs

AgentMailAddress

Durable ownership and routing scope resolved by the receiving runtime.

AgentMailEnvelope

AgentMailEventPayload

Canonical payload placed in every Agent Mail runtime event.

AgentMailEvidenceRef

Bounded pointer to evidence already authorized by the destination runtime.

AgentMailFailureReceipt

AgentMailMessageId

Stable, caller-supplied idempotency key for an Agent Mail envelope.

AgentMailSendRequest

AgentMailSendResponse

AgentMailSender

AgentMailValidationError

Enums

AgentMailDeliveryMode

AgentMailEvidenceKind

AgentMailFailureCode

AgentMailStatus

Constants

AGENT_MAIL_EVENT_DELIVERED

AGENT_MAIL_EVENT_DELIVERING

AGENT_MAIL_EVENT_DELIVERY_FAILED

AGENT_MAIL_EVENT_QUEUED

AGENT_MAIL_EVENT_READ

AGENT_MAIL_SCHEMA_VERSION

MAX_AGENT_MAIL_DELIVERY_ATTEMPTS

MAX_AGENT_MAIL_DISPLAY_LABEL_BYTES

MAX_AGENT_MAIL_EVIDENCE_LABEL_BYTES

MAX_AGENT_MAIL_EVIDENCE_REFS

MAX_AGENT_MAIL_FAILURE_MESSAGE_BYTES

MAX_AGENT_MAIL_HOPS

MAX_AGENT_MAIL_MESSAGE_ID_BYTES

MAX_AGENT_MAIL_OPAQUE_ID_BYTES

MAX_AGENT_MAIL_SUMMARY_BYTES