@anchrd/intel-ui 0.14.0 → 0.15.0

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.",

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.",

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"
+  ]
 }