agent-zero/plugins/_text_editor
Alessandro 6f0f036fea Share editor log presentation across local and remote tools
Move the duplicated editor log builder into the existing text-editor helper boundary while preserving headings, remote markers, log routing and tool identity. Correct the documentation that confused plugin activation with availability of shipped Python dependencies.

Verified with 100 editor, action and policy tests, six final log checks, and a framework local/remote log probe with plugin discovery disabled. File operations and connector routing are unchanged.
2026-09-06 20:35:27 +02:00
..
extensions Add text_editor custom message handler and CSS 2026-09-03 15:08:59 +03:00
helpers Share editor log presentation across local and remote tools 2026-09-06 20:35:27 +02:00
prompts Split text editor and Office artifact ownership 2026-05-22 11:21:04 +02:00
tools Share editor log presentation across local and remote tools 2026-09-06 20:35:27 +02:00
webui generated logos for builtin plugins 2026-03-19 17:35:03 +01:00
AGENTS.md Share editor log presentation across local and remote tools 2026-09-06 20:35:27 +02: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.