@auroraflow/code 0.0.15 → 0.0.17

package/README.md

@@ -16,8 +16,7 @@ lib/               current MVP support modules
 
 ## Install
 
-Installing `@auroraflow/code` as a global npm package attempts to install/update the
-official Claude Code and Codex global commands:
+Install `@auroraflow/code` as a global npm package:
 
 ```bash
 npm install -g @auroraflow/code
@@ -26,12 +25,18 @@ npm install -g @auroraflow/code
 Aurora does not export `claude` or `codex` bins. The standalone `claude` and
 `codex` commands remain the official clients and keep their official behavior.
 Aurora only wraps them through `aurora-claude` and `aurora-codex`.
+Aurora does not auto-install official clients during package installation; this
+keeps `npm install -g @auroraflow/code` fast and avoids hiding npm/network
+failures inside postinstall.
 
 To install or update the official clients explicitly:
 
 ```bash
 aurora install-clients
 aurora update-clients
+aurora install codex
+aurora install claude
+aurora install all
 ```
 
 ## Commands
@@ -43,6 +48,8 @@ node bin/aurora.js
 node bin/aurora.js init
 node bin/aurora.js claude
 node bin/aurora.js codex
+node bin/aurora.js install codex
+node bin/aurora.js install claude
 node bin/aurora.js install-clients
 node bin/aurora.js update-clients
 node bin/aurora.js status
@@ -50,6 +57,8 @@ node bin/aurora.js status
 
 Running `aurora` without a subcommand opens an interactive client selector. Use
 Up/Down (or `j`/`k`) and Enter to launch Claude or Codex through Aurora.
+If the selected official client is missing, Aurora prompts to install that
+specific client before launch.
 
 The launcher stores shared local state under `~/.aurora` and starts a local
 sidecar at `127.0.0.1:17878`. Official clients talk to the sidecar; the sidecar

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.15",
+  "version": "0.0.17",
   "type": "module",
   "description": "Aurora launcher and sidecar for official Codex and Claude Code clients.",
   "repository": {

package/packages/cli/src/index.js

@@ -1,7 +1,7 @@
 import { ensureLayout, readAccount, readState, writeAccount, writeState } from "../../state/src/index.js";
-import { officialClientStatuses, runClient, updateOfficialClients } from "../../clients/src/index.js";
+import { installOfficialClient, officialClientStatus, officialClientStatuses, runClient, updateOfficialClients } from "../../clients/src/index.js";
 import { ensureSidecarRunning, installSidecarService, sidecarServiceStatus, uninstallSidecarService } from "../../service/src/index.js";
-import { chooseClient, promptFields } from "../../../lib/prompt.js";
+import { chooseClient, promptChoice, promptFields } from "../../../lib/prompt.js";
 
 export async function runAuroraCLI(argv = process.argv.slice(2)) {
   await ensureLayout();
@@ -28,6 +28,9 @@ export async function runAuroraCLI(argv = process.argv.slice(2)) {
         officialClients: officialClientStatuses()
       }, null, 2));
       return;
+    case "install":
+      await installCommand(rest);
+      return;
     case "install-clients":
     case "install-official-clients":
     case "update-clients":
@@ -70,6 +73,26 @@ async function sidecarCommand(args) {
   }
 }
 
+async function installCommand(args) {
+  const target = args[0] ?? "";
+  switch (target) {
+    case "codex":
+    case "claude":
+      await installOfficialClient(target);
+      console.log(JSON.stringify({ officialClients: officialClientStatuses() }, null, 2));
+      return;
+    case "all":
+    case "clients":
+    case "official-clients":
+      await updateOfficialClients();
+      console.log(JSON.stringify({ officialClients: officialClientStatuses() }, null, 2));
+      return;
+    default:
+      console.error("Usage: aurora install [codex|claude|all]");
+      process.exit(1);
+  }
+}
+
 export async function runAuroraClaude(argv = process.argv.slice(2)) {
   await ensureLayout();
   await runClient("claude", argv);
@@ -86,9 +109,23 @@ async function startInteractive(args) {
     await init();
   }
   const client = await chooseClient();
+  await ensureOfficialClientForInteractive(client);
   await runClient(client, args);
 }
 
+async function ensureOfficialClientForInteractive(client) {
+  const status = officialClientStatus(client);
+  if (status?.installed) return;
+  const action = await promptChoice(`${status?.name ?? client} is not installed`, [
+    { label: `Install ${status?.name ?? client} now`, value: "install" },
+    { label: "Exit", value: "exit" }
+  ]);
+  if (action !== "install") {
+    throw new Error(`${status?.name ?? client} is required. Run: aurora install ${client}`);
+  }
+  await installOfficialClient(client);
+}
+
 async function init() {
   const existing = await readState();
   const account = await readAccount();
@@ -164,6 +201,9 @@ function usage(exitCode) {
   aurora init
   aurora claude [args...]
   aurora codex [args...]
+  aurora install codex
+  aurora install claude
+  aurora install all
   aurora install-clients
   aurora update-clients
   aurora status

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: {
@@ -24,10 +25,10 @@ const OFFICIAL_CLIENTS = {
 
 export async function createClientLaunchSpec(client, args = []) {
   const command = officialClientBin(client);
-  const sidecar = await ensureSidecarRunning();
   const state = await readState();
   const model = selectedModelAlias(state);
   const key = selectedKey(state);
+  const sidecar = await ensureSidecarRunning();
   if (client === "claude") {
     const env = {
       ...process.env,
@@ -83,8 +84,15 @@ export async function updateOfficialClients() {
 }
 
 export async function installOfficialClients() {
+  await installOfficialClient("claude");
+  await installOfficialClient("codex");
+}
+
+export async function installOfficialClient(client) {
+  const spec = OFFICIAL_CLIENTS[client];
+  if (!spec) throw new Error(`unknown official client: ${client}`);
   const npm = npmCommandSpec();
-  const args = ["install", "-g", "@anthropic-ai/claude-code@latest", "@openai/codex@latest"];
+  const args = ["install", "-g", `${spec.packageName}@latest`];
   await spawnAndWait(npm.command, [...npm.args, ...args], { ...process.env });
 }
 
@@ -92,12 +100,16 @@ export function isGlobalNpmLifecycle() {
   return process.env.npm_config_global === "true" || process.env.npm_config_location === "global";
 }
 
+export function officialClientStatus(client) {
+  return officialClientStatuses().find(status => status.id === client) ?? null;
+}
+
 function officialClientBin(client) {
   const spec = OFFICIAL_CLIENTS[client];
   if (!spec) throw new Error(`unknown official client: ${client}`);
   const bin = resolveOfficialClientBin(spec.binName);
   if (!bin) {
-    throw new Error(`${spec.name} is not installed. Run: aurora install-clients`);
+    throw new Error(`${spec.name} is not installed. Run: aurora install ${client}`);
   }
   return bin;
 }
@@ -171,13 +183,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}`);
   }

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)) {