@hemansubedi/aether-ai 1.0.0

package/docs/screenshots.md

@@ -0,0 +1,110 @@
+# Aether Screenshots
+
+This document describes the Aether TUI layout and provides ASCII representations of each view, so the project always looks great even without real PNG captures.
+
+> Note: Aether runs in a real terminal. The ASCII art below is a faithful textual rendering of each view. Real screenshots can be dropped into `docs/assets/` (gitignored) at any time.
+
+## TUI Layout
+
+The interactive TUI is a ChatGPT-style pane:
+
+```
++- Aether -----------------------------------------------+
+�  provider � model                                        �
+�                                                          �
+�  ? user prompt                                           �
+�                                                          �
+�  ? [tool: read_file] src/index.ts                        �
+�  ? [tool: edit_file] src/index.ts                        �
+�                                                          �
+�  assistant response (streamed token by token)            �
+�                                                          �
+�  ? Created src/routes/users.ts                           �
+�  ? Updated src/routes/posts.ts                            �
+�                                                          �
+�  ? _                                                     �
++----------------------------------------------------------+
+```
+
+The bottom bar shows the active provider and model, separated by a dot. Tool calls are indented with a `?` prefix. Completed file operations are marked with a green check.
+
+## Banner
+
+```
+  _   _      _      __  __  ___  
+ | \ | |    / \    |  \/  |/ _ \
+ |  \| |   / _ \   | |\/| | | | |
+ | |\  |  / ___ \  | |  | | |_| |
+ |_| \_| /_/   \_\ |_|  |_|\___/
+
+Aether
+```
+
+## Arena
+
+The arena pits two models against each other on the same prompt. Responses render side by side and a blind vote is recorded.
+
+```
++- Arena -------------------------------------------------+
+�                                                          �
+�  Prompt: Write a haiku about the moon                    �
+�                                                          �
+�  +-----------------------------+  +---------------------+ �
+�  � Model A                     �  � Model B             � �
+�  �                             �  �                     � �
+�  � Silver blade on quiet lake, �  � Cold coin in the    � �
+�  � a thousand reflections...   �  � sky,                � �
+�  �                             �  �                     � �
+�  �                             �  �                     � �
+�  +-----------------------------+  +---------------------+ �
+�                                                          �
+�  [A]  [B]  [Tie]                                          �
+�                                                          �
++----------------------------------------------------------+
+```
+
+Each vote updates the Elo leaderboard:
+
+```
+Rank  Model                          Elo     Wins  Losses  Votes
+----  -----------------------------  -----   ----  -----   -----
+ 1    qwen2.5-coder:7b               1512     24      3      27
+ 2    mistral:7b                     1488     19      8      27
+ 3    llama3.2:3b                    1395     11     16      27
+```
+
+## Stats
+
+`/stats` renders a session summary, cost table, and per-provider health:
+
+```
+Session:
+  messages: 42 (user: 14, assistant: 14, tool: 14)
+
+Cost:
+Provider           Model                                Requests  Input Tok  Output Tok  Cost (USD)
+-----------------  -----------------------------------  --------  ---------  ----------  ----------
+ollama-local       qwen2.5-coder:7b                     14        17623      7574        0.000000
+openrouter-free    mistral:7b                           2         150        300         0.000000
+openai-compatible  gpt-4o-mini                          1         1000       500         0.005000
+                                                             Total       0.005000
+
+Provider health:
+  ollama-local: healthy
+  openrouter-free: healthy
+  openai-compatible: unhealthy (HTTP 401)
+```
+
+## How to Take a Real Screenshot
+
+1. Run the interactive TUI: `npx tsx src/index.ts`
+2. Interact with the agent as normal.
+3. Capture the terminal with your tool of choice:
+   - macOS: `Cmd+Shift+4` (selection) or `Cmd+Shift+3` (full)
+   - Linux: `gnome-screenshot -i` or `scrot -s`
+   - Windows: `Snipping Tool` (Win+Shift+S)
+4. Save the PNG into `docs/assets/` and reference it here.
+
+## Preview File
+
+`docs/preview.txt` is auto-generated by the `update-preview` GitHub Actions workflow (every 6 hours and on push). It captures the live output of `npx tsx src/index.ts /help` and `npx tsx src/index.ts /stats`, so the preview always reflects the current code.

package/docs/stats.md

@@ -0,0 +1,5 @@
+# Aether Live Stats
+_Last updated: <timestamp>_
+
+<!-- stats-start -->
+<!-- stats-end -->

package/install.ps1

@@ -0,0 +1,170 @@
+<#
+.SYNOPSIS
+    Install the Aether CLI on Windows.
+
+.DESCRIPTION
+    Detects Node.js (>= 20), offers to install via winget if missing,
+    clones or updates the repo, installs dependencies, and links the
+    CLI onto PATH.
+
+.PARAMETER Yes
+    Run non-interactively (assume "yes" to all prompts).
+#>
+[CmdletBinding()]
+param(
+    [switch]$Yes
+)
+
+$ErrorActionPreference = "Stop"
+$ProgressPreference = "SilentlyContinue"
+
+$RepoUrl   = "https://github.com/hemansubedi10/aether.git"
+$MinNode   = 20
+$InstallRoot = if ($env:AETHER_INSTALL_DIR) { $env:AETHER_INSTALL_DIR } else { "$env:USERPROFILE\.aether" }
+$BinDir     = if ($env:AETHER_BIN_DIR)  { $env:AETHER_BIN_DIR }  else { "$env:USERPROFILE\.local\bin" }
+
+function Say($msg)   { Write-Host "==> $msg" -ForegroundColor Cyan }
+function Warn($msg)  { Write-Warning $msg }
+function Err($msg)   { Write-Error $msg }
+function Die($msg)   { Write-Error "error: $msg"; exit 1 }
+
+# ---------------------------------------------------------------------------
+# OS check
+# ---------------------------------------------------------------------------
+if ($IsWindows -ne $true) {
+    if ($IsLinux -eq $true -or $IsMacOS -eq $true) {
+        Die "This installer is for Windows. Use install.sh instead: bash install.sh"
+    }
+}
+Say "Detected platform: Windows"
+
+# ---------------------------------------------------------------------------
+# Node.js check
+# ---------------------------------------------------------------------------
+function Get-NodeMajorVersion {
+    $p = Get-Command node -ErrorAction SilentlyContinue
+    if (-not $p) { return $null }
+    try {
+        $v = (& node -p "process.version" 2>$null)
+        if ($v -match '\d+') { return [int]$Matches[0] }
+    } catch {}
+    return $null
+}
+
+$nodeMajor = Get-NodeMajorVersion
+if (-not $nodeMajor) {
+    Say "Node.js >= v$MinNode not found."
+    $install = $false
+    if ($Yes) {
+        $install = $true
+    } else {
+        $ans = Read-Host "Install Node.js now via winget? [Y/n]"
+        if ([string]::IsNullOrWhiteSpace($ans)) { $ans = "y" }
+        $install = ($ans -match '^(y|yes)$')
+    }
+    if (-not $install) {
+        Die "Node.js >= v$MinNode is required. Install it manually from https://nodejs.org and re-run this script."
+    }
+    if (-not (Get-Command winget -ErrorAction SilentlyContinue)) {
+        Die "winget not found. Install Node.js manually from https://nodejs.org and re-run this script."
+    }
+    Say "Installing Node.js via winget..."
+    winget install --id OpenJS.NodeJS --source winget --silent --accept-source-agreements
+    $env:PATH = "$env:ProgramFiles\nodejs;$env:PATH"
+    $nodeMajor = Get-NodeMajorVersion
+    if (-not $nodeMajor) { Die "Node.js install failed. Install it manually from https://nodejs.org." }
+}
+
+if ($nodeMajor -lt $MinNode) {
+    Die "Node.js v$nodeMajor detected, but >= v$MinNode is required. Install Node.js >= v$MinNode from https://nodejs.org."
+}
+Say "Node.js $(node -v) detected."
+
+if (-not (Get-Command npm -ErrorAction SilentlyContinue)) {
+    Die "npm not found. Reinstall Node.js from https://nodejs.org (include npm)."
+}
+
+# ---------------------------------------------------------------------------
+# Acquire the source
+# ---------------------------------------------------------------------------
+$repoDir = Join-Path $InstallRoot "repo"
+if (Test-Path $repoDir) {
+    if (Test-Path (Join-Path $repoDir ".git")) {
+        Say "Updating existing checkout at $repoDir ..."
+        & git -C $repoDir fetch --depth=1 origin
+        & git -C $repoDir reset --hard origin/main
+        & git -C $repoDir clean -fd
+    } else {
+        Say "Existing directory at $repoDir is not a git repo. Removing it..."
+        Remove-Item -Recurse -Force $repoDir
+        Say "Cloning $RepoUrl ..."
+        & git clone --depth 1 $RepoUrl $repoDir
+    }
+} else {
+    Say "Cloning $RepoUrl ..."
+    & git clone --depth 1 $RepoUrl $repoDir
+}
+
+# ---------------------------------------------------------------------------
+# Install dependencies
+# ---------------------------------------------------------------------------
+Say "Installing npm dependencies..."
+& npm install --no-audit --no-fund --prefix $repoDir
+
+# ---------------------------------------------------------------------------
+# Build
+# ---------------------------------------------------------------------------
+if (Test-Path (Join-Path $repoDir "package.json")) {
+    $pkg = Get-Content (Join-Path $repoDir "package.json") -Raw
+    if ($pkg -match '"build"') {
+        Say "Building TypeScript..."
+        try {
+            & npm run build --prefix $repoDir
+        } catch {
+            Warn "Build failed; the CLI will run via tsx instead."
+        }
+    }
+}
+
+# ---------------------------------------------------------------------------
+# Link the CLI onto PATH
+# ---------------------------------------------------------------------------
+New-Item -ItemType Directory -Force -Path $BinDir | Out-Null
+$linkAether      = Join-Path $BinDir "aether.cmd"
+$linkAetherShim  = Join-Path $BinDir "aether"
+$linkServer      = Join-Path $BinDir "aether-server.cmd"
+$linkServerShim  = Join-Path $BinDir "aether-server"
+
+# .cmd wrappers so cmd.exe finds them; shim scripts for PowerShell/WSL.
+Set-Content -LiteralPath $linkAether -Value "@echo off`n`"%USERPROFILE%\nodejs\npx.exe`" tsx `"%USERPROFILE%\.aether\repo\src\index.ts`" %*" -Encoding UTF8
+Set-Content -LiteralPath $linkServer -Value "@echo off`n`"%USERPROFILE%\nodejs\npx.exe`" tsx `"%USERPROFILE%\.aether\repo\src\server.ts`" %*" -Encoding UTF8
+Set-Content -LiteralPath $linkAetherShim -Value "#!/usr/bin/env bash`nexec npx tsx `"$InstallRoot/repo/src/index.ts`" `"$@`" -Encoding UTF8
+Set-Content -LiteralPath $linkServerShim -Value "#!/usr/bin/env bash`nexec npx tsx `"$InstallRoot/repo/src/server.ts`" `"$@`" -Encoding UTF8
+
+# Ensure bin dir is on PATH for the current user
+$machinePath = [Environment]::GetEnvironmentVariable("PATH", [EnvironmentVariableTarget]::Machine)
+$userPath     = [Environment]::GetEnvironmentVariable("PATH", [EnvironmentVariableTarget]::User)
+if ($machinePath -notlike "*$BinDir*") {
+    Say "Adding $BinDir to machine PATH..."
+    [Environment]::SetEnvironmentVariable("PATH", "$machinePath;$BinDir", [EnvironmentVariableTarget]::Machine)
+}
+if ($userPath -notlike "*$BinDir*") {
+    Say "Adding $BinDir to user PATH..."
+    [Environment]::SetEnvironmentVariable("PATH", "$userPath;$BinDir", [EnvironmentVariableTarget]::User)
+}
+$env:PATH = "$BinDir;$env:PATH"
+
+# ---------------------------------------------------------------------------
+# Verify
+# ---------------------------------------------------------------------------
+Say "Aether installed successfully."
+Write-Host ""
+Write-Host "Run it with:"
+Write-Host "  aether ""your prompt here"""
+Write-Host "  aether                 # interactive TUI"
+Write-Host "  aether-server         # start HTTP server"
+Write-Host ""
+Write-Host "If 'aether' is not found, start a new terminal or run:"
+Write-Host "  [Environment]::SetEnvironmentVariable(""PATH"", `"$env:PATH`", ""User"")"
+Write-Host ""
+Write-Host "Verify:  aether --version"

package/install.sh

@@ -0,0 +1,196 @@
+#!/usr/bin/env bash
+#
+# install.sh - Cross-platform installer for the Aether CLI (macOS / Linux)
+#
+# Usage:
+#   bash install.sh            # interactive
+#   bash install.sh --yes      # non-interactive
+#
+set -euo pipefail
+
+REPO_URL="https://github.com/hemansubedi10/aether.git"
+MIN_NODE_MAJOR=20
+INSTALL_DIR="${AETHER_INSTALL_DIR:-$HOME/.aether}"
+BIN_DIR="${AETHER_BIN_DIR:-$HOME/.local/bin}"
+
+# ---------------------------------------------------------------------------
+# Parse arguments
+# ---------------------------------------------------------------------------
+YES=0
+for arg in "$@"; do
+  case "$arg" in
+    --yes|-y) YES=1 ;;
+    -h|--help)
+      echo "Usage: bash install.sh [--yes]"
+      echo "Install the Aether CLI on macOS or Linux."
+      exit 0
+      ;;
+    *)
+      echo "Unknown option: $arg" >&2
+      echo "Usage: bash install.sh [--yes]" >&2
+      exit 2
+      ;;
+  esac
+done
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+say()  { printf '\033[1;34m==>\033[0m %s\n' "$*"; }
+warn() { printf '\033[1;33mwarn:\033[0m %s\n' "$*" >&2; }
+err()  { printf '\033[1;31merror:\033[0m %s\n' "$*" >&2; }
+die()  { err "$*"; exit 1; }
+
+# ---------------------------------------------------------------------------
+# OS detection
+# ---------------------------------------------------------------------------
+OS="$(uname -s)"
+case "$OS" in
+  Darwin) PLATFORM="macOS" ;;
+  Linux)  PLATFORM="Linux" ;;
+  *) die "Unsupported OS: $OS. install.sh supports macOS and Linux. Use install.ps1 on Windows." ;;
+esac
+say "Detected platform: $PLATFORM"
+
+# ---------------------------------------------------------------------------
+# Node.js check
+# ---------------------------------------------------------------------------
+need_node=0
+if ! command -v node >/dev/null 2>&1; then
+  need_node=1
+else
+  NODE_VERSION="$(node -v 2>/dev/null | sed 's/^v//; s/\..*//')"
+  if [ -z "$NODE_VERSION" ]; then
+    need_node=1
+  elif [ "$NODE_VERSION" -lt "$MIN_NODE_MAJOR" ]; then
+    warn "Node.js v$NODE_VERSION detected, but >= v$MIN_NODE_MAJOR is required."
+    need_node=1
+  fi
+fi
+
+if [ "$need_node" -eq 1 ]; then
+  say "Node.js >= v$MIN_NODE_MAJOR not found."
+  if [ "$YES" -eq 1 ]; then
+    PROMPT="y"
+  else
+    printf 'Install Node.js now via your package manager? [Y/n] '
+    read -r PROMPT
+    PROMPT="${PROMPT:-y}"
+  fi
+  case "${PROMPT,,}" in
+    y|yes)
+      if command -v brew >/dev/null 2>&1; then
+        say "Installing Node.js via Homebrew..."
+        brew install node
+      elif command -v apt-get >/dev/null 2>&1; then
+        say "Installing Node.js via apt..."
+        sudo apt-get update -y && sudo apt-get install -y nodejs npm
+      elif command -v dnf >/dev/null 2>&1; then
+        say "Installing Node.js via dnf..."
+        sudo dnf install -y nodejs npm
+      elif command -v pacman >/dev/null 2>&1; then
+        say "Installing Node.js via pacman..."
+        sudo pacman -S --noconfirm nodejs npm
+      elif command -v zypper >/dev/null 2>&1; then
+        say "Installing Node.js via zypper..."
+        sudo zypper install -y nodejs npm
+      else
+        die "No supported package manager found. Install Node.js >= v$MIN_NODE_MAJOR manually from https://nodejs.org"
+      fi
+      ;;
+    n|no)
+      die "Node.js >= v$MIN_NODE_MAJOR is required. Install it manually from https://nodejs.org and re-run this script."
+      ;;
+    *)
+      die "Invalid response. Aborting."
+      ;;
+  esac
+
+  # Re-check after attempted install
+  if ! command -v node >/dev/null 2>&1; then
+    die "Node.js still not found after install attempt. Please install it manually."
+  fi
+  NODE_VERSION="$(node -v 2>/dev/null | sed 's/^v//; s/\..*//')"
+  [ "$NODE_VERSION" -ge "$MIN_NODE_MAJOR" ] || die "Node.js version still too old (v$NODE_VERSION). Need >= v$MIN_NODE_MAJOR."
+fi
+say "Node.js $(node -v) detected."
+
+# npm is required
+command -v npm >/dev/null 2>&1 || die "npm not found. Node.js installation should include npm."
+
+# ---------------------------------------------------------------------------
+# Acquire the source
+# ---------------------------------------------------------------------------
+REPO_DIR="$INSTALL_DIR/repo"
+if [ -d "$REPO_DIR" ] && [ -d "$REPO_DIR/.git" ]; then
+  say "Updating existing checkout at $REPO_DIR ..."
+  git -C "$REPO_DIR" fetch --depth=1 origin
+  git -C "$REPO_DIR" reset --hard origin/main
+  git -C "$REPO_DIR" clean -fd
+elif [ -d "$REPO_DIR" ]; then
+  say "Existing directory at $REPO_DIR is not a git repo. Removing it..."
+  rm -rf "$REPO_DIR"
+  say "Cloning $REPO_URL ..."
+  git clone --depth 1 "$REPO_URL" "$REPO_DIR"
+else
+  say "Cloning $REPO_URL ..."
+  git clone --depth 1 "$REPO_URL" "$REPO_DIR"
+fi
+
+# ---------------------------------------------------------------------------
+# Install dependencies
+# ---------------------------------------------------------------------------
+say "Installing npm dependencies..."
+(cd "$REPO_DIR" && npm install --no-audit --no-fund)
+
+# ---------------------------------------------------------------------------
+# Build (TypeScript -> dist/)
+# ---------------------------------------------------------------------------
+if [ -f "$REPO_DIR/package.json" ] && grep -q '"build"' "$REPO_DIR/package.json"; then
+  say "Building TypeScript..."
+  (cd "$REPO_DIR" && npm run build) || warn "Build failed; the CLI will run via tsx instead."
+fi
+
+# ---------------------------------------------------------------------------
+# Link the CLI onto PATH
+# ---------------------------------------------------------------------------
+mkdir -p "$BIN_DIR"
+ln -sf "$REPO_DIR/src/index.ts" "$BIN_DIR/aether"
+ln -sf "$REPO_DIR/src/server.ts" "$BIN_DIR/aether-server"
+
+# Ensure bin dir is on PATH for this session and future shells
+export PATH="$BIN_DIR:$PATH"
+SHELL_RC=""
+case "$SHELL" in
+  */zsh)  SHELL_RC="$HOME/.zshrc" ;;
+  */bash) SHELL_RC="$HOME/.bashrc" ;;
+  *)      SHELL_RC="$HOME/.profile" ;;
+esac
+for rc in "$HOME/.zshrc" "$HOME/.bashrc" "$HOME/.profile"; do
+  if [ -f "$rc" ] && ! grep -q "AETHER_BIN_DIR\|$BIN_DIR" "$rc" 2>/dev/null; then
+    printf '\n# Aether CLI\nexport PATH="%s:$PATH"\n' "$BIN_DIR" >> "$rc"
+    say "Added $BIN_DIR to PATH in $rc"
+  fi
+done
+
+# ---------------------------------------------------------------------------
+# Verify
+# ---------------------------------------------------------------------------
+if command -v aether >/dev/null 2>&1; then
+  say "Aether installed successfully."
+  aether --version 2>/dev/null || true
+  echo
+  echo "Run it with:"
+  echo "  aether \"your prompt here\""
+  echo "  aether                 # interactive TUI"
+  echo "  aether-server         # start HTTP server"
+  echo
+  echo "If 'aether' is not found, open a new terminal or run:"
+  echo "  source ${SHELL_RC:-$HOME/.profile}"
+else
+  warn "Installation finished but 'aether' is not on PATH yet."
+  warn "Open a new terminal, or run: source ${SHELL_RC:-$HOME/.profile}"
+  echo
+  echo "Then run:"
+  echo "  aether --version"
+fi

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@hemansubedi/aether-ai",
+  "version": "1.0.0",
+  "description": "The Aether CLI: the free, unlimited, multi-provider LLM CLI - install like KiloCode, run like Claude Code.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "aether-ai": "dist/index.js",
+    "aether-ai-server": "dist/server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "engines": { "node": ">=20" },
+  "keywords": ["llm", "cli", "ai", "router", "ollama", "openrouter", "free"],
+  "author": "Heman Subedi <hemansubedi66@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/hemansubedi10/aether",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hemansubedi10/aether.git"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^7.0.0",
+    "tsx": "^4.0.0",
+    "@types/node": "^22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/generate-stats-card.ts

@@ -0,0 +1,62 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { PROVIDER_REGISTRY } from "../src/providers/registry.js";
+
+function parseHealth(statsText: string): { total: number; healthy: number } {
+  const lines = statsText.split("\n");
+  let inHealth = false;
+  let healthy = 0;
+  let total = 0;
+  for (const raw of lines) {
+    const line = raw.trim();
+    if (line.startsWith("Provider health:")) { inHealth = true; continue; }
+    if (!inHealth) continue;
+    if (!line) continue;
+    total++;
+    if (/^\s*[\w-]+:\s+healthy\b/.test(line)) healthy++;
+  }
+  return { total, healthy };
+}
+
+function modelCount(): number {
+  let n = 0;
+  for (const p of PROVIDER_REGISTRY) if (p.enabled) n += p.models.length;
+  return n;
+}
+
+function main() {
+  const statsPath = path.join(process.cwd(), "docs", "stats.md");
+  const statsTxtPath = path.join(process.cwd(), "docs", "stats.txt");
+  const statsText = fs.existsSync(statsTxtPath) ? fs.readFileSync(statsTxtPath, "utf8") : "";
+  const { total, healthy } = parseHealth(statsText);
+  const models = modelCount();
+
+  let md = fs.existsSync(statsPath) ? fs.readFileSync(statsPath, "utf8") : "";
+
+  const stamp = new Date().toISOString().replace("T", " ").slice(0, 19) + " UTC";
+  md = md.replace(/_Last updated:.*_/, "_Last updated: " + stamp + "_");
+
+  const card = [
+    "<!-- stats-start -->",
+    "| Metric | Value |",
+    "|--------|-------|",
+    "| Providers | " + total + " |",
+    "| Healthy | " + healthy + " |",
+    "| Unhealthy / Open | " + (total - healthy) + " |",
+    "| Models (enabled) | " + models + " |",
+    "<!-- stats-end -->",
+  ].join("\n");
+
+  const start = md.indexOf("<!-- stats-start -->");
+  const end = md.indexOf("<!-- stats-end -->");
+  if (start !== -1 && end !== -1) {
+    md = md.slice(0, start) + card + md.slice(end + "<!-- stats-end -->".length);
+  } else {
+    md = md.trimEnd() + "\n\n" + card + "\n";
+  }
+
+  fs.writeFileSync(statsPath, md, "utf8");
+  console.log("Updated docs/stats.md");
+}
+
+main();

package/scripts/patch_index.ps1

@@ -0,0 +1,17 @@
+$ErrorActionPreference = "Stop"
+$src = Get-Content -LiteralPath "C:\Users\heman\aether\src\index.ts" -Raw
+
+$src = $src.Replace("function makeRouterAdapter(engine: RouterEngine) {", "function makeRouterAdapter(engine: RouterEngine, combos: any) {")
+
+$src = $src.Replace("`n    configs: engine.configs_,", "`n    combos: combos,")
+
+$src = $src.Replace("`n    listAllModels: () => engine.listFreeModels(),", "`n    combos: combos,`n    applyCombo: (name: string) => {`n      const c = combos.select(name);`n      if (!c) return 'Combo ' + name + ' not found.';`n      const summary = engine.applyCombo(c);`n      adapter.activeProvider = c.providers[0];`n      return summary;`n    },`n    listAllModels: () => engine.listFreeModels(),")
+
+$src = $src.Replace("import { KeyManager } from './keys.js';", "import { KeyManager } from './keys.js';`nimport { ComboManager } from './combos.js';")
+
+$src = $src.Replace("  const engine = new RouterEngine(undefined, undefined, KeyManager.instance());`n  const router = makeRouterAdapter(engine);`n  const registry = new ToolRegistry();", "  const engine = new RouterEngine(undefined, undefined, KeyManager.instance());`n  const combos = ComboManager.instance();`n  const router = makeRouterAdapter(engine, combos);`n  const registry = new ToolRegistry();")
+
+$src = $src.Replace("  const engine = new RouterEngine(undefined, undefined, KeyManager.instance());`n  const router = makeRouterAdapter(engine);`n  const registry = new ToolRegistry();`n  for (const make of [makeReadFileTool", "  const engine = new RouterEngine(undefined, undefined, KeyManager.instance());`n  const combos = ComboManager.instance();`n  const router = makeRouterAdapter(engine, combos);`n  const registry = new ToolRegistry();`n  for (const make of [makeReadFileTool")
+
+Set-Content -LiteralPath "C:\Users\heman\aether\src\index.ts" -Value $src -NoNewline
+Write-Host "edited index.ts"

package/scripts/release.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+# Bump version, commit, tag, and push � GitHub Action publishes automatically.
+set -euo pipefail
+VERSION="${1:-patch}"
+npm version $VERSION
+git push --follow-tags
+echo "Pushed tag. GitHub Action will publish to npm."