Skip to content

The agent that grows with you

5.9 KB
Raw Blame
# Hermes plugin-catalog entry for hermes-frihet v0.2.1.
#
# Catalog: NousResearch/hermes-agent/plugin-catalog/frihet.yaml
# Per the catalog rules (plugin-catalog/README.md):
# - The maintainer of the plugin repository (Frihet-io) is the only one
#   authorised to submit the entry.
# - ``tier`` MUST be ``community`` — ``official`` in the catalog means
#   "maintained by NousResearch". We describe ourselves as the "Official
#   Hermes Agent integration for Frihet" in the description, not in the
#   catalog's tier label.
# - The SHA must be a 40-character full commit hash of a tagged, audited
#   commit of Frihet-io/hermes-frihet. Update via a new PR whenever we
#   ship a meaningful change (rule 4 of the catalog admission policy).
name: frihet
repo: https://github.com/Frihet-io/hermes-frihet
# Pinned SHA — Frihet-io/hermes-frihet @ v0.2.1 (tagged)
# (fix(classifier): treat anomaly_list as read; make manifest tests real).
#
# This SHA supersedes ``f331208`` (the older doctor that read the OAuth
# token cache), ``24a9612`` (first privacy fix), ``3c8325a`` (CI rename
# + first default_enabled), ``b9a8067`` (slash-command + redact
# per-line + first connector safety net), ``b77f5df4`` (canonical Frihet
# externalSideEffects drives classification), ``e805bf2`` (source head
# of the PyYAML branch before squash) AND ``4f092d58`` (PyYAML runtime
# dependency, PR #1). It pins all of the above AND:
#   * Hook dispatcher that passes the FULL tool name to the gate (no
#     more silent bypass of the approval gate).
#   * Doctor that derives auth evidence from ``ctx.call_mcp`` — the
#     plugin never reads ~/.hermes/mcp-tokens.
#   * Doctor that drops the list_invoices envelope from its output
#     (no invoice/customer data leaks through /frihet doctor).
#   * Setup that does NOT accept credentials as slash-command
#     arguments (no transcript leak).
#   * Slash-command rejection of unknown subcommands and unexpected
#     positional arguments — neither branch echoes user input back.
#   * redact() per-line masking: every Authorization: line is masked
#     independently, including mislabelled secrets (token=, secret:,
#     api_key:, password=).
#   * tools.default_enabled reduced to 39 read-only operations —
#     every create_* was removed because the canonical Frihet MCP
#     contract declares them under externalSideEffects (webhooks or
#     fiscal). Users opt in to mutating ops via 'hermes mcp configure
#     frihet'.
#   * Plugin classifier reads vendor/frihet-mcp-onboarding.json —
#     a frozen copy of Frihet-io/frihet-mcp/docs/agent-onboarding.json
#     — and treats the humanAuthority.externalSideEffects table as
#     the source of truth. Local pattern lists stay as a fallback
#     for tools the contract has not yet named.
#   * Runtime PyYAML dependency declared in pyproject.toml at >=6.0,<7
#     (catalog security recommendation). Closes the silent "unknown"
#     report from `frihet.py` mcp_server_block_present() in clean venvs
#     without PyYAML preinstalled (regression: 7 tests in tests/test_frihet.py).
#   * New tests/test_pyyaml_dependency.py asserts that yaml is importable
#     in the test environment, gating the runtime-dependency contract.
#   * New since 4f092d58 (v0.2.0 + v0.2.1):
#     - anomaly_list (read-only upstream, pre-checked in default_enabled)
#       now classifies as read; before, the hook asked for approval on
#       every call of it.
#     - The default_enabled tests now actually run: they load the
#       manifest and assert no mutating names, every tool classifies as
#       read, and the count is pinned at 39. The old versions looked for
#       the manifest outside the repo and returned early.
#     - Removed the live-hermes-validate CI job: it could never run.
#       CI on every push/PR = Python 3.14 tests + manifest lint, 3.11-3.13
#       compat smoke, and manifest-validate (schema + capability
#       cross-check). The full `hermes plugins validate --install-deps`
#       is run locally in a clean HERMES_HOME before each tag.
#     - Hard-coded "158 operations" dropped from docs: the canonical
#       count moves with every frihet-mcp release.
#
# Tests: 88 pass + 3 skips. hermes plugins validate --install-deps
# (clean HERMES_HOME): 14/14 checks, security scan "safe".
sha: 72493236b16c5e1e2b6a5ada3674781a6da180a1
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."
maintainer: Frihet-io
tier: community
category: tools
docs_url: https://github.com/Frihet-io/hermes-frihet#readme
requires_hermes: ">=0.21.5"
version: "0.2.1"
# Capabilities mirror plugin.yaml exactly.
# Provides zero Python tools on purpose: the canonical Frihet surface
# lives in @frihet/mcp-server and is reached via the
# native Hermes MCP client. The plugin adds:
#   - a skill (skills/frihet/SKILL.md) that encodes the operating contract
#   - a pre_tool_call hook that escalates irreversible Frihet operations
#     to the human approval gate
#   - a /frihet slash command for setup/status/doctor
capabilities:
  provides_tools: []
  provides_hooks:
    - pre_tool_call
  provides_middleware: []
  # No env vars required. Credentials (Bearer API key or OAuth 2.0+PKCE)
  # live on the ``mcp_servers.frihet`` block in the user's config.yaml,
  # not on the plugin itself.
  requires_env: []