clauderipple 0.9.1 → 0.9.2

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.9.2 — 2026-10-14
+
+### Added
+
+- **The mod shows when keep-warm held your cache.** A successful ping used to be silent, so it was
+  easy to think keep-warm never ran. When you come back, a card now says how many pings kept how
+  many tokens in cache and how long is left. It goes when you send a prompt or close it, and the
+  cold-cache card takes over if the cache expires after all.
+- **Keep-warm per chat.** The band's flame now turns keep-warm on or off for that chat only: a full
+  flame where it is on, an empty one where it is off. Settings is what a new chat starts with.
+  After a restart or resume, a chat follows Settings again.
+
+- **Grok through a Grok subscription.** A new "Grok subscription" provider uses Grok 4.7, 4.7
+  Fast, 4.6 and 4.5 with the Grok CLI's own sign-in (`grok login`), with no API key. It reads the
+  CLI's session and, when the session is about to expire, has the CLI refresh it. Tools,
+  thinking and effort (low…xhigh, per model) work as on the other translated providers. This
+  is the channel the Grok CLI itself talks to, not a published xAI API, so a CLI update can
+  change it. Pay-per-token access with an xAI API key stays under the xAI preset. Thanks @nakjiya (#52).
+
+### Fixed
+
+- An OpenAI-compatible provider's error that echoed the bare token, without its `Bearer` scheme,
+  could show it in the error message. It is now redacted like the full header value (#52).
+- On a two-line mod card, 리플이 sat on the title's line; it now sits at the card's middle.
+
 ## 0.9.1 — 2026-10-14
 
 ### Added

package/README.es.md

@@ -552,6 +552,7 @@ compatible con Anthropic que hayas configurado está disponible de la misma form
 |---|---|---|---|---|
 | Suscripción de ChatGPT | Backend de Codex | varios inicios de sesión, con cambio cuando uno se agota (también reutiliza el de Codex) | leída de tu suscripción (GPT-6 Sol, Luna, Astra, GPT-5.6 …) | esfuerzo low…max (Luna: ultra), caché de prompts 94–99 % |
 | Google Gemini | API de Gemini | clave de API de AI Studio o inicio de sesión con cuenta de Google (Antigravity, consulta las preguntas frecuentes) | descubierta | traducido (Messages ⇄ generateContent), las firmas de pensamiento se conservan entre turnos |
+| Suscripción de Grok | proxy de chat de la CLI de Grok | el inicio de sesión de la CLI de Grok (`grok login`), renovado por la CLI | leída de tu suscripción (Grok 4.7, 4.7 Fast, 4.6, 4.5) | traducido (Chat Completions), esfuerzo low…xhigh; canal propio de la CLI, no una API publicada ([§4e](docs/ARCHITECTURE.md#4e-grok-providers-implemented-2026-10-08)) |
 | OpenRouter | Compatible con Anthropic | clave de API | más de 400, descubierta | compatibilidad de esfuerzo por modelo leída de la API |
 | DeepSeek, Kimi, Z.ai GLM, MiniMax, Qwen (intl / cn) | Compatible con Anthropic | clave de API | predefinida | verificado con la documentación del proveedor |
 | xAI Grok, Mistral, Groq, Together, Fireworks | Compatible con OpenAI | clave de API | descubierta | traducido (Chat Completions / Responses) |

package/README.ja.md

@@ -321,6 +321,7 @@ ClaudeのモデルはCodexのモデル一覧にそれぞれの名前で表示さ
 |---|---|---|---|---|
 | ChatGPTサブスクリプション | Codexバックエンド | 複数ログイン、上限で自動切り替え（Codexのログインも再利用） | サブスクリプションから取得（GPT-6 Sol、Luna、Astra、GPT-5.6 …） | 推論強度 low…max（Lunaはultra）、プロンプトキャッシュ 94–99 % |
 | Google Gemini | Gemini API | AI StudioのAPIキー、またはGoogleアカウントでのログイン（Antigravity、FAQ参照） | 自動検出 | 変換（Messages ⇄ generateContent）、thought signatureをターン間で保持 |
+| Grokサブスクリプション | Grok CLIのチャットプロキシ | Grok CLIのログイン（`grok login`）、更新はCLIが行う | サブスクリプションから取得（Grok 4.7、4.7 Fast、4.6、4.5） | 変換（Chat Completions）、推論強度 low…xhigh。公開APIではなくCLI専用の経路（[§4e](docs/ARCHITECTURE.md#4e-grok-providers-implemented-2026-10-08)） |
 | OpenRouter | Anthropic互換 | APIキー | 400以上、自動検出 | モデルごとの推論強度への対応をAPIから取得 |
 | DeepSeek、Kimi、Z.ai GLM、MiniMax、Qwen（国際版 / 中国版） | Anthropic互換 | APIキー | プリセット | ベンダーのドキュメントで確認済み |
 | xAI Grok、Mistral、Groq、Together、Fireworks | OpenAI互換 | APIキー | 自動検出 | 変換（Chat Completions / Responses） |

package/README.ko.md

@@ -449,6 +449,7 @@ Anthropic API 키로 갑니다. 구독 로그인 재사용은 Anthropic 약관
 |---|---|---|---|---|
 | ChatGPT 구독 | Codex 백엔드 | 로그인 여러 개, 한도 차면 자동 전환(Codex 로그인도 재사용) | 구독에서 자동으로 읽음(GPT-6 Sol·Luna·Astra, GPT-5.6 …) | 추론 강도 low…max(Luna는 ultra), 프롬프트 캐시 94~99 % |
 | Google Gemini | Gemini API | AI Studio API 키, 또는 Google 계정 로그인(Antigravity, 위 FAQ 참고) | 자동 검색 | 번역(Messages ⇄ generateContent), 턴 사이 thought signature 유지 |
+| Grok 구독 | Grok CLI 채팅 프록시 | Grok CLI 로그인(`grok login`), 갱신은 CLI가 함 | 구독에서 자동으로 읽음(Grok 4.7, 4.7 Fast, 4.6, 4.5) | 번역(Chat Completions), 추론 강도 low…xhigh. 공개 API가 아닌 CLI 전용 채널([§4e](docs/ARCHITECTURE.md#4e-grok-providers-implemented-2026-10-08)) |
 | OpenRouter | Anthropic 호환 | API 키 | 400+, 자동 검색 | 모델별 추론 강도 지원을 API에서 읽음 |
 | DeepSeek, Kimi, Z.ai GLM, MiniMax, Qwen(국제/중국) | Anthropic 호환 | API 키 | 프리셋 | 벤더 공식 문서로 확인 |
 | xAI Grok, Mistral, Groq, Together, Fireworks | OpenAI 호환 | API 키 | 자동 검색 | 번역(Chat Completions / Responses) |

package/README.md

@@ -527,6 +527,7 @@ provider you configured is available the same way.
 |---|---|---|---|---|
 | ChatGPT subscription | Codex backend | several sign-ins, switching when one runs out (Codex login reused too) | read from your subscription (GPT-6 Sol, Luna, Astra, GPT-5.6 …) | effort low…max (Luna: ultra), prompt cache 94–99 % |
 | Google Gemini | Gemini API | AI Studio API key, or Google account sign-in (Antigravity, see the FAQ) | discovered | translated (Messages ⇄ generateContent), thought signatures kept across turns |
+| Grok subscription | Grok CLI chat proxy | the Grok CLI's sign-in (`grok login`), refreshed through the CLI | read from your subscription (Grok 4.7, 4.7 Fast, 4.6, 4.5) | translated (Chat Completions), effort low…xhigh; the CLI's own channel, not a published API ([§4e](docs/ARCHITECTURE.md#4e-grok-providers-implemented-2026-10-08)) |
 | OpenRouter | Anthropic-compatible | API key | 400+, discovered | per-model effort support read from the API |
 | DeepSeek, Kimi, Z.ai GLM, MiniMax, Qwen (intl / cn) | Anthropic-compatible | API key | preset | verified against vendor docs |
 | xAI Grok, Mistral, Groq, Together, Fireworks | OpenAI-compatible | API key | discovered | translated (Chat Completions / Responses) |

package/README.pt-BR.md

@@ -539,6 +539,7 @@ que você tenha configurado fica disponível da mesma forma.
 |---|---|---|---|---|
 | Assinatura do ChatGPT | backend do Codex | vários logins, trocando quando um se esgota (o login do Codex também é reaproveitado) | lida da sua assinatura (GPT-6 Sol, Luna, Astra, GPT-5.6 …) | esforço low…max (Luna: ultra), cache de prompt 94–99% |
 | Google Gemini | API Gemini | chave de API do AI Studio, ou login com conta do Google (Antigravity, veja as Perguntas frequentes) | descoberta automática | traduzido (Messages ⇄ generateContent), thought signatures mantidas entre turnos |
+| Assinatura do Grok | proxy de chat da CLI do Grok | o login da CLI do Grok (`grok login`), renovado pela CLI | lida da sua assinatura (Grok 4.7, 4.7 Fast, 4.6, 4.5) | traduzido (Chat Completions), esforço low…xhigh; canal próprio da CLI, não uma API publicada ([§4e](docs/ARCHITECTURE.md#4e-grok-providers-implemented-2026-10-08)) |
 | OpenRouter | compatível com Anthropic | chave de API | mais de 400, descoberta automática | suporte a esforço por modelo lido da API |
 | DeepSeek, Kimi, Z.ai GLM, MiniMax, Qwen (intl / cn) | compatível com Anthropic | chave de API | preset | conferido com a documentação do fornecedor |
 | xAI Grok, Mistral, Groq, Together, Fireworks | compatível com OpenAI | chave de API | descoberta automática | traduzido (Chat Completions / Responses) |

package/README.zh-CN.md

@@ -322,6 +322,7 @@ Claude 模型会以各自的名称出现在 Codex 的模型列表中（ClaudeRip
 |---|---|---|---|---|
 | ChatGPT 订阅 | Codex 后端 | 可登录多个账号，一个用尽自动切换（也会复用 Codex 登录） | 从你的订阅读取（GPT-6 Sol、Luna、Astra、GPT-5.6 …） | 推理强度 low…max（Luna：ultra），提示缓存 94–99 % |
 | Google Gemini | Gemini API | AI Studio API 密钥，或 Google 账号登录（Antigravity，见[常见问题](#通过-google-账号使用-gemini-呢)） | 自动发现 | 格式转换（Messages ⇄ generateContent），跨轮次保留思维签名（thought signatures） |
+| Grok 订阅 | Grok CLI 聊天代理 | Grok CLI 的登录（`grok login`），由 CLI 刷新 | 从你的订阅读取（Grok 4.7、4.7 Fast、4.6、4.5） | 格式转换（Chat Completions），推理强度 low…xhigh；CLI 自己的通道，不是公开 API（[§4e](docs/ARCHITECTURE.md#4e-grok-providers-implemented-2026-10-08)） |
 | OpenRouter | Anthropic 兼容 | API 密钥 | 400+，自动发现 | 从 API 读取各模型对推理强度的支持情况 |
 | DeepSeek、Kimi、Z.ai GLM、MiniMax、Qwen（国际版 / 国内版） | Anthropic 兼容 | API 密钥 | 预设 | 已对照厂商文档验证 |
 | xAI Grok、Mistral、Groq、Together、Fireworks | OpenAI 兼容 | API 密钥 | 自动发现 | 格式转换（Chat Completions / Responses） |

package/dist/app/package.json

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

package/dist/cli/src/index.js

@@ -20,6 +20,7 @@ import { applyAppProxy, caTrusted, currentAppProxy, nssDb, removeAppProxy, trust
 import { runtime } from "./runtime.js";
 import { codexOff, codexOn } from "./codex.js";
 import { ingressModels } from "../../router/src/ingress/models.js";
+import { GROK_DEFAULT_URL } from "../../router/src/providers/grok/catalog.js";
 import { claudeLogin, claudeLogout, desktopClaudeCodeDirs } from "./claude-auth.js";
 import { openBrowser } from "./browser.js";
 import { electronPath, installTrayRuntime, startTray } from "./tray.js";
@@ -315,7 +316,7 @@ async function status() {
     const p = await probe({ host: cfg.listen.host, port: cfg.listen.port, caPem: caPath, upstream: cfg.upstream });
     rows.push(["probe", `${p.ok ? "ok" : "FAIL"}: ${p.detail} (${p.ms}ms)`]);
     for (const [name, p2] of Object.entries(cfg.providers)) {
-        const providerUrl = p2.type === "chatgpt" ? (p2.url ?? "https://chatgpt.com") : p2.type === "anthropic" ? "https://api.anthropic.com" : p2.type === "google" ? (p2.url ?? "https://generativelanguage.googleapis.com") : p2.url;
+        const providerUrl = p2.type === "chatgpt" ? (p2.url ?? "https://chatgpt.com") : p2.type === "anthropic" ? "https://api.anthropic.com" : p2.type === "google" ? (p2.url ?? "https://generativelanguage.googleapis.com") : p2.type === "grok" ? (p2.url ?? GROK_DEFAULT_URL) : p2.url;
         const u = new URL(providerUrl);
         rows.push([`provider ${name}`, await tcpCheck(u.hostname, Number(u.port) || (u.protocol === "https:" ? 443 : 80))]);
     }

package/dist/mod/hooks/i18n.ts

@@ -70,6 +70,7 @@ const EN = {
   'band.hit': 'hit {percent}%',
   'band.effortAutoAlt': 'Effort Auto {state}',
   'band.warmAlt': 'Keep cache warm {state}',
+  'band.warmHere': 'this chat only; new chats follow Settings',
   'band.handoffAdvised': 'Handoff (advised: a fresh chat pays now)',
   'band.closeLog': 'Close the request log',
   'band.openLog': 'Open the request log',
@@ -90,6 +91,9 @@ const EN = {
   // Alerts.
   'alerts.coldTitle': 'The cache went cold',
   'alerts.coldBody': 'It sat {minutes} min, so the next prompt re-reads all {tokens} tokens at full price.',
+  'alerts.keptTitle': 'Cache kept warm while you were away',
+  'alerts.keptBody': '{pings} ping(s) held {tokens} tokens in cache, so your next prompt reads them at the cached rate. {minutes} min left.',
+  'alerts.gotIt': 'Got it',
   'alerts.swampTitle': 'Context {percent}% full',
   'alerts.swampBody': '{tokens} tokens ride along with every prompt: slower, dearer, blurrier.',
   'alerts.hotTitle': '{window} limit at {percent}%',
@@ -347,12 +351,12 @@ const EN = {
   'toasts.workerMissing': '{name} is not installed',
   // Commands (stats and debug labels included).
   'commands.description': 'ClaudeRipple effort, workers, cache and session tools',
-  'commands.argumentHint': 'settings|setup|auto|warm|save|handoff [full]|stats|debug|agents|log|bar|cold|swamp|hot|down',
+  'commands.argumentHint': 'settings|setup|auto|warm|save|handoff [full]|stats|debug|agents|log|bar|cold|swamp|hot|down|kept',
   'commands.logDescription': 'Open or close the ClaudeRipple request log',
   'commands.barDescription': 'Show or hide the ClaudeRipple band',
   'commands.logTitle': 'ClaudeRipple',
   'commands.agentsTitle': 'ClaudeRipple Agents',
-  'commands.help': 'ClaudeRipple: settings, setup, auto, warm, save, handoff [full], stats, debug, agents, log, bar, cold, swamp, hot, down.',
+  'commands.help': 'ClaudeRipple: settings, setup, auto, warm, save, handoff [full], stats, debug, agents, log, bar, cold, swamp, hot, down, kept.',
   'commands.done': 'ClaudeRipple: {command}.',
   'commands.logOpened': 'ClaudeRipple log opened.',
   'commands.logClosed': 'ClaudeRipple log closed.',
@@ -515,6 +519,7 @@ const KO: Record<Key, string> = {
   'band.hit': '적중 {percent}%',
   'band.effortAutoAlt': '추론 강도 자동 {state}',
   'band.warmAlt': '캐시 유지 {state}',
+  'band.warmHere': '이 세션만 적용, 새 세션은 설정을 따릅니다',
   'band.handoffAdvised': '인수인계 (권장: 지금은 새 대화가 더 효율적입니다)',
   'band.closeLog': '요청 로그 닫기',
   'band.openLog': '요청 로그 열기',
@@ -535,6 +540,9 @@ const KO: Record<Key, string> = {
   // Alerts.
   'alerts.coldTitle': '캐시가 만료되었습니다',
   'alerts.coldBody': '{minutes}분 동안 대기하여 캐시가 만료되었습니다. 다음 프롬프트는 {tokens} 토큰 전체를 새로 읽어 비용이 발생합니다.',
+  'alerts.keptTitle': '자리를 비운 동안 캐시를 유지했습니다',
+  'alerts.keptBody': '핑 {pings}회로 {tokens} 토큰을 캐시에 붙잡아 두었습니다. 다음 프롬프트도 캐시로 읽습니다. 만료까지 {minutes}분 남았습니다.',
+  'alerts.gotIt': '확인',
   'alerts.swampTitle': '컨텍스트 {percent}% 사용',
   'alerts.swampBody': '프롬프트마다 {tokens} 토큰이 함께 전송되어 응답 속도와 정확도, 비용에 영향을 줍니다.',
   'alerts.hotTitle': '{window} 한도 {percent}% 도달',
@@ -792,12 +800,12 @@ const KO: Record<Key, string> = {
   'toasts.workerMissing': '{name} 에이전트 미설치',
   // Commands (stats and debug labels included).
   'commands.description': 'ClaudeRipple 추론 강도, 워커, 캐시 및 세션 도구',
-  'commands.argumentHint': 'settings|setup|auto|warm|save|handoff [full]|stats|debug|agents|log|bar|cold|swamp|hot|down',
+  'commands.argumentHint': 'settings|setup|auto|warm|save|handoff [full]|stats|debug|agents|log|bar|cold|swamp|hot|down|kept',
   'commands.logDescription': 'ClaudeRipple 요청 로그 열기/닫기',
   'commands.barDescription': 'ClaudeRipple 상태 바 표시/숨기기',
   'commands.logTitle': 'ClaudeRipple',
   'commands.agentsTitle': 'ClaudeRipple 에이전트',
-  'commands.help': 'ClaudeRipple 하위 명령: settings, setup, auto, warm, save, handoff [full], stats, debug, agents, log, bar, cold, swamp, hot, down.',
+  'commands.help': 'ClaudeRipple 하위 명령: settings, setup, auto, warm, save, handoff [full], stats, debug, agents, log, bar, cold, swamp, hot, down, kept.',
   'commands.done': 'ClaudeRipple: {command} 완료.',
   'commands.logOpened': 'ClaudeRipple 로그를 열었습니다.',
   'commands.logClosed': 'ClaudeRipple 로그를 닫았습니다.',
@@ -958,6 +966,7 @@ const ZH: Record<Key, string> = {
   'band.hit': '命中 {percent}%',
   'band.effortAutoAlt': '推理强度自动{state}',
   'band.warmAlt': '缓存保温{state}',
+  'band.warmHere': '仅限本会话，新会话按设置',
   'band.handoffAdvised': '交接（建议：现在换新对话更划算）',
   'band.closeLog': '关闭请求日志',
   'band.openLog': '打开请求日志',
@@ -978,6 +987,9 @@ const ZH: Record<Key, string> = {
   // Alerts.
   'alerts.coldTitle': '缓存已过期',
   'alerts.coldBody': '闲置了 {minutes} 分钟，下一条提示词会按全价重读全部 {tokens} token。',
+  'alerts.keptTitle': '您离开期间缓存已保持温热',
+  'alerts.keptBody': '保温 ping {pings} 次，把 {tokens} token 留在了缓存里，下一条提示词仍按缓存价读取。还有 {minutes} 分钟过期。',
+  'alerts.gotIt': '知道了',
   'alerts.swampTitle': '上下文已用 {percent}%',
   'alerts.swampBody': '每条提示词都带着 {tokens} token：更慢、更贵、更模糊。',
   'alerts.hotTitle': '{window}限额已达 {percent}%',
@@ -1235,12 +1247,12 @@ const ZH: Record<Key, string> = {
   'toasts.workerMissing': '未安装 {name}',
   // Commands (stats and debug labels included).
   'commands.description': 'ClaudeRipple 推理强度、Worker、缓存与会话工具',
-  'commands.argumentHint': 'settings|setup|auto|warm|save|handoff [full]|stats|debug|agents|log|bar|cold|swamp|hot|down',
+  'commands.argumentHint': 'settings|setup|auto|warm|save|handoff [full]|stats|debug|agents|log|bar|cold|swamp|hot|down|kept',
   'commands.logDescription': '打开或关闭 ClaudeRipple 请求日志',
   'commands.barDescription': '显示或隐藏 ClaudeRipple 状态栏',
   'commands.logTitle': 'ClaudeRipple',
   'commands.agentsTitle': 'ClaudeRipple 代理',
-  'commands.help': 'ClaudeRipple 子命令：settings, setup, auto, warm, save, handoff [full], stats, debug, agents, log, bar, cold, swamp, hot, down.',
+  'commands.help': 'ClaudeRipple 子命令：settings, setup, auto, warm, save, handoff [full], stats, debug, agents, log, bar, cold, swamp, hot, down, kept.',
   'commands.done': 'ClaudeRipple: {command}.',
   'commands.logOpened': '已打开 ClaudeRipple 日志。',
   'commands.logClosed': '已关闭 ClaudeRipple 日志。',
@@ -1401,6 +1413,7 @@ const JA: Record<Key, string> = {
   'band.hit': 'ヒット {percent}%',
   'band.effortAutoAlt': '推論強度の自動 {state}',
   'band.warmAlt': 'キャッシュ保持 {state}',
+  'band.warmHere': 'このチャットだけ。新しいチャットは設定に従います',
   'band.handoffAdvised': '引き継ぎ（推奨: 今は新しい会話のほうが得です）',
   'band.closeLog': 'リクエストログを閉じる',
   'band.openLog': 'リクエストログを開く',
@@ -1421,6 +1434,9 @@ const JA: Record<Key, string> = {
   // Alerts.
   'alerts.coldTitle': 'キャッシュの期限が切れました',
   'alerts.coldBody': '{minutes} 分止まっていたので、次のプロンプトで {tokens} トークンを定価で読み直します。',
+  'alerts.keptTitle': '不在中もキャッシュを温かいまま保ちました',
+  'alerts.keptBody': 'キープウォームが {pings} 回、{tokens} トークンをキャッシュに保持しました。次のプロンプトもキャッシュで読めます。期限まで {minutes} 分です。',
+  'alerts.gotIt': '了解',
   'alerts.swampTitle': 'コンテキスト {percent}% 使用中',
   'alerts.swampBody': 'プロンプトごとに {tokens} トークンが付いていき、遅く・高く・曖昧になります。',
   'alerts.hotTitle': '{window}上限の {percent}% に到達',
@@ -1678,12 +1694,12 @@ const JA: Record<Key, string> = {
   'toasts.workerMissing': '{name} がインストールされていません',
   // Commands (stats and debug labels included).
   'commands.description': 'ClaudeRipple の推論強度、ワーカー、キャッシュ、セッションツール',
-  'commands.argumentHint': 'settings|setup|auto|warm|save|handoff [full]|stats|debug|agents|log|bar|cold|swamp|hot|down',
+  'commands.argumentHint': 'settings|setup|auto|warm|save|handoff [full]|stats|debug|agents|log|bar|cold|swamp|hot|down|kept',
   'commands.logDescription': 'ClaudeRipple のリクエストログを開閉',
   'commands.barDescription': 'ClaudeRipple のバーを表示・非表示',
   'commands.logTitle': 'ClaudeRipple',
   'commands.agentsTitle': 'ClaudeRipple エージェント',
-  'commands.help': 'ClaudeRipple のサブコマンド: settings, setup, auto, warm, save, handoff [full], stats, debug, agents, log, bar, cold, swamp, hot, down.',
+  'commands.help': 'ClaudeRipple のサブコマンド: settings, setup, auto, warm, save, handoff [full], stats, debug, agents, log, bar, cold, swamp, hot, down, kept.',
   'commands.done': 'ClaudeRipple: {command}.',
   'commands.logOpened': 'ClaudeRipple のログを開きました。',
   'commands.logClosed': 'ClaudeRipple のログを閉じました。',
@@ -1844,6 +1860,7 @@ const ES: Record<Key, string> = {
   'band.hit': 'acierto {percent}%',
   'band.effortAutoAlt': 'Esfuerzo auto {state}',
   'band.warmAlt': 'Mantener la caché caliente {state}',
+  'band.warmHere': 'solo este chat; los nuevos siguen los Ajustes',
   'band.handoffAdvised': 'Traspaso (recomendado: ahora conviene una conversación nueva)',
   'band.closeLog': 'Cerrar el registro de solicitudes',
   'band.openLog': 'Abrir el registro de solicitudes',
@@ -1864,6 +1881,9 @@ const ES: Record<Key, string> = {
   // Alerts.
   'alerts.coldTitle': 'La caché se enfrió',
   'alerts.coldBody': 'Estuvo {minutes} min parada, así que el próximo prompt relee sus {tokens} tokens a precio completo.',
+  'alerts.keptTitle': 'La caché se mantuvo caliente mientras no estabas',
+  'alerts.keptBody': '{pings} ping(s) mantuvieron {tokens} tokens en caché, así que tu próximo prompt los lee al precio en caché. Quedan {minutes} min.',
+  'alerts.gotIt': 'Entendido',
   'alerts.swampTitle': 'Contexto al {percent}%',
   'alerts.swampBody': '{tokens} tokens viajan con cada prompt: más lento, más caro, más difuso.',
   'alerts.hotTitle': 'Límite {window} al {percent}%',
@@ -2121,12 +2141,12 @@ const ES: Record<Key, string> = {
   'toasts.workerMissing': '{name} no está instalado',
   // Commands (stats and debug labels included).
   'commands.description': 'Esfuerzo, workers, caché y herramientas de sesión de ClaudeRipple',
-  'commands.argumentHint': 'settings|setup|auto|warm|save|handoff [full]|stats|debug|agents|log|bar|cold|swamp|hot|down',
+  'commands.argumentHint': 'settings|setup|auto|warm|save|handoff [full]|stats|debug|agents|log|bar|cold|swamp|hot|down|kept',
   'commands.logDescription': 'Abre o cierra el registro de solicitudes de ClaudeRipple',
   'commands.barDescription': 'Muestra u oculta la barra de ClaudeRipple',
   'commands.logTitle': 'ClaudeRipple',
   'commands.agentsTitle': 'Agentes de ClaudeRipple',
-  'commands.help': 'Subcomandos de ClaudeRipple: settings, setup, auto, warm, save, handoff [full], stats, debug, agents, log, bar, cold, swamp, hot, down.',
+  'commands.help': 'Subcomandos de ClaudeRipple: settings, setup, auto, warm, save, handoff [full], stats, debug, agents, log, bar, cold, swamp, hot, down, kept.',
   'commands.done': 'ClaudeRipple: {command}.',
   'commands.logOpened': 'Registro de ClaudeRipple abierto.',
   'commands.logClosed': 'Registro de ClaudeRipple cerrado.',
@@ -2287,6 +2307,7 @@ const PT: Record<Key, string> = {
   'band.hit': 'acerto {percent}%',
   'band.effortAutoAlt': 'Esforço auto {state}',
   'band.warmAlt': 'Manter o cache quente {state}',
+  'band.warmHere': 'só esta conversa; as novas seguem as Configurações',
   'band.handoffAdvised': 'Repasse (recomendado: agora uma conversa nova compensa)',
   'band.closeLog': 'Fechar o log de requisições',
   'band.openLog': 'Abrir o log de requisições',
@@ -2307,6 +2328,9 @@ const PT: Record<Key, string> = {
   // Alerts.
   'alerts.coldTitle': 'O cache esfriou',
   'alerts.coldBody': 'Ficou parada {minutes} min, então o próximo prompt relê os {tokens} tokens pelo preço cheio.',
+  'alerts.keptTitle': 'O cache ficou quente enquanto você esteve fora',
+  'alerts.keptBody': '{pings} ping(s) seguraram {tokens} tokens no cache, então o próximo prompt os lê pelo preço em cache. Faltam {minutes} min.',
+  'alerts.gotIt': 'Entendi',
   'alerts.swampTitle': 'Contexto {percent}% cheio',
   'alerts.swampBody': '{tokens} tokens vão junto com cada prompt: mais lento, mais caro, mais confuso.',
   'alerts.hotTitle': 'Limite {window} em {percent}%',
@@ -2564,12 +2588,12 @@ const PT: Record<Key, string> = {
   'toasts.workerMissing': '{name} não está instalado',
   // Commands (stats and debug labels included).
   'commands.description': 'Esforço, workers, cache e ferramentas de sessão do ClaudeRipple',
-  'commands.argumentHint': 'settings|setup|auto|warm|save|handoff [full]|stats|debug|agents|log|bar|cold|swamp|hot|down',
+  'commands.argumentHint': 'settings|setup|auto|warm|save|handoff [full]|stats|debug|agents|log|bar|cold|swamp|hot|down|kept',
   'commands.logDescription': 'Abre ou fecha o log de requisições do ClaudeRipple',
   'commands.barDescription': 'Mostra ou oculta a barra do ClaudeRipple',
   'commands.logTitle': 'ClaudeRipple',
   'commands.agentsTitle': 'Agentes do ClaudeRipple',
-  'commands.help': 'Subcomandos do ClaudeRipple: settings, setup, auto, warm, save, handoff [full], stats, debug, agents, log, bar, cold, swamp, hot, down.',
+  'commands.help': 'Subcomandos do ClaudeRipple: settings, setup, auto, warm, save, handoff [full], stats, debug, agents, log, bar, cold, swamp, hot, down, kept.',
   'commands.done': 'ClaudeRipple: {command}.',
   'commands.logOpened': 'Log do ClaudeRipple aberto.',
   'commands.logClosed': 'Log do ClaudeRipple fechado.',

package/dist/mod/hooks/register.tsx

@@ -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, saveUntil as limitSaveUntil, swampAlert, swamped } from './session'
+import { bandPriority, 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'
@@ -48,6 +48,7 @@ const lastSpawn = atom({ plugin: 'ripple', key: 'lastSpawn' } as const, null)
 const agents = atom({ plugin: 'ripple', key: 'agents' } as const, [])
 const cache = atom({ plugin: 'ripple', key: 'cache' } as const, null)
 const warm = atom({ plugin: 'ripple', key: 'warm' } as const, { pings: 0, cost: 0 })
+const warmHere = atom({ plugin: 'ripple', key: 'warmHere' } as const, null)
 const lastRealReplyAt = atom({ plugin: 'ripple', key: 'lastRealReplyAt' } as const, null)
 const context = atom({ plugin: 'ripple', key: 'context' } as const, null)
 const hot = atom({ plugin: 'ripple', key: 'hot' } as const, null)
@@ -56,6 +57,7 @@ const hotHidden = atom({ plugin: 'ripple', key: 'hotHidden' } as const, null)
 const saveUntil = atom({ plugin: 'ripple', key: 'saveUntil' } as const, null)
 const swampHidden = atom({ plugin: 'ripple', key: 'swampHidden' } as const, null)
 const coldHidden = atom({ plugin: 'ripple', key: 'coldHidden' } as const, false)
+const kept = atom({ plugin: 'ripple', key: 'kept' } as const, null)
 const judgeDown = atom({ plugin: 'ripple', key: 'judgeDown' } as const, null)
 const judgeDownHidden = atom({ plugin: 'ripple', key: 'judgeDownHidden' } as const, null)
 const judgeSeen = atom({ plugin: 'ripple', key: 'judgeSeen' } as const, [])
@@ -233,6 +235,8 @@ async function installSettings($: EngineInterface, s: Settings): Promise<void> {
   try { await registerAuto($, s) } catch (error) { await report($, 'agent register', error) }
   if (!s.effortAuto) await update($, heldPick, () => null)
   if (s.keepWarm && !previous.keepWarm) await update($, warm, value => ({ ...value, stopped: undefined }))
+  // Settings caught up with this chat's own choice: it follows Settings again.
+  if (await read($, warmHere) === s.keepWarm) await update($, warmHere, () => null)
 }
 function settingsSnapshot(text: string): ModSettingsSnapshot {
   const value = object(JSON.parse(text))
@@ -712,9 +716,15 @@ async function toggleAuto($: EngineInterface): Promise<void> {
   const s = await currentSettings($)
   await saveSettings($, { ...s, effortAuto: !s.effortAuto })
 }
+/** The band's flame turns keep-warm on or off for this chat only; Settings is what a new chat starts with. */
+async function keepWarmOn($: EngineInterface, s: Settings): Promise<boolean> {
+  return await read($, warmHere) ?? s.keepWarm
+}
 async function toggleWarm($: EngineInterface): Promise<void> {
   const s = await currentSettings($)
-  await saveSettings($, { ...s, keepWarm: !s.keepWarm })
+  const on = !await keepWarmOn($, s)
+  await update($, warmHere, () => on === s.keepWarm ? null : on)
+  if (on) await update($, warm, value => ({ ...value, stopped: undefined }))
 }
 async function toggleSave($: EngineInterface): Promise<void> {
   const now = await $.clock.now()
@@ -986,7 +996,8 @@ async function tick($: EngineInterface): Promise<void> {
       const answer = await $.model.complete({ model: HAIKU, system: ADVICE_SYSTEM, prompt: queued, effort: 'low', maxTokens: 60, timeoutMs: 8000 })
       if (answer.isAnswered) await update($, advice, () => parseAdvice(answer.text))
     }
-    const s = await currentSettings($)
+    const s = { ...await currentSettings($) }
+    s.keepWarm = await keepWarmOn($, s)
     const decision = shouldPing({ settings: s, memo: await read($, cache), warm: await read($, warm), now: await $.clock.now(), idle: !await read($, busy) && !await read($, deciding) && !forking,
       contextTokens: (await read($, context))?.tokens ?? 0, lastRealReplyAt: await read($, lastRealReplyAt) })
     if (decision.ping) {
@@ -997,6 +1008,15 @@ async function tick($: EngineInterface): Promise<void> {
       const after = afterPing(before, answer, await $.clock.now(), language)
       await update($, warm, () => after)
       if (after.stopped && !before.stopped) await $.ui.toast(t(language, 'toasts.warmStopped', { reason: after.stopped }))
+      // A ping read cache tokens: the cache held while the person was away. One card counts them all
+      // (a real reply or the expiry clears it; register.tsx kept), until then each ping adds up.
+      const usage = answer && 'usage' in answer ? answer.usage : null
+      if ((usage?.cache_read_input_tokens ?? 0) > 0) {
+        await update($, kept, prev => ({
+          pings: (prev?.pings ?? 0) + 1,
+          tokens: usage!.cache_read_input_tokens,
+        }))
+      }
     } else if (s.keepWarm && !await read($, busy) && decision.reason === 'keep warm time bound reached' && !(await read($, warm)).stopped) {
       await update($, warm, value => ({ ...value, stopped: t(language, 'toasts.warmBoundReason') }))
       await $.ui.toast(t(language, 'toasts.warmBound'))
@@ -1025,7 +1045,7 @@ async function dashboard($: EngineInterface, working: boolean): Promise<Dashboar
       mode: await read($, deciding) ? 'deciding' : await read($, paused) ? 'paused' : p?.by === 'manual' ? 'manual' : s.effortAuto ? 'auto' : 'off',
       ...(p?.why ? { why: p.why, by: p.by } : {}), ...(await read($, decidingSince) !== null ? { since: (await read($, decidingSince))! } : {}) },
     model: await read($, modelIs) ? modelName((await read($, modelIs))!) : null,
-    context: await read($, context), cache: await read($, cache), warm: { ...w, on: s.keepWarm },
+    context: await read($, context), cache: await read($, cache), warm: { ...w, on: await keepWarmOn($, s), ...(await read($, warmHere) !== null ? { here: true } : {}) },
     limit: l ? { ...l, save: saving } : null, route: record ? routeOf(record) : null, notice: await read($, line),
     auto: s.effortAuto, handoff: await read($, advice) ? 'advised' : s.handoffButton === 'always' ? 'always' : 'off',
     agents: { live: list.filter(a => ['running', 'waiting'].includes(a.state)).length, total: list.length },
@@ -1056,6 +1076,7 @@ async function alertView($: EngineInterface, now: number): Promise<AlertView | n
   const which = bandPriority({ panel: await read($, panel), judgeDown: d === 'down' || (!!downReason && downReason !== await read($, judgeDownHidden)),
     hot: d === 'hot' || hotAlert(h, await read($, hotHidden)), result: !!writing || !!result,
     cold: d === 'cold' || coldAlert(m, c?.tokens ?? 0, now, await read($, coldHidden)),
+    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 === 'handoff') return { kind: 'handoffChoice', handoffKind: await read($, handoffChoiceKind), after: await read($, handoffChoiceAfter) }
@@ -1068,22 +1089,27 @@ async function alertView($: EngineInterface, now: number): Promise<AlertView | n
     return { kind: 'result', stage, handoffKind: writing.kind, ...(detail ? { detail } : {}) }
   }
   if (which === 'cold') return { kind: 'cold', tokens: d === 'cold' ? 180000 : c!.tokens, idleMinutes: m ? Math.round((now - m.lastReplyAt) / 60000) : 61 }
+  if (which === 'kept') {
+    const k = d === 'kept' ? { pings: 2, tokens: 312000 } : (await read($, kept)) ?? { pings: 0, tokens: 0 }
+    return { kind: 'kept', pings: k.pings, tokens: k.tokens, minutesLeft: Math.ceil(((d === 'kept' ? now + 47 * 60000 : m!.expiresAt) - now) / 60000) }
+  }
   if (which === 'swamp') return { kind: 'swamp', percent: d === 'swamp' ? 65 : c!.percent, tokens: d === 'swamp' ? 160000 : c!.tokens }
   return null
 }
 /**
- * A prompt sent while the cold, heavy or hot band shows counts as having seen it: it comes back
- * only on its own next occasion (the next expiry, 15 more points of context, 10 more of the plan
- * window), never after every message.
+ * A prompt sent while the cold, kept, heavy or hot band shows counts as having seen it: it comes
+ * back only on its own next occasion (the next expiry, one more ping, 15 more points of context,
+ * 10 more of the plan window), never after every message.
  */
 async function markSeen($: EngineInterface): Promise<void> {
   const view = await alertView($, await $.clock.now())
-  if (view && (view.kind === 'cold' || view.kind === 'swamp' || view.kind === 'hot')) await dismiss($, view)
+  if (view && (view.kind === 'cold' || view.kind === 'kept' || view.kind === 'swamp' || view.kind === 'hot')) await dismiss($, view)
 }
 async function dismiss($: EngineInterface, view: AlertView): Promise<void> {
   await update($, demo, () => null)
   if (view.kind === 'hot') await update($, hotHidden, () => view.percent)
   else if (view.kind === 'cold') await update($, coldHidden, () => true)
+  else if (view.kind === 'kept') await update($, kept, () => null)
   else if (view.kind === 'swamp') await update($, swampHidden, () => view.percent)
   else if (view.kind === 'judgeDown') await update($, judgeDownHidden, () => view.reason)
   else if (view.kind === 'result') { await update($, resultCard, () => null); await update($, handoff, () => null) }
@@ -1133,6 +1159,7 @@ async function prepareStep($: EngineInterface, e: TurnStepInput): Promise<TurnSt
     if (previousModel !== null) {
       await update($, cache, () => null)
       await update($, lastRealReplyAt, () => null)
+      if (await read($, kept)) await update($, kept, () => null)
     }
   }
   const safe = isCacheSafeModel(e.model)
@@ -1200,6 +1227,7 @@ export const register: Register = on => {
           await update($, cache, () => null)
           await update($, context, () => null)
           await update($, lastRealReplyAt, () => null)
+          if (await read($, kept)) await update($, kept, () => null)
         }
         if (e.model) await update($, modelIs, () => e.model!)
         await update($, paused, () => e.model ? !isCacheSafeModel(e.model) : false)
@@ -1291,6 +1319,7 @@ export const register: Register = on => {
           const memo = nextMemo(await read($, cache), answer.usage, now)
           await update($, cache, () => memo)
           if (await read($, coldHidden)) await update($, coldHidden, () => false)
+          if (await read($, kept)) await update($, kept, () => null)
           await update($, lastRealReplyAt, () => now)
           if ((await read($, warm)).stopped !== undefined) await update($, warm, value => ({ ...value, stopped: undefined }))
         }
@@ -1403,6 +1432,7 @@ export const register: Register = on => {
       if (!answer.isAnswered || answer.text.trim().length <= 200) throw new Error(t(language, 'toasts.summaryEmpty'))
       await update($, cache, () => null)
       await update($, context, () => null)
+      if (await read($, kept)) await update($, kept, () => null)
       await update($, resultCard, () => ({ stage: 'compacted' }))
       return compactResult(answer.text)
     } catch (error) {
@@ -1425,7 +1455,7 @@ export const register: Register = on => {
       else if (sub === 'log') await toggleLog($)
       else if (sub === 'agents') await toggleAgents($)
       else if (sub === 'bar') await toggleBar($)
-      else if (['cold', 'swamp', 'hot', 'down'].includes(sub)) { await update($, panel, () => null); await update($, demo, () => sub as 'cold' | 'swamp' | 'hot' | 'down') }
+      else if (['cold', 'swamp', 'hot', 'down', 'kept'].includes(sub)) { await update($, panel, () => null); await update($, demo, () => sub as 'cold' | 'swamp' | 'hot' | 'down' | 'kept') }
       else return { text: t(language, 'commands.help') }
       return { text: t(language, 'commands.done', { command: sub }) }
     } catch (error) { await report($, 'ripple command', error); return next(e) }

package/dist/mod/hooks/session.ts

@@ -37,6 +37,14 @@ export function coldAlert(memo: CacheMemo | null, contextTokens: number, now: nu
   return !hidden && memo !== null && memo.expiresAt <= now && contextTokens >= 150000
 }
 
+/**
+ * Keep-warm held the cache while the person was away: at least one ping read cache tokens and the
+ * memo says the cache is still warm. Once it has expired the cold card is the truth, never this.
+ */
+export function keptAlert(kept: { pings: number; tokens: number } | null, memo: CacheMemo | null, now: number): boolean {
+  return kept !== null && kept.pings > 0 && memo !== null && memo.expiresAt > now
+}
+
 export function hotAlert(hot: Hot | null, hidden: number | null): boolean {
   return hot !== null && hot.percent >= 80 && (hidden === null || hot.percent >= hidden + 10)
 }
@@ -54,9 +62,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
-  judgeDown?: boolean; hot?: boolean; result?: boolean; cold?: boolean; swamp?: boolean
-}): 'settings' | 'compact' | 'handoff' | 'setup' | 'judgeDown' | 'hot' | 'result' | 'cold' | 'swamp' | 'dashboard' {
+  judgeDown?: boolean; hot?: boolean; result?: boolean; cold?: boolean; swamp?: boolean; kept?: boolean
+}): 'settings' | 'compact' | 'handoff' | 'setup' | 'judgeDown' | 'hot' | 'result' | 'cold' | 'swamp' | 'kept' | 'dashboard' {
   if (state.panel) return state.panel
-  for (const band of ['judgeDown', 'hot', 'result', 'cold', 'swamp'] as const) if (state[band]) return band
+  for (const band of ['judgeDown', 'hot', 'result', 'cold', 'swamp', 'kept'] as const) if (state[band]) return band
   return 'dashboard'
 }

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

@@ -12,7 +12,7 @@ import { t } from '../i18n'
 import type { RenderNode } from 'claude-code'
 
 import type { HandoffKind, Settings } from '../../types'
-import { CELL_PX, MUTE, SUB, TONE, pillArt } from './art'
+import { CELL_PX, MUTE, ROW_PX, SUB, TONE, pillArt } from './art'
 import type { Sea, Tone } from './art'
 import { capsule, closeButton, pill, ripple, segmented as drawnSegmented, well } from './kit'
 import type { SegmentOption } from './kit'
@@ -61,6 +61,14 @@ function cardOf(frame: Frame, alert: AlertView, a: AlertActions): Card {
         quiet: [handoff],
         close: notNow,
       }
+    case 'kept':
+      return {
+        key: 'kept',
+        face: 'pleased',
+        title: t(L, 'alerts.keptTitle'),
+        body: t(L, 'alerts.keptBody', { pings: alert.pings, tokens: compactNumber(alert.tokens), minutes: alert.minutesLeft }),
+        close: { key: 'dismiss', label: t(L, 'alerts.gotIt'), hotkey: 'x', onPress: a.dismiss },
+      }
     case 'swamp':
       return {
         key: 'swamp',
@@ -205,6 +213,8 @@ function seaOf(card: Card, alert: AlertView): Omit<Sea, 'at'> {
   switch (card.key) {
     case 'cold':
       return { tone: 'ice', weather: 'snow', motes: true }
+    case 'kept':
+      return { tone: 'amber', weather: 'sparkles', ripples: 'calm' }
     case 'swamp':
       return { tone: 'amber', weather: 'bubbles', ripples: 'calm' }
     case 'hot':
@@ -329,7 +339,8 @@ function drawnAlert(el: Els, frame: Frame, alert: AlertView, a: AlertActions): R
     </Box>
   ) : (
     <Box key="top" flexDirection="row" alignItems="flex-start" columnGap={2} width="100%" minWidth={0}>
-      {face}
+      {/* Beside two lines 리플이 sits at their middle, not on the title's line (2026-10-14: it rode high). */}
+      <Box key="face" alignSelf="center" flexShrink={0}>{face}</Box>
       <Box key="say" flexDirection="column" rowGap={1} flexGrow={1} flexShrink={1} minWidth={0}>
         {title}
         {body}
@@ -339,10 +350,12 @@ function drawnAlert(el: Els, frame: Frame, alert: AlertView, a: AlertActions): R
       {actionsBelow ? null : buttons}
     </Box>
   )
+  const rows = oneRow ? 2 : 4 + (more.length ? 3.2 : 0) + (actionsBelow ? 2 : 0) + (frame.columns < 60 ? 3 : 0)
   return capsule(el, frame, {
     key: 'alert-' + card.key,
-    sea: { ...sea, reach: 130, at: { x: 1.5 * CELL_PX + CARD_FACE / 2, y: 0.5 * 19 * 0.5 + CARD_FACE / 2 } },
-    rows: oneRow ? 2 : 4 + (more.length ? 3.2 : 0) + (actionsBelow ? 2 : 0) + (frame.columns < 60 ? 3 : 0),
+    // The light comes from 리플이: on the title's line in one row, at the card's middle beside more.
+    sea: { ...sea, reach: 130, at: { x: 1.5 * CELL_PX + CARD_FACE / 2, y: oneRow ? 0.5 * ROW_PX * 0.5 + CARD_FACE / 2 : rows * ROW_PX / 2 } },
+    rows,
     children: [top],
   })
 }

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

@@ -596,7 +596,7 @@ function controlsDrawn(el: Els, frame: Frame, view: DashboardView, actions: Band
     ? { key: 'auto', cells: toggleCells(autoLabel), node: toggle(el, 'auto', view.auto, autoLabel, actions.toggleAuto, view.effort.mode === 'deciding', tipScope('auto')), tip: autoTip }
     : { key: 'auto', cells: SWITCH_ONLY, node: lit(el, 'auto', SWITCH_ONLY, [pic(el, 'auto', switchArt(view.auto, view.effort.mode === 'deciding'), autoLabel, 36, 22), press(el, 'auto', SWITCH_ONLY * CELL_PX, actions.toggleAuto)], 0.25, tipScope('auto')), tip: autoTip })
   const warmLabel = t(L, 'band.warm')
-  out.push(iconControl(el, 'warm', iconArt('flame', view.warm.on, 'amber'), ICON_PX, warmLabel, t(L, 'band.warmAlt', { state: state(view.warm.on) }) + ' · ' + t(L, 'settings.warmLine'), actions.toggleWarm, words.includes('warm') ? warmLabel : undefined, view.warm.on ? TONE.amber.text : SUB))
+  out.push(iconControl(el, 'warm', iconArt('flame', view.warm.on, 'amber'), ICON_PX, warmLabel, t(L, 'band.warmAlt', { state: state(view.warm.on) }) + ' · ' + t(L, view.warm.here ? 'band.warmHere' : 'settings.warmLine'), actions.toggleWarm, words.includes('warm') ? warmLabel : undefined, view.warm.on ? TONE.amber.text : SUB))
   const agentsLabel = t(L, 'band.agents')
   const live = view.agents.live
   // The live count sits on the icon's shoulder, in one picture of one width: no width change.

package/dist/mod/hooks/ui/view.ts

@@ -65,7 +65,8 @@ export type DashboardView = {
   context: { percent: number; tokens: number; window: number } | null
   /** The last main reply's cache; null when unknown. */
   cache: { expiresAt: number; ttlMs: number } | null
-  warm: { on: boolean; pings: number; cost: number; stopped?: string }
+  /** `here`: this chat differs from Settings, set by the band's flame. */
+  warm: { on: boolean; pings: number; cost: number; stopped?: string; here?: boolean }
   /** The hottest plan window, shown when present. */
   limit: { kind: string; percent: number; resetsAt?: string; save: boolean } | null
   route: RouteView | null
@@ -113,6 +114,8 @@ export type ResultStage = 'handingOff' | 'handoffReady' | 'handoffDone' | 'compa
 export type AlertView =
   /** The cache expired on a big chat: the next prompt re-reads it all. */
   | { kind: 'cold'; tokens: number; idleMinutes: number }
+  /** Keep-warm held the cache while the person was away. */
+  | { kind: 'kept'; pings: number; tokens: number; minutesLeft: number }
   /** Context is heavy. */
   | { kind: 'swamp'; percent: number; tokens: number }
   /** A plan window at or above 80%. */