dsh-code 1.0.7 → 1.3.0

package/src/render/status.ts

@@ -12,21 +12,13 @@
 
 import { visibleColumns } from './markdown.ts'
 import type { TranscriptStats } from './projection.ts'
-import { singleLineText, truncateColumns } from './text.ts'
+import { billedInputTokens } from './usage.ts'
+import { singleLineText, truncateColumns, formatTokens } from './text.ts'
+
+// Re-exported for the callers that have always read the formatter here.
+export { formatTokens }
+import { t, type MessageKey } from '../i18n.ts'
 
-/**
- * Compact token count: 517 / 12.2K / 517K / 1.2M (one decimal under three
- * digits), mirroring the web composer's StatsLine format.
- * @param n - token count.
- * @returns display string.
- */
-export function formatTokens(n: number): string {
-  const scaled = (v: number): string =>
-    v >= 100 ? String(Math.round(v)) : String(Math.round(v * 10) / 10)
-  if (n < 1_000) return String(n)
-  if (n < 1_000_000) return scaled(n / 1_000) + 'K'
-  return scaled(n / 1_000_000) + 'M'
-}
 
 /**
  * Compact duration: 45.2s under a minute, 2m42s from there on.
@@ -37,7 +29,11 @@ export function formatDuration(ms: number): string {
   const s = ms / 1_000
   if (s < 60) return String(Math.round(s * 10) / 10) + 's'
   const whole = Math.round(s)
-  return Math.floor(whole / 60) + 'm' + (whole % 60) + 's'
+  const hours = Math.floor(whole / 3_600)
+  const minutes = Math.floor((whole % 3_600) / 60)
+  const seconds = whole % 60
+  if (hours > 0) return `${hours}h${minutes}m${seconds === 0 ? '' : `${seconds}s`}`
+  return `${minutes}m${seconds}s`
 }
 
 /**
@@ -53,14 +49,17 @@ function formatRate(n: number): string {
 }
 
 /**
- * Cache-hit share of billed prompt-side input.
+ * Cache-hit share of billed prompt-side input. The denominator is the same
+ * billed total the /usage panel shows (uncached input plus both cache
+ * buckets), so the two readouts can never disagree.
  * @param usage - cumulative token totals.
  * @returns percent rounded to one decimal place, or null when no input was billed.
  */
 export function cacheHitPercent(usage: TranscriptStats['usage']): number | null {
-  return usage.inputTokens === 0
+  const billed = billedInputTokens(usage)
+  return billed === 0
     ? null
-    : Math.round(usage.cacheReadTokens / usage.inputTokens * 1_000) / 10
+    : Math.round(usage.cacheReadTokens / billed * 1_000) / 10
 }
 
 /**
@@ -124,8 +123,14 @@ export const STATUS_GROUP_SEPARATOR = ' | '
 /** Separator between trailing state spans. */
 export const STATUS_ITEM_SEPARATOR = ' · '
 /** The Codex-style mode cycle hint appended to the permission badge. */
+/** English compatibility value for callers that only measure the default layout. */
 export const STATUS_CYCLE_HINT = ' (shift+tab to cycle)'
 
+/** Localized mode-cycle hint used by the live layout. */
+export function statusCycleHint(): string {
+  return ` ${t('status.cycleHint')}`
+}
+
 /**
  * Interior columns of the context bar. The layout starts every bar at this
  * width so the drop ladder can pre-measure the group, then degrades the
@@ -185,7 +190,7 @@ export function contextGroupSpans(
   barWidth: number,
   readout: ContextReadoutMode,
 ): readonly StatusSpan[] {
-  const spans: StatusSpan[] = [{ text: 'context ', tone: 'label' }]
+  const spans: StatusSpan[] = [{ text: t('status.label.context') + ' ', tone: 'label' }]
   spans.push(...contextBar(usedTokens, contextWindow, barWidth))
   if (readout === 'none' || barWidth <= 0 || contextWindow <= 0) return spans
   const used = Math.max(0, usedTokens)
@@ -250,6 +255,31 @@ export const STATUS_ITEMS: readonly StatusItemInfo[] = [
   { id: 'sandbox', label: 'sandbox', description: 'divergent sandbox-mode override', side: 'left' },
 ]
 
+const STATUSLINE_ITEM_KEYS: Record<StatusItemId, { label: MessageKey; description: MessageKey }> = {
+  model: { label: 'statusline.item.model', description: 'statusline.item.model.desc' },
+  cwd: { label: 'statusline.item.cwd', description: 'statusline.item.cwd.desc' },
+  mode: { label: 'statusline.item.mode', description: 'statusline.item.mode.desc' },
+  branch: { label: 'statusline.item.branch', description: 'statusline.item.branch.desc' },
+  context: { label: 'statusline.item.context', description: 'statusline.item.context.desc' },
+  permission: { label: 'statusline.item.permission', description: 'statusline.item.permission.desc' },
+  plan: { label: 'statusline.item.plan', description: 'statusline.item.plan.desc' },
+  turns: { label: 'statusline.item.turns', description: 'statusline.item.turns.desc' },
+  durations: { label: 'statusline.item.durations', description: 'statusline.item.durations.desc' },
+  cache: { label: 'statusline.item.cache', description: 'statusline.item.cache.desc' },
+  tokens: { label: 'statusline.item.tokens', description: 'statusline.item.tokens.desc' },
+  title: { label: 'statusline.item.title', description: 'statusline.item.title.desc' },
+  goal: { label: 'statusline.item.goal', description: 'statusline.item.goal.desc' },
+  sandbox: { label: 'statusline.item.sandbox', description: 'statusline.item.sandbox.desc' },
+}
+
+/** Picker rows with labels/descriptions in the active interface language. */
+export function localizedStatusItems(): readonly StatusItemInfo[] {
+  return STATUS_ITEMS.map(item => {
+    const keys = STATUSLINE_ITEM_KEYS[item.id]
+    return { ...item, label: t(keys.label), description: t(keys.description) }
+  })
+}
+
 /**
  * Default order: the whole catalog (matches the pre-customization bar).
  * The busy dot is not an item — it always leads the identity cluster.
@@ -291,9 +321,10 @@ export const STATUS_ROW2_INDENT = 2
 const TITLE_BUDGET = 48
 
 /**
- * Primary-row drop ranks: context drops before permission; the identity
- * cluster never drops and ellipsizes only after the right badge is gone.
- * Secondary-row groups reuse the remaining ranks independently.
+ * Primary-row drop ranks: identity never drops; permission outranks context.
+ * The drop ladder peels hint and trailing identity facts before removing
+ * the context meter, so occupancy stays visible on a typical 120-column
+ * terminal. Secondary-row groups reuse the remaining ranks independently.
  */
 const RANK_TITLE = 10
 const RANK_TOKENS = 50
@@ -357,6 +388,30 @@ function sep(): StatusSpan {
   return { text: ' · ', tone: 'label' }
 }
 
+/** True for the dim ` · ` that joins identity facts. */
+function isIdentitySep(span: StatusSpan): boolean {
+  return span.text === ' · ' && span.tone === 'label'
+}
+
+/**
+ * Drop the trailing identity fact (branch, then mode, then cwd) so the
+ * context meter can keep a column. Returns undefined once only the busy
+ * dot and model remain.
+ */
+function peelIdentityFact(spans: readonly StatusSpan[]): StatusSpan[] | undefined {
+  if (spans.length < 3) return undefined
+  const last = spans[spans.length - 1]
+  const before = spans[spans.length - 2]
+  const modeSep = spans[spans.length - 3]
+  if (last?.tone === 'accent' && modeSep !== undefined && isIdentitySep(modeSep) && before?.tone === 'label') {
+    return spans.slice(0, -3)
+  }
+  if ((last?.tone === 'branch' || last?.tone === 'path') && before !== undefined && isIdentitySep(before)) {
+    return spans.slice(0, -2)
+  }
+  return undefined
+}
+
 /** Total visible columns of a span list (separators ride inside the spans). */
 function spansWidth(spans: readonly StatusSpan[]): number {
   let width = 0
@@ -408,7 +463,7 @@ function buildCandidates(
   if (cwd !== '' && enabled.has('cwd')) push({ text: cwd, tone: 'path' })
   const mode = safe(facts.mode ?? '')
   if (mode !== '' && enabled.has('mode')) {
-    push({ text: '/mode ', tone: 'label' })
+    push({ text: t('status.label.mode') + ' ', tone: 'label' })
     identity.push({ text: mode, tone: 'accent' })
   }
   const branch = safe(facts.branch)
@@ -430,8 +485,8 @@ function buildCandidates(
         if (counts.length > 0) counts.push(sep())
         counts.push({ text: label + ' ', tone: 'label' }, { text: value, tone: 'value' })
       }
-      pair('turns', String(stats.turns))
-      pair('steps', String(stats.steps))
+      pair(t('status.label.turns'), String(stats.turns))
+      pair(t('status.label.steps'), String(stats.steps))
       row2.push({ group: { spans: counts }, rank: RANK_COUNTS, id: 'turns' })
     }
     if (enabled.has('durations')) {
@@ -443,29 +498,34 @@ function buildCandidates(
         if (durations.length > 0) durations.push(sep())
         durations.push({ text: label + ' ', tone: 'label' }, { text: value, tone: 'value' })
       }
-      if (stats.llmMs > 0) pair('model', formatDuration(stats.llmMs))
-      if (stats.ttftSteps > 0) pair('latency', formatDuration(stats.ttftMs / stats.ttftSteps))
+      if (stats.llmMs > 0) pair(t('status.label.modelTime'), formatDuration(stats.llmMs))
+      if (stats.ttftSteps > 0) pair(t('status.label.latency'), formatDuration(stats.ttftMs / stats.ttftSteps))
       if (stats.decodeMs > 0 && stats.decodeTokens > 0) {
         if (durations.length > 0) durations.push(sep())
         durations.push(
           { text: formatRate(stats.decodeTokens / (stats.decodeMs / 1_000)), tone: 'value' },
-          { text: ' tokens/s', tone: 'label' },
+          { text: t('status.label.tokensPerSec'), tone: 'label' },
         )
       }
-      if (stats.toolMs > 0) pair('tool', formatDuration(stats.toolMs))
+      if (stats.toolMs > 0) pair(t('status.label.tool'), formatDuration(stats.toolMs))
       if (durations.length > 0) {
         row2.push({ group: { spans: durations }, rank: RANK2_DURATIONS, id: 'durations' })
       }
     }
   }
 
+  // The cache group carries both facts about cached prompt tokens: how many
+  // were read and what share of the billed prompt that was. The read count
+  // lives here rather than in the tokens group so the tokens group keeps
+  // meaning "what the provider billed outside the cache".
   const cacheHit = cacheHitPercent(stats.usage)
   if (cacheHit !== null && enabled.has('cache')) {
-    row2.push({
-      group: { spans: [{ text: 'cache ', tone: 'label' }, { text: cacheHit + '%', tone: 'value' }] },
-      rank: RANK2_CACHE,
-      id: 'cache',
-    })
+    const spans: StatusSpan[] = [{ text: t('status.label.cache') + ' ', tone: 'label' }]
+    if (stats.usage.cacheReadTokens > 0) {
+      spans.push({ text: formatTokens(stats.usage.cacheReadTokens), tone: 'value' }, sep())
+    }
+    spans.push({ text: cacheHit + '%', tone: 'value' })
+    row2.push({ group: { spans }, rank: RANK2_CACHE, id: 'cache' })
   }
   // Context occupancy as a purely proportional bar with the usage readout
   // riding outside it: the used total is the most recent reported prompt
@@ -479,14 +539,14 @@ function buildCandidates(
       id: 'context',
     })
   }
-  if ((stats.usage.inputTokens > 0 || stats.usage.outputTokens > 0) && enabled.has('tokens')) {
+  if ((stats.usage.uncachedInputTokens > 0 || stats.usage.outputTokens > 0) && enabled.has('tokens')) {
     const tokens: StatusSpan[] = []
     const pair = (label: string, value: string): void => {
       if (tokens.length > 0) tokens.push(sep())
       tokens.push({ text: label + ' ', tone: 'label' }, { text: value, tone: 'value' })
     }
-    pair('in', formatTokens(stats.usage.inputTokens))
-    pair('out', formatTokens(stats.usage.outputTokens))
+    pair(t('status.label.in'), formatTokens(stats.usage.uncachedInputTokens))
+    pair(t('status.label.out'), formatTokens(stats.usage.outputTokens))
     row2.push({ group: { spans: tokens }, rank: RANK_TOKENS, id: 'tokens' })
   }
 
@@ -505,8 +565,8 @@ function buildCandidates(
       group: {
         spans: [{
           text: facts.goal.phase === 'active'
-            ? '◎ round ' + facts.goal.rounds + '/' + facts.goal.max
-            : '◎ ' + safe(facts.goal.phase),
+            ? t('status.goal.round', { current: facts.goal.rounds, max: facts.goal.max })
+            : t('status.goal.phase', { phase: safe(facts.goal.phase) }),
           tone: 'accent',
         }],
       },
@@ -517,7 +577,7 @@ function buildCandidates(
   // The sandbox override stays implicit when it merely echoes the preset.
   const sandbox = safe(facts.sandbox ?? '')
   if (sandbox !== '' && sandbox.toLowerCase() !== facts.permission.toLowerCase() && enabled.has('sandbox')) {
-    row2.push({ group: { spans: [{ text: 'sandbox ' + sandbox, tone: 'warn' }] }, rank: RANK_SANDBOX, id: 'sandbox' })
+    row2.push({ group: { spans: [{ text: t('status.label.sandbox') + ' ' + sandbox, tone: 'warn' }] }, rank: RANK_SANDBOX, id: 'sandbox' })
   }
   const permission = safe(facts.permission)
   let badge = -1
@@ -530,7 +590,7 @@ function buildCandidates(
   if (permission !== '' && enabled.has('permission')) {
     right.push({
       span: planStation
-        ? { text: 'plan on', tone: 'plan' }
+        ? { text: t('status.plan.on'), tone: 'plan' }
         : { text: permission, tone: permissionTone(permission) },
       rank: RANK_BADGE,
       id: 'permission',
@@ -538,7 +598,7 @@ function buildCandidates(
     badge = right.length - 1
   }
   if (facts.plan && enabled.has('plan')) {
-    row2.push({ group: { spans: [{ text: '⧉ plan', tone: 'accent' }] }, rank: RANK2_PLAN, id: 'plan' })
+    row2.push({ group: { spans: [{ text: t('status.plan.mark'), tone: 'accent' }] }, rank: RANK2_PLAN, id: 'plan' })
   }
   return { left, right, badge, row2 }
 }
@@ -546,7 +606,8 @@ function buildCandidates(
 /**
  * Compose the two-row footer layout under a column budget. Row 1 keeps model,
  * cwd, mode, branch, context, then the right-pinned permission badge and cycle
- * hint. It drops hint, context, and permission before ellipsizing identity.
+ * hint. It shrinks the context bar, drops the hint, and peels trailing
+ * identity facts before removing the context group or the permission badge.
  * Row 2 fits all secondary figures and state within its own budget.
  * @param facts - identity facts resolved by the runner.
  * @param stats - session figures folded from the durable log.
@@ -612,16 +673,15 @@ export function layoutStatusBar(
       groupSeparator,
     )
     const rightWidth = joinWidth(rightKept.map(entry => visibleColumns(entry.span.text)), itemSeparator)
-      + (hint ? visibleColumns(STATUS_CYCLE_HINT) : 0)
+      + (hint ? visibleColumns(statusCycleHint()) : 0)
     return rightWidth > 0 ? leftWidth + LEFT_RIGHT_GAP + rightWidth : leftWidth
   }
 
   while (width() > budget) {
-    // Context is the lowest-priority visual group: the bar shrinks inside
-    // its own budget first (the absolute readout survives), then the
-    // readout degrades to the bare percent, and only then does the whole
-    // group go — before the permission badge or its Shift+Tab affordance
-    // is touched.
+    // Occupancy outranks the cycle hint and trailing identity facts
+    // (cwd/mode/branch): shrink the bar, drop the hint, then peel those
+    // facts before removing the context group. Permission stays until
+    // context is already gone.
     if (leftKept.some(entry => entry.id === 'context')) {
       if (contextWidth > CONTEXT_MIN_WIDTH) {
         const overflow = width() - budget
@@ -634,24 +694,21 @@ export function layoutStatusBar(
         rebuildContext()
         continue
       }
-      leftKept.splice(leftKept.findIndex(entry => entry.id === 'context'), 1)
+    }
+    if (hint) {
+      hint = false
       continue
     }
-    if (hint && rightKept.length > 0 && leftKept.length > 0) {
-      const identity = leftKept[0]
-      const identityText = identity.group.spans.map(span => span.text).join('')
-      const rightWidth = joinWidth(rightKept.map(entry => visibleColumns(entry.span.text)), itemSeparator)
-      const identityBudget = budget - rightWidth - LEFT_RIGHT_GAP - visibleColumns(STATUS_CYCLE_HINT)
-      if (identityBudget > 0 && visibleColumns(identityText) > identityBudget) {
-        leftKept[0] = {
-          ...identity,
-          group: { spans: [{ text: truncateColumns(identityText, identityBudget), tone: 'model' }] },
-        }
+    const identityEntry = leftKept[0]
+    if (identityEntry?.id === 'identity') {
+      const peeled = peelIdentityFact(identityEntry.group.spans)
+      if (peeled !== undefined) {
+        leftKept[0] = { ...identityEntry, group: { spans: peeled } }
         continue
       }
     }
-    if (hint) {
-      hint = false
+    if (leftKept.some(entry => entry.id === 'context')) {
+      leftKept.splice(leftKept.findIndex(entry => entry.id === 'context'), 1)
       continue
     }
     let dropLeft = -1

package/src/render/text.ts

@@ -14,6 +14,21 @@
 
 import { graphemeWidth, splitGraphemes, stringWidth } from './width.ts'
 
+/**
+ * Compact token count: exact below 1K, then one-decimal-ish K/M.
+ * @param n - token count.
+ * @returns display string.
+ */
+export function formatTokens(n: number): string {
+  const scaled = (v: number): string =>
+    v >= 100 ? String(Math.round(v)) : String(Math.round(v * 10) / 10)
+  if (n < 1_000) return String(n)
+  // 999,500+ rounds to 1000K; step up to M instead of printing four digits.
+  if (n < 999_500) return scaled(n / 1_000) + 'K'
+  return scaled(n / 1_000_000) + 'M'
+}
+
+
 /** C0 controls except tab (0x09) and newline (0x0a), plus DEL and C1. */
 const CONTROL_ESCAPE = /[\u0000-\u0008\u000b-\u001f\u007f-\u009f]/gu
 

package/src/render/tool-preview.ts

@@ -1,77 +1,77 @@
-/**
- * Bounded preview line for a tool invocation's raw JSON arguments: the first
- * human-meaningful string among the well-known keys (command, path, query, …)
- * with a fallback to the bounded raw JSON. Shared by the tool card in the
- * transcript and the approval bar's command preview. Arguments longer than
- * {@link MAX_PARSE_CHARS} are never parsed: the preview is a display concern,
- * and a synchronous `JSON.parse` plus string copies of an unbounded model
- * payload must not run on the approval or projection paths.
- *
- * @module @deepseek-ai/dsh-code/render/tool-preview
- */
-
-/** Keys searched in declaration order when building a preview. */
-const PREVIEW_KEYS = ['command', 'cmd', 'description', 'path', 'pattern', 'query'] as const
-
-/**
- * Raw arguments longer than this are skipped without parsing and fall back
- * to the bounded raw preview. Well above any realistic command/path/query
- * string while keeping the synchronous parse cost negligible.
- */
-const MAX_PARSE_CHARS = 4096
-
-/** Bounded raw-arguments fallback shared by the skip-parse and parse-failure paths. */
-function boundedRawPreview(args: string): string {
-  return args.length > 80 ? `${args.slice(0, 77)}...` : args
-}
-
-/**
- * Resolve one bounded preview for raw tool arguments.
- * @param args - raw JSON arguments string as the model produced it.
- * @param toolName - the tool the arguments belong to (fallback label).
- * @returns the preview line; empty when nothing useful resolves.
- */
-export function toolArgumentsPreview(args: string, toolName: string): string {
-  if (args === '') return toolName
-  if (args.length > MAX_PARSE_CHARS) return boundedRawPreview(args)
-  try {
-    const parsed: unknown = JSON.parse(args)
-    if (parsed !== null && typeof parsed === 'object') {
-      const record = parsed as Record<string, unknown>
-      for (const key of PREVIEW_KEYS) {
-        const value = record[key]
-        if (typeof value === 'string' && value !== '') return value
-      }
-    }
-  } catch {
-    // Raw JSON parse failed: fall through to the bounded raw arguments.
-  }
-  return boundedRawPreview(args)
-}
-
-/** Visible budget for one delegation prompt row on the tool card. */
-const MAX_PROMPT_CHARS = 160
-
-/**
- * Bounded prompt preview for delegation-style tools (`subagent`): the
- * `prompt` argument rendered as the card's second row, so the transcript
- * shows what the child agent was asked — not just its description label —
- * while it runs (Codex's SpawnAgent card preview). Anything else returns ''.
- * @param toolName - the tool the arguments belong to.
- * @param args - raw JSON arguments string as the model produced it.
- * @returns the one-line prompt preview, or '' when none applies.
- */
-export function toolPromptPreview(toolName: string, args: string): string {
-  if (toolName !== 'subagent' || args === '' || args.length > MAX_PARSE_CHARS) return ''
-  try {
-    const parsed: unknown = JSON.parse(args)
-    if (parsed === null || typeof parsed !== 'object') return ''
-    const prompt = (parsed as Record<string, unknown>)['prompt']
-    if (typeof prompt !== 'string' || prompt === '') return ''
-    const flat = prompt.replace(/\s+/gu, ' ').trim()
-    return flat.length > MAX_PROMPT_CHARS ? `${flat.slice(0, MAX_PROMPT_CHARS - 1)}…` : flat
-  } catch {
-    // Malformed arguments degrade to no prompt row, never a thrown parse.
-    return ''
-  }
-}
+/**
+ * Bounded preview line for a tool invocation's raw JSON arguments: the first
+ * human-meaningful string among the well-known keys (command, path, query, …)
+ * with a fallback to the bounded raw JSON. Shared by the tool card in the
+ * transcript and the approval bar's command preview. Arguments longer than
+ * {@link MAX_PARSE_CHARS} are never parsed: the preview is a display concern,
+ * and a synchronous `JSON.parse` plus string copies of an unbounded model
+ * payload must not run on the approval or projection paths.
+ *
+ * @module @deepseek-ai/dsh-code/render/tool-preview
+ */
+
+/** Keys searched in declaration order when building a preview. */
+const PREVIEW_KEYS = ['command', 'cmd', 'description', 'path', 'pattern', 'query'] as const
+
+/**
+ * Raw arguments longer than this are skipped without parsing and fall back
+ * to the bounded raw preview. Well above any realistic command/path/query
+ * string while keeping the synchronous parse cost negligible.
+ */
+const MAX_PARSE_CHARS = 4096
+
+/** Bounded raw-arguments fallback shared by the skip-parse and parse-failure paths. */
+function boundedRawPreview(args: string): string {
+  return args.length > 80 ? `${args.slice(0, 77)}...` : args
+}
+
+/**
+ * Resolve one bounded preview for raw tool arguments.
+ * @param args - raw JSON arguments string as the model produced it.
+ * @param toolName - the tool the arguments belong to (fallback label).
+ * @returns the preview line; empty when nothing useful resolves.
+ */
+export function toolArgumentsPreview(args: string, toolName: string): string {
+  if (args === '') return toolName
+  if (args.length > MAX_PARSE_CHARS) return boundedRawPreview(args)
+  try {
+    const parsed: unknown = JSON.parse(args)
+    if (parsed !== null && typeof parsed === 'object') {
+      const record = parsed as Record<string, unknown>
+      for (const key of PREVIEW_KEYS) {
+        const value = record[key]
+        if (typeof value === 'string' && value !== '') return value
+      }
+    }
+  } catch {
+    // Raw JSON parse failed: fall through to the bounded raw arguments.
+  }
+  return boundedRawPreview(args)
+}
+
+/** Visible budget for one delegation prompt row on the tool card. */
+const MAX_PROMPT_CHARS = 160
+
+/**
+ * Bounded prompt preview for delegation-style tools (`subagent`): the
+ * `prompt` argument rendered as the card's second row, so the transcript
+ * shows what the child agent was asked — not just its description label —
+ * while it runs (Codex's SpawnAgent card preview). Anything else returns ''.
+ * @param toolName - the tool the arguments belong to.
+ * @param args - raw JSON arguments string as the model produced it.
+ * @returns the one-line prompt preview, or '' when none applies.
+ */
+export function toolPromptPreview(toolName: string, args: string): string {
+  if (toolName !== 'subagent' || args === '' || args.length > MAX_PARSE_CHARS) return ''
+  try {
+    const parsed: unknown = JSON.parse(args)
+    if (parsed === null || typeof parsed !== 'object') return ''
+    const prompt = (parsed as Record<string, unknown>)['prompt']
+    if (typeof prompt !== 'string' || prompt === '') return ''
+    const flat = prompt.replace(/\s+/gu, ' ').trim()
+    return flat.length > MAX_PROMPT_CHARS ? `${flat.slice(0, MAX_PROMPT_CHARS - 1)}…` : flat
+  } catch {
+    // Malformed arguments degrade to no prompt row, never a thrown parse.
+    return ''
+  }
+}