docs(clients): agent platform integration: readmes, example spec, plan gaps, suite counts

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-24 04:51:20 +02:00
co-authored by Claude Sonnet 5.5
parent 7190846704
commit fcdb7242be
5 changed files with 59 additions and 9 deletions
+19 -6
View File
@@ -35,13 +35,13 @@ is not defined in the Makefile yet.
## The living example
A route-level demo of every feature, with 111 integration tests on the real
A route-level demo of every feature, with 163 integration tests on the real
stack (no mocks). Standalone, no other part needed.
```sh
make -f example/example.mk example # build
./build/example/living-server 8080 # run
make -f example/example.mk example-test # expect: 111 passed, 0 failed
make -f example/example.mk example-test # expect: 163 passed, 0 failed
```
Open `http://127.0.0.1:8080/` and click through the matrix. Narrow the
@@ -65,9 +65,20 @@ GOOGLE_API_KEY=... ./build/example/living-server 8080 # then open /voice
Click Start, talk, pause: the answer is spoken back, and speaking over it
interrupts it. Optional env: `GOOGLE_VOICE_LANG` (default `nl-NL`),
`GOOGLE_VOICE_NAME`, `GOOGLE_GENAI_MODEL` (default `gemini-3.5-flash`), `GOOGLE_STT_MODEL`, `GOOGLE_TTS_MODEL` (default `gemini-2.5-flash-tts`), `GOOGLE_API_BACKEND`.
The Google layer is `src/google` (spec: `src/google/SPEC.md`); its route
tests script the Google side, `MOLO_LIVE_NET=1 make google-test` adds the
opt-in real-network checks.
The Google layer is `src/google` (spec: `src/google/SPEC.md`, plan
`plans/16-agent-platform.md`). No test scripts a Google reply: each module
is derived from Google's Discovery documents and re-checked by
`src/google/<module>/tools/check_discovery.py`; `MOLO_LIVE_NET=1 make
google-test` adds read-only live checks against real Google.
Credentials (environment, then `.env.json.local`, then `.env.json`):
`GOOGLE_API_KEY` (Vertex express keys, voice), `GOOGLE_CLOUD_PROJECT`,
`GOOGLE_CLOUD_LOCATION`, and for OAuth-only APIs either
`GOOGLE_ACCESS_TOKEN` or a service account key file in
`GOOGLE_APPLICATION_CREDENTIALS` (git-ignored `.secrets/`). `make
google-token && ./build/google/sa-token` prints an access token.
The Agent Platform demo pages are under `/agent/<module>` and, like all
`/voice`, `/google` and `/agent` routes, are excluded from locust.
Test conventions (one test file per URL, Arrange/Act/Assert, integration
only) are in `tests/README.md`.
@@ -197,7 +208,9 @@ src/app application, routers, views, forms, validation, templates
src/realtime WebSocket, SSE, Socket.IO, streaming, WebDAV, expose tunnels
src/supervisor process supervisor, tasks, replication
src/clients HTTP/REST client, OpenAPI, test double
src/google Google Cloud APIs: generic client, TTS, STT, Gemini, voice pipeline
src/google Google Cloud: generic client, OAuth + service accounts, voice, and the
Gemini Enterprise Agent Platform (models, runtime, sessions, sandbox,
registry, armor, optimize, adk, live), one dir per module
src/cli molo binary: CLI, dev server, embedder, AI, ops, i18n, CSP
src/tenancy multi-tenancy
src/audit hash-chained audit log, GDPR export/erasure, retention