klarkxy's DSH plugins

Session Recap

@klarkxy/dsh-recap

Write session recaps in the background and give the agent bounded progress checkpoints.

Install

 dsh plugin --profile web add @klarkxy/dsh-ai-services
 dsh plugin --profile web add @klarkxy/dsh-recap

This plugin depends on AI Services; the commands install them in order.

Replace web with your profile name. Restart the profile after installing; the plugin then shows up under Settings → Plugins.

About

From README.md in 0.1.4.

简体中文

Background recap generation and separate agent checkpoints. The plugin starts enabled and can be switched off under Settings → Plugins. Recaps, agent checkpoints, and semantic checkpoints use fixed automatic defaults. Recaps are display-only and are not model context.

Requires Node.js ≥22 and DSH 0.1.7-rc.2. Auxiliary generation requires @klarkxy/dsh-ai-services. @deepseek-ai/dsh-llm and @deepseek-ai/dsh-session are required peers.

dsh plugin --profile web add @klarkxy/dsh-ai-services
dsh plugin --profile web add @klarkxy/dsh-recap

Long turns and returning after the idle interval (default 15 minutes of focused document/user activity, not assistant streaming, and not while the chat panel is hidden) can generate recaps in the background. The chat events seat is a quiet lifecycle controller and renders no card, button, empty state, or error. There is no separate Recap settings page or manual generation control. Status reads do not call the model; each watermark gets at most one generation unless you retry. Checkpoints are injected only at host agent/pre-step on meaningful boundaries, using native createUserMessage.

When Mood is active in the same profile, Recap reads its task contract through ctx.aiMood.getContract(sessionId) for checkpoint context.

Turning either ability off cancels in-flight generation and stops auto injection. Stored recaps remain. Unloading the plugin waits for pending writes and ignores later session events.

From the repository root:

pnpm --filter @klarkxy/dsh-recap typecheck
pnpm exec vitest run packages/dsh-recap/src
pnpm --filter @klarkxy/dsh-recap build

The Editor preinstalls this feature enabled. In the Editor, use Settings → Plugins to switch it without restarting. Standalone DSH must load @klarkxy/dsh-ai-services before this package; installation or removal may require a restart when the host asks for one.