fix(cli): bracketed-paste timeout prevents permanent input freeze by Tranquil-Flow · Pull Request #27518 · NousResearch/hermes-agent

Tranquil-Flow · 2026-05-17T17:22:48Z

What does this PR do?

Adds a timeout safety valve for torn bracketed-paste sequences in the interactive CLI.

When a terminal sends ESC[200~ to start bracketed paste but the matching ESC[201~ end marker is lost, prompt_toolkit keeps buffering all later input in _paste_buffer. From the user's perspective, the CLI appears frozen. The only practical recovery was closing the tab/session.

This PR monkey-patches Vt100Parser.feed() so that bracketed-paste mode flushes buffered content as a normal BracketedPaste event after 2 seconds without an end marker, then restores normal parsing.

Related Issue

Fixes #16263

Type of Change

🐛 Bug fix (non-breaking change that fixes an issue)
✨ New feature (non-breaking change that adds functionality)
🔒 Security fix
📝 Documentation update
✅ Tests (adding or improving test coverage)
♻️ Refactor (no behavior change)
🎯 New skill (bundled or hub)

Changes Made

Adds _apply_bracketed_paste_timeout_patch() in cli.py.
Monkey-patches prompt_toolkit.input.vt100_parser.Vt100Parser.feed() to:
- keep normal complete bracketed paste behavior intact,
- track when bracketed-paste mode started,
- flush buffered content as a BracketedPaste event after 2 seconds without an end marker,
- restore normal parsing afterward.
Calls the helper from the existing CLI Application setup path.
Adds production-linked regression tests that AST-load the actual helper from cli.py without importing the entire CLI module and its optional runtime dependencies.

How to Test

Run the new regression suite:

python3 -m pytest -o 'addopts=' tests/cli/test_bracketed_paste_timeout.py -q
# 8 passed

Fail-without-fix proof:

git checkout refs/remotes/upstream/main -- cli.py
python3 -m pytest -o 'addopts=' tests/cli/test_bracketed_paste_timeout.py -q
# 8 failed

git checkout HEAD -- cli.py
python3 -m pytest -o 'addopts=' tests/cli/test_bracketed_paste_timeout.py -q
# 8 passed

Checklist

Code

I've read the Contributing Guide
My commit messages follow Conventional Commits (fix(scope):, feat(scope):, etc.)
I searched for existing PRs to make sure this isn't a duplicate
My PR contains only changes related to this fix/feature (no unrelated commits)
I've run pytest tests/ -q and all tests pass
I've added tests for my changes (required for bug fixes, strongly encouraged for features)
I've tested on my platform: macOS 15 (Darwin 24.6.0)

Documentation & Housekeeping

I've updated relevant documentation (README, docs/, docstrings) — or N/A
I've updated cli-config.yaml.example if I added/changed config keys — or N/A
I've updated CONTRIBUTING.md or AGENTS.md if I changed architecture or workflows — or N/A
I've considered cross-platform impact (Windows, macOS) per the compatibility guide — or N/A
I've updated tool descriptions/schemas if I changed tool behavior — or N/A

Screenshots / Logs

$ python3 -m pytest -o 'addopts=' tests/cli/test_bracketed_paste_timeout.py -q
8 passed

…usResearch#16263) When the terminal drops the ESC[201~ end mark during a bracketed paste (terminal race, torn write, SSH glitch, macOS sleep/wake), prompt_toolkit's Vt100Parser keeps buffering all later input in _paste_buffer forever. From the user's perspective, the CLI appears frozen — the only recovery was closing the tab/session. This patch monkey-patches Vt100Parser.feed() so that bracketed-paste mode flushes buffered content as a normal BracketedPaste event after 2 seconds without an end marker, then restores normal parsing. Includes 8 regression tests covering normal paste, timeout recovery, torn end marks, and edge cases.

…6263) When the terminal drops the ESC[201~ end mark during a bracketed paste (terminal race, torn write, SSH glitch, macOS sleep/wake), prompt_toolkit's Vt100Parser keeps buffering all later input in _paste_buffer forever. From the user's perspective, the CLI appears frozen — the only recovery was closing the tab/session. This patch monkey-patches Vt100Parser.feed() so that bracketed-paste mode flushes buffered content as a normal BracketedPaste event after 2 seconds without an end marker, then restores normal parsing. Includes 8 regression tests covering normal paste, timeout recovery, torn end marks, and edge cases. Surgical reapply of PR #27518. Original branch was many months stale (1193 files / 172k LOC of unrelated reverts); the substantive ~77 LOC patch in cli.py plus the new 157-line test file were reapplied onto current main with the contributor's authorship preserved via --author.

…o Tranquil-Flow (PR #27518)

…6263) When the terminal drops the ESC[201~ end mark during a bracketed paste (terminal race, torn write, SSH glitch, macOS sleep/wake), prompt_toolkit's Vt100Parser keeps buffering all later input in _paste_buffer forever. From the user's perspective, the CLI appears frozen — the only recovery was closing the tab/session. This patch monkey-patches Vt100Parser.feed() so that bracketed-paste mode flushes buffered content as a normal BracketedPaste event after 2 seconds without an end marker, then restores normal parsing. Includes 8 regression tests covering normal paste, timeout recovery, torn end marks, and edge cases. Surgical reapply of PR #27518. Original branch was many months stale (1193 files / 172k LOC of unrelated reverts); the substantive ~77 LOC patch in cli.py plus the new 157-line test file were reapplied onto current main with the contributor's authorship preserved via --author.

…o Tranquil-Flow (PR #27518)

teknium1 · 2026-05-25T12:07:29Z

Merged via PR #32018 (surgical reapply onto current main — your original branch was stale and a direct cherry-pick would have reverted 1,193 unrelated files). Your authorship is preserved in git log. Issue #16263 closed by the merge. Thanks!

…usResearch#16263) When the terminal drops the ESC[201~ end mark during a bracketed paste (terminal race, torn write, SSH glitch, macOS sleep/wake), prompt_toolkit's Vt100Parser keeps buffering all later input in _paste_buffer forever. From the user's perspective, the CLI appears frozen — the only recovery was closing the tab/session. This patch monkey-patches Vt100Parser.feed() so that bracketed-paste mode flushes buffered content as a normal BracketedPaste event after 2 seconds without an end marker, then restores normal parsing. Includes 8 regression tests covering normal paste, timeout recovery, torn end marks, and edge cases. Surgical reapply of PR NousResearch#27518. Original branch was many months stale (1193 files / 172k LOC of unrelated reverts); the substantive ~77 LOC patch in cli.py plus the new 157-line test file were reapplied onto current main with the contributor's authorship preserved via --author.

…o Tranquil-Flow (PR NousResearch#27518)

…usResearch#16263) When the terminal drops the ESC[201~ end mark during a bracketed paste (terminal race, torn write, SSH glitch, macOS sleep/wake), prompt_toolkit's Vt100Parser keeps buffering all later input in _paste_buffer forever. From the user's perspective, the CLI appears frozen — the only recovery was closing the tab/session. This patch monkey-patches Vt100Parser.feed() so that bracketed-paste mode flushes buffered content as a normal BracketedPaste event after 2 seconds without an end marker, then restores normal parsing. Includes 8 regression tests covering normal paste, timeout recovery, torn end marks, and edge cases. Surgical reapply of PR NousResearch#27518. Original branch was many months stale (1193 files / 172k LOC of unrelated reverts); the substantive ~77 LOC patch in cli.py plus the new 157-line test file were reapplied onto current main with the contributor's authorship preserved via --author.

…o Tranquil-Flow (PR NousResearch#27518)

…usResearch#16263) When the terminal drops the ESC[201~ end mark during a bracketed paste (terminal race, torn write, SSH glitch, macOS sleep/wake), prompt_toolkit's Vt100Parser keeps buffering all later input in _paste_buffer forever. From the user's perspective, the CLI appears frozen — the only recovery was closing the tab/session. This patch monkey-patches Vt100Parser.feed() so that bracketed-paste mode flushes buffered content as a normal BracketedPaste event after 2 seconds without an end marker, then restores normal parsing. Includes 8 regression tests covering normal paste, timeout recovery, torn end marks, and edge cases. Surgical reapply of PR NousResearch#27518. Original branch was many months stale (1193 files / 172k LOC of unrelated reverts); the substantive ~77 LOC patch in cli.py plus the new 157-line test file were reapplied onto current main with the contributor's authorship preserved via --author. #AI commit#

…o Tranquil-Flow (PR NousResearch#27518) #AI commit#

…usResearch#16263) When the terminal drops the ESC[201~ end mark during a bracketed paste (terminal race, torn write, SSH glitch, macOS sleep/wake), prompt_toolkit's Vt100Parser keeps buffering all later input in _paste_buffer forever. From the user's perspective, the CLI appears frozen — the only recovery was closing the tab/session. This patch monkey-patches Vt100Parser.feed() so that bracketed-paste mode flushes buffered content as a normal BracketedPaste event after 2 seconds without an end marker, then restores normal parsing. Includes 8 regression tests covering normal paste, timeout recovery, torn end marks, and edge cases. Surgical reapply of PR NousResearch#27518. Original branch was many months stale (1193 files / 172k LOC of unrelated reverts); the substantive ~77 LOC patch in cli.py plus the new 157-line test file were reapplied onto current main with the contributor's authorship preserved via --author.

…o Tranquil-Flow (PR NousResearch#27518)

…usResearch#16263) When the terminal drops the ESC[201~ end mark during a bracketed paste (terminal race, torn write, SSH glitch, macOS sleep/wake), prompt_toolkit's Vt100Parser keeps buffering all later input in _paste_buffer forever. From the user's perspective, the CLI appears frozen — the only recovery was closing the tab/session. This patch monkey-patches Vt100Parser.feed() so that bracketed-paste mode flushes buffered content as a normal BracketedPaste event after 2 seconds without an end marker, then restores normal parsing. Includes 8 regression tests covering normal paste, timeout recovery, torn end marks, and edge cases. Surgical reapply of PR NousResearch#27518. Original branch was many months stale (1193 files / 172k LOC of unrelated reverts); the substantive ~77 LOC patch in cli.py plus the new 157-line test file were reapplied onto current main with the contributor's authorship preserved via --author.

…o Tranquil-Flow (PR NousResearch#27518)

alt-glitch added type/bug Something isn't working P1 High — major feature broken, no workaround comp/cli CLI entry point, hermes_cli/, setup wizard labels May 17, 2026

Tranquil-Flow force-pushed the fix/16263-bracketed-paste-timeout branch 2 times, most recently from 4f7a150 to 098643c Compare May 19, 2026 13:40

teknium1 mentioned this pull request May 25, 2026

fix(cli): bracketed-paste timeout prevents permanent input freeze (#16263) #32018

Merged

Tranquil-Flow force-pushed the fix/16263-bracketed-paste-timeout branch from 098643c to d9bbb4e Compare May 25, 2026 11:03

teknium1 added a commit that referenced this pull request May 25, 2026

chore(release): map 66773372+Tranquil-Flow@users.noreply.github.com t…

1c71e9c

…o Tranquil-Flow (PR #27518)

teknium1 added a commit that referenced this pull request May 25, 2026

chore(release): map 66773372+Tranquil-Flow@users.noreply.github.com t…

4909dd8

…o Tranquil-Flow (PR #27518)

teknium1 closed this May 25, 2026

daletkc pushed a commit to daletkc/hermes-agent that referenced this pull request May 25, 2026

chore(release): map 66773372+Tranquil-Flow@users.noreply.github.com t…

3c2c9fa

…o Tranquil-Flow (PR NousResearch#27518)

mathias3 pushed a commit to mathias3/hermes-agent that referenced this pull request May 28, 2026

chore(release): map 66773372+Tranquil-Flow@users.noreply.github.com t…

b7517a7

…o Tranquil-Flow (PR NousResearch#27518)

Bryce-huang pushed a commit to wbkunlun/hermes-agent that referenced this pull request May 29, 2026

chore(release): map 66773372+Tranquil-Flow@users.noreply.github.com t…

2310bd8

…o Tranquil-Flow (PR NousResearch#27518) #AI commit#

mosaiq-systems pushed a commit to mosaiq-systems/hermes-agent that referenced this pull request May 29, 2026

chore(release): map 66773372+Tranquil-Flow@users.noreply.github.com t…

563116b

…o Tranquil-Flow (PR NousResearch#27518)

gweeteve pushed a commit to gweeteve/hermes-agent that referenced this pull request Jun 2, 2026

chore(release): map 66773372+Tranquil-Flow@users.noreply.github.com t…

5cd39a3

…o Tranquil-Flow (PR NousResearch#27518)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

fix(cli): bracketed-paste timeout prevents permanent input freeze#27518

fix(cli): bracketed-paste timeout prevents permanent input freeze#27518
Tranquil-Flow wants to merge 1 commit into
NousResearch:mainfrom
Tranquil-Flow:fix/16263-bracketed-paste-timeout

Tranquil-Flow commented May 17, 2026 •

edited

Loading

Uh oh!

teknium1 commented May 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

Tranquil-Flow commented May 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do?

Related Issue

Type of Change

Changes Made

How to Test

Checklist

Code

Documentation & Housekeeping

Screenshots / Logs

Uh oh!

teknium1 commented May 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Tranquil-Flow commented May 17, 2026 •

edited

Loading