Skip to main content

chatsee-google-adk

ChatSee connector for Google ADK (Agent Development Kit).

pip install chatsee-google-adk
from google.adk.apps import App
from chatsee_google_adk import instrument_google_adk

chatsee = instrument_google_adk(agent_id="...", tenant_id="...")
app = App(name="support", root_agent=agent, plugins=[chatsee.plugin])

That is the whole integration. The handle's .plugin is an ADK BasePlugin, and it works the same on a Runner(plugins=[...]). chatsee-ai is installed for you as a dependency.

What it captures

Per turn: the user's message, the agent's answer, the root agent's instruction as the system prompt, every tool call with its arguments, result and duration, and one model call per model call with the usage ADK reported for it.

No per-agent wiring

ADK fires plugin callbacks globally — every agent, every sub-agent, every model call and tool in the run goes past this one plugin. A multi-agent app needs no extra registration, and adding a sub-agent later changes nothing.

Every callback returns None, which is ADK's "carry on" — the plugin only reads what goes past and never alters a response, a tool result or the flow.

The part worth knowing

One ADK run is one ChatSee turn, emitted from after_run_callback — one runner.run_async call, one user message. Not after_agent_callback, which fires once per sub-agent and would split a single turn into several.

Two consequences worth knowing:

  • A failed run still produces a turn. ADK skips after_run when a run raises, so the connector also emits from on_run_error_callback, with the error attached. Otherwise a failing agent would simply go quiet.
  • Streaming does not inflate the model-call count. after_model fires once per chunk; partial responses are ignored and only the final aggregated response counts, so one call stays one call rather than dozens.

Sessions and users

By default each turn uses ADK's own session.id and user_id, so a reused ADK session is one ChatSee conversation — usually what you want.

To override, pass user_id= / conversation_id= to instrument_google_adk, or call chatsee.set_session(conversation_id) to pin every later turn to one conversation. chatsee.stats() reports turns emitted, capture failures and runs in flight.

Guarantees

  • Fails open. Every callback is wrapped; a failure inside capture is logged and swallowed. ADK re-raises plugin exceptions into the run, so this matters more here than elsewhere — ChatSee can never break your agent.
  • Idempotent. Instrumenting twice with the same identity returns the first handle rather than registering a second plugin.
  • Concurrency-safe. Runs are keyed by invocation_id, so one Runner serving several users at once does not mix them up, and the send happens off the event loop so one turn's POST does not stall the others.

All three are enforced by the contract suite, not just intended.

Tests

No network, no API key, no dev tenant — ADK is stubbed, ChatSee is not.

pip install -e python/connectors/_shared
pip install -e python/connectors/frameworks/google-adk
pytest python/connectors/frameworks/google-adk/tests -q

Metadata

Release files for chatsee-google-adk 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chatsee-google-adk 0.1.0
File Size Uploaded Provenance Actions
chatsee_google_adk-0.1.0.tar.gz 14.9 kB Without provenance Details for chatsee_google_adk-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for chatsee-google-adk 0.1.0
File Interpreter ABI Platform Actions
chatsee_google_adk-0.1.0-py3-none-any.whl Python 3 none any Details for chatsee_google_adk-0.1.0-py3-none-any.whl

Total release size: 24.6 kB

Release files / chatsee_google_adk-0.1.0.tar.gz

Download URL chatsee_google_adk-0.1.0.tar.gz
Size 14.9 kB
Tags Source
SHA-256 checksum
How to use checksums
767e499933c191fe7ba471f92e4ae7b34bf5018c484181b0d1f7a5efc648a92f
BLAKE2b-256 checksum
How to use checksums
803e5895203f51d5b3ff1098220abfa4281a5195d8113312f2bd4a7b216df587
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.11

Release files / chatsee_google_adk-0.1.0-py3-none-any.whl

Download URL chatsee_google_adk-0.1.0-py3-none-any.whl
Size 9.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5f9a2dc447551e71dbd390c11acb7d9cc8ea6d0913b6ad94b6f41bbfdcbc32ea
BLAKE2b-256 checksum
How to use checksums
f18b1d7bd1b27601be3e09e13b73342665a01683e0bba08bdaf591bf46148559
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.11

Security for chatsee-google-adk 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page