Skip to content

feat(chrome): add standalone browser agent with Web Shell - #9

Draft
yiliang114 wants to merge 4 commits into
cx/chrome-extension-native-toolsfrom
cx/chrome-extension-standalone-web
Draft

feat(chrome): add standalone browser agent with Web Shell#9
yiliang114 wants to merge 4 commits into
cx/chrome-extension-native-toolsfrom
cx/chrome-extension-standalone-web

Conversation

@yiliang114

@yiliang114 yiliang114 commented Jul 18, 2026

Copy link
Copy Markdown
Owner

What this PR does

This PR turns the standalone browser-agent prototype into a Qwen Web Shell host that runs without qwen serve, Native Messaging, or an external MCP process. The extension injects an in-process transport into the existing Web Shell, so chat, Markdown, sessions, history replay, model selection, tool cards, stop behavior, status UI, sidebar rename/archive/delete, and permission decisions use the same UI and daemon event contracts as the full extension.

The standalone runtime exposes all 20 existing Chrome debugger tools, including snapshots, screenshots, navigation, interaction, JavaScript, console inspection, network inspection, and page-context requests. Read-only inspection runs as part of the user-authorized turn; state-changing and sensitive tools use the normal Web Shell permission drawer. Tool inputs are passed through the existing browser-tool redaction logic before they enter transcript history.

First-run setup can import the active model, supported endpoint, and credential from a user-selected Qwen settings.json, including current modelProviders.openai/envKey, Token Plan, and deprecated auth-field formats. Chrome cannot silently read arbitrary local files, so the picker preserves the pure-browser security boundary. The credential remains in session storage unless the user explicitly enables persistence.

Why it's needed

The daemon-based extension provides the complete Qwen Code experience but requires a local runtime. This branch validates a parallel install-and-configure browser-agent product while reusing the production UI and browser engine instead of maintaining a demo-specific frontend.

The standalone path remains intentionally narrower than Qwen Code. Local filesystem, shell, Git, repository context, project skills, hooks, local MCP processes, CLI credentials, and daemon background jobs require a trusted local runtime and are not represented as working controls in this extension.

Reviewer Test Plan

How to verify

  1. Build the extension, load packages/chrome-extension/dist/extension unpacked, and keep qwen serve stopped.
  2. On first launch, select a representative Qwen settings.json or enter a supported ModelStudio endpoint, model, and API key. Confirm that unrelated environment variables and MCP configuration are not imported.
  3. Save with credential persistence disabled, reopen the panel, and confirm the credential survives only for the current Chrome session. Repeat with persistence enabled and confirm the choice is preserved when the model is selected again.
  4. Ask the agent to summarize an HTTP/HTTPS page. Confirm the formal Web Shell shows the user message, browser tool card, assistant response, completed turn, and persisted session in the sidebar.
  5. Ask the agent to navigate or interact with the page. Reject the permission request and confirm that no page action occurs; allow a second request and confirm that it executes. Change the page while a request is pending and confirm that the stale action is rejected.
  6. Create, rename, archive, reopen, and delete standalone chats from the Web Shell sidebar. Start a turn and use Stop to confirm the next prompt remains usable.
  7. Open tool status and confirm that all 20 browser tools are reported, including screenshot, JavaScript, console, network, and page-context request tools.

Evidence (Before & After)

Before: the standalone branch used a custom demo panel, an in-memory transcript, 11 allowlisted tools, window.confirm, and manual settings fields.

After: the extension bundles the production Qwen Web Shell and routes it through a tested in-process daemon transport with 20 browser tools, formal permission events, bounded persisted sessions, sidebar lifecycle actions, and local settings.json import. Browser automation cannot access chrome:// or chrome-extension:// pages by policy, so the final internal-page click-through remains a reviewer/manual check; package-level DOM and transport tests cover the same first-run, event, permission, and session contracts.

Tested on

OS Status
🍏 macOS
🪟 Windows ⚠️
🐧 Linux ⚠️

Environment (optional)

macOS, Chrome Developer Mode, unpacked extension. Verified with 92 unit/integration tests, ESLint on changed TypeScript, Chrome-extension and Web Shell type checking, production packaging, and artifact scanning.

Risk & Scope

  • Main risk or tradeoff: the extension retains the powerful debugger permission and sends page content required by a task to the configured ModelStudio endpoint. The full Web Shell increases the compressed package to approximately 3.2 MB.
  • Not validated / out of scope: Chrome Web Store publication, hosted account sign-in, token-streamed model responses, summarized context compaction, workflow recording, schedules, multi-tab groups, upload/GIF tooling, and manual Windows/Linux E2E.
  • Breaking changes / migration notes: this stacked comparison branch replaces only its own standalone side panel. The daemon/native-tools branch remains the full Qwen Code path.

Linked Issues

Stacked on QwenLM#7027. No issue linked.

中文说明

这个 PR 做了什么

这个 PR 将 standalone 浏览器 Agent 原型升级为无需 qwen serve、Native Messaging 或外部 MCP 进程的 Qwen Web Shell 宿主。扩展把进程内 transport 注入现有 Web Shell,因此聊天、Markdown、会话、历史恢复、模型选择、工具卡、停止、状态栏、侧栏重命名/归档/删除和权限决策都复用完整扩展相同的 UI 与 daemon 事件协议。

standalone runtime 暴露现有全部 20 个 Chrome debugger 工具,包括快照、截图、导航、页面交互、JavaScript、console、network 和页面上下文请求。只读检查属于用户发起 turn 的授权范围;修改页面和敏感工具通过正式 Web Shell 权限抽屉确认。工具参数在进入历史记录前复用现有 BrowserTools 脱敏逻辑。

首次配置可以从用户选择的 Qwen settings.json 导入当前模型、受支持 endpoint 和凭据,支持当前 modelProviders.openai/envKey、Token Plan 和旧 auth 字段格式。Chrome 不能静默读取任意本地文件,因此文件选择器保留了纯浏览器安全边界。除非用户明确开启持久化,否则凭据只保存在 session storage。

为什么需要

daemon 模式提供完整 Qwen Code 体验,但要求本地 runtime。这个分支验证并列的“安装并配置即可使用”的浏览器 Agent 产品形态,同时复用生产 UI 和浏览器引擎,不再维护 demo 专用前端。

standalone 路径仍然有意小于完整 Qwen Code。本地文件系统、Shell、Git、仓库上下文、项目 skills、hooks、本地 MCP 进程、CLI 凭据和 daemon 后台任务需要可信本地 runtime,因此不会在此扩展中伪装成可用控件。

Reviewer Test Plan

如何验证

  1. 构建扩展,使用 unpacked 方式加载 packages/chrome-extension/dist/extension,并保持 qwen serve 未启动。
  2. 首次打开时选择一个 Qwen settings.json,或输入受支持的 ModelStudio endpoint、模型和 API Key。确认无关环境变量与 MCP 配置不会被导入。
  3. 在关闭凭据持久化时保存并重新打开面板,确认凭据只在当前 Chrome session 存活;再开启持久化,确认重新选择模型后仍保留该选择。
  4. 要求 Agent 总结一个 HTTP/HTTPS 页面,确认正式 Web Shell 展示用户消息、浏览器工具卡、助手回复和完成状态,并在侧栏保存会话。
  5. 要求 Agent 导航或操作页面;拒绝权限请求并确认页面未改变,再允许一次请求并确认执行。等待权限期间切换页面,确认旧操作被拒绝。
  6. 从 Web Shell 侧栏新建、重命名、归档、恢复和删除 standalone 会话。运行中点击 Stop,确认下一条 prompt 仍可使用。
  7. 打开工具状态,确认报告全部 20 个浏览器工具,包括截图、JavaScript、console、network 和页面上下文请求。

验证证据(Before & After)

Before:standalone 分支使用自定义 demo 面板、内存 transcript、11 个 allowlist 工具、window.confirm 和手工 settings 字段。

After:扩展打包生产 Qwen Web Shell,通过已测试的进程内 daemon transport 提供 20 个浏览器工具、正式权限事件、有界持久会话、侧栏生命周期操作和本地 settings.json 导入。浏览器自动化策略禁止访问 chrome://chrome-extension:// 页面,因此最终内部页面点击仍需 reviewer 手工确认;包级 DOM 与 transport 测试覆盖相同的首次配置、事件、权限与会话协议。

测试平台

OS 状态
macOS
Windows ⚠️ 未测试
Linux ⚠️ 未测试

环境

macOS、Chrome Developer Mode、unpacked extension。已验证 92 个单元/集成测试、变更 TypeScript 的 ESLint、Chrome 扩展与 Web Shell typecheck、生产打包和 artifact scan。

风险与范围

  • 主要风险或取舍:扩展仍持有高权限 debugger,并将任务所需页面内容发送到配置的 ModelStudio endpoint;完整 Web Shell 使压缩包约为 3.2 MB。
  • 未验证或不在范围内:Chrome Web Store 发布、托管账号登录、模型 token 流式输出、摘要式上下文压缩、workflow 录制、定时任务、多 tab group、上传/GIF 工具和 Windows/Linux 人工 E2E。
  • 破坏性变更或迁移说明:这个 stacked 对比分支只替换自己的 standalone 侧栏;daemon/native-tools 分支仍是完整 Qwen Code 路径。

关联项

基于 QwenLM#7027。未关联 issue。

@changeset-bot

changeset-bot Bot commented Jul 18, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 3179a08

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel

vercel Bot commented Jul 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
qwen-code Error Error Jul 18, 2026 4:46am

@yiliang114 yiliang114 changed the title feat(chrome): prototype standalone browser agent feat(chrome): add standalone browser agent with Web Shell Jul 18, 2026
yiliang114 pushed a commit that referenced this pull request Sep 1, 2026
* feat(cli): OpenTUI foundation modules — theme, a11y, clipboard, keys, dialogs scaffolding

Foundation batch of the OpenTUI migration tracked in QwenLM#8662. Adds the renderer-neutral foundation modules under ui/opentui: theme family, a11y (plain-text, screen-reader), clipboard, key-map, mouse hit/caret, link-click + osc8 parity, early-input, exit guard/lifecycle, kitty negotiation, event-adapter, item-projection, slash dispatch (+ command parsing), commands context/output, help content, input history, and the dialog scaffolding primitives (core/shared) with the theme dialog. Two helpers land inside ui/opentui rather than utils/ to respect the utils leaf-layer rule (QwenLM#9737). Stacked on the infra batch: consumes ui/model streaming model and @OpenTui deps. No reachable ink code changes beyond a one-line export addition in the shared osc8 module.

* fix(cli): import originals instead of forking slash parser and dialog scope utils

* fix(cli): address R1 review findings in OpenTUI foundation modules

* fix(cli): align OpenTUI command host with the memory-file-count rename

Upstream renamed setGeminiMdFileCount to setMemoryFileCount in the command
UI contract; the rebase onto main surfaced the mismatch at build. Rename
the host interface member, the bridge wiring, the dispatch stub, and the
test mock to match.

* feat(cli): OpenTUI migration live-session and input batch

Third landing batch of the OpenTUI migration (QwenLM#8662): live-session stream
fold and model, message rendering (markdown heal, MCP progressive, client
tool runs, text batching), transcript adapter with resume/session-switch,
sticky todos, the composer (input-prompt view/key/model), mouse rows and
scrollbar, unified-diff rendering, and session-compaction notice. All
additive — no reachable ink code path is touched, ink remains the default.

Carries the first consumer of the remend dependency deferred from the
infra batch, placed in devDependencies per the renderer-deps convention.
The stacked-skill completion helpers import from the relocated
ui/commands module following the upstream rename.

* fix(cli): address R2 review findings in OpenTUI foundation modules

Round-2 review fixes (17 Critical + 10 Suggestion resolved in code):

- dialogs-shared: move number-select flush out of the setState updater
  (StrictMode double-fires onSelect); split setActiveIndex (ink
  SET_ACTIVE_INDEX, lands on any in-range row) from highlightIndex
  (arrow keys skip disabled rows) so wheel navigation never sticks
- event-adapter: chat_compressed notice mirrors ink formatCount ('~'
  prefix for estimated counts); vision_bridge_notice renders
  summary\nnotice; explicit projections for task_execution /
  findings_list / terminal_image keep multi-MB payloads off the
  transcript; retry-countdown-clear forwards isContinuation
- slash-dispatch: isSlashCommandInput drops the '?' branch (ink gate
  routes ? input to the model); executeSlashCommand races the action
  against the abort signal; dialog effects carry the
  OpenDialogActionReturn payload; projected added-item text surfaces
  alongside non-handled effects (notice); message-shaped items project
  to their text; ui.history comes from env; absent sessionStats stamp
  now, not epoch; telemetry parity (recordSkillInvocation /
  recordAutoSkillCommandUsage / makeSlashCommandEvent)
- item-projection: model stats render per-(model,source) sections with
  N/A for unpriced entries; Tool Calls line uses ASCII x like ink;
  redactProxy deduplicated via systemInfoFields export
- theme: palette/syntax colors resolve through color-utils toHex before
  parseColor (ink CSS names / *bright names no longer degrade to
  magenta); unresolvable values stay unset
- key-map: kitty 'kpenter' normalizes to 'return'; resolveCommands
  exposes ink's key fan-out (Ctrl+C fires QUIT + CLEAR_INPUT)
- a11y: hardWrap delegates to wrap-ansi (word-boundary parity with
  ink's screen-reader path); markdown reducer tracks fence length,
  keeps fence-like lines literal inside fences and inner backticks in
  multi-backtick spans; stripAnsi delegates to strip-ansi plus a
  private-parameter CSI pass (SGR mouse, DEC save/restore)
- clipboard: OSC 52 write gated on a TTY (stderr preferred), tests spy
  the stream instead of writing real sequences to the runner's terminal
- exit-guard: independent per-key arm windows like ink
- dialogs-theme: diff preview pane receives syntaxStyle/filetype

* fix(cli): harden kitty probe and screen-reader writer per maintainer review

- kitty-negotiation: KITTY_REPLY_RE requires at least one flag digit
  (\d+), so an echoed bare query \x1b[?u in PTY/CI environments no
  longer resolves true and locks the renderer into kitty mode on a
  terminal that never answers queries; the accumulation buffer keeps
  only a 256-byte tail (bounded memory, bounded rescan under byte
  floods); the settle-window drain is removed — an EventEmitter data
  listener cannot consume chunks from other listeners, so late replies
  flow to the renderer's input parser like any other terminal noise
- a11y-screen-reader: ScreenReaderOutputWriter sanitizes written
  content (stripAnsi + drop bare C0/C1 controls, keep newlines) so the
  plain-text-only contract is enforced at the writer instead of
  trusting every future caller — smuggled OSC 52 clipboard writes or
  title/cursor sequences cannot execute on the main screen

* fix(cli): address ytahdn independent review findings in OpenTUI foundation

All 15 findings from the independent static review verified in source and
fixed (no false positives; none deferred):

- quit effect carries QuitActionReturn.messages projected to text on a
  notice field — ink renders them via QuittingDisplay and the payload was
  permanently lost (Important #1)
- error and finished branches emit retry-countdown-clear like ink's
  handleErrorEvent/handleFinishedEvent, so a terminal event inside the
  countdown window no longer leaves a stale retry row (#2)
- projectContextUsage renders the compaction-threshold ladder and the
  per-item detail sections (tools/memory/skills, ink's sort order) when
  showDetails is on — /context detail transcripts no longer show strictly
  less than the compact view (#3)
- projectMcpStatus honors showSchema (parameter JSON under each tool) and
  showTips, so /mcp schema is distinguishable from /mcp (#4)
- SlashDispatchEnv.settings is required: the real
  CommandContext.services.settings is non-null and a null surfaced as a
  generic command failure on first .merged read (#5)
- dead singleColumn flag removed from the help width layout (clamp makes
  it always false; ink has no single-column mode) (#6)
- truncated SS3 tail (bare ESC O) is stripped like the truncated CSI
  tail, so a captured half F1-F4 no longer leaks 'O' into the composer (#7)
- readBufferRow trims cellColumns alongside text, so URLs ending at
  end-of-row on a wide character hit-test on both halves of the cell (#8)
- kitty probe writes guarded: a synchronous stream throw settles the
  probe (restores raw mode, removes the listener) instead of leaking (#9)
- eraseLines reuses the ansi-escapes helper (already a repo dependency)
  instead of a byte-identical hand-rolled copy (#10)
- truncateText passthrough wrapper dropped; callers use the exported
  truncateHelpText directly (QwenLM#11)
- SkillsList truncate keeps total length n like ink, so the description
  column no longer shifts by one cell when a name truncates (QwenLM#12)
- model_fallback names pass through sanitizeDisplayText like ink (QwenLM#13)
- selectIndex fires onHighlight before onSelect (ink dispatches
  SET_ACTIVE_INDEX then SELECT_CURRENT), keeping highlight-driven
  stay-open dialogs synced on mouse input (QwenLM#14)
- mcp_app without fallbackText renders empty instead of JSON-dumping the
  embedded HTML; projectAbout hides Base URL when selectedAuthType is
  empty, matching ink's formatBaseUrl (QwenLM#15)

* fix(cli): address R3 review findings in OpenTUI foundation modules

- executeSlashCommand catch checks the abort signal first: an ESC-
  cancelled command (action rejects AbortError) returns handled with no
  failure telemetry or error message, mirroring ink's processor — the
  race promise never resolves when the signal is already aborted at
  addEventListener time
- submit effect carries the full SubmitPromptActionReturn contract
  (modelOverride, onComplete, refreshContextFilesOnWrite) so the
  backend can honor /model <id> <prompt>, /dream's manual-run record,
  and /remember's context refresh like ink instead of silently
  degrading them
- closing fences cannot carry info text (CommonMark): a ```js line
  inside an open block is literal body, not an early close that drops
  the block and inverts parse state for the rest of the document
- info items append their linkUrl/linkText footer (ink's InfoMessage
  renders it; headless/SSH users need the printed URL, e.g. /bug)
- the screen-reader sanitize keeps TAB: it separates words in
  tool/model output and deleting it fused adjacent tokens

* fix(cli): address R4 review findings in OpenTUI foundation modules

- a11y-plain-text: split on all CommonMark line endings so CRLF
  markdown opens/closes fences correctly; private-param CSI regex
  covers ECMA-48 intermediate bytes; DCS/SOS/PM/APC and unterminated
  OSC sequences consumed before strip-ansi; code-span pattern mirrors
  ink's INLINE_CODE_SPAN_PATTERN (non-empty content, closing-run
  lookbehind)
- dialogs-shared: clearNumberBuffer called from setActiveIndex,
  selectIndex, and resyncKey block so wheel/hover/click/resync can't
  commit a stale numeric-flush selection the user never made
- event-adapter: tool_call_response carries visionBridgeNotice on the
  tool-result event (ink ToolMessage renders the egress disclosure)
- item-projection: projectContextUsage reads memoryFiles as { path,
  tokens } (ContextMemoryDetail), not { name, tokens }
- key-map: 10 kp* keypad-navigation aliases (kpleft→left, …) and
  super flag folded into meta (ink Cmd+Enter = newline, not submit)
- link-click: cellColumns no longer truncated to trimmed text length
  (preserves the wide-glyph right-half boundary); findUrlAtRow end
  boundary is width-aware (stringWidth of the last glyph)
- slash-dispatch: submit effect carries PartListUnion content + a
  textContent string for text-only consumers (image parts survive);
  toggleVimEnabled and startNewSession seams wired from env; abort
  race resolves immediately for an already-aborted signal
- clipboard: OSC 52 self-write removed — copyToClipboard's existing
  fallback (writeOsc52 / wrapForMultiplexer) is the single source
- a11y-screen-reader: appendStatic skips clean === '\n' (ink's
  hasStaticOutput guard)

* fix(cli): address QwenLM#10383 R1 findings in foundation modules

- event-adapter: finished branch emits retry-countdown-clear BEFORE the
  info notice so the countdown row is actually cleared (the fold only
  pops when the last item is the retry row)
- item-projection: /mcp tips now include all 5 lines ink renders (added
  OAuth auth tip and Ctrl+T toggle tip)
- link-click: wide-glyph end boundary uses the last code point (not
  UTF-16 code unit) so non-BMP emoji are measured correctly by
  stringWidth
- a11y-plain-text: CSI_SEQUENCE replaces PRIVATE_PARAM_CSI — drops the
  marker requirement so any CSI (with or without private parameter
  marker, with or without intermediate bytes) is fully consumed

* fix(cli): address QwenLM#10383 R2 Critical findings in slash-dispatch

- abort race: already-aborted signal now skips command.action entirely
  (result = undefined) instead of eagerly evaluating it as a Promise.race
  argument — the action's side effects (clear, persist, addItem) must not
  run on a cancelled submission
- parent command telemetry: logEvent (slash_command SUCCESS) is now
  called before the early return for parent commands with subCommands
  (help listing) and bare handled — matching ink's finally-block logging

* fix(cli): address QwenLM#10368 R2 review findings in live-session batch

- input-prompt: convert OpenTUI display-width cursor coordinates to
  code-point positions at the component boundary — the pinned
  @opentui/core reports logicalCursor.col/offset and el.cursorOffset in
  terminal-cell units (edit-buffer.zig), while the ported ink helpers
  work in code points; wide characters previously shifted placeholder
  backspace, the backslash continuation check, completion targeting,
  and history edge compares
- input-prompt: bump both search sequence refs when Esc dismisses the
  completion dropdown so an in-flight search resolving afterwards cannot
  re-open it and hijack Enter
- live-session-model: carry the vision-bridge egress disclosure through
  the tool-result fold (ink ToolMessage renders it under the result)
- messages: recognize the producers' two-L 'cancelled' summary spelling
  so canceled tools get the CANCELED glyph with strikethrough instead of
  the red ERROR glyph
- session-switch: wrap /resume and /branch in the telemetry swap
  transaction (begin before the outgoing-session capture, commit at the
  UI re-key, abort after a rolled-back swap) — restores the usage
  aggregate on failed swaps and rejects concurrent switches
- tests: display-width fake editor, wide-char placeholder/continuation
  witnesses, Esc invalidation, fold notice, cancelled spelling, and the
  three swap-transaction lifecycle cases

* fix(cli): declare cursorOffset on the FakeEditor test interface

The display-width fake added in 656e996 implements a cursorOffset
getter/setter but the interface it is cast through never declared the
member, so tsc --build fails with TS2339 at the two reads in the
wide-char placeholder test. Typecheck ran before that commit's files
were staged and missed it.

* test(cli): stub listStartingRunIds in the session-switch fake registry

The workflow-run registry gained listStartingRunIds with the workflow
tasks feature on main; backgroundWorkUtils iterates it when describing
blocking work, so the fake registry in session-switch.test.ts now
implements it (empty) to match the interface the merged code expects.

* fix(opentui): address yiliang114 review findings (4 P2 + 1 P3)

- transcript-adapter: FIFO queue for id-less tool call pairing so
  tool-start and tool_result share the same minted id
- session-switch: move uiSwapped=true to right after startNewSession
  (the first irreversible host mutation) preventing core/UI divergence
  on mid-sequence throw; same fix for branch handler
- session-switch: add error item when /resume targets an unloadable
  session instead of returning silently
- diff-render: run diff content through escapeAnsiCtrlCodes matching
  the ink text-boundary convention (useTurnDiffs.ts)
- package.json: move remend from devDependencies to dependencies
  (imported from production source markdown-heal.ts)

* fix(transcript): address R6 review — thinking latch, cancelled status, text join

- Replace one-shot `closed` latch with `thinkingOpen` state so
  [thought, text, thought, ...] patterns emit matching thinking-end
  for each burst (P2)
- Mirror live path: treat cancelled tool status as failed, not ok (P3)
- Join user text parts with newline instead of empty string (P3)
- Regenerate package-lock.json so remend is in dependencies (P2)

* fix(opentui): address review-pr bot R3 critical findings

- session-compaction: add missing COMPRESSION_FAILED_EMPTY_SUMMARY,
  OUTPUT_TRUNCATED, and API_ERROR cases to match ink compression-text.ts
- live-session: distinguish cancelled from error in tool-end summary
  so toolStatusMeta renders strikethrough instead of red X
- transcript-adapter: gate slash_command replay on phase=invocation to
  prevent double-replay (recorder writes both invocation and result)
- input-prompt: add key.meta/key.option to DELETE_WORD_BACKWARD branch
  to match the guard condition that intercepts Alt+Backspace

* fix(opentui): address round-5 review findings R2-5 R3-2 R3-12 R4-1

R2-5: update session-compaction.test.ts to assert the three new
parity texts (EMPTY_SUMMARY, OUTPUT_TRUNCATED, API_ERROR) added in
63a7f3c; the old assertion that EMPTY_SUMMARY returned '' is stale.

R3-2: transcript-adapter replay producer folded cancelled tool status
into summary 'error' (red ✕) instead of 'cancelled' (strikethrough).
Add the cancelled branch to match live-session.ts.

R3-12: hidden slash-command invocations (hiddenInvocation: true for
/auth, /help, /settings, /status, bare /effort, /btw) replayed as
visible user rows and entered composer history. Gate them on the
hiddenInvocation flag in the invocation filter.

R4-1: modelOverride was only carried on the first UserQuery send;
ToolResult continuation sends omitted it, so a per-turn model override
silently reverted to the session default after the first tool batch.
Propagate modelOverride into every continuation send.
yiliang114 pushed a commit that referenced this pull request Sep 1, 2026
…-rewind (QwenLM#10383)

* feat(cli): OpenTUI foundation modules — theme, a11y, clipboard, keys, dialogs scaffolding

Foundation batch of the OpenTUI migration tracked in QwenLM#8662. Adds the renderer-neutral foundation modules under ui/opentui: theme family, a11y (plain-text, screen-reader), clipboard, key-map, mouse hit/caret, link-click + osc8 parity, early-input, exit guard/lifecycle, kitty negotiation, event-adapter, item-projection, slash dispatch (+ command parsing), commands context/output, help content, input history, and the dialog scaffolding primitives (core/shared) with the theme dialog. Two helpers land inside ui/opentui rather than utils/ to respect the utils leaf-layer rule (QwenLM#9737). Stacked on the infra batch: consumes ui/model streaming model and @OpenTui deps. No reachable ink code changes beyond a one-line export addition in the shared osc8 module.

* fix(cli): import originals instead of forking slash parser and dialog scope utils

* fix(cli): address R1 review findings in OpenTUI foundation modules

* fix(cli): align OpenTUI command host with the memory-file-count rename

Upstream renamed setGeminiMdFileCount to setMemoryFileCount in the command
UI contract; the rebase onto main surfaced the mismatch at build. Rename
the host interface member, the bridge wiring, the dispatch stub, and the
test mock to match.

* feat(cli): OpenTUI migration live-session and input batch

Third landing batch of the OpenTUI migration (QwenLM#8662): live-session stream
fold and model, message rendering (markdown heal, MCP progressive, client
tool runs, text batching), transcript adapter with resume/session-switch,
sticky todos, the composer (input-prompt view/key/model), mouse rows and
scrollbar, unified-diff rendering, and session-compaction notice. All
additive — no reachable ink code path is touched, ink remains the default.

Carries the first consumer of the remend dependency deferred from the
infra batch, placed in devDependencies per the renderer-deps convention.
The stacked-skill completion helpers import from the relocated
ui/commands module following the upstream rename.

* feat(cli): OpenTUI migration batch 4 — dialogs, commands, and session-rewind

Adds the dialog layer and command-routing infrastructure for the OpenTUI
renderer: 19 dialog modules (auth, extensions, MCP, memory-status, misc,
model family, modes, permissions, settings, stats/skills, help overlay,
arena host, folder-trust gate), the commands registry with slash-to-dialog
routing, the commands dispatcher (action interpreter connecting the slash
gateway to the session and dialog layer), and the session-rewind viewer
with its history-folding model.

Also exports `isUserTextContent` from historyMapping so the rewind model
can classify user turns without duplicating the predicate.

Everything is additive: no reachable ink code path is touched, the default
renderer stays ink, and the dep-direction gate passes. Stacked on the
live-session batch.

56 test files / 886 tests, all green.

* fix(cli): address R2 review findings in OpenTUI foundation modules

Round-2 review fixes (17 Critical + 10 Suggestion resolved in code):

- dialogs-shared: move number-select flush out of the setState updater
  (StrictMode double-fires onSelect); split setActiveIndex (ink
  SET_ACTIVE_INDEX, lands on any in-range row) from highlightIndex
  (arrow keys skip disabled rows) so wheel navigation never sticks
- event-adapter: chat_compressed notice mirrors ink formatCount ('~'
  prefix for estimated counts); vision_bridge_notice renders
  summary\nnotice; explicit projections for task_execution /
  findings_list / terminal_image keep multi-MB payloads off the
  transcript; retry-countdown-clear forwards isContinuation
- slash-dispatch: isSlashCommandInput drops the '?' branch (ink gate
  routes ? input to the model); executeSlashCommand races the action
  against the abort signal; dialog effects carry the
  OpenDialogActionReturn payload; projected added-item text surfaces
  alongside non-handled effects (notice); message-shaped items project
  to their text; ui.history comes from env; absent sessionStats stamp
  now, not epoch; telemetry parity (recordSkillInvocation /
  recordAutoSkillCommandUsage / makeSlashCommandEvent)
- item-projection: model stats render per-(model,source) sections with
  N/A for unpriced entries; Tool Calls line uses ASCII x like ink;
  redactProxy deduplicated via systemInfoFields export
- theme: palette/syntax colors resolve through color-utils toHex before
  parseColor (ink CSS names / *bright names no longer degrade to
  magenta); unresolvable values stay unset
- key-map: kitty 'kpenter' normalizes to 'return'; resolveCommands
  exposes ink's key fan-out (Ctrl+C fires QUIT + CLEAR_INPUT)
- a11y: hardWrap delegates to wrap-ansi (word-boundary parity with
  ink's screen-reader path); markdown reducer tracks fence length,
  keeps fence-like lines literal inside fences and inner backticks in
  multi-backtick spans; stripAnsi delegates to strip-ansi plus a
  private-parameter CSI pass (SGR mouse, DEC save/restore)
- clipboard: OSC 52 write gated on a TTY (stderr preferred), tests spy
  the stream instead of writing real sequences to the runner's terminal
- exit-guard: independent per-key arm windows like ink
- dialogs-theme: diff preview pane receives syntaxStyle/filetype

* fix(cli): harden kitty probe and screen-reader writer per maintainer review

- kitty-negotiation: KITTY_REPLY_RE requires at least one flag digit
  (\d+), so an echoed bare query \x1b[?u in PTY/CI environments no
  longer resolves true and locks the renderer into kitty mode on a
  terminal that never answers queries; the accumulation buffer keeps
  only a 256-byte tail (bounded memory, bounded rescan under byte
  floods); the settle-window drain is removed — an EventEmitter data
  listener cannot consume chunks from other listeners, so late replies
  flow to the renderer's input parser like any other terminal noise
- a11y-screen-reader: ScreenReaderOutputWriter sanitizes written
  content (stripAnsi + drop bare C0/C1 controls, keep newlines) so the
  plain-text-only contract is enforced at the writer instead of
  trusting every future caller — smuggled OSC 52 clipboard writes or
  title/cursor sequences cannot execute on the main screen

* test(cli): strengthen /branch awaits handleBranch assertion with a deferred race

The previous test asserted branchNames was populated after dispatch, but a
fire-and-forget void call passed because microtasks drained before the check.
Replace with a Promise.race that proves dispatch was still pending (blocked on
the closed gate) before the gate was resolved — a void call resolves dispatch
immediately, making the race return 'resolved' instead of the sentinel.

* fix(cli): correct stale 67→69 count in commands-registry docblocks; clarify gate test

Two docblock comments said "67 modules" but the table has 69 entries (verified
against BuiltinCommandLoader.ts). Fixed to 69.

The gated-commands test comment now explains that TypeScript enforces the
CommandGate type at compile time, so the runtime loop is unnecessary — the
literal name list is the intentional guard for a bogus gatedBy on an ungated
command.

* fix(cli): address dialogs-batch self-review findings in command registry

- /theme route results include 'message': themeCommand returns a
  MessageActionReturn under NO_COLOR, so the declared results were
  incomplete
- drop the unreachable 'branch' member from OpenTuiDialogRequest and
  make routeDialogToOpenTui throw on dialog-branch instead: /branch is
  a host action intercepted unconditionally by the dispatcher (ink
  parity), and a compile-time exclusion is not expressible because
  OpenDialogActionReturn is a single interface with a union dialog
  field — the loud throw guards against a future refactor dropping the
  interception; the branch route no longer advertises a dialogs entry
  no renderer opens
- derive gate coverage from the loader instead of a hardcoded name
  list: the coverage test loads with every gate ON (plus the
  checkpointing flag the /restore factory needs) and asserts set
  equality between route names and registered built-ins — no escape
  hatches — and a new test proves every gatedBy route is genuinely
  absent from a gates-off load, so a bogus gate on an always-registered
  command fails

* fix(cli): address ytahdn independent review findings in OpenTUI foundation

All 15 findings from the independent static review verified in source and
fixed (no false positives; none deferred):

- quit effect carries QuitActionReturn.messages projected to text on a
  notice field — ink renders them via QuittingDisplay and the payload was
  permanently lost (Important #1)
- error and finished branches emit retry-countdown-clear like ink's
  handleErrorEvent/handleFinishedEvent, so a terminal event inside the
  countdown window no longer leaves a stale retry row (#2)
- projectContextUsage renders the compaction-threshold ladder and the
  per-item detail sections (tools/memory/skills, ink's sort order) when
  showDetails is on — /context detail transcripts no longer show strictly
  less than the compact view (#3)
- projectMcpStatus honors showSchema (parameter JSON under each tool) and
  showTips, so /mcp schema is distinguishable from /mcp (#4)
- SlashDispatchEnv.settings is required: the real
  CommandContext.services.settings is non-null and a null surfaced as a
  generic command failure on first .merged read (#5)
- dead singleColumn flag removed from the help width layout (clamp makes
  it always false; ink has no single-column mode) (#6)
- truncated SS3 tail (bare ESC O) is stripped like the truncated CSI
  tail, so a captured half F1-F4 no longer leaks 'O' into the composer (#7)
- readBufferRow trims cellColumns alongside text, so URLs ending at
  end-of-row on a wide character hit-test on both halves of the cell (#8)
- kitty probe writes guarded: a synchronous stream throw settles the
  probe (restores raw mode, removes the listener) instead of leaking (#9)
- eraseLines reuses the ansi-escapes helper (already a repo dependency)
  instead of a byte-identical hand-rolled copy (#10)
- truncateText passthrough wrapper dropped; callers use the exported
  truncateHelpText directly (QwenLM#11)
- SkillsList truncate keeps total length n like ink, so the description
  column no longer shifts by one cell when a name truncates (QwenLM#12)
- model_fallback names pass through sanitizeDisplayText like ink (QwenLM#13)
- selectIndex fires onHighlight before onSelect (ink dispatches
  SET_ACTIVE_INDEX then SELECT_CURRENT), keeping highlight-driven
  stay-open dialogs synced on mouse input (QwenLM#14)
- mcp_app without fallbackText renders empty instead of JSON-dumping the
  embedded HTML; projectAbout hides Base URL when selectedAuthType is
  empty, matching ink's formatBaseUrl (QwenLM#15)

* fix(cli): drop dead single-column branch in help overlay

The foundation batch removed the always-false singleColumn flag from
the help width layout (the 72-column clamp makes it unreachable and ink
has no single-column mode); the overlay's conditional branch on it no
longer compiles. Only the two-column path was ever taken.

* fix(cli): address R3 review findings in OpenTUI foundation modules

- executeSlashCommand catch checks the abort signal first: an ESC-
  cancelled command (action rejects AbortError) returns handled with no
  failure telemetry or error message, mirroring ink's processor — the
  race promise never resolves when the signal is already aborted at
  addEventListener time
- submit effect carries the full SubmitPromptActionReturn contract
  (modelOverride, onComplete, refreshContextFilesOnWrite) so the
  backend can honor /model <id> <prompt>, /dream's manual-run record,
  and /remember's context refresh like ink instead of silently
  degrading them
- closing fences cannot carry info text (CommonMark): a ```js line
  inside an open block is literal body, not an early close that drops
  the block and inverts parse state for the rest of the document
- info items append their linkUrl/linkText footer (ink's InfoMessage
  renders it; headless/SSH users need the printed URL, e.g. /bug)
- the screen-reader sanitize keeps TAB: it separates words in
  tool/model output and deleting it fused adjacent tokens

* fix(cli): address R4 review findings in OpenTUI foundation modules

- a11y-plain-text: split on all CommonMark line endings so CRLF
  markdown opens/closes fences correctly; private-param CSI regex
  covers ECMA-48 intermediate bytes; DCS/SOS/PM/APC and unterminated
  OSC sequences consumed before strip-ansi; code-span pattern mirrors
  ink's INLINE_CODE_SPAN_PATTERN (non-empty content, closing-run
  lookbehind)
- dialogs-shared: clearNumberBuffer called from setActiveIndex,
  selectIndex, and resyncKey block so wheel/hover/click/resync can't
  commit a stale numeric-flush selection the user never made
- event-adapter: tool_call_response carries visionBridgeNotice on the
  tool-result event (ink ToolMessage renders the egress disclosure)
- item-projection: projectContextUsage reads memoryFiles as { path,
  tokens } (ContextMemoryDetail), not { name, tokens }
- key-map: 10 kp* keypad-navigation aliases (kpleft→left, …) and
  super flag folded into meta (ink Cmd+Enter = newline, not submit)
- link-click: cellColumns no longer truncated to trimmed text length
  (preserves the wide-glyph right-half boundary); findUrlAtRow end
  boundary is width-aware (stringWidth of the last glyph)
- slash-dispatch: submit effect carries PartListUnion content + a
  textContent string for text-only consumers (image parts survive);
  toggleVimEnabled and startNewSession seams wired from env; abort
  race resolves immediately for an already-aborted signal
- clipboard: OSC 52 self-write removed — copyToClipboard's existing
  fallback (writeOsc52 / wrapForMultiplexer) is the single source
- a11y-screen-reader: appendStatic skips clean === '\n' (ink's
  hasStaticOutput guard)

* fix(cli): address QwenLM#10383 R1 findings in foundation modules

- event-adapter: finished branch emits retry-countdown-clear BEFORE the
  info notice so the countdown row is actually cleared (the fold only
  pops when the last item is the retry row)
- item-projection: /mcp tips now include all 5 lines ink renders (added
  OAuth auth tip and Ctrl+T toggle tip)
- link-click: wide-glyph end boundary uses the last code point (not
  UTF-16 code unit) so non-BMP emoji are measured correctly by
  stringWidth
- a11y-plain-text: CSI_SEQUENCE replaces PRIVATE_PARAM_CSI — drops the
  marker requirement so any CSI (with or without private parameter
  marker, with or without intermediate bytes) is fully consumed

* fix(cli): address QwenLM#10383 R1 findings in dialogs batch

- dialogs-mcp: flatServers derived from grouped render order, not raw
  prop order, so keyboard selection matches the highlighted server
- dialogs-misc: highlightScope syncs editor selection (setSel) so Enter
  persists the highlighted scope's own editor, not the previous one
- dialogs-settings: buildSettingsListItems forwards
  excludeWorkspaceRestricted under Workspace scope, matching ink's
  filter that prevents dead settings entries
- dialogs-extensions: all onDetailAction call sites now swallow async
  rejections (.catch), matching session-rewind.tsx's pattern
- dialogs-stats-skills: metrics read from per-session bucket
  (getMetricsForSession) not process-global; Wall Time computed from
  uiTelemetryService.getSessionStartTime() not a module-load constant
- dialogs-modes: MODE_DESC key 'auto_edit' fixed to 'auto-edit' to
  match ApprovalMode.AUTO_EDIT enum value

* fix(cli): address QwenLM#10383 R2 Critical findings in slash-dispatch

- abort race: already-aborted signal now skips command.action entirely
  (result = undefined) instead of eagerly evaluating it as a Promise.race
  argument — the action's side effects (clear, persist, addItem) must not
  run on a cancelled submission
- parent command telemetry: logEvent (slash_command SUCCESS) is now
  called before the early return for parent commands with subCommands
  (help listing) and bare handled — matching ink's finally-block logging

* fix(cli): address QwenLM#10383 R2 Critical findings in dialogs batch

- dialog-data: buildModelEntries image mode gates on
  isImageGenerationCapable (not imageOnly) so dual-role and visionOnly
  image-capable models appear in the image selector like ink
- dialogs-extensions: detailSelect gets resyncKey: view so the cursor
  re-syncs when re-entering detail (action list shrinks after
  checked-update state resets)
- dialogs-stats-skills: subscribes to uiTelemetryService 'update' event
  so stats stay live while the dialog is open (ink re-renders via
  SessionStatsProvider)

* fix(cli): address QwenLM#10383 R3 review findings in opentui dialogs/dispatch

- buildModelEntries: keep visionOnly models in the image selector (ink
  ModelDialog parity: isVisionModelMode || isImageModelMode || !visionOnly)
- useDialogSelect: re-sync the cursor on items changes like ink's
  useSelectionList INITIALIZE reducer — follow the active item's key,
  fall back to the initial index when it is gone, so a shrinking list
  never strands the cursor where Enter reads undefined
- OpenTuiSlashDispatcher: skip the action entirely when the signal is
  already aborted before the race — a late 'abort' listener never fires,
  so the eager race would run side effects before discarding
- tests: pin the pre-aborted skip in both dispatchers, the dual-role
  image/vision fixture, the items-shrink clamp, and restore the
  uninstall-backout guard assertion

* fix(cli): address QwenLM#10368 R2 review findings in live-session batch

- input-prompt: convert OpenTUI display-width cursor coordinates to
  code-point positions at the component boundary — the pinned
  @opentui/core reports logicalCursor.col/offset and el.cursorOffset in
  terminal-cell units (edit-buffer.zig), while the ported ink helpers
  work in code points; wide characters previously shifted placeholder
  backspace, the backslash continuation check, completion targeting,
  and history edge compares
- input-prompt: bump both search sequence refs when Esc dismisses the
  completion dropdown so an in-flight search resolving afterwards cannot
  re-open it and hijack Enter
- live-session-model: carry the vision-bridge egress disclosure through
  the tool-result fold (ink ToolMessage renders it under the result)
- messages: recognize the producers' two-L 'cancelled' summary spelling
  so canceled tools get the CANCELED glyph with strikethrough instead of
  the red ERROR glyph
- session-switch: wrap /resume and /branch in the telemetry swap
  transaction (begin before the outgoing-session capture, commit at the
  UI re-key, abort after a rolled-back swap) — restores the usage
  aggregate on failed swaps and rejects concurrent switches
- tests: display-width fake editor, wide-char placeholder/continuation
  witnesses, Esc invalidation, fold notice, cancelled spelling, and the
  three swap-transaction lifecycle cases

* fix(cli): declare cursorOffset on the FakeEditor test interface

The display-width fake added in 656e996 implements a cursorOffset
getter/setter but the interface it is cast through never declared the
member, so tsc --build fails with TS2339 at the two reads in the
wide-char placeholder test. Typecheck ran before that commit's files
were staged and missed it.

* fix(cli): address QwenLM#10383 R4 review findings in dialogs batch

- commands-dispatch.test: type the pre-aborted action mock as
  SlashCommandActionReturn so tsc --build passes (the inferred
  { type: string } could not satisfy the literal 'message' kind)
- dialogs-shared.test: pin the resyncKey numeric-flush disarm — an
  armed digit quick-select must not commit a selection in the view
  swapped to before the flush timeout
- session-switch.test: pin the unarmed-swap settlement when the
  resumed session is not found (commit, never abort) so the single
  swap slot cannot stay latched forever

* test(cli): stub listStartingRunIds in the session-switch fake registry

The workflow-run registry gained listStartingRunIds with the workflow
tasks feature on main; backgroundWorkUtils iterates it when describing
blocking work, so the fake registry in session-switch.test.ts now
implements it (empty) to match the interface the merged code expects.

* fix(opentui): address P2 review findings in session-rewind and load_history

- session-rewind: add useRef re-entrancy guard to prevent double onRewind
  from batched key events in single stdin chunk
- session-rewind: dispatch restore-error on onRewind rejection so the
  dialog recovers from dead 'restoring' phase back to 'pick'
- commands-dispatch: pass Date.now()-based timestamps to addItem instead
  of array indices in load_history branch
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant