@jacobbd/relay-ai 0.4.6 → 0.4.8

package/README.md

@@ -186,6 +186,7 @@ relay-ai ui
 Opens a browser-based dashboard on a random local port. From the UI you can:
 
 - **Launch any supported tool** — app cards for Claude Code CLI, Codex CLI, Gemini CLI, Antigravity CLI, Antigravity App, Antigravity IDE, Claude Code Desktop, and the ChatGPT Desktop app (Codex mode). Select a provider and model in the card, then click **Launch** — a native terminal opens with the selection pre-wired. No second picker in the terminal.
+- **Keep Claude Code's Anthropic login** — on the Claude Code CLI card, check **Keep my Anthropic login and add Relay models** to keep your normal Claude models while adding the selected Relay model and compatible favorites. This option is not shown for Claude Desktop.
 - **Manage General Favorites** — the sidebar shows your saved favorite models with a slot indicator (Slots used X/20). Favorites launch through all supported agents.
 - **Manage Antigravity Favorites** — separate favorites panel for Antigravity sessions.
 - **Manage providers** — add providers from templates, delete providers, and refresh model lists inline, all without leaving the browser.
@@ -201,6 +202,18 @@ relay-ai claude
 
 First run: pick a provider from your registry (or complete the inline setup wizard). If you've added OpenCode Zen/Go, those appear alongside registry providers like Groq, Nvidia, or DeepSeek.
 
+After you choose a compatible Relay model, the wizard asks whether you want to keep your normal Claude models available too. Choose **Yes** to use the Relay model alongside your existing Anthropic login, or **No** for the existing Relay-only launch.
+
+To skip that question, use `--http-proxy`. A selected model does not need to be a favorite:
+
+```bash
+relay-ai claude --http-proxy --provider moonshot --model kimi-k3
+```
+
+Using `--http-proxy` without a provider/model keeps native Claude as the starting model and adds any compatible saved favorites. Relay models cannot be inserted into Claude Code's built-in model picker, so the terminal prints the exact `/model relay:<provider>:<model>` commands you can use to switch. The temporary local connection is password-protected, uses a per-session certificate, and closes automatically when Claude Code exits. Existing non-local network or corporate proxy settings are rejected with a clear error because proxy chaining is not supported yet.
+
+> **Compatibility:** This mixed Anthropic + Relay mode currently supports Claude Code connected directly to Anthropic. It does not preserve Google Vertex AI configuration. Vertex users should continue using their normal Claude Code launch or Relay-only mode.
+
 #### Favorite models and mid-session switching
 
 Save the models you bounce between:
@@ -213,6 +226,8 @@ Add up to 20 favorites from Zen, Go, or any OpenCode-configured provider. When y
 
 No favorites? Launch works like before: single model, no switch menu. `--dry-run` ignores saved favorites so you can preview a single-model launch.
 
+That built-in favorites catalog applies to **Relay-only mode** (choose **No** when asked whether to keep your normal Claude models). In mixed Anthropic + Relay mode, compatible favorites are available through the printed `/model relay:<provider>:<model>` commands instead; Claude Code cannot add them to its built-in picker.
+
 #### `relay-ai claude` options
 
 | Flag | Description |
@@ -220,6 +235,7 @@ No favorites? Launch works like before: single model, no switch menu. `--dry-run
 | `--dry-run` | Run the full wizard but preview the launch command instead of executing |
 | `--setup` | Reminder to use `relay-ai providers` for provider setup |
 | `--trace` | Write debug logs to `~/.relay-ai/logs/` and show errors on exit |
+| `--http-proxy` | Keep the normal Anthropic login/models and add the selected model plus compatible favorites |
 | `--help` | Show command help |
 | `--version` | Show version |
 
@@ -227,6 +243,7 @@ No favorites? Launch works like before: single model, no switch menu. `--dry-run
 relay-ai claude --dry-run
 relay-ai claude --setup
 relay-ai claude --trace
+relay-ai claude --http-proxy --provider moonshot --model kimi-k3
 ```
 
 Claude Code flags and session IDs pass through unchanged:
@@ -491,6 +508,8 @@ When you launch, relay-ai builds a clean child environment:
 
 When Claude Code exits (normal exit, Ctrl+C, terminal close), your shell is unchanged. No cleanup step. No restore needed.
 
+In `--http-proxy` mode, relay-ai does not replace your Anthropic credential. It removes stale third-party endpoint/cloud overrides from the child process, sets a password-protected loopback proxy plus a temporary CA bundle, and forwards native Anthropic requests—including their original auth and body—unchanged. Only the selected Relay model and compatible favorites are allowed to use registry provider credentials.
+
 **Caveat: Claude Code persists the model.** relay-ai doesn't edit `~/.claude/settings.json`, but Claude Code saves the model you launched with (via `--model` and `ANTHROPIC_MODEL`). A later bare `claude` launch may still show that model, e.g. `anthropic-opencode-go__deepseek-v4-flash` from a prior relay-ai session. To get back to a first-party default, run `claude --model sonnet` (or your preferred Claude model), or remove the `"model"` key from `~/.claude/settings.json`. If you used the favorites switch menu, Claude Code may also cache the gateway catalog at `~/.claude/cache/gateway-models.json`. Delete that file if `/model` shows stale entries from a dead proxy.
 
 ### Model compatibility
@@ -570,7 +589,9 @@ The deprecated `OPENCODE_STARTER_HOME` env var still works as a fallback for `RE
 
 ## Contributing
 
-Private beta right now. Issues and PRs welcome on GitHub.
+Private beta right now. Issues and focused PRs are welcome on GitHub.
+
+Please read [CONTRIBUTING.md](CONTRIBUTING.md) before starting. Submit one feature or fix per PR, and discuss large or security-sensitive changes with a maintainer first.
 
 ## Support
 

package/dist/{chunk-YM6G7BHE.js → chunk-I3SSHXSP.js}

@@ -11,7 +11,7 @@ import { join } from "path";
 // package.json
 var package_default = {
   name: "@jacobbd/relay-ai",
-  version: "0.4.6",
+  version: "0.4.8",
   publishConfig: {
     access: "public"
   },
@@ -77,6 +77,7 @@ var package_default = {
     ai: "^6.0.197",
     "gitlab-ai-provider": "^6.8.0",
     "ipaddr.js": "^2.4.0",
+    "node-forge": "^1.4.0",
     open: "^11.0.0",
     picocolors: "^1.1.1",
     "smol-toml": "^1.6.1",
@@ -86,6 +87,7 @@ var package_default = {
   },
   devDependencies: {
     "@types/node": "^22.0.0",
+    "@types/node-forge": "^1.3.14",
     "@types/ws": "^8.18.1",
     "@vitest/coverage-v8": "^2.1.9",
     tsup: "^8.0.0",
@@ -1677,6 +1679,7 @@ function loadPreferences() {
     lastGeminiModel: config.lastGeminiModel,
     lastAntigravityProvider: config.lastAntigravityProvider,
     lastAntigravityModel: config.lastAntigravityModel,
+    lastClaudeTransparentMode: config.lastClaudeTransparentMode,
     recentModelsByProvider: config.recentModelsByProvider,
     favoriteModels: config.favoriteModels,
     antigravityCliFavoriteModels: config.antigravityCliFavoriteModels,
@@ -1697,6 +1700,7 @@ function savePreferences(prefs) {
   if (prefs.lastGeminiModel !== void 0) config.lastGeminiModel = prefs.lastGeminiModel;
   if (prefs.lastAntigravityProvider !== void 0) config.lastAntigravityProvider = prefs.lastAntigravityProvider;
   if (prefs.lastAntigravityModel !== void 0) config.lastAntigravityModel = prefs.lastAntigravityModel;
+  if (prefs.lastClaudeTransparentMode !== void 0) config.lastClaudeTransparentMode = prefs.lastClaudeTransparentMode;
   if (prefs.recentModelsByProvider !== void 0) config.recentModelsByProvider = prefs.recentModelsByProvider;
   if (prefs.favoriteModels !== void 0) config.favoriteModels = prefs.favoriteModels;
   if (prefs.antigravityCliFavoriteModels !== void 0) config.antigravityCliFavoriteModels = prefs.antigravityCliFavoriteModels;
@@ -1909,7 +1913,7 @@ function getInstalledClaudeVersion() {
   return "2.1.183";
 }
 function buildClaudeArgs(model, extraArgs) {
-  return ["--model", model, ...extraArgs];
+  return model ? ["--model", model, ...extraArgs] : [...extraArgs];
 }
 function launchClaude(env, model, extraArgs) {
   return new Promise((resolve) => {
@@ -1947,14 +1951,24 @@ function launchClaude(env, model, extraArgs) {
     const forward = (signal) => {
       child.kill(signal);
     };
-    process.once("SIGINT", () => forward("SIGINT"));
-    process.once("SIGTERM", () => forward("SIGTERM"));
-    child.on("exit", (code) => {
+    const onSigint = () => forward("SIGINT");
+    const onSigterm = () => forward("SIGTERM");
+    const onSighup = () => forward("SIGHUP");
+    const cleanup = () => {
       restore();
+      process.off("SIGINT", onSigint);
+      process.off("SIGTERM", onSigterm);
+      process.off("SIGHUP", onSighup);
+    };
+    process.once("SIGINT", onSigint);
+    process.once("SIGTERM", onSigterm);
+    process.once("SIGHUP", onSighup);
+    child.on("exit", (code) => {
+      cleanup();
       resolve(code ?? 0);
     });
     child.on("error", (err) => {
-      restore();
+      cleanup();
       resolve(1);
     });
   });
@@ -5814,6 +5828,54 @@ function startProxy(completionsUrl, modelId, debug = false, contextWindow, sdk,
   }], clientModelId, debug);
 }
 
+// src/catalog.ts
+function localModelToRoute(lp, model) {
+  if (model.modelFormat === "anthropic" && !model.baseUrl) return null;
+  if (model.modelFormat === "openai" && !isSdkMigratedNpm(model.npm) && !model.completionsUrl) return null;
+  const upstreamUrl = model.modelFormat === "cloud-code" ? model.baseUrl ?? ANTIGRAVITY_BASE_URLS[0] : model.modelFormat === "anthropic" ? model.baseUrl : model.completionsUrl;
+  return {
+    aliasId: claudeCodeClientModelId(aliasModelId(model.id, lp.id), model.contextWindow),
+    realModelId: model.upstreamModelId,
+    displayName: `${model.name || model.id} (${lp.name})`,
+    upstreamUrl: upstreamUrl ?? "",
+    apiKey: lp.apiKey,
+    modelFormat: model.modelFormat,
+    contextWindow: model.contextWindow,
+    npm: model.npm,
+    baseURL: model.apiBaseUrl,
+    providerId: lp.id,
+    authType: lp.authType,
+    oauthAccountId: lp.oauthAccountId,
+    providerData: lp.providerData,
+    headers: lp.headers,
+    supportedParameters: model.supportedParameters,
+    reasoning: model.reasoning,
+    interleavedReasoningField: model.interleavedReasoningField,
+    useResponsesLite: model.useResponsesLite,
+    preferWebSockets: model.preferWebSockets
+  };
+}
+function makeRouteResolver(localProviders) {
+  return (providerId, modelId) => {
+    const provider = localProviders?.find((lp) => lp.id === providerId);
+    const model = provider?.models.find((m) => m.id === modelId);
+    return provider && model ? localModelToRoute(provider, model) ?? void 0 : void 0;
+  };
+}
+function buildCatalogRoutes(startingRoute, favorites, resolveRoute, max = MAX_MODEL_CATALOG) {
+  const droppedFavorites = [];
+  const tail = favorites.map((fav) => {
+    const route = resolveRoute(fav.providerId, fav.modelId);
+    if (!route) droppedFavorites.push(fav);
+    return route;
+  }).filter((route) => route !== void 0);
+  const routes = [
+    startingRoute,
+    ...tail.filter((route) => route.aliasId !== startingRoute.aliasId)
+  ].slice(0, max);
+  return { routes, droppedFavorites };
+}
+
 // src/data/model-incompatible.json
 var model_incompatible_default = {
   schema_version: "1",
@@ -8235,6 +8297,52 @@ function favoriteProviderDisplayName(provider) {
   return provider.name;
 }
 
+// src/http-proxy/routes.ts
+var HTTP_PROXY_MODEL_PREFIX = "relay:";
+function httpProxyModelId(providerId, modelId) {
+  return `${HTTP_PROXY_MODEL_PREFIX}${providerId}:${modelId}`;
+}
+function supportsClaudeTransparentMode(model) {
+  return model.modelFormat === "openai" && isSdkMigratedNpm(model.npm);
+}
+function buildHttpProxyRoutes(providers, favorites, selected, max = MAX_MODEL_CATALOG) {
+  const routes = [];
+  const unavailable = [];
+  const unsupported = [];
+  const seen = /* @__PURE__ */ new Set();
+  const requested = selected ? [selected, ...favorites] : favorites;
+  for (const item of requested) {
+    const requestKey = `${item.providerId}\0${item.modelId}`;
+    if (seen.has(requestKey)) continue;
+    seen.add(requestKey);
+    if (routes.length >= max) break;
+    const provider = providers.find((candidate) => candidate.id === item.providerId);
+    const model = provider?.models.find((candidate) => candidate.id === item.modelId);
+    if (!provider || !model) {
+      unavailable.push(item);
+      continue;
+    }
+    if (!supportsClaudeTransparentMode(model)) {
+      unsupported.push(item);
+      continue;
+    }
+    const route = localModelToRoute(provider, model);
+    if (!route || !route.apiKey.trim()) {
+      unavailable.push(item);
+      continue;
+    }
+    routes.push({
+      ...route,
+      aliasId: claudeCodeClientModelId(
+        httpProxyModelId(provider.id, model.id),
+        model.contextWindow
+      ),
+      displayName: `${model.name || model.id} (${provider.name})`
+    });
+  }
+  return { routes, unavailable, unsupported };
+}
+
 // src/opencode-serve.ts
 import { execSync as execSync2, spawn as spawn2 } from "child_process";
 import { existsSync as existsSync10 } from "fs";
@@ -10349,6 +10457,7 @@ async function launchOrRestartClaudeApp(prompt = "Restart Claude Desktop to appl
 
 export {
   BACKENDS,
+  CONFLICTING_ENV_VARS,
   MAX_MODEL_CATALOG,
   VERTEX_ANTHROPIC_NPM,
   VERSION,
@@ -10358,7 +10467,6 @@ export {
   buildClaudeCodeBillingSystemLine,
   selectBetaFlags,
   injectClaudeIdentity,
-  isSdkMigratedNpm,
   maxToolsForNpm,
   createLanguageModel,
   getReasoningCapabilities,
@@ -10507,6 +10615,8 @@ export {
   aliasModelId,
   startProxyCatalog,
   startProxy,
+  makeRouteResolver,
+  buildCatalogRoutes,
   cachedModelToLocal,
   fetchProviderCatalog,
   providersForPicker,
@@ -10550,6 +10660,9 @@ export {
   findClaudeApp,
   isClaudeAppRunning,
   quitClaudeAppGracefully,
-  launchOrRestartClaudeApp
+  launchOrRestartClaudeApp,
+  httpProxyModelId,
+  supportsClaudeTransparentMode,
+  buildHttpProxyRoutes
 };
-//# sourceMappingURL=chunk-YM6G7BHE.js.map
+//# sourceMappingURL=chunk-I3SSHXSP.js.map