SDK language guide

The canonical generated sources live in the AgentMailer plugin monorepo:

LanguageSourcePrimary client
TypeScriptsdk/typescriptAgentMailerClient
Pythonsdk/pythonAgentMailer
Rustsdk/rustgenerated crate client
Rubysdk/rubygenerated gem client
Gosdk/gogenerated module client
Swiftsdk/swiftgenerated package client

TypeScript and Python also export AgentMailerWorkflows, which provides complete inbox pagination, retry-safe inbox creation, explicit text sending, and public A2A discovery. Prefer generated resource clients when the maintained helper does not cover the required API.

Use request_options or the language-equivalent request configuration for bounded retries and timeouts. Only retry operations that are read-only or protected by a stable idempotency key. Preserve structured API errors so callers can distinguish authentication, authorization, validation, rate limiting, and delivery state.