ucode-agent 1.61.1 → 1.62.1

package/THIRD_PARTY_NOTICES.md

@@ -1,34 +1,34 @@
-# Third-party notices
-
-ucode adapts logic from the following open-source project.
-
-## opencode
-
-Used in `src/tools/fuzzy.js` (the fallback matchers an edit tries when its
-text is not in the file as written), `src/core/window.js` (the anchored
-summary template), and `src/core/provider.js` (the context-overflow and
-transient-error patterns, and tool-name repair).
-
-```
-MIT License
-
-Copyright (c) 2025 opencode
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-```
+# Third-party notices
+
+ucode adapts logic from the following open-source project.
+
+## opencode
+
+Used in `src/tools/fuzzy.js` (the fallback matchers an edit tries when its
+text is not in the file as written), `src/core/window.js` (the anchored
+summary template), and `src/core/provider.js` (the context-overflow and
+transient-error patterns, and tool-name repair).
+
+```
+MIT License
+
+Copyright (c) 2025 opencode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/package.json

@@ -1,64 +1,64 @@
-{
-  "name": "ucode-agent",
-  "version": "1.61.1",
-  "description": "ucode - a terminal coding agent that reads, edits and runs your code, on Google Gemini models.",
-  "type": "module",
-  "main": "ucode.js",
-  "bin": {
-    "ucode": "ucode.js"
-  },
-  "files": [
-    "ucode.js",
-    "src/",
-    "skills/",
-    "templates/",
-    "THIRD_PARTY_NOTICES.md"
-  ],
-  "scripts": {
-    "start": "node ucode.js",
-    "test": "node test/run.js",
-    "prepublishOnly": "node scripts/no-bundled-key.js && node test/run.js",
-    "hooks": "node scripts/install-hooks.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/sppideey/ucode-agent.git"
-  },
-  "bugs": {
-    "url": "https://github.com/sppideey/ucode-agent/issues"
-  },
-  "homepage": "https://github.com/sppideey/ucode-agent#readme",
-  "engines": {
-    "node": ">=22"
-  },
-  "keywords": [
-    "agent",
-    "cli",
-    "terminal",
-    "coding-agent",
-    "llm",
-    "nvidia",
-    "nemotron",
-    "cohere",
-    "nex-agi"
-  ],
-  "author": "om dixit",
-  "license": "MIT",
-  "dependencies": {
-    "@babel/parser": "^7.29.8",
-    "chalk": "^6.0.0",
-    "dotenv": "^17.4.2",
-    "jsonrepair": "^3.15.0",
-    "marked": "^15.0.12",
-    "marked-terminal": "^7.3.0",
-    "openai": "^7.4.0",
-    "playwright-core": "^1.63.0"
-  },
-  "devDependencies": {
-    "@types/node": "^26.5.1",
-    "typescript": "^5.9.3"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "ucode-agent",
+  "version": "1.62.1",
+  "description": "ucode - a terminal coding agent that reads, edits and runs your code, on Google Gemini models.",
+  "type": "module",
+  "main": "ucode.js",
+  "bin": {
+    "ucode": "ucode.js"
+  },
+  "files": [
+    "ucode.js",
+    "src/",
+    "skills/",
+    "templates/",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "scripts": {
+    "start": "node ucode.js",
+    "test": "node test/run.js",
+    "prepublishOnly": "node scripts/no-bundled-key.js && node test/run.js",
+    "hooks": "node scripts/install-hooks.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sppideey/ucode-agent.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sppideey/ucode-agent/issues"
+  },
+  "homepage": "https://github.com/sppideey/ucode-agent#readme",
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "agent",
+    "cli",
+    "terminal",
+    "coding-agent",
+    "llm",
+    "nvidia",
+    "nemotron",
+    "cohere",
+    "nex-agi"
+  ],
+  "author": "om dixit",
+  "license": "MIT",
+  "dependencies": {
+    "@babel/parser": "^7.29.8",
+    "chalk": "^6.0.0",
+    "dotenv": "^17.4.2",
+    "jsonrepair": "^3.15.0",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "openai": "^7.4.0",
+    "playwright-core": "^1.63.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.5.1",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/core/doctor.js

@@ -1,111 +1,111 @@
-/**
- * doctor.js — `ucode doctor` and /doctor: is everything ucode needs working?
- *
- * Every check runs at once and each has a short deadline, so the whole report
- * takes a few seconds. A problem comes with the one thing that fixes it.
- * Secret values are never printed — only whether they are there and accepted.
- */
-
-import { spawnSync } from 'node:child_process';
-import { existsSync, readdirSync } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { theme, dim, blue } from '../ui/theme.js';
-import { VERSION } from './version.js';
-import { ENV_FILE, BASE_URL, providerKey } from './provider.js';
-import { newer } from './updater.js';
-
-const DEADLINE = 6000;
-const timed = (ms = DEADLINE) => AbortSignal.timeout(ms);
-
-function version(cmd) {
-  const r = spawnSync(cmd, ['--version'], { encoding: 'utf8', shell: process.platform === 'win32', timeout: 5000 });
-  return r.status === 0 ? String(r.stdout).trim().split('\n')[0] : null;
-}
-
-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 {
-    // 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' };
-  }
-}
-
-async function checkVercel() {
-  const token = process.env.VERCEL_TOKEN;
-  if (!token) return { ok: null, name: 'Vercel', detail: 'no token — /deploy needs one', fix: `vercel.com/account/tokens → Create Token, then add VERCEL_TOKEN=... to ${ENV_FILE}` };
-  try {
-    const r = await fetch('https://api.vercel.com/v2/user', { headers: { Authorization: `Bearer ${token}` }, signal: timed() });
-    if (!r.ok) return { ok: false, name: 'Vercel', detail: 'token rejected', fix: 'Make a new token at vercel.com/account/tokens' };
-    const j = await r.json();
-    return { ok: true, name: 'Vercel', detail: `ready to deploy as ${j.user?.username ?? 'you'}` };
-  } catch {
-    return { ok: false, name: 'Vercel', detail: 'could not reach Vercel', fix: 'Check your internet connection' };
-  }
-}
-
-async function checkBrowser() {
-  try {
-    const { chromium } = await import('playwright-core');
-    for (const channel of ['msedge', 'chrome']) {
-      try {
-        const b = await chromium.launch({ channel, headless: true, timeout: 8000 });
-        await b.close();
-        return { ok: true, name: 'Browser', detail: `${channel === 'msedge' ? 'Edge' : 'Chrome'} — look_at_app can see your apps` };
-      } catch { /* try the next one */ }
-    }
-  } catch { /* playwright-core missing */ }
-  return { ok: false, name: 'Browser', detail: 'no Edge or Chrome found', fix: 'Install Google Chrome or Microsoft Edge' };
-}
-
-async function checkVersion() {
-  try {
-    const r = await fetch('https://registry.npmjs.org/ucode-agent/latest', { signal: timed() });
-    const latest = (await r.json()).version;
-    return newer(latest, VERSION)
-      ? { ok: null, name: 'ucode', detail: `${VERSION} · ${latest} is out`, fix: 'It updates itself on the next start, or: npm install -g ucode-agent' }
-      : { ok: true, name: 'ucode', detail: `${VERSION} · up to date` };
-  } catch {
-    return { ok: true, name: 'ucode', detail: VERSION };
-  }
-}
-
-function checkTools() {
-  const [major] = process.versions.node.split('.').map(Number);
-  const out = [
-    major >= 22
-      ? { ok: true, name: 'Node', detail: process.versions.node }
-      : { ok: false, name: 'Node', detail: process.versions.node, fix: 'Install Node 22 or newer from nodejs.org' },
-  ];
-  const npm = version('npm');
-  out.push(npm ? { ok: true, name: 'npm', detail: npm } : { ok: false, name: 'npm', detail: 'not found', fix: 'Reinstall Node, which includes npm' });
-  const git = version('git');
-  out.push(git ? { ok: true, name: 'git', detail: git.replace(/^git version /, '') } : { ok: null, name: 'git', detail: 'not found', fix: 'Optional — install git to keep history of your apps' });
-  const cache = path.join(os.homedir(), '.ucode', 'cache');
-  if (existsSync(cache)) out.push({ ok: true, name: 'Starter cache', detail: `${readdirSync(cache).length} ready` });
-  return out;
-}
-
-/** Run every check; returns the lines to print. */
-export async function runDoctor() {
-  const results = [
-    ...checkTools(),
-    ...(await Promise.all([checkKey(), checkVercel(), checkBrowser(), checkVersion()])),
-  ];
-  const width = Math.max(...results.map((r) => r.name.length));
-  const lines = ['', `  ${blue('ucode doctor')}`];
-  for (const r of results) {
-    const mark = r.ok === true ? theme.ok('✓') : r.ok === false ? theme.error('✗') : theme.warn('!');
-    lines.push(`  ${mark} ${r.name.padEnd(width)}  ${r.detail}`);
-    if (r.fix && r.ok !== true) lines.push(`    ${' '.repeat(width)}  ${dim(`→ ${r.fix}`)}`);
-  }
-  const bad = results.filter((r) => r.ok === false).length;
-  lines.push('', bad ? `  ${bad} thing${bad === 1 ? '' : 's'} to fix` : `  ${theme.ok('All good')}`, '');
-  return lines;
-}
+/**
+ * doctor.js — `ucode doctor` and /doctor: is everything ucode needs working?
+ *
+ * Every check runs at once and each has a short deadline, so the whole report
+ * takes a few seconds. A problem comes with the one thing that fixes it.
+ * Secret values are never printed — only whether they are there and accepted.
+ */
+
+import { spawnSync } from 'node:child_process';
+import { existsSync, readdirSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { theme, dim, blue } from '../ui/theme.js';
+import { VERSION } from './version.js';
+import { ENV_FILE, BASE_URL, providerKey } from './provider.js';
+import { newer } from './updater.js';
+
+const DEADLINE = 6000;
+const timed = (ms = DEADLINE) => AbortSignal.timeout(ms);
+
+function version(cmd) {
+  const r = spawnSync(cmd, ['--version'], { encoding: 'utf8', shell: process.platform === 'win32', timeout: 5000 });
+  return r.status === 0 ? String(r.stdout).trim().split('\n')[0] : null;
+}
+
+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 {
+    // 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' };
+  }
+}
+
+async function checkVercel() {
+  const token = process.env.VERCEL_TOKEN;
+  if (!token) return { ok: null, name: 'Vercel', detail: 'no token — /deploy needs one', fix: `vercel.com/account/tokens → Create Token, then add VERCEL_TOKEN=... to ${ENV_FILE}` };
+  try {
+    const r = await fetch('https://api.vercel.com/v2/user', { headers: { Authorization: `Bearer ${token}` }, signal: timed() });
+    if (!r.ok) return { ok: false, name: 'Vercel', detail: 'token rejected', fix: 'Make a new token at vercel.com/account/tokens' };
+    const j = await r.json();
+    return { ok: true, name: 'Vercel', detail: `ready to deploy as ${j.user?.username ?? 'you'}` };
+  } catch {
+    return { ok: false, name: 'Vercel', detail: 'could not reach Vercel', fix: 'Check your internet connection' };
+  }
+}
+
+async function checkBrowser() {
+  try {
+    const { chromium } = await import('playwright-core');
+    for (const channel of ['msedge', 'chrome']) {
+      try {
+        const b = await chromium.launch({ channel, headless: true, timeout: 8000 });
+        await b.close();
+        return { ok: true, name: 'Browser', detail: `${channel === 'msedge' ? 'Edge' : 'Chrome'} — look_at_app can see your apps` };
+      } catch { /* try the next one */ }
+    }
+  } catch { /* playwright-core missing */ }
+  return { ok: false, name: 'Browser', detail: 'no Edge or Chrome found', fix: 'Install Google Chrome or Microsoft Edge' };
+}
+
+async function checkVersion() {
+  try {
+    const r = await fetch('https://registry.npmjs.org/ucode-agent/latest', { signal: timed() });
+    const latest = (await r.json()).version;
+    return newer(latest, VERSION)
+      ? { ok: null, name: 'ucode', detail: `${VERSION} · ${latest} is out`, fix: 'It updates itself on the next start, or: npm install -g ucode-agent' }
+      : { ok: true, name: 'ucode', detail: `${VERSION} · up to date` };
+  } catch {
+    return { ok: true, name: 'ucode', detail: VERSION };
+  }
+}
+
+function checkTools() {
+  const [major] = process.versions.node.split('.').map(Number);
+  const out = [
+    major >= 22
+      ? { ok: true, name: 'Node', detail: process.versions.node }
+      : { ok: false, name: 'Node', detail: process.versions.node, fix: 'Install Node 22 or newer from nodejs.org' },
+  ];
+  const npm = version('npm');
+  out.push(npm ? { ok: true, name: 'npm', detail: npm } : { ok: false, name: 'npm', detail: 'not found', fix: 'Reinstall Node, which includes npm' });
+  const git = version('git');
+  out.push(git ? { ok: true, name: 'git', detail: git.replace(/^git version /, '') } : { ok: null, name: 'git', detail: 'not found', fix: 'Optional — install git to keep history of your apps' });
+  const cache = path.join(os.homedir(), '.ucode', 'cache');
+  if (existsSync(cache)) out.push({ ok: true, name: 'Starter cache', detail: `${readdirSync(cache).length} ready` });
+  return out;
+}
+
+/** Run every check; returns the lines to print. */
+export async function runDoctor() {
+  const results = [
+    ...checkTools(),
+    ...(await Promise.all([checkKey(), checkVercel(), checkBrowser(), checkVersion()])),
+  ];
+  const width = Math.max(...results.map((r) => r.name.length));
+  const lines = ['', `  ${blue('ucode doctor')}`];
+  for (const r of results) {
+    const mark = r.ok === true ? theme.ok('✓') : r.ok === false ? theme.error('✗') : theme.warn('!');
+    lines.push(`  ${mark} ${r.name.padEnd(width)}  ${r.detail}`);
+    if (r.fix && r.ok !== true) lines.push(`    ${' '.repeat(width)}  ${dim(`→ ${r.fix}`)}`);
+  }
+  const bad = results.filter((r) => r.ok === false).length;
+  lines.push('', bad ? `  ${bad} thing${bad === 1 ? '' : 's'} to fix` : `  ${theme.ok('All good')}`, '');
+  return lines;
+}

package/src/core/login.js

@@ -1,59 +1,59 @@
-/**
- * login.js — putting the API key somewhere ucode will always find it.
- *
- * A key in a project's .env is a key you set up again in the next folder, and
- * on the next machine. This writes it once to ~/.ucode/.env, which every
- * project on the machine reads, so setting ucode up somewhere new — a borrowed
- * laptop, a machine you are demonstrating on — is one command.
- *
- * The file is written with owner-only permissions, and the existing contents
- * are kept: a key is replaced in place rather than by rewriting the file.
- */
-
-import { promises as fs } from 'node:fs';
-import path from 'node:path';
-import { ENV_FILE } from './provider.js';
-
-const NAME = 'GEMINI_API_KEY';
-
-/** A plausible Google key (AIza... or the newer AQ.... form), so a typo is caught here. */
-export function looksLikeKey(key) {
-  return typeof key === 'string' && /^(?:AIza[\w-]{30,}|AQ\.[\w.-]{30,})$/.test(key.trim());
-}
-
-/** Put `key` in the machine-wide env file, keeping whatever else is in it. */
-export function withKey(existing, key) {
-  const line = `${NAME}=${key}`;
-  const lines = String(existing ?? '').split('\n');
-  let replaced = false;
-  const out = lines.map((l) => {
-    if (new RegExp(`^\\s*(?:export\\s+)?${NAME}\\s*=`).test(l)) {
-      replaced = true;
-      return line;
-    }
-    return l;
-  });
-  if (!replaced) {
-    if (out.length && out[out.length - 1].trim() !== '') out.push('');
-    out.splice(out.length - 1, 0, line);
-  }
-  return out.join('\n').replace(/\n{3,}/g, '\n\n');
-}
-
-export async function saveKey(key) {
-  const trimmed = String(key ?? '').trim();
-
-  if (!trimmed) {
-    return `  Usage: ucode login <key>\n\n  Get one free at https://aistudio.google.com/apikey\n  It is saved to ${ENV_FILE} and used by every project on this machine.`;
-  }
-  if (!looksLikeKey(trimmed)) {
-    return `  That does not look like a Google key — they start with "AIza" or "AQ.".\n  Get one at https://aistudio.google.com/apikey`;
-  }
-
-  const existing = await fs.readFile(ENV_FILE, 'utf8').catch(() => '');
-  await fs.mkdir(path.dirname(ENV_FILE), { recursive: true });
-  await fs.writeFile(ENV_FILE, withKey(existing, trimmed), { encoding: 'utf8', mode: 0o600 });
-  await fs.chmod(ENV_FILE, 0o600).catch(() => {});
-
-  return `  Key saved to ${ENV_FILE}\n  Every project on this machine will use it. Run ucode anywhere to start.`;
-}
+/**
+ * login.js — putting the API key somewhere ucode will always find it.
+ *
+ * A key in a project's .env is a key you set up again in the next folder, and
+ * on the next machine. This writes it once to ~/.ucode/.env, which every
+ * project on the machine reads, so setting ucode up somewhere new — a borrowed
+ * laptop, a machine you are demonstrating on — is one command.
+ *
+ * The file is written with owner-only permissions, and the existing contents
+ * are kept: a key is replaced in place rather than by rewriting the file.
+ */
+
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { ENV_FILE } from './provider.js';
+
+const NAME = 'GEMINI_API_KEY';
+
+/** A plausible Google key (AIza... or the newer AQ.... form), so a typo is caught here. */
+export function looksLikeKey(key) {
+  return typeof key === 'string' && /^(?:AIza[\w-]{30,}|AQ\.[\w.-]{30,})$/.test(key.trim());
+}
+
+/** Put `key` in the machine-wide env file, keeping whatever else is in it. */
+export function withKey(existing, key) {
+  const line = `${NAME}=${key}`;
+  const lines = String(existing ?? '').split('\n');
+  let replaced = false;
+  const out = lines.map((l) => {
+    if (new RegExp(`^\\s*(?:export\\s+)?${NAME}\\s*=`).test(l)) {
+      replaced = true;
+      return line;
+    }
+    return l;
+  });
+  if (!replaced) {
+    if (out.length && out[out.length - 1].trim() !== '') out.push('');
+    out.splice(out.length - 1, 0, line);
+  }
+  return out.join('\n').replace(/\n{3,}/g, '\n\n');
+}
+
+export async function saveKey(key) {
+  const trimmed = String(key ?? '').trim();
+
+  if (!trimmed) {
+    return `  Usage: ucode login <key>\n\n  Get one free at https://aistudio.google.com/apikey\n  It is saved to ${ENV_FILE} and used by every project on this machine.`;
+  }
+  if (!looksLikeKey(trimmed)) {
+    return `  That does not look like a Google key — they start with "AIza" or "AQ.".\n  Get one at https://aistudio.google.com/apikey`;
+  }
+
+  const existing = await fs.readFile(ENV_FILE, 'utf8').catch(() => '');
+  await fs.mkdir(path.dirname(ENV_FILE), { recursive: true });
+  await fs.writeFile(ENV_FILE, withKey(existing, trimmed), { encoding: 'utf8', mode: 0o600 });
+  await fs.chmod(ENV_FILE, 0o600).catch(() => {});
+
+  return `  Key saved to ${ENV_FILE}\n  Every project on this machine will use it. Run ucode anywhere to start.`;
+}