@anchrd/intel-ui 0.13.0 → 0.15.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, deshalb sind beide Ordner.",
+  "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.",
@@ -379,6 +397,10 @@
   "settings.appearance.dark": "Dunkel",
   "settings.timezone": "Zeitzone",
   "settings.timezoneHint": "Zum Lesen von Zeiten, und als Vorschlag, wenn du einem Agenten einen Zeitplan gibst. Ein Zeitplan behält die Zeitzone, die er bekommen hat — eine Reise verschiebt also keine Läufe, die du bereits gesetzt hast.",
+  "settings.timezoneSearch": "Stadt, Zone oder Versatz suchen …",
+  "settings.timezoneNoMatch": "Keine Zeitzone passt.",
+  "settings.timezoneOwn": "Dein Gerät",
+  "settings.timezoneAll": "Alle Zeitzonen",
   "auth.signOut": "Abmelden",
   "auth.signOutFailed": "Das Abmelden ist fehlgeschlagen. Prüfe deine Verbindung und versuche es erneut.",
   "signIn.refusedTitle": "Angemeldet, aber nicht angenommen",

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, so both of those are folders.",
+  "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.",
@@ -379,6 +397,10 @@
   "settings.appearance.dark": "Dark",
   "settings.timezone": "Timezone",
   "settings.timezoneHint": "Used to read times, and suggested when you give an agent a schedule. A schedule keeps the timezone it was given, so travelling does not move the runs you already set.",
+  "settings.timezoneSearch": "Search city, zone or offset…",
+  "settings.timezoneNoMatch": "No timezone matches.",
+  "settings.timezoneOwn": "Your device",
+  "settings.timezoneAll": "All timezones",
   "auth.signOut": "Sign out",
   "auth.signOutFailed": "Signing out failed. Check your connection and try again.",
   "signIn.refusedTitle": "Signed in, but not accepted",

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, por eso ambos son carpetas.",
+  "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.",
@@ -379,6 +397,10 @@
   "settings.appearance.dark": "Oscuro",
   "settings.timezone": "Zona horaria",
   "settings.timezoneHint": "Se usa para leer las horas y se propone cuando le das un horario a un agente. Un horario conserva la zona con la que se creó, así que viajar no mueve las ejecuciones que ya has fijado.",
+  "settings.timezoneSearch": "Buscar ciudad, zona o desfase…",
+  "settings.timezoneNoMatch": "Ninguna zona horaria coincide.",
+  "settings.timezoneOwn": "Tu dispositivo",
+  "settings.timezoneAll": "Todas las zonas horarias",
   "auth.signOut": "Cerrar sesión",
   "auth.signOutFailed": "El cierre de sesión ha fallado. Comprueba tu conexión e inténtalo de nuevo.",
   "signIn.refusedTitle": "Sesión iniciada, pero no aceptada",

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-combobox/timezone-combobox.tsx

@@ -0,0 +1,149 @@
+import { Check, ChevronsUpDown } from "lucide-react";
+import { useMemo, useState } from "react";
+import {
+  Command,
+  CommandEmpty,
+  CommandGroup,
+  CommandInput,
+  CommandItem,
+  CommandList,
+} from "@/components/ui/command";
+import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover";
+import { useI18n } from "@/i18n/i18n-context.tsx";
+import { cn } from "@/lib/utils";
+import {
+  browserTimezone,
+  type TimezoneOption,
+  timezoneOption,
+  timezoneOptions,
+} from "../timezone.ts";
+
+/**
+ * Picking one of 418 timezones.
+ *
+ * ⚠️ A `Select` was the wrong shape and this replaces it (#243). Four hundred entries cannot be
+ * scrolled to, and a bare zone name does not say whether you got the right one — `Europe/Berlin`
+ * and `Europe/Madrid` are the same clock, `America/New_York` is not. So: type to search, and the
+ * current offset stands in front of every name.
+ *
+ * ⚠️ The label is computed here, at render time, and never stored. A zone's offset AND its
+ * abbreviation move with daylight saving, so a written-down label is wrong for half of every year.
+ */
+interface TimezoneComboboxProps {
+  id: string;
+  value: string;
+  onChange(zone: string): void;
+  /** Handed in rather than read from the clock, so a test does not have to travel in time. */
+  now?: Date;
+  describedBy?: string;
+}
+
+function OptionLabel({ option }: { option: TimezoneOption }) {
+  return (
+    <>
+      {/* Fixed width, so the zone names line up into a column instead of stepping left and right
+          with every offset. Tabular figures keep "GMT+05:30" and "GMT-04:00" the same width, and
+          ⚠️ `whitespace-nowrap` is not decoration: the longest label ("GMT-09:00 · HADT") wrapped
+          onto a second line and pushed its own row out of the column. */}
+      <span className="w-36 shrink-0 whitespace-nowrap text-xs tabular-nums text-muted-foreground">
+        {option.offsetLabel}
+        {option.abbreviation ? ` · ${option.abbreviation}` : ""}
+      </span>
+      <span className="truncate">{option.zone.replace(/_/g, " ")}</span>
+    </>
+  );
+}
+
+export function TimezoneCombobox({ id, value, onChange, now, describedBy }: TimezoneComboboxProps) {
+  const i18n = useI18n();
+  const [open, setOpen] = useState(false);
+  const at = now ?? new Date();
+  // The clock is a dependency on purpose: without it in the key, a session that crossed a DST
+  // boundary would keep showing yesterday's offsets.
+  const at_ = at.getTime();
+
+  const options = useMemo(
+    () => timezoneOptions(value, new Date(at_), i18n.locale),
+    [value, at_, i18n.locale],
+  );
+  const selected = useMemo(
+    () => timezoneOption(value, new Date(at_), i18n.locale),
+    [value, at_, i18n.locale],
+  );
+  // The reader's own zone, pinned above the list: it is the answer in the overwhelming majority of
+  // cases, and finding it in a sorted list of 418 is the work this saves.
+  const own = useMemo(
+    () => timezoneOption(browserTimezone(), new Date(at_), i18n.locale),
+    [at_, i18n.locale],
+  );
+
+  const choose = (zone: string) => {
+    onChange(zone);
+    setOpen(false);
+  };
+
+  return (
+    <Popover open={open} onOpenChange={setOpen}>
+      <PopoverTrigger asChild>
+        <button
+          id={id}
+          type="button"
+          role="combobox"
+          aria-expanded={open}
+          aria-describedby={describedBy}
+          className="flex w-full items-center gap-2 rounded-md border bg-background px-3 py-2 text-left text-sm outline-none focus-visible:ring-2 focus-visible:ring-ring"
+        >
+          <OptionLabel option={selected} />
+          <ChevronsUpDown aria-hidden="true" className="ml-auto size-4 shrink-0 opacity-50" />
+        </button>
+      </PopoverTrigger>
+      <PopoverContent className="w-(--radix-popover-trigger-width) p-0" align="start">
+        {/* ⚠️ A substring filter, not cmdk's default fuzzy one. Fuzzy matches a scattered
+            subsequence, so over 418 zones "berlin" also surfaced Brisbane, Dublin and Lisbon —
+            technically a match, useless as an answer. Prefix beats contains, so typing a city puts
+            that city first. An empty search returns 1 for everything, which leaves the list in DOM
+            order: sorted west to east. */}
+        <Command
+          filter={(value, search, keywords) => {
+            const needle = search.trim().toLowerCase();
+            if (!needle) return 1;
+            const haystack = [value.toLowerCase(), ...(keywords ?? [])];
+            if (haystack.some((word) => word.startsWith(needle))) return 2;
+            return haystack.some((word) => word.includes(needle)) ? 1 : 0;
+          }}
+        >
+          <CommandInput placeholder={i18n.t("settings.timezoneSearch")} />
+          <CommandList>
+            <CommandEmpty>{i18n.t("settings.timezoneNoMatch")}</CommandEmpty>
+            {own.zone !== value ? (
+              <CommandGroup heading={i18n.t("settings.timezoneOwn")}>
+                <CommandItem value={own.zone} keywords={own.keywords} onSelect={choose}>
+                  <OptionLabel option={own} />
+                </CommandItem>
+              </CommandGroup>
+            ) : null}
+            <CommandGroup heading={i18n.t("settings.timezoneAll")}>
+              {options.map((option) => (
+                <CommandItem
+                  key={option.zone}
+                  value={option.zone}
+                  keywords={option.keywords}
+                  onSelect={choose}
+                >
+                  <OptionLabel option={option} />
+                  <Check
+                    aria-hidden="true"
+                    className={cn(
+                      "ml-auto size-4 shrink-0",
+                      option.zone === value ? "opacity-100" : "opacity-0",
+                    )}
+                  />
+                </CommandItem>
+              ))}
+            </CommandGroup>
+          </CommandList>
+        </Command>
+      </PopoverContent>
+    </Popover>
+  );
+}

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;
+}