npm - dsh-model-router - Versions diffs - 0.4.0 → 0.6.0 - Mend

dsh-model-router 0.4.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/README.md CHANGED Viewed

@@ -53,7 +53,8 @@ Routing is on by default. Two ways to switch it off:
 - **GUI (Settings → Plugins → dsh-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.
+  section and the skill too. Flip it back on and everything returns. The same
+  card also hosts the Vision switch (v0.6.0+, see below).
 - **Patch row:** set `enabled: false` in the profile's `cordis.patch.yml` row
   (takes effect on the next boot). `disabled: true` still skips the row entirely.
@@ -61,6 +62,61 @@ With the router off, requests use the session's selected model (your
 `agent-default-model` setting or the base default) — the router is simply not
 rewriting them.
+## The GUI toggle (v0.5.0+)
+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
+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
+work everywhere:
+- **Patch row** — set `enabled: false` in the profile's `cordis.patch.yml`
+  (takes effect on the next boot), or
+- **`settings.yaml`** — add `model-router: { enabled: false }` under the
+  settings file the profile uses; this applies live, same as the GUI.
+## Vision routing (v0.6.0+)
+Since v0.6.0 the router can also handle image-bearing requests. **It is opt-in
+and off by default** (`vision.enabled: false`). Two ways to turn it on:
+- **GUI:** on the same **Model router** card, flip the **Vision** switch (live,
+  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` /
+`vision.maxTokens` pins work exactly like the per-role ones.
+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
+- **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
+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.
 ## Tuning
 All configuration lives on the plugin row. Patch it in the profile's `cordis.patch.yml`:

package/cordis.patch.yml CHANGED Viewed

@@ -29,7 +29,33 @@
         #         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
+        # 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.
+- patch:
+    - id: llm-deepseek
+      config:
+        models:
+          - id: deepseek-v4-flash
+            name: DeepSeek-V4-Flash
+            contextWindow: 1000000
+            maxTokens: 256000
+          - id: deepseek-v4-pro
+            name: DeepSeek-V4-Pro
+            contextWindow: 1000000
+            maxTokens: 256000
+          - id: deepseek-v4-flash-vision-exp
+            name: DeepSeek-V4-Flash-Vision-Exp
+            contextWindow: 1000000
+            maxTokens: 256000
+            inputModalities: [text, image]
+    - id: attachment-local
+      config:
+        maxImageDimension: 8192
+        maxImagePixels: 100000000
+        maxImageBytes: 15728640

package/lib/client.js ADDED Viewed

@@ -0,0 +1,356 @@
+window.__ModuleLoader__.load({
+	id: "dsh-model-router",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+// src/client.tsx
+var client_exports = {};
+__export(client_exports, {
+  apply: () => apply,
+  inject: () => inject
+});
+module.exports = __toCommonJS(client_exports);
+var import_react = require("react");
+var NS = "model-router";
+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.",
+  enabled: "Enabled",
+  enabledHint: "Off stops rewriting requests and unregisters the prompt section and skill; on restores them.",
+  on: "On",
+  off: "Off",
+  reset: "Reset to default",
+  overridden: "Overridden",
+  readOnly: "This deployment stores settings read-only in this browser; use the plugin row in the profile's cordis.patch.yml instead.",
+  plannerRoute: "Planner model",
+  executorRoute: "Executor model",
+  mode: "Mode",
+  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.",
+  visionSwitch: "Vision",
+  visionReset: "Reset vision to default",
+  visionRoute: "Vision model"
+};
+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",
+  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",
+  off: "\u5173",
+  reset: "\u6062\u590D\u9ED8\u8BA4",
+  overridden: "\u5DF2\u8986\u76D6",
+  readOnly: "\u5F53\u524D\u6D4F\u89C8\u5668\u4E2D\u8BE5\u90E8\u7F72\u7684\u8BBE\u7F6E\u4E3A\u53EA\u8BFB\uFF1B\u8BF7\u6539\u7528 profile \u7684 cordis.patch.yml \u4E2D\u7684\u63D2\u4EF6\u884C\u3002",
+  plannerRoute: "\u89C4\u5212\u6A21\u578B",
+  executorRoute: "\u6267\u884C\u6A21\u578B",
+  mode: "\u6A21\u5F0F",
+  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",
+  visionSwitch: "\u89C6\u89C9",
+  visionReset: "\u6062\u590D\u89C6\u89C9\u9ED8\u8BA4\u503C",
+  visionRoute: "\u89C6\u89C9\u6A21\u578B"
+};
+var ModelRouterCardController = class {
+  scope;
+  constructor(scope) {
+    this.scope = scope;
+  }
+  get store() {
+    return {
+      subscribe: (listener) => this.scope.subscribe(listener),
+      getSnapshot: () => this.scope.getSnapshot()
+    };
+  }
+  /** Build the face the card's slot registration injects. */
+  inject() {
+    return {
+      hooks: { modelRouterCard: this.store },
+      setEnabled: async (next) => {
+        try {
+          await this.scope.set("enabled", next);
+        } catch {
+        }
+      },
+      reset: async () => {
+        try {
+          await this.scope.unset("enabled");
+        } catch {
+        }
+      },
+      // Vision toggle merges into the current user-layer vision object so the
+      // provider/model base fields survive the write; reset drops the whole
+      // vision key from the user layer, restoring the schema defaults.
+      setVisionEnabled: async (next) => {
+        try {
+          const current = this.scope.getSnapshot().value?.vision;
+          await this.scope.set("vision", { ...current ?? {}, enabled: next });
+        } catch {
+        }
+      },
+      resetVision: async () => {
+        try {
+          await this.scope.unset("vision");
+        } catch {
+        }
+      }
+    };
+  }
+  /** Stop the scope's mirror subscription when the fiber stops. */
+  dispose() {
+    void this.scope.dispose();
+  }
+};
+function routeRow(label, value) {
+  return (0, import_react.createElement)("div", { style: styles.routeRow }, [
+    (0, import_react.createElement)("dt", { style: styles.routeLabel }, label),
+    (0, import_react.createElement)("dd", { style: styles.routeValue }, value)
+  ]);
+}
+function modeLabel(t, mode) {
+  return mode === "plan" ? t("modePlan") : t("modeStrict");
+}
+function ModelRouterCard(props) {
+  const { t } = props;
+  const state = props.useModelRouterCard((snapshot) => snapshot);
+  const unavailable = !state.writable || state.mode !== "host";
+  const overridden = state.user?.enabled !== void 0;
+  const visionOverridden = state.user?.vision !== void 0;
+  return (0, import_react.createElement)("section", { style: styles.card }, [
+    (0, import_react.createElement)("div", { style: styles.headRow }, [
+      (0, import_react.createElement)("h3", { style: styles.title }, t("title")),
+      overridden ? (0, import_react.createElement)("span", { style: styles.badge }, t("overridden")) : null
+    ]),
+    (0, import_react.createElement)("p", { style: styles.description }, t("description")),
+    ...unavailable ? [(0, import_react.createElement)("p", { style: styles.note }, t("readOnly"))] : state.value ? [
+      (0, import_react.createElement)("div", { style: styles.switchRow }, [
+        (0, import_react.createElement)("label", { htmlFor: "model-router-enabled", style: styles.label }, t("enabled")),
+        (0, import_react.createElement)("input", {
+          id: "model-router-enabled",
+          type: "checkbox",
+          checked: Boolean(state.value.enabled),
+          onChange: (event) => {
+            void props.setEnabled(event.currentTarget.checked);
+          },
+          style: styles.switch
+        }),
+        (0, import_react.createElement)("span", { style: styles.status }, state.value.enabled ? t("on") : t("off"))
+      ]),
+      (0, import_react.createElement)("p", { style: styles.hint }, t("enabledHint")),
+      overridden ? (0, import_react.createElement)(
+        "button",
+        { type: "button", style: styles.reset, onClick: () => void props.reset() },
+        t("reset")
+      ) : null,
+      (0, import_react.createElement)("div", { style: styles.vision }, [
+        (0, import_react.createElement)("div", { style: styles.switchRow }, [
+          (0, import_react.createElement)("label", { htmlFor: "model-router-vision", style: styles.label }, t("visionSwitch")),
+          (0, import_react.createElement)("input", {
+            id: "model-router-vision",
+            type: "checkbox",
+            checked: Boolean(state.value.vision?.enabled),
+            onChange: (event) => {
+              void props.setVisionEnabled(event.currentTarget.checked);
+            },
+            style: styles.switch
+          }),
+          (0, import_react.createElement)("span", { style: styles.status }, state.value.vision?.enabled ? t("on") : t("off"))
+        ]),
+        (0, import_react.createElement)("p", { style: styles.hint }, t("visionDesc")),
+        visionOverridden ? (0, import_react.createElement)(
+          "button",
+          { type: "button", style: styles.reset, onClick: () => void props.resetVision() },
+          t("visionReset")
+        ) : null,
+        (0, import_react.createElement)("dl", { style: styles.routes }, [
+          routeRow(
+            t("visionRoute"),
+            `${state.value.vision?.model ?? "\u2014"} \xB7 ${state.value.vision?.provider ?? "\u2014"}`
+          )
+        ])
+      ]),
+      (0, import_react.createElement)("dl", { style: styles.routes }, [
+        routeRow(t("plannerRoute"), state.value.planner?.model ?? "\u2014"),
+        routeRow(t("executorRoute"), state.value.executor?.model ?? "\u2014"),
+        routeRow(t("mode"), modeLabel(t, state.value.mode))
+      ])
+    ] : []
+  ]);
+}
+var styles = {
+  card: {
+    display: "flex",
+    flexDirection: "column",
+    gap: "10px",
+    padding: "16px 18px",
+    background: "var(--dsw-alias-bg-layer-3)",
+    border: "1px solid var(--dsw-alias-border-l2)",
+    borderRadius: "12px",
+    color: "var(--dsw-alias-label-primary)",
+    font: "inherit"
+  },
+  headRow: {
+    display: "flex",
+    alignItems: "center",
+    gap: "8px"
+  },
+  title: {
+    margin: 0,
+    fontSize: "15px",
+    fontWeight: 600,
+    lineHeight: 1.4
+  },
+  badge: {
+    whiteSpace: "nowrap",
+    background: "var(--dsw-alias-bg-module-platform)",
+    color: "var(--dsw-alias-label-secondary)",
+    borderRadius: "999px",
+    padding: "1px 8px",
+    fontSize: "11px",
+    fontWeight: 500,
+    lineHeight: "17px"
+  },
+  description: {
+    margin: 0,
+    color: "var(--dsw-alias-label-secondary)",
+    fontSize: "13px",
+    lineHeight: 1.5
+  },
+  switchRow: {
+    display: "flex",
+    alignItems: "center",
+    gap: "10px",
+    padding: "10px 0"
+  },
+  label: {
+    flex: 1,
+    minWidth: 0,
+    fontSize: "13px",
+    fontWeight: 500,
+    lineHeight: 1.5
+  },
+  switch: {
+    width: "16px",
+    height: "16px",
+    accentColor: "var(--dsw-alias-brand-primary)",
+    cursor: "pointer"
+  },
+  status: {
+    color: "var(--dsw-alias-label-secondary)",
+    fontSize: "12px",
+    lineHeight: 1.5,
+    minWidth: "24px"
+  },
+  hint: {
+    margin: 0,
+    color: "var(--dsw-alias-label-tertiary)",
+    fontSize: "12px",
+    lineHeight: 1.5
+  },
+  reset: {
+    alignSelf: "flex-start",
+    font: "inherit",
+    color: "var(--dsw-alias-label-secondary)",
+    background: "none",
+    border: "1px solid var(--dsw-alias-border-l2)",
+    borderRadius: "8px",
+    padding: "4px 10px",
+    fontSize: "12px",
+    lineHeight: 1.5,
+    cursor: "pointer"
+  },
+  routes: {
+    margin: "4px 0 0",
+    padding: "10px 0 0",
+    borderTop: "1px solid var(--dsw-alias-border-l2)",
+    display: "flex",
+    flexDirection: "column",
+    gap: "6px"
+  },
+  vision: {
+    margin: "4px 0 0",
+    padding: "12px 0 0",
+    borderTop: "1px solid var(--dsw-alias-border-l2)"
+  },
+  routeRow: {
+    display: "flex",
+    alignItems: "center",
+    gap: "8px"
+  },
+  routeLabel: {
+    minWidth: 0,
+    flex: 1,
+    margin: 0,
+    color: "var(--dsw-alias-label-secondary)",
+    fontSize: "12px",
+    lineHeight: 1.5
+  },
+  routeValue: {
+    margin: 0,
+    color: "var(--dsw-alias-label-primary)",
+    fontSize: "12px",
+    lineHeight: 1.5,
+    fontVariantNumeric: "tabular-nums"
+  },
+  note: {
+    margin: 0,
+    color: "var(--dsw-alias-label-tertiary)",
+    fontSize: "12px",
+    lineHeight: 1.5
+  }
+};
+function apply(ctx) {
+  const t = ctx.locale.bind(NS);
+  ctx.effect(
+    () => {
+      ctx.locale.register(NS, { zh, en });
+    },
+    "model-router: card dictionaries"
+  );
+  const controller = new ModelRouterCardController(ctx.settingsScope.bind({ namespace: NS }));
+  ctx.slots.inject("settings.plugin.item", function* () {
+    yield ctx.slots.register(
+      {
+        name: "settings.plugin.item",
+        key: NS,
+        locale: NS,
+        inject: () => controller.inject()
+      },
+      ModelRouterCard
+    );
+  });
+  ctx.effect(
+    () => () => controller.dispose(),
+    "model-router: card controller"
+  );
+}
+		return module.exports;
+	}
+});

package/lib/index.d.ts CHANGED Viewed

@@ -41,6 +41,23 @@ interface ModelRoute {
 }
 /** The two roles the router distinguishes. */
 type AgentRole = "planner" | "executor";
+/**
+ * Opt-in vision route: when enabled, any request whose messages carry image
+ * content is stamped with the vision model, from every role (root agent and
+ * subagents alike). Everything else keeps the pro/flash role routing.
+ */
+interface VisionRoute {
+    /** Master switch. Defaults to false — vision routing is opt-in. */
+    enabled: boolean;
+    /** Provider the vision model is served from. */
+    provider: string;
+    /** The vision model to stamp onto image-bearing requests. */
+    model: string;
+    /** Optional reasoning-effort pin; omitted means inherit the session's. */
+    reasoningEffort?: ReasoningEffort;
+    /** Optional output-token cap; omitted means inherit the session's. */
+    maxTokens?: number;
+}
 /** Resolved router configuration: one route per role plus routing mode. */
 interface RouterConfig {
     planner: ModelRoute;
@@ -55,6 +72,8 @@ interface RouterConfig {
     enabled: boolean;
     promptSection: boolean;
     skill: boolean;
+    /** Opt-in vision routing for image-bearing requests (v0.6.0+). */
+    vision: VisionRoute;
 }
 /**
  * Classify an agent as planner or executor.
@@ -104,9 +123,37 @@ declare function recentStepsHadError(events: readonly unknown[] | undefined, rec
  * @returns the effort to stamp, or `undefined` to inherit.
  */
 declare function effortFor(route: ModelRoute, events: readonly unknown[] | undefined): ReasoningEffort | undefined;
+/**
+ * Whether any message in a request payload carries image content.
+ *
+ * A message carries an image when its `content` is a block array containing
+ * an `image` block, directly or nested inside a `tool-result` block (tool
+ * results may embed the images they produced). String content never does.
+ *
+ * @param messages - the request's `messages` array (any runtime shape).
+ * @returns true when at least one message contains image content.
+ */
+declare function hasImageContent(messages: unknown): boolean;
 /** 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.
+ */
+declare const VisionRouteSchema: z<Schemastery.ObjectS<{
+    enabled: z<boolean, boolean>;
+    provider: z<string, string>;
+    model: z<string, string>;
+    reasoningEffort: z<"off" | "low" | "high" | "max", "off" | "low" | "high" | "max">;
+    maxTokens: z<number, number>;
+}>, Schemastery.ObjectT<{
+    enabled: z<boolean, boolean>;
+    provider: z<string, string>;
+    model: z<string, string>;
+    reasoningEffort: z<"off" | "low" | "high" | "max", "off" | "low" | "high" | "max">;
+    maxTokens: z<number, number>;
+}>>;
 /** The plugin's public config, validated at row load. */
 declare const Config: z<Schemastery.ObjectS<{
     planner: z<Schemastery.ObjectS<{
@@ -147,6 +194,19 @@ declare const Config: z<Schemastery.ObjectS<{
     enabled: z<boolean, boolean>;
     promptSection: z<boolean, boolean>;
     skill: z<boolean, boolean>;
+    vision: z<Schemastery.ObjectS<{
+        enabled: z<boolean, boolean>;
+        provider: z<string, string>;
+        model: z<string, string>;
+        reasoningEffort: z<"off" | "low" | "high" | "max", "off" | "low" | "high" | "max">;
+        maxTokens: z<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: z<boolean, boolean>;
+        provider: z<string, string>;
+        model: z<string, string>;
+        reasoningEffort: z<"off" | "low" | "high" | "max", "off" | "low" | "high" | "max">;
+        maxTokens: z<number, number>;
+    }>>;
 }>, Schemastery.ObjectT<{
     planner: z<Schemastery.ObjectS<{
         provider: z<string, string>;
@@ -186,6 +246,19 @@ declare const Config: z<Schemastery.ObjectS<{
     enabled: z<boolean, boolean>;
     promptSection: z<boolean, boolean>;
     skill: z<boolean, boolean>;
+    vision: z<Schemastery.ObjectS<{
+        enabled: z<boolean, boolean>;
+        provider: z<string, string>;
+        model: z<string, string>;
+        reasoningEffort: z<"off" | "low" | "high" | "max", "off" | "low" | "high" | "max">;
+        maxTokens: z<number, number>;
+    }>, Schemastery.ObjectT<{
+        enabled: z<boolean, boolean>;
+        provider: z<string, string>;
+        model: z<string, string>;
+        reasoningEffort: z<"off" | "low" | "high" | "max", "off" | "low" | "high" | "max">;
+        maxTokens: z<number, number>;
+    }>>;
 }>>;
 /** Settings namespace the live on/off toggle lives under (settings.yaml). */
 declare const SETTINGS_NS: _deepseek_ai_dsh_settings.SettingsNamespace;
@@ -261,4 +334,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, ModelRouter as default, effortFor, name, recentStepsHadError, roleFor, routeFor };
+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 };

package/lib/index.js CHANGED Viewed

@@ -44,6 +44,23 @@ function effortFor(route, events) {
   }
   return route.reasoningEffort;
 }
+function hasImageContent(messages) {
+  if (!Array.isArray(messages)) return false;
+  for (const message of messages) {
+    const content = message?.content;
+    if (typeof content === "string") continue;
+    if (Array.isArray(content) && blocksContainImage(content)) return true;
+  }
+  return false;
+}
+function blocksContainImage(blocks) {
+  for (const block of blocks) {
+    const candidate = block;
+    if (candidate?.type === "image") return true;
+    if (candidate?.type === "tool-result" && Array.isArray(candidate.content) && blocksContainImage(candidate.content)) return true;
+  }
+  return false;
+}
 // src/index.ts
 var name = "model-router";
@@ -56,6 +73,13 @@ var ModelRouteSchema = z.object({
   escalateTo: z.union(["off", "low", "high", "max"]),
   recoverySteps: z.number().min(1)
 });
+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"),
+  reasoningEffort: z.union(["off", "low", "high", "max"]),
+  maxTokens: z.number().min(1)
+});
 var Config = z.object({
   planner: ModelRouteSchema.default({
     provider: "deepseek-official",
@@ -68,7 +92,8 @@ var Config = z.object({
   mode: z.union(["strict", "plan"]).default("strict"),
   enabled: z.boolean().default(true),
   promptSection: z.boolean().default(true),
-  skill: z.boolean().default(true)
+  skill: z.boolean().default(true),
+  vision: VisionRouteSchema.default({})
 });
 var SETTINGS_NS = settingsNamespace("model-router");
 function resolveConfig(raw) {
@@ -79,11 +104,12 @@ function resolveConfig(raw) {
     mode: parsed.mode,
     enabled: parsed.enabled,
     promptSection: parsed.promptSection,
-    skill: parsed.skill
+    skill: parsed.skill,
+    vision: parsed.vision
   };
 }
 var SECTION_ORDER = -50;
-var 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 \u2014 writing code, running commands, builds, tests \u2014 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.`;
+var 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 \u2014 writing code, running commands, builds, tests \u2014 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}`;
 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.`;
@@ -149,6 +175,17 @@ var ModelRouter = class extends Service {
           const resolved = await next();
           const cfg = this.source();
           if (!cfg.enabled) return resolved;
+          if (cfg.vision.enabled && hasImageContent(resolved.messages)) {
+            const stamped2 = {
+              ...resolved,
+              provider: cfg.vision.provider,
+              model: cfg.vision.model
+            };
+            if (cfg.vision.maxTokens !== void 0) stamped2.maxTokens = cfg.vision.maxTokens;
+            const effort2 = effortFor(cfg.vision, agent.session?.events);
+            if (effort2 !== void 0) stamped2.reasoningEffort = effort2;
+            return stamped2;
+          }
           const route = routeFor(agent, cfg, isPlanModeActive(agent));
           if (route === void 0) return resolved;
           const stamped = {
@@ -201,9 +238,9 @@ var ModelRouter = class extends Service {
       this.promptDispose = this.harness.systemPrompt.section({
         name: ROW_ID,
         order: SECTION_ORDER,
-        text: SECTION_TEXT.replaceAll("{PLANNER_MODEL}", cfg.planner.model).replaceAll(
-          "{EXECUTOR_MODEL}",
-          cfg.executor.model
+        text: SECTION_TEXT.replaceAll("{PLANNER_MODEL}", cfg.planner.model).replaceAll("{EXECUTOR_MODEL}", cfg.executor.model).replace(
+          "{VISION_LINE}",
+          cfg.vision.enabled ? ` Image-bearing requests route to ${cfg.vision.model}.` : ""
         )
       });
     }
@@ -227,8 +264,10 @@ export {
   SKILL_DESCRIPTION,
   SKILL_NAME,
   SKILL_WHEN_TO_USE,
+  VisionRouteSchema,
   ModelRouter as default,
   effortFor,
+  hasImageContent,
   name,
   recentStepsHadError,
   roleFor,

package/lib/index.js.map CHANGED Viewed

	@@ -1 +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, recentStepsHadError, roleFor, routeFor, 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/* 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});\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 };\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.`;\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 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).replaceAll(\n \"{EXECUTOR_MODEL}\",\n cfg.executor.model,\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 name,\n ROW_ID,\n SKILL_CONTENT,\n SKILL_DESCRIPTION,\n SKILL_NAME,\n SKILL_WHEN_TO_USE,\n effortFor,\n recentStepsHadError,\n roleFor,\n routeFor,\n};\nexport type {\n AgentRole,\n ModelRoute,\n ReasoningEffort,\n RoutingMode,\n RouterConfig,\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/* 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}\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"],"mappings":";AAoBA,SAAkB,eAAe;AACjC,OAAO,OAAO;AACd,SAAS,oBAAoB;AAC7B,SAAS,wBAAwB,yBAAyB;;;ACsCnD,IAAM,yBAAyB;AAa/B,SAAS,QAAQ,OAA2B;AACjD,QAAM,UAAW,OAAiC;AAClD,QAAM,QAAS,SAAyC;AACxD,MAAI,OAAO,UAAU,YAAY,SAAS,EAAG,QAAO;AACpD,QAAM,UAAW,OAAiC;AAClD,QAAM,SAAU,SAAkC,SAC5C,QAA6C,OAAO,SACtD;AACJ,MAAI,WAAW,WAAY,QAAO;AAClC,SAAO;AACT;AAUO,SAAS,SACd,OACA,QACA,iBAAiB,OACO;AACxB,QAAM,OAAO,QAAQ,KAAK;AAC1B,MAAI,SAAS,WAAY,QAAO,OAAO;AAGvC,MAAI,OAAO,SAAS,UAAU,CAAC,eAAgB,QAAO,OAAO;AAC7D,SAAO,OAAO;AAChB;AAeO,SAAS,oBACd,QACA,gBAAwB,wBACf;AACT,MAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,iBAAiB,EAAG,QAAO;AACzD,QAAM,OAAO,oBAAI,IAAY;AAC7B,MAAI,QAAQ;AACZ,WAAS,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG;AAC9C,UAAM,QAAQ,OAAO,CAAC;AAGtB,QAAI,OAAO,SAAS,iBAAiB,MAAM,SAAS,OAAW;AAC/D,UAAM,MAAM,GAAG,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI;AACjD,QAAI,CAAC,KAAK,IAAI,GAAG,GAAG;AAGlB,UAAI,SAAS,cAAe;AAC5B,WAAK,IAAI,GAAG;AACZ,eAAS;AAAA,IACX;AACA,QAAI,MAAM,KAAK,UAAU,UAAa,MAAM,KAAK,UAAU,KAAM,QAAO;AAAA,EAC1E;AACA,SAAO;AACT;AAcO,SAAS,UACd,OACA,QAC6B;AAC7B,MAAI,MAAM,oBAAoB,QAAQ,oBAAoB,QAAQ,MAAM,aAAa,GAAG;AACtF,WAAO,MAAM,cAAc,MAAM;AAAA,EACnC;AACA,SAAO,MAAM;AACf;;;AD1IA,IAAM,OAAO;AAGb,IAAM,mBAAmB,EAAE,OAAO;AAAA,EAChC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC1B,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACvB,iBAAiB,EAAE,MAAM,CAAC,OAAO,OAAO,QAAQ,KAAK,CAAC;AAAA,EACtD,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC3B,iBAAiB,EAAE,QAAQ;AAAA,EAC3B,YAAY,EAAE,MAAM,CAAC,OAAO,OAAO,QAAQ,KAAK,CAAC;AAAA,EACjD,eAAe,EAAE,OAAO,EAAE,IAAI,CAAC;AACjC,CAAC;AAGD,IAAM,SAAS,EAAE,OAAO;AAAA,EACtB,SAAS,iBAAiB,QAAQ;AAAA,IAChC,UAAU;AAAA,IACV,OAAO;AAAA,EACT,CAAU;AAAA,EACV,UAAU,iBAAiB,QAAQ;AAAA,IACjC,UAAU;AAAA,IACV,OAAO;AAAA,EACT,CAAU;AAAA,EACV,MAAM,EAAE,MAAM,CAAC,UAAU,MAAM,CAAC,EAAE,QAAQ,QAAQ;AAAA,EAClD,SAAS,EAAE,QAAQ,EAAE,QAAQ,IAAI;AAAA,EACjC,eAAe,EAAE,QAAQ,EAAE,QAAQ,IAAI;AAAA,EACvC,OAAO,EAAE,QAAQ,EAAE,QAAQ,IAAI;AACjC,CAAC;AAGD,IAAM,cAAc,kBAAkB,cAAc;AAQpD,SAAS,cAAc,KAA4B;AACjD,QAAM,SAAS,OAAO,OAAO,CAAC,CAAC;AAC/B,SAAO;AAAA,IACL,SAAS,OAAO;AAAA,IAChB,UAAU,OAAO;AAAA,IACjB,MAAM,OAAO;AAAA,IACb,SAAS,OAAO;AAAA,IAChB,eAAe,OAAO;AAAA,IACtB,OAAO,OAAO;AAAA,EAChB;AACF;AAMA,IAAM,gBAAgB;AAEtB,IAAM,eAAe;AAErB,IAAM,aAAa;AAEnB,IAAM,oBACJ;AAEF,IAAM,oBAAoB;AAE1B,IAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA+BtB,IAAM,SAAS;AA2Cf,SAAS,iBAAiB,OAA2B;AACnD,QAAM,SAAS,MAAM,SAAS;AAC9B,MAAI,CAAC,MAAM,QAAQ,MAAM,EAAG,QAAO;AACnC,MAAI;AACF,WAAO,aAAa,MAA4C;AAAA,EAClE,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAKA,IAAM,cAAN,cAA0B,QAAQ;AAAA,EAChC,OAAO,SAAS,CAAC,UAAU,cAAc;AAAA,EAEzC;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA,EAEA,YAAY,KAAc,YAAqB,CAAC,GAAG;AACjD,UAAM,KAAK,aAAa;AACxB,SAAK,SAAS,cAAc,SAAS;AACrC,SAAK,SAAS,MAAM,KAAK;AACzB,SAAK,UAAU;AAIf,SAAK,QAAQ,GAAG,iBAAiB,CAAC,EAAE,MAAM,MAAM;AAM9C,YAAM,UAAU,MAAM,IAAI;AAAA,QACxB;AAAA,QACA,OAAO,SAAS,SAAS;AACvB,gBAAM,WAAW,MAAM,KAAK;AAC5B,gBAAM,MAAM,KAAK,OAAO;AACxB,cAAI,CAAC,IAAI,QAAS,QAAO;AACzB,gBAAM,QAAQ,SAAS,OAAO,KAAK,iBAAiB,KAAK,CAAC;AAC1D,cAAI,UAAU,OAAW,QAAO;AAChC,gBAAM,UAAmC;AAAA,YACvC,GAAG;AAAA,YACH,UAAU,MAAM;AAAA,YAChB,OAAO,MAAM;AAAA,UACf;AACA,cAAI,MAAM,cAAc,OAAW,SAAQ,YAAY,MAAM;AAC7D,gBAAM,SAAS,UAAU,OAAO,MAAM,SAAS,MAAM;AACrD,cAAI,WAAW,OAAW,SAAQ,kBAAkB;AACpD,iBAAO;AAAA,QACT;AAAA,QACA,EAAE,SAAS,KAAK;AAAA,MAClB;AACA,WAAK,QAAQ,GAAG,kBAAkB,CAAC,aAAa;AAC9C,YAAI,aAAa,MAAO,SAAQ;AAAA,MAClC,CAAC;AAAA,IACH,CAAC;AAID,SAAK,OAAO,KAAK,MAAM;AACvB;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA,KAAK;AAAA,MACL;AAAA,QACE,WAAW,CAAC,YAAY;AACtB,eAAK,SAAS;AAAA,QAChB;AAAA,QACA,UAAU,MAAM,KAAK,OAAO,KAAK,OAAO,CAAC;AAAA,MAC3C;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,OAAO,KAAyB;AACtC,QAAI,KAAK,eAAe;AACtB,WAAK,cAAc;AACnB,WAAK,gBAAgB;AAAA,IACvB;AACA,QAAI,KAAK,cAAc;AACrB,WAAK,aAAa;AAClB,WAAK,eAAe;AAAA,IACtB;AACA,QAAI,CAAC,IAAI,QAAS;AAClB,QAAI,IAAI,eAAe;AACrB,WAAK,gBAAgB,KAAK,QAAQ,aAAa,QAAQ;AAAA,QACrD,MAAM;AAAA,QACN,OAAO;AAAA,QACP,MAAM,aAAa,WAAW,mBAAmB,IAAI,QAAQ,KAAK,EAAE;AAAA,UAClE;AAAA,UACA,IAAI,SAAS;AAAA,QACf;AAAA,MACF,CAAC;AAAA,IACH;AACA,QAAI,IAAI,OAAO;AACb,WAAK,eAAe,KAAK,QAAQ,OAAO,SAAS;AAAA,QAC/C,MAAM;AAAA,QACN,aAAa;AAAA,QACb,WAAW;AAAA,QACX,SAAS;AAAA,QACT,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}
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, 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 messages carry image\n // content is stamped with the vision model, regardless of role.\n // The harness's own model-selection listener has already run\n // (`await next()`), so this rewrite wins over the session model.\n if (\n cfg.vision.enabled &&\n hasImageContent((resolved as { messages?: unknown }).messages)\n ) {\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};\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 @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/* Whether any block (or nested tool-result content) is an image block. */\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 CHANGED Viewed

@@ -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.4.0",
+  "version": "0.6.0",
   "publishConfig": {
     "access": "public"
   },
@@ -13,6 +13,9 @@
       "types": "./lib/index.d.ts",
       "default": "./lib/index.js"
     },
+    "./client": {
+      "default": "./lib/client.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -24,10 +27,19 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
     }
   },
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && npm run build:client",
+    "build:client": "node scripts/build-client.mjs",
     "prepare": "npm run build",
     "typecheck": "tsc --noEmit",
     "test": "vitest run"
@@ -44,6 +56,8 @@
     "@deepseek-ai/dsh-plan-mode": "^0.1.0-rc.8",
     "@deepseek-ai/dsh-settings": "^0.1.0-rc.8",
     "@types/node": "^22.10.0",
+    "@types/react": "^18.3.12",
+    "react": "^18.3.1",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8"