Bridge

Read the exposure status of already declared repository preset tools, including effective default/advanced profile and catalog limits. An absent optional project file is not an authorization failure. This grants no repository access and never executes a preset. Ordinary Host and file operations remain available when repository integration is unavailable.

bridge.repository_tools_status

Permanently delete one existing, owned permanent Bridge file. The current backend only permits this operation for previously stored permanent files; temporary imports/exports expire under their own retention rules. This does not delete files on a Host or erase execution receipts. Confirm the exact asset before deletion.

bridge.delete_file

Apply bounded text edits to existing tracked files on an allowed existing target branch, then execute the effective trusted profile verification. The default profile permits existing agent/** or codex/** edit branches and runs patch-integrity only (git diff --check, projectTestsRun=false); this does not prove project tests passed. Project and host policy must permit the exact paths, runner identity and limits; protected configuration paths cannot be edited. Verification cannot be omitted or selected by the caller. Returns a VERIFIED candidate only when trusted checks succeed. Changes are not published by this tool; publish is a separate explicit operation. A stale profile or invalid advanced recipe fails closed.

bridge.edit_and_verify_repository

After persisting the matching durable GitHub checkpoint or blocker, atomically release the active task stage as READY, BLOCKED or DONE. An active fenced task session is required. READY and DONE require the exact checkpoint SHA and state-comment ID. BLOCKED requires only its stable reason code. Only READY can request continuation to another stage.

bridge.task_transition

Retrieve bounded evidence for one owned completed run or READY transferred file. Temporary output files may include principal-bound MCP resource links; use only actual returned links and expiry. In a durable task session this also renews its lease. RESULT_NOT_READY means inspect/wait for the same run, not submit it again. Expired files do not erase retained command evidence.

bridge.get_result

Retrieve the owned run's normalized state and exact identity without re-executing it. Supports Host commands, temporary file transfers and GitHub engineering tasks. In a durable task session this also renews the active stage lease. Queued/running is not success, and an interrupted read does not cancel the submitted work.

bridge.get_run

Import one actual ChatGPT attachment through the native file parameter into the authenticated account's temporary private transfer store. Use its returned asset ID as a managed Host input. Public HTTPS file-delivery domains need no per-domain configuration; private network targets, URL credentials and nonstandard ports are rejected. Files are at most 25 MiB; native imports normally expire after 24 hours. Use the returned expiry and never invent a download URL.

bridge.import_file

Inspect the authenticated account's existing service entitlement, available usage allowance and usage records only when the user explicitly requests existing account usage or entitlement. Do not invoke this tool for a purchase, payment or checkout request, or to route the user to buying; directly explain that buying is outside the plugin. This does not purchase service credits, initiate payment, accept a rate, create checkout links or charge a card. The caller cannot supply another account, price, balance or payment details. A service restriction is not a successful task.

bridge.account_usage

Read the effective Bridge profile at the trusted default-branch SHA for one explicitly chosen authorized GitHub repository. An absent .bridge/project.json selects the versioned default profile; a present advanced file remains authoritative. Report the actual policy ref/SHA, runner classes and configured execution/editing controls. This is configuration inspection, not proof that a runner is online or that a job succeeded. Missing GitHub connection, saved selection or permission remains an error. A profile does not prove workflow, runner or host readiness; report unchecked prerequisites honestly.

bridge.get_repository_configuration

List the authenticated account's registered Bridge Hosts and reported execution state. Registration alone does not prove a live connection. Returns logical Host IDs, never physical filesystem roots. No repository or GitHub authorization is required.

bridge.list_hosts