zames_pro 2.16.0 → 2.18.0

package/README.md

@@ -9,7 +9,42 @@ directory, reads and edits files, runs commands, and commits to git.
 ## Requirements
 
 - Node.js >= 18
-- A DeepSeek account (you log in manually in the browser window that opens on first launch)
+- A DeepSeek account. On first launch zames asks for your DeepSeek
+  login/password in the terminal (and stores them in `~/.zames/config.json`
+  after a successful sign-in, so a later logout is handled automatically
+  without asking you again). You can also sign in manually in the browser
+  window when the browser is headed.
+
+## Signing in
+
+The browser runs **headless by default**. When DeepSeek requires a sign-in,
+zames:
+
+1. reuses the session stored in the persistent profile (`~/.zames/profile`)
+   if it is still valid;
+2. otherwise signs in automatically with the saved credentials
+   (`browser.auth.username` / `browser.auth.password`);
+3. otherwise asks you for the login/password in the terminal (in a TTY) and,
+   after a successful sign-in, remembers them for next time;
+4. otherwise falls back to a manual sign-in hint.
+
+To sign in by hand (for example, if DeepSeek shows a captcha), run with a
+visible window:
+
+```bash
+zames --headed
+```
+
+The `--headless` flag (the default) and `headless: true` in the config keep
+the browser without a window; `--headed` / `headless: false` show it.
+
+Headless works out of the box: a headless Chrome normally advertises a
+`HeadlessChrome/...` User-Agent that DeepSeek's CDN blocks with a 403, so
+zames strips that marker before loading the page (keeping the real engine
+version). You do not need `--headed` just to log in.
+
+Credentials and toggles can also be edited from `/config`
+(`browser.auth.username`, `browser.auth.password`, `browser.auth.saveSession`).
 
 ## Installation
 
@@ -71,6 +106,7 @@ zames --new-chat
 zames --resend-prompt
 zames --dir <path>
 zames --headless
+zames --headed
 zames --debug
 zames --version
 zames --help
@@ -111,6 +147,9 @@ Codex CLI:
  alwaysConfirm regex list).
 - /add-dir <path> — validate an extra directory (the sandbox is fixed at
  startup; relaunch with --dir to write there).
+- /resume <n> (after /chats) and /resume-id <id> — open a chat and PRINT its
+ dialogue into the terminal, so the restored context is visible. Only the
+ last 20 messages are shown (`RESTORED_HISTORY_LIMIT`).
 - /review [focus] [--staged] — ask the agent to review uncommitted changes
  and report findings (no code changes).
 

package/dist/agent-loop.js

@@ -4,7 +4,7 @@ import { getGitContext, formatGitContext } from './gitTools.js';
 import { parseXmlToolCalls } from './xml-toolcall.js';
 import { translate } from './i18n.js';
 import { normText } from './browser.js';
-export async function runAgentLoop({ browser, tools, task, workdir, maxIterations = 0, freshChat = false, sendSystemPrompt = false, transcript = null, attachments = [], onThinking = () => { }, onAssistantThought = () => { }, onToolCall = () => { }, onToolResult = () => { }, onAssistantMessage = () => { }, onChatReady = () => { }, onWarning = () => { }, debugLog = false, locale = 'ru', }) {
+export async function runAgentLoop({ browser, tools, task, workdir, maxIterations = 0, freshChat = false, sendSystemPrompt = false, transcript = null, attachments = [], onThinking = () => { }, onSendPause = () => { }, onAssistantThought = () => { }, onToolCall = () => { }, onToolResult = () => { }, onAssistantMessage = () => { }, onChatReady = () => { }, onWarning = () => { }, debugLog = false, locale = 'ru', }) {
     // UI callbacks must NEVER break the agent loop. A rendering error (a huge
     // tool result, a broken markdown frame, a closed terminal) used to throw
     // out of the loop right after a tool call — the session looked "stopped
@@ -26,6 +26,10 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
     // Previously safeThinking() fired before browser.ask(), so the spinner ran
     // through the whole throttle pause / chat-open phase with nothing in flight.
     browser.onSendStart = safeThinking;
+    // Animate the send-interval pause too: the browser reports the remaining
+    // seconds, the UI shows an animated status instead of a frozen line.
+    const safeSendPause = safe(onSendPause);
+    browser.onSendPause = safeSendPause;
     const safeAssistantThought = safe(onAssistantThought);
     const safeToolCall = safe(onToolCall);
     const safeToolResult = safe(onToolResult);
@@ -125,6 +129,9 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
     let unparsedRetries = 0;
     const MAX_UNPARSED_RETRIES = 4;
     let finalRespondAsked = false;
+    // The operator is told ONCE that the agent is re-asking the model for a
+    // proper tool call (not on every retry — that would spam the terminal).
+    let toolRetryWarned = false;
     // Guard against "the agent stalled": DeepSeek sometimes sends a final text
     // that merely DESCRIBES the next tool call (or cuts the answer off
     // mid-word), and the agent silently finishes the task even though the work
@@ -203,9 +210,9 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
                 attempt: afterToolRetries,
                 error: e.message,
             });
-            safeWarning('browser.ask() did not return an answer within ' +
-                Math.round(askDeadlineMs / 1000) +
-                's — retrying the request.');
+            safeWarning(translate(locale)('ds.answer_timeout', {
+                sec: Math.round(askDeadlineMs / 1000),
+            }));
             if (afterToolRetries < MAX_AFTER_TOOL_RETRIES) {
                 afterToolRetries++;
                 await new Promise((r) => setTimeout(r, 1500));
@@ -214,8 +221,7 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
             transcript?.log('ask_timeout_exhausted', {
                 message: 'ask() did not return an answer and the retry limit is exhausted',
             });
-            safeWarning('browser.ask() stopped responding; retry limit exhausted, ' +
-                'stopping. No model answer — check the DeepSeek chat manually.');
+            safeWarning(translate(locale)('ds.answer_timeout_give_up'));
             return 'ask() watchdog: no model answer received';
         }
         await reportChat();
@@ -398,6 +404,16 @@ export async function runAgentLoop({ browser, tools, task, workdir, maxIteration
                     attempt: unparsedRetries,
                     response: rawResponse.slice(0, 500),
                 });
+                // Tell the operator WHY nothing is happening: the model wrote text
+                // instead of a tool call and the agent is asking it to continue. Only
+                // once per task, otherwise the retry budget spams the terminal.
+                if (!toolRetryWarned) {
+                    toolRetryWarned = true;
+                    safeWarning(translate(locale)('ds.tool_retry', {
+                        attempt: unparsedRetries,
+                        max: MAX_UNPARSED_RETRIES,
+                    }));
+                }
                 message =
                     (justRanTool
                         ? 'You stopped after a tool call and wrote plain text. '