8601f0d10c
- rename document_artifact to office_artifact and remove retired shims/facades - make text_editor own Markdown saves, canvas-open intent, refresh, and stale-save protection - keep Office artifacts Desktop-only with Office formats and update skills/tests
3.3 KiB
text_editor
canonical text and Markdown file read write patch with numbered lines
not code execution rejects binary
terminal (grep find sed) advance search/replace
actions: read write patch
common args: action path
optional UI intent args: open_in_canvas
use this tool for Markdown and plain text files; use office_artifact only for Office packages such as odt ods odp docx xlsx pptx
if the user explicitly asks to open the Markdown file in the canvas/Editor after a write or patch, set open_in_canvas: true; otherwise omit UI flags because already-open Editor sessions refresh automatically
read
read file with numbered lines args path line_from line_to (inclusive optional) no range -> first {{default_line_count}} lines long lines cropped output may trim by token limit read surrounding context before patching usage:
{
"thoughts": ["I need file context before editing."],
"headline": "Reading file",
"tool_name": "text_editor",
"tool_args": {
"action": "read",
"path": "/path/file.py",
"line_from": 1,
"line_to": 50
}
}
write
create/overwrite file auto-creates dirs
args path content
for Markdown files, include open_in_canvas: true only when the user explicitly asks to open the canvas/Editor
usage:
{
"thoughts": ["I need to create or replace the file content."],
"headline": "Writing file",
"tool_name": "text_editor",
"tool_args": {
"action": "write",
"path": "/path/file.py",
"content": "import os\nprint('hello')\n"
}
}
patch
edit existing file. prefer exact replace for simple "change X to Y"; use patch_text for context changes; use edits only right after read for tiny line edits
if the user says patch, change without rewriting, or don't rewrite, use action patch instead of write
args path plus exactly one of: old_text+new_text OR patch_text string OR edits [{from to content}]
for Markdown files, include open_in_canvas: true only when the user explicitly asks to open the canvas/Editor
exact replace: old_text must be the exact current text span and must match once; new_text is the replacement
patch_text uses current file content, no prior read required
patch_text update-only forms:
- insert after anchor: @@ exact existing line then +new lines
- replace: use @@ line before target then -old +new, or @@ old target line then -same old target line +new
- do not repeat the same old line as both a space-context line and a -removed line
- context lines start with space, removals with -, additions with +
- use enough unique context; add @@ anchor when repeated text exists edits legacy line mode: from/to inclusive, original line numbers from read, no overlaps edits examples: {from:2 to:2 content:"x\n"} replace; {from:2 to:2} delete; {from:2 content:"x\n"} insert before for edits, re-read after insert/delete or line-count-changing replace ensure valid syntax in content (all braces brackets tags closed) usage:
{
"thoughts": ["I can replace one exact current string without rewriting the whole file."],
"headline": "Patching file",
"tool_name": "text_editor",
"tool_args": {
"action": "patch",
"path": "/path/file.py",
"old_text": "status = 'draft'",
"new_text": "status = 'ready'"
}
}