tau-coding-agent 0.1.0__py3-none-any.whl

tau/builtins/models/video.py

@@ -0,0 +1,40 @@
+from tau.inference.model.types import Cost, Model, Modality
+
+_TEXT  = [Modality.Text]
+_IMAGE = [Modality.Image]
+_VIDEO = [Modality.Video]
+
+models = [
+    # Google Veo 3 via fal.ai
+    Model(id="fal-ai/veo3",      name="Veo 3",      provider="fal", cost=Cost(), input=_TEXT, output=_VIDEO, api="fal-video"),
+    Model(id="fal-ai/veo3-fast", name="Veo 3 Fast", provider="fal", cost=Cost(), input=_TEXT, output=_VIDEO, api="fal-video"),
+    # Kling via fal.ai
+    Model(id="fal-ai/kling-video/v2.1/standard/text-to-video",  name="Kling v2.1 Standard",     provider="fal", cost=Cost(), input=_TEXT,  output=_VIDEO, api="fal-video"),
+    Model(id="fal-ai/kling-video/v2.1/pro/text-to-video",       name="Kling v2.1 Pro",          provider="fal", cost=Cost(), input=_TEXT,  output=_VIDEO, api="fal-video"),
+    Model(id="fal-ai/kling-video/v2.1/standard/image-to-video", name="Kling v2.1 Standard I2V", provider="fal", cost=Cost(), input=_IMAGE, output=_VIDEO, api="fal-video"),
+    Model(id="fal-ai/kling-video/v2.1/pro/image-to-video",      name="Kling v2.1 Pro I2V",      provider="fal", cost=Cost(), input=_IMAGE, output=_VIDEO, api="fal-video"),
+    # Runway Gen4 via fal.ai
+    Model(id="fal-ai/runway-gen4/turbo/text-to-video", name="Runway Gen4 Turbo", provider="fal", cost=Cost(), input=_TEXT, output=_VIDEO, api="fal-video"),
+    # Hailuo AI via fal.ai
+    Model(id="fal-ai/hailuo-ai/video-01",              name="Hailuo Video 01",     provider="fal", cost=Cost(), input=_TEXT,  output=_VIDEO, api="fal-video"),
+    Model(id="fal-ai/hailuo-ai/video-01/image-to-video", name="Hailuo Video 01 I2V", provider="fal", cost=Cost(), input=_IMAGE, output=_VIDEO, api="fal-video"),
+    # Seedance via fal.ai
+    Model(id="fal-ai/seedance-v1/lite/text-to-video", name="Seedance v1 Lite", provider="fal", cost=Cost(), input=_TEXT, output=_VIDEO, api="fal-video"),
+    Model(id="fal-ai/seedance-v1/pro/text-to-video",  name="Seedance v1 Pro",  provider="fal", cost=Cost(), input=_TEXT, output=_VIDEO, api="fal-video"),
+
+    # OpenRouter video models
+    Model(id="bytedance/seedance-2.0",      name="Seedance 2.0",         provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+    Model(id="bytedance/seedance-2.0-fast", name="Seedance 2.0 Fast",    provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+    Model(id="bytedance/seedance-1-5-pro",  name="Seedance 1.5 Pro",     provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+    Model(id="google/veo-3.1",              name="Veo 3.1",              provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+    Model(id="google/veo-3.1-fast",         name="Veo 3.1 Fast",         provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+    Model(id="google/veo-3.1-lite",         name="Veo 3.1 Lite",         provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+    Model(id="alibaba/wan-2.7",             name="Wan 2.7",              provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+    Model(id="alibaba/wan-2.6",             name="Wan 2.6",              provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+    Model(id="openai/sora-2-pro",           name="Sora 2 Pro",           provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+    Model(id="x-ai/grok-imagine-video",      name="Grok Imagine Video",   provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+    Model(id="minimax/hailuo-2.3",          name="Hailuo 2.3",           provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+    Model(id="kwaivgi/kling-video-o1",      name="Video O1",             provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+    Model(id="kwaivgi/kling-v3.0-pro",      name="Video v3.0 Pro",       provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+    Model(id="kwaivgi/kling-v3.0-std",      name="Video v3.0 Standard",  provider="openrouter", cost=Cost(), input=[Modality.Text, Modality.Image], output=_VIDEO, api="openrouter-video"),
+]

tau/builtins/prompts/commit.md

@@ -0,0 +1,7 @@
+---
+description: Write a commit message for staged changes
+argument-hint: [context]
+---
+Write a concise git commit message for the staged changes. Follow conventional commit style (type: short summary). If context is provided, use it to inform the message.
+
+${1:-no additional context}

tau/builtins/prompts/docs.md

@@ -0,0 +1,7 @@
+---
+description: Write or improve documentation
+argument-hint: <file or function>
+---
+Write clear, accurate documentation for the following. Include purpose, parameters/fields, return values, and a usage example where helpful.
+
+$@

tau/builtins/prompts/explain.md

@@ -0,0 +1,7 @@
+---
+description: Explain code or a concept clearly
+argument-hint: <file or topic>
+---
+Explain the following clearly and concisely. Use plain language and give a concrete example if it helps.
+
+$@

tau/builtins/prompts/fix.md

@@ -0,0 +1,7 @@
+---
+description: Fix a bug or error
+argument-hint: <error or description>
+---
+Fix the following issue. Read the relevant code first, identify the root cause, and make a targeted fix.
+
+$@

tau/builtins/prompts/refactor.md

@@ -0,0 +1,7 @@
+---
+description: Refactor code for clarity or performance
+argument-hint: <file or description>
+---
+Refactor the following. Improve readability and structure without changing behaviour. Explain what you changed and why.
+
+$@

tau/builtins/prompts/review.md

@@ -0,0 +1,7 @@
+---
+description: Review code or changes for issues
+argument-hint: <files or description>
+---
+Review the following carefully. Look for bugs, security issues, unclear logic, and style problems. Be specific and concise.
+
+$@

tau/builtins/prompts/test.md

@@ -0,0 +1,7 @@
+---
+description: Write tests for the given code
+argument-hint: <file or function>
+---
+Write tests for the following. Cover the happy path, edge cases, and error conditions.
+
+$@

tau/builtins/providers/audio.py

@@ -0,0 +1,10 @@
+from tau.inference.provider.types import AudioProvider
+
+providers = [
+    AudioProvider(name="openai",     api="openai-audio"),
+    AudioProvider(name="openrouter", api="openai-audio",     base_url="https://openrouter.ai/api/v1"),
+    AudioProvider(name="groq",       api="openai-audio",     base_url="https://api.groq.com/openai/v1"),
+    AudioProvider(name="google",     api="gemini-audio"),
+    AudioProvider(name="sarvam",     api="sarvam-audio",     base_url="https://api.sarvam.ai"),
+    AudioProvider(name="elevenlabs", api="elevenlabs-audio", base_url="https://api.elevenlabs.io"),
+]

tau/builtins/providers/image.py

@@ -0,0 +1,9 @@
+from tau.inference.provider.types import ImageProvider
+
+providers = [
+    ImageProvider(name="openrouter", api="openrouter-image", base_url="https://openrouter.ai/api/v1"),
+    ImageProvider(name="openai",     api="openai-image",     base_url="https://api.openai.com/v1"),
+    ImageProvider(name="together",   api="openai-image",     base_url="https://api.together.xyz/v1"),
+    ImageProvider(name="fireworks",  api="openai-image",     base_url="https://api.fireworks.ai/inference/v1"),
+    ImageProvider(name="google",     api="gemini-image",     base_url="https://generativelanguage.googleapis.com"),
+]

tau/builtins/providers/text.py

@@ -0,0 +1,33 @@
+from tau.inference.provider.oauth.openai_codex import OpenAICodexOAuthProvider
+from tau.inference.provider.oauth.anthropic_claude_code import AnthropicClaudeCodeOAuthProvider
+from tau.inference.provider.oauth.github_copilot import GitHubCopilotOAuthProvider
+from tau.inference.provider.oauth.google_antigravity import GoogleAntigravityOAuthProvider
+from tau.inference.provider.types import APIProvider
+from tau.inference.types import LLMOptions
+
+api_providers = [
+    APIProvider(id="openai",     name="OpenAI",          api="openai_responses",   options=LLMOptions()),
+    APIProvider(id="anthropic",  name="Anthropic",       api="anthropic_messages", options=LLMOptions()),
+    APIProvider(id="google",     name="Google",          api="gemini_generate",    options=LLMOptions()),
+    APIProvider(id="nvidia",     name="NVIDIA",          api="openai_completions", options=LLMOptions(base_url="https://integrate.api.nvidia.com/v1")),
+    APIProvider(id="groq",       name="Groq",            api="openai_completions", options=LLMOptions(base_url="https://api.groq.com/openai/v1")),
+    APIProvider(id="openrouter", name="OpenRouter",      api="openai_completions", options=LLMOptions(base_url="https://openrouter.ai/api/v1", extra_params={"include_reasoning": True})),
+    APIProvider(id="perplexity", name="Perplexity",      api="openai_responses",   options=LLMOptions(base_url="https://api.perplexity.ai/v1")),
+    APIProvider(id="xai",        name="xAI",             api="openai_responses",   options=LLMOptions(base_url="https://api.x.ai/v1")),
+    APIProvider(id="bedrock",    name="AWS Bedrock",     api="openai_responses",   options=LLMOptions(base_url="https://bedrock-mantle.us-east-1.api.aws/v1")),
+    APIProvider(id="kimi",       name="Kimi / Moonshot", api="openai_completions", options=LLMOptions(base_url="https://api.moonshot.ai/v1")),
+    APIProvider(id="minimax",    name="MiniMax",         api="anthropic_messages", options=LLMOptions(base_url="https://api.minimax.io/anthropic")),
+    APIProvider(id="deepseek",   name="DeepSeek",        api="openai_completions", options=LLMOptions(base_url="https://api.deepseek.com")),
+    APIProvider(id="kilocode",   name="Kilo Code",       api="openai_completions", options=LLMOptions(base_url="https://api.kilo.ai/api/gateway")),
+    APIProvider(id="mistral",    name="Mistral",         api="mistral_chat",       options=LLMOptions()),
+    APIProvider(id="ollama",     name="Ollama",          api="ollama_chat",        options=LLMOptions(base_url="http://localhost:11434")),
+]
+
+oauth_providers = [
+    OpenAICodexOAuthProvider(),
+    AnthropicClaudeCodeOAuthProvider(),
+    GitHubCopilotOAuthProvider(),
+    GoogleAntigravityOAuthProvider(),
+]
+
+providers = api_providers + oauth_providers

tau/builtins/providers/video.py

@@ -0,0 +1,6 @@
+from tau.inference.provider.types import VideoProvider
+
+providers = [
+    VideoProvider(name="fal",        api="fal-video"),
+    VideoProvider(name="openrouter", api="openrouter-video", base_url="https://openrouter.ai/api/v1"),
+]

tau/builtins/skills/code-review/SKILL.md

@@ -0,0 +1,4 @@
+---
+description: Review code changes for bugs, clarity, and correctness
+---
+Read the relevant files or diff. Look for bugs, security issues, unclear logic, and style problems. Report findings as a concise list grouped by severity (critical / warning / suggestion). Be specific — include file and line references where possible.

tau/builtins/skills/debug/SKILL.md

@@ -0,0 +1,4 @@
+---
+description: Diagnose and fix a bug or unexpected behaviour
+---
+Read the relevant code and any error output. Identify the root cause, not just the symptom. Explain the cause in one sentence, then make a targeted fix. Do not change unrelated code. If reproduction steps are unclear, ask before guessing.

tau/builtins/skills/git-commit/SKILL.md

@@ -0,0 +1,4 @@
+---
+description: Stage and commit changes with a well-formed commit message
+---
+Stage the relevant files, write a conventional commit message based on the diff, and create the commit. Follow the format `type: short summary` (e.g. `feat:`, `fix:`, `refactor:`). Keep the subject under 72 characters. If there are staged changes already, use them as-is.

tau/builtins/themes/dark.yaml

@@ -0,0 +1 @@
+name: dark

tau/builtins/themes/light.yaml

@@ -0,0 +1,46 @@
+name: light
+
+colors:
+  # UI chrome
+  divider:          "#c8c8c8"
+  spinner_frame:    "#0066cc"
+  spinner_label:    "#999999"
+
+  # Markdown
+  heading:          { color: "#6d28d9", bold: true }
+  code_inline:      "#b45309"
+  code_block:       "#047857"
+  code_block_border: "#c8c8c8"
+  quote:            { color: "#9ca3af", italic: true }
+  quote_border:     "#c8c8c8"
+  hr:               "#c8c8c8"
+  list_bullet:      "#6d28d9"
+  link_text:        "#0066cc"
+  link_url:         "#9ca3af"
+
+  # Messages
+  you_label:        { color: "#0066cc", bold: true }
+  assistant_label:  { color: "#047857", bold: true }
+  tool_arrow:       "#b45309"
+  tool_result_ok:   "#9ca3af"
+  tool_result_err:  "#dc2626"
+  thinking:         { color: "#9ca3af", italic: true }
+  error_label:      { color: "#dc2626", bold: true }
+  dim:              "#9ca3af"
+  stream_cursor:    "#374151"
+
+  # Select list
+  selected_label:   { color: "#6d28d9", bold: true }
+  selected_desc:    "#0066cc"
+  normal_label:     "#374151"
+  normal_desc:      "#9ca3af"
+  indicator:        "#9ca3af"
+  empty:            "#9ca3af"
+
+input:
+  prefix:      "❯ "
+  placeholder: ""
+
+spinner:
+  frames:      ["▖", "▘", "▝", "▗"]
+  interval_ms: 120

tau/builtins/tools/__init__.py

@@ -0,0 +1,73 @@
+"""Built-in coding-agent tools."""
+
+from tau.builtins.tools.read import ReadTool
+from tau.builtins.tools.write import WriteTool
+from tau.builtins.tools.edit import EditTool
+from tau.builtins.tools.terminal import TerminalTool
+from tau.builtins.tools.glob import GlobTool
+from tau.builtins.tools.grep import GrepTool
+from tau.builtins.tools.ls import LsTool
+
+TOOLS = [
+    ReadTool(),
+    WriteTool(),
+    EditTool(),
+    TerminalTool(),
+    GlobTool(),
+    GrepTool(),
+    LsTool(),
+]
+
+
+def create_read_tool() -> ReadTool:
+    """Return a fresh ReadTool instance for delegation in extension renderers."""
+    return ReadTool()
+
+
+def create_write_tool() -> WriteTool:
+    """Return a fresh WriteTool instance for delegation in extension renderers."""
+    return WriteTool()
+
+
+def create_edit_tool() -> EditTool:
+    """Return a fresh EditTool instance for delegation in extension renderers."""
+    return EditTool()
+
+
+def create_terminal_tool() -> TerminalTool:
+    """Return a fresh TerminalTool instance for delegation in extension renderers."""
+    return TerminalTool()
+
+
+def create_glob_tool() -> GlobTool:
+    """Return a fresh GlobTool instance for delegation in extension renderers."""
+    return GlobTool()
+
+
+def create_grep_tool() -> GrepTool:
+    """Return a fresh GrepTool instance for delegation in extension renderers."""
+    return GrepTool()
+
+
+def create_ls_tool() -> LsTool:
+    """Return a fresh LsTool instance for delegation in extension renderers."""
+    return LsTool()
+
+
+__all__ = [
+    "ReadTool",
+    "WriteTool",
+    "EditTool",
+    "TerminalTool",
+    "GlobTool",
+    "GrepTool",
+    "LsTool",
+    "TOOLS",
+    "create_read_tool",
+    "create_write_tool",
+    "create_edit_tool",
+    "create_terminal_tool",
+    "create_glob_tool",
+    "create_grep_tool",
+    "create_ls_tool",
+]

tau/builtins/tools/edit.py

@@ -0,0 +1,215 @@
+from __future__ import annotations
+
+import difflib
+import re
+from pathlib import Path
+from typing import Any, Optional
+
+from pydantic import BaseModel, Field
+
+from tau.tool.types import (
+    Tool, ToolKind,
+    ToolInvocation, ToolResult,
+    ToolExecutionUpdateCallback, AbortSignal, ToolContext,
+)
+from tau.tool.render import call_line
+
+
+def _render_edit_call(args: dict, _streaming: bool) -> list[str]:
+    return call_line("edit", args.get("path", ""))
+
+_CONTEXT_LINES = 2
+
+
+class EditParams(BaseModel):
+    """Parameters for the edit tool."""
+    path: str = Field(description="Absolute path to the file to edit.")
+    old_string: str = Field(description="Exact string to find and replace.")
+    new_string: str = Field(description="Replacement string.")
+    replace_all: bool = Field(default=False, description="Replace all occurrences; default replaces only the first.")
+
+
+def _parse_hunks(diff: str) -> list[list[tuple[str, int, int, str]]]:
+    """Parse unified diff into hunks of (char, old_line, new_line, text)."""
+    hunks: list[list[tuple[str, int, int, str]]] = []
+    current: list[tuple[str, int, int, str]] = []
+    old_line = new_line = 0
+    for raw in diff.splitlines():
+        if raw.startswith("---") or raw.startswith("+++"):
+            continue
+        if raw.startswith("@@"):
+            m = re.match(r"@@ -(\d+)(?:,\d+)? \+(\d+)(?:,\d+)? @@", raw)
+            if m:
+                if current:
+                    hunks.append(current)
+                    current = []
+                old_line, new_line = int(m.group(1)), int(m.group(2))
+        elif raw.startswith("+"):
+            current.append(("+", old_line, new_line, raw[1:]))
+            new_line += 1
+        elif raw.startswith("-"):
+            current.append(("-", old_line, new_line, raw[1:]))
+            old_line += 1
+        else:
+            current.append((" ", old_line, new_line, raw[1:]))
+            old_line += 1
+            new_line += 1
+    if current:
+        hunks.append(current)
+    return hunks
+
+
+def _render_edit_result(content: str, opts: Any) -> list[str]:
+    from tau.tui.ansi import GREEN, RED, DIM, RESET
+    metadata = opts.metadata or {}
+    added   = metadata.get("lines_added", 0)
+    removed = metadata.get("lines_removed", 0)
+    diff    = metadata.get("diff", "")
+
+    parts = []
+    if added:
+        parts.append(f"{GREEN}Added {added} {'line' if added == 1 else 'lines'}{RESET}")
+    if removed:
+        parts.append(f"{RED}Removed {removed} {'line' if removed == 1 else 'lines'}{RESET}")
+    result = [", ".join(parts) if parts else content.strip()]
+
+    if not diff:
+        return result
+
+    hunks = _parse_hunks(diff)
+    if not hunks:
+        return result
+
+    has_gaps = False
+
+    if opts.expanded:
+        for hunk in hunks:
+            for char, ol, nl, text in hunk:
+                if char == "+":
+                    result.append(f"{GREEN}{nl}  +  {text}{RESET}")
+                elif char == "-":
+                    result.append(f"{RED}{ol}  -  {text}{RESET}")
+                else:
+                    result.append(f"{nl}     {text}")
+    else:
+        prev_new_end: int | None = None
+        for hunk in hunks:
+            new_start = hunk[0][2]
+            if prev_new_end is not None:
+                gap = new_start - prev_new_end
+                if gap > 0:
+                    result.append(f"{DIM}  ···  {gap} line{'s' if gap != 1 else ''}{RESET}")
+                    has_gaps = True
+
+            changed = {i for i, (c, *_) in enumerate(hunk) if c != " "}
+            show = {j for ci in changed for j in range(max(0, ci - _CONTEXT_LINES), min(len(hunk), ci + _CONTEXT_LINES + 1))}
+
+            prev_i: int | None = None
+            for i, (char, ol, nl, text) in enumerate(hunk):
+                if i not in show:
+                    continue
+                if prev_i is not None and i > prev_i + 1:
+                    gap = i - prev_i - 1
+                    result.append(f"{DIM}  ···  {gap} line{'s' if gap != 1 else ''}{RESET}")
+                    has_gaps = True
+                if char == "+":
+                    result.append(f"{GREEN}{nl}  +  {text}{RESET}")
+                elif char == "-":
+                    result.append(f"{RED}{ol}  -  {text}{RESET}")
+                else:
+                    result.append(f"{nl}     {text}")
+                prev_i = i
+
+            last = hunk[-1]
+            prev_new_end = last[2] + (1 if last[0] != "-" else 0)
+
+    if has_gaps or opts.expanded:
+        hint = "(ctrl+o to collapse)" if opts.expanded else "···  (ctrl+o to expand)"
+        result.append(f"{DIM}  {hint}{RESET}")
+
+    return result
+
+
+class EditTool(Tool):
+    """Tool for replacing exact strings in files."""
+    def __init__(self) -> None:
+        super().__init__(
+            name="edit",
+            description=(
+                "Replace an exact string in a file. Fails if old_string is not found or (when replace_all=false) "
+                "appears more than once. Use replace_all=true to replace every occurrence."
+            ),
+            schema=EditParams,
+            kind=ToolKind.Edit,
+            render_result=_render_edit_result,
+            render_call=_render_edit_call,
+            render_shell="default",
+            prompt_guidelines="Read the file first so you understand context. Prefer small, targeted edits over rewriting large sections.",
+        )
+
+    def get_display_name(self, args: dict[str, Any]) -> str:
+        return args.get("path", "edit")
+
+    async def execute(
+        self,
+        invocation: ToolInvocation,
+        tool_execution_update_callback: Optional[ToolExecutionUpdateCallback] = None,
+        signal: Optional[AbortSignal] = None,
+        context: Optional[ToolContext] = None,
+    ) -> ToolResult:
+        params = EditParams.model_validate(invocation.params)
+        path = Path(params.path)
+
+        if not path.exists():
+            return ToolResult.error(invocation.id, f"File not found: {params.path}")
+        if not path.is_file():
+            return ToolResult.error(invocation.id, f"Not a file: {params.path}")
+
+        try:
+            original = path.read_text(encoding="utf-8")
+        except OSError as e:
+            return ToolResult.error(invocation.id, f"Cannot read file: {e}")
+
+        count = original.count(params.old_string)
+        if count == 0:
+            return ToolResult.error(invocation.id, f"old_string not found in {params.path}")
+        if not params.replace_all and count > 1:
+            return ToolResult.error(
+                invocation.id,
+                f"old_string matches {count} locations in {params.path}. "
+                "Provide more context to make it unique, or set replace_all=true.",
+            )
+
+        if params.replace_all:
+            updated = original.replace(params.old_string, params.new_string)
+        else:
+            updated = original.replace(params.old_string, params.new_string, 1)
+
+        try:
+            path.write_text(updated, encoding="utf-8")
+        except OSError as e:
+            return ToolResult.error(invocation.id, f"Cannot write file: {e}")
+
+        replacements = count if params.replace_all else 1
+
+        original_lines = original.splitlines(keepends=True)
+        updated_lines  = updated.splitlines(keepends=True)
+        diff_lines = list(difflib.unified_diff(
+            original_lines, updated_lines,
+            fromfile=f"a/{path.name}", tofile=f"b/{path.name}",
+            n=99999,
+        ))
+        diff = "".join(diff_lines)
+        lines_added   = sum(1 for l in diff_lines if l.startswith("+") and not l.startswith("+++"))
+        lines_removed = sum(1 for l in diff_lines if l.startswith("-") and not l.startswith("---"))
+
+        metadata = {
+            "file_path": str(path),
+            "lines_added": lines_added,
+            "lines_removed": lines_removed,
+            "diff": diff,
+            "occurrences_replaced": replacements,
+            "replace_all": params.replace_all,
+            "total_lines": len(updated_lines),
+        }
+        return ToolResult.ok(invocation.id, f"Replaced {replacements} occurrence(s) in {params.path}", metadata=metadata)