codex-chatgpt-control 0.5.1-alpha.1 → 0.5.1-alpha.2

package/dist/src/commands/configuration.js

@@ -47,6 +47,7 @@ export async function inspectConfiguration(env, args = {}) {
             };
         }
         const experience = detected.data.experience;
+        const initialPanel = await readConfigurationPanel(page);
         const rootOpened = experience !== "unknown" && await waitForConfigurationRoot(page, experience, args.timeoutMs);
         if (rootOpened) {
             await page.waitForTimeout?.(150);
@@ -57,6 +58,9 @@ export async function inspectConfiguration(env, args = {}) {
             await page.waitForTimeout?.(150);
         }
         const panel = await readConfigurationPanel(page);
+        if (panel.openerLabel === undefined && initialPanel.openerLabel !== undefined) {
+            panel.openerLabel = initialPanel.openerLabel;
+        }
         const rootItems = rootOpened ? await enumerateVisibleMenuItems(page) : [];
         const data = configurationInspectionFromSurface(experience, detected.data.selectorProfile, detected.data.evidence, panel, rootItems);
         if (args.includeOptions !== false && experience === "work" && panel.axisRows.length > 0) {
@@ -468,12 +472,18 @@ async function openConfigurationRoot(page, experience) {
                 }
                 return true;
             };
-            const composerRoots = Array.from(document.querySelectorAll("main form, main [data-testid*='composer' i], main [class*='composer' i]"));
+            const formRoots = Array.from(document.querySelectorAll("main form"));
+            const testIdRoots = Array.from(document.querySelectorAll("main [data-testid*='composer' i]"));
+            const classRoots = Array.from(document.querySelectorAll("main [class*='composer' i]"));
+            const composerRoots = formRoots.length > 0
+                ? formRoots
+                : testIdRoots.length > 0
+                    ? testIdRoots
+                    : classRoots;
             const main = document.querySelector("main");
-            const roots = Array.from(new Set([
-                ...composerRoots,
-                ...(main === null ? [] : [main])
-            ]));
+            const roots = Array.from(new Set(composerRoots.length > 0
+                ? composerRoots
+                : (main === null ? [] : [main])));
             const controls = Array.from(new Set(roots.flatMap(root => Array.from(root.querySelectorAll("button, [role='button']")))))
                 .filter(visible);
             const matches = controls.filter(control => {
@@ -620,12 +630,18 @@ async function readConfigurationPanel(page) {
                 break;
             }
         }
-        const composerRoots = Array.from(document.querySelectorAll("main form, main [data-testid*='composer' i], main [class*='composer' i]"));
+        const formRoots = Array.from(document.querySelectorAll("main form"));
+        const testIdRoots = Array.from(document.querySelectorAll("main [data-testid*='composer' i]"));
+        const classRoots = Array.from(document.querySelectorAll("main [class*='composer' i]"));
+        const composerRoots = formRoots.length > 0
+            ? formRoots
+            : testIdRoots.length > 0
+                ? testIdRoots
+                : classRoots;
         const main = document.querySelector("main");
-        const openerRoots = Array.from(new Set([
-            ...composerRoots,
-            ...(main === null ? [] : [main])
-        ]));
+        const openerRoots = Array.from(new Set(composerRoots.length > 0
+            ? composerRoots
+            : (main === null ? [] : [main])));
         const openerCandidates = Array.from(new Set(openerRoots.flatMap(root => Array.from(root.querySelectorAll("button, [role='button']")))))
             .filter(visible)
             .map(control => {
@@ -665,12 +681,30 @@ async function clickVisibleMenuItem(page, item) {
     if (item.testId !== undefined && await clickIfUnique(page.locator?.(`[data-testid="${escapeAttributeValue(item.testId)}"]`))) {
         return true;
     }
-    for (const role of ["menuitemradio", "menuitem", "option"]) {
+    const roles = [...new Set([
+            item.role,
+            "menuitemradio",
+            "menuitem",
+            "option"
+        ].filter((role) => role !== undefined))];
+    // Current Chat can expose visible text such as "Advanced" while assigning
+    // the actionable menu item a different accessible name (for example,
+    // "Show compact options"). Prefer that enumerated accessible name so the
+    // bridge clicks the menu item itself rather than a nested text span.
+    if (item.ariaLabel !== undefined) {
+        for (const role of roles) {
+            if (await clickIfUnique(page.getByRole?.(role, { name: item.ariaLabel, exact: true }))) {
+                return true;
+            }
+        }
+    }
+    for (const role of roles) {
         if (await clickIfUnique(page.getByRole?.(role, { name: item.label, exact: true }))) {
             return true;
         }
     }
-    return clickIfUnique(page.getByText?.(item.label, { exact: true }));
+    const exactText = new RegExp(`^\\s*${escapeRegExp(item.label)}\\s*$`, "i");
+    return clickIfUnique(page.locator?.("button, [role='button'], [role='menuitem'], [role='menuitemradio'], [role='option']")?.filter?.({ hasText: exactText }));
 }
 function findConfigurationOption(items, requested) {
     const normalizedRequested = normalizeConfigurationId(requested);

package/dist/src/commands/context.d.ts

@@ -1,2 +1,6 @@
 import type { CommandContext, PageLike } from "../types.js";
-export declare function contextFromPage(page: PageLike | undefined, partial?: Partial<CommandContext>): Promise<CommandContext>;
+export type ContextReadOptions = {
+    /** Avoid all optional browser probes on mutation/deadline result paths. */
+    minimal?: boolean;
+};
+export declare function contextFromPage(page: PageLike | undefined, partial?: Partial<CommandContext>, options?: ContextReadOptions): Promise<CommandContext>;

package/dist/src/commands/context.js

@@ -1,8 +1,8 @@
 import { countPageMessages } from "../dom/messages.js";
 import { parseConversationId } from "../browser/page-state.js";
 import { withTimeout } from "./timeouts.js";
-export async function contextFromPage(page, partial = {}) {
-    if (page === undefined) {
+export async function contextFromPage(page, partial = {}, options = {}) {
+    if (page === undefined || options.minimal === true) {
         return { timestamp: new Date().toISOString(), ...partial };
     }
     const url = typeof page.url === "function" ? await Promise.resolve(page.url()).catch(() => partial.url) : partial.url;

package/dist/src/commands/conversation.js

@@ -1,17 +1,29 @@
 import { parseConversationId } from "../browser/page-state.js";
+import { isChatGPTUrl, requireChatGPTUrl } from "../browser/chatgpt-url.js";
 import { countPageMessages, readLatestMessageText } from "../dom/messages.js";
 const CHATGPT_HOME = "https://chatgpt.com/";
 export async function ensureConversationTarget(page, target, options) {
     const targetUrl = absoluteConversationUrl(target);
+    requireChatGPTUrl(targetUrl, "Conversation target URL");
     const expectedConversationId = parseConversationId(targetUrl);
     const currentUrl = typeof page.url === "function" ? await Promise.resolve(page.url()).catch(() => "") : "";
-    if (expectedConversationId !== undefined
+    if (isChatGPTUrl(typeof currentUrl === "string" ? currentUrl : "")
+        &&
+            expectedConversationId !== undefined
         && parseConversationId(typeof currentUrl === "string" ? currentUrl : "") === expectedConversationId) {
         await waitForConversationHydrated(page, options.timeoutMs, expectedConversationId);
         return ensureResult(false, targetUrl, expectedConversationId);
     }
     await page.goto?.(targetUrl, { waitUntil: "domcontentloaded", timeout: options.timeoutMs });
+    const navigatedUrl = typeof page.url === "function" ? await Promise.resolve(page.url()).catch(() => "") : "";
+    requireChatGPTUrl(typeof navigatedUrl === "string" ? navigatedUrl : "", "Conversation navigation result");
     await waitForConversationHydrated(page, options.timeoutMs, expectedConversationId);
+    const finalUrl = typeof page.url === "function" ? await Promise.resolve(page.url()).catch(() => "") : "";
+    requireChatGPTUrl(typeof finalUrl === "string" ? finalUrl : "", "Hydrated conversation URL");
+    if (expectedConversationId !== undefined
+        && parseConversationId(typeof finalUrl === "string" ? finalUrl : "") !== expectedConversationId) {
+        throw new Error(`Visible Chat navigation did not reach conversation ${expectedConversationId}.`);
+    }
     return ensureResult(true, targetUrl, expectedConversationId);
 }
 export async function waitForConversationHydrated(page, timeoutMs, expectedConversationId) {

package/dist/src/commands/doctor.js

@@ -33,6 +33,8 @@ const REQUIRED_LOCALE_KEYS = [
 ];
 const REQUIRED_TOOL_IDS = ["web_search", "deep_research", "create_image"];
 const REQUIRED_MODE_OPTION_IDS = ["latest", "instant", "thinking", "extended", "medium", "high", "extraHigh", "pro"];
+const REQUIRED_CONFIGURATION_AXIS_IDS = ["power", "model", "intelligence", "effort", "speed", "advanced"];
+const REQUIRED_CONFIGURATION_OPTION_IDS = ["instant", "light", "medium", "high", "extraHigh", "max", "ultra", "pro", "standard", "fast"];
 export async function doctor(env, args = {}) {
     const wanted = args.check ?? DEFAULT_CHECKS;
     const checks = {};
@@ -232,8 +234,14 @@ function localizationCheck(env) {
     const requiredKeysMissing = REQUIRED_LOCALE_KEYS.filter(key => localeLabels[key].length === 0);
     const missingToolIds = REQUIRED_TOOL_IDS.filter(id => (localeLabels.tools[id]?.length ?? 0) === 0);
     const missingModeOptionIds = REQUIRED_MODE_OPTION_IDS.filter(id => (localeLabels.modeOptions[id]?.length ?? 0) === 0);
+    const missingConfigurationAxisIds = REQUIRED_CONFIGURATION_AXIS_IDS
+        .filter(id => (localeLabels.configurationAxes[id]?.length ?? 0) === 0);
+    const missingConfigurationOptionIds = REQUIRED_CONFIGURATION_OPTION_IDS
+        .filter(id => (localeLabels.configurationOptions[id]?.length ?? 0) === 0);
     const toolIds = Object.keys(localeLabels.tools);
     const modeOptionIds = Object.keys(localeLabels.modeOptions);
+    const configurationAxisIds = Object.keys(localeLabels.configurationAxes);
+    const configurationOptionIds = Object.keys(localeLabels.configurationOptions);
     const proAliases = [...localeLabels.modeOptions.pro];
     const supportsProExtendedAlias = proAliases.some(alias => /pro\s*(?:•\s*)?extended/i.test(alias))
         && proAliases.some(alias => /extended\s+pro/i.test(alias));
@@ -250,17 +258,26 @@ function localizationCheck(env) {
         && localeLabels.sendButton[0] === "Send prompt"
         && localeLabels.modeLabels.includes("Thinking")
         && localeLabels.modeOptions.pro?.[0] === "Pro"
+        && localeLabels.configurationAxes.power?.[0] === "Power"
+        && localeLabels.configurationAxes.advanced?.[0] === "Advanced"
+        && localeLabels.configurationOptions.ultra?.[0] === "Ultra"
         && localeLabels.tools.web_search?.[0] === "Web search";
     const labelCandidateCount = REQUIRED_LOCALE_KEYS.reduce((total, key) => total + localeLabels[key].length, 0)
         + Object.values(localeLabels.tools).reduce((total, values) => total + values.length, 0)
-        + Object.values(localeLabels.modeOptions).reduce((total, values) => total + values.length, 0);
+        + Object.values(localeLabels.modeOptions).reduce((total, values) => total + values.length, 0)
+        + Object.values(localeLabels.configurationAxes).reduce((total, values) => total + values.length, 0)
+        + Object.values(localeLabels.configurationOptions).reduce((total, values) => total + values.length, 0);
     const details = {
         englishCanonicalPresent,
         requiredKeysMissing,
         missingToolIds,
         missingModeOptionIds,
+        missingConfigurationAxisIds,
+        missingConfigurationOptionIds,
         toolIds,
         modeOptionIds,
+        configurationAxisIds,
+        configurationOptionIds,
         proAliases,
         supportsProExtendedAlias,
         runningStateLabelCoverage,
@@ -268,7 +285,12 @@ function localizationCheck(env) {
         pageAvailable: env.page !== undefined,
         runtimeSelectorCoverage: "registry_only_stage_2"
     };
-    if (englishCanonicalPresent && requiredKeysMissing.length === 0 && missingToolIds.length === 0 && missingModeOptionIds.length === 0) {
+    if (englishCanonicalPresent
+        && requiredKeysMissing.length === 0
+        && missingToolIds.length === 0
+        && missingModeOptionIds.length === 0
+        && missingConfigurationAxisIds.length === 0
+        && missingConfigurationOptionIds.length === 0) {
         const runningStateMessage = runningStateLocalizationSupport === "complete"
             ? "running-state labels are present for every registered non-English locale"
             : runningStateLocalizationSupport === "partial"

package/dist/src/commands/files.d.ts

@@ -3,3 +3,4 @@ export declare function validateAttachPaths(paths: string[]): Promise<AttachedFi
 export declare function preflightFiles(env: RuntimeEnv, args: FilePreflightArgs): Promise<CommandResult<FilePreflightData>>;
 export declare function attachFiles(env: RuntimeEnv, args: AttachFilesArgs): Promise<CommandResult<AttachFilesData>>;
 export declare function downloadLatestFile(env: RuntimeEnv, args: DownloadLatestArgs): Promise<CommandResult<DownloadedFile>>;
+export declare function stripLocalizedDownloadPrefix(value: string, labels: readonly string[]): string;