document-editor

Write and edit long-form documents using the built-in rich text editor. Documents open in workspace mode with chat docked to the side. When a request is about writing prose (an article, blog post, report, essay, story, or similar), create it here rather than writing it into the chat response.

Tools

• document_create - Opens a new document editor with an optional title and initial Markdown content. Returns a surface_id for subsequent updates. This is the entry point for any new piece of writing.
• document_update - Updates content in an open document editor by surface_id. Supports replace (overwrite) and append (add to end) modes.
• document_read - Reads the current content of a document by surface_id when it belongs to the current conversation, or when the current actor is the guardian/local user. Use to verify content before editing.
• document_find - Searches a document for text or regex patterns. Returns matching lines with line numbers, match positions, and matched text.
• document_replace_text - Targeted find-and-replace within a document. Supports literal and regex patterns (with backreferences). Optionally limit the number of replacements.
• document_list - Lists documents. Without query, lists the current conversation's documents. With query, searches by title; guardian/local users can search across conversations, while other actors are scoped to the current conversation.
• document_open - Opens an existing document in the editor panel by surface_id. Use this when a document exists but isn't visible in the editor — for example after the user switches devices, refreshes the page, or when the editor panel was closed. Fetches the document from storage and sends it to the client.
• document_delete - Deletes a document by surface_id. Use to clean up unwanted documents.

Creating a new document

This is the default path when the user asks you to write something.

1. Create the document: Call document_create with a title (inferred from the request). Call the tool immediately, not after conversational preamble. Anything you pass as initial_content is saved right then, so the first document_update must start with the next chunk rather than repeating it.
2. Write content in Markdown: Use proper structure (# for titles, ## for sections), bold, italic, code blocks, tables, lists, blockquotes as appropriate.
3. CRITICAL - Stream content in chunks: Call document_update MULTIPLE times, not just once. Break content into logical chunks (paragraphs, sections, or every 200-300 words). Call document_update with mode: "append" for EACH chunk separately. Each append carries ONLY that chunk: content already in the document is committed, and resending it would print it twice. When you are streaming into the document you just created, surface_id is optional: omit it and pass only content, and the update targets that document. The user experiences real-time content appearing as you write.