teamver-mail-agent 0.3.0

Teamver Mail BE client for AI agent runtimes (inbox, events, processing, reply)

teamver-mail-agent

Async Python client for the Teamver Mail BE Agent API (/v1/agent/*).
Built for agents, Hermes, and other AI agent runtimes.

Install

pip install teamver-mail-agent

Depends on teamver-sdk-core. Python ≥ 3.11.

For the unified agent facade (channel + DM + Drive + mail), install teamver-agent-sdk instead.

Quick start

import asyncio
from teamver_mail_agent import TeamverMailAgentClient

async def main():
    async with TeamverMailAgentClient.from_env() as client:
        events = await client.list_events(limit=10)
        for ev in events.events:
            if ev.message_id:
                await client.ack_event(ev.event_id)
                msg = await client.get_message(ev.message_id)
                print(msg.subject, msg.body_text)

asyncio.run(main())

Environment

Field	Env	Description
api_base_url	TEAMVER_MAIL_API_BASE or TEAMVER_MAIL_API_BASE_URL	Mail host, no /v1 suffix
agent_token	TEAMVER_MAIL_AGENT_TOKEN	Bearer tv_agent_…
internal_api_key	TEAMVER_INTERNAL_API_KEY	Optional — M2M provisioning only (not for edge agents)

Scopes

agent:read, agent:events, agent:reply — issued with the mail agent token.

Recommended loop

list/stream events → ack → get_message → processing_start
→ handle → reply (Idempotency-Key) → processing_complete

Helper: run_standard_inbound_loop (see package docs on GitHub).

Documentation

• AI Agent Guide
• API Quickref

Development

pip install -e ".[dev]"
pytest

License

MIT — see LICENSE.