dsh-retrace

LIMITATIONS

Known limitations

- **Optional dependency (deliberately NOT in `package.json`)**: AI summaries need an `llm` service from the host (the official `@deepseek-ai/dsh-llm`, bundled with DSH Desktop). The plugin takes it **dynamically** via `ctx.get('llm')`: present ⇒ summaries available, absent ⇒ it degrades to **verbatim excerpts only**. Install and startup are unaffected either way. Model and credentials follow the session's own default selection (`agentDefaultModel.currentSelection()`); the plugin adds **no configuration surface of its own**. Summaries sit behind a **default-off** switch (at most one small call per operation: ≤6×400 chars in, ≤200 tokens out, 5 s timeout); when it is off there are **zero LLM calls**, while the verbatim excerpt (zero token cost) is **always recorded**. - Only **user messages** can be edited; recall works on user and assistant messages. Tool results are shadowed along with the recalled range but are not themselves recall targets. - The agent must be **idle**: while a reply is streaming you must stop it (⏹) before recalling or editing. The Host rejects with `agent-busy` otherwise. - Recall/edit operate on the **active model surface**: a message that was already compacted away or previously recalled is rejected (`target-shadowed`). - Regenerate re-sends only the **text** of the original prompt; prompts that carried images fall back to the text-only content. ---