dsh-subagent-concurrency-limit

Limit how many DeepSeek Harness subagent runs and local child-agent turns run at the same time in one process. The root Agent is not counted.

Why it is needed

In DeepSeek Harness dsh-v0.1.1-rc.2 (commit b150a551b8d465e31e418e1b2eaf5e79bbb7d28e), the workflow engine's maxConcurrentAgents and maxTotalAgents apply to agent() calls inside each workflow run. The standard subagent tool has no process-wide limit for root-level direct runs outside a workflow. maxParallelToolCalls limits the dispatch pool for parallel-safe tool calls in one Agent step, not the number of background or continuable runs.

This plugin fills that gap by limiting concurrent root delegation admissions and local descendant Agent turns in one process.

Scope

The plugin limits the delegation tools listed in subagentToolNames and local Agent turns in the same process where delegationDepthOf(agent) > 0. They share one process-local pool. The default limit is 2.

• A root Agent's delegation call waits in FIFO order before creating a child.
• Add nonstandard delegation tool names to subagentToolNames.
• Nested children that call the same delegation tool also consume the pool. If a permit is available, they take it immediately; when the pool is full, they fail without waiting so a child cannot block the ancestor that is waiting for it.
• Workflow agent() calls and resumed local child turns use the same pool when their Agent turn starts.
• A permit is released when the child turn becomes idle, the run ends, or the Agent is disposed.
• For remote-process providers such as Codex, Claude Code, and ACP, only the configured root delegation admission and the observable subagent/start and subagent/end boundaries are visible. Nested execution and restarts inside the remote process cannot be counted.
• maxParallelToolCalls is independent because it limits tool calls, not live runs.

Install

These examples use the web profile. Replace web with your profile name in each command and path.

Install the plugin:

dsh plugin --profile web add \
  github:blauerberg/dsh-subagent-concurrency-limit#01182275695067510a187cb05b46df49e5fe812c

Git installs fetch the source and build lib/ with the package's prepare script. With pnpm 10 or later, the first command may stop because that build is not allowed. Add the revision-specific key to the profile's workspace file (keep any existing allowBuilds entries):

# $DSH_HOME/profiles/web/pnpm-workspace.yaml
allowBuilds:
  'dsh-subagent-concurrency-limit@https://codeload.github.com/blauerberg/dsh-subagent-concurrency-limit/tar.gz/01182275695067510a187cb05b46df49e5fe812c': true

Save the file, then rerun the install command above. The commit hash used in both places identifies v0.1.0. Installing another revision requires its commit hash in both places.

Add the plugin configuration to $DSH_HOME/profiles/web/cordis.patch.yml:

- id: subagent-concurrency-limit
  name: dsh-subagent-concurrency-limit
  config:
    maxConcurrentSubagents: 2
    subagentToolNames:
      - subagent

maxConcurrentSubagents must be a positive safe integer. subagentToolNames must contain at least one nonempty delegation tool name. The bundle patch applies the defaults above; edit the same keys to override them.

Start the profile:

dsh --profile web

Development

pnpm install
pnpm run check

License

The project is licensed under MIT.