zames_pro 2.73.1 → 2.73.2

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.73.2] - 2026-10-11
+
+### Changed
+
+- docs(readme): document Qwen everywhere and refresh the diagram
+
 ## [2.73.1] - 2026-10-11
 
 ### Fixed

package/README.md

@@ -63,27 +63,31 @@ zames does not call the model API. It launches a headless Chromium with a
 persistent profile, signs in to a chat web app like a human, types the task
 into the chat box, and reads the answer back.
 
-Two chat backends are available, switched with `/provider <deepseek|qwen>`
-(restart required): **DeepSeek** (`chat.deepseek.com`, the default) and
-**Qwen** (`chat.qwen.ai`). Each keeps its own persistent profile, so switching
-never signs the other one out.
+Two chat backends are available, switched with `/provider <deepseek|qwen>`:
+**DeepSeek** (`chat.deepseek.com`, the default) and **Qwen** (`chat.qwen.ai`).
+The switch is **live** — zames closes the current backend and opens the other
+one in place, no restart needed. Each keeps its own persistent profile
+(`~/.zames/profile` and `~/.zames/qwen-profile`), so switching never signs the
+other one out.
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/Viqto0r/zames_pro/master/docs/how-it-works.png" alt="how zames works" width="860">
 </p>
 
 In text: you type a task → zames sends the system prompt plus the task into
-the DeepSeek web chat → the model answers → zames parses the tool call, runs
-the tool locally, feeds the result back, and prints the final answer for you.
+the active chat web app (DeepSeek or Qwen) → the model answers → zames parses
+the tool call, runs the tool locally, feeds the result back, and prints the
+final answer for you.
 
 Key pieces:
 
 - **The answer is read from the raw network stream** (SSE), not the rendered
   DOM, so tool-call JSON with template strings and escapes survives intact.
-- **A persistent profile** (`~/.zames/profile`) keeps you signed in; the
-  headless User-Agent is patched so DeepSeek's CDN does not 403 the login.
-- **A send throttle** (15 s by default) keeps the web chat's rate limit happy
-  during long tool-heavy runs.
+- **A persistent per-provider profile** (`~/.zames/profile` for DeepSeek,
+  `~/.zames/qwen-profile` for Qwen) keeps you signed in; the headless
+  User-Agent is patched so the site's CDN does not 403 the login.
+- **A send throttle** (15 s on DeepSeek, ~1 s on Qwen, which tolerates rapid
+  sends) keeps the web chat's rate limit happy during long tool-heavy runs.
 - **The agent is sandboxed** to the directory it was started in — no tool can
   read or write above it.
 
@@ -174,7 +178,7 @@ zames can drive either **DeepSeek** (`chat.deepseek.com`, the default) or
 **Qwen** (`chat.qwen.ai`):
 
 ```bash
-/provider qwen      # switch to Qwen (persisted); restart zames to take effect
+/provider qwen      # switch to Qwen (persisted) — applied live, no restart
 /provider deepseek  # switch back
 /provider status    # show the active provider / model / login state
 /provider login     # (re)run the sign-in check
@@ -184,15 +188,18 @@ zames can drive either **DeepSeek** (`chat.deepseek.com`, the default) or
 
 Notes:
 
-- The two backends use **separate persistent profiles**
-  (`~/.zames/profile` for DeepSeek, `~/.zames/qwen-profile` for Qwen), so
-  switching never signs the other one out. A provider switch takes effect on
-  the next launch — the browser is created once at startup.
+- The switch is **live**: zames closes the current backend and opens the other
+  one in place, so no restart is needed. The two backends use **separate
+  persistent profiles** (`~/.zames/profile` for DeepSeek, `~/.zames/qwen-profile`
+  for Qwen), so switching never signs the other one out.
+- A chat id belongs to ONE backend, so the new provider opens a **fresh chat**.
+  If the previous chat had messages they are summarized and posted as a
+  handoff with the next task; an empty chat is switched silently.
 - Qwen works in **guest mode** without an account, but a guest is limited to a
   handful of messages per day; for long agent runs sign in (email / Google /
   GitHub — no phone required). zames auto-logins from the saved credentials or
   asks in the terminal, exactly like DeepSeek. `/model` changes the Qwen model
-  at runtime (no restart).
+  at runtime.
 - File attachments on Qwen go through the mode menu's **Upload attachment**
   item; DeepSeek uses its own paperclip.
 - `/doctor` shows the active provider and the UI health of that provider's
@@ -343,9 +350,10 @@ Codex CLI:
   (zames-export-<stamp>.md by default).
 - /doctor — diagnose node, git, config, browser, clipboard, MCP and the
   active chat provider (it also reports that provider's UI health).
-- /provider <deepseek|qwen> — switch the chat backend (restart to apply);
-  /provider status shows the active provider/model/login; /provider login
-  re-runs the sign-in check. /model [id] lists or picks a Qwen model at runtime.
+- /provider <deepseek|qwen> — switch the chat backend (applied live, no
+  restart); /provider status shows the active provider/model/login; /provider
+  login re-runs the sign-in check. /model [id] lists or picks a Qwen model at
+  runtime.
 - /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
@@ -582,30 +590,33 @@ zames не вызывает API модели. Он запускает headless C
 профилем, входит в веб-чат как человек, печатает задачу в поле чата и читает
 ответ обратно.
 
-Доступны два бэкенда, переключаются командой `/provider <deepseek|qwen>`
-(нужен перезапуск): **DeepSeek** (`chat.deepseek.com`, по умолчанию) и
-**Qwen** (`chat.qwen.ai`). У каждого свой постоянный профиль, поэтому
-переключение не разлогинивает другой.
+Доступны два бэкенда, переключаются командой `/provider <deepseek|qwen>`:
+**DeepSeek** (`chat.deepseek.com`, по умолчанию) и **Qwen** (`chat.qwen.ai`).
+Переключение **живое** — zames закрывает текущий бэкенд и открывает другой на
+месте, без перезапуска. У каждого свой постоянный профиль
+(`~/.zames/profile` и `~/.zames/qwen-profile`), поэтому переключение не
+разлогинивает другой.
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/Viqto0r/zames_pro/master/docs/how-it-works.png" alt="как работает zames" width="860">
 </p>
 
 Словами: вы вводите задачу → zames отправляет системный промпт и задачу в
-веб-чат DeepSeek → модель отвечает → zames разбирает вызов инструмента,
-выполняет его локально, возвращает результат обратно и печатает финальный
-ответ.
+активный веб-чат (DeepSeek или Qwen) → модель отвечает → zames разбирает
+вызов инструмента, выполняет его локально, возвращает результат обратно и
+печатает финальный ответ.
 
 Ключевые детали:
 
 - **Ответ читается из сырого сетевого потока** (SSE), а не из отрендеренного
   DOM, поэтому JSON вызова инструмента с шаблонными строками и экранированием
   остаётся целым.
-- **Постоянный профиль** (`~/.zames/profile`) держит вас залогиненным;
-  User-Agent headless-браузера подменяется, чтобы CDN DeepSeek не отдавал 403
-  на вход.
-- **Троттлинг отправки** (15 с по умолчанию) щадит рейт-лимит веб-чата во
-  время долгих прогонов с инструментами.
+- **Постоянный профиль на каждого провайдера** (`~/.zames/profile` у DeepSeek,
+  `~/.zames/qwen-profile` у Qwen) держит вас залогиненным; User-Agent
+  headless-браузера подменяется, чтобы CDN сайта не отдавал 403 на вход.
+- **Троттлинг отправки** (15 с у DeepSeek, ~1 с у Qwen, который спокойно
+  переносит частые отправки) щадит рейт-лимит веб-чата во время долгих
+  прогонов с инструментами.
 - **Агент запесочен** в директорию запуска — ни один инструмент не может
   читать или писать выше неё.
 
@@ -698,7 +709,7 @@ zames умеет работать с **DeepSeek** (`chat.deepseek.com`, по у
 **Qwen** (`chat.qwen.ai`):
 
 ```bash
-/provider qwen      # переключиться на Qwen (сохраняется); нужен перезапуск
+/provider qwen      # переключиться на Qwen (сохраняется) — применяется сразу
 /provider deepseek  # вернуться обратно
 /provider status    # активный провайдер / модель / статус входа
 /provider login     # повторно пройти проверку входа
@@ -708,15 +719,17 @@ zames умеет работать с **DeepSeek** (`chat.deepseek.com`, по у
 
 Замечания:
 
-- У бэкендов **разные постоянные профили** (`~/.zames/profile` у DeepSeek,
-  `~/.zames/qwen-profile` у Qwen), поэтому переключение не разлогинивает
-  другой. Смена провайдера применяется при следующем запуске — браузер
-  создаётся один раз на старте.
+- Переключение **живое**: zames закрывает текущий бэкенд и открывает другой на
+  месте, перезапуск не нужен. У бэкендов **разные постоянные профили**
+  (`~/.zames/profile` у DeepSeek, `~/.zames/qwen-profile` у Qwen), поэтому
+  переключение не разлогинивает другой.
+- id чата принадлежит ОДНОМУ бэкенду, поэтому новый провайдер открывает
+  **свежий чат**. Если в прошлом чате были сообщения, они сжимаются и
+  подставляются как handoff в следующую задачу; пустой чат переключается молча.
 - Qwen работает в **гостевом режиме** без аккаунта, но гостю доступно всего
   несколько сообщений в день; для долгих прогонов войдите (email / Google /
   GitHub — телефон не нужен). zames сам логинится по сохранённым кредам или
-  спросит в терминале, как и с DeepSeek. `/model` меняет модель Qwen на лету
-  (без перезапуска).
+  спросит в терминале, как и с DeepSeek. `/model` меняет модель Qwen на лету.
 - Вложения в Qwen идут через пункт **Upload attachment** в меню режима; в
   DeepSeek — своя скрепка.
 - `/doctor` показывает активный провайдер и состояние UI его страницы.
@@ -872,9 +885,10 @@ zames --task "..." --output-format jsonl \
   (по умолчанию zames-export-<stamp>.md).
 - /doctor — диагностика node, git, конфига, браузера, буфера обмена, MCP и
   активного провайдера чата (плюс состояние UI его страницы).
-- /provider <deepseek|qwen> — сменить бэкенд чата (нужен перезапуск);
-  /provider status показывает активный провайдер/модель/вход; /provider login
-  повторно проверяет вход. /model [id] покажет или выберет модель Qwen на лету.
+- /provider <deepseek|qwen> — сменить бэкенд чата (применяется сразу, без
+  перезапуска); /provider status показывает активный провайдер/модель/вход;
+  /provider login повторно проверяет вход. /model [id] покажет или выберет
+  модель Qwen на лету.
 - /add-dir <path> — проверить дополнительную директорию (песочница
   фиксируется при старте; для записи туда перезапустите с --dir).
 - /resume <n> (после /chats) и /resume-id <id> — открыть чат и НАПЕЧАТАТЬ его

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zames_pro",
-  "version": "2.73.1",
+  "version": "2.73.2",
   "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": {
@@ -35,6 +35,8 @@
     "self-smoke": "tsx scripts/self-smoke.mts",
     "qwen-smoke": "tsx scripts/qwen-smoke.mts",
     "render-demo": "tsx scripts/render-demo.mts",
+    "render-how": "tsx scripts/render-how-it-works.mts",
+    "render-how": "tsx scripts/render-how-it-works.mts",
     "build:readme": "tsx scripts/build-readme.mts",
     "postinstall": "node scripts/postinstall.mjs",
     "prepare": "husky"

package/scripts/render-how-it-works.mts

@@ -0,0 +1,129 @@
+// Render docs/how-it-works.png — the architecture diagram used in README.md.
+//
+// Why a generator: the README must show BOTH chat backends (DeepSeek and
+// Qwen), not just DeepSeek. A hand-drawn PNG drifts; this renders a fixed
+// HTML page with headless Chromium so the diagram is reproducible and easy to
+// update when a provider is added.
+//
+// Run:  npm run render-how  (tsx scripts/render-how-it-works.mts)
+//
+// Isolation: chromium.launch() uses a THROWAWAY in-memory context, never
+// ~/.zames/profile (see AGENTS.md — never touch the live agent's browser).
+
+import { chromium } from 'playwright'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const out = path.join(root, 'docs', 'how-it-works.png')
+
+const C = {
+  bg: '#23272e',
+  panel: '#2b303a',
+  border: '#3b4250',
+  text: '#cfc9b0',
+  dim: '#8a9bb5',
+  user: '#b4b8d0',
+  accent: '#7fc4f0',
+  ds: '#6f8ed0',
+  qwen: '#6fd0b0',
+  tool: '#c6a97e',
+}
+
+const W = 1300
+const H = 360
+
+const box = (
+  title: string,
+  sub: string,
+  color: string,
+): string =>
+  '<div class="box" style="border-color:' +
+  color +
+  '">' +
+  '<div class="box-t" style="color:' +
+  color +
+  '">' +
+  title +
+  '</div>' +
+  '<div class="box-s">' +
+  sub +
+  '</div></div>'
+
+const html =
+  '<!doctype html><html><head><meta charset="utf-8"><style>' +
+  '@font-face{font-family:ZM;src:local("DejaVu Sans Mono")}' +
+  'html,body{margin:0;padding:0;background:' +
+  C.bg +
+  '}' +
+  'body{font-family:"DejaVu Sans Mono",monospace;color:' +
+  C.text +
+  ';-webkit-font-smoothing:antialiased}' +
+  '.wrap{box-sizing:border-box;width:' +
+  W +
+  'px;height:' +
+  H +
+  'px;padding:26px 30px}' +
+  '.row{display:flex;align-items:center;justify-content:space-between;gap:8px}' +
+  '.box{box-sizing:border-box;border:2px solid;border-radius:10px;padding:14px 16px;' +
+  'background:' +
+  C.panel +
+  ';min-width:150px;text-align:center}' +
+  '.box-t{font-size:18px;font-weight:700;margin-bottom:6px}' +
+  '.box-s{font-size:12px;color:' +
+  C.dim +
+  ';line-height:1.5}' +
+  '.arrow{font-size:26px;color:' +
+  C.dim +
+  '}' +
+  '.flow-label{font-size:12px;color:' +
+  C.dim +
+  ';text-align:center;margin-top:4px}' +
+  '.providers{display:flex;flex-direction:column;gap:10px}' +
+  '.col{display:flex;flex-direction:column;align-items:center;gap:4px}' +
+  '.legend{margin-top:20px;font-size:12px;color:' +
+  C.dim +
+  ';text-align:center}' +
+  '.legend b{color:' +
+  C.text +
+  '}' +
+  '</style></head><body><div class="wrap">' +
+  '<div class="row">' +
+  // left: the operator
+  '<div class="col">' +
+  box('Operator', 'terminal task<br/>+ tool approval', C.user) +
+  '<div class="flow-label">types a task</div>' +
+  '</div>' +
+  '<div class="arrow">&#8594;</div>' +
+  // middle: zames
+  '<div class="col">' +
+  box(
+    'zames',
+    'sandboxed tools<br/>parses tool-calls<br/>runs them locally',
+    C.accent,
+  ) +
+  '<div class="flow-label">system prompt + task</div>' +
+  '</div>' +
+  '<div class="arrow">&#8644;</div>' +
+  // right: the two backends
+  '<div class="providers">' +
+  box('DeepSeek', 'chat.deepseek.com<br/>~/.zames/profile', C.ds) +
+  box('Qwen', 'chat.qwen.ai<br/>~/.zames/qwen-profile', C.qwen) +
+  '</div>' +
+  '</div>' +
+  '<div class="legend">zames drives a <b>real browser</b> over a persistent per-provider profile &mdash; no API key. ' +
+  'Switch live with <b>/provider &lt;deepseek|qwen&gt;</b> (each chat id belongs to one backend).</div>' +
+  '</div></body></html>'
+
+const browser = await chromium.launch({ headless: true })
+try {
+  const page = await browser.newPage({
+    viewport: { width: W, height: H },
+    deviceScaleFactor: 2,
+  })
+  await page.setContent(html, { waitUntil: 'load' })
+  await page.screenshot({ path: out })
+  console.log('wrote', path.relative(root, out))
+} finally {
+  await browser.close()
+}