`gjUdZddlmZddlmZehdZded<edGd d Zdd Z dd Z dd Z ddZ y)uUnified provider catalog — one source of truth for the provider universe. The provider list shown by ``hermes model`` (CLI/TUI) and the desktop Settings → Providers tabs (Accounts + API keys) **must be the same set**. Historically they were not: the CLI picker read :data:`hermes_cli.models.CANONICAL_PROVIDERS` (which auto-extends from ``plugins/model-providers//``), while the desktop tabs read separate hand-maintained lists (``_OAUTH_PROVIDER_CATALOG``, ``OPTIONAL_ENV_VARS`` + ``PROVIDER_GROUPS``) that nobody kept in sync. Every provider added after those lists were written silently went missing from the GUI — e.g. GitHub Copilot showing up only under "tools", or ``openai-api`` being configurable from the CLI but not the desktop app. This module fixes that at the root: it derives ONE descriptor per provider from the same universe ``hermes model`` renders (``CANONICAL_PROVIDERS``), joining: * ``auth_type`` / ``api_key_env_vars`` / ``base_url_env_var`` from :data:`hermes_cli.auth.PROVIDER_REGISTRY` (credential truth), and * ``display_name`` / ``description`` / ``signup_url`` from the provider's :class:`providers.base.ProviderProfile` when one exists, falling back to the ``CANONICAL_PROVIDERS`` entry's ``label`` / ``tui_desc`` and the ``OPTIONAL_ENV_VARS`` signup URL otherwise (many profiles leave these blank, and four canonical providers have no profile at all — lmstudio, openai-api, tencent-tokenhub, xai-oauth — so the fallbacks are load-bearing). Each descriptor is tagged with the ``tab`` it belongs on (``keys`` vs ``accounts``) based purely on how the provider authenticates. The desktop ``/api/env`` and ``/api/providers/oauth`` endpoints derive their MEMBERSHIP from this catalog; the old hand lists are demoted to presentation/override overlays (bespoke OAuth flow + status resolvers, richer copy, icons, ordering) and no longer decide which providers exist. Parity contract (locked by tests): the union of the two tabs equals the ``CANONICAL_PROVIDERS`` universe, i.e. exactly what ``hermes model`` shows. ) annotations) dataclass>copilot oauth_minimaxoauth_externalexternal_processoauth_device_codezfrozenset[str]_ACCOUNTS_AUTH_TYPEST)frozencleZdZUdZded<ded<ded<ded<ded<ded <ded <ded <d ed <y)ProviderDescriptorzDOne provider, as seen by every surface (CLI picker + both GUI tabs).strsluglabel description auth_typetabtuple[str, ...]api_key_env_varsbase_url_env_var signup_urlintorderN)__name__ __module__ __qualname____doc____annotations__N/root/.hermes/venv/lib/python3.12/site-packages/hermes_cli/provider_catalog.pyr r 8s5N I JN H%%O Jr r c|tvrdSdS)zEReturn the desktop tab ("keys"|"accounts") a provider's auth maps to.accountskeys)r )rs r!tab_for_auth_typer%Gs"&:::FFr cTtd|D}td|Dd}||fS)zASplit a profile's ``env_vars`` into (api_key_vars, base_url_var).c3hK|]*}|jdr|jdr'|,yw _BASE_URL_URLNendswith.0vs r! z"_split_env_vars..Ns'\qQZZ -D SYHZ\s 222c3fK|])}|jds|jds&|+ywr(r+r-s r!r0z"_split_env_vars..Os&Vq ;(?1::fCUVs'11)tuplenext)env_varsr$bases r!_split_env_varsr7Ls/ \H\ \D VHVXZ [D :r cddlm} ddlm} ddlm}|Dcic]}|j|}} ddlm } ddl m }g}t|D]\}} | j} |j| } |j| } |j| } | r t| ddndxs(| r t| ddndxs| r t| ddndxsd }| r4t| d d r't!| j"}t| d dxsd}n6| r/t| d d r"t%t!| j&\}}nd\}}| r t| ddndxs| j(xs| }| r t| ddndxs| j*xs|}| r t| ddndxsd}|s/|r-|j|dxsi}|jdxsd}|j-t/| |||t1||||| |S#t$ri}YwxYwcc}w#t$ri}YwxYw#t$ri}YwxYw#t$ri}YwxYw)aReturn one descriptor per provider in the ``hermes model`` universe. Membership is :data:`CANONICAL_PROVIDERS` (the list the CLI/TUI picker renders, which auto-extends from provider plugins). Auth + env come from ``PROVIDER_REGISTRY``; display metadata from ``ProviderProfile`` with canonical/env fallbacks so providers without a profile (or with blank profile metadata) still resolve sensibly. r)CANONICAL_PROVIDERS)PROVIDER_REGISTRY)list_providers)OPTIONAL_ENV_VARS)HERMES_OVERLAYSrr2api_keyrrrr5)rr2 display_namerrurl) rrrrrrrrr)hermes_cli.modelsr9hermes_cli.authr: Exception providersr;namehermes_cli.configr<hermes_cli.providersr= enumeratergetgetattrr3rr7r5rtui_descappendr r%)r9r:r;pprofilesr<r=outrentryrcfgprofoverlayr api_key_vars base_url_varrrrinfos r!provider_catalogrWSs6 5,'5'78!AFFAI8878%'C!"564 uzz##D)||D!!%%d+ /2WS+r *r 26k2.B 5<b1"   73 2B7 !5!56L"3(:B?E2L gdJ3)8t}}9M)N &L,)/ &L,37WT>2 .B {{   26WT=" -2 ~~   :>gdL"52L" l$((a9?RD%.BJ '#%i0!-!-%  Q4 j J[  9   sTG9HH HH"H49 HH H HH" H10H14 IIcRtDcic]}|j|c}Scc}w)z'Convenience: the catalog keyed by slug.)rWr)ds r!provider_catalog_by_slugrZs!/1 2!AFFAI 22 2s$N)rrreturnr)r5rr[ztuple[tuple[str, ...], str])r[zlist[ProviderDescriptor])r[zdict[str, ProviderDescriptor]) r __future__r dataclassesr frozensetr rr r%r7rWrZrr r!r_sa!F#!(1(n $   G ]@3r