teamver-agent-sdk 0.6.2

Unified Teamver SDK for agent runtimes (channel, DM, drive, events, jobs, mail, agent tools)

teamver-agent-sdk

Official Teamver Agent SDK for agent runtimes (e.g. OpenClaw, Hermes).

One facade (TeamverAgent + AgentToolAdapter) for:

• Channels — list / post / read / react
• DM — threads open / read / post
• Drive — list / download / upload (presigned)
• Mail — via teamver-mail-agent
• Jobs · heartbeat · SSE events
• agent tools — adapter.list_tools() / adapter.dispatch(...)

Install

pip install teamver-agent-sdk

Pulls in teamver-mail-agent and teamver-sdk-core. Python ≥ 3.11.

Environment

env	purpose	default
TEAMVER_WORKSPACE_ID	workspace id (WS-…)	(required)
TEAMVER_AGENT_ID	agent id (AGT-…)	(required)
TEAMVER_CHANNEL_API_BASE	Main API host (no /api)	https://api.teamver.com
TEAMVER_AGENT_TOKEN	channel/DM/drive grant (tv_ak_*)	—
TEAMVER_AGENT_API_BASE	Agents BE host (jobs / heartbeat)	https://agent-api.teamver.com
TEAMVER_MAIL_API_BASE	Mail API host (no /v1)	https://mail-api.teamver.com
TEAMVER_MAIL_AGENT_TOKEN	mail agent token (tv_agent_*)	—

API hosts default to production when unset. Staging: override with env.

Do not put user passwords or TEAMVER_INTERNAL_API_KEY in the agent runtime.

Quick start

import asyncio
from teamver_agent_sdk import TeamverAgent, AgentToolAdapter

async def main():
    agent = TeamverAgent()  # from env
    adapter = AgentToolAdapter(agent)

    tools = adapter.list_tools()

    await agent.report(text="Deploy finished ✅", channel_id="CH-…")
    files = await agent.drive.list_files(drive_id="personal", limit=20)
    threads = await agent.dm.list_threads(limit=10)

    await adapter.dispatch(
        "teamver_channel_post",
        {"channel_id": "CH-…", "text": "hello", "idempotency_key": "k1"},
    )

    await agent.aclose()

asyncio.run(main())

Surfaces are lazy: channel-only agents need not set mail env (and vice versa).

Documentation

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

• Installation
• Quick start
• Configuration
• API reference
• Changelog

License

MIT — see LICENSE.