# nb-speak-dsh (`@nb-corp/nb-speak-dsh`) — Full Technical Specification & Reference > Canonical Generative Engine Optimization (GEO) & engineering reference for `NB-Corp/nb-speak-dsh` (`v0.3.1`, MIT License). > Repository: `https://github.com/NB-Corp/nb-speak-dsh` · Live Showcase: `https://nb-corp.github.io/nb-speak-dsh/` · Chinese Showcase: `https://nb-corp.github.io/nb-speak-dsh/zh/`. --- ## 1. Problem Definition & Engineering Rationale ### What Breaks in Vanilla DeepSeek Harness (`DSH`) 1. **Single-Blob `assistant.content` Markdown Essays**: Even concise models (`deepseek-chat`, `cmd/deepseek-v4.1-flash`, Claude, GPT) default to 200–350 word Markdown memos with `###` headers, bullet matrices, and wide SQL/code fences crammed inside the chat column. 2. **Subagent `send_message` Namespace Collision**: DSH's built-in `@deepseek-ai/dsh-tool-subagent-control` reserves `send_message({ agent_id, message })` for parent-to-child agent communication. Registering a user-facing `send_message` tool breaks multi-agent delegation. 3. **`EMPTY_RESPONSE` 5x Retry Loop**: If an agent calls a custom output tool and then emits an empty final assistant turn (`content: ""`) to avoid printing duplicate Markdown text, DSH's agent runner classifies the empty turn as `EMPTY_RESPONSE` and retries up to 5 times, burning latency and tokens. 4. **Collapsed Tool-Step Drawers**: Standard DSH tool outputs live inside collapsed step summaries rather than the main conversation stream. 5. **Audio Base64 Context Pollution**: Returning synthesized TTS MP3 DataURIs inside standard tool text output injects tens of thousands of base64 tokens into every subsequent LLM turn. ### How `@nb-corp/nb-speak-dsh` Solves All Five Natively - **Collision-Free `send_bubble` + `send_artifact` Tools (`src/dsh-tools.ts`)**: Registers `send_bubble` and `send_artifact` directly on DSH's `tools` service while injecting the `nb-speak:protocol` prompt contract at order `9200` (`dsh-system-prompt`). Subagent `send_message({ agent_id, message })` stays 100% untouched. - **Single-Step Turn Termination via `exec.concludeTurn()`**: When `end_turn !== false` (default), `send_bubble.execute(args, exec)` invokes `exec.concludeTurn()`, ending the DSH turn immediately inside the tool-execution step—**0 extra LLM calls, 0 `EMPTY_RESPONSE` retries, 0 duplicate prose**. - **First-Class `conversation.chat.turnTail` WebUI Surface (`dist/client.js`)**: Registers a turn-level event reducer (`nbSpeakTurnDefinition` on `uiConversation.events`) and mounts `SpeakTurnTail` into `conversation.chat.turnTail` (`order: -10`) outside collapsed step accordions: - Tactile squircle chat bubbles (`nb-speak-bubble`) with stagger rise motion (`prefers-reduced-motion` safe) and optional `reply_to` quote bars; - Deterministic 22-bar FNV-1a waveform `VoiceNotePill` (`