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.

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). 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.