dsh-model-router 0.6.3 → 0.7.1

package/README.md

@@ -2,10 +2,10 @@
 
 A small plugin for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) that stops treating every model call the same. It splits your session into two roles:
 
-- **The planner** — your main agent — always runs on `deepseek-v4-pro`. That's where the thinking happens: understanding what you want, designing the approach, reviewing results, writing the final answer.
-- **The executors** — every subagent it delegates to — always run on `deepseek-v4-flash`. That's where the work happens: writing code, running commands, iterating on builds.
+- **The planner** — your main agent — defaults to `deepseek-flash` (V4.1 Flash, native multimodal). That's where the thinking happens: understanding what you want, designing the approach, reviewing results, writing the final answer.
+- **The executors** — every subagent it delegates to — default to `deepseek-flash` as well.
 
-The idea is simple: pro is the better thinker, flash is fast and cheap at grinding through implementation. You get the careful planning of the big model without paying pro prices for every single tool call.
+Both roles share the same model until V4.1-Pro launches (V4.1 Flash already beats V4-Pro on performance, cost, and speed, so DeepSeek is retiring `deepseek-v4-pro` / `deepseek-v4-flash` / `deepseek-v4-flash-vision-exp` — all three now route to V4.1 Flash server-side). The role split stays in the config, so flipping the planner back to Pro later is a one-line change. You keep the careful plan/delegate/review rhythm without paying Pro prices for every tool call.
 
 ## Install
 
@@ -29,7 +29,7 @@ Once it's in, restart the profile. You should see the row under `model-router` i
 
 Three small surfaces, one rule:
 
-1. **Request routing** — every model request gets stamped with a role. Root agents get `deepseek-v4-pro`; delegation children (`subagent`, `subagent_fork`, workflow workers, ralph rounds) get `deepseek-v4-flash`. The rewrite sits at the outermost layer of the request pipeline, so it wins — even over the harness's own default model (which is `deepseek-v4-flash` out of the box) and over whatever model you pick in the UI for the session. That's intentional: it's the "enforce" knob.
+1. **Request routing** — every model request gets stamped with a role. Root agents get the planner route; delegation children (`subagent`, `subagent_fork`, workflow workers, ralph rounds) get the executor route. Both default to `deepseek-flash` (V4.1 Flash) until V4.1-Pro launches, so today the stamp unifies while the role split stays configurable. The rewrite sits at the outermost layer of the request pipeline, so it wins — even over the harness's own default model and over whatever model you pick in the UI for the session. That's intentional: it's the "enforce" knob.
 2. **A prompt section** — a short note that renders before the agent's persona, telling the planner: you're the thinker, delegate the implementation. Without this, the model tends to just do everything itself.
 3. **A skill** — the `pro-flash-routing` skill shows up in the session's skill catalog and spells out the working rhythm: plan, delegate, review, report. Same convention, but loadable on demand when the agent wants details.
 
@@ -46,11 +46,20 @@ Everything else is a planner. That logic lives in `src/policy.ts` as a plain fun
 
 The router always stamps `provider` + `model`. `reasoningEffort` and `maxTokens` are *optional per role*: set them in the config and they're enforced for that role; leave them out and those fields inherit from your session's selection. So picking "max effort" in the UI but not pinning `reasoningEffort` in the config still gives you max-effort thinking — it just happens on the routed model.
 
+### What still differs while the models are unified
+
+With both routes on `deepseek-flash`, the model stamp is a pass-through — but the roles are not identical:
+
+- **Effort and token pins are per role.** Planner `high` + executor `low`, for example, genuinely behaves and costs differently per role today.
+- **The convention still steers behavior.** The prompt section and skill keep the root agent planning and delegating instead of doing everything itself, regardless of model.
+- **Enforcement still pins the model.** Every request lands on `deepseek-flash` no matter what the session or UI selects.
+- **The split is parked, not removed.** When V4.1-Pro launches, pointing the planner route at it restores the two-model setup with a one-line change.
+
 ## Turning the router off
 
 Routing is on by default. Two ways to switch it off:
 
-- **GUI (Settings → Plugins → dsh-model-router):** the plugin registers a live
+- **GUI (Settings → Plugins → Model router):** the plugin registers a live
   settings section; flip `enabled` off. It applies immediately (no restart),
   persists in `settings.yaml` under `model-router:`, and unregisters the prompt
   section and the skill too. Flip it back on and everything returns. The same
@@ -68,15 +77,18 @@ Since v0.5.0 the package ships a browser half, and the harness serves it
 automatically — no extra config. After installing (or updating to) v0.5.0+
 and restarting the profile, **Settings → Plugins** shows a **Model router**
 card with a live **Enabled** switch, an "Overridden" badge and **Reset to
-default** button once you've changed it, and a read-only view of the current
-planner/executor routes and mode. Flipping the switch applies immediately (no
+default** button once you've changed it, a read-only view of the current
+planner/executor routes and mode, and a Vision section (v0.6.0+) with its own
+live **Vision** switch, **Reset vision to default** button, and read-only
+vision-model line. Flipping the switch applies immediately (no
 restart) and persists in `settings.yaml` under `model-router:` — the same
 mechanism the GUI toggle described above uses.
 
 One harness-wide caveat (it applies to **all** settings pages — Models,
 Plugins, everything — not to this plugin specifically): the harness serves
 settings pages only to **loopback** browsers (`localhost` / `127.x`). A remote
-browser sees "settings are unavailable" instead of the card. Fallbacks that
+browser may not get the settings page at all; where the card does render it
+shows a read-only note. Fallbacks that
 work everywhere:
 
 - **Patch row** — set `enabled: false` in the profile's `cordis.patch.yml`
@@ -93,31 +105,45 @@ and off by default** (`vision.enabled: false`). Two ways to turn it on:
   no restart, persists in `settings.yaml`), or
 - **Patch row / settings:** set `vision.enabled: true` on the plugin's config.
 
-When enabled, **any request whose messages carry an image is stamped with the
-vision model** — `deepseek-v4-flash-vision-exp` from `deepseek-official` by
-default — **from every role**: the root (planner) agent and all delegated
-subagents. Everything else keeps the pro/flash role routing untouched. The
-vision branch is checked first, so a subagent reading an image still lands on
-the vision model, not on flash. Optional `vision.reasoningEffort` /
+When enabled, **any request sent while the session log carries an image is stamped with the
+vision model** — `deepseek-flash` from `deepseek-official` by
+default (V4.1 Flash is natively multimodal, so this matches the role routes
+unless you pin something else) — **from every role**: the root (planner) agent and all delegated
+subagents. Everything else keeps the role routing untouched. The
+vision branch is checked first, so an image-bearing request lands on the
+vision model even when it comes from a subagent. With the default config the
+vision model is the same `deepseek-flash` as the role routes, so the branch
+is a no-op until you pin a different vision model. Optional `vision.reasoningEffort` /
 `vision.maxTokens` pins work exactly like the per-role ones. Image detection
 reads the session event log (`user/message`, `assistant/message`, and
 `tool/result`, including images nested in `tool-result` blocks): once an image
 appears anywhere in the log, subsequent requests stay on the vision model for
 the rest of the session (sticky — the image stays in request context until
-compaction or pruning drops it).
+compaction or pruning drops it). Detection shapes are verified against real
+session logs: `user/message` carries the image at `data.content`, while
+`assistant/message` and `tool/result` carry it at `data.message.content`
+(tool results nest it inside a `tool-result` block). Possible follow-up:
+optional `vision.historyLimit` to bound the scan to the trailing N events
+(unset keeps today's sticky entire-log scan).
 
 The plugin ships the support in its own `cordis.patch.yml`:
 
-- a **catalog entry** for the vision model on the `llm-deepseek` row (with
-  `inputModalities: [text, image]`, plus raised `contextWindow`/`maxTokens`
-  restated for the pro/flash rows), and
+- a **catalog entry** for `deepseek-flash` on the `llm-deepseek` row (with
+  `inputModalities: [text, image]`, `contextWindow: 1000000`, `maxTokens:
+  384000`), plus the retired `deepseek-v4-flash` / `deepseek-v4-pro` /
+  `deepseek-v4-flash-vision-exp` ids kept as compat aliases through the
+  transition, and
 - **raised `attachment-local` image admission limits** so normal screenshots
   (~8K, 15MB) attach without being rejected (`maxImageDimension: 8192`,
   `maxImagePixels: 100000000`, `maxImageBytes: 15728640`).
 
 Both are defaults you can override in your **profile**'s `cordis.patch.yml` —
 the profile layer applies after the plugin layer, so a `patch:` targeting
-`llm-deepseek` or `attachment-local` in the profile wins. One hard requirement
+`llm-deepseek` or `attachment-local` in the profile wins. Note these are
+id-targeted rows that **replace the whole row config** (not a deep merge):
+installing the plugin resets `llm-deepseek` to exactly those 4 models and
+`attachment-local` to exactly those 3 image keys — restate anything else you
+need in the profile layer. One hard requirement
 remains: the vision model **must be present in the catalog with image input
 modality**, or the provider rejects the request at call time with
 `UNSUPPORTED_CONTENT` — the shipped catalog row is what satisfies that.
@@ -130,14 +156,14 @@ All configuration lives on the plugin row. Patch it in the profile's `cordis.pat
 - patch:
     - id: model-router
       config:
-        planner:            # root-agent route
+        planner:            # root-agent route (deepseek-flash until V4.1-Pro lands)
           provider: deepseek-official
-          model: deepseek-v4-pro
+          model: deepseek-flash
           reasoningEffort: high   # off | low | high | max (omit to inherit)
           maxTokens: 8192         # output cap (omit to inherit)
         executor:           # subagent route
           provider: deepseek-official
-          model: deepseek-v4-flash
+          model: deepseek-flash
           reasoningEffort: high
           escalateOnError: true   # after a failed step…
           escalateTo: max         #   …bump effort for the next request
@@ -147,19 +173,20 @@ All configuration lives on the plugin row. Patch it in the profile's `cordis.pat
         skill: true         # register the pro-flash-routing skill
 ```
 
-`mode` controls how the root agent is treated: `strict` keeps it on the planner route always; `plan` sends the root to the executor route unless plan mode is active, reserving pro for real planning.
+`mode` controls how the root agent is treated: `strict` keeps it on the planner route always; `plan` sends the root to the executor route unless plan mode is active, reserving the planner route for real planning.
 
 **Error-driven escalation** (`escalateOnError`): when a route's agent hits a failed tool step, the *next* request bumps to `escalateTo` and wears off after `recoverySteps` clean steps. It's deterministic and stateless — the router folds the session log per request, so only prior steps are considered (a failure can't escalate the very request that caused it). It's a per-route knob: enable it on the executor to make flash think harder after a flubbed execution step, without touching the baseline.
 
-The defaults are exactly the table at the top of this page. To switch the router off for a session, disable the row (`disabled: true`) or remove the plugin — `dsh plugin --profile web remove dsh-model-router`.
+The model defaults are exactly the two routes at the top of this page. To switch the router off for a session, disable the row (`disabled: true`) or remove the plugin — `dsh plugin --profile web remove dsh-model-router`. If even the convention surface is unwanted until V4.1-Pro lands, flip `enabled` off (see above) and leave the plugin installed — everything unregisters and you flip it back on later.
 
-## Reduce pro token usage
+## Reduce token usage
 
-The planner is the expensive model, so most of the savings come from shrinking its spend:
+With both roles on `deepseek-flash`, the bill is already far below the old
+pro-based setup — most of the remaining savings come from shrinking spend:
 
-- **Lower `reasoningEffort`.** The harness default runs pro at `max`, which produces a lot of reasoning tokens. `high` (or `low`) on the planner route keeps most of the quality at a fraction of the cost.
+- **Lower `reasoningEffort`.** The harness default runs at `max`, which produces a lot of reasoning tokens. `high` (or `low`) on a route keeps most of the quality at a fraction of the cost.
 - **Cap output** with `maxTokens` on the planner route so a verbose turn can't balloon.
-- **Reserve pro for planning** with `mode: plan` — trivial Q&A and execution-style turns stop hitting pro at all.
+- **Reserve the planner route for planning** with `mode: plan` — trivial Q&A and execution-style turns stop hitting the planner route at all (matters again once V4.1-Pro lands and the routes split).
 - **Keep the planner's context lean.** Input tokens dominate after reasoning. Delegate aggressively and trust the subagent's report; don't re-read big files or full transcripts on the planner. Use targeted reads and let auto-compaction (`/compact`) trim history.
 - **Tune the host pruner.** The tool-result pruner truncates oversized results before they reach the model (default ~8 KB); lowering `tool-result-pruner` → `thresholdChars` trims more planner input. That's harness config, not this plugin's row.
 - **Exploit DeepSeek's context cache.** Repeated prefixes are served from cache at a big discount, so keep the system prompt and conversation prefix stable between turns.
@@ -168,14 +195,30 @@ The first three are one-line changes on this plugin's row; the last three are di
 
 ## Does it work?
 
-I verified it against a real session log. Run a task that makes the agent plan and delegate, then check which models actually made the requests:
+Verify against a real session log. Run a task that makes the agent plan and delegate, then check which models actually made the requests:
 
 ```bash
 zstd -d -c "$DSH_HOME"/sessions/<workspace>/<session>/session.jsonl.zstd \
-  | grep -o '"model":"deepseek-v4-[a-z]*"' | sort | uniq -c
+  | grep '"type":"assistant/message"' \
+  | grep -o '"model":"deepseek-[a-z-]*"' | sort | uniq -c
 ```
 
-Planner messages come back as `deepseek-v4-pro`; subagent messages as `deepseek-v4-flash`. In my test: 9 pro requests in the planner's session, 6 flash in the subagent's.
+Two details matter in that command: filtering to `assistant/message` counts only real model responses
+(the raw log also records `request/header`, session-title, and web-search calls, which would inflate
+the numbers), and the `[a-z-]*` pattern keeps hyphenated model names
+(`deepseek-flash`, legacy `deepseek-v4-flash-vision-exp`) intact — a plain
+`[a-z]*` silently truncates them.
+
+Since v0.7.0 both roles log `deepseek-flash` (unified until V4.1-Pro lands and
+the planner route points at it). For reference, the v4-era split re-verified
+against production logs: a root session with delegations showed 170 pro / 182
+flash responses, and every child session (`delegationDepth >= 1`) showed flash
+only; with vision routing enabled, an image-heavy session logged 508
+`deepseek-v4-flash-vision-exp` responses.
+
+One operational note: the routing rewrite is loaded at harness boot. After updating the plugin (e.g.
+0.6.3 → 0.7.0), restart the profile — a session that keeps running across the update can keep behaving
+per the old code until the process reloads.
 
 ## Development
 
@@ -190,6 +233,19 @@ npm run build
 
 The `prepare` script builds `lib/` automatically, which is what makes the git install work without shipping build artifacts in the repo. The `dsh.bundle` field in `package.json` is what tells `dsh plugin` how to compose the plugin into a profile.
 
+## Releasing
+
+Pushing a tag alone does not make a release. Every version needs all four:
+
+```bash
+npm run typecheck && npm test && npm run build  # green first
+git tag vX.Y.Z && git push origin main && git push origin vX.Y.Z
+gh release create vX.Y.Z --title "vX.Y.Z" --notes "<CHANGELOG entry>"
+npm publish --access public  # needs login + 2FA (--otp) or a publish token
+```
+
+Keep `vX.Y.Z` flagged as Latest (`gh release edit vX.Y.Z --latest`) when backfilling older ones. Note: `scripts/publish.sh` is a one-shot bootstrap for a brand-new repo, not the per-release path.
+
 ## License
 
 MIT

package/cordis.patch.yml

@@ -9,16 +9,17 @@
     - id: model-router
       name: 'dsh-model-router'
       config:
+        # Both roles default to deepseek-flash (V4.1 Flash, native multimodal).
         # The session's root agent: planning, design, review, synthesis.
         planner:
           provider: deepseek-official
-          model: deepseek-v4-pro
+          model: deepseek-flash
           # reasoningEffort: high   # optional: off | low | high | max (omit to inherit)
           # maxTokens: 8192        # optional output-token cap (omit to inherit)
         # Every delegated subagent: code writing and execution.
         executor:
           provider: deepseek-official
-          model: deepseek-v4-flash
+          model: deepseek-flash
           # reasoningEffort: high
           # maxTokens: 16384
           # escalateOnError: true   # v1: after a failed step, escalate effort
@@ -29,31 +30,47 @@
         #         falls back to the executor route to reserve pro for planning.
         mode: strict
         # enabled: false  # off switch — GUI: Settings → Plugins → model-router (live, no restart); patch row needs a reboot
-        # vision.enabled: true  # route image-bearing requests to deepseek-v4-flash-vision-exp
+        # vision.enabled: true  # native on deepseek-flash; only enable to pin a distinct vision route
         # GUI: Settings → Plugins → "Model router" card (v0.5.0+, loopback browser only)
         # Publish the always-on routing convention prompt section.
         promptSection: true
         # Register the `pro-flash-routing` skill in the session catalog.
         skill: true
-# Vision support: the catalog must list the vision model with image input, and
-# image admission limits are raised so normal screenshots (~8K, 15MB) attach.
+# Vision support: deepseek-flash (V4.1 Flash) is natively multimodal, so the
+# catalog lists it with image input. Legacy v4 names are kept as compat
+# aliases (retired server-side, routed to V4.1 Flash): they let existing
+# configs keep working through the transition. Max output is 384K per the
+# current Models & Pricing page (was 256K on the v4 preview docs).
 # Direct id-targeted entries (same shape as a profile cordis.patch.yml): they
-# replace the targeted row's whole config.
+# REPLACE the targeted row's whole config (not a deep merge). Installing this
+# plugin therefore resets `llm-deepseek` to exactly the 4 models below and
+# `attachment-local` to exactly the 3 image keys below — any other models or
+# keys those rows carried (host defaults, other plugins, profile edits) are
+# dropped unless restated. If you need extra models or keys, restate them in
+# your PROFILE's cordis.patch.yml (the profile layer applies after the plugin
+# layer, so it wins).
 - id: llm-deepseek
   config:
     models:
+      - id: deepseek-flash
+        name: DeepSeek-V4.1-Flash
+        contextWindow: 1000000
+        maxTokens: 384000
+        inputModalities: [text, image]
       - id: deepseek-v4-flash
         name: DeepSeek-V4-Flash
         contextWindow: 1000000
-        maxTokens: 256000
+        maxTokens: 384000
+        inputModalities: [text, image]
       - id: deepseek-v4-pro
         name: DeepSeek-V4-Pro
         contextWindow: 1000000
-        maxTokens: 256000
+        maxTokens: 384000
+        inputModalities: [text, image]
       - id: deepseek-v4-flash-vision-exp
         name: DeepSeek-V4-Flash-Vision-Exp
         contextWindow: 1000000
-        maxTokens: 256000
+        maxTokens: 384000
         inputModalities: [text, image]
 - id: attachment-local
   config:

package/lib/client.js

@@ -36,7 +36,7 @@ var inject = ["slots", "locale", "settingsScope"];
 var en = {
   nav: "Model router",
   title: "Model router",
-  description: "Role-based model routing: planning runs on deepseek-v4-pro, delegated executor subagents on deepseek-v4-flash.",
+  description: "Role-based model routing: both roles default to deepseek-flash (V4.1 Flash, native multimodal).",
   enabled: "Enabled",
   enabledHint: "Off stops rewriting requests and unregisters the prompt section and skill; on restores them.",
   on: "On",
@@ -50,7 +50,7 @@ var en = {
   modeStrict: "strict \u2014 the root agent is always the planner",
   modePlan: "plan \u2014 the root agent is pro only while plan mode is active",
   visionTitle: "Vision routing",
-  visionDesc: "Opt-in (default off): when enabled, any request containing an image routes to the vision model, from every role; other requests keep the pro/flash routing.",
+  visionDesc: "Opt-in (default off, native on deepseek-flash): when enabled, any request containing an image routes to the vision model, from every role; other requests keep the role routing.",
   visionSwitch: "Vision",
   visionReset: "Reset vision to default",
   visionRoute: "Vision model"
@@ -58,7 +58,7 @@ var en = {
 var zh = {
   nav: "\u6A21\u578B\u8DEF\u7531",
   title: "\u6A21\u578B\u8DEF\u7531",
-  description: "\u6309\u89D2\u8272\u5206\u914D\u6A21\u578B\uFF1A\u89C4\u5212\u5728 deepseek-v4-pro \u4E0A\u8FD0\u884C\uFF0C\u59D4\u6D3E\u7684\u6267\u884C\u5B50\u4EE3\u7406\u5728 deepseek-v4-flash \u4E0A\u8FD0\u884C\u3002",
+  description: "\u6309\u89D2\u8272\u5206\u914D\u6A21\u578B\uFF1A\u4E24\u4E2A\u89D2\u8272\u9ED8\u8BA4\u5747\u4E3A deepseek-flash\uFF08V4.1 Flash\uFF0C\u539F\u751F\u591A\u6A21\u6001\uFF09\u3002",
   enabled: "\u542F\u7528",
   enabledHint: "\u5173\u95ED\u540E\u505C\u6B62\u6539\u5199\u8BF7\u6C42\uFF0C\u5E76\u6CE8\u9500\u63D0\u793A\u533A\u5757\u4E0E\u6280\u80FD\uFF1B\u91CD\u65B0\u6253\u5F00\u5373\u6062\u590D\u3002",
   on: "\u5F00",
@@ -72,7 +72,7 @@ var zh = {
   modeStrict: "strict \u2014 \u6839 agent \u59CB\u7EC8\u4E3A\u89C4\u5212\u8005",
   modePlan: "plan \u2014 \u6839 agent \u4EC5\u5728\u8BA1\u5212\u6A21\u5F0F\u6FC0\u6D3B\u65F6\u4F7F\u7528 pro",
   visionTitle: "\u89C6\u89C9\u8DEF\u7531",
-  visionDesc: "\u53EF\u9009\uFF08\u9ED8\u8BA4\u5173\u95ED\uFF09\uFF1A\u542F\u7528\u540E\uFF0C\u4EFB\u4F55\u5305\u542B\u56FE\u7247\u7684\u8BF7\u6C42\u90FD\u4F1A\u8DEF\u7531\u5230\u89C6\u89C9\u6A21\u578B\uFF0C\u9002\u7528\u4E8E\u6240\u6709\u89D2\u8272\uFF1B\u5176\u4ED6\u8BF7\u6C42\u4FDD\u6301 pro/flash \u8DEF\u7531\u3002",
+  visionDesc: "\u53EF\u9009\uFF08\u9ED8\u8BA4\u5173\u95ED\uFF0Cdeepseek-flash \u539F\u751F\u652F\u6301\uFF09\uFF1A\u542F\u7528\u540E\uFF0C\u4EFB\u4F55\u5305\u542B\u56FE\u7247\u7684\u8BF7\u6C42\u90FD\u4F1A\u8DEF\u7531\u5230\u89C6\u89C9\u6A21\u578B\uFF0C\u9002\u7528\u4E8E\u6240\u6709\u89D2\u8272\uFF1B\u5176\u4ED6\u8BF7\u6C42\u4FDD\u6301\u89D2\u8272\u8DEF\u7531\u3002",
   visionSwitch: "\u89C6\u89C9",
   visionReset: "\u6062\u590D\u89C6\u89C9\u9ED8\u8BA4\u503C",
   visionRoute: "\u89C6\u89C9\u6A21\u578B"

package/lib/index.d.ts

@@ -177,8 +177,11 @@ declare function shouldUseVision(events: readonly unknown[] | undefined, vision:
 /** Plugin row id; the bundle patch inserts it under this id. */
 declare const name = "model-router";
 /**
- * Opt-in vision route. Defaults are OFF on `deepseek-v4-flash-vision-exp` from
- * `deepseek-official`; `reasoningEffort` and `maxTokens` are optional pins.
+ * Opt-in vision route. Defaults to `deepseek-flash` (V4.1 Flash, native
+ * multimodal) from `deepseek-official`; `reasoningEffort` and `maxTokens`
+ * are optional pins. Native multimodal makes the vision branch a no-op when
+ * the role routes already point at the same model — kept for explicitness
+ * and for a future V4.1-Pro split.
  */
 declare const VisionRouteSchema: z<Schemastery.ObjectS<{
     enabled: z<boolean, boolean>;
@@ -304,7 +307,14 @@ declare const SETTINGS_NS: _deepseek_ai_dsh_settings.SettingsNamespace;
 declare const SKILL_NAME = "pro-flash-routing";
 declare const SKILL_DESCRIPTION = "Route planning and code execution across models: plan on the pro planner agent, delegate implementation to flash executor subagents.";
 declare const SKILL_WHEN_TO_USE = "Use when a task combines planning and implementation: before writing code, after a plan is approved, when delegating execution work, or when the user asks about the pro/flash routing convention.";
-declare const SKILL_CONTENT = "# Pro planner / Flash executor routing\n\nThis session routes models by role:\n\n- **Planner (this agent)** \u2014 `deepseek-v4-pro`. Planning, design decisions, reviewing delegated output, and user-facing synthesis happen here.\n- **Executors (every subagent)** \u2014 `deepseek-v4-flash`. Implementation work happens there: writing code, running commands, builds, and tests. The harness forces the model automatically; you do not select it.\n\n## Working rhythm\n\n1. **Plan here.** Explore, decide the approach, and (when plan mode is on) submit the plan with `exit_plan_mode`. The plan stays on this agent.\n2. **Delegate the execution.** Once a plan is approved, hand each self-contained chunk of implementation to a subagent with a complete prompt: exact files to touch, the change to make, and how to verify. Subagents are automatically routed to `deepseek-v4-flash`, so keep them execution-focused: give them the decision, not the decision to make.\n3. **Review here.** Read the subagent's result on this agent, verify it yourself (tests, diffs, logs), and iterate with follow-up messages to the same subagent when available.\n4. **Report here.** Summaries, plans, and answers to the user come from this agent.\n\n## Keep this agent's context lean\n\nInput tokens are the expensive part of the planner. Don't re-read large files or full transcripts on this agent \u2014 trust the subagent's final report. Prefer targeted reads (offset/limit) over whole files. When the context grows, compact rather than re-sending everything.\n\n## Delegation guidelines\n\n- Start independent delegations together in one assistant message and continue useful work while they run (background mode by default).\n- Prefer `subagent` for self-contained work and `workflow` when many independent pieces need fan-out; their workers run on flash as well.\n- Do not delegate design: subagents execute decisions already made.\n- If a subagent's task grows into design work, pull it back to this agent and re-delegate the narrowed execution.\n\n## Verification\n\n- Executor output was produced by `deepseek-v4-flash`; planner output by `deepseek-v4-pro`. If you need to confirm, check the session log's model metadata.\n- If routing ever looks wrong, the `model-router` plugin row in the profile composition is the single place that owns it.";
+/**
+ * Render the skill content for one config, substituting the configured
+ * planner/executor models (mirrors the prompt-section templating).
+ * @param cfg - the resolved router configuration.
+ * @returns the skill markdown with model placeholders filled.
+ */
+declare function buildSkillContent(cfg: RouterConfig): string;
+declare const SKILL_CONTENT: string;
 /** The plugin row id the bundle patch must insert. */
 declare const ROW_ID = "model-router";
 /** Minimal structural view of the live agent object the router reads. */
@@ -373,4 +383,4 @@ declare class ModelRouter extends Service {
     private render;
 }
 
-export { type AgentRole, Config, type ModelRoute, ModelRouter, ROW_ID, type ReasoningEffort, type RouterConfig, type RoutingMode, SETTINGS_NS, SKILL_CONTENT, SKILL_DESCRIPTION, SKILL_NAME, SKILL_WHEN_TO_USE, type VisionRoute, VisionRouteSchema, ModelRouter as default, effortFor, hasImageContent, name, recentStepsHadError, roleFor, routeFor, sessionHasImage, shouldUseVision };
+export { type AgentRole, Config, type ModelRoute, ModelRouter, ROW_ID, type ReasoningEffort, type RouterConfig, type RoutingMode, SETTINGS_NS, SKILL_CONTENT, SKILL_DESCRIPTION, SKILL_NAME, SKILL_WHEN_TO_USE, type VisionRoute, VisionRouteSchema, buildSkillContent, ModelRouter as default, effortFor, hasImageContent, name, recentStepsHadError, roleFor, routeFor, sessionHasImage, shouldUseVision };

package/lib/index.js

@@ -91,18 +91,18 @@ var ModelRouteSchema = z.object({
 var VisionRouteSchema = z.object({
   enabled: z.boolean().default(false),
   provider: z.string().min(1).default("deepseek-official"),
-  model: z.string().min(1).default("deepseek-v4-flash-vision-exp"),
+  model: z.string().min(1).default("deepseek-flash"),
   reasoningEffort: z.union(["off", "low", "high", "max"]),
   maxTokens: z.number().min(1)
 });
 var Config = z.object({
   planner: ModelRouteSchema.default({
     provider: "deepseek-official",
-    model: "deepseek-v4-pro"
+    model: "deepseek-flash"
   }),
   executor: ModelRouteSchema.default({
     provider: "deepseek-official",
-    model: "deepseek-v4-flash"
+    model: "deepseek-flash"
   }),
   mode: z.union(["strict", "plan"]).default("strict"),
   enabled: z.boolean().default(true),
@@ -128,17 +128,17 @@ var SECTION_TEXT = `Model routing is role-based. Planning runs on {PLANNER_MODEL
 var SKILL_NAME = "pro-flash-routing";
 var SKILL_DESCRIPTION = "Route planning and code execution across models: plan on the pro planner agent, delegate implementation to flash executor subagents.";
 var SKILL_WHEN_TO_USE = `Use when a task combines planning and implementation: before writing code, after a plan is approved, when delegating execution work, or when the user asks about the pro/flash routing convention.`;
-var SKILL_CONTENT = `# Pro planner / Flash executor routing
+var SKILL_TEMPLATE = `# Pro planner / Flash executor routing
 
-This session routes models by role:
+This session routes models by role (planner \`{PLANNER_MODEL}\`, executor \`{EXECUTOR_MODEL}\`; both default to deepseek-flash, V4.1 Flash with native multimodal; vision needs no separate model):
 
-- **Planner (this agent)** \u2014 \`deepseek-v4-pro\`. Planning, design decisions, reviewing delegated output, and user-facing synthesis happen here.
-- **Executors (every subagent)** \u2014 \`deepseek-v4-flash\`. Implementation work happens there: writing code, running commands, builds, and tests. The harness forces the model automatically; you do not select it.
+- **Planner (this agent)** \u2014 \`{PLANNER_MODEL}\`. Planning, design decisions, reviewing delegated output, and user-facing synthesis happen here.
+- **Executors (every subagent)** \u2014 \`{EXECUTOR_MODEL}\`. Implementation work happens there: writing code, running commands, builds, and tests. The harness forces the model automatically; you do not select it.
 
 ## Working rhythm
 
 1. **Plan here.** Explore, decide the approach, and (when plan mode is on) submit the plan with \`exit_plan_mode\`. The plan stays on this agent.
-2. **Delegate the execution.** Once a plan is approved, hand each self-contained chunk of implementation to a subagent with a complete prompt: exact files to touch, the change to make, and how to verify. Subagents are automatically routed to \`deepseek-v4-flash\`, so keep them execution-focused: give them the decision, not the decision to make.
+2. **Delegate the execution.** Once a plan is approved, hand each self-contained chunk of implementation to a subagent with a complete prompt: exact files to touch, the change to make, and how to verify. Subagents are automatically routed to \`{EXECUTOR_MODEL}\`, so keep them execution-focused: give them the decision, not the decision to make.
 3. **Review here.** Read the subagent's result on this agent, verify it yourself (tests, diffs, logs), and iterate with follow-up messages to the same subagent when available.
 4. **Report here.** Summaries, plans, and answers to the user come from this agent.
 
@@ -149,14 +149,29 @@ Input tokens are the expensive part of the planner. Don't re-read large files or
 ## Delegation guidelines
 
 - Start independent delegations together in one assistant message and continue useful work while they run (background mode by default).
-- Prefer \`subagent\` for self-contained work and \`workflow\` when many independent pieces need fan-out; their workers run on flash as well.
+- Prefer \`subagent\` for self-contained work and \`workflow\` when many independent pieces need fan-out; their workers run on \`{EXECUTOR_MODEL}\` as well.
 - Do not delegate design: subagents execute decisions already made.
 - If a subagent's task grows into design work, pull it back to this agent and re-delegate the narrowed execution.
 
 ## Verification
 
-- Executor output was produced by \`deepseek-v4-flash\`; planner output by \`deepseek-v4-pro\`. If you need to confirm, check the session log's model metadata.
+- Planner produces \`{PLANNER_MODEL}\`, executor produces \`{EXECUTOR_MODEL}\` (unified when equal since V4.1; split again when V4.1-Pro lands). If you need to confirm, check the session log's model metadata.
 - If routing ever looks wrong, the \`model-router\` plugin row in the profile composition is the single place that owns it.`;
+function buildSkillContent(cfg) {
+  return SKILL_TEMPLATE.replaceAll("{PLANNER_MODEL}", cfg.planner.model).replaceAll(
+    "{EXECUTOR_MODEL}",
+    cfg.executor.model
+  );
+}
+var SKILL_CONTENT = buildSkillContent({
+  planner: { provider: "deepseek-official", model: "deepseek-flash" },
+  executor: { provider: "deepseek-official", model: "deepseek-flash" },
+  mode: "strict",
+  enabled: true,
+  promptSection: true,
+  skill: true,
+  vision: { enabled: false, provider: "deepseek-official", model: "deepseek-flash" }
+});
 var ROW_ID = "model-router";
 function isPlanModeActive(agent) {
   const events = agent.session?.events;
@@ -183,6 +198,14 @@ var ModelRouter = class extends Service {
     this.config = resolveConfig(rawConfig);
     this.source = () => this.config;
     this.harness = ctx;
+    const requestDisposers = /* @__PURE__ */ new Map();
+    this.harness.on("agent/disposed", (disposedAgent) => {
+      const dispose = requestDisposers.get(disposedAgent);
+      if (dispose !== void 0) {
+        dispose();
+        requestDisposers.delete(disposedAgent);
+      }
+    });
     this.harness.on("agent/created", ({ agent }) => {
       const dispose = agent.ctx.on(
         "agent/request",
@@ -215,9 +238,9 @@ var ModelRouter = class extends Service {
         },
         { prepend: true }
       );
-      this.harness.on("agent/disposed", (disposed) => {
-        if (disposed === agent) dispose();
-      });
+      const prev = requestDisposers.get(agent);
+      if (prev !== void 0) prev();
+      requestDisposers.set(agent, dispose);
     });
     this.render(this.config);
     installSettingsSection(
@@ -264,7 +287,7 @@ var ModelRouter = class extends Service {
         name: SKILL_NAME,
         description: SKILL_DESCRIPTION,
         whenToUse: SKILL_WHEN_TO_USE,
-        content: SKILL_CONTENT,
+        content: buildSkillContent(cfg),
         source: "runtime"
       });
     }
@@ -280,6 +303,7 @@ export {
   SKILL_NAME,
   SKILL_WHEN_TO_USE,
   VisionRouteSchema,
+  buildSkillContent,
   ModelRouter as default,
   effortFor,
   hasImageContent,

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/policy.ts"],"sourcesContent":["/**\n * dsh-model-router: role-based model routing for the DeepSeek Harness.\n *\n * The planner (the session's root agent) runs on `deepseek-v4-pro`; delegated\n * executor subagents run on `deepseek-v4-flash`. Enforcement is a per-agent\n * `agent/request` rewrite registered when the agent is created, so it applies\n * in every mode (web / headless / tui) and every agent preset, including\n * subagents the delegation tools create.\n *\n * Each role route may also pin `reasoningEffort` and `maxTokens`; when set,\n * they override the session's selection for that role. A `mode` switch lets a\n * deployment reserve the planner route for actual planning.\n *\n * The plugin also publishes:\n *  - a system-prompt section stating the planner/executor convention, and\n *  - the `pro-flash-routing` skill teaching the agent to plan itself and\n *    delegate code execution to flash subagents.\n *\n * @module dsh-model-router\n */\nimport { Context, Service } from \"@deepseek-ai/cordis\";\nimport z from \"@deepseek-ai/schemastery\";\nimport { foldPlanMode } from \"@deepseek-ai/dsh-plan-mode\";\nimport { installSettingsSection, settingsNamespace } from \"@deepseek-ai/dsh-settings\";\nimport { effortFor, hasImageContent, recentStepsHadError, roleFor, routeFor, sessionHasImage, shouldUseVision, type RouterConfig } from \"./policy.js\";\n\n/** Plugin row id; the bundle patch inserts it under this id. */\nconst name = \"model-router\";\n\n/** One provider/model pair, with defaults and optional effort/token caps. */\nconst ModelRouteSchema = z.object({\n  provider: z.string().min(1),\n  model: z.string().min(1),\n  reasoningEffort: z.union([\"off\", \"low\", \"high\", \"max\"]),\n  maxTokens: z.number().min(1),\n  escalateOnError: z.boolean(),\n  escalateTo: z.union([\"off\", \"low\", \"high\", \"max\"]),\n  recoverySteps: z.number().min(1),\n});\n\n/**\n * Opt-in vision route. Defaults are OFF on `deepseek-v4-flash-vision-exp` from\n * `deepseek-official`; `reasoningEffort` and `maxTokens` are optional pins.\n */\nconst VisionRouteSchema = z.object({\n  enabled: z.boolean().default(false),\n  provider: z.string().min(1).default(\"deepseek-official\"),\n  model: z.string().min(1).default(\"deepseek-v4-flash-vision-exp\"),\n  reasoningEffort: z.union([\"off\", \"low\", \"high\", \"max\"]),\n  maxTokens: z.number().min(1),\n});\n\n/** The plugin's public config, validated at row load. */\nconst Config = z.object({\n  planner: ModelRouteSchema.default({\n    provider: \"deepseek-official\",\n    model: \"deepseek-v4-pro\",\n  } as never),\n  executor: ModelRouteSchema.default({\n    provider: \"deepseek-official\",\n    model: \"deepseek-v4-flash\",\n  } as never),\n  mode: z.union([\"strict\", \"plan\"]).default(\"strict\"),\n  enabled: z.boolean().default(true),\n  promptSection: z.boolean().default(true),\n  skill: z.boolean().default(true),\n  vision: VisionRouteSchema.default({} as never),\n});\n\n/** Settings namespace the live on/off toggle lives under (settings.yaml). */\nconst SETTINGS_NS = settingsNamespace(\"model-router\");\n\n/**\n * Resolve raw row config into the internal shape, failing loud on garbage.\n * Schemastery schemas are callable: invoking validates and applies defaults.\n * @param raw - the row's config object.\n * @returns the validated RouterConfig.\n */\nfunction resolveConfig(raw: unknown): RouterConfig {\n  const parsed = Config(raw ?? {});\n  return {\n    planner: parsed.planner,\n    executor: parsed.executor,\n    mode: parsed.mode,\n    enabled: parsed.enabled,\n    promptSection: parsed.promptSection,\n    skill: parsed.skill,\n    vision: parsed.vision,\n  };\n}\n\n/**\n * Always-on guidance section. Negative order renders before the persona, so\n * the convention is established before the agent's identity line.\n */\nconst SECTION_ORDER = -50;\n\nconst SECTION_TEXT = `Model routing is role-based. Planning runs on {PLANNER_MODEL}; implementation runs on {EXECUTOR_MODEL}. You are the root agent: plan, design, review subagent output, and write the final answer here. Delegate implementation — writing code, running commands, builds, tests — to subagents with complete, self-contained prompts, preferring background delegation for independent work. Keep plans and replies concise. Do not hand-write large amounts of code or run long executions here; delegate instead.{VISION_LINE}`;\n\nconst SKILL_NAME = \"pro-flash-routing\";\n\nconst SKILL_DESCRIPTION =\n  \"Route planning and code execution across models: plan on the pro planner agent, delegate implementation to flash executor subagents.\";\n\nconst SKILL_WHEN_TO_USE = `Use when a task combines planning and implementation: before writing code, after a plan is approved, when delegating execution work, or when the user asks about the pro/flash routing convention.`;\n\nconst SKILL_CONTENT = `# Pro planner / Flash executor routing\n\nThis session routes models by role:\n\n- **Planner (this agent)** — \\`deepseek-v4-pro\\`. Planning, design decisions, reviewing delegated output, and user-facing synthesis happen here.\n- **Executors (every subagent)** — \\`deepseek-v4-flash\\`. Implementation work happens there: writing code, running commands, builds, and tests. The harness forces the model automatically; you do not select it.\n\n## Working rhythm\n\n1. **Plan here.** Explore, decide the approach, and (when plan mode is on) submit the plan with \\`exit_plan_mode\\`. The plan stays on this agent.\n2. **Delegate the execution.** Once a plan is approved, hand each self-contained chunk of implementation to a subagent with a complete prompt: exact files to touch, the change to make, and how to verify. Subagents are automatically routed to \\`deepseek-v4-flash\\`, so keep them execution-focused: give them the decision, not the decision to make.\n3. **Review here.** Read the subagent's result on this agent, verify it yourself (tests, diffs, logs), and iterate with follow-up messages to the same subagent when available.\n4. **Report here.** Summaries, plans, and answers to the user come from this agent.\n\n## Keep this agent's context lean\n\nInput tokens are the expensive part of the planner. Don't re-read large files or full transcripts on this agent — trust the subagent's final report. Prefer targeted reads (offset/limit) over whole files. When the context grows, compact rather than re-sending everything.\n\n## Delegation guidelines\n\n- Start independent delegations together in one assistant message and continue useful work while they run (background mode by default).\n- Prefer \\`subagent\\` for self-contained work and \\`workflow\\` when many independent pieces need fan-out; their workers run on flash as well.\n- Do not delegate design: subagents execute decisions already made.\n- If a subagent's task grows into design work, pull it back to this agent and re-delegate the narrowed execution.\n\n## Verification\n\n- Executor output was produced by \\`deepseek-v4-flash\\`; planner output by \\`deepseek-v4-pro\\`. If you need to confirm, check the session log's model metadata.\n- If routing ever looks wrong, the \\`model-router\\` plugin row in the profile composition is the single place that owns it.`;\n\n/** The plugin row id the bundle patch must insert. */\nconst ROW_ID = \"model-router\";\n\n/** Minimal structural view of the live agent object the router reads. */\ninterface AgentLike {\n  ctx: AgentScopedContext;\n  options?: { subagentDepth?: number };\n  session?: { header?: { origin?: string }; events?: unknown[] };\n}\n\n/** The agent-scoped context's waterfall surface the router uses. */\ninterface AgentScopedContext {\n  on(\n    event: \"agent/request\",\n    listener: (\n      payload: Record<string, unknown>,\n      next: () => Promise<Record<string, unknown>>,\n    ) => Promise<Record<string, unknown>>,\n    options?: { prepend?: boolean },\n  ): () => void;\n}\n\n/** Host-plane surface the router consumes (events, prompt registry, skills). */\ninterface HarnessContext {\n  on(\n    event: \"agent/created\",\n    listener: (payload: { agent: AgentLike }) => void,\n  ): () => void;\n  on(event: \"agent/disposed\", listener: (agent: unknown) => void): () => void;\n  systemPrompt: {\n    section(section: { name: string; order: number; text: string }): () => void;\n  };\n  skills: {\n    register(skill: {\n      name: string;\n      description: string;\n      whenToUse?: string;\n      content: string;\n      source: string;\n    }): () => void;\n  };\n}\n\n/** Fold plan-mode state for an agent without trusting the agent's exact shape. */\nfunction isPlanModeActive(agent: AgentLike): boolean {\n  const events = agent.session?.events;\n  if (!Array.isArray(events)) return false;\n  try {\n    return foldPlanMode(events as Parameters<typeof foldPlanMode>[0]);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Cordis service: per-agent request routing plus the convention surface.\n */\nclass ModelRouter extends Service {\n  static inject = [\"skills\", \"systemPrompt\"];\n\n  config: RouterConfig;\n\n  /** Currently authoritative config; swapped by the settings section when one is mounted. */\n  source: () => RouterConfig;\n\n  /** Host-plane surface the router consumes (events, prompt registry, skills). */\n  harness: HarnessContext;\n\n  /** Disposer of the currently registered prompt section, if any. */\n  promptDispose?: () => void;\n\n  /** Disposer of the currently registered skill, if any. */\n  skillDispose?: () => void;\n\n  constructor(ctx: Context, rawConfig: unknown = {}) {\n    super(ctx, \"modelRouter\");\n    this.config = resolveConfig(rawConfig);\n    this.source = () => this.config;\n    this.harness = ctx as unknown as HarnessContext;\n\n    // Every agent that gets created — root sessions, delegation children,\n    // workflow workers, ralph rounds — passes through here.\n    this.harness.on(\"agent/created\", ({ agent }) => {\n      // `prepend` puts this listener OUTERMOST in the `agent/request`\n      // waterfall: the harness's model-selection listener runs inside it, so\n      // this rewrite is applied LAST and wins over the session's selected\n      // model (which dsh-base defaults to deepseek-v4-flash and the user\n      // settings or UI can change).\n      const dispose = agent.ctx.on(\n        \"agent/request\",\n        async (payload, next) => {\n          const resolved = await next();\n          const cfg = this.source();\n          if (!cfg.enabled) return resolved;\n          // Vision branch FIRST: any request whose session log carries image\n          // content is stamped with the vision model, regardless of role. The\n          // `agent/request` waterfall payload never includes `messages`, so\n          // detection reads the session event log (`user/message`,\n          // `assistant/message`, `tool/result`). The harness's own\n          // model-selection listener has already run (`await next()`), so\n          // this rewrite wins over the session model.\n          if (shouldUseVision(agent.session?.events, cfg.vision)) {\n            const stamped: Record<string, unknown> = {\n              ...resolved,\n              provider: cfg.vision.provider,\n              model: cfg.vision.model,\n            };\n            if (cfg.vision.maxTokens !== undefined) stamped.maxTokens = cfg.vision.maxTokens;\n            const effort = effortFor(cfg.vision, agent.session?.events);\n            if (effort !== undefined) stamped.reasoningEffort = effort;\n            return stamped;\n          }\n          const route = routeFor(agent, cfg, isPlanModeActive(agent));\n          if (route === undefined) return resolved;\n          const stamped: Record<string, unknown> = {\n            ...resolved,\n            provider: route.provider,\n            model: route.model,\n          };\n          if (route.maxTokens !== undefined) stamped.maxTokens = route.maxTokens;\n          const effort = effortFor(route, agent.session?.events);\n          if (effort !== undefined) stamped.reasoningEffort = effort;\n          return stamped;\n        },\n        { prepend: true },\n      );\n      this.harness.on(\"agent/disposed\", (disposed) => {\n        if (disposed === agent) dispose();\n      });\n    });\n\n    // Register the convention surface from the composition config, then let\n    // the settings section (when mounted) take over as the live source.\n    this.render(this.config);\n    installSettingsSection(\n      ctx,\n      SETTINGS_NS,\n      Config,\n      this.config as unknown as ReturnType<typeof Config>,\n      {\n        setSource: (current) => {\n          this.source = current;\n        },\n        onChange: () => this.render(this.source()),\n      },\n    );\n  }\n\n  /**\n   * Register the convention surface (prompt section + skill) for `cfg`,\n   * replacing whatever is currently registered. Called on construction and\n   * after every committed settings change; while `enabled` is false, nothing\n   * stays registered.\n   */\n  private render(cfg: RouterConfig): void {\n    if (this.promptDispose) {\n      this.promptDispose();\n      this.promptDispose = undefined;\n    }\n    if (this.skillDispose) {\n      this.skillDispose();\n      this.skillDispose = undefined;\n    }\n    if (!cfg.enabled) return;\n    if (cfg.promptSection) {\n      this.promptDispose = this.harness.systemPrompt.section({\n        name: ROW_ID,\n        order: SECTION_ORDER,\n        text: SECTION_TEXT.replaceAll(\"{PLANNER_MODEL}\", cfg.planner.model)\n          .replaceAll(\"{EXECUTOR_MODEL}\", cfg.executor.model)\n          .replace(\n            \"{VISION_LINE}\",\n            cfg.vision.enabled\n              ? ` Image-bearing requests route to ${cfg.vision.model}.`\n              : \"\",\n          ),\n      });\n    }\n    if (cfg.skill) {\n      this.skillDispose = this.harness.skills.register({\n        name: SKILL_NAME,\n        description: SKILL_DESCRIPTION,\n        whenToUse: SKILL_WHEN_TO_USE,\n        content: SKILL_CONTENT,\n        source: \"runtime\",\n      });\n    }\n  }\n}\n\nexport {\n  Config,\n  ModelRouter,\n  ModelRouter as default,\n  SETTINGS_NS,\n  VisionRouteSchema,\n  name,\n  ROW_ID,\n  SKILL_CONTENT,\n  SKILL_DESCRIPTION,\n  SKILL_NAME,\n  SKILL_WHEN_TO_USE,\n  effortFor,\n  hasImageContent,\n  recentStepsHadError,\n  roleFor,\n  routeFor,\n  sessionHasImage,\n  shouldUseVision,\n};\nexport type {\n  AgentRole,\n  ModelRoute,\n  ReasoningEffort,\n  RoutingMode,\n  RouterConfig,\n  VisionRoute,\n} from \"./policy.js\";\n","/**\n * Pure routing policy for dsh-model-router: which model each agent role gets.\n * Kept free of Cordis imports so the policy is trivially unit-testable.\n * @module dsh-model-router/policy\n */\n\n/** Reasoning-effort levels a route may pin (mirrors the harness vocabulary). */\nexport type ReasoningEffort = \"off\" | \"low\" | \"high\" | \"max\";\n\n/**\n * How the router treats the root agent.\n * - `strict`: the root agent is always the planner (pro).\n * - `plan`: the root agent is pro only while plan mode is active; otherwise it\n *   falls back to the executor route, reserving pro for real planning.\n */\nexport type RoutingMode = \"strict\" | \"plan\";\n\n/** One route: a provider/model pair stamped onto an agent request. */\nexport interface ModelRoute {\n  provider: string;\n  model: string;\n  /**\n   * Optional reasoning-effort override. When omitted, the request inherits the\n   * session's own selection; when set, the router pins it for that role.\n   */\n  reasoningEffort?: ReasoningEffort;\n  /** Optional output-token cap for the role; omitted means inherit. */\n  maxTokens?: number;\n  /**\n   * Error-driven escalation (v1): when true, a failed execution step bumps the\n   * next request's effort to `escalateTo`, wearing off after `recoverySteps`\n   * clean steps. Deterministic, stateless — the session log is folded per\n   * request, so only *prior* steps are ever considered.\n   */\n  escalateOnError?: boolean;\n  /** Effort used for the request after a failed step. */\n  escalateTo?: ReasoningEffort;\n  /** Clean steps before escalation wears off. Defaults to 2. */\n  recoverySteps?: number;\n}\n\n/** The two roles the router distinguishes. */\nexport type AgentRole = \"planner\" | \"executor\";\n\n/**\n * Opt-in vision route: when enabled, any request whose messages carry image\n * content is stamped with the vision model, from every role (root agent and\n * subagents alike). Everything else keeps the pro/flash role routing.\n */\nexport interface VisionRoute {\n  /** Master switch. Defaults to false — vision routing is opt-in. */\n  enabled: boolean;\n  /** Provider the vision model is served from. */\n  provider: string;\n  /** The vision model to stamp onto image-bearing requests. */\n  model: string;\n  /** Optional reasoning-effort pin; omitted means inherit the session's. */\n  reasoningEffort?: ReasoningEffort;\n  /** Optional output-token cap; omitted means inherit the session's. */\n  maxTokens?: number;\n}\n\n/** Resolved router configuration: one route per role plus routing mode. */\nexport interface RouterConfig {\n  planner: ModelRoute;\n  executor: ModelRoute;\n  mode: RoutingMode;\n  /**\n   * Live off-switch. Defaults to true; settable from Settings → Plugins →\n   * model-router (applies immediately) or from the patch row (next boot).\n   * When false, the router stops rewriting requests and unregisters the\n   * prompt section and the skill.\n   */\n  enabled: boolean;\n  promptSection: boolean;\n  skill: boolean;\n  /** Opt-in vision routing for image-bearing requests (v0.6.0+). */\n  vision: VisionRoute;\n}\n\n/** Default recovery window: an error escalates for the next two completed steps. */\nexport const DEFAULT_RECOVERY_STEPS = 2;\n\n/**\n * Classify an agent as planner or executor.\n *\n * The main (root) agent of a session is the planner. Every agent created as a\n * delegation child — `subagent`, `subagent_fork`, workflow workers, ralph\n * rounds — is an executor. The harness stamps two durable facts on children:\n * `options.subagentDepth` (>= 1) and the session header `origin: \"subagent\"`.\n *\n * @param agent - the live agent (any subset of the runtime shape).\n * @returns the role the agent should be routed as.\n */\nexport function roleFor(agent: unknown): AgentRole {\n  const options = (agent as { options?: unknown })?.options;\n  const depth = (options as { subagentDepth?: unknown })?.subagentDepth;\n  if (typeof depth === \"number\" && depth >= 1) return \"executor\";\n  const session = (agent as { session?: unknown })?.session;\n  const origin = (session as { header?: unknown })?.header\n    ? ((session as { header: { origin?: unknown } }).header.origin)\n    : undefined;\n  if (origin === \"subagent\") return \"executor\";\n  return \"planner\";\n}\n\n/**\n * Resolve the route for one agent.\n * @param agent - the live agent.\n * @param config - the resolved router configuration.\n * @param planModeActive - whether plan mode is currently folded active for the\n *   agent's session; consulted only in `plan` routing mode.\n * @returns the model route to stamp, or `undefined` to leave the request alone.\n */\nexport function routeFor(\n  agent: unknown,\n  config: RouterConfig,\n  planModeActive = false,\n): ModelRoute | undefined {\n  const role = roleFor(agent);\n  if (role === \"executor\") return config.executor;\n  // Root agent. In `plan` mode, reserve the planner route for actual planning;\n  // otherwise the root falls back to the executor route.\n  if (config.mode === \"plan\" && !planModeActive) return config.executor;\n  return config.planner;\n}\n\n/**\n * Whether any of the last `recoverySteps` completed steps carried a failed\n * tool result. A failure is a `tool/result` event whose data carries an\n * `error` field (the harness records tool failures there).\n *\n * Steps are deduplicated by `turn:step`, and only *completed* steps count —\n * events are scanned from the tail, so the current in-flight request is never\n * considered.\n *\n * @param events - the agent's session event log (or `undefined`).\n * @param recoverySteps - how many completed steps back to scan.\n * @returns true when a failed step is within the window.\n */\nexport function recentStepsHadError(\n  events: readonly unknown[] | undefined,\n  recoverySteps: number = DEFAULT_RECOVERY_STEPS,\n): boolean {\n  if (!Array.isArray(events) || recoverySteps <= 0) return false;\n  const seen = new Set<string>();\n  let steps = 0;\n  for (let i = events.length - 1; i >= 0; i -= 1) {\n    const event = events[i] as\n      | { type?: string; data?: { turn?: number; step?: number; error?: unknown } }\n      | undefined;\n    if (event?.type !== \"tool/result\" || event.data === undefined) continue;\n    const key = `${event.data.turn}:${event.data.step}`;\n    if (!seen.has(key)) {\n      // A new step beyond the recovery window ends the scan; events for steps\n      // already inside the window are still checked below.\n      if (steps >= recoverySteps) break;\n      seen.add(key);\n      steps += 1;\n    }\n    if (event.data.error !== undefined && event.data.error !== null) return true;\n  }\n  return false;\n}\n\n/**\n * Resolve the reasoning effort to stamp for one request.\n *\n * Baseline is the route's `reasoningEffort`; when `escalateOnError` is enabled\n * and a recent step failed, the effort bumps to `escalateTo` (falling back to\n * the baseline when `escalateTo` is unset). Returns `undefined` to leave the\n * request's effort alone (inherit the session selection).\n *\n * @param route - the resolved route for the agent.\n * @param events - the agent's session event log.\n * @returns the effort to stamp, or `undefined` to inherit.\n */\nexport function effortFor(\n  route: ModelRoute,\n  events: readonly unknown[] | undefined,\n): ReasoningEffort | undefined {\n  if (route.escalateOnError === true && recentStepsHadError(events, route.recoverySteps)) {\n    return route.escalateTo ?? route.reasoningEffort;\n  }\n  return route.reasoningEffort;\n}\n\n/**\n * Whether any message in a request payload carries image content.\n *\n * A message carries an image when its `content` is a block array containing\n * an `image` block, directly or nested inside a `tool-result` block (tool\n * results may embed the images they produced). String content never does.\n *\n * @deprecated Superseded by {@link sessionHasImage} (v0.6.2): the\n * `agent/request` waterfall payload never carries `messages`, so production\n * routing reads the session event log instead. Kept for backward compat.\n * @param messages - the request's `messages` array (any runtime shape).\n * @returns true when at least one message contains image content.\n */\nexport function hasImageContent(messages: unknown): boolean {\n  if (!Array.isArray(messages)) return false;\n  for (const message of messages) {\n    const content = (message as { content?: unknown })?.content;\n    if (typeof content === \"string\") continue;\n    if (Array.isArray(content) && blocksContainImage(content)) return true;\n  }\n  return false;\n}\n\n/**\n * Whether the agent's session log carries any image content.\n *\n * The `agent/request` waterfall payload never includes `messages`, so vision\n * detection reads the session event log instead. Shapes mirror the harness\n * `SessionEventMap` (`@deepseek-ai/dsh-session`):\n * - `user/message` event's data IS the `UserMessage` (content at `data.content`),\n * - `assistant/message` content lives at `data.message.content` (`AssistantMessage`),\n * - `tool/result` content lives at `data.message.content` (`ToolResultMessage`,\n *   a single-element `[ToolResultBlock]` whose nested `content` may hold images).\n * Blocks may also nest images inside `tool-result` blocks. Extraction tries\n * `data.message.content` first, then `data.content`, so minor harness shape\n * drift still detects rather than silently missing.\n *\n * Sticky by design: one image anywhere in the log routes vision for the rest\n * of the session, because the image stays in request context until compaction\n * or pruning drops it. The scan is O(N) per request from the tail (early exit\n * on hit); text-only sessions scan the full log, which is fine at session scale.\n *\n * @param events - the agent's session event log (or `undefined`).\n * @returns true when any user, assistant, or tool-result message carries image content.\n */\nexport function sessionHasImage(events: readonly unknown[] | undefined): boolean {\n  if (!Array.isArray(events)) return false;\n  for (let i = events.length - 1; i >= 0; i -= 1) {\n    const event = events[i] as\n      | { type?: string; data?: { content?: unknown; message?: { content?: unknown } } }\n      | undefined;\n    if (\n      event?.type !== \"user/message\" &&\n      event?.type !== \"assistant/message\" &&\n      event?.type !== \"tool/result\"\n    )\n      continue;\n    // Robust extraction: prefer the wrapped message shape, fall back to direct.\n    const content = event.data?.message?.content ?? event.data?.content;\n    if (Array.isArray(content) && blocksContainImage(content)) return true;\n  }\n  return false;\n}\n\n/**\n * Whether a request should take the vision route.\n *\n * Pure, testable wiring helper for the `agent/request` listener in\n * `src/index.ts`: vision wins only when explicitly enabled AND the session\n * log carries an image. Extracted so the gating logic is covered without\n * spinning up Cordis.\n *\n * @param events - the agent's session event log.\n * @param vision - the resolved vision route (only `enabled` is read).\n * @returns true when the request must be stamped with the vision model.\n */\nexport function shouldUseVision(\n  events: readonly unknown[] | undefined,\n  vision: Pick<VisionRoute, \"enabled\"> | undefined,\n): boolean {\n  if (vision?.enabled !== true) return false;\n  return sessionHasImage(events);\n}\n\n/**\n * Whether any block (or nested tool-result content) is an image block.\n * Exact `type` matching is intentional: it mirrors the harness\n * `ContentBlockMap` vocabulary (`@deepseek-ai/dsh-llm`: `text`, `reasoning`,\n * `image`, `tool-call`, `tool-result`). Provider wire variants (`image_url`,\n * `input_image`, …) are normalized by adapters before reaching the log.\n */\nfunction blocksContainImage(blocks: readonly unknown[]): boolean {\n  for (const block of blocks) {\n    const candidate = block as { type?: unknown; content?: unknown };\n    if (candidate?.type === \"image\") return true;\n    if (candidate?.type === \"tool-result\" && Array.isArray(candidate.content) && blocksContainImage(candidate.content)) return true;\n  }\n  return false;\n}\n"],"mappings":"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","names":["stamped","effort"]}
+{"version":3,"sources":["../src/index.ts","../src/policy.ts"],"sourcesContent":["/**\n * dsh-model-router: role-based model routing for the DeepSeek Harness.\n *\n * Both roles default to `deepseek-flash` (V4.1 Flash, native multimodal):\n * the planner (the session's root agent) and delegated executor subagents\n * share the same model until V4.1-Pro launches, at which point the planner\n * route can be flipped back with a one-line config change. Enforcement is a\n * per-agent `agent/request` rewrite registered when the agent is created, so\n * it applies in every mode (web / headless / tui) and every agent preset,\n * including subagents the delegation tools create.\n *\n * Each role route may also pin `reasoningEffort` and `maxTokens`; when set,\n * they override the session's selection for that role. A `mode` switch lets a\n * deployment reserve the planner route for actual planning.\n *\n * The plugin also publishes:\n *  - a system-prompt section stating the planner/executor convention, and\n *  - the `pro-flash-routing` skill teaching the agent to plan itself and\n *    delegate code execution to flash subagents.\n *\n * @module dsh-model-router\n */\nimport { Context, Service } from \"@deepseek-ai/cordis\";\nimport z from \"@deepseek-ai/schemastery\";\nimport { foldPlanMode } from \"@deepseek-ai/dsh-plan-mode\";\nimport { installSettingsSection, settingsNamespace } from \"@deepseek-ai/dsh-settings\";\nimport { effortFor, hasImageContent, recentStepsHadError, roleFor, routeFor, sessionHasImage, shouldUseVision, type RouterConfig } from \"./policy.js\";\n\n/** Plugin row id; the bundle patch inserts it under this id. */\nconst name = \"model-router\";\n\n/** One provider/model pair, with defaults and optional effort/token caps. */\nconst ModelRouteSchema = z.object({\n  provider: z.string().min(1),\n  model: z.string().min(1),\n  reasoningEffort: z.union([\"off\", \"low\", \"high\", \"max\"]),\n  maxTokens: z.number().min(1),\n  escalateOnError: z.boolean(),\n  escalateTo: z.union([\"off\", \"low\", \"high\", \"max\"]),\n  recoverySteps: z.number().min(1),\n});\n\n/**\n * Opt-in vision route. Defaults to `deepseek-flash` (V4.1 Flash, native\n * multimodal) from `deepseek-official`; `reasoningEffort` and `maxTokens`\n * are optional pins. Native multimodal makes the vision branch a no-op when\n * the role routes already point at the same model — kept for explicitness\n * and for a future V4.1-Pro split.\n */\nconst VisionRouteSchema = z.object({\n  enabled: z.boolean().default(false),\n  provider: z.string().min(1).default(\"deepseek-official\"),\n  model: z.string().min(1).default(\"deepseek-flash\"),\n  reasoningEffort: z.union([\"off\", \"low\", \"high\", \"max\"]),\n  maxTokens: z.number().min(1),\n});\n\n/** The plugin's public config, validated at row load. */\nconst Config = z.object({\n  planner: ModelRouteSchema.default({\n    provider: \"deepseek-official\",\n    model: \"deepseek-flash\",\n  } as never),\n  executor: ModelRouteSchema.default({\n    provider: \"deepseek-official\",\n    model: \"deepseek-flash\",\n  } as never),\n  mode: z.union([\"strict\", \"plan\"]).default(\"strict\"),\n  enabled: z.boolean().default(true),\n  promptSection: z.boolean().default(true),\n  skill: z.boolean().default(true),\n  vision: VisionRouteSchema.default({} as never),\n});\n\n/** Settings namespace the live on/off toggle lives under (settings.yaml). */\nconst SETTINGS_NS = settingsNamespace(\"model-router\");\n\n/**\n * Resolve raw row config into the internal shape, failing loud on garbage.\n * Schemastery schemas are callable: invoking validates and applies defaults.\n * @param raw - the row's config object.\n * @returns the validated RouterConfig.\n */\nfunction resolveConfig(raw: unknown): RouterConfig {\n  const parsed = Config(raw ?? {});\n  return {\n    planner: parsed.planner,\n    executor: parsed.executor,\n    mode: parsed.mode,\n    enabled: parsed.enabled,\n    promptSection: parsed.promptSection,\n    skill: parsed.skill,\n    vision: parsed.vision,\n  };\n}\n\n/**\n * Always-on guidance section. Negative order renders before the persona, so\n * the convention is established before the agent's identity line.\n */\nconst SECTION_ORDER = -50;\n\nconst SECTION_TEXT = `Model routing is role-based. Planning runs on {PLANNER_MODEL}; implementation runs on {EXECUTOR_MODEL}. You are the root agent: plan, design, review subagent output, and write the final answer here. Delegate implementation — writing code, running commands, builds, tests — to subagents with complete, self-contained prompts, preferring background delegation for independent work. Keep plans and replies concise. Do not hand-write large amounts of code or run long executions here; delegate instead.{VISION_LINE}`;\n\nconst SKILL_NAME = \"pro-flash-routing\";\n\nconst SKILL_DESCRIPTION =\n  \"Route planning and code execution across models: plan on the pro planner agent, delegate implementation to flash executor subagents.\";\n\nconst SKILL_WHEN_TO_USE = `Use when a task combines planning and implementation: before writing code, after a plan is approved, when delegating execution work, or when the user asks about the pro/flash routing convention.`;\n\nconst SKILL_TEMPLATE = `# Pro planner / Flash executor routing\n\nThis session routes models by role (planner \\`{PLANNER_MODEL}\\`, executor \\`{EXECUTOR_MODEL}\\`; both default to deepseek-flash, V4.1 Flash with native multimodal; vision needs no separate model):\n\n- **Planner (this agent)** — \\`{PLANNER_MODEL}\\`. Planning, design decisions, reviewing delegated output, and user-facing synthesis happen here.\n- **Executors (every subagent)** — \\`{EXECUTOR_MODEL}\\`. Implementation work happens there: writing code, running commands, builds, and tests. The harness forces the model automatically; you do not select it.\n\n## Working rhythm\n\n1. **Plan here.** Explore, decide the approach, and (when plan mode is on) submit the plan with \\`exit_plan_mode\\`. The plan stays on this agent.\n2. **Delegate the execution.** Once a plan is approved, hand each self-contained chunk of implementation to a subagent with a complete prompt: exact files to touch, the change to make, and how to verify. Subagents are automatically routed to \\`{EXECUTOR_MODEL}\\`, so keep them execution-focused: give them the decision, not the decision to make.\n3. **Review here.** Read the subagent's result on this agent, verify it yourself (tests, diffs, logs), and iterate with follow-up messages to the same subagent when available.\n4. **Report here.** Summaries, plans, and answers to the user come from this agent.\n\n## Keep this agent's context lean\n\nInput tokens are the expensive part of the planner. Don't re-read large files or full transcripts on this agent — trust the subagent's final report. Prefer targeted reads (offset/limit) over whole files. When the context grows, compact rather than re-sending everything.\n\n## Delegation guidelines\n\n- Start independent delegations together in one assistant message and continue useful work while they run (background mode by default).\n- Prefer \\`subagent\\` for self-contained work and \\`workflow\\` when many independent pieces need fan-out; their workers run on \\`{EXECUTOR_MODEL}\\` as well.\n- Do not delegate design: subagents execute decisions already made.\n- If a subagent's task grows into design work, pull it back to this agent and re-delegate the narrowed execution.\n\n## Verification\n\n- Planner produces \\`{PLANNER_MODEL}\\`, executor produces \\`{EXECUTOR_MODEL}\\` (unified when equal since V4.1; split again when V4.1-Pro lands). If you need to confirm, check the session log's model metadata.\n- If routing ever looks wrong, the \\`model-router\\` plugin row in the profile composition is the single place that owns it.`;\n\n/**\n * Render the skill content for one config, substituting the configured\n * planner/executor models (mirrors the prompt-section templating).\n * @param cfg - the resolved router configuration.\n * @returns the skill markdown with model placeholders filled.\n */\nfunction buildSkillContent(cfg: RouterConfig): string {\n  return SKILL_TEMPLATE.replaceAll(\"{PLANNER_MODEL}\", cfg.planner.model).replaceAll(\n    \"{EXECUTOR_MODEL}\",\n    cfg.executor.model,\n  );\n}\n\nconst SKILL_CONTENT = buildSkillContent({\n  planner: { provider: \"deepseek-official\", model: \"deepseek-flash\" },\n  executor: { provider: \"deepseek-official\", model: \"deepseek-flash\" },\n  mode: \"strict\",\n  enabled: true,\n  promptSection: true,\n  skill: true,\n  vision: { enabled: false, provider: \"deepseek-official\", model: \"deepseek-flash\" },\n});\n\n/** The plugin row id the bundle patch must insert. */\nconst ROW_ID = \"model-router\";\n\n/** Minimal structural view of the live agent object the router reads. */\ninterface AgentLike {\n  ctx: AgentScopedContext;\n  options?: { subagentDepth?: number };\n  session?: { header?: { origin?: string }; events?: unknown[] };\n}\n\n/** The agent-scoped context's waterfall surface the router uses. */\ninterface AgentScopedContext {\n  on(\n    event: \"agent/request\",\n    listener: (\n      payload: Record<string, unknown>,\n      next: () => Promise<Record<string, unknown>>,\n    ) => Promise<Record<string, unknown>>,\n    options?: { prepend?: boolean },\n  ): () => void;\n}\n\n/** Host-plane surface the router consumes (events, prompt registry, skills). */\ninterface HarnessContext {\n  on(\n    event: \"agent/created\",\n    listener: (payload: { agent: AgentLike }) => void,\n  ): () => void;\n  on(event: \"agent/disposed\", listener: (agent: unknown) => void): () => void;\n  systemPrompt: {\n    section(section: { name: string; order: number; text: string }): () => void;\n  };\n  skills: {\n    register(skill: {\n      name: string;\n      description: string;\n      whenToUse?: string;\n      content: string;\n      source: string;\n    }): () => void;\n  };\n}\n\n/** Fold plan-mode state for an agent without trusting the agent's exact shape. */\nfunction isPlanModeActive(agent: AgentLike): boolean {\n  const events = agent.session?.events;\n  if (!Array.isArray(events)) return false;\n  try {\n    return foldPlanMode(events as Parameters<typeof foldPlanMode>[0]);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Cordis service: per-agent request routing plus the convention surface.\n */\nclass ModelRouter extends Service {\n  static inject = [\"skills\", \"systemPrompt\"];\n\n  config: RouterConfig;\n\n  /** Currently authoritative config; swapped by the settings section when one is mounted. */\n  source: () => RouterConfig;\n\n  /** Host-plane surface the router consumes (events, prompt registry, skills). */\n  harness: HarnessContext;\n\n  /** Disposer of the currently registered prompt section, if any. */\n  promptDispose?: () => void;\n\n  /** Disposer of the currently registered skill, if any. */\n  skillDispose?: () => void;\n\n  constructor(ctx: Context, rawConfig: unknown = {}) {\n    super(ctx, \"modelRouter\");\n    this.config = resolveConfig(rawConfig);\n    this.source = () => this.config;\n    this.harness = ctx as unknown as HarnessContext;\n\n    // Every agent that gets created — root sessions, delegation children,\n    // workflow workers, ralph rounds — passes through here. The\n    // `agent/disposed` listener is registered once (not per agent) and fans\n    // out via a map, so long sessions with many delegations don't accumulate\n    // a global listener per agent.\n    const requestDisposers = new Map<unknown, () => void>();\n    this.harness.on(\"agent/disposed\", (disposedAgent) => {\n      const dispose = requestDisposers.get(disposedAgent);\n      if (dispose !== undefined) {\n        dispose();\n        requestDisposers.delete(disposedAgent);\n      }\n    });\n    this.harness.on(\"agent/created\", ({ agent }) => {\n      // `prepend` puts this listener OUTERMOST in the `agent/request`\n      // waterfall: the harness's model-selection listener runs inside it, so\n      // this rewrite is applied LAST and wins over the session's selected\n      // model (which dsh-base defaulted to deepseek-v4-flash, now deepseek-flash, and the user\n      // settings or UI can change).\n      const dispose = agent.ctx.on(\n        \"agent/request\",\n        async (payload, next) => {\n          const resolved = await next();\n          const cfg = this.source();\n          if (!cfg.enabled) return resolved;\n          // Vision branch FIRST: any request whose session log carries image\n          // content is stamped with the vision model, regardless of role. The\n          // `agent/request` waterfall payload never includes `messages`, so\n          // detection reads the session event log (`user/message`,\n          // `assistant/message`, `tool/result`). The harness's own\n          // model-selection listener has already run (`await next()`), so\n          // this rewrite wins over the session model.\n          if (shouldUseVision(agent.session?.events, cfg.vision)) {\n            const stamped: Record<string, unknown> = {\n              ...resolved,\n              provider: cfg.vision.provider,\n              model: cfg.vision.model,\n            };\n            if (cfg.vision.maxTokens !== undefined) stamped.maxTokens = cfg.vision.maxTokens;\n            const effort = effortFor(cfg.vision, agent.session?.events);\n            if (effort !== undefined) stamped.reasoningEffort = effort;\n            return stamped;\n          }\n          const route = routeFor(agent, cfg, isPlanModeActive(agent));\n          if (route === undefined) return resolved;\n          const stamped: Record<string, unknown> = {\n            ...resolved,\n            provider: route.provider,\n            model: route.model,\n          };\n          if (route.maxTokens !== undefined) stamped.maxTokens = route.maxTokens;\n          const effort = effortFor(route, agent.session?.events);\n          if (effort !== undefined) stamped.reasoningEffort = effort;\n          return stamped;\n        },\n        { prepend: true },\n      );\n      const prev = requestDisposers.get(agent);\n      if (prev !== undefined) prev();\n      requestDisposers.set(agent, dispose);\n    });\n\n    // Register the convention surface from the composition config, then let\n    // the settings section (when mounted) take over as the live source.\n    this.render(this.config);\n    installSettingsSection(\n      ctx,\n      SETTINGS_NS,\n      Config,\n      this.config as unknown as ReturnType<typeof Config>,\n      {\n        setSource: (current) => {\n          this.source = current;\n        },\n        onChange: () => this.render(this.source()),\n      },\n    );\n  }\n\n  /**\n   * Register the convention surface (prompt section + skill) for `cfg`,\n   * replacing whatever is currently registered. Called on construction and\n   * after every committed settings change; while `enabled` is false, nothing\n   * stays registered.\n   */\n  private render(cfg: RouterConfig): void {\n    if (this.promptDispose) {\n      this.promptDispose();\n      this.promptDispose = undefined;\n    }\n    if (this.skillDispose) {\n      this.skillDispose();\n      this.skillDispose = undefined;\n    }\n    if (!cfg.enabled) return;\n    if (cfg.promptSection) {\n      this.promptDispose = this.harness.systemPrompt.section({\n        name: ROW_ID,\n        order: SECTION_ORDER,\n        text: SECTION_TEXT.replaceAll(\"{PLANNER_MODEL}\", cfg.planner.model)\n          .replaceAll(\"{EXECUTOR_MODEL}\", cfg.executor.model)\n          .replace(\n            \"{VISION_LINE}\",\n            cfg.vision.enabled\n              ? ` Image-bearing requests route to ${cfg.vision.model}.`\n              : \"\",\n          ),\n      });\n    }\n    if (cfg.skill) {\n      this.skillDispose = this.harness.skills.register({\n        name: SKILL_NAME,\n        description: SKILL_DESCRIPTION,\n        whenToUse: SKILL_WHEN_TO_USE,\n        content: buildSkillContent(cfg),\n        source: \"runtime\",\n      });\n    }\n  }\n}\n\nexport {\n  Config,\n  ModelRouter,\n  ModelRouter as default,\n  SETTINGS_NS,\n  VisionRouteSchema,\n  buildSkillContent,\n  name,\n  ROW_ID,\n  SKILL_CONTENT,\n  SKILL_DESCRIPTION,\n  SKILL_NAME,\n  SKILL_WHEN_TO_USE,\n  effortFor,\n  hasImageContent,\n  recentStepsHadError,\n  roleFor,\n  routeFor,\n  sessionHasImage,\n  shouldUseVision,\n};\nexport type {\n  AgentRole,\n  ModelRoute,\n  ReasoningEffort,\n  RoutingMode,\n  RouterConfig,\n  VisionRoute,\n} from \"./policy.js\";\n","/**\n * Pure routing policy for dsh-model-router: which model each agent role gets.\n * Kept free of Cordis imports so the policy is trivially unit-testable.\n * @module dsh-model-router/policy\n */\n\n/** Reasoning-effort levels a route may pin (mirrors the harness vocabulary). */\nexport type ReasoningEffort = \"off\" | \"low\" | \"high\" | \"max\";\n\n/**\n * How the router treats the root agent.\n * - `strict`: the root agent is always the planner (pro).\n * - `plan`: the root agent is pro only while plan mode is active; otherwise it\n *   falls back to the executor route, reserving pro for real planning.\n */\nexport type RoutingMode = \"strict\" | \"plan\";\n\n/** One route: a provider/model pair stamped onto an agent request. */\nexport interface ModelRoute {\n  provider: string;\n  model: string;\n  /**\n   * Optional reasoning-effort override. When omitted, the request inherits the\n   * session's own selection; when set, the router pins it for that role.\n   */\n  reasoningEffort?: ReasoningEffort;\n  /** Optional output-token cap for the role; omitted means inherit. */\n  maxTokens?: number;\n  /**\n   * Error-driven escalation (v1): when true, a failed execution step bumps the\n   * next request's effort to `escalateTo`, wearing off after `recoverySteps`\n   * clean steps. Deterministic, stateless — the session log is folded per\n   * request, so only *prior* steps are ever considered.\n   */\n  escalateOnError?: boolean;\n  /** Effort used for the request after a failed step. */\n  escalateTo?: ReasoningEffort;\n  /** Clean steps before escalation wears off. Defaults to 2. */\n  recoverySteps?: number;\n}\n\n/** The two roles the router distinguishes. */\nexport type AgentRole = \"planner\" | \"executor\";\n\n/**\n * Opt-in vision route: when enabled, any request whose messages carry image\n * content is stamped with the vision model, from every role (root agent and\n * subagents alike). Everything else keeps the pro/flash role routing.\n */\nexport interface VisionRoute {\n  /** Master switch. Defaults to false — vision routing is opt-in. */\n  enabled: boolean;\n  /** Provider the vision model is served from. */\n  provider: string;\n  /** The vision model to stamp onto image-bearing requests. */\n  model: string;\n  /** Optional reasoning-effort pin; omitted means inherit the session's. */\n  reasoningEffort?: ReasoningEffort;\n  /** Optional output-token cap; omitted means inherit the session's. */\n  maxTokens?: number;\n}\n\n/** Resolved router configuration: one route per role plus routing mode. */\nexport interface RouterConfig {\n  planner: ModelRoute;\n  executor: ModelRoute;\n  mode: RoutingMode;\n  /**\n   * Live off-switch. Defaults to true; settable from Settings → Plugins →\n   * model-router (applies immediately) or from the patch row (next boot).\n   * When false, the router stops rewriting requests and unregisters the\n   * prompt section and the skill.\n   */\n  enabled: boolean;\n  promptSection: boolean;\n  skill: boolean;\n  /** Opt-in vision routing for image-bearing requests (v0.6.0+). */\n  vision: VisionRoute;\n}\n\n/** Default recovery window: an error escalates for the next two completed steps. */\nexport const DEFAULT_RECOVERY_STEPS = 2;\n\n/**\n * Classify an agent as planner or executor.\n *\n * The main (root) agent of a session is the planner. Every agent created as a\n * delegation child — `subagent`, `subagent_fork`, workflow workers, ralph\n * rounds — is an executor. The harness stamps two durable facts on children:\n * `options.subagentDepth` (>= 1) and the session header `origin: \"subagent\"`.\n *\n * @param agent - the live agent (any subset of the runtime shape).\n * @returns the role the agent should be routed as.\n */\nexport function roleFor(agent: unknown): AgentRole {\n  const options = (agent as { options?: unknown })?.options;\n  const depth = (options as { subagentDepth?: unknown })?.subagentDepth;\n  if (typeof depth === \"number\" && depth >= 1) return \"executor\";\n  const session = (agent as { session?: unknown })?.session;\n  const origin = (session as { header?: unknown })?.header\n    ? ((session as { header: { origin?: unknown } }).header.origin)\n    : undefined;\n  if (origin === \"subagent\") return \"executor\";\n  return \"planner\";\n}\n\n/**\n * Resolve the route for one agent.\n * @param agent - the live agent.\n * @param config - the resolved router configuration.\n * @param planModeActive - whether plan mode is currently folded active for the\n *   agent's session; consulted only in `plan` routing mode.\n * @returns the model route to stamp, or `undefined` to leave the request alone.\n */\nexport function routeFor(\n  agent: unknown,\n  config: RouterConfig,\n  planModeActive = false,\n): ModelRoute | undefined {\n  const role = roleFor(agent);\n  if (role === \"executor\") return config.executor;\n  // Root agent. In `plan` mode, reserve the planner route for actual planning;\n  // otherwise the root falls back to the executor route.\n  if (config.mode === \"plan\" && !planModeActive) return config.executor;\n  return config.planner;\n}\n\n/**\n * Whether any of the last `recoverySteps` completed steps carried a failed\n * tool result. A failure is a `tool/result` event whose data carries an\n * `error` field (the harness records tool failures there).\n *\n * Steps are deduplicated by `turn:step`, and only *completed* steps count —\n * events are scanned from the tail, so the current in-flight request is never\n * considered.\n *\n * @param events - the agent's session event log (or `undefined`).\n * @param recoverySteps - how many completed steps back to scan.\n * @returns true when a failed step is within the window.\n */\nexport function recentStepsHadError(\n  events: readonly unknown[] | undefined,\n  recoverySteps: number = DEFAULT_RECOVERY_STEPS,\n): boolean {\n  if (!Array.isArray(events) || recoverySteps <= 0) return false;\n  const seen = new Set<string>();\n  let steps = 0;\n  for (let i = events.length - 1; i >= 0; i -= 1) {\n    const event = events[i] as\n      | { type?: string; data?: { turn?: number; step?: number; error?: unknown } }\n      | undefined;\n    if (event?.type !== \"tool/result\" || event.data === undefined) continue;\n    const key = `${event.data.turn}:${event.data.step}`;\n    if (!seen.has(key)) {\n      // A new step beyond the recovery window ends the scan; events for steps\n      // already inside the window are still checked below.\n      if (steps >= recoverySteps) break;\n      seen.add(key);\n      steps += 1;\n    }\n    if (event.data.error !== undefined && event.data.error !== null) return true;\n  }\n  return false;\n}\n\n/**\n * Resolve the reasoning effort to stamp for one request.\n *\n * Baseline is the route's `reasoningEffort`; when `escalateOnError` is enabled\n * and a recent step failed, the effort bumps to `escalateTo` (falling back to\n * the baseline when `escalateTo` is unset). Returns `undefined` to leave the\n * request's effort alone (inherit the session selection).\n *\n * @param route - the resolved route for the agent.\n * @param events - the agent's session event log.\n * @returns the effort to stamp, or `undefined` to inherit.\n */\nexport function effortFor(\n  route: ModelRoute,\n  events: readonly unknown[] | undefined,\n): ReasoningEffort | undefined {\n  if (route.escalateOnError === true && recentStepsHadError(events, route.recoverySteps)) {\n    return route.escalateTo ?? route.reasoningEffort;\n  }\n  return route.reasoningEffort;\n}\n\n/**\n * Whether any message in a request payload carries image content.\n *\n * A message carries an image when its `content` is a block array containing\n * an `image` block, directly or nested inside a `tool-result` block (tool\n * results may embed the images they produced). String content never does.\n *\n * @deprecated Superseded by {@link sessionHasImage} (v0.6.2): the\n * `agent/request` waterfall payload never carries `messages`, so production\n * routing reads the session event log instead. Kept for backward compat.\n * @param messages - the request's `messages` array (any runtime shape).\n * @returns true when at least one message contains image content.\n */\nexport function hasImageContent(messages: unknown): boolean {\n  if (!Array.isArray(messages)) return false;\n  for (const message of messages) {\n    const content = (message as { content?: unknown })?.content;\n    if (typeof content === \"string\") continue;\n    if (Array.isArray(content) && blocksContainImage(content)) return true;\n  }\n  return false;\n}\n\n/**\n * Whether the agent's session log carries any image content.\n *\n * The `agent/request` waterfall payload never includes `messages`, so vision\n * detection reads the session event log instead. Shapes mirror the harness\n * `SessionEventMap` (`@deepseek-ai/dsh-session`):\n * - `user/message` event's data IS the `UserMessage` (content at `data.content`),\n * - `assistant/message` content lives at `data.message.content` (`AssistantMessage`),\n * - `tool/result` content lives at `data.message.content` (`ToolResultMessage`,\n *   a single-element `[ToolResultBlock]` whose nested `content` may hold images).\n * Blocks may also nest images inside `tool-result` blocks. Extraction tries\n * `data.message.content` first, then `data.content`, so minor harness shape\n * drift still detects rather than silently missing.\n *\n * Sticky by design: one image anywhere in the log routes vision for the rest\n * of the session, because the image stays in request context until compaction\n * or pruning drops it. The scan is O(N) per request from the tail (early exit\n * on hit); text-only sessions scan the full log, which is fine at session scale.\n *\n * @param events - the agent's session event log (or `undefined`).\n * @returns true when any user, assistant, or tool-result message carries image content.\n */\nexport function sessionHasImage(events: readonly unknown[] | undefined): boolean {\n  if (!Array.isArray(events)) return false;\n  for (let i = events.length - 1; i >= 0; i -= 1) {\n    const event = events[i] as\n      | { type?: string; data?: { content?: unknown; message?: { content?: unknown } } }\n      | undefined;\n    if (\n      event?.type !== \"user/message\" &&\n      event?.type !== \"assistant/message\" &&\n      event?.type !== \"tool/result\"\n    )\n      continue;\n    // Robust extraction: prefer the wrapped message shape, fall back to direct.\n    const content = event.data?.message?.content ?? event.data?.content;\n    if (Array.isArray(content) && blocksContainImage(content)) return true;\n  }\n  return false;\n}\n\n/**\n * Whether a request should take the vision route.\n *\n * Pure, testable wiring helper for the `agent/request` listener in\n * `src/index.ts`: vision wins only when explicitly enabled AND the session\n * log carries an image. Extracted so the gating logic is covered without\n * spinning up Cordis.\n *\n * @param events - the agent's session event log.\n * @param vision - the resolved vision route (only `enabled` is read).\n * @returns true when the request must be stamped with the vision model.\n */\nexport function shouldUseVision(\n  events: readonly unknown[] | undefined,\n  vision: Pick<VisionRoute, \"enabled\"> | undefined,\n): boolean {\n  if (vision?.enabled !== true) return false;\n  return sessionHasImage(events);\n}\n\n/**\n * Whether any block (or nested tool-result content) is an image block.\n * Exact `type` matching is intentional: it mirrors the harness\n * `ContentBlockMap` vocabulary (`@deepseek-ai/dsh-llm`: `text`, `reasoning`,\n * `image`, `tool-call`, `tool-result`). Provider wire variants (`image_url`,\n * `input_image`, …) are normalized by adapters before reaching the log.\n */\nfunction blocksContainImage(blocks: readonly unknown[]): boolean {\n  for (const block of blocks) {\n    const candidate = block as { type?: unknown; content?: unknown };\n    if (candidate?.type === \"image\") return true;\n    if (candidate?.type === \"tool-result\" && Array.isArray(candidate.content) && blocksContainImage(candidate.content)) return true;\n  }\n  return false;\n}\n"],"mappings":"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","names":["stamped","effort"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-model-router",
-  "description": "DeepSeek Harness plugin: role-based model routing — the planner agent runs on deepseek-v4-pro, delegated executor subagents run on deepseek-v4-flash.",
-  "version": "0.6.3",
+  "description": "DeepSeek Harness plugin: role-based model routing — both roles default to deepseek-flash (V4.1 Flash, native multimodal) until V4.1-Pro launches.",
+  "version": "0.7.1",
   "publishConfig": {
     "access": "public"
   },

package/skills/pro-flash-routing/SKILL.md

@@ -6,26 +6,30 @@ whenToUse: Use when a task combines planning and implementation: before writing
 
 # Pro planner / Flash executor routing
 
-This session routes models by role:
+This session routes models by role (planner `deepseek-flash`, executor `deepseek-flash`; both default to deepseek-flash, V4.1 Flash with native multimodal; vision needs no separate model):
 
-- **Planner (the root agent)** — `deepseek-v4-pro`. Planning, design decisions, reviewing delegated output, and user-facing synthesis happen here.
-- **Executors (every subagent)** — `deepseek-v4-flash`. Implementation work happens there: writing code, running commands, builds, and tests. The harness forces the model automatically; you do not select it.
+- **Planner (this agent)** — `deepseek-flash`. Planning, design decisions, reviewing delegated output, and user-facing synthesis happen here.
+- **Executors (every subagent)** — `deepseek-flash`. Implementation work happens there: writing code, running commands, builds, and tests. The harness forces the model automatically; you do not select it.
 
 ## Working rhythm
 
 1. **Plan here.** Explore, decide the approach, and (when plan mode is on) submit the plan with `exit_plan_mode`. The plan stays on this agent.
-2. **Delegate the execution.** Once a plan is approved, hand each self-contained chunk of implementation to a subagent with a complete prompt: exact files to touch, the change to make, and how to verify. Subagents are automatically routed to `deepseek-v4-flash`, so keep them execution-focused: give them the decision, not the decision to make.
+2. **Delegate the execution.** Once a plan is approved, hand each self-contained chunk of implementation to a subagent with a complete prompt: exact files to touch, the change to make, and how to verify. Subagents are automatically routed to `deepseek-flash`, so keep them execution-focused: give them the decision, not the decision to make.
 3. **Review here.** Read the subagent's result on this agent, verify it yourself (tests, diffs, logs), and iterate with follow-up messages to the same subagent when available.
 4. **Report here.** Summaries, plans, and answers to the user come from this agent.
 
+## Keep this agent's context lean
+
+Input tokens are the expensive part of the planner. Don't re-read large files or full transcripts on this agent — trust the subagent's final report. Prefer targeted reads (offset/limit) over whole files. When the context grows, compact rather than re-sending everything.
+
 ## Delegation guidelines
 
 - Start independent delegations together in one assistant message and continue useful work while they run (background mode by default).
-- Prefer `subagent` for self-contained work and `workflow` when many independent pieces need fan-out; their workers run on flash as well.
+- Prefer `subagent` for self-contained work and `workflow` when many independent pieces need fan-out; their workers run on `deepseek-flash` as well.
 - Do not delegate design: subagents execute decisions already made.
 - If a subagent's task grows into design work, pull it back to this agent and re-delegate the narrowed execution.
 
 ## Verification
 
-- Executor output was produced by `deepseek-v4-flash`; planner output by `deepseek-v4-pro`. If you need to confirm, check the session log's model metadata.
+- Planner produces `deepseek-flash`, executor produces `deepseek-flash` (unified when equal since V4.1; split again when V4.1-Pro lands). If you need to confirm, check the session log's model metadata.
 - If routing ever looks wrong, the `model-router` plugin row in the profile composition is the single place that owns it.