add_artifact
ChatGPTSaves a text note (kind "text" + text) or a link (kind "url" + url, optional text) to the space so every member and their AI can find it later.
cancel_reminder
ChatGPTCancels a scheduled reminder. Whoever set it, the owner or an admin may cancel it.
cancel_request
ChatGPTCancels a pending request the user created, e.g. when it is no longer needed. A space owner may also cancel a request someone else left open.
close_poll
ChatGPTEnds voting and announces the result to the group. Whoever started the poll, the owner or an admin may close it.
create_decision
ChatGPTRecords a decision the group made. First show the user the exact title and body and get an explicit yes, then call with confirmed: true. Without it the call fails. Runs only after the user's explicit yes in this conversation.
create_poll
ChatGPTStarts a poll for the group: a question and 2 to 10 short options (multiple for several choices, closesAt to end voting on time). Connected Telegram groups get it as a Telegram poll; members vote in the app, through their AI or in Telegram. Example: "make a poll in the group about where to eat on Friday: ramen, sushi or izakaya". For options "from the context", read get_context and offer the real options it lists.
create_proposal
ChatGPTProposes an option to the group (a hotel, a date, a plan) with an optional structured data object (price, link, dates). Members accept or reject it later.
create_reminder
ChatGPTReminds one member (targetUserName or targetUserId) or the whole group at dueAt (ISO 8601 with the UTC offset; get_space gives the space's timeZone). repeat daily or weekly; requestId skips it once that request is answered. It arrives as a notification and in the Telegram groups. Example: "remind Max on Friday at 10 to book the car" → create_reminder with targetUserName "Max" and dueAt in the space's zone.
create_request
ChatGPTSends a question or task to one member (targetUserName or targetUserId) or the whole group (omit both). Use it when the user says "ask Max whether…" or "check with everyone if…". Example: "Ask Max whether the April dates work for him" → create_request with targetUserName "Max", a short title and the details in body. targetUserName matches a member's name case-insensitively; if it is ambiguous the tool lists the candidates: ask the user, then pass targetUserId.
get_artifact
ChatGPTOne saved note, link or file by id (art_…), with its full text: for ids a note, an index or the user names. A file comes with its openUrl.
get_context
ChatGPTReads the space's shared context document (markdown: dates, budget, preferences, agreements) and its version. Read it before answering or proposing on the user's behalf. Pass the returned version as expectedVersion to update_context.
get_request
ChatGPTOne request with all its responses. The user may paste an id like req_k3j9x0c2m1p8q7r4. Typical prompt: "Review SharedAI request req_812".
get_snapshot
ChatGPTOne read for merging what this chat knows into a space: shared context with its version, members, decisions, open proposals, requests waiting for the user and saved artifacts. Then update_context. Use it when the user says "sync" or wants this chat's plans in the space. Merge without dropping what is there, show the user what changes, and call update_context only after their OK.
get_space
ChatGPTOverview of one space: members (with user ids), shared context, requests waiting for the user, open proposals, latest decisions and recent activity. Use it to orient and to find members by name. Address members from this list.
list_artifacts
ChatGPTNotes, links and files members saved to a space, newest first. A file comes with title, note and openUrl, the SharedAI page where the user opens it; its contents are readable only when the uploader set aiAccess. Files are uploaded in the SharedAI app.
list_decisions
ChatGPTDecisions the group recorded in a space, newest first. Typical prompts: "what did we decide", "is the hotel booked".
list_inbox
ChatGPTThe user's notifications: requests received, answers to their requests, new or decided proposals, new members. Use unreadOnly for "anything new for me".
list_pending_requests
ChatGPTRequests other members sent to the user (or to the whole group) that still wait for an answer, across all spaces or one space. Typical prompts: "what do I need to answer", "did anyone ask me something", "review pending SharedAI requests". Follow with get_request, get_context, then respond_to_request.
list_polls
ChatGPTPolls in a space with options, vote counts, who voted for what and the user's own choices. Use status "open" for "what are we voting on".
list_proposals
ChatGPTProposals in a space (options someone suggested to the group), optionally filtered by status.
list_recent_activity
ChatGPTWhat happened recently in one space or all the user's spaces, newest first: who asked, answered, proposed or decided what, and through which AI. Use it for "what's new". Typical prompts: "what's new", "did Max answer", "catch me up on the trip".
list_reminders
ChatGPTUpcoming reminders in a space, soonest first, with their local time, who they are for and who set them.
list_requests
ChatGPTEvery request in one space, newest first, optionally filtered by status (pending, answered, cancelled): who asked whom what, and the answers. For the ones waiting for the user use list_pending_requests. Typical prompts: "what have we asked each other", "did anyone answer the ryokan question".
list_spaces
ChatGPTLists the user's spaces (shared groups such as a trip or project) with member counts and how many requests wait for the user. Call this first when you do not know the spaceId. Typical prompts: "what's in SharedAI", "my groups", or any mention of a group by name ("the Japan trip").
prepare_action
ChatGPTValidates a write action without running it and returns a link (valid 15 minutes) the user opens to confirm it with one tap in SharedAI. Use it when write tools are unavailable or fail in this client. action is a write tool name; input are that tool's arguments (targetUserName works for create_request). Show the confirmUrl to the user and say nothing is done until they confirm.
respond_to_request
ChatGPTAnswers a request addressed to the user or to the group, in the user's name. Read get_request and get_context first; answer only what the user agreed to or asked you to say.
update_context
ChatGPTReplaces the space's shared context document. Read get_context first, edit the full text, and pass its version as expectedVersion; on version_conflict read again and merge. Every version is kept in the space's history; note says why this one exists. Pass note for anything beyond a small edit, e.g. "tidy: merged duplicate hotel notes" or "sync from chat".
update_proposal
ChatGPTAccepts or rejects a proposal; accepting records a group decision. First ask the user and get an explicit yes, then call with confirmed: true. Without it the call fails. Runs only after the user's explicit yes in this conversation.
whoami
ChatGPTReturns the SharedAI account (name, email) this assistant acts for and the detected AI client. Use it when the user asks which account is connected, or before writing if unsure who the user is.