Workspace drawer: files and changes

Gotchas and known limits

• When the drawer is closed, its tabs stay mounted at width 0. browser count 'testid=files-tab' is 1 even then, so assert with browser visible or right-panel-toggle aria-pressed.
• The tab row is a tablist "Conversation panels" of role=tab controls, each named after its tab even when inactive (#17612), so role=tab[name="Commits"] finds the Commits tab whether or not it is active; role=button[name="Commits"] finds nothing. aria-selected marks the selected tab. The conversation-tab-* test ids still work.
• The tab row ends with the ellipsis menu (Customize tabs), then the VSCode button (drawer-vscode-link, named Open in VS Code) when the runtime reports a running editor. #17660 removed that button and #18048 restored it, so on a checkout between the two the drawer has no editor control at all.
• The overflow menu is not a role=menu. Escape closes it and returns focus to the tab bar's ellipsis-button, both in the desktop drawer and on the phone /panel page; choosing a row or an outside click (browser mouse-click) closes it too.
• The Files list and the open preview do not follow bash edits: use-auto-refresh-files-on-edit.ts refreshes the file queries only for file-editor observations, and its comment says shell observations skip them on purpose (so that every shell command does not reload canvas iframes). This map still expects files the agent writes to appear (F08.files-auto-refresh), so the bash case stays a fail row. Click files-tab-refresh once before asserting on files the agent made with the shell. Since #18032 that one click also re-reads the open file (the content fetch revalidates instead of using the browser HTTP cache, and the rich preview gets a new ?v=), and a page reload shows the current body without a click.
• The chat also fetches the file list (to linkify paths). A conversation page left open while the agent works can therefore show a stale tree the moment the drawer first opens.
• Binary detection is a NUL-byte sniff of the first 8 KB, and the Office message also needs that sniff to trip. A 4-byte PK\003\004 "pptx" or random bytes without a NUL render as text in the plain viewer. Fixtures must contain a NUL.
• control-openhands fixture folder writes a plain folder with notes.md, but by the time the conversation has run the folder holds an empty .git, so a conversation that leaves notes.md in place shows Uncommitted 1 file rather than the empty state. Delete it first (as in the recipe).
• Diff views are Monaco. testid=file-diff-viewer and file-single-viewer are not on the DOM; read text through testid=editor-container. The narrow drawer falls back to an inline (not side-by-side) diff. The view-mode buttons are named Old version, Diff and New version, and collapse is named Expand or Collapse after its state (#18033).
• browser eval "navigator.clipboard.readText()" hangs for about 2 minutes (no clipboard permission). Use control-openhands browser clipboard to read what Copy wrote.
• browser click ... --observe accepts the usual selector syntax (testid=...).
• Two .cursor-ew-resize grips sit in the conversation page (chat/drawer, then the Files tree); scope the tree one with testid=files-tab-tree-resize-handle.
• At phone width, chat path links (and the agent's canvas_ui_control tab and file requests, through src/services/canvas-ui.ts) navigate to /conversations/<id>/panel (#18045); at desktop width they open the side drawer and the URL does not change. A /panel URL above 1024 px redirects to /conversations/<id>, so a bullet that leaves the phone viewport on /panel ends on the chat route.
• If the agent's terminal resets mid-command ("terminal session was reset", for example after a restart), the agent reruns the command. Check the workspace with git status through a second prompt rather than trusting the first observation. Runs no longer share a tmux server (OpenHands/OpenHands#17946).
• Known issue: #17567 (Monaco disposed-model page error on diff unmount; it also fires on collapse and on a diff→old switch).