agent-zero/plugins/_text_editor
Alessandro 4c2bc3d783 Add context-based patch_text support to text_editor
Introduces patch_text editing for the Docker-local text_editor, sharing request validation and freshness-state logic with text_editor_remote while preserving legacy line-number edits. Adds anchored context patching, safer state handling after context edits, updated model guidance, live remote wrapper reuse, and focused regression coverage for chained patches and Python replacement cases.
2026-04-21 18:18:59 +02:00
..
extensions refactor: split system prompt into per-concern extensions with extensibility hooks 2026-03-20 12:12:47 +08:00
helpers Add context-based patch_text support to text_editor 2026-04-21 18:18:59 +02:00
prompts Add context-based patch_text support to text_editor 2026-04-21 18:18:59 +02:00
tools Add context-based patch_text support to text_editor 2026-04-21 18:18:59 +02:00
webui generated logos for builtin plugins 2026-03-19 17:35:03 +01:00
default_config.yaml refactor - plugin names and builtin plugins 2026-03-10 22:20:53 +01:00
plugin.yaml refactor - plugin names and builtin plugins 2026-03-10 22:20:53 +01:00
README.md refactor: normalize plugin paths, add README viewer to plugin info modal, and update plugin hub filters 2026-03-22 08:05:32 +01:00

Text Editor

Provide an LLM-friendly file editing tool for reading, writing, and patching text files.

What It Does

This plugin exposes a native text editing tool that agents can use to inspect files, write complete contents, and apply validated patch operations while tracking file freshness between reads and edits.

Main Behavior

  • Read
    • Reads whole files or line ranges with token-aware limits.
    • Records file metadata so later patch operations can detect stale edits.
  • Write
    • Writes full file contents and then re-reads the resulting file for confirmation.
  • Patch
    • Validates edit structures before applying them.
    • Rejects edits if the file changed since it was last observed.
    • Reads back the affected patch region after applying changes.
  • Extension hooks
    • Exposes before and after extension points for read, write, and patch operations.

Key Files

  • Tool
    • tools/text_editor.py implements method dispatch, stale-file checks, patching flow, and prompt responses.
  • Helpers
    • helpers/file_ops.py provides file info, read/write helpers, edit validation, and patch application.
  • Configuration
    • default_config.yaml defines read limits and token budgets.
  • Prompts
    • prompts/ contains the agent-facing success and error messages.

Configuration Scope

  • Settings section: agent
  • Per-project config: true
  • Per-agent config: true

Plugin Metadata

  • Name: _text_editor
  • Title: Text Editor
  • Description: Native tool to read, write, and patch text files in an LLM-friendly way.