@openhoo/hoopilot 0.5.7 → 0.6.0

package/README.md

@@ -68,7 +68,7 @@ First sign in with GitHub Copilot OAuth in your browser:
 npx @openhoo/hoopilot login
 ```
 
-The login command prints a one-time code, opens `https://github.com/login/device` best-effort, verifies that the returned OAuth token can reach the Copilot API, and stores it in Hoopilot's auth file.
+The login command prints a one-time code, opens `https://github.com/login/device` best-effort, verifies that the returned OAuth token can reach the Copilot API, and stores it in Hoopilot's auth file. Re-run `npx @openhoo/hoopilot login` after upgrading Hoopilot if Copilot reports a supported model as unavailable; older stored tokens can have a reduced model set.
 
 Then start the proxy:
 
@@ -137,7 +137,10 @@ effort with `CODEXX_MODEL_REASONING_EFFORT`.
 `codexx` defaults to `gpt-5.5` with `model_reasoning_effort="xhigh"`. Codex sends
 those requests through its Responses API provider, and Hoopilot forwards them to
 Copilot's Responses endpoint because `gpt-5.5` is not available through Copilot's
-chat-completions endpoint.
+chat-completions endpoint. Before starting Codex, `codexx` checks
+`http://127.0.0.1:4141/v1/models` and reports if the logged-in Copilot account does
+not advertise the requested model. Set `CODEXX_MODEL` to one of the listed models,
+or log in with a Copilot account that has `gpt-5.5`.
 
 If no `HOOPILOT_API_KEY` is configured, Hoopilot accepts local requests without client authentication. Binding to a non-loopback host requires `HOOPILOT_API_KEY` unless `--allow-unauthenticated` is set.
 
@@ -178,7 +181,7 @@ Direct bearer tokens, GitHub CLI token fallback, classic GitHub PATs, and fine-g
 Supported authentication-related settings:
 
 - `HOOPILOT_AUTH_FILE`: OAuth credential store path.
-- `HOOPILOT_GITHUB_CLIENT_ID`: GitHub OAuth app client ID override.
+- `HOOPILOT_GITHUB_CLIENT_ID`: GitHub OAuth app client ID override. The default uses the same GitHub Copilot OAuth app as opencode's Copilot provider.
 - `HOOPILOT_GITHUB_DOMAIN`: GitHub domain override. Default: `github.com`.
 - `COPILOT_API_BASE_URL`: upstream Copilot API base URL override. Default: `https://api.githubcopilot.com`.
 
@@ -210,6 +213,7 @@ If that returns `401 copilot_auth_error`, rerun `npx @openhoo/hoopilot login` an
 ```powershell
 hoopilot [serve] [options]
 hoopilot login [options]
+hoopilot models [options]
 ```
 
 Commands:
@@ -217,6 +221,7 @@ Commands:
 ```txt
 serve                             Start the proxy server (default)
 login                             Sign in through GitHub OAuth in a browser and verify Copilot access
+models                            List available GitHub Copilot model IDs
 update, upgrade                   Update hoopilot to the latest release
 ```
 

package/dist/cli.js

@@ -101,9 +101,64 @@ function trimTrailingSlash(value) {
   return value.replace(/\/+$/, "");
 }
 
+// src/copilot.ts
+var CopilotClient = class {
+  #auth;
+  #fetch;
+  constructor(options = {}) {
+    this.#auth = new CopilotAuth(options);
+    this.#fetch = options.fetch ?? fetch;
+  }
+  async chatCompletions(body, signal) {
+    return this.fetchCopilot("/chat/completions", {
+      body: JSON.stringify(body),
+      headers: {
+        "content-type": "application/json"
+      },
+      method: "POST",
+      signal
+    });
+  }
+  async responses(body, signal) {
+    return this.fetchCopilot("/responses", {
+      body,
+      headers: {
+        "content-type": "application/json"
+      },
+      method: "POST",
+      signal
+    });
+  }
+  async models(signal) {
+    return this.fetchCopilot("/models", {
+      headers: {
+        accept: "application/json"
+      },
+      method: "GET",
+      signal
+    });
+  }
+  async fetchCopilot(path, init) {
+    const access = await this.#auth.getAccess();
+    const headers = new Headers(init.headers);
+    headers.set("accept", headers.get("accept") ?? "application/json");
+    headers.set("authorization", `Bearer ${access.token}`);
+    headers.set("copilot-integration-id", "vscode-chat");
+    headers.set("editor-plugin-version", "hoopilot/0.1.0");
+    headers.set("editor-version", "Hoopilot/0.1.0");
+    headers.set("openai-intent", "conversation-panel");
+    headers.set("user-agent", "hoopilot/0.1.0");
+    headers.set("x-github-api-version", "2026-06-01");
+    return this.#fetch(`${access.apiBaseUrl}${path}`, {
+      ...init,
+      headers
+    });
+  }
+};
+
 // src/github-device.ts
 import { setTimeout as sleep } from "timers/promises";
-var DEFAULT_GITHUB_COPILOT_CLIENT_ID = "Iv23lijnNxm2e9UX3CF8";
+var DEFAULT_GITHUB_COPILOT_CLIENT_ID = "Ov23li8tweQw6odWQebz";
 var DEFAULT_GITHUB_DOMAIN = "github.com";
 var DEVICE_GRANT_TYPE = "urn:ietf:params:oauth:grant-type:device_code";
 var POLLING_SAFETY_MARGIN_MS = 3e3;
@@ -321,61 +376,6 @@ function isLogLevel(value) {
   return LOG_LEVELS.includes(value);
 }
 
-// src/copilot.ts
-var CopilotClient = class {
-  #auth;
-  #fetch;
-  constructor(options = {}) {
-    this.#auth = new CopilotAuth(options);
-    this.#fetch = options.fetch ?? fetch;
-  }
-  async chatCompletions(body, signal) {
-    return this.fetchCopilot("/chat/completions", {
-      body: JSON.stringify(body),
-      headers: {
-        "content-type": "application/json"
-      },
-      method: "POST",
-      signal
-    });
-  }
-  async responses(body, signal) {
-    return this.fetchCopilot("/responses", {
-      body,
-      headers: {
-        "content-type": "application/json"
-      },
-      method: "POST",
-      signal
-    });
-  }
-  async models(signal) {
-    return this.fetchCopilot("/models", {
-      headers: {
-        accept: "application/json"
-      },
-      method: "GET",
-      signal
-    });
-  }
-  async fetchCopilot(path, init) {
-    const access = await this.#auth.getAccess();
-    const headers = new Headers(init.headers);
-    headers.set("accept", headers.get("accept") ?? "application/json");
-    headers.set("authorization", `Bearer ${access.token}`);
-    headers.set("copilot-integration-id", "vscode-chat");
-    headers.set("editor-plugin-version", "hoopilot/0.1.0");
-    headers.set("editor-version", "Hoopilot/0.1.0");
-    headers.set("openai-intent", "conversation-panel");
-    headers.set("user-agent", "hoopilot/0.1.0");
-    headers.set("x-github-api-version", "2026-06-01");
-    return this.#fetch(`${access.apiBaseUrl}${path}`, {
-      ...init,
-      headers
-    });
-  }
-};
-
 // src/openai.ts
 var DEFAULT_MODEL = "gpt-4.1";
 function normalizeChatCompletionRequest(request) {
@@ -1460,6 +1460,20 @@ async function main(argv = Bun.argv.slice(2)) {
     await runLogin(args2);
     return;
   }
+  if (command === "models") {
+    const args2 = withRuntimeEnv(parseArgs(argv.slice(1)));
+    if (args2.help) {
+      console.log(helpText(await getVersion()));
+      return;
+    }
+    args2.logger = createHoopilotLogger({
+      env: args2.env,
+      format: args2.logFormat,
+      level: args2.logLevel
+    }).child({ component: "cli", command: "models" });
+    await runModels(args2);
+    return;
+  }
   const args = withRuntimeEnv(parseArgs(argv));
   if (args.help) {
     console.log(helpText(await getVersion()));
@@ -1585,6 +1599,30 @@ async function runLogin(options = {}) {
   console.log(`Copilot OAuth credential stored at ${path}`);
   console.log("Copilot authentication ready.");
 }
+async function runModels(options = {}) {
+  const logger = options.logger?.child({ component: "models" }) ?? noopLogger;
+  logger.debug({ event: "models.list.started" }, "fetching github copilot models");
+  const response = await new CopilotClient(options).models();
+  if (!response.ok) {
+    const message = `GitHub Copilot API model list failed with ${response.status}: ${await safeResponseText2(response)}`;
+    if (response.status === 401 || response.status === 403) {
+      throw new CopilotAuthError(message);
+    }
+    throw new Error(message);
+  }
+  const ids = modelIdsFromResponse(await response.json().catch(() => void 0));
+  if (ids.length === 0) {
+    throw new Error("GitHub Copilot API returned no model IDs.");
+  }
+  logger.debug(
+    { count: ids.length, event: "models.list.succeeded" },
+    "github copilot models fetched"
+  );
+  for (const id of ids) {
+    console.log(id);
+  }
+  return ids;
+}
 async function verifyCopilotOAuthToken(token, options = {}) {
   const apiBaseUrl = trimTrailingSlash2(
     options.copilotApiBaseUrl ?? options.env?.COPILOT_API_BASE_URL ?? DEFAULT_COPILOT_API_BASE_URL2
@@ -1640,6 +1678,24 @@ async function safeResponseText2(response) {
 function trimTrailingSlash2(value) {
   return value.replace(/\/+$/, "");
 }
+function modelIdsFromResponse(body) {
+  const record = asRecord2(body);
+  const data = Array.isArray(record.data) ? record.data : Array.isArray(body) ? body : [];
+  const seen = /* @__PURE__ */ new Set();
+  const ids = [];
+  for (const model of data) {
+    const id = asRecord2(model).id;
+    if (typeof id !== "string" || id.length === 0 || seen.has(id)) {
+      continue;
+    }
+    seen.add(id);
+    ids.push(id);
+  }
+  return ids;
+}
+function asRecord2(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
 function withRuntimeEnv(args) {
   return { ...args, env: process.env };
 }
@@ -1651,12 +1707,14 @@ OpenAI-compatible proxy for GitHub Copilot.
 Usage:
   hoopilot [serve] [options]
   hoopilot login [options]
+  hoopilot models [options]
   hoopilot update
   npx @openhoo/hoopilot [options]
 
 Commands:
   serve                             Start the proxy server (default)
   login                             Sign in through GitHub OAuth in a browser and verify Copilot access
+  models                            List available GitHub Copilot model IDs
   update, upgrade                   Update hoopilot to the latest release
 
 Options:
@@ -1692,6 +1750,7 @@ if (import.meta.main) {
 export {
   main,
   parseArgs,
+  runModels,
   verifyCopilotOAuthToken
 };
 //# sourceMappingURL=cli.js.map