kiku-agent 1.0.9 → 1.0.11

package/server/agent/doctor.js

@@ -57,7 +57,7 @@ export async function runDoctor(options = {}) {
     { id: 'node', required: true, ok: nodeMajor >= 20, detail: `Node ${process.versions.node} (requires >=20)` },
     { id: 'data', required: true, ok: dataWritable, detail: dataDir },
     { id: 'gpu', required: false, ok: Boolean(gpu.available), detail: gpu.available && gpu.primary ? `${gpu.primary.name} (${gpu.primary.totalGb} GB VRAM${gpu.primary.driverVersion !== 'N/A' ? `, Driver ${gpu.primary.driverVersion}` : ''})` : 'CPU fallback / no dedicated acceleration detected' },
-    { id: 'lmstudio', required: false, ok: Boolean(lm.connected), detail: lm.connected ? `${lm.models?.length || 0} loaded model(s)` : 'offline; catalog-only mode is available' },
+    { id: 'lmstudio', required: false, ok: Boolean(lm.connected), detail: lm.connected ? `${lm.models?.length || 0} loaded model(s)` : 'offline; LM Studio server required for AI chat (/model reconnect)' },
     { id: 'ffmpeg', required: false, ok: ffmpegStatic && fluentFfmpeg, detail: 'audio add-on only; intentionally not installed with the core CLI' },
     { id: 'speaker', required: false, ok: speaker, detail: 'native audio add-on only; intentionally not installed with the core CLI' },
     { id: 'yt-dlp', required: false, ok: ytDlp, detail: 'recommended for YouTube search and playback' },

package/server/agent/errors.js

@@ -1,3 +1,5 @@
+import { C } from './ui.js';
+
 export function createAbortError(message = 'Query cancelled by user.') {
   const error = new Error(message);
   error.name = 'AbortError';
@@ -7,3 +9,206 @@ export function createAbortError(message = 'Query cancelled by user.') {
 export function isAbortError(error) {
   return error?.name === 'AbortError';
 }
+
+export function parseApiErrorText(errorText) {
+  if (!errorText) return 'Unknown error';
+  try {
+    const parsed = JSON.parse(errorText);
+    if (parsed.error) {
+      if (typeof parsed.error === 'string') return parsed.error;
+      if (parsed.error.message) return parsed.error.message;
+      if (parsed.error.description) return parsed.error.description;
+    }
+    if (parsed.message) return parsed.message;
+    if (parsed.description) return parsed.description;
+  } catch { }
+  return String(errorText).replace(/\s+/g, ' ').trim();
+}
+
+export function parseExecutionError(err, context = {}) {
+  const rawMsg = err?.message || String(err || '');
+  const provider = (context.provider || context.client?.provider || 'cloud').toLowerCase();
+  const providerName = context.providerName || context.client?.providerName || (provider === 'lmstudio' ? 'LM Studio' : 'AI Provider');
+  const model = context.model || context.client?.model || 'active model';
+  const isLocal = provider === 'lmstudio';
+
+  let cleanMsg = rawMsg;
+  const jsonMatch = rawMsg.match(/(\{[\s\S]*\})/);
+  if (jsonMatch) {
+    try {
+      const parsed = JSON.parse(jsonMatch[1]);
+      if (parsed.error) {
+        if (typeof parsed.error === 'string') cleanMsg = parsed.error;
+        else if (parsed.error.message) cleanMsg = parsed.error.message;
+        else if (parsed.error.description) cleanMsg = parsed.error.description;
+      } else if (parsed.message) {
+        cleanMsg = parsed.message;
+      }
+    } catch { }
+  }
+
+  cleanMsg = cleanMsg.replace(/^[A-Za-z0-9_\s]+error\s*\(\d+\):\s*/i, '').trim();
+
+  let type = 'general';
+  let title = 'Execution Error';
+  let headline = cleanMsg;
+  let details = [];
+  let recoveryOptions = [];
+
+  const lowerRaw = rawMsg.toLowerCase();
+  const status = err?.status || (rawMsg.match(/\((\d{3})\)/)?.[1] ? parseInt(rawMsg.match(/\((\d{3})\)/)[1], 10) : null);
+
+  if (status === 402 || lowerRaw.includes('insufficient credits') || lowerRaw.includes('credit balance') || lowerRaw.includes('purchased credits') || lowerRaw.includes('payment required')) {
+    type = 'insufficient_credits';
+    title = `${providerName} • Insufficient Credits (402)`;
+    headline = `Your ${providerName} account has run out of credits or has zero balance.`;
+    details = [
+      'The provider rejected the request with HTTP 402 (Payment Required).',
+      cleanMsg && cleanMsg !== headline ? `Provider note: ${cleanMsg}` : '',
+    ].filter(Boolean);
+    recoveryOptions = [
+      { action: 'Switch to local LM Studio (Free/Offline)', cmd: '/provider use lmstudio' },
+      { action: 'Switch to free Cloud tier (Groq)', cmd: '/provider use groq' },
+      { action: 'Switch to another configured provider', cmd: '/provider list' },
+    ];
+  } else if (status === 429 || lowerRaw.includes('rate limit') || lowerRaw.includes('quota') || lowerRaw.includes('tokens per minute') || lowerRaw.includes('tpm') || lowerRaw.includes('rpm')) {
+    type = 'rate_limit';
+    title = `${providerName} • Rate Limit Exceeded (429)`;
+    headline = `Usage limit reached on ${providerName} (${model}).`;
+    details = [
+      'Request exceeded tokens-per-minute (TPM) or requests-per-minute (RPM) quota.',
+      cleanMsg && cleanMsg !== headline ? `Details: ${cleanMsg}` : '',
+    ].filter(Boolean);
+    recoveryOptions = [
+      { action: 'Wait a few seconds and retry', cmd: '/retry' },
+      { action: 'Switch to local LM Studio (No rate limits)', cmd: '/provider use lmstudio' },
+      { action: 'Switch to another cloud provider', cmd: '/provider use groq' },
+    ];
+  } else if (status === 401 || status === 403 || lowerRaw.includes('invalid api key') || lowerRaw.includes('unauthorized') || lowerRaw.includes('authentication') || lowerRaw.includes('forbidden') || lowerRaw.includes('api key not found')) {
+    type = 'auth';
+    title = `${providerName} • Authentication Failed (${status || 401})`;
+    headline = `The API key for ${providerName} was rejected or is missing.`;
+    details = [
+      `Check your API key configuration for ${providerName}.`,
+      cleanMsg && cleanMsg !== headline ? `Details: ${cleanMsg}` : '',
+    ].filter(Boolean);
+    recoveryOptions = [
+      { action: `Set API key for ${provider}`, cmd: `/provider setkey ${provider} <your_key>` },
+      { action: 'Switch to local LM Studio (No key required)', cmd: '/provider use lmstudio' },
+      { action: 'Switch provider', cmd: '/provider list' },
+    ];
+  } else if (status === 404 || lowerRaw.includes('model not found') || lowerRaw.includes('does not exist') || lowerRaw.includes('model_not_found')) {
+    type = 'model_not_found';
+    title = `${providerName} • Model Not Found (404)`;
+    headline = `Model "${model}" is not available on ${providerName}.`;
+    details = [
+      'The model ID might be deprecated, typoed, or not enabled for your account.',
+      cleanMsg && cleanMsg !== headline ? `Details: ${cleanMsg}` : '',
+    ].filter(Boolean);
+    recoveryOptions = [
+      { action: 'List available models', cmd: `/provider models ${provider}` },
+      { action: 'Switch to recommended model', cmd: '/model recommend' },
+      { action: 'Switch to local LM Studio', cmd: '/provider use lmstudio' },
+    ];
+  } else if (lowerRaw.includes('econnrefused') || lowerRaw.includes('fetch failed') || lowerRaw.includes('networkerror') || lowerRaw.includes('enotfound') || lowerRaw.includes('connect error') || lowerRaw.includes('failed to fetch')) {
+    type = 'network';
+    if (isLocal) {
+      title = 'LM Studio • Local Server Offline';
+      headline = 'Cannot reach LM Studio local server at http://127.0.0.1:1234/v1';
+      details = [
+        'LM Studio application is not open or local inference server is stopped.',
+      ];
+      recoveryOptions = [
+        { action: 'Start LM Studio and click "Start Server", then run', cmd: '/model reconnect' },
+        { action: 'Switch to a Cloud AI provider', cmd: '/provider use groq' },
+      ];
+    } else {
+      title = `${providerName} • Network Connection Error`;
+      headline = `Could not reach ${providerName} cloud servers.`;
+      details = [
+        'Connection dropped, timed out, or internet connectivity is unavailable.',
+      ];
+      recoveryOptions = [
+        { action: 'Switch to local LM Studio (offline)', cmd: '/provider use lmstudio' },
+        { action: 'Retry previous query', cmd: '/retry' },
+      ];
+    }
+  } else if ((status >= 500 && status < 600) || lowerRaw.includes('internal server error') || lowerRaw.includes('bad gateway') || lowerRaw.includes('service unavailable')) {
+    type = 'server_error';
+    title = `${providerName} • Provider Server Error (${status || 500})`;
+    headline = `${providerName} server is experiencing downtime or internal errors.`;
+    details = [
+      cleanMsg || 'Temporary upstream error from cloud provider.',
+    ];
+    recoveryOptions = [
+      { action: 'Switch to local LM Studio (offline)', cmd: '/provider use lmstudio' },
+      { action: 'Switch to another cloud provider', cmd: '/provider use groq' },
+    ];
+  } else if (lowerRaw.includes('context_length') || lowerRaw.includes('context length') || lowerRaw.includes('maximum context')) {
+    type = 'context_length';
+    title = `${providerName} • Context Length Exceeded`;
+    headline = `Conversation history exceeds maximum context window of ${model}.`;
+    details = [
+      'The current session has accumulated more tokens than the model can accept in one turn.',
+    ];
+    recoveryOptions = [
+      { action: 'Archive & reset session history', cmd: '/clear' },
+      { action: 'Clear message history only', cmd: '/history clear' },
+    ];
+  } else {
+    type = 'general';
+    title = `${providerName} • Query Failed`;
+    headline = cleanMsg || 'An error occurred while processing the query.';
+    if (cleanMsg.length > 120) {
+      headline = `${cleanMsg.slice(0, 120)}...`;
+      details = [cleanMsg];
+    }
+    recoveryOptions = [
+      { action: 'Switch to local LM Studio', cmd: '/provider use lmstudio' },
+      { action: 'Switch provider or model', cmd: '/provider list' },
+      { action: 'Retry query', cmd: '/retry' },
+    ];
+  }
+
+  return {
+    type,
+    title,
+    headline,
+    details,
+    recoveryOptions,
+    status,
+    provider,
+    providerName,
+    model,
+    isLocal,
+    rawError: rawMsg,
+  };
+}
+
+export function formatExecutionErrorCard(err, context = {}) {
+  const diag = parseExecutionError(err, context);
+  const lines = [
+    `${C.bold}${C.white}${diag.headline}${C.reset}`,
+  ];
+
+  if (diag.details && diag.details.length > 0) {
+    lines.push('');
+    for (const d of diag.details) {
+      lines.push(`${C.slate}${d}${C.reset}`);
+    }
+  }
+
+  if (diag.recoveryOptions && diag.recoveryOptions.length > 0) {
+    lines.push('', `${C.bold}${C.lavender}Recommended Recovery Actions:${C.reset}`);
+    for (const opt of diag.recoveryOptions) {
+      lines.push(`  ${C.gold}• ${opt.action}:${C.reset} ${C.bold}${C.cyberCyan}${opt.cmd}${C.reset}`);
+    }
+  }
+
+  return {
+    title: diag.title,
+    status: 'error',
+    lines,
+    footer: `Switch immediately: ${C.cyberCyan}/provider use lmstudio${C.reset}${C.dim} | ${C.cyberCyan}/provider list${C.reset}${C.dim} | ${C.cyberCyan}/model${C.reset}`,
+  };
+}