dsh-codex-reasoning-router

简体中文 | English | AI / LLM context

A composable multi-model Agent Team plugin for DeepSeek Harness (DSH). Version 0.2 no longer requires a dedicated preset: it layers onto Standard, Code, or a user-defined preset.

Default roles:

• brain: tool-less deep reasoning, using openai-codex/gpt-5.6-sol at max.
• coordinator: tool-less decomposition and integration advice, using Sol at high.
• worker: a real tool-capable DSH subagent, using gpt-5.6-luna at max, with absolute maxDepth: 2.
• agent_team_catalog: reads the current user's registered providers, models, and model-specific reasoning efforts.
• agent_team_run: runs any configured advisory or subagent role.

The legacy luna-sol-reasoning-router preset and durable sol_consult state machine remain available, but route locking is disabled by default.

Install

Install and authenticate the model provider first, then add this plugin:

pnpm dsh plugin --profile web add dsh-codex
pnpm dsh plugin --profile web add link:/absolute/path/to/dsh-codex-reasoning-router

Or install from GitHub:

pnpm dsh plugin --profile web add github:chenmzh/dsh-codex-reasoning-router

Restart DSH and create a new session. Since 0.2, no preset copy or preset switch is needed. Copy preset/luna-sol-reasoning-router only when enabling the legacy route-guard workflow.

Configuration

See cordis.patch.yml for the complete default:

teamEnabled: true
presetIds: []                 # empty = all presets
roles:
  - id: brain
    kind: advisory            # tool-less one-shot reasoning
    description: Deep reasoning
    provider: openai-codex
    model: gpt-5.6-sol
    reasoningEffort: max
    maxTokens: 3000

  - id: coordinator
    kind: advisory
    description: Coordinate work
    provider: openai-codex
    model: gpt-5.6-sol
    reasoningEffort: high

  - id: worker
    kind: subagent            # real DSH child inheriting the current preset
    description: Implement and verify
    provider: openai-codex
    model: gpt-5.6-luna
    reasoningEffort: max
    subagentProvider: spawn
    maxDepth: 2               # absolute: root=0, descendants=1,2,...
    toolDeny: [web_search]     # optional; toolAllow is also supported

Roles may be added, removed, or renamed. Role ids must begin with a lowercase letter and contain lowercase letters, digits, _, or -.

The plugin does not guess model capabilities. It reads ctx.llm.listProviders(), listModels(), and resolveModelInfo() at runtime. Invalid model/effort combinations fail before provider dispatch. agent_team_catalog exposes the same live directory to the agent.

Preset composition

With the default presetIds: [], select whichever preset you already want:

Standard preset + agent team
Code preset     + agent team
custom preset   + agent team

In-process children inherit their parent's preset composition, workspace, delegated policy, and tools. The role then applies its own route, effort, persona, optional tool filter, and depth cap.

To limit the plugin to selected presets:

presetIds: [standard, code, my-review-preset]

Legacy Luna + Sol router

Restore the 0.1 behavior with:

requiredPresetId: luna-sol-reasoning-router
lunaProvider: openai-codex
lunaModel: gpt-5.6-luna
solProvider: openai-codex
solModel: gpt-5.6-sol
initialSolReasoning: medium
escalatedSolReasoning: high
initialConsultEnabled: true
failOpen: true

Copy and select the shipped preset. The old mode still provides a tool-less Sol advisor, validates the Luna root route, limits one blocker to two successful consultations, and restores escalation from durable session events. The 0.2 default requiredPresetId: '' disables only the legacy guard, not Agent Team.

Safety and runtime boundaries

• Advisory requests have no tools. A returned tool call is rejected and never dispatched.
• Workers use the native DSH subagent runtime; the provider enforces maxDepth on every start.
• Tool filters are composition visibility, not a new security sandbox. DSH sandbox and approval policy remain authoritative.
• Explicit model and effort selections are validated exactly; there is no silent fallback or model rewrite.
• Child reasoning effort is installed with agent-scoped installModelSelection before the child request.

Development

pnpm install --offline
pnpm run check
pnpm pack --dry-run

The test suite covers both the legacy router invariants and the new live catalog, effort validation, tool-less advisory, worker route/effort, tool filter, and absolute-depth behavior.

License

Apache-2.0. See LICENSE.