newmark-agent 0.4.2 → 0.4.4

package/dist/providers/provider-adapter.d.ts

@@ -52,7 +52,9 @@ export interface NormalizedAgentRequest {
     tools: NormalizedTool[];
     temperature: number;
     maxOutputTokens: number;
-    reasoningEffort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+    /** dev-0.4.3：模型原生思考强度档位名。Newmark 档位经模型配置
+     *  `thinking_tier_map` 映射后可能不再是 Newmark 档位名，故为自由字符串。 */
+    reasoningEffort?: string;
     apiKey: string;
     baseUrl: string;
     /** 可选的会话标识。仅当目标 provider 显式支持 session_id 语义的上下文缓存

package/dist/tools/index.js

@@ -350,7 +350,7 @@ class ToolExecutor {
             t('subagent_result', 'Return the persisted transcript, mailbox summary, status, and latest result for a peer agent. Target by exact id (preferred) or name.', { id: { type: 'string', description: 'Exact peer id from subagent_list.' }, name: { type: 'string', description: 'Convenience peer name.' } }, []),
             t('subagent_close', 'Close a same-conversation peer. Root can close any peer; a peer can close only itself. Target by exact id (preferred) or name.', { id: { type: 'string', description: 'Exact peer id from subagent_list.' }, name: { type: 'string', description: 'Convenience peer name.' } }, []),
             t('linked_plan', 'Read or update the current conversation linked Markdown plan. Update requires the current expected_revision.', { action: { type: 'string', enum: ['get', 'update'] }, markdown: { type: 'string' }, expected_revision: { type: 'number' } }, ['action']),
-            t('build_history_query', 'Read the concrete public work details of one historical Build Block. The prompt already exposes user input, final summary, and completion status; call this read-only tool only when the user asks what specifically happened. Select by newest-to-oldest history_index, or by run_id returned from an earlier query. Every activity/guide content is bounded to max_chars (default 2000) to keep the read lean and cache-friendly.', { history_index: { type: 'number', minimum: 1, description: '1-based historical Build Block index from the request ledger; 1 is the newest previous task.' }, run_id: { type: 'string', description: 'Exact run id returned by an earlier build_history_query result.' }, max_events: { type: 'number', minimum: 1, maximum: 200, description: 'Maximum trailing public work events; defaults to 80.' }, max_chars: { type: 'number', minimum: 100, maximum: 4000, description: 'Per-event/per-guide content character bound; defaults to 2000.' } }, []),
+            t('build_history_query', 'Read the concrete public work details (tool calls, results, file changes, guides) of one historical Build Block. Call it proactively when the current task continues, fixes, verifies, or depends on earlier work: reuse the returned activity instead of re-investigating from scratch. Do not call it merely to answer completion status already exposed by the prompt. Select by newest-to-oldest history_index, or by run_id returned from an earlier query. Every activity/guide content is bounded to max_chars (default 2000) to keep the read lean and cache-friendly.', { history_index: { type: 'number', minimum: 1, description: '1-based historical Build Block index from the request ledger; 1 is the newest previous task.' }, run_id: { type: 'string', description: 'Exact run id returned by an earlier build_history_query result.' }, max_events: { type: 'number', minimum: 1, maximum: 200, description: 'Maximum trailing public work events; defaults to 80.' }, max_chars: { type: 'number', minimum: 100, maximum: 4000, description: 'Per-event/per-guide content character bound; defaults to 2000.' } }, []),
             t('context_compress', 'Actively compress the LLM context history for this conversation. This collapses older history entries into a concise summary while preserving the recent tail, which reduces context tokens and cost. IMPORTANT: it affects only the LLM context (what the model sees); the displayed conversation history shown to the user is never altered. Call this when the conversation is long, token pressure is high, or you judge that older turns are no longer needed in full. Idempotent and safe: repeated calls produce incremental summaries.', { keep_recent: { type: 'number', minimum: 2, maximum: 60, description: 'Recent message count to keep uncompressed at the tail. Defaults to the configured keep_recent_messages.' }, force: { type: 'boolean', description: 'Compress even if the context is not yet over the automatic threshold. Defaults to false.' } }, []),
             t('context_history_manage', 'Manage the LLM context history for this conversation without affecting the displayed conversation history. This is the active context-management surface. The hot cache stays bounded; evicted folded segments remain in a conversation-isolated append-only cold archive and are loaded only by explicit search/read/restore calls. Actions: list returns a bounded index of current context entries; remove declares one long-term entry for unload (see below); summarize folds a contiguous current range; restore reinserts a folded segment when its summary marker is still present; search finds matching hot or archived segments; read returns one bounded segment without injecting the whole archive; status reports budgets, hot cache, cold archive, the protected recent zone, and pending removals. The recent context tail and last user message are protected from remove/summarize unless dangerous is true. For cache-optimization, remove ONLY targets long-term history (never the protected recent tail or last user message) and does NOT unload immediately: the declared entry stays in context for the rest of the current Build Block so the provider prefix cache stays stable, then is physically removed when the Block ends — applying to subsequent Blocks only.', {
                 action: { type: 'string', enum: ['list', 'remove', 'summarize', 'restore', 'search', 'read', 'status'], description: 'list current entries; remove one; summarize a range; restore by restore_id; search hot/cold folded segments; read one bounded folded segment; status report context budgets and storage.' },
@@ -372,7 +372,9 @@ class ToolExecutor {
             t('background_tool', 'Run a tool call in the background WITHOUT blocking the conversation turn. Pass the target tool name and its arguments; this tool returns a background_id IMMEDIATELY, and the real tool keeps running in the background. The result is persisted and can be retrieved later with read_tool_result. Use this for long-running or non-critical tools (bash, web_fetch, long read/grep) so the conversation continues without waiting. The background result stays OUT of context until you explicitly read it, preserving prompt-cache hit rate. Orchestration/flow/subagent/question tools cannot be backgrounded.', { tool: { type: 'string', description: 'The tool name to run in the background (e.g. bash, web_fetch, read, grep).' }, args: { type: 'object', description: 'The arguments object for the target tool, matching its normal schema.' } }, ['tool']),
             t('read_tool_result', 'Read the result of a background tool. Pass the background_id returned by background_tool. When status is running, returns a running marker; when done, returns the persisted result (optionally release it from storage after reading); when error, returns the failure. Background results are released from storage only when you set release=true.', { background_id: { type: 'string', description: 'The background_id returned by background_tool.' }, release: { type: 'boolean', description: 'Set true to release the persisted result from storage after reading it.' } }, ['background_id']),
             t('goal_manage', 'Actively manage the persistent Goal state for this conversation. You may enter Goal mode, update (edit) its objective, mark it complete, or exit Goal mode yourself. Call this when the user asks you to pursue a persistent objective, when the objective changes, when you have verified the objective is genuinely achieved, or when you judge the Goal is no longer needed and should be cleared. This is the agent-side state control that mirrors the GUI goal panel controls. enter/update require objective; complete marks the objective verified and exits Goal mode; exit clears the Goal (and returns to Build mode) without claiming completion.', { action: { type: 'string', enum: ['enter', 'update', 'complete', 'exit'], description: 'enter=enter Goal mode and set the objective; update=edit the objective (records a change); complete=mark the objective verified-achieved and exit Goal mode; exit=clear the Goal and return to Build mode without claiming completion.' }, objective: { type: 'string', description: 'The Goal objective text. Required for enter and update.' }, reason: { type: 'string', description: 'Optional one-line reason for the state change, recorded for audit.' } }, ['action']),
-            t('conversation_rename', 'Rename the CURRENT conversation to a concise, descriptive title you choose. On the FIRST Build Block of a NEW conversation the runtime asks you to call this once so the conversation list shows a meaningful name instead of an auto-generated one. Keep the title short (a few words) and cache-friendly: a concrete noun phrase describing the task, never a sentence or quoted prompt.', { title: { type: 'string', description: 'The new conversation title (a short noun phrase, e.g. "Fix TUI color leak", "Add goal_manage tool").' } }, ['title']),
+            t('task_read', 'Read the persistent inline task checklist of the CURRENT conversation (the same list the GUI Task panel and TUI plan view render). Returns bounded items (id, status, task text <=240 chars) plus unfinished count. Read-only and side-effect free; call this whenever you need concrete task-list state instead of assuming it. Kept out of the system prompt so provider prefix caching stays stable.', {}, []),
+            t('task_create', 'Maintain the persistent inline task checklist of the CURRENT conversation. This is the durable replacement for ephemeral in-reply checklists: items you create here appear in the GUI Task panel and TUI plan view immediately and persist across Build Blocks. Actions: create appends one task item; update changes status (pending|in_progress|done) or text of one item by id or index; clear removes completed items. Use create when starting a multi-step task, update as each item progresses, and update status=done when verified. Returns a compact confirmation, never the full list.', { action: { type: 'string', enum: ['create', 'update', 'clear'], description: 'create=append a task item; update=change one item status/text; clear=remove completed items.' }, task: { type: 'string', description: 'Task text for create, or new text for update. Short actionable label (<=400 chars).' }, text: { type: 'string', description: 'Alias of task.' }, id: { type: 'string', description: 'Item id from task_read for update.' }, index: { type: 'number', description: '0-based item index for update (alternative to id).' }, status: { type: 'string', enum: ['pending', 'in_progress', 'done', 'blocked'], description: 'New status for update; blocked is stored as pending.' } }, ['action']),
+            t('conversation_rename', 'Rename the CURRENT conversation to a concise, descriptive title you choose. Use this when the user asks to rename the conversation or when the current auto-generated title no longer describes the work. Keep the title short (a few words) and cache-friendly: a concrete noun phrase describing the task, never a sentence or quoted prompt.', { title: { type: 'string', description: 'The new conversation title (a short noun phrase, e.g. "Fix TUI color leak", "Add goal_manage tool").' } }, ['title']),
             t('question', 'Ask user a multiple-choice question', { questions: { type: 'array' } }, ['questions']),
             t('skill_download', 'Download a skill', { name: { type: 'string' }, source: { type: 'string' } }, ['name', 'source']),
             t('skill', 'Search enabled skill metadata or load one exact skill body on demand. Use query when unsure, then name to load the selected skill.', { query: { type: 'string', maxLength: 200 }, name: { type: 'string', maxLength: 200 } }, []),

package/dist/tui/src/app.js

@@ -51,8 +51,10 @@ const ESC = "\u001b[";
 function createPaintScheduler(state, output = process.stdout, renderFrame = render) {
   let pending = false;
   let lastFrame = "";
+  let cancelled = false;
   const flush = () => {
     pending = false;
+    if (cancelled) return;
     const frame = renderFrame(state);
     if (frame === lastFrame) return false;
     lastFrame = frame;
@@ -65,6 +67,8 @@ function createPaintScheduler(state, output = process.stdout, renderFrame = rend
     setImmediate(flush);
   };
   paint.flush = flush;
+  // 退出前调用：丢弃任何排队中的重绘，避免恢复主屏后又被画上一帧 TUI 画面。
+  paint.cancel = () => { cancelled = true; pending = false; };
   return paint;
 }
 
@@ -108,6 +112,28 @@ function resolveTuiWorkspacePath(args, options = {}) {
   return explicitRoot || process.cwd();
 }
 
+// 在 Windows 传统控制台（ConHost）下，输出句柄默认不启用
+// ENABLE_VIRTUAL_TERMINAL_PROCESSING，导致备用屏 ?1049h / 清屏 2J 等 ANSI
+// 序列不被解析，主屏保留滚动历史（滚轮能滚回旧帧）。Electron-as-node sidecar
+// 也不会像纯 Node 那样由 libuv 自动启用 VT。这里主动给输出句柄启用 VT 处理，
+// 给输入句柄启用原始输入，作为 main.ts 之外入口的保险。
+function enableWindowsVirtualTerminal() {
+  if (process.platform !== 'win32') return;
+  try {
+    const { spawnSync } = require('node:child_process');
+    const script = [
+      'Add-Type -TypeDefinition \'using System; using System.Runtime.InteropServices; public static class NewmarkTuiVT { [DllImport("kernel32.dll")] public static extern IntPtr GetStdHandle(int n); [DllImport("kernel32.dll")] public static extern bool GetConsoleMode(IntPtr h, out uint m); [DllImport("kernel32.dll")] public static extern bool SetConsoleMode(IntPtr h, uint m); }\'',
+      '$o = [NewmarkTuiVT]::GetStdHandle(-11); $om = [uint32]0; if ([NewmarkTuiVT]::GetConsoleMode($o, [ref]$om)) { [NewmarkTuiVT]::SetConsoleMode($o, ($om -bor 4)) | Out-Null }',
+      '$i = [NewmarkTuiVT]::GetStdHandle(-10); $im = [uint32]0; if ([NewmarkTuiVT]::GetConsoleMode($i, [ref]$im)) { [NewmarkTuiVT]::SetConsoleMode($i, (($im -band (-bnot 7)) -bor 512)) | Out-Null }',
+    ].join('; ');
+    spawnSync('powershell.exe', ['-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-Command', script], {
+      stdio: 'ignore',
+      windowsHide: true,
+      timeout: 3000,
+    });
+  } catch {}
+}
+
 function start(options = {}) {
   const forcedTerminal = process.env.NEWMARK_FORCE_TTY === "1";
   if ((!process.stdin.isTTY || !process.stdout.isTTY) && !forcedTerminal) {
@@ -115,6 +141,9 @@ function start(options = {}) {
     process.exitCode = 1;
     return;
   }
+  // 备用屏依赖输出句柄的 VT 处理；纯 Node 的 libuv 会自动启用，但
+  // Electron-as-node sidecar 或强制 TTY 路径不会，这里补上。
+  if (forcedTerminal || !process.stdout.isTTY) enableWindowsVirtualTerminal();
 
   const args = process.argv.slice(2);
   let adapter;
@@ -140,24 +169,38 @@ function start(options = {}) {
   let timer = null;
   let animationTimer = null;
   let closing = false;
+  // 标准 TUI 屏幕模型：进入备用屏幕缓冲（alternate screen buffer）。
+  // 备用屏没有主屏的滚动历史：每次刷新用 2J 全量重绘而不是滚动新页面，
+  // 鼠标滚轮无法滚回上一次刷新，终端滚动也不会让画面错位（否则高亮行
+  // 会随终端滚动"离开屏幕"）。
+  const enterAltScreen = () => process.stdout.write(`${ESC}?1049h${ESC}?25l${ESC}2J${ESC}H`);
+  const leaveAltScreen = () => `${ESC}?25h${ESC}?1049l${ESC}0m${ESC}2J${ESC}H`;
   const paint = createPaintScheduler(state);
   const cleanup = () => {
     if (timer) clearInterval(timer);
     if (animationTimer) clearInterval(animationTimer);
     if (typeof process.stdin.setRawMode === "function") process.stdin.setRawMode(false);
     process.stdin.pause();
-    process.stdout.write(`${ESC}?25h${ESC}0m${ESC}2J${ESC}H`);
   };
   const quit = () => {
     if (closing) return;
     closing = true;
+    paint.cancel();
     cleanup();
     if (typeof state.adapter.close === "function") state.adapter.close();
-    process.stdout.write(state.adapterKind === "mock"
-      ? "Newmark TUI demo closed. No state was saved.\n"
-      : "Newmark TUI closed. Conversation and settings state are persisted by Newmark.\n");
+    // 退出序列与关闭消息用 fs.writeSync 同步写入 fd：直接进入内核管道，
+    // 不经过异步流缓冲，process.exit() 不会丢弃任何字节（此前异步 write
+    // 在退出瞬间被 ConPTY/管道丢弃，导致恢复主屏后看不到退出消息）。
+    try {
+      const fs = require("node:fs");
+      const fd = process.stdout.fd || 1;
+      fs.writeSync(fd, `${leaveAltScreen()}\n`);
+      fs.writeSync(fd, state.adapterKind === "mock"
+        ? "Newmark TUI demo closed. No state was saved.\n"
+        : "Newmark TUI closed. Conversation and settings state are persisted by Newmark.\n");
+    } catch {}
     process.exitCode = 0;
-    setImmediate(() => process.exit(0));
+    process.exit(0);
   };
 
   function simulateReply(text) {
@@ -554,8 +597,10 @@ function start(options = {}) {
   process.stdin.resume();
   process.stdin.on("keypress", handleKey);
   process.stdout.on("resize", paint);
-  process.on("exit", () => process.stdout.write(`${ESC}?25h${ESC}0m`));
+  // 兜底：任何退出路径（包括未捕获异常后的 exit 事件）都恢复主屏缓冲与光标。
+  process.on("exit", () => process.stdout.write(`${ESC}?25h${ESC}?1049l${ESC}0m`));
   process.on("SIGTERM", quit);
+  enterAltScreen();
   paint();
 }
 

package/dist/tui/src/data.js

@@ -204,6 +204,34 @@ const providers = [
   }
 ];
 
+// Demo-only long-list injection: NEWMARK_TUI_DEMO_MODELS=<count> appends a
+// dedicated stress provider with <count> models so the featureless --demo TUI
+// can exercise long model-selection cursor-follow behavior without any runtime.
+const DEMO_MODEL_COUNT = Number(process.env.NEWMARK_TUI_DEMO_MODELS || 0);
+if (Number.isFinite(DEMO_MODEL_COUNT) && DEMO_MODEL_COUNT > 0) {
+  providers.push({
+    id: "provider-demo-stress",
+    name: "Demo Stress",
+    base_url: "https://demo.invalid/v1",
+    api_key: "",
+    has_api_key: false,
+    protocol: "openai",
+    enabled: true,
+    models: Array.from({ length: DEMO_MODEL_COUNT }, (_, index) => ({
+      name: `demo-stress-model-${String(index).padStart(3, "0")}`,
+      display: `Stress Model ${String(index).padStart(3, "0")}`,
+      description: `Long-list cursor-follow stress model ${index} description`,
+      max_tokens: 128000,
+      vision: false,
+      thinking: false,
+      enabled: true,
+      speed_rating: "unknown",
+      capability_rating: "unknown",
+      validation: { status: "unavailable", level: "discovered", checked_at: "" }
+    }))
+  });
+}
+
 const flows = [
   {
     name: "release-readiness",

package/dist/tui/src/render.js

@@ -430,19 +430,28 @@ function chatView(state, width, height, p) {
     `${p.bold}Conversations${p.reset}`,
     `${p.muted}N new${p.reset}`,
     "",
-    ...state.snapshot.conversations.map((item, i) => {
-      const style = state.focusRegion === "content" && i === state.selected && !state.inputMode ? `${p.selected}${p.bold}` : "";
-      const running = state.runningConversationKeys?.has(`${state.target.workspaceId}::${item.id}`);
-      const marker = running
-        ? `${p.cyan}${["\\", "—", "/", "—"][state.tick % 4]}${p.reset}`
-        : item.title === state.lastConversation
-          ? `${p.cyan}›${p.reset}`
-          : item.pinned
-            ? `${p.amber}◆${p.reset}`
-            : "·";
-      const updated = String(item.updatedAt || "").slice(11, 16) || "—";
-      return `${style}${marker} ${pad(item.title, 19)} ${p.muted}${updated}${p.reset}`;
-    })
+    ...(() => {
+      const conversationRows = state.snapshot.conversations.map((item, i) => {
+        const style = state.focusRegion === "content" && i === state.selected && !state.inputMode ? `${p.selected}${p.bold}` : "";
+        const running = state.runningConversationKeys?.has(`${state.target.workspaceId}::${item.id}`);
+        const marker = running
+          ? `${p.cyan}${["\\", "—", "/", "—"][state.tick % 4]}${p.reset}`
+          : item.title === state.lastConversation
+            ? `${p.cyan}›${p.reset}`
+            : item.pinned
+              ? `${p.amber}◆${p.reset}`
+              : "·";
+        const updated = String(item.updatedAt || "").slice(11, 16) || "—";
+        return `${style}${marker} ${pad(item.title, 19)} ${p.muted}${updated}${p.reset}`;
+      });
+      const listViewport = Math.max(1, height - 3);
+      const listMaxScroll = Math.max(0, conversationRows.length - listViewport);
+      let listScroll = Math.max(0, Math.min(listMaxScroll, Number(state.conversationListScroll) || 0));
+      if (state.selected < listScroll) listScroll = state.selected;
+      else if (state.selected >= listScroll + listViewport) listScroll = state.selected - listViewport + 1;
+      state.conversationListScroll = Math.max(0, Math.min(listMaxScroll, listScroll));
+      return conversationRows.slice(state.conversationListScroll, state.conversationListScroll + listViewport);
+    })()
   ] : [];
   const preview = state.snapshot.conversations[state.selected] || state.snapshot.conversations[0] || {
     id: state.target.conversationId,
@@ -680,29 +689,34 @@ function modelView(state, width, p) {
   const isCurrent = (selection) => selection.kind === current.kind
     && (selection.kind === "auto"
       || (selection.providerId === current.providerId && selection.modelId === current.modelId));
-  return [
+  const rows = [
     ...conversationContext(state, p, "Model and reasoning effort"),
-    `${p.bold}${tr(state, "Reasoning effort")}${p.reset}   ${p.muted}${tr(state, "Shared GUI/TUI request tier · ←/→ changes section")}${p.reset}`,
-    ...INTELLIGENCE_TIERS.map((tier, index) => {
-      const style = state.focusRegion === "content" && state.contentColumn === 0 && index === state.selected ? `${p.selected}${p.bold}` : "";
-      if (style) state.contentFocusLine = 5 + index;
-      return `${style} ${tier === currentTier ? `${p.cyan}●${p.reset}` : "○"} ${tier}${p.reset}`;
-    }),
+    `${p.bold}${tr(state, "Reasoning effort")}${p.reset}   ${p.muted}${tr(state, "Shared GUI/TUI request tier · ←/→ changes section")}${p.reset}`
+  ];
+  const tierStart = rows.length;
+  INTELLIGENCE_TIERS.forEach((tier, index) => {
+    const style = state.focusRegion === "content" && state.contentColumn === 0 && index === state.selected ? `${p.selected}${p.bold}` : "";
+    if (style) state.contentFocusLine = tierStart + index;
+    rows.push(`${style} ${tier === currentTier ? `${p.cyan}●${p.reset}` : "○"} ${tier}${p.reset}`);
+  });
+  rows.push(
     "",
     `${p.bold}${tr(state, "Deployment")}${p.reset}   ${p.muted}${tr(state, "Used by this conversation, including its Plan and Subagents")}${p.reset}`,
-    "",
-    ...options.flatMap((option, index) => {
-      const style = state.focusRegion === "content" && state.contentColumn === 1 && index === state.selected ? `${p.selected}${p.bold}` : "";
-      if (style) state.contentFocusLine = 14 + index * 2;
-      const marker = isCurrent(option.selection) ? `${p.cyan}●${p.reset}` : "○";
-      return [
-        `${style} ${marker} ${pad(option.label, Math.max(18, Math.min(32, width - 24)))} ${p.muted}${option.provider}${p.reset}`,
-        `   ${p.muted}${truncate(option.description, Math.max(20, width - 5))}${p.reset}`
-      ];
-    }),
+    ""
+  );
+  const deploymentStart = rows.length;
+  options.forEach((option, index) => {
+    const style = state.focusRegion === "content" && state.contentColumn === 1 && index === state.selected ? `${p.selected}${p.bold}` : "";
+    if (style) state.contentFocusLine = deploymentStart + index * 2;
+    const marker = isCurrent(option.selection) ? `${p.cyan}●${p.reset}` : "○";
+    rows.push(`${style} ${marker} ${pad(option.label, Math.max(18, Math.min(32, width - 24)))} ${p.muted}${option.provider}${p.reset}`);
+    rows.push(`   ${p.muted}${truncate(option.description, Math.max(20, width - 5))}${p.reset}`);
+  });
+  rows.push(
     "",
     `${p.muted}${tr(state, "Enter applies the focused tier or deployment. Effort persists globally; deployments remain per conversation.")}${p.reset}`
-  ];
+  );
+  return rows;
 }
 
 function flowBarView(state, width, p) {
@@ -736,20 +750,19 @@ function flowListView(state, width, p) {
 
 function flowTaskView(state, width, p) {
   const components = state.currentFlow?.components || [];
-  return [
+  const rows = [
     ...conversationContext(state, p, "Flow task"),
     `${p.bold}${tr(state, "Flow Task")}${p.reset}   ${p.muted}${state.currentFlow?.name || "No workflow"}${p.reset}`,
-    "",
-    ...components.flatMap((component, index) => {
-      const style = state.focusRegion === "content" && index === state.selected ? `${p.selected}${p.bold}` : "";
-      if (style) state.contentFocusLine = 6 + index * 2;
-      const mode = component.type === "logic" ? "LOGIC" : String(component.mode || "BUILD").toUpperCase();
-      return [
-        `${style} ${String(component.id).padStart(2)}  ${pad(mode, 7)} ${truncate(component.prompt, Math.max(18, width - 16))}`,
-        component.type === "logic" ? `     ${p.muted}true → ${component.goto_true} · false → ${component.goto_false}${p.reset}` : ""
-      ].filter(Boolean);
-    })
+    ""
   ];
+  components.forEach((component, index) => {
+    const style = state.focusRegion === "content" && index === state.selected ? `${p.selected}${p.bold}` : "";
+    if (style) state.contentFocusLine = rows.length;
+    const mode = component.type === "logic" ? "LOGIC" : String(component.mode || "BUILD").toUpperCase();
+    rows.push(`${style} ${String(component.id).padStart(2)}  ${pad(mode, 7)} ${truncate(component.prompt, Math.max(18, width - 16))}`);
+    if (component.type === "logic") rows.push(`     ${p.muted}true → ${component.goto_true} · false → ${component.goto_false}${p.reset}`);
+  });
+  return rows;
 }
 
 function toolsView(state, width, p) {
@@ -1143,11 +1156,19 @@ function overlayLines(state, width, p) {
   }
   if (state.overlay === "palette") {
     const commands = filteredCommands(state);
+    const paletteViewport = Math.min(7, Math.max(1, commands.length));
+    const paletteMaxScroll = Math.max(0, commands.length - paletteViewport);
+    let paletteScroll = Math.max(0, Math.min(paletteMaxScroll, Number(state.paletteScroll) || 0));
+    if (state.paletteIndex < paletteScroll) paletteScroll = state.paletteIndex;
+    else if (state.paletteIndex >= paletteScroll + paletteViewport) paletteScroll = state.paletteIndex - paletteViewport + 1;
+    state.paletteScroll = Math.max(0, Math.min(paletteMaxScroll, paletteScroll));
+    const visibleCommands = commands.slice(state.paletteScroll, state.paletteScroll + paletteViewport);
     const rows = [
       `${p.bold}>${p.reset} ${state.paletteQuery}${p.cyan}▏${p.reset}`,
       `${p.muted}${"─".repeat(Math.max(8, Math.min(64, width - 10)))}${p.reset}`,
-      ...(commands.length ? commands.slice(0, 7).map((command, i) => {
-        const style = i === state.paletteIndex ? `${p.selected}${p.bold}` : "";
+      ...(visibleCommands.length ? visibleCommands.map((command, i) => {
+        const commandIndex = state.paletteScroll + i;
+        const style = commandIndex === state.paletteIndex ? `${p.selected}${p.bold}` : "";
         return `${style} ${pad(command.label, Math.max(18, Math.min(52, width - 18)))} ${p.muted}${command.hint}${p.reset}`;
       }) : [`${p.muted} No matching commands${p.reset}`]),
       "",
@@ -1156,14 +1177,22 @@ function overlayLines(state, width, p) {
     return card(rows, Math.min(72, width - 4), p, "Command palette");
   }
   if (state.overlay === "flow-select") {
+    const flowViewport = Math.min(7, Math.max(1, state.flows.length));
+    const flowMaxScroll = Math.max(0, state.flows.length - flowViewport);
+    let flowScroll = Math.max(0, Math.min(flowMaxScroll, Number(state.flowSelectionScroll) || 0));
+    if (state.flowSelectionIndex < flowScroll) flowScroll = state.flowSelectionIndex;
+    else if (state.flowSelectionIndex >= flowScroll + flowViewport) flowScroll = state.flowSelectionIndex - flowViewport + 1;
+    state.flowSelectionScroll = Math.max(0, Math.min(flowMaxScroll, flowScroll));
+    const visibleFlows = state.flows.slice(state.flowSelectionScroll, state.flowSelectionScroll + flowViewport);
     return card([
       `${p.bold}Flow mode requires a workflow${p.reset}`,
       `${p.muted}This selection is bound to ${state.lastConversation}.${p.reset}`,
       "",
-      ...(state.flows.length
-        ? state.flows.map((name, index) => {
-          const style = index === state.flowSelectionIndex ? `${p.selected}${p.bold}` : "";
-          return `${style} ${index === state.flowSelectionIndex ? "›" : " "} ${name}${p.reset}`;
+      ...(visibleFlows.length
+        ? visibleFlows.map((name, i) => {
+          const flowIndex = state.flowSelectionScroll + i;
+          const style = flowIndex === state.flowSelectionIndex ? `${p.selected}${p.bold}` : "";
+          return `${style} ${flowIndex === state.flowSelectionIndex ? "›" : " "} ${name}${p.reset}`;
         })
         : [`${p.amber}No workflows are configured in ~/.Newmark/Flow.${p.reset}`]),
       "",
@@ -1226,14 +1255,38 @@ function overlayLines(state, width, p) {
   return [];
 }
 
-function render(state, columns = process.stdout.columns || 100, rows = process.stdout.rows || 30) {
+// 实时读取终端窗口尺寸：优先 getWindowSize()（每次调用都查询底层 TTY 尺寸，
+// 不依赖 Node 缓存的 columns/rows，避免 resize 事件丢失或延迟时按旧尺寸绘制），
+// 其次回退到缓存 columns/rows，再回退 COLUMNS/LINES 环境变量与默认值。
+function readWindowSize(fallbackColumns = 100, fallbackRows = 30) {
+  const stdout = process.stdout;
+  if (stdout && typeof stdout.getWindowSize === "function") {
+    try {
+      const [width, height] = stdout.getWindowSize();
+      if (Number.isFinite(width) && Number.isFinite(height) && width > 0 && height > 0) {
+        return { columns: Math.max(1, Math.floor(width)), rows: Math.max(1, Math.floor(height)) };
+      }
+    } catch {}
+  }
+  const columns = Number(stdout?.columns) || Number(process.env.COLUMNS) || fallbackColumns;
+  const rows = Number(stdout?.rows) || Number(process.env.LINES) || fallbackRows;
+  return { columns: Math.max(1, Math.floor(columns)), rows: Math.max(1, Math.floor(rows)) };
+}
+
+function render(state, columns, rows) {
+  const size = (columns !== undefined && rows !== undefined)
+    ? { columns: Math.max(1, Math.floor(Number(columns) || 1)), rows: Math.max(1, Math.floor(Number(rows) || 1)) }
+    : readWindowSize();
   const p = palette(state);
-  const width = Math.max(52, columns);
-  const height = Math.max(20, rows);
+  // 严格约束：直接采用终端实际尺寸，绝不通过 Math.max(52/20) 强制放大。
+  // 终端窗口小于内部最小布局时，内容在输出阶段裁剪到窗口内，否则帧会
+  // 画到窗口之外（用户看不到底部行/右侧列，如小窗口下的模型长菜单）。
+  const width = size.columns;
+  const height = size.rows;
   const compact = width < 78;
   const sidebarWidth = compact ? 0 : 22;
   const contentWidth = width - sidebarWidth - 2;
-  const bodyHeight = height - 3;
+  const bodyHeight = Math.max(1, height - 3);
   const sidebar = sidebarWidth ? renderSidebar(state, bodyHeight, sidebarWidth, p) : [];
   const content = renderContent(state, contentWidth, bodyHeight, p);
   let contentLines = content;
@@ -1242,8 +1295,11 @@ function render(state, columns = process.stdout.columns || 100, rows = process.s
     let scroll = Math.max(0, Math.min(maximumScroll, Number(state.contentScroll) || 0));
     const focusLine = Number(state.contentFocusLine) || -1;
     if (focusLine >= 0) {
-      if (focusLine < scroll) scroll = focusLine;
-      else if (focusLine >= scroll + bodyHeight) scroll = focusLine - bodyHeight + 1;
+      // 居中跟随：焦点行尽量保持在视口中上部，上下都留出内容，避免选中行
+      // 贴住视口边缘或被裁掉其相邻行（如两行一组的模型选项主行+描述行）。
+      const targetLine = Math.min(Math.max(0, Math.floor(bodyHeight / 3)), Math.max(0, bodyHeight - 2));
+      if (focusLine < scroll + targetLine) scroll = Math.max(0, focusLine - targetLine);
+      else if (focusLine >= scroll + bodyHeight - 1 - targetLine) scroll = Math.min(maximumScroll, focusLine - (bodyHeight - 1 - targetLine));
     }
     scroll = Math.max(0, Math.min(maximumScroll, scroll));
     state.contentScroll = scroll;
@@ -1262,20 +1318,25 @@ function render(state, columns = process.stdout.columns || 100, rows = process.s
     : "";
   if (compact) body.unshift(pad(top, width));
   const focus = state.focusRegion === "menu" ? "MENU" : "CONTENT";
-  const footer = `${p.panel} ${p.cyan}${focus}${p.reset}${p.panel}${p.muted} · ${truncate(state.notice, width - 42)}${p.reset}${p.panel}${" ".repeat(Math.max(1, width - visibleLength(state.notice) - visibleLength(focus) - 35))}Tab back  ? help  Q quit ${p.reset}`;
-  const renderedBody = body.slice(0, height - 1);
-  while (renderedBody.length < height - 1) renderedBody.push(pad("", width));
-  let output = `${ESC}?25l${ESC}2J${ESC}H${p.paint}${renderedBody.join("\n")}\n${pad(footer, width)}`;
+  const footer = `${p.panel} ${p.cyan}${focus}${p.reset}${p.panel}${p.muted} · ${truncate(state.notice, Math.max(1, width - 42))}${p.reset}${p.panel}${" ".repeat(Math.max(1, width - visibleLength(state.notice) - visibleLength(focus) - 35))}Tab back  ? help  Q quit ${p.reset}`;
+  const bodyLines = Math.max(1, height - 1);
+  const renderedBody = body.slice(0, bodyLines);
+  while (renderedBody.length < bodyLines) renderedBody.push(pad("", width));
+  // 输出阶段严格边界：每行按可见宽度截断到窗口宽度，行数限制在窗口高度内，
+  // 确保无论内部最小布局如何，帧绝不会画到窗口之外。
+  const boundedBody = renderedBody.map((line) => truncate(line, width));
+  const boundedFooter = truncate(pad(footer, width), width);
+  let output = `${ESC}?25l${ESC}2J${ESC}H${p.paint}${boundedBody.join("\n")}\n${boundedFooter}`;
   const overlay = overlayLines(state, width, p);
   if (overlay.length) {
     const overlayWidth = Math.max(...overlay.map(visibleLength));
     const x = Math.max(1, Math.floor((width - overlayWidth) / 2) + 1);
     const y = Math.max(2, Math.floor((height - overlay.length) / 2));
     overlay.forEach((line, index) => {
-      output += `${ESC}${y + index};${x}H${line}`;
+      output += `${ESC}${y + index};${x}H${truncate(line, width)}`;
     });
   }
   return `${output}${p.final}`;
 }
 
-module.exports = { render, stripAnsi, visibleLength, wrapText };
+module.exports = { render, readWindowSize, stripAnsi, visibleLength, wrapText };

package/dist/tui/src/state.js

@@ -183,6 +183,8 @@ function createState(options = {}) {
     workflowDraft: { name: "", mode: "build", prompt: "" },
     workflowFormIndex: 0,
     flowSelectionIndex: 0,
+    flowSelectionScroll: 0,
+    conversationListScroll: 0,
     flowByConversation: initialFlow ? { [`${target.workspaceId}::${target.conversationId}`]: initialFlow } : {},
     currentFlow: initialFlow,
     theme: appearance.theme,
@@ -192,6 +194,7 @@ function createState(options = {}) {
     settingChoiceIndex: 0,
     paletteQuery: "",
     paletteIndex: 0,
+    paletteScroll: 0,
     inputMode: false,
     input: "",
     inputCursor: 0,