mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-06-03 07:21:54 +00:00
65ca3ba93b
Pure file moves, zero content changes. Every file in agent/, tools/, hermes_cli/, gateway/, acp_adapter/, cron/, and plugins/ moves into hermes_agent/. Top-level modules (run_agent.py, cli.py, etc.) move to their new homes per the restructure manifest. Git sees 100% similarity on all moves. Part of #14182, #14183
43 lines
1.3 KiB
Python
43 lines
1.3 KiB
Python
"""Shared path validation helpers for tool implementations.
|
|
|
|
Extracts the ``resolve() + relative_to()`` and ``..`` traversal check
|
|
patterns previously duplicated across skill_manager_tool, skills_tool,
|
|
skills_hub, cronjob_tools, and credential_files.
|
|
"""
|
|
|
|
import logging
|
|
from pathlib import Path
|
|
from typing import Optional
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
def validate_within_dir(path: Path, root: Path) -> Optional[str]:
|
|
"""Ensure *path* resolves to a location within *root*.
|
|
|
|
Returns an error message string if validation fails, or ``None`` if the
|
|
path is safe. Uses ``Path.resolve()`` to follow symlinks and normalize
|
|
``..`` components.
|
|
|
|
Usage::
|
|
|
|
error = validate_within_dir(user_path, allowed_root)
|
|
if error:
|
|
return json.dumps({"error": error})
|
|
"""
|
|
try:
|
|
resolved = path.resolve()
|
|
root_resolved = root.resolve()
|
|
resolved.relative_to(root_resolved)
|
|
except (ValueError, OSError) as exc:
|
|
return f"Path escapes allowed directory: {exc}"
|
|
return None
|
|
|
|
|
|
def has_traversal_component(path_str: str) -> bool:
|
|
"""Return True if *path_str* contains ``..`` traversal components.
|
|
|
|
Quick check for obvious traversal attempts before doing full resolution.
|
|
"""
|
|
parts = Path(path_str).parts
|
|
return ".." in parts
|