zames_pro 2.69.0 → 2.70.0

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.70.0] - 2026-10-08
+
+### Added
+
+- **browser:** centralize DeepSeek UI constants and add a UI health probe
+
 ## [2.69.0] - 2026-10-08
 
 ### Changed

package/dist/browser.js

@@ -1,11 +1,18 @@
 import { chromium, } from 'playwright';
 import { extractAnswer, extractTokenUsage, dumpNetBody, isFinishedWithoutAnswer, } from './net-capture.js';
 import { rewriteFailedAttachments } from './commands.js';
+import { CHAT_URL, CHAT_ID_RE, chatUrl, HISTORY_MESSAGES_URL, BUTTON_CLASS_RE, INPUT_SELECTORS, SEND_SELECTORS, STOP_SELECTORS, STOP_NAME_RE, CONTINUE_NAME_RE, ANSWER_SELECTORS, THINK_CLASS_RE, MESSAGE_CONTAINER_SELECTORS, RESTORE_ANSWER_SELECTORS, ASSISTANT_CLASS_RE, ASSISTANT_SELECTOR, ANSWER_MARKDOWN_SELECTOR, MARKDOWN_SELECTOR, CHAT_SIGNAL_NODES_SELECTOR, NEW_CHAT_SELECTOR, NEW_CHAT_TEXT_RE, PASSWORD_SELECTORS, LOGIN_SELECTORS, LOGIN_SUBMIT_SELECTORS, LOGIN_BUTTON_SELECTOR, LOGIN_NAME_RE, LOGIN_FORM_SUBMIT_RE, SIDEBAR_TOGGLE_SELECTORS, TOGGLE_SELECTORS, DEEP_THINKING_RE, WEB_SEARCH_RE, ATTACH_SELECTORS, STATUS_RE, RATE_LIMIT_RE, SERVER_BUSY_RE, GENERATION_ERR_RE, INCOMPLETE_STATUS_RE, ANSWER_URL_RE, } from './deepseek-ui.js';
+import { probeUiHealth, } from './ui-health.js';
 import path from 'path';
 import os from 'os';
 import fs from 'fs/promises';
 import { theme } from './theme.js';
 import { translate, DEFAULT_LOCALE } from './i18n.js';
+// Re-export the DeepSeek UI regexes other modules/tests import from browser.ts.
+// The definitions live in deepseek-ui.ts; re-exporting the imported bindings
+// here preserves the existing public API (test/*.test.ts import them from
+// browser.ts).
+export { STOP_NAME_RE, CONTINUE_NAME_RE };
 // Muted terminal input for passwords. We do NOT use readline here: readline
 // echoes the typed text through its own internal _writeToOutput, which cannot
 // be reliably overridden from outside (a real bug: the login prompt swallowed
@@ -86,14 +93,6 @@ export function askPassword(question) {
     });
 }
 const USER_DATA_DIR = path.join(os.homedir(), '.zames', 'profile');
-const CHAT_URL = 'https://chat.deepseek.com/';
-// The "New chat" control is NOT a <button>/<a> on the current DeepSeek build
-// (it is a <div>), so matching only button/a missed it, the click timed out
-// and newChat() silently no-opped. Match any clickable-ish element whose text
-// is EXACTLY the new-chat label (an anchored regex keeps a big outer container
-// from matching its long descendant text).
-const NEW_CHAT_SELECTOR = 'button, a, [role="button"], div, span';
-const NEW_CHAT_TEXT_RE = /^\s*(new chat|новый чат|новый диалог)\s*$/i;
 // Cache of the sanitized (non-Headless) User-Agent, keyed by the browser
 // engine path. On the FIRST headless run we detect the real UA, strip the
 // "Headless" marker and store it here; later runs pass it straight to
@@ -165,119 +164,6 @@ export function sanitizeHeadlessUA(ua) {
 // Written after a successful sign-in so the next launch knows a session was
 // stored in the persistent profile (used by /doctor and diagnostics).
 const AUTH_MARKER_FILE = path.join(os.homedir(), '.zames', 'auth.json');
-// DeepSeek sign-in form. The login page is served on the same origin and
-// swaps in a password field; the exact classes change, so we match loosely on
-// input types and the known placeholder/autocomplete attributes.
-const PASSWORD_SELECTORS = [
-    'input[type="password"]',
-    'input[autocomplete="current-password"]',
-    'input[autocomplete="new-password"]',
-];
-const LOGIN_SELECTORS = [
-    'input[type="email"]',
-    'input[type="tel"]',
-    'input[name="email"]',
-    'input[name="phone"]',
-    'input[name="username"]',
-    'input[placeholder*="email" i]',
-    'input[placeholder*="phone" i]',
-    'input[placeholder*="телефон" i]',
-    'input[placeholder*="почт" i]',
-    'input[autocomplete="username"]',
-    'input[autocomplete="email"]',
-];
-const LOGIN_SUBMIT_SELECTORS = [
-    // DeepSeek's real button: a div[role=button] with these classes and a
-    // <span class="ds-button__content">Log in</span> inside.
-    'div[role="button"].ds-button--primary.ds-button--filled',
-    'div[role="button"].ds-button--primary',
-    'button[type="submit"]',
-    'button:has-text("Log in")',
-    'button:has-text("Sign in")',
-    'button:has-text("Войти")',
-    'div[role="button"]:has-text("Log in")',
-    'div[role="button"]:has-text("Sign in")',
-    'div[role="button"]:has-text("Войти")',
-];
-const INPUT_SELECTORS = [
-    'textarea',
-    'div[contenteditable="true"]',
-    '[role="textbox"]',
-];
-const ANSWER_SELECTORS = [
-    'div.ds-assistant-message-main-content',
-    'div[class*="ds-assistant-message-main-content"]',
-    'div[class*="ds-markdown"]',
-    'div[class*="markdown"]',
-];
-const SEND_SELECTORS = [
-    'div[role="button"].ds-button--primary.ds-button--circle',
-    'div[role="button"].ds-button--primary.ds-button--filled',
-    'button[type="submit"]',
-    'button[aria-label*="send" i]',
-    'button[aria-label*="отправ" i]',
-];
-// IMPORTANT: you MUST NOT add the generic 'div[role="button"][class*="ds-button--primary"]'
-// here — it matches the send button, which is always visible, and then
-// _isGenerating() always returns true, so the answer is never considered ready.
-const STOP_SELECTORS = [
-    'div[role="button"][aria-label*="stop" i]',
-    'div[role="button"][aria-label*="останов" i]',
-    'button:has-text("Stop")',
-    'button:has-text("Остановить")',
-    'button[aria-label*="Stop" i]',
-];
-// Accessible name of the Stop button, for a TRUSTED Playwright click. It is a
-// bare stop word (optionally with a short suffix), anchored and length-limited
-// so a "Stop" inside rendered prose is never clicked.
-export const STOP_NAME_RE = /^(?:stop|остановить)(?:\s+\S{0,20})?\s*[.!…]?$/i;
-// DeepSeek's "Continue" button. With the reasoning ("Deep thinking") toggle
-// on, the server caps the THINK phase: the reasoning stops mid-way and the UI
-// offers a Continue button (this is NOT the same as a truncated turn with
-// generation_err — there the answer failed; here the model simply paused).
-// The agent must click it so the reasoning/answer keeps flowing, otherwise the
-// turn sits idle until the operator presses Continue by hand.
-//
-// The button is found by Playwright's accessible name (getByRole) with an
-// EXACT match, falling back to a raw DOM scan. The class names change between
-// builds, so we do not rely on them.
-// Reasoning (Deep thinking) mode uses a LONGER label: the server pauses the
-// THINK phase and offers «Продолжить размышление» / «Continue thinking», NOT a
-// bare «Continue». The old exact list missed those, so with thinking ON the
-// button was never found — neither for the auto-click NOR for the "is the turn
-// paused?" guard — and the operator had to press it by hand.
-//
-// We match the accessible name with a REGEX: a bare continue word OR the same
-// word followed by a short reasoning/answer suffix. It is anchored and
-// length-limited, so a "Continue" inside rendered prose is never clicked (the
-// old non-exact `getByRole` matched any button CONTAINING the word).
-export const CONTINUE_NAME_RE = /^(?:continue|продолжить|продолжение)(?:\s+(?:think(?:ing)?|reason(?:ing)?|размышлени[ея]|генераци[юя]|ответ))?\s*[.!…]?$/i;
-// DeepSeek UI service statuses that are NOT the model's answer.
-// Otherwise the agent takes a status (Reading...) for an answer and breaks parsing.
-const STATUS_RE = /^(reading|thinking|searching|analyzing|generating|stop|остановить|читаю|думаю|поиск|анализ)[\s.…]*$/i;
-// DeepSeek's answer when the rate limit is exceeded.
-//
-// IMPORTANT: the generic "try again later" / "повторите позже" tail is NOT
-// part of this pattern. DeepSeek appends it to MANY toasts ("Server busy.
-// Try again later.", "Service unavailable. Try again later."), so matching it
-// here classified every server hiccup as a RATE LIMIT and sent the agent into
-// a 5-minute wait (and, after the finish-loop stopped reading toasts every
-// tick, looked like "the agent hung"). The rate limit is recognized by its
-// specific wording only.
-const RATE_LIMIT_RE = /(messages? too frequent|too many requests|rate limit|слишком часто|сообщени[яе] слишком част)/i;
-// Transient server-side hiccups (DeepSeek overloaded / hiccup). Unlike the
-// rate limit, these usually clear in seconds, so we retry quickly instead of
-// waiting minutes. "Server busy", 503, "temporarily unavailable", etc.
-const SERVER_BUSY_RE = /(server (is )?busy|server error|service (is )?unavailable|temporarily unavailable|internal server error|502|503|504|server overloaded|сервер занят|сервер перегружен|сервис недоступен|внутренняя ошибка|попробуйте позже)/i;
-// DeepSeek turns a generation that FAILED mid-way into a truncated turn
-// (`quasi_status: INCOMPLETE` + `finish_reason: generation_err`) and shows a
-// "Continue" button in the UI. The failure is invisible to the answer text:
-// the DOM keeps the partial answer (often the previous one), so the finish
-// loop used to wait out the whole timeout and throw ds.send_no_new_answer.
-// The SSE body IS available (net-capture keeps it as `_netCapture`), so we
-// recognize the failed/truncated turn from it and retry instead of hanging.
-const GENERATION_ERR_RE = /"finish_reason":\s*"generation_err"/i;
-const INCOMPLETE_STATUS_RE = /"quasi_status","v":"INCOMPLETE"/i;
 export function isGenerationIncompleteText(text) {
     const t = String(text || '');
     return GENERATION_ERR_RE.test(t) || INCOMPLETE_STATUS_RE.test(t);
@@ -763,7 +649,7 @@ export class DeepSeekBrowser {
             // capture assignment to those URLs: a future endpoint returning a
             // `content`/`text`/`response` string must not clobber the answer and
             // look fresh (it would be returned as the final answer).
-            const isAnswerUrl = /chat\/(completion|continue)/i.test(url);
+            const isAnswerUrl = ANSWER_URL_RE.test(url);
             const extracted = extractAnswer(body);
             if (extracted && isAnswerUrl) {
                 this._netCapture = extracted;
@@ -1065,8 +951,8 @@ export class DeepSeekBrowser {
         // Click exactly the one whose visible label is a login word, so we never
         // hit "Log in with Google" or another primary button by mistake.
         const precise = this.page
-            .locator('div[role="button"].ds-button--primary, button')
-            .filter({ hasText: /^\s*(log ?in|sign ?in|войти)\s*$/i });
+            .locator(LOGIN_BUTTON_SELECTOR)
+            .filter({ hasText: LOGIN_NAME_RE });
         const pc = await precise.count().catch(() => 0);
         if (pc > 0) {
             try {
@@ -1091,8 +977,9 @@ export class DeepSeekBrowser {
         }
         // Button inside the same form as the password field.
         const formClicked = await this.page
-            .evaluate((pwdSel) => {
-            const p = document.querySelector(pwdSel);
+            .evaluate((opts) => {
+            const loginRe = new RegExp(opts.submitRe, 'i');
+            const p = document.querySelector(opts.pwdSel);
             if (!p)
                 return false;
             const form = p.closest('form');
@@ -1101,7 +988,7 @@ export class DeepSeekBrowser {
             for (const b of btns) {
                 const txt = (b.textContent || '').trim().toLowerCase();
                 const aria = (b.getAttribute('aria-label') || '').toLowerCase();
-                if (/log ?in|sign ?in|войти|continue|продолж/.test(txt + ' ' + aria)) {
+                if (loginRe.test(txt + ' ' + aria)) {
                     b.click();
                     return true;
                 }
@@ -1116,7 +1003,10 @@ export class DeepSeekBrowser {
                 return true;
             }
             return false;
-        }, PASSWORD_SELECTORS[0])
+        }, {
+            pwdSel: PASSWORD_SELECTORS[0],
+            submitRe: LOGIN_FORM_SUBMIT_RE.source,
+        })
             .catch(() => false);
         if (formClicked && (await tryLogin()))
             return true;
@@ -1267,16 +1157,18 @@ export class DeepSeekBrowser {
     // call". The DOM reader has no such self-comparison problem: before the
     // send the DOM shows the OLD answer, after it the NEW one.
     async _readLastAnswerTextDom() {
-        return await this.page.evaluate((sels) => {
-            // DeepSeek stores the model's reasoning in .ds-think-content blocks.
+        return await this.page.evaluate((opts) => {
+            const sels = opts.sels;
+            // DeepSeek stores the model's reasoning in think blocks (THINK_CLASS_RE).
             // They are NOT the answer and must never be picked up as the answer
             // (otherwise the terminal would show the long reasoning). We also
             // prefer the first (most specific) selector with a hit.
+            const think = new RegExp(opts.thinkRe, 'i');
             const inThink = (e) => {
                 let n = e;
                 while (n) {
                     const cls = (n.className || '').toString();
-                    if (/ds-think-content|thinking-content/i.test(cls))
+                    if (think.test(cls))
                         return true;
                     n = n.parentElement;
                 }
@@ -1302,7 +1194,7 @@ export class DeepSeekBrowser {
             const out = el.innerText || el.textContent || '';
             const NL = String.fromCharCode(10);
             return out.replace(new RegExp(NL + '{3,}', 'g'), NL + NL).trim();
-        }, ANSWER_SELECTORS);
+        }, { sels: ANSWER_SELECTORS, thinkRe: THINK_CLASS_RE.source });
     }
     // We read ONLY visible toasts/notifications, not the whole page text.
     // Otherwise we catch "try again later" from service/hidden blocks and go
@@ -1358,11 +1250,12 @@ export class DeepSeekBrowser {
         if (explicit)
             return true;
         return await this.page
-            .evaluate(() => {
+            .evaluate((btnRe) => {
+            const re = new RegExp(btnRe, 'i');
             const btns = Array.from(document.querySelectorAll('div[role="button"], button'));
             for (const b of btns) {
                 const cls = (b.className || '').toString();
-                if (!/ds-button--(circle|primary|filled)/i.test(cls))
+                if (!re.test(cls))
                     continue;
                 const label = ((b.getAttribute('aria-label') || '') +
                     ' ' +
@@ -1377,7 +1270,7 @@ export class DeepSeekBrowser {
                     return true;
             }
             return false;
-        })
+        }, BUTTON_CLASS_RE.source)
             .catch(() => false);
     }
     async _isGenerating() {
@@ -1391,16 +1284,16 @@ export class DeepSeekBrowser {
     // all we need to tell "the page grew / a new answer is streaming".
     async _chatSignal() {
         return await this.page
-            .evaluate(() => {
-            const nodes = document.querySelectorAll('[class*="ds-message"], [class*="chat-message"], .ds-markdown').length;
+            .evaluate((opts) => {
+            const nodes = document.querySelectorAll(opts.nodesSel).length;
             let lastLen = 0;
-            const answers = document.querySelectorAll('.ds-markdown');
+            const answers = document.querySelectorAll(opts.mdSel);
             if (answers.length) {
                 const lastEl = answers[answers.length - 1];
                 lastLen = (lastEl.innerText || '').length;
             }
             return { nodes, lastLen };
-        })
+        }, { nodesSel: CHAT_SIGNAL_NODES_SELECTOR, mdSel: MARKDOWN_SELECTOR })
             .catch(() => ({ nodes: 0, lastLen: 0 }));
     }
     // Cheap first probe for the Continue button. Runs ONE page.evaluate
@@ -1411,8 +1304,8 @@ export class DeepSeekBrowser {
     // HITS do we run the full scan to get a clickable Locator.
     async _continueVisibleCheap() {
         return await this.page
-            .evaluate(() => {
-            const re = /^(?:continue|продолжить|продолжение)(?:\s+(?:think(?:ing)?|reason(?:ing)?|размышлени[ея]|генераци[юя]|ответ))?\s*[.!…]?$/i;
+            .evaluate((nameRe) => {
+            const re = new RegExp(nameRe, 'i');
             const cands = Array.from(document.querySelectorAll('div[role="button"], button'));
             for (const e of cands) {
                 const label = ((e.textContent || '') +
@@ -1430,7 +1323,7 @@ export class DeepSeekBrowser {
                     return true;
             }
             return false;
-        })
+        }, CONTINUE_NAME_RE.source)
             .catch(() => false);
     }
     // Is DeepSeek's "Continue" button currently visible? Used to BLOCK the
@@ -1608,28 +1501,43 @@ export class DeepSeekBrowser {
     // so we match by a loose regex on the visible text and read the state from
     // aria-pressed. We click ONLY when the state differs, so a send does not
     // flip a toggle the operator set by hand.
+    // Find the toggle button whose label matches `labelRe`. Tries the class
+    // anchor first, then the semantic fallbacks (see TOGGLE_SELECTORS) so a
+    // renamed `ds-toggle-button` class does not silently disable the toggles.
+    async _findToggle(labelRe) {
+        for (const sel of TOGGLE_SELECTORS) {
+            try {
+                const btns = this.page.locator(sel);
+                const count = await btns.count().catch(() => 0);
+                for (let i = 0; i < count; i++) {
+                    const b = btns.nth(i);
+                    const txt = ((await b.textContent().catch(() => '')) || '').trim();
+                    if (!labelRe.test(txt))
+                        continue;
+                    const pressed = (await b.getAttribute('aria-pressed').catch(() => null)) === 'true';
+                    return { loc: b, pressed };
+                }
+            }
+            catch { }
+        }
+        return null;
+    }
     async _setToggle(labelRe, want) {
         try {
-            const btns = this.page.locator('.ds-toggle-button');
-            const count = await btns.count().catch(() => 0);
-            for (let i = 0; i < count; i++) {
-                const b = btns.nth(i);
-                const txt = ((await b.textContent().catch(() => '')) || '').trim();
-                if (!labelRe.test(txt))
-                    continue;
-                const pressed = (await b.getAttribute('aria-pressed').catch(() => null)) === 'true';
-                if (pressed !== want) {
-                    await b.click({ timeout: 2000 }).catch(() => { });
-                    await this.page.waitForTimeout(150);
-                }
+            const found = await this._findToggle(labelRe);
+            if (!found)
                 return;
+            if (found.pressed !== want) {
+                await found.loc.click({ timeout: 2000 }).catch(() => { });
+                await this.page.waitForTimeout(150);
             }
+            return;
         }
         catch { }
     }
     async _applyToggles() {
-        await this._setToggle(/глубок|deep\s*think/i, this.deepThinking);
-        await this._setToggle(/поиск|search/i, this.webSearch);
+        await this._setToggle(DEEP_THINKING_RE, this.deepThinking);
+        await this._setToggle(WEB_SEARCH_RE, this.webSearch);
         this._toggles = await this.getToggleStates();
     }
     // Synchronous snapshot of the last known toggle states, for the editor's
@@ -1652,22 +1560,16 @@ export class DeepSeekBrowser {
     async getToggleStates() {
         const read = async (labelRe, fallback) => {
             try {
-                const btns = this.page.locator('.ds-toggle-button');
-                const count = await btns.count().catch(() => 0);
-                for (let i = 0; i < count; i++) {
-                    const b = btns.nth(i);
-                    const txt = ((await b.textContent().catch(() => '')) || '').trim();
-                    if (!labelRe.test(txt))
-                        continue;
-                    return ((await b.getAttribute('aria-pressed').catch(() => null)) === 'true');
-                }
+                const found = await this._findToggle(labelRe);
+                if (found)
+                    return found.pressed;
             }
             catch { }
             return fallback;
         };
         return {
-            deepThinking: await read(/глубок|deep\s*think/i, this.deepThinking),
-            webSearch: await read(/поиск|search/i, this.webSearch),
+            deepThinking: await read(DEEP_THINKING_RE, this.deepThinking),
+            webSearch: await read(WEB_SEARCH_RE, this.webSearch),
         };
     }
     // Stop the current generation. Used by Esc/Ctrl+C. Prefers a TRUSTED
@@ -1704,11 +1606,12 @@ export class DeepSeekBrowser {
         // 3) Raw DOM scan + the full pointer/mouse sequence (older builds without
         //    a proper role, or a click intercepted by an overlay).
         const clicked = await this.page
-            .evaluate(() => {
+            .evaluate((btnRe) => {
+            const re = new RegExp(btnRe, 'i');
             const btns = Array.from(document.querySelectorAll('div[role="button"], button'));
             for (const b of btns) {
                 const cls = (b.className || '').toString();
-                if (!/ds-button--(circle|primary|filled)/i.test(cls))
+                if (!re.test(cls))
                     continue;
                 const svg = b.querySelector('svg');
                 if (svg && svg.querySelector('rect')) {
@@ -1726,7 +1629,7 @@ export class DeepSeekBrowser {
                 }
             }
             return false;
-        })
+        }, BUTTON_CLASS_RE.source)
             .catch(() => false);
         if (clicked)
             return true;
@@ -1984,15 +1887,7 @@ export class DeepSeekBrowser {
             return failed;
         // Preferred path: click the attach button and let the file chooser event
         // carry the files. This is how a real user attaches a file and it reliably
-        // triggers DeepSeek's upload handler.
-        const ATTACH_SELECTORS = [
-            'div[role="button"][aria-label*="attach" i]',
-            'div[role="button"][aria-label*="влож" i]',
-            'button[aria-label*="attach" i]',
-            'button[aria-label*="влож" i]',
-            '[class*="upload"]',
-            '[class*="attach"]',
-        ];
+        // triggers DeepSeek's upload handler. See ATTACH_SELECTORS in deepseek-ui.ts.
         for (const sel of ATTACH_SELECTORS) {
             const btn = this.page.locator(sel).last();
             try {
@@ -2678,15 +2573,23 @@ export class DeepSeekBrowser {
         });
         return { file: filePath, selectors: report };
     }
+    // A cheap "can the agent still drive this page?" probe for /doctor and
+    // startup. See ui-health.ts: it probes the ALWAYS-present controls (input,
+    // send, toggles, new-chat) and reports the missing ones, so a DeepSeek
+    // redesign surfaces as a clear message BEFORE a task hangs on it. Never
+    // throws — a dead page reports every capability missing.
+    async probeUiHealth() {
+        if (!this.page) {
+            return { ok: false, present: [], missing: [], missingCritical: [] };
+        }
+        const page = {
+            count: (sel) => this.page.locator(sel).count(),
+            countByText: (sel, textRe) => this.page.locator(sel).filter({ hasText: textRe }).count(),
+        };
+        return await probeUiHealth(page);
+    }
     async _ensureSidebarOpen() {
-        const toggles = [
-            'button[aria-label*="sidebar" i]',
-            'button[aria-label*="история" i]',
-            'button[aria-label*="history" i]',
-            'button[class*="sidebar-toggle"]',
-            'button[class*="sidebarToggle"]',
-        ];
-        for (const sel of toggles) {
+        for (const sel of SIDEBAR_TOGGLE_SELECTORS) {
             try {
                 const btn = this.page.locator(sel).first();
                 if ((await btn.count()) === 0)
@@ -2750,7 +2653,7 @@ export class DeepSeekBrowser {
             catch { }
         }
         try {
-            await this.page.goto(`https://chat.deepseek.com/a/chat/s/${id}`, {
+            await this.page.goto(chatUrl(id), {
                 waitUntil: 'domcontentloaded',
                 timeout: 20_000,
             });
@@ -2796,7 +2699,8 @@ export class DeepSeekBrowser {
         const res = await this.page
             .evaluate(async (opts) => {
             try {
-                const url = 'https://chat.deepseek.com/api/v0/chat/history_messages?chat_session_id=' +
+                const url = opts.historyUrl +
+                    '?chat_session_id=' +
                     encodeURIComponent(opts.chatId);
                 const headers = {
                     accept: 'application/json',
@@ -2845,7 +2749,7 @@ export class DeepSeekBrowser {
             catch (e) {
                 return { error: 'fetch failed: ' + e.message, list: [] };
             }
-        }, { chatId: id, auth, pow })
+        }, { chatId: id, auth, pow, historyUrl: HISTORY_MESSAGES_URL })
             .catch((e) => ({
             error: 'evaluate failed: ' + e.message,
             list: [],
@@ -2863,8 +2767,7 @@ export class DeepSeekBrowser {
         // when the in-page fetch was blocked (CSP, CORS, a page error).
         this._lastHistoryError = res.error;
         try {
-            const resp = await this.page.request.get('https://chat.deepseek.com/api/v0/chat/history_messages?chat_session_id=' +
-                encodeURIComponent(id), { headers: { accept: 'application/json' } });
+            const resp = await this.page.request.get(HISTORY_MESSAGES_URL + '?chat_session_id=' + encodeURIComponent(id), { headers: { accept: 'application/json' } });
             if (!resp.ok())
                 return list;
             const json = (await resp.json());
@@ -2911,12 +2814,14 @@ export class DeepSeekBrowser {
         if (!this.page)
             return [];
         const raw = await this.page
-            .evaluate(() => {
+            .evaluate((opts) => {
+            const think = new RegExp(opts.thinkRe, 'i');
+            const assistantRe = new RegExp(opts.assistantRe, 'i');
             const inThink = (e) => {
                 let n = e;
                 while (n) {
                     const cls = (n.className || '').toString();
-                    if (/ds-think-content|thinking-content/i.test(cls))
+                    if (think.test(cls))
                         return true;
                     n = n.parentElement;
                 }
@@ -2934,25 +2839,19 @@ export class DeepSeekBrowser {
             // detection is content-based, not class-prefix-based.
             const looksAssistant = (e) => {
                 const cls = (e.className || '').toString();
-                if (/ds-assistant-message|assistant-message/i.test(cls))
+                if (assistantRe.test(cls))
                     return true;
-                if (e.querySelector('[class*="ds-assistant-message"]'))
+                if (e.querySelector(opts.assistantSel))
                     return true;
                 // A user bubble has no rendered markdown; an answer does.
-                if (e.querySelector('[class*="ds-markdown"]'))
+                if (e.querySelector(opts.markdownSel))
                     return true;
                 return false;
             };
             // Message-level containers first (broad), then the answer wrappers.
-            const containerSels = [
-                '[data-message-id]',
-                '[class*="ds-message"]',
-                '[class*="chat-message"]',
-                '[class*="message-item"]',
-                '[class*="_message"]',
-            ];
+            // See MESSAGE_CONTAINER_SELECTORS in deepseek-ui.ts.
             let blocks = [];
-            for (const s of containerSels) {
+            for (const s of opts.containerSels) {
                 const found = Array.from(document.querySelectorAll(s)).filter((e) => !inThink(e) && textOf(e).length > 0);
                 if (found.length) {
                     blocks = found;
@@ -2983,12 +2882,8 @@ export class DeepSeekBrowser {
             }
             // Last resort: assistant answers only (no user turns) — better than
             // nothing when no message container matched.
-            const sels = [
-                'div.ds-assistant-message-main-content',
-                'div[class*="ds-assistant-message-main-content"]',
-                'div[class*="ds-markdown"]',
-            ];
-            for (const s of sels) {
+            // See RESTORE_ANSWER_SELECTORS in deepseek-ui.ts.
+            for (const s of opts.answerSels) {
                 const list = Array.from(document.querySelectorAll(s)).filter((e) => !inThink(e));
                 if (!list.length)
                     continue;
@@ -3000,6 +2895,13 @@ export class DeepSeekBrowser {
                 break;
             }
             return out;
+        }, {
+            containerSels: MESSAGE_CONTAINER_SELECTORS,
+            answerSels: RESTORE_ANSWER_SELECTORS,
+            thinkRe: THINK_CLASS_RE.source,
+            assistantRe: ASSISTANT_CLASS_RE.source,
+            assistantSel: ASSISTANT_SELECTOR,
+            markdownSel: ANSWER_MARKDOWN_SELECTOR,
         })
             .catch(() => []);
         return raw;
@@ -3007,7 +2909,7 @@ export class DeepSeekBrowser {
     async getCurrentChatId() {
         try {
             const url = this.page.url();
-            const m = url.match(/\/chat\/s\/([a-zA-Z0-9_-]+)/);
+            const m = url.match(CHAT_ID_RE);
             if (m)
                 return m[1];
             return this._netChatId;

package/dist/commands.js

@@ -309,6 +309,20 @@ export function renderDoctor(d, t = translate('en')) {
     if (d.headless) {
         row(!!d.headlessUaCached, 'headless', d.headlessUaCached ? t('doctor.ua_cached') : t('doctor.ua_not_cached'));
     }
+    // The DeepSeek UI probe (see ui-health.ts). Rendered only when the caller
+    // ran it (the browser must be up); a missing capability is a WARN row, and a
+    // missing CRITICAL one is called out in words so the operator knows the next
+    // task will fail before it starts.
+    if (d.uiPresent || d.uiMissing) {
+        const missing = d.uiMissing || [];
+        const missingCritical = d.uiMissingCritical || [];
+        const summary = missing.length === 0
+            ? t('doctor.ui_ok')
+            : missingCritical.length > 0
+                ? t('doctor.ui_broken', { v: missingCritical.join(', ') })
+                : t('doctor.ui_degraded', { v: missing.join(', ') });
+        row(missing.length === 0, 'deepseek ui', summary);
+    }
     return t('doctor.title') + NL + rows.join(NL);
 }
 // ---------- /add-dir ----------

package/dist/deepseek-ui.js

@@ -0,0 +1,225 @@
+// DeepSeek UI constants — the SINGLE place where chat.deepseek.com specifics live.
+//
+// WHY this module exists: the agent drives the DeepSeek web UI through
+// Playwright, so every selector, button label and protocol marker is a
+// hardcoded assumption about a page we do not control. Keeping them scattered
+// across browser.ts made a DeepSeek redesign a diffuse, easy-to-miss breakage
+// (a renamed class here, a relabeled button there). Concentrating them here
+// turns "DeepSeek changed the UI" into ONE file to audit, and lets the health
+// check (probeUiHealth) report the exact broken capability to the operator
+// BEFORE a task hangs on it.
+//
+// Priority order everywhere: prefer SEMANTIC anchors (role / aria-label /
+// accessible name / input type) over DeepSeek's `ds-*` class names, which
+// drift between builds. The `ds-*` selectors stay in the chains as a
+// high-precision FIRST hit, with semantic fallbacks after them.
+// ---------- endpoints ----------
+export const CHAT_URL = 'https://chat.deepseek.com/';
+export const CHAT_ID_RE = /\/chat\/s\/([a-zA-Z0-9_-]+)/;
+// DeepSeek's chat URL shape. A direct navigation always yields the requested
+// chat (the sidebar link click is tried first, this is the fallback).
+export const CHAT_PATH_PREFIX = 'a/chat/s/';
+export function chatUrl(id) {
+    return CHAT_URL + CHAT_PATH_PREFIX + id;
+}
+// The history endpoint returns EVERY message of a chat as JSON (the rendered
+// page virtualizes long chats). Requested from INSIDE the page so the auth
+// cookie and PoW handling are the browser's; see browser.fetchChatMessages.
+export const HISTORY_MESSAGES_URL = 'https://chat.deepseek.com/api/v0/chat/history_messages';
+// ---------- input ----------
+export const INPUT_SELECTORS = [
+    'textarea',
+    'div[contenteditable="true"]',
+    '[role="textbox"]',
+];
+// ---------- send ----------
+// IMPORTANT: you MUST NOT add the generic
+// 'div[role="button"][class*="ds-button--primary"]' here — it matches the
+// STOP button too, and then _isGenerating() always returns true, so an answer
+// is never considered ready.
+export const SEND_SELECTORS = [
+    'div[role="button"].ds-button--primary.ds-button--circle',
+    'div[role="button"].ds-button--primary.ds-button--filled',
+    'button[type="submit"]',
+    'button[aria-label*="send" i]',
+    'button[aria-label*="отправ" i]',
+];
+// DeepSeek's own button classes. Used as a coarse "is this a DeepSeek button?"
+// filter in the raw-DOM fallbacks for Stop and for the send/stop icon
+// detection. Kept as a source string because the fallback runs INSIDE
+// page.evaluate, which cannot receive a RegExp object.
+export const BUTTON_CLASS_RE = /ds-button--(circle|primary|filled)/i;
+// ---------- stop ----------
+export const STOP_SELECTORS = [
+    'div[role="button"][aria-label*="stop" i]',
+    'div[role="button"][aria-label*="останов" i]',
+    'button:has-text("Stop")',
+    'button:has-text("Остановить")',
+    'button[aria-label*="Stop" i]',
+];
+// Accessible name of the Stop button, for a TRUSTED Playwright click. A bare
+// stop word (optionally with a short suffix), anchored and length-limited so a
+// "Stop" inside rendered prose is never clicked.
+export const STOP_NAME_RE = /^(?:stop|остановить)(?:\s+\S{0,20})?\s*[.!…]?$/i;
+// ---------- continue ----------
+// DeepSeek's "Continue" button. With the reasoning ("Deep thinking") toggle on
+// the server caps the THINK phase: the reasoning stops mid-way and the UI
+// offers a Continue button (NOT the same as a truncated turn with
+// generation_err — there the answer FAILED; here the model paused). The agent
+// must click it so the reasoning/answer keeps flowing.
+//
+// Reasoning mode uses a LONGER label («Продолжить размышление» / «Continue
+// thinking»), not a bare «Continue», so the match is a regex: a bare continue
+// word OR the word plus a short reasoning/answer suffix. It is anchored and
+// length-limited, so a "Continue" inside rendered prose is never clicked.
+export const CONTINUE_NAME_RE = /^(?:continue|продолжить|продолжение)(?:\s+(?:think(?:ing)?|reason(?:ing)?|размышлени[ея]|генераци[юя]|ответ))?\s*[.!…]?$/i;
+// ---------- messages / answers ----------
+// The rendered assistant answer. The FIRST hit is preferred (most specific),
+// so `ds-markdown` stays ahead of the generic `markdown` catch-all.
+export const ANSWER_SELECTORS = [
+    'div.ds-assistant-message-main-content',
+    'div[class*="ds-assistant-message-main-content"]',
+    'div[class*="ds-markdown"]',
+    'div[class*="markdown"]',
+];
+// Reasoning blocks. They are NOT the answer and must never be picked up as
+// one, otherwise the terminal would show the model's long reasoning.
+export const THINK_CLASS_RE = /ds-think-content|thinking-content/i;
+// Last-resort answer-only selectors for the restored-dialogue scraper. The
+// generic `markdown` catch-all is deliberately absent here: without a message
+// container it would also match a user bubble that happens to render markdown.
+export const RESTORE_ANSWER_SELECTORS = [
+    'div.ds-assistant-message-main-content',
+    'div[class*="ds-assistant-message-main-content"]',
+    'div[class*="ds-markdown"]',
+];
+// Message-level containers for the restored dialogue (broad first).
+export const MESSAGE_CONTAINER_SELECTORS = [
+    '[data-message-id]',
+    '[class*="ds-message"]',
+    '[class*="chat-message"]',
+    '[class*="message-item"]',
+    '[class*="_message"]',
+];
+// A message block is "assistant" when it carries the assistant class OR a
+// rendered markdown wrapper (a user bubble has no rendered markdown). Used by
+// the restored-dialogue scraper; the class names drift between builds, so the
+// detection is content-based rather than class-prefix-only.
+export const ASSISTANT_CLASS_RE = /ds-assistant-message|assistant-message/i;
+export const ASSISTANT_SELECTOR = '[class*="ds-assistant-message"]';
+export const ANSWER_MARKDOWN_SELECTOR = '[class*="ds-markdown"]';
+// A cheap "did the page grow?" signal (_chatSignal): count message nodes and
+// measure the LAST answer node's text length. The old code read
+// document.body.innerText.length every tick, which serializes the WHOLE page
+// (sidebar, history, menus) and forces a layout — expensive on a long chat.
+export const CHAT_SIGNAL_NODES_SELECTOR = '[class*="ds-message"], [class*="chat-message"], .ds-markdown';
+export const MARKDOWN_SELECTOR = '.ds-markdown';
+// ---------- new chat ----------
+// The "New chat" control is NOT a <button>/<a> on the current DeepSeek build
+// (it is a <div>), so matching only button/a missed it. Match any
+// clickable-ish element whose text is EXACTLY the new-chat label (an anchored
+// regex keeps a big outer container from matching its long descendant text).
+export const NEW_CHAT_SELECTOR = 'button, a, [role="button"], div, span';
+export const NEW_CHAT_TEXT_RE = /^\s*(new chat|новый чат|новый диалог)\s*$/i;
+// ---------- login ----------
+// The login page is served on the same origin and swaps in a password field;
+// the exact classes change, so we match loosely on input types and the known
+// placeholder/autocomplete attributes.
+export const PASSWORD_SELECTORS = [
+    'input[type="password"]',
+    'input[autocomplete="current-password"]',
+    'input[autocomplete="new-password"]',
+];
+export const LOGIN_SELECTORS = [
+    'input[type="email"]',
+    'input[type="tel"]',
+    'input[name="email"]',
+    'input[name="phone"]',
+    'input[name="username"]',
+    'input[placeholder*="email" i]',
+    'input[placeholder*="phone" i]',
+    'input[placeholder*="телефон" i]',
+    'input[placeholder*="почт" i]',
+    'input[autocomplete="username"]',
+    'input[autocomplete="email"]',
+];
+// Any login-ish button: a primary DeepSeek button or a plain <button>. The
+// visible label is filtered by LOGIN_NAME_RE so "Log in with Google" is not
+// hit by mistake.
+export const LOGIN_BUTTON_SELECTOR = 'div[role="button"].ds-button--primary, button';
+export const LOGIN_NAME_RE = /^\s*(log ?in|sign ?in|войти)\s*$/i;
+// A looser label test used inside the form fallback: a Continue button can also
+// submit the login step on some builds.
+export const LOGIN_FORM_SUBMIT_RE = /log ?in|sign ?in|войти|continue|продолж/i;
+export const LOGIN_SUBMIT_SELECTORS = [
+    // DeepSeek's real button: a div[role=button] with these classes and a
+    // <span class="ds-button__content">Log in</span> inside.
+    'div[role="button"].ds-button--primary.ds-button--filled',
+    'div[role="button"].ds-button--primary',
+    'button[type="submit"]',
+    'button:has-text("Log in")',
+    'button:has-text("Sign in")',
+    'button:has-text("Войти")',
+    'div[role="button"]:has-text("Log in")',
+    'div[role="button"]:has-text("Sign in")',
+    'div[role="button"]:has-text("Войти")',
+];
+// ---------- sidebar / chats ----------
+export const SIDEBAR_TOGGLE_SELECTORS = [
+    'button[aria-label*="sidebar" i]',
+    'button[aria-label*="история" i]',
+    'button[aria-label*="history" i]',
+    'button[class*="sidebar-toggle"]',
+    'button[class*="sidebarToggle"]',
+];
+// ---------- toggles (deep thinking / web search) ----------
+// DeepSeek exposes two toggle buttons above the input. Their labels are
+// localized, so we match by a loose regex on the visible text and read the
+// state from aria-pressed. `.ds-toggle-button` is the class anchor; the
+// semantic fallback ([aria-pressed] or [role=switch]) is tried when the class
+// is renamed, so a redesign does not silently disable the toggles.
+export const TOGGLE_SELECTORS = [
+    '.ds-toggle-button',
+    '[role="switch"]',
+    'div[role="button"][aria-pressed]',
+    'button[aria-pressed]',
+];
+export const DEEP_THINKING_RE = /глубок|deep\s*think/i;
+export const WEB_SEARCH_RE = /поиск|search/i;
+// ---------- attachments ----------
+export const ATTACH_SELECTORS = [
+    'div[role="button"][aria-label*="attach" i]',
+    'div[role="button"][aria-label*="влож" i]',
+    'button[aria-label*="attach" i]',
+    'button[aria-label*="влож" i]',
+    '[class*="upload"]',
+    '[class*="attach"]',
+];
+// ---------- service statuses / errors ----------
+// DeepSeek UI service statuses that are NOT the model's answer. Otherwise the
+// agent takes a status (Reading...) for an answer and breaks parsing.
+export const STATUS_RE = /^(reading|thinking|searching|analyzing|generating|stop|остановить|читаю|думаю|поиск|анализ)[\s.…]*$/i;
+// DeepSeek's answer when the rate limit is exceeded.
+//
+// IMPORTANT: the generic "try again later" / "повторите позже" tail is NOT
+// part of this pattern. DeepSeek appends it to MANY toasts ("Server busy.
+// Try again later.", "Service unavailable. Try again later."), so matching it
+// here classified every server hiccup as a RATE LIMIT and sent the agent into
+// a 5-minute wait. The rate limit is recognized by its specific wording only.
+export const RATE_LIMIT_RE = /(messages? too frequent|too many requests|rate limit|слишком часто|сообщени[яе] слишком част)/i;
+// Transient server-side hiccups (DeepSeek overloaded / hiccup). Unlike the
+// rate limit, these usually clear in seconds, so we retry quickly instead of
+// waiting minutes.
+export const SERVER_BUSY_RE = /(server (is )?busy|server error|service (is )?unavailable|temporarily unavailable|internal server error|502|503|504|server overloaded|сервер занят|сервер перегружен|сервис недоступен|внутренняя ошибка|попробуйте позже)/i;
+// ---------- network protocol (SSE) ----------
+export const GENERATION_ERR_RE = /"finish_reason":\s*"generation_err"/i;
+export const INCOMPLETE_STATUS_RE = /"quasi_status","v":"INCOMPLETE"/i;
+// A turn that ENDED (`quasi_status: FINISHED`) but produced NO answer text —
+// the reasoning was generated and the model stopped WITHOUT a RESPONSE
+// fragment. The UI shows Stopped + Continue.
+export const FINISHED_STATUS_RE = /"quasi_status","v":"FINISHED"/i;
+export const RESPONSE_CONTENT_RE = /"type":"RESPONSE","content":"[^"]/;
+// Only a completion/continue turn carries a real answer. Gating the capture
+// assignment to these URLs keeps a future endpoint (which happens to return a
+// `content`/`text` field) from clobbering the answer and looking fresh.
+export const ANSWER_URL_RE = /chat\/(completion|continue)/i;

package/dist/i18n/doctor.js

@@ -38,6 +38,26 @@ export const doctorMessages = {
         ru: 'UA ещё не закэширован (первый запуск перезапустится один раз)',
         en: 'no cached UA yet (first start relaunches once)',
     },
+    'doctor.ui_ok': {
+        ru: 'все ключевые элементы найдены',
+        en: 'all key elements found',
+    },
+    'doctor.ui_degraded': {
+        ru: 'часть элементов не найдена: {v} (агент может работать некорректно)',
+        en: 'some elements not found: {v} (the agent may misbehave)',
+    },
+    'doctor.ui_broken': {
+        ru: 'НЕ найдено критичное: {v} — DeepSeek сменил вёрстку, задачи не будут отправляться. Запусти /debug-dom.',
+        en: 'MISSING critical: {v} — DeepSeek changed the markup, tasks will not send. Run /debug-dom.',
+    },
+    'ui.probe_failed': {
+        ru: '⚠ DeepSeek UI: не найдено критичное ({v}) — возможно, сменилась вёрстка chat.deepseek.com. Задачи могут не отправляться; проверь /doctor и /debug-dom.',
+        en: '⚠ DeepSeek UI: missing critical element(s) ({v}) — chat.deepseek.com markup may have changed. Tasks may not send; check /doctor and /debug-dom.',
+    },
+    'ui.probe_degraded': {
+        ru: '⚠ DeepSeek UI: не найдено ({v}) — часть возможностей (тумблеры/новый чат) может не работать.',
+        en: '⚠ DeepSeek UI: not found ({v}) — some features (toggles/new chat) may not work.',
+    },
     'adddir.usage': {
         ru: 'Использование: /add-dir <path>',
         en: 'Usage: /add-dir <path>',

package/dist/index.js

@@ -997,6 +997,23 @@ async function main() {
         await transcript.close();
         process.exit(1);
     }
+    // DeepSeek UI health probe. The agent drives a page we do not control, so a
+    // redesign silently breaks selectors and the FIRST symptom is a task hanging
+    // on "input field not found". Probe the always-present controls right after
+    // login and warn the operator up front. Best-effort: a probe failure must
+    // never block startup.
+    const warnUiHealth = (h) => {
+        if (h.missingCritical.length) {
+            console.error(theme.warn(t('ui.probe_failed', { v: h.missingCritical.join(', ') })));
+        }
+        else if (h.missing.length) {
+            console.error(theme.warn(t('ui.probe_degraded', { v: h.missing.join(', ') })));
+        }
+    };
+    try {
+        warnUiHealth(await browser.probeUiHealth());
+    }
+    catch { }
     // One-shot mode
     if (task) {
         const baseTools = mod.createTools(currentWorkdir, {
@@ -2940,6 +2957,9 @@ async function main() {
             const mcpStatus = mcpPool
                 ? mcpPool.status()
                 : { servers: [], toolCount: 0 };
+            // Probe the DeepSeek UI so a redesign shows up as a /doctor row instead
+            // of a task that hangs on a missing input. Best-effort.
+            const uiHealth = await browser.probeUiHealth().catch(() => null);
             console.log(theme.system(mod.commands.renderDoctor({
                 nodeVersion: process.version,
                 platform: process.platform,
@@ -2961,6 +2981,9 @@ async function main() {
                 sshRemote: !!(process.env.SSH_CONNECTION || process.env.SSH_TTY),
                 headless: !!headless,
                 headlessUaCached: await headlessUACacheReady().catch(() => false),
+                uiPresent: uiHealth?.present,
+                uiMissing: uiHealth?.missing,
+                uiMissingCritical: uiHealth?.missingCritical,
             }, t)));
             continue;
         }

package/dist/net-capture.js

@@ -1,6 +1,7 @@
 import fs from 'fs/promises';
 import os from 'os';
 import path from 'path';
+import { FINISHED_STATUS_RE, RESPONSE_CONTENT_RE } from './deepseek-ui.js';
 // Extraction of the RAW model answer text from DeepSeek's network data.
 //
 // Why: the answer is read from the RENDERED DOM, and DeepSeek's rendering
@@ -175,11 +176,11 @@ export function isFinishedWithoutAnswer(body) {
     const b = String(body || '');
     if (!b)
         return false;
-    const finished = /"quasi_status","v":"FINISHED"/i.test(b);
+    const finished = FINISHED_STATUS_RE.test(b);
     if (!finished)
         return false;
     // A RESPONSE fragment with actual content means the model DID answer.
-    if (/"type":"RESPONSE","content":"[^"]/.test(b))
+    if (RESPONSE_CONTENT_RE.test(b))
         return false;
     // The turn carried reasoning (THINK) or was truncated mid-way; treat the
     // absence of response content as "no answer produced".

package/dist/ui-health.js

@@ -0,0 +1,71 @@
+// UI health check — a cheap "can the agent still drive this page?" probe.
+//
+// WHY: every selector in deepseek-ui.ts is an assumption about a page we do
+// not control. When DeepSeek ships a redesign, the FIRST symptom used to be a
+// task hanging on "input field not found" (or a silently mis-clicked send),
+// minutes into a run. This module turns that into an explicit answer BEFORE
+// the task: it checks the capabilities the agent ALWAYS needs and reports the
+// missing ones. The page object is injected (the browser owns Playwright), so
+// the decision logic here stays pure and unit-testable.
+//
+// Only ALWAYS-PRESENT capabilities are probed. The Stop button and the answer
+// nodes are TRANSIENT (Stop exists only during generation, answers only after
+// a turn), so a presence probe on a healthy idle page would report false
+// negatives; they are deliberately excluded.
+import { INPUT_SELECTORS, SEND_SELECTORS, TOGGLE_SELECTORS, NEW_CHAT_SELECTOR, NEW_CHAT_TEXT_RE, } from './deepseek-ui.js';
+// Critical: without the input the prompt cannot be typed, without send it
+// cannot be submitted — a task would hang on `ds.input_missing`. Advisory:
+// toggles/newChat degrade gracefully (the toggles fall back to the configured
+// state, newChat falls back to navigating to the base URL).
+export const UI_CAPABILITIES = [
+    { capability: 'input', selectors: INPUT_SELECTORS, critical: true },
+    { capability: 'send', selectors: SEND_SELECTORS, critical: true },
+    { capability: 'toggles', selectors: TOGGLE_SELECTORS, critical: false },
+    { capability: 'newChat', selectors: [NEW_CHAT_SELECTOR], critical: false },
+];
+async function hasAny(page, sel, textRe) {
+    try {
+        const n = textRe
+            ? await page.countByText(sel, textRe)
+            : await page.count(sel);
+        return n > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Probe the always-present DeepSeek controls. Never throws: a dead page is
+ * reported as every capability missing, which the caller surfaces to the
+ * operator instead of letting the next task hang.
+ */
+export async function probeUiHealth(page) {
+    const present = [];
+    const missing = [];
+    const missingCritical = [];
+    for (const spec of UI_CAPABILITIES) {
+        let found = false;
+        // The new-chat control is matched by an EXACT text label on a broad
+        // element set (it is a <div> on the current build, not a <button>).
+        const textRe = spec.capability === 'newChat' ? NEW_CHAT_TEXT_RE : undefined;
+        for (const sel of spec.selectors) {
+            if (await hasAny(page, sel, textRe)) {
+                found = true;
+                break;
+            }
+        }
+        if (found)
+            present.push(spec.capability);
+        else {
+            missing.push(spec.capability);
+            if (spec.critical)
+                missingCritical.push(spec.capability);
+        }
+    }
+    return {
+        ok: missingCritical.length === 0,
+        present,
+        missing,
+        missingCritical,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zames_pro",
-  "version": "2.69.0",
+  "version": "2.70.0",
   "description": "Terminal coding agent that drives chat.deepseek.com through Playwright — no API key required. Reads and edits files, runs commands, commits to git, like Claude Code / Codex CLI.",
   "type": "module",
   "bin": {