@contraagent/ui 0.2.0 → 0.4.0

package/src/elements/lists/ca-panel-body.ts

@@ -1,4 +1,4 @@
-import { typedBody, type CodeBody, type PanelBody, type TableBody, type TreeBody, type TreeLink, type TypedPanelBody } from '@contraagent/api';
+import { typedBody, type CodeBody, type EmbedBody, type PanelBody, type TableBody, type TreeBody, type TreeLink, type TypedPanelBody } from '@contraagent/api';
 import '@contraagent/elements/charts/define';
 import '@contraagent/elements/code/define';
 import '@contraagent/elements/data-table/define';
@@ -35,7 +35,9 @@ const CELLS = [
 
 /**
  * A pipeline's own view drawn from its typed body (`PanelBody`): tiles, a table, charts,
- * a status grid, notes, code, trees, and blocks of them one under another, each under its title
+ * a status grid, notes, code, trees, a page in a frame (an app the monitor serves, by a path
+ * relative to `base-url`, or an http(s) URL; given the theme shown as `theme`, `dark` or
+ * `light`), and blocks of them one under another, each under its title
  * (folded when the body says `collapsed`). A tree whose nodes hold code shows the selected
  * node's code beside it; a node with a link leads to a body of the panel (its `anchor`), a
  * run panel's tab or a task. A body of another shape, inside blocks, is shown as a JSON tree.
@@ -70,10 +72,16 @@ export class CaPanelBody extends LitElement {
       .pair > .tree { border: 1px solid var(--line); border-radius: var(--radius-md); max-height: 70vh; overflow: auto; }
       .pane { min-width: 0; }
       @media (max-width: 720px) { .pair { grid-template-columns: minmax(0, 1fr); } .pair > .tree { max-height: 40vh; } }
+      /* a page of the pipeline's own: as tall as the body says, else the screen under the monitor's header */
+      .embed { display: block; width: 100%; height: calc(100dvh - 160px); min-height: 320px; border: 1px solid var(--line); border-radius: var(--radius-md); background: var(--surface); }
     `,
   ];
 
   @property({ attribute: false }) body: PanelBody | undefined;
+  /** Where the monitor is served: an embedded page's path is relative to it. */
+  @property({ attribute: 'base-url' }) baseUrl = '';
+  /** The panel's title: the name of a framed page whose body has no title of its own. */
+  @property() label = '';
 
   /** The order of each table's rows, by the table's place in the body. */
   @state() private sorts = new Map<string, SortState>();
@@ -100,6 +108,15 @@ export class CaPanelBody extends LitElement {
       .path=${c.path ?? path ?? ''} .label=${c.title ?? c.path ?? path ?? ''} ?wrap=${!!c.wrap} .strings=${codeStrings()}></cae-code>`;
   }
 
+  /** A page in a frame: its URL against the monitor's, with the theme shown. */
+  private embed(b: EmbedBody): TemplateResult {
+    const base = new URL(this.baseUrl ? this.baseUrl.replace(/\/?$/, '/') : './', document.baseURI);
+    const url = new URL(b.url, base);
+    url.searchParams.set('theme', shownTheme(this));
+    return html`<iframe class="embed" src=${url.href} title=${b.title || this.label}
+      style=${b.height ? `height:${b.height}px` : nothing}></iframe>`;
+  }
+
   /** A tree, and the selected node's code beside it: the texts come with the body, so a selection sends no request. */
   private tree(b: TreeBody, at: string): TemplateResult {
     const { items, nodes, first } = bodyTree(b);
@@ -167,6 +184,8 @@ export class CaPanelBody extends LitElement {
         return this.code(b);
       case 'tree':
         return this.tree(b, at);
+      case 'embed':
+        return this.embed(b);
       default:
         return html`${nothing}`;
     }
@@ -193,6 +212,15 @@ export class CaPanelBody extends LitElement {
   }
 }
 
+/** The theme `el` is shown in, `dark` or `light`: the nearest `data-ca-theme` above it, through shadow roots; else the screen's. */
+function shownTheme(el: Element): 'dark' | 'light' {
+  for (let n: Node | null = el; n; n = n.parentNode ?? (n instanceof ShadowRoot ? n.host : null)) {
+    const theme = n instanceof Element ? n.getAttribute('data-ca-theme') : null;
+    if (theme) return theme.includes('light') ? 'light' : 'dark';
+  }
+  return matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark';
+}
+
 declare global {
   interface HTMLElementTagNameMap {
     'ca-panel-body': CaPanelBody;

package/src/elements/lists/ca-panel-view.ts

@@ -25,6 +25,8 @@ export class CaPanelView extends LitElement {
   @property({ attribute: false }) panel: PanelInfo | undefined;
   /** Its body; undefined until the feed has sent it. */
   @property({ attribute: false }) data: PanelBody | undefined;
+  /** Where the monitor is served: an embedded page's path is relative to it. */
+  @property({ attribute: 'base-url' }) baseUrl = '';
 
   override render() {
     if (this.data === undefined) {
@@ -38,7 +40,7 @@ export class CaPanelView extends LitElement {
       <h3><span class="tab-ic" aria-hidden="true">${info?.icon || '▤'}</span>${info?.title || this.name}
         <span class="r">${msg('Custom view')}</span></h3>
       ${info?.description ? html`<div class="meta desc">${info.description}</div>` : nothing}
-      ${typedBody(this.data) ? html`<ca-panel-body .body=${this.data}></ca-panel-body>` : html`<cae-json-tree .value=${this.data}></cae-json-tree>`}
+      ${typedBody(this.data) ? html`<ca-panel-body .body=${this.data} base-url=${this.baseUrl} label=${info?.title || this.name}></ca-panel-body>` : html`<cae-json-tree .value=${this.data}></cae-json-tree>`}
     </section>`;
   }
 }

package/src/elements/overview/ca-overview.ts

@@ -46,6 +46,12 @@ import './ca-workers.js';
 
 /** Failed outputs listed on the overview; the rest are behind a link to the outputs tab. */
 const OUTPUTS_SHOWN = 5;
+/** The problems of each group shown (failed, not started, partly done); the rest are in the history. */
+const PROBLEMS_SHOWN = 5;
+/** The tasks done after a retry shown: they are done, so fewer. */
+const RECOVERED_SHOWN = 3;
+/** The later tasks a failure stopped, shown as chips beside it. */
+const STOPPED_SHOWN = 4;
 
 const CT_ORDER = ['invalid', 'refused', 'failed', 'running', 'pending', 'valid'] as const satisfies readonly (keyof OutputTally)[];
 
@@ -147,7 +153,9 @@ export class CaOverview extends LitElement {
       .cu { display: grid; grid-template-columns: 90px 1fr 70px auto; gap: 8px; align-items: center; }
       .cu-bar { height: 5px; border-radius: 3px; background: var(--track); overflow: hidden; }
       .cu-bar i { display: block; height: 100%; background: var(--meter); }
-      .fl > div.meta { grid-column: 1 / 4; overflow: hidden; text-overflow: ellipsis; }
+      /* one line each, the whole text in its tooltip: a long reason does not make the card taller */
+      .fl > div.meta { grid-column: 1 / 4; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+      .ofl > .meta { white-space: nowrap; }
       .stopped { grid-column: 1 / 4; color: var(--text-muted); font-size: 11px; display: flex; flex-wrap: wrap; align-items: center; gap: 4px; }
       .fl.muted { opacity: 0.7; }
       .problems h4.sub { margin: 10px 0 2px; font-size: 11px; font-weight: 600; color: var(--text-muted); display: flex; }
@@ -307,7 +315,7 @@ export class CaOverview extends LitElement {
           ${statusWord({ text: o.status ? contractStatusLabel(o.status) : '—', tone: contractTone(o.status), title: o.status ? contractStatusWhy(o.status) : null })}
           <b class="jmono" title=${c.key}>${kindUnit({ kind: c.kind, unit: c.unit === c.key ? '' : c.unit })}</b>
           <span class="meta">${formatOf(o)}</span>
-          <span class="meta">${runRelative(o.errors?.[0] || o.path, this.run).slice(0, 160)}</span>
+          <span class="meta" title=${runRelative(o.errors?.[0] || o.path, this.run)}>${runRelative(o.errors?.[0] || o.path, this.run)}</span>
         </button>`,
       )}
       ${bad.length > shown.length
@@ -422,49 +430,60 @@ export class CaOverview extends LitElement {
     const issues = failed.length + notStarted.length + partial.length;
     const ok = html`<div class="ok"><span aria-hidden="true">✓</span>${msg('No problems')}</div>`;
     if (!issues && !recovered.length) return ok;
-    const reason = (t: TaskOutcome) => runRelative(t.attempts[t.attempts.length - 1]?.reason || '—', this.run).slice(0, 200);
+    const reason = (t: TaskOutcome) => runRelative(t.attempts[t.attempts.length - 1]?.reason || '—', this.run);
     const stoppedLine = (stopped: TaskOutcome[]) =>
       stopped.length
         ? html`<div class="stopped">
             <span>${stopped.length === 1 ? msg('1 later task not started') : msg(str`${stopped.length} later tasks not started`)}</span>
-            ${stopped.map((x) => taskChip(this, this.name(x), x))}
+            ${stopped.slice(0, STOPPED_SHOWN).map((x) => taskChip(this, this.name(x), x))}
+            ${stopped.length > STOPPED_SHOWN ? html`<span>${msg(str`${stopped.length - STOPPED_SHOWN} more`)}</span>` : nothing}
           </div>`
         : nothing;
+    // Each group shows its first few; a link leads to the rest, in the history filtered to them.
+    const rest = (all: number, shown: number, stop: string) =>
+      all > shown
+        ? html`<div class="more"><a class="lnk" href="#" @click=${(e: Event) => this.nav(e, () => emit(this, 'ca-navigate', { tab: 'journal', stop }))}>${all - shown === 1
+            ? msg('1 more in history')
+            : msg(str`${all - shown} more in history`)}</a></div>`
+        : nothing;
     // The tasks done after retrying are done, not problems: a group of their own, after the problems.
     return html`${issues ? nothing : ok}${repeat(
-        failed,
+        failed.slice(0, PROBLEMS_SHOWN),
         (p) => p.task.key,
         (p) => {
           const last = p.task.attempts[p.task.attempts.length - 1];
           return html`<div class="fl" @click=${(e: MouseEvent) => this.openRow(e, p.task)}>
             ${statusWord({ text: outcomeLabel('failed'), tone: 'failed' })}
             ${this.nameButton(p.task)}<span class="meta">${localTime(last?.ts, true)}</span>
-            <div class="meta">${stopLabel(last?.stop)}: ${reason(p.task)}</div>
+            <div class="meta" title=${reason(p.task)}>${stopLabel(last?.stop)}: ${reason(p.task)}</div>
             ${stoppedLine(p.stopped)}
           </div>`;
         },
       )}
+      ${rest(failed.length, PROBLEMS_SHOWN, 'bad')}
       ${repeat(
-        notStarted,
+        notStarted.slice(0, PROBLEMS_SHOWN),
         (t) => t.key,
         (t) => html`<div class="fl" @click=${(e: MouseEvent) => this.openRow(e, t)}>
           ${statusWord({ text: outcomeLabel('not_started'), tone: 'attention' })}
           ${this.nameButton(t)}<span></span>
-          <div class="meta">${notStartedCause(t, outcomes, this.run) ? sentence(notStartedCause(t, outcomes, this.run)) : reason(t)}</div>
+          ${this.metaLine(notStartedCause(t, outcomes, this.run) ? sentence(notStartedCause(t, outcomes, this.run)) : reason(t))}
         </div>`,
       )}
+      ${rest(notStarted.length, PROBLEMS_SHOWN, 'invalid_input')}
       ${repeat(
-        partial,
+        partial.slice(0, PROBLEMS_SHOWN),
         (t) => t.key,
         (t) => html`<div class="fl" @click=${(e: MouseEvent) => this.openRow(e, t)}>
           ${statusWord({ text: outcomeLabel('partial'), tone: outcomeTone('partial') })}
           ${this.nameButton(t)}<span></span>
-          <div class="meta">${reason(t)}</div>
+          ${this.metaLine(reason(t))}
         </div>`,
       )}
+      ${rest(partial.length, PROBLEMS_SHOWN, 'partial')}
       ${recovered.length ? html`<h4 class="sub">${sentence(outcomeLabel('recovered'))} <span class="r">${recovered.length}</span></h4>` : nothing}
       ${repeat(
-        recovered,
+        recovered.slice(0, RECOVERED_SHOWN),
         (t) => t.key,
         (t) => {
           const fails = t.tries.filter((a) => !a.ok).length;
@@ -478,9 +497,15 @@ export class CaOverview extends LitElement {
           </div>`;
         },
       )}
+      ${rest(recovered.length, RECOVERED_SHOWN, 'retried')}
       ${this.nextStep(live, issues)}`;
   }
 
+  /** A row's second line: one line, the whole of it in its tooltip. */
+  private metaLine(text: string) {
+    return html`<div class="meta" title=${text}>${text}</div>`;
+  }
+
   /** For a finished run with problems: how many tasks are not done (the tasks resume=True runs again). */
   private nextStep(live: boolean, problemCount: number) {
     if (live || !problemCount) return nothing;

package/src/elements/shell/views.ts

@@ -61,7 +61,7 @@ export function tabView({ snap, viewRoute, derived, q, client, baseUrl }: TabVie
     default: {
       const name = viewRoute.tab.slice('panel:'.length);
       const info = snap.info.panels.find((p) => p.name === name);
-      return html`<ca-panel-view .name=${name} .panel=${info} .data=${state.panels[name]}></ca-panel-view>`;
+      return html`<ca-panel-view .name=${name} .panel=${info} .data=${state.panels[name]} base-url=${baseUrl}></ca-panel-view>`;
     }
   }
 }

package/src/elements/task/header.ts

@@ -9,6 +9,7 @@ import { facts, fmtDur, kindUnit, listText, localTime, tokenCount, unreadEvents,
 import { attemptNames, deferredText, changedFiles, changedFilesTip, changeLabel, credentialLabel, credentialTip, locksLabel, locksTip, modelSwitch, outcomeLabel, priorityText, priorityTip, replayedLabel, replayedTip, stopLabel, type ChangeKind } from '../../words/index.js';
 import { contextWarnedText, contextWarnedTip, peakContextLine, peakContextTip, peakTry } from '../../words/context.js';
 import { readingShort, readingTip } from '../../words/quota.js';
+import { safetyStopCount, safetyStopLine, safetyStopTip } from '../../words/safety.js';
 import { customColumnTip, customValues } from '../../words/row-extras.js';
 import { isStop, type Tone } from '../../lib/tone.js';
 import { executorIcon } from '../../words/executor.js';
@@ -159,6 +160,7 @@ export function taskHeader(c: TaskContext, key: string, onSearch: (query: string
       ${customLine(tries, d.row_extras ?? [])}
       ${searchFold(tries, onSearch)}
       ${changesFold(tries)}
+      ${safetyFold(tries)}
       ${unreadEvents(tries)
         ? html`<div class="meta unread" title=${msg('Event types this contraagent version does not know (unread_events)')}>
             <span aria-hidden="true">⚠</span> ${msg(str`Unrecognized events: ${unreadEvents(tries)}`)}
@@ -227,6 +229,18 @@ function changesFold(tries: JournalRow[]) {
   </details>`;
 }
 
+/** The safety stops of the task's attempts, one per line (the attempt named when more than one has them); nothing when none had one. */
+function safetyFold(tries: JournalRow[]) {
+  const names = attemptNames(tries);
+  const withStops = tries.filter((r) => r.safety_stops?.length).length;
+  if (!withStops) return nothing;
+  const lines = tries.flatMap((r, i) => (r.safety_stops ?? []).map((s) => facts(withStops > 1 ? (names[i] ?? '') : '', safetyStopLine(s))));
+  return html`<details class="io-fold">
+    <summary title=${safetyStopTip()}>${safetyStopCount(lines.length)}</summary>
+    <ul class="meta searches">${lines.map((l) => html`<li>${l}</li>`)}</ul>
+  </details>`;
+}
+
 /** The latest attempt's custom columns (`row_extras`), name and value; each attempt's are in its chip's tooltip. */
 function customLine(tries: JournalRow[], extras: readonly string[]) {
   const last = tries[tries.length - 1];
@@ -269,12 +283,13 @@ function quotaLine(c: TaskContext, tries: JournalRow[]) {
   </div>`;
 }
 
-/** One finished attempt: how it ended, how long, its cost; the rest (when, corrections, model, model switch) in its tooltip. */
+/** One finished attempt: how it ended, how long, its cost, its safety stops; the rest (when, corrections, model, model switch) in its tooltip. */
 function runChip(c: TaskContext, r: JournalRow, name: string, session: boolean, extras: readonly string[]) {
   const look = r.stop === 'partial' ? 'part' : r.ok ? 'ok' : 'bad';
   const played = !!c.replayMarks && !!r.replayed;
   const reason = runRelative(r.reason, c.run);
   const sw = modelSwitch(r.hops, null, r.skipped_hops);
+  const safety = r.safety_stops?.length ? safetyStopCount(r.safety_stops.length) : '';
   const tip = [
     msg(str`Ended ${localTime(r.ts, true)}`),
     correctionsOf(r),
@@ -291,6 +306,6 @@ function runChip(c: TaskContext, r: JournalRow, name: string, session: boolean,
     .join('\n');
   const cost = r.cost_usd !== null && r.cost_usd !== undefined ? usd(r.cost_usd) : '';
   return html`<span class="runchip ${look}" title=${tip}>
-    ${mark(r)} ${facts(name, stopLabel(r.stop, r.reason), fmtDur(r.wall_s), cost, played ? replayedLabel() : '')}
+    ${mark(r)} ${facts(name, stopLabel(r.stop, r.reason), fmtDur(r.wall_s), cost, safety, played ? replayedLabel() : '')}
   </span>`;
 }

package/src/locales/ja.ts

@@ -34,8 +34,10 @@
 's03b454fb08e876ad': `タブ`,
 's03ee3cfb0919c62c': `タスク`,
 's03fb84d070eb4d43': str`古い試行 ${0} 件は非表示`,
+'s041489fa7f9e6fe6': str`ほか ${0} 件`,
 's04286bec7654cf3f': `タスクが宣言したパターンの下で、試行が作成・変更・削除したファイル（changes）`,
 's044f7ee7915b22a3': str`一部のみ完了 ${0} 件`,
+'s04f1babead09ec6b': `停止した部分`,
 's051e95917479e3a4': `実行中のエージェントのセッション`,
 's05548eaadd7b3e53': `選択中の項目`,
 's061a40d8b1403d96': `OutputContract`,
@@ -119,6 +121,7 @@
 's1ebbae8f5810b65b': `入力`,
 's1f25e1e20469a9ea': `削除`,
 's1f53dce0721a5fdc': str`所要時間 ${0}`,
+'s2043c2041d0a5142': `安全分類器による停止`,
 's20e04bdc808a6442': str`リセットまで ${0}`,
 's20f936012bd51f12': `依存先タスクが実行されなかった`,
 's20fd629bac8fddd1': `ホストなし`,
@@ -240,6 +243,7 @@
 's51383b9a7d305b0c': `入力・出力・キャッシュ読み込み・キャッシュ書き込みの合計`,
 's5144d023ec192e11': `実行が終了した`,
 's521a16a18cfbcf5a': `1 ユニット`,
+'s5226f85458fa03d2': `安全分類器がエージェントのセッションの一部を止め、セッションはそのまま続いた（safety_stops）`,
 's525b03a82e5421df': `失敗の後の、次のモデルでの新しいエージェントのセッション（Router のホップ）`,
 's525c011dcf23c207': `記録から再生した試行（replayed）`,
 's529efbcb1a0cf166': str`上限 ${0}`,
@@ -502,6 +506,7 @@
 'sa434ad4d2100f245': `作成元`,
 'sa48318e1513f445c': `コマンドライン`,
 'sa4f4addc6a836fcf': str`最大 ${0} 回`,
+'sa508a8fb4e60520e': `安全分類器による停止 1 件`,
 'sa50a6326530d8a0d': `折りたたむ`,
 'sa57b5e86ecb7d735': `権限エラーになったツール呼び出し`,
 'sa58fd816ed43f98e': `周回数`,
@@ -585,6 +590,7 @@
 'sbd4aeb401e751129': `実行を切り替え（r）`,
 'sbd58f76b47025b9c': `停止の記録なし`,
 'sbd9a674a977ac3b7': `再開後`,
+'sbdc36a52f3bf5b79': str`履歴にほか ${0} 件`,
 'sbe299a9270c76655': `実行履歴の失敗した試行`,
 'sbe4c836868862bb2': str`${0} の記録から再生したエージェントのセッション（replay）`,
 'sbe920e285458a813': str`週（${0}）`,
@@ -629,6 +635,7 @@
 'scbd3558d2cfc7dc3': `全文`,
 'sccad21b77f9a317c': str`最も高い種別: ${0}`,
 'sccce3de7b4abfdfe': `モデルが応答を拒否`,
+'scd16bc5ac18bdf91': `モデルの応答`,
 'scd27d0ff0f4f8757': str`${0}: ${1} → 次のモデル`,
 'scd945ec17b61f103': `エージェントの所要時間`,
 'scd9ce582cd9e0daf': str`優先度 ${0}`,
@@ -676,6 +683,7 @@
 'sdd4a8ac67f7885c1': `モデル 1 種類`,
 'sdd826d4b3e02f41b': `修正依頼なし`,
 'sddf65e6dc438188d': `ビューを表示`,
+'sde7cbc4291a82cc4': `履歴にほか 1 件`,
 'sde88e8c24887ecfe': str`アカウント ${0}`,
 'sdf14d39488c16f16': str`${0} 回目で完了 | 失敗 1 回 | 最初の失敗: ${1}`,
 'sdf452c95fdeb4be0': `リトライなし`,
@@ -701,6 +709,7 @@
 'se6de387a56331077': `下の階層あり`,
 'se7102b7d5942a59c': str`${0} 回目`,
 'se751edc73f4d0062': `リプレイと新しいセッション`,
+'se8d06d5375424a9c': str`安全分類器による停止 ${0} 件`,
 'se90f184c6aa3ffbb': `認証情報`,
 'se99de5c72fecbbc3': `ロック`,
 'se99f79da6128e386': str`終了（失敗したタスク ${0} 件）`,
@@ -753,11 +762,13 @@
 'sf7d87f0549046c0a': str`残り ${0}`,
 'sf7e6e6be222007c3': `すべての実行グループ`,
 'sf82a1121505029b9': str`休止 ${0} → ${1}`,
+'sf868eba1173ef02e': `内容不明`,
 'sf93c7009f950942a': `合計`,
 'sf9bbecb9ed98e966': `エージェントのセッションが始まらなかった`,
 'sfa04f4ef1995407e': `テキスト`,
 'sfa251e3af0f9c14c': str`${0} 〜 ${1}`,
 'sfa6a5b4597c720bc': `フィルターに一致するタスクなし`,
+'sfa82224480602f92': `ツールのリクエスト`,
 'sfadf0e9dfc4b3030': `修正依頼 1 回で完了`,
 'sfae8c6e1b5f558f4': `ホスト一覧`,
 'sfb33dc608ac218c4': `実行を切り替え`,

package/src/words/index.ts

@@ -29,3 +29,4 @@ export * from './priority.js';
 export * from './context.js';
 export * from './preflight.js';
 export * from './task-definition.js';
+export * from './safety.js';

package/src/words/safety.ts

@@ -0,0 +1,37 @@
+// Words for safety stops: a safety classifier stopped part of an agent session, which
+// went on and ended on its own outcome (`JournalRow.safety_stops`, `Trends.safety_stops`).
+import type { JournalRow } from '@contraagent/api';
+import { msg, str } from '@lit/localize';
+import { facts, localTime } from './format.js';
+
+/** One safety stop of an attempt. */
+export type SafetyStop = NonNullable<JournalRow['safety_stops']>[number];
+
+/** The heading of the safety stops (the trends' table, a count's column). */
+export const safetyStopsLabel = (): string => msg('Safety stops');
+
+/** A count of safety stops: `1 safety stop`, `3 safety stops`. */
+export const safetyStopCount = (n: number): string => (n === 1 ? msg('1 safety stop') : msg(str`${n} safety stops`));
+
+/** What a safety stop is, for its tooltip. */
+export const safetyStopTip = (): string => msg('A safety classifier stopped part of the agent session, and the session went on (safety_stops)');
+
+/** What the safety classifier stopped (`SafetyStop.part`), in words. */
+export function safetyPartLabel(part: string | null | undefined): string {
+  switch (part) {
+    case 'response':
+      return msg('model response', { desc: 'A safety stop of a response of the model of the agent session' });
+    case 'tool':
+      return msg('tool request', { desc: 'A safety stop of a request of a model that a tool calls; the tool call ended in an error' });
+    case 'unread':
+      return msg('unrecognized', { desc: 'A safety stop the coding agent counted, in words this contraagent version does not recognize' });
+    default:
+      return part || '—';
+  }
+}
+
+/** The column of the trends' table that names what was stopped. */
+export const safetyPartColumn = (): string => msg('Stopped part', { desc: 'A column: what a safety classifier stopped (a model response, a tool request)' });
+
+/** One safety stop as a row of its known facts: `model response | opus | cyber | 2026-10-11 09:00:01`. */
+export const safetyStopLine = (s: SafetyStop): string => facts(safetyPartLabel(s.part), s.model, s.category, s.tool, localTime(s.ts, true));