zeroclaw 0.1.7

Zero overhead. Zero compromise. 100% Rust. The fastest, smallest AI assistant.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

"""
File read/write tools.
"""

import os

from langchain_core.tools import tool


MAX_FILE_SIZE = 100_000


@tool
def file_read(path: str) -> str:
    """
    Read the contents of a file at the given path.

    Args:
        path: The file path to read (absolute or relative)

    Returns:
        The file contents, or an error message
    """
    try:
        with open(path, "r", encoding="utf-8", errors="replace") as f:
            content = f.read()
            if len(content) > MAX_FILE_SIZE:
                return content[:MAX_FILE_SIZE] + f"\n... (truncated, {len(content)} bytes total)"
            return content
    except FileNotFoundError:
        return f"Error: File not found: {path}"
    except PermissionError:
        return f"Error: Permission denied: {path}"
    except Exception as e:
        return f"Error: {e}"


@tool
def file_write(path: str, content: str) -> str:
    """
    Write content to a file, creating directories if needed.

    Args:
        path: The file path to write to
        content: The content to write

    Returns:
        Success message or error
    """
    try:
        parent = os.path.dirname(path)
        if parent:
            os.makedirs(parent, exist_ok=True)
        with open(path, "w", encoding="utf-8") as f:
            f.write(content)
        return f"Successfully wrote {len(content)} bytes to {path}"
    except PermissionError:
        return f"Error: Permission denied: {path}"
    except Exception as e:
        return f"Error: {e}"