codex-copilot-dx 0.9.12 → 0.9.13

package/README.md

@@ -20,7 +20,7 @@ The adapter handles response history, encrypted reasoning state, function/custom
 
 Codex can select Standard or Fast without changing CCDX configuration. When the client requests a model with `service_tier: "priority"`, CCDX uses its exact `-fast` model only when the live Copilot catalog advertises that variant as enabled, selectable, OpenAI-owned, and Responses-only. Standard mode continues to use the base model; CCDX does not invent Fast availability when the upstream catalog does not provide it. This retains the established `gpt-5.6-sol` / `gpt-5.6-sol-fast` mapping and applies the same exact-match rule to future models.
 
-Codex Auto-review uses the hidden `codex-auto-review` model ID. CCDX maps it to Copilot's `gpt-6.1-sol` Responses model by default, independently of the interactive Fast/Standard selection, and logs both model IDs when the mapping is used. An omitted Auto-review reasoning effort defaults to `low`; explicit efforts and other reasoning fields are preserved. The review target can be changed interactively without reinstalling or restarting CCDX.
+Codex Auto-review uses the hidden `codex-auto-review` model ID. CCDX maps it to Copilot's `gpt-6.1-sol` Responses model by default, independently of the interactive Fast/Standard selection, and logs both model IDs when the mapping is used. Without a saved reasoning override, an omitted Auto-review effort defaults to `low`; explicit client efforts are preserved. A saved override changes only review effort, preserving other reasoning fields. The review target and effort can be changed interactively without reinstalling or restarting a current CCDX adapter.
 
 ### GPT-6 model catalog
 
@@ -117,7 +117,9 @@ ccdx auto-review-model
 
 The selector first queries the running adapter, including its last-known-good model list when live refresh is unavailable, then falls back to a local model cache no older than seven days. It offers model IDs that advertise a Responses endpoint and are not explicitly hidden from the model picker. This selection does not itself verify policy or inference access.
 
-The selection is saved in `~/.config/codex-copilot-dx/config.json`, or under `XDG_CONFIG_HOME` when set. Choosing `gpt-6.1-sol` clears the override and restores the package default. Existing saved models, including `gpt-5.5`, and environment overrides remain effective. A running adapter reads the setting on the next Auto-review request. The selector changes the model, not the reasoning effort; Codex Guardian currently sends `low`. GPT-6.1 Sol does not support explicit `none` or `minimal` efforts.
+Enter a model number, then a reasoning-effort number. The second menu reuses the same model-directory lookup and lists only advertised efforts. GPT-6.1 Sol excludes `none` and `minimal`, even if upstream metadata incorrectly lists them. Enter keeps the current valid effort or selects `low` for a new selection when advertised; `0` follows the client (or `low` if the request omits effort). If effort metadata is absent, only `0` is offered. Enter `q` at either step to cancel without saving either choice.
+
+Both choices are saved together in `~/.config/codex-copilot-dx/config.json`, or under `XDG_CONFIG_HOME` when set. Choosing `gpt-6.1-sol` clears the model override and restores the package default. A selected effort is saved as `auto_review_reasoning: { "model": "gpt-6.1-sol", "effort": "medium" }` and applies only when its model matches the effective review target. Existing saved models, including `gpt-5.5`, and environment model overrides retain their precedence; changing the model via an environment variable does not transfer another model's effort. Choose `0` to clear the effort override; its `null` marker remembers client-following so Enter preserves that choice next time. Users who do not configure effort retain their existing behavior. Adapters running 0.9.13 or newer read both settings on the next Auto-review request; older adapters must first be upgraded and restarted. No client patch, foreground-model change, Fast mapping, permission or approval-policy change is involved.
 
 ### Runtime caches
 

package/bin/cli.mjs

@@ -16,7 +16,7 @@ import { cliCommandName, cliHelp, parseAdapterAddressOptions, parseAdapterProbeO
 import { formatAdapterStatus, readAdapterStatus } from "../src/cli-status.mjs";
 import { closeHttpServer } from "../src/shutdown.mjs";
 import { runAutoReviewModelCommand } from "../src/auto-review-model.mjs";
-import { autoReviewModelPreference, responseHistoryLimitPreference, terminalAnimationPreference } from "../src/user-settings.mjs";
+import { autoReviewModelPreference, autoReviewPreference, responseHistoryLimitPreference, terminalAnimationPreference } from "../src/user-settings.mjs";
 import { fetchLiveCopilotModels, formatLiveCopilotModels } from "../src/cli-models.mjs";
 import { runAuthCommand } from "../src/cli-auth.mjs";
 import { createProfileRuntime } from "../src/profile-runtime.mjs";
@@ -340,7 +340,7 @@ try {
   const terminalAnimationTheme = terminalAnimationPreference().theme;
   const codexModelCatalog = createCodexModelCatalog();
   activeServer = await startAdapter(ADAPTER_PORT, ADAPTER_HOST, {
-    autoReviewModelResolver: () => autoReviewModelPreference().model,
+    autoReviewModelResolver: () => autoReviewPreference(),
     codexClient: profileRuntime.codexClient,
     codexModelCatalog,
     codexModelRegistry: profileModels.codexRegistry,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-copilot-dx",
-  "version": "0.9.12",
+  "version": "0.9.13",
   "description": "Use Codex App with GitHub Copilot",
   "author": "Dale Xiao",
   "type": "module",

package/src/auto-review-model.mjs

@@ -3,12 +3,13 @@ import { createInterface } from "node:readline/promises";
 import { loadModelCache } from "./model-cache.mjs";
 import {
   DEFAULT_CODEX_AUTO_REVIEW_MODEL,
+  autoReviewReasoningEfforts,
   responsesModelIdsFromCopilotModels,
 } from "./models.mjs";
 import { parseAdapterProbeOptions } from "./cli-options.mjs";
 import { adapterBaseUrl } from "./running-adapter.mjs";
 import {
-  autoReviewModelPreference,
+  autoReviewPreference,
   readUserSettings,
   writeAutoReviewModel,
 } from "./user-settings.mjs";
@@ -28,6 +29,13 @@ function sortedModelIds(modelIds, currentModel) {
   });
 }
 
+function catalogReasoningEfforts(models, modelIds) {
+  const data = Array.isArray(models) ? models : models?.data;
+  return Object.fromEntries(modelIds.map((id) => [id,
+    autoReviewReasoningEfforts(data?.find((model) => String(model?.id || "").trim() === id)),
+  ]));
+}
+
 export async function loadAutoReviewModelCatalog({
   env = process.env,
   fetchImpl = fetch,
@@ -52,7 +60,8 @@ export async function loadAutoReviewModelCatalog({
       const modelIds = responsesModelIdsFromCopilotModels(models);
       if (modelIds.length) {
         const fallback = response.headers.get("X-CCDX-Model-Source") === "last-known-good";
-        return { modelIds, source: fallback ? "running adapter cache" : "running adapter" };
+        return { modelIds, reasoningEfforts: catalogReasoningEfforts(models, modelIds),
+          source: fallback ? "running adapter cache" : "running adapter" };
       }
       liveError = "adapter returned no selectable Responses models";
     }
@@ -66,7 +75,7 @@ export async function loadAutoReviewModelCatalog({
 
   const cached = loadModelCacheFn({ home });
   const modelIds = responsesModelIdsFromCopilotModels(cached);
-  if (modelIds.length) return { modelIds, source: "local model cache" };
+  if (modelIds.length) return { modelIds, reasoningEfforts: catalogReasoningEfforts(cached, modelIds), source: "local model cache" };
   throw new Error(`No selectable Responses models are available (${liveError}). Start ccdx once to refresh the model list.`);
 }
 
@@ -85,13 +94,14 @@ export async function runAutoReviewModelCommand({
   }
 
   readUserSettings({ env, home, strict: true });
-  const current = autoReviewModelPreference({ env, home });
+  const current = autoReviewPreference({ env, home });
   const catalog = await loadCatalog({ env, fetchImpl, home });
   const modelIds = sortedModelIds(catalog.modelIds, current.model);
   if (!modelIds.length) throw new Error("No selectable Responses models are available");
 
   output.write(`${commandName} auto-review-model\n`);
   output.write(`Current: ${current.model} (${current.source})\n`);
+  output.write(`Reasoning: ${current.reasoningEffort || "follow client (low when omitted)"}\n`);
   output.write(`Responses models from ${catalog.source}:\n`);
   modelIds.forEach((model, index) => {
     const markers = [];
@@ -111,6 +121,7 @@ export async function runAutoReviewModelCommand({
   });
 
   let selectedModel;
+  let selectedEffort;
   try {
     while (!selectedModel) {
       const answer = String(await ask(`Select a model [${defaultIndex + 1}], or q to cancel: `) || "").trim();
@@ -125,17 +136,45 @@ export async function runAutoReviewModelCommand({
         output.write(`Enter a number from 1 to ${modelIds.length}, or q to cancel.\n`);
       }
     }
+    const efforts = catalog.reasoningEfforts?.[selectedModel] || [];
+    const choices = [null, ...efforts];
+    const currentEffort = selectedModel === current.model ? current.reasoningEffort : undefined;
+    const effortIndex = selectedModel === current.model && current.reasoningEffort === null
+      ? 0 : currentEffort ? efforts.indexOf(currentEffort) + 1 : efforts.indexOf("low") + 1;
+    output.write(`Reasoning for ${selectedModel}:\n`);
+    output.write("  0. Follow client (low when omitted)\n");
+    efforts.forEach((effort, index) => {
+      const markers = [];
+      if (effort === currentEffort) markers.push("current");
+      if (effort === "low") markers.push("default");
+      output.write(`  ${index + 1}. ${effort}${markers.length ? ` [${markers.join(", ")}]` : ""}\n`);
+    });
+    if (!efforts.length) output.write("No reasoning efforts are advertised; no override will be set.\n");
+    while (selectedEffort === undefined) {
+      const answer = String(await ask(`Select reasoning [${effortIndex}], or q to cancel: `) || "").trim();
+      if (["q", "quit"].includes(answer.toLowerCase())) {
+        output.write("No changes made.\n");
+        return { changed: false, cancelled: true, model: current.model };
+      }
+      const selectedIndex = answer === "" ? effortIndex : Number(answer);
+      if (Number.isInteger(selectedIndex) && selectedIndex >= 0 && selectedIndex < choices.length) {
+        selectedEffort = choices[selectedIndex];
+      } else {
+        output.write(`Enter a number from 0 to ${efforts.length}, or q to cancel.\n`);
+      }
+    }
   } finally {
     readline?.close();
   }
 
   const savedModel = selectedModel === DEFAULT_CODEX_AUTO_REVIEW_MODEL ? "" : selectedModel;
-  const result = writeAutoReviewModel(savedModel, { env, home });
+  const result = writeAutoReviewModel(savedModel, { env, home, reasoningEffort: selectedEffort });
   output.write(`${result.changed ? "Saved" : "Kept"} Auto Review model: ${selectedModel}\n`);
+  output.write(`Reasoning: ${selectedEffort || "follow client (low when omitted)"}\n`);
   if (String(env.CCDX_AUTO_REVIEW_MODEL || "").trim()) {
-    output.write(`CCDX_AUTO_REVIEW_MODEL=${current.model} remains the effective override until it is unset.\n`);
+    output.write(`CCDX_AUTO_REVIEW_MODEL=${current.model} remains the effective override until it is unset. Reasoning is bound to ${selectedModel}.\n`);
   } else {
-    output.write("The running adapter will use this model on the next Auto Review request.\n");
+    output.write("The running adapter will use this model on the next Auto Review request. Reasoning selection requires an adapter running 0.9.13 or newer.\n");
   }
-  return { ...result, cancelled: false, model: selectedModel };
+  return { ...result, cancelled: false, model: selectedModel, reasoningEffort: selectedEffort };
 }

package/src/cli-options.mjs

@@ -355,7 +355,7 @@ function topicHelp(name, topic) {
     "enable-image": `Usage:\n  ${name} enable-image\n\nInteractively configures an HTTPS image API endpoint (base URLs are also accepted) and API key, detects its supported image model and protocol, installs CCDX image guidance, and checks the local image tool for Codex App without generating an image. A blank key preserves the saved key only for the same origin; a new origin requires explicit key entry. Concurrent unrelated config edits are preserved.`,
     "disable-image": `Usage:\n  ${name} disable-image\n\nDisables the local CCDX image tool and removes its stored API credential and unmodified CCDX image guidance.`,
     "image-status": `Usage:\n  ${name} image-status\n\nShows provider configuration and probes local image-tool readiness without generating an image or exposing its API key.`,
-    "auto-review-model": `Usage:\n  ${name} auto-review-model\n\nInteractively selects an advertised Responses model for Codex Auto-review.`,
+    "auto-review-model": `Usage:\n  ${name} auto-review-model\n\nSelect a Responses model, then an advertised reasoning effort. Enter keeps the default/current choice; q cancels both steps without saving. Effort 0 follows the client (low when omitted). Settings apply only to Auto-review on the next request; no client patch or restart is required for adapters running 0.9.13 or newer.`,
     update: `Usage:\n  ${name} update [npm|github]\n\nUpdates the global package from the configured npm registry or GitHub main. With no source, an interactive terminal prompts for one.`,
     version: `Usage:\n  ${name} --version`,
   };
@@ -398,7 +398,7 @@ Commands:
   enable-image       Configure and enable the optional image provider
   disable-image      Disable the image provider and remove its credential
   image-status       Show the optional image provider status
-  auto-review-model  Select the Codex Auto-review Responses model
+  auto-review-model  Select the Codex Auto-review model and reasoning effort
   update             Update the global package from npm or GitHub
 
 Run ${name} <command> --help for command details.`;

package/src/models.mjs

@@ -1,6 +1,16 @@
 export const CODEX_AUTO_REVIEW_MODEL = "codex-auto-review";
 export const DEFAULT_CODEX_AUTO_REVIEW_MODEL = "gpt-6.1-sol";
 export const CODEX_GPT6_MODEL = "gpt-6-astra";
+export const AUTO_REVIEW_REASONING_EFFORTS = ["low", "medium", "high", "xhigh", "max", "minimal", "none"];
+
+export function autoReviewReasoningEfforts(model) {
+  const advertised = model?.capabilities?.supports?.reasoning_effort;
+  const supported = new Set(Array.isArray(advertised) ? advertised : []);
+  const id = String(model?.id || "").trim();
+  const gpt61Sol = id === "gpt-6.1-sol" || id === "gpt-6.1-sol-fast";
+  return AUTO_REVIEW_REASONING_EFFORTS.filter((effort) => supported.has(effort)
+    && !(gpt61Sol && ["none", "minimal"].includes(effort)));
+}
 
 function hasOpenAIEndpoint(model) {
   const endpoints = Array.isArray(model?.supported_endpoints) ? model.supported_endpoints : [];

package/src/responses-handler.mjs

@@ -90,10 +90,13 @@ function unsupportedCustomToolsError(model) {
 }
 
 function resolveRequestModel(model, openAIModelEnv, autoReviewModelResolver) {
-  const options = model === CODEX_AUTO_REVIEW_MODEL && typeof autoReviewModelResolver === "function"
-    ? { autoReviewModel: autoReviewModelResolver() }
-    : {};
-  return resolveOpenAIModel(model, openAIModelEnv, options);
+  const preference = model === CODEX_AUTO_REVIEW_MODEL && typeof autoReviewModelResolver === "function"
+    ? autoReviewModelResolver() : undefined;
+  const resolved = resolveOpenAIModel(model, openAIModelEnv, {
+    autoReviewModel: typeof preference === "string" ? preference : preference?.model,
+  });
+  return { ...resolved, reasoningEffort: preference?.model === resolved.upstreamModel
+    ? preference.reasoningEffort : undefined };
 }
 
 function stripUnsupportedGpt6ServiceTier(body, requestedModel, upstreamModel, priorityTierModel) {
@@ -274,8 +277,8 @@ export function createResponsesHandler(options) {
       stripUnsupportedGpt6ServiceTier(prepared.body, requestedModel, upstreamModel, priorityTierModel);
       if (requestedModel === CODEX_AUTO_REVIEW_MODEL) {
         delete prepared.body.service_tier;
-        if (prepared.body.reasoning?.effort === undefined) {
-          prepared.body.reasoning = { ...prepared.body.reasoning, effort: "low" };
+        if (resolvedModel.reasoningEffort || prepared.body.reasoning?.effort === undefined) {
+          prepared.body.reasoning = { ...prepared.body.reasoning, effort: resolvedModel.reasoningEffort || "low" };
         }
       }
       if (upstreamModel !== requestedModel) prepared.body.model = upstreamModel;
@@ -544,8 +547,8 @@ export function createResponsesCompactHandler(options) {
       stripUnsupportedGpt6ServiceTier(prepared.body, requestedModel, upstreamModel, priorityTierModel);
       if (requestedModel === CODEX_AUTO_REVIEW_MODEL) {
         delete prepared.body.service_tier;
-        if (prepared.body.reasoning?.effort === undefined) {
-          prepared.body.reasoning = { ...prepared.body.reasoning, effort: "low" };
+        if (resolvedModel.reasoningEffort || prepared.body.reasoning?.effort === undefined) {
+          prepared.body.reasoning = { ...prepared.body.reasoning, effort: resolvedModel.reasoningEffort || "low" };
         }
       }
       if (upstreamModel !== requestedModel) prepared.body.model = upstreamModel;

package/src/user-settings.mjs

@@ -2,7 +2,7 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { atomicWriteFileIfChangedSync } from "./atomic-file.mjs";
-import { DEFAULT_CODEX_AUTO_REVIEW_MODEL } from "./models.mjs";
+import { AUTO_REVIEW_REASONING_EFFORTS, DEFAULT_CODEX_AUTO_REVIEW_MODEL } from "./models.mjs";
 import { loadRuntimeConfig, RUNTIME_DEFAULTS } from "./runtime-config.mjs";
 import {
   MIB,
@@ -17,6 +17,7 @@ import {
 } from "./terminal-animation.mjs";
 
 const AUTO_REVIEW_MODEL_KEY = "auto_review_model";
+const AUTO_REVIEW_REASONING_KEY = "auto_review_reasoning";
 const TERMINAL_ANIMATION_KEY = "terminal_animation";
 const RESPONSE_HISTORY_MAX_MIB_KEY = "response_history_max_mib";
 const DECODED_BODY_LIMIT_MIB_KEY = "decoded_body_limit_mib";
@@ -47,6 +48,15 @@ export function readUserSettings({ env = process.env, home = os.homedir(), stric
         throw invalidSettings(filePath, `${AUTO_REVIEW_MODEL_KEY} must be a non-empty string`);
       }
     }
+    if (Object.hasOwn(parsed, AUTO_REVIEW_REASONING_KEY)) {
+      const value = parsed[AUTO_REVIEW_REASONING_KEY];
+      if (!value || typeof value !== "object" || Array.isArray(value)
+        || typeof value.model !== "string" || !value.model.trim()
+        || !(value.effort === null || AUTO_REVIEW_REASONING_EFFORTS.includes(value.effort))) {
+        if (strict) throw invalidSettings(filePath, `${AUTO_REVIEW_REASONING_KEY} must contain a model and valid effort`);
+        delete parsed[AUTO_REVIEW_REASONING_KEY];
+      }
+    }
     if (Object.hasOwn(parsed, TERMINAL_ANIMATION_KEY)) {
       const value = parsed[TERMINAL_ANIMATION_KEY];
       // Accept the retired value on read so upgrades can fall back and select a replacement.
@@ -97,12 +107,18 @@ export function savedAutoReviewModel(options = {}) {
 }
 
 export function autoReviewModelPreference({ env = process.env, home = os.homedir() } = {}) {
-  const environmentModel = String(env.CCDX_AUTO_REVIEW_MODEL || "").trim();
-  if (environmentModel) return { model: environmentModel, source: "environment" };
+  const { model, source } = autoReviewPreference({ env, home });
+  return { model, source };
+}
 
-  const savedModel = savedAutoReviewModel({ env, home });
-  if (savedModel) return { model: savedModel, source: "settings" };
-  return { model: DEFAULT_CODEX_AUTO_REVIEW_MODEL, source: "default" };
+export function autoReviewPreference({ env = process.env, home = os.homedir() } = {}) {
+  const settings = readUserSettings({ env, home });
+  const environmentModel = String(env.CCDX_AUTO_REVIEW_MODEL || "").trim();
+  const savedModel = String(settings[AUTO_REVIEW_MODEL_KEY] || "").trim();
+  const model = environmentModel || savedModel || DEFAULT_CODEX_AUTO_REVIEW_MODEL;
+  const source = environmentModel ? "environment" : savedModel ? "settings" : "default";
+  const reasoning = settings[AUTO_REVIEW_REASONING_KEY];
+  return { model, source, reasoningEffort: reasoning?.model === model ? reasoning.effort : undefined };
 }
 
 export function savedTerminalAnimationTheme(options = {}) {
@@ -183,13 +199,22 @@ export function writeResponseHistoryLimitMib(mib, { env = process.env, home = os
   return { changed, filePath, ...responseHistoryLimitPreference({ env, home }) };
 }
 
-export function writeAutoReviewModel(model, { env = process.env, home = os.homedir() } = {}) {
+export function writeAutoReviewModel(model, { env = process.env, home = os.homedir(), reasoningEffort } = {}) {
+  if (reasoningEffort !== undefined && reasoningEffort !== null
+    && !AUTO_REVIEW_REASONING_EFFORTS.includes(reasoningEffort)) {
+    throw new Error("Auto-review reasoning effort is invalid");
+  }
   const filePath = userSettingsPath({ env, home });
   const settings = readUserSettings({ env, home, strict: true });
   const value = String(model || "").trim();
   const next = { ...settings };
   if (value) next[AUTO_REVIEW_MODEL_KEY] = value;
   else delete next[AUTO_REVIEW_MODEL_KEY];
+  const selectedModel = value || DEFAULT_CODEX_AUTO_REVIEW_MODEL;
+  if (reasoningEffort !== undefined) next[AUTO_REVIEW_REASONING_KEY] = { model: selectedModel, effort: reasoningEffort };
+  else if (next[AUTO_REVIEW_REASONING_KEY]?.model !== selectedModel) {
+    delete next[AUTO_REVIEW_REASONING_KEY];
+  }
 
   const changed = atomicWriteFileIfChangedSync(filePath, `${JSON.stringify(next, null, 2)}\n`, { mode: 0o600 });
   return { changed, filePath, model: value || DEFAULT_CODEX_AUTO_REVIEW_MODEL };