Personal AI, On Personal Devices
Python
"""Default directory allow-list for the filesystem tools."""
from __future__ import annotations
import os
from typing import Any, List, Optional
def validate_allowed_dirs(allowed_dirs: object) -> List[str]:
"""Validate an active policy without interpreting None as an ambient default."""
if not isinstance(allowed_dirs, (list, tuple)) or any(
not isinstance(directory, (str, os.PathLike))
or not isinstance(os.fspath(directory), str)
or not os.fspath(directory).strip()
for directory in allowed_dirs
):
raise ValueError("security.allowed_dirs must be a list of non-empty paths")
return [os.fspath(directory) for directory in allowed_dirs]
def file_tool_kwargs(name: str, config: Any = None) -> dict[str, List[str]]:
"""Bind native file tools to the caller's config when one was supplied."""
if name not in {"file_read", "file_write"} or config is None:
return {}
return {"allowed_dirs": validate_allowed_dirs(config.security.allowed_dirs)}
def resolve_allowed_dirs(allowed_dirs: Optional[List[str]]) -> List[str]:
"""Return *allowed_dirs*, or ``[security] allowed_dirs`` from the config.
An explicit empty list keeps the historical unrestricted behaviour. Invalid
or unreadable configuration must never silently remove a restriction.
"""
if allowed_dirs is None:
from openjarvis.core.config import load_config
allowed_dirs = load_config().security.allowed_dirs
return validate_allowed_dirs(allowed_dirs)