<tools>
    <tool name="read_file">
        <description>Read the contents of a file from the filesystem.
            Use this tool when you need to examine existing files, review code, read configuration files, or access any text-based file content.</description>
        <details>This tool reads the entire contents of a text file and returns it as a string.
            Important notes:
            - The file must exist and be readable
            - Binary files cannot be read with this tool
            - Large files will return their full content
            - Use relative or absolute file paths</details>
        <parameters>
            <parameter name="file_path" type="string" required="true">
                <description>Path to the file to read. Can be relative to current working directory or absolute path.</description>
            </parameter>
        </parameters>
        <returns type="Dict[str, Any]">
            <description>Response containing:
                - success: Whether the file was read successfully
                - message: Status message with file size info or error details
                - data: The complete file contents as a string (or None on error)</description>
        </returns>
        <examples>
            # Read a configuration file
            <function=read_file>
            <parameter=file_path>config/settings.json</parameter>
    </function>

    # Read a Python source file
    <function=read_file>
    <parameter=file_path>/home/user/project/main.py</parameter>
        </function>

        # Read a log file
<function=read_file>
<parameter=file_path>logs/app.log</parameter>
        </function>
        </examples>
        </tool>
        </tools>