oh-my-opencode 5.0.0-beta.62 → 5.0.0-beta.63

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 (213) hide show
  1. package/THIRD-PARTY-NOTICES.md +8 -6
  2. package/dist/cli/doctor/checks/browser-provider.d.ts +2 -0
  3. package/dist/cli/index.js +64 -35
  4. package/dist/cli-node/index.js +64 -35
  5. package/dist/config/schema/agent-names.d.ts +0 -1
  6. package/dist/config/schema/browser-automation.d.ts +0 -2
  7. package/dist/config/schema/oh-my-opencode-config.d.ts +0 -1
  8. package/dist/hooks/comment-checker/__fixtures__/download-probe.fixture.d.ts +1 -0
  9. package/dist/index.js +61 -535
  10. package/dist/oh-my-opencode.schema.json +0 -1
  11. package/dist/skills/ast-grep/SKILL.md +12 -0
  12. package/dist/skills/debugging/references/tools/playwright-cli.md +79 -161
  13. package/dist/skills/frontend/SKILL.md +1 -1
  14. package/dist/skills/frontend/references/design/aside.md +1 -1
  15. package/dist/skills/frontend/references/design/clone-from-url.md +1 -1
  16. package/dist/skills/frontend/scripts/perfection/lighthouse-audit.py +2 -2
  17. package/dist/skills/review-work/SKILL.md +1 -1
  18. package/dist/skills/ultimate-browsing/ATTRIBUTION.md +1 -82
  19. package/dist/skills/ultimate-browsing/SKILL.md +17 -29
  20. package/dist/skills/ultimate-browsing/engine/AGENTS.md +2 -1
  21. package/dist/skills/ultimate-browsing/engine/templates/package.json +2 -2
  22. package/dist/skills/ultimate-browsing/engine/templates/playwright_mobile_chrome.js +5 -2
  23. package/dist/skills/ultimate-browsing/engine/templates/playwright_real_chrome.js +8 -6
  24. package/dist/skills/ultimate-browsing/engine/tests/test_playwright_stealth.py +86 -0
  25. package/dist/skills/ultimate-browsing/engine/tests/test_playwright_templates.py +4 -7
  26. package/dist/skills/ultimate-browsing/references/chrome-stealth.md +86 -100
  27. package/dist/skills/ultimate-browsing/references/insane-search/README.md +9 -3
  28. package/dist/skills/ultimate-browsing/references/insane-search/playwright.md +16 -13
  29. package/dist/skills/ultimate-browsing/scripts/extract_cookies.py +3 -3
  30. package/dist/skills/ulw-execute/SKILL.md +1 -1
  31. package/dist/skills/ulw-plan/scripts/scaffold-plan.mjs +1 -1
  32. package/dist/skills/ulw-research/SKILL.md +3 -3
  33. package/dist/skills/visual-qa/AGENTS.md +1 -1
  34. package/dist/skills/visual-qa/SKILL.md +1 -1
  35. package/dist/skills/visual-qa/references/browser-setup.md +75 -0
  36. package/dist/tui.js +12 -5
  37. package/package.json +16 -23
  38. package/packages/omo-codex/plugin/.codex-plugin/plugin.json +1 -1
  39. package/packages/omo-codex/plugin/components/bootstrap/dist/cli.js +2 -0
  40. package/packages/omo-codex/plugin/components/bootstrap/hooks/hooks.json +1 -1
  41. package/packages/omo-codex/plugin/components/bootstrap/package.json +1 -1
  42. package/packages/omo-codex/plugin/components/comment-checker/hooks/hooks.json +1 -1
  43. package/packages/omo-codex/plugin/components/comment-checker/package.json +1 -1
  44. package/packages/omo-codex/plugin/components/git-bash/hooks/hooks.json +2 -2
  45. package/packages/omo-codex/plugin/components/git-bash/package.json +1 -1
  46. package/packages/omo-codex/plugin/components/lazycodex-executor-verify/hooks/hooks.json +1 -1
  47. package/packages/omo-codex/plugin/components/lazycodex-executor-verify/package.json +1 -1
  48. package/packages/omo-codex/plugin/components/lsp/dist/.omo-runtime-manifest.json +2 -2
  49. package/packages/omo-codex/plugin/components/lsp/hooks/hooks.json +2 -2
  50. package/packages/omo-codex/plugin/components/lsp/package.json +1 -1
  51. package/packages/omo-codex/plugin/components/rules/hooks/hooks.json +4 -4
  52. package/packages/omo-codex/plugin/components/rules/package.json +1 -1
  53. package/packages/omo-codex/plugin/components/teammode/hooks/hooks.json +1 -1
  54. package/packages/omo-codex/plugin/components/teammode/package.json +1 -1
  55. package/packages/omo-codex/plugin/components/telemetry/hooks/hooks.json +1 -1
  56. package/packages/omo-codex/plugin/components/telemetry/package.json +1 -1
  57. package/packages/omo-codex/plugin/components/ultrawork/agents/plan.toml +2 -2
  58. package/packages/omo-codex/plugin/components/ultrawork/dist/cli.js +5 -4
  59. package/packages/omo-codex/plugin/components/ultrawork/hooks/hooks.json +1 -1
  60. package/packages/omo-codex/plugin/components/ultrawork/package.json +1 -1
  61. package/packages/omo-codex/plugin/components/ultrawork/src/directive-content.ts +1 -1
  62. package/packages/omo-codex/plugin/components/ulw-execute-continuation/directive.md +1 -1
  63. package/packages/omo-codex/plugin/components/ulw-execute-continuation/hooks/hooks.json +1 -1
  64. package/packages/omo-codex/plugin/components/ulw-execute-continuation/package.json +1 -1
  65. package/packages/omo-codex/plugin/components/ulw-loop/CHANGELOG.md +13 -0
  66. package/packages/omo-codex/plugin/components/ulw-loop/directive.md +5 -4
  67. package/packages/omo-codex/plugin/components/ulw-loop/dist/checkpoint.js +5 -4
  68. package/packages/omo-codex/plugin/components/ulw-loop/dist/cli.js +582 -322
  69. package/packages/omo-codex/plugin/components/ulw-loop/dist/domain-types.d.ts +5 -0
  70. package/packages/omo-codex/plugin/components/ulw-loop/dist/evidence.js +16 -12
  71. package/packages/omo-codex/plugin/components/ulw-loop/dist/ledger.d.ts +4 -0
  72. package/packages/omo-codex/plugin/components/ulw-loop/dist/ledger.js +34 -0
  73. package/packages/omo-codex/plugin/components/ulw-loop/dist/plan-commit.d.ts +19 -0
  74. package/packages/omo-codex/plugin/components/ulw-loop/dist/plan-commit.js +107 -0
  75. package/packages/omo-codex/plugin/components/ulw-loop/dist/plan-crud.d.ts +2 -1
  76. package/packages/omo-codex/plugin/components/ulw-loop/dist/plan-crud.js +48 -22
  77. package/packages/omo-codex/plugin/components/ulw-loop/dist/plan-io.d.ts +9 -7
  78. package/packages/omo-codex/plugin/components/ulw-loop/dist/plan-io.js +105 -114
  79. package/packages/omo-codex/plugin/components/ulw-loop/dist/plan-log.d.ts +15 -0
  80. package/packages/omo-codex/plugin/components/ulw-loop/dist/plan-log.js +86 -0
  81. package/packages/omo-codex/plugin/components/ulw-loop/dist/plan-missing-recovery.d.ts +5 -1
  82. package/packages/omo-codex/plugin/components/ulw-loop/dist/plan-missing-recovery.js +15 -3
  83. package/packages/omo-codex/plugin/components/ulw-loop/dist/review-blockers.js +3 -4
  84. package/packages/omo-codex/plugin/components/ulw-loop/dist/sdk/factory.js +12 -5
  85. package/packages/omo-codex/plugin/components/ulw-loop/dist/spawn-budget-io.d.ts +5 -0
  86. package/packages/omo-codex/plugin/components/ulw-loop/dist/spawn-budget-io.js +67 -0
  87. package/packages/omo-codex/plugin/components/ulw-loop/dist/spawn-guard.js +8 -62
  88. package/packages/omo-codex/plugin/components/ulw-loop/dist/state-lock.d.ts +11 -1
  89. package/packages/omo-codex/plugin/components/ulw-loop/dist/state-lock.js +120 -88
  90. package/packages/omo-codex/plugin/components/ulw-loop/dist/status-next-actions.d.ts +3 -2
  91. package/packages/omo-codex/plugin/components/ulw-loop/dist/status-next-actions.js +18 -10
  92. package/packages/omo-codex/plugin/components/ulw-loop/dist/steering-batch.js +4 -4
  93. package/packages/omo-codex/plugin/components/ulw-loop/dist/steering.js +5 -5
  94. package/packages/omo-codex/plugin/components/ulw-loop/dist/stop-resume-hook.js +8 -17
  95. package/packages/omo-codex/plugin/components/ulw-loop/hooks/hooks.json +5 -5
  96. package/packages/omo-codex/plugin/components/ulw-loop/package.json +1 -1
  97. package/packages/omo-codex/plugin/components/ulw-loop/skills/ulw-loop/references/full-workflow.md +2 -2
  98. package/packages/omo-codex/plugin/components/ulw-loop/src/checkpoint.ts +5 -4
  99. package/packages/omo-codex/plugin/components/ulw-loop/src/domain-types.ts +5 -0
  100. package/packages/omo-codex/plugin/components/ulw-loop/src/evidence.ts +16 -16
  101. package/packages/omo-codex/plugin/components/ulw-loop/src/ledger.ts +33 -0
  102. package/packages/omo-codex/plugin/components/ulw-loop/src/plan-commit.ts +124 -0
  103. package/packages/omo-codex/plugin/components/ulw-loop/src/plan-crud.ts +58 -51
  104. package/packages/omo-codex/plugin/components/ulw-loop/src/plan-io.ts +126 -140
  105. package/packages/omo-codex/plugin/components/ulw-loop/src/plan-log.ts +84 -0
  106. package/packages/omo-codex/plugin/components/ulw-loop/src/plan-missing-recovery.ts +26 -3
  107. package/packages/omo-codex/plugin/components/ulw-loop/src/review-blockers.ts +3 -3
  108. package/packages/omo-codex/plugin/components/ulw-loop/src/sdk/factory.ts +30 -5
  109. package/packages/omo-codex/plugin/components/ulw-loop/src/spawn-budget-io.ts +59 -0
  110. package/packages/omo-codex/plugin/components/ulw-loop/src/spawn-guard.ts +8 -59
  111. package/packages/omo-codex/plugin/components/ulw-loop/src/state-lock.ts +129 -111
  112. package/packages/omo-codex/plugin/components/ulw-loop/src/status-next-actions.ts +19 -10
  113. package/packages/omo-codex/plugin/components/ulw-loop/src/steering-batch.ts +4 -4
  114. package/packages/omo-codex/plugin/components/ulw-loop/src/steering.ts +5 -4
  115. package/packages/omo-codex/plugin/components/ulw-loop/src/stop-resume-hook.ts +8 -16
  116. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/barrier.ts +13 -0
  117. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/commit-child.ts +65 -0
  118. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/commit-cli-qa.mjs +76 -0
  119. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/commit-crash.ts +23 -0
  120. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/commit-mutations.mjs +58 -0
  121. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/commit-writer.ts +65 -0
  122. package/packages/omo-codex/plugin/components/ulw-loop/test/fixtures/lease-clock.ts +23 -0
  123. package/packages/omo-codex/plugin/components/ulw-loop/test/plan-commit-log.test.ts +252 -0
  124. package/packages/omo-codex/plugin/components/ulw-loop/test/plan-commit-recovery.test.ts +190 -0
  125. package/packages/omo-codex/plugin/components/ulw-loop/test/plan-io.test.ts +50 -35
  126. package/packages/omo-codex/plugin/components/ulw-loop/test/plan-log-newest.test.ts +72 -0
  127. package/packages/omo-codex/plugin/components/ulw-loop/test/sdk-completed-plan.test.ts +43 -0
  128. package/packages/omo-codex/plugin/components/ulw-loop/test/sdk-session-context.test.ts +21 -0
  129. package/packages/omo-codex/plugin/components/ulw-loop/test/state-lock.test.ts +92 -0
  130. package/packages/omo-codex/plugin/components/ulw-loop/test/status-next-actions-surface.test.ts +133 -0
  131. package/packages/omo-codex/plugin/components/ulw-loop/test/steering-batch.test.ts +12 -12
  132. package/packages/omo-codex/plugin/components/ulw-loop/test/steering.test.ts +4 -1
  133. package/packages/omo-codex/plugin/hooks/post-compact-resetting-git-bash-mcp-reminder.json +1 -1
  134. package/packages/omo-codex/plugin/hooks/post-compact-resetting-lsp-diagnostics-cache.json +1 -1
  135. package/packages/omo-codex/plugin/hooks/post-compact-resetting-project-rule-cache.json +1 -1
  136. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-comments.json +1 -1
  137. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-lsp-diagnostics.json +1 -1
  138. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-thread-title-hygiene.json +1 -1
  139. package/packages/omo-codex/plugin/hooks/post-tool-use-matching-project-rules.json +1 -1
  140. package/packages/omo-codex/plugin/hooks/post-tool-use-recording-spawn-admission.json +1 -1
  141. package/packages/omo-codex/plugin/hooks/pre-tool-use-enforcing-unlimited-goal-budget.json +1 -1
  142. package/packages/omo-codex/plugin/hooks/pre-tool-use-guarding-ulw-loop-spawns.json +1 -1
  143. package/packages/omo-codex/plugin/hooks/pre-tool-use-recommending-git-bash-mcp.json +1 -1
  144. package/packages/omo-codex/plugin/hooks/session-start-checking-auto-update.json +1 -1
  145. package/packages/omo-codex/plugin/hooks/session-start-checking-bootstrap-provisioning.json +1 -1
  146. package/packages/omo-codex/plugin/hooks/session-start-loading-project-rules.json +1 -1
  147. package/packages/omo-codex/plugin/hooks/session-start-recording-session-telemetry.json +1 -1
  148. package/packages/omo-codex/plugin/hooks/stop-checking-ulw-execute-continuation.json +1 -1
  149. package/packages/omo-codex/plugin/hooks/stop-checking-ulw-loop-resume.json +1 -1
  150. package/packages/omo-codex/plugin/hooks/subagent-stop-verifying-lazycodex-executor-evidence.json +1 -1
  151. package/packages/omo-codex/plugin/hooks/user-prompt-submit-checking-ultrawork-trigger.json +1 -1
  152. package/packages/omo-codex/plugin/hooks/user-prompt-submit-checking-ulw-loop-steering.json +1 -1
  153. package/packages/omo-codex/plugin/hooks/user-prompt-submit-loading-project-rules.json +1 -1
  154. package/packages/omo-codex/plugin/package-lock.json +12 -12
  155. package/packages/omo-codex/plugin/package.json +1 -1
  156. package/packages/omo-codex/plugin/scripts/sync-skills.d.mts +4 -0
  157. package/packages/omo-codex/plugin/scripts/sync-skills.mjs +15 -7
  158. package/packages/omo-codex/plugin/skills/ast-grep/SKILL.md +12 -0
  159. package/packages/omo-codex/plugin/skills/debugging/references/tools/playwright-cli.md +79 -161
  160. package/packages/omo-codex/plugin/skills/frontend/SKILL.md +1 -1
  161. package/packages/omo-codex/plugin/skills/frontend/references/design/aside.md +1 -1
  162. package/packages/omo-codex/plugin/skills/frontend/references/design/clone-from-url.md +1 -1
  163. package/packages/omo-codex/plugin/skills/frontend/scripts/perfection/lighthouse-audit.py +2 -2
  164. package/packages/omo-codex/plugin/skills/review-work/SKILL.md +1 -1
  165. package/packages/omo-codex/plugin/skills/ultimate-browsing/ATTRIBUTION.md +1 -82
  166. package/packages/omo-codex/plugin/skills/ultimate-browsing/SKILL.md +17 -29
  167. package/packages/omo-codex/plugin/skills/ultimate-browsing/engine/AGENTS.md +2 -1
  168. package/packages/omo-codex/plugin/skills/ultimate-browsing/engine/templates/package.json +2 -2
  169. package/packages/omo-codex/plugin/skills/ultimate-browsing/engine/templates/playwright_mobile_chrome.js +5 -2
  170. package/packages/omo-codex/plugin/skills/ultimate-browsing/engine/templates/playwright_real_chrome.js +8 -6
  171. package/packages/omo-codex/plugin/skills/ultimate-browsing/engine/tests/test_playwright_stealth.py +86 -0
  172. package/packages/omo-codex/plugin/skills/ultimate-browsing/engine/tests/test_playwright_templates.py +4 -7
  173. package/packages/omo-codex/plugin/skills/ultimate-browsing/references/chrome-stealth.md +86 -100
  174. package/packages/omo-codex/plugin/skills/ultimate-browsing/references/insane-search/README.md +9 -3
  175. package/packages/omo-codex/plugin/skills/ultimate-browsing/references/insane-search/playwright.md +16 -13
  176. package/packages/omo-codex/plugin/skills/ultimate-browsing/scripts/extract_cookies.py +3 -3
  177. package/packages/omo-codex/plugin/skills/ultrawork/SKILL.md +5 -4
  178. package/packages/omo-codex/plugin/skills/ulw-execute/SKILL.md +1 -1
  179. package/packages/omo-codex/plugin/skills/ulw-loop/references/full-workflow.md +2 -2
  180. package/packages/omo-codex/plugin/skills/ulw-research/SKILL.md +3 -3
  181. package/packages/omo-codex/plugin/skills/visual-qa/AGENTS.md +1 -1
  182. package/packages/omo-codex/plugin/skills/visual-qa/SKILL.md +1 -1
  183. package/packages/omo-codex/plugin/skills/visual-qa/references/browser-setup.md +75 -0
  184. package/packages/omo-codex/scripts/install-dist/install-local.mjs +4 -2
  185. package/packages/prompts-core/prompts/ultrawork/codex.md +5 -4
  186. package/packages/shared-skills/skills/ast-grep/SKILL.md +12 -0
  187. package/packages/shared-skills/skills/debugging/references/tools/playwright-cli.md +79 -161
  188. package/packages/shared-skills/skills/frontend/SKILL.md +1 -1
  189. package/packages/shared-skills/skills/frontend/references/design/aside.md +1 -1
  190. package/packages/shared-skills/skills/frontend/references/design/clone-from-url.md +1 -1
  191. package/packages/shared-skills/skills/frontend/scripts/perfection/lighthouse-audit.py +2 -2
  192. package/packages/shared-skills/skills/review-work/SKILL.md +1 -1
  193. package/packages/shared-skills/skills/ultimate-browsing/ATTRIBUTION.md +1 -82
  194. package/packages/shared-skills/skills/ultimate-browsing/SKILL.md +17 -29
  195. package/packages/shared-skills/skills/ultimate-browsing/engine/AGENTS.md +2 -1
  196. package/packages/shared-skills/skills/ultimate-browsing/engine/templates/package.json +2 -2
  197. package/packages/shared-skills/skills/ultimate-browsing/engine/templates/playwright_mobile_chrome.js +5 -2
  198. package/packages/shared-skills/skills/ultimate-browsing/engine/templates/playwright_real_chrome.js +8 -6
  199. package/packages/shared-skills/skills/ultimate-browsing/engine/tests/test_playwright_stealth.py +86 -0
  200. package/packages/shared-skills/skills/ultimate-browsing/engine/tests/test_playwright_templates.py +4 -7
  201. package/packages/shared-skills/skills/ultimate-browsing/references/chrome-stealth.md +86 -100
  202. package/packages/shared-skills/skills/ultimate-browsing/references/insane-search/README.md +9 -3
  203. package/packages/shared-skills/skills/ultimate-browsing/references/insane-search/playwright.md +16 -13
  204. package/packages/shared-skills/skills/ultimate-browsing/scripts/extract_cookies.py +3 -3
  205. package/packages/shared-skills/skills/ulw-execute/SKILL.md +1 -1
  206. package/packages/shared-skills/skills/ulw-plan/scripts/scaffold-plan.mjs +1 -1
  207. package/packages/shared-skills/skills/ulw-research/SKILL.md +3 -3
  208. package/packages/shared-skills/skills/visual-qa/AGENTS.md +1 -1
  209. package/packages/shared-skills/skills/visual-qa/SKILL.md +1 -1
  210. package/packages/shared-skills/skills/visual-qa/references/browser-setup.md +75 -0
  211. package/dist/skills/visual-qa/references/agent-browser-setup.md +0 -45
  212. package/packages/omo-codex/plugin/skills/visual-qa/references/agent-browser-setup.md +0 -45
  213. package/packages/shared-skills/skills/visual-qa/references/agent-browser-setup.md +0 -45
@@ -76,11 +76,12 @@ async function main() {
76
76
  const playwrightExtra = requireOptionalModule('playwright-extra');
77
77
  const stealthPlugin = playwrightExtra ? requireOptionalModule('puppeteer-extra-plugin-stealth') : null;
78
78
  if (playwrightExtra && stealthPlugin) {
79
- ({ chromium, devices } = playwrightExtra);
79
+ ({ devices } = require('playwright-core'));
80
+ chromium = playwrightExtra.addExtra(require('playwright-core').chromium);
80
81
  const stealth = stealthPlugin();
81
82
  chromium.use(stealth);
82
83
  } else {
83
- ({ chromium, devices } = require('playwright'));
84
+ ({ chromium, devices } = require('playwright-core'));
84
85
  }
85
86
 
86
87
  const dev = devices[deviceName];
@@ -94,6 +95,8 @@ async function main() {
94
95
  try {
95
96
  ctx = await chromium.launchPersistentContext(profileDir, {
96
97
  channel: 'chrome',
98
+ args: ['--disable-blink-features=AutomationControlled'],
99
+ ignoreDefaultArgs: ['--enable-automation'],
97
100
  headless,
98
101
  ...dev,
99
102
  });
@@ -10,9 +10,9 @@
10
10
  * NO-SITE-NAME RULE: this file must never branch on specific hostnames.
11
11
  * All site specifics come from the JSON input (url, waitSelector).
12
12
  *
13
- * Dependencies (install once on target machine):
14
- * npm i -g playwright playwright-extra puppeteer-extra-plugin-stealth
15
- * npx playwright install chrome # system Chrome binary
13
+ * User setup: ../../references/chrome-stealth.md (engine-local dependencies).
14
+ * Chrome must already be installed; optional stealth plugins run only in this script.
15
+ * Execute this script from js eval; profileDir must be task-owned or a CLONED profile.
16
16
  */
17
17
 
18
18
  const fs = require('fs');
@@ -82,18 +82,20 @@ async function main() {
82
82
  const playwrightExtra = requireOptionalModule('playwright-extra');
83
83
  const stealthPlugin = playwrightExtra ? requireOptionalModule('puppeteer-extra-plugin-stealth') : null;
84
84
  if (playwrightExtra && stealthPlugin) {
85
- ({ chromium } = playwrightExtra);
85
+ chromium = playwrightExtra.addExtra(require('playwright-core').chromium);
86
86
  const stealth = stealthPlugin();
87
87
  chromium.use(stealth);
88
88
  } else {
89
- // Fallback to plain playwright (no stealth). Still uses channel:chrome.
90
- ({ chromium } = require('playwright'));
89
+ // Core controls installed Chrome without downloading a managed browser.
90
+ ({ chromium } = require('playwright-core'));
91
91
  }
92
92
 
93
93
  let ctx;
94
94
  try {
95
95
  ctx = await chromium.launchPersistentContext(profileDir, {
96
96
  channel: 'chrome', // real Chrome, not bundled Chromium
97
+ args: ['--disable-blink-features=AutomationControlled'],
98
+ ignoreDefaultArgs: ['--enable-automation'],
97
99
  headless,
98
100
  viewport,
99
101
  });
@@ -0,0 +1,86 @@
1
+ from __future__ import annotations
2
+
3
+ import json
4
+ import os
5
+ import subprocess
6
+ import tempfile
7
+ import unittest
8
+ from pathlib import Path
9
+
10
+ from test_playwright_templates import (
11
+ TEMPLATE_NAMES,
12
+ TEMPLATES_DIR,
13
+ _install_fake_playwright,
14
+ _write_file,
15
+ )
16
+
17
+
18
+ class PlaywrightTemplateStealth(unittest.TestCase):
19
+ def test_extracts_html_and_closes_wrapped_chrome_when_stealth_is_installed(self) -> None:
20
+ for template_name in TEMPLATE_NAMES:
21
+ with self.subTest(template_name=template_name), tempfile.TemporaryDirectory() as tmp:
22
+ # Given: core has no plugin API; only addExtra supplies a registered wrapper.
23
+ root = Path(tmp)
24
+ modules = root / "node_modules"
25
+ profile = root / "profile"
26
+ receipt = root / "launch.json"
27
+ _install_fake_playwright(modules)
28
+ _write_file(modules / "puppeteer-extra-plugin-stealth/index.js", """
29
+ module.exports = () => ({ name: 'stealth' });
30
+ """)
31
+ _write_file(modules / "playwright-extra/index.js", """
32
+ const assert = require('node:assert/strict');
33
+ const fs = require('node:fs');
34
+ exports.addExtra = (core) => {
35
+ assert.equal(core, require('playwright-core').chromium);
36
+ assert.equal(Object.hasOwn(core, 'use'), false);
37
+ const events = ['wrap'];
38
+ let registered = false;
39
+ return {
40
+ use(plugin) {
41
+ assert.equal(plugin.name, 'stealth');
42
+ registered = true;
43
+ events.push(plugin.name);
44
+ },
45
+ async launchPersistentContext(profileDir, options) {
46
+ assert.equal(registered, true);
47
+ events.push({ profileDir, channel: options.channel, viewport: options.viewport });
48
+ const context = await core.launchPersistentContext(profileDir, options);
49
+ return {
50
+ ...context,
51
+ async close() {
52
+ await context.close();
53
+ events.push('close');
54
+ fs.writeFileSync(process.env.STEALTH_RECEIPT, JSON.stringify(events));
55
+ },
56
+ };
57
+ },
58
+ };
59
+ };
60
+ """)
61
+ script = root / template_name
62
+ script.write_bytes((TEMPLATES_DIR / template_name).read_bytes())
63
+ env = {key: value for key, value in os.environ.items() if key != "NODE_PATH"}
64
+ env["STEALTH_RECEIPT"] = str(receipt)
65
+
66
+ # When: the actual bundled entry point consumes its normal stdin protocol.
67
+ result = subprocess.run(
68
+ ["node", str(script)],
69
+ input=json.dumps({"url": "https://example.com/", "profileDir": str(profile), "headless": True}),
70
+ text=True, capture_output=True, timeout=5, env=env, check=False,
71
+ )
72
+
73
+ # Then: HTML arrives through the registered wrapper and the context is closed.
74
+ self.assertEqual(result.returncode, 0, result.stderr)
75
+ self.assertEqual(result.stdout, "<html><article>ok</article></html>")
76
+ self.assertEqual(result.stderr, "")
77
+ viewport = {"width": 390, "height": 844} if "mobile" in template_name else {"width": 1366, "height": 900}
78
+ self.assertEqual(json.loads(receipt.read_text(encoding="utf-8")), [
79
+ "wrap", "stealth",
80
+ {"profileDir": str(profile), "channel": "chrome", "viewport": viewport},
81
+ "close",
82
+ ])
83
+
84
+
85
+ if __name__ == "__main__":
86
+ unittest.main()
@@ -21,7 +21,7 @@ def _write_file(path: Path, content: str) -> None:
21
21
 
22
22
  def _install_fake_playwright(node_modules: Path) -> None:
23
23
  _write_file(
24
- node_modules / "playwright" / "index.js",
24
+ node_modules / "playwright-core" / "index.js",
25
25
  """
26
26
  const page = {
27
27
  async goto() {},
@@ -47,7 +47,6 @@ def _install_fake_playwright(node_modules: Path) -> None:
47
47
  };
48
48
 
49
49
  exports.chromium = {
50
- use() {},
51
50
  async launchPersistentContext() { return context; },
52
51
  };
53
52
  exports.devices = {
@@ -78,9 +77,7 @@ def _install_working_playwright_extra(node_modules: Path) -> None:
78
77
  _write_file(
79
78
  node_modules / "playwright-extra" / "index.js",
80
79
  """
81
- const playwright = require('playwright');
82
- exports.chromium = playwright.chromium;
83
- exports.devices = playwright.devices;
80
+ exports.addExtra = (browserType) => browserType;
84
81
  """,
85
82
  )
86
83
 
@@ -149,7 +146,7 @@ def _run_template(
149
146
 
150
147
  @unittest.skipUnless(shutil.which("node"), "node is required for Playwright template tests")
151
148
  class PlaywrightTemplateErrorHandling(unittest.TestCase):
152
- def test_missing_playwright_extra_warns_and_falls_back_to_plain_playwright(self) -> None:
149
+ def test_missing_playwright_extra_warns_and_falls_back_to_playwright_core(self) -> None:
153
150
  for template_name in TEMPLATE_NAMES:
154
151
  with self.subTest(template_name=template_name):
155
152
  result = _run_template(
@@ -166,7 +163,7 @@ class PlaywrightTemplateErrorHandling(unittest.TestCase):
166
163
  self.assertIn("best-effort optional module playwright-extra failed:", result.stderr)
167
164
  self.assertIn("Cannot find module 'playwright-extra'", result.stderr)
168
165
 
169
- def test_missing_stealth_plugin_warns_and_falls_back_to_plain_playwright(self) -> None:
166
+ def test_missing_stealth_plugin_warns_and_falls_back_to_playwright_core(self) -> None:
170
167
  for template_name in TEMPLATE_NAMES:
171
168
  with self.subTest(template_name=template_name):
172
169
  result = _run_template(
@@ -1,127 +1,113 @@
1
- # Tier 2 — Chrome stealth (CloakBrowser + agent-browser)
1
+ # Tier 2 — Chrome stealth through playwright-core scripts
2
2
 
3
- Real interaction (clicks, forms, screenshots, video, persistent login) for pages that defeat Tier 1/1.5. Two runtime tools, both installed on demand — neither is vendored in this skill:
4
-
5
- - **CloakBrowser** (`pip`) — stealth Chromium with source-level C++ fingerprint patches. The Python wrapper source is MIT; the downloaded Chromium binary is covered by CloakBrowser's separate binary license and is not redistributed by this package. Passes Cloudflare Turnstile, FingerprintJS, BrowserScan, and 30+ detectors. Pin **0.5.7**.
6
- - **agent-browser** (`npm`, Apache-2.0) — native CDP automation CLI that drives CloakBrowser. AX-tree snapshots, `@eN` refs, click/fill/type/scroll, screenshots, video, cookie/state/session management. Pin **0.34.0**.
7
-
8
- ```
9
- CloakBrowser (stealth Chromium) <- CDP port 9242 -> agent-browser CLI
10
- - 57 C++ fingerprint patches - AX-tree snapshots, @eN refs
11
- - Canvas/WebGL consistency - click / fill / type / scroll
12
- - navigator.webdriver = false at C++ source - screenshot, video record
13
- - Humanize mode (mouse curves, timing) - cookie / state / session mgmt
14
- ```
3
+ For real-Chrome semantics, stealth, traces, or authenticated sessions, WRITE a
4
+ script and run it from the js-eval kernel. Use installed local Chrome, not a
5
+ managed browser download. Ordinary macOS captures on a Bun >= 1.4 kernel use
6
+ `new Bun.WebView()`; Linux/Windows WebView needs installed Chrome/Chromium/Edge.
7
+ Codex's ordinary browser surface is `browser:control-in-app-browser`.
15
8
 
16
9
  ## Install (one-time)
17
10
 
18
- CloakBrowser runs in a dedicated Python venv. Cross-platform: macOS, Linux, and Windows all supported by both tools (use the venv path convention for your OS).
19
-
20
- The venv lives at a fixed path so every session reuses one stealth-Chromium download instead of creating a new venv per working directory, and every command below calls its interpreter by absolute path — no `activate` step to forget.
21
-
22
- ```bash
23
- # CloakBrowser (MIT wrapper source; separate binary license, pin 0.5.7):
24
- VENV="$HOME/.agents/cloak-venv" # Windows: %USERPROFILE%\.agents\cloak-venv
25
- uv venv "$VENV" --python 3.13
26
- uv pip install --python "$VENV/bin/python" "cloakbrowser==0.5.7"
27
- "$VENV/bin/python" -c "import cloakbrowser; cloakbrowser.ensure_binary()" # downloads stealth Chromium on first import
11
+ Only the user installs these script dependencies, once in the skill's engine
12
+ directory. Stealth plugins run inside scripts, never inside WebView:
28
13
 
29
- # agent-browser (Apache-2.0, pin 0.34.0):
30
- bun add -g agent-browser@0.34.0 && agent-browser install
31
- agent-browser --version # 0.34.0
14
+ ```sh
15
+ cd "$SKILL_DIR/engine"
16
+ test -f package.json || cp templates/package.json package.json
17
+ bun add playwright-core@1.62.1 playwright-extra@4.3.6 puppeteer-extra-plugin-stealth@2.11.2
32
18
  ```
33
19
 
34
- Verify CloakBrowser:
35
-
36
- ```bash
37
- "$VENV/bin/python" -c "import cloakbrowser; print(cloakbrowser.__version__, cloakbrowser.CHROMIUM_VERSION, cloakbrowser.binary_info()['installed'])"
38
- # -> 0.5.7 <chromium-version> True
39
- ```
20
+ Chrome must already be installed. The bundled `templates/playwright_real_chrome.js`
21
+ and `templates/playwright_mobile_chrome.js` resolve these dependencies from their
22
+ parent engine directory. Without optional plugins, templates report the fallback
23
+ and use plain `playwright-core`; do not call that fallback stealth.
40
24
 
41
25
  ## Launch + drive
42
26
 
43
- NEVER clear cookies, cache, or site data (`Network.clearBrowserCookies`, `Storage.clearCookies`, `chrome.browsingData.remove`, "clear browsing data") on the user's real/main browser profile — it wipes their logged-in state everywhere. If you need that profile's login state, clone it first (`rsync -a <profile>/ <tmp-clone>/`) and launch with the clone as the user-data-dir; run any clearing on the clone only.
44
-
45
- ```bash
46
- # 1. Launch CloakBrowser with CDP on :9242 (background). cloakbrowser lives only in the venv,
47
- # so call its interpreter by absolute path — this works in any shell, activated or not:
48
- "$HOME/.agents/cloak-venv/bin/python" -c "import asyncio,cloakbrowser; asyncio.run(cloakbrowser.launch_async(headless=False, stealth_args=True, args=['--remote-debugging-port=9242']))" &
49
-
50
- # 2. CloakBrowser launches tabless -> agent-browser would say "No page found".
51
- # Open the first tab via CDP before any agent-browser command:
52
- curl -s -X PUT "http://127.0.0.1:9242/json/new?https://example.com"
53
-
54
- # 3. Connect agent-browser. CloakBrowser already patches navigator.webdriver=false at the
55
- # C++ source, so NO --init-script is required — only --user-agent to hide HeadlessChrome:
56
- agent-browser --cdp 9242 \
57
- --user-agent "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.7680.177 Safari/537.36" \
58
- open https://example.com
59
-
60
- # 4. Interact:
61
- agent-browser --cdp 9242 snapshot -i # interactive elements (@eN refs)
62
- agent-browser --cdp 9242 click @e3
63
- agent-browser --cdp 9242 screenshot out.png
64
-
65
- # 5. Close when done:
66
- agent-browser --cdp 9242 close
27
+ Close the source browser before cloning its user-data directory for a consistent
28
+ copy. Preserve its `Local State` alongside the selected profile. Use a private,
29
+ task-owned clone, never the live user-data-dir. NEVER clear the live profile's
30
+ cookies, cache, or site data. For unauthenticated QA, use a fresh task-owned profile.
31
+
32
+ Write `capture.cjs` in the engine directory. `clonePath`, URL, and output path are
33
+ arguments owned by this QA run; keep cookie values out of argv and logs:
34
+
35
+ ```js
36
+ const { chromium: core } = require('playwright-core');
37
+ const { addExtra } = require('playwright-extra');
38
+ const stealth = require('puppeteer-extra-plugin-stealth');
39
+ const [clonePath, url, pngPath] = process.argv.slice(2);
40
+ const chromium = addExtra(core);
41
+ chromium.use(stealth());
42
+
43
+ async function capture() {
44
+ const context = await chromium.launchPersistentContext(clonePath, {
45
+ channel: 'chrome',
46
+ headless: true,
47
+ args: ['--disable-blink-features=AutomationControlled'],
48
+ ignoreDefaultArgs: ['--enable-automation'],
49
+ viewport: { width: 1280, height: 720 },
50
+ });
51
+ try {
52
+ const page = await context.newPage();
53
+ await page.goto(url, { waitUntil: 'load', timeout: 30000 });
54
+ await page.screenshot({ path: pngPath });
55
+ console.log(JSON.stringify({ pngPath, webdriver: await page.evaluate(() => navigator.webdriver) }));
56
+ } finally {
57
+ await context.close();
58
+ }
59
+ }
60
+ capture().catch((error) => { console.error(error); process.exitCode = 1; });
67
61
  ```
68
62
 
69
- agent-browser ships its own always-version-matched usage guide — load it instead of guessing flags:
63
+ Run the script from js eval with a bounded process lifetime:
70
64
 
71
- ```bash
72
- agent-browser skills get core # core workflows, patterns, troubleshooting
73
- agent-browser skills get core --full # + full command reference and templates
74
- agent-browser skills get electron # Electron apps (VS Code, Slack, Discord, Figma, ...)
75
- agent-browser skills list # everything available on the installed version
65
+ ```js
66
+ const { promisify } = await import('node:util')
67
+ const { execFile } = await import('node:child_process')
68
+ const result = await promisify(execFile)('node', [scriptPath, clonePath, url, pngPath], { timeout: 45000 })
69
+ console.log(result.stdout)
76
70
  ```
77
71
 
78
- ## Verify stealth
79
-
80
- ```bash
81
- agent-browser --cdp 9242 eval 'navigator.webdriver' # must print false
82
- ```
72
+ For extraction, run a bundled template the same way, supplying its JSON input on
73
+ stdin (`url`, `profileDir: clonePath`, `waitSelector`, `headless`). The template
74
+ returns HTML on stdout. For traces, use `context.tracing.start()` before navigation
75
+ and `context.tracing.stop({ path: tracePath })` before closing. Use `headless: false`
76
+ only with an available display when headed behavior is the criterion.
83
77
 
84
- Verified 2026-07 with CloakBrowser 0.5.7 + agent-browser 0.34.0: `navigator.webdriver` reads the boolean false with no init-script, bot.sannysoft.com all-green, browserscan.net "Normal" (15/15), nowsecure.nl Turnstile bypassed.
78
+ ## Verify stealth
85
79
 
86
- > **agent-browser 0.33.x behavior note:** the daemon now defaults to a 1-hour idle timeout (saves restore state, closes the browser, exits after 1 h of no commands). Set `AGENT_BROWSER_IDLE_TIMEOUT_MS=0` to restore the old always-persist behavior. External WebSocket stream consumers see latest-wins frame delivery; `record` (CDP) and the dashboard are unaffected.
80
+ Inspect the page, screenshot, and requested content. `navigator.webdriver === false`
81
+ checks one browser property, NOT a promise to pass a detector or challenge.
82
+ Persistent challenge pages or missing content are failures, even if the script
83
+ exits zero. Do not keep retrying or silently swap browser tooling.
87
84
 
88
85
  ## Cookie login (cross-platform)
89
86
 
90
- `scripts/extract_cookies.py` reads cookies from a local browser profile and optionally injects them into the running CDP session. Profile-path resolution and value decryption are per-OS:
87
+ `scripts/extract_cookies.py` exports local-browser cookies with owner-only `0600`
88
+ permissions. Keep exports private and never commit them. For a persistent context,
89
+ load the exported cookies with `context.addCookies(...)`, then navigate/reload.
90
+ Browser- or device-bound login tokens may not transfer to a clone.
91
91
 
92
- | OS | Profile location | Cookie value decryption |
93
- |----|------------------|--------------------------|
94
- | macOS | `~/Library/Application Support/<app>/` | Keychain (AES-128-CBC, PBKDF2 salt `saltysalt`) |
95
- | Linux | `~/.config/<app>/` (Chromium), `~/.mozilla/firefox/` (Firefox) | libsecret/SecretService, then PBKDF2 + AES-128-CBC |
96
- | Windows | `%LOCALAPPDATA%\<app>\User Data\` | DPAPI (`CryptUnprotectData`) + AES-256-GCM (`os_crypt` key) |
97
-
98
- ```bash
99
- # Extract to a file:
100
- mkdir -p ~/.local/state/omo-cookies
101
- python3 ../scripts/extract_cookies.py --browser chrome --domain youtube.com --output ~/.local/state/omo-cookies/youtube.cookies.json
102
- # Extract and inject into the running CDP session:
103
- python3 ../scripts/extract_cookies.py --browser chrome --domain youtube.com --inject --cdp 9242
104
- ```
105
-
106
- Cookie export files are written with owner-only `0600` permissions. Do not place live auth cookies in shared temp directories or commit them to a repo. Cookie injection sends values to CDP over stdin rather than argv, so live cookie values do not appear in process listings. Cookies apply on next navigation — reload after injecting. Google services use fingerprint-bound tokens (SIDTS) that may not transfer across browser profiles. Firefox-family profiles store cookies unencrypted; Chromium-family profiles trigger a one-time OS-keyring prompt on macOS/Linux.
92
+ The helper's `--inject --cdp <port>` targets a task-owned local Chrome CDP endpoint,
93
+ which a script can also use via `chromium.connectOverCDP(...)`. Expose CDP on
94
+ loopback only, never against the live profile. Values travel on stdin, not argv.
107
95
 
108
96
  ## Anti-patterns
109
97
 
110
- - Do NOT launch CloakBrowser for plain text extraction — use Tier 1.
111
- - Do NOT pass an `--init-script` for the webdriver flag — CloakBrowser already patches it at source; the only required override is `--user-agent`.
112
- - Do NOT run agent-browser before creating the first tab via `curl -X PUT .../json/new` — CloakBrowser launches tabless.
113
- - Do NOT use vanilla Chrome when stealth is needed — always CloakBrowser.
114
- - Do NOT forget to `close` the session when done.
115
- - Do NOT inject cookies without reloading the page.
98
+ - Plain text extraction does not need a stealth browser: use the extraction lane.
99
+ - Never launch against, clear, or delete the user's live profile.
100
+ - Never claim stealth from successful startup alone; validate rendered content.
101
+ - Never run plugins without explicit user-installed script dependencies.
116
102
 
117
103
  ## Troubleshooting
118
104
 
119
- ```bash
120
- # Port 9242 already in use (macOS/Linux):
121
- lsof -ti:9242 | xargs kill -9
122
- # agent-browser can't connect:
123
- curl -s http://127.0.0.1:9242/json/version | head -5 # empty -> CloakBrowser not running
124
- # Update either tool:
125
- uv pip install --python "$HOME/.agents/cloak-venv/bin/python" --upgrade "cloakbrowser==0.5.7" && "$HOME/.agents/cloak-venv/bin/python" -c "import cloakbrowser; cloakbrowser.ensure_binary()"
126
- bun add -g agent-browser@0.34.0
127
- ```
105
+ A missing Chrome executable is a prerequisite failure: report it, do not download
106
+ a replacement. Missing plugins require the one-time setup above; module errors
107
+ inside installed plugins are real failures, not optional-dependency misses.
108
+ A locked profile usually means the source was not cloned or another run owns the
109
+ clone. Use a new task-owned clone instead of killing unrelated browsers.
110
+
111
+ Always close contexts in `finally`, stop the fixture server, and remove only this
112
+ run's clone and temporary scripts. Preserve requested PNG/trace evidence and record
113
+ the cleanup receipt, including failures.
@@ -223,11 +223,17 @@ result = fetch(
223
223
  python3 -c "import curl_cffi, bs4, yaml" 2>/dev/null || pip install curl_cffi beautifulsoup4 pyyaml -q
224
224
  ```
225
225
 
226
- Playwright 로컬 경로 사용 시 Node가 필요:
226
+ 브라우저를 직접 제어할 때는 js eval에서 Bun >= 1.4의 `new Bun.WebView()`를
227
+ 사용한다(macOS 기본; Linux/Windows는 설치된 Chrome/Chromium/Edge 필요).
228
+ 그 외 또는 Chrome 동작·stealth·trace·인증이 필요하면 `playwright-core` 스크립트를
229
+ 작성해 js eval에서 로컬 Chrome(`channel: "chrome"`)으로 실행한다.
230
+ 사용자가 엔진 디렉터리에서 한 번 설치할 스크립트 의존성:
227
231
  ```bash
228
- npm i -g playwright playwright-extra puppeteer-extra-plugin-stealth
229
- npx playwright install chrome
232
+ cd "$SKILL_DIR/engine"
233
+ test -f package.json || cp templates/package.json package.json
234
+ bun add playwright-core@1.62.1 playwright-extra@4.3.6 puppeteer-extra-plugin-stealth@2.11.2
230
235
  ```
236
+ Chrome은 이미 설치되어 있어야 한다. 인증 프로필은 먼저 복제하고 복제본만 사용한다.
231
237
 
232
238
  ## 빠른 참조 — Phase 0 명령어
233
239
 
@@ -16,10 +16,10 @@
16
16
 
17
17
  ### 의존성
18
18
 
19
- ```bash
20
- claude mcp list 2>/dev/null | grep -q playwright && echo "OK" || echo "NOT CONNECTED"
21
- claude mcp add playwright -- npx @playwright/mcp@latest
22
- ```
19
+ 이 항목은 이미 연결된 MCP를 사용하는 엔진 어댑터의 설명이다.
20
+ 새 브라우저 세션은 js eval의 Bun.WebView(Bun >= 1.4, macOS 기본;
21
+ Linux/Windows는 설치된 Chrome/Chromium/Edge 필요), 그 외 또는 Chrome 동작·stealth·trace·인증은
22
+ 로컬 Chrome을 제어하는 `playwright-core` 스크립트로 실행한다. MCP를 새로 설치하지 않는다.
23
23
 
24
24
  ### 기본 워크플로
25
25
 
@@ -56,11 +56,11 @@ claude mcp add playwright -- npx @playwright/mcp@latest
56
56
  # Node (시스템 설치)
57
57
  node -v # v18+ 권장
58
58
 
59
- # Playwright + stealth 플러그인
60
- npm i -g playwright playwright-extra puppeteer-extra-plugin-stealth
61
-
62
- # 시스템 Chrome 바이너리 (번들 Chromium 아님)
63
- npx playwright install chrome
59
+ # 사용자가 엔진 디렉터리에서 한 번 설치하는 스크립트 의존성
60
+ cd "$SKILL_DIR/engine"
61
+ test -f package.json || cp templates/package.json package.json
62
+ bun add playwright-core@1.62.1 playwright-extra@4.3.6 puppeteer-extra-plugin-stealth@2.11.2
63
+ # Chrome은 이미 시스템에 설치되어 있어야 한다. 브라우저 다운로드 명령은 없다.
64
64
  ```
65
65
 
66
66
  ### 호출 (engine 내부)
@@ -81,7 +81,8 @@ attempt, html = run_playwright_fallback(
81
81
  ### 데스크톱 템플릿 (`playwright_real_chrome.js`)
82
82
 
83
83
  ```js
84
- const { chromium } = require('playwright-extra');
84
+ const { addExtra } = require('playwright-extra');
85
+ const chromium = addExtra(require('playwright-core').chromium);
85
86
  const stealth = require('puppeteer-extra-plugin-stealth')();
86
87
  chromium.use(stealth);
87
88
 
@@ -95,7 +96,9 @@ const ctx = await chromium.launchPersistentContext(profileDir, {
95
96
  ### 모바일 템플릿 (`playwright_mobile_chrome.js`)
96
97
 
97
98
  ```js
98
- const { chromium, devices } = require('playwright-extra');
99
+ const { devices } = require('playwright-core');
100
+ const { addExtra } = require('playwright-extra');
101
+ const chromium = addExtra(require('playwright-core').chromium);
99
102
  const iPhone = devices['iPhone 13 Pro'];
100
103
 
101
104
  const ctx = await chromium.launchPersistentContext(profileDir, {
@@ -126,8 +129,8 @@ const ctx = await chromium.launchPersistentContext(profileDir, {
126
129
 
127
130
  ## 디버깅 팁
128
131
 
129
- - `profileDir`를 고정 경로로 두면 세션·쿠키가 유지되어 재시도 빠름 (`/tmp/.insane_pw_profile`)
130
- - Akamai 재시도가 잦으면 `profileDir`를 삭제해 fresh 상태로 리셋
132
+ - 템플릿은 js eval에서 스크립트로 실행한다. `profileDir`는 작업 전용 경로나 사용자 프로필의 복제본만 사용한다.
133
+ - 사용자의 실제 프로필을 실행·초기화·삭제하지 않는다. 작업 종료 시 컨텍스트를 닫고 작업 전용 복제본만 정리한다.
131
134
  - 실패 시 `result.trace`의 `error` 필드에 Node stderr 200자가 포함됨
132
135
 
133
136
  ## 사이트 예시 (독자 이해용, 코드 분기 근거 아님)
@@ -4,7 +4,7 @@
4
4
  The OS-keyring lookup is an injected boundary: cookie_paths resolves profile
5
5
  paths and cookie_crypto derives keys + decrypts values, both pure and testable
6
6
  with synthetic fixtures on any OS. This module wires them to a real browser DB
7
- and the agent-browser CDP session.
7
+ and a local Chrome CDP session controlled by playwright-core scripts.
8
8
 
9
9
  Usage:
10
10
  python extract_cookies.py --browser chrome --domain youtube.com --output /tmp/cookies.json
@@ -255,7 +255,7 @@ def inject_cookies(cookies: list[CookieRecord], cdp_port: int) -> None:
255
255
  if proc.returncode != 0:
256
256
  raise RuntimeError((proc.stderr or "CDP cookie injection failed").strip())
257
257
  ok = int((proc.stdout or "0").strip() or "0")
258
- print(f"Injected {ok}/{len(filtered)} cookies into agent-browser (CDP {cdp_port})")
258
+ print(f"Injected {ok}/{len(filtered)} cookies into local Chrome (playwright-core CDP {cdp_port})")
259
259
 
260
260
 
261
261
  def main() -> None:
@@ -263,7 +263,7 @@ def main() -> None:
263
263
  parser.add_argument("--browser", required=True, choices=sorted(BROWSERS.keys()))
264
264
  parser.add_argument("--domain", required=True, action="append", dest="domains")
265
265
  parser.add_argument("--output", help="Write cookies JSON to file")
266
- parser.add_argument("--inject", action="store_true", help="Inject into agent-browser")
266
+ parser.add_argument("--inject", action="store_true", help="Inject into the local Chrome CDP endpoint used by a playwright-core script")
267
267
  parser.add_argument("--cdp", type=int, default=9242, help="CDP port (default 9242)")
268
268
  args = parser.parse_args()
269
269
 
@@ -69,16 +69,17 @@ exercises the surface; capture the artifact.
69
69
  for color / layout / CJK evidence, which degrades truecolor.
70
70
  3. Browser use — in Codex, use `browser:control-in-app-browser`
71
71
  first when available and no authenticated/persistent user browser
72
- profile is required. Otherwise use Chrome to drive the REAL page;
73
- if Chrome is not available, download and use agent-browser
74
- (https://github.com/vercel-labs/agent-browser). Capture action
72
+ profile is required. Otherwise, or for Chrome semantics, stealth,
73
+ or trace, WRITE a `playwright-core` script and run it from js eval
74
+ against local Chrome (`chromium.launch({ channel: "chrome" })` /
75
+ `launchPersistentContext` on a CLONED profile). Capture action
75
76
  log + screenshot path. Never downgrade to a non-browser surface
76
77
  for a browser-facing criterion. NEVER clear cookies, cache, or
77
78
  site data (`Network.clearBrowserCookies`, `Storage.clearCookies`,
78
79
  `chrome.browsingData.remove`, "clear browsing data") on the user's
79
80
  real/main browser profile — it wipes their logged-in state. If you
80
81
  need that profile's login state, clone it first (`rsync -a
81
- <profile>/ <tmp-clone>/`) and launch Chrome / agent-browser against
82
+ <profile>/ <tmp-clone>/`) and launch Chrome against
82
83
  the clone as the user-data-dir; run any clearing there only.
83
84
  4. Computer use — when the surface is a desktop/GUI app rather than a
84
85
  page, drive it via OS-level automation (a computer-use agent,
@@ -169,7 +169,7 @@ Each sub-task message must include:
169
169
  5. One Manual-QA channel, named with the exact tool and exact invocation (the literal `curl`, `send-keys`, `browser:control-in-app-browser` action, `page.click`, payload, selectors, and the binary observable that decides PASS/FAIL), not "verify it works". A LIGHT checkbox needs one real-surface proof of its deliverable, and auxiliary surfaces (CLI stdout, DB state diff, parsed config dump) are first-class when the surface is CLI- or data-shaped:
170
170
  - HTTP call: `curl -i` against the live endpoint.
171
171
  - Terminal / TUI: drive a real pty; `tmux send-keys` is fine for a boot/behavior smoke, but color/layout/CJK evidence goes through the xterm.js web terminal below, NEVER `tmux capture-pane`.
172
- - Browser use: prefer the harness's in-app browser control when available and the scenario does not need an authenticated or persistent user browser profile; otherwise drive the real page with Chrome, or agent-browser (https://github.com/vercel-labs/agent-browser) when Chrome is unavailable.
172
+ - Browser use: from js eval, use `new Bun.WebView()` on Bun >= 1.4 (macOS default; Linux/Windows need Chrome/Chromium/Edge). Otherwise, or for Chrome semantics, stealth, trace, or auth, write and run a `playwright-core` script against local Chrome (`channel: "chrome"`; persistent context on a CLONED profile). Codex: `browser:control-in-app-browser` for ordinary page control.
173
173
  - Computer use: OS-level GUI automation against the running desktop app when the surface is not a page.
174
174
  - TUI visual evidence: when a TUI claim needs visual QA or PR proof, run `bun script/qa/web-terminal-visual-qa.mjs --command "<cmd>" --input "{Enter}" --evidence-dir <dir>` (real pty rendered through xterm.js in Chrome) and attach `terminal.png` plus `metadata.json`.
175
175
  6. The adversarial classes that apply to this sub-task (from the 9 ultraqa classes) and how each is probed.
@@ -20,7 +20,7 @@ Run each criterion's real-surface proof yourself through the channel that faithf
20
20
 
21
21
  1. **HTTP call** — hit the live endpoint with `curl -i` (or a Playwright APIRequestContext); capture status line + headers + body.
22
22
  2. **Terminal / TUI** - prove it through the xterm.js web terminal; tmux `send-keys` is fine for a boot smoke, but NEVER `tmux capture-pane` for color/layout/CJK evidence (it degrades truecolor).
23
- 3. **Browser use** — in Codex, use `browser:control-in-app-browser` first when available and the scenario does not need an authenticated or persistent user browser profile. Otherwise use Chrome to drive the REAL page; if unavailable, use agent-browser. Capture action log + screenshot path. Never downgrade a browser-facing criterion.
23
+ 3. **Browser use** — in Codex, prefer `browser:control-in-app-browser`. Otherwise, or for Chrome semantics, stealth, trace, or auth, WRITE a `playwright-core` script and run it from js eval against local Chrome (`channel: "chrome"`; persistent context on a CLONED profile, never the live one). Capture action log + screenshot path. Never downgrade a browser-facing criterion.
24
24
  4. **Computer use** — for desktop/GUI apps, drive the running app via OS automation (computer-use, AppleScript, xdotool, etc.); capture action log + screenshot.
25
25
 
26
26
  For TUI visual QA (mandatory when a PR or review must inspect the terminal screen),
@@ -165,7 +165,7 @@ Loop per goal. Cap at 5 cycles per goal. Cap identical same-criterion failures a
165
165
  4. INTEGRATE + CRITICAL SELF-QA + GIT CHECKPOINT (EVERY WORKER RETURN): do NOT trust the worker's report. Read the diff yourself, re-run its tests, and run LSP diagnostics on the changed files. Treat "done" as a claim to disprove. If the diff drifts, the test is hollow, or evidence is missing, RESPAWN the worker with the specific failure context. Once the work unit is verified, use `git-master` before staging: inspect recent repository commits and touched-path history to infer commit language, Conventional Commit scope, message shape, and unit size. Stage only that unit's files and commit in the observed style; do not carry verified work forward into a later omnibus commit. If no git-tracked files changed or committing is unsafe, record the no-commit reason as evidence. Forward every finding/learning to subsequent workers.
166
166
  5. EXECUTE-AS-SCENARIO: ACTUALLY run the Manual-QA scenario the criterion named (channel table above). Run it yourself for the orchestrator check; for heavier flows dispatch a dedicated QA execution worker (`lazycodex-worker-medium` by default; `lazycodex-worker-high` when the QA flow itself is hard) whose ONLY job is to drive the channel and write the artifact to the named evidence path. If the scenario FAILS, respawn the implementing worker with the captured failure — do not hand-patch around it.
167
167
  6. CAPTURE: collect the observable artifact path: transcript, stdout, screenshot, assertion, status+body, diff, or parsed dump. No artifact written at the evidence path — not done; record BLOCKED and respawn QA.
168
- 7. CLEAN (PAIRED, NEVER SKIP): tear down every runtime artifact step 5 spawned BEFORE recording — server PIDs (`kill`, verify `kill -0` fails), `tmux` sessions (`tmux kill-session -t ulw-qa-<criterion>`; confirm `tmux ls`), browser / Playwright contexts (`.close()`), containers (`docker rm -f`), bound ports (`lsof -i :<port>` empty), temp sockets / files / dirs (`rm -rf` the `mktemp` paths), QA-only env vars, AND close every finished worker (v1 `close_agent`; on V2 finished workers end on their own — `interrupt_agent` any still running). Register each teardown as its own todo the moment the QA spawns the resource (scripts, tmux assets, browsers / agent-browser sessions, PIDs, ports) so none is forgotten. Embed a one-line cleanup receipt in the evidence string, e.g. `cleanup: killed 12345; tmux kill-session ulw-qa-foo; rm -rf /tmp/ulw.aB12cD; interrupt_agent w-3`. Missing receipt → record BLOCKED, not PASS.
168
+ 7. CLEAN (PAIRED, NEVER SKIP): tear down every runtime artifact step 5 spawned BEFORE recording — server PIDs (`kill`, verify `kill -0` fails), `tmux` sessions (`tmux kill-session -t ulw-qa-<criterion>`; confirm `tmux ls`), browser / Playwright contexts (`.close()`), containers (`docker rm -f`), bound ports (`lsof -i :<port>` empty), temp sockets / files / dirs (`rm -rf` the `mktemp` paths), QA-only env vars, AND close every finished worker (v1 `close_agent`; on V2 finished workers end on their own — `interrupt_agent` any still running). Register each teardown as its own todo the moment the QA spawns the resource (scripts, tmux assets, browser contexts, PIDs, ports) so none is forgotten. Embed a one-line cleanup receipt in the evidence string, e.g. `cleanup: killed 12345; tmux kill-session ulw-qa-foo; rm -rf /tmp/ulw.aB12cD; interrupt_agent w-3`. Missing receipt → record BLOCKED, not PASS.
169
169
  8. RECORD one result immediately from the artifact you just wrote — never from memory or a later turn — stamping the capture tree `$(git rev-parse --short "HEAD^{tree}")` into the evidence:
170
170
  - PASS: `omo-agent-toolkit ulw-loop record-evidence --goal-id <id> --criterion-id <id> --status pass --evidence "<observable> @tree:<short-tree> | <cleanup receipt>" --json`
171
171
  - FAIL: `omo-agent-toolkit ulw-loop record-evidence --goal-id <id> --criterion-id <id> --status fail --evidence "<observable> @tree:<short-tree> | <cleanup receipt>" --notes "<diagnosis>" --json`