Skip to content

[Docs] Explain model-specific reasoning capabilities - #3257

Draft
roomote-roomote[bot] wants to merge 1 commit into
developfrom
docs/model-specific-reasoning-guidance-39t8gygkrzqvs
Draft

roomote-roomote[bot] wants to merge 1 commit into
developfrom
docs/model-specific-reasoning-guidance-39t8gygkrzqvs

Conversation

@roomote-roomote

Copy link
Copy Markdown
Contributor

​Opened on behalf of @mrubens. View the task or mention @roomote-roomote for follow-up asks.

What changed

  • Explain that reasoning levels are model-specific and can vary between provider routes for the same model family.
  • Document how refreshed model metadata limits the picker and validates custom mapping presets against the selected model's supported levels.
  • Clarify the metadata and verification limits for custom and self-hosted OpenAI-compatible endpoints.

Why this change was made

A recent user question highlighted that local and less-common models may support different reasoning-level subsets. Roomote already enforces those capabilities in the model picker and preset flow, but the public model guide did not explain that users should verify the per-model choices.

Impact

People configuring models can distinguish a provider or model capability limit from a Roomote failure, refresh stale metadata after provider changes, and avoid assuming that every model accepts every reasoning level.

@roomote-community

roomote-community Bot commented Sep 28, 2026 •

Copy link
Copy Markdown
Contributor

1 issue outstanding. See task

  • apps/docs/models.mdx:397-401 says endpoint-reported reasoning metadata hides the selector, but endpoint discovery does not collect that capability and unknown models keep it visible.

Reviewed 3d2fe6e

Comment thread apps/docs/models.mdx
Comment on lines +397 to +401
For a custom or self-hosted OpenAI-compatible endpoint, capability metadata
depends on what that endpoint reports. After adding a model or changing a
provider, refresh model metadata in **Settings > Models** and confirm the
available choices in the picker. If the endpoint does not expose configurable
reasoning, Roomote hides the selector for that model; check the endpoint's

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Endpoint discovery does not report reasoning capabilities to Roomote: buildLocalProviderModel only retains context and pricing fields. An endpoint model that Roomote cannot otherwise identify has null metadata, and the settings UI deliberately leaves the selector visible for unknown support. Consequently, an endpoint that omits reasoning support will not hide the selector as this paragraph says. Describe this metadata as best-effort Roomote catalog data, or state that the selector is hidden only when its metadata explicitly reports no configurable reasoning.

This branch has not been deployed

No deployments
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