fabro/docs/public/integrations
Bryan Helmkamp 671324a06f
docs(secrets): document settings-declared credentials, fix stale local-run guidance
server-secrets-strategy.md described only two credential mechanisms — bootstrap
ServerSecrets and vault-only optional integrations — and stated its most
restrictive rule in terms of "server runtime", which is ambiguous now that every
run is a server process plus a worker. It omitted the third mechanism actually
used by operator-configured integrations: settings-declared credentials in
InterpString fields, resolved at consumption time from {{ env.NAME }} or
{{ secrets.NAME }}, as LLM provider extra_headers already does.

Add a "Which process resolves what" table keyed on resolving process and timing,
a "Settings-declared credentials" section with the extra_headers precedent, and a
mechanism table at the head of "Adding A New Server Secret". Replace "server
runtime" with per-process statements, and describe where CredentialResolver's
process-env fallback is actually live.

Also correct six docs that told operators to export provider keys for "standalone
local runs". There is no CLI-local run execution: runs always execute in a worker
whose environment is cleared and repopulated from WORKER_ENV_ALLOWLIST, which
excludes provider API keys. Those instructions could not have worked.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-25 09:04:59 -04:00
..
bedrock.mdx docs(secrets): document settings-declared credentials, fix stale local-run guidance 2026-07-25 09:04:59 -04:00
brave-search.mdx refactor: simplify profile builder and drop dead tool plumbing 2026-07-24 17:32:33 -04:00
daytona.mdx feat(sandbox): secure daytona snapshot names (#429) 2026-05-27 11:52:35 -04:00
fireworks.mdx docs(fireworks): fix CLI examples flagged in review 2026-07-24 09:37:18 -04:00
github.mdx docs: sync product documentation 2026-07-24 11:39:16 -04:00
litellm.mdx docs(secrets): document settings-declared credentials, fix stale local-run guidance 2026-07-25 09:04:59 -04:00
openrouter.mdx feat(model): add Claude Opus 5 to OpenRouter 2026-07-24 22:34:02 -04:00
poolside.mdx feat(llm): add Poolside Laguna models 2026-07-22 18:49:16 -04:00
slack.mdx docs: sync product documentation 2026-07-24 11:39:16 -04:00