hermes-model-switcher.yaml 4.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162
  1. # Community catalog entry — hermes-model-switcher
  2. #
  3. # Owner-submitted: the PR author (nicolasestrem) owns and maintains the repo below.
  4. # Exact-SHA pin (40-hex, resolves as a COMMIT on the repo). Dashboard-only plugin:
  5. # the whole code surface is a Dashboard extension tab served through the plugin host.
  6. name: hermes-model-switcher
  7. repo: https://github.com/nicolasestrem/hermes-model-switcher
  8. sha: d62530d906307154e16ed98bb9b4be10ea6fef56
  9. description: >-
  10. Choose models across Hermes profiles from a Dashboard tab: a per-profile
  11. picker built on host-supplied model data (SDK-authenticated
  12. GET /api/model/options), a preview of provider/model intent across every
  13. supported model-selection slot (main, delegation, auxiliary, judge,
  14. fallback, MoA, cron, plugin and specialist), and one-click apply or revert
  15. with presets.
  16. Main-slot preview shows intended provider/model, not the exact persisted
  17. diff; the exact diff is shown only after host readback. Disclosure — its
  18. apply route reads and edits the profiles' config.yaml (that is the plugin's
  19. function) through public seams only: POST /api/model/set for main and
  20. compatible auxiliary slots, and public hermes_cli.config load/save under the
  21. target home for other slots; credential presence checks use public
  22. profile-scoped secret helpers (agent.secret_scope), and profile discovery
  23. uses public hermes_constants. The plugin makes no direct third-party
  24. requests and opens no provider caches or pricing registries directly, but
  25. its browser tab does call the host's /api/model/* routes through the
  26. Dashboard SDK, and the host options route may itself initiate provider or
  27. pricing I/O even without an explicit refresh request, so reads are not
  28. guaranteed cache-only.
  29. It runs no shell commands or background processes and reports nothing. The
  30. private undo journal stores a full pre-change snapshot of each config it
  31. edits, which can contain sensitive fields including embedded credentials.
  32. Saved presets also persist reviewed change values, potentially including
  33. inline credentials or credential-bearing base URLs, in presets.json (0600)
  34. under get_hermes_home()/state/hermes-model-switcher/ (0700).
  35. The host write route has no expected-revision check: readback surfaces many
  36. foreign edits as recovery_required, but a concurrent same-key edit can be
  37. overwritten undetected and full-state deletions retain an unrelated-write
  38. race, so not every foreign edit is guaranteed to surface.
  39. maintainer: Nico Estrem
  40. tier: community
  41. category: models
  42. docs_url: https://github.com/nicolasestrem/hermes-model-switcher#readme
  43. version: "0.3.2"
  44. # Fresh 0.3.2 captures at the pinned commit, re-taken after the catalog-row
  45. # fix: Dashboard SDK fixture with the
  46. # plugin's real backend and Hermes' own /api/model/* routers over an isolated
  47. # lab home (provenance in docs/images/catalog-captures.json).
  48. screenshots:
  49. - https://raw.githubusercontent.com/nicolasestrem/hermes-model-switcher/d62530d906307154e16ed98bb9b4be10ea6fef56/docs/images/model-switcher-0.3.2-dashboard.png
  50. - https://raw.githubusercontent.com/nicolasestrem/hermes-model-switcher/d62530d906307154e16ed98bb9b4be10ea6fef56/docs/images/model-switcher-0.3.2-preview.png
  51. - https://raw.githubusercontent.com/nicolasestrem/hermes-model-switcher/d62530d906307154e16ed98bb9b4be10ea6fef56/docs/images/model-switcher-0.3.2-operation.png
  52. - https://raw.githubusercontent.com/nicolasestrem/hermes-model-switcher/d62530d906307154e16ed98bb9b4be10ea6fef56/docs/images/model-switcher-0.3.2-catalog.png
  53. - https://raw.githubusercontent.com/nicolasestrem/hermes-model-switcher/d62530d906307154e16ed98bb9b4be10ea6fef56/docs/images/model-switcher-0.3.2-light.png
  54. - https://raw.githubusercontent.com/nicolasestrem/hermes-model-switcher/d62530d906307154e16ed98bb9b4be10ea6fef56/docs/images/model-switcher-0.3.2-narrow.png
  55. known_issues:
  56. - "Couples at runtime to public Hermes seams that are not stability-guaranteed APIs (the /api/model/* dashboard routes, hermes_cli.config, agent.secret_scope, hermes_constants); a host refactor can break the plugin until it re-pins. Missing upstream seams remain open: a compare-and-save write with an expected-revision check (hermes-agent #142339), a public typed write route for non-main slots (#142340), and a dry-run footprint for exact main-slot previews (#142341)."
  57. capabilities:
  58. provides_tools: []
  59. provides_hooks: []
  60. provides_middleware: []
  61. requires_env: []
  62. requires_hermes: ">=0.22.3"