Skip to content

docs: record what the providers overhaul deliberately left out - #64

Merged
QR-Madness merged 1 commit into
masterfrom
docs/providers-backlog
Aug 2, 2026
Merged

docs: record what the providers overhaul deliberately left out#64
QR-Madness merged 1 commit into
masterfrom
docs/providers-backlog

Conversation

@QR-Madness

Copy link
Copy Markdown
Owner

Close-out for the providers track (#59, #60, #61, #63).

Each slice named its deferrals in the PR body, but none reached the backlog — so the reasons would have evaporated along with the PR descriptions.

Records five open items with why, not just what:

  • Measured cost in the usage ledger — the endpoint exists; the reconciliation loop belongs in a background job, because an inline per-turn lookup adds a round trip and OpenRouter writes the record asynchronously (so an immediate call 404s).
  • Spend cap at mint time — depends on whether /auth forwards limit/key_label as query params. Undocumented and unverified; flagged to probe before promising.
  • Management-key features — declined: genuine upstream revocation would need a second, higher-privilege secret stored for a convenience. Today's unlink is local and says so.
  • Unused OpenRouter surface/presets, /byok, /providers metadata, /analytics/query, /embeddings/models, /videos.
  • Anthropic-compatible custom endpoints — the ProviderKind slot exists; only openai_compatible is registerable (ADR-15).

Plus the operational gotcha that isn't visible from the code: existing clusters need the new tokenless gateway location and up -d --force-recreate before OpenRouter linking works there.

Docs only — no version bump, nothing user-facing changed. task docs:check green.

Assisted-by: Opus 5

The four slices each named deferrals in their PR bodies, but none of it landed
in the backlog — so the reasons would have evaporated with the PR descriptions.

Captures the five open items with *why* they were declined, not just what:
measured cost needs a background job (an inline per-turn lookup would add a round
trip, and OpenRouter writes the record asynchronously); a spend cap at mint time
depends on an undocumented, unverified `/auth` behavior and shouldn't be promised
before it's probed; management-key features were declined because they store a
second higher-privilege secret for a convenience.

Also flags the operational gotcha that isn't obvious from the code: existing
clusters need the new tokenless gateway location plus `up -d --force-recreate`
before OpenRouter linking works there — a plain restart won't reload a changed
bind-mounted file.

Docs only; no version bump (nothing user-facing changed).

Assisted-by: Opus 5
@vercel

vercel Bot commented Aug 1, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agentx-docs-site Ready Ready Preview Aug 1, 2026 11:42pm

@QR-Madness
QR-Madness merged commit a746a3e into master Aug 2, 2026
4 checks passed
@QR-Madness
QR-Madness deleted the docs/providers-backlog branch August 2, 2026 11:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant