Read a document's history
folio_historyRead a document's version history, newest first, to see how a passage or value changed and when across commits, saves, deleted files, block revisions, and embed results.
Instructions
Read a document's versions, newest first, merged from its git commits and every save Folio saw - a document since deleted included. With version, that version's full text; with block, each text the block has had; with reference, each result that embed has shown. Use it to answer how a passage or a value changed and when; for everything that changed in the folder over a period use folio_digest. Give at most one of version, block and reference. Answers {path, versions: [{id, at: ISO time, seen: a list of saved, committed and file, by: the commit's author, removed}]}, {path, version, text: null when unknown}, {path, block, versions: [{version, at: ISO time, text: absent where the block was not there}]} or {path, reference, results: [{at: ISO time, value or table, error}]}. A list cut to fit one answer adds omitted, the entries each list left out, and narrow, how to ask for less.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | The document's path, relative to the served folder or absolute under it, such as notes/plan.md, also one since deleted | |
| block | No | A block's id as folio_document lists it, for each text the block has had | |
| version | No | A version's id from this tool's versions, for that version's text | |
| reference | No | An embed's reference as the document writes it, such as #totals#0.n, for each result it has shown |