acontext 0.1.4__tar.gz → 0.1.6__tar.gz

{acontext-0.1.4 → acontext-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: acontext
-Version: 0.1.4
+Version: 0.1.6
 Summary: Python SDK for the Acontext API
 Keywords: acontext,sdk,client,api
 Requires-Dist: httpx>=0.28.1

{acontext-0.1.4 → acontext-0.1.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "acontext"
-version = "0.1.4"
+version = "0.1.6"
 description = "Python SDK for the Acontext API"
 readme = "README.md"
 requires-python = ">=3.10"

{acontext-0.1.4 → acontext-0.1.6}/src/acontext/agent/prompts.py

@@ -92,5 +92,8 @@ Container environment:
 - Standard Unix utilities available (grep, sed, awk, etc.)
 - Archive tools: tar, unzip, zip
 - Additional tools: ripgrep, fd, sqlite3, jq, imagemagick
-- Do not try to install new packages and libraries with pip as there is no internet access
+- You can install new packages with pip if needed (internet access is available)
+
+
+Remember to always export your artifacts at the end of your task so that the user can view them.
 """

{acontext-0.1.4 → acontext-0.1.6}/src/acontext/agent/sandbox.py

@@ -10,6 +10,15 @@ from .prompts import SANDBOX_TEXT_EDITOR_REMINDER, SANDBOX_BASH_REMINDER, SKILL_
 from ..client import AcontextClient
 from ..async_client import AcontextAsyncClient
 
+MAX_OUTPUT_CHARS = 20000
+
+
+def truncate_output(text: str, max_chars: int = MAX_OUTPUT_CHARS) -> str:
+    """Truncate text to max_chars, appending a truncation flag if needed."""
+    if len(text) > max_chars:
+        return text[:max_chars] + "...[truncated]"
+    return text
+
 
 class MountedSkill(TypedDict):
     name: str
@@ -191,8 +200,8 @@ class BashTool(BaseTool):
 
         return json.dumps(
             {
-                "stdout": result.stdout,
-                "stderr": result.stderr,
+                "stdout": truncate_output(result.stdout),
+                "stderr": truncate_output(result.stderr),
                 "exit_code": result.exit_code,
             }
         )
@@ -213,8 +222,8 @@ class BashTool(BaseTool):
 
         return json.dumps(
             {
-                "stdout": result.stdout,
-                "stderr": result.stderr,
+                "stdout": truncate_output(result.stdout),
+                "stderr": truncate_output(result.stderr),
                 "exit_code": result.exit_code,
             }
         )
@@ -248,27 +257,34 @@ class TextEditorTool(BaseTool):
             "command": {
                 "type": "string",
                 "enum": ["view", "create", "str_replace"],
-                "description": "The operation to perform: 'view', 'create', or 'str_replace'",
+                "description": (
+                    "Perform only text operations: 'view', 'create', or 'str_replace'. "
+                    "Required parameters per command: "
+                    "'view' requires path (view_range is optional); "
+                    "'create' requires path and file_text; "
+                    "'str_replace' requires path, old_str, and new_str."
+                ),
             },
             "path": {
                 "type": "string",
-                "description": "The file path in the sandbox (e.g., '/workspace/script.py')",
+                "description": "Required for all commands. The file path in the sandbox (e.g., '/workspace/script.py')",
             },
             "file_text": {
                 "type": ["string", "null"],
-                "description": "For 'create' command: the content to write to the file",
+                "description": "Required for 'create' command. The content to write to the file.",
             },
             "old_str": {
                 "type": ["string", "null"],
-                "description": "For 'str_replace' command: the exact string to find and replace",
+                "description": "Required for 'str_replace' command. The exact string to find and replace.",
             },
             "new_str": {
                 "type": ["string", "null"],
-                "description": "For 'str_replace' command: the string to replace old_str with",
+                "description": "Required for 'str_replace' command. The string to replace old_str with.",
             },
             "view_range": {
                 "type": ["array", "null"],
-                "description": "For 'view' command: optional [start_line, end_line] to view specific lines",
+                "items": {"type": "integer"},
+                "description": "Optional for 'view' command. An array [start_line, end_line] to view specific lines. If not provided, shows the first 200 lines.",
             },
         }
 

acontext-0.1.6/src/acontext/agent/text_editor.py

@@ -0,0 +1,420 @@
+"""Text editor file operations for sandbox environments."""
+
+import base64
+import posixpath
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .sandbox import AsyncSandboxContext, SandboxContext
+
+MAX_CONTENT_CHARS = 20000
+
+
+def truncate_content(text: str, max_chars: int = MAX_CONTENT_CHARS) -> str:
+    """Truncate text to max_chars, appending a truncation flag if needed."""
+    if len(text) > max_chars:
+        return text[:max_chars] + "...[truncated]"
+    return text
+
+
+def escape_for_shell(s: str) -> str:
+    """Escape a string for safe use in shell commands."""
+    # Use single quotes and escape any single quotes in the string
+    return "'" + s.replace("'", "'\"'\"'") + "'"
+
+
+# ============================================================================
+# Sync Operations
+# ============================================================================
+
+
+def view_file(
+    ctx: "SandboxContext", path: str, view_range: list | None, timeout: float | None
+) -> dict:
+    """View file content with line numbers.
+
+    Args:
+        ctx: The sandbox context.
+        path: The file path to view.
+        view_range: Optional [start_line, end_line] to view specific lines.
+        timeout: Optional timeout for command execution.
+
+    Returns:
+        A dict with file content and metadata, or error information.
+    """
+    escaped_path = escape_for_shell(path)
+
+    # Build combined command: check existence, get total lines, and view content in one exec
+    if view_range and len(view_range) == 2:
+        start_line, end_line = view_range
+        view_cmd = (
+            f"sed -n '{start_line},{end_line}p' {escaped_path} | nl -ba -v {start_line}"
+        )
+    else:
+        max_lines = 200
+        view_cmd = f"head -n {max_lines} {escaped_path} | nl -ba"
+        start_line = 1
+
+    # Single combined command: outputs "TOTAL:<n>" on first line, then file content
+    cmd = (
+        f"if [ ! -f {escaped_path} ]; then echo 'FILE_NOT_FOUND'; exit 1; fi; "
+        f'echo "TOTAL:$(wc -l < {escaped_path})"; {view_cmd}'
+    )
+
+    result = ctx.client.sandboxes.exec_command(
+        sandbox_id=ctx.sandbox_id,
+        command=cmd,
+        timeout=timeout,
+    )
+
+    if result.exit_code != 0 or "FILE_NOT_FOUND" in result.stdout:
+        return {
+            "error": f"File not found: {path}",
+            "stderr": result.stderr,
+        }
+
+    # Parse output: first line is "TOTAL:<n>", rest is content
+    lines = result.stdout.split("\n", 1)
+    total_lines = 0
+    content = ""
+
+    if lines and lines[0].startswith("TOTAL:"):
+        total_str = lines[0][6:].strip()
+        total_lines = int(total_str) if total_str.isdigit() else 0
+        content = lines[1] if len(lines) > 1 else ""
+
+    content_lines = content.rstrip("\n").split("\n") if content.strip() else []
+    num_lines = len(content_lines)
+
+    return {
+        "file_type": "text",
+        "content": truncate_content(content),
+        "numLines": num_lines,
+        "startLine": start_line if view_range else 1,
+        "totalLines": total_lines + 1,  # wc -l doesn't count last line without newline
+    }
+
+
+def create_file(
+    ctx: "SandboxContext", path: str, file_text: str, timeout: float | None
+) -> dict:
+    """Create a new file with content.
+
+    Args:
+        ctx: The sandbox context.
+        path: The file path to create.
+        file_text: The content to write to the file.
+        timeout: Optional timeout for command execution.
+
+    Returns:
+        A dict with creation status or error information.
+    """
+    escaped_path = escape_for_shell(path)
+    encoded_content = base64.b64encode(file_text.encode()).decode()
+
+    # Get directory path for mkdir
+    dir_path = posixpath.dirname(path)
+    mkdir_part = f"mkdir -p {escape_for_shell(dir_path)} && " if dir_path else ""
+
+    # Single combined command: check existence, create dir, write file
+    cmd = (
+        f"is_update=$(test -f {escaped_path} && echo 1 || echo 0); "
+        f"{mkdir_part}"
+        f"echo {escape_for_shell(encoded_content)} | base64 -d > {escaped_path} && "
+        f'echo "STATUS:$is_update"'
+    )
+
+    result = ctx.client.sandboxes.exec_command(
+        sandbox_id=ctx.sandbox_id,
+        command=cmd,
+        timeout=timeout,
+    )
+
+    if result.exit_code != 0 or "STATUS:" not in result.stdout:
+        return {
+            "error": f"Failed to create file: {path}",
+            "stderr": result.stderr,
+        }
+
+    is_update = "STATUS:1" in result.stdout
+
+    return {
+        "is_file_update": is_update,
+        "message": f"File {'updated' if is_update else 'created'}: {path}",
+    }
+
+
+def str_replace(
+    ctx: "SandboxContext", path: str, old_str: str, new_str: str, timeout: float | None
+) -> dict:
+    """Replace a string in a file.
+
+    Uses a Python script on the sandbox to avoid transferring the entire file.
+    Only the base64-encoded old_str and new_str are sent.
+
+    Args:
+        ctx: The sandbox context.
+        path: The file path to modify.
+        old_str: The exact string to find and replace.
+        new_str: The string to replace old_str with.
+        timeout: Optional timeout for command execution.
+
+    Returns:
+        A dict with success message or error details.
+    """
+    old_b64 = base64.b64encode(old_str.encode()).decode()
+    new_b64 = base64.b64encode(new_str.encode()).decode()
+
+    # Write Python script to a temp file and execute it
+    # This avoids shell escaping issues with inline python -c
+    py_script = f'''import sys, base64, os
+old = base64.b64decode("{old_b64}").decode()
+new = base64.b64decode("{new_b64}").decode()
+path = "{path}"
+if not os.path.exists(path):
+    print("FILE_NOT_FOUND")
+    sys.exit(1)
+with open(path, "r") as f:
+    content = f.read()
+count = content.count(old)
+if count == 0:
+    print("NOT_FOUND")
+    sys.exit(0)
+if count > 1:
+    print(f"MULTIPLE:{{count}}")
+    sys.exit(0)
+with open(path, "w") as f:
+    f.write(content.replace(old, new, 1))
+print("SUCCESS")
+'''
+    # Base64 encode the script itself to avoid any escaping issues
+    script_b64 = base64.b64encode(py_script.encode()).decode()
+    cmd = f"echo {escape_for_shell(script_b64)} | base64 -d | python3"
+
+    result = ctx.client.sandboxes.exec_command(
+        sandbox_id=ctx.sandbox_id,
+        command=cmd,
+        timeout=timeout,
+    )
+
+    output = result.stdout.strip()
+
+    if result.exit_code != 0 or output == "FILE_NOT_FOUND":
+        return {"error": f"File not found: {path}", "stderr": result.stderr}
+
+    if output == "NOT_FOUND":
+        return {"error": f"String not found in file: {old_str[:50]}..."}
+
+    if output.startswith("MULTIPLE:"):
+        count = output.split(":")[1]
+        return {
+            "error": f"Multiple occurrences ({count}) of the string found. "
+            "Please provide more context to make the match unique."
+        }
+
+    if output == "SUCCESS":
+        return {"msg": "Successfully replaced text at exactly one location."}
+
+    return {"error": f"Unexpected response: {output}", "stderr": result.stderr}
+
+
+# ============================================================================
+# Async Operations
+# ============================================================================
+
+
+async def async_view_file(
+    ctx: "AsyncSandboxContext",
+    path: str,
+    view_range: list | None,
+    timeout: float | None,
+) -> dict:
+    """View file content with line numbers (async).
+
+    Args:
+        ctx: The async sandbox context.
+        path: The file path to view.
+        view_range: Optional [start_line, end_line] to view specific lines.
+        timeout: Optional timeout for command execution.
+
+    Returns:
+        A dict with file content and metadata, or error information.
+    """
+    escaped_path = escape_for_shell(path)
+
+    # Build combined command: check existence, get total lines, and view content in one exec
+    if view_range and len(view_range) == 2:
+        start_line, end_line = view_range
+        view_cmd = (
+            f"sed -n '{start_line},{end_line}p' {escaped_path} | nl -ba -v {start_line}"
+        )
+    else:
+        max_lines = 200
+        view_cmd = f"head -n {max_lines} {escaped_path} | nl -ba"
+        start_line = 1
+
+    # Single combined command: outputs "TOTAL:<n>" on first line, then file content
+    cmd = (
+        f"if [ ! -f {escaped_path} ]; then echo 'FILE_NOT_FOUND'; exit 1; fi; "
+        f'echo "TOTAL:$(wc -l < {escaped_path})"; {view_cmd}'
+    )
+
+    result = await ctx.client.sandboxes.exec_command(
+        sandbox_id=ctx.sandbox_id,
+        command=cmd,
+        timeout=timeout,
+    )
+
+    if result.exit_code != 0 or "FILE_NOT_FOUND" in result.stdout:
+        return {
+            "error": f"File not found: {path}",
+            "stderr": result.stderr,
+        }
+
+    # Parse output: first line is "TOTAL:<n>", rest is content
+    lines = result.stdout.split("\n", 1)
+    total_lines = 0
+    content = ""
+
+    if lines and lines[0].startswith("TOTAL:"):
+        total_str = lines[0][6:].strip()
+        total_lines = int(total_str) if total_str.isdigit() else 0
+        content = lines[1] if len(lines) > 1 else ""
+
+    content_lines = content.rstrip("\n").split("\n") if content.strip() else []
+    num_lines = len(content_lines)
+
+    return {
+        "file_type": "text",
+        "content": truncate_content(content),
+        "numLines": num_lines,
+        "startLine": start_line if view_range else 1,
+        "totalLines": total_lines + 1,
+    }
+
+
+async def async_create_file(
+    ctx: "AsyncSandboxContext", path: str, file_text: str, timeout: float | None
+) -> dict:
+    """Create a new file with content (async).
+
+    Args:
+        ctx: The async sandbox context.
+        path: The file path to create.
+        file_text: The content to write to the file.
+        timeout: Optional timeout for command execution.
+
+    Returns:
+        A dict with creation status or error information.
+    """
+    escaped_path = escape_for_shell(path)
+    encoded_content = base64.b64encode(file_text.encode()).decode()
+
+    # Get directory path for mkdir
+    dir_path = posixpath.dirname(path)
+    mkdir_part = f"mkdir -p {escape_for_shell(dir_path)} && " if dir_path else ""
+
+    # Single combined command: check existence, create dir, write file
+    cmd = (
+        f"is_update=$(test -f {escaped_path} && echo 1 || echo 0); "
+        f"{mkdir_part}"
+        f"echo {escape_for_shell(encoded_content)} | base64 -d > {escaped_path} && "
+        f'echo "STATUS:$is_update"'
+    )
+
+    result = await ctx.client.sandboxes.exec_command(
+        sandbox_id=ctx.sandbox_id,
+        command=cmd,
+        timeout=timeout,
+    )
+
+    if result.exit_code != 0 or "STATUS:" not in result.stdout:
+        return {
+            "error": f"Failed to create file: {path}",
+            "stderr": result.stderr,
+        }
+
+    is_update = "STATUS:1" in result.stdout
+
+    return {
+        "is_file_update": is_update,
+        "message": f"File {'updated' if is_update else 'created'}: {path}",
+    }
+
+
+async def async_str_replace(
+    ctx: "AsyncSandboxContext",
+    path: str,
+    old_str: str,
+    new_str: str,
+    timeout: float | None,
+) -> dict:
+    """Replace a string in a file (async).
+
+    Uses a Python script on the sandbox to avoid transferring the entire file.
+    Only the base64-encoded old_str and new_str are sent.
+
+    Args:
+        ctx: The async sandbox context.
+        path: The file path to modify.
+        old_str: The exact string to find and replace.
+        new_str: The string to replace old_str with.
+        timeout: Optional timeout for command execution.
+
+    Returns:
+        A dict with success message or error details.
+    """
+    old_b64 = base64.b64encode(old_str.encode()).decode()
+    new_b64 = base64.b64encode(new_str.encode()).decode()
+
+    # Write Python script to a temp file and execute it
+    # This avoids shell escaping issues with inline python -c
+    py_script = f'''import sys, base64, os
+old = base64.b64decode("{old_b64}").decode()
+new = base64.b64decode("{new_b64}").decode()
+path = "{path}"
+if not os.path.exists(path):
+    print("FILE_NOT_FOUND")
+    sys.exit(1)
+with open(path, "r") as f:
+    content = f.read()
+count = content.count(old)
+if count == 0:
+    print("NOT_FOUND")
+    sys.exit(0)
+if count > 1:
+    print(f"MULTIPLE:{{count}}")
+    sys.exit(0)
+with open(path, "w") as f:
+    f.write(content.replace(old, new, 1))
+print("SUCCESS")
+'''
+    # Base64 encode the script itself to avoid any escaping issues
+    script_b64 = base64.b64encode(py_script.encode()).decode()
+    cmd = f"echo {escape_for_shell(script_b64)} | base64 -d | python3"
+
+    result = await ctx.client.sandboxes.exec_command(
+        sandbox_id=ctx.sandbox_id,
+        command=cmd,
+        timeout=timeout,
+    )
+
+    output = result.stdout.strip()
+
+    if result.exit_code != 0 or output == "FILE_NOT_FOUND":
+        return {"error": f"File not found: {path}", "stderr": result.stderr}
+
+    if output == "NOT_FOUND":
+        return {"error": f"String not found in file: {old_str[:50]}..."}
+
+    if output.startswith("MULTIPLE:"):
+        count = output.split(":")[1]
+        return {
+            "error": f"Multiple occurrences ({count}) of the string found. "
+            "Please provide more context to make the match unique."
+        }
+
+    if output == "SUCCESS":
+        return {"msg": "Successfully replaced text at exactly one location."}
+
+    return {"error": f"Unexpected response: {output}", "stderr": result.stderr}

acontext-0.1.4/src/acontext/agent/text_editor.py

@@ -1,436 +0,0 @@
-"""Text editor file operations for sandbox environments."""
-
-import base64
-from typing import TYPE_CHECKING
-
-if TYPE_CHECKING:
-    from .sandbox import AsyncSandboxContext, SandboxContext
-
-
-def escape_for_shell(s: str) -> str:
-    """Escape a string for safe use in shell commands."""
-    # Use single quotes and escape any single quotes in the string
-    return "'" + s.replace("'", "'\"'\"'") + "'"
-
-
-# ============================================================================
-# Sync Operations
-# ============================================================================
-
-
-def view_file(
-    ctx: "SandboxContext", path: str, view_range: list | None, timeout: float | None
-) -> dict:
-    """View file content with line numbers.
-
-    Args:
-        ctx: The sandbox context.
-        path: The file path to view.
-        view_range: Optional [start_line, end_line] to view specific lines.
-        timeout: Optional timeout for command execution.
-
-    Returns:
-        A dict with file content and metadata, or error information.
-    """
-    # First check if file exists and get total lines
-    check_cmd = f"wc -l < {escape_for_shell(path)} 2>/dev/null || echo 'FILE_NOT_FOUND'"
-    result = ctx.client.sandboxes.exec_command(
-        sandbox_id=ctx.sandbox_id,
-        command=check_cmd,
-        timeout=timeout,
-    )
-
-    if "FILE_NOT_FOUND" in result.stdout or result.exit_code != 0:
-        return {
-            "error": f"File not found: {path}",
-            "stderr": result.stderr,
-        }
-
-    total_lines = int(result.stdout.strip()) if result.stdout.strip().isdigit() else 0
-
-    # Build the view command with line numbers
-    if view_range and len(view_range) == 2:
-        start_line, end_line = view_range
-        cmd = f"sed -n '{start_line},{end_line}p' {escape_for_shell(path)} | nl -ba -v {start_line}"
-    else:
-        cmd = f"nl -ba {escape_for_shell(path)}"
-        start_line = 1
-
-    result = ctx.client.sandboxes.exec_command(
-        sandbox_id=ctx.sandbox_id,
-        command=cmd,
-        timeout=timeout,
-    )
-
-    if result.exit_code != 0:
-        return {
-            "error": f"Failed to view file: {path}",
-            "stderr": result.stderr,
-        }
-
-    # Count lines in output
-    content_lines = (
-        result.stdout.rstrip("\n").split("\n") if result.stdout.strip() else []
-    )
-    num_lines = len(content_lines)
-
-    return {
-        "file_type": "text",
-        "content": result.stdout,
-        "numLines": num_lines,
-        "startLine": start_line if view_range else 1,
-        "totalLines": total_lines + 1,  # wc -l doesn't count last line without newline
-    }
-
-
-def create_file(
-    ctx: "SandboxContext", path: str, file_text: str, timeout: float | None
-) -> dict:
-    """Create a new file with content.
-
-    Args:
-        ctx: The sandbox context.
-        path: The file path to create.
-        file_text: The content to write to the file.
-        timeout: Optional timeout for command execution.
-
-    Returns:
-        A dict with creation status or error information.
-    """
-    # Check if file already exists
-    check_cmd = f"test -f {escape_for_shell(path)} && echo 'EXISTS' || echo 'NEW'"
-    check_result = ctx.client.sandboxes.exec_command(
-        sandbox_id=ctx.sandbox_id,
-        command=check_cmd,
-        timeout=timeout,
-    )
-    is_update = "EXISTS" in check_result.stdout
-
-    # Create directory if needed
-    dir_path = "/".join(path.split("/")[:-1])
-    if dir_path:
-        mkdir_cmd = f"mkdir -p {escape_for_shell(dir_path)}"
-        ctx.client.sandboxes.exec_command(
-            sandbox_id=ctx.sandbox_id,
-            command=mkdir_cmd,
-            timeout=timeout,
-        )
-
-    # Write file using base64 encoding to safely transfer content
-    encoded_content = base64.b64encode(file_text.encode()).decode()
-    write_cmd = f"echo {escape_for_shell(encoded_content)} | base64 -d > {escape_for_shell(path)}"
-
-    result = ctx.client.sandboxes.exec_command(
-        sandbox_id=ctx.sandbox_id,
-        command=write_cmd,
-        timeout=timeout,
-    )
-
-    if result.exit_code != 0:
-        return {
-            "error": f"Failed to create file: {path}",
-            "stderr": result.stderr,
-        }
-
-    return {
-        "is_file_update": is_update,
-        "message": f"File {'updated' if is_update else 'created'}: {path}",
-    }
-
-
-def str_replace(
-    ctx: "SandboxContext", path: str, old_str: str, new_str: str, timeout: float | None
-) -> dict:
-    """Replace a string in a file.
-
-    Args:
-        ctx: The sandbox context.
-        path: The file path to modify.
-        old_str: The exact string to find and replace.
-        new_str: The string to replace old_str with.
-        timeout: Optional timeout for command execution.
-
-    Returns:
-        A dict with diff information or error details.
-    """
-    # First read the file content
-    read_cmd = f"cat {escape_for_shell(path)}"
-    result = ctx.client.sandboxes.exec_command(
-        sandbox_id=ctx.sandbox_id,
-        command=read_cmd,
-        timeout=timeout,
-    )
-
-    if result.exit_code != 0:
-        return {
-            "error": f"File not found: {path}",
-            "stderr": result.stderr,
-        }
-
-    original_content = result.stdout
-
-    # Check if old_str exists in the file
-    if old_str not in original_content:
-        return {
-            "error": f"String not found in file: {old_str[:50]}...",
-        }
-
-    # Count occurrences
-    occurrences = original_content.count(old_str)
-    if occurrences > 1:
-        return {
-            "error": f"Multiple occurrences ({occurrences}) of the string found. Please provide more context to make the match unique.",
-        }
-
-    # Perform the replacement
-    new_content = original_content.replace(old_str, new_str, 1)
-
-    # Find the line numbers affected
-    old_lines = original_content.split("\n")
-    new_lines = new_content.split("\n")
-
-    # Find where the change starts
-    old_start = 1
-    for i, (old_line, new_line) in enumerate(zip(old_lines, new_lines)):
-        if old_line != new_line:
-            old_start = i + 1
-            break
-
-    # Write the new content
-    encoded_content = base64.b64encode(new_content.encode()).decode()
-    write_cmd = f"echo {escape_for_shell(encoded_content)} | base64 -d > {escape_for_shell(path)}"
-
-    result = ctx.client.sandboxes.exec_command(
-        sandbox_id=ctx.sandbox_id,
-        command=write_cmd,
-        timeout=timeout,
-    )
-
-    if result.exit_code != 0:
-        return {
-            "error": f"Failed to write file: {path}",
-            "stderr": result.stderr,
-        }
-
-    # Calculate diff info
-    old_str_lines = old_str.count("\n") + 1
-    new_str_lines = new_str.count("\n") + 1
-
-    # Build diff lines
-    diff_lines = []
-    for line in old_str.split("\n"):
-        diff_lines.append(f"-{line}")
-    for line in new_str.split("\n"):
-        diff_lines.append(f"+{line}")
-
-    return {
-        "oldStart": old_start,
-        "oldLines": old_str_lines,
-        "newStart": old_start,
-        "newLines": new_str_lines,
-        "lines": diff_lines,
-    }
-
-
-# ============================================================================
-# Async Operations
-# ============================================================================
-
-
-async def async_view_file(
-    ctx: "AsyncSandboxContext", path: str, view_range: list | None, timeout: float | None
-) -> dict:
-    """View file content with line numbers (async).
-
-    Args:
-        ctx: The async sandbox context.
-        path: The file path to view.
-        view_range: Optional [start_line, end_line] to view specific lines.
-        timeout: Optional timeout for command execution.
-
-    Returns:
-        A dict with file content and metadata, or error information.
-    """
-    check_cmd = f"wc -l < {escape_for_shell(path)} 2>/dev/null || echo 'FILE_NOT_FOUND'"
-    result = await ctx.client.sandboxes.exec_command(
-        sandbox_id=ctx.sandbox_id,
-        command=check_cmd,
-        timeout=timeout,
-    )
-
-    if "FILE_NOT_FOUND" in result.stdout or result.exit_code != 0:
-        return {
-            "error": f"File not found: {path}",
-            "stderr": result.stderr,
-        }
-
-    total_lines = int(result.stdout.strip()) if result.stdout.strip().isdigit() else 0
-
-    if view_range and len(view_range) == 2:
-        start_line, end_line = view_range
-        cmd = f"sed -n '{start_line},{end_line}p' {escape_for_shell(path)} | nl -ba -v {start_line}"
-    else:
-        cmd = f"nl -ba {escape_for_shell(path)}"
-        start_line = 1
-
-    result = await ctx.client.sandboxes.exec_command(
-        sandbox_id=ctx.sandbox_id,
-        command=cmd,
-        timeout=timeout,
-    )
-
-    if result.exit_code != 0:
-        return {
-            "error": f"Failed to view file: {path}",
-            "stderr": result.stderr,
-        }
-
-    content_lines = (
-        result.stdout.rstrip("\n").split("\n") if result.stdout.strip() else []
-    )
-    num_lines = len(content_lines)
-
-    return {
-        "file_type": "text",
-        "content": result.stdout,
-        "numLines": num_lines,
-        "startLine": start_line if view_range else 1,
-        "totalLines": total_lines + 1,
-    }
-
-
-async def async_create_file(
-    ctx: "AsyncSandboxContext", path: str, file_text: str, timeout: float | None
-) -> dict:
-    """Create a new file with content (async).
-
-    Args:
-        ctx: The async sandbox context.
-        path: The file path to create.
-        file_text: The content to write to the file.
-        timeout: Optional timeout for command execution.
-
-    Returns:
-        A dict with creation status or error information.
-    """
-    check_cmd = f"test -f {escape_for_shell(path)} && echo 'EXISTS' || echo 'NEW'"
-    check_result = await ctx.client.sandboxes.exec_command(
-        sandbox_id=ctx.sandbox_id,
-        command=check_cmd,
-        timeout=timeout,
-    )
-    is_update = "EXISTS" in check_result.stdout
-
-    dir_path = "/".join(path.split("/")[:-1])
-    if dir_path:
-        mkdir_cmd = f"mkdir -p {escape_for_shell(dir_path)}"
-        await ctx.client.sandboxes.exec_command(
-            sandbox_id=ctx.sandbox_id,
-            command=mkdir_cmd,
-            timeout=timeout,
-        )
-
-    encoded_content = base64.b64encode(file_text.encode()).decode()
-    write_cmd = f"echo {escape_for_shell(encoded_content)} | base64 -d > {escape_for_shell(path)}"
-
-    result = await ctx.client.sandboxes.exec_command(
-        sandbox_id=ctx.sandbox_id,
-        command=write_cmd,
-        timeout=timeout,
-    )
-
-    if result.exit_code != 0:
-        return {
-            "error": f"Failed to create file: {path}",
-            "stderr": result.stderr,
-        }
-
-    return {
-        "is_file_update": is_update,
-        "message": f"File {'updated' if is_update else 'created'}: {path}",
-    }
-
-
-async def async_str_replace(
-    ctx: "AsyncSandboxContext", path: str, old_str: str, new_str: str, timeout: float | None
-) -> dict:
-    """Replace a string in a file (async).
-
-    Args:
-        ctx: The async sandbox context.
-        path: The file path to modify.
-        old_str: The exact string to find and replace.
-        new_str: The string to replace old_str with.
-        timeout: Optional timeout for command execution.
-
-    Returns:
-        A dict with diff information or error details.
-    """
-    read_cmd = f"cat {escape_for_shell(path)}"
-    result = await ctx.client.sandboxes.exec_command(
-        sandbox_id=ctx.sandbox_id,
-        command=read_cmd,
-        timeout=timeout,
-    )
-
-    if result.exit_code != 0:
-        return {
-            "error": f"File not found: {path}",
-            "stderr": result.stderr,
-        }
-
-    original_content = result.stdout
-
-    if old_str not in original_content:
-        return {
-            "error": f"String not found in file: {old_str[:50]}...",
-        }
-
-    occurrences = original_content.count(old_str)
-    if occurrences > 1:
-        return {
-            "error": f"Multiple occurrences ({occurrences}) of the string found. Please provide more context to make the match unique.",
-        }
-
-    new_content = original_content.replace(old_str, new_str, 1)
-
-    old_lines = original_content.split("\n")
-    new_lines = new_content.split("\n")
-
-    old_start = 1
-    for i, (old_line, new_line) in enumerate(zip(old_lines, new_lines)):
-        if old_line != new_line:
-            old_start = i + 1
-            break
-
-    encoded_content = base64.b64encode(new_content.encode()).decode()
-    write_cmd = f"echo {escape_for_shell(encoded_content)} | base64 -d > {escape_for_shell(path)}"
-
-    result = await ctx.client.sandboxes.exec_command(
-        sandbox_id=ctx.sandbox_id,
-        command=write_cmd,
-        timeout=timeout,
-    )
-
-    if result.exit_code != 0:
-        return {
-            "error": f"Failed to write file: {path}",
-            "stderr": result.stderr,
-        }
-
-    old_str_lines = old_str.count("\n") + 1
-    new_str_lines = new_str.count("\n") + 1
-
-    diff_lines = []
-    for line in old_str.split("\n"):
-        diff_lines.append(f"-{line}")
-    for line in new_str.split("\n"):
-        diff_lines.append(f"+{line}")
-
-    return {
-        "oldStart": old_start,
-        "oldLines": old_str_lines,
-        "newStart": old_start,
-        "newLines": new_str_lines,
-        "lines": diff_lines,
-    }