view-file-tool 0.1.0__py3-none-any.whl

view_file_tool/main.py

@@ -0,0 +1,113 @@
+"""
+view_file Tool
+==============
+Read the contents of a file from the local filesystem.
+
+Parameters:
+  path        - Absolute path to the file to read (required).
+  start_line  - First line to return, 1-indexed inclusive (optional).
+  end_line    - Last line to return, 1-indexed inclusive (optional).
+               Must be >= start_line. Max 800 lines per call.
+"""
+
+import logging
+import os
+from typing import Any, Dict, List, Optional
+import aiofiles
+from openchadpy.tool_base import ToolBase
+
+logger = logging.getLogger(__name__)
+
+MAX_LINES = 800
+
+
+class Tool(ToolBase):
+    name = "view_file"
+    description = (
+        "Read the contents of a file from the local filesystem. "
+        "Supports an optional line range (start_line / end_line). "
+        "Returns at most 800 lines per call. "
+        "Lines are returned 1-indexed with line numbers prepended."
+    )
+    input_schema = {
+        "type": "object",
+        "properties": {
+            "path": {
+                "type": "string",
+                "description": "Absolute path to the file to read.",
+            },
+            "start_line": {
+                "type": "integer",
+                "description": (
+                    "First line to return, 1-indexed inclusive. "
+                    "Defaults to 1 when omitted."
+                ),
+            },
+            "end_line": {
+                "type": "integer",
+                "description": (
+                    "Last line to return, 1-indexed inclusive. "
+                    "Defaults to start_line + 799 when omitted. "
+                    "Must be >= start_line."
+                ),
+            },
+        },
+        "required": ["path"],
+    }
+    allowed_callers = ["direct", "code_execution"]
+
+    async def execute(self, **kwargs) -> Dict[str, Any]:
+        path: str = kwargs.get("path", "").strip()
+        start_line: Optional[int] = kwargs.get("start_line")
+        end_line: Optional[int] = kwargs.get("end_line")
+
+        if not path:
+            return {"error": "path is required and must not be empty."}
+
+        if not os.path.exists(path):
+            return {"error": f"File not found: {path!r}"}
+
+        if not os.path.isfile(path):
+            return {"error": f"Path is not a file: {path!r}"}
+
+        try:
+            async with aiofiles.open(path, "r", encoding="utf-8", errors="replace") as f:
+                all_lines: List[str] = await f.readlines()
+        except Exception as e:
+            logger.error(f"[view_file] failed to read {path!r}: {e}")
+            return {"error": f"Failed to read file: {e}"}
+
+        total_lines = len(all_lines)
+
+        # Resolve defaults
+        sl: int = max(1, int(start_line)) if start_line is not None else 1
+        el: int = (
+            min(int(end_line), total_lines)
+            if end_line is not None
+            else min(sl + MAX_LINES - 1, total_lines)
+        )
+
+        # Validate range
+        if sl > total_lines:
+            return {
+                "error": (
+                    f"start_line {sl} exceeds total lines in file ({total_lines})."
+                )
+            }
+        if el < sl:
+            return {"error": f"end_line ({el}) must be >= start_line ({sl})."}
+
+        # Clamp window to MAX_LINES
+        if el - sl + 1 > MAX_LINES:
+            el = sl + MAX_LINES - 1
+
+        selected = all_lines[sl - 1 : el]
+        numbered = "".join(f"{sl + i}: {line}" for i, line in enumerate(selected))
+
+        return {
+            "path": path,
+            "total_lines": total_lines,
+            "start_line": sl,
+            "end_line": el,
+            "content": numbered,
+        }

view_file_tool-0.1.0.dist-info/METADATA

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: view_file_tool
+Version: 0.1.0
+Summary: Read the contents of a file from the local filesystem.
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: aiofiles>=25.1.0
+Requires-Dist: openchadpy>=0.1.23
+Requires-Dist: types-aiofiles>=25.1.0.20260518

view_file_tool-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+view_file_tool/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+view_file_tool/main.py,sha256=eNYV2JDWcJq5TbXKJ7SXDMjnQHOBh2xpjIOHsZoQviY,3616
+view_file_tool-0.1.0.dist-info/METADATA,sha256=V7zLyYiBVZ6QwF4abO8T5k-SGr3494Tic-WBoE6RsEY,299
+view_file_tool-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+view_file_tool-0.1.0.dist-info/top_level.txt,sha256=7pl6hH7CP6NUe1ENmjoOqG8RcNowhC-7XDeZ_8mLmq4,15
+view_file_tool-0.1.0.dist-info/RECORD,,

view_file_tool-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

view_file_tool-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+view_file_tool