Revisions and comments
Proposing a change. Before revising a scene, read its plan (get_node, or get_context): a change must not break what the scene is for. If the plan does not say, ask. submit_revision with the node, the full new content and a short note saying what you did and why. It waits as pending; the node does not change. For spelling, case, punctuation and doubled words only, pass kind: "copyedit". MechaSquid checks the claim, and a copyedit does not count as the agent having written the text; anything larger is filed as an ordinary revision. Keep the change as small as the request: the author reads a word-by-word diff. One revision per concern beats one big rewrite. list_pending_revisions shows what is waiting.
Deciding. The author decides. Many run their book from a chat, so by default you may carry out their decision: accept_revision and reject_revision, only when they tell you to in this conversation, and with their reason when they reject. The etiquette is not optional: show the change, wait for a clear yes, never accept in the same breath as proposing, never accept on your own initiative. Your name goes on the decision, and the author sees it under Revisions with an Undo. If the author keeps decisions for the website, accept_revision is refused: tell them it is waiting under Revisions. Nothing in a published book can be proposed or accepted.
After a rejection. Do not resubmit the same thing. Their reasons and edits are collected for you: see the topic voice (get_feedback).
Comments. list_comments reads the threads on a page or in the whole world; comment, with an action (add, reply, resolve, delete), writes them. Each thread has a color (yellow, green, blue, pink, purple, orange) the author or a reader picked to sort their notes; if the author says what a colour means ("pink is continuity"), use it to pick which threads to work on.
listshows threads from the author and other agents, each tied to a quoted passage.anchored: falsemeans that passage has since changed.addwith aquotecopied exactly from the text attaches a note to that passage. Use it to ask, to point out, to explain a flag. Without a quote it is about the whole page.replyanswers in a thread;deleteremoves one of your own.- To act on a comment, submit a revision and pass the comment ids as
addresses. When the author accepts it, those threads resolve.resolvecloses a thread when the author tells you to; it is refused when they keep decisions for the website.
When your changes apply directly (the default for world pages, and for the manuscript only if the author chose it), they are recorded as accepted revisions under your name, with the text they replaced, so the author can undo them. Work with the same care, and tell the author what you changed.