Houmao Agent Email Comms

Actions

• Read actions/resolve-live.md only when the current prompt or recent mailbox context does not already provide the exact gateway base URL or current binding set.
• Read actions/status.md to inspect current mailbox identity, mailbox transport, or live gateway posture.
• Read actions/list.md to list unread, open, archived, or current mailbox state.
• Read actions/read.md when deciding whether to peek at or read one selected message.
• Read actions/send.md to send one new message.
• Read actions/post.md when the caller is acting as operator or otherwise outside the managed Houmao runtime and needs to leave one operator-origin note in a managed agent mailbox.
• Read actions/reply.md to reply to one existing message.
• Read actions/archive.md to archive one or more processed messages.

Transport Pages

• Read transports/filesystem.md when mailbox.transport is filesystem and you need layout, policy, or no-gateway fallback guidance.
• Read transports/stalwart.md when mailbox.transport is stalwart and you need direct-access or no-gateway fallback guidance.

References

• Read references/endpoint-contract.md for the shared /v1/mail/* route summary.
• Read references/curl-examples.md for copy-paste curl forms against the exact current gateway.base_url.
• Read references/managed-agent-fallback.md for the supported houmao-mgr agents mail ... fallback surface when no live gateway facade exists.
• Read references/filesystem-resolver-fields.md or references/stalwart-resolver-fields.md when transport-local resolver fields matter.
• Read references/filesystem-layout.md only when filesystem mailbox layout details are relevant.

Useful Patterns

• For supported higher-level mailbox and gateway compositions such as self-wakeup through self-mail plus notifier-driven rounds, switch to the Houmao advanced-usage skill houmao-adv-usage-pattern.

Guardrails

• Do not guess the gateway host or port; use the exact base URL already present in prompt or context when available, otherwise use gateway.base_url from houmao-mgr agents mail resolve-live.
• Do not scrape tmux state directly when the manager-owned resolver is available.
• Do not route operator-origin mailbox delivery through ordinary /v1/mail/send; use the dedicated post surface.
• Do not derive mailbox internals from visible message_ref or thread_ref prefixes.
• Do not archive a message before the corresponding mailbox action and any required reply succeed.
• Do not treat this ordinary communication skill as the whole notifier-round workflow when houmao-process-emails-via-gateway is available.
• Do not present direct transport-local access as the first-choice path when a live shared gateway mailbox facade is available.