BCD — Bridge Control Delegate

Copy a file or directory, keeping the source intact. Never overwrites or merges an existing destination and does not follow symbolic links. Up to 2 GB/10000 entries. Returns copyId immediately; poll copy_status with the same workSessionId for byte/file progress and completion. An interrupted copy may leave a partial destination; inspect it before retrying.

copy_path

Read an explicit copy job’s progress, outcome and undo changeId. Use the original workSessionId. The source is never removed; failed or interrupted jobs are never replayed automatically.

copy_status

Create a separate work session for this AI conversation and a unique workspace folder. Keep the returned workSessionId and pass it on every subsequent call, including process output and undo. Sessions unused for 30 days (or the least recently used, past 500) are forgotten; their folders stay. Relative file paths and commands without cwd use that workspace; ~ still means home. This separates activity and process control, not access to shared absolute paths or the physical browser.

create_work_session

Delete this caller’s saved definition by workflowId. Existing run records and output files remain available.

delete_workflow

Show what takes up disk space in a folder without changing anything: the size of each item directly inside it, largest first, and the folder's total (allocated space, as du counts it). Call it again on a large item to look inside. A very large folder may stop after 90 seconds with complete: false and the items finished by then.

disk_usage

Edit a file in place: replaces old_string with new_string, which must occur exactly expected_replacements times (default 1); include nearby lines to make it unique. Spreadsheets: range (e.g. Sheet1!A1:C3) and a 2D content array. DOCX: exact XML (for text across formatting use edit_docx). On a mismatch nothing changes and the closest match is shown.

edit_block

Edit cells or ranges, or append rows, in an Excel workbook (xlsx, xlsm, xls) into a new outputPath, keeping the original. Keeps styles, charts, images, merged cells, tables and VBA (never run); formulas recalculate where supported. Use it when edit_block refuses an in-place edit. Reports what was preserved.

edit_spreadsheet

Replace exact text in a Word .docx even where it spans formatting runs, writing a new outputPath (the original is kept). oldText must occur expectedOccurrences times (default 1). part: body (default), header, footer or all. mode xml replaces XML copied from read_file docxMode xml. Images, fields and untouched parts are preserved; signed files are refused.

edit_docx

List retained file changes in this work session, newest first, with changeId and undo availability. Tracks file/document writes, edits, moves and explicit copies, bounded to 100 changes/250 MB/30 days per caller (older ones are dropped first). Shell commands, deletes and untracked/oversized changes cannot be undone.

list_file_changes

List computers currently connected to your BCD account, with their names, permissions and which one is the default. Pass a name or id as deviceId to other tools.

list_devices

List a folder: one "[DIR] name" or "[FILE] name" line per entry, depth-first. depth 2 (default) includes subfolder contents (first 100 each); depth 1 lists only the folder itself.

list_directory

List start_process sessions, newest first, including ones from earlier connections: id, status, exit code and whether each is waiting for input.

list_process_sessions

List bounded process metadata for processes owned by the current user. Command arguments are omitted.

list_processes

List this caller’s work sessions on this computer, so a conversation can resume with its workSessionId after reconnecting.

list_work_sessions

Give the user a link to watch one of their computers' screen live and take control of it themselves: to sign in, pass a CAPTCHA, approve a payment or anything else only they should do. Signed in to BCD, they see the screen a few times a second and, after Take control, click and type on it; what they type there never reaches you. Wait until they say they are done, then take a screenshot to see where things stand. Works on Macs; needs the computer's Live screen permission, which only its owner can turn on.

screen_view

For BCD's live screen view only: a one-time socket address for watching and controlling one of the user's own computers.

screen_session

Create a folder and any missing parents. An existing folder is fine.

make_directory

Move or rename files and folders. Creates missing parent folders and never overwrites an existing destination. To move many items (organizing a folder), pass moves: up to 200 {from, to} pairs in one call; each item is reported.

move_path

File or folder details: size, modified/created times, mode, text line count and appendPosition, or spreadsheet sheet sizes. Returns JSON. A missing path is an error unless missingOk is true; to check whether a path exists, pass missingOk: true and read exists.

stat_path

Type text into a start_process session (a newline is added unless newline is false). With waitMs or waitForPrompt, returns the output that follows as JSON.

process_input

Read the output and status of a start_process session. newOnly returns only output since the last newOnly read; waitMs waits for new output or exit; waitForPrompt waits until it asks for input (heuristic). Default: the last tailChars of output. Returns JSON with running, exitCode, output, nextCursor and interactionState.

process_output

Read text from the computer's clipboard.

read_clipboard

Read a file. Text: offset is the zero-based first line and length the line count (default 1000); a negative offset reads the last N lines. Returns a "[Reading N lines from … (total: T lines, R remaining)]" header, then the text. Also reads images (as images), PDF (offset/length count pages; options.ocr auto|force|off, Korean/English OCR), DOCX (outline; docxMode text|outline|xml) and spreadsheets (sheet, range: 2D values). For web pages use read_url.

read_file

Read up to 20 files in one call, each under its own path header with its own error if it fails. Same formats as read_file; offset/length apply to every file.

read_multiple_files

Read a public web page or HTTP(S) URL: HTML comes back as readable text, JSON/XML/text as is. offset/length select lines. Sends no cookies or credentials and reads at most 1 MB. Refuses private and local network addresses; a device with a public IPv6 address counts as public.

read_url

Delete a file or folder (recursive: true for a folder with contents). It cannot be undone: use it only when the user asked for the deletion.

remove_path

Review the exact steps and parameters of a saved workflow before rerunning it.

get_workflow

Run a shell command as the signed-in user and return its combined stdout/stderr, ending with [exit=N]. A command still running after 50 s keeps running as a process session until timeoutMs (default 120 s) and the reply gives its id for process_output and stop_process; for longer jobs use start_process. For commands that wait for input, use start_process. Reading, listing, searching and editing files also have their own tools with structured results: read_file, list_directory, search_files, search_content, edit_block and write_file; checking the computer, folder sizes and running programs have read-only ones: system_info, disk_usage and list_processes.

run_command

Start one run of a saved workflow with inputs, using the selected workSessionId. Its steps, which get_workflow shows, are calls to the file, document and command tools save_workflow lists, made in order through the same tools and folder checks as calling each one directly. Pass expectedVersion from get_workflow to refuse a definition changed since review. Validates every step before any run; stops on the first error. Requires read, write and process permissions. Returns runId; poll workflow_status, or stop it with cancel_workflow. Completed steps are not rolled back or replayed automatically. Commands are bounded by their normal timeout.

run_workflow

Save 1–20 ordered steps on this computer, to rerun later with run_workflow; saving runs nothing. Each step is one call to a tool listed here (read_file, read_multiple_files, list_directory, search_files, search_content, stat_path, write_file, edit_block, make_directory, move_path, copy_path, write_pdf, edit_spreadsheet, edit_docx, run_command) with that tool's own arguments, so a run does only what those calls do on their own. Use {{inputName}} in file arguments to supply new values later; commands must be fixed text. Definitions and inputs are stored locally, not in the relay: do not put secrets in them. Saving sets no schedule; schedule_workflow, where listed, runs a saved workflow on one. With an existing workflowId it replaces that definition (only this caller’s), and the earlier steps are not kept.

save_workflow

List this caller’s reusable workflows saved on this computer, including input names. Definitions survive reconnects and restarts and can run in a new work session.

list_workflows

Capture the computer's screen as a JPEG image (format png for lossless). On a Mac it needs Screen Recording permission. For web pages in the connected browser, browser_snapshot is cheaper.

screenshot

Find text inside files: query is literal, or a JavaScript regular expression matched per line with regex true, searched recursively under path (a folder or one file), skipping hidden files, .git and node_modules unless includeHidden. filePattern limits it to matching files, a glob like *.js. Returns JSON matches with file, line number and line text; contextLines adds lines around each.

search_content

Find files and folders by name: case-insensitive substring of the name, or a glob on the whole name when query has * or ? (e.g. *.js, report-??.pdf), searched under path (default the work session workspace, or ~ without a session). Returns a JSON array of full paths (maxResults, default 100). Stops after 8 seconds; on macOS a folder too large to scan in time is answered from the Spotlight index, elsewhere with the results found so far and scanComplete false, so give the most specific folder you can.

search_files

Send the user's feedback about BCD to the BCD team: a bug, a feature request, or what works well. Use it when the user asks to report something to BCD, or accepts your offer to. Write the message in the user's words and include only what they want to send; never include file contents, credentials or personal data they did not ask to share.

send_feedback

Start a long-running or interactive command in the background (dev servers, long builds, REPLs, anything over 2 minutes) and return its session id as JSON. timeoutMs or waitForPrompt also waits for first output. Then process_output reads it, process_input types into it and stop_process stops it. The process keeps running past timeouts and reconnects.

start_process

Stop a start_process session with TERM (force: KILL). waitMs waits for it to exit and returns its final status.

stop_process

Describe this computer without changing anything: its name, model, operating system, processor, memory, the free space of the home volume and uptime, plus the folders BCD may use. Use it instead of running commands to check what the computer is.

system_info

Undo one retained file edit/write, move or copy by changeId. Pass the original workSessionId. Refuses if the contents changed afterward, the original move location is occupied, or a crash left the outcome unknown. Does not undo terminal commands or permanent deletions.

undo_file_change

Show the selected conversation’s workspace, active tool calls and recent workflow runs. Requires workSessionId; other conversations’ activity is excluded.

get_work_session