clauderipple 0.9.2 → 0.9.4

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## 0.9.4 — 2026-10-14
+
+### Fixed
+
+- **Reasoning models are no longer cut off after five minutes of thinking.** Node's `fetch` dropped a
+  response that sent nothing for 300 seconds. Muse Spark 1.3 at xhigh thinks for minutes in silence
+  on a large context, so long steps failed with 529 at 303–305 seconds and started over. The router
+  now waits up to 15 minutes. OpenCode's own CLI had no such limit, which is why the same model
+  worked there.
+- **OpenCode Go and Zen models get their real context window.** They fell back to the global
+  258,400, so Claude Code compacted DeepSeek V4.1 Flash, GLM-5.3 and Muse Spark 1.3 at a quarter of
+  their 1M windows. The router now reads the window from the same models.dev catalogue OpenCode's
+  CLI uses, and fills models already saved without one.
+- **A ChatGPT account whose limit was reset or topped up is usable again right away.** It stayed
+  "cooling" until the old reset time, so the app could not switch to GPT models.
+- **Adding an OpenAI-compatible provider such as B.ai works.** The connection check asked for one
+  token, which some vendors refuse ("max_tokens must be greater than 2", #57).
+- **The plan limit shows on the band**, and every control's tip shows on hover even when the band
+  is full.
+
+### Changed
+
+- **The band:** Auto is a word that lights when on, instead of a switch. Compact and Clear (with a
+  confirm) sit beside settings. The limit draws as a small gauge and its percent.
+- **Workers read and edit with the dedicated tools.** Generated worker agents are told to read files
+  with Read and change them with Edit, not with `sed`/`cat` through Bash.
+- `/ripple debug` also shows the model, the limit and the host's rate limits.
+
+## 0.9.3 — 2026-10-14
+
+### Fixed
+
+- **Claude workers offer X-High.** Claude's effort ladder stopped at high and max, so X-High could
+  not be picked for Claude in the mod or the dashboard though GPT had it. Opus, Sonnet and Haiku 5.5
+  all take it (#56).
+- **A model ticked after the mod's worker list was saved is usable.** It used to stay off and show
+  as unavailable in the mod (GPT-6 Astra in #56). A worker the list has not seen now starts on.
+  Settings saved before this keep the old reading until the list is changed once.
+- **The plan limit shows in the band on Claude chats.** The desktop Code tab left the mod's rate
+  limits empty, so the limit never appeared even with it switched on. The mod now falls back to the
+  router's figure for the same Claude login, and hides it when that figure is over 15 minutes old.
+- `/ripple-bar` no longer says the band is shown above the prompt when the layout is Minimal, where
+  only the short line under the prompt is drawn (#56).
+- The close button lights as one disc under the pointer instead of drawing a second box around it.
+
 ## 0.9.2 — 2026-10-14
 
 ### Added

package/dist/app/package.json

@@ -1,5 +1,5 @@
 {
   "private": true,
-  "version": "0.9.2",
+  "version": "0.9.4",
   "type": "commonjs"
 }

package/dist/mod/hooks/i18n.ts

@@ -63,6 +63,9 @@ const EN = {
   'band.warm': 'Warm',
   'band.handoff': 'Handoff',
   'band.compact': 'Compact',
+  'band.clear': 'Clear',
+  'band.compactAlt': 'Compact — summarise the conversation to free context',
+  'band.clearAlt': 'New start (/clear) — clear the conversation and start fresh',
   'band.log': 'Log',
   'band.agents': 'Agents',
   'band.settings': 'Settings',
@@ -152,6 +155,9 @@ const EN = {
   'alerts.demoDown': 'Jev out of credits (demo)',
   'alerts.copied': 'The resume note was copied; this chat was kept.',
   'alerts.compactFailed': 'Compaction did not finish.',
+  'alerts.clearTitle': 'Start this conversation over?',
+  'alerts.clearBody': 'The conversation\'s context is emptied; a fresh chat starts with nothing.',
+  'alerts.clearGo': 'Start over',
   // Settings.
   'settings.effortBlurb': 'How Auto picks the effort for each prompt you send.',
   'settings.workers': 'Workers',
@@ -361,6 +367,7 @@ const EN = {
   'commands.logOpened': 'ClaudeRipple log opened.',
   'commands.logClosed': 'ClaudeRipple log closed.',
   'commands.barShown': 'ClaudeRipple line shown above the prompt.',
+  'commands.barShownMinimal': 'The layout is Minimal, so ClaudeRipple shows as a short line under the prompt. For the full band above the prompt, set Layout to Dashboard in /ripple settings.',
   'commands.barHidden': 'ClaudeRipple line hidden. /ripple-bar shows it again.',
   'commands.statsAuto': 'Auto: {prompts} prompts, {requests} requests; {total} weighted tokens',
   'commands.statsTokens': 'Tokens: input {input}, write {write}, read {read}, output {output}',
@@ -512,6 +519,9 @@ const KO: Record<Key, string> = {
   'band.warm': '캐시 유지',
   'band.handoff': '인수인계',
   'band.compact': '압축',
+  'band.clear': '새로 시작',
+  'band.compactAlt': '대화 압축 — 지금까지 대화를 요약해 컨텍스트를 줄입니다',
+  'band.clearAlt': '새로 시작 (/clear) — 대화 맥락을 비우고 새로 시작합니다',
   'band.log': '로그',
   'band.agents': '에이전트',
   'band.settings': '설정',
@@ -601,6 +611,9 @@ const KO: Record<Key, string> = {
   'alerts.demoDown': 'Jev 크레딧 소진 (데모)',
   'alerts.copied': '재개용 요약 메모를 복사했습니다. 현재 대화는 보존됩니다.',
   'alerts.compactFailed': '대화 압축을 마치지 못했습니다.',
+  'alerts.clearTitle': '대화를 새로 시작할까요?',
+  'alerts.clearBody': '지금 대화 맥락이 비워집니다. 새 대화가 아무것도 없는 상태에서 시작됩니다.',
+  'alerts.clearGo': '새로 시작',
   // Settings.
   'settings.effortBlurb': '전송하는 프롬프트마다 추론 강도를 자동으로 선택합니다.',
   'settings.workers': '워커',
@@ -810,6 +823,7 @@ const KO: Record<Key, string> = {
   'commands.logOpened': 'ClaudeRipple 로그를 열었습니다.',
   'commands.logClosed': 'ClaudeRipple 로그를 닫았습니다.',
   'commands.barShown': '프롬프트 상단에 ClaudeRipple 상태 바를 표시합니다.',
+  'commands.barShownMinimal': '레이아웃이 최소화로 되어 있어 ClaudeRipple은 프롬프트 아래 한 줄로만 표시됩니다. 프롬프트 위에 상태 바를 띄우려면 /ripple settings에서 레이아웃을 대시보드로 바꾸십시오.',
   'commands.barHidden': 'ClaudeRipple 상태 바를 숨겼습니다. /ripple-bar로 다시 표시할 수 있습니다.',
   'commands.statsAuto': '자동: 프롬프트 {prompts}개, 요청 {requests}개, 가중 토큰 {total}',
   'commands.statsTokens': '토큰: 입력 {input}, 쓰기 {write}, 읽기 {read}, 출력 {output}',
@@ -959,6 +973,9 @@ const ZH: Record<Key, string> = {
   'band.warm': '保温',
   'band.handoff': '交接',
   'band.compact': '压缩',
+  'band.clear': '新开',
+  'band.compactAlt': '压缩对话 — 总结对话以释放上下文',
+  'band.clearAlt': '重新开始 (/clear) — 清空对话上下文，重新开始',
   'band.log': '日志',
   'band.agents': '代理',
   'band.settings': '设置',
@@ -1048,6 +1065,9 @@ const ZH: Record<Key, string> = {
   'alerts.demoDown': 'Jev 额度用尽（演示）',
   'alerts.copied': '已复制续接说明，此对话已保留。',
   'alerts.compactFailed': '压缩未完成。',
+  'alerts.clearTitle': '重新开始此对话？',
+  'alerts.clearBody': '当前对话的上下文将被清空；新对话从空白开始。',
+  'alerts.clearGo': '重新开始',
   // Settings.
   'settings.effortBlurb': '自动模式如何为你发送的每条提示词选择推理强度。',
   'settings.workers': 'Worker',
@@ -1257,6 +1277,7 @@ const ZH: Record<Key, string> = {
   'commands.logOpened': '已打开 ClaudeRipple 日志。',
   'commands.logClosed': '已关闭 ClaudeRipple 日志。',
   'commands.barShown': 'ClaudeRipple 状态栏已显示在提示词上方。',
+  'commands.barShownMinimal': '布局是“极简”，所以 ClaudeRipple 只在提示词下方显示一行。要在提示词上方显示完整状态栏，请在 /ripple settings 里把布局改为“仪表盘”。',
   'commands.barHidden': 'ClaudeRipple 状态栏已隐藏，/ripple-bar 可重新显示。',
   'commands.statsAuto': '自动：{prompts} 条提示词，{requests} 次请求；加权 token {total}',
   'commands.statsTokens': 'Token：输入 {input}，写入 {write}，读取 {read}，输出 {output}',
@@ -1406,6 +1427,9 @@ const JA: Record<Key, string> = {
   'band.warm': '保持',
   'band.handoff': '引き継ぎ',
   'band.compact': '圧縮',
+  'band.clear': '新しく開始',
+  'band.compactAlt': '圧縮 — これまでの会話を要約してコンテキストを減らします',
+  'band.clearAlt': '新しく開始 (/clear) — 会話の文脈を空にして新しく始めます',
   'band.log': 'ログ',
   'band.agents': 'エージェント',
   'band.settings': '設定',
@@ -1495,6 +1519,9 @@ const JA: Record<Key, string> = {
   'alerts.demoDown': 'Jev のクレジット切れ（デモ）',
   'alerts.copied': '再開メモをコピーしました。この会話はそのままです。',
   'alerts.compactFailed': '圧縮が完了しませんでした。',
+  'alerts.clearTitle': 'この会話を新しく始めますか？',
+  'alerts.clearBody': '今の会話のコンテキストは空になります。新しい会話は何もない状態から始まります。',
+  'alerts.clearGo': '新しく開始',
   // Settings.
   'settings.effortBlurb': '送信するプロンプトごとに、自動が推論強度を選ぶ方法。',
   'settings.workers': 'ワーカー',
@@ -1704,6 +1731,7 @@ const JA: Record<Key, string> = {
   'commands.logOpened': 'ClaudeRipple のログを開きました。',
   'commands.logClosed': 'ClaudeRipple のログを閉じました。',
   'commands.barShown': 'ClaudeRipple のバーをプロンプトの上に表示しました。',
+  'commands.barShownMinimal': 'レイアウトがミニマルなので、ClaudeRipple はプロンプトの下に 1 行で表示されます。プロンプトの上にバーを出すには、/ripple settings でレイアウトをダッシュボードにしてください。',
   'commands.barHidden': 'ClaudeRipple のバーを非表示にしました。/ripple-bar で再表示できます。',
   'commands.statsAuto': '自動: プロンプト {prompts} 件、リクエスト {requests} 件、加重トークン {total}',
   'commands.statsTokens': 'トークン: 入力 {input}、書き込み {write}、読み取り {read}、出力 {output}',
@@ -1853,6 +1881,9 @@ const ES: Record<Key, string> = {
   'band.warm': 'Mantener',
   'band.handoff': 'Traspaso',
   'band.compact': 'Compactar',
+  'band.clear': 'Reiniciar',
+  'band.compactAlt': 'Compactar — resume la conversación para liberar contexto',
+  'band.clearAlt': 'Empezar de nuevo (/clear) — vacía la conversación y empieza desde cero',
   'band.log': 'Registro',
   'band.agents': 'Agentes',
   'band.settings': 'Ajustes',
@@ -1942,6 +1973,9 @@ const ES: Record<Key, string> = {
   'alerts.demoDown': 'Jev sin créditos (demo)',
   'alerts.copied': 'Se copió la nota para continuar; esta conversación se conservó.',
   'alerts.compactFailed': 'La compactación no terminó.',
+  'alerts.clearTitle': '¿Empezar esta conversación de nuevo?',
+  'alerts.clearBody': 'El contexto de esta conversación se vacía; una conversación nueva empieza de cero.',
+  'alerts.clearGo': 'Empezar de nuevo',
   // Settings.
   'settings.effortBlurb': 'Cómo Auto elige el esfuerzo de cada prompt que envías.',
   'settings.workers': 'Workers',
@@ -2151,6 +2185,7 @@ const ES: Record<Key, string> = {
   'commands.logOpened': 'Registro de ClaudeRipple abierto.',
   'commands.logClosed': 'Registro de ClaudeRipple cerrado.',
   'commands.barShown': 'Barra de ClaudeRipple visible sobre el prompt.',
+  'commands.barShownMinimal': 'La disposición es Mínimo, así que ClaudeRipple aparece como una línea corta bajo el prompt. Para la barra completa sobre el prompt, elige Panel en Disposición en /ripple settings.',
   'commands.barHidden': 'Barra de ClaudeRipple oculta. /ripple-bar la vuelve a mostrar.',
   'commands.statsAuto': 'Auto: {prompts} prompts, {requests} solicitudes; {total} tokens ponderados',
   'commands.statsTokens': 'Tokens: entrada {input}, escritura {write}, lectura {read}, salida {output}',
@@ -2300,6 +2335,9 @@ const PT: Record<Key, string> = {
   'band.warm': 'Manter',
   'band.handoff': 'Repasse',
   'band.compact': 'Compactar',
+  'band.clear': 'Recomeçar',
+  'band.compactAlt': 'Compactar — resume a conversa para liberar contexto',
+  'band.clearAlt': 'Começar de novo (/clear) — limpa a conversa e começa do zero',
   'band.log': 'Log',
   'band.agents': 'Agentes',
   'band.settings': 'Ajustes',
@@ -2389,6 +2427,9 @@ const PT: Record<Key, string> = {
   'alerts.demoDown': 'Jev sem créditos (demo)',
   'alerts.copied': 'A nota para continuar foi copiada; esta conversa foi mantida.',
   'alerts.compactFailed': 'A compactação não terminou.',
+  'alerts.clearTitle': 'Começar esta conversa de novo?',
+  'alerts.clearBody': 'O contexto desta conversa é esvaziado; uma conversa nova começa do zero.',
+  'alerts.clearGo': 'Começar de novo',
   // Settings.
   'settings.effortBlurb': 'Como o Auto escolhe o esforço de cada prompt que você envia.',
   'settings.workers': 'Workers',
@@ -2598,6 +2639,7 @@ const PT: Record<Key, string> = {
   'commands.logOpened': 'Log do ClaudeRipple aberto.',
   'commands.logClosed': 'Log do ClaudeRipple fechado.',
   'commands.barShown': 'Barra do ClaudeRipple visível acima do prompt.',
+  'commands.barShownMinimal': 'O layout está em Mínimo, então o ClaudeRipple aparece como uma linha curta abaixo do prompt. Para a barra completa acima do prompt, escolha Painel em Layout no /ripple settings.',
   'commands.barHidden': 'Barra do ClaudeRipple oculta. /ripple-bar mostra de novo.',
   'commands.statsAuto': 'Auto: {prompts} prompts, {requests} requisições; {total} tokens ponderados',
   'commands.statsTokens': 'Tokens: entrada {input}, gravação {write}, leitura {read}, saída {output}',

package/dist/mod/hooks/ladder.js

@@ -150,9 +150,9 @@ export function preset(id, choices) {
     }
     return { rungs, substituted };
 }
-/** The choices a person ticked; an empty list ticks every one. */
-export function tickedChoices(choices, allow) {
-    return choices.filter(choice => isAllowed(candidateKey(choice.target), choice.provider, allow));
+/** The choices a person ticked; an empty list ticks every one, and a key absent from `known` ticks on too. */
+export function tickedChoices(choices, allow, known = []) {
+    return choices.filter(choice => isAllowed(candidateKey(choice.target), choice.provider, allow, known));
 }
 /** Only empty lists need filling; unticked entries stay in order and are skipped at dispatch. */
 export function ladderNeedsFill(rungs, _allow = []) {
@@ -162,8 +162,8 @@ export function ladderNeedsFill(rungs, _allow = []) {
  * Fill empty lists from the ticked, connected choices. Existing ordered lists are never rewritten
  * for temporary availability or shared allow-list changes; dispatch explains each skipped entry.
  */
-export function fillLadder(rungs, allow, choices) {
-    const pick = preset('claudeGpt', tickedChoices(choices, allow));
+export function fillLadder(rungs, allow, choices, known = []) {
+    const pick = preset('claudeGpt', tickedChoices(choices, allow, known));
     const out = {};
     const filled = [];
     for (const rung of RUNGS) {

package/dist/mod/hooks/ladder.ts

@@ -146,9 +146,9 @@ export function preset(id: PresetId, choices: readonly LadderChoice[]): Preset {
   return { rungs, substituted }
 }
 
-/** The choices a person ticked; an empty list ticks every one. */
-export function tickedChoices(choices: readonly LadderChoice[], allow: readonly string[]): LadderChoice[] {
-  return choices.filter(choice => isAllowed(candidateKey(choice.target), choice.provider, allow))
+/** The choices a person ticked; an empty list ticks every one, and a key absent from `known` ticks on too. */
+export function tickedChoices(choices: readonly LadderChoice[], allow: readonly string[], known: readonly string[] = []): LadderChoice[] {
+  return choices.filter(choice => isAllowed(candidateKey(choice.target), choice.provider, allow, known))
 }
 
 /** Only empty lists need filling; unticked entries stay in order and are skipped at dispatch. */
@@ -160,8 +160,8 @@ export function ladderNeedsFill(rungs: Rungs, _allow: readonly string[] = []): b
  * Fill empty lists from the ticked, connected choices. Existing ordered lists are never rewritten
  * for temporary availability or shared allow-list changes; dispatch explains each skipped entry.
  */
-export function fillLadder(rungs: Rungs, allow: readonly string[], choices: readonly LadderChoice[]): { rungs: Record<Rung, Step[]>; filled: Rung[] } {
-  const pick = preset('claudeGpt', tickedChoices(choices, allow))
+export function fillLadder(rungs: Rungs, allow: readonly string[], choices: readonly LadderChoice[], known: readonly string[] = []): { rungs: Record<Rung, Step[]>; filled: Rung[] } {
+  const pick = preset('claudeGpt', tickedChoices(choices, allow, known))
   const out = {} as Record<Rung, Step[]>
   const filled: Rung[] = []
   for (const rung of RUNGS) {

package/dist/mod/hooks/register.tsx

@@ -1,7 +1,7 @@
 // Engine wiring lives here: imported logic and drawings never receive the engine interface.
 // Timers own background work; hooks only admit/rewrite a request and record its result.
 import { atom, read, update } from 'claude-code'
-import type { AgentSpawnInput, EngineInterface, ModelCompleteResult, ModelForkResult, Register, RenderElement, RenderInput, ToolCallInput, TurnStepInput, TurnUsage } from 'claude-code'
+import type { AgentSpawnInput, EngineInterface, ModelCompleteResult, ModelForkResult, Register, RenderElement, RenderInput, SessionRateLimit, ToolCallInput, TurnStepInput, TurnUsage } from 'claude-code'
 import type { AgentRec, Effort, JudgeInput, JudgeKind, JudgeRun, ModSettingsSnapshot, Pick, Settings, StatusRequest, TierTarget, Verdict, WorkerCandidate, WorkerPick, WorkerVerdict } from '../types'
 import { MOD_SETTINGS_SCHEMA_VERSION, applySettingsChanges, normalizeSettings, settingsChanges } from './settings'
 import { debugText, langFrom, t } from './i18n'
@@ -13,7 +13,7 @@ import { activeModeOf, claudeWindow, eagerNote, modeKey, modeOver, quotaWindows,
 import type { QuotaWindow } from './modes'
 import type { Spawn, WorkerFix } from './worker'
 import { afterPing, nextMemo, restoreFromResume, shouldPing } from './cache'
-import { bandPriority, coldAlert, hotAlert, hottest, keptAlert, saveUntil as limitSaveUntil, swampAlert, swamped } from './session'
+import { bandPriority, claudeLimitsFrom, coldAlert, hotAlert, hottest, keptAlert, saveUntil as limitSaveUntil, swampAlert, swamped } from './session'
 import { COMPACT_SYSTEM, compactResult, serializeTranscript } from './compact'
 import { ADVICE_SYSTEM, FULL_PROMPT, QUICK_PROMPT, adviceDue, adviceInput, parseAdvice, wrapForNewChat } from './handoff'
 import { addJudge, addPrompt, addRequest, addWarm, addWorker, emptyStats, formatStats, weighted } from './stats'
@@ -442,7 +442,7 @@ async function refreshLadder($: EngineInterface): Promise<void> {
   try {
     const response = await $.http.fetch(`${await adminUrl($)}/api/mod-options`)
     if (!response.ok) throw new Error(t(await read($, lang), 'commands.routerHttp', { status: response.status }))
-    const fresh = ladderOptionsFrom(JSON.parse(response.text), await $.clock.now() + KEEP_MS, (await currentSettings($)).allow)
+    const fresh = ladderOptionsFrom(JSON.parse(response.text), await $.clock.now() + KEEP_MS, (await currentSettings($)).allow, (await currentSettings($)).allowKnown)
     if (!same(await read($, ladderOptions), fresh)) await update($, ladderOptions, () => fresh)
   } catch (error) { await report($, 'ladder options', error) }
 }
@@ -692,7 +692,7 @@ async function requestPick($: EngineInterface, e: AgentSpawnInput, s: Settings):
   const routing = routingSettings(s)
   const resolved = explicitCandidate && candidateUsable(explicitCandidate, s, usable, providers)
     ? { target: target!, effort: verdict.effort }
-    : ladderPick(verdict, routing.rules.general, routing, pinnedCandidates, usable, language, routing.allow, providers)
+    : ladderPick(verdict, routing.rules.general, routing, pinnedCandidates, usable, language, routing.allow, providers, routing.allowKnown)
   const selected = resolved.target
   if (!selected) return { deny: t(language, 'workers.none') }
   const fallbackReason = resolved.fallbackReason
@@ -931,6 +931,16 @@ async function openCompact($: EngineInterface, surface: Frame['surface']): Promi
   await update($, compactNote, () => '')
   await update($, panel, () => 'compact')
 }
+async function openClear($: EngineInterface): Promise<void> {
+  await update($, panel, () => 'clear')
+}
+/** The router's figure for this login's plan windows; nothing when the router cannot say. */
+async function routerClaudeLimits($: EngineInterface): Promise<SessionRateLimit[]> {
+  try {
+    const status = await $.http.fetch(`${await adminUrl($)}/api/status`)
+    return status.ok ? claudeLimitsFrom(JSON.parse(status.text), await $.clock.now()) : []
+  } catch (error) { await report($, 'claude limits', error); return [] }
+}
 async function refreshUsage($: EngineInterface): Promise<void> {
   const usage = await $.session.usage()
   const c = usage.context
@@ -940,11 +950,15 @@ async function refreshUsage($: EngineInterface): Promise<void> {
   // Below the line again (a compact, a clear), the next crossing shows the heavy-context band once.
   const putOff = await read($, swampHidden)
   if (putOff !== null && (putOff > 100 || !ctx || ctx.percent < (await currentSettings($)).swampAt)) await update($, swampHidden, () => null)
-  const h = hottest(usage.rateLimits)
+  // The host can leave the plan windows out though the replies carried them; on a Claude chat the
+  // router's figure for the same login stands in.
+  const own = usage.rateLimits.some(l => ['five_hour', 'seven_day'].includes(l.kind))
+  const rateLimits = own || !/^claude-/.test(await $.session.model()) ? usage.rateLimits : [...usage.rateLimits, ...await routerClaudeLimits($)]
+  const h = hottest(rateLimits)
   const previous = await read($, hot)
   if (previous && (!h || previous.kind !== h.kind || previous.resetsAt !== h.resetsAt)) await update($, hotHidden, () => null)
   if (JSON.stringify(h) !== JSON.stringify(previous)) await update($, hot, () => h)
-  const top = usage.rateLimits.filter(l => ['five_hour', 'seven_day'].includes(l.kind)).sort((a, b) => b.percentUsed - a.percentUsed)[0]
+  const top = rateLimits.filter(l => ['five_hour', 'seven_day'].includes(l.kind)).sort((a, b) => b.percentUsed - a.percentUsed)[0]
   const l = top ? { kind: top.kind, percent: top.percentUsed, ...(top.resetsAt ? { resetsAt: top.resetsAt } : {}) } : null
   // Check the previous binding deadline before a rolled-forward snapshot replaces it.
   await endModeIfOver($)
@@ -1079,6 +1093,7 @@ async function alertView($: EngineInterface, now: number): Promise<AlertView | n
     kept: d === 'kept' || keptAlert(await read($, kept), m, now),
     swamp: d === 'swamp' || (s.swampAlert && !await read($, busy) && swampAlert(swamped(c, s.swampAt), await read($, swampHidden))) })
   if (which === 'compact') return { kind: 'compactNote', draft: await read($, compactNote) }
+  if (which === 'clear') return { kind: 'clear' }
   if (which === 'handoff') return { kind: 'handoffChoice', handoffKind: await read($, handoffChoiceKind), after: await read($, handoffChoiceAfter) }
   if (which === 'judgeDown') return { kind: 'judgeDown', judge: s.judge, reason: d === 'down' ? t(language, 'alerts.demoDown') : downReason!, network: d !== 'down' && await read($, judgeDownNetwork) }
   if (which === 'hot') return { kind: 'hot', limitKind: h?.kind ?? 'five_hour', percent: d === 'hot' ? 86 : h!.percent, resetsAt: h?.resetsAt, save: (await read($, saveUntil) ?? 0) > now }
@@ -1116,7 +1131,7 @@ async function dismiss($: EngineInterface, view: AlertView): Promise<void> {
   else await update($, panel, () => null)
 }
 function bandActions($: EngineInterface, surface: Frame['surface']): BandActions {
-  return { toggleAuto: () => toggleAuto($), toggleWarm: () => toggleWarm($), compact: () => openCompact($, surface), handoff: () => openHandoff($), toggleLog: () => toggleLog($), toggleAgents: () => toggleAgents($), openSettings: () => startPanel($, 'settings'),
+  return { toggleAuto: () => toggleAuto($), toggleWarm: () => toggleWarm($), compact: () => openCompact($, surface), clear: () => openClear($), handoff: () => openHandoff($), toggleLog: () => toggleLog($), toggleAgents: () => toggleAgents($), openSettings: () => startPanel($, 'settings'),
     toggleEffortMenu: () => update($, effortMenuOpen, value => !value), pickEffort: effort => manualPick($, effort) }
 }
 function settingsActions($: EngineInterface): SettingsActions {
@@ -1136,7 +1151,7 @@ function setupActions($: EngineInterface): SetupActions {
     back: () => update($, setupStep, step => Math.max(1, step - 1) as 1 | 2 | 3 | 4), next: () => update($, setupStep, step => Math.min(4, step + 1) as 1 | 2 | 3 | 4), finish: () => finishSetup($), skip: () => finishSetup($, true) }
 }
 function alertActions($: EngineInterface, view: AlertView): AlertActions {
-  return { compact: note => runCompact($, note), handoff: () => openHandoff($), dismiss: () => dismiss($, view), toggleSave: () => toggleSave($), openSettings: () => startPanel($, 'settings'),
+  return { compact: note => runCompact($, note), clear: async () => { await update($, panel, () => null); await $.command.run({ command: 'clear', args: '' }) }, handoff: () => openHandoff($), dismiss: () => dismiss($, view), toggleSave: () => toggleSave($), openSettings: () => startPanel($, 'settings'),
     noteInput: text => update($, compactNote, () => text), setHandoffKind: kind => update($, handoffChoiceKind, () => kind), setHandoffAfter: after => update($, handoffChoiceAfter, () => after), go: () => queueHandoff($), copy: () => copyHandoff($), openNew: () => moveToNewSession($) }
 }
 function toolLine(e: ToolCallInput): string {
@@ -1446,7 +1461,7 @@ export const register: Register = on => {
       const language = await read($, lang)
       const [sub = 'settings', arg] = e.args.trim().toLowerCase().split(/\s+/)
       if (sub === 'stats') return { text: formatStats(await read($, stats), language) }
-      if (sub === 'debug') return { text: debugText(language, { judge: (await currentSettings($)).judge, judgeModel: (await currentSettings($)).judgeModel, pick: await read($, pick), paused: await read($, paused), cache: await read($, cache), warm: await read($, warm), lastSpawn: await read($, lastSpawn), lastRequest: await read($, lastRequest) }) }
+      if (sub === 'debug') return { text: debugText(language, { judge: (await currentSettings($)).judge, judgeModel: (await currentSettings($)).judgeModel, pick: await read($, pick), paused: await read($, paused), cache: await read($, cache), warm: await read($, warm), lastSpawn: await read($, lastSpawn), lastRequest: await read($, lastRequest), model: await $.session.model(), limit: await read($, limit), hostRateLimits: (await $.session.usage()).rateLimits }) }
       if (sub === 'settings' || sub === 'setup') await startPanel($, sub)
       else if (sub === 'auto') await toggleAuto($)
       else if (sub === 'warm') await toggleWarm($)
@@ -1469,7 +1484,9 @@ export const register: Register = on => {
   on('command.run', { command: 'ripple-bar' }, async ($, e, next) => {
     try {
       const language = await read($, lang)
-      return { text: await toggleBar($) ? t(language, 'commands.barShown') : t(language, 'commands.barHidden') } }
+      if (!await toggleBar($)) return { text: t(language, 'commands.barHidden') }
+      // The minimal layout draws no band above the prompt, only the short line under it (#56).
+      return { text: t(language, (await currentSettings($)).layout === 'minimal' ? 'commands.barShownMinimal' : 'commands.barShown') } }
     catch (error) { await report($, 'ripple-bar', error); return next(e) }
   })
   on('ui.close', { id: LOG_PANE }, async ($, e, next) => {
@@ -1489,7 +1506,7 @@ export const register: Register = on => {
       const frame = await frameOf($, e)
       const el = $.ui.resolve(e)
       if (which === 'settings') return renderSettings(el, frame, await settingsView($), settingsActions($)) as RenderElement
-      if (which === 'compact' || which === 'handoff') {
+      if (which === 'compact' || which === 'clear' || which === 'handoff') {
         const choice = await alertView($, frame.now)
         if (choice) return renderAlert(el, frame, choice, alertActions($, choice)) as RenderElement
       }

package/dist/mod/hooks/session.ts

@@ -7,6 +7,32 @@ export function hottest(rateLimits: readonly SessionRateLimit[]): Hot | null {
   return limit ? { kind: limit.kind, percent: limit.percentUsed, ...(limit.resetsAt ? { resetsAt: limit.resetsAt } : {}) } : null
 }
 
+const WINDOW_KIND: Record<number, string> = { 300: 'five_hour', 10080: 'seven_day' }
+/** A router snapshot older than this is not shown as the plan's figure. */
+export const CLAUDE_USAGE_STALE_MS = 15 * 60_000
+
+/**
+ * The plan windows of the Claude login this session's requests pass through, from the router's
+ * GET /api/status (`claude.accounts[id=current].quota`, packages/router/src/admin.ts
+ * claudeAccountUsage): for when the host leaves `rateLimits` empty though the requests carry them
+ * (measured 2026-10-14: the router passes the `anthropic-ratelimit-unified-*` headers through).
+ * Percent as the router reports it; a stale or unknown snapshot gives nothing.
+ */
+export function claudeLimitsFrom(status: unknown, now: number): SessionRateLimit[] {
+  const object = (v: unknown): Record<string, unknown> => v && typeof v === 'object' && !Array.isArray(v) ? v as Record<string, unknown> : {}
+  const accounts = object(object(status).claude).accounts
+  const current = Array.isArray(accounts) ? accounts.map(object).find(a => a.id === 'current') : undefined
+  const quota = object(current?.quota)
+  if (typeof quota.at !== 'number' || now - quota.at > CLAUDE_USAGE_STALE_MS) return []
+  const limits = object(quota.rate_limits)
+  return [limits.primary, limits.secondary].map(object).flatMap(w => {
+    const kind = typeof w.window_minutes === 'number' ? WINDOW_KIND[w.window_minutes] : undefined
+    if (!kind || typeof w.used_percent !== 'number' || !Number.isFinite(w.used_percent)) return []
+    const reset = typeof w.reset_at === 'number' ? w.reset_at * (w.reset_at < 1e12 ? 1000 : 1) : NaN
+    return [{ kind, percentUsed: Math.round(w.used_percent * 10) / 10, ...(Number.isFinite(reset) ? { resetsAt: new Date(reset).toISOString() } : {}) }]
+  })
+}
+
 /**
  * The reset is read in the person's own clock: `offsetMinutes` is `Date#getTimezoneOffset` (minutes
  * behind UTC), passed in so tests do not depend on the machine's zone.
@@ -61,9 +87,9 @@ export function swampAlert(percent: number | null, hidden: number | null): boole
 
 /** Rendering consumes eligibility, keeping dismissal and idle decisions outside drawing code. */
 export function bandPriority(state: {
-  panel?: 'settings' | 'compact' | 'handoff' | 'setup' | null
+  panel?: 'settings' | 'compact' | 'clear' | 'handoff' | 'setup' | null
   judgeDown?: boolean; hot?: boolean; result?: boolean; cold?: boolean; swamp?: boolean; kept?: boolean
-}): 'settings' | 'compact' | 'handoff' | 'setup' | 'judgeDown' | 'hot' | 'result' | 'cold' | 'swamp' | 'kept' | 'dashboard' {
+}): 'settings' | 'compact' | 'clear' | 'handoff' | 'setup' | 'judgeDown' | 'hot' | 'result' | 'cold' | 'swamp' | 'kept' | 'dashboard' {
   if (state.panel) return state.panel
   for (const band of ['judgeDown', 'hot', 'result', 'cold', 'swamp', 'kept'] as const) if (state[band]) return band
   return 'dashboard'

package/dist/mod/hooks/settings.js

@@ -21,7 +21,7 @@ export const DEFAULTS = {
                 hard: [{ target: { agent: 'gpt-6-astra' }, effort: 'high' }], plan: [claude('opus', 'high')],
             } },
     },
-    allow: [], modes: [],
+    allow: [], allowKnown: [], modes: [],
     providers: {},
     fallback: { agent: 'general-purpose', model: 'sonnet' },
     keepWarm: false, keepWarmHours: 2, keepWarmMinTokens: 30000,
@@ -158,16 +158,16 @@ export function migrateAllow(allow, workers) {
     const agents = new Set(workers.map(w => w.name));
     return [...new Set(allow.flatMap(entry => agents.has(entry) || !workers.some(w => w.provider === entry) ? [entry] : workers.filter(w => w.provider === entry).map(w => w.name)))];
 }
-/** The workers switched on by an allow-list; empty means every worker. */
-export function allowedWorkers(allow, workers) {
+/** The workers switched on by an allow-list; empty means every worker. A worker that did not exist when the list was last written (absent from `known`) counts as on. */
+export function allowedWorkers(allow, workers, known = []) {
     if (!allow.length)
         return workers.map(w => w.name);
     const on = new Set(migrateAllow(allow, workers));
-    return workers.filter(w => on.has(w.name)).map(w => w.name);
+    return workers.filter(w => on.has(w.name) || known.length > 0 && !known.includes(w.name)).map(w => w.name);
 }
-/** Switches one worker; every worker on again is stored as [], and the last one cannot go off. */
-export function toggleAllow(allow, name, workers) {
-    const on = allowedWorkers(allow, workers);
+/** Switches one worker; every worker on again is stored as [], and the last one cannot go off. `known` is the allow-list keys the writer knew. */
+export function toggleAllow(allow, name, workers, known = []) {
+    const on = allowedWorkers(allow, workers, known);
     const next = on.includes(name) ? on.filter(n => n !== name) : workers.filter(w => w.name === name || on.includes(w.name)).map(w => w.name);
     if (!next.length)
         return [...allow];
@@ -175,10 +175,11 @@ export function toggleAllow(allow, name, workers) {
 }
 /**
  * Whether a stored model is ticked: its key (an agent name, or `general-purpose:<model>`) or, for
- * settings from before 2026-10-10, its provider is listed; an empty list ticks every model.
+ * settings from before 2026-10-10, its provider is listed; an empty list ticks every model. A key
+ * absent from a non-empty `known` list (a worker added after the list was last written) ticks on.
  */
-export function isAllowed(key, provider, allow) {
-    return !allow.length || allow.includes(key) || allow.includes(provider);
+export function isAllowed(key, provider, allow, known = []) {
+    return !allow.length || allow.includes(key) || allow.includes(provider) || known.length > 0 && !known.includes(key);
 }
 /** The design ladder every save stored until 2026-10-12: Claude, Sonnet then Opus. */
 const RETIRED_DESIGN = JSON.stringify([claude('sonnet', 'medium'), claude('sonnet', 'high'), claude('opus', 'high'), claude('opus', 'high')].map(s => [s.target.agent, s.target.model, s.effort]));
@@ -266,7 +267,8 @@ export function normalizeSettings(raw, workers) {
         rules.general = ladderFromPin(targets, {});
     }
     const ticked = names(Array.isArray(value.allow) ? value.allow : object(stored.general).mode === 'auto' ? object(stored.general).allow : []);
-    const result = { ...DEFAULTS, rules, allow: workers?.length ? migrateAllow(ticked, workers) : ticked, providers: {}, hide: [...DEFAULTS.hide], extras: [...DEFAULTS.extras], fallback: { ...DEFAULTS.fallback } };
+    const savedKnown = names(value.allowKnown);
+    const result = { ...DEFAULTS, rules, allow: workers?.length ? migrateAllow(ticked, workers) : ticked, allowKnown: savedKnown, providers: {}, hide: [...DEFAULTS.hide], extras: [...DEFAULTS.extras], fallback: { ...DEFAULTS.fallback } };
     for (const [name, enabled] of Object.entries(object(value.providers)))
         if (typeof enabled === 'boolean')
             result.providers[name] = enabled;

package/dist/mod/hooks/settings.ts

@@ -26,7 +26,7 @@ export const DEFAULTS: Settings = {
       hard: [{ target: { agent: 'gpt-6-astra' }, effort: 'high' }], plan: [claude('opus', 'high')],
     } },
   },
-  allow: [], modes: [],
+  allow: [], allowKnown: [], modes: [],
   providers: {},
   fallback: { agent: 'general-purpose', model: 'sonnet' },
   keepWarm: false, keepWarmHours: 2, keepWarmMinTokens: 30000,
@@ -159,16 +159,16 @@ export function migrateAllow(allow: readonly string[], workers: readonly Worker[
   return [...new Set(allow.flatMap(entry => agents.has(entry) || !workers.some(w => w.provider === entry) ? [entry] : workers.filter(w => w.provider === entry).map(w => w.name)))]
 }
 
-/** The workers switched on by an allow-list; empty means every worker. */
-export function allowedWorkers(allow: readonly string[], workers: readonly Worker[]): string[] {
+/** The workers switched on by an allow-list; empty means every worker. A worker that did not exist when the list was last written (absent from `known`) counts as on. */
+export function allowedWorkers(allow: readonly string[], workers: readonly Worker[], known: readonly string[] = []): string[] {
   if (!allow.length) return workers.map(w => w.name)
   const on = new Set(migrateAllow(allow, workers))
-  return workers.filter(w => on.has(w.name)).map(w => w.name)
+  return workers.filter(w => on.has(w.name) || known.length > 0 && !known.includes(w.name)).map(w => w.name)
 }
 
-/** Switches one worker; every worker on again is stored as [], and the last one cannot go off. */
-export function toggleAllow(allow: readonly string[], name: string, workers: readonly Worker[]): string[] {
-  const on = allowedWorkers(allow, workers)
+/** Switches one worker; every worker on again is stored as [], and the last one cannot go off. `known` is the allow-list keys the writer knew. */
+export function toggleAllow(allow: readonly string[], name: string, workers: readonly Worker[], known: readonly string[] = []): string[] {
+  const on = allowedWorkers(allow, workers, known)
   const next = on.includes(name) ? on.filter(n => n !== name) : workers.filter(w => w.name === name || on.includes(w.name)).map(w => w.name)
   if (!next.length) return [...allow]
   return next.length === workers.length ? [] : next
@@ -176,10 +176,11 @@ export function toggleAllow(allow: readonly string[], name: string, workers: rea
 
 /**
  * Whether a stored model is ticked: its key (an agent name, or `general-purpose:<model>`) or, for
- * settings from before 2026-10-10, its provider is listed; an empty list ticks every model.
+ * settings from before 2026-10-10, its provider is listed; an empty list ticks every model. A key
+ * absent from a non-empty `known` list (a worker added after the list was last written) ticks on.
  */
-export function isAllowed(key: string, provider: string, allow: readonly string[]): boolean {
-  return !allow.length || allow.includes(key) || allow.includes(provider)
+export function isAllowed(key: string, provider: string, allow: readonly string[], known: readonly string[] = []): boolean {
+  return !allow.length || allow.includes(key) || allow.includes(provider) || known.length > 0 && !known.includes(key)
 }
 
 /** The design ladder every save stored until 2026-10-12: Claude, Sonnet then Opus. */
@@ -262,7 +263,8 @@ export function normalizeSettings(raw: unknown, workers?: readonly Worker[]): Se
     rules.general = ladderFromPin(targets, {})
   }
   const ticked = names(Array.isArray(value.allow) ? value.allow : object(stored.general).mode === 'auto' ? object(stored.general).allow : [])
-  const result: Settings = { ...DEFAULTS, rules, allow: workers?.length ? migrateAllow(ticked, workers) : ticked, providers: {}, hide: [...DEFAULTS.hide], extras: [...DEFAULTS.extras], fallback: { ...DEFAULTS.fallback } }
+  const savedKnown = names(value.allowKnown)
+  const result: Settings = { ...DEFAULTS, rules, allow: workers?.length ? migrateAllow(ticked, workers) : ticked, allowKnown: savedKnown, providers: {}, hide: [...DEFAULTS.hide], extras: [...DEFAULTS.extras], fallback: { ...DEFAULTS.fallback } }
   for (const [name, enabled] of Object.entries(object(value.providers))) if (typeof enabled === 'boolean') result.providers[name] = enabled
   for (const key of ['effortAuto', 'keepWarm', 'setupDone', 'swampAlert'] as const) if (typeof value[key] === 'boolean') result[key] = value[key]
   if (Array.isArray(value.extras)) result.extras = [...new Set(value.extras.filter((part): part is string => typeof part === 'string' && EXTRAS.includes(part)))]

package/dist/mod/hooks/ui/alerts.tsx

@@ -114,6 +114,15 @@ function cardOf(frame: Frame, alert: AlertView, a: AlertActions): Card {
         main: { ...compact, onPress: () => a.compact(alert.draft) },
         close: cancel,
       }
+    case 'clear':
+      return {
+        key: 'clear',
+        face: 'asking',
+        title: t(L, 'alerts.clearTitle'),
+        body: t(L, 'alerts.clearBody'),
+        main: { key: 'clear-go', label: t(L, 'alerts.clearGo'), hotkey: 'g', onPress: a.clear },
+        close: cancel,
+      }
     case 'handoffChoice':
       return {
         key: 'handoff',
@@ -222,6 +231,7 @@ function seaOf(card: Card, alert: AlertView): Omit<Sea, 'at'> {
     case 'judge':
       return { tone: 'red', weather: 'static' }
     case 'note':
+    case 'clear':
     case 'handoff':
       return { tone: 'violet', weather: 'sparkles', ripples: 'calm' }
     default: {