Skip to content

extension_network ​

Stub a network response on a Chromium session: add a rule, list or clear the rules, or read which requests hit one or missed.

Quick start ​

Make the API answer 500 and show me what the popup renders

How the agent uses it ​

Rules last until extension_stop. Firefox is refused.

Page text in the answer ​

Part of this tool's answer is text a web page or the extension wrote. The server fences it between <untrusted-data-ID> and </untrusted-data-ID> with a fresh random ID per call, named in untrusted.boundary. A fence is a signal to the model, not a gate: pair it with --no-ship when the agent reads pages you do not trust. See Server flags and telemetry.

Reference ​

Groupextras, off unless named: on with --features=local,platform,extras or --features=local,extras
TierTest
Needsthe server started with extras in --features, as in --features=local,platform,extras; a live dev or start session on a Chromium browser
Read onlyno
Destructiveno
Idempotentno
Reaches the open webno

Inputs ​

InputTypeRequiredDefaultWhat it does
projectPathstringyesProject root of a running session: extension_dev, extension_start, or npx extension dev|start by hand
action"add" | "list" | "clear" | "requests"yesrequests: the requests seen.
methodstringnoadd: HTTP method; default ANY.
urlstringnoadd: exact URL, or a glob with * and ?.
statusnumberno200add: HTTP status to answer.
bodystringnoadd: response text.
jsonanynoadd: response as a JSON value; not with body.
contentTypestringnoadd: Content-Type; default by body or json.
browserstringnoSession browser; required when several run.

When it fails ​

  • The call is refused because no session is live. Start one with extension_dev or extension_start and call again.
  • The tool is missing from the client's list, or the call answers E_TOOL_DISABLED. The extras group is off unless named. Start the server with --features=local,platform,extras, or --features=local,extras without the platform tools; see Server flags and telemetry.

Next ​