| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697 |
- # 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: []
|