dsh-queue-reorder

dsh plugin --profile web add dsh-queue-reorder

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-checked

agent/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 hidden

conversation.input.dock entry (which renders null) reads the session

snapshot for the queued ids and their order — the dock's DOM carries no ids —

and a MutationObserver decorates 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