pi-agent-browser-native 0.2.48 → 0.2.50

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 (189) hide show
  1. package/CHANGELOG.md +27 -1
  2. package/README.md +21 -11
  3. package/dist/extensions/agent-browser/index.js +808 -0
  4. package/dist/extensions/agent-browser/lib/argv-descriptor.js +71 -0
  5. package/dist/extensions/agent-browser/lib/argv-grammar.js +121 -0
  6. package/dist/extensions/agent-browser/lib/bash-guard.js +190 -0
  7. package/dist/extensions/agent-browser/lib/command-policy.js +85 -0
  8. package/dist/extensions/agent-browser/lib/command-taxonomy.js +302 -0
  9. package/dist/extensions/agent-browser/lib/config-policy.js +669 -0
  10. package/dist/extensions/agent-browser/lib/config.js +122 -0
  11. package/dist/extensions/agent-browser/lib/electron/cdp.js +51 -0
  12. package/dist/extensions/agent-browser/lib/electron/cleanup.js +212 -0
  13. package/dist/extensions/agent-browser/lib/electron/discovery.js +633 -0
  14. package/dist/extensions/agent-browser/lib/electron/launch.js +351 -0
  15. package/{extensions/agent-browser/lib/electron/text.ts → dist/extensions/agent-browser/lib/electron/text.js} +5 -5
  16. package/dist/extensions/agent-browser/lib/executable-path.js +20 -0
  17. package/dist/extensions/agent-browser/lib/fs-utils.js +18 -0
  18. package/dist/extensions/agent-browser/lib/input-modes/electron.js +165 -0
  19. package/dist/extensions/agent-browser/lib/input-modes/job.js +519 -0
  20. package/dist/extensions/agent-browser/lib/input-modes/lookups.js +440 -0
  21. package/dist/extensions/agent-browser/lib/input-modes/params.js +164 -0
  22. package/dist/extensions/agent-browser/lib/input-modes/semantic-action.js +119 -0
  23. package/dist/extensions/agent-browser/lib/input-modes/shared.js +42 -0
  24. package/dist/extensions/agent-browser/lib/input-modes/types.js +21 -0
  25. package/dist/extensions/agent-browser/lib/input-modes.js +10 -0
  26. package/dist/extensions/agent-browser/lib/json-schema.js +58 -0
  27. package/dist/extensions/agent-browser/lib/launch-scoped-flags.js +59 -0
  28. package/dist/extensions/agent-browser/lib/navigation-policy.js +83 -0
  29. package/dist/extensions/agent-browser/lib/orchestration/batch-stdin.js +62 -0
  30. package/dist/extensions/agent-browser/lib/orchestration/browser-run/artifact-paths.js +39 -0
  31. package/dist/extensions/agent-browser/lib/orchestration/browser-run/click-dispatch.js +276 -0
  32. package/dist/extensions/agent-browser/lib/orchestration/browser-run/diagnostics.js +909 -0
  33. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result.js +443 -0
  34. package/dist/extensions/agent-browser/lib/orchestration/browser-run/index.js +47 -0
  35. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/direct-anchor-download.js +141 -0
  36. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/network-page-filter.js +108 -0
  37. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/scroll-shims.js +112 -0
  38. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter.js +158 -0
  39. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/wait-timeouts.js +54 -0
  40. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare.js +762 -0
  41. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output.js +491 -0
  42. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prompt-guards.js +40 -0
  43. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-artifacts.js +5 -0
  44. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state.js +731 -0
  45. package/dist/extensions/agent-browser/lib/orchestration/browser-run/types.js +1 -0
  46. package/dist/extensions/agent-browser/lib/orchestration/electron-host/index.js +718 -0
  47. package/dist/extensions/agent-browser/lib/orchestration/input-plan.js +247 -0
  48. package/dist/extensions/agent-browser/lib/orchestration/output-file.js +68 -0
  49. package/{extensions/agent-browser/lib/parsing.ts → dist/extensions/agent-browser/lib/parsing.js} +12 -11
  50. package/dist/extensions/agent-browser/lib/pi-tool-rendering.js +241 -0
  51. package/dist/extensions/agent-browser/lib/playbook.js +121 -0
  52. package/dist/extensions/agent-browser/lib/process.js +363 -0
  53. package/dist/extensions/agent-browser/lib/prompt-policy.js +91 -0
  54. package/dist/extensions/agent-browser/lib/results/action-recommendations.js +220 -0
  55. package/dist/extensions/agent-browser/lib/results/artifact-manifest.js +111 -0
  56. package/{extensions/agent-browser/lib/results/artifact-state.ts → dist/extensions/agent-browser/lib/results/artifact-state.js} +4 -8
  57. package/dist/extensions/agent-browser/lib/results/categories.js +76 -0
  58. package/dist/extensions/agent-browser/lib/results/confirmation.js +63 -0
  59. package/dist/extensions/agent-browser/lib/results/contracts.js +8 -0
  60. package/dist/extensions/agent-browser/lib/results/editable-ref-evidence.js +74 -0
  61. package/dist/extensions/agent-browser/lib/results/envelope.js +166 -0
  62. package/dist/extensions/agent-browser/lib/results/network-routes.js +92 -0
  63. package/dist/extensions/agent-browser/lib/results/network.js +73 -0
  64. package/dist/extensions/agent-browser/lib/results/next-actions.js +72 -0
  65. package/dist/extensions/agent-browser/lib/results/presentation/artifacts.js +515 -0
  66. package/dist/extensions/agent-browser/lib/results/presentation/batch.js +397 -0
  67. package/dist/extensions/agent-browser/lib/results/presentation/browser-profile-recovery.js +55 -0
  68. package/dist/extensions/agent-browser/lib/results/presentation/common.js +46 -0
  69. package/dist/extensions/agent-browser/lib/results/presentation/content.js +24 -0
  70. package/dist/extensions/agent-browser/lib/results/presentation/diagnostics.js +956 -0
  71. package/dist/extensions/agent-browser/lib/results/presentation/errors.js +205 -0
  72. package/dist/extensions/agent-browser/lib/results/presentation/large-output.js +134 -0
  73. package/dist/extensions/agent-browser/lib/results/presentation/navigation.js +159 -0
  74. package/dist/extensions/agent-browser/lib/results/presentation/registry.js +216 -0
  75. package/dist/extensions/agent-browser/lib/results/presentation/semantic-action.js +104 -0
  76. package/dist/extensions/agent-browser/lib/results/presentation/skills.js +152 -0
  77. package/dist/extensions/agent-browser/lib/results/presentation.js +177 -0
  78. package/dist/extensions/agent-browser/lib/results/recovery-actions.js +107 -0
  79. package/dist/extensions/agent-browser/lib/results/recovery-next-actions.js +50 -0
  80. package/dist/extensions/agent-browser/lib/results/selector-recovery.js +225 -0
  81. package/{extensions/agent-browser/lib/results/shared.ts → dist/extensions/agent-browser/lib/results/shared.js} +0 -1
  82. package/dist/extensions/agent-browser/lib/results/snapshot-high-value-controls.js +208 -0
  83. package/dist/extensions/agent-browser/lib/results/snapshot-refs.js +78 -0
  84. package/dist/extensions/agent-browser/lib/results/snapshot-segments.js +331 -0
  85. package/dist/extensions/agent-browser/lib/results/snapshot-spill.js +40 -0
  86. package/dist/extensions/agent-browser/lib/results/snapshot.js +264 -0
  87. package/dist/extensions/agent-browser/lib/results/text.js +40 -0
  88. package/{extensions/agent-browser/lib/results.ts → dist/extensions/agent-browser/lib/results.js} +2 -32
  89. package/dist/extensions/agent-browser/lib/runtime.js +855 -0
  90. package/dist/extensions/agent-browser/lib/session-page-state.js +411 -0
  91. package/dist/extensions/agent-browser/lib/string-enum-schema.js +13 -0
  92. package/dist/extensions/agent-browser/lib/temp.js +498 -0
  93. package/dist/extensions/agent-browser/lib/web-search.js +562 -0
  94. package/docs/ARCHITECTURE.md +5 -5
  95. package/docs/COMMAND_REFERENCE.md +4 -4
  96. package/docs/RELEASE.md +22 -11
  97. package/docs/REQUIREMENTS.md +1 -1
  98. package/docs/SUPPORT_MATRIX.md +5 -4
  99. package/docs/TOOL_CONTRACT.md +1 -1
  100. package/package.json +9 -5
  101. package/scripts/config.mjs +14 -20
  102. package/scripts/doctor.mjs +8 -7
  103. package/extensions/agent-browser/index.ts +0 -961
  104. package/extensions/agent-browser/lib/argv-descriptor.ts +0 -90
  105. package/extensions/agent-browser/lib/argv-grammar.ts +0 -128
  106. package/extensions/agent-browser/lib/bash-guard.ts +0 -205
  107. package/extensions/agent-browser/lib/command-policy.ts +0 -71
  108. package/extensions/agent-browser/lib/command-taxonomy.ts +0 -336
  109. package/extensions/agent-browser/lib/config-policy.js +0 -690
  110. package/extensions/agent-browser/lib/config.ts +0 -211
  111. package/extensions/agent-browser/lib/electron/cdp.ts +0 -69
  112. package/extensions/agent-browser/lib/electron/cleanup.ts +0 -235
  113. package/extensions/agent-browser/lib/electron/discovery.ts +0 -710
  114. package/extensions/agent-browser/lib/electron/launch.ts +0 -499
  115. package/extensions/agent-browser/lib/executable-path.ts +0 -19
  116. package/extensions/agent-browser/lib/fs-utils.ts +0 -18
  117. package/extensions/agent-browser/lib/input-modes/electron.ts +0 -170
  118. package/extensions/agent-browser/lib/input-modes/job.ts +0 -527
  119. package/extensions/agent-browser/lib/input-modes/lookups.ts +0 -447
  120. package/extensions/agent-browser/lib/input-modes/params.ts +0 -205
  121. package/extensions/agent-browser/lib/input-modes/semantic-action.ts +0 -127
  122. package/extensions/agent-browser/lib/input-modes/shared.ts +0 -46
  123. package/extensions/agent-browser/lib/input-modes/types.ts +0 -225
  124. package/extensions/agent-browser/lib/input-modes.ts +0 -45
  125. package/extensions/agent-browser/lib/json-schema.ts +0 -73
  126. package/extensions/agent-browser/lib/launch-scoped-flags.ts +0 -67
  127. package/extensions/agent-browser/lib/navigation-policy.ts +0 -95
  128. package/extensions/agent-browser/lib/orchestration/batch-stdin.ts +0 -65
  129. package/extensions/agent-browser/lib/orchestration/browser-run/artifact-paths.ts +0 -44
  130. package/extensions/agent-browser/lib/orchestration/browser-run/click-dispatch.ts +0 -280
  131. package/extensions/agent-browser/lib/orchestration/browser-run/diagnostics.ts +0 -914
  132. package/extensions/agent-browser/lib/orchestration/browser-run/final-result.ts +0 -521
  133. package/extensions/agent-browser/lib/orchestration/browser-run/index.ts +0 -53
  134. package/extensions/agent-browser/lib/orchestration/browser-run/prepare/direct-anchor-download.ts +0 -158
  135. package/extensions/agent-browser/lib/orchestration/browser-run/prepare/network-page-filter.ts +0 -116
  136. package/extensions/agent-browser/lib/orchestration/browser-run/prepare/scroll-shims.ts +0 -147
  137. package/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter.ts +0 -183
  138. package/extensions/agent-browser/lib/orchestration/browser-run/prepare/wait-timeouts.ts +0 -58
  139. package/extensions/agent-browser/lib/orchestration/browser-run/prepare.ts +0 -847
  140. package/extensions/agent-browser/lib/orchestration/browser-run/process-output.ts +0 -559
  141. package/extensions/agent-browser/lib/orchestration/browser-run/prompt-guards.ts +0 -47
  142. package/extensions/agent-browser/lib/orchestration/browser-run/session-artifacts.ts +0 -8
  143. package/extensions/agent-browser/lib/orchestration/browser-run/session-state.ts +0 -868
  144. package/extensions/agent-browser/lib/orchestration/browser-run/types.ts +0 -565
  145. package/extensions/agent-browser/lib/orchestration/electron-host/index.ts +0 -855
  146. package/extensions/agent-browser/lib/orchestration/input-plan.ts +0 -375
  147. package/extensions/agent-browser/lib/orchestration/output-file.ts +0 -86
  148. package/extensions/agent-browser/lib/pi-tool-rendering.ts +0 -267
  149. package/extensions/agent-browser/lib/playbook.ts +0 -142
  150. package/extensions/agent-browser/lib/process.ts +0 -516
  151. package/extensions/agent-browser/lib/prompt-policy.ts +0 -105
  152. package/extensions/agent-browser/lib/results/action-recommendations.ts +0 -264
  153. package/extensions/agent-browser/lib/results/artifact-manifest.ts +0 -111
  154. package/extensions/agent-browser/lib/results/categories.ts +0 -106
  155. package/extensions/agent-browser/lib/results/confirmation.ts +0 -76
  156. package/extensions/agent-browser/lib/results/contracts.ts +0 -241
  157. package/extensions/agent-browser/lib/results/editable-ref-evidence.ts +0 -72
  158. package/extensions/agent-browser/lib/results/envelope.ts +0 -195
  159. package/extensions/agent-browser/lib/results/network-routes.ts +0 -83
  160. package/extensions/agent-browser/lib/results/network.ts +0 -78
  161. package/extensions/agent-browser/lib/results/next-actions.ts +0 -117
  162. package/extensions/agent-browser/lib/results/presentation/artifacts.ts +0 -588
  163. package/extensions/agent-browser/lib/results/presentation/batch.ts +0 -450
  164. package/extensions/agent-browser/lib/results/presentation/browser-profile-recovery.ts +0 -67
  165. package/extensions/agent-browser/lib/results/presentation/common.ts +0 -53
  166. package/extensions/agent-browser/lib/results/presentation/content.ts +0 -36
  167. package/extensions/agent-browser/lib/results/presentation/diagnostics.ts +0 -923
  168. package/extensions/agent-browser/lib/results/presentation/errors.ts +0 -227
  169. package/extensions/agent-browser/lib/results/presentation/large-output.ts +0 -182
  170. package/extensions/agent-browser/lib/results/presentation/navigation.ts +0 -184
  171. package/extensions/agent-browser/lib/results/presentation/registry.ts +0 -242
  172. package/extensions/agent-browser/lib/results/presentation/semantic-action.ts +0 -131
  173. package/extensions/agent-browser/lib/results/presentation/skills.ts +0 -143
  174. package/extensions/agent-browser/lib/results/presentation.ts +0 -257
  175. package/extensions/agent-browser/lib/results/recovery-actions.ts +0 -139
  176. package/extensions/agent-browser/lib/results/recovery-next-actions.ts +0 -71
  177. package/extensions/agent-browser/lib/results/selector-recovery.ts +0 -320
  178. package/extensions/agent-browser/lib/results/snapshot-high-value-controls.ts +0 -273
  179. package/extensions/agent-browser/lib/results/snapshot-refs.ts +0 -100
  180. package/extensions/agent-browser/lib/results/snapshot-segments.ts +0 -366
  181. package/extensions/agent-browser/lib/results/snapshot-spill.ts +0 -63
  182. package/extensions/agent-browser/lib/results/snapshot.ts +0 -329
  183. package/extensions/agent-browser/lib/results/text.ts +0 -40
  184. package/extensions/agent-browser/lib/runtime.ts +0 -988
  185. package/extensions/agent-browser/lib/session-page-state.ts +0 -512
  186. package/extensions/agent-browser/lib/string-enum-schema.ts +0 -20
  187. package/extensions/agent-browser/lib/temp.ts +0 -577
  188. package/extensions/agent-browser/lib/web-search.ts +0 -728
  189. /package/{extensions/agent-browser/lib/orchestration/browser-run.ts → dist/extensions/agent-browser/lib/orchestration/browser-run.js} +0 -0
@@ -1,447 +0,0 @@
1
- /**
2
- * Purpose: Compile and analyze experimental DOM/source and network source lookup input modes.
3
- * Responsibilities: Build lookup batches, collect DOM/React/workspace candidates, and redact network lookup surfaces.
4
- * Scope: Source lookup and network source lookup only.
5
- */
6
-
7
- import { readFile, readdir } from "node:fs/promises";
8
- import { extname, join } from "node:path";
9
-
10
- import { isRecord } from "../parsing.js";
11
- import { redactInvocationArgs, redactSensitiveText } from "../runtime.js";
12
- import { getBatchResultItems, validateLookupMaxWorkspaceFiles } from "./shared.js";
13
- import {
14
- SOURCE_LOOKUP_DEFAULT_MAX_WORKSPACE_FILES,
15
- SOURCE_LOOKUP_IGNORED_DIRECTORIES,
16
- SOURCE_LOOKUP_MAX_WORKSPACE_FILES,
17
- SOURCE_LOOKUP_WORKSPACE_EXTENSIONS,
18
- type AgentBrowserNetworkSourceLookupAnalysis,
19
- type AgentBrowserNetworkSourceLookupCandidate,
20
- type AgentBrowserNetworkSourceLookupRequest,
21
- type AgentBrowserNetworkSourceLookupStatus,
22
- type AgentBrowserSourceLookupAnalysis,
23
- type AgentBrowserSourceLookupAnalysisContext,
24
- type AgentBrowserSourceLookupCandidate,
25
- type AgentBrowserSourceLookupStatus,
26
- type CompiledAgentBrowserNetworkSourceLookup,
27
- type CompiledAgentBrowserSourceLookup,
28
- type CompiledAgentBrowserSourceLookupStep,
29
- } from "./types.js";
30
-
31
- export function compileAgentBrowserSourceLookup(input: unknown): { compiled?: CompiledAgentBrowserSourceLookup; error?: string } {
32
- if (!isRecord(input)) {
33
- return { error: "sourceLookup must be an object." };
34
- }
35
- const selector = input.selector;
36
- const reactFiberId = input.reactFiberId;
37
- const componentName = input.componentName;
38
- if (selector !== undefined && (typeof selector !== "string" || selector.trim().length === 0)) {
39
- return { error: "sourceLookup.selector must be a non-empty string when provided." };
40
- }
41
- if (reactFiberId !== undefined && (typeof reactFiberId !== "string" || reactFiberId.trim().length === 0)) {
42
- return { error: "sourceLookup.reactFiberId must be a non-empty string when provided." };
43
- }
44
- if (componentName !== undefined && (typeof componentName !== "string" || componentName.trim().length === 0)) {
45
- return { error: "sourceLookup.componentName must be a non-empty string when provided." };
46
- }
47
- if (selector === undefined && reactFiberId === undefined && componentName === undefined) {
48
- return { error: "sourceLookup requires selector, reactFiberId, or componentName." };
49
- }
50
- if (input.includeDomHints !== undefined && typeof input.includeDomHints !== "boolean") {
51
- return { error: "sourceLookup.includeDomHints must be a boolean when provided." };
52
- }
53
- const rawMaxWorkspaceFiles = input.maxWorkspaceFiles;
54
- if (rawMaxWorkspaceFiles !== undefined && (typeof rawMaxWorkspaceFiles !== "number" || !Number.isInteger(rawMaxWorkspaceFiles) || rawMaxWorkspaceFiles <= 0)) {
55
- return { error: "sourceLookup.maxWorkspaceFiles must be a positive integer when provided." };
56
- }
57
- if (typeof rawMaxWorkspaceFiles === "number" && rawMaxWorkspaceFiles > SOURCE_LOOKUP_MAX_WORKSPACE_FILES) {
58
- return { error: `sourceLookup.maxWorkspaceFiles must be ${SOURCE_LOOKUP_MAX_WORKSPACE_FILES} or less.` };
59
- }
60
- const includeDomHints = input.includeDomHints !== false;
61
- const maxWorkspaceFiles = (rawMaxWorkspaceFiles as number | undefined) ?? SOURCE_LOOKUP_DEFAULT_MAX_WORKSPACE_FILES;
62
- const steps: CompiledAgentBrowserSourceLookupStep[] = [];
63
- if (typeof selector === "string") {
64
- steps.push({ action: "dom", args: ["is", "visible", selector] });
65
- if (includeDomHints) {
66
- steps.push({ action: "dom", args: ["get", "html", selector] });
67
- }
68
- }
69
- if (typeof reactFiberId === "string") {
70
- steps.push({ action: "react", args: ["react", "inspect", reactFiberId] });
71
- }
72
- if (typeof componentName === "string") {
73
- steps.push({ action: "react", args: ["react", "tree"] });
74
- }
75
- return {
76
- compiled: {
77
- args: ["batch"],
78
- query: { componentName, includeDomHints, maxWorkspaceFiles, reactFiberId, selector },
79
- stdin: JSON.stringify(steps.map((step) => step.args)),
80
- steps,
81
- },
82
- };
83
- }
84
-
85
- function extractStringField(value: Record<string, unknown>, names: string[]): string | undefined {
86
- for (const name of names) {
87
- const field = value[name];
88
- if (typeof field === "string" && field.trim().length > 0) return field;
89
- }
90
- return undefined;
91
- }
92
-
93
- function extractNumberField(value: Record<string, unknown>, names: string[]): number | undefined {
94
- for (const name of names) {
95
- const field = value[name];
96
- if (typeof field === "number" && Number.isFinite(field)) return field;
97
- if (typeof field === "string" && /^\d+$/.test(field)) return Number(field);
98
- }
99
- return undefined;
100
- }
101
-
102
- function candidateKey(candidate: AgentBrowserSourceLookupCandidate): string {
103
- return [candidate.source, candidate.file ?? "", candidate.line ?? "", candidate.column ?? "", candidate.componentName ?? ""].join(":");
104
- }
105
-
106
- function addSourceLookupCandidate(candidates: AgentBrowserSourceLookupCandidate[], candidate: AgentBrowserSourceLookupCandidate): void {
107
- if (!candidates.some((existing) => candidateKey(existing) === candidateKey(candidate))) {
108
- candidates.push(candidate);
109
- }
110
- }
111
-
112
- function collectSourceCandidatesFromValue(value: unknown, source: "react-inspect" | "dom-attribute", candidates: AgentBrowserSourceLookupCandidate[], evidence: string[], depth = 0): void {
113
- if (depth > 6 || value === undefined || value === null) return;
114
- if (typeof value === "string") {
115
- const sourcePattern = /([A-Za-z0-9_./@-]+\.(?:tsx|jsx|ts|js))(?:[:#](\d+))?(?:[:#](\d+))?/g;
116
- for (const match of value.matchAll(sourcePattern)) {
117
- addSourceLookupCandidate(candidates, {
118
- column: match[3] ? Number(match[3]) : undefined,
119
- confidence: source === "react-inspect" ? "high" : "medium",
120
- evidence,
121
- file: match[1],
122
- line: match[2] ? Number(match[2]) : undefined,
123
- source,
124
- });
125
- }
126
- return;
127
- }
128
- if (Array.isArray(value)) {
129
- for (const item of value) collectSourceCandidatesFromValue(item, source, candidates, evidence, depth + 1);
130
- return;
131
- }
132
- if (!isRecord(value)) return;
133
- const file = extractStringField(value, ["file", "fileName", "filename", "filePath", "path", "source", "url"]);
134
- if (file && /\.(?:tsx|jsx|ts|js)(?:$|[:?#])/.test(file)) {
135
- addSourceLookupCandidate(candidates, {
136
- column: extractNumberField(value, ["column", "columnNumber", "col"]),
137
- confidence: source === "react-inspect" ? "high" : "medium",
138
- evidence,
139
- file,
140
- line: extractNumberField(value, ["line", "lineNumber"]),
141
- source,
142
- });
143
- }
144
- for (const nested of Object.values(value)) {
145
- collectSourceCandidatesFromValue(nested, source, candidates, evidence, depth + 1);
146
- }
147
- }
148
-
149
- function getHtmlAttributeValue(html: string, name: string): string | undefined {
150
- const pattern = new RegExp(`${name}=["']([^"']+)["']`, "i");
151
- return pattern.exec(html)?.[1];
152
- }
153
-
154
- function collectDomSourceCandidates(html: unknown, candidates: AgentBrowserSourceLookupCandidate[]): void {
155
- if (typeof html !== "string") return;
156
- const file = getHtmlAttributeValue(html, "(?:data-source-file|data-file|data-component-file|data-source)");
157
- if (file && /\.(?:tsx|jsx|ts|js)$/.test(file)) {
158
- const line = getHtmlAttributeValue(html, "(?:data-source-line|data-line)");
159
- const column = getHtmlAttributeValue(html, "(?:data-source-column|data-column)");
160
- addSourceLookupCandidate(candidates, {
161
- column: column && /^\d+$/.test(column) ? Number(column) : undefined,
162
- confidence: "medium",
163
- evidence: ["selector HTML contained source-like data attributes"],
164
- file,
165
- line: line && /^\d+$/.test(line) ? Number(line) : undefined,
166
- source: "dom-attribute",
167
- });
168
- }
169
- collectSourceCandidatesFromValue(html, "dom-attribute", candidates, ["selector HTML contained source-like text"]);
170
- }
171
-
172
- async function walkWorkspaceSourceFiles(root: string, maxFiles: number): Promise<string[]> {
173
- const files: string[] = [];
174
- async function visit(directory: string): Promise<void> {
175
- if (files.length >= maxFiles) return;
176
- let entries: Array<{ isDirectory: () => boolean; isFile: () => boolean; name: string }>;
177
- try {
178
- entries = await readdir(directory, { withFileTypes: true });
179
- } catch {
180
- return;
181
- }
182
- for (const entry of entries) {
183
- if (files.length >= maxFiles) return;
184
- const path = join(directory, entry.name);
185
- if (entry.isDirectory()) {
186
- if (!SOURCE_LOOKUP_IGNORED_DIRECTORIES.has(entry.name)) await visit(path);
187
- } else if (entry.isFile() && SOURCE_LOOKUP_WORKSPACE_EXTENSIONS.has(extname(entry.name))) {
188
- files.push(path);
189
- }
190
- }
191
- }
192
- await visit(root);
193
- return files;
194
- }
195
-
196
- function escapeRegExp(value: string): string {
197
- return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
198
- }
199
-
200
- async function collectWorkspaceComponentCandidates(query: CompiledAgentBrowserSourceLookup["query"], cwd: string, candidates: AgentBrowserSourceLookupCandidate[], limitations: string[]): Promise<void> {
201
- if (!query.componentName) return;
202
- const files = await walkWorkspaceSourceFiles(cwd, query.maxWorkspaceFiles);
203
- if (files.length >= query.maxWorkspaceFiles) {
204
- limitations.push(`Workspace source scan stopped at ${query.maxWorkspaceFiles} files.`);
205
- }
206
- const componentPattern = new RegExp(`(?:function|class)\\s+${escapeRegExp(query.componentName)}\\b|(?:const|let|var)\\s+${escapeRegExp(query.componentName)}\\s*=|export\\s+default\\s+function\\s+${escapeRegExp(query.componentName)}\\b`);
207
- for (const file of files) {
208
- let text: string;
209
- try {
210
- text = await readFile(file, "utf8");
211
- } catch {
212
- continue;
213
- }
214
- const match = componentPattern.exec(text);
215
- if (!match) continue;
216
- const line = text.slice(0, match.index).split("\n").length;
217
- addSourceLookupCandidate(candidates, {
218
- componentName: query.componentName,
219
- confidence: "low",
220
- evidence: [`local workspace contains a matching ${query.componentName} declaration`],
221
- file,
222
- line,
223
- source: "workspace-search",
224
- });
225
- if (candidates.filter((candidate) => candidate.source === "workspace-search").length >= 10) break;
226
- }
227
- }
228
-
229
- export async function analyzeSourceLookupResults(
230
- data: unknown,
231
- compiled: CompiledAgentBrowserSourceLookup,
232
- cwd: string,
233
- context?: AgentBrowserSourceLookupAnalysisContext,
234
- ): Promise<AgentBrowserSourceLookupAnalysis> {
235
- const items = getBatchResultItems(data);
236
- const candidates: AgentBrowserSourceLookupCandidate[] = [];
237
- const limitations = [
238
- "Experimental lookup only reports candidates with evidence; it cannot guarantee a DOM node maps to one source file.",
239
- "React source hints require the page to be opened with --enable react-devtools and source information from the app build.",
240
- ];
241
- let unsupported = false;
242
- for (const item of items) {
243
- const command = Array.isArray(item.command) ? item.command : [];
244
- const result = isRecord(item.result) && "data" in item.result ? item.result.data : item.result;
245
- if (item.success === false && command[0] === "react") unsupported = true;
246
- if (command[0] === "react" && command[1] === "inspect") {
247
- collectSourceCandidatesFromValue(result, "react-inspect", candidates, ["react inspect returned source-like metadata"]);
248
- }
249
- if (command[0] === "get" && command[1] === "html") {
250
- collectDomSourceCandidates(result, candidates);
251
- }
252
- }
253
- await collectWorkspaceComponentCandidates(compiled.query, cwd, candidates, limitations);
254
- const status: AgentBrowserSourceLookupStatus = candidates.length > 0 ? "candidates-found" : unsupported ? "unsupported" : "no-candidates";
255
- const electronContext = status === "no-candidates" ? context?.electronContext : undefined;
256
- const workspaceRoot = context?.workspaceRoot ?? cwd;
257
- if (electronContext) {
258
- limitations.push(
259
- `Workspace source scan is limited to the Pi tool session cwd: ${workspaceRoot}.`,
260
- "Packaged Electron app code may live inside installed app resources or app.asar outside the workspace; the wrapper does not unpack asar files or scan app bundle resources.",
261
- );
262
- }
263
- return {
264
- candidates,
265
- electronContext,
266
- limitations,
267
- status,
268
- summary: candidates.length > 0
269
- ? `Source lookup found ${candidates.length} candidate location(s).`
270
- : unsupported
271
- ? "Source lookup could not inspect React metadata in this session."
272
- : electronContext
273
- ? `Source lookup found no candidate locations. The workspace scan was limited to ${workspaceRoot}; packaged Electron app code may live outside that cwd in app resources or app.asar.`
274
- : "Source lookup found no candidate locations.",
275
- workspaceRoot: electronContext ? workspaceRoot : undefined,
276
- };
277
- }
278
-
279
- export function compileAgentBrowserNetworkSourceLookup(input: unknown): { compiled?: CompiledAgentBrowserNetworkSourceLookup; error?: string } {
280
- if (!isRecord(input)) return { error: "networkSourceLookup must be an object." };
281
- const filter = input.filter;
282
- const requestId = input.requestId;
283
- const session = input.session;
284
- const url = input.url;
285
- if (filter !== undefined && (typeof filter !== "string" || filter.trim().length === 0)) return { error: "networkSourceLookup.filter must be a non-empty string when provided." };
286
- if (requestId !== undefined && (typeof requestId !== "string" || requestId.trim().length === 0)) return { error: "networkSourceLookup.requestId must be a non-empty string when provided." };
287
- if (session !== undefined && (typeof session !== "string" || session.trim().length === 0)) return { error: "networkSourceLookup.session must be a non-empty string when provided." };
288
- if (url !== undefined && (typeof url !== "string" || url.trim().length === 0)) return { error: "networkSourceLookup.url must be a non-empty string when provided." };
289
- if (filter === undefined && requestId === undefined && url === undefined) return { error: "networkSourceLookup requires requestId, filter, or url." };
290
- const maxWorkspaceFiles = validateLookupMaxWorkspaceFiles(input.maxWorkspaceFiles, "networkSourceLookup.maxWorkspaceFiles");
291
- if (maxWorkspaceFiles.error) return { error: maxWorkspaceFiles.error };
292
- const steps: Array<{ action: "network"; args: string[] }> = [];
293
- if (typeof requestId === "string") {
294
- steps.push({ action: "network", args: ["network", "request", requestId] });
295
- }
296
- const effectiveFilter = typeof filter === "string" ? filter : typeof url === "string" ? url : undefined;
297
- if (effectiveFilter) {
298
- steps.push({ action: "network", args: ["network", "requests", "--filter", effectiveFilter] });
299
- }
300
- const args = typeof session === "string" ? ["--session", session, "batch"] : ["batch"];
301
- return { compiled: { args, query: { filter, maxWorkspaceFiles: maxWorkspaceFiles.value as number, requestId, session, url }, stdin: JSON.stringify(steps.map((step) => step.args)), steps } };
302
- }
303
-
304
- function getResultPayload(item: Record<string, unknown>): unknown {
305
- return isRecord(item.result) && "data" in item.result ? item.result.data : item.result;
306
- }
307
-
308
- function networkRequestMatchesQuery(url: string | undefined, queryText: string | undefined): boolean {
309
- return queryText === undefined || url === undefined || url.includes(queryText) || queryText.includes(url);
310
- }
311
-
312
- function isFailedNetworkRecord(request: Record<string, unknown>): boolean {
313
- const status = typeof request.status === "number" ? request.status : undefined;
314
- const error = typeof request.error === "string" ? request.error : undefined;
315
- return request.failed === true || error !== undefined || (status !== undefined && status >= 400);
316
- }
317
-
318
- function getFailedNetworkRequests(data: unknown, queryText?: string): AgentBrowserNetworkSourceLookupRequest[] {
319
- const failed: AgentBrowserNetworkSourceLookupRequest[] = [];
320
- for (const item of getBatchResultItems(data)) {
321
- const payload = getResultPayload(item);
322
- const requests = isRecord(payload) && Array.isArray(payload.requests) ? payload.requests : Array.isArray(payload) ? payload : isRecord(payload) ? [payload] : [];
323
- for (const request of requests) {
324
- if (!isRecord(request)) continue;
325
- const url = typeof request.url === "string" ? request.url : undefined;
326
- if (!networkRequestMatchesQuery(url, queryText) || !isFailedNetworkRecord(request)) continue;
327
- failed.push({
328
- error: typeof request.error === "string" ? request.error : undefined,
329
- method: typeof request.method === "string" ? request.method : undefined,
330
- requestId: typeof request.id === "string" ? request.id : typeof request.requestId === "string" ? request.requestId : undefined,
331
- status: typeof request.status === "number" ? request.status : undefined,
332
- url,
333
- });
334
- }
335
- }
336
- return failed;
337
- }
338
-
339
- function addNetworkCandidate(candidates: AgentBrowserNetworkSourceLookupCandidate[], candidate: AgentBrowserNetworkSourceLookupCandidate): void {
340
- const key = [candidate.source, candidate.file ?? "", candidate.line ?? "", candidate.requestUrl ?? ""].join(":");
341
- if (!candidates.some((existing) => [existing.source, existing.file ?? "", existing.line ?? "", existing.requestUrl ?? ""].join(":") === key)) candidates.push(candidate);
342
- }
343
-
344
- function collectInitiatorCandidates(data: unknown, failedRequests: AgentBrowserNetworkSourceLookupRequest[], candidates: AgentBrowserNetworkSourceLookupCandidate[]): void {
345
- const failedRequestIds = new Set(failedRequests.map((request) => request.requestId).filter((value): value is string => value !== undefined));
346
- const failedRequestUrls = new Set(failedRequests.map((request) => request.url).filter((value): value is string => value !== undefined));
347
- for (const item of getBatchResultItems(data)) {
348
- const payload = getResultPayload(item);
349
- const requestValues = isRecord(payload) && Array.isArray(payload.requests) ? payload.requests : [payload];
350
- for (const value of requestValues) {
351
- if (!isRecord(value)) continue;
352
- const requestUrl = typeof value.url === "string" ? value.url : undefined;
353
- const requestId = typeof value.id === "string" ? value.id : typeof value.requestId === "string" ? value.requestId : undefined;
354
- const correlatesWithFailedRequest = (requestId !== undefined && failedRequestIds.has(requestId)) || (requestUrl !== undefined && failedRequestUrls.has(requestUrl));
355
- if (!correlatesWithFailedRequest && !isFailedNetworkRecord(value)) continue;
356
- for (const field of [value.initiator, value.stack, value.source, value.trace]) {
357
- const localCandidates: AgentBrowserSourceLookupCandidate[] = [];
358
- collectSourceCandidatesFromValue(field, "dom-attribute", localCandidates, ["failed network request included source-like initiator metadata"]);
359
- for (const candidate of localCandidates) {
360
- addNetworkCandidate(candidates, { confidence: "medium", evidence: candidate.evidence, file: candidate.file, line: candidate.line, requestUrl, source: "initiator" });
361
- }
362
- }
363
- }
364
- }
365
- }
366
-
367
- async function collectWorkspaceRequestCandidates(query: CompiledAgentBrowserNetworkSourceLookup["query"], failedRequests: AgentBrowserNetworkSourceLookupRequest[], cwd: string, candidates: AgentBrowserNetworkSourceLookupCandidate[], limitations: string[]): Promise<void> {
368
- const needles = [...new Set([query.url, query.filter, ...failedRequests.map((request) => request.url)].filter((value): value is string => typeof value === "string" && value.length > 0).flatMap((value) => {
369
- try {
370
- const parsed = new URL(value);
371
- return [value, parsed.pathname].filter((item) => item && item !== "/");
372
- } catch {
373
- return [value];
374
- }
375
- }))].slice(0, 8);
376
- if (needles.length === 0) return;
377
- const files = await walkWorkspaceSourceFiles(cwd, query.maxWorkspaceFiles);
378
- if (files.length >= query.maxWorkspaceFiles) limitations.push(`Workspace source scan stopped at ${query.maxWorkspaceFiles} files.`);
379
- for (const file of files) {
380
- let text: string;
381
- try { text = await readFile(file, "utf8"); } catch { continue; }
382
- for (const needle of needles) {
383
- const index = text.indexOf(needle);
384
- if (index === -1) continue;
385
- addNetworkCandidate(candidates, { confidence: "low", evidence: [`local workspace contains request URL literal ${needle}`], file, line: text.slice(0, index).split("\n").length, requestUrl: needle, source: "workspace-search" });
386
- if (candidates.filter((candidate) => candidate.source === "workspace-search").length >= 10) return;
387
- }
388
- }
389
- }
390
-
391
- export function redactNetworkSourceLookupUrl(value: string | undefined): string | undefined {
392
- if (!value) return value;
393
- try {
394
- const isRelative = value.startsWith("/");
395
- const url = new URL(value, isRelative ? "https://redacted.invalid" : undefined);
396
- url.username = url.username ? "[REDACTED]" : "";
397
- url.password = url.password ? "[REDACTED]" : "";
398
- for (const key of [...url.searchParams.keys()]) {
399
- url.searchParams.set(key, "[REDACTED]");
400
- }
401
- if (/(?:token|secret|password|passwd|pwd|key|auth|session|jwt|credential)/i.test(url.hash)) {
402
- url.hash = "#[REDACTED]";
403
- }
404
- return isRelative ? `${url.pathname}${url.search}${url.hash}` : url.toString();
405
- } catch {
406
- return redactSensitiveText(value
407
- .replace(/([a-z][a-z0-9+.-]*:\/\/)\S+:\S+@/gi, "$1[REDACTED]@")
408
- .replace(/([?&][^=]+)=([^&#\s"'\]]+)/g, "$1=[REDACTED]"));
409
- }
410
- }
411
-
412
- export function redactNetworkSourceLookupArgs(args: string[]): string[] {
413
- return redactInvocationArgs(args).map((arg) => redactNetworkSourceLookupUrl(arg) ?? arg);
414
- }
415
-
416
- export function redactNetworkSourceLookupSurface(value: unknown): unknown {
417
- if (typeof value === "string") return redactNetworkSourceLookupUrl(value) ?? value;
418
- if (Array.isArray(value)) return value.map((item) => redactNetworkSourceLookupSurface(item));
419
- if (!isRecord(value)) return value;
420
- return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, redactNetworkSourceLookupSurface(item)]));
421
- }
422
-
423
- export function redactNetworkSourceLookupAnalysis(analysis: AgentBrowserNetworkSourceLookupAnalysis): AgentBrowserNetworkSourceLookupAnalysis {
424
- return {
425
- ...analysis,
426
- candidates: analysis.candidates.map((candidate) => ({
427
- ...candidate,
428
- evidence: candidate.evidence.map((item) => redactNetworkSourceLookupUrl(item) ?? redactSensitiveText(item)),
429
- file: redactNetworkSourceLookupUrl(candidate.file),
430
- requestUrl: redactNetworkSourceLookupUrl(candidate.requestUrl),
431
- })),
432
- failedRequests: analysis.failedRequests.map((request) => ({ ...request, error: redactNetworkSourceLookupUrl(request.error), url: redactNetworkSourceLookupUrl(request.url) })),
433
- };
434
- }
435
-
436
- export async function analyzeNetworkSourceLookupResults(data: unknown, compiled: CompiledAgentBrowserNetworkSourceLookup, cwd: string): Promise<AgentBrowserNetworkSourceLookupAnalysis> {
437
- const limitations = [
438
- "Experimental network source hints report candidates only; failed requests can be triggered indirectly by frameworks, caches, service workers, or third-party scripts.",
439
- "Initiator/source-map metadata is upstream/browser-build dependent and may be absent.",
440
- ];
441
- const failedRequests = getFailedNetworkRequests(data, compiled.query.url ?? compiled.query.filter);
442
- const candidates: AgentBrowserNetworkSourceLookupCandidate[] = [];
443
- collectInitiatorCandidates(data, failedRequests, candidates);
444
- await collectWorkspaceRequestCandidates(compiled.query, failedRequests, cwd, candidates, limitations);
445
- const status: AgentBrowserNetworkSourceLookupStatus = failedRequests.length === 0 ? "no-failed-requests" : candidates.length > 0 ? "failed-requests-found" : "no-candidates";
446
- return { candidates, failedRequests, limitations, status, summary: failedRequests.length === 0 ? "Network source lookup found no failed requests." : candidates.length > 0 ? `Network source lookup found ${failedRequests.length} failed request(s) and ${candidates.length} candidate source hint(s).` : `Network source lookup found ${failedRequests.length} failed request(s) but no source candidates.` };
447
- }