claude-connect 0.1.7 → 0.1.9

package/README.md

@@ -1,11 +1,11 @@
 # Claude Connect
 
-> 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.
+> Conecta `Claude Code` con `OpenCode Go`, `Zen`, `Kimi`, `DeepSeek`, `Z.AI`, `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%20Inception%20Labs%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%20Z.AI%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`, `Inception Labs`, `OpenRouter` y `Qwen` listos desde el primer arranque
+- `OpenCode Go`, `Zen`, `Kimi`, `DeepSeek`, `Z.AI`, `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`
@@ -78,11 +78,14 @@ Al activar:
 - `Zen` usa conexión directa o gateway según el modelo elegido
 - `Kimi` usa gateway local y reenvia al endpoint Anthropic de `https://api.kimi.com/coding/`
 - `DeepSeek` apunta a `https://api.deepseek.com/anthropic`
+- `Z.AI` apunta a `https://api.z.ai/api/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`
+- para algunos modelos con limites conocidos, el gateway ahora ajusta `max_tokens` y bloquea prompts sobredimensionados antes de que el upstream devuelva errores opacos
+- para `Inception Labs`, el gateway tambien respeta un presupuesto local de input tokens por minuto para reducir errores de `Rate limit reached`
 
 ## Providers
 
@@ -92,6 +95,7 @@ Al activar:
 | `Zen` | `Claude*` de Zen + modelos `chat/completions` de Zen | `Token` | Mixta |
 | `Kimi` | `kimi-for-coding` | `Token` | Gateway local |
 | `DeepSeek` | `deepseek-chat`, `deepseek-reasoner` | `Token` | Directa |
+| `Z.AI` | `glm-5.1`, `glm-4.7`, `glm-4.5-air` | `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 |
@@ -123,12 +127,31 @@ Nota sobre `OpenAI`:
 Nota sobre `Inception Labs`:
 
 - esta primera integracion expone solo `mercury-2`, que es el modelo chat-compatible oficial en `v1/chat/completions`
+- `mercury-2` se trata como modelo solo texto en Claude Connect; si envias una imagen, la app ahora corta la peticion con un mensaje claro
+- Claude Connect aplica presupuesto preventivo de contexto para `mercury-2` usando ventana `128K` y salida maxima `16,384`
+- Claude Connect tambien aplica una ventana deslizante local de `400,000` input tokens por minuto para reducir rechazos del upstream por rate limit
 - `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
+  - https://docs.inceptionlabs.ai/get-started/rate-limits
+
+Nota sobre `DeepSeek`:
+
+- Claude Connect aplica presupuesto preventivo de contexto para `deepseek-chat` y `deepseek-reasoner`
+- referencias oficiales:
+  - https://api-docs.deepseek.com/quick_start/pricing/
+  - https://api-docs.deepseek.com/guides/reasoning_model
+
+Nota sobre `Z.AI`:
+
+- usa el endpoint Anthropic-compatible oficial `https://api.z.ai/api/anthropic`
+- Claude Connect fija `API_TIMEOUT_MS=3000000`
+- al activar un perfil de `Z.AI`, tambien mapea `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` y `ANTHROPIC_DEFAULT_OPUS_MODEL` al modelo elegido para que Claude Code use `GLM` de forma consistente
+- referencias oficiales:
+  - https://docs.z.ai/devpack/tool/claude
 
 Nota sobre `Ollama`:
 

package/package.json

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

package/src/data/catalog-store.js

@@ -39,6 +39,7 @@ CREATE TABLE IF NOT EXISTS models (
   api_base_url TEXT,
   api_path TEXT,
   auth_env_mode TEXT NOT NULL DEFAULT 'auth_token',
+  supports_vision INTEGER NOT NULL DEFAULT 1,
   sort_order INTEGER NOT NULL DEFAULT 0,
   is_default INTEGER NOT NULL DEFAULT 0
 );
@@ -527,6 +528,75 @@ const seedProviders = [
       }
     ]
   },
+  {
+    id: 'zai',
+    name: 'Z.AI',
+    vendor: 'Zhipu AI',
+    description: 'GLM Coding Plan para Claude Code usando el endpoint Anthropic-compatible oficial de z.ai.',
+    docsUrl: 'https://docs.z.ai/devpack/tool/claude',
+    docsVerifiedAt: '2026-04-04',
+    baseUrl: 'https://api.z.ai/api/anthropic',
+    defaultModelId: 'glm-5.1',
+    defaultAuthMethodId: 'token',
+    defaultApiKeyEnvVar: 'ZAI_API_KEY',
+    models: [
+      {
+        id: 'glm-5.1',
+        name: 'GLM-5.1',
+        category: 'Coding',
+        contextWindow: 'Auto',
+        summary: 'Modelo recomendado de la documentacion oficial de z.ai para usuarios Max que quieren usar GLM-5.1 en Claude Code.',
+        upstreamModelId: 'glm-5.1',
+        transportMode: 'direct',
+        apiStyle: 'anthropic',
+        apiBaseUrl: 'https://api.z.ai/api/anthropic',
+        apiPath: '/v1/messages',
+        authEnvMode: 'auth_token',
+        sortOrder: 1,
+        isDefault: 1
+      },
+      {
+        id: 'glm-4.7',
+        name: 'GLM-4.7',
+        category: 'General',
+        contextWindow: 'Auto',
+        summary: 'Modelo default recomendado por z.ai para Opus y Sonnet dentro del GLM Coding Plan.',
+        upstreamModelId: 'glm-4.7',
+        transportMode: 'direct',
+        apiStyle: 'anthropic',
+        apiBaseUrl: 'https://api.z.ai/api/anthropic',
+        apiPath: '/v1/messages',
+        authEnvMode: 'auth_token',
+        sortOrder: 2,
+        isDefault: 0
+      },
+      {
+        id: 'glm-4.5-air',
+        name: 'GLM-4.5-Air',
+        category: 'Fast',
+        contextWindow: 'Auto',
+        summary: 'Modelo ligero recomendado por z.ai para la clase Haiku dentro del GLM Coding Plan.',
+        upstreamModelId: 'glm-4.5-air',
+        transportMode: 'direct',
+        apiStyle: 'anthropic',
+        apiBaseUrl: 'https://api.z.ai/api/anthropic',
+        apiPath: '/v1/messages',
+        authEnvMode: 'auth_token',
+        sortOrder: 3,
+        isDefault: 0
+      }
+    ],
+    authMethods: [
+      {
+        id: 'token',
+        name: 'Token',
+        description: 'Conexion por API key contra el endpoint Anthropic-compatible oficial de z.ai.',
+        credentialKind: 'env_var',
+        sortOrder: 1,
+        isDefault: 1
+      }
+    ]
+  },
   {
     id: 'ollama',
     name: 'Ollama',
@@ -703,6 +773,7 @@ const seedProviders = [
         apiBaseUrl: 'https://api.inceptionlabs.ai/v1',
         apiPath: '/chat/completions',
         authEnvMode: 'auth_token',
+        supportsVision: false,
         sortOrder: 1,
         isDefault: 1
       }
@@ -838,10 +909,10 @@ function seedCatalog(db) {
     INSERT INTO models (
       id, provider_id, name, category, context_window, summary,
       upstream_model_id,
-      transport_mode, api_style, api_base_url, api_path, auth_env_mode,
+      transport_mode, api_style, api_base_url, api_path, auth_env_mode, supports_vision,
       sort_order, is_default
     )
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     ON CONFLICT(id) DO UPDATE SET
       provider_id = excluded.provider_id,
       name = excluded.name,
@@ -854,6 +925,7 @@ function seedCatalog(db) {
       api_base_url = excluded.api_base_url,
       api_path = excluded.api_path,
       auth_env_mode = excluded.auth_env_mode,
+      supports_vision = excluded.supports_vision,
       sort_order = excluded.sort_order,
       is_default = excluded.is_default
   `);
@@ -924,6 +996,7 @@ function seedCatalog(db) {
           model.apiBaseUrl ?? null,
           model.apiPath ?? null,
           model.authEnvMode ?? 'auth_token',
+          model.supportsVision === false ? 0 : 1,
           model.sortOrder,
           model.isDefault
         );
@@ -995,6 +1068,10 @@ function ensureSchemaMigrations(db) {
     alterStatements.push(`ALTER TABLE models ADD COLUMN auth_env_mode TEXT NOT NULL DEFAULT 'auth_token'`);
   }
 
+  if (!modelColumns.has('supports_vision')) {
+    alterStatements.push(`ALTER TABLE models ADD COLUMN supports_vision INTEGER NOT NULL DEFAULT 1`);
+  }
+
   if (!modelColumns.has('upstream_model_id')) {
     alterStatements.push(`ALTER TABLE models ADD COLUMN upstream_model_id TEXT`);
   }
@@ -1037,6 +1114,7 @@ function mapModelRow(row) {
     apiBaseUrl: row.api_base_url,
     apiPath: row.api_path,
     authEnvMode: row.auth_env_mode,
+    supportsVision: Boolean(row.supports_vision),
     sortOrder: Number(row.sort_order),
     isDefault: Boolean(row.is_default)
   };

package/src/gateway/server.js

@@ -24,8 +24,10 @@ import {
 } from './state.js';
 import { resolveClaudeConnectPaths } from '../lib/app-paths.js';
 import { readSwitchState } from '../lib/claude-settings.js';
+import { enforceModelTokenBudget } from '../lib/model-budget.js';
 import { readOAuthToken, refreshOAuthToken } from '../lib/oauth.js';
 import { readProfileFile } from '../lib/profile.js';
+import { reserveProviderInputTokens } from '../lib/provider-rate-limit.js';
 import { readManagedProviderTokenSecret, readManagedTokenSecret } from '../lib/secrets.js';
 
 const projectRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
@@ -161,6 +163,48 @@ function getUpstreamModelId(profile) {
   return profile?.model?.upstreamModelId ?? profile?.model?.id ?? 'unknown';
 }
 
+function requestContainsImageInput(body) {
+  return Array.isArray(body?.messages)
+    && body.messages.some((messageItem) => Array.isArray(messageItem?.content)
+      && messageItem.content.some((part) => part?.type === 'image'));
+}
+
+function profileSupportsImageInput(profile) {
+  if (typeof profile?.model?.supportsVision === 'boolean') {
+    return profile.model.supportsVision;
+  }
+
+  if (profile?.provider?.id === 'inception') {
+    return false;
+  }
+
+  return true;
+}
+
+function stringifyUpstreamMessage(value) {
+  if (typeof value === 'string') {
+    return value;
+  }
+
+  if (value == null) {
+    return '';
+  }
+
+  if (typeof value === 'object') {
+    if ('message' in value && typeof value.message === 'string') {
+      return value.message;
+    }
+
+    try {
+      return JSON.stringify(value);
+    } catch (_error) {
+      return String(value);
+    }
+  }
+
+  return String(value);
+}
+
 function resolveGatewayUpstreamConfig(profile) {
   if (profile?.provider?.id === 'ollama') {
     return {
@@ -335,9 +379,9 @@ async function forwardUpstreamRequest({ targetUrl, headers, payload, context, re
     });
   }
 
-  const message = responsePayload?.error?.message
-    || responsePayload?.message
-    || responsePayload?.error
+  const message = stringifyUpstreamMessage(responsePayload?.error?.message)
+    || stringifyUpstreamMessage(responsePayload?.message)
+    || stringifyUpstreamMessage(responsePayload?.error)
     || `HTTP ${response.status}`;
   const providerName = context?.profile?.provider?.name ?? context?.profile?.provider?.id ?? 'El proveedor';
   const containsImageInput = Array.isArray(payload?.messages)
@@ -453,9 +497,24 @@ async function handleCountTokens(request, response) {
 }
 
 async function handleMessages(request, response) {
-  const body = await readJsonBody(request);
+  const rawBody = await readJsonBody(request);
   const context = await resolveGatewayContext();
 
+  if (requestContainsImageInput(rawBody) && !profileSupportsImageInput(context.profile)) {
+    const providerName = context.profile.provider.name;
+    const modelName = context.profile.model.name;
+    throw new Error(`${providerName} no admite imagenes con el modelo ${modelName} en esta integracion. Usa un proveedor o modelo con soporte visual.`);
+  }
+
+  const body = enforceModelTokenBudget({
+    body: rawBody,
+    profile: context.profile
+  });
+  await reserveProviderInputTokens({
+    profile: context.profile,
+    inputTokens: estimateTokenCountFromAnthropicRequest(body)
+  });
+
   if (context.upstreamApiStyle === 'anthropic') {
     const upstreamResponse = await forwardAnthropicMessage({
       requestBody: body,

package/src/lib/claude-settings.js

@@ -154,6 +154,13 @@ export async function resolveClaudeTransportForProfile({
       extraEnv.ANTHROPIC_DEFAULT_HAIKU_MODEL = profile.model.id;
     }
 
+    if (profile.provider.id === 'zai') {
+      extraEnv.API_TIMEOUT_MS = '3000000';
+      extraEnv.ANTHROPIC_DEFAULT_HAIKU_MODEL = profile.model.id;
+      extraEnv.ANTHROPIC_DEFAULT_SONNET_MODEL = profile.model.id;
+      extraEnv.ANTHROPIC_DEFAULT_OPUS_MODEL = profile.model.id;
+    }
+
     if (profile.provider.id === 'kimi') {
       extraEnv.ENABLE_TOOL_SEARCH = 'false';
     }
@@ -220,6 +227,8 @@ export function buildClaudeSettingsForProfile({
   delete env.ENABLE_TOOL_SEARCH;
   delete env.ANTHROPIC_MODEL;
   delete env.ANTHROPIC_DEFAULT_HAIKU_MODEL;
+  delete env.ANTHROPIC_DEFAULT_SONNET_MODEL;
+  delete env.ANTHROPIC_DEFAULT_OPUS_MODEL;
 
   Object.assign(env, extraEnv);
 
@@ -259,9 +268,16 @@ export async function activateClaudeProfile({ profile, gatewayBaseUrl = 'http://
   const currentAccount = await readClaudeAccount();
   const currentCredentials = await readJsonIfExists(claudeCredentialsPath);
   const currentState = await readSwitchState();
-  const originalSettings = currentState?.originalSettings ?? currentSettings;
-  const originalAccount = currentState?.originalAccount ?? currentAccount;
-  const originalCredentials = currentState && Object.prototype.hasOwnProperty.call(currentState, 'originalCredentials')
+  const canReuseActiveSnapshot = currentState?.active === true;
+  const originalSettings = canReuseActiveSnapshot
+    ? currentState?.originalSettings ?? currentSettings
+    : currentSettings;
+  const originalAccount = canReuseActiveSnapshot
+    ? currentState?.originalAccount ?? currentAccount
+    : currentAccount;
+  const originalCredentials = canReuseActiveSnapshot
+    && currentState
+    && Object.prototype.hasOwnProperty.call(currentState, 'originalCredentials')
     ? currentState.originalCredentials
     : currentCredentials;
   const transport = await resolveClaudeTransportForProfile({

package/src/lib/model-budget.js

@@ -0,0 +1,73 @@
+import { estimateTokenCountFromAnthropicRequest } from '../gateway/messages.js';
+
+function getModelIdentity(profile) {
+  return profile?.model?.upstreamModelId ?? profile?.model?.id ?? '';
+}
+
+export function getModelTokenLimits(profile) {
+  const providerId = profile?.provider?.id;
+  const modelId = getModelIdentity(profile);
+
+  if (providerId === 'inception' && modelId === 'mercury-2') {
+    return {
+      contextWindowTokens: 128_000,
+      defaultOutputTokens: 8_192,
+      maxOutputTokens: 16_384
+    };
+  }
+
+  if (providerId === 'deepseek' && modelId === 'deepseek-chat') {
+    return {
+      contextWindowTokens: 128_000,
+      defaultOutputTokens: 4_000,
+      maxOutputTokens: 8_000
+    };
+  }
+
+  if (providerId === 'deepseek' && modelId === 'deepseek-reasoner') {
+    return {
+      contextWindowTokens: 128_000,
+      defaultOutputTokens: 32_000,
+      maxOutputTokens: 64_000
+    };
+  }
+
+  return null;
+}
+
+export function enforceModelTokenBudget({ body, profile, safetyMarginTokens = 1024 }) {
+  const limits = getModelTokenLimits(profile);
+
+  if (!limits) {
+    return body;
+  }
+
+  const estimatedInputTokens = estimateTokenCountFromAnthropicRequest(body);
+  const availableForOutput = limits.contextWindowTokens - estimatedInputTokens - safetyMarginTokens;
+
+  if (availableForOutput <= 0) {
+    throw new Error(
+      `La conversacion actual excede el contexto aproximado de ${limits.contextWindowTokens.toLocaleString('en-US')} tokens para ${profile.model.name}. Usa /compact o /clear antes de continuar.`
+    );
+  }
+
+  const requestedOutputTokens = typeof body?.max_tokens === 'number'
+    ? body.max_tokens
+    : limits.defaultOutputTokens;
+  const clampedOutputTokens = Math.min(
+    requestedOutputTokens,
+    limits.maxOutputTokens,
+    availableForOutput
+  );
+
+  if (clampedOutputTokens < 256) {
+    throw new Error(
+      `Queda muy poco margen de salida para ${profile.model.name} dentro de su contexto aproximado de ${limits.contextWindowTokens.toLocaleString('en-US')} tokens. Usa /compact o /clear antes de continuar.`
+    );
+  }
+
+  return {
+    ...body,
+    max_tokens: clampedOutputTokens
+  };
+}

package/src/lib/profile.js

@@ -32,7 +32,8 @@ export function buildProfile({ provider, model, authMethod, profileName, apiKeyE
       apiStyle: model.apiStyle,
       apiBaseUrl: model.apiBaseUrl,
       apiPath: model.apiPath,
-      authEnvMode: model.authEnvMode
+      authEnvMode: model.authEnvMode,
+      supportsVision: model.supportsVision ?? true
     },
     auth: {
       method: authMethod.id

package/src/lib/provider-rate-limit.js

@@ -0,0 +1,109 @@
+function getProviderId(profile) {
+  return profile?.provider?.id ?? '';
+}
+
+function getProviderInputTokensPerMinute(profile) {
+  const providerId = getProviderId(profile);
+
+  if (providerId === 'inception') {
+    return 400_000;
+  }
+
+  return null;
+}
+
+const recentReservations = [];
+
+function pruneReservations(now) {
+  for (let index = recentReservations.length - 1; index >= 0; index -= 1) {
+    if (now - recentReservations[index].timestamp >= 60_000) {
+      recentReservations.splice(index, 1);
+    }
+  }
+}
+
+function sumReservedTokens(profile, now) {
+  const providerId = getProviderId(profile);
+
+  return recentReservations.reduce((total, entry) => {
+    if (entry.providerId !== providerId) {
+      return total;
+    }
+
+    if (now - entry.timestamp >= 60_000) {
+      return total;
+    }
+
+    return total + entry.tokens;
+  }, 0);
+}
+
+function earliestExpiryForProvider(profile, now) {
+  const providerId = getProviderId(profile);
+  let minExpiry = null;
+
+  for (const entry of recentReservations) {
+    if (entry.providerId !== providerId) {
+      continue;
+    }
+
+    const expiry = entry.timestamp + 60_000;
+
+    if (expiry <= now) {
+      continue;
+    }
+
+    if (minExpiry == null || expiry < minExpiry) {
+      minExpiry = expiry;
+    }
+  }
+
+  return minExpiry;
+}
+
+export function resetProviderRateLimitState() {
+  recentReservations.length = 0;
+}
+
+export async function reserveProviderInputTokens({
+  profile,
+  inputTokens,
+  now = () => Date.now(),
+  sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+}) {
+  const tokensPerMinute = getProviderInputTokensPerMinute(profile);
+
+  if (!tokensPerMinute) {
+    return;
+  }
+
+  if (inputTokens > tokensPerMinute) {
+    throw new Error(
+      `${profile.provider.name} rechazo la solicitud porque la entrada estimada excede el limite de ${tokensPerMinute.toLocaleString('en-US')} tokens por minuto. Usa /compact o /clear antes de continuar.`
+    );
+  }
+
+  while (true) {
+    const currentTime = now();
+    pruneReservations(currentTime);
+    const usedTokens = sumReservedTokens(profile, currentTime);
+
+    if (usedTokens + inputTokens <= tokensPerMinute) {
+      recentReservations.push({
+        providerId: getProviderId(profile),
+        tokens: inputTokens,
+        timestamp: currentTime
+      });
+      return;
+    }
+
+    const nextExpiry = earliestExpiryForProvider(profile, currentTime);
+
+    if (nextExpiry == null) {
+      throw new Error(`No se pudo reservar presupuesto de tokens para ${profile.provider.name}.`);
+    }
+
+    const waitMs = Math.max(250, nextExpiry - currentTime + 25);
+    await sleep(waitMs);
+  }
+}

package/src/lib/terminal.js

@@ -19,7 +19,26 @@ export function openAppScreen() {
 }
 
 export function closeAppScreen() {
-  process.stdout.write('\x1b[?25h\x1b[?1049l');
+  process.stdout.write('\x1b[?25h\x1b[?1049l\r\n');
+}
+
+function beginKeyboardCapture() {
+  readline.emitKeypressEvents(process.stdin);
+  process.stdin.resume();
+  process.stdin.setRawMode(true);
+}
+
+function restoreKeyboardState(onKeypress) {
+  if (typeof onKeypress === 'function') {
+    process.stdin.removeListener('keypress', onKeypress);
+  }
+
+  if (process.stdin.isTTY && process.stdin.isRaw) {
+    process.stdin.setRawMode(false);
+  }
+
+  process.stdin.pause();
+  process.stdout.write('\x1b[?25h');
 }
 
 export function clearScreen() {
@@ -64,13 +83,11 @@ export function buildFrame({ eyebrow, title, subtitle, body = [], footer = [] })
 
 export function waitForAnyKey(message = 'Presiona una tecla para continuar.') {
   return new Promise((resolve, reject) => {
-    readline.emitKeypressEvents(process.stdin);
-    process.stdin.setRawMode(true);
+    beginKeyboardCapture();
     let escapePending = false;
 
     const cleanup = () => {
-      process.stdin.removeListener('keypress', onKeypress);
-      process.stdin.setRawMode(false);
+      restoreKeyboardState(onKeypress);
     };
 
     const onKeypress = (_input, key = {}) => {
@@ -124,12 +141,10 @@ export function selectFromList({
     let selectedIndex = 0;
     let escapePending = false;
 
-    readline.emitKeypressEvents(process.stdin);
-    process.stdin.setRawMode(true);
+    beginKeyboardCapture();
 
     const cleanup = () => {
-      process.stdin.removeListener('keypress', onKeypress);
-      process.stdin.setRawMode(false);
+      restoreKeyboardState(onKeypress);
     };
 
     const render = () => {
@@ -247,12 +262,10 @@ export function promptText({
     let value = '';
     let escapePending = false;
 
-    readline.emitKeypressEvents(process.stdin);
-    process.stdin.setRawMode(true);
+    beginKeyboardCapture();
 
     const cleanup = () => {
-      process.stdin.removeListener('keypress', onKeypress);
-      process.stdin.setRawMode(false);
+      restoreKeyboardState(onKeypress);
     };
 
     const render = () => {