@xelauvas/xela-cli 0.3.0 → 0.4.0

package/local/README.md

@@ -0,0 +1,112 @@
+# Xela with a local model (llama.cpp)
+
+Everything needed to run Xela on your own GPU, without any cloud API. Tested on
+an RTX 5090 Laptop (24 GB) with Qwen3.6-27B at 31-47 tok/s.
+
+## 1. Install Xela
+
+```bash
+npm install -g @xelauvas/xela-cli
+```
+
+This gives you two commands: `xela` (cloud providers, interactive setup) and
+`xela-local` (local model, this guide).
+
+## 2. Build llama.cpp with CUDA
+
+```bash
+sudo apt install -y git cmake build-essential python3 curl
+git clone https://github.com/ggml-org/llama.cpp ~/llama.cpp
+cd ~/llama.cpp
+cmake -B build -DGGML_CUDA=ON -DCMAKE_CUDA_ARCHITECTURES=120   # 120 = RTX 50xx; 89 = RTX 40xx; 86 = RTX 30xx
+cmake --build build --config Release -j --target llama-server
+```
+
+Needs the NVIDIA driver and the CUDA toolkit (12.8 or newer for RTX 50xx).
+
+## 3. Download the model
+
+```bash
+mkdir -p ~/models && cd ~/models
+# main model, ~17.6 GB
+curl -L -o Qwen3.6-27B-UD-Q4_K_XL.gguf \
+  https://huggingface.co/unsloth/Qwen3.6-27B-GGUF/resolve/main/Qwen3.6-27B-UD-Q4_K_XL.gguf
+# MTP draft head for speculative decoding, ~3.2 GB (optional, +50% speed at 64k context)
+curl -L -o mtp-Qwen3.6-27B-Q8_0.gguf \
+  https://huggingface.co/unsloth/Qwen3.6-27B-GGUF/resolve/main/mtp-Qwen3.6-27B-Q8_0.gguf
+```
+
+Keep the models on the Linux disk (not `/mnt/c`) when using WSL.
+
+## 4. Run
+
+```bash
+xela-local                      # starts the server if needed, then Xela in the current directory
+CTX=65536 xela-local            # faster mode: 64k context + speculative decoding
+OPENAI_THINKING=off xela-local  # no reasoning, quicker answers
+```
+
+Environment variables (all optional):
+
+| Variable | Default | Meaning |
+|---|---|---|
+| `XELA_MODELS_DIR` | `~/models` | folder with the GGUF files |
+| `LLAMA_SERVER` | `~/llama.cpp/build/bin/llama-server` | server binary |
+| `CTX` | `131072` | context length; MTP turns on automatically at 65536 or less |
+| `XELA_CONFIG_DIR` | `~/.xela-local` | Xela config, separate from `~/.claude` |
+| `XELA_SERVER_URL` | `http://localhost:8080` | use an existing server (another machine works too) |
+
+The server can be started by hand with `start-qwen.sh` (same directory as
+`xela-local`); its log is in `$XELA_MODELS_DIR/server.log`.
+
+## What is different from the cloud setup
+
+- Auto mode permission classifier runs on the local model; read-only tools skip
+  it. Expect 5-7 s per write/shell action.
+- Background memory extraction, compaction, workflows and subagents all use the
+  same local server (4 parallel slots).
+- `/peers`, proactive mode (`/proactive on`), assistant mode (`xela-local --assistant`)
+  and the other Claude Code features are enabled by default; see
+  `src/_shims/bun_bundle.js` for the feature list (`XELA_FEATURES_DISABLE=NAME` to turn one off).
+
+## Using Xela from any computer (like Claude Code or Codex)
+
+The model server stays on the GPU machine; Xela on any other computer or
+network talks to it over the internet. Install once, enter the server address
+once, then just run `xela-local`.
+
+**On the GPU machine**, start the server with a key and expose it through a
+tunnel (no router or firewall changes needed; the key is the only protection,
+so keep it secret):
+
+```bash
+LLAMA_API_KEY=choose-a-secret CTX=65536 start-qwen.sh   # or let xela-local start it
+start-tunnel.sh                                          # ngrok (needs `ngrok config add-authtoken ...` once)
+```
+
+`start-tunnel.sh` prints the public https URL and checks that requests without
+the key are refused. The free ngrok URL changes on every restart; claim the
+free static domain in the ngrok dashboard (Domains) and run
+`NGROK_DOMAIN=yourname.ngrok-free.app start-tunnel.sh` to keep it fixed.
+
+Same network only? Skip the tunnel and use `http://<gpu-machine-ip>:8080`. If
+the server runs inside WSL, enable mirrored networking (Windows 11: add
+`networkingMode=mirrored` under `[wsl2]` in `%UserProfile%\.wslconfig`, then
+`wsl --shutdown`) and allow port 8080 in the Windows firewall:
+
+```powershell
+New-NetFirewallHyperVRule -Name llama-8080 -DisplayName "llama-server 8080 (WSL)" -Direction Inbound -VMCreatorId '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}' -Protocol TCP -LocalPorts 8080
+New-NetFirewallRule -DisplayName "llama-server 8080" -Direction Inbound -Protocol TCP -LocalPort 8080 -Action Allow
+```
+
+**On any other computer** (Node 20+ and bash/curl; no GPU, no model):
+
+```bash
+npm install -g @xelauvas/xela-cli
+xela-local            # first run asks: Server URL, API key → saved in ~/.xela-local/server.env
+```
+
+Afterwards `xela-local` works in any directory. `xela-local --setup` changes
+the server; `xela-local --server URL --key KEY` sets it non-interactively.
+`XELA_SERVER_URL` / `LLAMA_API_KEY` in the environment override the saved
+values. The launcher never starts a server when the address is not localhost.

package/local/start-qwen.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+# Start a local Qwen3.6-27B as an OpenAI-compatible server on http://localhost:8080/v1
+# using llama.cpp. Tuned for a 24 GB GPU.
+#
+#   XELA_MODELS_DIR   where the GGUF files live            (default ~/models)
+#   LLAMA_SERVER      llama-server binary                  (default ~/llama.cpp/build/bin/llama-server)
+#   MODEL             main model file                      (default Qwen3.6-27B-UD-Q4_K_XL.gguf)
+#   MTP_MODEL         MTP draft head for speculative decoding (default mtp-Qwen3.6-27B-Q8_0.gguf)
+#   CTX               context length (default 131072); MTP is enabled automatically at <= 65536
+#   MTP=0|1           force speculative decoding on/off (both do not fit in 24 GB at 128k)
+#   PORT              default 8080
+#   LLAMA_API_KEY     if set, clients must send it as a Bearer token (use it when exposing the port)
+#
+# Modes on a 24 GB card:
+#   CTX=131072 (default)  no MTP   ~31 tok/s, large context, rare compactions
+#   CTX=65536             + MTP    ~47 tok/s, auto-compact kicks in more often
+set -u
+MODELS="${XELA_MODELS_DIR:-$HOME/models}"
+BIN="${LLAMA_SERVER:-$HOME/llama.cpp/build/bin/llama-server}"
+MODEL_FILE="$MODELS/${MODEL:-Qwen3.6-27B-UD-Q4_K_XL.gguf}"
+MTP_FILE="$MODELS/${MTP_MODEL:-mtp-Qwen3.6-27B-Q8_0.gguf}"
+CTX="${CTX:-131072}"
+PORT="${PORT:-8080}"
+if [ -z "${MTP:-}" ]; then
+  [ "$CTX" -le 65536 ] && MTP=1 || MTP=0
+fi
+[ -x "$BIN" ] || { echo "llama-server not found at $BIN (set LLAMA_SERVER). See local/README.md." >&2; exit 1; }
+[ -f "$MODEL_FILE" ] || { echo "model not found: $MODEL_FILE (set XELA_MODELS_DIR / MODEL). See local/README.md." >&2; exit 1; }
+KEY=()
+[ -n "${LLAMA_API_KEY:-}" ] && KEY=(--api-key "$LLAMA_API_KEY")
+SPEC=()
+if [ "$MTP" = "1" ] && [ -f "$MTP_FILE" ]; then
+  SPEC=(-md "$MTP_FILE" --spec-type draft-mtp)
+fi
+exec "$BIN" \
+  -m "$MODEL_FILE" \
+  "${SPEC[@]}" "${KEY[@]}" \
+  --alias qwen3.6-27b \
+  -ngl 99 \
+  -c "$CTX" \
+  -fa on \
+  --cache-type-k q8_0 --cache-type-v q8_0 \
+  --cache-reuse 256 \
+  --cache-ram 0 --no-cache-idle-slots \
+  --jinja \
+  --temp 0.6 --top-p 0.95 --top-k 20 --min-p 0 \
+  --host 0.0.0.0 --port "$PORT"

package/local/start-tunnel.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# Expose the model server (localhost:8080) on the internet through ngrok and print the public URL.
+# The server must run with LLAMA_API_KEY: the key is the only protection of the public URL.
+#   NGROK_DOMAIN=yourname.ngrok-free.app start-tunnel.sh   fixed URL (free static domain from the ngrok dashboard)
+#   PORT=8080  XELA_MODELS_DIR=~/models                    defaults
+set -u
+PORT="${PORT:-8080}"
+MODELS="${XELA_MODELS_DIR:-$HOME/models}"
+command -v ngrok >/dev/null || { echo "ngrok is not installed: https://ngrok.com/download, then: ngrok config add-authtoken <token>" >&2; exit 1; }
+pgrep -x llama-server >/dev/null || { echo "llama-server is not running; start it with start-qwen.sh" >&2; exit 1; }
+KEY="${LLAMA_API_KEY:-$(cat "$MODELS/llama-api-key" 2>/dev/null)}"
+[ -z "$KEY" ] && echo "WARNING: no API key (LLAMA_API_KEY or $MODELS/llama-api-key): the public URL will be open to everyone" >&2
+pkill -x ngrok 2>/dev/null || true
+DOM=(); [ -n "${NGROK_DOMAIN:-}" ] && DOM=(--url "https://$NGROK_DOMAIN")
+nohup ngrok http "$PORT" "${DOM[@]}" --log "$MODELS/ngrok.log" --log-format json >/dev/null 2>&1 &
+disown
+URL=""
+for _ in $(seq 1 15); do
+  URL=$(curl -s http://127.0.0.1:4040/api/tunnels 2>/dev/null | grep -o '"public_url":"https://[^"]*"' | head -1 | cut -d'"' -f4)
+  [ -n "$URL" ] && break
+  sleep 1
+done
+[ -z "$URL" ] && { echo "ngrok did not start:" >&2; grep -o '"err":"[^"]*"' "$MODELS/ngrok.log" | tail -3 >&2; exit 1; }
+# ngrok answers 404 "tunnel not found" for a few seconds after start
+for _ in $(seq 1 20); do
+  code=$(curl -s -o /dev/null -w '%{http_code}' "$URL/v1/models")
+  [ "$code" != "404" ] && [ "$code" != "000" ] && break
+  sleep 1
+done
+AUTH=(); [ -n "$KEY" ] && AUTH=(-H "Authorization: Bearer $KEY")
+echo "Public URL:    $URL"
+echo "without key:   HTTP $(curl -s -o /dev/null -w '%{http_code}' "$URL/v1/models")  (expected 401)"
+echo "with key:      HTTP $(curl -s -o /dev/null -w '%{http_code}' "${AUTH[@]}" "$URL/v1/models")  (expected 200)"
+echo
+echo "On another computer:  npm install -g @xelauvas/xela-cli && xela-local --server $URL --key <key>"
+echo "Stop the tunnel:      pkill -x ngrok"

package/local/xela-local.sh

@@ -0,0 +1,139 @@
+#!/usr/bin/env bash
+# Run Xela against your own model server (llama-server). Works from any directory.
+#
+#   xela-local                     interactive (first run on a machine without a GPU asks for
+#                                  the server URL + API key once and saves them, like a login)
+#   xela-local -p "question"       one answer
+#   xela-local --setup             enter the server URL / API key again
+#   xela-local --server URL --key KEY   one-off override (also saved for next time)
+#
+# Env overrides (take precedence over the saved config):
+#   XELA_SERVER_URL=...            default http://localhost:8080; a remote host never starts a server
+#   LLAMA_API_KEY=...              key the server was started with (start-qwen.sh LLAMA_API_KEY)
+#   XELA_CONFIG_DIR=...            config dir (default ~/.xela-local, separate from ~/.claude)
+#   OPENAI_THINKING=off            no reasoning (faster, weaker on hard tasks)
+set -u
+HERE="$(cd "$(dirname "$(readlink -f "$0")")" && pwd)"
+ROOT="$(cd "$HERE/.." && pwd)"
+export CLAUDE_CONFIG_DIR="${XELA_CONFIG_DIR:-$HOME/.xela-local}"
+SERVER_CONF="$CLAUDE_CONFIG_DIR/server.env"
+MODEL_FILE="${XELA_MODEL_FILE:-${XELA_MODELS_DIR:-$HOME/models}/Qwen3.6-27B-UD-Q4_K_XL.gguf}"
+LOG="${XELA_SERVER_LOG:-${XELA_MODELS_DIR:-$HOME/models}/server.log}"
+
+# --- arguments handled here: --setup, --server, --key -------------------------------------
+SETUP=0; ARGS=()
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --setup) SETUP=1; shift ;;
+    --server) XELA_SERVER_URL="$2"; SETUP=2; shift 2 ;;
+    --key) LLAMA_API_KEY="$2"; SETUP=2; shift 2 ;;
+    *) ARGS+=("$1"); shift ;;
+  esac
+done
+set -- "${ARGS[@]+"${ARGS[@]}"}"
+
+# --- saved config (env wins) -------------------------------------------------------------
+if [ -f "$SERVER_CONF" ]; then
+  SAVED_URL=$(sed -n 's/^XELA_SERVER_URL=//p' "$SERVER_CONF" | tail -1)
+  SAVED_KEY=$(sed -n 's/^LLAMA_API_KEY=//p' "$SERVER_CONF" | tail -1)
+  : "${XELA_SERVER_URL:=$SAVED_URL}"
+  : "${LLAMA_API_KEY:=$SAVED_KEY}"
+fi
+[ -z "${LLAMA_API_KEY:-}" ] && [ -f "${XELA_MODELS_DIR:-$HOME/models}/llama-api-key" ] && \
+  LLAMA_API_KEY=$(cat "${XELA_MODELS_DIR:-$HOME/models}/llama-api-key")
+
+health() { # $1 url, $2 key
+  local a=(); [ -n "$2" ] && a=(-H "Authorization: Bearer $2")
+  # /v1/models requires the API key (unlike /health), so a wrong key fails here, not later
+  curl -sf --connect-timeout 5 "${a[@]}" "$1/v1/models" >/dev/null 2>&1
+}
+save_conf() {
+  mkdir -p "$CLAUDE_CONFIG_DIR"
+  printf 'XELA_SERVER_URL=%s\nLLAMA_API_KEY=%s\n' "$XELA_SERVER_URL" "${LLAMA_API_KEY:-}" > "$SERVER_CONF"
+  chmod 600 "$SERVER_CONF"
+}
+setup() {
+  echo "" >&2
+  echo "  Xela needs a model server (llama-server started with local/start-qwen.sh)." >&2
+  echo "  Enter its address, e.g. https://xxxx.ngrok-free.app or http://192.168.1.20:8080" >&2
+  echo "" >&2
+  while :; do
+    read -r -p "  Server URL [${XELA_SERVER_URL:-http://localhost:8080}]: " u </dev/tty
+    XELA_SERVER_URL="${u:-${XELA_SERVER_URL:-http://localhost:8080}}"
+    XELA_SERVER_URL="${XELA_SERVER_URL%/}"; XELA_SERVER_URL="${XELA_SERVER_URL%/v1}"
+    read -r -s -p "  API key (empty if the server has none): " k </dev/tty; echo "" >&2
+    [ -n "$k" ] && LLAMA_API_KEY="$k"
+    if health "$XELA_SERVER_URL" "${LLAMA_API_KEY:-}"; then
+      save_conf
+      echo "  Connected. Saved to $SERVER_CONF (xela-local --setup to change)." >&2
+      echo "" >&2
+      return 0
+    fi
+    echo "  Cannot reach $XELA_SERVER_URL with that key. Try again (Ctrl+C to quit)." >&2
+  done
+}
+
+if [ "$SETUP" = "1" ]; then
+  setup
+elif [ "$SETUP" = "2" ]; then
+  XELA_SERVER_URL="${XELA_SERVER_URL:-http://localhost:8080}"
+  health "$XELA_SERVER_URL" "${LLAMA_API_KEY:-}" || { echo "Model server not reachable at $XELA_SERVER_URL" >&2; exit 1; }
+  save_conf
+fi
+
+SERVER="${XELA_SERVER_URL:-http://localhost:8080}"
+case "$SERVER" in
+  http://localhost*|http://127.0.0.1*|http://0.0.0.0*) REMOTE=0 ;;
+  *) REMOTE=1 ;;
+esac
+
+if ! health "$SERVER" "${LLAMA_API_KEY:-}"; then
+  if [ "$REMOTE" = "1" ]; then
+    echo "Model server not reachable at $SERVER. Is it (and the tunnel) running? Run xela-local --setup to change it." >&2
+    exit 1
+  elif [ ! -f "$MODEL_FILE" ]; then
+    # No local model on this machine: first run → ask where the server is.
+    setup
+    SERVER="$XELA_SERVER_URL"
+  else
+    echo "Starting the local model server (log: $LOG)..." >&2
+    mkdir -p "$(dirname "$LOG")"
+    nohup "$HERE/start-qwen.sh" > "$LOG" 2>&1 &
+    for _ in $(seq 1 180); do
+      health "$SERVER" "${LLAMA_API_KEY:-}" && break
+      sleep 1
+    done
+    if ! health "$SERVER" "${LLAMA_API_KEY:-}"; then
+      echo "Server did not come up in 3 minutes. See $LOG" >&2
+      exit 1
+    fi
+  fi
+fi
+AUTH=(); [ -n "${LLAMA_API_KEY:-}" ] && AUTH=(-H "Authorization: Bearer $LLAMA_API_KEY")
+
+# Variables inherited from a real Claude Code session would mix the two apps.
+unset CLAUDE_CODE_MESSAGING_SOCKET CLAUDE_CODE_SESSION_KIND CLAUDE_CODE_SESSION_NAME CLAUDE_CODE_SESSION_LOG \
+      CLAUDE_CODE_ENTRYPOINT CLAUDECODE CLAUDE_CODE_SSE_PORT CLAUDE_CODE_AGENT CLAUDE_PLAN_FILE 2>/dev/null
+
+if [ ! -f "$CLAUDE_CONFIG_DIR/.claude.json" ]; then
+  mkdir -p "$CLAUDE_CONFIG_DIR"
+  echo '{"hasCompletedOnboarding": true, "numStartups": 1}' > "$CLAUDE_CONFIG_DIR/.claude.json"
+fi
+if [ ! -f "$CLAUDE_CONFIG_DIR/settings.json" ]; then
+  echo '{"theme": "dark", "skipAutoPermissionPrompt": true, "permissions": {"defaultMode": "auto"}}' > "$CLAUDE_CONFIG_DIR/settings.json"
+fi
+
+export DISABLE_INSTALLATION_CHECKS=1 DISABLE_AUTOUPDATER=1 CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL=1
+export DISABLE_LOGIN_COMMAND=1 DISABLE_LOGOUT_COMMAND=1 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
+export OPENAI_API_KEY="${OPENAI_API_KEY:-${LLAMA_API_KEY:-local}}"
+export OPENAI_BASE_URL="${OPENAI_BASE_URL:-$SERVER/v1}"
+export OPENAI_MODEL="${OPENAI_MODEL:-qwen3.6-27b}"
+
+# Real context size of the server (drives the context indicator and auto-compact); no python needed
+CTX=$(curl -s --connect-timeout 5 "${AUTH[@]}" "$SERVER/props" | grep -o '"n_ctx":[0-9]*' | head -1 | cut -d: -f2)
+CTX="${CTX:-65536}"
+export OPENAI_CONTEXT_WINDOW="$CTX"
+MAX_OUT=$(( CTX / 4 )); [ "$MAX_OUT" -lt 16384 ] && MAX_OUT=16384
+export OPENAI_MAX_TOKENS="${OPENAI_MAX_TOKENS:-$MAX_OUT}"
+
+exec "$ROOT/run.sh" "$@"

package/package.json

@@ -1,22 +1,36 @@
 {
   "name": "@xelauvas/xela-cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Xela — AI coding assistant powered by any model (OpenRouter, Groq, Ollama, DeepSeek, OpenAI)",
   "author": "xelauvas",
   "license": "MIT",
   "type": "module",
   "repository": {
     "type": "git",
-    "url": "https://github.com/xelauvas/codeclau.git"
+    "url": "git+https://github.com/xelauvas/codeclau.git"
   },
-  "keywords": ["ai", "coding", "assistant", "cli", "openrouter", "groq", "ollama", "deepseek", "xela"],
+  "keywords": [
+    "ai",
+    "coding",
+    "assistant",
+    "cli",
+    "openrouter",
+    "groq",
+    "ollama",
+    "deepseek",
+    "xela"
+  ],
   "bin": {
-    "xela": "./bin/xela.js"
+    "xela": "bin/xela.js",
+    "xela-local": "local/xela-local.sh",
+    "xela-tunnel": "local/start-tunnel.sh"
   },
   "files": [
     "bin/",
     "src/",
-    "start.js"
+    "start.js",
+    "local/",
+    "run.sh"
   ],
   "scripts": {
     "start": "node --import ./src/_shims/register.js ./src/entrypoints/cli.tsx",

package/run.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+# Run Claude Code with any OpenAI-compatible backend
+#
+# Providers (auto-detected from key prefix or OPENAI_BASE_URL):
+#
+#   OpenAI:      OPENAI_API_KEY=sk-proj-...
+#   Groq (free): OPENAI_API_KEY=gsk_...
+#   OpenRouter:  OPENAI_API_KEY=sk-or-...
+#   DeepSeek:    OPENAI_API_KEY=sk-... OPENAI_BASE_URL=https://api.deepseek.com
+#   Moonshot:    OPENAI_API_KEY=sk-... OPENAI_BASE_URL=https://api.moonshot.cn/v1
+#   Ollama:      OPENAI_API_KEY=ollama OPENAI_BASE_URL=http://localhost:11434/v1
+#   Mistral:     OPENAI_API_KEY=... OPENAI_BASE_URL=https://api.mistral.ai/v1
+#   Together:    OPENAI_API_KEY=... OPENAI_BASE_URL=https://api.together.xyz/v1
+#
+# Optional: OPENAI_MODEL=model-name (auto-detected per provider)
+
+if [ -z "$OPENAI_API_KEY" ]; then
+  echo "Error: OPENAI_API_KEY is not set"
+  echo ""
+  echo "Usage examples:"
+  echo "  OPENAI_API_KEY=sk-...  ./run.sh              # OpenAI (gpt-4o)"
+  echo "  OPENAI_API_KEY=gsk_... ./run.sh              # Groq free (llama-3.3-70b)"
+  echo "  OPENAI_API_KEY=sk-or-... ./run.sh            # OpenRouter"
+  echo "  OPENAI_API_KEY=sk-... OPENAI_BASE_URL=https://api.deepseek.com ./run.sh  # DeepSeek"
+  exit 1
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+exec node \
+  --import "$SCRIPT_DIR/src/_shims/register.js" \
+  "$SCRIPT_DIR/start.js" \
+  "$@"

package/src/Tool.ts

@@ -152,7 +152,7 @@ export type CompactProgressEvent =
       type: 'hooks_start'
       hookType: 'pre_compact' | 'post_compact' | 'session_start'
     }
-  | { type: 'compact_start' }
+  | { type: 'compact_start'; preCompactTokenCount?: number }
   | { type: 'compact_end' }
 
 export type ToolUseContext = {

package/src/_shims/_generated_stubs/_universal_stub.mjs

@@ -0,0 +1,168 @@
+// Universal stub — exports all known names for unresolved modules
+export default {};
+
+// --- Arrays (names ending in S, LIST, TOOLS, etc.) ---
+export const BROWSER_TOOLS = [];
+export const DEFAULT_SESSION_TIMEOUT_MS = [];
+export const RARITY_COLORS = [];
+export const EYES = [];
+export const HATS = [];
+export const RARITIES = [];
+export const RARITY_WEIGHTS = [];
+export const SPECIES = [];
+export const STAT_NAMES = [];
+export const AGENT_PATHS = [];
+export const DEFAULT_GRANT_FLAGS = [];
+export const MEMORY_TYPE_VALUES = [];
+export const SYNC_KEYS = [];
+export const CUSTOMIZATION_SURFACES = [];
+export const FIND_KEYS = [];
+export const OPERATORS = [];
+export const SIMPLE_MOTIONS = [];
+export const TEXT_OBJ_SCOPES = [];
+export const TEXT_OBJ_TYPES = [];
+export const SOURCES = [];
+export const FRAME_INTERVAL_MS = [];
+export const ONE_SHOT_BUILTIN_AGENT_TYPES = [];
+export const REPL_ONLY_TOOLS = [];
+export const SETTING_SOURCES = [];
+export const MDM_SUBPROCESS_TIMEOUT_MS = [];
+
+// --- Functions (is/has/get/set/create/handle...) ---
+export const isBackgroundTask = () => undefined;
+export const isInProcessTeammateTask = () => undefined;
+export const isMcpServerCommandEntry = () => undefined;
+export const isMcpServerNameEntry = () => undefined;
+export const isMcpServerUrlEntry = () => undefined;
+export const isPaneBackend = () => undefined;
+export const isOperatorKey = () => undefined;
+export const isTextObjScopeKey = () => undefined;
+export const isReplModeEnabled = () => undefined;
+export const isSettingSourceEnabled = () => undefined;
+export const getSourceDisplayName = () => undefined;
+export const getSettingSourceName = () => undefined;
+export const getSwarmSocketName = () => undefined;
+export const getSettingSourceDisplayNameLowercase = () => undefined;
+export const getSettingSourceDisplayNameCapitalized = () => undefined;
+export const getEnabledSettingSources = () => undefined;
+export const getMacOSPlistPaths = () => undefined;
+export const getSyntaxTheme = () => undefined;
+export const createClaudeForChromeMcpServer = () => undefined;
+export const createInitialPersistentState = () => undefined;
+export const createInitialVimState = () => undefined;
+export const parseSettingSourcesFlag = () => undefined;
+export const reduceAnsiCodes = () => undefined;
+
+// --- Constants/schemas/values ---
+export const BRIDGE_LOGIN_INSTRUCTION = undefined;
+export const BRIDGE_LOGIN_ERROR = undefined;
+export const axolotl = undefined;
+export const blob = undefined;
+export const cactus = undefined;
+export const capybara = undefined;
+export const cat = undefined;
+export const chonk = undefined;
+export const dragon = undefined;
+export const duck = undefined;
+export const ghost = undefined;
+export const goose = undefined;
+export const mushroom = undefined;
+export const octopus = undefined;
+export const owl = undefined;
+export const penguin = undefined;
+export const rabbit = undefined;
+export const robot = undefined;
+export const snail = undefined;
+export const turtle = undefined;
+export const ElicitRequestSchema = undefined;
+export const ElicitationCompleteNotificationSchema = undefined;
+export const REMOTE_CONTROL_DISCONNECTED_MSG = undefined;
+export const CallToolRequestSchema = undefined;
+export const ListToolsRequestSchema = undefined;
+export const defaultStyle = undefined;
+export const connectResponseSchema = undefined;
+export const CallToolResultSchema = undefined;
+export const ErrorCode = undefined;
+export const ListPromptsResultSchema = undefined;
+export const ListResourcesResultSchema = undefined;
+export const ListRootsRequestSchema = undefined;
+export const ListToolsResultSchema = undefined;
+export const McpError = undefined;
+export const McpJsonConfigSchema = undefined;
+export const McpServerConfigSchema = undefined;
+export const PromptListChangedNotificationSchema = undefined;
+export const ResourceListChangedNotificationSchema = undefined;
+export const ToolListChangedNotificationSchema = undefined;
+export const ConfigScopeSchema = undefined;
+export const PolicyLimitsResponseSchema = undefined;
+export const SettingsSchema = undefined;
+export const RemoteManagedSettingsResponseSchema = undefined;
+export const UserSyncDataSchema = undefined;
+export const TeamMemoryDataSchema = undefined;
+export const TeamMemoryTooManyEntriesSchema = undefined;
+export const HooksSchema = undefined;
+export const appendCappedMessage = undefined;
+export const inputSchema = undefined;
+export const outputSchema = undefined;
+export const gitDiffSchema = undefined;
+export const hunkSchema = undefined;
+export const ReadResourceResultSchema = undefined;
+export const TodoListSchema = undefined;
+export const McpStdioServerConfigSchema = undefined;
+export const DEFAULT_UPLOAD_CONCURRENCY = undefined;
+export const FILE_COUNT_LIMIT = undefined;
+export const OUTPUTS_SUBDIR = undefined;
+export const JSONRPCMessageSchema = undefined;
+export const MAX_VIM_COUNT = undefined;
+export const AGENT_TOOL_NAME = undefined;
+export const LEGACY_AGENT_TOOL_NAME = undefined;
+export const EXIT_PLAN_MODE_V2_TOOL_NAME = undefined;
+export const TEAM_CREATE_TOOL_NAME = undefined;
+export const CLAUDE_FOLDER_PERMISSION_PATTERN = undefined;
+export const FILE_EDIT_TOOL_NAME = undefined;
+export const GLOBAL_CLAUDE_FOLDER_PERMISSION_PATTERN = undefined;
+export const SKILL_TOOL_NAME = undefined;
+export const TEAM_LEAD_NAME = undefined;
+export const TMUX_COMMAND = undefined;
+export const VERIFICATION_AGENT_TYPE = undefined;
+export const TODO_WRITE_TOOL_NAME = undefined;
+export const TASK_CREATE_TOOL_NAME = undefined;
+export const TASK_OUTPUT_TOOL_NAME = undefined;
+export const ENTER_PLAN_MODE_TOOL_NAME = undefined;
+export const NOTEBOOK_EDIT_TOOL_NAME = undefined;
+export const SEND_MESSAGE_TOOL_NAME = undefined;
+export const TASK_GET_TOOL_NAME = undefined;
+export const TASK_LIST_TOOL_NAME = undefined;
+export const TASK_UPDATE_TOOL_NAME = undefined;
+export const ENTER_WORKTREE_TOOL_NAME = undefined;
+export const EXIT_WORKTREE_TOOL_NAME = undefined;
+export const WORKFLOW_TOOL_NAME = undefined;
+export const TEAM_DELETE_TOOL_NAME = undefined;
+export const ContinuousEventPriority = undefined;
+export const DefaultEventPriority = undefined;
+export const DiscreteEventPriority = undefined;
+export const NoEventPriority = undefined;
+export const ConcurrentRoot = undefined;
+export const LegacyRoot = undefined;
+export const REPL_TOOL_NAME = undefined;
+export const EXIT_PLAN_MODE_TOOL_NAME = undefined;
+export const CONFIG_TOOL_NAME = undefined;
+export const FILE_UNEXPECTEDLY_MODIFIED_ERROR = undefined;
+export const TOOL_SEARCH_TOOL_NAME = undefined;
+export const SWARM_SESSION_NAME = undefined;
+export const TEAMMATE_COMMAND_ENV_VAR = undefined;
+export const PLUTIL_ARGS_PREFIX = undefined;
+export const PLUTIL_PATH = undefined;
+export const WINDOWS_REGISTRY_KEY_PATH_HKCU = undefined;
+export const WINDOWS_REGISTRY_KEY_PATH_HKLM = undefined;
+export const WINDOWS_REGISTRY_VALUE_NAME = undefined;
+export const CLAUDE_CODE_SETTINGS_SCHEMA_URL = undefined;
+export const HIDDEN_SESSION_NAME = undefined;
+export const SWARM_VIEW_WINDOW_NAME = undefined;
+export const ColorDiff = undefined;
+export const ColorFile = undefined;
+export const ansiCodesToString = undefined;
+export const diffAnsiCodes = undefined;
+export const styledCharsFromTokens = undefined;
+export const tokenize = undefined;
+export const undoAnsiCodes = undefined;

package/src/_shims/_generated_stubs/stub_346f96741420f62caece15b196e233c6.mjs

@@ -0,0 +1,19 @@
+// Generated stub for missing module ./sdk/runtimeTypes.js (imported by entrypoints/agentSdkTypes.ts)
+export const AnyZodRawShape = undefined;
+export const ForkSessionOptions = undefined;
+export const ForkSessionResult = undefined;
+export const GetSessionInfoOptions = undefined;
+export const GetSessionMessagesOptions = undefined;
+export const InferShape = undefined;
+export const InternalOptions = undefined;
+export const InternalQuery = undefined;
+export const ListSessionsOptions = undefined;
+export const McpSdkServerConfigWithInstance = undefined;
+export const Options = undefined;
+export const Query = undefined;
+export const SDKSession = undefined;
+export const SDKSessionOptions = undefined;
+export const SdkMcpToolDefinition = undefined;
+export const SessionMessage = undefined;
+export const SessionMutationOptions = undefined;
+export default {};

package/src/_shims/_generated_stubs/stub_4b79af2a6ac1af5a53a55fd666b2bbb4.mjs

@@ -0,0 +1,3 @@
+// Generated stub for missing module @ant/claude-for-chrome-mcp (imported by utils/claudeInChrome/setup.ts)
+export const BROWSER_TOOLS = [];
+export default {};

package/src/_shims/_generated_stubs/stub_94345ddeadacc184ff895597ec5abf71.mjs

@@ -0,0 +1,6 @@
+// Generated stub for missing module color-diff-napi (imported by components/StructuredDiff/colorDiff.ts)
+export const ColorDiff = undefined;
+export const ColorFile = undefined;
+export const getSyntaxTheme = () => undefined;
+export const SyntaxTheme = undefined;
+export default {};

package/src/_shims/_generated_stubs/stub_99fa0bc272643c549d8a2ec6d578436f.mjs

@@ -0,0 +1,3 @@
+// Generated stub for missing module ../tools/TungstenTool/TungstenLiveMonitor.js (imported by screens/REPL.tsx)
+export const TungstenLiveMonitor = undefined;
+export default {};

package/src/_shims/_generated_stubs/stub_e3451b131fcaf272a2a75270b9a427a3.mjs

@@ -0,0 +1,9 @@
+// Generated stub for missing module ./types.js (imported by utils/filePersistence/filePersistence.ts)
+export const DEFAULT_UPLOAD_CONCURRENCY = '';
+export const FailedPersistence = undefined;
+export const FILE_COUNT_LIMIT = '';
+export const FilesPersistedEventData = undefined;
+export const OUTPUTS_SUBDIR = '';
+export const PersistedFile = undefined;
+export const TurnStartTime = undefined;
+export default {};

package/src/_shims/_generated_stubs/text_stub.mjs

@@ -0,0 +1 @@
+export default '';