dsh-subagent-response-promoter

Readme

# dsh-subagent-response-promoter

A small Host-side Cordis plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness).

Continuable background subagents already wake their parent when an activation settles. If a parent is busy, the runtime places the manager-authored `subagent-settled` response in the next safe Agent step. This plugin stably promotes those responses ahead of ordinary context in that step, so the parent handles child callbacks first without polling or interrupting an in-flight model/tool call.

The built-in `send_message` tool submits a coordinator relay as the child's next turn. This plugin moves that relay to the child's `next-step` inbox while preserving the original wake, so a running child receives it at its nearest later step boundary instead of waiting for its current turn to finish.

## Behavior

Given one proposed Agent step:

```text
ordinary A, child response A, ordinary B, child response B
```

The model receives:

```text
child response A, child response B, ordinary A, ordinary B
```

A coordinator relay inserted into `next-turn` is durably removed and reinserted into `next-step`. The relocation does not cancel an active model request or tool call; it becomes visible only when the Agent reaches a safe step boundary. Other follow-up messages retain their ordinary next-turn behavior.

## Install in a DSH profile

Add the repository as a profile dependency and bundle:

```json
{
  "dependencies": {
    "dsh-subagent-response-promoter": "github:JachinShen/dsh-subagent-response-promoter#v0.2.0"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "dsh-subagent-response-promoter"
      ]
    }
  }
}
```

Then reinstall that profile and restart its DSH process. The package's `cordis.patch.yml` inserts the Host plugin automatically.

## Development

```bash
npm test
```

## License

MIT