@anchrd/intel-ui 0.14.0 → 0.16.0

package/src/i18n/de.json

@@ -282,12 +282,13 @@
   "agent.tab.chat": "Chat",
   "agent.tab.calendar": "Kalender",
   "agent.tab.log": "Protokoll",
-  "agent.statusRunning": "Läuft",
-  "agent.statusIdle": "Bereit",
-  "agent.statusPaused": "Pausiert",
-  "agent.statusUnknown": "Laufzeit nicht erreichbar",
+  "agent.status.running": "Läuft",
+  "agent.status.waiting": "Wartet auf den nächsten Lauf",
+  "agent.status.failed": "Letzter Lauf fehlgeschlagen",
+  "agent.status.paused": "Pausiert",
+  "agent.status.unknown": "Laufzeit nicht erreichbar",
   "agent.nextRun": "nächster Lauf {when} ({zone})",
-  "agent.noNextRun": "kein geplanter Lauf",
+  "agent.lastRun": "letzter Lauf {when}",
   "agent.pausedNoRuns": "kein Zeitplan feuert, keine Aufgabe und keine Mail wird angenommen; der Chat antwortet weiter",
   "agent.pause": "Pausieren",
   "agent.resume": "Fortsetzen",
@@ -296,6 +297,7 @@
   "agent.runNowPaused": "Setze den Agenten fort, bevor du ihn ausführst.",
   "agent.actionFailed": "Das hat nicht funktioniert. Versuche es erneut.",
   "agent.keyMissing": "Dieser Agent hat keinen Application-Key, deshalb kann kein Lauf starten. Ersetze seinen Key unter „Identität“ im Profil.",
+  "agent.createdBy": "von {name}",
   "agent.notPermitted": "Du darfst diesen Agenten lesen, aber nicht steuern. Dafür braucht es die Berechtigung „Agenten ausführen“.",
   "agent.noRuntime": "Diese Installation betreibt keine Agenten-Laufzeit, deshalb kann dieser Agent hier weder chatten noch laufen. Seine Definition bleibt erhalten und funktioniert wieder auf einer Installation, die eine hat.",
   "agent.loadFailed": "Dieser Agent konnte nicht geladen werden. Prüfe deinen Zugriff und versuche es erneut.",
@@ -320,10 +322,10 @@
   "agent.contactAdd": "Erreichbarkeit hinzufügen",
   "agent.contactAddReason": "Eine Mail-Adresse gehört der Installation, nicht der Definition des Agenten — sie wird dort konfiguriert, wo die Laufzeit betrieben wird.",
   "agent.knows": "Was er weiß",
-  "agent.knowsHint": "Die Ordner, die dieser Agent liest, und wofür jeder davon zählt. Eine Systemnachricht weist ihn an, semantischer Kontext wird durchsucht, in das Gedächtnis wird zurückgeschrieben.",
-  "agent.addReference": "Ordner hinzufügen",
+  "agent.knowsHint": "Was dieser Agent liest, und wofür jeder Eintrag zählt. Eine Systemnachricht weist ihn an — ein Ordner, ein Dokument oder eine Tabelle. Semantischer Kontext wird durchsucht, und in das Gedächtnis wird zurückgeschrieben und es wird ebenso durchsucht, deshalb sind beide Ordner. Der Name verspricht weniger als die Rolle: Was der Agent sich im Gedächtnis notiert, kommt ihm bei jeder späteren Suche wieder entgegen.",
+  "agent.addReference": "Etwas zum Lesen hinzufügen",
   "agent.removeReferenceOf": "{title} nicht mehr lesen",
-  "agent.pickFolder": "Zu lesender Ordner",
+  "agent.pickEntry": "Was gelesen wird",
   "agent.roleFor": "Wofür {title} zählt",
   "agent.role.system-message": "Systemnachricht",
   "agent.role.semantic-context": "Semantischer Kontext",
@@ -335,11 +337,12 @@
   "agent.removeToolServerOf": "{name} diesem Agenten wegnehmen",
   "agent.toolServerUnavailable": "Du erreichst diesen Server nicht mehr",
   "agent.toolsDelegationNotice": "Wer diesen Agenten ausführen darf, handelt auf deiner Verbindung.",
+  "agent.toolsDelegationNoticeBy": "Wer diesen Agenten ausführen darf, handelt auf der Verbindung von {name}.",
+  "agent.toolsDelegationNoticeSomebody": "Wer diesen Agenten ausführen darf, handelt auf der Verbindung dessen, der ihm diese Werkzeuge gegeben hat — nicht auf deiner.",
   "agent.toolsNotConnected": "Du bist noch nicht am Firmenportal angemeldet, es gibt also nichts abzugeben. Öffne „Werkzeuge“, um dich zu verbinden.",
   "agent.toolsNoneLeft": "Jeder Server, den du erreichst, ist diesem Agenten bereits gegeben.",
   "agent.schedule": "Zeitplan",
   "agent.scheduleHint": "Wann dieser Agent von sich aus handelt und was er ausführt. Jeder Zeitplan behält die Zeitzone, die er bekommen hat — er meint damit für alle Lesenden dieselbe Stunde.",
-  "agent.scheduleEmpty": "Dieser Agent läuft nur, wenn er gefragt wird.",
   "agent.addSchedule": "Zeitplan hinzufügen",
   "agent.removeSchedule": "Diesen Zeitplan entfernen",
   "agent.scheduleTarget": "Was ausgeführt wird",
@@ -350,8 +353,23 @@
   "agent.model": "Modell",
   "agent.modelHint": "Welches Modell denkt. Eine Änderung übernimmt die Laufzeit innerhalb einer Minute.",
   "agent.modelFigures": "{context} Kontext · {input} $ rein / {output} $ raus je 1 Mio. Token",
+  "agent.usage": "{input} rein · {output} raus · {cacheRead} Cache gelesen · {cacheWrite} Cache geschrieben",
+  "agent.usageUnknown": "Für diesen Lauf sind keine Verbrauchszahlen erfasst",
+  "agent.usageNotReported": "Dieser Anbieter meldet keinen Verbrauch",
+  "agent.costMissing": "Kosten stehen nicht im Gateway-Log",
+  "agent.costNotConfigured": "Keine Kostenangabe: Diese Installation hat kein Lese-Token für das AI Gateway.",
+  "agent.costUnreadable": "Keine Kostenangabe: Das AI-Gateway-Log war nicht lesbar.",
+  "agent.costPartial": "Das Gateway-Log wurde bis zur Seitengrenze gelesen — diese Summen sind eine Untergrenze.",
+  "agent.costWindow": "Letzte {days} Tage",
+  "agent.costWindowCalls": "{count} Modellaufrufe",
+  "agent.costs": "Kosten",
+  "agent.costsSpent": "{amount} in den letzten {days} Tagen",
+  "agent.costsSpentPast": "Bereits ausgegeben, für vergangene Läufe — keine Vorhersage für das oben gewählte Modell.",
+  "agent.costsSpentWith": "mit {models}",
+  "agent.modelFiguresStale": "Diese Angaben stammen aus einer eingebauten Tabelle und können veraltet sein.",
   "agent.calendar": "Kommende Läufe",
-  "agent.calendarZones": "Jede Zeit steht in der Zeitzone ihres eigenen Zeitplans, denn dann läuft der Agent.",
+  "agent.calendarZones": "Jede Zeit steht in der Zeitzone ihres eigenen Zeitplans, denn dann läuft der Agent. Weicht deine eigene Zeitzone ab, steht sie daneben.",
+  "agent.calendarYourTime": "{when} bei dir",
   "agent.calendarUnreadable": "Keiner der Zeitpläne dieses Agenten lässt sich als Cron-Ausdruck lesen, es ist also nichts geplant.",
   "agent.log": "Läufe",
   "agent.logEmpty": "Dieser Agent ist noch nicht gelaufen.",
@@ -359,6 +377,8 @@
   "agent.runFailed": "Dieser Lauf konnte nicht gelesen werden.",
   "agent.runLog": "Was dieser Lauf getan hat",
   "agent.runLogEmpty": "Dieser Lauf hat nichts aufgezeichnet.",
+  "agent.runAnswer": "Was dieser Lauf geantwortet hat",
+  "agent.runAnswerEmpty": "Dieser Lauf hat keine Antwort aufgezeichnet.",
   "agent.steps": "{count} Schritte",
   "agent.trigger.chat": "aus dem Chat",
   "agent.trigger.schedule": "nach Zeitplan",

package/src/i18n/en.json

@@ -282,12 +282,13 @@
   "agent.tab.chat": "Chat",
   "agent.tab.calendar": "Calendar",
   "agent.tab.log": "Log",
-  "agent.statusRunning": "Running",
-  "agent.statusIdle": "Idle",
-  "agent.statusPaused": "Paused",
-  "agent.statusUnknown": "Runtime not reachable",
+  "agent.status.running": "Running",
+  "agent.status.waiting": "Waiting for its next run",
+  "agent.status.failed": "Last run failed",
+  "agent.status.paused": "Paused",
+  "agent.status.unknown": "Runtime not reachable",
   "agent.nextRun": "next run {when} ({zone})",
-  "agent.noNextRun": "no scheduled run",
+  "agent.lastRun": "last run {when}",
   "agent.pausedNoRuns": "no schedule fires, no task and no mail is taken; the chat still answers",
   "agent.pause": "Pause",
   "agent.resume": "Resume",
@@ -296,6 +297,7 @@
   "agent.runNowPaused": "Resume the agent before running it.",
   "agent.actionFailed": "That did not work. Try again.",
   "agent.keyMissing": "This agent has no application key, so no run can start. Replace its key under Identity in the profile.",
+  "agent.createdBy": "by {name}",
   "agent.notPermitted": "You may read this agent, but not drive it. Driving an agent needs the “run agents” permission.",
   "agent.noRuntime": "This installation runs no agent runtime, so this agent cannot chat or run here. Its definition is kept and works again on an installation that has one.",
   "agent.loadFailed": "This agent could not be loaded. Check your access and try again.",
@@ -320,10 +322,10 @@
   "agent.contactAdd": "Add contact",
   "agent.contactAddReason": "A mail address belongs to the installation, not to the agent's definition, so it is configured where the runtime is deployed.",
   "agent.knows": "What it knows",
-  "agent.knowsHint": "The folders this agent reads, and what each one counts as. A system message instructs it, semantic context is searched, memory is written back to.",
-  "agent.addReference": "Add folder",
+  "agent.knowsHint": "What this agent reads, and what each entry counts as. A system message instructs it — a folder, a document or a table. Semantic context is searched, and memory is written back to and searched as well, so both of those are folders. The name promises less than the role does: what the agent notes down in memory comes back to it in every later search.",
+  "agent.addReference": "Add something to read",
   "agent.removeReferenceOf": "Stop reading {title}",
-  "agent.pickFolder": "Folder to read",
+  "agent.pickEntry": "What to read",
   "agent.roleFor": "What {title} counts as",
   "agent.role.system-message": "System message",
   "agent.role.semantic-context": "Semantic context",
@@ -335,11 +337,12 @@
   "agent.removeToolServerOf": "Take {name} away from this agent",
   "agent.toolServerUnavailable": "You no longer reach this server",
   "agent.toolsDelegationNotice": "Anyone who may run this agent acts on your connection.",
+  "agent.toolsDelegationNoticeBy": "Anyone who may run this agent acts on the connection of {name}.",
+  "agent.toolsDelegationNoticeSomebody": "Anyone who may run this agent acts on the connection of whoever gave it these tools — not on yours.",
   "agent.toolsNotConnected": "You are not signed in to the company portal yet, so there is nothing to give away. Open Tools to connect.",
   "agent.toolsNoneLeft": "Every server you reach is already given to this agent.",
   "agent.schedule": "Schedule",
   "agent.scheduleHint": "When this agent acts on its own, and what it runs. Each schedule keeps the timezone it was given, so it means the same hour to everybody reading it.",
-  "agent.scheduleEmpty": "This agent runs only when it is asked.",
   "agent.addSchedule": "Add schedule",
   "agent.removeSchedule": "Remove this schedule",
   "agent.scheduleTarget": "What to run",
@@ -350,8 +353,23 @@
   "agent.model": "Model",
   "agent.modelHint": "Which model does the thinking. A change is picked up by the runtime within a minute.",
   "agent.modelFigures": "{context} context · ${input} in / ${output} out per 1M tokens",
+  "agent.usage": "{input} in · {output} out · {cacheRead} cache read · {cacheWrite} cache written",
+  "agent.usageUnknown": "No usage figures for this run",
+  "agent.usageNotReported": "This provider reports no usage",
+  "agent.costMissing": "Cost not in the gateway log",
+  "agent.costNotConfigured": "No cost figures: this installation has no AI Gateway read token.",
+  "agent.costUnreadable": "No cost figures: the AI Gateway log could not be read.",
+  "agent.costPartial": "The gateway log was read up to its page limit, so these totals are a lower bound.",
+  "agent.costWindow": "Last {days} days",
+  "agent.costWindowCalls": "{count} model calls",
+  "agent.costs": "Cost",
+  "agent.costsSpent": "{amount} in the last {days} days",
+  "agent.costsSpentPast": "Already spent, on past runs — not a forecast for the model chosen above.",
+  "agent.costsSpentWith": "with {models}",
+  "agent.modelFiguresStale": "These figures come from a built-in table and can be out of date.",
   "agent.calendar": "Upcoming runs",
-  "agent.calendarZones": "Each time is shown in the timezone of its own schedule, because that is when the agent runs.",
+  "agent.calendarZones": "Each time is shown in the timezone of its own schedule, because that is when the agent runs. Where your own timezone differs, it is added beside it.",
+  "agent.calendarYourTime": "{when} your time",
   "agent.calendarUnreadable": "None of this agent's schedules can be read as a cron expression, so nothing is planned.",
   "agent.log": "Runs",
   "agent.logEmpty": "This agent has not run yet.",
@@ -359,6 +377,8 @@
   "agent.runFailed": "This run could not be read.",
   "agent.runLog": "What this run did",
   "agent.runLogEmpty": "This run recorded nothing.",
+  "agent.runAnswer": "What this run answered",
+  "agent.runAnswerEmpty": "This run recorded no answer.",
   "agent.steps": "{count} steps",
   "agent.trigger.chat": "from the chat",
   "agent.trigger.schedule": "on schedule",

package/src/i18n/es.json

@@ -282,12 +282,13 @@
   "agent.tab.chat": "Chat",
   "agent.tab.calendar": "Calendario",
   "agent.tab.log": "Registro",
-  "agent.statusRunning": "En marcha",
-  "agent.statusIdle": "Inactivo",
-  "agent.statusPaused": "En pausa",
-  "agent.statusUnknown": "Entorno de ejecución no accesible",
+  "agent.status.running": "En marcha",
+  "agent.status.waiting": "Esperando su próxima ejecución",
+  "agent.status.failed": "La última ejecución falló",
+  "agent.status.paused": "En pausa",
+  "agent.status.unknown": "Entorno de ejecución no accesible",
   "agent.nextRun": "próxima ejecución {when} ({zone})",
-  "agent.noNextRun": "sin ejecución programada",
+  "agent.lastRun": "última ejecución {when}",
   "agent.pausedNoRuns": "no se dispara ningún horario, no se acepta ninguna tarea ni ningún correo; el chat sigue respondiendo",
   "agent.pause": "Pausar",
   "agent.resume": "Reanudar",
@@ -296,6 +297,7 @@
   "agent.runNowPaused": "Reanuda el agente antes de ejecutarlo.",
   "agent.actionFailed": "Eso no ha funcionado. Inténtalo de nuevo.",
   "agent.keyMissing": "Este agente no tiene clave de aplicación, así que no puede empezar ninguna ejecución. Sustituye su clave en «Identidad», dentro del perfil.",
+  "agent.createdBy": "por {name}",
   "agent.notPermitted": "Puedes leer este agente, pero no manejarlo. Manejar un agente necesita el permiso «ejecutar agentes».",
   "agent.noRuntime": "Esta instalación no tiene entorno de ejecución de agentes, así que este agente no puede chatear ni ejecutarse aquí. Su definición se conserva y vuelve a funcionar en una instalación que sí lo tenga.",
   "agent.loadFailed": "Este agente no se ha podido cargar. Comprueba tu acceso e inténtalo de nuevo.",
@@ -320,10 +322,10 @@
   "agent.contactAdd": "Añadir un contacto",
   "agent.contactAddReason": "Una dirección de correo pertenece a la instalación, no a la definición del agente, así que se configura donde está desplegado el entorno de ejecución.",
   "agent.knows": "Lo que sabe",
-  "agent.knowsHint": "Las carpetas que lee este agente y para qué cuenta cada una. Un mensaje de sistema lo instruye, el contexto semántico se busca, en la memoria se escribe de vuelta.",
-  "agent.addReference": "Añadir una carpeta",
+  "agent.knowsHint": "Lo que lee este agente y para qué cuenta cada entrada. Un mensaje de sistema lo instruye — una carpeta, un documento o una tabla. El contexto semántico se busca, y en la memoria se escribe de vuelta y también se busca, por eso ambas son carpetas. El nombre promete menos que el papel: lo que el agente anota en la memoria le vuelve en cada búsqueda posterior.",
+  "agent.addReference": "Añadir algo para leer",
   "agent.removeReferenceOf": "Dejar de leer {title}",
-  "agent.pickFolder": "Carpeta que leer",
+  "agent.pickEntry": "Qué se lee",
   "agent.roleFor": "Para qué cuenta {title}",
   "agent.role.system-message": "Mensaje de sistema",
   "agent.role.semantic-context": "Contexto semántico",
@@ -335,11 +337,12 @@
   "agent.removeToolServerOf": "Quitarle {name} a este agente",
   "agent.toolServerUnavailable": "Ya no alcanzas este servidor",
   "agent.toolsDelegationNotice": "Quien pueda ejecutar este agente actúa sobre tu conexión.",
+  "agent.toolsDelegationNoticeBy": "Quien pueda ejecutar este agente actúa sobre la conexión de {name}.",
+  "agent.toolsDelegationNoticeSomebody": "Quien pueda ejecutar este agente actúa sobre la conexión de quien le dio estas herramientas, no sobre la tuya.",
   "agent.toolsNotConnected": "Todavía no has iniciado sesión en el portal de la empresa, así que no hay nada que ceder. Abre «Herramientas» para conectarte.",
   "agent.toolsNoneLeft": "Todos los servidores que alcanzas ya están dados a este agente.",
   "agent.schedule": "Horario",
   "agent.scheduleHint": "Cuándo actúa este agente por su cuenta y qué ejecuta. Cada horario conserva la zona horaria con la que se creó, así que significa la misma hora para todo el que lo lea.",
-  "agent.scheduleEmpty": "Este agente solo se ejecuta cuando se le pide.",
   "agent.addSchedule": "Añadir un horario",
   "agent.removeSchedule": "Quitar este horario",
   "agent.scheduleTarget": "Qué ejecutar",
@@ -350,8 +353,23 @@
   "agent.model": "Modelo",
   "agent.modelHint": "Qué modelo piensa. El entorno de ejecución recoge un cambio en menos de un minuto.",
   "agent.modelFigures": "{context} de contexto · {input} $ de entrada / {output} $ de salida por cada millón de tokens",
+  "agent.usage": "{input} de entrada · {output} de salida · {cacheRead} leídos de caché · {cacheWrite} escritos en caché",
+  "agent.usageUnknown": "No hay cifras de consumo para esta ejecución",
+  "agent.usageNotReported": "Este proveedor no informa del consumo",
+  "agent.costMissing": "El coste no figura en el registro de la pasarela",
+  "agent.costNotConfigured": "Sin cifras de coste: esta instalación no tiene un token de lectura de AI Gateway.",
+  "agent.costUnreadable": "Sin cifras de coste: no se pudo leer el registro de AI Gateway.",
+  "agent.costPartial": "El registro de la pasarela se leyó hasta su límite de páginas, así que estos totales son un mínimo.",
+  "agent.costWindow": "Últimos {days} días",
+  "agent.costWindowCalls": "{count} llamadas al modelo",
+  "agent.costs": "Coste",
+  "agent.costsSpent": "{amount} en los últimos {days} días",
+  "agent.costsSpentPast": "Ya gastado, en ejecuciones pasadas: no es una previsión para el modelo elegido arriba.",
+  "agent.costsSpentWith": "con {models}",
+  "agent.modelFiguresStale": "Estas cifras proceden de una tabla incorporada y pueden estar desactualizadas.",
   "agent.calendar": "Próximas ejecuciones",
-  "agent.calendarZones": "Cada hora se muestra en la zona horaria de su propio horario, porque es cuando se ejecuta el agente.",
+  "agent.calendarZones": "Cada hora se muestra en la zona horaria de su propio horario, porque es cuando se ejecuta el agente. Si tu propia zona horaria difiere, se añade al lado.",
+  "agent.calendarYourTime": "{when} en tu hora",
   "agent.calendarUnreadable": "Ninguno de los horarios de este agente se puede leer como expresión cron, así que no hay nada planificado.",
   "agent.log": "Ejecuciones",
   "agent.logEmpty": "Este agente todavía no se ha ejecutado.",
@@ -359,6 +377,8 @@
   "agent.runFailed": "Esta ejecución no se ha podido leer.",
   "agent.runLog": "Lo que ha hecho esta ejecución",
   "agent.runLogEmpty": "Esta ejecución no ha registrado nada.",
+  "agent.runAnswer": "Lo que ha respondido esta ejecución",
+  "agent.runAnswerEmpty": "Esta ejecución no ha registrado ninguna respuesta.",
   "agent.steps": "{count} pasos",
   "agent.trigger.chat": "desde el chat",
   "agent.trigger.schedule": "por horario",

package/src/section-hint/section-hint.tsx

@@ -0,0 +1,40 @@
+import { Info } from "lucide-react";
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@/components/ui/tooltip";
+
+/**
+ * An explanation behind an ⓘ, beside the thing it explains (#204, shared since #249).
+ *
+ * It exists for the sentence that answers "what IS this" — read once, then furniture. Not for the
+ * sentence you need WHILE you type: `agent.cronHint` ("five fields: minute, hour, …") deliberately
+ * stays a visible paragraph, because a reference you read while writing must not be behind a hover.
+ * That is the dividing line: *what is this* may hide, *how do I write this* may not.
+ *
+ * ⚠️ The hint is the trigger's accessible NAME, not only the tooltip's content: Radix describes the
+ * trigger by the content only while it is open, and a listener who tabs past a nameless icon button
+ * would never learn there is anything behind it.
+ *
+ * ⚠️ A real `<button>`, not a bare icon or a `<span>` with a hover style. A tooltip that only opens
+ * on hover cannot be opened at all on a touch device, and an element that is not focusable is one
+ * the keyboard walks straight past.
+ *
+ * ⚠️ It does NOT replace a field's description. Where this sits beside a form control, the control
+ * keeps its own `aria-describedby` pointing at an `sr-only` copy of the same words — the tooltip's
+ * content is in the accessibility tree only while it is open, so a field that gave up its
+ * description for one would quietly have lost it (#249).
+ */
+export function SectionHint({ hint }: { hint: string }) {
+  return (
+    <TooltipProvider delayDuration={300}>
+      <Tooltip>
+        <TooltipTrigger
+          type="button"
+          aria-label={hint}
+          className="rounded-full text-muted-foreground outline-none hover:text-foreground focus-visible:ring-2 focus-visible:ring-ring"
+        >
+          <Info aria-hidden="true" className="size-3.5" />
+        </TooltipTrigger>
+        <TooltipContent className="max-w-xs">{hint}</TooltipContent>
+      </Tooltip>
+    </TooltipProvider>
+  );
+}

package/src/timezone/timezone-context.tsx

@@ -1,10 +1,17 @@
 import { createContext, type ReactNode, useContext, useMemo, useState } from "react";
-import { browserTimezone, readTimezone, rememberTimezone } from "./timezone.ts";
+import { browserTimezone, readChosenTimezone, rememberTimezone } from "./timezone.ts";
 
 // The React seam of the timezone preference, the same shape as i18n-context and theme-context.
 
 export interface TimezoneSelection {
+  /** The zone to read times in: the choice, or the browser's own where there is none. */
   current: string;
+  /**
+   * ⚠️ The zone somebody actually CHOSE — `null` while they never did (#256). `current` cannot
+   * answer this: it falls back to the browser, and a screen that treated that as a preference would
+   * annotate every schedule with a guess nobody made.
+   */
+  chosen: string | null;
   select(zone: string): void;
 }
 
@@ -16,17 +23,18 @@ interface TimezoneProviderProps {
 }
 
 export function TimezoneProvider({ store, children }: TimezoneProviderProps) {
-  const [current, setCurrent] = useState(() => readTimezone(store));
+  const [chosen, setChosen] = useState(() => readChosenTimezone(store));
 
   const selection = useMemo<TimezoneSelection>(
     () => ({
-      current,
+      current: chosen ?? browserTimezone(),
+      chosen,
       select: (zone) => {
         rememberTimezone(zone, store);
-        setCurrent(zone);
+        setChosen(zone);
       },
     }),
-    [current, store],
+    [chosen, store],
   );
 
   return <TimezoneContext value={selection}>{children}</TimezoneContext>;
@@ -43,3 +51,15 @@ export function useTimezone(): string {
   const selection = useContext(TimezoneContext);
   return selection?.current ?? browserTimezone();
 }
+
+/**
+ * The zone the reader CHOSE, or `null` (#256).
+ *
+ * ⚠️ Not `useTimezone`. This is for screens that add the reader's own reading BESIDE a time that is
+ * already correct — the agent's calendar. Nothing may be added for somebody who never set a zone:
+ * the browser's guess presented as "your time" is a setting the reader did not make, and it would
+ * put a second time on every row of a screen that was fine as it was.
+ */
+export function useChosenTimezone(): string | null {
+  return useContext(TimezoneContext)?.chosen ?? null;
+}

package/src/timezone/timezone.ts

@@ -39,16 +39,31 @@ export function isKnownTimezone(zone: string): boolean {
   }
 }
 
-// A stored zone the engine no longer knows is discarded rather than kept: IANA renames zones, and a
-// name that stopped resolving would otherwise throw on every date the calendar draws.
-export function readTimezone(store?: Pick<Storage, "getItem">): string {
+/**
+ * The zone the reader actually CHOSE, or `null` when they never did.
+ *
+ * ⚠️ The difference from `readTimezone` is the whole reason this exists (#256). A screen that wants
+ * to add "…and this is what it says on your clock" may only do so for a zone somebody set: falling
+ * back to the browser would put a guess on screen dressed as a preference, and the agent's calendar
+ * would start annotating every schedule for a reader who never asked for it.
+ *
+ * A stored zone the engine no longer knows counts as "never chose": IANA renames zones, and a name
+ * that stopped resolving would otherwise throw on every date the calendar draws.
+ */
+export function readChosenTimezone(store?: Pick<Storage, "getItem">): string | null {
   let stored: string | null = null;
   try {
     stored = store?.getItem(STORE_KEY) ?? null;
   } catch {
-    return browserTimezone();
+    return null;
   }
-  return stored !== null && isKnownTimezone(stored) ? stored : browserTimezone();
+  return stored !== null && isKnownTimezone(stored) ? stored : null;
+}
+
+// The zone to read times in — the choice, and the browser's own where there is none. Never null: a
+// component that has to format a date needs an answer, and the browser's is the honest one.
+export function readTimezone(store?: Pick<Storage, "getItem">): string {
+  return readChosenTimezone(store) ?? browserTimezone();
 }
 
 export function rememberTimezone(zone: string, store?: Pick<Storage, "setItem">): void {

package/src/title-row/title-row.tsx

@@ -11,10 +11,11 @@ import { ResourceMenu, type ResourceTarget } from "@/resource-menu/resource-menu
  * the rule could be forgotten. That is the whole point: the menu holds rename, move, share and
  * archive, and a position one has to look for is a position one stops using.
  *
- * The two slots are for what belongs to this thing but lives further down the tree, where its state
- * is. `title-meta` is a quiet word beside the name (a table's row count); `title-actions` is a
- * button in the group (saving a document, exporting a table). Both are filled through `ActionSlot`
- * and both sit before the menu for the same reason `children` do.
+ * The three slots are for what belongs to this thing but lives further down the tree, where its
+ * state is. `title-meta` is a quiet word beside the name (a table's row count); `title-byline` is a
+ * quiet line under it (who made an agent, #258); `title-actions` is a button in the group (saving a
+ * document, exporting a table). All are filled through `ActionSlot`, and the two in the group sit
+ * before the menu for the same reason `children` do.
  */
 export function TitleRow({
   title,
@@ -47,6 +48,10 @@ export function TitleRow({
             <h2 className="truncate text-lg font-semibold">{title}</h2>
             <span data-slot="title-meta" className="text-sm text-muted-foreground" />
           </div>
+          {/* ⚠️ `empty:hidden` is the whole rule for "no line rather than an empty one": nothing is
+              portalled in here for most kinds, and a slot that kept its margin would make every
+              head a few pixels taller for a line nobody wrote (#258). */}
+          <span data-slot="title-byline" className="mt-0.5 block min-w-0 empty:hidden" />
           {description ? <p className="mt-1 text-sm text-muted-foreground">{description}</p> : null}
         </div>
       </div>

package/src/user-name/user-name.ts

@@ -0,0 +1,41 @@
+import type { SessionUser } from "@anchrd/intel-contract";
+import { useQuery } from "@tanstack/react-query";
+import { useIntelRouterContext } from "@/router/router-context.ts";
+
+/**
+ * The signed-in person, from the one query the shell already makes.
+ *
+ * ⚠️ The same query key the user footer uses, so asking here costs no second request — and the two
+ * can never disagree about who is signed in.
+ */
+export function useSessionUser(): SessionUser | null {
+  const { data } = useIntelRouterContext();
+  const session = useQuery({ queryKey: ["session"], queryFn: () => data.getSession() });
+  return session.data ?? null;
+}
+
+/** What a person is CALLED, by the same rule the user footer follows: the name, or the address. */
+export function displayNameOf(user: SessionUser): string {
+  return user.name ?? user.email;
+}
+
+/**
+ * The display name behind a user id — or `null` where this browser cannot say.
+ *
+ * ⚠️ Today it can say for exactly one id: the signed-in person's. Intel has no user directory —
+ * `/session` answers from the token's own subject and deliberately carries nothing else, and the
+ * Gate SDK Intel holds (`authorize`, `interfaces`) has no lookup either. So a foreign id is not
+ * "probably a person whose name we could guess": it is unresolvable, and every caller here has to
+ * treat it as such.
+ *
+ * ⚠️ Never fall back to the id. An id under a name is not an answer to "who made this", it is the
+ * question again in smaller type — and it would leak an identifier onto a screen that has no reason
+ * to carry one. Callers show nothing instead (#258).
+ *
+ * This is the ONE place that changes when Intel gains a way to resolve a name (#261).
+ */
+export function useUserName(userId: string | null): string | null {
+  const me = useSessionUser();
+  if (userId === null || me === null || me.id !== userId) return null;
+  return displayNameOf(me);
+}

package/tsconfig.json

@@ -7,5 +7,11 @@
     "paths": { "@/*": ["src/*"] },
     "types": ["vite/client"]
   },
-  "include": ["src/**/*.ts", "src/**/*.tsx", "vite.config.ts"]
+  "include": [
+    "src/**/*.ts",
+    "src/**/*.tsx",
+    "vite.config.ts",
+    "vitest.config.ts",
+    "vitest.setup.ts"
+  ]
 }