@contraagent/ui 0.0.0-stage → 0.2.0

package/src/words/stop.ts

@@ -0,0 +1,65 @@
+// How an attempt ended (a journal row's `stop`), in words.
+import { inputProblems, type Stop } from '@contraagent/api';
+import { msg, str } from '@lit/localize';
+import { isStop } from '../lib/tone.js';
+
+/**
+ * How one attempt ended (a journal row's `stop`), in words. A value contraagent does not write is shown as it is.
+ * With the row's `reason`, a refused input names its problem (missing, or failed checks).
+ */
+export function stopLabel(stop: string | null | undefined, reason?: string | null): string {
+  if (!stop) return '—';
+  return isStop(stop) ? knownStopLabel(stop, reason) : msg(str`unknown (${stop})`);
+}
+
+/** A stop contraagent writes, in words: every `Stop` has a case, or this fails type-checking. */
+function knownStopLabel(stop: Stop, reason?: string | null): string {
+  switch (stop) {
+    case 'completed':
+      return msg('done', { id: 'stop-completed', desc: 'How an attempt ended: completed' });
+    case 'skipped':
+      return msg('skipped');
+    case 'partial':
+      return msg('partly done', { id: 'stop-partial', desc: 'How an attempt ended: partial, its output a placeholder' });
+    case 'invalid_input': {
+      const kinds = new Set(inputProblems(reason).map((p) => p.problem));
+      if (kinds.size === 1 && kinds.has('missing')) return msg('not started (input missing)');
+      if (kinds.size === 1 && kinds.has('checks')) return msg('not started (input failed checks)');
+      if (kinds.size === 1 && kinds.has('failed')) return msg('not started (earlier task failed)');
+      if (kinds.size === 2 && kinds.has('missing') && kinds.has('checks')) return msg('not started (input missing and input failed checks)');
+      return msg('not started', { id: 'stop-invalid-input', desc: 'How an attempt ended: invalid_input, with no input named' });
+    }
+    case 'invalid_output':
+      return msg('failed checks');
+    case 'timeout':
+      return msg('timed out');
+    case 'max_turns':
+      return msg('turn limit reached');
+    case 'budget':
+      return msg('cost limit reached');
+    case 'context_budget':
+      return msg('context limit reached');
+    case 'stalled':
+      return msg('stalled (no events)');
+    case 'auth_failed':
+      return msg('authentication failed');
+    case 'api_error':
+      return msg('API error');
+    case 'rate_limited':
+      return msg('rate limited');
+    case 'refused':
+      return msg('refused by the model');
+    case 'aborted':
+      return msg('aborted');
+    case 'denied':
+      return msg('permission denied');
+    case 'error':
+      return msg('error');
+    case 'no_output':
+      return msg('ended without a result');
+    case 'launch_failed':
+      return msg('agent session did not start');
+    case 'credential_mismatch':
+      return msg('wrong identity used');
+  }
+}

package/src/words/table.ts

@@ -0,0 +1,10 @@
+// The words of a `<cae-data-table>`.
+import type { DataTableStrings } from '@contraagent/elements/data-table';
+import { msg } from '@lit/localize';
+
+/** A table's words; `empty` is what it shows with no rows. */
+export const tableStrings = (empty: string): Required<DataTableStrings> => ({
+  empty,
+  sortAscending: msg('Sort ascending'),
+  sortDescending: msg('Sort descending'),
+});

package/src/words/task-definition.ts

@@ -0,0 +1,37 @@
+// Words for the facts of a task definition that need more than a label: a Python
+// task's retries, the parts of an output file it keeps, another kind's output it writes,
+// the kind it is one implementation of.
+import { msg, str } from '@lit/localize';
+
+/** The label of a Python task's retries. */
+export const retriesLabel = (): string => msg('Retries');
+
+/** A number of retries: `up to 2`. */
+export const retriesText = (n: number): string => msg(str`up to ${n}`, { desc: 'A number of retries' });
+
+/** The label of the exceptions that give a Python task another attempt. */
+export const retriedExceptionsLabel = (): string => msg('Retried exceptions');
+
+/** What they are, for their tooltip. */
+export const retriedExceptionsTip = (): string => msg('Exceptions that give another attempt (retry_on)');
+
+/** The label of the parts of an output file a task must keep as they were (`preserve`). */
+export const preserveLabel = (): string => msg('Must stay unchanged');
+
+/** What they are, for their tooltip. */
+export const preserveTip = (): string => msg('Parts of the output file kept as before the task (preserve)');
+
+/** The output of another kind that a task writes in place of its own (`output_of`): `output of draft`. */
+export const outputOfText = (kind: string): string => msg(str`output of ${kind}`, { desc: "Another kind's output file that this task writes" });
+
+/** What that is, for its tooltip. */
+export const outputOfTip = (): string => msg('The kind whose output file this task writes (output_of)');
+
+/** The label of the kind an implementation kind is one implementation of (`base_kind`). */
+export const implementationOfLabel = (): string => msg('Implementation of', { desc: 'A task definition: the kind that this kind is one implementation of' });
+
+/** An implementation kind, in a list of kinds: `Implementation of review`. */
+export const implementationOfText = (kind: string): string => msg(str`Implementation of ${kind}`);
+
+/** What a base kind is, for its tooltip. */
+export const implementationOfTip = (): string => msg('A kind that other kinds implement (base_kind)');

package/src/words/time-box.ts

@@ -0,0 +1,21 @@
+// A flow call's own deadline (`time_box`), in words: the function node of the
+// pipeline graph and its flow calls show it.
+import type { TimeBoxRecord } from '@contraagent/api';
+import { msg, str } from '@lit/localize';
+import { facts, fmtDur, listText, localTime } from './format.js';
+
+/** A deadline's terms: `45m 00s | finishing time 15m 00s | finishing kinds: lint_fixer, report`. */
+export function timeBoxFacts(box: TimeBoxRecord): string {
+  const kinds = box.finishing_kinds ?? [];
+  return facts(
+    fmtDur(box.deadline_s),
+    box.grace_s && kinds.length ? msg(str`finishing time ${fmtDur(box.grace_s)}`) : '',
+    kinds.length ? msg(str`finishing kinds: ${listText(kinds)}`) : '',
+  );
+}
+
+/** When one flow call's deadline falls, as an absolute time: `10/14 11:16:00`. */
+export const deadlineAtText = (iso: string): string => localTime(iso, true);
+
+/** The tooltip of a deadline row: the term, in code. */
+export const timeBoxTip = (): string => msg('A deadline of its own (time_box)');

package/src/words/trends.ts

@@ -0,0 +1,118 @@
+// Words for the trends: what the runs of a period add up to (`/api/trends`).
+import { msg, str } from '@lit/localize';
+import { getLocale } from '../core/i18n.js';
+
+/** The trends page's name: in the run picker, the page's heading and the browser tab. */
+export const trendsTitle = (): string => msg('Trends');
+/** What the trends page shows, for the run picker's entry and the page's tooltip. */
+export const trendsTip = (): string => msg('Totals of the runs in a period');
+/** The trends page's first tab: the trends, with the custom views that name no tab. */
+export const trendsFirstTab = (): string => msg('Summary', { desc: "The trends page's first tab: what the runs of the period add up to, beside the tabs of the custom views" });
+
+/** A day of the period (YYYY-MM-DD) with its month as a word: `Oct 14`. */
+export function dayLabel(day: string, locale: string = getLocale()): string {
+  const d = new Date(`${day}T12:00:00Z`);
+  if (Number.isNaN(d.getTime())) return day;
+  return new Intl.DateTimeFormat(locale, { month: 'short', day: 'numeric', timeZone: 'UTC' }).format(d);
+}
+
+/** The period in words: `Oct 1 to Oct 14, 2026 | Asia/Tokyo`. */
+export function periodLabel(from: string, to: string, tz: string, locale: string = getLocale()): string {
+  const year = to.slice(0, 4);
+  return msg(str`${dayLabel(from, locale)} to ${dayLabel(to, locale)}, ${year} | ${tz}`, { desc: 'The days the trends cover, and the time zone they are counted in' });
+}
+
+/** A length of period ending today: `7 days`. */
+export const lastDays = (n: number): string => msg(str`${n} days`, { desc: 'A period of the trends: the last N days, today included' });
+export const customPeriod = (): string => msg('Dates', { desc: 'A period of the trends from one chosen day to another' });
+export const fromLabel = (): string => msg('From', { desc: 'The first day of the trends period' });
+export const toLabel = (): string => msg('To', { desc: 'The last day of the trends period' });
+export const zoneLabel = (): string => msg('Time zone');
+export const groupLabel = (): string => msg('Run group');
+export const allGroups = (): string => msg('All run groups');
+
+/** Monday to Sunday, short, in the UI's language (the rows of the run starts' grid). */
+export function weekdayLabels(locale: string = getLocale()): string[] {
+  const f = new Intl.DateTimeFormat(locale, { weekday: 'short', timeZone: 'UTC' });
+  // 2026-10-12 was a Monday.
+  return Array.from({ length: 7 }, (_, i) => f.format(new Date(Date.UTC(2026, 9, 12 + i, 12))));
+}
+
+/** The headings and labels of the trends' sections. */
+export const trendWords = () => ({
+  runs: msg('Runs', { id: 'trends-runs', desc: 'How many runs worked in the trends period' }),
+  attempts: msg('Attempts'),
+  done: msg('Done'),
+  cost: msg('Cost'),
+  tokens: msg('Tokens'),
+  time: msg('Time'),
+  costByDay: msg('Cost by day'),
+  costByDayTip: msg('Reported by the coding agent, on the day each attempt ended'),
+  kinds: msg('Kinds'),
+  kind: msg('Kind'),
+  group: msg('Group'),
+  tasks: msg('Tasks'),
+  tasksDone: msg('Tasks done'),
+  partial: msg('Partly done', { id: 'trends-partial', desc: 'A column: tasks or attempts whose output is a placeholder (partial)' }),
+  medianTime: msg('Median time'),
+  totalTime: msg('Total time'),
+  models: msg('Models'),
+  model: msg('Model'),
+  sessions: msg('Agent sessions'),
+  calls: msg('API calls'),
+  input: msg('Input'),
+  output: msg('Output'),
+  cacheRead: msg('Cache read'),
+  cacheWrite: msg('Cache write'),
+  outcomes: msg('Attempts not done'),
+  outcome: msg('Outcome'),
+  denials: msg('Denied tool calls'),
+  toolCalls: msg('Tool calls'),
+  pythonKinds: msg('Python tasks'),
+  tool: msg('Tool'),
+  usage: msg('Subscription usage'),
+  usageTip: msg('The highest reading of each day'),
+  deferred: msg('Not run'),
+  cause: msg('Cause'),
+  task: msg('Task'),
+  when: msg('When'),
+  rests: msg('Paused identities'),
+  identity: msg('Identity'),
+  event: msg('Event'),
+  starts: msg('Run starts', { desc: 'How many runs started, by weekday and hour' }),
+  startsTip: msg('By weekday and hour, in the period\'s time zone'),
+  run: msg('Run'),
+  started: msg('Started'),
+  trendPanels: msg('Custom views'),
+});
+
+/** A count beside a title: `Not run | 64`. */
+export const titled = (title: string, n: number): string => `${title} | ${n}`;
+
+/** A deferral by a paused identity, the identity named when the run's sentence names it (`personal rests: ...`). */
+export const pausedCause = (reason: string): string => {
+  const who = /^(\S+) rests\b/.exec(reason)?.[1];
+  return who ? msg(str`Identity ${who} paused`) : msg('Identity paused');
+};
+
+/** A model's name with its coding agent: `sonnet | claude`. */
+export const modelName = (agent: string, model: string): string => (agent ? `${model || '—'} | ${agent}` : model || '—');
+
+/** An identity's window in a line's name: `personal | weekly`. */
+export const usageLine = (identity: string, window: string): string => `${identity} | ${window}`;
+
+/** A rest's start or end, in words. */
+export const restEvent = (event: string | null | undefined): string =>
+  event === 'end' ? msg('ended', { desc: 'A paused identity was used again' }) : event === 'start' ? msg('started', { desc: 'An identity began its pause' }) : event || '—';
+
+/** A day's share of an amount: `$1.20 a day`. */
+export const perDay = (amount: string): string => msg(str`${amount} a day`, { desc: 'An average over the days of the trends period that had any cost' });
+
+/** The share of attempts done: `Done 97%`. */
+export const doneShare = (pctText: string): string => msg(str`Done ${pctText}`);
+
+/** The trends' empty state. */
+export const noRunsInPeriod = (): string => msg('No runs in this period');
+
+/** The period of an export, which a page cannot change. */
+export const exportedPeriod = (): string => msg('Period of this export');