| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413 |
- """Interactive model picker used after OAuth login.
- Re-exported from ``hermes_cli/auth.py`` (patch targets unchanged); origin helpers are imported
- lazily per function so ``hermes_cli.auth.<helper>`` patches still intercept and no cycle forms.
- """
- from __future__ import annotations
- import logging
- import subprocess
- from typing import Dict, List, Optional
- from hermes_cli.auth_constants import DEFAULT_NOUS_PORTAL_URL
- logger = logging.getLogger("hermes_cli.auth")
- _CUSTOM_LABEL = "Enter custom model name"
- _SKIP_LABEL = "Skip (keep current)"
- _CURRENT_SUFFIX = " ← currently in use"
- def _confirm_selection_guards(
- model_id: str, *, provider: str = "", base_url: str = "", api_key: str = "",
- include_kinds: Optional[list[str]] = None,
- ) -> bool:
- """Prompt before saving a model that trips any selection guard (cost, data-policy, ...).
- Shows one [y/N] confirm listing every warning that fired. Returns True to proceed.
- """
- try:
- from hermes_cli.model_selection_guards import combined_message, selection_warnings
- warnings = selection_warnings(
- model_id, provider=provider, base_url=base_url, api_key=api_key, include_kinds=include_kinds,
- )
- except Exception:
- warnings = []
- if not warnings:
- return True
- print()
- print("=" * 72)
- print(combined_message(warnings))
- print("=" * 72)
- try:
- response = input("Switch anyway? [y/N]: ").strip().lower()
- except (KeyboardInterrupt, EOFError):
- print()
- return False
- return response in {"y", "yes"}
- # Usage column on a window plan: "Large" / "Free" (other levels carry no tag).
- _COST_COL = len("Large")
- _GAUGE_GAP = " "
- # Style per gateway level: Free green, Large yellow (it draws on its own limit), the rest plain.
- _LEVEL_STYLE = {"free": "green", "top_tier": "yellow"}
- class _ModelPickerRows:
- """Column-aligned picker rows.
- Usage-window plan: ``Large`` / ``Free`` on the rows the gateway marks, exactly as
- the gateway sent it on this caller's catalog. Every other account keeps ``$/Mtok``.
- Chrome is emitted as styled segments, not ANSI baked into one string — curses addnstr would
- render escape bytes literally.
- """
- def __init__(
- self, all_models: list[str], pricing: Optional[dict[str, dict[str, str]]], *,
- current_model: str, sale_chrome: bool, usage=None,
- notes: Optional[dict[str, str]] = None,
- ) -> None:
- from hermes_cli.models_pricing import _format_price_per_mtok, compute_sale_discount
- self.current_model = current_model
- # Per-model dim annotation (e.g. "usage credits"); the row stays selectable.
- self.notes = notes or {}
- self.window_mode = usage is not None
- if self.window_mode:
- # The gateway's ``top_tier`` marks decide which rows a full large-model limit dims.
- usage = usage.with_pricing(pricing)
- self.usage = usage
- if self.window_mode:
- from hermes_cli.model_picker_usage import usage_tag_levels
- # Tags only: dimming reads ``usage.blocks`` (free_ids), so subscription-billed rows still never dim.
- self.levels = usage_tag_levels(all_models, pricing)
- self.has_pricing = False
- self.has_cache = False
- self.any_on_sale = False
- self.price_col = self.cache_col = 0
- self._price_cache = {}
- self.has_top_tier = "top_tier" in self.levels.values()
- self.name_col = max((len(m) for m in all_models), default=0) + 2
- return
- self.levels = {}
- self.has_top_tier = False
- self.has_pricing = bool(pricing and any(pricing.get(m) for m in all_models))
- # Leave room for a leading "★ " on sale rows (Nous only).
- name_pad = 3 if sale_chrome else 2
- self.name_col = max((len(m) for m in all_models), default=0) + name_pad if self.has_pricing else 0
- # (inp, out, cache, pct|None, was_inp, was_out)
- self._price_cache: dict[str, tuple[str, str, str, int | None, str, str]] = {}
- self.price_col = 3 # minimum width
- self.cache_col = 0 # only set if any model has cache pricing
- self.has_cache = False
- self.any_on_sale = False
- if not self.has_pricing:
- return
- def _was(raw: str) -> str:
- return _format_price_per_mtok(raw) if raw != "" else "?"
- for mid in all_models:
- p = pricing.get(mid) # type: ignore[union-attr]
- pct: int | None = None
- was_inp = was_out = ""
- inp, out, cache = "", "", ""
- if p:
- inp = _format_price_per_mtok(p.get("prompt", ""))
- out = _format_price_per_mtok(p.get("completion", ""))
- cache_read = p.get("input_cache_read", "")
- cache = _format_price_per_mtok(cache_read) if cache_read else ""
- if cache:
- self.has_cache = True
- sale = compute_sale_discount(p.get("prompt", ""), p.get("completion", ""), p.get("original")) if sale_chrome else None
- if sale is not None:
- self.any_on_sale = True
- pct, was_prompt_raw, was_out_raw = sale
- # Natively-free models (no gateway original) carry empty was_* raws — leave
- # them empty so the row shows bare "-100%" with no "was ?/?" suffix.
- if was_prompt_raw != "" or was_out_raw != "":
- was_inp, was_out = _was(was_prompt_raw), _was(was_out_raw)
- self._price_cache[mid] = (inp, out, cache, pct, was_inp, was_out)
- self.price_col = max(self.price_col, len(inp), len(out))
- self.cache_col = max(self.cache_col, len(cache))
- if self.has_cache:
- self.cache_col = max(self.cache_col, 5) # minimum: "Cache" header
- def _cost_segments(self, mid: str) -> list[tuple[str, str | None]]:
- """Window row: padded name (dim when a full allowance stops it) + Large / Free."""
- segs: list[tuple[str, str | None]] = [(f"{mid:<{self.name_col}}", "dim" if self.usage.blocks(mid) else None)]
- from hermes_cli.model_picker_usage import usage_level_label
- level = self.levels.get(mid)
- word = usage_level_label(level, "en")
- segs.extend(((_GAUGE_GAP, None), (f"{word:<{_COST_COL}}", _LEVEL_STYLE.get(level or ""))))
- return segs
- def segments(self, mid: str) -> list[tuple[str, str | None]]:
- """Build a rich radiolist row: yellow ★/% , dim was, plain prices — or usage gauges on the window."""
- current = [(_CURRENT_SUFFIX, None)] if mid == self.current_model else []
- note = [(f" · {self.notes[mid]}", "dim")] if self.notes.get(mid) else []
- if self.window_mode:
- return self._cost_segments(mid) + current
- if not self.has_pricing:
- return [(mid, None), *note, *current]
- inp, out, cache, pct, was_inp, was_out = self._price_cache.get(mid, ("", "", "", None, "", ""))
- on_sale = pct is not None
- # Reserve 2 columns for "★ " so sale and non-sale names share alignment.
- if on_sale:
- segs: list[tuple[str, str | None]] = [("★ ", "yellow"), (f"{mid:<{self.name_col - 2}}", None)]
- else:
- segs = [(f"{mid:<{self.name_col}}", None)]
- price_part = f" {inp:>{self.price_col}} {out:>{self.price_col}}"
- if self.has_cache:
- price_part += f" {cache:>{self.cache_col}}"
- segs.append((price_part, None))
- if on_sale:
- segs.append((f" -{pct}%", "yellow"))
- if was_inp or was_out:
- segs.append((f" was {was_inp}/{was_out}", "dim"))
- return segs + note + current
- def label(self, mid: str) -> str:
- return "".join(text for text, _style in self.segments(mid))
- def description_lines(self) -> list[str]:
- """Lines between the title and the list: plan gauges (window plan), column headers, legend.
- Each choice is " {label}" (2 spaces) plus a 3-char cursor region ("-> " or " "), so column
- content starts at col 5."""
- pad = " " * 5
- lines: list[str] = []
- if self.window_mode:
- from hermes_cli.model_picker_usage import plan_gauge_lines
- for i, line in enumerate(plan_gauge_lines(self.usage)):
- suffix = f" — {self.usage.included_summary}" if i == 0 else ""
- lines.append(f"{pad}{line}{suffix}")
- lines.append(f"{pad}{'':>{self.name_col}}{_GAUGE_GAP}Usage")
- return lines
- if self.has_pricing:
- header = f"{pad}{'':>{self.name_col}} {'In':>{self.price_col}} {'Out':>{self.price_col}}"
- if self.has_cache:
- header += f" {'Cache':>{self.cache_col}}"
- header += " $/Mtok"
- if self.any_on_sale:
- header += " ★ = on sale"
- lines.append(header)
- return lines
- def menu_title(self, title: str = "Select default model:") -> str:
- """*title* plus the description lines (headers / gauges), newline-joined."""
- lines = self.description_lines()
- return title + ("\n" + "\n".join(lines) if lines else "")
- def footnote(self) -> str:
- """Window plan with a Large row listed: the one line that says what Large means."""
- if not self.has_top_tier:
- return ""
- from hermes_cli.model_picker_usage import TOP_TIER_FOOTNOTE
- return TOP_TIER_FOOTNOTE
- def _picker_order(model_ids: list[str], current_model: str, window_usage) -> tuple[list[str], dict[int, str], int]:
- """``(ordered ids, {row index: section heading}, cursor start)`` for the picker.
- Window plan: "Recommended" (the plan's featured picks) then "Other models", with the current
- model left in its own section (the cursor starts on it). Everyone else: current first.
- """
- sections: dict[int, str] = {}
- if window_usage is not None:
- from hermes_cli.model_picker_usage import SECTION_OTHER, SECTION_RECOMMENDED, split_recommended
- head, rest = split_recommended(list(dict.fromkeys(model_ids)), window_usage.featured_model_ids)
- ordered = head + rest
- if head:
- sections[0] = SECTION_RECOMMENDED
- if rest:
- sections[len(head)] = SECTION_OTHER
- else:
- # Reorder: current model first, then the rest (deduplicated)
- ordered = list(dict.fromkeys(
- ([current_model] if current_model and current_model in model_ids else []) + list(model_ids)
- ))
- return ordered, sections, (ordered.index(current_model) if current_model in ordered else 0)
- def _print_numbered_rows(rows: _ModelPickerRows, menu_title: str, ordered: list[str], sections: dict[int, str]) -> int:
- """The no-curses fallback's title, numbered rows (+ custom / skip) and footnote; returns the number width."""
- from hermes_cli.curses_ui import colorize_gauge_bars_ansi, format_radio_item_ansi
- from hermes_cli.colors import Colors, color
- n, _DIM, _RESET = len(ordered), "\033[2m", "\033[0m"
- for line in menu_title.splitlines():
- if rows.window_mode:
- line = colorize_gauge_bars_ansi(line)
- print(line.replace("★", color("★", Colors.YELLOW), 1) if "★" in line else line)
- num_width = len(str(n + 2))
- for i, mid in enumerate(ordered, 1):
- if (i - 1) in sections:
- print(f" {_DIM}{sections[i - 1]}{_RESET}")
- print(f" {i:>{num_width}}. {format_radio_item_ansi(rows.segments(mid))}")
- print(f" {n + 1:>{num_width}}. {_CUSTOM_LABEL}")
- print(f" {n + 2:>{num_width}}. {_SKIP_LABEL}")
- if footnote := rows.footnote():
- print(f" {_DIM}{footnote}{_RESET}")
- return num_width
- def _prompt_model_selection(
- model_ids: list[str], current_model: str = "",
- pricing: Optional[dict[str, dict[str, str]]] = None,
- unavailable_models: Optional[list[str]] = None, portal_url: str = "",
- unavailable_message: str = "", confirm_provider: str = "", confirm_base_url: str = "",
- confirm_api_key: str = "", usage=None,
- notes: Optional[dict[str, str]] = None, title: str = "Select default model:",
- ) -> Optional[str]:
- """Interactive model picker; current_model listed first. Returns the chosen model ID or None. *title* heads
- the menu (a plugin picking a model for something other than the default says so).
- With *pricing* (``{model_id: {prompt, completion}}``) a compact price column is shown; models in
- *unavailable_models* render grayed out and unselectable with an upgrade link to *portal_url*.
- *usage* (``model_picker_usage.PickerUsage``, Nous only) swaps ``$/Mtok`` for plan gauges and the
- gateway's per-model usage word on a usage-window plan.
- """
- from hermes_cli.cli_output import line_input
- _unavailable = unavailable_models or []
- # Sale chrome is Nous Portal-only, even if pricing.original is present for another provider.
- sale_chrome = (confirm_provider or "").strip().lower() == "nous"
- def _confirmed_selection(mid: str) -> Optional[str]:
- if not mid:
- return None
- # Cost guard needs a known provider; id-keyed guards (data policy) always run.
- ok = _confirm_selection_guards(
- mid, provider=confirm_provider, base_url=confirm_base_url, api_key=confirm_api_key,
- include_kinds=None if confirm_provider else ["data_policy"],
- )
- return mid if ok else None
- def _custom_selection() -> Optional[str]:
- try:
- custom = line_input("Enter model name: ").strip()
- except (EOFError, KeyboardInterrupt):
- return None
- return _confirmed_selection(custom) if custom else None
- # All models for column-width computation (selectable + unavailable). Plan usage is Nous-only chrome.
- window_usage = usage if sale_chrome else None
- ordered, sections, start = _picker_order(model_ids, current_model, window_usage)
- rows = _ModelPickerRows(
- ordered + list(_unavailable), pricing, current_model=current_model, sale_chrome=sale_chrome,
- usage=window_usage, notes=notes)
- _DIM = "\033[2m"
- _RESET = "\033[0m"
- menu_title = rows.menu_title(title)
- _upgrade_url = (portal_url or DEFAULT_NOUS_PORTAL_URL).rstrip("/")
- n = len(ordered)
- # Try arrow-key menu first, fall back to number input.
- try:
- from hermes_cli.curses_ui import curses_radiolist
- choices = [rows.segments(mid) for mid in ordered] + [_CUSTOM_LABEL, _SKIP_LABEL]
- unavailable_footer = unavailable_message.strip()
- if not unavailable_footer and _unavailable:
- unavailable_footer = f"Upgrade at {_upgrade_url} for paid models"
- # Header/legend/gauges + unavailable block go in the description so they survive the curses clear.
- desc_lines: list[str] = rows.description_lines()
- if _unavailable:
- desc_lines.extend(f" {rows.label(mid)}" for mid in _unavailable)
- desc_lines.append(f" ── {unavailable_footer} ──")
- if footnote := rows.footnote():
- desc_lines.append(f" {footnote}")
- # Search haystack = label + aliases for brand-less wire ids (Kimi `k3` ↔ "kimi"); skip when
- # model_search_text adds nothing beyond the bare id.
- from hermes_cli.model_search import model_search_text
- model_search_labels = []
- for mid in ordered:
- label, haystack = rows.label(mid), model_search_text(mid)
- model_search_labels.append(label if haystack == mid else f"{label} {haystack}")
- model_search_labels += [_CUSTOM_LABEL, _SKIP_LABEL]
- idx = curses_radiolist(
- title,
- choices,
- selected=start, # cursor on the current model
- cancel_returns=-1,
- description="\n".join(desc_lines) if desc_lines else None,
- searchable=True,
- search_labels=model_search_labels,
- headings=sections or None,
- )
- if idx < 0:
- return None
- print()
- if idx < n:
- return _confirmed_selection(ordered[idx])
- if idx == n:
- return _custom_selection()
- return None
- except (ImportError, NotImplementedError, OSError, subprocess.SubprocessError):
- pass
- # Fallback: numbered list (ANSI colors for sale chrome / usage gauges)
- num_width = _print_numbered_rows(rows, menu_title, ordered, sections)
- if _unavailable:
- unavailable_footer = unavailable_message.strip() or (
- f"Unavailable models (requires paid tier — upgrade at {_upgrade_url})"
- )
- print()
- print(f" {_DIM}── {unavailable_footer} ──{_RESET}")
- for mid in _unavailable:
- print(f" {'':>{num_width}} {_DIM}{rows.label(mid)}{_RESET}")
- print()
- while True:
- try:
- choice = input(f"Choice [1-{n + 2}] (default: skip): ").strip()
- if not choice:
- return None
- idx = int(choice)
- if 1 <= idx <= n:
- return _confirmed_selection(ordered[idx - 1])
- if idx == n + 1:
- return _custom_selection()
- if idx == n + 2:
- return None
- print(f"Please enter 1-{n + 2}")
- except ValueError:
- print("Please enter a number")
- except (KeyboardInterrupt, EOFError):
- return None
- _model_choice_saves = 0 # bumped per saved pick; `hermes model` reads it to know a pick landed
- def model_choice_save_count() -> int:
- return _model_choice_saves
- def _save_model_choice(model_id: str) -> None:
- """Save the selected model to config.yaml only — NOT .env, which would stomp in multi-agent setups."""
- global _model_choice_saves
- from hermes_cli.config import save_config, load_config
- _model_choice_saves += 1
- config = load_config()
- # Always use dict format so provider/base_url can be stored alongside
- if isinstance(config.get("model"), dict):
- config["model"]["default"] = model_id
- else:
- config["model"] = {"default": model_id}
- save_config(config)
- from hermes_cli.observability.shared_metrics_setup import note_provider_setup_saved
- note_provider_setup_saved()
- # Public for plugins (catalog rule 9): the interactive model picker under a caller's title.
- prompt_model_selection = _prompt_model_selection
|