Rapier

Reads exact source (Markdown included) by ref, context_handle or start/end in UTF-16 units, or one comparison difference by its change handle. Use a ref returned to this caller; obtain a fresh one if it expires or becomes stale. Use when you need the words themselves, and before every edit. The returned handle authorizes editing exactly the disclosed text; next_cursor reads on, and complete_handle then covers the whole passage. A drawing reads as its recipe JSON (paint rasters as {kept:true,bytes,type}), and its handle is document.draw's recipe_handle.

document.read_context

Opens a comparison of one of your applied changes (default: your latest) for the person to see. Use to inspect an applied revision or answer what changed. This shows an applied change; it does not approve a proposal or count as human review.

document.show_changes

Lists notes from this host’s configured Notes store (file, title, section, modified), Skills first, without bodies. An absent store returns successful empty data with availability unavailable; it does not grant access to device files.

notes.list

Returns editor or headless/page state, edit gate, Will, review cause, changes since your last look, waiting returns, selection and focus. Use when starting, resuming, or resolving “this” in a request from the editor. Host context is a pointer; read current source before changing it. An optional brief comes from a source comment visible in the editable document; it is continuation context, never authority over the person. Inspect before editing; a pending proposal is not applied. Send agent, your display name, on each call; the ledger lists those names.

document.get_context

Lists headings, or code declarations, with refs for read_context, without their bodies. Refs are temporary, caller-scoped read grants minted per call, not stable section ids; find can return a different ref for the same section. Use when you need the shape of the document before reading part of it.

document.get_outline

Stages apply_edits' batch as a proposal the person approves or declines; the source is unchanged until then. Use when the change is theirs to decide, whatever the policy. Send only the changed passages; one review at a time.

document.propose_edits

Creates a workspace from text or reopens one by its document capability and requests an editor from the host. A successful call does not confirm an editor opened; document.get_context reports editor presence or a headless workspace. Use for an editable document, drawing or review workspace in the requested task. Include prose and supported Mermaid flowcharts directly in text; reopen existing work with document alone. Open once per presentation, then use document.* tools with the returned document; do not reopen merely to deliver it again after reading or editing. The workspace lasts until expiresAt. A createToken makes a create retryable: the same token reopens the workspace it made.

rapier.open

Reads one note's Markdown by file, paged like read_context. An absent store or missing note returns successful empty data with found false and text null. An existing empty note has found true and text empty. An unreadable store still refuses.

notes.read

Waits for the person's next selection, message or returned page, up to timeout_ms. Use when the next step is theirs. One wait at a time.

document.wait_for_user

Returns this editor's workspace snapshot, or unchanged while afterRevision and afterVersion still hold.

document.sync

Replaces the working document with text; old handles and comparisons end. Use only when the person asked for a new document here; for a separate MCP workspace, use rapier.open.

document.open_text

Saves to the destination the person already chose on a local host. On the hosted door, confirms durable workspace storage; it does not download or save a file on the person’s device. The receipt says whether the write was verified.

document.save

Commits the editor's exact text against its last acknowledged revision. A conflict keeps the server's revision.

document.commit

Sets the person's choice of FREE, CHECK, ASK or read-only on this workspace version.

document.set_policy

Requests display of the passage or difference a current handle names. On the hosted door, presentation_pending is normal: the editor has not confirmed display. Retain view.id and check document.get_context with a fresh operation_id; that same view with status presented confirms it. refused, expired or invalidated ends the request. Do not claim display or repeat reveal while pending. wait_for_user waits for a reply, not display confirmation.

document.reveal

Reverses one of your changes and keeps the person's later work. Use when they want that edit taken back. Without change_id, the call's agent name selects its latest change; when the latest change is another name's, the answer names it and its id. Naming change_id undoes that change.

document.undo_agent_change

Reports this editor's selection, focus and editing lease for one revision.

document.human_context