frihet.yaml 5.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  1. # Hermes plugin-catalog entry for hermes-frihet v0.2.1.
  2. #
  3. # Catalog: NousResearch/hermes-agent/plugin-catalog/frihet.yaml
  4. # Per the catalog rules (plugin-catalog/README.md):
  5. # - The maintainer of the plugin repository (Frihet-io) is the only one
  6. # authorised to submit the entry.
  7. # - ``tier`` MUST be ``community`` — ``official`` in the catalog means
  8. # "maintained by NousResearch". We describe ourselves as the "Official
  9. # Hermes Agent integration for Frihet" in the description, not in the
  10. # catalog's tier label.
  11. # - The SHA must be a 40-character full commit hash of a tagged, audited
  12. # commit of Frihet-io/hermes-frihet. Update via a new PR whenever we
  13. # ship a meaningful change (rule 4 of the catalog admission policy).
  14. name: frihet
  15. repo: https://github.com/Frihet-io/hermes-frihet
  16. # Pinned SHA — Frihet-io/hermes-frihet @ v0.2.1 (tagged)
  17. # (fix(classifier): treat anomaly_list as read; make manifest tests real).
  18. #
  19. # This SHA supersedes ``f331208`` (the older doctor that read the OAuth
  20. # token cache), ``24a9612`` (first privacy fix), ``3c8325a`` (CI rename
  21. # + first default_enabled), ``b9a8067`` (slash-command + redact
  22. # per-line + first connector safety net), ``b77f5df4`` (canonical Frihet
  23. # externalSideEffects drives classification), ``e805bf2`` (source head
  24. # of the PyYAML branch before squash) AND ``4f092d58`` (PyYAML runtime
  25. # dependency, PR #1). It pins all of the above AND:
  26. # * Hook dispatcher that passes the FULL tool name to the gate (no
  27. # more silent bypass of the approval gate).
  28. # * Doctor that derives auth evidence from ``ctx.call_mcp`` — the
  29. # plugin never reads ~/.hermes/mcp-tokens.
  30. # * Doctor that drops the list_invoices envelope from its output
  31. # (no invoice/customer data leaks through /frihet doctor).
  32. # * Setup that does NOT accept credentials as slash-command
  33. # arguments (no transcript leak).
  34. # * Slash-command rejection of unknown subcommands and unexpected
  35. # positional arguments — neither branch echoes user input back.
  36. # * redact() per-line masking: every Authorization: line is masked
  37. # independently, including mislabelled secrets (token=, secret:,
  38. # api_key:, password=).
  39. # * tools.default_enabled reduced to 39 read-only operations —
  40. # every create_* was removed because the canonical Frihet MCP
  41. # contract declares them under externalSideEffects (webhooks or
  42. # fiscal). Users opt in to mutating ops via 'hermes mcp configure
  43. # frihet'.
  44. # * Plugin classifier reads vendor/frihet-mcp-onboarding.json —
  45. # a frozen copy of Frihet-io/frihet-mcp/docs/agent-onboarding.json
  46. # — and treats the humanAuthority.externalSideEffects table as
  47. # the source of truth. Local pattern lists stay as a fallback
  48. # for tools the contract has not yet named.
  49. # * Runtime PyYAML dependency declared in pyproject.toml at >=6.0,<7
  50. # (catalog security recommendation). Closes the silent "unknown"
  51. # report from `frihet.py` mcp_server_block_present() in clean venvs
  52. # without PyYAML preinstalled (regression: 7 tests in tests/test_frihet.py).
  53. # * New tests/test_pyyaml_dependency.py asserts that yaml is importable
  54. # in the test environment, gating the runtime-dependency contract.
  55. # * New since 4f092d58 (v0.2.0 + v0.2.1):
  56. # - anomaly_list (read-only upstream, pre-checked in default_enabled)
  57. # now classifies as read; before, the hook asked for approval on
  58. # every call of it.
  59. # - The default_enabled tests now actually run: they load the
  60. # manifest and assert no mutating names, every tool classifies as
  61. # read, and the count is pinned at 39. The old versions looked for
  62. # the manifest outside the repo and returned early.
  63. # - Removed the live-hermes-validate CI job: it could never run.
  64. # CI on every push/PR = Python 3.14 tests + manifest lint, 3.11-3.13
  65. # compat smoke, and manifest-validate (schema + capability
  66. # cross-check). The full `hermes plugins validate --install-deps`
  67. # is run locally in a clean HERMES_HOME before each tag.
  68. # - Hard-coded "158 operations" dropped from docs: the canonical
  69. # count moves with every frihet-mcp release.
  70. #
  71. # Tests: 88 pass + 3 skips. hermes plugins validate --install-deps
  72. # (clean HERMES_HOME): 14/14 checks, security scan "safe".
  73. sha: 72493236b16c5e1e2b6a5ada3674781a6da180a1
  74. description: "Official Hermes Agent integration for Frihet — discoverability, setup, diagnostics, and operating guidance for the Frihet MCP. Zero duplicated tools; the canonical Frihet MCP surface stays in @frihet/mcp-server and the remote endpoint https://mcp.frihet.io/mcp. Disclosure — /frihet setup and /frihet doctor send an unauthenticated MCP initialize to mcp.frihet.io (or FRIHET_MCP_URL); /frihet doctor also makes one read-only list_invoices call through Hermes's MCP client once you grant plugins.entries.frihet.mcp_allowlist; reads ~/.hermes/config.yaml only to check that an mcp_servers.frihet block exists; the pre_tool_call hook prompts before Frihet MCP calls it classifies as irreversible or unknown, but reads and draft-first creates pass without a prompt unless the server sets trust: untrusted."
  75. maintainer: Frihet-io
  76. tier: community
  77. category: tools
  78. docs_url: https://github.com/Frihet-io/hermes-frihet#readme
  79. requires_hermes: ">=0.21.5"
  80. version: "0.2.1"
  81. # Capabilities mirror plugin.yaml exactly.
  82. # Provides zero Python tools on purpose: the canonical Frihet surface
  83. # lives in @frihet/mcp-server and is reached via the
  84. # native Hermes MCP client. The plugin adds:
  85. # - a skill (skills/frihet/SKILL.md) that encodes the operating contract
  86. # - a pre_tool_call hook that escalates irreversible Frihet operations
  87. # to the human approval gate
  88. # - a /frihet slash command for setup/status/doctor
  89. capabilities:
  90. provides_tools: []
  91. provides_hooks:
  92. - pre_tool_call
  93. provides_middleware: []
  94. # No env vars required. Credentials (Bearer API key or OAuth 2.0+PKCE)
  95. # live on the ``mcp_servers.frihet`` block in the user's config.yaml,
  96. # not on the plugin itself.
  97. requires_env: []