codex-copilot-dx 0.5.4 → 0.5.6

package/README.md

@@ -33,6 +33,21 @@ global install, use `npx codex-copilot-dx@latest`.
 Both installed commands expose the same options and subcommands; help, version,
 doctor, status, and argument-error output use the command name that was invoked.
 
+To query the models currently advertised as selectable for the saved Copilot
+account, run:
+
+```bash
+ccdx models
+```
+
+This performs a fresh, read-only GitHub Copilot model-directory lookup without
+starting the adapter, opening device login, reading the local model cache, or
+consuming an inference request. It lists model IDs by provider with their
+advertised API capabilities and reports the live Claude/Anthropic count. A model
+being advertised does not guarantee that a later inference request will avoid
+quota, rate-limit, or policy enforcement. `codex-copilot-dx models` is fully
+equivalent.
+
 To change the model used by Codex Auto-review, run:
 
 ```bash
@@ -60,6 +75,8 @@ ccdx update npm
 ccdx update github
 ```
 
+`ccdx update gh` is accepted as a shorthand for the GitHub source.
+
 The npm source installs `codex-copilot-dx@latest` through the registry already
 configured for npm, including a company mirror. The GitHub source installs the
 latest commit from `DaleXiao/codex-copilot-dx` `main` and opts in to Git fetching
@@ -68,6 +85,8 @@ for that command, as required by npm 12. It does not change npm's persistent
 interpolation. A currently running adapter keeps its loaded version until it is
 stopped and started again. The
 `codex-copilot-dx update` compatibility command behaves identically.
+If a configured npm mirror has not synchronized the current release yet, use
+the GitHub source to install the current `main` revision.
 
 On first run, it will:
 1. Authenticate with GitHub via device flow (if needed), after first trying compatible local Copilot token sources
@@ -194,7 +213,9 @@ Environment variables:
 | `CCDX_IMG_CACHE_MAX_BYTES` | `67108864` | Process-local byte ceiling for cached image optimization results; set to `0` to disable result caching |
 | `CCDX_DISABLE_IMG_OPT` | unset | Set to `1` to disable image optimization |
 | `CCDX_CONFIGURE_CLAUDE_DESKTOP` | unset | Set to `1` to write the Claude App 3P gateway profile during startup |
+| `CCDX_AUTO_LAUNCH` | enabled | Set to `0`, `false`, `no`, or `off` to start the adapter without opening Codex or ChatGPT |
 | `CCDX_CLAUDE_DESKTOP_API_KEY` | managed profile or generated for opt-in setup | Explicit bearer key written into the Claude App profile and recognized by the adapter for model discovery |
+| `CCDX_PROXY_API_KEY` | unset | Backward-compatible alias for `CCDX_CLAUDE_DESKTOP_API_KEY`; the Claude-specific variable takes precedence |
 | `CCDX_CLAUDE_MODEL_ALIASES` | built-in Claude aliases | Comma-separated Desktop-to-upstream aliases, for example `claude-sonnet-4-6=claude-sonnet-4.6` |
 | `CCDX_GITHUB_TOKEN` | unset | Explicit GitHub Copilot OAuth token to validate and import before device login |
 | `CCDX_GITHUB_TOKEN_PATH` | unset | Explicit file containing a GitHub Copilot OAuth token to validate and import before device login |
@@ -204,6 +225,7 @@ Environment variables:
 | `CCDX_TOKEN_LOCK_TIMEOUT_MS` | `600000` | Maximum time to wait for another local process to finish GitHub token login/import |
 | `CCDX_TOKEN_LOCK_STALE_MS` | `900000` | Age after which a stale GitHub token lock file can be removed |
 | `CCDX_EXISTING_ADAPTER_TIMEOUT_MS` | `500` | Timeout for detecting an already-running local adapter during startup |
+| `CCDX_MODEL_REFRESH_TIMEOUT_MS` | `5000` | Timeout for a Copilot model metadata refresh or live Auto-review model lookup |
 | `CCDX_MODEL_REFRESH_INTERVAL_MS` | `7200000` | Interval for refreshing Copilot model metadata; successful lists are cached locally as last-known-good data |
 | `CCDX_RESPONSE_HISTORY_MAX_BYTES` | `67108864` | Total in-memory byte budget for locally expanded Responses history |
 | `CCDX_RESPONSE_HISTORY_MAX_ENTRIES` | `4096` | Maximum stored incremental Responses history nodes |
@@ -216,14 +238,14 @@ Environment variables:
 
 The adapter records token usage metadata to `~/.local/share/codex-copilot-dx/usage.jsonl` when upstream responses include usage fields. It logs counts, model names, API surface, and response IDs only; it does not log prompts, completions, tool arguments, or image content.
 
-### Debug logging
-
-Set `CCDX_LOG_PATH=1` to mirror terminal logs to `~/.local/share/codex-copilot-dx/debug.log`, or set `CCDX_LOG_PATH` to a custom file. Add `CCDX_LOG_LEVEL=debug` to include upstream request attempts, retry causes, status codes, and timings. Debug logs do not include prompts, completions, request bodies, or authorization tokens.
-
 ```bash
 ccdx usage
 ```
 
+### Debug logging
+
+Set `CCDX_LOG_PATH=1` to mirror terminal logs to `~/.local/share/codex-copilot-dx/debug.log`, or set `CCDX_LOG_PATH` to a custom file. Add `CCDX_LOG_LEVEL=debug` to include upstream request attempts, retry causes, status codes, and timings. Debug logs do not include prompts, completions, request bodies, or authorization tokens.
+
 ### Image optimization
 
 Long computer-use sessions can accumulate screenshots inside the conversation history. Each screenshot is shipped on later turns, and GitHub Copilot's `/responses` endpoint can reject oversized requests with `408 Request Timeout` while reading the body or `413 Payload Too Large`.

package/bin/cli.mjs

@@ -21,6 +21,7 @@ import { formatAdapterStatus, readAdapterStatus } from "../src/cli-status.mjs";
 import { closeHttpServer } from "../src/shutdown.mjs";
 import { runAutoReviewModelCommand } from "../src/auto-review-model.mjs";
 import { autoReviewModelPreference } from "../src/user-settings.mjs";
+import { fetchLiveCopilotModels, formatLiveCopilotModels } from "../src/cli-models.mjs";
 
 const LOCAL_VERSION = localPackageVersion();
 const CLI_NAME = cliCommandName();
@@ -68,6 +69,16 @@ if (CLI.command === "status") {
     process.exit(1);
   }
 }
+if (CLI.command === "models") {
+  try {
+    const catalog = await fetchLiveCopilotModels();
+    console.log(formatLiveCopilotModels(catalog, { commandName: CLI_NAME }));
+    process.exit(0);
+  } catch (e) {
+    console.error(status("err", e.message));
+    process.exit(1);
+  }
+}
 if (CLI.command === "auto-review-model") {
   try {
     await runAutoReviewModelCommand({ commandName: CLI_NAME });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-copilot-dx",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "description": "Use Codex Desktop, Claude Code, and Claude App with GitHub Copilot",
   "author": "Dale Xiao",
   "type": "module",

package/src/cli-models.mjs

@@ -0,0 +1,164 @@
+import fs from "node:fs";
+import os from "node:os";
+import { githubTokenPath, validateGithubToken } from "./auth.mjs";
+import { buildHeaders, DEFAULT_API_BASE, FALLBACK_VSCODE_VERSION } from "./copilot.mjs";
+import { status } from "./status.mjs";
+
+const DEFAULT_MODELS_TIMEOUT_MS = 10000;
+const SUPPORTED_ENDPOINTS = [
+  ["responses", new Set(["/responses", "/v1/responses"])],
+  ["chat", new Set(["/chat/completions"])],
+  ["messages", new Set(["/v1/messages"])],
+];
+
+function safeText(value, fallback = "") {
+  const text = String(value ?? "")
+    .replace(/[\u0000-\u001f\u007f-\u009f]/g, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+  return text || fallback;
+}
+
+function endpointLabels(model) {
+  const advertised = new Set(Array.isArray(model?.supported_endpoints) ? model.supported_endpoints : []);
+  return SUPPORTED_ENDPOINTS
+    .filter(([, values]) => [...values].some((value) => advertised.has(value)))
+    .map(([label]) => label);
+}
+
+export function selectableCopilotModels(payload) {
+  const data = Array.isArray(payload) ? payload : payload?.data;
+  if (!Array.isArray(data)) throw new Error("Copilot models response contained no model list");
+
+  const models = [];
+  const seen = new Set();
+  for (const model of data) {
+    if (model?.model_picker_enabled !== true) continue;
+    const policyState = safeText(model?.policy?.state).toLowerCase();
+    if (policyState && policyState !== "enabled") continue;
+    const capabilityType = safeText(model?.capabilities?.type).toLowerCase();
+    if (capabilityType && capabilityType !== "chat") continue;
+
+    const id = safeText(model?.id);
+    const endpoints = endpointLabels(model);
+    if (!id || id === "codex-auto-review" || !endpoints.length || seen.has(id)) continue;
+    seen.add(id);
+    models.push({
+      id,
+      vendor: safeText(model?.vendor || model?.owned_by, "Unknown"),
+      endpoints,
+      preview: model?.preview === true,
+    });
+  }
+
+  models.sort((left, right) => left.vendor.localeCompare(right.vendor, "en")
+    || left.id.localeCompare(right.id, "en"));
+  return { advertised: data.length, models };
+}
+
+function validationFailure(validation) {
+  const httpStatus = validation?.status ? ` (HTTP ${validation.status})` : "";
+  return `GitHub Copilot authentication failed: ${validation?.reason || "unknown error"}${httpStatus}`;
+}
+
+async function responseText(response) {
+  try {
+    return await response.text();
+  } catch {
+    return "";
+  }
+}
+
+export async function fetchLiveCopilotModels({
+  home = os.homedir(),
+  fetchImpl = fetch,
+  timeoutMs = DEFAULT_MODELS_TIMEOUT_MS,
+  vscodeVersion = FALLBACK_VSCODE_VERSION,
+} = {}) {
+  const tokenPath = githubTokenPath(home);
+  let githubToken;
+  try {
+    githubToken = fs.readFileSync(tokenPath, "utf8").trim();
+  } catch (error) {
+    if (error?.code === "ENOENT") throw new Error("GitHub token not found. Start ccdx once to log in.");
+    throw new Error(`Could not read the GitHub token: ${error.message}`);
+  }
+  if (!githubToken) throw new Error("GitHub token file is empty. Start ccdx again to log in.");
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const validation = await validateGithubToken(githubToken, {
+      fetchImpl,
+      signal: controller.signal,
+    });
+    if (controller.signal.aborted) throw new Error(`Live model lookup timed out after ${timeoutMs}ms`);
+    if (!validation.ok) throw new Error(validationFailure(validation));
+
+    const tokenData = validation.copilotTokenData;
+    const apiBase = tokenData.endpoints?.api || DEFAULT_API_BASE;
+    const headers = buildHeaders({
+      token: tokenData.token,
+      version: vscodeVersion,
+      initiator: "user",
+      vision: false,
+    });
+    const response = await fetchImpl(`${apiBase}/models`, {
+      headers,
+      redirect: "error",
+      signal: controller.signal,
+    });
+    const body = await responseText(response);
+    if (!response.ok) {
+      const detail = safeText(body).slice(0, 240);
+      throw new Error(`Copilot models endpoint returned HTTP ${response.status}${detail ? `: ${detail}` : ""}`);
+    }
+
+    let payload;
+    try {
+      payload = JSON.parse(body);
+    } catch {
+      throw new Error("Copilot models endpoint returned invalid JSON");
+    }
+    const catalog = selectableCopilotModels(payload);
+    let upstreamHost = "GitHub Copilot";
+    try { upstreamHost = new URL(apiBase).hostname; } catch {}
+    return { ...catalog, upstreamHost: safeText(upstreamHost, "GitHub Copilot") };
+  } catch (error) {
+    if (controller.signal.aborted && !/timed out/.test(error?.message || "")) {
+      throw new Error(`Live model lookup timed out after ${timeoutMs}ms`);
+    }
+    throw error;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+export function formatLiveCopilotModels(catalog, { commandName = "ccdx" } = {}) {
+  const models = Array.isArray(catalog?.models) ? catalog.models : [];
+  const responses = models.filter((model) => model.endpoints.includes("responses")).length;
+  const chat = models.filter((model) => model.endpoints.includes("chat")).length;
+  const claude = models.filter((model) => model.id.toLowerCase().startsWith("claude-")
+    || model.vendor.toLowerCase() === "anthropic").length;
+  const lines = [
+    `${commandName} models`,
+    status("ok", `Live catalog from ${safeText(catalog?.upstreamHost, "GitHub Copilot")}: ${models.length} selectable of ${Number(catalog?.advertised) || 0} advertised`),
+    status("info", `Responses: ${responses}; Chat: ${chat}; Claude/Anthropic: ${claude}`),
+  ];
+
+  if (!models.length) {
+    lines.push(status("warn", "No selectable models were advertised for this account"));
+    return lines.join("\n");
+  }
+
+  let vendor = "";
+  for (const model of models) {
+    if (model.vendor !== vendor) {
+      vendor = model.vendor;
+      lines.push("", `${vendor}:`);
+    }
+    const flags = [...model.endpoints, ...(model.preview ? ["preview"] : [])];
+    lines.push(`  ${model.id} [${flags.join(", ")}]`);
+  }
+  return lines.join("\n");
+}

package/src/cli-options.mjs

@@ -26,6 +26,10 @@ export function parseCliArgs(args = []) {
     if (rest.length) unexpectedArgs(rest);
     return { command: "usage", configureClaudeDesktop: false, showRequestId: false, online: false, compat: false };
   }
+  if (command === "models") {
+    if (rest.length) unexpectedArgs(rest);
+    return { command: "models", configureClaudeDesktop: false, showRequestId: false, online: false, compat: false };
+  }
   if (command === "auto-review-model") {
     if (rest.length) unexpectedArgs(rest);
     return { command: "auto-review-model", configureClaudeDesktop: false, showRequestId: false, online: false, compat: false };
@@ -125,6 +129,7 @@ export function cliHelp(commandName = "ccdx") {
   ${name} [--configure-claude-desktop] [--show-request-id]
   ${name} doctor [--online] [--compat]
   ${name} status
+  ${name} models
   ${name} usage
   ${name} auto-review-model
   ${name} update [npm|github]