#  Copyright 2026 zhaoxi826
#
#  Licensed under the Apache License, Version 2.0 (the "License");
#  you may not use this file except in compliance with the License.
#  You may obtain a copy of the License at
#
#       http://www.apache.org/licenses/LICENSE-2.0
#
#  Unless required by applicable law or agreed to in writing, software
#  distributed under the License is distributed on an "AS IS" BASIS,
#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
#  See the License for the specific language governing permissions and
#  limitations under the License.

from pydantic_ai import RunContext
from kilostar.plugin.tool_plugin.base_tool import BaseToolData
import os


class FileReaderData(BaseToolData):
    """``file_reader`` 工具的元数据：声明工具的名称、描述与是否系统级别。"""

    is_system: bool = True
    name: str = "file_reader"
    description: str = "读取本地文件的内容"


def file_reader(ctx: RunContext, filepath: str) -> str:
    """读取本地文件内容的工具。

    Args:
        filepath: 目标文件的绝对路径或相对路径。

    Returns:
        如果文件存在并可读，返回文件内容；否则返回错误信息。
    """
    if not os.path.exists(filepath):
        return f"Error: 文件 {filepath} 不存在。"
    if not os.path.isfile(filepath):
        return f"Error: {filepath} 不是一个文件。"

    try:
        with open(filepath, "r", encoding="utf-8") as f:
            content = f.read()
        return content
    except Exception as e:
        return f"Error: 读取文件失败，原因：{str(e)}"