@jiayunxie/aerial 0.2.5 → 0.2.6

package/src/cli/app-status.js

@@ -1,23 +0,0 @@
-export function computeAppStatus(setup, service) {
-  const githubTokenPresent = setup.auth.github_token.source !== "missing";
-  const apiKeyPresent = setup.auth.api_key.exists;
-  const hasAerialClient = setup.clients.codex.state === "aerial" || setup.clients.claude.state === "aerial";
-  const serviceHealthy = service.supported !== false && service.health?.aerial === true;
-  const ok = apiKeyPresent && githubTokenPresent && hasAerialClient && serviceHealthy;
-  const nextSteps = [];
-  const hints = [];
-  if (!githubTokenPresent) nextSteps.push("run: aerial login");
-  if (!hasAerialClient) nextSteps.push("run: aerial setup codex or aerial setup claude");
-  if (hasAerialClient && !apiKeyPresent) nextSteps.push("run: aerial setup codex or aerial setup claude to recreate the local Aerial key");
-  if (service.supported !== false && !service.service?.loaded) {
-    if (serviceHealthy) {
-      hints.push("Aerial is running in the foreground but no background service is installed; run `aerial service install` so it starts on reboot.");
-    } else {
-      nextSteps.push("run: aerial service install");
-    }
-  }
-  if (setup.auth.github_token.source === "env") {
-    hints.push("AERIAL_GITHUB_TOKEN is set for this process only; run aerial login without that env var to persist a service-readable login.");
-  }
-  return { schema: "aerial.status.v1", ok, setup, service, nextSteps, hints };
-}

package/src/cli/args.js

@@ -1,28 +0,0 @@
-export function argValue(args, name) {
-  const index = args.indexOf(name);
-  return index >= 0 ? args[index + 1] : undefined;
-}
-
-export function requiredArgValue(args, name) {
-  const index = args.indexOf(name);
-  if (index < 0) return undefined;
-  const value = args[index + 1];
-  if (value === undefined || value.startsWith("--")) {
-    throw new Error(`${name} requires a value.`);
-  }
-  return value;
-}
-
-export function parseConfigPort(value) {
-  const text = String(value).trim();
-  if (!/^\d+$/.test(text)) throw new Error("port must be an integer between 1 and 65535");
-  const port = Number(text);
-  if (port < 1 || port > 65535) throw new Error("port must be an integer between 1 and 65535");
-  return port;
-}
-
-export function parseConfigHost(value) {
-  const host = String(value).trim().toLowerCase();
-  if (host === "127.0.0.1" || host === "localhost" || host === "::1") return host;
-  throw new Error("host must be a loopback address: 127.0.0.1, localhost, or ::1");
-}

package/src/cli/help.js

@@ -1,23 +0,0 @@
-export function printHelp() {
-  console.log(`Aerial local Copilot proxy
-
-Usage:
-  aerial --version
-  aerial login
-  aerial setup codex [--model <id>] [--effort <low|medium|high|xhigh|max>]
-  aerial setup claude [--model <id>] [--effort <low|medium|high|xhigh|max>]
-  aerial service install
-  aerial status [--json]
-  aerial proxy status|enable|disable [--json]
-
-Diagnostics and rollback:
-  aerial setup status [--json]
-  aerial setup restore <codex|claude|all> --latest
-  aerial service status [--json]
-  aerial disable
-  aerial doctor
-  aerial probe [--live] [--json]
-
-Debug:
-  aerial start [--host 127.0.0.1] [--port 18181]`);
-}

package/src/cli/model-selection.js

@@ -1,119 +0,0 @@
-import { createInterface } from "node:readline/promises";
-import { stdin as input, stdout as output } from "node:process";
-import { proxyModels } from "../proxy/index.js";
-import { readJsonSafely } from "../shared/http-utils.js";
-import { modelsForRoute } from "../proxy/model-utils.js";
-import { parseNumberChoice } from "../shared/prompt-utils.js";
-
-const MAX_LISTED_MODELS = 20;
-const GPT_VERSION_RE = /^gpt-(\d+)(?:\.(\d+))?/i;
-const STABLE_GPT_RE = /^gpt-\d+(?:\.\d+)?$/i;
-
-export { modelsForRoute } from "../proxy/model-utils.js";
-
-function gptVersionScore(id) {
-  const match = GPT_VERSION_RE.exec(id);
-  if (!match) return undefined;
-  const major = Number(match[1]);
-  const minor = match[2] === undefined ? 0 : Number(match[2]);
-  return major * 1000 + minor;
-}
-
-export function rankModels(choices) {
-  return [...choices]
-    .map((choice, index) => ({ choice, index, score: gptVersionScore(choice.id) }))
-    .sort((a, b) => {
-      if (a.score !== undefined && b.score !== undefined && a.score !== b.score) return b.score - a.score;
-      if (a.score !== undefined && b.score === undefined) return -1;
-      if (a.score === undefined && b.score !== undefined) return 1;
-      return a.index - b.index;
-    })
-    .map((entry) => entry.choice);
-}
-
-export function pickRecommended(choices) {
-  if (!choices.length) return { recommended: undefined, source: "first_available" };
-  const ranked = rankModels(choices);
-  const stable = ranked.filter((c) => STABLE_GPT_RE.test(c.id));
-  if (stable.length) return { recommended: stable[0].id, source: "recommended_stable", ranked };
-  return { recommended: ranked[0].id, source: "recommended_fallback", ranked };
-}
-
-export function orderForPrompt(ranked, recommended) {
-  if (!recommended) return [...ranked];
-  const found = ranked.find((c) => c.id === recommended);
-  if (!found) return [...ranked];
-  return [found, ...ranked.filter((c) => c.id !== recommended)];
-}
-
-export async function discoverModelsForRoute(route) {
-  const response = await proxyModels(new Request("http://aerial.local/v1/models", { method: "GET" }));
-  const payload = await readJsonSafely(response);
-  if (!response.ok) {
-    const detail = payload.error || payload.raw || JSON.stringify(payload);
-    throw new Error(`Could not load Copilot models (${response.status}): ${detail}`);
-  }
-  const models = Array.isArray(payload.data) ? payload.data : [];
-  return modelsForRoute(models, route);
-}
-
-export async function chooseSetupModel({ target, route, explicitModel, prompt = input.isTTY }) {
-  if (explicitModel) return { model: explicitModel, choices: [], source: "explicit" };
-  let raw;
-  try {
-    raw = await discoverModelsForRoute(route);
-  } catch (err) {
-    throw new Error(`${err.message}\nRun \`aerial login\` first, or pass \`--model <id>\` if you already know which ${target} model to use.`);
-  }
-  if (!raw.length) {
-    throw new Error(`No Copilot models currently advertise the ${route} route needed by ${target}. Run \`aerial probe\` to inspect the full model list.`);
-  }
-  const { recommended, source: recommendedSource, ranked } = pickRecommended(raw);
-  const choices = ranked;
-  const promptListed = orderForPrompt(ranked, recommended).slice(0, MAX_LISTED_MODELS);
-  if (!prompt) return { model: recommended, choices, source: recommendedSource, recommended };
-
-  const rl = createInterface({ input, output });
-  try {
-    output.write(`Available ${target} models (${route} route):\n`);
-    if (recommendedSource === "recommended_fallback") {
-      output.write(`  No stable gpt-N.M model available; recommending ${recommended} as a fallback. Pass --model <id> to override.\n`);
-    }
-    for (const [index, choice] of promptListed.entries()) {
-      const marker = choice.id === recommended ? "  (recommended)" : "";
-      output.write(`  ${index + 1}. ${choice.id}${marker}\n`);
-    }
-    if (choices.length > MAX_LISTED_MODELS) output.write(`  ... ${choices.length - MAX_LISTED_MODELS} more\n`);
-    while (true) {
-      const answer = await rl.question(`Choose ${target} model [1-${promptListed.length}, default 1 = ${recommended}]: `);
-      const selected = parseNumberChoice(answer, { max: promptListed.length, defaultIndex: 1, oneBased: true });
-      if (selected) return { model: promptListed[selected - 1].id, choices, source: "prompt", displayed: true, recommended };
-      output.write(`Enter a number from 1 to ${promptListed.length}, or press Enter for 1.\n`);
-    }
-  } finally {
-    rl.close();
-  }
-}
-
-export function formatModelChoices({ target, route, choices, selectedModel, source, recommended }) {
-  if (!choices.length) return [];
-  const lines = [
-    `Available ${target} models (${route} route):`
-  ];
-  for (const [index, choice] of choices.slice(0, MAX_LISTED_MODELS).entries()) {
-    const markers = [];
-    if (choice.id === recommended) markers.push("recommended");
-    if (choice.id === selectedModel) markers.push("selected");
-    const suffix = markers.length ? `  (${markers.join(", ")})` : "";
-    lines.push(`  ${index + 1}. ${choice.id}${suffix}`);
-  }
-  if (choices.length > MAX_LISTED_MODELS) lines.push(`  ... ${choices.length - MAX_LISTED_MODELS} more`);
-  if (source === "first_available" || source === "recommended_stable") {
-    lines.push(`No interactive terminal detected; selected ${selectedModel}. Pass --model <id> to choose a different model.`);
-  } else if (source === "recommended_fallback") {
-    lines.push(`No stable gpt-N.M model available; selected ${selectedModel}. Pass --model <id> to override.`);
-  } else {
-    lines.push(`Selected ${target} model: ${selectedModel}`);
-  }
-  return lines;
-}

package/src/cli/runtime-auth.js

@@ -1,21 +0,0 @@
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const CLI_ENTRY = path.join(path.dirname(fileURLToPath(import.meta.url)), "index.js");
-
-export function codexAuthCommand() {
-  return {
-    command: process.execPath,
-    args: [CLI_ENTRY, "key", "print"],
-    timeout_ms: 5000,
-    refresh_interval_ms: 0
-  };
-}
-
-function quoteCommandPart(value) {
-  return `"${String(value).replace(/"/g, '\\"')}"`;
-}
-
-export function claudeApiKeyHelper() {
-  return [process.execPath, CLI_ENTRY, "key", "print"].map(quoteCommandPart).join(" ");
-}

package/src/cli/setup-selection.js

@@ -1,47 +0,0 @@
-import { createInterface } from "node:readline/promises";
-import { stdin as input, stdout as output } from "node:process";
-import { parseNumberChoice } from "../shared/prompt-utils.js";
-import { DEFAULT_EFFORT, EFFORT_VALUES, assertValidEffort } from "../shared/effort.js";
-
-export { DEFAULT_EFFORT, EFFORT_VALUES, normalizeEffort, assertValidEffort } from "../shared/effort.js";
-
-export async function chooseSetupEffort({
-  target,
-  explicitEffort,
-  prompt,
-  input: inputStream = input,
-  output: outputStream = output
-} = {}) {
-  if (explicitEffort !== undefined) {
-    return { effort: assertValidEffort(explicitEffort), source: "explicit", displayed: false };
-  }
-  const shouldPrompt = prompt === undefined ? Boolean(inputStream.isTTY) : prompt;
-  if (!shouldPrompt) {
-    return { effort: DEFAULT_EFFORT, source: "default_non_tty", displayed: false };
-  }
-  const defaultIndex = EFFORT_VALUES.indexOf(DEFAULT_EFFORT);
-  const rl = createInterface({ input: inputStream, output: outputStream });
-  try {
-    outputStream.write(`Choose ${target} reasoning effort:\n`);
-    for (const [index, value] of EFFORT_VALUES.entries()) {
-      const marker = index === defaultIndex ? "  (default)" : "";
-      outputStream.write(`  ${index + 1}. ${value}${marker}\n`);
-    }
-    while (true) {
-      const answer = await rl.question(`Choose effort [1-${EFFORT_VALUES.length}, default ${defaultIndex + 1} = ${DEFAULT_EFFORT}]: `);
-      const selectedIndex = parseNumberChoice(answer, { max: EFFORT_VALUES.length, defaultIndex });
-      if (selectedIndex !== undefined) {
-        return { effort: EFFORT_VALUES[selectedIndex], source: "prompt", displayed: true };
-      }
-      outputStream.write(`Enter a number from 1 to ${EFFORT_VALUES.length}, or press Enter for ${defaultIndex + 1}.\n`);
-    }
-  } finally {
-    rl.close();
-  }
-}
-
-export function formatEffortSelection({ target, effort, source }) {
-  if (source === "explicit") return `Selected ${target} effort: ${effort}`;
-  if (source === "prompt") return `Selected ${target} effort: ${effort}`;
-  return `No interactive terminal detected; selected ${target} effort: ${effort}. Pass --effort <low|medium|high|xhigh|max> to choose a different effort.`;
-}

package/src/cli/version.js

@@ -1,19 +0,0 @@
-import fs from "node:fs";
-
-const PACKAGE_JSON_URL = new URL("../../package.json", import.meta.url);
-
-export function readPackageVersion(packageJsonUrl = PACKAGE_JSON_URL) {
-  try {
-    const pkg = JSON.parse(fs.readFileSync(packageJsonUrl, "utf8"));
-    if (typeof pkg.version === "string" && pkg.version.length > 0) return pkg.version;
-    throw new Error("missing version field");
-  } catch (error) {
-    const reason = error?.message || String(error);
-    console.warn(`aerial: cannot read package version (${reason}); reporting "unknown"`);
-    return "unknown";
-  }
-}
-
-export function printVersion(packageJsonUrl = PACKAGE_JSON_URL) {
-  console.log(readPackageVersion(packageJsonUrl));
-}

package/src/proxy/model-utils.js

@@ -1,20 +0,0 @@
-export function aerialRoutes(model) {
-  return Array.isArray(model?.aerial?.routes) ? model.aerial.routes : [];
-}
-
-export function modelsForRoute(models, route) {
-  return models
-    .filter((model) => typeof model?.id === "string" && aerialRoutes(model).includes(route))
-    .map((model) => ({ id: model.id, routes: aerialRoutes(model), notes: model.aerial?.notes || [] }));
-}
-
-export function usageSummary(payload) {
-  const usage = payload?.usage || payload?.response?.usage || {};
-  return {
-    input: usage.input_tokens ?? usage.prompt_tokens,
-    output: usage.output_tokens ?? usage.completion_tokens,
-    cached: usage.input_tokens_details?.cached_tokens
-      ?? usage.prompt_tokens_details?.cached_tokens
-      ?? usage.cache_read_input_tokens
-  };
-}

package/src/setup/backup.js

@@ -1,38 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-
-const BACKUP_PREFIX = ".aerial-backup-";
-const ISO_STAMP_RE = /^\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z$/;
-
-export function backupIfExists(file) {
-  if (!fs.existsSync(file)) return undefined;
-  const backup = `${file}.aerial-backup-${new Date().toISOString().replace(/[:.]/g, "-")}`;
-  fs.copyFileSync(file, backup);
-  return backup;
-}
-
-function listBackups(file) {
-  const dir = path.dirname(file);
-  const base = path.basename(file);
-  if (!fs.existsSync(dir)) return [];
-  const prefix = `${base}${BACKUP_PREFIX}`;
-  const entries = fs.readdirSync(dir);
-  const matches = [];
-  for (const entry of entries) {
-    if (!entry.startsWith(prefix)) continue;
-    const stamp = entry.slice(prefix.length);
-    if (!ISO_STAMP_RE.test(stamp)) continue;
-    matches.push({ name: entry, path: path.join(dir, entry), stamp });
-  }
-  matches.sort((a, b) => (a.stamp < b.stamp ? -1 : a.stamp > b.stamp ? 1 : 0));
-  return matches;
-}
-
-export function findLatestBackup(file) {
-  const all = listBackups(file);
-  return all.length ? all[all.length - 1] : undefined;
-}
-
-export function backupPathsFor(file) {
-  return listBackups(file).map((entry) => entry.path);
-}

package/src/setup/status.js

@@ -1,24 +0,0 @@
-import fs from "node:fs";
-import { loadConfig } from "../shared/config.js";
-import { apiKeyPath, githubTokenPath } from "../shared/paths.js";
-import { gitHubTokenSource } from "../shared/auth.js";
-import { CLIENTS } from "./clients.js";
-
-export function setupStatus() {
-  const config = loadConfig();
-  const apiKeyFile = apiKeyPath();
-  const githubTokenFile = githubTokenPath();
-  return {
-    schema: "aerial.setup-status.v1",
-    platform: process.platform,
-    config: { host: config.host, port: config.port },
-    auth: {
-      api_key: { file: apiKeyFile, exists: fs.existsSync(apiKeyFile) },
-      github_token: (() => {
-        const source = gitHubTokenSource();
-        return { file: githubTokenFile, exists: source !== "missing", source };
-      })()
-    },
-    clients: Object.fromEntries(Object.entries(CLIENTS).map(([target, client]) => [target, client.status()]))
-  };
-}

package/src/shared/http-utils.js

@@ -1,9 +0,0 @@
-export async function readJsonSafely(response) {
-  const text = await response.text();
-  if (!text) return {};
-  try {
-    return JSON.parse(text);
-  } catch {
-    return { raw: text };
-  }
-}

package/src/shared/prompt-utils.js

@@ -1,8 +0,0 @@
-export function parseNumberChoice(value, { max, defaultIndex = 0, oneBased = false } = {}) {
-  const trimmed = String(value || "").trim();
-  if (!trimmed) return defaultIndex;
-  if (!/^\d+$/.test(trimmed)) return undefined;
-  const n = Number(trimmed);
-  if (n < 1 || n > max) return undefined;
-  return oneBased ? n : n - 1;
-}