plugins/_editor/helpers/open_files_context.py

from __future__ import annotations

from typing import Any

from plugins._editor.helpers import markdown_sessions


def build_context(context_id: str = "", max_items: int = 20) -> str:
    files = markdown_sessions.get_manager().list_open(context_id=context_id, limit=max_items)
    if not files:
        return ""

    lines = [
        "These Markdown or plain text files are open in the Editor for the active Agent Zero context. Content is omitted; use `text_editor` with action `read` before content-sensitive edits.",
    ]
    for item in files:
        lines.append(format_open_file_line(item))
    lines.append(
        "For these paths, `text_editor` is the canonical saved-edit tool. Use `open_in_canvas: true` only when the user asks to open the Editor UI; open Editor sessions refresh automatically after saved text edits."
    )
    return "\n".join(lines)


def format_open_file_line(item: dict[str, Any]) -> str:
    active = "active, " if item.get("active") else ""
    dirty = "dirty, " if item.get("dirty") else "saved, "
    external = "external changes pending, " if item.get("external_modified") else ""
    return (
        f"- {item.get('title', 'Untitled')} "
        f"(.{item.get('extension', 'md')}, {active}{dirty}{external}"
        f"file_id={item.get('file_id', '')}, path={item.get('path', '')}, "
        f"version={item.get('version', '')}, size={item.get('size', 0)} bytes, "
        f"last_modified={item.get('last_modified', '')}, open_sessions={item.get('open_sessions', 1)})"
    )