Report whether the Recordful extension is connected and what the recorder is doing (idle, starting, recording, paused), the selected recording mode, the active tab, and which capture permissions are granted. Safe to call any time.

Start a Recordful recording on the target tab using the user's saved Recordful settings (mode, microphone, camera, countdown). Resolves once capture is live, or reports why it could not start. Navigate to the page you want to show before calling this.

Stop the current Recordful recording. Recordful then opens its editor with the recording, exactly as when the user clicks Stop. Returns where it went: recording.kind "cloud" (Recordful Pro: already uploading, with its videoId and links) or "local" (saved on this computer as takeId; upload_recording uploads it), plus the markers add_marker placed.

Pause the current recording. Use it while you plan the next step so the video has no dead air. No-op if already paused.

Resume a paused recording. No-op if not paused.

Mark this moment of the running recording with a short label ("signed in", "error shown"). It is timed on the video clock, pauses left out, and stop_recording returns every marker as { atMs, label }, so you can point the user to moments or edit around them later.

Diagnostic: check, without recording, whether the extension can capture the target tab right now with no user click, and which optional Chrome permissions are granted. Refuses while a recording is running.

Open an http(s) URL in the tab the user handed to Recordful and wait for it to load. Returns the final URL and title. Refs from earlier snapshots stop working.

List the interactive elements (links, buttons, fields, checkboxes, tabs, menu items) and headings in the recorded tab, each with a ref to pass to click/type/scroll/wait_for, its role, accessible name, current value or state, and bounding box in CSS pixels. Refs stay the same for an element while it stays on the page.

Move Recordful's visible cursor to the element, scrolling it into view if needed, and click it, with a click highlight in the video. Reports a navigation the click started. Fails with ELEMENT_OBSCURED (naming what is on top, with its ref) if something covers it.

Click the field, then type the text at a human pace (text inputs, text areas, content-editable areas). Set clear to replace what is already there. Use press for Enter, Tab and other keys.

Press a key in the focused element, e.g. Enter to submit a form, Tab to move focus, Escape to close a dialog, ArrowDown in a menu, Shift+Tab, Control+a. Recordful also performs the key's usual effect (submitting, moving focus, deleting), since pages ignore synthetic keys otherwise.

Scroll smoothly: either bring an element (ref) into view, or scroll the page in a direction, by amount pixels or most of a screen.

Wait until text appears on the page or an element (ref) becomes visible, or with state "hidden" until it goes away. Keeps waiting across navigations. Fails with WAIT_TIMEOUT if it doesn't happen in time.

Capture what the recorded tab shows right now, as an image, to check the page looks right. The tab must be the active tab of its window.

List the recordings saved on this computer (newest first): each takeId, size, when it was recorded, and its videoId if it was uploaded. Recordings made while signed in to Recordful Pro go straight to the cloud instead; see list_videos.

Recordful Pro only (check get_status recorder.account.plan first). Upload a local recording to recordful.app and, by default, wait until the upload finishes. Defaults to the last recording. Returns the videoId and its view and edit links. A recording made in the cloud is already uploading, so this just returns it. Then get_transcript reads it back.

A Recordful video's title, length, who may watch it, its view and edit links, and its upload stage: "uploading" → "processing" → "ready". With wait, keeps checking until it's ready. Defaults to the last recording.

List the user's videos on recordful.app, newest first: videoId, title, date, length, who may watch, and links. Optionally filter by title.

Recordful Pro only (check get_status recorder.account.plan first). Read back what was said in a Recordful video. Starts transcribing if it hasn't been yet, and by default waits until it's done, including for an upload still in progress. format: "text" (default), "vtt" (timed captions), or "both". Defaults to the last recording; a recording only on this computer must be uploaded first (upload_recording).

Recordful Pro only (check get_status recorder.account.plan first). Change a video's title and/or who may watch it: "private" (only the user), "workspace" (their team) or "public" (anyone with the link). Show the user exactly what you will change and wait for their yes first. Defaults to the last recording. Only the person who recorded it, or the workspace owner, can.

Recordful Pro only (check get_status recorder.account.plan first). Permanently delete a video and its files from recordful.app. This can't be undone, and there is no default video: name it. Ask the user to confirm this exact video (title and link) first, then call with confirm: true.

Recordful Pro only (check get_status recorder.account.plan first). What viewers did with a video: its view count, likes, and every comment (oldest first, with author and time). Read-only. Defaults to the last recording.

Recordful Pro only (check get_status recorder.account.plan first). Post a comment on a video as the signed-in user. It is public to everyone who can watch the video. Show the user exactly what you will change and wait for their yes first. Pass the comment exactly as the user approved it. Defaults to the last recording.

Recordful Pro only (check get_status recorder.account.plan first). Like a video as the signed-in user (liked: false removes it). Returns the new like count. Defaults to the last recording.

Recordful Pro only (check get_status recorder.account.plan first). The user's folders on recordful.app: folderId, name, parentId (null at the top level) and whether it's shared. list_videos shows each video's folderId.

Recordful Pro only (check get_status recorder.account.plan first). Create a folder, at the top level or inside another folder. Show the user exactly what you will change and wait for their yes first.

Recordful Pro only (check get_status recorder.account.plan first). Move videos into a folder (folderId null moves them to the top level). Moving into a shared folder shares them, except private videos. Show the user exactly what you will change and wait for their yes first. Videos the user can't manage come back as skipped.

Recordful Pro only (check get_status recorder.account.plan first). How much of the user's Recordful cloud storage is used (bytes, percent) and whether more can be uploaded. Read-only.