Create a shared Markdown doc, returns a public URL. Backend semantics differ: gist backend has no password support (secret URL is the protection) and lazy expiry; selfhost backend enforces both.

Append content to an existing shared doc. NOT idempotent: a retry appends twice — check with search_shared_docs before retrying. Accepts a doc id or URL.

Replace the entire content of an existing shared doc (title, password, and expiry are left unchanged). Idempotent: unlike append_to_shared_doc, calling it twice with the same content is safe to retry — the result is the same either way. Accepts a doc id or URL.

Extend a doc expiry by N hours (for "N days" multiply by 24 first). On the gist backend expiry is enforced lazily (cleanup on next use).

Reset a doc password (null removes protection). Selfhost backend only.

Update a shared doc title (must be non-empty).

Revoke a shared doc: the link stops working but the record stays searchable. Gist backend: the gist is deleted immediately and irreversibly. Selfhost backend: revoked with a 7-day grace before content is purged. To erase the record entirely, use delete_shared_doc.

Permanently delete a shared doc: the link dies AND the record disappears from search — unlike revoke_shared_doc, no history is kept. Irreversible on both backends. Requires confirm: true, which you must only pass after the user explicitly approved the permanent deletion; prefer revoke_shared_doc for routine takedowns.

Find previously shared docs and their links. Call with NO arguments to list the newest docs (each result includes its share URL, and on the selfhost backend, viewCount/lastViewedAt — gist returns those as null, GitHub exposes no gist view-count data). title_query filters by title substring; content_query searches body text (selfhost: full content; gist: the opening excerpt only); status filters active/revoked/expired; limit max 100 (default 20); offset pages past it (must be >= 0) — hasMore in the response tells you whether to fetch another page at offset + limit.