NousResearch/hermes-agent

Fix model picker truncation with pagination

Cluster 56586 · gateway. Data as of

1 open item. Fix merged in #92150 on 22 Aug 2026. Check it covers your case.

The short answer

1open issue
0open PRs
4items grouped
Known?
Yes. 4 related items grouped here, 0 issues already closed.
Fix event
A fix was merged to main in PR #92150. Check it covers your case. No release data is tracked.
Tracker
The maintainers' tracker marks this unresolved. That is separate from the fix event.
Still open
1 issue and 0 PRs.

These issues and PRs address a bug where model pickers silently truncate the available model list due to hardcoded limits (50 in interactive pickers, 25 in Discord). The work involves removing caps and adding pagination to display all available models.

Open issues1

  • Issue#56586Discord /model picker silently truncates providers with >25 models (models[:25]) — no pagination/search

Open PRs0

No open pull requests.

Fixes on record

Merged to main. A stamp counts the issues a fix is linked to.

  • #48611 fix(picker): remove max_models=50 cap in interactive model pickers

    merged to main

    files: cli.py, hermes_cli/inventory.py, hermes_cli/model_switch.py, hermes_cli/web_server.py, tests/hermes_cli/test_inventory.py, tests/hermes_cli/test_model_catalog.py, tui_gateway/server.py

    Show the diff
    • cli.py
      @@ -6930,7 +6930,7 @@ def _handle_model_switch(self, cmd_original: str):
                   try:
                       if ctx is None:
                           raise RuntimeError("inventory context unavailable")
      -                providers = build_models_payload(ctx, max_models=50)["providers"]
      +                providers = build_models_payload(ctx)["providers"]
                   except Exception:
                       providers = []
       
    • hermes_cli/inventory.py
      @@ -117,7 +117,7 @@ def build_models_payload(
           pricing: bool = False,
           capabilities: bool = False,
           force_fresh_nous_tier: bool = False,
      -    max_models: int = 50,
      +    max_models: int | None = None,
       ) -> dict:
           """Build the ``{providers, model, provider}`` shape every consumer
           needs from a single substrate call.
    • hermes_cli/model_switch.py
      @@ -1188,7 +1188,6 @@ def _warm() -> None:
                       current_model=ctx.current_model,
                       user_providers=ctx.user_providers,
                       custom_providers=ctx.custom_providers,
      -                max_models=50,
                   )
               except Exception:
                   # Best-effort warmup — never surface errors into the session.
      @@ -1206,7 +1205,7 @@ def list_authenticated_providers(
           custom_providers: list | None = None,
           *,
           force_fresh_nous_tier: bool = False,
      -    max_models: int = 8,
      +    max_models: int | None = None,
           current_model: str = "",
       ) -> List[dict]:
           """Detect which providers have credentials and list their curated models.
      @@ -1426,7 +1425,7 @@ def _has_aws_sdk_creds_for_listing(slug: str) -> bool:
                   if hermes_id in _MODELS_DEV_PREFERRED:
                       model_ids = _merge_with_models_dev(hermes_id, model_ids)
               total = len(model_ids)
      -        top = model_ids[:max_models]
      +        top = model_ids[:max_models] if max_models is not None else model_ids
       
               slug = hermes_id
               pinfo = _mdev_pinfo(mdev_id)
      @@ -1589,7 +1588,7 @@ def _has_aws_sdk_creds_for_listing(slug: str) -> bool:
                       if hermes_slug in _MODELS_DEV_PREFERRED:
                           model_ids = _merge_with_models_dev(hermes_slug, model_ids)
               total = len(model_ids)
      -        top = model_ids[:max_models]
      +        top = model_ids[:max_models] if max_models is not None else model_ids
       
               results.append({
                   "slug": hermes_slug,
      @@ -1664,7 +1663,7 @@ def _has_aws_sdk_creds_for_listing(slug: str) -> bool:
                   if not _cp_model_ids:
                       _cp_model_ids = curated.get(_cp.slug, [])
               _cp_total = len(_cp_model_ids)
      -        _cp_top = _cp_model_ids[:max_models]
      +        _cp_top = _cp_model_ids[:max_models] if max_models is not None else _cp_model_ids
       
               results.append({
                   "slug": _cp.slug,
      @@ -1813,7 +1812,7 @@ def _has_aws_sdk_creds_for_listing(slug: str) -> bool:
                   "name": "Custom endpoint",
                   "is_current": True,
                   "is_user_defined": True,
      -            "models": _models[:max_models] if max_models else _models,
      +            "models": _models[:max_models] if max_models is not None else _models,
                   "total_models": len(_models),
                   "source": "model-config",
                   "api_url": str(current_base_url).strip().rstrip("/"),
      @@ -2040,7 +2039,7 @@ def list_picker_providers(
           current_base_url: str = "",
           user_providers: dict = None,
           custom_providers: list | None = None,
      -    max_models: int = 8,
      +    max_models: int | None = None,
           current_model: str = "",
       ) -> List[dict]:
           """Interactive-picker variant of :func:`list_authenticated_providers`.
      @@ -2083,7 +2082,7 @@ def list_picker_providers(
                   except Exception:
                       live_ids = list(p.get("models", []))
                   p = dict(p)
      -            p["models"] = live_ids[:max_models]
      +            p["models"] = live_ids[:max_models] if max_models is not None else live_ids
                   p["total_models"] = len(live_ids)
       
               has_models = bool(p.get("models"))
    • hermes_cli/web_server.py
      @@ -3323,7 +3323,6 @@ def get_model_options(profile: Optional[str] = None):
               with _profile_scope(profile):
                   return build_models_payload(
                       load_picker_context(),
      -                max_models=50,
                       include_unconfigured=True,
                       picker_hints=True,
                       canonical_order=True,
      @@ -3398,7 +3397,7 @@ def get_recommended_default_model(provider: str = ""):
           try:
               from hermes_cli.inventory import build_models_payload, load_picker_context
       
      -        payload = build_models_payload(load_picker_context(), max_models=50)
      +        payload = build_models_payload(load_picker_context())
               for row in payload.get("providers", []):
                   if str(row.get("slug", "")).lower() == slug:
                       models = row.get("models") or []
    • tests/hermes_cli/test_inventory.py
      @@ -660,3 +660,31 @@ def test_two_custom_providers_with_overlap_both_survive():
           assert a_row["total_models"] == 2
           assert b_row["total_models"] == 2
       
      +
      +def test_build_models_payload_no_max_models_returns_full_list():
      +    """When max_models is not passed (None), build_models_payload must
      +    return the full model list — not truncate to the old default of 50.
      +    Regression for #48279: Kilo Gateway picker was capped at 50 of 336
      +    models, making most models undiscoverable via search."""
      +    full_models = [f"model-{i}" for i in range(100)]
      +    rows = [
      +        {
      +            "slug": "kilocode",
      +            "name": "Kilo Code",
      +            "models": full_models,
      +            "total_models": len(full_models),
      +            "is_current": False,
      +            "is_user_defined": False,
      +            "source": "built-in",
      +        },
      +    ]
      +    ctx = _empty_ctx()
      +    with _list_auth_returning(rows):
      +        # No max_models argument — should return all 100 models
      +        payload = build_models_payload(ctx)
      +
      +    kilo_row = next(r for r in payload["providers"] if r["slug"] == "kilocode")
      +    assert kilo_row["models"] == full_models
      +    assert kilo_row["total_models"] == 100
      +    assert len(kilo_row["models"]) == 100
      +
    • tests/hermes_cli/test_model_catalog.py
      @@ -423,6 +423,71 @@ def test_picker_nous_row_uses_curated_list(self, tmp_path, monkeypatch):
               assert nous_row is not None, "nous row must appear when authed"
               assert nous_row["models"] == expected
       
      +    def test_picker_max_models_cap_semantics(self, tmp_path, monkeypatch):
      +        """The cap argument has three distinct meanings on the real slicing
      +        path: ``None`` = unlimited (the cap-removal fix, #48297), ``0`` = no
      +        models (preserved for slug-only callers), an int N = first N. Guards
      +        the ``is not None`` distinction the cap-removal follow-up introduced —
      +        a ``if max_models`` (falsy) check would conflate ``0`` with unlimited.
      +        """
      +        import importlib
      +        from hermes_cli import model_catalog
      +        from hermes_cli.models import get_curated_nous_model_ids
      +        importlib.reload(model_catalog)
      +        try:
      +            from hermes_cli.model_switch import (
      +                list_authenticated_providers,
      +                list_picker_providers,
      +            )
      +
      +            active_home = Path(os.environ["HERMES_HOME"])
      +            (active_home / "auth.json").write_text(
      +                json.dumps(
      +                    {
      +                        "providers": {"nous": {"access_token": "fake"}},
      +                        "credential_pool": {},
      +                    }
      +                )
      +            )
      +            with patch.object(
      +                model_catalog, "_fetch_manifest", return_value=_valid_manifest()
      +            ), patch("hermes_cli.models.check_nous_free_tier", return_value=False), patch(
      +                "hermes_cli.models.union_with_portal_free_recommendations",
      +                side_effect=lambda ids, *a, **k: (ids, {}),
      +            ), patch(
      +                "hermes_cli.models.union_with_portal_paid_recommendations",
      +                side_effect=lambda ids, *a, **k: (ids, {}),
      +            ):
      +                expected = get_curated_nous_model_ids()
      +                full = list_picker_providers(current_provider="nous", max_models=None)
      +                one = list_picker_providers(current_provider="nous", max_models=1)
      +                # 0 is exercised on list_authenticated_providers (the slug-only
      +                # path); the picker variant drops empty-model rows entirely, so
      +                # the empty-list contract lives on the auth-providers call.
      +                zero = list_authenticated_providers(
      +                    current_provider="nous", max_models=0
      +                )
      +        finally:
      +            model_catalog.reset_cache()
      +
      +        def _nous(rows):
      +            return next((r for r in rows if r["slug"] == "nous"), None)
      +
      +        # Only meaningful when the curated list actually exceeds 1 entry.
      +        assert len(expected) > 1, "test needs a multi-model curated nous list"
      +
      +        full_row = _nous(full)
      +        assert full_row is not None and full_row["models"] == expected
      +
      +        one_row = _nous(one)
      +        assert one_row is not None and one_row["models"] == expected[:1]
      +
      +        zero_row = _nous(zero)
      +        # 0 means an empty model list — NOT unlimited. total_models still real.
      +        assert zero_row is not None
      +        assert zero_row["models"] == []
      +        assert zero_row["total_models"] == len(expected)
      +
       
       # -----------------------------------------------------------------------------
       # Drift guard — prevent the in-repo curated lists from going out of sync with
    • tui_gateway/server.py
      @@ -9280,7 +9280,6 @@ def _(rid, params: dict) -> dict:
                   canonical_order=True,
                   pricing=True,
                   capabilities=True,
      -            max_models=50,
               )
               return _ok(rid, payload)
           except Exception as e:
  • #92150 fix(discord): render provider model lists longer than 25 options across multiple select menus

    merged to main

    files: contributors/emails/[redacted:email], plugins/platforms/discord/adapter.py, tests/gateway/test_discord_model_picker_partition.py

1 PR closed without merging

From the close comments: superseded by another PR 1

  • #56595 fix(discord): paginate /model picker when provider has >25 models · superseded by another PR → #92150, #56586
How this cluster was grouped
  • Link evidence (structural links throughout): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
  • Pairwise link density 0.50: the share of item pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. 1.00 means every pair is linked.

Pick up a Lab task

Check whether a fix covers the open issues here, with your own agent. Bring back evidence for maintainers.

Open the Lab

At a glance

Subsystem
gateway
Merged PRs
#48611, #92150
Closed issues
0
Attempts
1 PR closed without merging
Fix link checked
22 Aug 2026

For your agent

The same facts, typed.