Examples

AgentMailer examples

Copyable, named examples for common AgentMailer workflows. Every example is a self-contained directory with a README and equivalent Python and TypeScript implementations.

Architecture boundary

These examples are agent applications, not jobs hosted by AgentMailer. AgentMailer supplies durable identity, inboxes, messages, threads, drafts, attachments, events, delivery state, A2A protocol exchange, and communication policy. The example process or its production runtime owns model calls, tools, schedules, checkpoints, event deduplication, business approvals, and internal workflow state.

For email automation, verify and durably record the signed AgentMailer event in your application before doing expensive work. Correlate application state with the AgentMailer message or thread ID, and use stable idempotency keys for every mailbox mutation. A2A task state is shared protocol state between peers, not an AgentMailer worker queue.

Getting started and infrastructure

ExampleLearn how to
QuickstartList inboxes and opt in to sending a first email
Human-approved signupRequest an agent identity with explicit human approval
A2A delegationDiscover a peer’s Agent Card before delegating a task
Webhook consumerVerify signed events and reject replayed deliveries
Browser Use integrationGive a Browser Use agent mailbox and draft tools
Kernel browser integrationCombine isolated cloud browsing with reviewable email drafts
LangChain terminalPut AgentMailer behind a terminal agent loop
OpenAI terminalInspect mail with an OpenAI-compatible model
CLI workflowsCompose read-first AgentMailer shell commands

Productivity and operations

ExampleLearn how to
Approval inboxTurn requests into explicit approval drafts
Inbox ZeroClassify mail and produce an actionable digest
Note takerConvert forwarded mail into structured notes
Newsletter digestSummarize newsletters into one briefing
Scheduling agentCoordinate timezones and meeting availability
Dinner coordination agentReconcile participant preferences into a plan
Dinner reservationCoordinate parties and restaurant reservations
Browser signup agentHandle verification mail without exposing OTPs
Voice-to-emailTurn a supplied transcript into email

Sales, recruiting, and communications

ExampleLearn how to
GTM agentDraft relevant, permission-aware outreach
Cold email researcherResearch prospect context before outreach
Sales agentQualify inbound interest and propose a response
Sales signal routerDetect and route buying signals
Negotiation agentDraft counteroffers within an approved mandate
Podcast booking agentResearch fit and prepare guest outreach
Hiring screenerStructure applicant evidence against a rubric
Recruiter coordinatorCoordinate candidate interviews
ExampleLearn how to
Email agentPrepare safe responses to inbound mail
Support agentTriage support mail and prepare reviewable drafts
Documentation assistantAnswer product questions with cited sources
Invoice processorExtract invoice fields and route exceptions
Receipt parserExtract structured receipt data
Collections agentDraft respectful payment reminders
x402 payment agentPrepare a payment approval record
Contract redline agentIdentify risky contract clauses
Legal intake agentCollect matter-intake facts without legal advice
GitHub maintainer agentPropose actions for repository notifications

Each TypeScript example is an independent workspace package. Validate them all without calling AgentMailer:

1pnpm install
2pnpm --filter @agentmailer/sdk build
3pnpm examples:check

Python examples install the local generated SDK from this repository. From an example’s python/ directory:

1python -m venv .venv
2source .venv/bin/activate
3pip install -r requirements.txt
4python agent.py

The existing client snippets remain available as terse API references. Start with a named example when you want a complete communication pattern for an agent application.

Safety conventions

  • Read operations are the default.
  • Email and A2A writes require an explicit environment-variable opt-in.
  • Agent execution state and external side effects remain outside AgentMailer.
  • Signup stops at the human approval boundary.
  • Support automation creates a draft instead of sending a reply.
  • Webhook examples verify the raw request body before parsing it.
  • Secrets, customer content, and .env files must never be committed.

Inkbox workflow coverage

The Browser Use, Kernel, signup, webhook, and CLI mailbox journeys from Inkbox’s examples are covered. AgentMailer does not expose an encrypted credential vault, TOTP generation, phone-number provisioning, calling, or a general-purpose public tunnel. Those Inkbox-specific operations are intentionally not imitated here; use a dedicated provider with separately scoped credentials when a workflow needs them.