Save (create or overwrite) a .md file in md-log by path; missing folders are auto-created. Optionally upload embedded images as assets first and rewrite their refs to asset:// links. This is a force-write (last-writer-wins) — the headline agent tool.

Upload a single image as an asset (reserve -> presigned PUT -> complete) and return an 'asset://' reference you can embed in markdown image syntax: . Provide the image as EITHER data_base64 (inline base64) OR file_path (a local file to read) — exactly one.

Append content to the end of an existing .md file using optimistic concurrency (GET current -> concat -> PUT with base_version_no). Auto-retries once on conflict, then surfaces CONFLICT.

Replace the content of an existing .md file. Pass expected_version for optimistic concurrency (mismatch -> CONFLICT); omit it to force last-writer-wins.

Read a .md file's content by path. Pass version (a version_no from list_versions) to read an OLD immutable version instead of the current one.

List a .md file's immutable version history, newest first (version_no, commit_message, author, registered_at, size). Read an old version's content with get_markdown + version.

Soft-delete a .md file. Requires confirm:true (otherwise VALIDATION). Resolves the path to a document key, then DELETE /documents/{key}.

Create a folder path, creating every missing parent segment (mkdir -p). Already-existing folders are treated as success.

Move and/or rename a .md file: from_path -> to_path. Destination folders are auto-created (mkdir -p). The document KEEPS its identity (same document key), so its whole version history and reviewers' annotations survive the move — never re-save + delete to relocate a file. Fails if a different file already occupies to_path.

Move a folder (with its whole subtree: documents, versions, annotations) under a new parent. new_parent_path '' or omitted = move to the root. Parent folders are auto-created. Moving a folder into its own subtree is rejected by the server.

Rename a folder in place (descendant paths are rewritten automatically; documents, versions and annotations are untouched).

Delete a folder. Requires confirm:true (otherwise VALIDATION). By default only an EMPTY folder is deleted (a non-empty one is refused); pass cascade:true to soft-delete the whole subtree — every subfolder and document under it (like rm -r). Documents are soft-deleted (recoverable), but prefer move_folder/move_markdown when reorganizing.

Return the full folder tree.

List the documents (and immediate subfolders) inside a folder path. Omit path (or pass '' / '/') to list the ROOT folder.

Search documents by TITLE (substring) and BODY (full-text over current versions; whole-word match, ranked, body hits carry a bolded snippet). Use it to find a prior report by its content or name.