zames_pro 2.51.0 → 2.52.0

package/README.md

@@ -76,6 +76,23 @@ While the agent is working you can keep typing: press Enter to queue a message
 abort the current generation. This mirrors typing during generation on the
 DeepSeek website.
 
+### Input line
+
+The prompt is a small line editor with persistent history:
+
+- `↑` / `↓` — walk the message history (saved in `~/.zames/history.json`, so it
+  survives a restart); inside a multiline message the arrows move between lines.
+- `Ctrl+R` — incremental reverse search over the history (bash-style): type to
+  filter, `Ctrl+R` for older matches, `Enter` to accept, `Esc` to cancel.
+- `Ctrl+_` — undo the last edit in the input line (a fat-fingered `Ctrl+U` /
+  `Ctrl+K` is recoverable).
+- `Ctrl+U` — clear the line, `Ctrl+K` — delete to end of line, `Ctrl+W` —
+  delete the word before the cursor, `Ctrl+←`/`Ctrl+→` — move by words.
+- `\` + `Enter`, `Ctrl+J`, `Ctrl+Enter` or `Shift+Enter` — insert a newline.
+- `/` + `Tab` — slash-command hints and completion.
+
+Set `NO_COLOR=1` to disable colors (a calm default palette is used otherwise).
+
 ### Images and files
 
 You can paste an image or a file into the input line (Ctrl+Shift+V / Shift+Insert
@@ -149,7 +166,11 @@ Codex CLI:
   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`).
+  last 20 messages are shown (`RESTORED_HISTORY_LIMIT`). /last reopens the last
+  chat of the current directory with no lookup step; /sessions shows the saved
+  sessions with their relative age.
+- /help <command> — the full description of a single command (e.g. `/help diff`)
+  instead of the whole list.
 - /review [focus] [--staged] — ask the agent to review uncommitted changes
   and report findings (no code changes).
 - /compact — ask DeepSeek to compress the current chat into a handover

package/dist/commands.js

@@ -86,6 +86,27 @@ export function formatDuration(ms, units = EN_DURATION_UNITS) {
         return m + units.m + ' ' + pad(s) + units.s;
     return s + units.s;
 }
+// Short relative age ("just now", "5m ago", "3h ago", "2d ago") for the
+// /sessions and /chats lists. The operator cares about RECENCY, not a raw
+// ISO timestamp, when picking a session to restore.
+export function formatRelativeTime(iso, t = translate('en'), now = Date.now()) {
+    if (!iso)
+        return '';
+    const then = Date.parse(iso);
+    if (!Number.isFinite(then))
+        return '';
+    const diff = Math.max(0, now - then);
+    const min = Math.floor(diff / 60_000);
+    if (min < 1)
+        return t('time.now');
+    if (min < 60)
+        return t('time.min_ago', { n: String(min) });
+    const hours = Math.floor(min / 60);
+    if (hours < 24)
+        return t('time.hour_ago', { n: String(hours) });
+    const days = Math.floor(hours / 24);
+    return t('time.day_ago', { n: String(days) });
+}
 export function renderCost(stats, transcriptFile, tokenUsage = null, t = translate('en')) {
     const lines = [];
     lines.push(t('cost.title'));

package/dist/i18n.js

@@ -103,6 +103,10 @@ const CATALOG = {
         ru: 'Ctrl+R                   поиск по истории (обратный)',
         en: 'Ctrl+R                    reverse-search the history',
     },
+    'help.key.undo': {
+        ru: 'Ctrl+_                   отменить правку в строке ввода',
+        en: 'Ctrl+_                    undo the last edit in the input line',
+    },
     'help.key.words': {
         ru: 'Ctrl+← / Ctrl+→          перемещение по словам',
         en: 'Ctrl+← / Ctrl+→           move by words',
@@ -363,6 +367,10 @@ const CATALOG = {
         ru: '/debug-dom               сохранить HTML страницы (для отладки)',
         en: '/debug-dom               dump page HTML (debug)',
     },
+    'help.no_topic': {
+        ru: 'Нет команды по запросу «{v}». Попробуй /help без аргумента.',
+        en: 'No command matches "{v}". Try /help without arguments.',
+    },
     'help.cmd.help': {
         ru: '/help, help              справка',
         en: '/help, help              this help',
@@ -455,7 +463,15 @@ const CATALOG = {
     'help.files.profile': { ru: 'Профиль:', en: 'Profile:' },
     'help.files.snapshots': { ru: 'Снапшоты:', en: 'Snapshots:' },
     'help.files.tmp': { ru: 'Временные:', en: 'Temp:' },
+    'help.files.tmp_note': {
+        ru: '(в .gitignore, очищается при старте)',
+        en: '(.gitignore, cleaned on start)',
+    },
     'help.files.config': { ru: 'Конфиг:', en: 'Config:' },
+    'help.toggles_legend': {
+        ru: 'Индикаторы в статус-строке: 🧠 — глубокое размышление, 🌐 — поиск в интернете (видны, когда включены).',
+        en: 'Status-line icons: 🧠 — Deep thinking, 🌐 — web search (shown when enabled).',
+    },
     // ---------- spinner ----------
     'spinner.phrases': {
         ru: 'Анализирую запрос…|Изучаю контекст…|Планирую решение…|Обрабатываю данные…|Формулирую ответ…|Проверяю детали…|Собираю информацию…|Обдумываю варианты…|Структурирую мысли…|Готовлю решение…|Анализирую код…|Уточняю детали…|Выполняю вычисления…|Систематизирую данные…|Прорабатываю задачу…|Проверяю логику…|Оптимизирую подход…|Формирую выводы…',
@@ -1080,6 +1096,10 @@ const CATALOG = {
     },
     'chats.history_you': { ru: 'Вы', en: 'You' },
     'chats.history_agent': { ru: 'Агент', en: 'Agent' },
+    'time.now': { ru: 'только что', en: 'just now' },
+    'time.min_ago': { ru: '{n} мин назад', en: '{n}m ago' },
+    'time.hour_ago': { ru: '{n} ч назад', en: '{n}h ago' },
+    'time.day_ago': { ru: '{n} дн назад', en: '{n}d ago' },
     'sessions.dir': { ru: 'Папка сессий: {v}', en: 'Sessions dir: {v}' },
     'sessions.none': {
         ru: 'Сохранённых сессий нет. Они появятся после первой задачи/чата.',

package/dist/index.js

@@ -17,12 +17,12 @@ import { translate, normalizeLocale, localeDisplayName, isLocale, } from './i18n
 import { Transcript } from './transcript.js';
 import { UndoStore } from './undo.js';
 import { selfReview, selfDiff, selfApply, selfList } from './self-review.js';
-import { formatDiff, diffGitArgs, parseTranscript, summarizeTranscript, renderCost, formatExport, defaultExportPath, renderDoctor, renderPermissions, resolveExtraDir, buildReviewPrompt, formatDuration, trimRestoredMessages, RESTORED_HISTORY_LIMIT, mergeMessages, hasQueuedJob, isSlashCommand, parseQueueCommand, parseLiveToggle, parseGoalCommand, isLiveConfigCommand, withGoal, formatQueueList, ctrlCEscalation, } from './commands.js';
+import { formatDiff, diffGitArgs, parseTranscript, summarizeTranscript, renderCost, formatExport, defaultExportPath, renderDoctor, renderPermissions, resolveExtraDir, buildReviewPrompt, formatDuration, formatRelativeTime, trimRestoredMessages, RESTORED_HISTORY_LIMIT, mergeMessages, hasQueuedJob, isSlashCommand, parseQueueCommand, parseLiveToggle, parseGoalCommand, isLiveConfigCommand, withGoal, formatQueueList, ctrlCEscalation, } from './commands.js';
 import { performCompact } from './compact.js';
 import { Scheduler, parseInterval, formatInterval, formatJobLine, parseCron, } from './scheduler.js';
 import { renderMarkdown } from './markdown.js';
 import { closeWeb } from './web.js';
-import { saveSession, loadLastSession, readSession, listSessions, sessionsDir, } from './sessions.js';
+import { saveSession, loadLastSession, readSession, listSessions, sessionsDir, loadHistory, saveHistory, } from './sessions.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const NL = String.fromCharCode(10);
 // Floor for a /loop interval. A loop faster than the send throttle (15s)
@@ -299,6 +299,7 @@ ${theme.bold(t('help.while_working'))}
   ${t('help.key.history')}
   ${t('help.key.search')}
   ${t('help.key.words')}
+  ${t('help.key.undo')}
   ${t('help.key.slash')}
   ${t('help.key.newline')}
   ${t('help.key.backslash')}
@@ -357,9 +358,11 @@ ${theme.bold(t('help.files'))}
   ${t('help.files.sessions')}      ${sessionsDir()}
   ${t('help.files.profile')}     ~/.zames/profile
   ${t('help.files.snapshots')}    ~/.zames/snapshots
-  ${t('help.files.tmp')}   <project>/tmp (.gitignore, cleaned on start)
+  ${t('help.files.tmp')}   <project>/tmp ${t('help.files.tmp_note')}
   ${t('help.files.config')}      ${CONFIG_PATHS.HOME_CONFIG}
                ${CONFIG_PATHS.PROJECT_CONFIG}
+
+${theme.dim(t('help.toggles_legend'))}
 `);
 }
 function dirLabel(p) {
@@ -1544,6 +1547,11 @@ async function main() {
         });
         editor = ed;
         ed.setTmpDir(TMP_DIR);
+        // Restore the input history from the previous runs and persist every new
+        // entry, so Ctrl+R / arrows can recall older messages after a restart.
+        ed.history = loadHistory();
+        ed._histIndex = ed.history.length;
+        ed.onHistoryChange = (h) => saveHistory(h);
         // The token context right-aligned on the status line (above the input).
         // The editor pulls the number on every render, so it follows the live
         // DeepSeek counter (accumulated_token_usage) without a polling timer.
@@ -2115,8 +2123,29 @@ async function main() {
         const lower = trimmed.toLowerCase();
         if (['/exit', '/quit', 'exit', 'quit'].includes(lower))
             break;
-        if (lower === '/help' || lower === 'help') {
-            printHelp();
+        if (lower === '/help' ||
+            lower === 'help' ||
+            lower.startsWith('/help ') ||
+            lower.startsWith('help ')) {
+            const topic = trimmed.replace(/^\/?help\s*/i, '').trim();
+            if (!topic) {
+                printHelp();
+            }
+            else {
+                // /help <command> — print the full description of ONE command instead
+                // of making the operator scroll the whole list.
+                const q = '/' + topic.replace(/^\//, '').toLowerCase();
+                const match = buildSlashCommands().filter((c) => c.name.toLowerCase() === q ||
+                    c.name.toLowerCase().startsWith(q + ' '));
+                if (!match.length) {
+                    console.error(theme.warn(t('help.no_topic', { v: topic })));
+                }
+                else {
+                    for (const c of match) {
+                        console.log(theme.assistant(c.name) + theme.dim('  ' + c.description));
+                    }
+                }
+            }
             continue;
         }
         if (['/new', '/clear', 'new'].includes(lower)) {
@@ -2414,7 +2443,9 @@ async function main() {
                     const mark = s.id === currentChatId ? theme.user(' *') : '';
                     const title = s.title ? `  ${s.title}` : '';
                     const wd = s.workdir ? theme.dim(`  [${dirLabel(s.workdir)}]`) : '';
-                    console.log(`  ${theme.user(n)}. ${s.id.slice(0, 8)}…${title}${wd}${mark}`);
+                    const age = formatRelativeTime(s.updatedAt, t);
+                    const ageText = age ? theme.dim('  ' + age) : '';
+                    console.log(`  ${theme.user(n)}. ${s.id.slice(0, 8)}…${title}${wd}${ageText}${mark}`);
                 });
                 console.log(theme.system(t('sessions.restore_hint')));
             }

package/dist/input.js

@@ -356,6 +356,16 @@ export class LineEditor {
     _searchQuery;
     _searchIndex;
     _searchSavedBuf;
+    // Called after every submit with the new full history, so the caller can
+    // persist it (the history otherwise dies with the process).
+    onHistoryChange;
+    // Snapshots of {buf, cursor} taken before each edit, so Ctrl+_ can undo a
+    // slip (a fat-fingered Ctrl+U / Ctrl+K used to wipe the whole line with no
+    // way back). Capped so a long session cannot grow it without bound.
+    _undoStack;
+    // True while a run of plain typing is in progress, so one undo snapshot
+    // covers the whole run instead of every character.
+    _typingRun;
     // Slash-command hints (shown when you type «/»).
     slashCommands;
     _suggestCount;
@@ -462,6 +472,9 @@ export class LineEditor {
         this._searchQuery = '';
         this._searchIndex = -1;
         this._searchSavedBuf = '';
+        this.onHistoryChange = null;
+        this._undoStack = [];
+        this._typingRun = false;
         this.slashCommands = commands;
         this._suggestCount = 0;
         this.pastes = [];
@@ -1280,6 +1293,9 @@ export class LineEditor {
         // Add to history only non-empty messages that don't duplicate the previous one.
         if (text.trim() && this.history[this.history.length - 1] !== text) {
             this.history.push(text);
+            // Persist the new entry: the in-memory history dies with the process.
+            if (this.onHistoryChange)
+                this.onHistoryChange(this.history.slice());
         }
         this._histIndex = this.history.length;
         this._histDraft = '';
@@ -1304,6 +1320,26 @@ export class LineEditor {
         if (this.busy)
             this._startThinking();
     }
+    // Record the current buffer for Ctrl+_ undo. `coalesce` keeps one snapshot
+    // for a whole run of plain typing (so undo removes the run, not one char) —
+    // the run ends as soon as a non-typing key is handled.
+    _pushUndo(coalesce = false) {
+        if (coalesce && this._typingRun)
+            return;
+        this._undoStack.push({ buf: this.buf, cursor: this.cursor });
+        if (this._undoStack.length > 200)
+            this._undoStack.shift();
+        this._typingRun = coalesce;
+    }
+    // Ctrl+_ — restore the buffer to before the last edit.
+    _undoEdit() {
+        const prev = this._undoStack.pop();
+        if (!prev)
+            return;
+        this.buf = prev.buf;
+        this.cursor = Math.min(prev.cursor, Array.from(prev.buf).length);
+        this._typingRun = false;
+    }
     _insert(text) {
         const chars = Array.from(this.buf);
         const ins = Array.from(String(text));
@@ -1774,12 +1810,19 @@ export class LineEditor {
                 continue;
             }
             if (code === 21) {
+                this._pushUndo();
                 this.buf = '';
                 this.cursor = 0;
                 this.pastes = [];
                 this._renderInputOnly();
                 continue;
             }
+            if (code === 31) {
+                // Ctrl+_ — undo the last edit in the input line.
+                this._undoEdit();
+                this._renderInputOnly();
+                continue;
+            }
             if (code === 22) {
                 // Ctrl+V: terminals rarely deliver an image as text here, so we try the
                 // OS clipboard first; if there is no image we fall back to reading the
@@ -1793,12 +1836,14 @@ export class LineEditor {
                 continue;
             }
             if (code === 23) {
+                this._pushUndo();
                 this._deleteWordLeft();
                 this._renderInputOnly();
                 continue;
             }
             if (code === 11) {
                 // Ctrl+K — delete from the cursor to the end of the line.
+                this._pushUndo();
                 const arr = Array.from(this.buf);
                 let e = this.cursor;
                 while (e < arr.length && arr[e] !== NL)
@@ -1809,6 +1854,7 @@ export class LineEditor {
                 continue;
             }
             if (code === 127 || code === 8) {
+                this._pushUndo(true);
                 this._backspace();
                 this._renderInputOnly();
                 continue;
@@ -1872,6 +1918,7 @@ export class LineEditor {
                     continue;
                 }
                 if (s.startsWith('[3~')) {
+                    this._pushUndo(true);
                     this._delete();
                     s = s.slice(3);
                     this._renderInputOnly();
@@ -1898,6 +1945,8 @@ export class LineEditor {
             }
             if (code < 32)
                 continue;
+            // Coalesce a run of typing into ONE undo snapshot.
+            this._pushUndo(true);
             this._insert(ch);
             this._renderInputOnly();
         }

package/dist/sessions.js

@@ -132,3 +132,29 @@ export function listSessions() {
 export function sessionsDir() {
     return SESSIONS_DIR;
 }
+// ---------- input history ----------
+// The LineEditor history otherwise dies with the process (it was in-memory
+// only), so the arrow keys / Ctrl+R could not recall anything from a previous
+// run. We persist it in ~/.zames/history.json, capped so the file cannot grow
+// without bound.
+const HISTORY_FILE = path.join(os.homedir(), '.zames', 'history.json');
+const HISTORY_LIMIT = 500;
+export function loadHistory() {
+    try {
+        const raw = JSON.parse(fs.readFileSync(HISTORY_FILE, 'utf-8'));
+        if (!Array.isArray(raw))
+            return [];
+        return raw.filter((x) => typeof x === 'string');
+    }
+    catch {
+        return [];
+    }
+}
+export function saveHistory(history) {
+    try {
+        ensureDir();
+        const trimmed = history.slice(-HISTORY_LIMIT);
+        atomicWriteJson(HISTORY_FILE, trimmed);
+    }
+    catch { }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zames_pro",
-  "version": "2.51.0",
+  "version": "2.52.0",
   "description": "Terminal coding agent over chat.deepseek.com via Playwright",
   "type": "module",
   "bin": {