@alexeiled/claude-router 1.8.0 → 1.8.1
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.
- package/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +7 -0
- package/docs/router-band.svg +60 -60
- package/docs/user-guide.md +2 -2
- package/lib/band.mjs +19 -7
- package/lib/display.mjs +13 -1
- package/package.json +1 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "router",
|
|
3
3
|
"displayName": "Router",
|
|
4
|
-
"version": "1.8.
|
|
4
|
+
"version": "1.8.1",
|
|
5
5
|
"description": "Model and effort routing for the main conversation by task difficulty and activity, advised by a prompt classifier (Jev, Clef, Clef Flash, OpenAI or local Ollama). Preserves subagent model choices.",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "Alexei Ledenev",
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.8.1 (2026-10-10)
|
|
4
|
+
|
|
5
|
+
### Changed
|
|
6
|
+
|
|
7
|
+
- The band names the activity with a verb in orange italic, `high coding → Opus 5.5 · xhigh`, so it no longer reads as part of the model. `ops` reads `running`, `docs` reads `documenting`, and the rest end in `-ing`. The reasons and the switch toast use the same words: `↗ coding`, `↘ running`. In `shadow` the label stays dim.
|
|
8
|
+
- A space now follows the tier chip, so its background no longer runs into the next word.
|
|
9
|
+
|
|
3
10
|
## 1.8.0 (2026-10-10)
|
|
4
11
|
|
|
5
12
|
### Changed
|
package/docs/router-band.svg
CHANGED
|
@@ -14,18 +14,18 @@
|
|
|
14
14
|
<text x="47.4" y="56" fill="#e0708a" xml:space="preserve">█</text>
|
|
15
15
|
<rect x="55.2" y="42" width="46.8" height="18" rx="4" fill="#e0708a"/>
|
|
16
16
|
<text x="55.2" y="56" fill="#0d1016" font-weight="700" xml:space="preserve"> high </text>
|
|
17
|
-
<text x="
|
|
18
|
-
<text x="
|
|
19
|
-
<text x="
|
|
20
|
-
<text x="
|
|
21
|
-
<text x="
|
|
22
|
-
<text x="
|
|
23
|
-
<text x="
|
|
24
|
-
<text x="
|
|
25
|
-
<text x="
|
|
26
|
-
<text x="
|
|
27
|
-
<text x="
|
|
28
|
-
<text x="
|
|
17
|
+
<text x="109.8" y="56" fill="#d77757" font-style="italic" xml:space="preserve">coding → </text>
|
|
18
|
+
<text x="180.0" y="56" fill="#d0d0d0" xml:space="preserve">Opus 5.5 · xhigh</text>
|
|
19
|
+
<text x="304.8" y="56" fill="#7c7c7c" xml:space="preserve"> · </text>
|
|
20
|
+
<text x="343.8" y="56" fill="#7c7c7c" xml:space="preserve">↑ jump</text>
|
|
21
|
+
<text x="390.6" y="56" fill="#7c7c7c" xml:space="preserve"> · </text>
|
|
22
|
+
<text x="429.6" y="56" fill="#7c7c7c" xml:space="preserve">Jev 88% ≥ 82%</text>
|
|
23
|
+
<text x="531.0" y="56" fill="#7c7c7c" xml:space="preserve"> · </text>
|
|
24
|
+
<text x="570.0" y="56" fill="#d0d0d0" xml:space="preserve">ctx </text>
|
|
25
|
+
<text x="601.2" y="56" fill="#87d787" xml:space="preserve">40%</text>
|
|
26
|
+
<text x="624.6" y="56" fill="#d0d0d0" xml:space="preserve"> · cache hit </text>
|
|
27
|
+
<text x="726.0" y="56" fill="#87d787" xml:space="preserve">100%</text>
|
|
28
|
+
<text x="772.8" y="56" fill="#d0d0d0" xml:space="preserve">Router</text>
|
|
29
29
|
<text class="cap" x="20" y="95">Two rows, with the hover row shown: the session against your model, pins, Turn off</text>
|
|
30
30
|
<rect x="12" y="103" width="897.6" height="67" rx="5" fill="#232323"/>
|
|
31
31
|
<text x="24.0" y="121" fill="#e0708a" xml:space="preserve">▂</text>
|
|
@@ -34,16 +34,16 @@
|
|
|
34
34
|
<text x="47.4" y="121" fill="#e0708a" xml:space="preserve">█</text>
|
|
35
35
|
<rect x="55.2" y="107" width="46.8" height="18" rx="4" fill="#e0708a"/>
|
|
36
36
|
<text x="55.2" y="121" fill="#0d1016" font-weight="700" xml:space="preserve"> high </text>
|
|
37
|
-
<text x="
|
|
38
|
-
<text x="
|
|
39
|
-
<text x="
|
|
40
|
-
<text x="
|
|
41
|
-
<text x="
|
|
42
|
-
<text x="
|
|
43
|
-
<text x="
|
|
44
|
-
<text x="
|
|
45
|
-
<text x="
|
|
46
|
-
<text x="
|
|
37
|
+
<text x="109.8" y="121" fill="#d77757" font-style="italic" xml:space="preserve">coding → </text>
|
|
38
|
+
<text x="180.0" y="121" fill="#d0d0d0" xml:space="preserve">Opus 5.5 · xhigh</text>
|
|
39
|
+
<text x="304.8" y="121" fill="#7c7c7c" xml:space="preserve"> · </text>
|
|
40
|
+
<text x="343.8" y="121" fill="#7c7c7c" xml:space="preserve">↑ jump</text>
|
|
41
|
+
<text x="390.6" y="121" fill="#7c7c7c" xml:space="preserve"> · </text>
|
|
42
|
+
<text x="429.6" y="121" fill="#d0d0d0" xml:space="preserve">ctx </text>
|
|
43
|
+
<text x="460.8" y="121" fill="#87d787" xml:space="preserve">40%</text>
|
|
44
|
+
<text x="484.2" y="121" fill="#d0d0d0" xml:space="preserve"> · cache hit </text>
|
|
45
|
+
<text x="585.6" y="121" fill="#87d787" xml:space="preserve">100%</text>
|
|
46
|
+
<text x="632.4" y="121" fill="#d0d0d0" xml:space="preserve">Router</text>
|
|
47
47
|
<text x="24.0" y="140" fill="#7c7c7c" xml:space="preserve">session </text>
|
|
48
48
|
<text x="94.2" y="140" fill="#6fcf97" font-weight="700" xml:space="preserve">saved $1.84 (22%)</text>
|
|
49
49
|
<text x="226.8" y="140" fill="#d0d0d0" xml:space="preserve"> vs Opus 5.5 · xhigh</text>
|
|
@@ -73,20 +73,20 @@
|
|
|
73
73
|
<text x="47.4" y="224" fill="#7c7c7c" xml:space="preserve">█</text>
|
|
74
74
|
<rect x="55.2" y="210" width="39.0" height="18" rx="4" fill="#5f9fe0"/>
|
|
75
75
|
<text x="55.2" y="224" fill="#0d1016" font-weight="700" xml:space="preserve"> low </text>
|
|
76
|
-
<text x="
|
|
77
|
-
<text x="
|
|
78
|
-
<text x="
|
|
79
|
-
<text x="
|
|
80
|
-
<text x="
|
|
81
|
-
<text x="
|
|
82
|
-
<text x="
|
|
83
|
-
<text x="
|
|
84
|
-
<text x="
|
|
85
|
-
<text x="
|
|
86
|
-
<text x="
|
|
87
|
-
<text x="
|
|
88
|
-
<text x="
|
|
89
|
-
<text x="
|
|
76
|
+
<text x="102.0" y="224" fill="#d77757" font-style="italic" xml:space="preserve">running → </text>
|
|
77
|
+
<text x="180.0" y="224" fill="#d0d0d0" xml:space="preserve">Haiku 5.5 · high</text>
|
|
78
|
+
<text x="304.8" y="224" fill="#7c7c7c" xml:space="preserve"> · </text>
|
|
79
|
+
<text x="343.8" y="224" fill="#7c9cff" xml:space="preserve">⏵ next turn: </text>
|
|
80
|
+
<text x="445.2" y="224" fill="#d7af5f" font-weight="700" xml:space="preserve">medium</text>
|
|
81
|
+
<text x="499.8" y="224" fill="#d0d0d0" xml:space="preserve">✕</text>
|
|
82
|
+
<text x="507.6" y="224" fill="#7c7c7c" xml:space="preserve"> · </text>
|
|
83
|
+
<text x="546.6" y="224" fill="#7c7c7c" xml:space="preserve">= fits</text>
|
|
84
|
+
<text x="593.4" y="224" fill="#7c7c7c" xml:space="preserve"> · </text>
|
|
85
|
+
<text x="632.4" y="224" fill="#d0d0d0" xml:space="preserve">ctx </text>
|
|
86
|
+
<text x="663.6" y="224" fill="#87d787" xml:space="preserve">40%</text>
|
|
87
|
+
<text x="687.0" y="224" fill="#d0d0d0" xml:space="preserve"> · cache hit </text>
|
|
88
|
+
<text x="788.4" y="224" fill="#87d787" xml:space="preserve">100%</text>
|
|
89
|
+
<text x="835.2" y="224" fill="#d0d0d0" xml:space="preserve">Router</text>
|
|
90
90
|
<text class="cap" x="20" y="263">No classifier key: routing keeps the model and offers Set up</text>
|
|
91
91
|
<rect x="12" y="271" width="897.6" height="29" rx="5" fill="#232323"/>
|
|
92
92
|
<text x="24.0" y="289" fill="#f0b429" xml:space="preserve">⚠ Jev: no API key</text>
|
|
@@ -100,10 +100,10 @@
|
|
|
100
100
|
<text x="336.0" y="289" fill="#7c7c7c" xml:space="preserve">█</text>
|
|
101
101
|
<rect x="343.8" y="275" width="39.0" height="18" rx="4" fill="#5f9fe0"/>
|
|
102
102
|
<text x="343.8" y="289" fill="#0d1016" font-weight="700" xml:space="preserve"> low </text>
|
|
103
|
-
<text x="
|
|
104
|
-
<text x="
|
|
105
|
-
<text x="
|
|
106
|
-
<text x="
|
|
103
|
+
<text x="390.6" y="289" fill="#d0d0d0" xml:space="preserve">Haiku 5.5 · high</text>
|
|
104
|
+
<text x="515.4" y="289" fill="#7c7c7c" xml:space="preserve"> · </text>
|
|
105
|
+
<text x="554.4" y="289" fill="#f0b429" xml:space="preserve">keeping model</text>
|
|
106
|
+
<text x="671.4" y="289" fill="#d0d0d0" xml:space="preserve">Router</text>
|
|
107
107
|
<text class="cap" x="20" y="328">Routing off: /model chose the model; Turn on resumes routing</text>
|
|
108
108
|
<rect x="12" y="336" width="897.6" height="29" rx="5" fill="#232323"/>
|
|
109
109
|
<text x="24.0" y="354" fill="#7c7c7c" xml:space="preserve">○ </text>
|
|
@@ -125,16 +125,16 @@
|
|
|
125
125
|
<text x="47.4" y="419" fill="#7c7c7c" xml:space="preserve">█</text>
|
|
126
126
|
<rect x="55.2" y="405" width="62.4" height="18" rx="4" fill="#d7af5f"/>
|
|
127
127
|
<text x="55.2" y="419" fill="#0d1016" font-weight="700" xml:space="preserve"> medium </text>
|
|
128
|
-
<text x="
|
|
129
|
-
<text x="
|
|
130
|
-
<text x="
|
|
131
|
-
<text x="
|
|
132
|
-
<text x="
|
|
133
|
-
<text x="
|
|
134
|
-
<text x="
|
|
135
|
-
<text x="
|
|
136
|
-
<text x="
|
|
137
|
-
<text x="
|
|
128
|
+
<text x="125.4" y="419" fill="#d77757" font-style="italic" xml:space="preserve">running → </text>
|
|
129
|
+
<text x="203.4" y="419" fill="#d0d0d0" xml:space="preserve">Haiku 5.5 · high</text>
|
|
130
|
+
<text x="328.2" y="419" fill="#7c7c7c" xml:space="preserve"> · </text>
|
|
131
|
+
<text x="367.2" y="419" fill="#7c7c7c" xml:space="preserve">↘ running</text>
|
|
132
|
+
<text x="437.4" y="419" fill="#7c7c7c" xml:space="preserve"> · </text>
|
|
133
|
+
<text x="476.4" y="419" fill="#d0d0d0" xml:space="preserve">ctx </text>
|
|
134
|
+
<text x="507.6" y="419" fill="#87d787" xml:space="preserve">40%</text>
|
|
135
|
+
<text x="531.0" y="419" fill="#d0d0d0" xml:space="preserve"> · cache hit </text>
|
|
136
|
+
<text x="632.4" y="419" fill="#87d787" xml:space="preserve">100%</text>
|
|
137
|
+
<text x="679.2" y="419" fill="#d0d0d0" xml:space="preserve">Router</text>
|
|
138
138
|
<text class="cap" x="20" y="458">Activity routing in shadow: the label is shown, the base route still runs</text>
|
|
139
139
|
<rect x="12" y="466" width="897.6" height="29" rx="5" fill="#232323"/>
|
|
140
140
|
<text x="24.0" y="484" fill="#5f9fe0" xml:space="preserve">▂</text>
|
|
@@ -143,14 +143,14 @@
|
|
|
143
143
|
<text x="47.4" y="484" fill="#7c7c7c" xml:space="preserve">█</text>
|
|
144
144
|
<rect x="55.2" y="470" width="39.0" height="18" rx="4" fill="#5f9fe0"/>
|
|
145
145
|
<text x="55.2" y="484" fill="#0d1016" font-weight="700" xml:space="preserve"> low </text>
|
|
146
|
-
<text x="
|
|
147
|
-
<text x="
|
|
148
|
-
<text x="
|
|
149
|
-
<text x="
|
|
150
|
-
<text x="
|
|
151
|
-
<text x="
|
|
152
|
-
<text x="
|
|
153
|
-
<text x="
|
|
154
|
-
<text x="
|
|
155
|
-
<text x="
|
|
146
|
+
<text x="102.0" y="484" fill="#7c7c7c" xml:space="preserve">coding (shadow) → </text>
|
|
147
|
+
<text x="242.4" y="484" fill="#d0d0d0" xml:space="preserve">Haiku 5.5 · high</text>
|
|
148
|
+
<text x="367.2" y="484" fill="#7c7c7c" xml:space="preserve"> · </text>
|
|
149
|
+
<text x="406.2" y="484" fill="#7c7c7c" xml:space="preserve">= fits</text>
|
|
150
|
+
<text x="453.0" y="484" fill="#7c7c7c" xml:space="preserve"> · </text>
|
|
151
|
+
<text x="492.0" y="484" fill="#d0d0d0" xml:space="preserve">ctx </text>
|
|
152
|
+
<text x="523.2" y="484" fill="#87d787" xml:space="preserve">40%</text>
|
|
153
|
+
<text x="546.6" y="484" fill="#d0d0d0" xml:space="preserve"> · cache hit </text>
|
|
154
|
+
<text x="648.0" y="484" fill="#87d787" xml:space="preserve">100%</text>
|
|
155
|
+
<text x="694.8" y="484" fill="#d0d0d0" xml:space="preserve">Router</text>
|
|
156
156
|
</svg>
|
package/docs/user-guide.md
CHANGED
|
@@ -37,8 +37,8 @@ Router draws one line above the prompt. The line ends with a **Router** button t
|
|
|
37
37
|
Read the first line of the picture from left to right:
|
|
38
38
|
|
|
39
39
|
- **Tier meter** `▂▄▆█`: one bar per tier, lit up to the current tier in its color, like signal strength.
|
|
40
|
-
- **Tier, activity, and model**: the route for this turn. The activity, such as `
|
|
41
|
-
- **Reason**: one or two words with a direction, such as `↑ jump`, `↓ downgrade`, `= fits`, or `… waiting to go down`. An activity move reads `↗
|
|
40
|
+
- **Tier, activity, and model**: the route for this turn. The activity sits between the tier and the model as a verb in orange italic, such as `coding →`: `coding`, `debugging`, `exploring`, `planning`, `reviewing`, `running` (commands: git, builds, tests, CI) or `documenting`. See [Route by activity](#route-by-activity). **fallback** means Claude Code answered with another model.
|
|
41
|
+
- **Reason**: one or two words with a direction, such as `↑ jump`, `↓ downgrade`, `= fits`, or `… waiting to go down`. An activity move reads `↗ coding` or `↘ running`, and a refused one `… running: not worth a switch`.
|
|
42
42
|
- **Classifier support**: what the active classifier, such as Jev or Clef Flash, gave the switch against the bar the policy required, such as `Jev 88% ≥ 82%`. When whole percents would read as equal, it shows tenths: `Jev 81.0% < 81.4%`.
|
|
43
43
|
- **Switch cost**: `switch cost ≈ $0.37`, the policy's price for the switch it weighed this turn, mostly the prompt cache the other model must write. For a move to a cheaper model it is net of what that model saves over the next turns. The higher the cost, the higher the bar a stronger model must clear.
|
|
44
44
|
- **ctx** and **cache hit**: context use and the share of input read from the cache on the last reply. They turn yellow at 60% context and red at 80%.
|
package/lib/band.mjs
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { activeClassifier, TIERS } from './config.mjs';
|
|
2
2
|
import {
|
|
3
|
+
activityVerb,
|
|
3
4
|
classifierLabel,
|
|
4
5
|
classifierStatus,
|
|
5
6
|
classifierWarns,
|
|
@@ -28,7 +29,15 @@ const GAP = ' ';
|
|
|
28
29
|
const ROUTER_BUTTON = 8;
|
|
29
30
|
|
|
30
31
|
// Hex, like TIER_COLOR, so every surface draws the same shades. Yellow stays out: it marks a fault that needs action.
|
|
31
|
-
|
|
32
|
+
// Activity is Claude Code's orange for a turn's action; italic sets it apart from the high and medium tier colors.
|
|
33
|
+
const COLOR = {
|
|
34
|
+
accent: '#7c9cff',
|
|
35
|
+
off: '#2a3040',
|
|
36
|
+
muted: '#8b93a7',
|
|
37
|
+
warn: '#f0b429',
|
|
38
|
+
ink: '#0d1016',
|
|
39
|
+
activity: '#d77757',
|
|
40
|
+
};
|
|
32
41
|
|
|
33
42
|
const part = (text, style = {}) => ({ text, style });
|
|
34
43
|
// A filled chip: the text on a background, as the prototype's status pills.
|
|
@@ -82,12 +91,14 @@ const pendingMeter = () => [...BARS].map((bar) => part(bar, { color: COLOR.accen
|
|
|
82
91
|
|
|
83
92
|
const route = (view) => routeLabel(view.actualModel ?? view.selectedModel ?? view.nativeModel, view.effort);
|
|
84
93
|
|
|
85
|
-
// The turn's activity between the tier and the route,
|
|
86
|
-
//
|
|
94
|
+
// The turn's activity between the tier and the route, as a verb in orange italic; dim and marked in shadow, where the
|
|
95
|
+
// route shown is still the one in use. One part with its arrow, so a narrow band drops both before the reason.
|
|
87
96
|
function activityPart(config, view) {
|
|
88
97
|
if (!view.activity || config.activityRouting === 'off') return null;
|
|
89
|
-
const
|
|
90
|
-
return
|
|
98
|
+
const verb = activityVerb(view.activity);
|
|
99
|
+
return config.activityRouting === 'shadow'
|
|
100
|
+
? { ...part(`${verb} (shadow) → `, { dimColor: true }), priority: 2 }
|
|
101
|
+
: { ...part(`${verb} → `, { color: COLOR.activity, italic: true }), priority: 2 };
|
|
91
102
|
}
|
|
92
103
|
|
|
93
104
|
function served(view) {
|
|
@@ -155,7 +166,8 @@ export function bandSegments(config, view, usage, actions) {
|
|
|
155
166
|
return [segment(0, meter(null, true), part(' Routing on · ready', { dimColor: true })), pin].filter(Boolean);
|
|
156
167
|
const main = segment(
|
|
157
168
|
0,
|
|
158
|
-
|
|
169
|
+
// The space after the pill keeps its background off the next word.
|
|
170
|
+
view.tier ? [...meter(view.tier), pill(view.tier, TIER_COLOR[view.tier]), part(' ')] : part('○ '),
|
|
159
171
|
activityPart(config, view),
|
|
160
172
|
part(route(view)),
|
|
161
173
|
served(view) ? part(' fallback', { color: 'yellow' }) : null,
|
|
@@ -283,7 +295,7 @@ export function renderBand({ Box, Text, Button }, config, view, usage, { columns
|
|
|
283
295
|
export function switchToast(config, previous, next, estimate) {
|
|
284
296
|
const label = (decision) => routeLabel(decision.model, decision.effort);
|
|
285
297
|
const support = supportText(config, estimate);
|
|
286
|
-
// An activity move names the activity: "Model changed: Sonnet 5.5 · medium → Haiku 5.5 · high ·
|
|
298
|
+
// An activity move names the activity: "Model changed: Sonnet 5.5 · medium → Haiku 5.5 · high · running".
|
|
287
299
|
const why = shortReason(next.reason, next.activity).replace(/^\W+\s*/, '');
|
|
288
300
|
return `Model changed: ${label(previous)} → ${label(next)} · ${why}${support ? ` (${support})` : ''}`;
|
|
289
301
|
}
|
package/lib/display.mjs
CHANGED
|
@@ -167,9 +167,21 @@ export const SHORT_REASONS = {
|
|
|
167
167
|
'activity-pending': '… {activity}: not worth a switch',
|
|
168
168
|
};
|
|
169
169
|
|
|
170
|
+
// What the band calls each activity: the verb for the work, as Claude Code names a turn's action.
|
|
171
|
+
const ACTIVITY_VERB = {
|
|
172
|
+
code: 'coding',
|
|
173
|
+
debug: 'debugging',
|
|
174
|
+
explore: 'exploring',
|
|
175
|
+
plan: 'planning',
|
|
176
|
+
review: 'reviewing',
|
|
177
|
+
ops: 'running',
|
|
178
|
+
docs: 'documenting',
|
|
179
|
+
};
|
|
180
|
+
export const activityVerb = (activity) => ACTIVITY_VERB[activity] ?? activity;
|
|
181
|
+
|
|
170
182
|
// The band's words for `reason`; an activity move names the activity it is about, `base` for the tier's own route.
|
|
171
183
|
export const shortReason = (reason, activity) =>
|
|
172
|
-
(SHORT_REASONS[reason] ?? reason ?? '').replace('{activity}', activity
|
|
184
|
+
(SHORT_REASONS[reason] ?? reason ?? '').replace('{activity}', activity ? activityVerb(activity) : 'base');
|
|
173
185
|
|
|
174
186
|
// The activity a reason is about: the applied one for a move, and for a refused move the classifier's activity when
|
|
175
187
|
// it carries enough mass to apply, else null (the tier's base route).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@alexeiled/claude-router",
|
|
3
|
-
"version": "1.8.
|
|
3
|
+
"version": "1.8.1",
|
|
4
4
|
"description": "Native Claude Code Mod: model and effort routing for the main conversation, advised by Jev, Clef, Clef Flash, OpenAI or Ollama.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Alexei Ledenev",
|