The manual the binary carries, rendered on the client port: a sidebar of the documents in the console's reading order (now one list, llmgw.Manual, for both), heading anchors, links between documents kept in the portal and links to files outside the binary sent to the repository, no script. Public by default; landing.docs_sign_in sends visitors to sign in first. docs/clients.md shows the official OpenAI and Anthropic SDKs against llmgw in Python, TypeScript, Go and curl, with llmgw's headers; the portal's index, the landing page and the account page link to it. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2.2 KiB
2.2 KiB
C24: the SDK/docs portal
CHANGELOG
Documentation
- A docs portal at /docs. The manual the binary carries — the pages
llmgw docsprints and the console's Manual shows, the configuration reference among them — rendered on the client port in the portal's own look: a sidebar of the documents in reading order, the open one's sections under it, a link on every heading, and links between documents kept inside the portal (links to files that are not in the binary, such asdeploy/, go to the repository). No script on the page, so the Content-Security-Policy has nothing to allow. Public by default, like the landing page; setlanding.docs_sign_in: trueto send visitors to sign in first. Signed in, the page carries the usual menu, which now has a Docs link. - A client developer's guide,
docs/clients.md. How to use llmgw from the official OpenAI and Anthropic SDKs — there is no llmgw SDK, and none is needed — in Python, TypeScript, Go and curl: the base URL and key, streaming, tools, embeddings, the Responses API, batches, the Anthropic SDK against/v1/messages, and what llmgw adds as headers (x-llmgw-thread,x-session-id, metadata andx-llmgw-tags,x-llmgw-variant,/v1/memory,/mcp), with the statuses a client meets. The portal's index leads with it, and the landing page and the account page link to it. - The console's Manual and the portal read one list of documents in one
order (
llmgw.Manual), so the two cannot drift.
BACKLOG
- 24 (SDK/docs portal): built — /docs renders the embedded manual (goldmark, GFM, heading anchors, links rewritten, no script; public,
landing.docs_sign_into require a session), and docs/clients.md shows the official OpenAI/Anthropic SDKs against llmgw. Left: the console's generated "Commands" page is not in the portal (it is built from the cobra tree, which internal/web cannot see); no search across documents; the clients.md sections on /v1/messages, batches, tags and x-llmgw-variant were written against the features-c2 commit messages and must be checked against that code when merging (exactx-llmgw-tagsformat,canaryas the variant value, Anthropic-shaped errors on /v1/messages).