@georgedong32/ccs 7.67.0 → 8.0.0

package/dist/utils/browser/browser-settings.js

@@ -0,0 +1,257 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveOptionalBrowserAttachRuntime = exports.getEffectiveClaudeBrowserAttachConfig = exports.getBrowserAttachOverride = exports.describeManagedBrowserAttachNotReady = exports.ensureManagedBrowserUserDataDir = exports.buildManagedBrowserAttachSetupOptions = exports.isManagedClaudeBrowserAttachConfig = exports.buildBrowserLaunchCommands = exports.resolveBrowserUserDataDir = exports.getRecommendedBrowserUserDataDir = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_manager_1 = require("../config-manager");
+const helpers_1 = require("../helpers");
+const chrome_reuse_1 = require("./chrome-reuse");
+const platform_1 = require("./platform");
+function getRecommendedBrowserUserDataDir() {
+    return path.join((0, config_manager_1.getCcsDir)(), 'browser', 'chrome-user-data');
+}
+exports.getRecommendedBrowserUserDataDir = getRecommendedBrowserUserDataDir;
+function resolveBrowserUserDataDir(value) {
+    return value?.trim() ? (0, helpers_1.expandPath)(value) : undefined;
+}
+exports.resolveBrowserUserDataDir = resolveBrowserUserDataDir;
+function buildBrowserLaunchCommands(userDataDir, devtoolsPort) {
+    const quotedPath = JSON.stringify(userDataDir);
+    return {
+        darwin: `open -na "Google Chrome" --args --remote-debugging-port=${devtoolsPort} --user-data-dir=${quotedPath}`,
+        linux: `google-chrome --remote-debugging-port=${devtoolsPort} --user-data-dir=${quotedPath}`,
+        win32: `chrome.exe --remote-debugging-port=${devtoolsPort} --user-data-dir=${quotedPath}`,
+    };
+}
+exports.buildBrowserLaunchCommands = buildBrowserLaunchCommands;
+function isManagedClaudeBrowserAttachConfig(config) {
+    return (config.source === 'config' &&
+        path.resolve(config.userDataDir) === path.resolve(getRecommendedBrowserUserDataDir()));
+}
+exports.isManagedClaudeBrowserAttachConfig = isManagedClaudeBrowserAttachConfig;
+function buildCurrentPlatformLaunchCommand(userDataDir, devtoolsPort) {
+    return buildBrowserLaunchCommands(userDataDir, devtoolsPort)[(0, platform_1.getNodePlatformKey)()];
+}
+function buildManagedBrowserActionLines() {
+    return [
+        'Run `ccs browser setup` to configure and start the managed browser session.',
+        'Diagnose only: `ccs browser doctor`.',
+    ];
+}
+function buildManagedBrowserAttachSetupOptions(_config) {
+    return buildManagedBrowserActionLines();
+}
+exports.buildManagedBrowserAttachSetupOptions = buildManagedBrowserAttachSetupOptions;
+function buildManagedBrowserAttachWarning(_config) {
+    return [
+        'Claude Browser Attach is not ready yet.',
+        `  Managed user-data dir: ${(0, config_manager_1.getCcsPathDisplay)('browser', 'chrome-user-data')}`,
+        '  CCS will continue without browser tools for this launch.',
+        '',
+        ...buildManagedBrowserActionLines().map((line) => `  ${line}`),
+    ].join('\n');
+}
+function ensureManagedBrowserUserDataDir(config) {
+    if (!isManagedClaudeBrowserAttachConfig(config)) {
+        return {
+            usesManagedDefaultDir: false,
+            createdProfileDir: false,
+        };
+    }
+    try {
+        fs.statSync(config.userDataDir);
+        return {
+            usesManagedDefaultDir: true,
+            createdProfileDir: false,
+        };
+    }
+    catch (error) {
+        const code = error.code;
+        if (code && code !== 'ENOENT') {
+            return {
+                usesManagedDefaultDir: true,
+                createdProfileDir: false,
+            };
+        }
+    }
+    try {
+        fs.mkdirSync(config.userDataDir, { recursive: true, mode: 0o700 });
+        return {
+            usesManagedDefaultDir: true,
+            createdProfileDir: true,
+        };
+    }
+    catch {
+        return {
+            usesManagedDefaultDir: true,
+            createdProfileDir: false,
+        };
+    }
+}
+exports.ensureManagedBrowserUserDataDir = ensureManagedBrowserUserDataDir;
+function describeManagedBrowserAttachNotReady(config, errorMessage, options = {}) {
+    if (!isManagedClaudeBrowserAttachConfig(config)) {
+        return undefined;
+    }
+    const launchCommand = options.launchCommand ??
+        buildCurrentPlatformLaunchCommand((0, config_manager_1.getCcsPathDisplay)('browser', 'chrome-user-data'), config.devtoolsPort);
+    const nextStep = [
+        ...buildManagedBrowserActionLines(),
+        `Manual launch (${(0, platform_1.getNodePlatformKey)()}): ${launchCommand}`,
+    ].join('\n');
+    if (errorMessage.includes('Chrome reuse metadata')) {
+        const summary = options.createdProfileDir
+            ? 'CCS created the managed browser profile directory, but the attach session is not running yet.'
+            : 'No running attach-mode Chrome session is using the managed browser profile yet.';
+        return {
+            state: 'browser_not_running',
+            title: 'Claude Browser Attach is not ready yet.',
+            detail: `${summary} Diagnostic: ${errorMessage}`,
+            nextStep,
+            warning: buildManagedBrowserAttachWarning(config),
+        };
+    }
+    if (errorMessage.includes('Chrome DevTools endpoint')) {
+        return {
+            state: 'endpoint_unreachable',
+            title: 'Claude Browser Attach could not reach the managed Chrome session.',
+            detail: `CCS found the managed browser profile, but the DevTools endpoint did not answer successfully. Diagnostic: ${errorMessage}`,
+            nextStep,
+            warning: buildManagedBrowserAttachWarning(config),
+        };
+    }
+    if (errorMessage.includes('Chrome profile directory is invalid')) {
+        return {
+            state: 'path_missing',
+            title: 'Claude Browser Attach could not initialize the managed profile.',
+            detail: `CCS could not initialize the managed browser profile directory. Diagnostic: ${errorMessage}`,
+            nextStep,
+            warning: buildManagedBrowserAttachWarning(config),
+        };
+    }
+    return undefined;
+}
+exports.describeManagedBrowserAttachNotReady = describeManagedBrowserAttachNotReady;
+function getBrowserAttachOverride(env = process.env) {
+    const explicitUserDataDir = resolveBrowserUserDataDir(env.CCS_BROWSER_USER_DATA_DIR);
+    if (explicitUserDataDir) {
+        return {
+            userDataDir: explicitUserDataDir,
+            devtoolsPort: parseDevtoolsPort(env.CCS_BROWSER_DEVTOOLS_PORT),
+            source: 'CCS_BROWSER_USER_DATA_DIR',
+        };
+    }
+    const legacyProfileDir = resolveBrowserUserDataDir(env.CCS_BROWSER_PROFILE_DIR);
+    if (legacyProfileDir) {
+        return {
+            userDataDir: legacyProfileDir,
+            devtoolsPort: parseDevtoolsPort(env.CCS_BROWSER_DEVTOOLS_PORT),
+            source: 'CCS_BROWSER_PROFILE_DIR',
+        };
+    }
+    return {};
+}
+exports.getBrowserAttachOverride = getBrowserAttachOverride;
+function getEffectiveClaudeBrowserAttachConfig(config, env = process.env) {
+    const override = getBrowserAttachOverride(env);
+    const configUserDataDir = resolveBrowserUserDataDir(config.claude.user_data_dir) ?? getRecommendedBrowserUserDataDir();
+    const configPort = normalizeDevtoolsPort(config.claude.devtools_port);
+    const configEvalMode = config.claude.eval_mode ?? 'readonly';
+    if (override.userDataDir) {
+        return {
+            enabled: config.claude.enabled,
+            source: override.source,
+            overrideActive: true,
+            userDataDir: override.userDataDir,
+            devtoolsPort: override.devtoolsPort ?? configPort,
+            hasExplicitDevtoolsPort: override.devtoolsPort !== undefined,
+            evalMode: configEvalMode,
+        };
+    }
+    return {
+        enabled: config.claude.enabled,
+        source: 'config',
+        overrideActive: false,
+        userDataDir: configUserDataDir,
+        devtoolsPort: configPort,
+        hasExplicitDevtoolsPort: true,
+        evalMode: configEvalMode,
+    };
+}
+exports.getEffectiveClaudeBrowserAttachConfig = getEffectiveClaudeBrowserAttachConfig;
+async function resolveOptionalBrowserAttachRuntime(config) {
+    if (!config.enabled) {
+        return {};
+    }
+    const bootstrap = ensureManagedBrowserUserDataDir(config);
+    if (bootstrap.createdProfileDir) {
+        return {
+            warning: buildManagedBrowserAttachWarning(config),
+        };
+    }
+    try {
+        const runtimeEnv = await (0, chrome_reuse_1.resolveBrowserRuntimeEnv)({
+            profileDir: config.userDataDir,
+            devtoolsPort: config.hasExplicitDevtoolsPort ? String(config.devtoolsPort) : undefined,
+        });
+        return {
+            runtimeEnv: {
+                ...runtimeEnv,
+                CCS_BROWSER_EVAL_MODE: config.evalMode,
+            },
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const managedDefaultMessage = describeManagedBrowserAttachNotReady(config, message, {
+            createdProfileDir: bootstrap.createdProfileDir,
+        });
+        if (managedDefaultMessage) {
+            return {
+                warning: managedDefaultMessage.warning,
+            };
+        }
+        throw error;
+    }
+}
+exports.resolveOptionalBrowserAttachRuntime = resolveOptionalBrowserAttachRuntime;
+function parseDevtoolsPort(value) {
+    if (!value?.trim() || !/^\d+$/.test(value.trim())) {
+        return undefined;
+    }
+    return normalizeDevtoolsPort(Number.parseInt(value.trim(), 10));
+}
+function normalizeDevtoolsPort(value) {
+    if (!Number.isFinite(value)) {
+        return 9222;
+    }
+    const port = Math.floor(value);
+    if (port < 1 || port > 65535) {
+        return 9222;
+    }
+    return port;
+}
+//# sourceMappingURL=browser-settings.js.map

package/dist/utils/browser/browser-settings.js.map

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

package/dist/utils/browser/browser-setup.d.ts

@@ -0,0 +1,21 @@
+import { type BrowserStatusPayload, getBrowserStatus } from './browser-status';
+import { ensureBrowserMcp } from './mcp-installer';
+import { getBrowserConfig, mutateConfig } from '../../config/config-loader-facade';
+export interface BrowserSetupResult {
+    configUpdated: boolean;
+    createdUserDataDir: boolean;
+    mcpReady: boolean;
+    overrideActive: boolean;
+    ready: boolean;
+    launchCommand: string;
+    status: BrowserStatusPayload;
+    notes: string[];
+}
+export interface BrowserSetupDeps {
+    getBrowserConfig: typeof getBrowserConfig;
+    mutateConfig: typeof mutateConfig;
+    ensureBrowserMcp: typeof ensureBrowserMcp;
+    getBrowserStatus: typeof getBrowserStatus;
+}
+export declare function runBrowserSetup(deps?: BrowserSetupDeps): Promise<BrowserSetupResult>;
+//# sourceMappingURL=browser-setup.d.ts.map

package/dist/utils/browser/browser-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-setup.d.ts","sourceRoot":"","sources":["../../../src/utils/browser/browser-setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOnD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEnF,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;IAC1C,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;IAC1C,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;CAC3C;AASD,wBAAsB,eAAe,CACnC,IAAI,GAAE,gBAA0C,GAC/C,OAAO,CAAC,kBAAkB,CAAC,CAuC7B"}

package/dist/utils/browser/browser-setup.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBrowserSetup = void 0;
+const platform_1 = require("./platform");
+const browser_status_1 = require("./browser-status");
+const mcp_installer_1 = require("./mcp-installer");
+const browser_settings_1 = require("./browser-settings");
+const config_loader_facade_1 = require("../../config/config-loader-facade");
+const defaultBrowserSetupDeps = {
+    getBrowserConfig: config_loader_facade_1.getBrowserConfig,
+    mutateConfig: config_loader_facade_1.mutateConfig,
+    ensureBrowserMcp: mcp_installer_1.ensureBrowserMcp,
+    getBrowserStatus: browser_status_1.getBrowserStatus,
+};
+async function runBrowserSetup(deps = defaultBrowserSetupDeps) {
+    const initialConfig = deps.getBrowserConfig();
+    const configUpdated = persistBrowserSetupConfig(deps, initialConfig);
+    const persistedConfig = deps.getBrowserConfig();
+    const effectiveConfig = (0, browser_settings_1.getEffectiveClaudeBrowserAttachConfig)(persistedConfig);
+    const createdUserDataDir = (0, browser_settings_1.isManagedClaudeBrowserAttachConfig)(effectiveConfig)
+        ? (0, browser_settings_1.ensureManagedBrowserUserDataDir)(effectiveConfig).createdProfileDir
+        : false;
+    const mcpReady = deps.ensureBrowserMcp();
+    const status = await deps.getBrowserStatus();
+    const notes = [];
+    if (effectiveConfig.overrideActive) {
+        notes.push(`Current session is using ${effectiveConfig.source}; remove that override if you want saved browser settings to take effect in future shells.`);
+    }
+    if (!mcpReady) {
+        notes.push('CCS could not fully prepare the local browser MCP runtime.');
+    }
+    if (!(0, browser_settings_1.isManagedClaudeBrowserAttachConfig)(effectiveConfig)) {
+        notes.push('Setup did not create the current browser user-data dir because it is not the CCS-managed default path.');
+    }
+    const platform = (0, platform_1.getNodePlatformKey)();
+    return {
+        configUpdated,
+        createdUserDataDir,
+        mcpReady,
+        overrideActive: effectiveConfig.overrideActive,
+        ready: status.claude.state === 'ready' && mcpReady,
+        launchCommand: status.claude.launchCommands[platform],
+        status,
+        notes,
+    };
+}
+exports.runBrowserSetup = runBrowserSetup;
+function persistBrowserSetupConfig(deps, currentConfig) {
+    const before = JSON.stringify(currentConfig);
+    deps.mutateConfig((config) => {
+        const existingBrowser = config.browser ?? currentConfig;
+        const currentUserDataDir = existingBrowser.claude.user_data_dir?.trim();
+        config.browser = {
+            claude: {
+                enabled: true,
+                policy: existingBrowser.claude.policy,
+                user_data_dir: currentUserDataDir || (0, browser_settings_1.getRecommendedBrowserUserDataDir)(),
+                devtools_port: currentConfig.claude.devtools_port,
+            },
+            codex: {
+                enabled: existingBrowser.codex.enabled,
+                policy: existingBrowser.codex.policy,
+            },
+        };
+    });
+    return JSON.stringify(deps.getBrowserConfig()) !== before;
+}
+//# sourceMappingURL=browser-setup.js.map

package/dist/utils/browser/browser-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-setup.js","sourceRoot":"","sources":["../../../src/utils/browser/browser-setup.ts"],"names":[],"mappings":";;;AACA,yCAAgD;AAChD,qDAA+E;AAC/E,mDAAmD;AACnD,yDAK4B;AAC5B,4EAAmF;AAoBnF,MAAM,uBAAuB,GAAqB;IAChD,gBAAgB,EAAhB,uCAAgB;IAChB,YAAY,EAAZ,mCAAY;IACZ,gBAAgB,EAAhB,gCAAgB;IAChB,gBAAgB,EAAhB,iCAAgB;CACjB,CAAC;AAEK,KAAK,UAAU,eAAe,CACnC,OAAyB,uBAAuB;IAEhD,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC9C,MAAM,aAAa,GAAG,yBAAyB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACrE,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAChD,MAAM,eAAe,GAAG,IAAA,wDAAqC,EAAC,eAAe,CAAC,CAAC;IAC/E,MAAM,kBAAkB,GAAG,IAAA,qDAAkC,EAAC,eAAe,CAAC;QAC5E,CAAC,CAAC,IAAA,kDAA+B,EAAC,eAAe,CAAC,CAAC,iBAAiB;QACpE,CAAC,CAAC,KAAK,CAAC;IACV,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,eAAe,CAAC,cAAc,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CACR,4BAA4B,eAAe,CAAC,MAAM,4FAA4F,CAC/I,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,CAAC,IAAA,qDAAkC,EAAC,eAAe,CAAC,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CACR,wGAAwG,CACzG,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,6BAAkB,GAAE,CAAC;IACtC,OAAO;QACL,aAAa;QACb,kBAAkB;QAClB,QAAQ;QACR,cAAc,EAAE,eAAe,CAAC,cAAc;QAC9C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,OAAO,IAAI,QAAQ;QAClD,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC;QACrD,MAAM;QACN,KAAK;KACN,CAAC;AACJ,CAAC;AAzCD,0CAyCC;AAED,SAAS,yBAAyB,CAAC,IAAsB,EAAE,aAA4B;IACrF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAE7C,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QAC3B,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,IAAI,aAAa,CAAC;QACxD,MAAM,kBAAkB,GAAG,eAAe,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;QAExE,MAAM,CAAC,OAAO,GAAG;YACf,MAAM,EAAE;gBACN,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM;gBACrC,aAAa,EAAE,kBAAkB,IAAI,IAAA,mDAAgC,GAAE;gBACvE,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,aAAa;aAClD;YACD,KAAK,EAAE;gBACL,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,OAAO;gBACtC,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM;aACrC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,KAAK,MAAM,CAAC;AAC5D,CAAC"}

package/dist/utils/browser/browser-status.d.ts

@@ -0,0 +1,42 @@
+import type { BrowserConfig, BrowserEvalMode, BrowserToolPolicy } from '../../config/unified-config-types';
+import { type BrowserRuntimeEnv } from './chrome-reuse';
+import { type BrowserLaunchCommands } from './browser-settings';
+export interface ClaudeBrowserStatus {
+    enabled: boolean;
+    policy: BrowserToolPolicy;
+    evalMode: BrowserEvalMode;
+    source: 'config' | 'CCS_BROWSER_USER_DATA_DIR' | 'CCS_BROWSER_PROFILE_DIR';
+    overrideActive: boolean;
+    state: 'disabled' | 'path_missing' | 'browser_not_running' | 'endpoint_unreachable' | 'ready';
+    title: string;
+    detail: string;
+    nextStep: string;
+    effectiveUserDataDir: string;
+    recommendedUserDataDir: string;
+    devtoolsPort: number;
+    managedMcpServerName: string;
+    managedMcpServerPath: string;
+    launchCommands: BrowserLaunchCommands;
+    runtimeEnv?: BrowserRuntimeEnv;
+}
+export interface CodexBrowserStatus {
+    enabled: boolean;
+    policy: BrowserToolPolicy;
+    evalMode: BrowserEvalMode;
+    state: 'disabled' | 'enabled' | 'unsupported_build';
+    title: string;
+    detail: string;
+    nextStep: string;
+    serverName: string;
+    supportsConfigOverrides: boolean;
+    binaryPath: string | null;
+    version?: string;
+}
+export interface BrowserStatusPayload {
+    claude: ClaudeBrowserStatus;
+    codex: CodexBrowserStatus;
+}
+export declare function getBrowserStatus(): Promise<BrowserStatusPayload>;
+export declare function getUserFacingBrowserConfig(): BrowserConfig;
+export declare function getManagedBrowserSetupHint(): string;
+//# sourceMappingURL=browser-status.d.ts.map

package/dist/utils/browser/browser-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-status.d.ts","sourceRoot":"","sources":["../../../src/utils/browser/browser-status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EAClB,MAAM,mCAAmC,CAAC;AAI3C,OAAO,EAAE,KAAK,iBAAiB,EAA4B,MAAM,gBAAgB,CAAC;AAGlF,OAAO,EAKL,KAAK,qBAAqB,EAG3B,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,QAAQ,GAAG,2BAA2B,GAAG,yBAAyB,CAAC;IAC3E,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,UAAU,GAAG,cAAc,GAAG,qBAAqB,GAAG,sBAAsB,GAAG,OAAO,CAAC;IAC9F,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,qBAAqB,CAAC;IACtC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,mBAAmB,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB,EAAE,OAAO,CAAC;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAMtE;AAiBD,wBAAgB,0BAA0B,IAAI,aAAa,CAuC1D;AAmLD,wBAAgB,0BAA0B,IAAI,MAAM,CAUnD"}

package/dist/utils/browser/browser-status.js

@@ -0,0 +1,251 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getManagedBrowserSetupHint = exports.getUserFacingBrowserConfig = exports.getBrowserStatus = void 0;
+const path = __importStar(require("path"));
+const config_manager_1 = require("../config-manager");
+const codex_detector_1 = require("../../targets/codex-detector");
+const chrome_reuse_1 = require("./chrome-reuse");
+const mcp_installer_1 = require("./mcp-installer");
+const platform_1 = require("./platform");
+const browser_settings_1 = require("./browser-settings");
+const config_loader_facade_1 = require("../../config/config-loader-facade");
+async function getBrowserStatus() {
+    const browserConfig = getUserFacingBrowserConfig();
+    return {
+        claude: await buildClaudeBrowserStatus(browserConfig),
+        codex: buildCodexBrowserStatus(browserConfig),
+    };
+}
+exports.getBrowserStatus = getBrowserStatus;
+function resolveSafeBrowserPolicy(policy) {
+    return policy === 'auto' || policy === 'manual' ? policy : 'manual';
+}
+function resolveSafeBrowserEvalMode(evalMode) {
+    return evalMode === 'disabled' || evalMode === 'readonly' || evalMode === 'readwrite'
+        ? evalMode
+        : 'readonly';
+}
+function getUserFacingBrowserConfig() {
+    const canonical = (0, config_loader_facade_1.getBrowserConfig)();
+    const persisted = (0, config_loader_facade_1.loadUnifiedConfig)()?.browser;
+    if (!persisted) {
+        return {
+            claude: {
+                ...canonical.claude,
+                enabled: false,
+                policy: 'manual',
+                eval_mode: resolveSafeBrowserEvalMode(canonical.claude.eval_mode),
+            },
+            codex: {
+                ...canonical.codex,
+                enabled: false,
+                policy: 'manual',
+                eval_mode: resolveSafeBrowserEvalMode(canonical.codex.eval_mode),
+            },
+        };
+    }
+    return {
+        claude: {
+            ...canonical.claude,
+            enabled: persisted.claude?.enabled ?? false,
+            policy: resolveSafeBrowserPolicy(persisted.claude?.policy),
+            eval_mode: resolveSafeBrowserEvalMode(persisted.claude?.eval_mode ?? canonical.claude.eval_mode),
+        },
+        codex: {
+            ...canonical.codex,
+            enabled: persisted.codex?.enabled ?? false,
+            policy: resolveSafeBrowserPolicy(persisted.codex?.policy),
+            eval_mode: resolveSafeBrowserEvalMode(persisted.codex?.eval_mode ?? canonical.codex.eval_mode),
+        },
+    };
+}
+exports.getUserFacingBrowserConfig = getUserFacingBrowserConfig;
+async function buildClaudeBrowserStatus(browserConfig = getUserFacingBrowserConfig()) {
+    const effective = (0, browser_settings_1.getEffectiveClaudeBrowserAttachConfig)(browserConfig);
+    const launchCommands = (0, browser_settings_1.buildBrowserLaunchCommands)(effective.userDataDir, effective.devtoolsPort);
+    const base = {
+        enabled: effective.enabled,
+        policy: browserConfig.claude.policy,
+        evalMode: resolveSafeBrowserEvalMode(browserConfig.claude.eval_mode),
+        source: effective.source,
+        overrideActive: effective.overrideActive,
+        effectiveUserDataDir: effective.userDataDir,
+        recommendedUserDataDir: (0, browser_settings_1.getRecommendedBrowserUserDataDir)(),
+        devtoolsPort: effective.devtoolsPort,
+        managedMcpServerName: (0, mcp_installer_1.getBrowserMcpServerName)(),
+        managedMcpServerPath: (0, mcp_installer_1.getBrowserMcpServerPath)(),
+        launchCommands,
+    };
+    if (!effective.enabled) {
+        return {
+            ...base,
+            state: 'disabled',
+            title: 'Claude Browser Attach is disabled.',
+            detail: 'CCS keeps Claude Browser Attach off by default and will not provision the managed browser MCP runtime until this lane is enabled.',
+            nextStep: `Enable Claude Browser Attach in Settings > Browser or in ${(0, config_manager_1.getCcsPathDisplay)('config.yaml')}, then run \`ccs browser setup\` when you are ready to opt in.`,
+        };
+    }
+    const managedBootstrap = (0, browser_settings_1.ensureManagedBrowserUserDataDir)(effective);
+    if (managedBootstrap.createdProfileDir) {
+        const managedMessage = (0, browser_settings_1.describeManagedBrowserAttachNotReady)(effective, `Chrome reuse metadata not found: ${path.join(effective.userDataDir, 'DevToolsActivePort')}`, {
+            createdProfileDir: true,
+            launchCommand: launchCommands[(0, platform_1.getNodePlatformKey)()],
+        });
+        if (managedMessage) {
+            return {
+                ...base,
+                state: managedMessage.state,
+                title: managedMessage.title,
+                detail: managedMessage.detail,
+                nextStep: managedMessage.nextStep,
+            };
+        }
+    }
+    try {
+        const runtimeEnv = await (0, chrome_reuse_1.resolveBrowserRuntimeEnv)({
+            profileDir: effective.userDataDir,
+            devtoolsPort: effective.hasExplicitDevtoolsPort ? String(effective.devtoolsPort) : undefined,
+        });
+        return {
+            ...base,
+            state: 'ready',
+            title: 'Claude Browser Attach is ready.',
+            detail: browserConfig.claude.policy === 'manual'
+                ? 'CCS can reach the configured Chrome DevTools endpoint, and the lane stays hidden until a launch uses `--browser`.'
+                : 'CCS can reach the configured Chrome DevTools endpoint for the current attach session.',
+            nextStep: browserConfig.claude.policy === 'manual'
+                ? 'Launch a Claude-target CCS session with `--browser` to use the managed browser MCP runtime.'
+                : 'Launch a Claude-target CCS session to use the managed browser MCP runtime.',
+            runtimeEnv,
+        };
+    }
+    catch (error) {
+        const message = error.message;
+        const managedMessage = (0, browser_settings_1.describeManagedBrowserAttachNotReady)(effective, message, {
+            createdProfileDir: managedBootstrap.createdProfileDir,
+            launchCommand: launchCommands[(0, platform_1.getNodePlatformKey)()],
+        });
+        if (managedMessage) {
+            return {
+                ...base,
+                state: managedMessage.state,
+                title: managedMessage.title,
+                detail: managedMessage.detail,
+                nextStep: managedMessage.nextStep,
+            };
+        }
+        if (message.includes('Chrome profile directory is invalid')) {
+            return {
+                ...base,
+                state: 'path_missing',
+                title: 'Claude Browser Attach path is missing.',
+                detail: message,
+                nextStep: `Create or choose a Chrome user-data directory, then launch Chrome with attach mode enabled. Example: ${launchCommands[(0, platform_1.getNodePlatformKey)()]}`,
+            };
+        }
+        if (message.includes('Chrome reuse metadata')) {
+            return {
+                ...base,
+                state: 'browser_not_running',
+                title: 'Claude Browser Attach could not find a running browser session.',
+                detail: message,
+                nextStep: `Start Chrome with remote debugging and the configured user-data dir. Example: ${launchCommands[(0, platform_1.getNodePlatformKey)()]}`,
+            };
+        }
+        return {
+            ...base,
+            state: 'endpoint_unreachable',
+            title: 'Claude Browser Attach could not reach the DevTools endpoint.',
+            detail: message,
+            nextStep: `Restart the attach browser session or confirm the configured port. Example: ${launchCommands[(0, platform_1.getNodePlatformKey)()]}`,
+        };
+    }
+}
+function buildCodexBrowserStatus(browserConfig = getUserFacingBrowserConfig()) {
+    if (!browserConfig.codex.enabled) {
+        return {
+            enabled: false,
+            policy: browserConfig.codex.policy,
+            evalMode: resolveSafeBrowserEvalMode(browserConfig.codex.eval_mode),
+            state: 'disabled',
+            title: 'Codex Browser Tools are disabled.',
+            detail: 'CCS keeps Codex Browser Tools off by default and will not inject Playwright MCP browser tooling until this lane is enabled.',
+            nextStep: 'Enable Codex Browser Tools in Settings > Browser when you want browser access on Codex-target launches.',
+            serverName: 'ccs_browser',
+            supportsConfigOverrides: false,
+            binaryPath: null,
+        };
+    }
+    const binaryInfo = (0, codex_detector_1.getCodexBinaryInfo)({ includeVersion: true, includeFeatures: true });
+    const supportsConfigOverrides = Boolean(binaryInfo?.features?.includes('config-overrides'));
+    if (!binaryInfo || !supportsConfigOverrides) {
+        return {
+            enabled: true,
+            policy: browserConfig.codex.policy,
+            evalMode: resolveSafeBrowserEvalMode(browserConfig.codex.eval_mode),
+            state: 'unsupported_build',
+            title: 'Codex Browser Tools need a Codex build with --config override support.',
+            detail: binaryInfo
+                ? `Detected Codex at ${binaryInfo.path}, but it does not advertise --config overrides.`
+                : 'No Codex binary was detected, so CCS cannot confirm managed browser override support.',
+            nextStep: 'Install or upgrade Codex, then rerun browser status/doctor.',
+            serverName: 'ccs_browser',
+            supportsConfigOverrides,
+            binaryPath: binaryInfo?.path ?? null,
+            version: binaryInfo?.version,
+        };
+    }
+    return {
+        enabled: true,
+        policy: browserConfig.codex.policy,
+        evalMode: resolveSafeBrowserEvalMode(browserConfig.codex.eval_mode),
+        state: 'enabled',
+        title: 'Codex Browser Tools are enabled.',
+        detail: browserConfig.codex.policy === 'manual'
+            ? 'CCS can inject the managed Playwright MCP overrides when a Codex-target launch opts in with `--browser`.'
+            : 'CCS can inject the managed Playwright MCP overrides into Codex-target launches.',
+        nextStep: browserConfig.codex.policy === 'manual'
+            ? 'Use `--browser` on a Codex-target CCS launch to access browser tools.'
+            : 'Use a Codex-target CCS launch to access browser tools.',
+        serverName: 'ccs_browser',
+        supportsConfigOverrides,
+        binaryPath: binaryInfo.path,
+        version: binaryInfo.version,
+    };
+}
+function getManagedBrowserSetupHint() {
+    return (0, browser_settings_1.buildManagedBrowserAttachSetupOptions)({
+        enabled: true,
+        source: 'config',
+        overrideActive: false,
+        userDataDir: (0, browser_settings_1.getRecommendedBrowserUserDataDir)(),
+        devtoolsPort: 9222,
+        hasExplicitDevtoolsPort: true,
+        evalMode: 'readonly',
+    }).join('\n');
+}
+exports.getManagedBrowserSetupHint = getManagedBrowserSetupHint;
+//# sourceMappingURL=browser-status.js.map