@comecaramelos/dsh-chrome-mcp 0.0.1 → 2.0.0

package/lib/host/windows/connect-flags.js

@@ -0,0 +1,97 @@
+/**
+ * Windows Chrome run — the connect-mode address and flag it writes.
+ *
+ * The connect half of the run: the `http://127.0.0.1:<P>` address a debugging
+ * port answers for, the port one saved `--browserUrl=` entry carries, and the
+ * replace-by-key merge that keeps the saved flags at exactly one connect entry
+ * (never two, with the local `--user-data-dir` row dropped — upstream refuses
+ * `userDataDir` and `browserUrl` in the same argv). The run calls these to
+ * answer and to persist its outcome; ./run.ts drives them.
+ */
+import { carriesConnectionMode } from "../flags.js";
+import { BROWSER_URL_FLAG_PREFIX } from "../constants.js";
+/** The connect address one debugging port answers for. */
+export function windowsChromeUrl(port) {
+    return `http://127.0.0.1:${Math.trunc(port)}`;
+}
+/** The debugging port the live connect entry carries, 0 when the list carries
+ * none. The entry's **spelling** is irrelevant: the port is read through the
+ * very predicate that decides connect mode (`carriesConnectionMode` in
+ * `./flags.ts`), so `--browserUrl=<url>`, `--browserUrl <url>` (the two-entry
+ * form the whitespace-split env source produces), one string carrying its
+ * value after whitespace, and `--wsEndpoint=<url>` all answer with the live
+ * port instead of reading as "no live session". */
+export function browserUrlFlagPort(flags) {
+    const list = Array.isArray(flags) ? flags : [];
+    for (let index = 0; index < list.length; index += 1) {
+        const flag = list[index];
+        if (typeof flag !== "string" || !carriesConnectionMode(flag))
+            continue;
+        const eq = flag.indexOf("=");
+        if (eq !== -1) {
+            const match = flag.slice(eq + 1).trim().match(/:(\d+)/u);
+            return match === null ? 0 : Number.parseInt(match[1], 10);
+        }
+        const whitespace = flag.slice(2).match(/\s/u);
+        if (whitespace?.index !== void 0) {
+            const match = flag.slice(whitespace.index + 3).trim().match(/:(\d+)/u);
+            return match === null ? 0 : Number.parseInt(match[1], 10);
+        }
+        const value = list[index + 1];
+        const match = typeof value === "string" ? value.trim().match(/:(\d+)/u) : null;
+        return match === null ? 0 : Number.parseInt(match[1], 10);
+    }
+    return 0;
+}
+/** The local-profile row the connect entry makes mutually exclusive with it
+ * upstream: a saved `--user-data-dir` next to a `--browserUrl` kills the spawn
+ * (`Arguments userDataDir and browserUrl are mutually exclusive`, measured
+ * live with chrome-devtools-mcp), so the run drops it when it pins connect. */
+const CONNECT_EXCLUDED_FLAG = "--user-data-dir";
+/**
+ * Collapse every connect entry the list carries into the run's own address, so
+ * the saved list keeps exactly **one** connect source whatever spelling it was
+ * stored in — the same idempotency rule the saved-executable merge follows for
+ * a repeated id, keyed now on the whole connect-mode predicate rather than one
+ * flag spelling. An entry that carries its value as the *following* entry (the
+ * `--browserUrl <url>` form the whitespace-split env source produces) consumes
+ * that value with it, so no bare URL survives as a stray argv item.
+ *
+ * The one thing that does not survive is a `--user-data-dir` row: connect
+ * carries no local profile to hand the browser, upstream refuses both at once,
+ * so keeping a saved Flags-WSL row would leave the bridge unspawnable
+ * (`Arguments userDataDir and browserUrl are mutually exclusive`, measured live
+ * with chrome-devtools-mcp).
+ */
+export function withBrowserUrlFlag(flags, url) {
+    const entry = `${BROWSER_URL_FLAG_PREFIX}${url}`;
+    const list = Array.isArray(flags) ? flags : [];
+    const next = [];
+    let replaced = false;
+    let awaitingValue = false;
+    for (const flag of list) {
+        if (typeof flag !== "string")
+            continue;
+        if (flag.startsWith(CONNECT_EXCLUDED_FLAG))
+            continue;
+        if (carriesConnectionMode(flag)) {
+            if (!replaced) {
+                next.push(entry);
+                replaced = true;
+            }
+            // No inline value (no `=`, no whitespace) means the value is the
+            // entry that follows — drop it with the flag, exactly the way
+            // `stripExecutablePathFlags` consumes a `--flag <path>` spelling.
+            awaitingValue = !flag.includes("=") && !/\s/u.test(flag);
+            continue;
+        }
+        if (awaitingValue && !flag.startsWith("-"))
+            continue;
+        awaitingValue = false;
+        next.push(flag);
+    }
+    if (!replaced)
+        next.push(entry);
+    return next;
+}
+//# sourceMappingURL=connect-flags.js.map

package/lib/host/windows/connect-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-flags.js","sourceRoot":"","sources":["../../../src/host/windows/connect-flags.ts"],"names":[],"mappings":"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"}

package/lib/host/windows/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Host half — the Windows-side Chrome run behind the card's **Open Windows
+ * Chrome** button and the `prelaunch_windows_chrome` tool.
+ *
+ * The whole Windows path, split the way it reads into one directory:
+ *
+ *   ./paths.ts          drive→mount mapping, locate, the Windows-native profile
+ *                      directory + LOCALAPPDATA root, and the project dir the
+ *                      workspace `.chrome` view hangs under
+ *   ./link.ts           the workspace `.chrome` view link (a WSL-side symlink)
+ *   ./connect-flags.ts  the connect address + the replace-by-key `--browserUrl`
+ *                      merge with the local profile flag dropped
+ *   ./landing.ts        the packaged page the launched window opens, rendered
+ *                      with the run's answers, written beside the profile and
+ *                      answered back as a `file:///…` URL
+ *   ./spawn.ts          the raw TCP reachability sample + the interop launch
+ *   ./run.ts            the orchestrator: locate → prereq → port → launch → wait
+ *
+ * Driving the Windows browser in **connect** mode is the only Windows path ever
+ * measured to work (launching `chrome.exe` across the interop boundary cannot —
+ * the debug pipes do not survive it); see ./run.ts's header and the field log in
+ * `.probe/windows-chrome-connect-probe.log`. Every half is injectable, so the
+ * tests never depend on the machine they run on.
+ */
+export { findWindowsChromeExecutable, findWindowsChromeExecutables, windowsChromeLocalAppData, windowsChromeProfileDir, windowsChromeProjectDir, windowsPathToMount } from "./paths.js";
+export { linkWindowsChromeProfile } from "./link.js";
+export { browserUrlFlagPort, withBrowserUrlFlag, windowsChromeUrl } from "./connect-flags.js";
+export { windowsChromeLandingAsset, windowsChromeLandingHtml, windowsChromeLandingPath, windowsChromeLandingUrl, windowsFileUrl } from "./landing.js";
+export { runWindowsChromeConnect } from "./run.js";
+export type { WindowsChromeRunOptions } from "./run.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/host/windows/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/windows/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EACH,2BAA2B,EAC3B,4BAA4B,EAC5B,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtJ,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACnD,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC"}

package/lib/host/windows/index.js

@@ -0,0 +1,30 @@
+/**
+ * Host half — the Windows-side Chrome run behind the card's **Open Windows
+ * Chrome** button and the `prelaunch_windows_chrome` tool.
+ *
+ * The whole Windows path, split the way it reads into one directory:
+ *
+ *   ./paths.ts          drive→mount mapping, locate, the Windows-native profile
+ *                      directory + LOCALAPPDATA root, and the project dir the
+ *                      workspace `.chrome` view hangs under
+ *   ./link.ts           the workspace `.chrome` view link (a WSL-side symlink)
+ *   ./connect-flags.ts  the connect address + the replace-by-key `--browserUrl`
+ *                      merge with the local profile flag dropped
+ *   ./landing.ts        the packaged page the launched window opens, rendered
+ *                      with the run's answers, written beside the profile and
+ *                      answered back as a `file:///…` URL
+ *   ./spawn.ts          the raw TCP reachability sample + the interop launch
+ *   ./run.ts            the orchestrator: locate → prereq → port → launch → wait
+ *
+ * Driving the Windows browser in **connect** mode is the only Windows path ever
+ * measured to work (launching `chrome.exe` across the interop boundary cannot —
+ * the debug pipes do not survive it); see ./run.ts's header and the field log in
+ * `.probe/windows-chrome-connect-probe.log`. Every half is injectable, so the
+ * tests never depend on the machine they run on.
+ */
+export { findWindowsChromeExecutable, findWindowsChromeExecutables, windowsChromeLocalAppData, windowsChromeProfileDir, windowsChromeProjectDir, windowsPathToMount } from "./paths.js";
+export { linkWindowsChromeProfile } from "./link.js";
+export { browserUrlFlagPort, withBrowserUrlFlag, windowsChromeUrl } from "./connect-flags.js";
+export { windowsChromeLandingAsset, windowsChromeLandingHtml, windowsChromeLandingPath, windowsChromeLandingUrl, windowsFileUrl } from "./landing.js";
+export { runWindowsChromeConnect } from "./run.js";
+//# sourceMappingURL=index.js.map

package/lib/host/windows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/host/windows/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EACH,2BAA2B,EAC3B,4BAA4B,EAC5B,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtJ,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC"}

package/lib/host/windows/landing.d.ts

@@ -0,0 +1,47 @@
+/** The run's own tokens in the packaged page, in the shape each one answers. */
+type LandingTokens = {
+    url: string;
+    port: number;
+    profile: string;
+};
+/** The packaged page's path on this host, "" when the package carries none. */
+export declare function windowsChromeLandingAsset(): string;
+/**
+ * The packaged page, with the run's answers folded into its `{{TOKEN}}`s —
+ * "" when the asset is not there. Values are escaped, tokens the page does not
+ * carry are simply left alone, and a page whose write fails downstream is not
+ * this function's problem: it answers the *rendered* text, nothing else.
+ */
+export declare function windowsChromeLandingHtml(tokens?: Partial<LandingTokens>): string;
+/**
+ * The landing file's Windows path beside a profile directory:
+ * `…\dsh-chrome-mcp\prelaunch-<port>.html`, a **sibling** of the profile rather
+ * than a file inside it — Chrome owns everything inside its own profile
+ * directory, and this page is not part of one.
+ */
+export declare function windowsChromeLandingPath(profileDir: unknown, port: number): string;
+/**
+ * A Windows path as a `file://` URL — the only form the launched browser reads
+ * (the interop mount path is Linux-side, invisible to `chrome.exe`). No drive
+ * letter answers "" (never a half-formed URL), and every path segment is
+ * percent-encoded, since a user profile directory routinely carries spaces.
+ */
+export declare function windowsFileUrl(path: unknown): string;
+/**
+ * The whole landing-page half of a launch: render the packaged page with this
+ * run's answers, write it beside the profile directory through the interop
+ * mount, and answer the `file:///…` URL to hand the browser ("" = launch with
+ * no page). Every failure is silent on purpose — the page explains the window,
+ * it never gates it.
+ * @param profileDir - the Windows-side profile directory the launch carries.
+ * @param url - the connect address the window answers for.
+ * @param port - the debugging port that launch picked.
+ * @param write - the filesystem half: place `html` at the **mount** path and
+ * answer whether it actually landed. Defaults to creating the directory and
+ * writing the file through the interop mount; injected so a test never depends
+ * on the machine it runs on (the mount is never inside the checkout, and the
+ * agent's own file sandbox denies it outright).
+ */
+export declare function windowsChromeLandingUrl(profileDir: unknown, url: unknown, port: unknown, write?: (mountPath: string, html: string) => boolean): string;
+export {};
+//# sourceMappingURL=landing.d.ts.map

package/lib/host/windows/landing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"landing.d.ts","sourceRoot":"","sources":["../../../src/host/windows/landing.ts"],"names":[],"mappings":"AA6BA,gFAAgF;AAChF,KAAK,aAAa,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AA0BpE,+EAA+E;AAC/E,wBAAgB,yBAAyB,IAAI,MAAM,CAMlD;AAQD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,MAAM,CAmBpF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAWpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACnC,UAAU,EAAE,OAAO,EACnB,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,OAAO,EACb,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,GACrD,MAAM,CAuBR"}

package/lib/host/windows/landing.js

@@ -0,0 +1,174 @@
+/**
+ * Windows Chrome run — the **landing page** the launched window opens.
+ *
+ * A window that appears for no visible reason looks like a malfunction, and the
+ * honest answer to "why did a Chrome window just open?" is a paragraph of
+ * explanation the bridge's argv cannot carry. So the run ships one: a packaged,
+ * self-contained HTML page (`assets/prelaunch-windows-chrome.html`, the only
+ * asset the plugin carries) rendered with the run's own answers and written next
+ * to the Windows-side profile directory, so the window that opens *states* what
+ * it is for — opened by the plugin from DSH so the bridge can drive it over the
+ * debugging port, never a browsing session the user started.
+ *
+ * The file has to live on the **Windows** filesystem and be handed to the browser
+ * as a `file:///…` URL, exactly like the profile directory it sits beside: the
+ * WSL-side path is invisible to a Windows-side process. Nothing depends on it:
+ * every answer is "" when the asset cannot be read, the write fails or LOCALAPPDATA
+ * never answered, and a run without a landing page launches the same browser it
+ * launched before — the page is a description of the window, not a precondition
+ * of it. It is never opened on the re-attach branch (nothing was launched, so no
+ * window was added), and it is opened exactly once per launch.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { WINDOWS_CHROME_LANDING_ASSET, WINDOWS_CHROME_LANDING_BASENAME } from "../constants.js";
+import { windowsPathToMount } from "./paths.js";
+/** The packaged page, resolved once per process (see {@link packageRoot} for why
+ * the lookup walks directories instead of trusting a depth). */
+let cachedAsset;
+/**
+ * The package root, walked up from this module until a `package.json` shows up:
+ * the emit sits under `lib/host/windows/`, so the asset's package-root-relative
+ * path is the same whether the plugin was installed or linked from a checkout,
+ * and a hard-coded `../../` would break the day the layout moves. "" answers when
+ * the lookup runs out of directories (an exotic packaging), which is simply no
+ * landing page.
+ */
+function packageRoot() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let hops = 0; hops < 8; hops += 1) {
+        const manifest = `${dir}/package.json`;
+        if (existsSync(manifest))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return "";
+}
+/** The packaged page's path on this host, "" when the package carries none. */
+export function windowsChromeLandingAsset() {
+    if (typeof cachedAsset === "string")
+        return cachedAsset;
+    const root = packageRoot();
+    const asset = root === "" ? "" : `${root}/${WINDOWS_CHROME_LANDING_ASSET}`;
+    cachedAsset = asset !== "" && existsSync(asset) ? asset : "";
+    return cachedAsset;
+}
+/** The one HTML entity escape the page needs: the profile path is the only
+ * value that can carry markup characters (a user name with `&`, say). */
+function escapeHtml(value) {
+    return String(value ?? "").replace(/&/gu, "&amp;").replace(/</gu, "&lt;").replace(/>/gu, "&gt;");
+}
+/**
+ * The packaged page, with the run's answers folded into its `{{TOKEN}}`s —
+ * "" when the asset is not there. Values are escaped, tokens the page does not
+ * carry are simply left alone, and a page whose write fails downstream is not
+ * this function's problem: it answers the *rendered* text, nothing else.
+ */
+export function windowsChromeLandingHtml(tokens = {}) {
+    const asset = windowsChromeLandingAsset();
+    if (asset === "")
+        return "";
+    let html;
+    try {
+        html = readFileSync(asset, "utf8");
+    }
+    catch {
+        return "";
+    }
+    const port = Number.isFinite(tokens.port) ? String(Math.trunc(Number(tokens.port))) : "";
+    const values = {
+        URL: escapeHtml(typeof tokens.url === "string" ? tokens.url : ""),
+        PORT: port,
+        PROFILE: escapeHtml(typeof tokens.profile === "string" ? tokens.profile : "")
+    };
+    for (const [token, value] of Object.entries(values)) {
+        html = html.split(`{{${token}}}`).join(value);
+    }
+    return html;
+}
+/**
+ * The landing file's Windows path beside a profile directory:
+ * `…\dsh-chrome-mcp\prelaunch-<port>.html`, a **sibling** of the profile rather
+ * than a file inside it — Chrome owns everything inside its own profile
+ * directory, and this page is not part of one.
+ */
+export function windowsChromeLandingPath(profileDir, port) {
+    const profile = typeof profileDir === "string" ? profileDir.trim().replace(/[\\/]+$/u, "") : "";
+    if (profile === "")
+        return "";
+    const cut = Math.max(profile.lastIndexOf("\\"), profile.lastIndexOf("/"));
+    if (cut <= 0)
+        return "";
+    const leaf = `${WINDOWS_CHROME_LANDING_BASENAME}-${String(Math.trunc(port))}.html`;
+    return `${profile.slice(0, cut)}\\${leaf}`;
+}
+/**
+ * A Windows path as a `file://` URL — the only form the launched browser reads
+ * (the interop mount path is Linux-side, invisible to `chrome.exe`). No drive
+ * letter answers "" (never a half-formed URL), and every path segment is
+ * percent-encoded, since a user profile directory routinely carries spaces.
+ */
+export function windowsFileUrl(path) {
+    if (typeof path !== "string")
+        return "";
+    const candidate = path.trim().replace(/[\\/]+$/u, "");
+    const match = candidate.match(/^([a-zA-Z]):[\\/](.*)$/u);
+    if (match === null)
+        return "";
+    const segments = match[2]
+        .split(/[\\/]+/u)
+        .filter((segment) => segment !== "")
+        .map((segment) => encodeURIComponent(segment));
+    if (segments.length === 0)
+        return "";
+    return `file:///${match[1]}:/${segments.join("/")}`;
+}
+/**
+ * The whole landing-page half of a launch: render the packaged page with this
+ * run's answers, write it beside the profile directory through the interop
+ * mount, and answer the `file:///…` URL to hand the browser ("" = launch with
+ * no page). Every failure is silent on purpose — the page explains the window,
+ * it never gates it.
+ * @param profileDir - the Windows-side profile directory the launch carries.
+ * @param url - the connect address the window answers for.
+ * @param port - the debugging port that launch picked.
+ * @param write - the filesystem half: place `html` at the **mount** path and
+ * answer whether it actually landed. Defaults to creating the directory and
+ * writing the file through the interop mount; injected so a test never depends
+ * on the machine it runs on (the mount is never inside the checkout, and the
+ * agent's own file sandbox denies it outright).
+ */
+export function windowsChromeLandingUrl(profileDir, url, port, write) {
+    const number = Number.isFinite(port) ? Math.trunc(Number(port)) : 0;
+    const path = windowsChromeLandingPath(profileDir, number);
+    if (path === "")
+        return "";
+    const html = windowsChromeLandingHtml({
+        url: typeof url === "string" ? url : "",
+        port: number,
+        profile: typeof profileDir === "string" ? profileDir : ""
+    });
+    if (html === "")
+        return "";
+    const mount = windowsPathToMount(path);
+    if (mount === "")
+        return "";
+    const place = (mountPath, content) => {
+        try {
+            mkdirSync(dirname(mountPath), { recursive: true });
+            writeFileSync(mountPath, content, "utf8");
+        }
+        catch {
+            return false;
+        }
+        return true;
+    };
+    if (!(typeof write === "function" ? write(mount, html) : place(mount, html)))
+        return "";
+    return windowsFileUrl(path);
+}
+//# sourceMappingURL=landing.js.map

package/lib/host/windows/landing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"landing.js","sourceRoot":"","sources":["../../../src/host/windows/landing.ts"],"names":[],"mappings":"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"}

package/lib/host/windows/link.d.ts

@@ -0,0 +1,11 @@
+import type { WindowsChromeLinkAnswer } from "../types/index.js";
+/**
+ * Points `linkPath` (the workspace's `.chrome`, a WSL-side path) at the
+ * Windows-side profile directory — the link is pure WSL-side, so Windows never
+ * sees it, but everything the run profiles reads back from the checkout. The
+ * target is Linux-side (`/mnt/c…`): Chrome reads the Windows spelling of the
+ * link's own target, not this link at all. A real directory that is already
+ * there is kept untouched (it might carry the user's own reading).
+ */
+export declare function linkWindowsChromeProfile(linkPath: unknown, profileWin: unknown): WindowsChromeLinkAnswer;
+//# sourceMappingURL=link.d.ts.map

package/lib/host/windows/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../src/host/windows/link.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,uBAAuB,CAwBxG"}

package/lib/host/windows/link.js

@@ -0,0 +1,52 @@
+/**
+ * Windows Chrome run — the workspace `.chrome` view link.
+ *
+ * A run profiles a Windows-native directory and keeps the checkout's `.chrome`
+ * as a **view** of it: a WSL-side symlink, so Windows never sees the link, but
+ * the checkout reads the profile back through it. A real directory already
+ * sitting at the view spot is kept — the link never clobbers what is already
+ * there. The answer names what happened (`linked`/`updated`/`kept`/`failed`) so
+ * the controller states a kept directory exactly once.
+ */
+import { lstatSync, readlinkSync, symlinkSync, unlinkSync } from "node:fs";
+import { windowsPathToMount } from "./paths.js";
+/**
+ * Points `linkPath` (the workspace's `.chrome`, a WSL-side path) at the
+ * Windows-side profile directory — the link is pure WSL-side, so Windows never
+ * sees it, but everything the run profiles reads back from the checkout. The
+ * target is Linux-side (`/mnt/c…`): Chrome reads the Windows spelling of the
+ * link's own target, not this link at all. A real directory that is already
+ * there is kept untouched (it might carry the user's own reading).
+ */
+export function linkWindowsChromeProfile(linkPath, profileWin) {
+    const link = typeof linkPath === "string" ? linkPath.trim().replace(/[\\/]+$/u, "") : "";
+    const target = windowsPathToMount(profileWin);
+    if (link === "" || target === "")
+        return "failed";
+    let existing;
+    try {
+        existing = lstatSync(link);
+    }
+    catch {
+        try {
+            symlinkSync(target, link);
+            return "linked";
+        }
+        catch {
+            return "failed";
+        }
+    }
+    if (!existing.isSymbolicLink())
+        return "kept";
+    if (readlinkSync(link) === target)
+        return "updated";
+    try {
+        unlinkSync(link);
+        symlinkSync(target, link);
+        return "updated";
+    }
+    catch {
+        return "failed";
+    }
+}
+//# sourceMappingURL=link.js.map

package/lib/host/windows/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../../src/host/windows/link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhD;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAiB,EAAE,UAAmB;IAC3E,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,EAAE,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAClD,IAAI,QAAsC,CAAC;IAC3C,IAAI,CAAC;QACD,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACL,IAAI,CAAC;YACD,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC1B,OAAO,QAAQ,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,QAAQ,CAAC;QACpB,CAAC;IACL,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACpD,IAAI,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC1B,OAAO,SAAS,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,QAAQ,CAAC;IACpB,CAAC;AACL,CAAC"}

package/lib/host/windows/paths.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The Windows spelling mapped onto the interop mount (`C:\Program Files\…` →
+ * `/mnt/c/Program Files/…`), which is the form WSL can stat. A path already
+ * spelled as the mount maps to itself — the mount spelling is what the WSL side
+ * can stat and therefore what a saved row or the row config may carry — and a
+ * path that is neither maps nowhere and yields "".
+ *
+ * A path may have been written or copied shell-style, where a space is escaped
+ * (`Program\ Files`). Such a backslash escapes the space that follows it and is
+ * not a separator, so it folds away to the plain space first; every other
+ * backslash is a Windows separator and folds to a slash. Turning one space
+ * escape blindly into a slash produced `Program/ Files` — a path that exists
+ * nowhere and answers `not-found` for a Chrome the run had actually located
+ * (measured live 2026-10-12 against a saved mount-spelled selection).
+ */
+export declare function windowsPathToMount(path: unknown): string;
+/**
+ * Locate the Windows-side Chrome through the interop mount: the first candidate
+ * whose mount path exists, "" when this machine carries none of them. The
+ * returned path keeps its **Windows** spelling — it is what the `start`
+ * invocation takes and what the card names.
+ */
+export declare function findWindowsChromeExecutable(exists?: (path: string) => boolean, candidates?: readonly string[]): string;
+/**
+ * Every Windows-side executable this host carries, in the list's own preference
+ * order and in its **Windows** spelling — the whole located set, not only the
+ * first. This is what the executable run folds into its candidate list, so the
+ * picker offers the Windows browser instead of hiding it. A machine that carries
+ * none of them answers nothing, so the list is what is installed here, never a
+ * fixed set of install locations. Nothing on the list is ever spawned from WSL
+ * (see `blockedForPlatform`); it is offered so that the **Prelaunch Windows
+ * Chrome** run can be pointed at the one the picker selected.
+ */
+export declare function findWindowsChromeExecutables(exists?: (path: string) => boolean, candidates?: readonly string[]): string[];
+/**
+ * The Windows-side profile directory: `<localAppData>\<dir>\.chrome[-<port>]`.
+ * The profile has to live on the Windows filesystem — Chrome takes real locks
+ * for its SQLite tables and its singleton socket, and the WSL-side directories
+ * Windows sees through the interop mount (9P) cannot carry them: a profile
+ * rooted there creates every table as a zero-byte file, never answers the
+ * singleton lock, and shows "an error occurred while opening your profile" on
+ * every launch (measured live 2026-10-04 against Chrome 154). "" answers when
+ * LOCALAPPDATA is not there.
+ */
+export declare function windowsChromeProfileDir(localAppData: unknown, leaf?: string): string;
+/**
+ * Resolves `%LOCALAPPDATA%` on the Windows side through the Known Folder API
+ * (never the inherited environment — the interop hand-off drops it, so
+ * `echo %LOCALAPPDATA%` comes back empty), cached across the process:
+ * powershell answers it exactly once per host.
+ */
+export declare function windowsChromeLocalAppData(): string;
+/**
+ * The directory the Windows run roots its profile view under — the project
+ * whose checkout the run answers: the row-config `cwd`, else the **live
+ * session workspace** (the run answers to the GUI the user is driving, not to
+ * whatever directory `dsh web` happened to be launched from — a run rooted at
+ * `~` links `~/.chrome` instead of the workspace), else the host's own cwd.
+ * @param configCwd - the row-config `cwd`, "" when unset.
+ * @param sessions - the sessions service, resolved optionally.
+ * @param hostCwd - the host process' cwd.
+ */
+export declare function windowsChromeProjectDir(configCwd: unknown, sessions: unknown, hostCwd: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/lib/host/windows/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/host/windows/paths.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAQxD;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACvC,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAA4C,EACtE,UAAU,GAAE,SAAS,MAAM,EAA8B,GAC1D,MAAM,CAER;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CACxC,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAA4C,EACtE,UAAU,GAAE,SAAS,MAAM,EAA8B,GAC1D,MAAM,EAAE,CAQV;AAKD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,OAAO,EAAE,IAAI,SAAY,GAAG,MAAM,CAMvF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAelD;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAmBtG"}