Function generateInstructionBlock

browse/src/cli.ts:663–754

(opts: InstructionBlockOptions)

/** Pure function: generate a copy-pasteable instruction block for a remote agent. */
export function generateInstructionBlock(opts: InstructionBlockOptions): string {
  const { setupKey, serverUrl, scopes, expiresAt } = opts;
  const scopeDesc = scopes.includes('admin')
    ? 'read + write + admin access (can execute JS, read cookies, access storage)'
    : 'read + write access (cannot execute JS, read cookies, or access storage)';

  return `\
${'='.repeat(59)}
 REMOTE BROWSER ACCESS
 Paste this into your other AI agent's chat.
${'='.repeat(59)}

You can control a real Chromium browser via HTTP API. Navigate
pages, read content, click buttons, fill forms, take screenshots.
You get your own isolated tab. This setup key expires in 5 minutes.

SERVER: ${serverUrl}

STEP 1 — Exchange the setup key for a session token:

  curl -s -X POST \\
    -H "Content-Type: application/json" \\
    -d '{"setup_key": "${setupKey}"}' \\
    ${serverUrl}/connect

  Save the "token" value from the response. Use it as your
  Bearer token for all subsequent requests.

STEP 2 — Create your own tab (required before interacting):

  curl -s -X POST \\
    -H "Authorization: Bearer <TOKEN>" \\
    -H "Content-Type: application/json" \\
    -d '{"command": "newtab", "args": ["https://example.com"]}' \\
    ${serverUrl}/command

  Save the "tabId" from the response. Include it in every command.

STEP 3 — Browse. The key pattern is snapshot then act:

  # Get an interactive snapshot with clickable @ref labels
  curl -s -X POST \\
    -H "Authorization: Bearer <TOKEN>" \\
    -H "Content-Type: application/json" \\
    -d '{"command": "snapshot", "args": ["-i"], "tabId": <TAB>}' \\
    ${serverUrl}/command

  The snapshot returns labeled elements like:
    @e1 [link] "Home"
    @e2 [button] "Sign In"
    @e3 [input] "Search..."

  Use those @refs to interact:
    {"command": "click", "args": ["@e2"], "tabId": <TAB>}
    {"command": "fill", "args": ["@e3", "query"], "tabId": <TAB>}

  Always snapshot first, then use the @refs. Don't guess selectors.