ucode-agent 1.62.2 → 1.62.3

package/README.md

@@ -27,7 +27,7 @@ corner:
          add a dark mode toggle that remembers the choice
 
 
-                                                                           v1.62.2
+                                                                           v1.62.3
 ```
 
 A light crosses the wordmark once as it opens, and the three lines under the box

package/package.json

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

package/skills/build-app/DIGEST.md

@@ -108,6 +108,18 @@ first time; then the server route with the real integration; then the core
 loop UI wired to it; then every state — empty, loading, success, error,
 invalid input; then polish: motion, responsive, copy, title and metadata.
 
+## 5a. It has to look finished
+
+People judge the app in the first second it is on screen, before they click
+anything. Before handing it over, check:
+
+- A real title and one line saying what it is for — never "Welcome to…".
+- The main action is visible without scrolling and is the most prominent button.
+- Every button and input has hover and focus states; nothing is left browser-default.
+- An empty list says what to do next ("No tasks yet — add one above"), never blank.
+- It fits a 375px phone with no sideways scroll; tap targets are at least 44px.
+- The number that matters (a score, a total, a timer) is big — several times body text.
+
 ## 5b. Tests, where there is a runner
 
 `next-shadcn` ships vitest and one passing test, so `npm test` works from

package/skills/build-app/SKILL.md

@@ -195,6 +195,18 @@ const res = await fetch('https://openrouter.ai/api/v1/chat/completions', {
 
 Use `batch_write` for the skeleton — one call, every file.
 
+## 5a. It has to look finished
+
+People judge the app in the first second it is on screen, before they click
+anything. Before handing it over, check:
+
+- A real title and one line saying what it is for — never "Welcome to…".
+- The main action is visible without scrolling and is the most prominent button.
+- Every button and input has hover and focus states; nothing is left browser-default.
+- An empty list says what to do next ("No tasks yet — add one above"), never blank.
+- It fits a 375px phone with no sideways scroll; tap targets are at least 44px.
+- The number that matters (a score, a total, a timer) is big — several times body text.
+
 ## 6. Prove it works
 
 - `npm run build` — it type-checks and lints; a build that fails is not done.

package/src/core/loop.js

@@ -1246,7 +1246,8 @@ export class Agent {
     this.abort = new AbortController();
     this.endedSilently = false;
 
-    const turnStarted = Date.now();
+    // Kept on the agent too: the hand-over says how long the build took.
+    const turnStarted = (this.turnStarted = Date.now());
     let finished = false;
     this.ui.turnStart?.();
     try {
@@ -1592,8 +1593,7 @@ export class Agent {
               `${modelName()} produced invalid tool arguments ${argRetries} times running ` +
               'and could not correct itself.',
             fix:
-              'Say what you want more concretely, or /model to another one — North Mini ' +
-              'Code and Nemotron 3.5 Lightning are both steadier with tool arguments.',
+              'Say what you want more concretely, or /model to another one.',
           });
         }
       } else {
@@ -1750,13 +1750,29 @@ export class Agent {
     const server = serversReadySince(since).at(-1);
     if (!server || (this.opened ??= new Set()).has(server.url)) return;
     this.opened.add(server.url);
+    if (this.openInBrowser(server.url)) this.ui.note(`Opened ${server.url} in your browser`);
+  }
+
+  /**
+   * Show a URL or a local page in the desktop browser. False when it did not.
+   *
+   * A file goes to explorer on Windows, not `cmd /c start`: the folder name
+   * comes from the model, and an & in it would be a second command to cmd.
+   */
+  openInBrowser(target) {
+    if (!this.full || process.env.UCODE_OPEN === '0') return false;
+    const web = /^https?:\/\//.test(target);
+    // Only pages inside the project: a UNC path would have explorer reach out to another machine.
+    const rel = web ? '' : path.relative(this.cwd, target);
+    if (!web && (!rel || rel.startsWith('..') || path.isAbsolute(rel))) return false;
     const [cmd, args] = process.platform === 'win32'
-      ? ['cmd', ['/c', 'start', '', server.url]]
-      : [process.platform === 'darwin' ? 'open' : 'xdg-open', [server.url]];
+      ? (web ? ['cmd', ['/c', 'start', '', target]] : ['explorer.exe', [target]])
+      : [process.platform === 'darwin' ? 'open' : 'xdg-open', [target]];
     try {
-      spawn(cmd, args, { stdio: 'ignore', detached: true, windowsHide: true }).unref();
-      this.ui.note(`Opened ${server.url} in your browser`);
-    } catch { /* no browser to open — the link is in the answer */ }
+      // A missing opener (no xdg-open) fails later, as an event; unheard, it would crash ucode.
+      spawn(cmd, args, { stdio: 'ignore', detached: true, windowsHide: true }).on('error', () => {}).unref();
+      return true;
+    } catch { return false; /* no browser to open — the link is in the answer */ }
   }
 
   cmdStats() {
@@ -2597,11 +2613,16 @@ export class Agent {
     const made = calls.find((c) => c.name === 'create_app' && c.args?.name)?.args.name ?? this.appName;
     const name = String(made ?? path.basename(app)).trim();
     this.appName = name;
-    const link = pathToFileURL(path.join(app, 'index.html')).href;
-    const text = `${name} is done. Open it here: ${link}\n\n(or open \`${show}/index.html\` in your browser)`;
+    const page = path.join(app, 'index.html');
+    const link = pathToFileURL(page).href;
+    // "Quiz is done in 42s": how long the whole build took, from the request.
+    const took = this.turnStarted ? ` in ${formatDuration(Date.now() - this.turnStarted)}` : '';
+    const text = `${name} is done${took}. Open it here: ${link}\n\n(or open \`${show}/index.html\` in your browser)`;
     this.push({ role: 'assistant', content: text });
     this.ui.assistant(text, { closing: true });
     await this.persist();
+    // The app pops up on its own; UCODE_OPEN=0 keeps it to the link.
+    this.openInBrowser(page);
     return { done: true };
   }
 

package/src/core/provider.js

@@ -500,9 +500,8 @@ export function explain(err, id) {
         : `Too many requests for ${modelName(id)} just now${wait ? ` — clear in ${wait}` : ''}.`,
       fix: daily
         ? `It resets ${resetAt ? `at ${resetAt.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })}` : 'once a day'}. ` +
-          'Adding credit to your account raises the limit.'
-        : 'ucode waits these out on its own. Free endpoints are shared, so it usually ' +
-          'clears in seconds; /model moves to a quieter one.',
+          'Nothing to do until then — the key is fine.'
+        : 'ucode waits these out on its own, usually for a few seconds. /model moves to another one.',
       detail: { retryAfter, daily, resetAt: resetAt?.getTime() ?? null },
       cause: err,
     });
@@ -596,10 +595,7 @@ export function explain(err, id) {
       kind: 'timeout',
       attempted,
       failed: `${modelName(id)} sent nothing back in time — the provider dropped the request.`,
-      fix:
-        'Free endpoints stall under load, and the largest reasoning models are the ' +
-        'first to. ucode already retried. If it keeps happening, /model to Nemotron ' +
-        '3.5 Lightning or North Mini Code, which answer sooner.',
+      fix: 'ucode already retried. Google is busy right now — send again, or /model to another one.',
       detail: { status },
       cause: err,
     });
@@ -609,7 +605,7 @@ export function explain(err, id) {
     return new Failure({
       kind: 'server',
       attempted,
-      failed: `The provider returned HTTP ${status}. That is their side, not yours.`,
+      failed: `Google's servers are busy right now (HTTP ${status}). That is their side, not yours.`,
       fix: 'Wait a few seconds and send again. If it persists, /model to another one.',
       cause: err,
     });
@@ -627,11 +623,14 @@ export function explain(err, id) {
     return new Failure({
       kind: 'network',
       attempted,
-      failed: `The connection to the model dropped: ${raw}`,
+      // No DNS answer: the machine is offline, and saying so
+      // beats a raw "getaddrinfo ENOTFOUND" on a demo screen.
+      failed: /ENOTFOUND|EAI_AGAIN|getaddrinfo/i.test(raw)
+        ? 'ucode could not reach Google — this computer looks offline.'
+        : `The connection to Google dropped: ${raw}`,
       fix:
-        'ucode retries this by itself. If it keeps happening, check your connection, ' +
-        'VPN and any corporate proxy (HTTPS_PROXY) — or /model to a lighter one, since ' +
-        'a long think on a busy free endpoint is the usual cause.',
+        'ucode retries this by itself. If it keeps happening, check the Wi-Fi, ' +
+        'VPN and any proxy (HTTPS_PROXY), then send again.',
       cause: err,
     });
   }
@@ -785,7 +784,7 @@ async function streamed(request, opts, id) {
     kind: 'timeout',
     attempted: `asking ${modelName(id)} for a reply`,
     failed: `${modelName(id)} went silent for ${Math.round(limit() / 1000)}s, so ucode stopped waiting.`,
-    fix: 'ucode asks again by itself. If it keeps freezing, /model to North Mini Code.',
+    fix: 'ucode asks again by itself. If it keeps freezing, /model to another one.',
     detail: { stalled: true, handed: handed.size },
     cause,
   });