taimoe-platform SDK
===================

The official Python SDK for connecting agents and runtimes to the Taimoe Agent Platform.

This documentation is generated with Sphinx from the SDK source code, docstrings, and type hints.

.. toctree::
   :maxdepth: 2
   :caption: Start

   installation
   quickstart
   configuration

.. toctree::
   :maxdepth: 2
   :caption: Guides

   adk-integration
   runtime-discovery
   observability
   rest-client
   governance-headers

.. toctree::
   :maxdepth: 2
   :caption: SDK Reference

   api

What the SDK provides
---------------------

* Managed Agent configuration with runtime-bound and runtime-less synchronization.
* Google ADK model, instruction, tool, and generation-config hot reload.
* Gateway routing and automatic ADK instrumentation.
* Runtime discovery manifests and FastAPI health endpoints.
* Native traces and spans with an optional OpenTelemetry bridge.
* Typed synchronous and asynchronous resource clients with canonical errors and retry.
* Taimoe governance headers and W3C Trace Context propagation.

The package is currently **Alpha**. Pin a minor version for production integrations.