Upsy

Lists the user's Gmail labels (their own and system ones like INBOX, STARRED, IMPORTANT).

email_labels

Lists the user's documents (CV, ID scans, contracts, …) and the files you saved earlier, with their ids.

files_list

The Slack channels, group DMs and DMs the user is in, with ids for slack_read_channel, and the names of DMs' people (users). JSON.

slack_list_channels

Moves Gmail emails to the trash. Gmail deletes them for good after 30 days; until then they can be restored. Only trash what the user asked for.

email_trash

Opens a web page in the user's cloud browser, which is logged in to the user's sites: for websites Upsy has no tools for, like checking an order or a booking. For email, calendar, Slack, Drive and the apps in app_tools, use their tools instead. Your first page opens a new tab of yours (grouped under your name); later ones reuse your current tab unless newTab. back: true goes back a page. Returns a snapshot of the page: its text and elements, with refs for browser_click, browser_type and browser_select. No code needed.

browser_navigate

Picks an option of a dropdown (a <select>) in your tab, by its text. For other menus, click the menu, then the option. Returns the page after.

browser_select

Presses a key in your tab, e.g. Enter, Escape, Tab, ArrowDown, or a shortcut like Control+Enter. It goes to the focused element. Returns the page after.

browser_press_key

A Slack channel's or DM's messages, newest first, with each message's ts (for slack_read_thread and replies), author, and reply_count when it has a thread, plus the names of the people in them (users). JSON.

slack_read_channel

A person's Slack profile: name, display name, title, email, timezone and status. Without user_id, the user's own. JSON.

slack_read_user_profile

A Slack thread: the message it started from, then its replies, oldest first, with the names of the people in it (users). JSON.

slack_read_thread

Returns every message in a Gmail thread (thread id from search_threads or get_message), oldest first.

email_read_thread

Returns a file's extracted text (paged with `offset`) and a short-lived download URL for the original, e.g. to attach it somewhere.

files_read

The page in your tab of the user's browser as it is now: its text and elements, with refs for browser_click, browser_type and browser_select.

browser_snapshot

Returns the user's memory: one markdown document they wrote about themselves (who they are, preferences, family, work, …). Read it at the start of a task to personalize it, and before asking the user for details they may have saved (addresses, preferences, names).

memory_read

Moves Gmail emails out of the trash, back where they were.

email_untrash

Saves a file you produced (report, itinerary, summary, …) into your own folder in the user's Upsy. The user sees it under Agent files; other agents don't. Pass `content` for text or `content_base64` for binary files. Max 2.9 MB.

files_upload

Scrolls the page in your tab by most of a screen, with the mouse wheel; with a ref, the part of the page that element is in. For pages that load more as you scroll. Returns the page after.

browser_scroll

Searches the user's Gmail conversations with Gmail search syntax, e.g. "in:sent" or "from:alice newer_than:7d". Returns JSON: threads, each with its messages (id, threadId, labelIds, sender, to, cc, subject, date, snippet).

search_threads

Searches every Slack message and DM the user can see, e.g. "launch plan" or "what did Ada say about pricing". Returns matches with channel, ts, author, text and permalink. JSON. This is the user's own Slack, connected to Upsy.

slack_search_messages

Searches the user's own documents (CV, passport and ID scans, contracts, invoices, …) and the files you saved, by meaning. Look here when a task needs one of their documents or personal details, e.g. to fill in a form. Returns matching files with a snippet.

files_search

A screenshot of what your tab of the user's browser shows, for when the look matters (images, charts, layout). Brings the tab to the front.

browser_screenshot

Sends an email from the user's Gmail: a new one (to, subject, body, and optionally cc and htmlBody; replyToMessageId to reply in its thread), or a draft by draftId (from create_draft). Only send what the user asked for. Returns JSON with the sent message's id.

send_message

Sends a message as the user to a channel, or to a person's DM with their user id. thread_ts replies in that thread; reply_broadcast also shows the reply in the channel. Uses Slack's mrkdwn (*bold*, <@U…> mentions). Only send what the user asked for. Returns the message's channel, ts and permalink. JSON. This is the user's own Slack, connected to Upsy.

slack_send_message

Sends an existing Gmail draft as it is. Only send what the user asked for.

email_send_draft

Suggests adding something to the user's memory, e.g. a lasting preference they just told you. Nothing changes until the user accepts it in their Upsy. Write one short sentence in the user's voice or as a fact about them.

memory_suggest

Types text into a field of the page in your tab (an input, a text area or an editor), with the keyboard, replacing what's in it. submit: true presses Enter after. Returns the page after.

browser_type

Changes Gmail emails: mark read or unread, star or unstar, mark important, move back to the inbox, or add and remove labels by name (see email_labels). New label names are created. To archive, use email_archive.

email_update

The user's connectors in Upsy and what you may do with each: nothing yet. Returns each account's address, your access (All, Read-only, some tools only, or not allowed) and the tools that reach it. The user changes access in Upsy.

upsy_connectors

Lists your tabs in the user's browser (the ones you opened), marking your current one. close: a tab to close first.

browser_tabs