The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
# 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: []