Repository navigation
docs: document combo invocation by exact model name (#7992) - #10779
Merged
diegosouzapw merged 1 commit intoAug 20, 2026
Merged
diegosouzapw merged 1 commit into
diegosouzapw merged 1 commit into
Conversation
maxmad64bis
force-pushed
the
docs/7992-combo-invocation-docs
branch
from
August 19, 2026 21:59
94376d5 to
ab5f136
Compare
Persisted combos (Settings → Combos) are only used when the client sends their exact name in the model field; auto/auto/* is a separate zero-config router that does not consult persisted combos, and openrouter/auto is a real paid OpenRouter product (Auto Best Available), not an alias. Three surfaces, no runtime change: - Combos page guide: info block + 4 i18n keys (usageGuideInvoke*) - docs/routing/AUTO-COMBO.md: 'Calling a Custom Combo From a Client' section - docs/getting-started/AUTO-COMBO-GUIDE.md: FAQ exact-name requirement - changelog fragment + unit test (tests/unit/combo-guide-invocation-keys.test.ts)
maxmad64bis
force-pushed
the
docs/7992-combo-invocation-docs
branch
from
August 19, 2026 22:02
ab5f136 to
5124d91
Compare
muhamadgalihsaputra
pushed a commit
to niyatna/NiyatnaRoute
that referenced
this pull request
Sep 27, 2026
… (diegosouzapw#10779) Merged via merge-train (release/v3.8.50, batch1 2026-08-20) — static gates (typecheck/file-size/complexity/cognitive/changelog) green on the combined tree; test:unit reds observed in the boarded run were verified pre-existing on the pure release tip (unrelated flake), not caused by this PR. Thanks for the contribution!
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Persisted combos (Settings → Combos) are only used when the client sends their exact name in the
modelfield —auto/auto/*is a separate zero-config router that does not consult persisted combos. The confusion produced two issues (#7992, #7111): reporters' clients kept sendingmodel: "auto"while their combos were never reached, andopenrouter/auto402s were a real paid OpenRouter product, not an alias.This PR documents the invocation contract on three surfaces (no runtime change):
usageGuideInvoke*)docs/routing/AUTO-COMBO.md: new sectionCalling a Custom Combo From a Clientdocs/getting-started/AUTO-COMBO-GUIDE.md: FAQCan I force a specific provider?now mentions the exact-name requirementchangelog.d/maintenance/10779-combo-invocation-docs.md)Related Issues
Validation
Choose the change type and focused loop from the Contribution Golden Path. The full unit suite, Vitest, the 60% coverage gate, and the production build all run in CI on this PR (#8329):
check:docs-sync,check:docs-counts,check:doc-links,check:fabricated-docs,i18n:check-ui-coverage,check:changelog-integrity— PASS locallynpm run lint— PASS locally3d7ed7aa8, branch rebased, focused checks rerun afterward)tests/unit/combo-guide-invocation-keys.test.ts(2 tests)Known base-red:⚠️ base-red inherited: #9985
check:env-doc-syncfails on the base tip itself (verified on a clean base worktree).Tests Added Or Updated
tests/unit/combo-guide-invocation-keys.test.ts— new: asserts the 4usageGuideInvoke*i18n keys exist inen.jsonwith the expected copy, and thatComboUsageGuide(page.tsx) references each key viagetI18nOrFallback. Run:node --import tsx/esm --test tests/unit/combo-guide-invocation-keys.test.ts→ 2/2 PASS.Coverage Notes
src/app/(dashboard)/dashboard/combos/page.tsx(4getI18nOrFallbackcalls) + 4 newen.jsonkeys (i18n files excluded from the test-policy gate by design). The new test covers the catalog keys and their page references; no covered branches are removed, so no coverage movement is expected.Reviewer Notes
getComboForModel()resolution order is untouched.check:dashboard-typecheckwas inconclusive in the dev environment (stalenode_modulesbefore the fork sync; process died afternpm install); the gate runs authoritatively in CI.lint:mdreports only pre-existing errors (CHANGELOG.md, AUTO-COMBO.md lines 7/10, AUTO-COMBO-GUIDE.md lines 7/50) — none on the added lines.