@agentruntime-labs/browser-agent 0.1.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (161) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +6 -0
  3. package/README.md +64 -34
  4. package/bin/browser-agent.js +1 -0
  5. package/cli/control.mjs +477 -0
  6. package/cli/daemon.mjs +143 -0
  7. package/cli/hosts.mjs +1 -0
  8. package/cli/main.mjs +24 -0
  9. package/cli/mcp.mjs +1 -0
  10. package/docs/ARCHITECTURE.md +73 -0
  11. package/docs/DESKTOP_MCP.md +41 -0
  12. package/docs/EXTENSION_MANIFEST.md +163 -0
  13. package/docs/HYBRID.md +12 -0
  14. package/docs/MANAGED_BROWSER.md +111 -0
  15. package/docs/MCP_TOOLS.md +486 -0
  16. package/docs/MESSAGES.md +272 -0
  17. package/docs/MVP.md +76 -0
  18. package/docs/PRIVACY_POLICY.md +50 -0
  19. package/docs/README.md +27 -0
  20. package/docs/REFERENCE_PROJECTS.md +24 -0
  21. package/docs/RELEASE_CHECKLIST.md +49 -0
  22. package/docs/REPEATED_DOCS.md +27 -0
  23. package/docs/SAFETY.md +92 -0
  24. package/docs/SHELL_QUOTING.md +30 -0
  25. package/docs/SPLIT_REPOS.md +46 -0
  26. package/docs/THIRD_PARTY_LICENSES.md +182 -0
  27. package/docs/VISION.md +38 -0
  28. package/docs/WEB_STORE_SUBMISSION.md +117 -0
  29. package/extension/approval.js +1 -0
  30. package/extension/assets/agentruntime-logo.svg +77 -0
  31. package/extension/assets/agentruntime-mark-512.png +0 -0
  32. package/extension/background.js +776 -62
  33. package/extension/cdp.js +577 -0
  34. package/extension/constants.js +1 -0
  35. package/extension/content.js +69 -9
  36. package/extension/devtools-grant.html +31 -0
  37. package/extension/devtools-grant.js +29 -0
  38. package/extension/icons/icon128.png +0 -0
  39. package/extension/icons/icon16.png +0 -0
  40. package/extension/icons/icon32.png +0 -0
  41. package/extension/icons/icon48.png +0 -0
  42. package/extension/manifest.json +50 -23
  43. package/extension/policy.js +102 -0
  44. package/extension/popup.html +190 -56
  45. package/extension/popup.js +376 -166
  46. package/extension/soft.js +301 -0
  47. package/extension/welcome.html +91 -0
  48. package/extension/welcome.js +13 -0
  49. package/package.json +6 -2
  50. package/server/dist/arBrowserPaths.d.ts.map +1 -1
  51. package/server/dist/arBrowserPaths.js +1 -0
  52. package/server/dist/arBrowserPaths.js.map +1 -1
  53. package/server/dist/automationBackend.d.ts +46 -0
  54. package/server/dist/automationBackend.d.ts.map +1 -0
  55. package/server/dist/automationBackend.js +20 -0
  56. package/server/dist/automationBackend.js.map +1 -0
  57. package/server/dist/automationSession.d.ts.map +1 -1
  58. package/server/dist/automationSession.js +1 -0
  59. package/server/dist/automationSession.js.map +1 -1
  60. package/server/dist/bridge.d.ts +17 -4
  61. package/server/dist/bridge.d.ts.map +1 -1
  62. package/server/dist/bridge.js +132 -33
  63. package/server/dist/bridge.js.map +1 -1
  64. package/server/dist/browserToolsExtras.d.ts +2 -2
  65. package/server/dist/browserToolsExtras.d.ts.map +1 -1
  66. package/server/dist/browserToolsExtras.js +70 -1
  67. package/server/dist/browserToolsExtras.js.map +1 -1
  68. package/server/dist/cdpTools.d.ts +5 -0
  69. package/server/dist/cdpTools.d.ts.map +1 -0
  70. package/server/dist/cdpTools.js +411 -0
  71. package/server/dist/cdpTools.js.map +1 -0
  72. package/server/dist/compositeTools.d.ts +2 -2
  73. package/server/dist/compositeTools.d.ts.map +1 -1
  74. package/server/dist/compositeTools.js.map +1 -1
  75. package/server/dist/debugSnapshot.d.ts +2 -2
  76. package/server/dist/debugSnapshot.d.ts.map +1 -1
  77. package/server/dist/debugSnapshot.js.map +1 -1
  78. package/server/dist/guardrails.d.ts.map +1 -1
  79. package/server/dist/guardrails.js +1 -0
  80. package/server/dist/guardrails.js.map +1 -1
  81. package/server/dist/humanLike.d.ts.map +1 -1
  82. package/server/dist/humanLike.js +1 -0
  83. package/server/dist/humanLike.js.map +1 -1
  84. package/server/dist/main.js +56 -15
  85. package/server/dist/main.js.map +1 -1
  86. package/server/dist/managedBridge.d.ts +58 -0
  87. package/server/dist/managedBridge.d.ts.map +1 -0
  88. package/server/dist/managedBridge.js +619 -0
  89. package/server/dist/managedBridge.js.map +1 -0
  90. package/server/dist/managedDom.d.ts +58 -0
  91. package/server/dist/managedDom.d.ts.map +1 -0
  92. package/server/dist/managedDom.js +310 -0
  93. package/server/dist/managedDom.js.map +1 -0
  94. package/server/dist/policyTiers.d.ts.map +1 -1
  95. package/server/dist/policyTiers.js +3 -1
  96. package/server/dist/policyTiers.js.map +1 -1
  97. package/server/dist/protocol.d.ts +4 -0
  98. package/server/dist/protocol.d.ts.map +1 -1
  99. package/server/dist/protocol.js +1 -0
  100. package/server/dist/protocol.js.map +1 -1
  101. package/server/dist/recorder.d.ts +22 -0
  102. package/server/dist/recorder.d.ts.map +1 -0
  103. package/server/dist/recorder.js +82 -0
  104. package/server/dist/recorder.js.map +1 -0
  105. package/server/dist/richEditorFill.d.ts.map +1 -1
  106. package/server/dist/richEditorFill.js +1 -0
  107. package/server/dist/richEditorFill.js.map +1 -1
  108. package/server/dist/screenshotCrop.d.ts.map +1 -1
  109. package/server/dist/screenshotCrop.js +1 -0
  110. package/server/dist/screenshotCrop.js.map +1 -1
  111. package/server/dist/sessionLog.d.ts +1 -0
  112. package/server/dist/sessionLog.d.ts.map +1 -1
  113. package/server/dist/sessionLog.js +1 -0
  114. package/server/dist/sessionLog.js.map +1 -1
  115. package/server/dist/sessionPhase.d.ts.map +1 -1
  116. package/server/dist/sessionPhase.js.map +1 -1
  117. package/server/dist/sessionSummary.d.ts.map +1 -1
  118. package/server/dist/sessionSummary.js +1 -0
  119. package/server/dist/sessionSummary.js.map +1 -1
  120. package/server/dist/shotUtil.d.ts +44 -0
  121. package/server/dist/shotUtil.d.ts.map +1 -0
  122. package/server/dist/shotUtil.js +89 -0
  123. package/server/dist/shotUtil.js.map +1 -0
  124. package/server/dist/skillsInstructions.d.ts.map +1 -1
  125. package/server/dist/skillsInstructions.js +1 -0
  126. package/server/dist/skillsInstructions.js.map +1 -1
  127. package/server/dist/snapshotText.d.ts +47 -0
  128. package/server/dist/snapshotText.d.ts.map +1 -0
  129. package/server/dist/snapshotText.js +99 -0
  130. package/server/dist/snapshotText.js.map +1 -0
  131. package/server/dist/structureFilter.d.ts.map +1 -1
  132. package/server/dist/structureFilter.js.map +1 -1
  133. package/server/dist/surveyCatalog.d.ts.map +1 -1
  134. package/server/dist/surveyCatalog.js +1 -0
  135. package/server/dist/surveyCatalog.js.map +1 -1
  136. package/server/dist/surveyRunner.d.ts.map +1 -1
  137. package/server/dist/surveyRunner.js.map +1 -1
  138. package/server/dist/toolHelpers.d.ts +27 -2
  139. package/server/dist/toolHelpers.d.ts.map +1 -1
  140. package/server/dist/toolHelpers.js +67 -1
  141. package/server/dist/toolHelpers.js.map +1 -1
  142. package/server/dist/toolRuntime.d.ts +4 -0
  143. package/server/dist/toolRuntime.d.ts.map +1 -1
  144. package/server/dist/toolRuntime.js +12 -6
  145. package/server/dist/toolRuntime.js.map +1 -1
  146. package/server/dist/toolSchemas.d.ts +37 -1
  147. package/server/dist/toolSchemas.d.ts.map +1 -1
  148. package/server/dist/toolSchemas.js +33 -1
  149. package/server/dist/toolSchemas.js.map +1 -1
  150. package/server/dist/tools.d.ts +2 -2
  151. package/server/dist/tools.d.ts.map +1 -1
  152. package/server/dist/tools.js +65 -11
  153. package/server/dist/tools.js.map +1 -1
  154. package/server/dist/verdictExtract.d.ts.map +1 -1
  155. package/server/dist/verdictExtract.js +1 -0
  156. package/server/dist/verdictExtract.js.map +1 -1
  157. package/server/dist/workflowTools.d.ts +2 -2
  158. package/server/dist/workflowTools.d.ts.map +1 -1
  159. package/server/dist/workflowTools.js +16 -4
  160. package/server/dist/workflowTools.js.map +1 -1
  161. package/skills/browser-agent/SKILL.md +89 -0
@@ -1,6 +1,9 @@
1
+ // SPDX-License-Identifier: Apache-2.0
1
2
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
3
  import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
4
+ import { managedHeadlessFromEnv, resolveDriverMode } from './automationBackend.js';
3
5
  import { ExtensionBridge, getDefaultPortFromEnv } from './bridge.js';
6
+ import { ManagedBrowserBridge } from './managedBridge.js';
4
7
  import { registerBrowserTools } from './tools.js';
5
8
  import { catalogInstructionsAppendix } from './surveyCatalog.js';
6
9
  import { policyTiersAppendix } from './policyTiers.js';
@@ -10,11 +13,15 @@ import { ToolRuntime } from './toolRuntime.js';
10
13
  function parseArgs() {
11
14
  const argv = process.argv.slice(2);
12
15
  let insecure = false;
16
+ let managed = resolveDriverMode() === 'managed';
13
17
  const rest = [];
14
18
  for (const a of argv) {
15
19
  if (a === '--insecure-no-token') {
16
20
  insecure = true;
17
21
  }
22
+ else if (a === '--managed') {
23
+ managed = true;
24
+ }
18
25
  else {
19
26
  rest.push(a);
20
27
  }
@@ -22,25 +29,44 @@ function parseArgs() {
22
29
  const port = rest[0] ? parseInt(rest[0], 10) : getDefaultPortFromEnv();
23
30
  return {
24
31
  port: Number.isFinite(port) && port > 0 ? port : getDefaultPortFromEnv(),
25
- insecure
32
+ insecure,
33
+ managed
26
34
  };
27
35
  }
36
+ function managedInstructions() {
37
+ return ('Managed Playwright Chromium (BROWSER_AUTOMATION_DRIVER=managed). No Chrome extension — spin-up headless/headed browser. ' +
38
+ 'Set BROWSER_AUTOMATION_HEADED=1 for visible window. Prefer browser_snapshot (compact text with @e1 refs; includes iframes + shadow DOM; flags captchas). browser_downloads lists downloaded files. ' +
39
+ 'Not your user profile — use extension driver for logged-in Chrome. ');
40
+ }
28
41
  async function main() {
29
- const { port, insecure } = parseArgs();
42
+ const { port, insecure, managed } = parseArgs();
30
43
  bootstrapArBrowserAssets();
31
- const bridge = new ExtensionBridge({
32
- port,
33
- requireSessionToken: !insecure
34
- });
35
- await bridge.start();
36
- console.error(`[browser-automation] WebSocket ws://127.0.0.1:${bridge.boundPort} (localhost only)${insecure ? ' | WARNING: session token disabled (--insecure-no-token)' : ''}`);
37
- if (!insecure) {
38
- console.error(`[browser-automation] SESSION=${bridge.getSessionToken()}`);
44
+ let backend;
45
+ if (managed) {
46
+ // The "one navigate until evidence" gate exists because extension navigations are fire-and-forget and
47
+ // race. Playwright's goto() is awaited, so the gate only adds friction here. Opt back in with =1.
48
+ if (process.env['BROWSER_AUTOMATION_ENFORCE_NAV_DISCIPLINE'] === undefined) {
49
+ process.env['BROWSER_AUTOMATION_ENFORCE_NAV_DISCIPLINE'] = '0';
50
+ }
51
+ backend = new ManagedBrowserBridge({ headless: managedHeadlessFromEnv() });
52
+ await backend.start();
53
+ }
54
+ else {
55
+ const bridge = new ExtensionBridge({
56
+ port,
57
+ requireSessionToken: !insecure
58
+ });
59
+ await bridge.start();
60
+ console.error(`[browser-automation] WebSocket ws://127.0.0.1:${bridge.boundPort} (localhost only)${insecure ? ' | WARNING: session token disabled (--insecure-no-token)' : ''}`);
61
+ if (!insecure) {
62
+ console.error(`[browser-automation] SESSION=${bridge.getSessionToken()}`);
63
+ }
64
+ console.error(`[browser-automation] BRIDGE_PORT=${bridge.boundPort}`);
65
+ backend = bridge;
39
66
  }
40
- console.error(`[browser-automation] BRIDGE_PORT=${bridge.boundPort}`);
41
67
  const runtime = new ToolRuntime();
42
68
  const mcp = new McpServer({ name: 'browser-automation', version: '0.1.0' }, {
43
- instructions: 'Automates one real Chrome tab via an MV3 extension on localhost. ' +
69
+ instructions: (managed ? managedInstructions() : 'Automates one real Chrome tab via an MV3 extension on localhost. ') +
44
70
  'Use browser_navigate for http(s) pages only — chrome://, edge://, the Web Store, and most browser UI ' +
45
71
  'tabs cannot be scripted; switch the target tab to a normal website first. ' +
46
72
  'Use exactly ONE Node MCP server process: match the extension WebSocket port to BRIDGE_PORT from that process stderr (see README). ' +
@@ -55,6 +81,7 @@ async function main() {
55
81
  'One navigate at a time until page text or browser_debug_snapshot is captured; do not batch navigates. ' +
56
82
  'Ground claims in quoted page text; use browser_find_nodes by name/role before clicking refs. ' +
57
83
  'Use refs only from the latest snapshot. browser_find_nodes filters a snapshot for matching controls. ' +
84
+ 'browser_snapshot returns a compact text view (@e1 refs, iframes as f2.e1, open shadow DOM, captcha flag) — prefer it over get_page_structure JSON. ' +
58
85
  'Hidden input[type=file] nodes appear in structure with hint [hidden file input]. ' +
59
86
  'browser_get_element_screen_rect maps a ref to OS screen pixels (centerX/centerY) for hybrid desktop_click. ' +
60
87
  'browser_set_file_input attaches files to file input refs (including hidden). ' +
@@ -66,11 +93,25 @@ async function main() {
66
93
  'LIGHT tasks: fill then Enter; if URL unchanged use find_nodes for submit button. ' +
67
94
  'browser_tab_* tools manage additional tabs without changing the default active tab unless pinned in the extension popup.'
68
95
  });
69
- registerBrowserTools(mcp, bridge, runtime);
96
+ registerBrowserTools(mcp, backend, runtime);
70
97
  const transport = new StdioServerTransport();
71
98
  await mcp.connect(transport);
72
- process.on('SIGINT', () => runtime.close());
73
- process.on('SIGTERM', () => runtime.close());
99
+ let closing = false;
100
+ const shutdown = () => {
101
+ if (closing)
102
+ return;
103
+ closing = true;
104
+ runtime.close();
105
+ // Close the managed Chromium (releases the profile lock) before exiting; hard-exit if it hangs.
106
+ const force = setTimeout(() => process.exit(0), 5000);
107
+ force.unref();
108
+ void backend.stop().finally(() => process.exit(0));
109
+ };
110
+ process.on('SIGINT', shutdown);
111
+ process.on('SIGTERM', shutdown);
112
+ // MCP clients disconnect by closing stdin; without this the browser (and its profile lock) is orphaned.
113
+ process.stdin.on('end', shutdown);
114
+ process.stdin.on('close', shutdown);
74
115
  }
75
116
  main().catch((e) => {
76
117
  console.error('[browser-automation] fatal', e);
@@ -1 +1 @@
1
- {"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,58 @@
1
+ import type { AutomationBackend } from './automationBackend.js';
2
+ export type ManagedOptions = {
3
+ headless?: boolean;
4
+ /** Persistent profile dir (cookies/logins survive restarts). Env: BROWSER_AUTOMATION_USER_DATA_DIR */
5
+ userDataDir?: string;
6
+ /** Use an installed browser instead of bundled Chromium, e.g. "chrome" | "msedge". Env: BROWSER_AUTOMATION_CHANNEL */
7
+ channel?: string;
8
+ viewport?: {
9
+ width: number;
10
+ height: number;
11
+ };
12
+ /** Where downloads are saved. Env: BROWSER_AUTOMATION_DOWNLOAD_DIR (default ~/.ar_browser/downloads) */
13
+ downloadDir?: string;
14
+ /** Abort these resource types for speed, e.g. "image,media,font". Env: BROWSER_AUTOMATION_BLOCK_RESOURCES */
15
+ blockResources?: string[];
16
+ };
17
+ export declare class ManagedBrowserBridge implements AutomationBackend {
18
+ readonly mode: "managed";
19
+ private browser;
20
+ private context;
21
+ private tabs;
22
+ private tabIds;
23
+ private nextTabId;
24
+ private activeTabId;
25
+ private consoleBuf;
26
+ private networkBuf;
27
+ private opts;
28
+ private started;
29
+ private frameRegistry;
30
+ private downloads;
31
+ private downloadSeq;
32
+ private pendingDownloads;
33
+ constructor(options?: ManagedOptions);
34
+ /** Headed windows use the real window size (needed for accurate screen-coordinate mapping). */
35
+ private get realWindow();
36
+ private viewportOf;
37
+ isReady(): boolean;
38
+ start(): Promise<void>;
39
+ stop(): Promise<void>;
40
+ private registerPage;
41
+ private pushConsole;
42
+ private pageFor;
43
+ /**
44
+ * Make sure the headed window is really on top of the desktop before handing screen coordinates to an
45
+ * OS-level click. Page.bringToFront only changes the active tab; on Windows another app can still cover
46
+ * the window (foreground-lock). A minimize→restore through the browser's own window API reliably
47
+ * re-activates it without moving or resizing it.
48
+ */
49
+ private raiseOsWindow;
50
+ private settle;
51
+ private ref;
52
+ private requireRef;
53
+ sendRequest(method: string, params: Record<string, unknown>, _meta?: {
54
+ mcpTool?: string;
55
+ deadlineMs?: number;
56
+ }, deadlineMs?: number): Promise<unknown>;
57
+ }
58
+ //# sourceMappingURL=managedBridge.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"managedBridge.d.ts","sourceRoot":"","sources":["../src/managedBridge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA0BhE,MAAM,MAAM,cAAc,GAAG;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sGAAsG;IACtG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sHAAsH;IACtH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,wGAAwG;IACxG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6GAA6G;IAC7G,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAOF,qBAAa,oBAAqB,YAAW,iBAAiB;IAC1D,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,IAAI,CAA2F;IACvG,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,gBAAgB,CAA4B;gBAExC,OAAO,CAAC,EAAE,cAAc;IAiBpC,+FAA+F;IAC/F,OAAO,KAAK,UAAU,GAErB;YAEa,UAAU;IAMxB,OAAO,IAAI,OAAO;IAKZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgFtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,OAAO,CAAC,YAAY;IAmEpB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,OAAO;IAYf;;;;;OAKG;YACW,aAAa;YAkBb,MAAM;IAKpB,OAAO,CAAC,GAAG;YAmBG,UAAU;IAalB,WAAW,CACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EACjD,UAAU,SAAS,GACpB,OAAO,CAAC,OAAO,CAAC;CAsVtB"}