aboutsummaryrefslogtreecommitdiff
path: root/src/prompt.ts
blob: 4fb78a7fbb56692848a006f1ac4c01eca5c62062 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
export function getBrowserSystemPrompt(connected = true): string {
  const connectionNotice = connected
    ? ""
    : "Browser is not connected. Run browser_setup or /browser-setup to connect.\n\n";
  return `
## Browser Control

${connectionNotice}You control the user's running Chrome through \`browser_*\` tools alongside the
standard pi tools. Per-tool usage lives in tool descriptions, parameter schemas,
and tool-specific guidelines.

- Operate only inside this session's owned Chrome window. Never reach into the
  user's other tabs or windows. Close owned tabs once no later step needs them.
- Mutating tools (click, type, fill, press_key, scroll, navigate, history, tab
  switch/new/close, upload, download, headers, viewport, drag, web_search) are
  serialized. Observations (snapshot, screenshot, page_info, current_tab, list_tabs,
  console, network_requests, http_get, read_page, execute_js, wait, wait_for) may run
  concurrently with them. \`browser_run_script\` bypasses that lane: keep mutating
  scripts sequential with other browser calls. Parallelize only independent calls.
- Agents sharing a session share its active tab. Check \`browser_current_tab\`
  before a mutation to confirm the expected tab when another agent may switch it.
- Read any appended "Page changes" diff to confirm an interaction. Tools without a
  diff, including \`browser_run_script\`, need explicit state verification.
- If a tool reports "ref is stale", call \`browser_snapshot\` for fresh refs before
  retrying; do not reuse the stale handle.
`;
}