claude-connect 0.1.6 → 0.1.7

package/README.md

@@ -1,11 +1,11 @@
 # Claude Connect
 
-> Conecta `Claude Code` con `OpenCode Go`, `Zen`, `Kimi`, `DeepSeek`, `Ollama`, `OpenAI`, `OpenRouter` y `Qwen` desde una interfaz de consola clara, rápida y reversible.
+> Conecta `Claude Code` con `OpenCode Go`, `Zen`, `Kimi`, `DeepSeek`, `Ollama`, `OpenAI`, `Inception Labs`, `OpenRouter` y `Qwen` desde una interfaz de consola clara, rápida y reversible.
 
 [![npm version](https://img.shields.io/npm/v/claude-connect?style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/claude-connect)
 [![node](https://img.shields.io/badge/node-%3E%3D22-2f7d32?style=for-the-badge&logo=node.js&logoColor=white)](https://nodejs.org/)
 [![license](https://img.shields.io/badge/license-MIT-0f172a?style=for-the-badge)](./LICENSE)
-[![providers](https://img.shields.io/badge/providers-OpenCode%20Go%20%7C%20Zen%20%7C%20Kimi%20%7C%20DeepSeek%20%7C%20Ollama%20%7C%20OpenAI%20%7C%20OpenRouter%20%7C%20Qwen-0ea5e9?style=for-the-badge)](https://www.npmjs.com/package/claude-connect)
+[![providers](https://img.shields.io/badge/providers-OpenCode%20Go%20%7C%20Zen%20%7C%20Kimi%20%7C%20DeepSeek%20%7C%20Ollama%20%7C%20OpenAI%20%7C%20Inception%20Labs%20%7C%20OpenRouter%20%7C%20Qwen-0ea5e9?style=for-the-badge)](https://www.npmjs.com/package/claude-connect)
 
 ## Why Claude Connect
 
@@ -13,7 +13,7 @@
 
 ### Highlights
 
-- `OpenCode Go`, `Zen`, `Kimi`, `DeepSeek`, `Ollama`, `OpenAI`, `OpenRouter` y `Qwen` listos desde el primer arranque
+- `OpenCode Go`, `Zen`, `Kimi`, `DeepSeek`, `Ollama`, `OpenAI`, `Inception Labs`, `OpenRouter` y `Qwen` listos desde el primer arranque
 - soporte para `Token` y `OAuth` cuando el proveedor lo permite
 - API keys compartidas por proveedor para no repetir el mismo token en cada modelo
 - activación reversible sobre la instalación real de `Claude Code`
@@ -80,6 +80,7 @@ Al activar:
 - `DeepSeek` apunta a `https://api.deepseek.com/anthropic`
 - `Ollama` pide una URL local o remota, valida `/api/tags` y usa el gateway local sobre `.../api/chat`
 - `OpenAI` usa el gateway local sobre `https://api.openai.com/v1/chat/completions`
+- `Inception Labs` usa el gateway local sobre `https://api.inceptionlabs.ai/v1/chat/completions`
 - `OpenRouter` usa `openrouter/free` por gateway sobre `https://openrouter.ai/api/v1`
 - `Qwen` apunta al gateway local `http://127.0.0.1:4310/anthropic`
 
@@ -93,6 +94,7 @@ Al activar:
 | `DeepSeek` | `deepseek-chat`, `deepseek-reasoner` | `Token` | Directa |
 | `Ollama` | modelos descubiertos desde tu servidor | `Servidor Ollama` | Gateway local |
 | `OpenAI` | `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.3-codex`, `gpt-5.2-codex`, `gpt-5.2`, `gpt-5.1-codex-max`, `gpt-5.1-codex-mini` | `Token` | Gateway local |
+| `Inception Labs` | `mercury-2` | `Token` | Gateway local |
 | `OpenRouter` | `openrouter/free` | `Token` | Gateway local |
 | `Qwen` | `qwen3-coder-plus` | `OAuth`, `Token` | Gateway local |
 
@@ -118,6 +120,16 @@ Nota sobre `OpenAI`:
   - https://platform.openai.com/docs/api-reference/authentication
   - https://developers.openai.com/api/docs/models
 
+Nota sobre `Inception Labs`:
+
+- esta primera integracion expone solo `mercury-2`, que es el modelo chat-compatible oficial en `v1/chat/completions`
+- `Mercury Edit 2` no se publica todavia en Claude Connect porque usa endpoints `fim/edit` que no encajan con Claude Code en esta arquitectura
+- autenticacion soportada: `API key`
+- referencias oficiales:
+  - https://docs.inceptionlabs.ai/get-started/get-started
+  - https://docs.inceptionlabs.ai/get-started/authentication
+  - https://docs.inceptionlabs.ai/get-started/models
+
 Nota sobre `Ollama`:
 
 - la URL del servidor se define al crear la conexión
@@ -151,14 +163,16 @@ Ahí viven:
 El catálogo SQLite local se genera automáticamente en:
 
 ```text
-storage/claude-connect.sqlite
+Linux: ~/.claude-connect/storage/claude-connect.sqlite
+Windows: %APPDATA%\claude-connect\storage\claude-connect.sqlite
 ```
 
 Importante:
 
 - esa base ya no se versiona en git
 - el catálogo se siembra desde `src/data/catalog-store.js`
-- esto evita conflictos molestos al hacer `git pull`
+- ya no se crea en la carpeta donde ejecutas el comando
+- esto evita conflictos molestos al hacer `git pull` y carpetas `storage/` accidentales en proyectos ajenos
 
 ## Claude Code Switching
 
@@ -175,6 +189,7 @@ Eso permite:
 - activar otro proveedor sin tocar archivos manualmente
 - evitar el `Auth conflict` entre sesión `claude.ai` y `API key`
 - volver a tu estado original con `Revertir Claude`
+- bloquear la activación si `Claude Code` no está realmente instalado todavía
 
 ## Qwen OAuth
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-connect",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "CLI para configurar Claude Code con proveedores de modelos externos",
   "author": "wmcarlosv",
   "type": "module",

package/src/data/catalog-store.js

@@ -1,8 +1,14 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { DatabaseSync } from 'node:sqlite';
+import { resolveClaudeConnectHomeSync } from '../lib/app-paths.js';
 
-export const defaultCatalogDbPath = path.join(process.cwd(), 'storage', 'claude-connect.sqlite');
+export function getDefaultCatalogDbPath(options = {}) {
+  const pathModule = options.platform === 'win32' ? path.win32 : path.posix;
+  return pathModule.join(resolveClaudeConnectHomeSync(options), 'storage', 'claude-connect.sqlite');
+}
+
+export const defaultCatalogDbPath = getDefaultCatalogDbPath();
 
 const schemaSql = `
 PRAGMA foreign_keys = ON;
@@ -673,6 +679,45 @@ const seedProviders = [
       }
     ]
   },
+  {
+    id: 'inception',
+    name: 'Inception Labs',
+    vendor: 'Inception Labs',
+    description: 'Inception Platform con Mercury 2 sobre un endpoint OpenAI-compatible. Claude Code se conecta a traves del gateway local para mantener compatibilidad Anthropic y herramientas.',
+    docsUrl: 'https://docs.inceptionlabs.ai/get-started/get-started',
+    docsVerifiedAt: '2026-04-03',
+    baseUrl: 'https://api.inceptionlabs.ai/v1',
+    defaultModelId: 'mercury-2',
+    defaultAuthMethodId: 'token',
+    defaultApiKeyEnvVar: 'INCEPTION_API_KEY',
+    models: [
+      {
+        id: 'mercury-2',
+        name: 'Mercury 2',
+        category: 'OpenAI Chat Completions',
+        contextWindow: '128K',
+        summary: 'Modelo generalista y de razonamiento de Inception Labs expuesto por v1/chat/completions.',
+        upstreamModelId: 'mercury-2',
+        transportMode: 'gateway',
+        apiStyle: 'openai-chat',
+        apiBaseUrl: 'https://api.inceptionlabs.ai/v1',
+        apiPath: '/chat/completions',
+        authEnvMode: 'auth_token',
+        sortOrder: 1,
+        isDefault: 1
+      }
+    ],
+    authMethods: [
+      {
+        id: 'token',
+        name: 'Token',
+        description: 'Conexion por API key de Inception Labs.',
+        credentialKind: 'env_var',
+        sortOrder: 1,
+        isDefault: 1
+      }
+    ]
+  },
   {
     id: 'openrouter',
     name: 'OpenRouter',
@@ -1021,7 +1066,7 @@ function mapOAuthRow(row) {
   };
 }
 
-export function createCatalogStore({ filename = defaultCatalogDbPath } = {}) {
+export function createCatalogStore({ filename = getDefaultCatalogDbPath() } = {}) {
   if (filename !== ':memory:') {
     fs.mkdirSync(path.dirname(filename), { recursive: true });
   }

package/src/lib/app-paths.js

@@ -1,4 +1,5 @@
 import fs from 'node:fs/promises';
+import fsSync from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import process from 'node:process';
@@ -48,6 +49,14 @@ async function pathExists(targetPath) {
   }
 }
 
+function pathExistsSync(targetPath) {
+  try {
+    return fsSync.existsSync(targetPath);
+  } catch (_error) {
+    return false;
+  }
+}
+
 function defaultHomedir(env, fallbackHomedir) {
   const pathModule = getPathModule(process.platform);
 
@@ -179,6 +188,18 @@ export async function resolveClaudeConnectHome(options = {}) {
   return candidates[0];
 }
 
+export function resolveClaudeConnectHomeSync(options = {}) {
+  const candidates = buildClaudeConnectHomeCandidates(options);
+
+  for (const candidate of candidates) {
+    if (pathExistsSync(candidate)) {
+      return candidate;
+    }
+  }
+
+  return candidates[0];
+}
+
 export async function resolveClaudeSettingsPath(options = {}) {
   if (typeof options.env?.CLAUDE_SETTINGS_PATH === 'string' && options.env.CLAUDE_SETTINGS_PATH.trim().length > 0) {
     return buildClaudeSettingsPathCandidates(options)[0];
@@ -244,6 +265,8 @@ export async function resolveClaudeConnectPaths(options = {}) {
 
   return {
     claudeConnectHome,
+    storageDir: path.join(claudeConnectHome, 'storage'),
+    catalogDbPath: path.join(claudeConnectHome, 'storage', 'claude-connect.sqlite'),
     profilesDir: path.join(claudeConnectHome, 'profiles'),
     tokensDir: path.join(claudeConnectHome, 'tokens'),
     secretsDir: path.join(claudeConnectHome, 'secrets'),
@@ -269,3 +292,90 @@ export async function resolveClaudePaths(options = {}) {
     ...claudeConnectPaths
   };
 }
+
+function buildExecutableNames(command, platform = process.platform, env = process.env) {
+  if (platform !== 'win32') {
+    return [command];
+  }
+
+  const pathext = typeof env.PATHEXT === 'string' && env.PATHEXT.length > 0
+    ? env.PATHEXT.split(';').filter(Boolean)
+    : ['.EXE', '.CMD', '.BAT', '.COM'];
+  const hasExt = path.win32.extname(command).length > 0;
+
+  if (hasExt) {
+    return [command];
+  }
+
+  return pathext.map((ext) => `${command}${ext.toLowerCase()}`);
+}
+
+export async function findExecutableOnPath(command, {
+  platform = process.platform,
+  env = process.env
+} = {}) {
+  const pathModule = getPathModule(platform);
+  const pathValue = typeof env.PATH === 'string' ? env.PATH : '';
+  const pathEntries = pathValue.split(path.delimiter).filter(Boolean);
+  const commandNames = buildExecutableNames(command, platform, env);
+
+  for (const directory of pathEntries) {
+    for (const commandName of commandNames) {
+      const candidate = pathModule.join(directory, commandName);
+
+      if (await pathExists(candidate)) {
+        return candidate;
+      }
+    }
+  }
+
+  return null;
+}
+
+export async function detectClaudeCodeInstallation(options = {}) {
+  const settingsCandidates = buildClaudeSettingsPathCandidates(options);
+  const accountCandidates = buildClaudeAccountPathCandidates(options);
+  const credentialsCandidates = buildClaudeCredentialsPathCandidates(options);
+  const executablePath = await findExecutableOnPath('claude', options);
+
+  const [existingSettingsPath, existingAccountPath, existingCredentialsPath] = await Promise.all([
+    (async () => {
+      for (const candidate of settingsCandidates) {
+        if (await pathExists(candidate)) {
+          return candidate;
+        }
+      }
+
+      return null;
+    })(),
+    (async () => {
+      for (const candidate of accountCandidates) {
+        if (await pathExists(candidate)) {
+          return candidate;
+        }
+      }
+
+      return null;
+    })(),
+    (async () => {
+      for (const candidate of credentialsCandidates) {
+        if (await pathExists(candidate)) {
+          return candidate;
+        }
+      }
+
+      return null;
+    })()
+  ]);
+
+  return {
+    isInstalled: Boolean(executablePath || existingSettingsPath || existingAccountPath || existingCredentialsPath),
+    executablePath,
+    existingSettingsPath,
+    existingAccountPath,
+    existingCredentialsPath,
+    settingsCandidates,
+    accountCandidates,
+    credentialsCandidates
+  };
+}

package/src/lib/claude-settings.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { resolveClaudePaths } from './app-paths.js';
+import { detectClaudeCodeInstallation, resolveClaudePaths } from './app-paths.js';
 import { readManagedProviderTokenSecret, readManagedTokenSecret } from './secrets.js';
 
 function isObject(value) {
@@ -240,6 +240,14 @@ export function buildClaudeSettingsForProfile({
 }
 
 export async function activateClaudeProfile({ profile, gatewayBaseUrl = 'http://127.0.0.1:4310/anthropic' }) {
+  const installation = await detectClaudeCodeInstallation();
+
+  if (!installation.isInstalled) {
+    throw new Error(
+      'Claude Code no parece estar instalado en esta maquina. Instala o ejecuta Claude Code primero y luego vuelve a activar la conexion.'
+    );
+  }
+
   const {
     claudeSettingsPath,
     claudeAccountPath,

package/src/wizard.js

@@ -433,7 +433,22 @@ async function activateClaudeFromSavedProfile() {
     return profile;
   }
 
-  const result = await activateClaudeProfile({ profile });
+  let result;
+
+  try {
+    result = await activateClaudeProfile({ profile });
+  } catch (error) {
+    renderInfoScreen({
+      title: 'No se pudo activar Claude',
+      subtitle: 'Claude Connect no pudo aplicar la conexion en Claude Code.',
+      lines: [
+        colorize(error instanceof Error ? error.message : String(error), colors.warning)
+      ],
+      footer: 'Presiona una tecla para volver'
+    });
+    return await waitForAnyKey();
+  }
+
   const gateway = result.connectionMode === 'gateway'
     ? await restartGatewayInBackground()
     : await stopGateway();