docs: document the provider option and refresh the vendor list in chat() - #3505
Merged
Salazareo merged 1 commit intoAug 4, 2026
Merged
Conversation
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.
What
Two documentation changes to
puter.ai.chat():provideroption, which is not currently in the options list.puter.ai.listModelProviders()returns 16.Why
provideris undocumented.ChatCompletionDriver.complete()readsargs.providerand passes it to#resolveModel()to pin a request to a vendor, andputer.ai.chat()forwards the option through. Nothing in the docs mentions it, so there is currently no documented way to ask for a specific vendor.The vendor list is stale. Both places name OpenAI, Anthropic, Google, xAI, Mistral, OpenRouter and DeepSeek.
puter.ai.listModelProviders()returned 16 ids when I ran the playground example on 2026-08-04:The replacement list is those ids written as company names, merging the two pairs that are one vendor (
azure-openai+azure-openai-responses,openai-completion+openai-responses). It is the API response rather than a hand-picked selection.Both new links also give
listModelProvidersits first inbound link from the docs. Nothing currently links to that page.One question for a maintainer
I deliberately did not document what happens when the requested vendor does not serve the requested model.
#resolveModel()currently returnsmodels.find(m => m.provider === provider) ?? models[0], so it falls back to the default vendor for that model rather than erroring. I did not want to write that down as intended behaviour without someone confirming it is intended. Happy to add a sentence either way, or to leave it out.Disclosure
Infron is one of the vendors added to the list. I work on the Infron provider integration merged in #3433. The list is taken from the API response rather than curated, and the
providerdocumentation applies to every vendor equally.