dsh-turn-fold
English | 简体中文
A dsh-harmony provider that adds
Codex-Desktop-style turn folding to the DSH WebUI conversation.
https://github.com/user-attachments/assets/3c9dfdcf-a454-4750-9edf-76771ed5a9a6
During a turn, the summary bar remains visible while native thinking, notes,
commands, and tool calls keep streaming. Consecutive reasoning, context
injections, and tool activity share one compact group from the second item
onward. When a turn settles, known
Agent activity, including context injection, moves into one disclosure
immediately before the final answer. Its configurable metrics default to wall
time, tool-call count, and input/output tokens, and appear only when the loaded
turn contains enough data to calculate them without guessing.
The final answer is located through turn-tail.closing.finalNode, not
finish_reason or DOM position. Completed, stopped, and interrupted turns fold,
with distinct status labels for the latter two. A turn remains expanded when
DSH marks its closing branch unavailable, when any later node follows the
closing answer, or while the user has keyboard focus or an active text selection
inside its activity. Failed, max-token, closing-less, and open turns also stay
expanded so errors and unfinished work are never hidden.
Expanding reuses the original native node renderers, so tool details, copy, and
file links keep working. Open turns are remembered per session and turn while
the WebUI remains loaded. The disclosure has keyboard-visible focus, accessible
state and action labels, responsive wrapping, reduced-motion handling, and a
short open/close transition that unmounts the activity after it closes.
How it works
On DSH versions with native message folding, Turn Fold takes over: it removes
the native process disclosure and disables native node folding, leaving the
plugin's turn summary and activity groups in control. Support is detected from
the chat renderer's compactTranscript or usePresentation prop rather than the CLI version.
DSH still renders reasoning, tools, and context. Saved native display preferences
are unchanged, so disabling the plugin restores native folding.
Three shape-guarded Source Patches run in memory against the compiled browser
bundle. For DSH 0.1.0-rc.8 through 0.1.1-rc.2, they target
@deepseek-ai/dsh-client-ui-conversation; for DSH 0.1.2-alpha.5 through the
0.1.7 line (including prereleases), they follow the renderer into @deepseek-ai/dsh-client-ui-chat.
Installed DSH files are never modified. Every selector must still match exactly
once, so an incompatible compiled shape fails closed instead of modifying an
uncertain target.
| Patch | Selector (expect 1) | Effect |
|---|---|---|
inject-turn-fold-runtime |
FunctionDeclaration[name.name="ChatView"], VariableStatement:has(VariableDeclaration[name.name="ChatView"]) |
Injects the fold renderer + disclosure UI into either native or decorated ChatView |
rewrite-node-render-loop |
legacy order.map(...) / 0.1.2 ChatNodeList call |
Replaces the version-specific native node-list seam with the per-turn renderer |
install-turn-fold-services |
VariableStatement:has(VariableDeclaration[name.name="t"][initializer.expression.name.name="bind"]) |
Registers the bundled English and Chinese dictionaries through DSH's native locale service and binds the native settings scope |
Install
dsh plugin --profile web add github:memorax-ai/dsh-turn-fold
dsh harmony status --profile web # all three patches must be `bound`
Test
node test/run.cjs
npm install installs the dependencies required by the test harness. The test
suite applies all three patches to both supported compiled shapes in memory, parses the final browser bundles, and
covers completed, split-activity, post-closing, partial-history, failed,
interrupted, open, accessibility, localization, settings, and state-retention
behavior. A missing target or selector mismatch fails the test; it is never
reported as a skipped pass.
CI and release
GitHub Actions runs the test suite and a package dry run for every pull request
and every push to main. Version tags publish to npm through Trusted Publishing
(OIDC), without a long-lived npm token.
Configure the npm trusted publisher once:
npx npm@^11.15.0 trust github @ch4acko3/dsh-turn-fold \
--repo memorax-ai/dsh-turn-fold \
--file release.yml \
--allow-publish
Then create and push a version tag whose value matches package.json:
npm version patch
git push --follow-tags
Compatibility checks cover the real 0.1.5-rc.2, 0.1.6-alpha.2, and 0.1.7-rc.2 bundles. Run npm test with DSH_TURN_FOLD_UPSTREAM_ROOT pointing to an isolated DSH installation to exercise that chat bundle. Exact selector counts remain required.
DSH 0.2.0-rc.2 is also supported explicitly. Its runtime uses configForms, a Plugins settings tab, live configuration fields, and the renamed native icons. Turn Fold reads the timeline through the native chat hook when the renderer has no local timeline binding, and accepts the native duration formatter's numeric/unit segments. Windows browser checks cover combined startup with Bites, editing metrics, persistence across a Host restart, and replaying a synthetic two-turn session written through native session persistence. Seeking back hides later turns, playback disables input, and exiting restores input. This does not cover real model calls or browser interactions on macOS/Linux. The 0.2 range is limited to this tested release.
