dsh-queue-reorder
Reorder the messages you queued while a DSH agent was busy — inside the official queue dock, not in a panel beside it.

What you get
- A grip handle on every queued row: drag a message where you want it.
- ↑ / ↓ per row, wearing the dock's own action-button class, for precision instead of a drag. The last row's ↓ is disabled, because there is nothing after it.
- The dock is decorated, never replaced. Previews, inline editing, steering, removal, attachments and collapse stay exactly as the conversation plugin ships them; uninstall and the dock is untouched.
Install
dsh plugin --profile web add -w dsh-queue-reorder
# restart dsh web, then reload the page
Requires DSH >=0.1.2-alpha.1 <0.2.0-0 (earlier client-plugin contracts have no
conversation.input.dock slot). From a checkout instead:
dsh plugin --profile web add -w link:/absolute/path/to/dsh-queue-reorder
Uninstall:
dsh plugin --profile web remove dsh-queue-reorder
Design
Two small halves, no build step, no runtime dependencies:
- Host (
lib/index.js) registers one same-origin route,POST /queue-reorder, and performs a single concurrency-checkedagent/inbox.splice('next-turn', …)over the smallest span containing both ends of the move. - Browser (
lib/client.js) is a hand-authored module-loader bundle. A hiddenconversation.input.dockentry (which rendersnull) reads the session snapshot for the queued ids and their order — the dock's DOM carries no ids — and aMutationObserverdecorates the official rows. It re-reads each row's position at click and drag time, because the dock reorders those very elements in place.
What it refuses, and why
| Refusal | Reason |
|---|---|
QUEUE_CHANGED |
Your view of the queue no longer matches the live queue; retry rather than scramble it. |
NON_USER_MESSAGE |
The move would discard and reinsert a row whose source the harness still tracks (a goal round prompt, for example), cancelling that work. |
SUBAGENT_UNSUPPORTED |
A subagent session's queue is owned by its parent session. |
| Steering rows | Only next-turn (placement: "queued") rows move; next-step stays put. |
A refused move changes nothing: every guard runs before the splice.
Caveats
- The decorator attaches to the official dock's markup (
[data-queue-dock], its row list, the trailing action container). Those are implementation details of@deepseek-ai/dsh-client-ui-conversation, not a published contract: if the dock is restructured, the controls may stop appearing. It fails soft — the dock keeps working, you just lose the grip until this plugin catches up. - Verified on DSH 0.1.5-rc.1, in a browser and through
selftest.mjs. - The route answers on the loopback interface without the GUI's session cookie, like other plugin HTTP routes. A cross-site browser request is still blocked: the JSON content type forces a CORS preflight that the route answers with 405.
Tests
node selftest.mjs
No network, no browser, no build. 32 assertions covering the move transaction, every refusal, the request decoder, the HTTP surface, and the dock decoration (injection idempotence, live index reads, drop marking, notice reporting).
License
MIT
No comments yet. Be the first to write one.