DSH compatibility

August 16, 2026 ยท View on GitHub

Status for DSH 0.1.0-rc.6 and the multi-agent paths that create agents.

Supported creation paths

PathHow it reaches the dockLoop selection sourceStatus
DSH Web session create/resumectx.agents.create/resume with preset setuprecorded agentLoopDock binding, then meta.agentPreset mapped through presetLoopsimplemented
Declarative agent-loop-dock.agentsdock calls ctx.agents.create/resumeagents[].loop / agents[].driverimplemented
Programmatic plugin callersctx.agents.create/resumeoptions.loop / options.driverimplemented
subagent / subagent_forkctx.agents.createchild meta.agentPreset from parenttransparent, setup order verified
workflow / ralph spawned childrenctx.agents.create through their providerschild meta.agentPreset when presentexpected transparent; live E2E pending
Natural-language team creation from chatdoes not exist yetwould need a new model-facing toolnot implemented

Important integration rule

DSH Web and in-process subagent providers already compose the preset through the caller's setup before an agent is published. Dock strategy setups run after that caller setup. Built-in preset loops check agentPresets.composedPreset(agentCtx) and skip their own mount when a composition already exists, so:

  • Web-created sessions do not double-mount;
  • subagents joining their parent preset do not double-mount;
  • declarative dock agents with no caller setup still get the preset mounted.

This is covered by unit tests and should be re-verified against a live Web profile before a release.

Live E2E checklist before publishing

  • Install dsh-loop-dock into the Web profile and restart.
  • Create two sessions: one shipped preset mapped to standard, and one user-registered loop mapped through presetLoops.
  • Restart DSH and confirm each session resumes on its recorded loop and driver (agent-preset/selected data.agentLoopDock; fallback for unrecorded sessions is SessionHeader.agentPreset โ†’ presetLoops).
  • From one session, call subagent and verify the child is created without a preset double-mount error.
  • Test subagent_fork.
  • Test workflow / ralph if those tools are enabled by the preset.
  • Restart DSH and verify configured declarative agents resume their persisted sessions and loops.