README.md

🧪 dsh-mock

⚠️ Unstable release: dsh-mock@0.1.1 is available for early testing. The command, API, and UI surface may change before a stable release.

📦 Install

Add the plugin to the DSH web profile with one command:

dsh plugin --profile web add dsh-mock@0.1.1

Or install the npm package directly:

npm install dsh-mock@0.1.1

This is an external Cordis plugin. It registers the internal per-turn provider route mock with the mock model and routes accepted /mock run and /mock replay commands through the public AgentLoop request waterfall. The route is deliberately omitted from the advertised model catalog, so the normal model selector remains unchanged; only the slash command activates it. The plugin also registers mock in the public slash-command catalog, and its command handler queues the exact line as a normal AgentLoop follow-up. The adapter emits ordinary model chunks; the host AgentLoop and ToolRuntime execute and record the actual calls.

Replay is read-only and in-memory. A relative path is resolved against the current session's absolute session.header.cwd; when that value is missing, relative paths are rejected. Absolute paths are accepted for read-only input, and the plugin never creates, copies, rewrites, renames, or deletes a replay source. --overwrite-wait-time-ms changes only explicit waits in the detached canonical plan.

The plugin emits ephemeral mock/status events for a host UI bridge. The bridge should render a compact status row above the existing composer and leave normal DSH tool/result/error cards authoritative.