teamver-mail-agent 0.3.1

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	Default
api_base_url	TEAMVER_MAIL_API_BASE or TEAMVER_MAIL_API_BASE_URL	Mail host, no /v1	https://mail-api.teamver.com
agent_token	TEAMVER_MAIL_AGENT_TOKEN	Bearer tv_agent_…	(required)
internal_api_key	TEAMVER_INTERNAL_API_KEY	Optional — M2M provisioning only	—

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

Documentation

Public docs: github.com/NeuralStudioKr/teamver-sdk-docs/tree/main/mail-agent

• Installation
• Quick start
• API reference
• Changelog

License

MIT — see LICENSE.