@tea-agent/loop-agent 0.35.1-beta.0 → 0.35.1-beta.2

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 (179) hide show
  1. package/AGENTS.md +110 -108
  2. package/CHANGELOG.md +24 -26
  3. package/README.md +165 -165
  4. package/bin/agent-worker.js +0 -0
  5. package/bin/loop-agent.js +57 -21
  6. package/dist/application/task-lifecycle/advance.js +0 -1
  7. package/dist/build-stamp.json +6 -0
  8. package/dist/cli/program.js +2 -2
  9. package/dist/commands/cursor-prompt.js +6 -6
  10. package/dist/commands/init-upgrade.js +19 -351
  11. package/dist/commands/init.js +67 -14
  12. package/dist/commands/loop-benchmark.js +11 -11
  13. package/dist/commands/pi-reuse-benchmark.js +16 -16
  14. package/dist/commands/run-dag-progress.js +0 -14
  15. package/dist/commands/task-advance.js +3 -33
  16. package/dist/executors/dag-pi-executor.js +44 -0
  17. package/dist/shared/operator/capabilities.js +1 -38
  18. package/dist/shared/package-metadata.js +42 -0
  19. package/dist/sidecars/cursor-prompt/executor.js +1 -1
  20. package/dist/worker/console/chat/pi-runtime.js +25 -41
  21. package/dist/worker/console/chat/routes.js +4 -27
  22. package/dist/worker/console/operation-runner.js +0 -24
  23. package/dist/worker/console/operator-actions.js +0 -58
  24. package/dist/worker/console/static/assets/index-CvsQgALl.js +56 -0
  25. package/dist/worker/console/static/assets/{index-Dups4sSM.css → index-hJqCPs_g.css} +1 -1
  26. package/dist/worker/console/static/index.html +2 -2
  27. package/dist/worker/console/static-src/app/useRecoveryConsole.js +5 -0
  28. package/dist/worker/console/static-src/operator-chat/useChatSessions.js +2 -13
  29. package/dist/worker/console/static-src/operator-chat/useComposer.js +7 -30
  30. package/dist/worker/loop-agent/loop-agent-client.js +17 -3
  31. package/dist/worker/observability/read-model.js +20 -0
  32. package/dist/worker/observe/static/copy.js +67 -67
  33. package/dist/worker/observe/static/dag-layout.d.ts +36 -36
  34. package/dist/worker/observe/static/dom.js +220 -220
  35. package/dist/worker/observe/static/relations.js +133 -133
  36. package/dist/worker/observe/static/run-processing.js +148 -148
  37. package/dist/worker/observe/static/views/batch.js +227 -227
  38. package/dist/worker/observe/static/views/failures.js +143 -143
  39. package/dist/worker/observe/static/views/feature.js +492 -492
  40. package/dist/worker/observe/static/views/run.js +453 -453
  41. package/dist/worker/observe/static/views/shell.js +7 -7
  42. package/dist/worker/observe/static/views/timeline.js +163 -163
  43. package/dist/worker/preflight.js +2 -1
  44. package/dist/workflows/dag/backend-test-scenario-param.js +33 -23
  45. package/dist/workflows/dag/canvas-observer.js +275 -275
  46. package/dist/workflows/dag/contract-output-registry.js +14 -0
  47. package/dist/workflows/dag/contract-validator-registrations.js +8 -0
  48. package/dist/workflows/dag/dynamic-runtime/shared.js +9 -1
  49. package/dist/workflows/dag/frontend-implementation-contract.js +233 -39
  50. package/dist/workflows/dag/frontend-prewrite-gate.js +364 -61
  51. package/dist/workflows/dag/frontend-recovery-plan.js +73 -0
  52. package/dist/workflows/dag/frontend-recovery-root-manifest.js +123 -0
  53. package/dist/workflows/dag/frontend-recovery-run.js +539 -0
  54. package/dist/workflows/dag/frontend-repair.js +219 -18
  55. package/dist/workflows/dag/frontend-verification-trace.js +47 -32
  56. package/dist/workflows/dag/frontend-writer-recovery.js +106 -0
  57. package/dist/workflows/dag/frontend-writer-rollback.js +821 -0
  58. package/dist/workflows/dag/init-hybrid.js +41 -24
  59. package/dist/workflows/dag/node-execution.js +89 -0
  60. package/dist/workflows/dag/recovery-recommendation.js +58 -0
  61. package/dist/workflows/dag/runner.js +245 -11
  62. package/dist/workflows/dag/scheduler.js +257 -3
  63. package/dist/workflows/dag/types.js +130 -2
  64. package/docs/architecture/evolution.md +73 -73
  65. package/docs/architecture/system-overview.md +100 -100
  66. package/docs/architecture/worker-and-feature.md +122 -122
  67. package/docs/skills/README.md +7 -7
  68. package/docs/templates/adr.md +60 -60
  69. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  70. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  71. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  72. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  73. package/docs/templates/agent-dag-report.schema.json +473 -473
  74. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  75. package/docs/templates/backend-test-result.schema.json +99 -99
  76. package/docs/templates/evaluation/agents-map-slim-v1.md +87 -87
  77. package/docs/templates/evaluation/agents-map-verbose-v0.md +153 -153
  78. package/docs/templates/feature-spec.md +53 -53
  79. package/docs/templates/frontend-design-contract.md +42 -42
  80. package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -17
  81. package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -16
  82. package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -16
  83. package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -16
  84. package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -16
  85. package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -16
  86. package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -21
  87. package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -29
  88. package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -28
  89. package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -28
  90. package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -29
  91. package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -27
  92. package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -28
  93. package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -28
  94. package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -27
  95. package/docs/templates/frontend-eval/metrics.md +138 -138
  96. package/docs/templates/frontend-eval/smoke-targets.md +53 -53
  97. package/docs/templates/frontend-task-constraints.md +35 -35
  98. package/docs/templates/frontend-task-requirement.md +70 -70
  99. package/docs/templates/init-evolution-review.md +35 -35
  100. package/docs/templates/init-managed-agents.md +154 -156
  101. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  102. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
  103. package/docs/templates/knowledge-sync-dag.json +178 -178
  104. package/docs/templates/knowledge-sync-draft.schema.json +71 -71
  105. package/docs/templates/product-line/closeout.yaml +9 -9
  106. package/docs/templates/product-line/design.md +13 -13
  107. package/docs/templates/product-line/links.md +10 -10
  108. package/docs/templates/product-line/requirement.md +17 -17
  109. package/docs/templates/product-line/test-plan.md +7 -7
  110. package/docs/templates/project-start-checklist.md +9 -9
  111. package/docs/templates/qa-report.md +48 -48
  112. package/docs/templates/sprint-contract.md +29 -29
  113. package/docs/templates/worker-dogfood-evidence.md +80 -80
  114. package/docs/templates/worker-dogfood-setup.md +68 -68
  115. package/harness.json +2 -5
  116. package/package.json +2 -2
  117. package/scripts/kb-bootstrap-init-skeleton.sh +0 -0
  118. package/scripts/kb-graph-incremental-prepare.mjs +0 -0
  119. package/scripts/kb-graph-materialize.mjs +105 -105
  120. package/scripts/kb-graph-promote.mjs +164 -164
  121. package/scripts/kb-query.mjs +554 -554
  122. package/skills/agent-worker/SKILL.md +48 -48
  123. package/skills/agent-worker/references/agent-worker-operator.md +159 -159
  124. package/skills/ai-engineering-context/SKILL.md +48 -48
  125. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +0 -0
  126. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +0 -0
  127. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +0 -0
  128. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +0 -0
  129. package/skills/analyze-product-requirements/scripts/compute-source-identity.mjs +0 -0
  130. package/skills/analyze-product-requirements/scripts/test-validators.mjs +0 -0
  131. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +0 -0
  132. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +0 -0
  133. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +0 -0
  134. package/skills/browser-tools/browser-content.js +103 -103
  135. package/skills/browser-tools/browser-cookies.js +35 -35
  136. package/skills/browser-tools/browser-eval.js +53 -53
  137. package/skills/browser-tools/browser-hn-scraper.js +108 -108
  138. package/skills/browser-tools/browser-nav.js +44 -44
  139. package/skills/browser-tools/browser-pick.js +162 -162
  140. package/skills/browser-tools/browser-screenshot.js +34 -34
  141. package/skills/browser-tools/browser-start.js +86 -86
  142. package/skills/browser-tools/package-lock.json +2556 -2556
  143. package/skills/browser-tools/package.json +19 -19
  144. package/skills/code-review-core/SKILL.md +20 -20
  145. package/skills/codebase-scout/SKILL.md +19 -19
  146. package/skills/grill-me/SKILL.md +10 -10
  147. package/skills/local-jacoco-coverage/scripts/run-coverage-analysis.sh +0 -0
  148. package/skills/local-jacoco-coverage/scripts/start-jacoco-agent.sh +0 -0
  149. package/skills/loop-agent/SKILL.md +0 -1
  150. package/skills/loop-agent/references/command-reference.md +639 -641
  151. package/skills/loop-agent/references/docs-converge.md +126 -126
  152. package/skills/loop-agent/references/learned/README.md +21 -21
  153. package/skills/loop-agent/references/pi-prompt.md +23 -23
  154. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  155. package/skills/playwright-cli/references/element-attributes.md +23 -23
  156. package/skills/playwright-cli/references/playwright-tests.md +39 -39
  157. package/skills/playwright-cli/references/request-mocking.md +87 -87
  158. package/skills/playwright-cli/references/running-code.md +241 -241
  159. package/skills/playwright-cli/references/session-management.md +225 -225
  160. package/skills/playwright-cli/references/storage-state.md +275 -275
  161. package/skills/playwright-cli/references/test-generation.md +433 -433
  162. package/skills/requesting-code-review/SKILL.md +101 -101
  163. package/skills/requesting-code-review/code-reviewer.md +168 -168
  164. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  165. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  166. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  167. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  168. package/skills/systematic-debugging/find-polluter.sh +63 -63
  169. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  170. package/skills/systematic-debugging/test-academic.md +14 -14
  171. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  172. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  173. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  174. package/skills/using-git-worktrees/SKILL.md +215 -215
  175. package/skills/verification-before-completion/SKILL.md +154 -154
  176. package/skills/webapp-testing/SKILL.md +19 -19
  177. package/dist/worker/console/operation-wait.js +0 -241
  178. package/dist/worker/console/static/assets/index-SjjjZnV3.js +0 -56
  179. package/dist/worker/console/static-src/operator-chat/slash-palette-nav.js +0 -141
@@ -1,44 +1,44 @@
1
- #!/usr/bin/env node
2
-
3
- import puppeteer from "puppeteer-core";
4
-
5
- const args = process.argv.slice(2);
6
- const newTab = args.includes("--new");
7
- const reload = args.includes("--reload");
8
- const url = args.find(a => !a.startsWith("--"));
9
-
10
- if (!url) {
11
- console.log("Usage: browser-nav.js <url> [--new] [--reload]");
12
- console.log("\nExamples:");
13
- console.log(" browser-nav.js https://example.com # Navigate current tab");
14
- console.log(" browser-nav.js https://example.com --new # Open in new tab");
15
- console.log(" browser-nav.js https://example.com --reload # Navigate and force reload");
16
- process.exit(1);
17
- }
18
-
19
- const b = await Promise.race([
20
- puppeteer.connect({
21
- browserURL: "http://localhost:9222",
22
- defaultViewport: null,
23
- }),
24
- new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
25
- ]).catch((e) => {
26
- console.error("✗ Could not connect to browser:", e.message);
27
- console.error(" Run: browser-start.js");
28
- process.exit(1);
29
- });
30
-
31
- if (newTab) {
32
- const p = await b.newPage();
33
- await p.goto(url, { waitUntil: "domcontentloaded" });
34
- console.log("✓ Opened:", url);
35
- } else {
36
- const p = (await b.pages()).at(-1);
37
- await p.goto(url, { waitUntil: "domcontentloaded" });
38
- if (reload) {
39
- await p.reload({ waitUntil: "domcontentloaded" });
40
- }
41
- console.log("✓ Navigated to:", url);
42
- }
43
-
44
- await b.disconnect();
1
+ #!/usr/bin/env node
2
+
3
+ import puppeteer from "puppeteer-core";
4
+
5
+ const args = process.argv.slice(2);
6
+ const newTab = args.includes("--new");
7
+ const reload = args.includes("--reload");
8
+ const url = args.find(a => !a.startsWith("--"));
9
+
10
+ if (!url) {
11
+ console.log("Usage: browser-nav.js <url> [--new] [--reload]");
12
+ console.log("\nExamples:");
13
+ console.log(" browser-nav.js https://example.com # Navigate current tab");
14
+ console.log(" browser-nav.js https://example.com --new # Open in new tab");
15
+ console.log(" browser-nav.js https://example.com --reload # Navigate and force reload");
16
+ process.exit(1);
17
+ }
18
+
19
+ const b = await Promise.race([
20
+ puppeteer.connect({
21
+ browserURL: "http://localhost:9222",
22
+ defaultViewport: null,
23
+ }),
24
+ new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
25
+ ]).catch((e) => {
26
+ console.error("✗ Could not connect to browser:", e.message);
27
+ console.error(" Run: browser-start.js");
28
+ process.exit(1);
29
+ });
30
+
31
+ if (newTab) {
32
+ const p = await b.newPage();
33
+ await p.goto(url, { waitUntil: "domcontentloaded" });
34
+ console.log("✓ Opened:", url);
35
+ } else {
36
+ const p = (await b.pages()).at(-1);
37
+ await p.goto(url, { waitUntil: "domcontentloaded" });
38
+ if (reload) {
39
+ await p.reload({ waitUntil: "domcontentloaded" });
40
+ }
41
+ console.log("✓ Navigated to:", url);
42
+ }
43
+
44
+ await b.disconnect();
@@ -1,162 +1,162 @@
1
- #!/usr/bin/env node
2
-
3
- import puppeteer from "puppeteer-core";
4
-
5
- const message = process.argv.slice(2).join(" ");
6
- if (!message) {
7
- console.log("Usage: browser-pick.js 'message'");
8
- console.log("\nExample:");
9
- console.log(' browser-pick.js "Click the submit button"');
10
- process.exit(1);
11
- }
12
-
13
- const b = await Promise.race([
14
- puppeteer.connect({
15
- browserURL: "http://localhost:9222",
16
- defaultViewport: null,
17
- }),
18
- new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
19
- ]).catch((e) => {
20
- console.error("✗ Could not connect to browser:", e.message);
21
- console.error(" Run: browser-start.js");
22
- process.exit(1);
23
- });
24
-
25
- const p = (await b.pages()).at(-1);
26
-
27
- if (!p) {
28
- console.error("✗ No active tab found");
29
- process.exit(1);
30
- }
31
-
32
- // Inject pick() helper into current page
33
- await p.evaluate(() => {
34
- if (!window.pick) {
35
- window.pick = async (message) => {
36
- if (!message) {
37
- throw new Error("pick() requires a message parameter");
38
- }
39
- return new Promise((resolve) => {
40
- const selections = [];
41
- const selectedElements = new Set();
42
-
43
- const overlay = document.createElement("div");
44
- overlay.style.cssText =
45
- "position:fixed;top:0;left:0;width:100%;height:100%;z-index:2147483647;pointer-events:none";
46
-
47
- const highlight = document.createElement("div");
48
- highlight.style.cssText =
49
- "position:absolute;border:2px solid #3b82f6;background:rgba(59,130,246,0.1);transition:all 0.1s";
50
- overlay.appendChild(highlight);
51
-
52
- const banner = document.createElement("div");
53
- banner.style.cssText =
54
- "position:fixed;bottom:20px;left:50%;transform:translateX(-50%);background:#1f2937;color:white;padding:12px 24px;border-radius:8px;font:14px sans-serif;box-shadow:0 4px 12px rgba(0,0,0,0.3);pointer-events:auto;z-index:2147483647";
55
-
56
- const updateBanner = () => {
57
- banner.textContent = `${message} (${selections.length} selected, Cmd/Ctrl+click to add, Enter to finish, ESC to cancel)`;
58
- };
59
- updateBanner();
60
-
61
- document.body.append(banner, overlay);
62
-
63
- const cleanup = () => {
64
- document.removeEventListener("mousemove", onMove, true);
65
- document.removeEventListener("click", onClick, true);
66
- document.removeEventListener("keydown", onKey, true);
67
- overlay.remove();
68
- banner.remove();
69
- selectedElements.forEach((el) => {
70
- el.style.outline = "";
71
- });
72
- };
73
-
74
- const onMove = (e) => {
75
- const el = document.elementFromPoint(e.clientX, e.clientY);
76
- if (!el || overlay.contains(el) || banner.contains(el)) return;
77
- const r = el.getBoundingClientRect();
78
- highlight.style.cssText = `position:absolute;border:2px solid #3b82f6;background:rgba(59,130,246,0.1);top:${r.top}px;left:${r.left}px;width:${r.width}px;height:${r.height}px`;
79
- };
80
-
81
- const buildElementInfo = (el) => {
82
- const parents = [];
83
- let current = el.parentElement;
84
- while (current && current !== document.body) {
85
- const parentInfo = current.tagName.toLowerCase();
86
- const id = current.id ? `#${current.id}` : "";
87
- const cls = current.className
88
- ? `.${current.className.trim().split(/\s+/).join(".")}`
89
- : "";
90
- parents.push(parentInfo + id + cls);
91
- current = current.parentElement;
92
- }
93
-
94
- return {
95
- tag: el.tagName.toLowerCase(),
96
- id: el.id || null,
97
- class: el.className || null,
98
- text: el.textContent?.trim().slice(0, 200) || null,
99
- html: el.outerHTML.slice(0, 500),
100
- parents: parents.join(" > "),
101
- };
102
- };
103
-
104
- const onClick = (e) => {
105
- if (banner.contains(e.target)) return;
106
- e.preventDefault();
107
- e.stopPropagation();
108
- const el = document.elementFromPoint(e.clientX, e.clientY);
109
- if (!el || overlay.contains(el) || banner.contains(el)) return;
110
-
111
- if (e.metaKey || e.ctrlKey) {
112
- if (!selectedElements.has(el)) {
113
- selectedElements.add(el);
114
- el.style.outline = "3px solid #10b981";
115
- selections.push(buildElementInfo(el));
116
- updateBanner();
117
- }
118
- } else {
119
- cleanup();
120
- const info = buildElementInfo(el);
121
- resolve(selections.length > 0 ? selections : info);
122
- }
123
- };
124
-
125
- const onKey = (e) => {
126
- if (e.key === "Escape") {
127
- e.preventDefault();
128
- cleanup();
129
- resolve(null);
130
- } else if (e.key === "Enter" && selections.length > 0) {
131
- e.preventDefault();
132
- cleanup();
133
- resolve(selections);
134
- }
135
- };
136
-
137
- document.addEventListener("mousemove", onMove, true);
138
- document.addEventListener("click", onClick, true);
139
- document.addEventListener("keydown", onKey, true);
140
- });
141
- };
142
- }
143
- });
144
-
145
- const result = await p.evaluate((msg) => window.pick(msg), message);
146
-
147
- if (Array.isArray(result)) {
148
- for (let i = 0; i < result.length; i++) {
149
- if (i > 0) console.log("");
150
- for (const [key, value] of Object.entries(result[i])) {
151
- console.log(`${key}: ${value}`);
152
- }
153
- }
154
- } else if (typeof result === "object" && result !== null) {
155
- for (const [key, value] of Object.entries(result)) {
156
- console.log(`${key}: ${value}`);
157
- }
158
- } else {
159
- console.log(result);
160
- }
161
-
162
- await b.disconnect();
1
+ #!/usr/bin/env node
2
+
3
+ import puppeteer from "puppeteer-core";
4
+
5
+ const message = process.argv.slice(2).join(" ");
6
+ if (!message) {
7
+ console.log("Usage: browser-pick.js 'message'");
8
+ console.log("\nExample:");
9
+ console.log(' browser-pick.js "Click the submit button"');
10
+ process.exit(1);
11
+ }
12
+
13
+ const b = await Promise.race([
14
+ puppeteer.connect({
15
+ browserURL: "http://localhost:9222",
16
+ defaultViewport: null,
17
+ }),
18
+ new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
19
+ ]).catch((e) => {
20
+ console.error("✗ Could not connect to browser:", e.message);
21
+ console.error(" Run: browser-start.js");
22
+ process.exit(1);
23
+ });
24
+
25
+ const p = (await b.pages()).at(-1);
26
+
27
+ if (!p) {
28
+ console.error("✗ No active tab found");
29
+ process.exit(1);
30
+ }
31
+
32
+ // Inject pick() helper into current page
33
+ await p.evaluate(() => {
34
+ if (!window.pick) {
35
+ window.pick = async (message) => {
36
+ if (!message) {
37
+ throw new Error("pick() requires a message parameter");
38
+ }
39
+ return new Promise((resolve) => {
40
+ const selections = [];
41
+ const selectedElements = new Set();
42
+
43
+ const overlay = document.createElement("div");
44
+ overlay.style.cssText =
45
+ "position:fixed;top:0;left:0;width:100%;height:100%;z-index:2147483647;pointer-events:none";
46
+
47
+ const highlight = document.createElement("div");
48
+ highlight.style.cssText =
49
+ "position:absolute;border:2px solid #3b82f6;background:rgba(59,130,246,0.1);transition:all 0.1s";
50
+ overlay.appendChild(highlight);
51
+
52
+ const banner = document.createElement("div");
53
+ banner.style.cssText =
54
+ "position:fixed;bottom:20px;left:50%;transform:translateX(-50%);background:#1f2937;color:white;padding:12px 24px;border-radius:8px;font:14px sans-serif;box-shadow:0 4px 12px rgba(0,0,0,0.3);pointer-events:auto;z-index:2147483647";
55
+
56
+ const updateBanner = () => {
57
+ banner.textContent = `${message} (${selections.length} selected, Cmd/Ctrl+click to add, Enter to finish, ESC to cancel)`;
58
+ };
59
+ updateBanner();
60
+
61
+ document.body.append(banner, overlay);
62
+
63
+ const cleanup = () => {
64
+ document.removeEventListener("mousemove", onMove, true);
65
+ document.removeEventListener("click", onClick, true);
66
+ document.removeEventListener("keydown", onKey, true);
67
+ overlay.remove();
68
+ banner.remove();
69
+ selectedElements.forEach((el) => {
70
+ el.style.outline = "";
71
+ });
72
+ };
73
+
74
+ const onMove = (e) => {
75
+ const el = document.elementFromPoint(e.clientX, e.clientY);
76
+ if (!el || overlay.contains(el) || banner.contains(el)) return;
77
+ const r = el.getBoundingClientRect();
78
+ highlight.style.cssText = `position:absolute;border:2px solid #3b82f6;background:rgba(59,130,246,0.1);top:${r.top}px;left:${r.left}px;width:${r.width}px;height:${r.height}px`;
79
+ };
80
+
81
+ const buildElementInfo = (el) => {
82
+ const parents = [];
83
+ let current = el.parentElement;
84
+ while (current && current !== document.body) {
85
+ const parentInfo = current.tagName.toLowerCase();
86
+ const id = current.id ? `#${current.id}` : "";
87
+ const cls = current.className
88
+ ? `.${current.className.trim().split(/\s+/).join(".")}`
89
+ : "";
90
+ parents.push(parentInfo + id + cls);
91
+ current = current.parentElement;
92
+ }
93
+
94
+ return {
95
+ tag: el.tagName.toLowerCase(),
96
+ id: el.id || null,
97
+ class: el.className || null,
98
+ text: el.textContent?.trim().slice(0, 200) || null,
99
+ html: el.outerHTML.slice(0, 500),
100
+ parents: parents.join(" > "),
101
+ };
102
+ };
103
+
104
+ const onClick = (e) => {
105
+ if (banner.contains(e.target)) return;
106
+ e.preventDefault();
107
+ e.stopPropagation();
108
+ const el = document.elementFromPoint(e.clientX, e.clientY);
109
+ if (!el || overlay.contains(el) || banner.contains(el)) return;
110
+
111
+ if (e.metaKey || e.ctrlKey) {
112
+ if (!selectedElements.has(el)) {
113
+ selectedElements.add(el);
114
+ el.style.outline = "3px solid #10b981";
115
+ selections.push(buildElementInfo(el));
116
+ updateBanner();
117
+ }
118
+ } else {
119
+ cleanup();
120
+ const info = buildElementInfo(el);
121
+ resolve(selections.length > 0 ? selections : info);
122
+ }
123
+ };
124
+
125
+ const onKey = (e) => {
126
+ if (e.key === "Escape") {
127
+ e.preventDefault();
128
+ cleanup();
129
+ resolve(null);
130
+ } else if (e.key === "Enter" && selections.length > 0) {
131
+ e.preventDefault();
132
+ cleanup();
133
+ resolve(selections);
134
+ }
135
+ };
136
+
137
+ document.addEventListener("mousemove", onMove, true);
138
+ document.addEventListener("click", onClick, true);
139
+ document.addEventListener("keydown", onKey, true);
140
+ });
141
+ };
142
+ }
143
+ });
144
+
145
+ const result = await p.evaluate((msg) => window.pick(msg), message);
146
+
147
+ if (Array.isArray(result)) {
148
+ for (let i = 0; i < result.length; i++) {
149
+ if (i > 0) console.log("");
150
+ for (const [key, value] of Object.entries(result[i])) {
151
+ console.log(`${key}: ${value}`);
152
+ }
153
+ }
154
+ } else if (typeof result === "object" && result !== null) {
155
+ for (const [key, value] of Object.entries(result)) {
156
+ console.log(`${key}: ${value}`);
157
+ }
158
+ } else {
159
+ console.log(result);
160
+ }
161
+
162
+ await b.disconnect();
@@ -1,34 +1,34 @@
1
- #!/usr/bin/env node
2
-
3
- import { tmpdir } from "node:os";
4
- import { join } from "node:path";
5
- import puppeteer from "puppeteer-core";
6
-
7
- const b = await Promise.race([
8
- puppeteer.connect({
9
- browserURL: "http://localhost:9222",
10
- defaultViewport: null,
11
- }),
12
- new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
13
- ]).catch((e) => {
14
- console.error("✗ Could not connect to browser:", e.message);
15
- console.error(" Run: browser-start.js");
16
- process.exit(1);
17
- });
18
-
19
- const p = (await b.pages()).at(-1);
20
-
21
- if (!p) {
22
- console.error("✗ No active tab found");
23
- process.exit(1);
24
- }
25
-
26
- const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
27
- const filename = `screenshot-${timestamp}.png`;
28
- const filepath = join(tmpdir(), filename);
29
-
30
- await p.screenshot({ path: filepath });
31
-
32
- console.log(filepath);
33
-
34
- await b.disconnect();
1
+ #!/usr/bin/env node
2
+
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+ import puppeteer from "puppeteer-core";
6
+
7
+ const b = await Promise.race([
8
+ puppeteer.connect({
9
+ browserURL: "http://localhost:9222",
10
+ defaultViewport: null,
11
+ }),
12
+ new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
13
+ ]).catch((e) => {
14
+ console.error("✗ Could not connect to browser:", e.message);
15
+ console.error(" Run: browser-start.js");
16
+ process.exit(1);
17
+ });
18
+
19
+ const p = (await b.pages()).at(-1);
20
+
21
+ if (!p) {
22
+ console.error("✗ No active tab found");
23
+ process.exit(1);
24
+ }
25
+
26
+ const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
27
+ const filename = `screenshot-${timestamp}.png`;
28
+ const filepath = join(tmpdir(), filename);
29
+
30
+ await p.screenshot({ path: filepath });
31
+
32
+ console.log(filepath);
33
+
34
+ await b.disconnect();
@@ -1,86 +1,86 @@
1
- #!/usr/bin/env node
2
-
3
- import { spawn, execSync } from "node:child_process";
4
- import puppeteer from "puppeteer-core";
5
-
6
- const useProfile = process.argv[2] === "--profile";
7
-
8
- if (process.argv[2] && process.argv[2] !== "--profile") {
9
- console.log("Usage: browser-start.js [--profile]");
10
- console.log("\nOptions:");
11
- console.log(" --profile Copy your default Chrome profile (cookies, logins)");
12
- process.exit(1);
13
- }
14
-
15
- const SCRAPING_DIR = `${process.env.HOME}/.cache/browser-tools`;
16
-
17
- // Check if already running on :9222
18
- try {
19
- const browser = await puppeteer.connect({
20
- browserURL: "http://localhost:9222",
21
- defaultViewport: null,
22
- });
23
- await browser.disconnect();
24
- console.log("✓ Chrome already running on :9222");
25
- process.exit(0);
26
- } catch {}
27
-
28
- // Setup profile directory
29
- execSync(`mkdir -p "${SCRAPING_DIR}"`, { stdio: "ignore" });
30
-
31
- // Remove SingletonLock to allow new instance
32
- try {
33
- execSync(`rm -f "${SCRAPING_DIR}/SingletonLock" "${SCRAPING_DIR}/SingletonSocket" "${SCRAPING_DIR}/SingletonCookie"`, { stdio: "ignore" });
34
- } catch {}
35
-
36
- if (useProfile) {
37
- console.log("Syncing profile...");
38
- execSync(
39
- `rsync -a --delete \
40
- --exclude='SingletonLock' \
41
- --exclude='SingletonSocket' \
42
- --exclude='SingletonCookie' \
43
- --exclude='*/Sessions/*' \
44
- --exclude='*/Current Session' \
45
- --exclude='*/Current Tabs' \
46
- --exclude='*/Last Session' \
47
- --exclude='*/Last Tabs' \
48
- "${process.env.HOME}/Library/Application Support/Google/Chrome/" "${SCRAPING_DIR}/"`,
49
- { stdio: "pipe" },
50
- );
51
- }
52
-
53
- // Start Chrome with flags to force new instance
54
- spawn(
55
- "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
56
- [
57
- "--remote-debugging-port=9222",
58
- `--user-data-dir=${SCRAPING_DIR}`,
59
- "--no-first-run",
60
- "--no-default-browser-check",
61
- ],
62
- { detached: true, stdio: "ignore" },
63
- ).unref();
64
-
65
- // Wait for Chrome to be ready
66
- let connected = false;
67
- for (let i = 0; i < 30; i++) {
68
- try {
69
- const browser = await puppeteer.connect({
70
- browserURL: "http://localhost:9222",
71
- defaultViewport: null,
72
- });
73
- await browser.disconnect();
74
- connected = true;
75
- break;
76
- } catch {
77
- await new Promise((r) => setTimeout(r, 500));
78
- }
79
- }
80
-
81
- if (!connected) {
82
- console.error("✗ Failed to connect to Chrome");
83
- process.exit(1);
84
- }
85
-
86
- console.log(`✓ Chrome started on :9222${useProfile ? " with your profile" : ""}`);
1
+ #!/usr/bin/env node
2
+
3
+ import { spawn, execSync } from "node:child_process";
4
+ import puppeteer from "puppeteer-core";
5
+
6
+ const useProfile = process.argv[2] === "--profile";
7
+
8
+ if (process.argv[2] && process.argv[2] !== "--profile") {
9
+ console.log("Usage: browser-start.js [--profile]");
10
+ console.log("\nOptions:");
11
+ console.log(" --profile Copy your default Chrome profile (cookies, logins)");
12
+ process.exit(1);
13
+ }
14
+
15
+ const SCRAPING_DIR = `${process.env.HOME}/.cache/browser-tools`;
16
+
17
+ // Check if already running on :9222
18
+ try {
19
+ const browser = await puppeteer.connect({
20
+ browserURL: "http://localhost:9222",
21
+ defaultViewport: null,
22
+ });
23
+ await browser.disconnect();
24
+ console.log("✓ Chrome already running on :9222");
25
+ process.exit(0);
26
+ } catch {}
27
+
28
+ // Setup profile directory
29
+ execSync(`mkdir -p "${SCRAPING_DIR}"`, { stdio: "ignore" });
30
+
31
+ // Remove SingletonLock to allow new instance
32
+ try {
33
+ execSync(`rm -f "${SCRAPING_DIR}/SingletonLock" "${SCRAPING_DIR}/SingletonSocket" "${SCRAPING_DIR}/SingletonCookie"`, { stdio: "ignore" });
34
+ } catch {}
35
+
36
+ if (useProfile) {
37
+ console.log("Syncing profile...");
38
+ execSync(
39
+ `rsync -a --delete \
40
+ --exclude='SingletonLock' \
41
+ --exclude='SingletonSocket' \
42
+ --exclude='SingletonCookie' \
43
+ --exclude='*/Sessions/*' \
44
+ --exclude='*/Current Session' \
45
+ --exclude='*/Current Tabs' \
46
+ --exclude='*/Last Session' \
47
+ --exclude='*/Last Tabs' \
48
+ "${process.env.HOME}/Library/Application Support/Google/Chrome/" "${SCRAPING_DIR}/"`,
49
+ { stdio: "pipe" },
50
+ );
51
+ }
52
+
53
+ // Start Chrome with flags to force new instance
54
+ spawn(
55
+ "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
56
+ [
57
+ "--remote-debugging-port=9222",
58
+ `--user-data-dir=${SCRAPING_DIR}`,
59
+ "--no-first-run",
60
+ "--no-default-browser-check",
61
+ ],
62
+ { detached: true, stdio: "ignore" },
63
+ ).unref();
64
+
65
+ // Wait for Chrome to be ready
66
+ let connected = false;
67
+ for (let i = 0; i < 30; i++) {
68
+ try {
69
+ const browser = await puppeteer.connect({
70
+ browserURL: "http://localhost:9222",
71
+ defaultViewport: null,
72
+ });
73
+ await browser.disconnect();
74
+ connected = true;
75
+ break;
76
+ } catch {
77
+ await new Promise((r) => setTimeout(r, 500));
78
+ }
79
+ }
80
+
81
+ if (!connected) {
82
+ console.error("✗ Failed to connect to Chrome");
83
+ process.exit(1);
84
+ }
85
+
86
+ console.log(`✓ Chrome started on :9222${useProfile ? " with your profile" : ""}`);