@wlv-zedd/dsh-chatgpt-web 1.0.0 → 1.0.2

package/src/dev-chat/profile.ts

@@ -1,223 +1,223 @@
-import { execFileSync, spawn } from "node:child_process";
-import { readFileSync, statSync } from "node:fs";
-import { homedir } from "node:os";
-import { isAbsolute, join, posix, resolve, win32 } from "node:path";
-import { expandUserPath, getConfigPath } from "../config";
-import {
-  readLauncherBrowserHostDescriptor,
-  type LauncherBrowserHostDescriptor,
-} from "../launcher-browser-host";
-
-import { DEV_LAUNCHER_PROFILE } from "./constants";
-
-export interface DevProfilePaths {
-  home: string;
-  codexHome: string;
-  launcherUserData: string;
-  launcherStatePath: string;
-  descriptorPath: string;
-  chatsPath: string;
-  runtimePath: string;
-  configPath: string;
-}
-
-const WINDOWS_LAUNCHER_GUID = "d1a6026a-6210-588e-9a2b-da3936f94e02";
-
-function registeredWindowsLauncherInstallLocation(): string | undefined {
-  try {
-    const output = execFileSync(
-      "reg.exe",
-      ["query", `HKCU\\Software\\${WINDOWS_LAUNCHER_GUID}`, "/v", "InstallLocation"],
-      { encoding: "utf8", windowsHide: true },
-    );
-    const match = output.match(/^\s*InstallLocation\s+REG_SZ\s+(.+?)\s*$/mi);
-    return match && win32.isAbsolute(match[1]) ? match[1] : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-export function resolveDevProfilePaths({
-  environment = process.env,
-  homeDirectory = homedir(),
-}: {
-  environment?: NodeJS.ProcessEnv;
-  homeDirectory?: string;
-} = {}): DevProfilePaths {
-  const home = resolve(expandUserPath(
-    environment.DSH_CHATGPT_FREE_DEV_HOME?.trim()
-      || join(homeDirectory, ".dsh", "storages", "chatgpt-web-dev"),
-  ));
-  const productionHome = resolve(expandUserPath(
-    environment.DSH_CHATGPT_FREE_HOME?.trim()
-      || environment.DSH_CHATGPT_WEB_HOME?.trim()
-      || join(homeDirectory, ".dsh", "storages", "chatgpt-web"),
-  ));
-  if (home === productionHome) {
-    throw new Error("DEV profile home must differ from the production home");
-  }
-  const launcherUserData = join(home, "launcher");
-  return {
-    home,
-    codexHome: join(home, "codex-home"),
-    launcherUserData,
-    launcherStatePath: join(launcherUserData, "launcher-state.json"),
-    descriptorPath: join(home, "runtime", "launcher-browser.json"),
-    chatsPath: join(home, "chats"),
-    runtimePath: join(home, "runtime", "dev-chat"),
-    configPath: join(home, "config.json"),
-  };
-}
-
-export interface DevChatExperimentalFeatures {
-  biggerContext: boolean;
-}
-
-/** Read the canonical DEV runtime setting consumed by repository chat commands. */
-export function readDevChatExperimentalFeatures(
-  paths = resolveDevProfilePaths(),
-): DevChatExperimentalFeatures {
-  let value: unknown;
-  try {
-    value = JSON.parse(readFileSync(paths.configPath, "utf8"));
-  } catch (error) {
-    if ((error as NodeJS.ErrnoException).code === "ENOENT") return { biggerContext: false };
-    throw new Error(
-      `Could not read DEV runtime settings from ${paths.configPath}: ${error instanceof Error ? error.message : String(error)}`,
-    );
-  }
-  if (!value || typeof value !== "object" || Array.isArray(value) || (value as { version?: unknown }).version !== 3) {
-    throw new Error(`Invalid DEV runtime settings in ${paths.configPath}`);
-  }
-  const enabled = (value as { experimentalBiggerContext?: unknown }).experimentalBiggerContext;
-  if (enabled !== undefined && typeof enabled !== "boolean") {
-    throw new Error(`Invalid Bigger Context preference in ${paths.configPath}`);
-  }
-  return { biggerContext: enabled === true };
-}
-
-export function activateDevProfileEnvironment(paths = resolveDevProfilePaths()): DevProfilePaths {
-  process.env.DSH_CHATGPT_FREE_DEV_HOME = paths.home;
-  process.env.DSH_CHATGPT_FREE_HOME = paths.home;
-  if (getConfigPath() !== paths.configPath) {
-    throw new Error("DEV profile environment did not resolve to its isolated configuration path");
-  }
-  return paths;
-}
-
-function executableFile(path: string): boolean {
-  try {
-    const stat = statSync(path);
-    return stat.isFile() && (process.platform === "win32" || (stat.mode & 0o111) !== 0);
-  } catch {
-    return false;
-  }
-}
-
-export function installedLauncherCandidates({
-  environment = process.env,
-  homeDirectory = homedir(),
-  platform = process.platform,
-  windowsInstallLocation,
-}: {
-  environment?: NodeJS.ProcessEnv;
-  homeDirectory?: string;
-  platform?: NodeJS.Platform;
-  windowsInstallLocation?: string;
-} = {}): string[] {
-  const override = environment.CODEX_WEB_GPT_LAUNCHER_EXECUTABLE?.trim();
-  const candidates = override ? [expandUserPath(override)] : [];
-  const targetPath = platform === "win32" ? win32 : posix;
-  if (platform === "darwin") {
-    candidates.push(
-      "/Applications/Codex Web GPT.app/Contents/MacOS/Codex Web GPT",
-      posix.join(homeDirectory, "Applications", "Codex Web GPT.app", "Contents", "MacOS", "Codex Web GPT"),
-    );
-  } else if (platform === "win32") {
-    const registeredLocation = windowsInstallLocation?.trim()
-      || (process.platform === "win32" ? registeredWindowsLauncherInstallLocation() : undefined);
-    if (registeredLocation && win32.isAbsolute(registeredLocation)) {
-      candidates.push(win32.join(registeredLocation, "Codex Web GPT.exe"));
-    } else {
-      const localAppData = environment.LOCALAPPDATA?.trim();
-      if (localAppData) {
-        candidates.push(win32.join(localAppData, "Programs", "Codex Web GPT", "Codex Web GPT.exe"));
-      }
-    }
-  } else if (platform === "linux") {
-    candidates.push(posix.join(homeDirectory, ".local", "bin", "codex-web-gpt"));
-    for (const entry of (environment.PATH || "").split(":").filter(Boolean)) {
-      candidates.push(posix.join(entry, "codex-web-gpt"));
-    }
-  }
-  return [...new Set(candidates.map(candidate => targetPath.resolve(candidate)))];
-}
-
-export function findInstalledLauncherExecutable(options: Parameters<typeof installedLauncherCandidates>[0] = {}): string {
-  const candidates = installedLauncherCandidates(options);
-  const executable = candidates.find(executableFile);
-  if (executable) return executable;
-  throw new Error(
-    "Installed Codex Web GPT launcher was not found. Install it first or set CODEX_WEB_GPT_LAUNCHER_EXECUTABLE to its absolute executable path."
-      + ` Checked: ${candidates.join(", ") || "no platform candidates"}`,
-  );
-}
-
-export function devLauncherEnvironment(
-  paths: DevProfilePaths,
-  environment: NodeJS.ProcessEnv = process.env,
-): NodeJS.ProcessEnv {
-  const childEnvironment = { ...environment };
-  delete childEnvironment.DSH_CHATGPT_FREE_HOME;
-  delete childEnvironment.DSH_CHATGPT_WEB_HOME;
-  childEnvironment.DSH_CHATGPT_FREE_DEV_HOME = paths.home;
-  return childEnvironment;
-}
-
-function devDescriptor(path: string): LauncherBrowserHostDescriptor {
-  const descriptor = readLauncherBrowserHostDescriptor(path);
-  if (descriptor.profile !== DEV_LAUNCHER_PROFILE) {
-    throw new Error(`Launcher descriptor belongs to ${descriptor.profile}, not the isolated DEV profile`);
-  }
-  return descriptor;
-}
-
-export async function waitForDevLauncher(
-  descriptorPath: string,
-  timeoutMs = 30_000,
-): Promise<LauncherBrowserHostDescriptor> {
-  const deadline = Date.now() + timeoutMs;
-  let lastError = "descriptor is not ready";
-  while (Date.now() < deadline) {
-    try {
-      return devDescriptor(descriptorPath);
-    } catch (error) {
-      lastError = error instanceof Error ? error.message : String(error);
-    }
-    await new Promise(resolveWait => setTimeout(resolveWait, 100));
-  }
-  throw new Error(`DEV launcher did not become ready within ${timeoutMs}ms: ${lastError}`);
-}
-
-export async function launchDevProfile(
-  paths = resolveDevProfilePaths(),
-  options: { executable?: string; timeoutMs?: number } = {},
-): Promise<{ descriptor: LauncherBrowserHostDescriptor; executable: string; alreadyRunning: boolean }> {
-  let existing: LauncherBrowserHostDescriptor | undefined;
-  try { existing = devDescriptor(paths.descriptorPath); }
-  catch { /* A stale or absent descriptor is replaced only by its owning launcher. */ }
-
-  const executable = options.executable ? resolve(options.executable) : findInstalledLauncherExecutable();
-  if (!isAbsolute(executable) || !executableFile(executable)) {
-    throw new Error(`DEV launcher executable is not an executable regular file: ${executable}`);
-  }
-  const child = spawn(executable, ["--dev-profile"], {
-    detached: true,
-    env: devLauncherEnvironment(paths),
-    stdio: "ignore",
-    windowsHide: false,
-  });
-  child.unref();
-  const descriptor = await waitForDevLauncher(paths.descriptorPath, options.timeoutMs);
-  return { descriptor, executable, alreadyRunning: existing?.pid === descriptor.pid };
-}
+import { execFileSync, spawn } from "node:child_process";
+import { readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { isAbsolute, join, posix, resolve, win32 } from "node:path";
+import { expandUserPath, getConfigPath } from "../config";
+import {
+  readLauncherBrowserHostDescriptor,
+  type LauncherBrowserHostDescriptor,
+} from "../launcher-browser-host";
+
+import { DEV_LAUNCHER_PROFILE } from "./constants";
+
+export interface DevProfilePaths {
+  home: string;
+  codexHome: string;
+  launcherUserData: string;
+  launcherStatePath: string;
+  descriptorPath: string;
+  chatsPath: string;
+  runtimePath: string;
+  configPath: string;
+}
+
+const WINDOWS_LAUNCHER_GUID = "d1a6026a-6210-588e-9a2b-da3936f94e02";
+
+function registeredWindowsLauncherInstallLocation(): string | undefined {
+  try {
+    const output = execFileSync(
+      "reg.exe",
+      ["query", `HKCU\\Software\\${WINDOWS_LAUNCHER_GUID}`, "/v", "InstallLocation"],
+      { encoding: "utf8", windowsHide: true },
+    );
+    const match = output.match(/^\s*InstallLocation\s+REG_SZ\s+(.+?)\s*$/mi);
+    return match && win32.isAbsolute(match[1]) ? match[1] : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+export function resolveDevProfilePaths({
+  environment = process.env,
+  homeDirectory = homedir(),
+}: {
+  environment?: NodeJS.ProcessEnv;
+  homeDirectory?: string;
+} = {}): DevProfilePaths {
+  const home = resolve(expandUserPath(
+    environment.DSH_CHATGPT_FREE_DEV_HOME?.trim()
+      || join(homeDirectory, ".dsh", "storages", "chatgpt-web-dev"),
+  ));
+  const productionHome = resolve(expandUserPath(
+    environment.DSH_CHATGPT_FREE_HOME?.trim()
+      || environment.DSH_CHATGPT_WEB_HOME?.trim()
+      || join(homeDirectory, ".dsh", "storages", "chatgpt-web"),
+  ));
+  if (home === productionHome) {
+    throw new Error("DEV profile home must differ from the production home");
+  }
+  const launcherUserData = join(home, "launcher");
+  return {
+    home,
+    codexHome: join(home, "codex-home"),
+    launcherUserData,
+    launcherStatePath: join(launcherUserData, "launcher-state.json"),
+    descriptorPath: join(home, "runtime", "launcher-browser.json"),
+    chatsPath: join(home, "chats"),
+    runtimePath: join(home, "runtime", "dev-chat"),
+    configPath: join(home, "config.json"),
+  };
+}
+
+export interface DevChatExperimentalFeatures {
+  biggerContext: boolean;
+}
+
+/** Read the canonical DEV runtime setting consumed by repository chat commands. */
+export function readDevChatExperimentalFeatures(
+  paths = resolveDevProfilePaths(),
+): DevChatExperimentalFeatures {
+  let value: unknown;
+  try {
+    value = JSON.parse(readFileSync(paths.configPath, "utf8"));
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code === "ENOENT") return { biggerContext: false };
+    throw new Error(
+      `Could not read DEV runtime settings from ${paths.configPath}: ${error instanceof Error ? error.message : String(error)}`,
+    );
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value) || (value as { version?: unknown }).version !== 3) {
+    throw new Error(`Invalid DEV runtime settings in ${paths.configPath}`);
+  }
+  const enabled = (value as { experimentalBiggerContext?: unknown }).experimentalBiggerContext;
+  if (enabled !== undefined && typeof enabled !== "boolean") {
+    throw new Error(`Invalid Bigger Context preference in ${paths.configPath}`);
+  }
+  return { biggerContext: enabled === true };
+}
+
+export function activateDevProfileEnvironment(paths = resolveDevProfilePaths()): DevProfilePaths {
+  process.env.DSH_CHATGPT_FREE_DEV_HOME = paths.home;
+  process.env.DSH_CHATGPT_FREE_HOME = paths.home;
+  if (getConfigPath() !== paths.configPath) {
+    throw new Error("DEV profile environment did not resolve to its isolated configuration path");
+  }
+  return paths;
+}
+
+function executableFile(path: string): boolean {
+  try {
+    const stat = statSync(path);
+    return stat.isFile() && (process.platform === "win32" || (stat.mode & 0o111) !== 0);
+  } catch {
+    return false;
+  }
+}
+
+export function installedLauncherCandidates({
+  environment = process.env,
+  homeDirectory = homedir(),
+  platform = process.platform,
+  windowsInstallLocation,
+}: {
+  environment?: NodeJS.ProcessEnv;
+  homeDirectory?: string;
+  platform?: NodeJS.Platform;
+  windowsInstallLocation?: string;
+} = {}): string[] {
+  const override = environment.CODEX_WEB_GPT_LAUNCHER_EXECUTABLE?.trim();
+  const candidates = override ? [expandUserPath(override)] : [];
+  const targetPath = platform === "win32" ? win32 : posix;
+  if (platform === "darwin") {
+    candidates.push(
+      "/Applications/Codex Web GPT.app/Contents/MacOS/Codex Web GPT",
+      posix.join(homeDirectory, "Applications", "Codex Web GPT.app", "Contents", "MacOS", "Codex Web GPT"),
+    );
+  } else if (platform === "win32") {
+    const registeredLocation = windowsInstallLocation?.trim()
+      || (process.platform === "win32" ? registeredWindowsLauncherInstallLocation() : undefined);
+    if (registeredLocation && win32.isAbsolute(registeredLocation)) {
+      candidates.push(win32.join(registeredLocation, "Codex Web GPT.exe"));
+    } else {
+      const localAppData = environment.LOCALAPPDATA?.trim();
+      if (localAppData) {
+        candidates.push(win32.join(localAppData, "Programs", "Codex Web GPT", "Codex Web GPT.exe"));
+      }
+    }
+  } else if (platform === "linux") {
+    candidates.push(posix.join(homeDirectory, ".local", "bin", "codex-web-gpt"));
+    for (const entry of (environment.PATH || "").split(":").filter(Boolean)) {
+      candidates.push(posix.join(entry, "codex-web-gpt"));
+    }
+  }
+  return [...new Set(candidates.map(candidate => targetPath.resolve(candidate)))];
+}
+
+export function findInstalledLauncherExecutable(options: Parameters<typeof installedLauncherCandidates>[0] = {}): string {
+  const candidates = installedLauncherCandidates(options);
+  const executable = candidates.find(executableFile);
+  if (executable) return executable;
+  throw new Error(
+    "Installed Codex Web GPT launcher was not found. Install it first or set CODEX_WEB_GPT_LAUNCHER_EXECUTABLE to its absolute executable path."
+      + ` Checked: ${candidates.join(", ") || "no platform candidates"}`,
+  );
+}
+
+export function devLauncherEnvironment(
+  paths: DevProfilePaths,
+  environment: NodeJS.ProcessEnv = process.env,
+): NodeJS.ProcessEnv {
+  const childEnvironment = { ...environment };
+  delete childEnvironment.DSH_CHATGPT_FREE_HOME;
+  delete childEnvironment.DSH_CHATGPT_WEB_HOME;
+  childEnvironment.DSH_CHATGPT_FREE_DEV_HOME = paths.home;
+  return childEnvironment;
+}
+
+function devDescriptor(path: string): LauncherBrowserHostDescriptor {
+  const descriptor = readLauncherBrowserHostDescriptor(path);
+  if (descriptor.profile !== DEV_LAUNCHER_PROFILE) {
+    throw new Error(`Launcher descriptor belongs to ${descriptor.profile}, not the isolated DEV profile`);
+  }
+  return descriptor;
+}
+
+export async function waitForDevLauncher(
+  descriptorPath: string,
+  timeoutMs = 30_000,
+): Promise<LauncherBrowserHostDescriptor> {
+  const deadline = Date.now() + timeoutMs;
+  let lastError = "descriptor is not ready";
+  while (Date.now() < deadline) {
+    try {
+      return devDescriptor(descriptorPath);
+    } catch (error) {
+      lastError = error instanceof Error ? error.message : String(error);
+    }
+    await new Promise(resolveWait => setTimeout(resolveWait, 100));
+  }
+  throw new Error(`DEV launcher did not become ready within ${timeoutMs}ms: ${lastError}`);
+}
+
+export async function launchDevProfile(
+  paths = resolveDevProfilePaths(),
+  options: { executable?: string; timeoutMs?: number } = {},
+): Promise<{ descriptor: LauncherBrowserHostDescriptor; executable: string; alreadyRunning: boolean }> {
+  let existing: LauncherBrowserHostDescriptor | undefined;
+  try { existing = devDescriptor(paths.descriptorPath); }
+  catch { /* A stale or absent descriptor is replaced only by its owning launcher. */ }
+
+  const executable = options.executable ? resolve(options.executable) : findInstalledLauncherExecutable();
+  if (!isAbsolute(executable) || !executableFile(executable)) {
+    throw new Error(`DEV launcher executable is not an executable regular file: ${executable}`);
+  }
+  const child = spawn(executable, ["--dev-profile"], {
+    detached: true,
+    env: devLauncherEnvironment(paths),
+    stdio: "ignore",
+    windowsHide: false,
+  });
+  child.unref();
+  const descriptor = await waitForDevLauncher(paths.descriptorPath, options.timeoutMs);
+  return { descriptor, executable, alreadyRunning: existing?.pid === descriptor.pid };
+}