@auroraflow/code 0.0.14 → 0.0.16

package/bin/aurora-claude.js

@@ -1,4 +1,9 @@
 #!/usr/bin/env node
 import { runAuroraClaude } from "../packages/cli/src/index.js";
 
-await runAuroraClaude(process.argv.slice(2));
+try {
+  await runAuroraClaude(process.argv.slice(2));
+} catch (error) {
+  console.error(`Aurora Claude error: ${error?.message || error}`);
+  process.exit(1);
+}

package/bin/aurora-codex.js

@@ -1,4 +1,9 @@
 #!/usr/bin/env node
 import { runAuroraCodex } from "../packages/cli/src/index.js";
 
-await runAuroraCodex(process.argv.slice(2));
+try {
+  await runAuroraCodex(process.argv.slice(2));
+} catch (error) {
+  console.error(`Aurora Codex error: ${error?.message || error}`);
+  process.exit(1);
+}

package/bin/aurora-postinstall.js

@@ -1,13 +1,16 @@
 #!/usr/bin/env node
 import { installOfficialClients, isGlobalNpmLifecycle, officialClientStatuses } from "../packages/clients/src/index.js";
 
-if (!process.env.AURORA_SKIP_OFFICIAL_CLIENT_INSTALL && isGlobalNpmLifecycle()) {
+if (process.env.AURORA_INSTALL_OFFICIAL_CLIENTS === "1" && isGlobalNpmLifecycle()) {
   try {
     await installOfficialClients();
   } catch (error) {
     console.error(`[aurora-code] official client install failed: ${error.message}`);
     console.error("[aurora-code] run `aurora install-clients` after installation.");
   }
+} else if (isGlobalNpmLifecycle()) {
+  console.error("[aurora-code] installed Aurora launcher. Official Claude/Codex clients are not auto-installed.");
+  console.error("[aurora-code] run `aurora install-clients`, or install only what you need: `npm install -g @openai/codex@latest`.");
 }
 
 const statuses = officialClientStatuses();

package/bin/aurora.js

@@ -1,4 +1,9 @@
 #!/usr/bin/env node
 import { runAuroraCLI } from "../packages/cli/src/index.js";
 
-await runAuroraCLI(process.argv.slice(2));
+try {
+  await runAuroraCLI(process.argv.slice(2));
+} catch (error) {
+  console.error(`Aurora error: ${error?.message || error}`);
+  process.exit(1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auroraflow/code",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "type": "module",
   "description": "Aurora launcher and sidecar for official Codex and Claude Code clients.",
   "repository": {

package/packages/clients/src/index.js

@@ -8,6 +8,7 @@ import { ensureSidecarRunning } from "../../service/src/index.js";
 
 const here = dirname(fileURLToPath(import.meta.url));
 const packageRoot = resolve(here, "..", "..", "..");
+const CODEX_MODEL_CATALOG_TIMEOUT_MS = 30000;
 
 const OFFICIAL_CLIENTS = {
   claude: {
@@ -23,10 +24,11 @@ const OFFICIAL_CLIENTS = {
 };
 
 export async function createClientLaunchSpec(client, args = []) {
-  const sidecar = await ensureSidecarRunning();
+  const command = officialClientBin(client);
   const state = await readState();
   const model = selectedModelAlias(state);
   const key = selectedKey(state);
+  const sidecar = await ensureSidecarRunning();
   if (client === "claude") {
     const env = {
       ...process.env,
@@ -42,7 +44,7 @@ export async function createClientLaunchSpec(client, args = []) {
       DISABLE_AUTOUPDATER: "1"
     };
     env.ANTHROPIC_MODEL = model;
-    return { command: officialClientBin("claude"), args, env };
+    return { command, args, env };
   }
   await writeCodexRuntimeFiles({ sidecar, model, key });
   const env = {
@@ -53,7 +55,7 @@ export async function createClientLaunchSpec(client, args = []) {
     OPENAI_BASE_URL: `${sidecar.baseURL}/v1`
   };
   env.OPENAI_MODEL = model;
-  return { command: officialClientBin("codex"), args, env };
+  return { command, args, env };
 }
 
 export async function runClient(client, args = []) {
@@ -82,9 +84,9 @@ export async function updateOfficialClients() {
 }
 
 export async function installOfficialClients() {
-  const npm = process.env.npm_execpath || "npm";
+  const npm = npmCommandSpec();
   const args = ["install", "-g", "@anthropic-ai/claude-code@latest", "@openai/codex@latest"];
-  await spawnAndWait(npm, args, { ...process.env });
+  await spawnAndWait(npm.command, [...npm.args, ...args], { ...process.env });
 }
 
 export function isGlobalNpmLifecycle() {
@@ -170,13 +172,18 @@ stream_idle_timeout_ms = 300000
 
 async function writeCodexModelCatalog(sidecar, modelCatalogPath) {
   const clientVersion = "0.137.0";
-  const response = await fetch(
-    `${sidecar.baseURL}/v1/models?client_version=${encodeURIComponent(clientVersion)}`,
-    {
-      headers: { authorization: `Bearer ${sidecar.token}` },
-      signal: AbortSignal.timeout(5000)
-    }
-  );
+  let response;
+  try {
+    response = await fetch(
+      `${sidecar.baseURL}/v1/models?client_version=${encodeURIComponent(clientVersion)}`,
+      {
+        headers: { authorization: `Bearer ${sidecar.token}` },
+        signal: AbortSignal.timeout(CODEX_MODEL_CATALOG_TIMEOUT_MS)
+      }
+    );
+  } catch (error) {
+    throw new Error(`Aurora Codex model catalog request timed out after ${CODEX_MODEL_CATALOG_TIMEOUT_MS / 1000}s. Check Aurora Desktop key/model selection and network to Aurora Gateway. (${error?.message || error})`);
+  }
   if (!response.ok) {
     throw new Error(`Aurora Codex model catalog request failed with HTTP ${response.status}`);
   }
@@ -249,6 +256,14 @@ function spawnSyncCompat(command, args) {
   });
 }
 
+function npmCommandSpec() {
+  const npmExecPath = process.env.npm_execpath || "";
+  if (npmExecPath.endsWith(".js")) {
+    return { command: process.execPath, args: [npmExecPath] };
+  }
+  return { command: npmExecPath || "npm", args: [] };
+}
+
 function windowsCommandSpec(command, args) {
   if (process.platform !== "win32" || !command.toLowerCase().endsWith(".cmd")) {
     return { command, args, shell: false };

package/packages/sidecar/src/index.js

@@ -48,6 +48,7 @@ export async function ensureSidecarIdentity() {
 }
 
 export async function startSidecar(options = {}) {
+  installSidecarProcessGuards();
   const tokenOverride = options.token || readArg("--token") || process.env.AURORA_SIDECAR_TOKEN;
   const portOverride = options.port || readArg("--port") || process.env.AURORA_SIDECAR_PORT;
   const identity = await ensureSidecarIdentity();
@@ -134,18 +135,22 @@ async function pingLocalSidecar(port, token) {
   }
 }
 
-// The sidecar is a long-lived local proxy that Claude Code / Codex depend on
-// for every request. A single bad request (e.g. a mid-stream upstream drop)
-// must NOT kill the process: an orphaned sidecar with no live supervisor never
-// comes back, leaving the client stuck on ConnectionRefused. Log and keep
-// serving; the HTTP server stays healthy for the next request.
-process.on("uncaughtException", error => {
-  console.error(`Aurora sidecar uncaught exception: ${error?.stack || error?.message || error}`);
-});
+function installSidecarProcessGuards() {
+  if (process.__auroraSidecarProcessGuardsInstalled) return;
+  process.__auroraSidecarProcessGuardsInstalled = true;
+  // The sidecar is a long-lived local proxy that Claude Code / Codex depend on
+  // for every request. A single bad request (e.g. a mid-stream upstream drop)
+  // must NOT kill the process: an orphaned sidecar with no live supervisor never
+  // comes back, leaving the client stuck on ConnectionRefused. Log and keep
+  // serving; the HTTP server stays healthy for the next request.
+  process.on("uncaughtException", error => {
+    console.error(`Aurora sidecar uncaught exception: ${error?.stack || error?.message || error}`);
+  });
 
-process.on("unhandledRejection", reason => {
-  console.error(`Aurora sidecar unhandled rejection: ${reason?.stack || reason?.message || reason}`);
-});
+  process.on("unhandledRejection", reason => {
+    console.error(`Aurora sidecar unhandled rejection: ${reason?.stack || reason?.message || reason}`);
+  });
+}
 
 async function handle(request, response, token) {
   if (!isAuthorized(request, token)) {
@@ -181,12 +186,19 @@ async function proxyModels(response, incomingURL) {
   const upstreamURL = clientVersion
     ? `${gatewayURL}/v1/aurora-cli/models?client_version=${encodeURIComponent(clientVersion)}`
     : `${gatewayURL}/v1/aurora-cli/models`;
-  const upstream = await fetch(upstreamURL, {
-    headers: {
-      ...selectedKeyHeaders(state),
-      "accept-encoding": "identity"
-    }
-  });
+  let upstream;
+  try {
+    upstream = await fetch(upstreamURL, {
+      headers: {
+        ...selectedKeyHeaders(state),
+        "accept-encoding": "identity"
+      },
+      signal: AbortSignal.timeout(GATEWAY_HEADER_TIMEOUT_MS)
+    });
+  } catch (error) {
+    writeJSON(response, 502, { error: { type: "gateway_unreachable", message: error?.message || String(error) } });
+    return;
+  }
   const payload = await upstream.json().catch(() => ({ object: "list", data: [] }));
   const sourceModels = Array.isArray(payload.data) ? payload.data : [];
   if (clientVersion) {