docs(clients): vendor platform integration: llm spec, readmes, example spec, plan gaps, counts
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -35,13 +35,13 @@ is not defined in the Makefile yet.
|
||||
|
||||
## The living example
|
||||
|
||||
A route-level demo of every feature, with 163 integration tests on the real
|
||||
A route-level demo of every feature, with 205 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: 163 passed, 0 failed
|
||||
make -f example/example.mk example-test # expect: 205 passed, 0 failed
|
||||
```
|
||||
|
||||
Open `http://127.0.0.1:8080/` and click through the matrix. Narrow the
|
||||
@@ -78,7 +78,22 @@ Credentials (environment, then `.env.json.local`, then `.env.json`):
|
||||
`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.
|
||||
`/voice`, `/google`, `/agent` and `/ai` routes, are excluded from locust.
|
||||
|
||||
Other vendors (plan `plans/17-llm-vendor-platforms.md`, shared layer
|
||||
`src/llm/SPEC.md`): pages `/ai/xai`, `/ai/xai/platform`, `/ai/anthropic`,
|
||||
`/ai/anthropic/admin`, `/ai/meta`, `/ai/deepseek`, `/ai/openai`,
|
||||
`/ai/openai/platform`, `/ai/openai/admin`, `/ai/openrouter`. Keys go in
|
||||
`.env.json.local` or the environment: `XAI_API_KEY`, `XAI_MANAGEMENT_KEY`,
|
||||
`ANTHROPIC_API_KEY`, `ANTHROPIC_ADMIN_KEY`, `META_API_KEY` (or
|
||||
`MODEL_API_KEY`), `DEEPSEEK_API_KEY`, `OPENAI_API_KEY`, `OPENAI_ADMIN_KEY`,
|
||||
`OPENROUTER_API_KEY`, `OPENROUTER_MANAGEMENT_KEY`. Without a key a page and
|
||||
its status route still load and every calling route answers 503
|
||||
`not_configured`; paid or destructive routes are dry runs unless the body has
|
||||
`"confirm":true`. `MOLO_LIVE_NET=1 make ai-test` adds opt-in live checks;
|
||||
anything that costs money also needs `MOLO_LIVE_PAID=1`. No vendor key
|
||||
exists in this repo's environment yet, so every vendor package is verified
|
||||
against its published spec and unauthenticated probes only.
|
||||
Test conventions (one test file per URL, Arrange/Act/Assert, integration
|
||||
only) are in `tests/README.md`.
|
||||
|
||||
@@ -208,6 +223,10 @@ 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/llm shared layer for the vendor platforms below (client, SSE, errors, ChatModel)
|
||||
src/xai src/anthropic src/meta src/deepseek src/openai src/openrouter
|
||||
whole public API platforms of Grok, Claude, Meta Model API (Muse Spark),
|
||||
DeepSeek, OpenAI and OpenRouter, one dir per work package
|
||||
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
|
||||
|
||||
Reference in New Issue
Block a user