clauderipple 0.9.0 → 0.9.2

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/judge.ts

@@ -90,7 +90,23 @@ export function verdictObject(text: string): Record<string, unknown> | undefined
       }
     }
   }
-  return undefined
+  return looseVerdictObject(text)
+}
+
+/**
+ * A small judge sometimes breaks its JSON (Haiku answered `…"why":"…","}`, #53). Its complete
+ * `"key": value` pairs still carry the verdict, so they are read one by one; the parsers above
+ * check every field they use, so nothing here is trusted beyond a JSON scalar.
+ */
+function looseVerdictObject(text: string): Record<string, unknown> | undefined {
+  const start = text.indexOf('{')
+  if (start === -1) return undefined
+  const value: Record<string, unknown> = {}
+  const pair = /"(\w+)"\s*:\s*("(?:[^"\\]|\\.)*"|-?\d+(?:\.\d+)?|true|false|null)/g
+  for (const match of text.slice(start).matchAll(pair)) {
+    try { value[match[1]!] ??= JSON.parse(match[2]!) } catch { /* a malformed scalar adds nothing */ }
+  }
+  return Object.keys(value).length ? value : undefined
 }
 
 const effortCriteria = {

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':
@@ -305,8 +315,11 @@ function drawnAlert(el: Els, frame: Frame, alert: AlertView, a: AlertActions): R
   const oneRow = !more.length && faceCells + chOf(card.title) * 1.12 + 2 + chOf(card.body) + 2 + actionCells <= room
   // Too narrow to keep the actions beside the words: they go under them.
   const actionsBelow = !oneRow && room - faceCells - actionCells < 30
+  // Beside a title and a why of two lines, the actions sit at the card's middle, not on the title's
+  // line (2026-10-13: they rode high). Beside the handoff's options they stay by the title, the ×
+  // where a way out is looked for.
   const buttons = (
-    <Box key="actions" flexDirection="row" alignItems="center" columnGap={1} flexShrink={0} flexWrap="wrap" rowGap={1}>
+    <Box key="actions" flexDirection="row" alignItems="center" alignSelf={more.length ? 'flex-start' : 'center'} columnGap={1} flexShrink={0} flexWrap="wrap" rowGap={1}>
       {quiet.map(c => pill(el, c.key, c.label, 'ghost', c.onPress, tone))}
       {main ? pill(el, main.key, main.label, 'primary', main.onPress, tone) : null}
       {card.close ? closeButton(el, card.close.key, card.close.label, card.close.onPress) : null}
@@ -326,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}
@@ -336,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%. */

package/dist/mod/tests/register.test.tsx

@@ -918,6 +918,42 @@ test('keep-warm forks near expiry, refreshes the memo and stops once on a null f
   expect(stats.text).toContain('Warm: 1 pings')
 })
 
+test('a cache-reading ping keeps the card, a real reply and /clear drop it, and the demo draws it', async ($, on) => {
+  const b = boundaries(on, { keepWarm: true })
+  http(on)
+  judgeStub(on)
+  stepStub(on)
+  on('model.fork', () => ({ value: { isAnswered: true, text: 'ok', usage: USAGE } }))
+  await start($)
+  await step($)
+  await complete($)
+  await b.clock.advance(3375000)
+  // The ping read 40000 cache tokens: the card tells it, with the memo's minutes left.
+  const ui = await band($)
+  expect(await ui.find({ type: 'Text', text: /held 40k tokens in cache/ })).toBeDefined()
+  await ui.unmount()
+  // A prompt counts as having seen the card; the next is a real reply, which clears the count.
+  await submit($)
+  await step($)
+  await complete($)
+  const after = await band($)
+  expect(await after.find({ type: 'Text', text: /held 40k tokens in cache/ })).toBeUndefined()
+  await after.unmount()
+  await b.clock.advance(3375000)
+  await b.clock.settle()
+  const again = await band($)
+  expect(await again.find({ type: 'Text', text: /held 40k tokens in cache/ })).toBeDefined()
+  await again.unmount()
+  await $.classic.SessionStart({ source: 'clear' })
+  const cleared = await band($)
+  expect(await cleared.find({ type: 'Text', text: /held 40k tokens in cache/ })).toBeUndefined()
+  await cleared.unmount()
+  // The demo shows the card with sample values, whatever the state.
+  await command($, 'kept')
+  const demo = await band($)
+  expect(await demo.find({ type: 'Text', text: /held 312k tokens in cache/ })).toBeDefined()
+})
+
 test('fork turn.step is not effort-steered, busy or main-request cost', async ($, on) => {
   const b = boundaries(on, { keepWarm: true })
   http(on)
@@ -941,6 +977,23 @@ test('fork turn.step is not effort-steered, busy or main-request cost', async ($
   expect(stats.text).toContain('Warm: 1 pings')
 })
 
+test('the flame turns keep-warm off for this chat only; Settings stay as they are', async ($, on) => {
+  const b = boundaries(on, { keepWarm: true })
+  http(on)
+  judgeStub(on, '{"effort":"high","why":"scope"}')
+  stepStub(on)
+  let forks = 0
+  on('model.fork', async () => { forks++; return { value: { isAnswered: true, text: 'ok', usage: USAGE } } })
+  await start($)
+  await submit($)
+  await step($)
+  await complete($)
+  await $.command.run({ command: 'ripple', origin: { kind: 'composer' }, presentation: { isFullscreen: true, columns: 140 }, args: 'warm' })
+  await b.clock.advance(3375000)
+  expect(forks).toBe(0)
+  expect(b.router().settings.keepWarm).toBe(true)
+})
+
 test('Haiku compaction returns replacement messages and forwards the keep note', async ($, on) => {
   boundaries(on)
   http(on)