@alexeiled/claude-router 1.24.0 → 1.25.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.
Files changed (79) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/CHANGELOG.md +74 -0
  3. package/README.md +55 -7
  4. package/docs/architecture.md +30 -4
  5. package/docs/configuration.md +23 -14
  6. package/docs/evaluation.md +3 -3
  7. package/docs/native-router.md +12 -4
  8. package/docs/router-band.svg +140 -142
  9. package/docs/router-pane-classifier.svg +48 -31
  10. package/docs/router-pane-now.svg +162 -120
  11. package/docs/router-pane-policy.svg +79 -47
  12. package/docs/router-pane-routes.svg +8 -8
  13. package/docs/router-pane-usage-whatif.svg +14 -14
  14. package/docs/router-pane-usage.svg +20 -20
  15. package/docs/routing-modes.md +10 -8
  16. package/docs/user-guide.md +151 -22
  17. package/hooks/native-router.mjs +415 -88
  18. package/lib/activity-stats.mjs +23 -4
  19. package/lib/activity.mjs +7 -5
  20. package/lib/auto-engine.mjs +13 -6
  21. package/lib/auto-route.mjs +10 -4
  22. package/lib/band.mjs +35 -440
  23. package/lib/classifier-client.mjs +12 -8
  24. package/lib/config-file.mjs +7 -2
  25. package/lib/config.mjs +24 -9
  26. package/lib/cost.mjs +5 -1
  27. package/lib/costs.mjs +4 -2
  28. package/lib/decisions.mjs +13 -9
  29. package/lib/display.mjs +71 -20
  30. package/lib/facts.mjs +3 -0
  31. package/lib/failover.mjs +55 -0
  32. package/lib/modes.mjs +8 -4
  33. package/lib/panel.mjs +75 -2167
  34. package/lib/policy.mjs +7 -6
  35. package/lib/replay-trace.mjs +5 -2
  36. package/lib/replay.mjs +7 -1
  37. package/lib/route-line.mjs +46 -0
  38. package/lib/route.mjs +51 -32
  39. package/lib/savings.mjs +14 -3
  40. package/lib/subagents.mjs +41 -11
  41. package/lib/subcommands.mjs +60 -0
  42. package/lib/ui/fallback.mjs +22 -0
  43. package/lib/ui/graphical/band.mjs +256 -0
  44. package/lib/ui/graphical/charts.mjs +163 -0
  45. package/lib/ui/graphical/classifier.mjs +153 -0
  46. package/lib/ui/graphical/frame.mjs +231 -0
  47. package/lib/ui/graphical/kit.mjs +156 -0
  48. package/lib/ui/graphical/meter.mjs +25 -0
  49. package/lib/ui/graphical/now.mjs +357 -0
  50. package/lib/ui/graphical/policy.mjs +56 -0
  51. package/lib/ui/graphical/routes.mjs +264 -0
  52. package/lib/ui/graphical/squares.mjs +29 -0
  53. package/lib/ui/graphical/usage.mjs +376 -0
  54. package/lib/ui/model/band.mjs +441 -0
  55. package/lib/ui/model/classifier.mjs +308 -0
  56. package/lib/ui/model/draft.mjs +62 -0
  57. package/lib/ui/model/format.mjs +41 -0
  58. package/lib/ui/model/frame.mjs +359 -0
  59. package/lib/ui/model/now.mjs +421 -0
  60. package/lib/ui/model/policy.mjs +194 -0
  61. package/lib/ui/model/routes.mjs +392 -0
  62. package/lib/ui/model/usage-agents.mjs +311 -0
  63. package/lib/ui/model/usage-breakdown.mjs +237 -0
  64. package/lib/ui/model/usage-shared.mjs +58 -0
  65. package/lib/ui/model/usage.mjs +330 -0
  66. package/lib/ui/terminal/band.mjs +253 -0
  67. package/lib/ui/terminal/classifier.mjs +150 -0
  68. package/lib/ui/terminal/frame.mjs +169 -0
  69. package/lib/ui/terminal/kit.mjs +162 -0
  70. package/lib/ui/terminal/now.mjs +293 -0
  71. package/lib/ui/terminal/policy.mjs +55 -0
  72. package/lib/ui/terminal/routes.mjs +167 -0
  73. package/lib/ui/terminal/usage.mjs +363 -0
  74. package/lib/ui/terminal/wrap.mjs +37 -0
  75. package/lib/ui/tokens.mjs +106 -0
  76. package/lib/usage.mjs +5 -5
  77. package/lib/view.mjs +5 -2
  78. package/package.json +4 -2
  79. package/types/index.d.ts +17 -0
@@ -40,28 +40,28 @@
40
40
  <text x="453.0" y="91" fill="#7c7c7c" xml:space="preserve"> p next</text>
41
41
  <text x="24.0" y="110" fill="#7c7c7c" xml:space="preserve">this session · your model </text>
42
42
  <text x="226.8" y="110" fill="#e0708a" font-weight="700" xml:space="preserve">Opus 5.5 · xhigh</text>
43
- <text x="24.0" y="148" fill="#6fcf97" font-weight="700" xml:space="preserve">−$4.09 (−31%)</text>
43
+ <text x="24.0" y="148" fill="#87d787" font-weight="700" xml:space="preserve">−$4.09 (−31%)</text>
44
44
  <text x="125.4" y="148" fill="#d0d0d0" xml:space="preserve"> vs unrouted</text>
45
45
  <text x="226.8" y="186" fill="#7c7c7c" xml:space="preserve"> cost</text>
46
46
  <text x="289.2" y="186" fill="#7c7c7c" xml:space="preserve"> vs unrouted</text>
47
47
  <text x="406.2" y="186" fill="#7c7c7c" xml:space="preserve"> unrouted</text>
48
48
  <text x="24.0" y="205" fill="#d0d0d0" xml:space="preserve">main · 86 replies</text>
49
49
  <text x="226.8" y="205" fill="#d0d0d0" xml:space="preserve"> ≈$6.45</text>
50
- <text x="289.2" y="205" fill="#6fcf97" xml:space="preserve"> −$4.17</text>
50
+ <text x="289.2" y="205" fill="#87d787" xml:space="preserve"> −$4.17</text>
51
51
  <text x="406.2" y="205" fill="#7c7c7c" xml:space="preserve"> ≈$10.62</text>
52
52
  <text x="24.0" y="224" fill="#7c7c7c" xml:space="preserve"> cheaper models</text>
53
- <text x="289.2" y="224" fill="#6fcf97" xml:space="preserve"> −$4.36</text>
53
+ <text x="289.2" y="224" fill="#87d787" xml:space="preserve"> −$4.36</text>
54
54
  <text x="24.0" y="243" fill="#7c7c7c" xml:space="preserve"> cache rebuilds</text>
55
- <text x="289.2" y="243" fill="#f0b429" xml:space="preserve"> +$0.19</text>
55
+ <text x="289.2" y="243" fill="#d7af5f" xml:space="preserve"> +$0.19</text>
56
56
  <text x="406.2" y="243" fill="#7c7c7c" xml:space="preserve"> 4% of the saving</text>
57
57
  <text x="24.0" y="262" fill="#d0d0d0" xml:space="preserve">agents · 6</text>
58
58
  <text x="226.8" y="262" fill="#d0d0d0" xml:space="preserve"> ≈$2.52</text>
59
- <text x="289.2" y="262" fill="#f0b429" xml:space="preserve"> +$0.08</text>
59
+ <text x="289.2" y="262" fill="#d7af5f" xml:space="preserve"> +$0.08</text>
60
60
  <text x="406.2" y="262" fill="#7c7c7c" xml:space="preserve"> ≈$2.44</text>
61
61
  <text x="24.0" y="281" fill="#7c7c7c" xml:space="preserve">─────────────────────────────────────────────────────────────</text>
62
62
  <text x="24.0" y="300" fill="#d0d0d0" font-weight="700" xml:space="preserve">session · API estimate</text>
63
63
  <text x="226.8" y="300" fill="#d0d0d0" font-weight="700" xml:space="preserve"> ≈$8.97</text>
64
- <text x="289.2" y="300" fill="#6fcf97" font-weight="700" xml:space="preserve"> −$4.09</text>
64
+ <text x="289.2" y="300" fill="#87d787" font-weight="700" xml:space="preserve"> −$4.09</text>
65
65
  <text x="406.2" y="300" fill="#7c7c7c" xml:space="preserve"> ≈$13.06</text>
66
66
  <text x="24.0" y="338" fill="#7c7c7c" xml:space="preserve"> 86 replies · 86 turns · input 5.93M · cache hit 90% · output 77.4K</text>
67
67
  <text x="24.0" y="376" fill="#5fafd7" font-weight="700" xml:space="preserve">BY </text>
@@ -76,12 +76,12 @@
76
76
  <text x="39.6" y="414" fill="#d0d0d0" xml:space="preserve">▸</text>
77
77
  <text x="55.2" y="414" fill="#5f9fe0" xml:space="preserve">▂▄</text>
78
78
  <text x="211.2" y="414" fill="#d0d0d0" xml:space="preserve"> 41 ≈$1.20</text>
79
- <text x="351.6" y="414" fill="#6fcf97" xml:space="preserve"> −$3.57</text>
79
+ <text x="351.6" y="414" fill="#87d787" xml:space="preserve"> −$3.57</text>
80
80
  <text x="468.6" y="414" fill="#7c7c7c" xml:space="preserve"> Haiku 5.5 · high</text>
81
81
  <text x="39.6" y="433" fill="#d0d0d0" xml:space="preserve">▸</text>
82
82
  <text x="55.2" y="433" fill="#d7af5f" xml:space="preserve">▂▄▆</text>
83
83
  <text x="211.2" y="433" fill="#d0d0d0" xml:space="preserve"> 12 ≈$0.96</text>
84
- <text x="351.6" y="433" fill="#6fcf97" xml:space="preserve"> −$0.60</text>
84
+ <text x="351.6" y="433" fill="#87d787" xml:space="preserve"> −$0.60</text>
85
85
  <text x="468.6" y="433" fill="#7c7c7c" xml:space="preserve"> Sonnet 5.5 · high</text>
86
86
  <text x="39.6" y="452" fill="#d0d0d0" xml:space="preserve">▸</text>
87
87
  <text x="55.2" y="452" fill="#e0708a" xml:space="preserve">▂▄▆█</text>
@@ -95,11 +95,11 @@
95
95
  <text x="39.6" y="509" fill="#d0d0d0" xml:space="preserve">Haiku 5.5</text>
96
96
  <text x="211.2" y="509" fill="#7c7c7c" xml:space="preserve">████</text>
97
97
  <text x="382.8" y="509" fill="#d0d0d0" xml:space="preserve"> ≈$2.12</text>
98
- <text x="453.0" y="509" fill="#6fcf97" xml:space="preserve"> −$8.50</text>
98
+ <text x="453.0" y="509" fill="#87d787" xml:space="preserve"> −$8.50</text>
99
99
  <text x="39.6" y="528" fill="#d0d0d0" xml:space="preserve">Sonnet 5.5</text>
100
100
  <text x="211.2" y="528" fill="#7c7c7c" xml:space="preserve">█████████████</text>
101
101
  <text x="382.8" y="528" fill="#d0d0d0" xml:space="preserve"> ≈$6.37</text>
102
- <text x="453.0" y="528" fill="#6fcf97" xml:space="preserve"> −$4.25</text>
102
+ <text x="453.0" y="528" fill="#87d787" xml:space="preserve"> −$4.25</text>
103
103
  <text x="39.6" y="547" fill="#d0d0d0" font-weight="700" xml:space="preserve">Routed</text>
104
104
  <text x="211.2" y="547" fill="#5fafd7" xml:space="preserve">█████████████</text>
105
105
  <text x="382.8" y="547" fill="#d0d0d0" xml:space="preserve"> ≈$6.45</text>
@@ -110,7 +110,7 @@
110
110
  <text x="24.0" y="585" fill="#7c7c7c" xml:space="preserve"> same tokens and output on each model alone · answer quality not measured</text>
111
111
  <text x="24.0" y="623" fill="#5fafd7" font-weight="700" xml:space="preserve">WORTH A LOOK</text>
112
112
  <text x="117.6" y="623" fill="#7c7c7c" xml:space="preserve"> · from the numbers; answer quality is not measured</text>
113
- <text x="39.6" y="642" fill="#d7875f" font-style="italic" xml:space="preserve">code</text>
113
+ <text x="39.6" y="642" fill="#d77757" font-style="italic" xml:space="preserve">code</text>
114
114
  <text x="70.8" y="642" fill="#7c7c7c" xml:space="preserve"> · </text>
115
115
  <text x="94.2" y="642" fill="#e0708a" xml:space="preserve">▂▄▆█</text>
116
116
  <text x="125.4" y="642" fill="#d0d0d0" xml:space="preserve"> carried 67% of the cost</text>
@@ -130,7 +130,7 @@
130
130
  <text x="125.4" y="718" fill="#d0d0d0" xml:space="preserve">■ 3 moved by the router</text>
131
131
  <text x="304.8" y="718" fill="#7c7c7c" xml:space="preserve"> · </text>
132
132
  <text x="328.2" y="718" fill="#d0d0d0" xml:space="preserve">□ 3 on Claude Code’s pick</text>
133
- <text x="39.6" y="737" fill="#f0b429" font-weight="700" xml:space="preserve">routing +$0.08 (+7%)</text>
133
+ <text x="39.6" y="737" fill="#d7af5f" font-weight="700" xml:space="preserve">routing +$0.08 (+7%)</text>
134
134
  <text x="195.6" y="737" fill="#d0d0d0" xml:space="preserve"> vs Claude Code’s picks</text>
135
135
  <text x="375.0" y="737" fill="#7c7c7c" xml:space="preserve"> on 3 routed agents</text>
136
136
  <text x="24.0" y="775" fill="#d0d0d0" font-weight="700" xml:space="preserve"> ROUTED</text>
@@ -141,13 +141,13 @@
141
141
  <text x="203.4" y="813" fill="#c3e88d" xml:space="preserve">■■</text>
142
142
  <text x="297.0" y="813" fill="#d0d0d0" xml:space="preserve"> 2</text>
143
143
  <text x="320.4" y="813" fill="#d0d0d0" xml:space="preserve"> ≈$0.08</text>
144
- <text x="390.6" y="813" fill="#6fcf97" xml:space="preserve"> −$0.33 ▼</text>
144
+ <text x="390.6" y="813" fill="#87d787" xml:space="preserve"> −$0.33 ▼</text>
145
145
  <text x="39.6" y="832" fill="#d0d0d0" xml:space="preserve">▸</text>
146
146
  <text x="55.2" y="832" fill="#d0d0d0" xml:space="preserve">dev-flow:reviewer</text>
147
147
  <text x="203.4" y="832" fill="#c792ea" xml:space="preserve">■</text>
148
148
  <text x="297.0" y="832" fill="#d0d0d0" xml:space="preserve"> 1</text>
149
149
  <text x="320.4" y="832" fill="#d0d0d0" xml:space="preserve"> ≈$1.12</text>
150
- <text x="390.6" y="832" fill="#f0b429" xml:space="preserve"> +$0.41 ▲</text>
150
+ <text x="390.6" y="832" fill="#d7af5f" xml:space="preserve"> +$0.41 ▲</text>
151
151
  <text x="24.0" y="870" fill="#d0d0d0" font-weight="700" xml:space="preserve"> NOT ROUTED</text>
152
152
  <text x="117.6" y="870" fill="#7c7c7c" xml:space="preserve"> · Claude Code picked the model</text>
153
153
  <text x="39.6" y="889" fill="#d0d0d0" xml:space="preserve">▸</text>
@@ -39,28 +39,28 @@
39
39
  <text x="390.6" y="91" fill="#d0d0d0" xml:space="preserve">[ All ]</text>
40
40
  <text x="453.0" y="91" fill="#7c7c7c" xml:space="preserve"> p next</text>
41
41
  <text x="24.0" y="110" fill="#7c7c7c" xml:space="preserve">all projects · Oct 7 – Oct 13 · each session vs its own model</text>
42
- <text x="24.0" y="148" fill="#6fcf97" font-weight="700" xml:space="preserve">−$12.29 (−37%)</text>
42
+ <text x="24.0" y="148" fill="#87d787" font-weight="700" xml:space="preserve">−$12.29 (−37%)</text>
43
43
  <text x="133.2" y="148" fill="#d0d0d0" xml:space="preserve"> vs unrouted</text>
44
44
  <text x="226.8" y="186" fill="#7c7c7c" xml:space="preserve"> cost</text>
45
45
  <text x="289.2" y="186" fill="#7c7c7c" xml:space="preserve"> vs unrouted</text>
46
46
  <text x="406.2" y="186" fill="#7c7c7c" xml:space="preserve"> unrouted</text>
47
47
  <text x="24.0" y="205" fill="#d0d0d0" xml:space="preserve">main · 221 replies</text>
48
48
  <text x="226.8" y="205" fill="#d0d0d0" xml:space="preserve"> ≈$15.33</text>
49
- <text x="289.2" y="205" fill="#6fcf97" xml:space="preserve"> −$11.78</text>
49
+ <text x="289.2" y="205" fill="#87d787" xml:space="preserve"> −$11.78</text>
50
50
  <text x="406.2" y="205" fill="#7c7c7c" xml:space="preserve"> ≈$27.11</text>
51
51
  <text x="24.0" y="224" fill="#7c7c7c" xml:space="preserve"> cheaper models</text>
52
- <text x="289.2" y="224" fill="#6fcf97" xml:space="preserve"> −$12.29</text>
52
+ <text x="289.2" y="224" fill="#87d787" xml:space="preserve"> −$12.29</text>
53
53
  <text x="24.0" y="243" fill="#7c7c7c" xml:space="preserve"> cache rebuilds</text>
54
- <text x="289.2" y="243" fill="#f0b429" xml:space="preserve"> +$0.51</text>
54
+ <text x="289.2" y="243" fill="#d7af5f" xml:space="preserve"> +$0.51</text>
55
55
  <text x="406.2" y="243" fill="#7c7c7c" xml:space="preserve"> 4% of the saving</text>
56
56
  <text x="24.0" y="262" fill="#d0d0d0" xml:space="preserve">agents · 15</text>
57
57
  <text x="226.8" y="262" fill="#d0d0d0" xml:space="preserve"> ≈$5.60</text>
58
- <text x="289.2" y="262" fill="#6fcf97" xml:space="preserve"> −$0.51</text>
58
+ <text x="289.2" y="262" fill="#87d787" xml:space="preserve"> −$0.51</text>
59
59
  <text x="406.2" y="262" fill="#7c7c7c" xml:space="preserve"> ≈$6.11</text>
60
60
  <text x="24.0" y="281" fill="#7c7c7c" xml:space="preserve">─────────────────────────────────────────────────────────────</text>
61
61
  <text x="24.0" y="300" fill="#d0d0d0" font-weight="700" xml:space="preserve">7 days · API estimate</text>
62
62
  <text x="226.8" y="300" fill="#d0d0d0" font-weight="700" xml:space="preserve"> ≈$20.93</text>
63
- <text x="289.2" y="300" fill="#6fcf97" font-weight="700" xml:space="preserve"> −$12.29</text>
63
+ <text x="289.2" y="300" fill="#87d787" font-weight="700" xml:space="preserve"> −$12.29</text>
64
64
  <text x="406.2" y="300" fill="#7c7c7c" xml:space="preserve"> ≈$33.22</text>
65
65
  <text x="24.0" y="338" fill="#7c7c7c" xml:space="preserve"> 221 replies · 131 turns · input 15.25M · cache hit 90% · output 198.9K</text>
66
66
  <text x="24.0" y="376" fill="#5fafd7" font-weight="700" xml:space="preserve">BY </text>
@@ -73,31 +73,31 @@
73
73
  <text x="304.8" y="376" fill="#7c7c7c" xml:space="preserve"> g next</text>
74
74
  <text x="24.0" y="395" fill="#7c7c7c" xml:space="preserve"> replies cost vs unrouted mostly on</text>
75
75
  <text x="39.6" y="414" fill="#d0d0d0" xml:space="preserve">▾</text>
76
- <text x="55.2" y="414" fill="#d7875f" font-style="italic" xml:space="preserve">code</text>
76
+ <text x="55.2" y="414" fill="#d77757" font-style="italic" xml:space="preserve">code</text>
77
77
  <text x="211.2" y="414" fill="#d0d0d0" xml:space="preserve"> 125 ≈$12.70</text>
78
- <text x="351.6" y="414" fill="#6fcf97" xml:space="preserve"> −$3.55</text>
78
+ <text x="351.6" y="414" fill="#87d787" xml:space="preserve"> −$3.55</text>
79
79
  <text x="468.6" y="414" fill="#7c7c7c" xml:space="preserve"> Sonnet 5.5 · high</text>
80
80
  <text x="70.8" y="433" fill="#d0d0d0" xml:space="preserve">Opus 5.5 · xhigh</text>
81
81
  <text x="211.2" y="433" fill="#d0d0d0" xml:space="preserve"> 54 ≈$7.02</text>
82
82
  <text x="351.6" y="433" fill="#d0d0d0" xml:space="preserve"> $0.00</text>
83
83
  <text x="70.8" y="452" fill="#d0d0d0" xml:space="preserve">Sonnet 5.5 · high</text>
84
84
  <text x="211.2" y="452" fill="#d0d0d0" xml:space="preserve"> 71 ≈$5.68</text>
85
- <text x="351.6" y="452" fill="#6fcf97" xml:space="preserve"> −$3.55</text>
85
+ <text x="351.6" y="452" fill="#87d787" xml:space="preserve"> −$3.55</text>
86
86
  <text x="24.0" y="471" fill="#7c7c7c" xml:space="preserve"> cheaper −$3.69 · stronger $0.00 · cache rebuilds +$0.14 · input 8.63M · output 112.5K</text>
87
87
  <text x="39.6" y="490" fill="#d0d0d0" xml:space="preserve">▸</text>
88
- <text x="55.2" y="490" fill="#d7875f" font-style="italic" xml:space="preserve">ops</text>
88
+ <text x="55.2" y="490" fill="#d77757" font-style="italic" xml:space="preserve">ops</text>
89
89
  <text x="211.2" y="490" fill="#d0d0d0" xml:space="preserve"> 50 ≈$1.50</text>
90
- <text x="351.6" y="490" fill="#6fcf97" xml:space="preserve"> −$4.50</text>
90
+ <text x="351.6" y="490" fill="#87d787" xml:space="preserve"> −$4.50</text>
91
91
  <text x="468.6" y="490" fill="#7c7c7c" xml:space="preserve"> Haiku 5.5 · high</text>
92
92
  <text x="39.6" y="509" fill="#d0d0d0" xml:space="preserve">▸</text>
93
- <text x="55.2" y="509" fill="#d7875f" font-style="italic" xml:space="preserve">explore</text>
93
+ <text x="55.2" y="509" fill="#d77757" font-style="italic" xml:space="preserve">explore</text>
94
94
  <text x="211.2" y="509" fill="#d0d0d0" xml:space="preserve"> 36 ≈$1.01</text>
95
- <text x="351.6" y="509" fill="#6fcf97" xml:space="preserve"> −$2.95</text>
95
+ <text x="351.6" y="509" fill="#87d787" xml:space="preserve"> −$2.95</text>
96
96
  <text x="468.6" y="509" fill="#7c7c7c" xml:space="preserve"> Haiku 5.5 · high</text>
97
97
  <text x="39.6" y="528" fill="#d0d0d0" xml:space="preserve">▸</text>
98
- <text x="55.2" y="528" fill="#d7875f" font-style="italic" xml:space="preserve">plan</text>
98
+ <text x="55.2" y="528" fill="#d77757" font-style="italic" xml:space="preserve">plan</text>
99
99
  <text x="211.2" y="528" fill="#d0d0d0" xml:space="preserve"> 10 ≈$0.12</text>
100
- <text x="351.6" y="528" fill="#6fcf97" xml:space="preserve"> −$0.78</text>
100
+ <text x="351.6" y="528" fill="#87d787" xml:space="preserve"> −$0.78</text>
101
101
  <text x="468.6" y="528" fill="#7c7c7c" xml:space="preserve"> Haiku 5.5 · low</text>
102
102
  <text x="24.0" y="566" fill="#5fafd7" font-weight="700" xml:space="preserve">COST BY DAY </text>
103
103
  <text x="117.6" y="566" fill="#5fafd7" xml:space="preserve">▂▃▁·▂▃█</text>
@@ -106,7 +106,7 @@
106
106
  <text x="297.0" y="566" fill="#d0d0d0" xml:space="preserve">[ What if ]</text>
107
107
  <text x="24.0" y="604" fill="#5fafd7" font-weight="700" xml:space="preserve">WORTH A LOOK</text>
108
108
  <text x="117.6" y="604" fill="#7c7c7c" xml:space="preserve"> · from the numbers; answer quality is not measured</text>
109
- <text x="39.6" y="623" fill="#d7875f" font-style="italic" xml:space="preserve">code</text>
109
+ <text x="39.6" y="623" fill="#d77757" font-style="italic" xml:space="preserve">code</text>
110
110
  <text x="70.8" y="623" fill="#7c7c7c" xml:space="preserve"> · </text>
111
111
  <text x="94.2" y="623" fill="#e0708a" xml:space="preserve">▂▄▆█</text>
112
112
  <text x="125.4" y="623" fill="#d0d0d0" xml:space="preserve"> carried 46% of the cost</text>
@@ -130,7 +130,7 @@
130
130
  <text x="133.2" y="699" fill="#d0d0d0" xml:space="preserve">■ 8 moved by the router</text>
131
131
  <text x="312.6" y="699" fill="#7c7c7c" xml:space="preserve"> · </text>
132
132
  <text x="336.0" y="699" fill="#d0d0d0" xml:space="preserve">□ 7 on Claude Code’s pick</text>
133
- <text x="39.6" y="718" fill="#6fcf97" font-weight="700" xml:space="preserve">routing −$0.51 (−14%)</text>
133
+ <text x="39.6" y="718" fill="#87d787" font-weight="700" xml:space="preserve">routing −$0.51 (−14%)</text>
134
134
  <text x="203.4" y="718" fill="#d0d0d0" xml:space="preserve"> vs Claude Code’s picks</text>
135
135
  <text x="382.8" y="718" fill="#7c7c7c" xml:space="preserve"> on 9 routed agents</text>
136
136
  <text x="24.0" y="737" fill="#d0d0d0" xml:space="preserve"> per day </text>
@@ -144,21 +144,21 @@
144
144
  <text x="203.4" y="813" fill="#c3e88d" xml:space="preserve">■■■■</text>
145
145
  <text x="297.0" y="813" fill="#d0d0d0" xml:space="preserve"> 4</text>
146
146
  <text x="320.4" y="813" fill="#d0d0d0" xml:space="preserve"> ≈$0.18</text>
147
- <text x="390.6" y="813" fill="#6fcf97" xml:space="preserve"> −$0.72 ▼</text>
147
+ <text x="390.6" y="813" fill="#87d787" xml:space="preserve"> −$0.72 ▼</text>
148
148
  <text x="39.6" y="832" fill="#d0d0d0" xml:space="preserve">▸</text>
149
149
  <text x="55.2" y="832" fill="#d0d0d0" xml:space="preserve">dev-flow:reviewer</text>
150
150
  <text x="203.4" y="832" fill="#f78c6c" xml:space="preserve">□</text>
151
151
  <text x="211.2" y="832" fill="#c792ea" xml:space="preserve">■■</text>
152
152
  <text x="297.0" y="832" fill="#d0d0d0" xml:space="preserve"> 3</text>
153
153
  <text x="320.4" y="832" fill="#d0d0d0" xml:space="preserve"> ≈$2.50</text>
154
- <text x="390.6" y="832" fill="#f0b429" xml:space="preserve"> +$0.77 ▲</text>
154
+ <text x="390.6" y="832" fill="#d7af5f" xml:space="preserve"> +$0.77 ▲</text>
155
155
  <text x="39.6" y="851" fill="#d0d0d0" xml:space="preserve">▸</text>
156
156
  <text x="55.2" y="851" fill="#d0d0d0" xml:space="preserve">general-purpose</text>
157
157
  <text x="203.4" y="851" fill="#c3e88d" xml:space="preserve">■</text>
158
158
  <text x="211.2" y="851" fill="#f78c6c" xml:space="preserve">■</text>
159
159
  <text x="297.0" y="851" fill="#d0d0d0" xml:space="preserve"> 2</text>
160
160
  <text x="320.4" y="851" fill="#d0d0d0" xml:space="preserve"> ≈$0.47</text>
161
- <text x="390.6" y="851" fill="#6fcf97" xml:space="preserve"> −$0.56 ▼</text>
161
+ <text x="390.6" y="851" fill="#87d787" xml:space="preserve"> −$0.56 ▼</text>
162
162
  <text x="24.0" y="889" fill="#d0d0d0" font-weight="700" xml:space="preserve"> NOT ROUTED</text>
163
163
  <text x="117.6" y="889" fill="#7c7c7c" xml:space="preserve"> · Claude Code picked the model</text>
164
164
  <text x="39.6" y="908" fill="#d0d0d0" xml:space="preserve">▸</text>
@@ -1,7 +1,6 @@
1
1
  # Routing modes
2
2
 
3
- One setting trades cost against answer quality: `cost`, `balanced` (the default) or `quality`. The classifier and
4
- your routes stay as they are. With the default `table` engine, the mode moves the route each tier runs by one fixed step.
3
+ One routing mode trades cost against answer quality: `cost`, `balanced` (the default) or `quality`. With `table`, the mode moves each tier route by one fixed step. `shadow` keeps those table routes for requests; its automatic proposal uses the mode only as a capability margin. `auto` also uses only the capability margin. Neither automatic engine applies `modes.*.policy` patches.
5
4
 
6
5
  | Mode | What changes |
7
6
  | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -9,9 +8,9 @@ your routes stay as they are. With the default `table` engine, the mode moves th
9
8
  | `balanced` | Nothing: every tier runs its route as configured. |
10
9
  | `quality` | One effort level more on the same model, else the route of the tier above. Haiku 5.5 automatically prefers High, except medium bounded ops may use Xhigh. Explicit higher efforts stay supported. |
11
10
 
12
- In every mode:
11
+ For requests selected by `table` and `shadow`, these route-table rules apply:
13
12
 
14
- - `micro` turns keep the `micro` route. Only the classifier makes a turn `micro`; `cost` never does.
13
+ - `micro` turns keep the configured `micro` route. Only the classifier makes a turn `micro`; `cost` never does.
15
14
  - A pin (`/router pin <tier>`) runs that tier's configured route. With routing off (`/router off`, `/model`),
16
15
  Claude's model runs, as before.
17
16
  - A route never loses its effort: an effort level moves only within what the model lists in `models.<alias>.efforts`,
@@ -19,10 +18,13 @@ In every mode:
19
18
  on a model listing only those three. A route with a `null` effort (the session's) or a model without efforts has no effort step.
20
19
  - [MiniMax, MiMo and Kimi tables](providers.md#new-provider-modes) show every new preset's mode/activity combination.
21
20
 
22
- Optional [automatic routing](configuration.md#routing-engine) uses the mode only as a capability margin: `cost`
23
- subtracts 0.5 from demand, `balanced` adds nothing and `quality` adds 0.5, clamped to 0–3. It uses base policy,
24
- not mode policy patches. Tier pins use exact demand without a margin; candidates still must fit. Shadow records a
25
- proposal while the table routes. Auto is opt-in; quality evaluation and cutover are pending.
21
+ For `auto`, `micro` is classifier demand 0, not a pinned table row. A tier pin sets exact demand for one turn,
22
+ without a mode margin; eligible model-effort candidates still obey hard constraints.
23
+
24
+ [Routing engines](configuration.md#routing-engine) are selected separately in the profile file. `auto` is opt-in;
25
+ `shadow` records proposals while `table` routes. Auto uses the mode only as a capability margin: `cost` subtracts 0.5
26
+ from demand, `balanced` adds nothing and `quality` adds 0.5, clamped to 0–3. Tier pins use exact demand without a
27
+ margin. Evaluation and default cutover are pending.
26
28
 
27
29
  ## Choose a mode
28
30