{
  "sources": [
    {
      "url": "https://gist.githubusercontent.com/gtmcknight/594c47336546c8763e641b46cf9af4ec/raw/field.json",
      "quote": "\"refs\":[{\"name\":\"done-bell\",\"repo\":\"https://github.com/aydnOktay/hermes-done-bell-\",\"sha\":\"3fa519a291d91b0e6c44bd42762190363ce80c39\",\"subdir\":\"\"},{\"name\":\"homeassistant\",\"repo\":\"https://github.com/NousResearch/hermes-official-plugins\",\"sha\":\"e7a218f26db88426ab3e7376f0e000b6e356f5e7\",\"subdir\":\"homeassistant\"}],\"plugins\":[{\"pr\":149124,\"name\":\"neuralwatt\",\"repo\":\"https://github.com/0xGingi/neuralwatt-hermes\",\"sha\":\"123651dd0456ad235953652eb1e9d527f2"
    },
    {
      "url": "https://gist.githubusercontent.com/gtmcknight/594c47336546c8763e641b46cf9af4ec/raw/RUN.md",
      "quote": "# Run a plugin inside real Hermes\n\nFor seats in rounds 3 and 4. Everything lives under `test/scratch/`. Nothing here needs a model, a key or an account: the model is Nous's own scripted test stand-in, `tests/fakes/fake_llm_provider.py` in the Hermes source, which answers with the tool calls you plan and records everything Hermes sends.\n\n## 1. Hermes, once\n\n    git clone --depth 1 https://github.com/NousResearch/herme"
    },
    {
      "url": "https://raw.githubusercontent.com/NousResearch/hermes-agent/34ce08bb7728c359450fa599b9910deb0d083b1a/plugin-catalog/README.md",
      "quote": "11. **Credentials come through Hermes, never from files.** A plugin gets\n   secrets only through Hermes's routes. Its declared `requires_env` and\n   `config_schema` secrets are read with `agent.secret_scope.get_secret(NAME)`,\n   which honours the active profile (a bare `os.environ` read can pick up another\n   profile's key under multiplexing). A subscription sign-in (Codex / ChatGPT\n   today) is used only through `credentialed_provider_request` with\n   `requires_auth`, so Her"
    },
    {
      "url": "https://raw.githubusercontent.com/codeybot-labs/signaldesk/1fb9efc3d6895f5852d5f04b9a6e09477e1f559e/drafts.py",
      "quote": "result = fn(prompt)\n                if isinstance(result, dict):\n                    result = result.get(\"text\") or result.get(\"content\") or result.get(\"completion\")\n                return str(result) if result else None\n            except TypeError:\n                try:\n                    result = fn(messages=[{\"role\": \"user\", \"content\": prompt}])\n                    if isinstance(result, dict):\n                        result = result.get(\"text\") or result.get(\"content\")\n  "
    },
    {
      "url": "https://raw.githubusercontent.com/aydnOktay/hermes-done-bell-/3fa519a291d91b0e6c44bd42762190363ce80c39/README.md",
      "quote": "# done-bell\n\nHermes plugin: **ring when a turn finishes** so you can leave the window.\n\nOS notification (when away), optional chime, status chip (`busy` / `done` /\n`needs you`). No API keys. Does not send chat, write code, or touch user files.\n\nLives under `plugins/done-bell/` so it stays separate from debug-desk.\n\nRepo: https://github.com/aydnOkta"
    },
    {
      "url": "https://raw.githubusercontent.com/aydnOktay/hermes-done-bell-/3fa519a291d91b0e6c44bd42762190363ce80c39/desktop/plugin.js",
      "quote": "function BellWatcher({ ctx }) {\n  const query = useBell(ctx)\n  const busyMap = useValue(host.state.busyBySession) || {}\n  const prevMap = useRef(null)\n  const prevNeeds = useRef(false)\n  const settings = settingsOf(query.data)\n  const needsYou = Boolean(query.data && query.data.needs_you)\n\n  useEffect(() => {\n    const next = busyMap && typeof busyMap === 'object' ? busyMap : {}\n    const prev = prevMap.current\n    prevMap.current = next\n    if (!prev) return\n    const ids = new Set([."
    },
    {
      "url": "https://raw.githubusercontent.com/aydnOktay/hermes-done-bell-/3fa519a291d91b0e6c44bd42762190363ce80c39/bell_store.py",
      "quote": "def ring_cli(title: str, body: str, *, platform_name: str = \"\") -> None:\n    if os.environ.get(\"DONE_BELL_NO_OS\") == \"1\":\n        return\n    if not should_os_notify_cli(platform_name):\n        return\n    settings = get_settings()\n    if settings.get(\"sound\"):\n        _beep()\n    threading.Thread(target=_os_toast, args=(title, body), daemon=True).start()\n\n\ndef _beep() -> None:\n    try:\n        if sys.platform == \"win32\":\n            import winsound\n\n       "
    },
    {
      "url": "https://raw.githubusercontent.com/NousResearch/hermes-official-plugins/e7a218f26db88426ab3e7376f0e000b6e356f5e7/homeassistant/README.md",
      "quote": "1. **Gateway platform `homeassistant`**: subscribes to Home Assistant's WebSocket event bus and\n   forwards `state_changed` events to the agent, with domain/entity filters and per-entity cooldowns.\n   The agent's replies show up as Home Assistant persistent notifications titled \"Hermes Agent\".\n   Cron jobs can deliver to `deliver=homeassistant[:target]` through the target's own notify service\n   (`notify.mobile_app_my_phone` for `target=mobile_app_my_phone`), without a running gateway."
    },
    {
      "url": "https://raw.githubusercontent.com/NousResearch/hermes-official-plugins/e7a218f26db88426ab3e7376f0e000b6e356f5e7/homeassistant/tools.py",
      "quote": "def register_tools(ctx) -> None:\n    \"\"\"Register the four Home Assistant tools in the ``homeassistant`` toolset via the plugin API.\"\"\"\n    for schema, handler in TOOLS:\n        ctx.register_tool(\n            name=schema[\"name\"], toolset=TOOLSET, schema=schema, handler=handler,\n            check_fn=_check_ha_available, emoji=\"\ud83c\udfe0\")\n"
    },
    {
      "url": "https://raw.githubusercontent.com/xMannixx/Agent-Security-Guard/b1b923e6733f2a3dd7f0a79318d452ad395d8340/plugin/README.md",
      "quote": "- **Outside content is marked as data.** Results of web, search and browser\n  tools reach the model inside an `UNTRUSTED CONTENT - DATA ONLY` block\n  (`transform_tool_result`).\n- **Every planned tool call is checked** before it runs (`pre_tool_call`).\n  Reading, searching and summarising stay free. After outside content has\n  entered a turn, a shell command, file write, install, config change or\n  external send goes to Hermes's own approval prompt.\n- **Hard rules that hold in every tur"
    },
    {
      "url": "https://raw.githubusercontent.com/xMannixx/Agent-Security-Guard/b1b923e6733f2a3dd7f0a79318d452ad395d8340/plugin/agent_security_guard/host_tools.py",
      "quote": "UNTRUSTED_CONTENT_TOOLS = (\n    \"web_fetch\", \"web_extract\", \"web_search\", \"webfetch\", \"websearch\",\n    \"x_search\", \"http_get\", \"https_get\", \"fetch_url\", \"read_url\", \"scrape\",\n    \"browser\", \"browser_*\",\n)\n\nHOST_TOOL_TIER: Dict[str, ActionTier] = {\n    **{name: ActionTier.EXECUTION for name in _EXECUTION},\n    **{name: ActionTier.LOCAL_WRI"
    },
    {
      "url": "https://raw.githubusercontent.com/xMannixx/Agent-Security-Guard/b1b923e6733f2a3dd7f0a79318d452ad395d8340/plugin/__init__.py",
      "quote": "def register(ctx) -> None:\n    \"\"\"Entry point Hermes calls to wire the hooks.\"\"\"\n    ctx.register_hook(\"pre_llm_call\", wrap_untrusted_context)\n    ctx.register_hook(\"pre_tool_call\", guard_tool_call)\n    try:\n        ctx.register_hook(\"transform_tool_result\", wrap_tool_result)\n    except Exception as exc:  # a host without this hook must keep the other two\n        logger.warning(\"transform_tool_result hook not registered: %s\", exc)\n\n\n# Fallback copy of the package's "
    },
    {
      "url": "https://raw.githubusercontent.com/nativ3ai/hermes-camel-guard-plugin/4cbfca3a5f1d46f5d152280cccc496d0df14d097/plugin/README.md",
      "quote": "## Boundaries\n\nThis is a **coarse capability guard**, not the full CaMeL interpreter and not a\nsandbox. Authorization applies to an effect category, not an exact command,\nfile path, recipient or argument. It does not prevent answer contamination or\nexfiltration through an already-authorized capability. It trusts the host to\nprovide the actual current user request separately from imported content.\nUntrusted attachments concatenated into that trusted field are outside this\nboundary. Moni"
    },
    {
      "url": "https://raw.githubusercontent.com/nativ3ai/hermes-camel-guard-plugin/4cbfca3a5f1d46f5d152280cccc496d0df14d097/plugin/policy.py",
      "quote": "CLASSIFIER_INSTRUCTIONS = \"\"\"Classify trusted operator intent for a tool-policy guard.\n\nYou receive exactly one trusted user message and no tool output, retrieved\ncontent, memory, web page, file contents, or model-generated instructions.\nOnly authorize a capability when the trusted user explicitly requests it or\nwhen it is unavoidably required to complete that request. Ambiguity means the\ncapability is not authorized. Put a capability in denied_capabilities only\nwhen the trus"
    },
    {
      "url": "https://raw.githubusercontent.com/nativ3ai/hermes-camel-guard-plugin/4cbfca3a5f1d46f5d152280cccc496d0df14d097/plugin/__init__.py",
      "quote": "def _classify(self, state: TurnState) -> CapabilityPlan:\n        with state.classification_lock:\n            if state.plan is not None:\n                return state.plan\n            try:\n                result = self._ctx.llm.complete_structured(\n                    instructions=CLASSIFIER_INSTRUCTIONS,\n                    input=[\n                        {\n                            \"type\": \"text\",\n                            \"text\": json.dumps(\n                                {\"trust"
    },
    {
      "url": "https://raw.githubusercontent.com/codeybot-labs/signaldesk/1fb9efc3d6895f5852d5f04b9a6e09477e1f559e/README.md",
      "quote": "SignalDesk is a plugin, not a prompt:\n\n- **Tools** for ICP, scan, **map scan**, list, draft, approve, mark, follow-ups, CSV, sources, a local `.eml`, and the HTML board\n- A **`pre_tool_call` hook** that blocks send-like tools unless the lead is approved *and* the session is interactive\n- A **slash command** (`/signaldesk`) and a weekday **catch-up blueprint** that only scans and summarizes\n- A **SQLite pipeline** with domain dedup and transparent scores\n- An **interactive HTML board** "
    },
    {
      "url": "https://raw.githubusercontent.com/codeybot-labs/signaldesk/1fb9efc3d6895f5852d5f04b9a6e09477e1f559e/toolhandlers.py",
      "quote": "def signaldesk_approve(args: dict, **kwargs) -> str:\n    try:\n        lead_id = (args or {}).get(\"lead_id\") or \"\"\n        lead = get_lead(lead_id)\n        if not lead:\n            return _err(\"Lead not found\", lead_id=lead_id)\n        if not lead.draft_body:\n            return _err(\"Draft this lead before approving it.\", lead_id=lead_id)\n        lead.stage = \"approved\"\n        lead.approved_at = _now()\n        save_lead(lead)\n        return _ok(ok=True, message=\"Approved. Nothing was s"
    },
    {
      "url": "https://raw.githubusercontent.com/codeybot-labs/signaldesk/1fb9efc3d6895f5852d5f04b9a6e09477e1f559e/hooks.py",
      "quote": "def _approved_lead_for(recipient: str, lead_id: str = \"\") -> bool:\n    if lead_id:\n        lead = get_lead(lead_id)\n        if lead and lead.stage in SENDABLE_STAGES:\n            return True\n    if not recipient:\n        return False\n    emails = extract_emails(recipient) or ([recipient] if \"@\" in recipient else [])\n    for email in emails:\n        lead = find_by_contact(email)\n        if lead and lead.stage in SENDABLE_STAGES:\n            return True\n        domain = domain_from_email"
    },
    {
      "url": "https://raw.githubusercontent.com/bhaskarduvvuri/hermes-ask-ledger/1986b146f7fbddf5437744ec9d72bf8caa88cb8a/README.md",
      "quote": "**Limit.** Hermes tells the plugin a message's chat when the message arrives, but\nnot which arrival a later model turn belongs to. So the plugin treats a turn as\nprivate only when it carries a direct-message arrival that matches its session,\nand counts anything uncertain as shared: a turn with no arrival of its own, an\narrival from a different chat than the session's, or anyone active in two chats\nwithin 10 minutes. One case is covered only inside that window: the very first\nturn of a "
    },
    {
      "url": "https://raw.githubusercontent.com/bhaskarduvvuri/hermes-ask-ledger/1986b146f7fbddf5437744ec9d72bf8caa88cb8a/plugin/ledger.py",
      "quote": "class Ledger:\n    def __init__(self, directory, on_change: Optional[Callable[[\"Ledger\"], None]] = None):\n        self.dir = Path(directory)\n        self.path = self.dir / \"asks.jsonl\"\n        self.on_change = on_change\n        self.skipped = 0\n\n    # Reading -------------------------------------------------------------\n    def _fold(self) -> Dict[str, Ask]:\n        asks: Dict[str, Ask] = {}\n        self.skipped = 0\n        try:\n            with open(self.path, \"r\", encoding=\"utf-8\", er"
    }
  ]
}