zames_pro 2.6.0 → 2.7.0

package/dist/spinner.js

@@ -2,8 +2,8 @@ import ora from 'ora';
 import { theme } from './theme.js';
 import { renderMarkdown } from './markdown.js';
 import { translate } from './i18n.js';
-// Фразы для спиннера «агент работает». Выбираются в случайном порядке.
-// Текст берётся из i18n по ключу 'spinner.phrases' (строки разделены «|»).
+// Phrases for the "agent is working" spinner. Chosen in random order.
+// The text comes from i18n via the key 'spinner.phrases' (strings separated by "|").
 export function randomThinkingPhrase(locale = 'ru') {
     const raw = translate(locale)('spinner.phrases');
     const phrases = raw.split('|').filter((s) => s.trim().length);
@@ -11,7 +11,7 @@ export function randomThinkingPhrase(locale = 'ru') {
         return '';
     return phrases[Math.floor(Math.random() * phrases.length)];
 }
-// Убираем завершающее многоточие из фразы — точки анимируем отдельно.
+// Strip the trailing ellipsis from the phrase — dots are animated separately.
 export function stripEllipsis(phrase) {
     return phrase.replace(/[.…]+\s*$/, '');
 }
@@ -20,8 +20,8 @@ export function createSpinner(locale = 'ru') {
     let dotTimer = null;
     let dotPhase = 0;
     let pending = null;
-    // Анимация точек: старт с пустой строки (0 точек), затем рост.
-    // Ширину выравниваем по максимуму (3), чтобы подсказка не смещалась.
+    // Dot animation: start from an empty string (0 dots), then grow.
+    // We align the width to the maximum (3) so the hint doesn't shift.
     const DOTS = ['', '.', '..', '...'];
     const DOTS_PAD = '   ';
     const start = (text) => {
@@ -38,14 +38,14 @@ export function createSpinner(locale = 'ru') {
         if (spinner)
             spinner.stop();
     };
-    // Подсказка в строке статуса: во время работы агента терминал живой,
-    // можно печатать следующее сообщение. Без неё это неочевидно.
+    // Hint in the status line: while the agent works the terminal is live,
+    // so you can type the next message. Without it this is not obvious.
     const HINT = theme.dim('  ·  ' + translate(locale)('spinner.hint'));
-    // Запуск анимированного статуса: коричневый текст + «бегущие» точки.
+    // Start the animated status: brown text + "running" dots.
     const startThinking = () => {
         const base = theme.brown(stripEllipsis(randomThinkingPhrase(locale)));
-        // Точки того же цвета, что и база, и фиксированной ширины — иначе
-        // подсказка справа «прыгает» при смене фазы анимации.
+        // The dots are the same color as the base and of fixed width — otherwise
+        // the hint on the right "jumps" when the animation phase changes.
         const dots = (n) => theme.brown(DOTS[n] + DOTS_PAD.slice(DOTS[n].length));
         start(base + dots(0) + HINT);
         dotPhase = 0;
@@ -60,8 +60,8 @@ export function createSpinner(locale = 'ru') {
         if (dotTimer.unref)
             dotTimer.unref();
     };
-    // Показать набранный, но ещё не отправленный текст вместо спиннера.
-    // Позволяет печатать сообщение прямо во время работы агента.
+    // Show the typed but not yet sent text instead of the spinner.
+    // Lets you type a message right while the agent is working.
     const showPending = () => {
         if (dotTimer) {
             clearInterval(dotTimer);
@@ -80,8 +80,8 @@ export function createSpinner(locale = 'ru') {
             }
             startThinking();
         },
-        // Текст, который пользователь набирает во время работы агента.
-        // Пустая строка / null — вернуть обычный спиннер.
+        // The text the user types while the agent is working.
+        // Empty string / null — restore the regular spinner.
         setPending: (text) => {
             pending = text && String(text).length ? String(text) : null;
             if (pending)
@@ -104,12 +104,16 @@ export function createSpinner(locale = 'ru') {
             stop();
             const NL = String.fromCharCode(10);
             const rendered = renderMarkdown(msg);
-            // Маркер ответа модели: помогает визуально отделить его от ввода
-            // пользователя (который подсвечен приглашением с золотой стрелкой).
+            // Model answer marker: helps visually separate it from the user's input
+            // (which is highlighted by the prompt with a golden arrow).
             console.log(NL + theme.assistant('● Ответ') + NL);
             console.log(rendered);
             console.log(theme.dim('─'.repeat(60)) + NL);
         },
+        warning: (msg) => {
+            stop();
+            console.log(String.fromCharCode(10) + theme.warn('⚠ ' + msg));
+        },
         stop,
         succeed: () => { },
         fail: () => { },

package/dist/system-prompt.js

@@ -65,6 +65,29 @@ To give a final answer to the user, respond with:
 
 {"tool": "respond", "args": {"message": "your final answer here"}}
 
+## TOOL CALL FORMAT - EXACT REQUIREMENTS (read carefully)
+
+The parser is strict about the SHAPE of your call. These mistakes have caused
+the agent to silently stall (the call was not recognized, so the task ended):
+
+1. ALWAYS wrap the call in curly braces { ... }. Never emit tool-colon-quote
+   without the leading brace. Never drop the very first character.
+2. ALWAYS put DOUBLE quotes around keys and string values, e.g.
+   {"tool": "Read", "args": {"path": "a.ts"}}.
+   NEVER use single quotes; that is not valid JSON.
+3. NEVER wrap the call in markdown fences or in XML/DSML tags
+   (invoke, parameter, tool_calls, DSML variants). Plain JSON only.
+4. NEVER put prose before or after the JSON in the same response. Not even
+   a short lead-in. The whole response is the JSON.
+5. Do NOT truncate long calls. If a Bash command, file content, or Edit is
+   large, SPLIT it: run several smaller Bash commands, or write the file in
+   parts (Write then Edit). A cut-off JSON never parses and stalls the agent.
+6. One object per call; to call several independent tools at once, use a JSON
+   ARRAY of objects, still no prose around it.
+
+If you catch yourself about to emit anything other than a bare JSON object or
+array, stop and reformat it first. A malformed call is worse than a slow one.
+
 ## Git
 
 - You CAN commit and push using GitAdd / GitCommit / GitPush. Prefer these over raw \`git\` through Bash.

package/dist/theme.js

@@ -1,32 +1,32 @@
 import chalk from 'chalk';
-// Спокойная палитра для тёмного терминала.
-// Приглушённые, слегка «выцветшие» тона без высокой насыщенности
-// (в духе Tokyo Night / Nord). Задача — комфортное чтение длинных
-// ответов, а не максимальная контрастность.
+// A calm palette for a dark terminal.
+// Muted, slightly "faded" tones without high saturation
+// (in the spirit of Tokyo Night / Nord). The goal is comfortable reading of
+// long answers, not maximum contrast.
 //
-// Роли:
-//   - user        — мягкий лавандово-серый (служебные сообщения)
-//   - prompt      — тёплое золотистое (приглашение ввода, заметное)
-//   - dir         — светло-голубое (имя рабочей директории)
-//   - assistant   — тёплый песочный (ответы модели)
-//   - tool        — приглушённый янтарный
-//   - toolResult  — серо-голубой
-//   - system      — нейтральный серый
-//   - warn        — спокойный охра
-//   - error       — приглушённый терракот
+// Roles:
+//   - user        — soft lavender-gray (service messages)
+//   - prompt      — warm gold (input prompt, noticeable)
+//   - dir         — light blue (working directory name)
+//   - assistant   — warm sand (model answers)
+//   - tool        — muted amber
+//   - toolResult  — gray-blue
+//   - system      — neutral gray
+//   - warn        — calm ochre
+//   - error       — muted terracotta
 export const theme = {
-    user: chalk.hex('#b4b8d0'), // мягкий лавандово-серый
-    prompt: chalk.hex('#c8b06a').bold, // приглашение ввода — тёплое золотистое, заметное
-    dir: chalk.hex('#7fc4f0'), // имя рабочей директории — заметно голубое
-    assistant: chalk.hex('#cfc9b0'), // тёплый песочный
-    tool: chalk.hex('#c6a97e'), // приглушённый янтарный
-    toolResult: chalk.hex('#8a9bb5'), // серо-голубой
-    system: chalk.hex('#808896'), // нейтральный серый
-    dim: chalk.hex('#5b616e'), // тёмно-серый
-    warn: chalk.hex('#c9a86a'), // спокойный охра
-    error: chalk.hex('#c98a80'), // приглушённый терракот
-    success: chalk.hex('#a9c08c'), // мягкий шалфейный
-    brown: chalk.hex('#a1723f'), // коричневый (статус/спиннер)
+    user: chalk.hex('#b4b8d0'), // soft lavender-gray
+    prompt: chalk.hex('#c8b06a').bold, // input prompt — warm gold, noticeable
+    dir: chalk.hex('#7fc4f0'), // working directory name — noticeably blue
+    assistant: chalk.hex('#cfc9b0'), // warm sand
+    tool: chalk.hex('#c6a97e'), // muted amber
+    toolResult: chalk.hex('#8a9bb5'), // gray-blue
+    system: chalk.hex('#808896'), // neutral gray
+    dim: chalk.hex('#5b616e'), // dark gray
+    warn: chalk.hex('#c9a86a'), // calm ochre
+    error: chalk.hex('#c98a80'), // muted terracotta
+    success: chalk.hex('#a9c08c'), // soft sage
+    brown: chalk.hex('#a1723f'), // brown (status/spinner)
     bold: chalk.bold,
 };
 export default theme;

package/dist/tools.js

@@ -7,16 +7,16 @@ export function createTools(workdir, { undo } = {}) {
     const root = path.resolve(workdir);
     const safe = (p) => {
         const resolved = path.resolve(root, p);
-        // startsWith(root) пропускал бы соседние пути с общим префиксом
-        // (C:\work\proj vs C:\work\proj-old). Считаем через relative().
+        // startsWith(root) would let through sibling paths with a common prefix
+        // (C:\work\proj vs C:\work\proj-old). We compute via relative().
         const rel = path.relative(root, resolved);
         if (rel.startsWith('..') || path.isAbsolute(rel)) {
             throw new Error(`Доступ за пределы рабочей директории: ${p}`);
         }
         return resolved;
     };
-    // Sandbox (вариант A): не даём команде выйти выше root.
-    // Это защитный барьер, а не полноценная изоляция ОС.
+    // Sandbox (option A): don't let the command go above root.
+    // This is a protective barrier, not full OS isolation.
     const assertCommandInsideRoot = (command) => {
         const cmd = String(command || '');
         const cdRe = /(?:^|[;&|]|\s)(?:cd|pushd)\s+([^;&|]+)/gi;
@@ -74,10 +74,10 @@ export function createTools(workdir, { undo } = {}) {
             resolve(parts.join('\n'));
         });
     });
-    // Достаёт текст из content/content_base64. base64 нужен, потому что канал
-    // передачи ответа модели может искажать символы ($, обратные слэши,
-    // переводы строк). base64 состоит только из [A-Za-z0-9+/=] и искажению
-    // не подвержен.
+    // Extracts text from content/content_base64. base64 is needed because the
+    // channel that delivers the model's answer may corrupt characters ($,
+    // backslashes, newlines). base64 consists only of [A-Za-z0-9+/=] and is not
+    // subject to corruption.
     const decodeContent = (content, contentBase64) => {
         if (typeof contentBase64 === 'string' && contentBase64.length) {
             return Buffer.from(contentBase64, 'base64').toString('utf-8');
@@ -172,7 +172,7 @@ export function createTools(workdir, { undo } = {}) {
                 const { glob } = await import('fs/promises');
                 const results = [];
                 for await (const f of glob(String(pattern), { cwd: workdir })) {
-                    // Sandbox: игнорируем всё, что выходит за пределы root.
+                    // Sandbox: ignore anything that goes outside root.
                     const abs = path.resolve(workdir, f);
                     const rel = path.relative(root, abs);
                     if (rel.startsWith('..') || path.isAbsolute(rel))

package/dist/transcript.js

@@ -17,8 +17,8 @@ export class Transcript {
             const stamp = new Date().toISOString().replace(/[:.]/g, '-');
             this.file = path.join(dir, `${sessionName}-${stamp}.jsonl`);
             this.stream = fs.createWriteStream(this.file, { flags: 'a' });
-            // Ошибки записи (диск переполнен, файл удалён и т.п.) приходят
-            // событием 'error'; без слушателя это uncaught exception.
+            // Write errors (disk full, file deleted, etc.) arrive as an 'error'
+            // event; without a listener this is an uncaught exception.
             this.stream.on('error', (e) => {
                 console.error(`transcript: ошибка записи: ${e.message}`);
                 this.enabled = false;

package/dist/types.js

@@ -1,3 +1,3 @@
-// Общие типы-контракты для всего агента.
-// Здесь только типы — ни рантайм-кода, ни побочных эффектов.
+// Shared contract types for the whole agent.
+// Types only here — no runtime code, no side effects.
 export {};

package/dist/web.js

@@ -1,27 +1,27 @@
 import { chromium } from 'playwright';
 const DEFAULT_TIMEOUT = 20_000;
 const MAX_TEXT = 12_000;
-// Убирает скрипты, стили, и превращает HTML в читабельный текст.
+// Removes scripts, styles, and turns HTML into readable text.
 function htmlToText(html) {
-    // Удаляем блоки, которые не нужны
+    // Remove blocks we don't need
     let s = html
         .replace(/<script[\s\S]*?<\/script>/gi, '')
         .replace(/<style[\s\S]*?<\/style>/gi, '')
         .replace(/<noscript[\s\S]*?<\/noscript>/gi, '')
         .replace(/<svg[\s\S]*?<\/svg>/gi, '')
         .replace(/<!--[\s\S]*?-->/g, '');
-    // Ссылки: <a href="URL">text</a> → text (URL)
+    // Links: <a href="URL">text</a> → text (URL)
     s = s.replace(/<a\b[^>]*href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/gi, (_, href, text) => {
         const t = text.replace(/<[^>]+>/g, '').trim();
         return t ? `${t} (${href})` : href;
     });
-    // Заголовки, параграфы, BR → переводы строк
+    // Headings, paragraphs, BR → newlines
     s = s
         .replace(/<\/(h[1-6]|p|div|li|tr|section|article)>/gi, '\n')
         .replace(/<br\s*\/?>/gi, '\n')
         .replace(/<li[^>]*>/gi, '- ')
         .replace(/<[^>]+>/g, '');
-    // HTML entities — базовые
+    // HTML entities — the basic ones
     s = s
         .replace(/&nbsp;/g, ' ')
         .replace(/&amp;/g, '&')
@@ -34,7 +34,7 @@ function htmlToText(html) {
         .replace(/&hellip;/g, '…')
         .replace(/&#(\d+);/g, (_, n) => String.fromCodePoint(Number(n)))
         .replace(/&#x([0-9a-f]+);/gi, (_, n) => String.fromCodePoint(parseInt(n, 16)));
-    // Сжимаем пустые строки
+    // Collapse blank lines
     s = s
         .split('\n')
         .map((l) => l.replace(/[ \t]+/g, ' ').trim())
@@ -42,7 +42,7 @@ function htmlToText(html) {
         .join('\n');
     return s;
 }
-// fetch с редиректами и таймаутом
+// fetch with redirects and a timeout
 async function httpFetch(url, { timeout = DEFAULT_TIMEOUT, headers = {} } = {}) {
     const ctrl = new AbortController();
     const t = setTimeout(() => ctrl.abort(), timeout);
@@ -64,8 +64,8 @@ async function httpFetch(url, { timeout = DEFAULT_TIMEOUT, headers = {} } = {})
         clearTimeout(t);
     }
 }
-// Отдельный headless-браузер для JS-страниц.
-// Ленивая инициализация, чтобы не тратить ресурсы впустую.
+// A separate headless browser for JS pages.
+// Lazy initialization so we don't waste resources.
 let _headless = null;
 async function getHeadless() {
     if (_headless)
@@ -96,7 +96,7 @@ async function renderWithHeadless(url, { timeout = DEFAULT_TIMEOUT } = {}) {
             waitUntil: 'domcontentloaded',
             timeout,
         });
-        // Дать JS немного времени дорисовать
+        // Give JS a little time to finish rendering
         await page.waitForTimeout(1500);
         const html = await page.content();
         const status = resp ? resp.status() : 0;
@@ -107,7 +107,7 @@ async function renderWithHeadless(url, { timeout = DEFAULT_TIMEOUT } = {}) {
         await ctx.close();
     }
 }
-// ---------- инструменты ----------
+// ---------- tools ----------
 export function createWebTools() {
     return [
         {
@@ -132,14 +132,14 @@ export function createWebTools() {
                         return formatResult(r.status, r.url, text, limit);
                     }
                     const r = await httpFetch(String(url));
-                    // Если это JSON/plain text — вернуть как есть
+                    // If it's JSON/plain text — return as is
                     if (/application\/json|text\/plain|text\/markdown/i.test(r.contentType)) {
                         const trimmed = r.body.slice(0, limit);
                         return `HTTP ${r.status}  ${r.url}\nContent-Type: ${r.contentType}\n\n${trimmed}`;
                     }
-                    // HTML — почистить
+                    // HTML — clean it up
                     const text = htmlToText(r.body);
-                    // Если текста почти нет — вероятно JS-страница, дать намёк
+                    // If there's almost no text — probably a JS page, give a hint
                     if (text.length < 200) {
                         return (`HTTP ${r.status}  ${r.url}\n` +
                             `Content-Type: ${r.contentType}\n\n` +
@@ -177,13 +177,13 @@ export function createWebTools() {
                     if (r.status !== 200) {
                         return `DuckDuckGo вернул HTTP ${r.status}`;
                     }
-                    // Парсим простыми регексами. Формат html.duckduckgo.com стабильный.
+                    // We parse with simple regexes. The html.duckduckgo.com format is stable.
                     const results = [];
                     const re = /<a[^>]*class="[^"]*result__a[^"]*"[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>[\s\S]*?(?:<a[^>]*class="[^"]*result__snippet[^"]*"[^>]*>([\s\S]*?)<\/a>)?/gi;
                     let m;
                     while ((m = re.exec(r.body)) && results.length < limit) {
                         let href = m[1];
-                        // DuckDuckGo заворачивает ссылки в редирект вида /l/?uddg=...
+                        // DuckDuckGo wraps links in a redirect like /l/?uddg=...
                         const uddgMatch = href.match(/[?&]uddg=([^&]+)/);
                         if (uddgMatch)
                             href = decodeURIComponent(uddgMatch[1]);

package/dist/xml-toolcall.js

@@ -13,13 +13,13 @@ function readAttr(attrs, name) {
     const m = attrs.match(re);
     return m ? m[2] : null;
 }
-// Достаёт параметры из тела <invoke>. Тег открытия и закрытия может нести
-// произвольный префикс (DSML и т.п.), а некоторые модели путают пары тегов
-// (<parameter …> … </|DSML| parameter>). Регулярка ниже матчит любую пару
-// <…parameter…> … </…parameter…>, поэтому такие «смешанные» теги тоже
-// разбираются. Значения дедуплицируются: если модель повторила parameter
-// несколько раз, берём ПЕРВОЕ значение, а не последнее (повторы обычно
-// дублируют корректный параметр).
+// Extracts parameters from an <invoke> body. The opening and closing tags may
+// carry an arbitrary prefix (DSML, etc.), and some models confuse tag pairs
+// (<parameter …> … </|DSML| parameter>). The regex below matches any pair
+// <…parameter…> … </…parameter…>, so such "mixed" tags are parsed too.
+// Values are deduplicated: if the model repeated a parameter several times,
+// we take the FIRST value, not the last (repeats usually duplicate a correct
+// parameter).
 function parseParameters(body) {
     const args = {};
     const paramRe = /<[^>]*?parameter([^>]*)>([\s\S]*?)<\/[^>]*?parameter[^>]*>/gi;
@@ -57,8 +57,8 @@ export function parseXmlToolCalls(text) {
         const closeMatch = closeRe.exec(rest);
         const body = closeMatch ? rest.slice(0, closeMatch.index) : rest;
         const args = parseParameters(body);
-        // Некоторые модели кладут весь JSON-объект аргументов в один
-        // parameter с именем args. Разворачиваем, чтобы не было
+        // Some models put the whole JSON arguments object into a single
+        // parameter named args. We unwrap it so there's no
         // {args: {args: {...}}}.
         let finalArgs = args;
         const keys = Object.keys(args);
@@ -73,10 +73,10 @@ export function parseXmlToolCalls(text) {
     }
     if (calls.length)
         return calls.length === 1 ? calls[0] : calls;
-    // Модель иногда опускает тег <invoke> и оставляет только DSML-обёртку
-    // (<|DSML| calls> … <|DSML| parameter name=…>…). Имя инструмента в таком
-    // ответе отсутствует, поэтому восстановить вызов нельзя — но и молча
-    // принимать его за финальный ответ нельзя: agent-loop попросит повторить
-    // (looksLikeToolCall срабатывает по слову parameter/DSML).
+    // The model sometimes omits the <invoke> tag and leaves only the DSML
+    // wrapper (<|DSML| calls> … <|DSML| parameter name=…>…). There's no tool
+    // name in such an answer, so the call can't be restored — but it also must
+    // not be silently taken as the final answer: agent-loop will ask to retry
+    // (looksLikeToolCall triggers on the word parameter/DSML).
     return null;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zames_pro",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Terminal coding agent over chat.deepseek.com via Playwright",
   "type": "module",
   "bin": {