mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-11-18 11:56:11 +03:00
94f991f473
rm/unlink/shred/truncate/mv of HERMES_HOME itself or a protected store (state.db, sessions/, vault/, mcp-tokens/, ...), and cp/install/rsync/dd/tee/ redirection onto a store, were auto-approved: the patterns only special-cased config.yaml and .env, and the resolved-home fold skipped the bare home word. sqlite3 write verbs on a store prompt too, keyed on the verb rather than a missing WHERE (`where 1=1` wipes the same rows). The protected-store list moves to hermes_cli.home_data_layout so the file tools' write deny and the shell gate share one source of truth. Prompt-grade (DANGEROUS), not hardline: backup/doctor flows legitimately touch these paths. Hardening (SECURITY.md §3.2), not a boundary. Fixes #109367
52 lines
3.2 KiB
Python
52 lines
3.2 KiB
Python
"""Machine-specific state excluded from portable home transfers."""
|
|
from __future__ import annotations
|
|
|
|
|
|
# Dependency generations, downloaded tools, and partial transfers belong to this machine.
|
|
PM_RUNTIME_ROOT_DIRS = frozenset({"installs", "tools", "cache"})
|
|
|
|
# Bitwarden / 1Password secret-value caches and the Photon sidecar auth token, as POSIX paths relative to
|
|
# a home. They sit at its top, where a sandbox can hide a file by path (a writable folder above a hidden
|
|
# file can be renamed). Hermes regenerates them on use, so backups leave them out.
|
|
SECRET_CACHE_FILES = ("bws_cache.json", "bws_cache.enc.json", "op_cache.json", "photon-sidecar.json")
|
|
# Where earlier releases kept the same files, in folders the agent can write. Hermes deletes a copy
|
|
# there unread on first use.
|
|
LEGACY_SECRET_CACHE_PATHS = (
|
|
"cache/bws_cache.json", "cache/bws_cache.enc.json", "cache/op_cache.json", "runtime/photon-sidecar.json",
|
|
)
|
|
# Credential stores for every guard that lists them.
|
|
SECRET_CACHE_STORES = (*SECRET_CACHE_FILES, *LEGACY_SECRET_CACHE_PATHS)
|
|
# The home's dotenv files: provider secrets, and the 1Password service-account token that
|
|
# load_hermes_dotenv() bootstraps from (it resolves every op:// reference the account can read).
|
|
HOME_ENV_FILES = (".env", ".op.env")
|
|
# Credential trees under a home, as POSIX paths relative to it. Stores resolved by get_hermes_dir()
|
|
# are listed at both the current platforms/... location and the legacy one.
|
|
CREDENTIAL_STORE_DIRS = (
|
|
"mcp-tokens", "vault", "pairing", "platforms/pairing",
|
|
"whatsapp/session", "platforms/whatsapp/session", "matrix/store", "platforms/matrix/store",
|
|
)
|
|
# Home subpaths the agent must not rewrite with generic file tools or destroy from the shell without a
|
|
# prompt. Session transcripts (state.db, sessions/) are application-owned state whose rewrite can
|
|
# falsify history and break resume/compression; CREDENTIAL_STORE_DIRS (vault/ holds key + ciphertext
|
|
# side by side), browser-profile/ (copied cookies / Login Data) and webapp/ (the Webapp's browser
|
|
# credential and its grants to native apps) hold credential material. skills/ and memories/ are
|
|
# deliberately NOT here: they are user-editable content, and write approval for them (memory/skills
|
|
# ``write_approval``) is enforced by the memory/skill subsystem tools, not the generic write path
|
|
# (#60440 tracks closing that gap for write_file/patch). Control files (auth.json,
|
|
# config.yaml, webhook_subscriptions.json) are deliberately NOT here (#45947): read-denied, but the
|
|
# user may ask to edit them.
|
|
HERMES_PROTECTED_SUBPATHS = (
|
|
"state.db", "sessions", "browser-profile", "webapp", *CREDENTIAL_STORE_DIRS)
|
|
|
|
# The WhatsApp bridge log and its rotated generation, as path parts relative to a home: troubleshooting
|
|
# output that records chat ids and the Signal library's console lines, never needed for a restore (#149860).
|
|
BRIDGE_LOG_PARTS = frozenset(
|
|
(*parent, name) for parent in (("platforms", "whatsapp"), ("whatsapp",)) for name in ("bridge.log", "bridge.log.1"))
|
|
|
|
|
|
def profile_root_entry(parts: tuple[str, ...]) -> str | None:
|
|
"""Locate a home-root entry without excluding same-named skill/plugin data."""
|
|
if len(parts) >= 3 and parts[0] == "profiles":
|
|
return parts[2]
|
|
return parts[0] if parts else None
|