zames_pro 2.82.137 → 2.82.138

package/dist/input.js

@@ -96,7 +96,7 @@ export class LineEditor {
     // is stored so it can be removed in dispose().
     _onResize;
     _resizeTimer;
-    // ESC disambiguation (N29): a read may end on a bare ESC that is really the
+    // ESC disambiguation: a read may end on a bare ESC that is really the
     // head of a control sequence split across two reads. We hold it briefly and
     // fire onEscape only if no tail arrives.
     _escPending;
@@ -644,7 +644,6 @@ export class LineEditor {
         this.pastes = [];
         this._render();
     }
-    // ---------- rendering ----------
     _eraseBlock() {
         if (!this.rendered)
             return;
@@ -936,7 +935,6 @@ export class LineEditor {
         process.stdout.write(String(text) + NL);
         this._writeBlock();
     }
-    // ---------- spinner-compatible interface ----------
     setStatus(text) {
         this.statusText = text || '';
         this._render();
@@ -1124,7 +1122,6 @@ export class LineEditor {
         const wrapped = wrapToWidth('⚠ ' + msg, maxW);
         this.printAbove(NL + theme.warn(wrapped));
     }
-    // ---------- input ----------
     _submit() {
         if (this.locked) {
             this._render();
@@ -1367,7 +1364,7 @@ export class LineEditor {
     }
     // Bare ESC: wait a moment for a possible control-sequence tail before firing
     // onEscape. Without this a sequence split across two reads (ESC, then "[A")
-    // looked like a lone Escape and aborted the current generation (N29).
+    // looked like a lone Escape and aborted the current generation.
     _scheduleEscape() {
         this._escPending = true;
         if (this._escTimer)
@@ -1460,7 +1457,6 @@ export class LineEditor {
         chars.splice(this.cursor, i - this.cursor);
         this.buf = chars.join('');
     }
-    // ---------- history ----------
     _historyUp() {
         if (!this.history.length)
             return;
@@ -1485,7 +1481,6 @@ export class LineEditor {
         }
         this.cursor = Array.from(this.buf).length;
     }
-    // ---------- reverse-search (Ctrl+R) ----------
     // Start an incremental reverse search, keeping the current buffer aside so
     // Esc restores it (bash behavior). An empty history leaves the editor
     // untouched.
@@ -1596,7 +1591,7 @@ export class LineEditor {
         // A previous read ended on a bare ESC. That is ambiguous: the Escape key
         // or the head of a control sequence split across reads (arrows, Ctrl+Del).
         // Reattach the ESC and parse the whole sequence, so a split arrow does not
-        // abort the generation (N29).
+        // abort the generation.
         if (this._escPending) {
             this._escPending = false;
             if (this._escTimer) {

package/dist/markdown.js

@@ -15,7 +15,6 @@ const theme = {
     tableHeader: { color: '#9fb8d8', bold: true },
     tableCell: { color: '#d0d0d0' },
 };
-// Code highlighting via cli-highlight (already present transitively).
 function highlighter(code, lang) {
     try {
         return highlight(code, {

package/dist/mcp.js

@@ -477,11 +477,8 @@ export async function createMcpPool(opts) {
         }
     }
     // Distinct servers can produce the SAME qualified name (server 'a' + tool
-    // 'b__c' vs server 'a__b' + tool 'c'), and agent-loop resolves a call with
-    // tools.find(name) — it takes the FIRST. A duplicate would make the second
-    // tool silently unreachable (the model calls "the right name", a DIFFERENT
-    // tool runs). Rename the later one with a numeric suffix so every name is
-    // unique.
+    // 'b__c' vs server 'a__b' + tool 'c'); dedupeToolNames below explains why
+    // that has to be fixed rather than left to tools.find().
     dedupeToolNames(tools);
     let closed = false;
     return {

package/dist/net-capture.js

@@ -259,7 +259,7 @@ export function isFinishedWithAnswer(body) {
         return false;
     // A truncated RESPONSE head (a lone `{`) is NOT a complete answer: the
     // finish loop would return it as the model's text and the tool-call parser
-    // would fail on it. Require real content (see MIN_FINISHED_ANSWER_CHARS).
+    // would fail on it. Require real content (see responseTextLength).
     return responseContentLength(b) >= MIN_REAL_ANSWER_CHARS;
 }
 // The CONTEXT size (in tokens) DeepSeek reports for the current answer.

package/dist/path-token.js

@@ -118,15 +118,11 @@ export function extractAtFileRefs(text) {
         }
         let j = i + 1;
         let tok = '';
-        // The token is rejected WHOLE when it contains an at-sign that is NOT a
-        // list separator — `@Component` / `user@host` are a decorator and an
-        // email. Trimming the prefix at that at-sign would otherwise inline a
-        // bogus path.
-        let hadInnerAt = false;
         // A token that contains an at-sign (`@Component`, `user@host`) is a
-        // decorator / an email, NOT a file reference. The scan used to stop at
-        // that at-sign and hand the PREFIX (`Component` … no) or, worse, the part
-        // BEFORE it to the inliner. Now the whole token is rejected instead.
+        // decorator or an email, NOT a file reference, and the WHOLE token is
+        // rejected: the scan used to stop at that at-sign and hand the part
+        // BEFORE it to the inliner, which inlined a bogus path.
+        let hadInnerAt = false;
         const isRef = (t) => t.length > 0 && !t.includes('@');
         while (j < n && !isRefEnd(chars[j])) {
             // A COMMA directly followed by another `@` starts the NEXT reference:
@@ -154,12 +150,9 @@ export function extractAtFileRefs(text) {
             seen.add(cleaned);
             out.push(cleaned);
         }
-        // The break above leaves `j` ON the comma; step past it so the next `@`
-        // is seen as the start of a reference. When the scan ended on a
-        // terminator instead, continue AFTER it.
-        // The scan stopped ON a separator that split the token (`,`, `;` or a
-        // second at-sign): resume AT it so the next part is scanned as its own
-        // reference. Continuing past it dropped the second file of a list.
+        // The scan may have stopped ON a separator that split the token (`,`, `;`
+        // or a second at-sign): resume AT it so the next part is scanned as its
+        // own reference. Continuing past it dropped the second file of a list.
         const sep = j < n ? chars[j] : '';
         if (j > i + 1 && (sep === ',' || sep === ';' || sep === '@'))
             i = j;

package/dist/prompt.js

@@ -31,7 +31,8 @@ export async function promptOnce(question) {
     const wasRaw = stdin.isRaw;
     stdin.setRawMode(true);
     stdin.resume();
-    // We enable/disable bracketed paste in pairs.
+    // Bracketed paste is enabled/disabled in pairs, so the terminal is left in
+    // normal mode however the prompt exits.
     stdout.write('\x1b[?2004h');
     stdout.write(question);
     let line = '';
@@ -40,11 +41,11 @@ export async function promptOnce(question) {
     const PASTE_START = '\x1b[200~';
     const PASTE_END = '\x1b[201~';
     const redraw = () => {
-        // Return to the start of the line, erase and print again.
+        // Redraw in place: CR + erase-to-end, then the prompt and the line again.
         stdout.write(String.fromCharCode(13));
         stdout.write('\x1b[K');
         stdout.write(question + line);
-        // Put the cursor in the right position.
+        // Step back to the cursor, measured in UTF-16 units.
         const back = line.length - cursor;
         if (back > 0)
             stdout.write('\x1b[' + back + 'D');

package/dist/qwen-browser.js

@@ -6,7 +6,7 @@
 // and the chat-id scheme. DeepSeekBrowser is already large; folding a second
 // site into it would make both harder to audit. The shared surface is the
 // ChatProvider interface (types.ts); the agent loop only needs BrowserLike and
-// never sees either concrete class.
+// never sees a concrete class.
 //
 // Verified against a live session (headless Chromium, guest + logged in):
 //   input  -> textarea.message-input-textarea
@@ -233,7 +233,6 @@ export class QwenBrowser {
     sendIntervalMs() {
         return this.minSendIntervalMs;
     }
-    // ---------- lifecycle ----------
     async launch() {
         if (await profileLooksLocked(QWEN_USER_DATA_DIR)) {
             if (this.debug)
@@ -487,7 +486,6 @@ export class QwenBrowser {
         }
         catch { }
     }
-    // ---------- login ----------
     // Are we signed in? Detected from the PAGE, the same way a human sees it: a
     // signed-out visitor has the header "Log in" / "Sign up" buttons, a signed-in
     // one shows the account menu instead. The `auths/refresh` API was the first
@@ -1005,7 +1003,6 @@ export class QwenBrowser {
         }
         return false;
     }
-    // ---------- chat management ----------
     async newChat() {
         const before = await this.getCurrentChatId();
         const btn = this.page.locator(NEW_CHAT_SELECTOR).first();
@@ -1272,7 +1269,6 @@ export class QwenBrowser {
     getLastTokenUsage() {
         return this._lastTokenUsage;
     }
-    // ---------- answer reading ----------
     async _readLastAnswerText() {
         if (this._netCapture && this._netCaptureAt >= this._lastSentAt) {
             return this._netCapture;
@@ -1346,7 +1342,6 @@ export class QwenBrowser {
         catch { }
         return false;
     }
-    // ---------- toggles (model thinking / search) ----------
     getToggleStatesSync() {
         return this._toggles;
     }
@@ -1523,7 +1518,6 @@ export class QwenBrowser {
         }
         catch { }
     }
-    // ---------- diagnostics ----------
     async dumpDom(filePath) {
         if (!this.page)
             throw new Error('qwen: browser not launched');
@@ -1566,7 +1560,6 @@ export class QwenBrowser {
     chatUrl(id) {
         return chatUrl(id);
     }
-    // ---------- ask ----------
     async _waitForSendSlot(agent) {
         if (!agent)
             return;

package/dist/qwen-chats.js

@@ -84,7 +84,6 @@ export function scrapeQwenChatMessages(opts) {
     }
     return out;
 }
-// ---------- API payload parsers (pure, unit-tested) ----------
 /**
  * Parse the chat list from `GET /api/v2/chats/?page=1&exclude_project=true`.
  * The shape has drifted between builds, so accept several:

package/dist/qwen-net-capture.js

@@ -223,13 +223,10 @@ export function isFinishedWithoutAnswer(body) {
     return extractFromSse(b) === '';
 }
 // True when the body carries Qwen's rate-limit / busy notice, so ask() can
-// back off instead of waiting out the deadline. Matched against the RAW body.
-// The classifier runs against the RAW body, so a phrase like `please try again
-// later` would also match a NORMAL answer (the model writing about retry
-// logic) and make ask() back off on a good turn. A real notice arrives in an
-// ERROR payload (`event: error` / `"type":"error"`) or as a code; answer text
-// lives in `choices[].delta.content`. We therefore only inspect the body when
-// it is NOT a plain answer stream, or when it carries no answer content.
+// back off instead of waiting out the deadline. The classifier runs against the
+// RAW body, where a phrase like `please try again later` also matches a NORMAL
+// answer (the model writing about retry logic) and made ask() back off on a
+// good turn. So it only counts an ERROR payload or a body with NO answer text.
 export function isRateLimitText(body) {
     const b = String(body || '');
     if (!b)

package/dist/qwen-ui.js

@@ -174,9 +174,6 @@ export const STATUS_RE = /^(thinking|searching|generating|thinking completed|о
 // Qwen's rate-limit / busy notices (best-effort; the toast may be short-lived).
 export const RATE_LIMIT_RE = /too many requests|rate limit|too frequent|please try again later|слишком часто/i;
 export const SERVER_BUSY_RE = /server is busy|service unavailable|try again later/i;
-// ---------- toggles ----------
-// The "Auto" thinking/search toggle and the mode selector. Read-only probing
-// support; the model's thinking mode is set via config when supported.
 // ---------- toggles (thinking mode / web search) ----------
 // Qwen exposes thinking as a MODE dropdown (`.qwen-thinking-selector`, label
 // "Auto" by default) with options Auto / Thinking / Fast — NOT a boolean

package/dist/run-task.js

@@ -330,7 +330,7 @@ export async function runTask(deps, browser, tools, taskText, workdir, opts, att
         });
     try {
         // Set when the loop ends without a real answer (iteration limit / watchdog)
-        // so the one-shot mode can exit non-zero. See N5.
+        // so the one-shot mode can exit non-zero.
         let failure = null;
         // The machine-readable reason for the last task's outcome.
         let outcomeKind = 'ok';
@@ -351,7 +351,7 @@ export async function runTask(deps, browser, tools, taskText, workdir, opts, att
         // Calling it here made the spinner run for the whole pre-send phase (chat
         // creation, throttle wait) with no generation in flight.
         while (true) {
-            // T7: per-task summary (duration + number of tool calls + tokens).
+            // Per-task summary: duration, number of tool calls and tokens spent.
             const taskStart = Date.now();
             // Token delta for THIS task: accumulated_token_usage is cumulative for
             // the whole chat, so the per-task spend is after - before. Null when the
@@ -461,8 +461,8 @@ export async function runTask(deps, browser, tools, taskText, workdir, opts, att
             else {
                 outcomeKind = 'ok';
             }
-            // T7: one summary line per task (duration + tool calls + tokens spent).
-            // Printed even on an abort, so the operator sees what happened.
+            // One summary line per task, printed even on an abort, so the operator
+            // sees what happened.
             const tokensAfter = getTokenUsage ? getTokenUsage() : null;
             const tokenDelta = typeof tokensBefore === 'number' && typeof tokensAfter === 'number'
                 ? Math.max(0, tokensAfter - tokensBefore)

package/dist/self-review.js

@@ -122,7 +122,6 @@ async function copyContextFiles(srcDir, snapDir) {
         }
     }
 }
-// ---------- /self-review ----------
 export async function selfReview({ browser, focus, transcript, locale, }) {
     const t = translator(locale);
     const stamp = new Date().toISOString().replace(/[:.]/g, '-');
@@ -190,7 +189,6 @@ export async function selfReview({ browser, focus, transcript, locale, }) {
     console.log();
     return { snapDir, reportPath, changed };
 }
-// ---------- /self-diff ----------
 export async function selfDiff({ name, locale, }) {
     const t = translator(locale);
     const snapDir = path.join(SNAP_ROOT, name);
@@ -218,7 +216,6 @@ export async function selfDiff({ name, locale, }) {
         console.log(theme.system(t('self.no_diff')));
     }
 }
-// ---------- /self-apply ----------
 export async function selfApply({ name, locale, }) {
     const t = translator(locale);
     const snapDir = path.join(SNAP_ROOT, name);
@@ -247,7 +244,6 @@ export async function selfApply({ name, locale, }) {
     console.log(theme.system(t('self.backup', { dir: backupDir })));
     console.log(theme.warn('\n' + t('self.restart_hint') + '\n'));
 }
-// ---------- /self-list ----------
 export async function selfList({ locale, } = {}) {
     const t = translator(locale);
     const snapRoot = path.join(SNAP_ROOT);
@@ -285,7 +281,6 @@ export async function selfList({ locale, } = {}) {
     console.log();
     console.log(theme.system(t('self.list_commands') + '\n'));
 }
-// ---------- helpers ----------
 async function diffFiles(origDir, newDir) {
     const files = await listTsFiles(newDir).catch(() => []);
     const changed = [];

package/dist/send-runtime.js

@@ -78,11 +78,9 @@ export class SendRuntime {
         if (typeof extra.retryAfterMs === 'number') {
             e.retryAfterMs = extra.retryAfterMs;
         }
-        // A SUCCESS after a rate limit IS the lift of that block. onBlockLifted()
-        // was the only producer of `blockMs`, but no provider's ask() calls it (a
-        // rate limit is retried IN PLACE and the retry simply succeeds), and the
-        // fold below clears `blockedAt` first. The measured duration is therefore
-        // taken HERE, before the state is folded; it is attached to the SAME event
+        // A SUCCESS after a rate limit IS the lift of that block: the retry happens
+        // IN PLACE and simply succeeds. The duration is therefore measured HERE,
+        // before the fold below clears `blockedAt`, and attached to the SAME event
         // line, so one block still yields exactly one sample.
         let blockMs;
         if (outcome === 'ok' &&
@@ -101,11 +99,9 @@ export class SendRuntime {
             this.state = { ...this.state, blocked: true, blockedAt: this.now() };
         }
         if (outcome === 'rate_limit') {
-            // The block START is only known AFTER the fold above (the adaptive path
-            // sets it there). The event itself carries NO duration: a rate-limit
-            // send is not the END of the block, so any value measured here is a
-            // lower bound that would then be averaged together with the real
-            // duration written by onBlockLifted — the same block counted TWICE.
+            // The event carries NO duration: a rate-limit send is not the END of the
+            // block, so a value measured here would be averaged together with the
+            // real duration measured at the lift — the same block counted TWICE.
             if (!this.state.blockedAt) {
                 this.state = { ...this.state, blocked: true, blockedAt: this.now() };
             }

package/dist/send-telemetry.js

@@ -51,14 +51,12 @@ export function summarizeSends(events, now = Date.now()) {
         const age = now - t;
         return age >= 0 && age <= ms;
     }).length;
-    // `blockMs` may arrive as a NUMBER (the writer) or a string (an older
-    // build, a hand-edited file): a numeric string is accepted so the average
-    // is not silently 0 for a file that records the block.
     const blocks = events
-        // `Number(null)`/`Number(undefined)` — 0/NaN, and 0 IS a finite
-        // non-negative number: an event that carries no block duration (the
-        // rate-limit event only records `blockedAt`) was averaged as a ZERO-length
-        // block, halving the reported average. Only a REAL value counts.
+        // `blockMs` may arrive as a NUMBER (the writer) or a string (an older
+        // build, a hand-edited file), so it is coerced. A missing value must NOT
+        // become 0: 0 is a finite non-negative number, and an event without a
+        // block duration (the rate-limit event only records `blockedAt`) was
+        // averaged as a ZERO-length block, halving the reported average.
         .map((e) => e.blockMs === null || e.blockMs === undefined ? NaN : Number(e.blockMs))
         // A finite value is not enough: the SUM of many large durations overflows
         // a JS number (two `Number.MAX_VALUE` entries add up to Infinity), so the

package/dist/send-throttle.js

@@ -39,11 +39,10 @@ function prune(recent, now, windowMs) {
  */
 export function nextWaitMs(state, lastSentAt, now) {
     if (state.forcedWaitMs > 0) {
-        // A forced wait must EXPIRE: a long Retry-After used to block every
-        // send forever (the check was `> 0` only), until another event cleared
-        // it. With the request stamp the remaining time is exact; without one
-        // (a caller-built or restored state) the wait is reported ONCE, from
-        // the current call, and expires on the next.
+        // A forced wait must EXPIRE: with only `forcedWaitMs > 0` a long
+        // Retry-After blocked every send until another event cleared it. The
+        // request stamp makes the remaining time exact; without one (a caller-built
+        // or restored state) the wait is reported ONCE, from the current call.
         if (state.forcedWaitAt) {
             const left = state.forcedWaitMs - (now - state.forcedWaitAt);
             return left > 0 ? left : 0;

package/dist/sessions.js

@@ -133,13 +133,12 @@ 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).
-// The last session for the working directory, restricted to `provider` when
-// given. A chat id only exists on ITS backend, so restoring a DeepSeek chat
-// while the active provider is Qwen (or vice versa) would fail to open — the
-// filter makes auto-restore and /last pick the right one (and fall back to the
-// global last only within the same provider).
+// The last session for the working directory (the last one overall when the
+// directory has none — useful when launched from a new place), restricted to
+// `provider` when given. A chat id only exists on ITS backend, so restoring a
+// DeepSeek chat while the active provider is Qwen (or vice versa) would fail to
+// open; the filter makes auto-restore and /last pick the right one, and fall
+// back to the global last only within the same provider.
 export function loadLastSession(workdir = '', provider) {
     try {
         const index = JSON.parse(fs.readFileSync(INDEX_FILE, 'utf-8'));

package/dist/spinner.js

@@ -152,10 +152,9 @@ export function createSpinner(locale = 'ru') {
             }
             startThinking();
         },
-        // The agent is waiting out the send-interval pause before a real send.
-        // Show it as an ANIMATED status line with the remaining seconds, so the
-        // spinner keeps moving during the pause (previously a static console line
-        // was printed and the dots stayed frozen).
+        // The agent is waiting out the send-interval pause before a real send: an
+        // ANIMATED status with the remaining seconds, so the spinner keeps moving
+        // (a static line made the pause look frozen).
         sendPause: (seconds) => {
             if (pending)
                 return;

package/dist/statusline.js

@@ -58,10 +58,6 @@ export function runStatusLineCommand(workdir, command, info, timeoutMs = 4000) {
             // (the row overflows and the cursor arithmetic drifts).
             resolve(clipBadge(first));
         };
-        // Only the FIRST LINE is shown, so there is no reason to keep collecting a
-        // big blob: a chatty command (a JSON dump, `ls -R`) would grow `out`
-        // unboundedly and the status row then repainted megabytes. Stop appending
-        // once a short line is buffered (the rest of that line does not matter).
         const timer = setTimeout(() => {
             try {
                 if (process.platform !== 'win32' && child.pid) {
@@ -74,15 +70,15 @@ export function runStatusLineCommand(workdir, command, info, timeoutMs = 4000) {
             catch { }
             finish();
         }, timeoutMs);
-        // A status line is a short badge: cap what is buffered so a chatty
-        // command cannot grow it (and the rendered row) without bound.
+        // Only the FIRST line is shown and the status line is a short badge, so the
+        // buffer is capped: a chatty command (a JSON dump, `ls -R`) would otherwise
+        // grow `out` and make the status row repaint megabytes on every tick.
         const MAX_OUT = 400;
         child.stdout?.on('data', (c) => {
             if (out.length >= MAX_OUT)
                 return;
-            // A chunk can be huge (one 64 KB read); clip it to the remaining space
-            // so the buffer never exceeds MAX_OUT. An unbounded `out` made the
-            // status row repaint megabytes on every tick.
+            // A chunk can be huge (one 64 KB read): clip it to the remaining space so
+            // the buffer never exceeds MAX_OUT.
             out += c.toString().slice(0, MAX_OUT - out.length);
         });
         child.on('error', () => {

package/dist/system-prompt.js

@@ -124,7 +124,7 @@ export function renderContextSection(context) {
                 f.content +
                 '\n';
     }
-    // B6: nested AGENTS.md/MEMORY.md from the directories this task touches.
+    // Nested AGENTS.md/MEMORY.md from the directories this task touches.
     // Deliberately a SEPARATE section: these apply only to part of the tree and
     // must not be mistaken for project-wide rules.
     for (const f of context.scopedAgents || []) {

package/dist/tui/widgets.js

@@ -1,6 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
-// ---- palette (kept in one place so every menu is consistent) ----
 export const UI = {
     accent: '#c8b06a',
     accentDim: '#7a6b45',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zames_pro",
-  "version": "2.82.137",
+  "version": "2.82.138",
   "description": "Terminal coding agent that drives a real browser to chat with DeepSeek, Qwen and other web LLMs — no API key required. Reads and edits files, runs commands, commits to git, like Claude Code / Codex CLI.",
   "type": "module",
   "bin": {