docs: document egress route fields #211

Merged
didericis merged 3 commits from docs/egress-manifest-shape into main 2026-06-23 17:55:57 -04:00
Collaborator

Summary

Documents the egress route fields added in PRDs 0052/0053 that were not reflected in the public-facing docs, and corrects stale provider-auth documentation.

  • Feature bullet: adds per-route matches filtering and both-direction DLP scanning to the description.
  • Bottle example: expands the egress.routes entry to show matches (paths/methods) and dlp (outbound/inbound detector overrides).
  • New Egress route fields reference table covering all accepted keys, types, and defaults (host, role, auth, matches, dlp, git.fetch).
  • role row corrected: PRD 0029 removed the claude_code_oauth role and the parser now rejects any role value as reserved-for-future-use. Provider auth routes are injected from agent_provider.auth_token.
  • examples/bottles/claude.md: replaced the manual api.anthropic.com route (which used the rejected role key, and would otherwise be silently dropped in favour of the provider-injected route) with the canonical agent_provider.auth_token shape.
## Summary Documents the egress route fields added in PRDs 0052/0053 that were not reflected in the public-facing docs, and corrects stale provider-auth documentation. - Feature bullet: adds per-route `matches` filtering and both-direction DLP scanning to the description. - Bottle example: expands the `egress.routes` entry to show `matches` (paths/methods) and `dlp` (outbound/inbound detector overrides). - New **Egress route fields** reference table covering all accepted keys, types, and defaults (`host`, `role`, `auth`, `matches`, `dlp`, `git.fetch`). - `role` row corrected: PRD 0029 removed the `claude_code_oauth` role and the parser now rejects any `role` value as reserved-for-future-use. Provider auth routes are injected from `agent_provider.auth_token`. - `examples/bottles/claude.md`: replaced the manual `api.anthropic.com` route (which used the rejected `role` key, and would otherwise be silently dropped in favour of the provider-injected route) with the canonical `agent_provider.auth_token` shape.
didericis force-pushed docs/egress-manifest-shape from 7c0fa9d55a to d1d9e7a105 2026-06-19 21:58:24 -04:00 Compare
didericis added 3 commits 2026-06-23 17:53:29 -04:00
Both fields were missing from the reference table added in the preceding
commit — `role` is visible in examples/bottles/claude.md and `git.fetch`
is documented in PRD 0052 but neither appeared in the README table.
The egress route fields table described `role` as a functional field
that wires built-in auth flows. PRD 0029 removed the
`claude_code_oauth` role; the manifest parser now rejects any `role`
value as reserved-for-future-use. Provider auth routes are injected
from `agent_provider.auth_token`.

- README: fix the `role` row to state it is reserved and any value is
  rejected at load.
- examples/bottles/claude.md: the manual `api.anthropic.com` route used
  the rejected `role` key and, even without it, would be silently
  dropped (provider-injected routes win for a provisioned host) — so its
  auth never took effect and the dlp comments described a route that
  never exists in the plan. Replace it with the canonical
  `agent_provider.auth_token` shape.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YcU7nerbg8cVj9R4EkpfLJ
didericis force-pushed docs/egress-manifest-shape from df469b2f47 to 31cde11b0d 2026-06-23 17:53:29 -04:00 Compare
didericis-claude changed title from docs: document egress matches, dlp fields, and detector defaults to docs: document egress route fields 2026-06-23 17:53:41 -04:00
didericis merged commit 31cde11b0d into main 2026-06-23 17:55:57 -04:00
didericis deleted branch docs/egress-manifest-shape 2026-06-23 17:55:57 -04:00
Sign in to join this conversation.