ucode-agent 1.61.0 → 1.62.0

package/README.md

@@ -96,6 +96,9 @@ Served by Google (aistudio.google.com), free with a key.
 
 `/model` shows them and switches. `ucode -m gemini-3.5-flash` starts on one.
 
+When Google is overloaded and Flash-Lite stops answering, ucode carries on with
+3.5 Flash by itself and goes back to Flash-Lite a few minutes later.
+
 ## What it does
 
 **Twenty-one tools.** `create_app`, `read_file`, `read_files`, `write_file`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ucode-agent",
-  "version": "1.61.0",
+  "version": "1.62.0",
   "description": "ucode - a terminal coding agent that reads, edits and runs your code, on Google Gemini models.",
   "type": "module",
   "main": "ucode.js",

package/src/core/doctor.js

@@ -12,7 +12,7 @@ import os from 'node:os';
 import path from 'node:path';
 import { theme, dim, blue } from '../ui/theme.js';
 import { VERSION } from './version.js';
-import { DEFAULT_MODEL, ENV_FILE, BASE_URL, providerKey } from './provider.js';
+import { ENV_FILE, BASE_URL, providerKey } from './provider.js';
 import { newer } from './updater.js';
 
 const DEADLINE = 6000;
@@ -27,22 +27,11 @@ async function checkKey() {
   const key = providerKey();
   if (!key) return { ok: false, name: 'API key', detail: 'not set', fix: `Add GEMINI_API_KEY=... to ${ENV_FILE} (free at aistudio.google.com/apikey)` };
   try {
-    const r = await fetch(`${BASE_URL}/chat/completions`, {
-      method: 'POST',
-      headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
-      body: JSON.stringify({ model: DEFAULT_MODEL, messages: [{ role: 'user', content: 'ok' }], max_tokens: 1 }),
-      signal: timed(),
-    });
-    if (r.status === 401 || r.status === 403) return { ok: false, name: 'API key', detail: 'rejected', fix: 'Check the key for typos, or make a new one' };
-    const body = await r.json().catch(() => ({}));
-    const meta = body?.error?.metadata?.headers ?? {};
-    const left = r.headers.get('x-ratelimit-remaining') ?? meta['X-RateLimit-Remaining'];
-    const reset = Number(r.headers.get('x-ratelimit-reset') ?? meta['X-RateLimit-Reset']);
-    if (r.status === 429 && /per[- ]day|daily/i.test(`${body?.error?.message} ${body?.error?.metadata?.limit_source}`)) {
-      const at = Number.isFinite(reset) ? new Date(reset).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }) : 'tomorrow';
-      return { ok: false, name: 'Requests today', detail: 'daily free limit used up', fix: `It resets at ${at}; adding credit raises the limit` };
-    }
-    return { ok: true, name: 'API key', detail: left != null ? `works · ${left} free requests left today` : 'works' };
+    // Listing models checks the key in under a second; a chat request can queue for half a minute.
+    const r = await fetch(`${BASE_URL}/models`, { headers: { Authorization: `Bearer ${key}` }, signal: timed() });
+    if ([400, 401, 403].includes(r.status)) return { ok: false, name: 'API key', detail: 'rejected', fix: 'Check the key for typos, or make a new one' };
+    if (!r.ok) return { ok: false, name: 'API key', detail: `could not check (HTTP ${r.status})`, fix: 'Try again in a minute' };
+    return { ok: true, name: 'API key', detail: 'works' };
   } catch (err) {
     return { ok: false, name: 'API key', detail: `could not check (${err.name === 'TimeoutError' ? 'no answer' : err.message})`, fix: 'Check your internet connection' };
   }

package/src/core/loop.js

@@ -27,7 +27,7 @@ import { spawn } from 'node:child_process';
 
 import {
   ask, model, setModel, modelName, modelList, contextLimit, rateLimits,
-  estimateConversation, MODELS, DEFAULT_MODEL, PROVIDER, fallbackFor,
+  estimateConversation, MODELS, DEFAULT_MODEL, PROVIDER, fallbackFor, backupFor,
 } from './provider.js';
 import {
   tools, runTool, describe, setRoot, setConfirm, setRequest,
@@ -1946,6 +1946,26 @@ export class Agent {
       .map((f) => ({ abs: path.resolve(this.cwd, f.path), size: f.content.length, path: f.path }));
   }
 
+  /**
+   * A model that has just made todo-app/ sometimes writes app.js beside it
+   * instead of in it: the page never gets its script, and the hand-over, which
+   * watches the app folder, never fires. A bare name the app already has, and
+   * this folder does not, goes into the app.
+   */
+  intoApp(call) {
+    const app = this.apps?.at(-1);
+    if (!app) return;
+    const fix = (p) => {
+      if (typeof p !== 'string' || path.isAbsolute(p) || existsSync(path.resolve(this.cwd, p))) return p;
+      const inside = path.join(app, p);
+      if (path.relative(app, inside).startsWith('..') || !existsSync(inside)) return p;
+      return path.relative(this.cwd, inside).split(path.sep).join('/');
+    };
+    const a = call.args ?? {};
+    if (call.name === 'write_file') a.path = fix(a.path);
+    else if (call.name === 'batch_write') a.files = normaliseFiles(a.files).map((f) => (f && typeof f === 'object' ? { ...f, path: fix(f.path) } : f));
+  }
+
   async dispatch(call, offered = this.offering) {
     // The model emitted arguments that were not valid JSON. Hand the parser's
     // own complaint straight back so it can correct itself next step.
@@ -2053,6 +2073,8 @@ export class Agent {
       }
     }
 
+    if (call.name === 'write_file' || call.name === 'batch_write') this.intoApp(call);
+
     if (call.name === 'load_skill') return this.loadSkill(call.args?.name);
     if (call.name === 'update_plan') return this.updatePlan(call.args?.items);
     if (call.name === 'delegate') return this.delegate(call.args?.tasks);
@@ -2073,6 +2095,8 @@ export class Agent {
     if (++this.failovers > MAX_FAILOVERS) return false;
     const from = model();
     let next = fallbackFor(from, this.tried);
+    const backup = err.kind !== 'rate_limit' && backupFor(from);
+    if (!next && backup && !this.tried?.has(backup)) next = backup;
 
     const why = err.kind === 'rate_limit' ? 'busy' : err.kind === 'timeout' ? 'too slow to answer' : 'not answering';
 

package/src/core/provider.js

@@ -104,6 +104,15 @@ export function fallbackFor(id, tried = new Set()) {
   return null;
 }
 
+/**
+ * Where a Flash-Lite model goes when Google is overloaded (503) or it freezes.
+ * Unlike fallbackFor this is on by default: both Lite models go down together
+ * at peak hours while Flash keeps answering, and a build that waits on them
+ * can wait for hours. UCODE_BACKUP=0 turns it off.
+ */
+export const backupFor = (id) =>
+  /flash-lite/.test(id) && process.env.UCODE_BACKUP !== '0' ? 'gemini-3.5-flash' : null;
+
 /** Seconds to wait on successive rate limits that come with no retry-after. */
 const RATE_LIMIT_BACKOFF = [5, 10, 20];
 
@@ -711,7 +720,7 @@ export async function ask(messages, tools = [], opts = {}) {
           kind: 'stalled',
           attempted: `asking ${modelName(id)} for a reply`,
           failed: `${modelName(id)} froze ${MAX_STALLS} times in a row — it took the request and then sent nothing.`,
-          fix: 'Its free endpoint is struggling right now. Run /model and pick another one; North Mini Code answers soonest.',
+          fix: 'Google is struggling with it right now. Run /model and pick another one.',
           cause: problem,
         });
       }
@@ -741,6 +750,7 @@ export async function ask(messages, tools = [], opts = {}) {
       if (!worthRetrying || attempt === attempts || opts.signal?.aborted) break;
       if (printed > 0) break; // half an answer is on screen; do not print it twice
       if (problem.detail?.handed) break; // its first tool calls are already running
+      if (problem.kind === 'timeout' && backupFor(id)) break; // one freeze is enough: the loop moves to the backup
 
       // A stalled provider needs longer to come back than a dropped socket
       // does, and the wait is narrated so a slow turn never looks like a hang.