ShareCube

Add a comment. New thread: omit parent_thread_id; optionally pass anchor {quote, start, end, occurrenceIndex} for a selection (quote must match content.slice(start, end); occurrenceIndex is the 0-based match when quote appears more than once). Reply: set parent_thread_id to the thread id and omit anchor. Requires Commenter+ on the project. Response includes author_sub + author_name. To mention someone, insert [@Display Name](mention://user/{user_id}) using their stable user id.

create_comment

Create an HTML or Markdown artifact in a project (Editor/Owner) — the default, simplest way to create one: one call, content included. Use this unless the document is large (say, above ~2 MB) AND you can also issue a raw outbound HTTP request yourself outside of tool calls — only then is request_artifact_upload worth the extra step. Inline create is rejected above 4 MB. On success, response includes created_by + created_by_name and console_url — return console_url to the user so they can open the artifact in the ShareCube web app to edit further and manage visibility/permissions. share_url is the public link path (access still depends on visibility set in the console).

create_artifact

Create a new project in the caller's org. The caller becomes Owner. Use the returned projectId as project_id for create_artifact. There is no name-uniqueness constraint — check list_projects first if you want to avoid a duplicate.

create_project

Permanently delete an artifact (Editor/Owner).

delete_artifact

Delete a comment. Omit reply_id to delete the whole thread; set reply_id to delete one reply.

delete_comment

Replace one exact piece of text inside an artifact (Editor/Owner), without sending the whole document. Prefer this over update_artifact for any targeted change to an existing document, and especially for a large one: the body is read, edited and written server-side, so a small edit costs two short strings instead of a full copy in each direction. old_str must match the current content exactly, whitespace and line breaks included, and must appear exactly once — if it appears more than once the edit is refused rather than applied to a guess, so extend old_str with surrounding text until it is unique, or pass replace_all=true to change every occurrence. new_str may be empty to delete the matched text. Creates a new content version, so pass base_version_id from get_artifact (or from your own previous update) to be told about a concurrent save instead of overwriting it. To rewrite a document wholesale, or to change only the title, use update_artifact.

edit_artifact

Edit a comment or reply body. Omit reply_id to edit the thread root; set reply_id to edit a reply.

update_comment

Load artifact metadata and content. Response includes created_by + created_by_name, console_url (web app editor, comments, sharing/permissions), and share_url (public share page). Always give the user console_url when they need to continue editing or manage access. The response also includes current_version_id — keep it and pass it as base_version_id if you later call update_artifact or request_artifact_upload (update mode). Small documents include content inline. Large ones omit content and set content_url — GET that URL with no Authorization header (same as upload_url) before the content_url_expires_at timestamp. After an out-of-band PUT from request_artifact_upload, poll this tool: you succeeded only if current_version_id is a new id AND the body is your revision (inline content, or GET content_url). content_upload_error=conflict means a concurrent save won — re-read, rebase, retry. too_large, quota_exceeded or invalid_content (not UTF-8 text) mean the upload was refused; retrying the same body will not help. If current_version_id is still the base after about a minute, the PUT never finalized — re-read and retry. Do not treat "the version id changed" alone as proof your PUT won.

get_artifact

Get one comment thread (root + replies) by artifact_id and thread_id.

get_comment

Get one template by id from list_templates: its source with {{placeholders}}, and fill_prompt, how to fill it. Replace every placeholder with real content, follow fill_prompt, then save the result with create_artifact using the template's type. Never save the template with its placeholders.

get_template