@duckmind/dm-windows-x64 0.60.6 → 0.60.8

package/extensions/dm-cua/src/browser-cua-lib.mjs

@@ -1,6 +1,490 @@
-import{createHash as dm}from"node:crypto";import{spawn as nm}from"node:child_process";import{existsSync as V,mkdirSync as g,readFileSync as Am}from"node:fs";import Tm from"node:http";import{homedir as Lm,platform as $m,tmpdir as c}from"node:os";import{dirname as N,join as f,resolve as Y}from"node:path";import{fileURLToPath as wm}from"node:url";import{spawn as P}from"node:child_process";import{existsSync as p}from"node:fs";import{homedir as W,platform as H}from"node:os";import J from"node:path";var x=900000,E=16384,K=5,t=1000;function Q(...m){return J.win32.join(...m)}function _(m,o){if(o&&!m.includes(o))m.push(o)}function a(m,o,i){let L=m.PATH??m.Path??m.path??"",T=o==="win32"?";":J.delimiter,n=o==="win32"?(m.PATHEXT??".COM;.EXE;.BAT;.CMD").split(";").filter(Boolean):[""],A=[];for(let w of L.split(T).filter(Boolean))for(let M of i){if(o==="win32"&&J.win32.extname(M)){_(A,Q(w,M));continue}for(let d of n){let h=o==="win32"?`${M}${d.toLowerCase()}`:M;_(A,o==="win32"?Q(w,h):J.join(w,h))}}return A}function v({env:m=process.env,platformName:o=H(),homeDir:i=W(),exists:L=p}={}){let T=[];if(o==="win32"){for(let n of[m.LOCALAPPDATA,m.ProgramFiles,m["ProgramFiles(x86)"]]){if(!n)continue;_(T,Q(n,"Google","Chrome","Application","chrome.exe")),_(T,Q(n,"Chromium","Application","chrome.exe"))}_(T,i?Q(i,"AppData","Local","Google","Chrome","Application","chrome.exe"):void 0),T.push(...a(m,o,["chrome","chromium"]))}else if(o==="darwin"){for(let n of["/Applications",J.join(i,"Applications")])_(T,J.join(n,"Google Chrome.app","Contents","MacOS","Google Chrome")),_(T,J.join(n,"Chromium.app","Contents","MacOS","Chromium"));T.push(...a(m,o,["google-chrome-stable","google-chrome","chromium","chromium-browser"]))}else if(o==="linux"){for(let n of["/usr/bin/google-chrome-stable","/usr/bin/google-chrome","/usr/bin/chromium","/usr/bin/chromium-browser","/snap/bin/chromium","/usr/local/bin/google-chrome","/usr/local/bin/chromium"])_(T,n);T.push(...a(m,o,["google-chrome-stable","google-chrome","chromium","chromium-browser"]))}return T.find((n)=>L(n))}function C(m,...o){return{command:m,args:o}}function z(m,o){if(o===0)return m;return m.map(({command:i,args:L})=>C("sudo","-n",i,...L))}function r({platformName:m=H(),uid:o=typeof process.getuid==="function"?process.getuid():void 0}={}){if(m==="darwin")return[{id:"homebrew-google-chrome",commands:[C("brew","install","--cask","google-chrome")]}];if(m==="win32"){let i=["install","--id","Google.Chrome","-e","--silent","--accept-package-agreements","--accept-source-agreements","--disable-interactivity"];return[{id:"winget-user-google-chrome",commands:[C("winget",...i.slice(0,4),"--scope","user",...i.slice(4))]},{id:"winget-machine-google-chrome",commands:[C("winget",...i)]},{id:"chocolatey-google-chrome",commands:[C("choco","install","googlechrome","-y","--no-progress")]}]}if(m==="linux")return[{id:"apt-chromium",commands:z([C("apt-get","update"),C("apt-get","install","-y","chromium")],o)},{id:"apt-chromium-browser",commands:z([C("apt-get","update"),C("apt-get","install","-y","chromium-browser")],o)},{id:"dnf-chromium",commands:z([C("dnf","install","-y","chromium")],o)},{id:"yum-chromium",commands:z([C("yum","install","-y","chromium")],o)},{id:"pacman-chromium",commands:z([C("pacman","-S","--noconfirm","--needed","chromium")],o)},{id:"zypper-chromium",commands:z([C("zypper","--non-interactive","install","chromium")],o)},{id:"apk-chromium",commands:z([C("apk","add","chromium")],o)}];return[]}function e(m=process.env){let o=m.DM_CUA_AUTO_INSTALL;if(o===void 0)return!0;return!["0","false","no","off"].includes(o.trim().toLowerCase())}function mm(m){let o=Number(m.DM_CUA_INSTALL_TIMEOUT_MS);return Number.isFinite(o)&&o>0?o:x}function F(m,o){let i=`${m}${o}`;if(Buffer.byteLength(i)<=E)return i;return i.slice(-E)}function om(m,o,{env:i=process.env,timeoutMs:L=mm(i)}={}){return new Promise((T)=>{let n=!1,A="",w,M=P(m,o,{env:i,shell:!1,stdio:["ignore","pipe","pipe"],windowsHide:!0}),d=(h)=>{if(n)return;n=!0,clearTimeout(w),T(h)};M.stdout?.on("data",(h)=>{A=F(A,h.toString())}),M.stderr?.on("data",(h)=>{A=F(A,h.toString())}),M.on("error",(h)=>{d({status:h.code==="ENOENT"?"unavailable":"failed",exitCode:null,message:`${h.message}${A?`
-${A.trim()}`:""}`})}),M.on("close",(h,$)=>{d({status:h===0?"ok":"failed",exitCode:h,message:A.trim()||($?`installer terminated by signal ${$}`:"")})}),w=setTimeout(()=>{M.kill(),d({status:"timeout",exitCode:null,message:`installer timed out after ${L}ms`})},L)})}function im(m){if(m.startsWith("homebrew-"))return"Homebrew";if(m.startsWith("winget-"))return"winget";return m.split("-")[0]}function hm(m){let o=m.message?`: ${m.message}`:"";return`${m.id} ${m.status}${o}`}async function b({env:m=process.env,platformName:o=H(),uid:i=typeof process.getuid==="function"?process.getuid():void 0,findExecutable:L=()=>v({env:m,platformName:o,homeDir:W()}),runCommand:T=(A,w)=>om(A,w,{env:m}),sleep:n=(A)=>new Promise((w)=>{setTimeout(w,A)})}={}){let A=L();if(A)return{status:"existing",path:A,method:null,attempts:[]};if(!e(m))throw Error("Chrome was not found and automatic installation is disabled by DM_CUA_AUTO_INSTALL.");let w=r({platformName:o,uid:i});if(w.length===0)throw Error(`Chrome was not found and no automatic Chrome installer is defined for ${o}.`);let M=[];for(let h of w){let $={status:"ok",exitCode:0,message:""};for(let D of h.commands)if($=await T(D.command,D.args),$.status!=="ok")break;if($.status!=="ok"){M.push({id:h.id,status:$.status,exitCode:$.exitCode,message:$.message});continue}let U;for(let D=0;D<K;D+=1){if(U=L(),U)break;if(D<K-1)await n(t)}if(U)return M.push({id:h.id,status:"installed",exitCode:$.exitCode,message:$.message}),{status:"installed",path:U,method:h.id,attempts:M};M.push({id:h.id,status:"missing-after-success",exitCode:$.exitCode,message:`${im(h.id)} reported success, but Chrome was not found`})}let d=M.map(hm).join("; ");throw Error(`Chrome automatic installation failed. ${d}`)}var q=N(wm(import.meta.url)),Bm=Y(q,".."),Mm=9322,Cm=400,j=60000,um=/^(about:|https?:\/\/|file:|chrome-error:\/\/)/i,fm={chrome:"Chrome",cloak:"CloakBrowser"};function O(m){let o=Number.parseInt(String(m??""),10);return Number.isInteger(o)&&o>1024&&o<65535?o:null}function Um(m){return dm("sha256").update(String(m||"default")).digest("hex")}function km(m){let o=String(m||"chrome").trim().toLowerCase();if(o==="cloakbrowser"||o==="cloak-browser")return"cloak";if(o==="chromium"||o==="google-chrome"||o==="chrome")return"chrome";return o.replace(/[^a-z0-9_.-]/g,"-")||"chrome"}function Xm(m,o){let i=m.DM_CUA_BROWSER_PATH||(o==="cloak"?m.DM_CUA_CLOAK_PATH||m.CLOAKBROWSER_BINARY_PATH:void 0)||m.CHROME_PATH;return i?Y(String(i)):void 0}function _m(m=process.env,o=process.cwd()){let i=m.DM_CUA_SCOPE||m.DM_CODING_AGENT_DIR||m.PI_CODING_AGENT_DIR||o,L=Um(Y(String(i||"."))),T=String(m.DM_CUA_INSTANCE_ID||L.slice(0,12)).replace(/[^a-zA-Z0-9_.-]/g,"-"),n=km(m.DM_CUA_BROWSER||m.DM_BROWSER_CUA_BROWSER||m.DM_CUA_BROWSER_KIND),A=m.DM_CUA_BROWSER_DISPLAY_NAME||fm[n]||n,w=Xm(m,n),M=O(m.DM_CUA_PORT)??O(m.GREEDY_SEARCH_PORT)??Mm+Number.parseInt(L.slice(0,8),16)%Cm,d=n==="chrome"?"chrome":n,h=Y(m.DM_CUA_PROFILE_DIR||f(c(),`dm-cua-${d}-profile-${T}`)),$=$m()==="win32"?c():"/tmp";return{instanceId:T,browserKind:n,browserDisplayName:A,browserExecutablePath:w,browserExecutableIsExplicit:Boolean(w),browserInstallation:void 0,port:M,profileDir:h,pidFile:f(h,"chrome.pid"),modeFile:f(h,"chrome-mode"),pagesCache:f(h,"cdp-pages.json"),socketDir:f($,`dm-cua-cdp-${T}`)}}var u=_m(),Ym=u.port,Sm=u.profileDir;function k(){return{kind:u.browserKind,displayName:u.browserDisplayName,executablePath:u.browserExecutablePath,installation:u.browserInstallation??null,profileDir:u.profileDir,port:u.port}}async function zm(m=u,{env:o=process.env,exists:i=V,ensureChrome:L=b}={}){if(m.browserKind==="cloak"&&!m.browserExecutablePath)throw Error(["CloakBrowser selected for browser CUA, but no executable path was provided.","Install/pre-download CloakBrowser yourself, then set DM_CUA_BROWSER_PATH, DM_CUA_CLOAK_PATH, CLOAKBROWSER_BINARY_PATH, or CHROME_PATH.","DM does not bundle the compiled CloakBrowser binary because its upstream license allows use but not redistribution."].join(" "));if(m.browserExecutablePath&&!i(m.browserExecutablePath))throw Error(`${m.browserDisplayName} executable not found: ${m.browserExecutablePath}`);if(m.browserExecutablePath)return m;if(m.browserKind!=="chrome")throw Error(`${m.browserDisplayName} browser CUA requires an explicit executable path via DM_CUA_BROWSER_PATH.`);let T=await L({env:o});return m.browserExecutablePath=T.path,m.browserInstallation={status:T.status,method:T.method,attempts:T.attempts.map(({id:n,status:A,exitCode:w})=>({id:n,status:A,exitCode:w}))},m}var Z;async function Jm(){if(!Z)Z=zm(u).catch((m)=>{throw Z=void 0,m});return Z}function B(){let o=[Y(q,"..","greedysearch-dm"),Y(q,"..","..","greedysearch-dm")].map((i)=>({launchScript:f(i,"bin","launch.mjs"),cdpScript:f(i,"bin","cdp.mjs")}));for(let i of o)if(V(i.launchScript)&&V(i.cdpScript))return i;return o[0]}function ym(m=u,o=process.env){let i=o.GREEDY_SEARCH_VISIBLE??o.DM_CUA_VISIBLE??o.DM_BROWSER_CUA_VISIBLE;return{...o,...m.browserExecutablePath?{CHROME_PATH:m.browserExecutablePath}:{},CDP_PROFILE_DIR:m.profileDir.replace(/\\/g,"/"),CDP_PAGES_CACHE:m.pagesCache.replace(/\\/g,"/"),CDP_SOCKET_DIR:m.socketDir.replace(/\\/g,"/"),GREEDY_SEARCH_BROWSER_LABEL:m.browserDisplayName,GREEDY_SEARCH_PORT:String(m.port),GREEDY_SEARCH_PROFILE_DIR:m.profileDir.replace(/\\/g,"/"),GREEDY_SEARCH_PID_FILE:m.pidFile.replace(/\\/g,"/"),GREEDY_SEARCH_MODE_FILE:m.modeFile.replace(/\\/g,"/"),GREEDY_SEARCH_ALLOW_PORT_CLEANUP:o.GREEDY_SEARCH_ALLOW_PORT_CLEANUP??"0",...i===void 0?{}:{GREEDY_SEARCH_VISIBLE:i}}}function s(){return ym(u,process.env)}function Dm(m){return um.test(m)}function Qm(m){return m.split(/\r?\n/).map((o)=>o.trimEnd()).filter(Boolean).map((o)=>{let i=o.trim().split(/\s{2,}/).filter(Boolean);if(i.length===0)return null;let L=i[0];if(i.length===1)return{target:L,title:"",url:""};if(i.length===2&&Dm(i[1]))return{target:L,title:"",url:i[1]};let T=i.at(-1)??"",n=i.slice(1,-1).join("  ");return{target:L,title:n,url:T}}).filter(Boolean)}function Vm(m){let o=String(m??"").trim();if(!o)throw Error("selector is required for action=click");if(/:contains\s*\(/i.test(o))throw Error(":contains(...) is not a standard CSS selector. Use browser_cua(snapshot) to inspect a standard selector, or browser_cua(evaluate) for text matching.");return o}function Zm(){let m=process.env.DM_CODING_AGENT_DIR||process.env.PI_CODING_AGENT_DIR;return m?Y(m):f(Lm(),".dm","agent")}function am(){let m=f(Zm(),"cua","screenshots");g(m,{recursive:!0});let o=new Date().toISOString().replace(/[:.]/g,"-");return f(m,`browser-${o}.png`)}function G(m,o,{env:i=process.env,timeoutMs:L=j}={}){return new Promise((T,n)=>{let A=nm("node",[m,...o],{env:i,stdio:["ignore","pipe","pipe"]}),w="",M="",d=!1,h=setTimeout(()=>{if(d)return;d=!0,A.kill("SIGTERM"),n(Error(`Timed out running ${m}`))},L);A.stdout.on("data",($)=>{w+=$.toString()}),A.stderr.on("data",($)=>{M+=$.toString()}),A.on("error",($)=>{if(d)return;d=!0,clearTimeout(h),n($)}),A.on("close",($)=>{if(d)return;if(d=!0,clearTimeout(h),$!==0){n(Error((M||w||`exit ${$}`).trim()));return}T({stdout:w,stderr:M})})})}function Hm(m,o){return new Promise((i,L)=>{let T=Tm.request({host:"127.0.0.1",port:Ym,path:o,method:m},(n)=>{let A="";n.on("data",(w)=>{A+=w.toString()}),n.on("end",()=>{if((n.statusCode??500)>=400){L(Error(`Browser CDP HTTP ${n.statusCode}: ${A.trim()}`));return}try{i(A?JSON.parse(A):{})}catch(w){L(w)}})});T.on("error",L),T.end()})}async function qm(m="about:blank"){return Hm("PUT",`/json/new?${encodeURIComponent(m)}`)}async function X(m,o={}){let{cdpScript:i}=B();return G(i,m,{env:s(),timeoutMs:o.timeoutMs??j})}async function I(){let m=await X(["list"]);return Qm(m.stdout)}function S(m,o){if(!o)return m[0]??null;let i=o.toUpperCase();return m.find((L)=>L.target.toUpperCase().startsWith(i))??null}async function l(){let{launchScript:m,cdpScript:o}=B();if(!V(m)||!V(o))throw Error("Bundled browser helpers are missing. Rebuild DM so dm-cua and greedysearch-dm are staged together.");return{launchScript:m,cdpScript:o}}async function R(){let{launchScript:m}=await l();await Jm(),await G(m,[],{env:s(),timeoutMs:j});let o=await I();if(o.length===0)await qm("about:blank"),o=await I();return o}async function y(m){let o=await R(),i=S(o,m);if(!i){if(m)throw Error(`No browser tab matching prefix "${m}". Run browser_cua(list) first.`);throw Error("No browser tab available after browser bootstrap.")}return{tab:i.target,page:i,pages:o}}async function lm({action:m,tab:o,url:i,selector:L,x:T,y:n,text:A,expression:w,outputPath:M}={}){switch(m){case"list":{let d=await R();return{status:"ok",action:m,browser:k(),pages:d}}case"navigate":{if(!i)throw Error("url is required for action=navigate");let d=await y(o),h=await X(["nav",d.tab,i],{timeoutMs:90000}),$=await I(),U=S($,d.tab)??d.page;return{status:"ok",action:m,browser:k(),tab:d.tab,url:U?.url||i,title:U?.title||"",message:h.stdout.trim(),pages:$}}case"snapshot":{let d=await y(o),h=await X(["snap",d.tab]);return{status:"ok",action:m,browser:k(),tab:d.tab,title:d.page?.title||"",url:d.page?.url||"",snapshot:h.stdout.trim()}}case"screenshot":{let d=await y(o),h=M?Y(M):am();g(N(h),{recursive:!0});let $=await X(["shot",d.tab,h],{timeoutMs:120000}),U=Am(h).toString("base64");return{status:"ok",action:m,browser:k(),tab:d.tab,title:d.page?.title||"",url:d.page?.url||"",imagePath:h,imageBase64:U,mimeType:"image/png",message:$.stdout.trim()}}case"click":{let d=Vm(L),h=await y(o),$=await X(["click",h.tab,d]);return{status:"ok",action:m,browser:k(),tab:h.tab,selector:d,message:$.stdout.trim()}}case"click_xy":{if(typeof T!=="number"||Number.isNaN(T)||typeof n!=="number"||Number.isNaN(n))throw Error("x and y are required numbers for action=click_xy");let d=await y(o),h=await X(["clickxy",d.tab,String(T),String(n)]);return{status:"ok",action:m,browser:k(),tab:d.tab,x:T,y:n,message:h.stdout.trim()}}case"type":{if(A==null||A==="")throw Error("text is required for action=type");let d=await y(o),h=await X(["type",d.tab,A]);return{status:"ok",action:m,browser:k(),tab:d.tab,textLength:A.length,message:h.stdout.trim()}}case"evaluate":{if(!w)throw Error("expression is required for action=evaluate");let d=await y(o),h=await X(["eval",d.tab,w]);return{status:"ok",action:m,browser:k(),tab:d.tab,value:h.stdout.trim()}}case"stop":{let{launchScript:d}=await l();try{await X(["stop"])}catch{}let h=await G(d,["--kill"],{env:s(),timeoutMs:30000});return{status:"ok",action:m,browser:k(),message:(h.stdout||"Stopped browser CUA lane.").trim()}}default:throw Error(`Unsupported browser action: ${m}`)}}function Rm(m){switch(m.action){case"list":{if(!Array.isArray(m.pages)||m.pages.length===0)return"Browser CUA is ready, but no pages are open.";return["Open browser tabs:",...m.pages.map((o)=>o.url?`${o.target}  ${o.title||"(untitled)"}  ${o.url}`:`${o.target}  ${o.title||"(untitled)"}`)].join(`
-`)}case"navigate":return[`Navigated browser tab ${m.tab} to ${m.url||"(unknown URL)"}`,m.title?`Title: ${m.title}`:""].filter(Boolean).join(`
-`);case"snapshot":return[`Browser snapshot for ${m.tab}`,m.snapshot||"(empty snapshot)"].join(`
-`);case"screenshot":return[`Saved browser screenshot for ${m.tab} at ${m.imagePath}`,m.title?`Title: ${m.title}`:"",m.url?`URL: ${m.url}`:""].filter(Boolean).join(`
-`);case"click":return`Clicked selector ${JSON.stringify(m.selector)} on browser tab ${m.tab}`;case"click_xy":return`Clicked browser tab ${m.tab} at CSS coordinates (${m.x}, ${m.y})`;case"type":return`Typed ${m.textLength} characters into browser tab ${m.tab}`;case"evaluate":return`Browser evaluate result for ${m.tab}: ${m.value}`;case"stop":return m.message||"Stopped browser CUA lane.";default:return JSON.stringify(m,null,2)}}export{Vm as validateBrowserSelector,lm as runBrowserAction,_m as resolveBrowserRuntimeConfig,ym as resolveBrowserProcessEnv,B as resolveBrowserHelperPaths,Rm as renderBrowserActionText,Qm as parseListOutput,zm as ensureBrowserSelectionUsable,R as ensureBrowserReady,Sm as BROWSER_PROFILE_DIR};
+import { createHash } from "node:crypto";
+import { spawn } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import http from "node:http";
+import { homedir, platform, tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ensureChromeAvailable } from "./browser-install.mjs";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT_DIR = resolve(__dirname, "..");
+const DEFAULT_CUA_PORT_BASE = 9322;
+const DEFAULT_CUA_PORT_RANGE = 400;
+const DEFAULT_TIMEOUT_MS = 60000;
+const URLISH_PATTERN = /^(about:|https?:\/\/|file:|chrome-error:\/\/)/i;
+const BROWSER_DISPLAY_NAMES = {
+  chrome: "Chrome",
+  cloak: "CloakBrowser"
+};
+function parsePort(value) {
+  const port = Number.parseInt(String(value ?? ""), 10);
+  return Number.isInteger(port) && port > 1024 && port < 65535 ? port : null;
+}
+function hashScope(value) {
+  return createHash("sha256").update(String(value || "default")).digest("hex");
+}
+function normalizeBrowserKind(value) {
+  const raw = String(value || "chrome").trim().toLowerCase();
+  if (raw === "cloakbrowser" || raw === "cloak-browser")
+    return "cloak";
+  if (raw === "chromium" || raw === "google-chrome" || raw === "chrome")
+    return "chrome";
+  return raw.replace(/[^a-z0-9_.-]/g, "-") || "chrome";
+}
+function resolveBrowserExecutablePath(env, browserKind) {
+  const explicit = env.DM_CUA_BROWSER_PATH || (browserKind === "cloak" ? env.DM_CUA_CLOAK_PATH || env.CLOAKBROWSER_BINARY_PATH : undefined) || env.CHROME_PATH;
+  return explicit ? resolve(String(explicit)) : undefined;
+}
+export function resolveBrowserRuntimeConfig(env = process.env, scope = process.cwd()) {
+  const rawScope = env.DM_CUA_SCOPE || env.DM_CODING_AGENT_DIR || env.PI_CODING_AGENT_DIR || scope;
+  const scopeHash = hashScope(resolve(String(rawScope || ".")));
+  const instanceId = String(env.DM_CUA_INSTANCE_ID || scopeHash.slice(0, 12)).replace(/[^a-zA-Z0-9_.-]/g, "-");
+  const browserKind = normalizeBrowserKind(env.DM_CUA_BROWSER || env.DM_BROWSER_CUA_BROWSER || env.DM_CUA_BROWSER_KIND);
+  const browserDisplayName = env.DM_CUA_BROWSER_DISPLAY_NAME || BROWSER_DISPLAY_NAMES[browserKind] || browserKind;
+  const browserExecutablePath = resolveBrowserExecutablePath(env, browserKind);
+  const port = parsePort(env.DM_CUA_PORT) ?? parsePort(env.GREEDY_SEARCH_PORT) ?? DEFAULT_CUA_PORT_BASE + Number.parseInt(scopeHash.slice(0, 8), 16) % DEFAULT_CUA_PORT_RANGE;
+  const profileSuffix = browserKind === "chrome" ? "chrome" : browserKind;
+  const profileDir = resolve(env.DM_CUA_PROFILE_DIR || join(tmpdir(), `dm-cua-${profileSuffix}-profile-${instanceId}`));
+  const socketBaseDir = platform() === "win32" ? tmpdir() : "/tmp";
+  return {
+    instanceId,
+    browserKind,
+    browserDisplayName,
+    browserExecutablePath,
+    browserExecutableIsExplicit: Boolean(browserExecutablePath),
+    browserInstallation: undefined,
+    port,
+    profileDir,
+    pidFile: join(profileDir, "chrome.pid"),
+    modeFile: join(profileDir, "chrome-mode"),
+    pagesCache: join(profileDir, "cdp-pages.json"),
+    socketDir: join(socketBaseDir, `dm-cua-cdp-${instanceId}`)
+  };
+}
+const BROWSER_CONFIG = resolveBrowserRuntimeConfig();
+const CHROME_PORT = BROWSER_CONFIG.port;
+export const BROWSER_PROFILE_DIR = BROWSER_CONFIG.profileDir;
+function browserSummary() {
+  return {
+    kind: BROWSER_CONFIG.browserKind,
+    displayName: BROWSER_CONFIG.browserDisplayName,
+    executablePath: BROWSER_CONFIG.browserExecutablePath,
+    installation: BROWSER_CONFIG.browserInstallation ?? null,
+    profileDir: BROWSER_CONFIG.profileDir,
+    port: BROWSER_CONFIG.port
+  };
+}
+export async function ensureBrowserSelectionUsable(config = BROWSER_CONFIG, {
+  env = process.env,
+  exists = existsSync,
+  ensureChrome = ensureChromeAvailable
+} = {}) {
+  if (config.browserKind === "cloak" && !config.browserExecutablePath) {
+    throw new Error([
+      "CloakBrowser selected for browser CUA, but no executable path was provided.",
+      "Install/pre-download CloakBrowser yourself, then set DM_CUA_BROWSER_PATH, DM_CUA_CLOAK_PATH, CLOAKBROWSER_BINARY_PATH, or CHROME_PATH.",
+      "DM does not bundle the compiled CloakBrowser binary because its upstream license allows use but not redistribution."
+    ].join(" "));
+  }
+  if (config.browserExecutablePath && !exists(config.browserExecutablePath)) {
+    throw new Error(`${config.browserDisplayName} executable not found: ${config.browserExecutablePath}`);
+  }
+  if (config.browserExecutablePath)
+    return config;
+  if (config.browserKind !== "chrome") {
+    throw new Error(`${config.browserDisplayName} browser CUA requires an explicit executable path via DM_CUA_BROWSER_PATH.`);
+  }
+  const selection = await ensureChrome({ env });
+  config.browserExecutablePath = selection.path;
+  config.browserInstallation = {
+    status: selection.status,
+    method: selection.method,
+    attempts: selection.attempts.map(({ id, status, exitCode }) => ({
+      id,
+      status,
+      exitCode
+    }))
+  };
+  return config;
+}
+let browserSelectionPromise;
+async function ensureConfiguredBrowserSelectionUsable() {
+  if (!browserSelectionPromise) {
+    browserSelectionPromise = ensureBrowserSelectionUsable(BROWSER_CONFIG).catch((error) => {
+      browserSelectionPromise = undefined;
+      throw error;
+    });
+  }
+  return browserSelectionPromise;
+}
+export function resolveBrowserHelperPaths() {
+  const helperRoots = [
+    resolve(__dirname, "..", "greedysearch-dm"),
+    resolve(__dirname, "..", "..", "greedysearch-dm")
+  ];
+  const candidates = helperRoots.map((root) => ({
+    launchScript: join(root, "bin", "launch.mjs"),
+    cdpScript: join(root, "bin", "cdp.mjs")
+  }));
+  for (const candidate of candidates) {
+    if (existsSync(candidate.launchScript) && existsSync(candidate.cdpScript)) {
+      return candidate;
+    }
+  }
+  return candidates[0];
+}
+export function resolveBrowserProcessEnv(config = BROWSER_CONFIG, env = process.env) {
+  const visible = env.GREEDY_SEARCH_VISIBLE ?? env.DM_CUA_VISIBLE ?? env.DM_BROWSER_CUA_VISIBLE;
+  return {
+    ...env,
+    ...config.browserExecutablePath ? { CHROME_PATH: config.browserExecutablePath } : {},
+    CDP_PROFILE_DIR: config.profileDir.replace(/\\/g, "/"),
+    CDP_PAGES_CACHE: config.pagesCache.replace(/\\/g, "/"),
+    CDP_SOCKET_DIR: config.socketDir.replace(/\\/g, "/"),
+    GREEDY_SEARCH_BROWSER_LABEL: config.browserDisplayName,
+    GREEDY_SEARCH_PORT: String(config.port),
+    GREEDY_SEARCH_PROFILE_DIR: config.profileDir.replace(/\\/g, "/"),
+    GREEDY_SEARCH_PID_FILE: config.pidFile.replace(/\\/g, "/"),
+    GREEDY_SEARCH_MODE_FILE: config.modeFile.replace(/\\/g, "/"),
+    GREEDY_SEARCH_ALLOW_PORT_CLEANUP: env.GREEDY_SEARCH_ALLOW_PORT_CLEANUP ?? "0",
+    ...visible === undefined ? {} : { GREEDY_SEARCH_VISIBLE: visible }
+  };
+}
+function browserEnv() {
+  return resolveBrowserProcessEnv(BROWSER_CONFIG, process.env);
+}
+function looksLikeUrl(value) {
+  return URLISH_PATTERN.test(value);
+}
+export function parseListOutput(output) {
+  return output.split(/\r?\n/).map((line) => line.trimEnd()).filter(Boolean).map((line) => {
+    const parts = line.trim().split(/\s{2,}/).filter(Boolean);
+    if (parts.length === 0) {
+      return null;
+    }
+    const target = parts[0];
+    if (parts.length === 1) {
+      return { target, title: "", url: "" };
+    }
+    if (parts.length === 2 && looksLikeUrl(parts[1])) {
+      return { target, title: "", url: parts[1] };
+    }
+    const url = parts.at(-1) ?? "";
+    const title = parts.slice(1, -1).join("  ");
+    return { target, title, url };
+  }).filter(Boolean);
+}
+export function validateBrowserSelector(selector) {
+  const value = String(selector ?? "").trim();
+  if (!value) {
+    throw new Error("selector is required for action=click");
+  }
+  if (/:contains\s*\(/i.test(value)) {
+    throw new Error(":contains(...) is not a standard CSS selector. Use browser_cua(snapshot) to inspect a standard selector, or browser_cua(evaluate) for text matching.");
+  }
+  return value;
+}
+function resolveAgentDir() {
+  const explicit = process.env.DM_CODING_AGENT_DIR || process.env.PI_CODING_AGENT_DIR;
+  return explicit ? resolve(explicit) : join(homedir(), ".dm", "agent");
+}
+function defaultScreenshotPath() {
+  const dir = join(resolveAgentDir(), "cua", "screenshots");
+  mkdirSync(dir, { recursive: true });
+  const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+  return join(dir, `browser-${stamp}.png`);
+}
+function runNodeScript(scriptPath, args, { env = process.env, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
+  return new Promise((resolvePromise, rejectPromise) => {
+    const child = spawn("node", [scriptPath, ...args], {
+      env,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let stdout = "";
+    let stderr = "";
+    let settled = false;
+    const timeout = setTimeout(() => {
+      if (settled)
+        return;
+      settled = true;
+      child.kill("SIGTERM");
+      rejectPromise(new Error(`Timed out running ${scriptPath}`));
+    }, timeoutMs);
+    child.stdout.on("data", (chunk) => {
+      stdout += chunk.toString();
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on("error", (error) => {
+      if (settled)
+        return;
+      settled = true;
+      clearTimeout(timeout);
+      rejectPromise(error);
+    });
+    child.on("close", (code) => {
+      if (settled)
+        return;
+      settled = true;
+      clearTimeout(timeout);
+      if (code !== 0) {
+        rejectPromise(new Error((stderr || stdout || `exit ${code}`).trim()));
+        return;
+      }
+      resolvePromise({ stdout, stderr });
+    });
+  });
+}
+function requestJson(method, requestPath) {
+  return new Promise((resolvePromise, rejectPromise) => {
+    const req = http.request({
+      host: "127.0.0.1",
+      port: CHROME_PORT,
+      path: requestPath,
+      method
+    }, (response) => {
+      let body = "";
+      response.on("data", (chunk) => {
+        body += chunk.toString();
+      });
+      response.on("end", () => {
+        if ((response.statusCode ?? 500) >= 400) {
+          rejectPromise(new Error(`Browser CDP HTTP ${response.statusCode}: ${body.trim()}`));
+          return;
+        }
+        try {
+          resolvePromise(body ? JSON.parse(body) : {});
+        } catch (error) {
+          rejectPromise(error);
+        }
+      });
+    });
+    req.on("error", rejectPromise);
+    req.end();
+  });
+}
+async function createBlankTarget(url = "about:blank") {
+  return requestJson("PUT", `/json/new?${encodeURIComponent(url)}`);
+}
+async function runCdp(args, options = {}) {
+  const { cdpScript } = resolveBrowserHelperPaths();
+  return runNodeScript(cdpScript, args, { env: browserEnv(), timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS });
+}
+async function listPages() {
+  const result = await runCdp(["list"]);
+  return parseListOutput(result.stdout);
+}
+function findPage(pages, prefix) {
+  if (!prefix)
+    return pages[0] ?? null;
+  const upper = prefix.toUpperCase();
+  return pages.find((page) => page.target.toUpperCase().startsWith(upper)) ?? null;
+}
+async function ensureBrowserHelpersExist() {
+  const { launchScript, cdpScript } = resolveBrowserHelperPaths();
+  if (!existsSync(launchScript) || !existsSync(cdpScript)) {
+    throw new Error("Bundled browser helpers are missing. Rebuild DM so dm-cua and greedysearch-dm are staged together.");
+  }
+  return { launchScript, cdpScript };
+}
+export async function ensureBrowserReady() {
+  const { launchScript } = await ensureBrowserHelpersExist();
+  await ensureConfiguredBrowserSelectionUsable();
+  await runNodeScript(launchScript, [], { env: browserEnv(), timeoutMs: DEFAULT_TIMEOUT_MS });
+  let pages = await listPages();
+  if (pages.length === 0) {
+    await createBlankTarget("about:blank");
+    pages = await listPages();
+  }
+  return pages;
+}
+async function resolveTabContext(tabPrefix) {
+  const pages = await ensureBrowserReady();
+  const page = findPage(pages, tabPrefix);
+  if (!page) {
+    if (tabPrefix) {
+      throw new Error(`No browser tab matching prefix "${tabPrefix}". Run browser_cua(list) first.`);
+    }
+    throw new Error("No browser tab available after browser bootstrap.");
+  }
+  return { tab: page.target, page, pages };
+}
+export async function runBrowserAction({
+  action,
+  tab,
+  url,
+  selector,
+  x,
+  y,
+  text,
+  expression,
+  outputPath
+} = {}) {
+  switch (action) {
+    case "list": {
+      const pages = await ensureBrowserReady();
+      return { status: "ok", action, browser: browserSummary(), pages };
+    }
+    case "navigate": {
+      if (!url)
+        throw new Error("url is required for action=navigate");
+      const context = await resolveTabContext(tab);
+      const result = await runCdp(["nav", context.tab, url], { timeoutMs: 90000 });
+      const pages = await listPages();
+      const page = findPage(pages, context.tab) ?? context.page;
+      return {
+        status: "ok",
+        action,
+        browser: browserSummary(),
+        tab: context.tab,
+        url: page?.url || url,
+        title: page?.title || "",
+        message: result.stdout.trim(),
+        pages
+      };
+    }
+    case "snapshot": {
+      const context = await resolveTabContext(tab);
+      const result = await runCdp(["snap", context.tab]);
+      return {
+        status: "ok",
+        action,
+        browser: browserSummary(),
+        tab: context.tab,
+        title: context.page?.title || "",
+        url: context.page?.url || "",
+        snapshot: result.stdout.trim()
+      };
+    }
+    case "screenshot": {
+      const context = await resolveTabContext(tab);
+      const imagePath = outputPath ? resolve(outputPath) : defaultScreenshotPath();
+      mkdirSync(dirname(imagePath), { recursive: true });
+      const result = await runCdp(["shot", context.tab, imagePath], { timeoutMs: 120000 });
+      const imageBase64 = readFileSync(imagePath).toString("base64");
+      return {
+        status: "ok",
+        action,
+        browser: browserSummary(),
+        tab: context.tab,
+        title: context.page?.title || "",
+        url: context.page?.url || "",
+        imagePath,
+        imageBase64,
+        mimeType: "image/png",
+        message: result.stdout.trim()
+      };
+    }
+    case "click": {
+      const safeSelector = validateBrowserSelector(selector);
+      const context = await resolveTabContext(tab);
+      const result = await runCdp(["click", context.tab, safeSelector]);
+      return {
+        status: "ok",
+        action,
+        browser: browserSummary(),
+        tab: context.tab,
+        selector: safeSelector,
+        message: result.stdout.trim()
+      };
+    }
+    case "click_xy": {
+      if (typeof x !== "number" || Number.isNaN(x) || typeof y !== "number" || Number.isNaN(y)) {
+        throw new Error("x and y are required numbers for action=click_xy");
+      }
+      const context = await resolveTabContext(tab);
+      const result = await runCdp(["clickxy", context.tab, String(x), String(y)]);
+      return {
+        status: "ok",
+        action,
+        browser: browserSummary(),
+        tab: context.tab,
+        x,
+        y,
+        message: result.stdout.trim()
+      };
+    }
+    case "type": {
+      if (text == null || text === "")
+        throw new Error("text is required for action=type");
+      const context = await resolveTabContext(tab);
+      const result = await runCdp(["type", context.tab, text]);
+      return {
+        status: "ok",
+        action,
+        browser: browserSummary(),
+        tab: context.tab,
+        textLength: text.length,
+        message: result.stdout.trim()
+      };
+    }
+    case "evaluate": {
+      if (!expression)
+        throw new Error("expression is required for action=evaluate");
+      const context = await resolveTabContext(tab);
+      const result = await runCdp(["eval", context.tab, expression]);
+      return {
+        status: "ok",
+        action,
+        browser: browserSummary(),
+        tab: context.tab,
+        value: result.stdout.trim()
+      };
+    }
+    case "stop": {
+      const { launchScript } = await ensureBrowserHelpersExist();
+      try {
+        await runCdp(["stop"]);
+      } catch {}
+      const result = await runNodeScript(launchScript, ["--kill"], { env: browserEnv(), timeoutMs: 30000 });
+      return {
+        status: "ok",
+        action,
+        browser: browserSummary(),
+        message: (result.stdout || "Stopped browser CUA lane.").trim()
+      };
+    }
+    default:
+      throw new Error(`Unsupported browser action: ${action}`);
+  }
+}
+export function renderBrowserActionText(result) {
+  switch (result.action) {
+    case "list": {
+      if (!Array.isArray(result.pages) || result.pages.length === 0) {
+        return "Browser CUA is ready, but no pages are open.";
+      }
+      return [
+        "Open browser tabs:",
+        ...result.pages.map((page) => page.url ? `${page.target}  ${page.title || "(untitled)"}  ${page.url}` : `${page.target}  ${page.title || "(untitled)"}`)
+      ].join(`
+`);
+    }
+    case "navigate":
+      return [`Navigated browser tab ${result.tab} to ${result.url || "(unknown URL)"}`, result.title ? `Title: ${result.title}` : ""].filter(Boolean).join(`
+`);
+    case "snapshot":
+      return [`Browser snapshot for ${result.tab}`, result.snapshot || "(empty snapshot)"].join(`
+`);
+    case "screenshot":
+      return [
+        `Saved browser screenshot for ${result.tab} at ${result.imagePath}`,
+        result.title ? `Title: ${result.title}` : "",
+        result.url ? `URL: ${result.url}` : ""
+      ].filter(Boolean).join(`
+`);
+    case "click":
+      return `Clicked selector ${JSON.stringify(result.selector)} on browser tab ${result.tab}`;
+    case "click_xy":
+      return `Clicked browser tab ${result.tab} at CSS coordinates (${result.x}, ${result.y})`;
+    case "type":
+      return `Typed ${result.textLength} characters into browser tab ${result.tab}`;
+    case "evaluate":
+      return `Browser evaluate result for ${result.tab}: ${result.value}`;
+    case "stop":
+      return result.message || "Stopped browser CUA lane.";
+    default:
+      return JSON.stringify(result, null, 2);
+  }
+}