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_runwhen a run raises, so the connector also emits fromon_run_error_callback, with the error attached. Otherwise a failing agent would simply go quiet. - Streaming does not inflate the model-call count.
after_modelfires 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.