@tangle-network/browser-agent-driver 0.36.2 → 0.37.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 (139) hide show
  1. package/README.md +72 -364
  2. package/dist/artifacts/composite-sink.d.ts.map +1 -1
  3. package/dist/artifacts/composite-sink.js.map +1 -1
  4. package/dist/artifacts/filesystem-sink.d.ts.map +1 -1
  5. package/dist/artifacts/filesystem-sink.js.map +1 -1
  6. package/dist/artifacts/webhook-sink.d.ts.map +1 -1
  7. package/dist/brain/action-parse.js.map +1 -1
  8. package/dist/brain/index.d.ts.map +1 -1
  9. package/dist/brain/index.js.map +1 -1
  10. package/dist/brain/model-client.js.map +1 -1
  11. package/dist/brain/provider-fetch.d.ts +1 -1
  12. package/dist/brain/provider-fetch.d.ts.map +1 -1
  13. package/dist/browser-launch.js.map +1 -1
  14. package/dist/captcha.js.map +1 -1
  15. package/dist/cli/benchmark-sync.js.map +1 -1
  16. package/dist/cli/version.js.map +1 -1
  17. package/dist/cli-attach.js.map +1 -1
  18. package/dist/cli-patterns.js.map +1 -1
  19. package/dist/cli-preview.d.ts.map +1 -1
  20. package/dist/cli-preview.js.map +1 -1
  21. package/dist/cli-share.d.ts.map +1 -1
  22. package/dist/cli-ui.d.ts.map +1 -1
  23. package/dist/cli-view-live.js.map +1 -1
  24. package/dist/cli-view.d.ts.map +1 -1
  25. package/dist/cli-view.js.map +1 -1
  26. package/dist/cli.js.map +1 -1
  27. package/dist/context-budget.d.ts.map +1 -1
  28. package/dist/design/audit/attribution/store.js.map +1 -1
  29. package/dist/design/audit/build-result.js.map +1 -1
  30. package/dist/design/audit/ethics/check.js.map +1 -1
  31. package/dist/design/audit/ethics/loader.js.map +1 -1
  32. package/dist/design/audit/evaluate.d.ts.map +1 -1
  33. package/dist/design/audit/evaluate.js.map +1 -1
  34. package/dist/design/audit/measure/a11y.js.map +1 -1
  35. package/dist/design/audit/modality/android.d.ts +1 -1
  36. package/dist/design/audit/modality/android.d.ts.map +1 -1
  37. package/dist/design/audit/modality/html.d.ts +1 -1
  38. package/dist/design/audit/modality/html.d.ts.map +1 -1
  39. package/dist/design/audit/modality/ios.d.ts +1 -1
  40. package/dist/design/audit/modality/ios.d.ts.map +1 -1
  41. package/dist/design/audit/patterns/match.js.map +1 -1
  42. package/dist/design/audit/patterns/mine.js.map +1 -1
  43. package/dist/design/audit/patterns/store.js.map +1 -1
  44. package/dist/design/audit/reference/config.js.map +1 -1
  45. package/dist/design/audit/reference/dna/derive.js.map +1 -1
  46. package/dist/design/audit/reference/dna/descriptor.js.map +1 -1
  47. package/dist/design/audit/reference/dna/scroll-capture.js.map +1 -1
  48. package/dist/design/audit/reference/generate/generator.js.map +1 -1
  49. package/dist/design/audit/reference/generate/prompt.js.map +1 -1
  50. package/dist/design/audit/reference/judge/image-clamp.js.map +1 -1
  51. package/dist/design/audit/reference/judge/quality.js.map +1 -1
  52. package/dist/design/audit/reference/judge/rank.js.map +1 -1
  53. package/dist/design/audit/reference/judge/vision-judge.js.map +1 -1
  54. package/dist/design/audit/reference/reference-context.js.map +1 -1
  55. package/dist/design/audit/reference/retrieval/embedding-openai.js.map +1 -1
  56. package/dist/design/audit/reference/retrieval/matcher.js.map +1 -1
  57. package/dist/design/audit/report.js.map +1 -1
  58. package/dist/design/audit/rubric/anchor-loader.js.map +1 -1
  59. package/dist/design/audit/rubric/loader.js.map +1 -1
  60. package/dist/design/audit/score-types.d.ts +2 -1
  61. package/dist/design/audit/score-types.d.ts.map +1 -1
  62. package/dist/design/audit/score-types.js +2 -1
  63. package/dist/design/audit/score-types.js.map +1 -1
  64. package/dist/design/viewports.d.ts +3 -3
  65. package/dist/design/viewports.d.ts.map +1 -1
  66. package/dist/design-audit.d.ts.map +1 -1
  67. package/dist/design-audit.js.map +1 -1
  68. package/dist/discover/index.js.map +1 -1
  69. package/dist/discover/wayback.js.map +1 -1
  70. package/dist/drivers/overlay-label.js.map +1 -1
  71. package/dist/drivers/playwright.d.ts.map +1 -1
  72. package/dist/drivers/playwright.js.map +1 -1
  73. package/dist/drivers/snapshot.d.ts.map +1 -1
  74. package/dist/drivers/snapshot.js.map +1 -1
  75. package/dist/drivers/steel.d.ts.map +1 -1
  76. package/dist/drivers/steel.js.map +1 -1
  77. package/dist/extensions/loader.js.map +1 -1
  78. package/dist/ffmpeg-availability.js.map +1 -1
  79. package/dist/jobs/retry.js.map +1 -1
  80. package/dist/jobs/store.js.map +1 -1
  81. package/dist/memory/analyzer.d.ts.map +1 -1
  82. package/dist/memory/knowledge.d.ts.map +1 -1
  83. package/dist/memory/project-store.d.ts.map +1 -1
  84. package/dist/memory/run-registry.d.ts.map +1 -1
  85. package/dist/memory/selectors.d.ts.map +1 -1
  86. package/dist/memory/store.d.ts.map +1 -1
  87. package/dist/memory/store.js.map +1 -1
  88. package/dist/multi-actor.d.ts.map +1 -1
  89. package/dist/multi-actor.js.map +1 -1
  90. package/dist/personas.d.ts +1 -1
  91. package/dist/personas.d.ts.map +1 -1
  92. package/dist/provider-defaults.js.map +1 -1
  93. package/dist/reports/aggregate.js.map +1 -1
  94. package/dist/reports/narrate.js.map +1 -1
  95. package/dist/reports/templates.js.map +1 -1
  96. package/dist/reports/tools.d.ts +5 -52
  97. package/dist/reports/tools.d.ts.map +1 -1
  98. package/dist/reports/tools.js.map +1 -1
  99. package/dist/run-state.d.ts.map +1 -1
  100. package/dist/runner/completion-policy.js.map +1 -1
  101. package/dist/runner/constants.d.ts +1 -1
  102. package/dist/runner/decision-cache.d.ts.map +1 -1
  103. package/dist/runner/decision-cache.js.map +1 -1
  104. package/dist/runner/direct-start.js.map +1 -1
  105. package/dist/runner/events.d.ts.map +1 -1
  106. package/dist/runner/events.js.map +1 -1
  107. package/dist/runner/google-flights-preflight.js.map +1 -1
  108. package/dist/runner/interrupt-controller.d.ts.map +1 -1
  109. package/dist/runner/interrupt-controller.js.map +1 -1
  110. package/dist/runner/overlay-narration.d.ts.map +1 -1
  111. package/dist/runner/replay/controller.d.ts.map +1 -1
  112. package/dist/runner/replay/guard.d.ts.map +1 -1
  113. package/dist/runner/replay/guard.js.map +1 -1
  114. package/dist/runner/runner.d.ts.map +1 -1
  115. package/dist/runner/runner.js.map +1 -1
  116. package/dist/runner/selector-guard.js.map +1 -1
  117. package/dist/runner/stream-webhook.d.ts.map +1 -1
  118. package/dist/skills/domain-loader.js.map +1 -1
  119. package/dist/skills/macro-loader.d.ts +1 -1
  120. package/dist/skills/macro-loader.js.map +1 -1
  121. package/dist/supervisor/critic.js.map +1 -1
  122. package/dist/supervisor/policy.js.map +1 -1
  123. package/dist/telemetry/client.d.ts.map +1 -1
  124. package/dist/telemetry/client.js.map +1 -1
  125. package/dist/telemetry/sink.d.ts.map +1 -1
  126. package/dist/telemetry/sink.js.map +1 -1
  127. package/dist/test-runner.d.ts.map +1 -1
  128. package/dist/test-runner.js.map +1 -1
  129. package/dist/types/test-runner.d.ts +1 -1
  130. package/dist/wallet/automation.d.ts.map +1 -1
  131. package/dist/wallet/automation.js.map +1 -1
  132. package/package.json +39 -61
  133. package/skills/domain/amazon.com/SKILL.md +14 -0
  134. package/skills/domain/github.com/SKILL.md +15 -0
  135. package/skills/domain/linkedin.com/SKILL.md +14 -0
  136. package/skills/domain/stackoverflow.com/SKILL.md +13 -0
  137. package/skills/domain/wikipedia.org/SKILL.md +15 -0
  138. package/skills/macros/dismiss-cookie-banner.json +11 -0
  139. package/skills/macros/search-and-submit.json +13 -0
@@ -0,0 +1,14 @@
1
+ ---
2
+ host: amazon.com
3
+ aliases: [www.amazon.com, smile.amazon.com]
4
+ title: Amazon product search and extraction
5
+ ---
6
+
7
+ On amazon.com:
8
+
9
+ - Prefer the search box at the top. It's a `searchbox` role with ref near the page header. After typing the query, press Enter rather than clicking the "Go" button — the button is often hidden behind the keyboard and Enter submits reliably.
10
+ - Cookie/consent banners only appear on EU/UK domains (`.co.uk`, `.de`). If present, click the "Accept" or "Customize" button before any other interaction — Amazon's layout shifts after consent and `@ref` values change.
11
+ - Product search results live under the "Search results" landmark. Each card has a link whose accessible name is the product title. Use `click` on the title link, not the image, to reach the product detail page.
12
+ - On product detail pages, the canonical price is inside the `#corePrice_feature_div` block. Read `#priceblock_ourprice`, `#priceblock_dealprice`, or the a-price-whole spans — the field varies by category. Extract using `extractWithIndex` with the `offscreen` filter off; Amazon renders price twice (once with aria-hidden) and the accessible version is what you want.
13
+ - Ratings appear as `4.5 out of 5 stars` in an `[aria-label]`. Parse the numeric portion before "out of".
14
+ - Be aware of sponsored vs organic results: sponsored cards have "Sponsored" in small text above the title. Most tasks want the first organic result; filter accordingly.
@@ -0,0 +1,15 @@
1
+ ---
2
+ host: github.com
3
+ aliases: [www.github.com]
4
+ title: GitHub navigation, repo discovery, and PR/issue extraction
5
+ ---
6
+
7
+ On github.com:
8
+
9
+ - The top search bar is `role="combobox"` with `aria-label="Search GitHub"`. Typing a query and pressing Enter runs the global search. For in-repo search, use the "Go to file" shortcut: press `t` on a repo page and type the filename.
10
+ - Repo pages have stable URL structure: `/OWNER/REPO`, `/OWNER/REPO/pulls`, `/OWNER/REPO/issues`, `/OWNER/REPO/blob/BRANCH/PATH`. Prefer direct URL navigation over clicking through the UI when the owner/repo is known — it's faster and avoids sidebar ambiguity.
11
+ - PR and issue lists use infinite scroll but the first ~25 fit on one page. Don't scroll unless the task requires more than 25 results.
12
+ - PR/issue counts: the tab badges ("Pull requests 42", "Issues 7") carry the exact number. Extract from the tab's accessible name, not from scrolling the list.
13
+ - File browsing: blob pages render the code inside a `<table>` with `role="presentation"`. Line numbers are in a separate column; use the `#L<n>` URL fragment to jump to a specific line rather than scrolling.
14
+ - For star/fork counts on a repo, the values are in the top-right action bar with accessible labels like "42 stars" and "3 forks".
15
+ - Login state matters: logged-in users see private repos in search; logged-out users don't. Don't assume visibility equals existence.
@@ -0,0 +1,14 @@
1
+ ---
2
+ host: linkedin.com
3
+ aliases: [www.linkedin.com]
4
+ title: LinkedIn navigation and profile extraction
5
+ ---
6
+
7
+ On linkedin.com:
8
+
9
+ - The site aggressively detects automation. If you see an authwall ("Join now to see"), the account is not logged in — abort unless the task explicitly expects this. Do not try to sign up programmatically.
10
+ - Profile pages use dynamic React rendering. Wait for `heading` role with the person's name to appear before extracting — snapshot on first load is often skeleton UI.
11
+ - The search bar is `role="combobox"` with placeholder "Search". After typing, press Enter; the dropdown suggestions can lead to unrelated pages if clicked.
12
+ - Job listings: use `extractWithIndex` on the search results container (class `jobs-search-results-list` or role `list`). Each item's title, company, and location are distinct children — don't flatten them into a single blob.
13
+ - LinkedIn rate-limits heavy scraping. If the page shows "You've reached the weekly limit", abort the run — retries will not help.
14
+ - When logged in via attach mode, respect the user's real account: never send connection requests, InMails, or messages unless the task explicitly requests it.
@@ -0,0 +1,13 @@
1
+ ---
2
+ host: stackoverflow.com
3
+ title: Stack Overflow question and answer extraction
4
+ ---
5
+
6
+ On stackoverflow.com:
7
+
8
+ - Question pages have a stable structure: question body, then answers sorted by vote count (accepted answer floats to the top). The accepted answer has a green checkmark and `aria-label="Accepted answer"`.
9
+ - Answer count appears in the sidebar sub-header ("3 Answers"). Extract from that heading, not from counting `<article>` elements — pinned/deleted answers can throw off the DOM count.
10
+ - Code blocks inside answers are `<pre><code>` — their text content is preserved verbatim. If the task is "extract the code from the top answer", grab the first `<pre>` inside the answer body.
11
+ - Vote counts are in a `.js-vote-count` or `[itemprop="upvoteCount"]` element next to each post. Use the accessible label ("23 votes") rather than parsing the class.
12
+ - Tags appear below the question title as a list of `role="link"` with `tag` in the URL. Good proxy for topic when the question title is ambiguous.
13
+ - Stack Overflow requires JS to render vote counts and comments. Wait for the "Show X more comments" expander to resolve before extracting comment text.
@@ -0,0 +1,15 @@
1
+ ---
2
+ host: wikipedia.org
3
+ aliases: [en.wikipedia.org]
4
+ title: Wikipedia article extraction
5
+ ---
6
+
7
+ On wikipedia.org:
8
+
9
+ - Article content is inside `#mw-content-text`. Infoboxes are the table at the top-right of the article — use them for structured facts (birth/death dates, coordinates, population, founding year) rather than parsing prose.
10
+ - The article lead (first paragraph after the infobox) is the highest-density summary; for one-fact queries it usually contains the answer.
11
+ - When extracting a numeric fact for a goal like "what year was X founded", emit the number in the exact shape the goal asks for. If the goal implies a JSON object, wrap: `{"year": 1815}`, not the bare string "1815". Wikipedia extraction goals are the most common site where this formatting detail decides pass/fail.
12
+ - The search box is at the top-right. Pressing Enter after typing runs the search; the dropdown suggestions lead to disambiguation pages which can be wrong — prefer pressing Enter.
13
+ - Disambiguation pages: if the search resolves to a "X may refer to:" list, the correct entry is usually the one matching the goal's context (place, person, company). Scan the list before clicking.
14
+ - References and citations use superscripts like `[1]`. Do not include them in extracted prose — strip the `<sup>` elements or their text content.
15
+ - For facts, prefer the English Wikipedia (`en.wikipedia.org`) over other language editions unless the task specifies a different language.
@@ -0,0 +1,11 @@
1
+ {
2
+ "name": "dismiss-cookie-banner",
3
+ "description": "Accept/dismiss a standard cookie consent banner by clicking the 'Accept' button, then give the page 500ms to settle so the next snapshot sees the dismissed layout. Use when the snapshot contains a role=dialog with cookie/consent text and a visible Accept button ref.",
4
+ "params": [
5
+ { "name": "acceptRef", "description": "The ref of the Accept/Accept all/OK button inside the banner", "required": true }
6
+ ],
7
+ "steps": [
8
+ { "action": "click", "selector": "${acceptRef}" },
9
+ { "action": "wait", "ms": 500 }
10
+ ]
11
+ }
@@ -0,0 +1,13 @@
1
+ {
2
+ "name": "search-and-submit",
3
+ "description": "Focus a searchbox, type the query, and press Enter to submit. Use on pages with a top-level search affordance — avoids clicking a 'Go' button whose ref may shift under the keyboard.",
4
+ "params": [
5
+ { "name": "searchRef", "description": "Ref of the searchbox/combobox to type into", "required": true },
6
+ { "name": "query", "description": "Query text to type", "required": true }
7
+ ],
8
+ "steps": [
9
+ { "action": "click", "selector": "${searchRef}" },
10
+ { "action": "type", "selector": "${searchRef}", "text": "${query}" },
11
+ { "action": "press", "selector": "${searchRef}", "key": "Enter" }
12
+ ]
13
+ }