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

package/dist/src/backend/client.d.ts

@@ -6,7 +6,7 @@ import type { ChatGPTResponsesCreateArgs } from "../runner/responses.js";
 import type { ChatGPTRunStream } from "../runner/stream.js";
 import type { ChatGPTAgent, ChatGPTAgentConfig, ChatGPTResponse, ChatGPTRunInput, ChatGPTRunResult } from "../runner/types.js";
 import type { ReportRedactionOptions } from "../safety/report-redaction.js";
-import type { ArtifactDownloadArgs, ArtifactWaitArgs, BootstrapArgs, CommandResult, CopyResponseArgs, DownloadLatestArgs, ListArtifactsArgs, NewThreadArgs, OpenThreadArgs, ReadLatestArgs, SearchThreadsArgs, SelectToolArgs, SequencePlan, SetModeArgs, WaitArgs } from "../types.js";
+import type { ArtifactDownloadArgs, ArtifactWaitArgs, ApplyConfigurationData, ApplyConfigurationArgs, BootstrapArgs, ChatGPTExperience, CommandResult, ConfigurationInspectionData, CopyResponseArgs, DetectExperienceArgs, DetectExperienceData, DownloadLatestArgs, GetModeArgs, GetModeData, InspectConfigurationArgs, ListArtifactsArgs, MessageStatusArgs, NewThreadArgs, OpenThreadArgs, OpenExperienceData, ReadLatestArgs, ReadWorkLatestArgs, ReadWorkLatestData, SearchThreadsArgs, SelectToolArgs, SequencePlan, SetModeArgs, StartWorkArgs, StartWorkData, SteerWorkArgs, SteerWorkData, WaitArgs, WorkStatusArgs, WorkStatusData, WorkWaitArgs, WorkWaitData } from "../types.js";
 import { type BackendEvent, type BackendRequest, type BackendResponse } from "./protocol.js";
 export type BackendTransport = {
     request(request: BackendRequest): Promise<BackendResponse>;
@@ -60,6 +60,29 @@ export type ChatGPTBackendClient = {
     session: {
         bootstrap(args?: BootstrapArgs): Promise<CommandResult<unknown>>;
     };
+    experience: {
+        detect(args?: DetectExperienceArgs): Promise<CommandResult<DetectExperienceData>>;
+        open(args: {
+            experience: Exclude<ChatGPTExperience, "unknown">;
+            timeoutMs?: number;
+        }): Promise<CommandResult<OpenExperienceData>>;
+    };
+    configuration: {
+        inspect(args?: InspectConfigurationArgs): Promise<CommandResult<ConfigurationInspectionData>>;
+        apply(args: ApplyConfigurationArgs): Promise<CommandResult<ApplyConfigurationData>>;
+    };
+    work: {
+        start(args: StartWorkArgs): Promise<CommandResult<StartWorkData>>;
+        status(args?: WorkStatusArgs): Promise<CommandResult<WorkStatusData>>;
+        wait(args?: WorkWaitArgs): Promise<CommandResult<WorkWaitData>>;
+        steer(args: SteerWorkArgs): Promise<CommandResult<SteerWorkData>>;
+        readLatest(args?: ReadWorkLatestArgs): Promise<CommandResult<ReadWorkLatestData>>;
+        artifacts: {
+            listLatest(args?: ListArtifactsArgs): Promise<CommandResult<unknown>>;
+            wait(args?: ArtifactWaitArgs): Promise<CommandResult<unknown>>;
+            downloadLatest(args: ArtifactDownloadArgs): Promise<CommandResult<unknown>>;
+        };
+    };
     threads: {
         "new"(args?: NewThreadArgs): Promise<CommandResult<unknown>>;
         search(args: SearchThreadsArgs): Promise<CommandResult<unknown>>;
@@ -84,6 +107,7 @@ export type ChatGPTBackendClient = {
         }): Promise<CommandResult<unknown>>;
         wait(args?: WaitArgs): Promise<CommandResult<unknown>>;
         readLatest(args?: ReadLatestArgs): Promise<CommandResult<unknown>>;
+        status(args?: MessageStatusArgs): Promise<CommandResult<unknown>>;
         waitAndRead(args?: WaitArgs & ReadLatestArgs): Promise<CommandResult<unknown>>;
     };
     files: {
@@ -95,6 +119,7 @@ export type ChatGPTBackendClient = {
     };
     modes: {
         set(args: SetModeArgs): Promise<CommandResult<unknown>>;
+        get(args?: GetModeArgs): Promise<CommandResult<GetModeData>>;
     };
     tools: {
         select(args: SelectToolArgs): Promise<CommandResult<unknown>>;

package/dist/src/backend/client.js

@@ -63,6 +63,26 @@ export function createChatGPTBackendClient(transport) {
         session: {
             bootstrap: args => request("session.bootstrap", args ?? {})
         },
+        experience: {
+            detect: args => request("experience.detect", args ?? {}),
+            open: args => request("experience.open", args)
+        },
+        configuration: {
+            inspect: args => request("configuration.inspect", args ?? {}),
+            apply: args => request("configuration.apply", args)
+        },
+        work: {
+            start: args => request("work.start", args),
+            status: args => request("work.status", args ?? {}),
+            wait: args => request("work.wait", args ?? {}),
+            steer: args => request("work.steer", args),
+            readLatest: args => request("work.readLatest", args ?? {}),
+            artifacts: {
+                listLatest: args => request("artifacts.listLatest", args ?? {}),
+                wait: args => request("artifacts.wait", args ?? {}),
+                downloadLatest: args => request("artifacts.downloadLatest", args)
+            }
+        },
         threads: {
             new: args => request("threads.new", args ?? {}),
             search: args => request("threads.search", args),
@@ -74,6 +94,7 @@ export function createChatGPTBackendClient(transport) {
             ask: args => request("messages.ask", args),
             wait: args => request("messages.wait", args ?? {}),
             readLatest: args => request("messages.readLatest", args ?? {}),
+            status: args => request("messages.status", args ?? {}),
             waitAndRead: args => request("messages.waitAndRead", args)
         },
         artifacts: {
@@ -86,7 +107,8 @@ export function createChatGPTBackendClient(transport) {
             downloadLatest: args => request("files.downloadLatest", args)
         },
         modes: {
-            set: args => request("modes.set", args)
+            set: args => request("modes.set", args),
+            get: args => request("modes.get", args ?? {})
         },
         tools: {
             select: args => request("tools.select", args)

package/dist/src/backend/protocol.d.ts

@@ -1,7 +1,7 @@
 export declare const BACKEND_REQUEST_SCHEMA_VERSION: "chatgpt.browser_control.backend_request.v1";
 export declare const BACKEND_RESPONSE_SCHEMA_VERSION: "chatgpt.browser_control.backend_response.v1";
 export declare const BACKEND_EVENT_SCHEMA_VERSION: "chatgpt.browser_control.backend_event.v1";
-export declare const backendCommands: readonly ["backend.version", "backend.health", "backend.capabilities", "runner.run", "runner.plan", "runner.stream", "responses.create", "ask", "askInThread", "askWithFiles", "askAndDownload", "runMessages", "openThread", "readLatest", "copyLatest", "downloadLatest", "runPlan", "doctor", "createReport", "reports.create", "reports.redact", "reports.summarize", "commands", "describe", "help", "session.bootstrap", "threads.new", "threads.search", "threads.open", "messages.compose", "messages.submit", "messages.ask", "messages.wait", "messages.readLatest", "messages.waitAndRead", "artifacts.listLatest", "artifacts.wait", "artifacts.downloadLatest", "files.preflight", "files.attach", "files.downloadLatest", "projects.sources.list", "projects.sources.planAdd", "projects.sources.add", "modes.set", "modes.get", "tools.select", "response.copy"];
+export declare const backendCommands: readonly ["backend.version", "backend.health", "backend.capabilities", "runner.run", "runner.plan", "runner.stream", "responses.create", "ask", "askInThread", "askWithFiles", "askAndDownload", "runMessages", "openThread", "readLatest", "copyLatest", "downloadLatest", "runPlan", "doctor", "createReport", "reports.create", "reports.redact", "reports.summarize", "commands", "describe", "help", "session.bootstrap", "experience.detect", "experience.open", "configuration.inspect", "configuration.apply", "work.start", "work.status", "work.wait", "work.steer", "work.readLatest", "threads.new", "threads.search", "threads.open", "messages.compose", "messages.submit", "messages.ask", "messages.wait", "messages.readLatest", "messages.status", "messages.waitAndRead", "artifacts.listLatest", "artifacts.wait", "artifacts.downloadLatest", "files.preflight", "files.attach", "files.downloadLatest", "projects.sources.list", "projects.sources.planAdd", "projects.sources.add", "modes.set", "modes.get", "tools.select", "response.copy"];
 export type BackendCommand = typeof backendCommands[number];
 export type BackendRequest = {
     schemaVersion: typeof BACKEND_REQUEST_SCHEMA_VERSION;

package/dist/src/backend/protocol.js

@@ -28,6 +28,15 @@ export const backendCommands = [
     "describe",
     "help",
     "session.bootstrap",
+    "experience.detect",
+    "experience.open",
+    "configuration.inspect",
+    "configuration.apply",
+    "work.start",
+    "work.status",
+    "work.wait",
+    "work.steer",
+    "work.readLatest",
     "threads.new",
     "threads.search",
     "threads.open",
@@ -36,6 +45,7 @@ export const backendCommands = [
     "messages.ask",
     "messages.wait",
     "messages.readLatest",
+    "messages.status",
     "messages.waitAndRead",
     "artifacts.listLatest",
     "artifacts.wait",

package/dist/src/backend/session.js

@@ -123,6 +123,24 @@ async function dispatchBackendCommand(client, request) {
             return client.reports.summarize(requiredRecord(payload, "result"), optionalRecord(payload, "args"));
         case "session.bootstrap":
             return client.session.bootstrap(emptyToUndefined(payload));
+        case "experience.detect":
+            return client.experience.detect(emptyToUndefined(payload));
+        case "experience.open":
+            return client.experience.open(payload);
+        case "configuration.inspect":
+            return client.configuration.inspect(emptyToUndefined(payload));
+        case "configuration.apply":
+            return client.configuration.apply(payload);
+        case "work.start":
+            return client.work.start(payload);
+        case "work.status":
+            return client.work.status(emptyToUndefined(payload));
+        case "work.wait":
+            return client.work.wait(emptyToUndefined(payload));
+        case "work.steer":
+            return client.work.steer(payload);
+        case "work.readLatest":
+            return client.work.readLatest(emptyToUndefined(payload));
         case "threads.new":
             return client.threads.new(emptyToUndefined(payload));
         case "threads.search":
@@ -139,6 +157,8 @@ async function dispatchBackendCommand(client, request) {
             return client.messages.wait(emptyToUndefined(payload));
         case "messages.readLatest":
             return client.messages.readLatest(emptyToUndefined(payload));
+        case "messages.status":
+            return client.messages.status(emptyToUndefined(payload));
         case "messages.waitAndRead":
             return client.messages.waitAndRead(payload);
         case "artifacts.listLatest":

package/dist/src/browser/attach.d.ts

@@ -6,3 +6,4 @@ export type AttachedBrowser = {
     tabId?: string;
 };
 export declare function attachChatGPTBrowser(env: RuntimeEnv, args?: BootstrapArgs): Promise<AttachedBrowser>;
+export declare function tabIdFromPage(page: PageLike): string | undefined;

package/dist/src/browser/attach.js

@@ -16,7 +16,7 @@ export async function attachChatGPTBrowser(env, args = {}) {
         page,
         browserName: browser.name ?? "chrome"
     };
-    const tabId = getTabId(page);
+    const tabId = tabIdFromPage(page);
     if (tabId !== undefined) {
         attached.tabId = tabId;
     }
@@ -332,7 +332,7 @@ function mismatchReasonForNoMatches(policy, tabs, chatgptTabs) {
 async function pageMatchesExistingTarget(page, policy) {
     const url = await Promise.resolve(page.url?.()).catch(() => undefined);
     const title = await Promise.resolve(page.title?.()).catch(() => undefined);
-    const tab = { id: getTabId(page) ?? "" };
+    const tab = { id: tabIdFromPage(page) ?? "" };
     if (url !== undefined)
         tab.url = url;
     if (title !== undefined)
@@ -557,7 +557,7 @@ function normalizePage(pageOrTab) {
     }
     return pageOrTab;
 }
-function getTabId(page) {
+export function tabIdFromPage(page) {
     const maybe = page;
     const id = maybe.id ?? maybe.tabId;
     return typeof id === "string" ? id : undefined;

package/dist/src/browser/downloads.d.ts

@@ -4,4 +4,4 @@ export type DownloadLike = {
     saveAs?: (path: string) => Promise<void>;
     path?: () => Promise<string | null>;
 };
-export declare function waitForDownloadFromClick(page: PageLike, click: () => Promise<void>, destDir: string, timeoutMs: number): Promise<DownloadedFile>;
+export declare function waitForDownloadFromClick(page: PageLike, click: () => Promise<void>, destDir: string, timeoutMs: number, filenameHint?: string): Promise<DownloadedFile>;

package/dist/src/browser/downloads.js

@@ -1,7 +1,7 @@
-import { mkdir, stat } from "node:fs/promises";
+import { copyFile, mkdir, stat } from "node:fs/promises";
 import { basename, join, resolve } from "node:path";
 import { localGuardTimeout, withTimeout } from "../commands/timeouts.js";
-export async function waitForDownloadFromClick(page, click, destDir, timeoutMs) {
+export async function waitForDownloadFromClick(page, click, destDir, timeoutMs, filenameHint) {
     const absoluteDest = resolve(destDir);
     await mkdir(absoluteDest, { recursive: true });
     const downloadPromise = page.waitForEvent?.("download", { timeout: timeoutMs, timeoutMs });
@@ -10,13 +10,22 @@ export async function waitForDownloadFromClick(page, click, destDir, timeoutMs)
     }
     await withTimeout(click(), localGuardTimeout(timeoutMs, 10000), "Download control click did not complete before the local guard timeout.");
     const download = await downloadPromise;
-    const suggestedFilename = download.suggestedFilename?.() ?? `chatgpt-download-${Date.now()}`;
+    const sourcePath = typeof download.path === "function" ? await download.path() : null;
+    const suggestedFilename = filenameHint
+        ?? download.suggestedFilename?.()
+        ?? (sourcePath === null ? undefined : basename(sourcePath))
+        ?? `chatgpt-download-${Date.now()}`;
     const targetPath = join(absoluteDest, basename(suggestedFilename));
     if (typeof download.saveAs === "function") {
         await download.saveAs(targetPath);
     }
+    else if (sourcePath !== null) {
+        if (resolve(sourcePath) !== resolve(targetPath)) {
+            await copyFile(sourcePath, targetPath);
+        }
+    }
     else {
-        throw new Error("The browser download object does not expose saveAs().");
+        throw new Error("The browser download object exposes neither saveAs() nor a completed local path().");
     }
     const saved = await stat(targetPath);
     if (saved.size <= 0) {

package/dist/src/browser/page-state.js

@@ -22,8 +22,11 @@ export async function readPageState(page) {
     const rawTitle = typeof page.title === "function" ? await page.title().catch(() => undefined) : undefined;
     const title = typeof rawTitle === "string" ? rawTitle : undefined;
     const visibleText = await readVisibleText(page);
-    const blocker = classifyVisibleText(visibleText);
-    const signedIn = isLikelySignedIn(visibleText) && blocker?.kind !== "login_required";
+    const signedIn = isLikelySignedIn(visibleText);
+    const classifiedBlocker = classifyVisibleText(visibleText);
+    const blocker = classifiedBlocker?.kind === "login_required" && signedIn
+        ? undefined
+        : classifiedBlocker;
     const conversationId = parseConversationId(url);
     const state = {
         url,

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import type { AskArgs, ArtifactDownloadArgs, ArtifactWaitArgs, AttachFilesArgs, BootstrapArgs, CommandResult, CopyResponseArgs, DownloadLatestArgs, FilePreflightArgs, FilePreflightData, GetModeArgs, GetModeData, ListArtifactsArgs, NewThreadArgs, OpenThreadArgs, ProjectSourcesAddArgs, ProjectSourcesAddData, ProjectSourcesAddPlanData, ProjectSourcesListArgs, ProjectSourcesListData, ProjectSourcesPlanAddArgs, ReadLatestArgs, RuntimeEnv, SearchThreadsArgs, SelectToolArgs, SequencePlan, SetModeArgs, ThreadTarget, WaitArgs } from "./types.js";
+import type { AskArgs, ArtifactDownloadArgs, ArtifactWaitArgs, ApplyConfigurationData, ApplyConfigurationArgs, AttachFilesArgs, BootstrapArgs, ChatGPTExperience, CommandResult, ConfigurationInspectionData, ConfigurationSelection, CopyResponseArgs, DetectExperienceArgs, DetectExperienceData, DownloadLatestArgs, FilePreflightArgs, FilePreflightData, GetModeArgs, GetModeData, InspectConfigurationArgs, ListArtifactsArgs, MessageStatusArgs, NewThreadArgs, OpenThreadArgs, OpenExperienceData, ProjectSourcesAddArgs, ProjectSourcesAddData, ProjectSourcesAddPlanData, ProjectSourcesListArgs, ProjectSourcesListData, ProjectSourcesPlanAddArgs, ReadLatestArgs, RuntimeEnv, ReadWorkLatestArgs, ReadWorkLatestData, SearchThreadsArgs, SelectToolArgs, SequencePlan, SetModeArgs, StartWorkArgs, StartWorkData, SteerWorkArgs, SteerWorkData, ThreadTarget, WaitArgs, WorkStatusArgs, WorkStatusData, WorkWaitArgs, WorkWaitData } from "./types.js";
 import { type DoctorArgs, type DoctorReport } from "./commands/doctor.js";
 import { type RunReportData, type RunReportOptions } from "./commands/reports.js";
 import { type CommandDescriptor } from "./commands/registry.js";
@@ -8,6 +8,8 @@ import { type ReportRedactionOptions } from "./safety/report-redaction.js";
 import { type BlockerExplanation, type ExplainBlockerOptions } from "./diagnostics/blockers.js";
 export type ChatGPTClientOptions = RuntimeEnv & {
     defaults?: {
+        experience?: Exclude<ChatGPTExperience, "unknown">;
+        configuration?: ConfigurationSelection;
         mode?: SetModeArgs;
         wait?: boolean | WaitArgs;
         read?: boolean | ReadLatestArgs;
@@ -59,6 +61,8 @@ export type AskWorkflowArgs = {
     thread?: WorkflowThread;
     existingTab?: BootstrapArgs["existingTab"];
     preferExistingTab?: boolean;
+    experience?: Exclude<ChatGPTExperience, "unknown">;
+    configuration?: ConfigurationSelection;
     mode?: SetModeArgs;
     tools?: SelectToolArgs[];
     files?: FileInput[];
@@ -83,6 +87,8 @@ export type RunMessagesArgs = {
     thread?: WorkflowThread;
     existingTab?: BootstrapArgs["existingTab"];
     preferExistingTab?: boolean;
+    experience?: Exclude<ChatGPTExperience, "unknown">;
+    configuration?: ConfigurationSelection;
     mode?: SetModeArgs;
     messages: Array<{
         id?: string;
@@ -136,6 +142,29 @@ export type ChatGPTClient = {
     session: {
         bootstrap(args?: BootstrapArgs): Promise<CommandResult<unknown>>;
     };
+    experience: {
+        detect(args?: DetectExperienceArgs): Promise<CommandResult<DetectExperienceData>>;
+        open(args: {
+            experience: Exclude<ChatGPTExperience, "unknown">;
+            timeoutMs?: number;
+        }): Promise<CommandResult<OpenExperienceData>>;
+    };
+    configuration: {
+        inspect(args?: InspectConfigurationArgs): Promise<CommandResult<ConfigurationInspectionData>>;
+        apply(args: ApplyConfigurationArgs): Promise<CommandResult<ApplyConfigurationData>>;
+    };
+    work: {
+        start(args: StartWorkArgs): Promise<CommandResult<StartWorkData>>;
+        status(args?: WorkStatusArgs): Promise<CommandResult<WorkStatusData>>;
+        wait(args?: WorkWaitArgs): Promise<CommandResult<WorkWaitData>>;
+        steer(args: SteerWorkArgs): Promise<CommandResult<SteerWorkData>>;
+        readLatest(args?: ReadWorkLatestArgs): Promise<CommandResult<ReadWorkLatestData>>;
+        artifacts: {
+            listLatest(args?: ListArtifactsArgs): Promise<CommandResult<unknown>>;
+            wait(args?: ArtifactWaitArgs): Promise<CommandResult<unknown>>;
+            downloadLatest(args: ArtifactDownloadArgs): Promise<CommandResult<unknown>>;
+        };
+    };
     threads: {
         "new"(args?: NewThreadArgs): Promise<CommandResult<unknown>>;
         search(args: SearchThreadsArgs): Promise<CommandResult<unknown>>;
@@ -155,6 +184,7 @@ export type ChatGPTClient = {
         ask(args: AskArgs): Promise<CommandResult<unknown>>;
         wait(args?: WaitArgs): Promise<CommandResult<unknown>>;
         readLatest(args?: ReadLatestArgs): Promise<CommandResult<unknown>>;
+        status(args?: MessageStatusArgs): Promise<CommandResult<unknown>>;
         waitAndRead(args?: WaitArgs & ReadLatestArgs): Promise<CommandResult<unknown>>;
     };
     files: {

package/dist/src/client.js

@@ -2,14 +2,17 @@ import { downloadLatestArtifact, listLatestArtifacts, waitForArtifact } from "./
 import { attachFiles, downloadLatestFile, preflightFiles } from "./commands/files.js";
 import { addProjectSources, buildProjectSourceAddPlan, listProjectSources } from "./commands/project-sources.js";
 import { doctor } from "./commands/doctor.js";
-import { askMessage, composeMessage, readLatest, submitMessage, waitAndRead, waitForMessage } from "./commands/messages.js";
+import { askMessage, composeMessage, messageStatus, readLatest, submitMessage, waitAndRead, waitForMessage } from "./commands/messages.js";
 import { getMode, selectTool, setMode } from "./commands/modes.js";
+import { applyConfiguration, inspectConfiguration } from "./commands/configuration.js";
+import { detectExperience, openExperience } from "./commands/experience.js";
 import { createRunReport } from "./commands/reports.js";
 import { copyResponse } from "./commands/response-actions.js";
 import { commandDescriptors, describeCommand, helpText } from "./commands/registry.js";
 import { runSequence } from "./commands/sequence.js";
 import { bootstrap } from "./commands/session.js";
 import { newThread, openThread, searchThreads } from "./commands/threads.js";
+import { readLatestWork, startWork, steerWork, waitForWork, workStatus } from "./commands/work.js";
 import { resultError, resultOk } from "./errors.js";
 import { createChatGPTAgent } from "./runner/agent.js";
 import { toRunResult } from "./runner/result.js";
@@ -60,6 +63,26 @@ export function createChatGPT(options = {}) {
         session: {
             bootstrap: args => bootstrap(env, args)
         },
+        experience: {
+            detect: args => detectExperience(env, args),
+            open: args => openExperience(env, args)
+        },
+        configuration: {
+            inspect: args => inspectConfiguration(env, args),
+            apply: args => applyConfiguration(env, args)
+        },
+        work: {
+            start: args => startWork(env, args),
+            status: args => workStatus(env, args),
+            wait: args => waitForWork(env, args),
+            steer: args => steerWork(env, args),
+            readLatest: args => readLatestWork(env, args),
+            artifacts: {
+                listLatest: args => listLatestArtifacts(env, args),
+                wait: args => waitForArtifact(env, args),
+                downloadLatest: args => downloadLatestArtifact(env, args)
+            }
+        },
         threads: {
             new: args => newThread(env, args),
             search: args => searchThreads(env, args),
@@ -71,6 +94,7 @@ export function createChatGPT(options = {}) {
             ask: args => askMessage(env, args),
             wait: args => waitForMessage(env, args),
             readLatest: args => readLatest(env, args),
+            status: args => messageStatus(env, args),
             waitAndRead: args => waitAndRead(env, args)
         },
         files: {
@@ -166,6 +190,30 @@ function pathsFromAttachStep(step) {
     const paths = step.args.paths;
     return paths.every(item => typeof item === "string") ? paths : [];
 }
+function appendSurfaceConfigurationSteps(steps, preferences) {
+    if (preferences.experience !== undefined) {
+        steps.push({
+            id: "experience",
+            command: "experience.open",
+            args: { experience: preferences.experience }
+        });
+    }
+    if (preferences.configuration !== undefined) {
+        steps.push({
+            id: "configuration",
+            command: "configuration.apply",
+            args: {
+                ...(preferences.experience === undefined ? {} : { experience: preferences.experience }),
+                desired: preferences.configuration,
+                strict: true
+            }
+        });
+        return;
+    }
+    if (preferences.mode !== undefined) {
+        steps.push({ id: "mode", command: "modes.set", args: preferences.mode });
+    }
+}
 function normalizeLimits(limits) {
     return {
         maxPromptsPerRun: limits?.maxPromptsPerRun ?? 5,
@@ -178,7 +226,7 @@ function normalizeLimits(limits) {
 function checkRunBudget(plan, limits) {
     const prompts = plan.steps.filter(step => step.command === "messages.ask" || step.command === "messages.submit").length;
     const threads = plan.steps.filter(step => step.command === "threads.new" || step.command === "threads.open").length;
-    const reads = plan.steps.filter(step => step.command === "messages.readLatest" || step.command === "messages.waitAndRead" || step.command === "response.copy").length
+    const reads = plan.steps.filter(step => step.command === "messages.readLatest" || step.command === "messages.status" || step.command === "messages.waitAndRead" || step.command === "response.copy").length
         + plan.steps.filter(step => step.command === "messages.ask" && askStepReads(step.args)).length;
     const violations = [];
     if (prompts > limits.maxPromptsPerRun)
@@ -270,10 +318,11 @@ function planAgentWorkflowFromNormalized(agent, input, defaults = {}) {
         bootstrapStepForWorkflow(thread, input.existingTab ?? agent.defaults.existingTab ?? defaults.existingTab, input.preferExistingTab ?? agent.defaults.preferExistingTab ?? defaults.preferExistingTab),
         ...threadSteps(thread)
     ];
-    const mode = input.mode ?? agent.defaults.mode ?? defaults.mode;
-    if (mode !== undefined) {
-        steps.push({ id: "mode", command: "modes.set", args: mode });
-    }
+    appendSurfaceConfigurationSteps(steps, {
+        experience: input.experience ?? agent.defaults.experience ?? defaults.experience,
+        configuration: input.configuration ?? agent.defaults.configuration ?? defaults.configuration,
+        mode: input.mode ?? agent.defaults.mode ?? defaults.mode
+    });
     for (const [index, tool] of input.tools.entries()) {
         steps.push({ id: `tool${index + 1}`, command: "tools.select", args: tool });
     }
@@ -338,6 +387,10 @@ function normalizeRunnerInput(agent, input) {
         normalized.existingTab = args.existingTab;
     if (args.preferExistingTab !== undefined)
         normalized.preferExistingTab = args.preferExistingTab;
+    if (args.experience !== undefined)
+        normalized.experience = args.experience;
+    if (args.configuration !== undefined)
+        normalized.configuration = args.configuration;
     if (mode !== undefined)
         normalized.mode = mode;
     if (args.response !== undefined)
@@ -458,10 +511,11 @@ function planAskWorkflow(args, defaults = {}) {
         bootstrapStepForWorkflow(thread, args.existingTab ?? defaults.existingTab, args.preferExistingTab ?? defaults.preferExistingTab),
         ...threadSteps(thread)
     ];
-    const mode = args.mode ?? defaults.mode;
-    if (mode !== undefined) {
-        steps.push({ id: "mode", command: "modes.set", args: mode });
-    }
+    appendSurfaceConfigurationSteps(steps, {
+        experience: args.experience ?? defaults.experience,
+        configuration: args.configuration ?? defaults.configuration,
+        mode: args.mode ?? defaults.mode
+    });
     for (const [index, tool] of (args.tools ?? []).entries()) {
         steps.push({ id: `tool${index + 1}`, command: "tools.select", args: tool });
     }
@@ -529,10 +583,11 @@ function planRunMessages(args, defaults = {}) {
         bootstrapStepForWorkflow(thread, args.existingTab ?? defaults.existingTab, args.preferExistingTab ?? defaults.preferExistingTab),
         ...threadSteps(thread)
     ];
-    const mode = args.mode ?? defaults.mode;
-    if (mode !== undefined) {
-        steps.push({ id: "mode", command: "modes.set", args: mode });
-    }
+    appendSurfaceConfigurationSteps(steps, {
+        experience: args.experience ?? defaults.experience,
+        configuration: args.configuration ?? defaults.configuration,
+        mode: args.mode ?? defaults.mode
+    });
     args.messages.forEach((message, index) => {
         steps.push({
             id: message.id ?? `message${index + 1}`,

package/dist/src/commands/artifacts.js

@@ -7,7 +7,7 @@ import { cssSelectors, requiredLocator } from "../dom/selectors.js";
 import { localeLabels } from "../dom/locale-labels.js";
 import { resultOk } from "../errors.js";
 import { contextFromPage } from "./context.js";
-import { bootstrap } from "./session.js";
+import { ensurePage } from "./session.js";
 import { localGuardTimeout, withTimeout } from "./timeouts.js";
 export async function listLatestArtifacts(env, args = {}) {
     const boot = await ensurePage(env);
@@ -408,12 +408,6 @@ function artifactDownloadBlocker(error, context) {
         context
     };
 }
-async function ensurePage(env) {
-    if (env.page !== undefined) {
-        return resultOk({}, await contextFromPage(env.page));
-    }
-    return bootstrap(env, { preferExistingTab: true });
-}
 async function hasStopControl(page, timeoutMs) {
     if (typeof page.evaluate !== "function")
         return false;

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

@@ -0,0 +1,15 @@
+import { type MenuItem } from "../dom/menus.js";
+import type { ApplyConfigurationArgs, ApplyConfigurationData, ChatGPTExperience, CommandResult, ConfigurationAxis, ConfigurationInspectionData, ConfigurationSelection, InspectConfigurationArgs, RuntimeEnv, SurfaceSelectorProfile } from "../types.js";
+export type ConfigurationPanelSnapshot = {
+    openerLabel?: string;
+    axisRows: Array<{
+        axis: ConfigurationAxis;
+        label: string;
+        value?: string;
+    }>;
+    advancedVisible: boolean;
+};
+export declare function inspectConfiguration(env: RuntimeEnv, args?: InspectConfigurationArgs): Promise<CommandResult<ConfigurationInspectionData>>;
+export declare function applyConfiguration(env: RuntimeEnv, args: ApplyConfigurationArgs): Promise<CommandResult<ApplyConfigurationData>>;
+export declare function configurationInspectionFromSurface(experience: ChatGPTExperience, detectedProfile: SurfaceSelectorProfile, evidence: ConfigurationInspectionData["evidence"], panel: ConfigurationPanelSnapshot, menuItems: MenuItem[]): ConfigurationInspectionData;
+export declare function configurationMatchesSelection(inspection: ConfigurationInspectionData, desired: ConfigurationSelection): boolean;