zames_pro 2.50.2 → 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

@@ -1,29 +1,26 @@
 import path from 'path';
 import { isImageName } from './attachments.js';
+import { translate } from './i18n.js';
 // Helpers for the extra slash commands (/diff, /cost, /export, /doctor,
 // /permissions, /review, /add-dir). Pure functions, unit-tested without a
 // live agent/browser. index.ts only renders their output.
 const NL = String.fromCharCode(10);
 const CR = String.fromCharCode(13);
 // ---------- /diff ----------
-export function formatDiff(diffText, opts = {}) {
+export function formatDiff(diffText, opts = {}, t = translate('en')) {
     const maxLines = opts.maxLines ?? 200;
     const trimmed = String(diffText ?? '')
         .split(CR + NL)
         .join(NL)
         .trimEnd();
     if (!trimmed)
-        return '(no changes)';
+        return t('diff.no_changes');
     const lines = trimmed.split(NL);
     if (lines.length <= maxLines)
         return trimmed;
     const head = lines.slice(0, maxLines).join(NL);
     const rest = lines.length - maxLines;
-    return (head +
-        NL +
-        '... [' +
-        rest +
-        ' more lines, use Bash git diff for the full output]');
+    return head + NL + t('diff.more_lines', { n: String(rest) });
 }
 export function diffGitArgs(staged = false) {
     return staged ? 'git diff --staged' : 'git diff';
@@ -89,30 +86,51 @@ export function formatDuration(ms, units = EN_DURATION_UNITS) {
         return m + units.m + ' ' + pad(s) + units.s;
     return s + units.s;
 }
-export function renderCost(stats, transcriptFile, tokenUsage = null) {
+// 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('Session stats:');
+    lines.push(t('cost.title'));
     if (typeof tokenUsage === 'number') {
-        lines.push(' context: ~' + tokenUsage + ' tokens (DeepSeek accumulated_token_usage)');
+        lines.push(t('cost.context_known', { n: String(tokenUsage) }));
     }
     else {
-        lines.push(' context: unknown (DeepSeek reports it after the first answer in a chat)');
+        lines.push(t('cost.context_unknown'));
     }
-    lines.push(' tasks: ' + stats.turns);
-    lines.push(' tool calls: ' + stats.toolCalls);
+    lines.push(t('cost.tasks', { n: String(stats.turns) }));
+    lines.push(t('cost.tool_calls', { n: String(stats.toolCalls) }));
     if (stats.autoCompacts > 0) {
-        lines.push(' auto-compacts: ' + stats.autoCompacts);
+        lines.push(t('cost.auto_compacts', { n: String(stats.autoCompacts) }));
     }
     const top = Object.entries(stats.toolCounts).sort((a, b) => b[1] - a[1]);
     if (top.length) {
-        lines.push(' by tool:');
+        lines.push(t('cost.by_tool'));
         for (const [name, n] of top)
             lines.push(' ' + name + ': ' + n);
     }
-    lines.push(' duration: ' + formatDuration(stats.durationMs));
+    lines.push(t('cost.duration', { dur: formatDuration(stats.durationMs) }));
     if (stats.startedAt)
-        lines.push(' started: ' + stats.startedAt);
-    lines.push(' transcript: ' + (transcriptFile || '(off)'));
+        lines.push(t('cost.started', { v: stats.startedAt }));
+    lines.push(t('cost.transcript', { v: transcriptFile || t('cost.off') }));
     return lines.join(NL);
 }
 // ---------- /export ----------
@@ -172,64 +190,74 @@ export function defaultExportPath(workdir, now = new Date()) {
         .replace('Z', '');
     return path.join(workdir, 'zames-export-' + stamp + '.md');
 }
-export function renderDoctor(d) {
+export function renderDoctor(d, t = translate('en')) {
     const rows = [];
     const row = (ok, label, value) => {
         rows.push(' ' + (ok ? '[OK] ' : '[WARN]') + ' ' + label.padEnd(16) + ' ' + value);
     };
+    const onoff = (b) => (b ? t('common.on') : t('common.off'));
     row(true, 'node', d.nodeVersion);
     row(true, 'platform', d.platform);
     row(true, 'workdir', d.workdir);
-    row(d.gitOk, 'git', d.gitOk ? 'repo (' + (d.gitBranch || 'detached') + ')' : 'not a repository');
-    row(d.configOk, 'config', d.configOk ? 'loaded' : 'error: ' + (d.configError || 'unknown'));
-    row(true, 'browser', d.browserChannel ? d.browserChannel : 'bundled chromium');
-    row(!!d.authSaved, 'auth', d.authSaved ? 'session saved (auto re-login ready)' : 'no saved session');
-    row(!!d.clipboardTool, 'clipboard', d.clipboardTool || 'no tool found (image paste disabled)');
-    row(true, 'mcp', d.mcpServers + ' server(s), ' + d.mcpTools + ' tool(s)');
-    row(d.transcriptOk, 'transcript', d.transcriptOk ? 'on' : 'off');
+    row(d.gitOk, 'git', d.gitOk
+        ? t('doctor.repo', { v: d.gitBranch || t('doctor.detached') })
+        : t('doctor.not_repo'));
+    row(d.configOk, 'config', d.configOk
+        ? t('doctor.loaded')
+        : t('doctor.error', { v: d.configError || t('doctor.unknown') }));
+    row(true, 'browser', d.browserChannel ? d.browserChannel : t('doctor.bundled'));
+    row(!!d.authSaved, 'auth', d.authSaved ? t('doctor.auth_saved') : t('doctor.auth_none'));
+    row(!!d.clipboardTool, 'clipboard', d.clipboardTool || t('doctor.clipboard_none'));
+    row(true, 'mcp', t('doctor.mcp', {
+        servers: String(d.mcpServers),
+        tools: String(d.mcpTools),
+    }));
+    row(d.transcriptOk, 'transcript', onoff(d.transcriptOk));
     if (typeof d.contextLimit === 'number' && d.contextLimit > 0) {
-        row(true, 'context', d.contextLimit.toLocaleString('en-US') + ' tokens');
+        row(true, 'context', t('doctor.tokens', {
+            v: d.contextLimit.toLocaleString('en-US'),
+        }));
     }
     if (d.gitOk && typeof d.hasOrigin === 'boolean') {
-        row(true, 'git remote', d.hasOrigin ? 'origin configured' : 'no origin');
+        row(true, 'git remote', d.hasOrigin ? t('doctor.origin_ok') : t('doctor.origin_none'));
     }
     if (typeof d.minSendIntervalMs === 'number') {
-        row(d.minSendIntervalMs > 0, 'send pause', Math.round(d.minSendIntervalMs / 1000) + 's between agent sends');
+        row(d.minSendIntervalMs > 0, 'send pause', t('doctor.send_pause', {
+            n: String(Math.round(d.minSendIntervalMs / 1000)),
+        }));
     }
     if (typeof d.sshRemote === 'boolean') {
-        row(true, 'session', d.sshRemote ? 'SSH remote' : 'local terminal');
+        row(true, 'session', d.sshRemote ? t('doctor.ssh') : t('doctor.local'));
     }
     if (d.headless) {
-        row(!!d.headlessUaCached, 'headless', d.headlessUaCached
-            ? 'UA cached (no relaunch)'
-            : 'no cached UA yet (first start relaunches once)');
+        row(!!d.headlessUaCached, 'headless', d.headlessUaCached ? t('doctor.ua_cached') : t('doctor.ua_not_cached'));
     }
-    return 'Doctor:' + NL + rows.join(NL);
+    return t('doctor.title') + NL + rows.join(NL);
 }
-export function renderPermissions(p) {
-    const onoff = (b) => (b ? 'ask' : 'allow');
+export function renderPermissions(p, t = translate('en')) {
+    const onoff = (b) => (b ? t('perm.ask') : t('perm.allow'));
     const lines = [];
-    lines.push('Tool permissions (confirmation settings):');
-    lines.push(' Write: ' + onoff(p.write));
-    lines.push(' Edit: ' + onoff(p.edit));
-    lines.push(' Bash: ' + onoff(p.bash));
+    lines.push(t('perm.title'));
+    lines.push(t('perm.write', { v: onoff(p.write) }));
+    lines.push(t('perm.edit', { v: onoff(p.edit) }));
+    lines.push(t('perm.bash', { v: onoff(p.bash) }));
     if (p.alwaysConfirm.length) {
-        lines.push(' Always confirm (regex):');
+        lines.push(t('perm.always'));
         for (const re of p.alwaysConfirm)
             lines.push(' ' + re);
     }
     lines.push('');
-    lines.push('Change with: /config set confirmation.write false (and .edit / .bash)');
+    lines.push(t('perm.change_hint'));
     return lines.join(NL);
 }
 // ---------- /add-dir ----------
-export function resolveExtraDir(input, workdir) {
+export function resolveExtraDir(input, workdir, t = translate('en')) {
     const raw = String(input ?? '').trim();
     if (!raw)
-        return { error: 'Usage: /add-dir <path>' };
+        return { error: t('adddir.usage') };
     const abs = path.resolve(workdir, raw);
     if (abs === path.resolve(workdir)) {
-        return { error: 'This is already the working directory.' };
+        return { error: t('adddir.same') };
     }
     return { path: abs };
 }

package/dist/config-menu.js

@@ -11,9 +11,9 @@
 import { theme } from './theme.js';
 import { visLen } from './input.js';
 const ESC = String.fromCharCode(27);
-// Strip ANSI sequences to compute the visible length of a line.
+// Strip ANSH sequences to compute the visible length of a line.
 function stripAnsi(s) {
-    return s.replace(/\x1b\[[0-9;?]*[A-Za-z]/g, '');
+    return s.replace(/\x1b\`[0-9;?]*[A-Za-z]/g, '');
 }
 // Visible COLUMNS of a line (ANSI removed, wide chars counted as 2). Using the
 // code-point count made the block height disagree with the real screen on lines
@@ -35,7 +35,7 @@ function displayValue(field, value, t) {
     return String(value);
 }
 function groupLabel(field, t) {
-    return t(field.groupKey);
+    return theme.system('  ' + t(field.groupKey));
 }
 /**
  * Show the interactive menu. Returns a promise that resolves when the
@@ -45,13 +45,20 @@ function groupLabel(field, t) {
 export function runConfigMenu(opts) {
     const input = opts.input || process.stdin;
     const output = opts.output || process.stdout;
-    const { fields, t, get, set, reset } = opts;
+    const { fields, t, get, set, reset, getDefault } = opts;
     if (!input.isTTY || !input.setRawMode) {
         return Promise.reject(new Error(t('cfg.menu.notty')));
     }
+    // cursor indexes the VISIBLE (filtered) list, not the full `fields`.
     let cursor = 0;
     let editing = false;
     let editBuf = '';
+    // Reverse/forward filter over the list (/ to enter, typing narrows it).
+    let filterMode = false;
+    let filterQuery = '';
+    // Second `d` on the same row confirms the reset, so a stray keypress
+    // cannot wipe a setting by accident.
+    let pendingReset = null;
     let message = null;
     let exited = false;
     let resolveDone = null;
@@ -59,18 +66,53 @@ export function runConfigMenu(opts) {
     input.setRawMode(true);
     input.resume();
     output.write(ESC + '[?25l'); // hide the cursor while rendering
+    // Fields that match the current filter (path, label or group contains the
+    // query, case-insensitive). Empty query -> everything.
+    const visible = () => {
+        const q = filterQuery.trim().toLowerCase();
+        if (!q)
+            return fields;
+        return fields.filter((f) => (f.path + ' ' + t(f.labelKey || f.path) + ' ' + t(f.groupKey))
+            .toLowerCase()
+            .includes(q));
+    };
+    const currentField = () => {
+        const vis = visible();
+        if (!vis.length)
+            return null;
+        if (cursor >= vis.length)
+            cursor = vis.length - 1;
+        return vis[cursor];
+    };
+    // True when the value differs from the default (the field is overridden
+    // in a config file), so the menu can mark it. Skipped with no getDefault.
+    const isModified = (f) => {
+        if (!getDefault)
+            return false;
+        const cur = get(f.path);
+        const def = getDefault(f.path);
+        try {
+            return JSON.stringify(cur) !== JSON.stringify(def);
+        }
+        catch {
+            return String(cur) !== String(def);
+        }
+    };
     // Menu rendering: lines go top to bottom, and we return the cursor to the
     // start of the block via relative moves so we don't spawn blank lines.
     let lastRows = 0;
     const render = () => {
         const lines = [];
         lines.push(theme.bold(t('cfg.menu.title')));
+        const vis = visible();
+        if (cursor >= vis.length)
+            cursor = Math.max(0, vis.length - 1);
         let lastGroup = '';
-        for (let i = 0; i < fields.length; i++) {
-            const f = fields[i];
+        for (let i = 0; i < vis.length; i++) {
+            const f = vis[i];
             const g = groupLabel(f, t);
             if (g !== lastGroup) {
-                lines.push(theme.system('  ' + g));
+                lines.push(g);
                 lastGroup = g;
             }
             const selected = i === cursor;
@@ -80,21 +122,38 @@ export function runConfigMenu(opts) {
                 : t(f.labelKey || f.path);
             const val = displayValue(f, get(f.path), t);
             const valText = selected ? theme.assistant(val) : theme.dim(val);
+            const mod = isModified(f) ? theme.warn('*') : '';
             const pathText = selected ? theme.dim('  ' + f.path) : '';
-            lines.push(marker + label + theme.dim('  =  ') + valText + pathText);
+            lines.push(marker + label + theme.dim('  =  ') + valText + mod + pathText);
+        }
+        if (!vis.length) {
+            lines.push(theme.dim('  ' + t('cfg.menu.no_match')));
         }
         if (editing) {
             lines.push('');
             lines.push(theme.user(t('cfg.menu.edit_hint')));
             lines.push(theme.prompt('\u276f ') + editBuf);
         }
+        else if (filterMode) {
+            lines.push('');
+            lines.push(theme.user(t('cfg.menu.filter_hint')));
+            lines.push(theme.prompt('\u276f ') + filterQuery);
+        }
         else if (message) {
             lines.push('');
             lines.push(theme.assistant(message));
         }
         else {
             lines.push('');
-            lines.push(theme.dim(t('cfg.menu.hint')));
+            if (filterQuery) {
+                lines.push(theme.dim(t('cfg.menu.filter_active', { q: filterQuery }) +
+                    '  ' +
+                    t('cfg.menu.hint')));
+            }
+            else {
+                lines.push('  ' + theme.dim(t('cfg.menu.hint')));
+                lines.push('  ' + theme.dim(t('cfg.menu.filter_hint')));
+            }
         }
         // Erase the previous block and print the new one. We count VISUAL lines
         // (accounting for wrapping by terminal width), otherwise on narrow
@@ -134,12 +193,12 @@ export function runConfigMenu(opts) {
             lastRows = 0;
         }
     };
-    const cleanup = (clearOnExit = false) => {
+    const cleanup = (cleanOnExit = false) => {
         if (exited)
             return;
         exited = true;
         input.removeListener('data', onData);
-        if (clearOnExit)
+        if (cleanOnExit)
             clearBlock();
         if (input.setRawMode)
             input.setRawMode(wasRaw || false);
@@ -148,10 +207,12 @@ export function runConfigMenu(opts) {
             resolveDone();
     };
     const commitEdit = () => {
-        const f = fields[cursor];
+        const f = currentField();
         const raw = editBuf.trim();
         editing = false;
         editBuf = '';
+        if (!f)
+            return;
         if (!raw) {
             message = null;
             return;
@@ -168,7 +229,9 @@ export function runConfigMenu(opts) {
         }
     };
     const toggle = () => {
-        const f = fields[cursor];
+        const f = currentField();
+        if (!f)
+            return;
         if (f.type === 'boolean') {
             const cur = get(f.path);
             set(f, cur === true ? 'false' : 'true');
@@ -218,20 +281,49 @@ export function runConfigMenu(opts) {
             render();
             return;
         }
+        // Filter mode (/): printable keys build the query, Esc/Enter leave it
+        // (keeping the query active), Ctrl+C exits the whole menu.
+        if (filterMode) {
+            for (const ch of s) {
+                if (ch === '\r' || ch === '\n' || ch === ESC) {
+                    filterMode = false;
+                    break;
+                }
+                if (ch === '\x03') {
+                    cleanup(true);
+                    return;
+                }
+                if (ch === '\x7f' || ch === '\b') {
+                    filterQuery = filterQuery.slice(0, -1);
+                }
+                else if (ch >= ' ') {
+                    filterQuery += ch;
+                }
+            }
+            cursor = 0;
+            render();
+            return;
+        }
         // The terminal may send several keys in one packet (fast typing,
         // auto-repeat, automation). We parse the buffer into tokens: first
         // escape sequences (arrows), then single characters.
         let i = 0;
         while (i < s.length) {
             if (s.startsWith('\x1b[A', i)) {
-                cursor = (cursor - 1 + fields.length) % fields.length;
+                const n = visible().length;
+                if (n > 0)
+                    cursor = (cursor - 1 + n) % n;
                 message = null;
+                pendingReset = null;
                 i += 3;
                 continue;
             }
             if (s.startsWith('\x1b[B', i)) {
-                cursor = (cursor + 1) % fields.length;
+                const n = visible().length;
+                if (n > 0)
+                    cursor = (cursor + 1) % n;
                 message = null;
+                pendingReset = null;
                 i += 3;
                 continue;
             }
@@ -242,21 +334,51 @@ export function runConfigMenu(opts) {
                 cleanup(true);
                 return;
             }
-            if (ch === 'k') {
-                cursor = (cursor - 1 + fields.length) % fields.length;
+            if (ch === '/') {
+                filterMode = true;
+                message = null;
+                // The rest of THIS packet belongs to the filter query (typing " /debug"
+                // arrives as one chunk, and without this the trailing characters fell
+                // through to the command keys — 'd' armed a reset instead of filtering).
+                for (const rest of s.slice(i + 1)) {
+                    if (rest === '\x7f' || rest === '\b') {
+                        filterQuery = filterQuery.slice(0, -1);
+                    }
+                    else if (rest >= ' ') {
+                        filterQuery += rest;
+                    }
+                }
+                cursor = 0;
+                i = s.length;
+            }
+            else if (ch === 'k') {
+                const n = visible().length;
+                if (n > 0)
+                    cursor = (cursor - 1 + n) % n;
                 message = null;
             }
             else if (ch === 'j') {
-                cursor = (cursor + 1) % fields.length;
+                const n = visible().length;
+                if (n > 0)
+                    cursor = (cursor + 1) % n;
                 message = null;
             }
             else if (ch === '\r' || ch === '\n' || ch === ' ') {
                 toggle();
             }
             else if (ch === 'd' || ch === 'D') {
-                const f = fields[cursor];
-                reset(f);
-                message = t('cfg.reset', { v: f.path });
+                const f = currentField();
+                if (f) {
+                    if (pendingReset === f.path) {
+                        reset(f);
+                        message = t('cfg.reset', { v: f.path });
+                        pendingReset = null;
+                    }
+                    else {
+                        pendingReset = f.path;
+                        message = t('cfg.menu.reset_confirm', { v: f.path });
+                    }
+                }
             }
             i++;
         }