Documents & manuscript

add_footnote

Adds a footnote or endnote definition to a document. The inline [^id] reference goes in the body (write it with the body/append tools); this defines the note's text. A fresh definition is an orphan until the body cites [^id].

Example call

{
  "name": "add_footnote",
  "arguments": {
    "title": "<title>",
    "text": "<text>"
  }
}

append_to_document

Appends prose to the end of a document's body, preserving its stored format (use this to continue a chapter without resending the whole body).

Example call

{
  "name": "append_to_document",
  "arguments": {
    "title": "<title>",
    "text": "<text>"
  }
}

create_document

Creates a document in the manuscript tree, appended after its siblings. Args: title (must be unique), optional kind/body/synopsis/parent.

Example call

{
  "name": "create_document",
  "arguments": {
    "title": "<title>"
  }
}

find_replace

Project-wide find & replace over document bodies (regex-capable). With dry_run or no replace it lists matches; a replace applies as one undo step.

Example call

{
  "name": "find_replace",
  "arguments": {
    "find": "<find>"
  }
}

get_document

Reads one document: kind, status, point of view, synopsis, word count, and its body as Markdown. Address it by title (or by id when titles collide).

Example call

{
  "name": "get_document",
  "arguments": {
    "title": "<title>"
  }
}

get_document_versions

Lists a document's saved version snapshots with labels and timestamps, oldest first.

Example call

{
  "name": "get_document_versions",
  "arguments": {
    "title": "<title>"
  }
}

get_manuscript_tree

Shows the manuscript's document tree in reading order, each document with its kind (prose/note/screenplay) and word count.

No parameters.

Example call

{
  "name": "get_manuscript_tree",
  "arguments": {}
}

list_footnotes

Lists a document's footnotes and endnotes in reader numbering (order of first [^id] reference in the body), plus any unreferenced definitions.

Example call

{
  "name": "list_footnotes",
  "arguments": {
    "title": "<title>"
  }
}

manage_variants

Manages a document's alternate ('what-if') drafts, distinct from version snapshots. action: list; create (branches a new draft from the current one and makes it active); switch (parks the live body and loads the named draft -- no draft is lost); rename (renames the active draft); delete (removes a named alternate, never the active one). Address drafts by name, which must stay unique.

Example call

{
  "name": "manage_variants",
  "arguments": {
    "title": "<title>"
  }
}

remove_footnote

Deletes a footnote definition by id. Any [^id] marker left in the body is reported so it can be removed from the prose too.

Example call

{
  "name": "remove_footnote",
  "arguments": {
    "title": "<title>",
    "footnote_id": "<footnote_id>"
  }
}

snapshot_document_version

Saves a version snapshot of a document's current body, so the draft can later be compared against or restored in Easy Writer's Version History.

Example call

{
  "name": "snapshot_document_version",
  "arguments": {
    "title": "<title>"
  }
}

update_document

Sparse update of one document: only the keys you pass change (new_title, body, synopsis, status, point_of_view, word_count_target, kind, parent). Omitted keys stay untouched. Reorder among siblings with "order" (first/last), "index" (0-based position), or "before"/"after" (a sibling title) -- alone to reorder in place, or with "parent" to reposition after moving; at most one ordering key.

Example call

{
  "name": "update_document",
  "arguments": {
    "title": "<title>"
  }
}

update_footnote

Edits an existing footnote definition's text and/or endnote flag, by id.

Example call

{
  "name": "update_footnote",
  "arguments": {
    "title": "<title>",
    "footnote_id": "<footnote_id>"
  }
}