zames_pro 2.6.0 → 2.8.0

package/dist/net-capture.js

@@ -1,14 +1,14 @@
 import fs from 'fs/promises';
 import os from 'os';
 import path from 'path';
-// Извлечение СЫРОГО текста ответа модели из сетевых данных DeepSeek.
+// Extraction of the RAW model answer text from DeepSeek's network data.
 //
-// Зачем: чтение ответа идёт из ОТРЕНДЕРЕННОГО DOM, а рендер DeepSeek
-// искажает ответ — превращает доллар-формулы в LaTeX (символ доллара
-// теряется), нормализует переводы строк, делает автолинки. Из-за этого
-// tool-call с шаблонными строками и экранированными переводами строк в
-// аргументах доходил до инструментов искажённым. Здесь мы достаём исходный
-// текст из тела сетевого ответа.
+// Why: the answer is read from the RENDERED DOM, and DeepSeek's rendering
+// distorts the answer — it turns dollar formulas into LaTeX (the dollar sign
+// is lost), normalizes newlines, and auto-links. Because of this a tool-call
+// with template strings and escaped newlines in its arguments reached the
+// tools distorted. Here we extract the original text from the network
+// response body.
 //
 // Format DeepSeek (SSE, chat.deepseek.com/api/v0/chat/completion):
 //   * startovy fragment otveta lezhit v data-chanke s uzlom v.response
@@ -36,11 +36,11 @@ function parseDataLines(body) {
     }
     return out;
 }
-// Собирает текст ответа из SSE-потока. Поддерживает два формата:
-//   * OpenAI-совместимый: choices[].delta.content (reasoning_content
-//     игнорируется — это размышления, а не ответ);
-//   * DeepSeek chat.deepseek.com: стартовый v.response.fragments[] и
-//     инкрементальные APPEND-чанки response/fragments/-1/content.
+// Assembles the answer text from the SSE stream. Supports two formats:
+//   * OpenAI-compatible: choices[].delta.content (reasoning_content
+//     is ignored — that's reasoning, not the answer);
+//   * DeepSeek chat.deepseek.com: the initial v.response.fragments[] and
+//     incremental APPEND chunks response/fragments/-1/content.
 export function extractFromSse(body) {
     let out = '';
     for (const obj of parseDataLines(body)) {
@@ -65,8 +65,8 @@ export function extractFromSse(body) {
             }
             continue;
         }
-        // Инкрементальный APPEND: p='response/fragments/-1/content' -> v=строка;
-        // последующие чанки идут с одним полем v.
+        // Incremental APPEND: p='response/fragments/-1/content' -> v=string;
+        // subsequent chunks come with a single v field.
         if (o.p === 'response/fragments/-1/content' && typeof o.v === 'string') {
             out += o.v;
             continue;
@@ -87,9 +87,9 @@ export function extractFromJson(body) {
     }
     return pickAnswerText(obj);
 }
-// Достает финальный текст ответа из узла, НЕ смешивая его с reasoning.
-// Порядок: choices/messages -> delta/message -> content; reasoning_content
-// намеренно не берем — это размышления модели, а не ответ.
+// Extracts the final answer text from a node, WITHOUT mixing it with reasoning.
+// Order: choices/messages -> delta/message -> content; reasoning_content is
+// deliberately not taken — that's the model's reasoning, not the answer.
 function pickAnswerText(node) {
     if (node == null)
         return '';
@@ -124,15 +124,15 @@ function pickAnswerText(node) {
     }
     return '';
 }
-// Универсальная попытка: сначала SSE, затем обычный JSON.
+// A universal attempt: first SSE, then regular JSON.
 export function extractAnswer(body) {
     const sse = extractFromSse(body);
     if (sse)
         return sse;
     return extractFromJson(body);
 }
-// Сохраняет тело сетевого ответа DeepSeek на диск для разбора постфактум.
-// Файлы лежат в ~/.zames/net-log — po nim видно реальный формат ответа.
+// Saves the DeepSeek network response body to disk for post-mortem analysis.
+// The files live in ~/.zames/net-log — from them the real answer format is visible.
 export async function dumpNetBody(url, body) {
     try {
         const dir = path.join(os.homedir(), '.zames', 'net-log');

package/dist/self-review.js

@@ -4,10 +4,10 @@ import { theme } from './theme.js';
 import { fileURLToPath } from 'url';
 import { ZAMES_HOME } from './config.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-// Исходники для самообзора — это .ts файлы. После сборки (tsc → dist/)
-// __dirname указывает на dist, где лежат .js. Поэтому ищем каталог с
-// исходниками: либо рядом (запуск из src/ через tsx), либо в ../src
-// (запуск собранного dist/ из корня репозитория).
+// The sources for self-review are .ts files. After the build (tsc → dist/)
+// __dirname points to dist, where the .js files live. So we look for the
+// source directory: either nearby (running from src/ via tsx), or in ../src
+// (running the built dist/ from the repo root).
 function resolveSrcDir() {
     const candidates = [__dirname, path.join(__dirname, '..', 'src')];
     for (const dir of candidates) {
@@ -22,9 +22,9 @@ function resolveSrcDir() {
 }
 const SRC_DIR = resolveSrcDir();
 const SNAP_ROOT = path.join(ZAMES_HOME, 'snapshots');
-// Динамический импорт логики с timestamp — чтобы при /reload (или авто-reload)
-// self-review использовал СВЕЖИЕ tools/agent-loop, а не закэшированные при
-// первой загрузке. Иначе reload не доходил бы до зависимостей self-review.
+// Dynamic import of the logic with a timestamp — so that on /reload (or
+// auto-reload) self-review uses FRESH tools/agent-loop, not the ones cached on
+// first load. Otherwise reload wouldn't reach self-review's dependencies.
 async function loadFresh() {
     const stamp = Date.now();
     const toolsUrl = new URL('./tools.js', import.meta.url);
@@ -66,7 +66,7 @@ export async function selfReview({ browser, focus, transcript }) {
             `Проверь, что src/ не пуст и ты запускаешь агента из корня проекта.\n`));
         throw new Error('SRC_DIR пуст — нечего ревьюить');
     }
-    // Копируем package.json для контекста — чтобы агент видел зависимости
+    // Copy package.json for context — so the agent sees the dependencies
     try {
         const pkg = await fs.readFile(path.resolve(SRC_DIR, '..', 'package.json'), 'utf-8');
         await fs.writeFile(path.join(snapDir, 'package.json'), pkg, 'utf-8');
@@ -104,10 +104,10 @@ export async function selfReview({ browser, focus, transcript }) {
             console.log();
         },
     });
-    // Сохраняем отчёт
+    // Save the report
     const reportPath = path.join(snapDir, '_report.md');
     await fs.writeFile(reportPath, finalMessage || '(пусто)', 'utf-8');
-    // Считаем, что изменилось
+    // Compute what changed
     const changed = await diffFiles(SRC_DIR, snapDir);
     console.log(theme.system('─'.repeat(60)));
     console.log(theme.system(`Отчёт:       ${reportPath}`));
@@ -159,7 +159,7 @@ export async function selfApply({ name }) {
     const snapStat = await fs.stat(snapDir).catch(() => null);
     if (!snapStat)
         throw new Error(`Снапшот не найден: ${snapDir}`);
-    // Бэкап текущего src перед перезаписью
+    // Back up the current src before overwriting
     const stamp = new Date().toISOString().replace(/[:.]/g, '-');
     const backupDir = path.join(SNAP_ROOT, `backup-before-apply-${stamp}`);
     await copyDirJsFiles(SRC_DIR, backupDir);
@@ -264,16 +264,16 @@ ${focusLine}
 
 When done, respond with a markdown report as the message:
 
-## Найдено
+## Found
 - (bullet list of issues you found, with file:line if possible)
 
-## Исправлено
-- (bullet list: file — что именно изменил)
+## Fixed
+- (bullet list: file — what exactly you changed)
 
-## Не исправлено (осознанно)
+## Not fixed (deliberately)
 - (bullet list: what you left alone and why)
 
-## Проверка
+## Verification
 - (bullet list: what you verified, e.g. \`node --check\` results)
 
 Be honest and specific. If the code is fine in some area, say so.`;

package/dist/sessions.js

@@ -1,10 +1,10 @@
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
-// Сессии (чаты DeepSeek) храним в отдельной папке, чтобы они не терялись
-// после перезапуска процесса. Каждая сессия — отдельный JSON-файл
-// <id>.json в ~/.zames/.sessions. last.json указывает на последнюю
-// открытую сессию для конкретной рабочей директории.
+// We store sessions (DeepSeek chats) in a separate folder so they aren't lost
+// after a process restart. Each session is a separate JSON file
+// <id>.json in ~/.zames/.sessions. last.json points to the last
+// opened session for a specific working directory.
 const SESSIONS_DIR = path.join(os.homedir(), '.zames', '.sessions');
 const INDEX_FILE = path.join(SESSIONS_DIR, 'last.json');
 function ensureDir() {
@@ -13,8 +13,8 @@ function ensureDir() {
 function safeName(id) {
     return String(id).replace(/[^a-zA-Z0-9_.-]/g, '_');
 }
-// Сохраняем/обновляем сессию. workdir нужен, чтобы при запуске из того же
-// проекта восстанавливать именно его последний чат.
+// Save/update a session. workdir is needed so that when launched from the same
+// project we restore exactly its last chat.
 export function saveSession({ id, title = '', workdir = '', }) {
     if (!id)
         return null;
@@ -63,16 +63,16 @@ function writeIndex({ id, workdir }) {
     }
     catch { }
 }
-// Последняя сессия для рабочей директории. Если для неё ничего нет —
-// возвращаем последнюю сессию вообще (полезно при запуске из нового места).
+// The last session for the working directory. If there is none —
+// we return the last session overall (useful when launched from a new place).
 export function loadLastSession(workdir = '') {
     try {
         const index = JSON.parse(fs.readFileSync(INDEX_FILE, 'utf-8'));
         const byWorkdir = index && index.byWorkdir ? index.byWorkdir : {};
         const candidates = [byWorkdir[workdir], index.last].filter((x) => Boolean(x));
         for (const id of candidates) {
-            // Файл сессии мог быть удалён — индекс тогда устарел, и сессию
-            // восстанавливать нельзя. Пробуем следующий кандидат.
+            // The session file may have been deleted — the index is then stale and
+            // the session cannot be restored. We try the next candidate.
             const s = readSession(id);
             if (s)
                 return s;
@@ -94,7 +94,7 @@ export function readSession(id) {
         return null;
     }
 }
-// Список всех сессий, свежие — первыми.
+// List all sessions, newest first.
 export function listSessions() {
     try {
         ensureDir();

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

@@ -1,5 +1,5 @@
 import { translate } from './i18n.js';
-export function buildSystemPrompt({ workdir, tools, gitContext = null, locale = 'ru', }) {
+export function buildSystemPrompt({ workdir, tools, gitContext = null, locale = 'ru', attachments = [], }) {
     const t = translate(locale);
     const toolDescriptions = tools
         .map((t2) => `### ${t2.name}\n${t2.description}\nПараметры: ${JSON.stringify(t2.parameters)}`)
@@ -7,6 +7,10 @@ export function buildSystemPrompt({ workdir, tools, gitContext = null, locale =
     const gitSection = gitContext
         ? `\n## Git context\n\n${gitContext}\n`
         : '\n## Git context\n\nNot a git repository (or git is not installed).\n';
+    const attachSection = attachments.length
+        ? `\n## Attachments\n\nThe user attached files to this task: ${attachments.join(', ')}.\n` +
+            `Each [image#N] / [file#N] marker corresponds to a file the user pasted into the terminal; the file was uploaded to the chat and also saved under <project>/tmp. Look at the images in the chat; for files, read the copy in tmp if you need the contents.\n`
+        : '';
     return `You are a coding agent running in a terminal. You help the user with software engineering tasks by reading files, writing code, running commands, and iterating until the task is done.
 
 You work in the directory: ${workdir}
@@ -46,7 +50,7 @@ operator will not read it, so never use plain text.\n\nNO PROSE AROUND TOOL CALL
 You have access to the following tools:
 
 ${toolDescriptions}
-${gitSection}
+${gitSection}${attachSection}
 ## How to use tools
 
 To call ONE tool, respond with ONLY a JSON object (no markdown fences, no extra text):
@@ -65,6 +69,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]);