kather-relay 0.1.0 → 0.2.0

package/README.md

@@ -5,11 +5,13 @@ Le Relais de [Kather](https://kather.katalyx.fr) : il fait apparaître les Agent
 Node 22.12 ou plus.
 
 ```sh
-npx kather-relay connect https://kather.katalyx.fr   # code à confirmer dans Kather, puis consentement T3 Code (Full access)
-npx kather-relay install-service                      # service utilisateur (systemd --user, launchd)
-npx kather-relay status                               # appairage, T3 Code, service
+npx kather-relay@latest connect https://kather.katalyx.fr   # code à confirmer dans Kather, puis consentement T3 Code (Full access)
+npx kather-relay@latest install-service                      # service utilisateur (systemd --user, launchd)
+npx kather-relay@latest status                               # appairage, T3 Code, service
 ```
 
 Le plus simple : dans Kather, copie le prompt d'installation du Relais et colle-le dans ton T3 Code.
 
+Kather refuse un Relais trop ancien (bandeau « Mets à jour ton Relais ») : relance `npx kather-relay@latest install-service`, qui remplace la copie du service.
+
 Autres commandes : `kather-relay login` (reconnecter T3 Code), `kather-relay run` (au premier plan), `kather-relay uninstall-service`. Option `--redirect-host localhost` si T3 Code refuse la redirection vers `127.0.0.1`.

package/dist/kather-relay.mjs

@@ -3776,6 +3776,22 @@ import { hostname as hostname3 } from "node:os";
 import { dirname, join as join3, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 
+// ../../packages/shared/src/geometry.ts
+function rectangle(minX, minZ, maxX, maxZ) {
+  return [
+    { x: minX, z: minZ },
+    { x: maxX, z: minZ },
+    { x: maxX, z: maxZ },
+    { x: minX, z: maxZ }
+  ];
+}
+
+// ../../packages/shared/src/ranges.ts
+var NAME_TAG_RANGE = 6;
+
+// ../../packages/shared/src/agent-scene.ts
+var AGENT_PILL_RANGE = NAME_TAG_RANGE * 2;
+
 // ../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/classic/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -23512,6 +23528,24 @@ function katherStatusOf(t3Status, pendingRequestCount = 0) {
   if (pendingRequestCount > 0) return "waiting";
   return BY_T3_STATUS[t3Status] ?? "available";
 }
+var short = external_exports.string().max(2e3);
+var pendingRequestSchema = external_exports.object({
+  requestId: external_exports.string().min(1).max(512),
+  questions: external_exports.array(
+    external_exports.object({
+      id: external_exports.string().min(1).max(512),
+      header: short.nullable(),
+      question: short,
+      options: external_exports.array(external_exports.object({ label: short, value: short.optional(), description: short.optional() })).max(20),
+      multiSelect: external_exports.boolean()
+    })
+  ).max(10)
+});
+var agentRequestSchema = external_exports.discriminatedUnion("kind", [
+  external_exports.object({ kind: external_exports.literal("question"), request: pendingRequestSchema }),
+  external_exports.object({ kind: external_exports.literal("approval") })
+]);
+var agentPlaceSchema = external_exports.enum(["desk", "raised", "coming", "near", "returning"]);
 var agentViewSchema = external_exports.object({
   /** Identité stable : `environmentId` T3 + `threadId`. */
   id: external_exports.string(),
@@ -23524,11 +23558,19 @@ var agentViewSchema = external_exports.object({
   title: external_exports.string(),
   project: external_exports.string().nullable(),
   status: agentStatusSchema,
-  pendingRequest: external_exports.boolean(),
+  /**
+   * Ce que l'Agent attend, en Attend ; `null` sinon, et pour qui ne peut pas lire le fil (un
+   * Invité, un autre Membre face à un Agent privé).
+   */
+  request: agentRequestSchema.nullable(),
+  /** La marque À relire (glossaire), tenue par le serveur : visible de tous, Invités compris. */
+  toReview: external_exports.boolean(),
   subagents: external_exports.object({ active: external_exports.number().int(), total: external_exports.number().int() }),
   /** La rangée du Propriétaire et le Poste dans la rangée ; `null` : « sans Poste ». */
   rowIndex: external_exports.number().int().nullable(),
   deskIndex: external_exports.number().int().nullable(),
+  /** Où il en est dans la scène : à son Poste, en route, près de son Propriétaire… */
+  place: agentPlaceSchema,
   /** Hors ligne depuis cet instant (ms depuis l'époque), ou `null` si le Relais répond. */
   offlineSince: external_exports.number().nullable(),
   /** Réglé par le Propriétaire (US 71) : les autres ne voient que Statut, titre et Propriétaire. */
@@ -23542,6 +23584,12 @@ var agentRowOwnerSchema = external_exports.object({
   name: external_exports.string(),
   outfit: external_exports.string()
 });
+var agentPoseSchema = external_exports.object({
+  id: external_exports.string(),
+  x: external_exports.number(),
+  z: external_exports.number(),
+  heading: external_exports.number()
+});
 var agentsMessageSchema = external_exports.discriminatedUnion("event", [
   external_exports.object({
     type: external_exports.literal("agents"),
@@ -23559,19 +23607,6 @@ var agentsMessageSchema = external_exports.discriminatedUnion("event", [
   })
 ]);
 var agentAlertSchema = external_exports.enum(["waiting", "done"]);
-var short = external_exports.string().max(2e3);
-var pendingRequestSchema = external_exports.object({
-  requestId: external_exports.string().min(1).max(512),
-  questions: external_exports.array(
-    external_exports.object({
-      id: external_exports.string().min(1).max(512),
-      header: short.nullable(),
-      question: short,
-      options: external_exports.array(external_exports.object({ label: short, value: short.optional(), description: short.optional() })).max(20),
-      multiSelect: external_exports.boolean()
-    })
-  ).max(10)
-});
 var looseRequestSchema = external_exports.looseObject({
   requestId: external_exports.string().min(1).max(512),
   questions: external_exports.array(
@@ -23590,15 +23625,23 @@ var looseRequestSchema = external_exports.looseObject({
     })
   ).max(10)
 });
-
-// ../../packages/shared/src/geometry.ts
-function rectangle(minX, minZ, maxX, maxZ) {
-  return [
-    { x: minX, z: minZ },
-    { x: maxX, z: minZ },
-    { x: maxX, z: maxZ },
-    { x: minX, z: maxZ }
-  ];
+function pendingRequestsFrom(result) {
+  const parsed = external_exports.looseObject({ requests: external_exports.array(looseRequestSchema).max(20) }).safeParse(result);
+  if (!parsed.success) return null;
+  return parsed.data.requests.map((r) => ({
+    requestId: r.requestId,
+    questions: r.questions.map((q) => ({
+      id: q.id,
+      header: q.header ?? null,
+      question: q.question ?? "",
+      options: (q.options ?? []).map((o) => ({
+        label: o.label,
+        ...o.value != null ? { value: String(o.value) } : {},
+        ...o.description ? { description: o.description } : {}
+      })),
+      multiSelect: q.multiSelect ?? false
+    }))
+  }));
 }
 
 // ../../packages/shared/src/appearance.ts
@@ -23815,7 +23858,7 @@ var parisParts = new Intl.DateTimeFormat("en-GB", {
 });
 
 // ../../packages/shared/src/relay-protocol.ts
-var RELAY_PROTOCOL_VERSION = 2;
+var RELAY_PROTOCOL_VERSION = 3;
 var RELAY_HEARTBEAT_MS = 3e4;
 var id = external_exports.string().min(1).max(512);
 var name = external_exports.string().max(500);
@@ -23829,8 +23872,12 @@ var relayAgentSchema = external_exports.object({
   projectId: id.nullable(),
   projectName: name.nullable(),
   status: agentStatusSchema,
-  /** Une demande en attente (`t3_pending_request`), lue pour les Agents en Attend. */
-  pendingRequest: external_exports.boolean(),
+  /**
+   * Le résumé de ce que l'Agent attend, en Attend : la première demande listée par
+   * `t3_pending_request` (question et options), ou `approval` quand T3 Code compte une demande
+   * sans en lister aucune. `null` hors Attend, ou tant que la demande n'a pas pu être lue.
+   */
+  request: agentRequestSchema.nullable(),
   subagents: subagentCountSchema,
   /** Le lien du thread dans T3 Code (`t3-thread://…`), pour l'y ouvrir. */
   link: external_exports.string().max(2e3).nullable()
@@ -23880,6 +23927,11 @@ var relayMessageSchema = external_exports.discriminatedUnion("type", [
     hasMore: external_exports.boolean()
   }),
   external_exports.object({ type: external_exports.literal("t3.auth"), ...t3AuthSchema.shape }),
+  /**
+   * Un Agent a écrit à un autre Agent de la même machine : un `user_message` de `toThreadId`
+   * porte `createdBy: "agent"` et `senderThreadId: fromThreadId`. Jamais pour un sous-agent.
+   */
+  external_exports.object({ type: external_exports.literal("agents.exchange"), fromThreadId: id, toThreadId: id }),
   external_exports.discriminatedUnion("ok", [
     external_exports.object({
       type: external_exports.literal("command.result"),
@@ -24037,13 +24089,19 @@ var clientMessageSchema = external_exports.discriminatedUnion("type", [
       external_exports.union([external_exports.string().max(2e4), external_exports.array(external_exports.string().max(2e3)).max(20)])
     )
   }),
-  external_exports.object({ type: external_exports.literal("agent.setPrivate"), agentId: ref, ref, private: external_exports.boolean() })
+  external_exports.object({ type: external_exports.literal("agent.setPrivate"), agentId: ref, ref, private: external_exports.boolean() }),
+  /**
+   * « Retirer de l'Espace » (US 35) : le Propriétaire retire tout de suite un Agent Hors ligne, au
+   * lieu d'attendre 24 h. S'il revient en ligne, il réapparaît comme un nouvel Agent.
+   */
+  external_exports.object({ type: external_exports.literal("agent.remove"), agentId: ref, ref })
 ]);
 var deliverySchema = external_exports.enum(["started", "queued", "steered"]);
 var agentErrorSchema = external_exports.enum([
   "forbidden",
   "unknown-agent",
   "offline",
+  "online",
   "refused",
   "escalation",
   "failed"
@@ -24075,14 +24133,14 @@ var serverMessageSchema = external_exports.discriminatedUnion("type", [
     occupants: external_exports.array(external_exports.object({ id: external_exports.string(), ...poseSchema.shape, audioKey: audioKeySchema }))
   }),
   /**
-   * Ma clé audio et les identités autorisées à s'abonner à mon micro (`null` : tout le monde).
-   * Envoyé à l'entrée, puis à chaque changement ; le client le pose par
-   * `setTrackSubscriptionPermissions`.
+   * Ma clé audio et les identités autorisées à s'abonner à mon micro, ma caméra et mon écran : les
+   * occupants de même clé, ceux du dehors quand je suis dehors (`listenersAllowed`). Envoyé à
+   * l'entrée, puis à chaque changement ; le client le pose par `setTrackSubscriptionPermissions`.
    */
   external_exports.object({
     type: external_exports.literal("audio"),
     key: audioKeySchema,
-    allowed: external_exports.array(external_exports.string()).nullable()
+    allowed: external_exports.array(external_exports.string())
   }),
   /** Création d'un Aparté ou changement de ses participants, pour tout l'Espace. */
   external_exports.object({ type: external_exports.literal("aparte.update"), aparte: aparteSchema }),
@@ -24118,6 +24176,11 @@ var serverMessageSchema = external_exports.discriminatedUnion("type", [
   external_exports.object({ type: external_exports.literal("correction"), ...poseSchema.shape }),
   /** Les Agents de l'Espace : instantané à l'entrée, puis changements. */
   agentsMessageSchema,
+  /**
+   * 15 Hz, à tout l'Espace : la position des Agents hors de leur Poste, calculée par le serveur
+   * (en route, dans une file). Un Agent absent de la liste est à son Poste. Envoyé aussi à l'entrée.
+   */
+  external_exports.object({ type: external_exports.literal("agents.poses"), poses: external_exports.array(agentPoseSchema) }),
   /** Le fil d'un Agent, à qui a le droit de le lire et l'a ouvert : ses derniers éléments. */
   external_exports.object({
     type: external_exports.literal("agent.thread"),
@@ -24146,6 +24209,17 @@ var serverMessageSchema = external_exports.discriminatedUnion("type", [
       error: agentErrorSchema
     })
   ]),
+  /**
+   * Aux Membres de l'Espace (pas aux Invités) : l'Agent `from` vient d'écrire à l'Agent `to`, de
+   * la même machine. Le client trace un trait entre eux pendant ~10 s (`AGENT_LINK_MS`).
+   */
+  external_exports.object({ type: external_exports.literal("agents.exchange"), from: external_exports.string(), to: external_exports.string() }),
+  /**
+   * Au Propriétaire : ses Relais refusés parce que trop anciens (leurs noms), pour le bandeau
+   * « Mets à jour ton Relais ». Envoyé à l'entrée s'il y en a, et à chaque changement ; une liste
+   * vide retire le bandeau.
+   */
+  external_exports.object({ type: external_exports.literal("relays.outdated"), relays: external_exports.array(external_exports.string()) }),
   /** Au Propriétaire seulement : son Agent attend ou a fini (US 66). */
   external_exports.object({
     type: external_exports.literal("notify"),
@@ -24183,9 +24257,6 @@ var TEXTS = {
     tu: "La connexion avec Google a \xE9chou\xE9. R\xE9essaie dans un instant.",
     vous: "La connexion avec Google a \xE9chou\xE9. R\xE9essayez dans un instant."
   },
-  "space.choose.title": { tu: "O\xF9 veux-tu entrer ?", vous: "O\xF9 voulez-vous entrer ?" },
-  "space.choose.enter": same("Entrer"),
-  "space.choose.last": same("Dernier utilis\xE9"),
   "space.none": {
     tu: "Tu n\u2019as acc\xE8s \xE0 aucun Espace. Demande l\u2019acc\xE8s \xE0 un associ\xE9 de Katalyx.",
     vous: "Vous n\u2019avez acc\xE8s \xE0 aucun Espace."
@@ -24193,10 +24264,37 @@ var TEXTS = {
   "space.entering": same("Entr\xE9e dans l\u2019Espace {space}\u2026"),
   "space.title": same("Espace {space}"),
   "space.help": {
-    tu: "Clique au sol ou marche avec Z Q S D. Clic droit gliss\xE9 pour tourner la cam\xE9ra, molette pour zoomer.",
+    tu: "Clique au sol ou marche avec Z Q S D. Clic droit gliss\xE9 pour tourner la cam\xE9ra, molette pour zoomer. Clique sur un robot pour ouvrir son Agent.",
     vous: "Cliquez au sol ou marchez avec Z Q S D. Clic droit gliss\xE9 pour tourner la cam\xE9ra, molette pour zoomer."
   },
-  "menu.open": same("Menu"),
+  "space.help.dismiss": same("Compris"),
+  // Les Coins de l'Espace (ADR 0008).
+  "corner.space": same("L\u2019Espace"),
+  "corner.space.menu": same("Changer d\u2019Espace ou se d\xE9connecter"),
+  "corner.space.guestMenu": same("Se d\xE9connecter"),
+  "corner.people": same("Pr\xE9sents, Agents et R\xE9glages"),
+  "corner.me": same("Mes commandes"),
+  "corner.view": same("La vue"),
+  "presents.button": same("Pr\xE9sents ({count})"),
+  "agents.button": same("Agents"),
+  "agents.waitingOne": { tu: "1 t\u2019attend", vous: "1 vous attend" },
+  "agents.waitingCount": { tu: "{count} t\u2019attendent", vous: "{count} vous attendent" },
+  "agents.reviewCount": same("{count} \xE0 relire"),
+  "me.place.passage": same("Passage"),
+  "moment.label": same("Action du moment"),
+  "moment.aparte": same("Apart\xE9 avec {names}"),
+  "moment.enter": same("Entr\xE9e"),
+  "drawer.close": same("Fermer (\xC9chap)"),
+  "drawer.back": same("Retour \xE0 la liste"),
+  goTo: same("Aller vers"),
+  // Raccourcis (Réglages > Raccourcis).
+  "shortcuts.walk": same("Marcher"),
+  "shortcuts.mic": same("Couper ou rouvrir le micro"),
+  "shortcuts.videos": same("Basculer entre l\u2019Espace et la Vue Vid\xE9os"),
+  "shortcuts.open": same("Ouvrir l\u2019Agent vis\xE9"),
+  "shortcuts.send": same("Envoyer un message \xE0 l\u2019Agent"),
+  "shortcuts.escape": same("Fermer le tiroir, sortir du plein \xE9cran"),
+  "shortcuts.turn": same("Quart de tour, en vue Iso"),
   "menu.switchSpace": same("Changer d\u2019Espace"),
   "menu.settings": same("R\xE9glages"),
   "menu.invite": same("Inviter"),
@@ -24212,6 +24310,11 @@ var TEXTS = {
     vous: "L\u2019enregistrement a \xE9chou\xE9. R\xE9essayez dans un instant."
   },
   "appearance.legend": { tu: "Ton Apparence", vous: "Votre Apparence" },
+  "appearance.change": same("Changer"),
+  "appearance.drawn": {
+    tu: "Tir\xE9e au hasard. \xAB Changer \xBB en tire une autre.",
+    vous: "Tir\xE9e au hasard. \xAB Changer \xBB en tire une autre."
+  },
   "appearance.skin": same("Peau"),
   "appearance.outfit": same("Tenue"),
   "appearance.hairStyle": same("Coiffure"),
@@ -24264,8 +24367,8 @@ var TEXTS = {
   },
   // Le temps que la restriction du micro s'applique : rien n'est encore promis.
   "zone.bannerPending": {
-    tu: "Zone priv\xE9e : {name} \xB7 Micro suspendu le temps de fermer la Zone",
-    vous: "Zone priv\xE9e : {name} \xB7 Micro suspendu le temps de fermer la Zone"
+    tu: "Zone priv\xE9e : {name} \xB7 Micro et cam\xE9ra suspendus le temps de fermer la Zone",
+    vous: "Zone priv\xE9e : {name} \xB7 Micro et cam\xE9ra suspendus le temps de fermer la Zone"
   },
   "aparte.name": same("Apart\xE9"),
   "aparte.label": same("Apart\xE9 \xB7 {count}"),
@@ -24301,16 +24404,17 @@ var TEXTS = {
     vous: "Approchez-vous du cercle de l\u2019Apart\xE9 pour frapper."
   },
   "aparte.refused.unknown": same("Cet Apart\xE9 est termin\xE9."),
-  "controls.label": same("Barre de contr\xF4le"),
   "camera.label": same("Cam\xE9ra"),
   "camera.libre": same("Libre"),
   "camera.iso": same("Iso"),
   "camera.dessus": same("Dessus"),
   "camera.turnLeft": same("Tourner d\u2019un quart de tour \xE0 gauche (A)"),
   "camera.turnRight": same("Tourner d\u2019un quart de tour \xE0 droite (E)"),
-  "rings.toggle": same("Cercles de 2 m et 6 m"),
-  "panel.toggle": same("Panneau lat\xE9ral"),
-  "panel.tabs": same("Onglets du panneau"),
+  "rings.toggle": same("Port\xE9e de voix"),
+  "rings.hint": {
+    tu: "Montre jusqu\u2019o\xF9 on t\u2019entend (2 m et 6 m)",
+    vous: "Montre jusqu\u2019o\xF9 on vous entend (2 m et 6 m)"
+  },
   "presents.title": same("Pr\xE9sents"),
   "presents.member": same("Membre"),
   "presents.guest": same("Invit\xE9"),
@@ -24325,6 +24429,56 @@ var TEXTS = {
     tu: "Le nom que les autres voient sur ton \xE9tiquette et dans la liste des Pr\xE9sents.",
     vous: "Le nom que les autres voient sur votre \xE9tiquette et dans la liste des Pr\xE9sents."
   },
+  "settings.audio": same("Micro et sortie"),
+  "settings.camera": same("Cam\xE9ra et \xE9cran"),
+  "settings.camera.lead": {
+    tu: "Ta cam\xE9ra est coup\xE9e \xE0 chaque entr\xE9e. Allum\xE9e, elle est visible de tout l\u2019Espace en petit, en grand \xE0 moins de 2 m ; dans une Salle ou un Apart\xE9, de ceux qui y sont seulement.",
+    vous: "Votre cam\xE9ra est coup\xE9e \xE0 chaque entr\xE9e. Allum\xE9e, elle est visible de tout l\u2019Espace en petit, en grand \xE0 moins de 2 m ; dans une Salle ou un Apart\xE9, de ceux qui y sont seulement."
+  },
+  "settings.camera.device": same("Cam\xE9ra"),
+  "settings.camera.default": same("Cam\xE9ra par d\xE9faut"),
+  "settings.camera.atEntry": {
+    tu: "Allumer ma cam\xE9ra en entrant",
+    vous: "Allumer ma cam\xE9ra en entrant"
+  },
+  // Vidéo et partage d'écran (ADR 0009).
+  "video.cameraOn": same("Allumer la cam\xE9ra"),
+  "video.cameraOff": same("Couper la cam\xE9ra"),
+  "video.cameraHint": same("Visible de tout l\u2019Espace en petit, en grand \xE0 moins de 2 m"),
+  "video.cameraError.denied": {
+    tu: "Cam\xE9ra refus\xE9e : autorise-la dans les r\xE9glages du navigateur.",
+    vous: "Cam\xE9ra refus\xE9e : autorisez-la dans les r\xE9glages du navigateur."
+  },
+  "video.cameraError.unavailable": same("Cam\xE9ra indisponible"),
+  "video.shareStart": same("Partager l\u2019\xE9cran"),
+  "video.shareStop": same("Arr\xEAter le partage d\u2019\xE9cran"),
+  "video.bandeau": same("Bandeau des vid\xE9os"),
+  "video.more": same("Voir les {count} autres vid\xE9os"),
+  "video.cameraMuted": same("cam\xE9ra coup\xE9e"),
+  "video.screenOf": same("\xC9cran de {name}"),
+  "video.myScreen": { tu: "Ton \xE9cran", vous: "Votre \xE9cran" },
+  "video.mini": same("Vid\xE9o de {name}"),
+  "video.enlarge": same("Agrandir"),
+  "video.view": same("Vue Vid\xE9os"),
+  "video.toggle": same("Espace ou Vue Vid\xE9os (V)"),
+  "video.toggle.space": same("Espace"),
+  "video.toggle.videos": same("Vid\xE9os"),
+  "video.propose": same("Vue Vid\xE9os"),
+  "video.later": same("Plus tard"),
+  "video.back": same("Revenir \xE0 l\u2019Espace"),
+  "video.around": { tu: "Autour de toi", vous: "Autour de vous" },
+  "video.alone": {
+    tu: "Personne \xE0 moins de 2 m. Approche-toi de quelqu\u2019un ou allume ta cam\xE9ra.",
+    vous: "Personne \xE0 moins de 2 m. Approchez-vous de quelqu\u2019un ou allumez votre cam\xE9ra."
+  },
+  "video.mosaic": same("Revenir \xE0 la mosa\xEFque"),
+  "video.fullscreen": same("Plein \xE9cran"),
+  "video.fullscreenExit": same("Quitter le plein \xE9cran (\xC9chap)"),
+  "video.zoomLevel": same("Niveau de zoom"),
+  "video.fit": same("Ajuster"),
+  "video.actualSize": same("Taille r\xE9elle (1:1)"),
+  "video.zoomHint": same("Ctrl + molette ou pincement pour zoomer, glisser pour se d\xE9placer"),
+  "settings.shortcuts": same("Raccourcis"),
   "settings.save": same("Enregistrer"),
   "settings.saved": same("Enregistr\xE9."),
   "settings.failed": {
@@ -24343,18 +24497,52 @@ var TEXTS = {
   "agents.status.waiting": same("Attend"),
   "agents.status.available": same("Disponible"),
   "agents.status.failed": same("En \xE9chec"),
-  "agents.offline": same("Hors ligne depuis {time}"),
-  "agents.pendingRequest": same("Demande en attente"),
-  "agents.pendingBadge": same("{count} demande(s) en attente"),
+  "agents.status.review": same("\xC0 relire"),
+  "agents.status.offline": same("Hors ligne"),
+  "agents.filter": same("Quels Agents"),
+  "agents.filter.all": same("Tous"),
+  "agents.filter.mine": same("Les miens"),
+  "agents.group.waiting": same("Attend une r\xE9ponse"),
+  "agents.group.review": same("\xC0 relire"),
+  "agents.group.failed": same("En \xE9chec"),
+  "agents.group.working": same("Travaille"),
+  "agents.group.available": same("Disponible"),
+  "agents.group.offline": same("Hors ligne ({count})"),
+  "agents.chip.waiting": same("R\xE9ponse"),
+  // Demandes, À relire et Relais v2.
+  "agents.answer": same("R\xE9pondre \xE0 \xAB {title} \xBB"),
+  "agents.answer.other": same("Autre r\xE9ponse\u2026"),
+  "agents.answer.open": same("R\xE9pondre\u2026"),
+  "bubble.waiting": same("Attend une r\xE9ponse"),
+  "bubble.review": same("\xC0 relire"),
+  "bubble.approval": same("Approbation en attente"),
+  "agents.exchange": same("\xAB {from} \xBB \xE9crit \xE0 \xAB {to} \xBB"),
+  "relays.outdated": {
+    tu: "Mets \xE0 jour ton Relais \xAB {names} \xBB : il est trop ancien pour ce Kather et ses Agents n\u2019apparaissent plus. Lance npx kather-relay@latest install-service sur cette machine.",
+    vous: "Ce Relais est trop ancien pour ce Kather."
+  },
+  "protocol.outdated": {
+    tu: "Kather a \xE9t\xE9 mis \xE0 jour : recharge la page pour continuer.",
+    vous: "Kather a \xE9t\xE9 mis \xE0 jour : rechargez la page pour continuer."
+  },
+  "protocol.outdated.title": same("Nouvelle version de Kather"),
+  "protocol.reload": same("Recharger"),
+  "agents.chip.review": same("\xC0 relire"),
+  "agents.chip.failed": same("\xC9chec"),
+  "agents.mineEmpty": {
+    tu: "Aucun de tes Agents n\u2019est dans cet Espace.",
+    vous: "Aucun Agent."
+  },
   "agents.noDesk": same("sans Poste"),
-  "agents.subagents": same("{active}/{total} sous-agents"),
-  "agents.alertBadge": same("{count} Agent(s) \xE0 voir"),
+  "agents.where.comingToMe": { tu: "en route vers toi", vous: "en route vers vous" },
+  "agents.where.coming": same("en route vers {name}"),
+  "agents.where.nearMe": { tu: "pr\xE8s de toi", vous: "pr\xE8s de vous" },
+  "agents.where.near": same("pr\xE8s de {name}"),
+  "agents.where.returning": same("rentre \xE0 son Poste"),
+  "agents.where.raised": same("main lev\xE9e \xE0 son Poste"),
   // Panneau d'un Agent (US 67 à 71, 76, 77).
   "agent.panel": same("Agent \xAB {title} \xBB"),
-  "agent.open": same("Ouvrir le panneau de l\u2019Agent"),
   "agent.prompt": same("Ouvrir \xAB {title} \xBB"),
-  "agent.close": same("Fermer le panneau"),
-  "agent.owner": same("Agent de {name}"),
   "agent.readOnly": same("Lecture seule \xB7 Agent de {name}"),
   "agent.restricted.private": same(
     "Agent priv\xE9 : seuls son Statut, son titre et son Propri\xE9taire sont visibles."
@@ -24380,6 +24568,7 @@ var TEXTS = {
   "agent.error.forbidden": same("Seul le Propri\xE9taire peut \xE9crire \xE0 cet Agent."),
   "agent.error.unknown-agent": same("Cet Agent n\u2019est plus l\xE0."),
   "agent.error.offline": same("Agent hors ligne : le Relais ou T3 Code ne r\xE9pond pas."),
+  "agent.error.online": same("Cet Agent est de nouveau en ligne : il reste dans l\u2019Espace."),
   "agent.error.refused": same("Le Relais a refus\xE9 cette op\xE9ration."),
   "agent.error.escalation": {
     tu: "T3 Code refuse : ce thread tourne dans un mode plus large que l\u2019autorisation du Relais. Reconnecte ton T3 Code en Full access (kather-relay login).",
@@ -24391,13 +24580,30 @@ var TEXTS = {
   ),
   "agent.request": same("Demande en attente"),
   "agent.request.loading": same("Lecture de la demande\u2026"),
-  "agent.request.none": {
-    tu: "L\u2019Agent attend, mais pas une r\xE9ponse \xE0 une question : cette demande (une permission, sans doute) se traite dans T3 Code.",
-    vous: "L\u2019Agent attend une demande qui se traite dans T3 Code."
-  },
+  "agent.request.reread": same("Relire la demande"),
   "agent.request.other": same("Autre r\xE9ponse"),
   "agent.request.answer": same("R\xE9pondre"),
   "agent.request.answered": same("R\xE9ponse envoy\xE9e."),
+  "agent.menu": same("Plus d\u2019actions"),
+  "agent.goToDesk": same("Aller \xE0 son Poste"),
+  "agent.meta.mine": { tu: "\xE0 toi", vous: "\xE0 vous" },
+  "agent.meta.of": same("de {name}"),
+  "agent.offline.machine": same("La machine {machine} ne donne plus de nouvelles depuis {time}."),
+  "agent.offline.unknown": same("Sa machine ne donne plus de nouvelles depuis {time}."),
+  "agent.offline.back": same("Son fil reviendra quand son Relais sera relanc\xE9."),
+  "agent.remove": same("Retirer de l\u2019Espace"),
+  "agent.remove.hint": same(
+    "Il dispara\xEEt pour tous et lib\xE8re son Poste ; s\u2019il revient en ligne, il r\xE9appara\xEEt comme un nouvel Agent."
+  ),
+  "agent.removed": same("\xAB {title} \xBB a \xE9t\xE9 retir\xE9 de l\u2019Espace."),
+  "agent.request.waiting": {
+    tu: "L\u2019Agent attend ta r\xE9ponse",
+    vous: "L\u2019Agent attend une r\xE9ponse"
+  },
+  "agent.request.collapse": same("Replier la demande"),
+  "agent.request.expand": same("D\xE9plier la demande"),
+  "agent.request.approve": same("\xC0 approuver dans T3 Code"),
+  "agent.composer": same("\xC9crire \xE0 l\u2019Agent\u2026  (Ctrl+Entr\xE9e)"),
   "agent.private": same("Priv\xE9"),
   "agent.private.hint": {
     tu: "Les autres Membres ne voient que son Statut et son titre, sans son fil.",
@@ -24425,7 +24631,7 @@ var TEXTS = {
     tu: "Reconnecte ton T3 Code : l\u2019autorisation de \xAB {machine} \xBB a expir\xE9. Lance kather-relay login sur cette machine.",
     vous: "Reconnectez votre T3 Code : l\u2019autorisation de \xAB {machine} \xBB a expir\xE9."
   },
-  "settings.relays": same("Relais"),
+  "settings.relays": same("Relais et Agents"),
   "relays.lead": {
     tu: "Le Relais fait appara\xEEtre tes Agents T3 Code dans Kather. Il tourne sur ta machine : ton jeton T3 Code ne la quitte jamais.",
     vous: "Le Relais fait appara\xEEtre vos Agents T3 Code dans Kather. Il tourne sur votre machine."
@@ -24436,7 +24642,7 @@ var TEXTS = {
     vous: "Collez-le dans votre T3 Code : votre agent installe, appaire et lance le Relais."
   },
   "relays.prompt": same(
-    "Installe et lance le Relais Kather sur cette machine. 1) V\xE9rifie que Node 22 ou plus est install\xE9. 2) Lance `npx kather-relay connect {url}` : il m\u2019affichera un code que je confirmerai dans le navigateur, puis il ouvrira la page de consentement de T3 Code, o\xF9 je choisirai Full access. 3) Installe ensuite le Relais en service utilisateur qui d\xE9marre avec ma session (systemd `--user` sous Linux, launchd sous macOS) avec `npx kather-relay install-service`, puis v\xE9rifie qu\u2019il tourne avec `npx kather-relay status`. Ne modifie aucun autre r\xE9glage de T3 Code."
+    "Installe et lance le Relais Kather sur cette machine. 1) V\xE9rifie que Node 22 ou plus est install\xE9. 2) Lance `npx kather-relay@latest connect {url}` : il m\u2019affichera un code que je confirmerai dans le navigateur, puis il ouvrira la page de consentement de T3 Code, o\xF9 je choisirai Full access. 3) Installe ensuite le Relais en service utilisateur qui d\xE9marre avec ma session (systemd `--user` sous Linux, launchd sous macOS) avec `npx kather-relay@latest install-service`, puis v\xE9rifie qu\u2019il tourne avec `npx kather-relay@latest status`. Ne modifie aucun autre r\xE9glage de T3 Code."
   ),
   "relays.prompt.copy": same("Copier le prompt"),
   "relays.prompt.copied": same("Copi\xE9."),
@@ -24549,6 +24755,9 @@ var TEXTS = {
   "invitations.pending": same("Espace {space} \xB7 lien valable jusqu\u2019au {date}"),
   "invitations.entered": same("Espace {space} \xB7 Entr\xE9e, acc\xE8s jusqu\u2019\xE0 minuit"),
   "invitations.revoke": same("R\xE9voquer"),
+  "invitations.copy": same("Copier le lien"),
+  "invitations.copied": same("Lien copi\xE9."),
+  "invitations.fresh": same("Envoy\xE9e \xE0 l\u2019instant"),
   "invitations.revoke.confirm": same("R\xE9voquer l\u2019invitation de {email} ?"),
   "invitation.title": {
     tu: "{inviter} t\u2019invite dans l\u2019Espace {space}",
@@ -24773,7 +24982,11 @@ var threadSchema = external_exports.looseObject({
   link: external_exports.string().nullish(),
   settled: external_exports.boolean().nullish(),
   parentThreadId: external_exports.string().nullish(),
-  relationshipToParent: external_exports.string().nullish()
+  relationshipToParent: external_exports.string().nullish(),
+  /** Change à chaque nouvel élément de la chronologie. */
+  updatedAt: external_exports.string().nullish(),
+  /** Tous les éléments de la chronologie, activité comprise. */
+  itemCount: external_exports.number().int().nullish()
 });
 var threadPageSchema = external_exports.looseObject({
   threads: external_exports.array(threadSchema),
@@ -24797,7 +25010,11 @@ var threadReadSchema = external_exports.looseObject({
       type: external_exports.string(),
       text: external_exports.string().nullish(),
       textTruncated: external_exports.boolean().nullish(),
-      updatedAt: external_exports.string().nullish()
+      updatedAt: external_exports.string().nullish(),
+      /** `agent` pour un message écrit par un autre fil, et pour les réponses de l'Agent. */
+      createdBy: external_exports.string().nullish(),
+      /** Le fil qui a écrit ce `user_message`, quand c'est un Agent. */
+      senderThreadId: external_exports.string().nullish()
     })
   ),
   nextPosition: external_exports.number().int().nullish(),
@@ -24887,11 +25104,29 @@ function createT3(options) {
 }
 
 // src/version.ts
-var RELAY_VERSION = "0.1.0";
+var RELAY_VERSION = "0.2.0";
 
 // src/relay.ts
 var EXPIRY_WARNING_MS = 3 * 24 * 60 * 60 * 1e3;
 var PROJECT_CACHE_MS = 6e4;
+var EXCHANGE_READ_ITEMS = 5;
+var EXCHANGE_MAX_PAGES = 20;
+async function readSince(client, threadId, after, added) {
+  const items = [];
+  const pages = added === null ? EXCHANGE_MAX_PAGES : Math.ceil(added / EXCHANGE_READ_ITEMS) + 1;
+  let position = after;
+  for (let page = 0; page < pages; page++) {
+    const read = await client.readThread(threadId, {
+      limit: EXCHANGE_READ_ITEMS,
+      maxCharsPerItem: 1,
+      ...position >= 0 ? { afterPosition: position } : {}
+    });
+    items.push(...read.items);
+    if (!read.hasMore || read.nextPosition == null) break;
+    position = read.nextPosition;
+  }
+  return items;
+}
 var MAX_RECONNECT_MS = 3e4;
 var serialize = (agent) => JSON.stringify(agent);
 function startRelay(options) {
@@ -24914,6 +25149,8 @@ function startRelay(options) {
   const watched = /* @__PURE__ */ new Map();
   let projects = null;
   let lastPending = /* @__PURE__ */ new Map();
+  let requests = /* @__PURE__ */ new Map();
+  let timelines = /* @__PURE__ */ new Map();
   const connectT3 = (from) => from ? createT3({
     url: from.url,
     accessToken: from.accessToken,
@@ -24965,6 +25202,62 @@ function startRelay(options) {
     wake = done;
   });
   const pollSoon = () => wake?.();
+  async function readRequests(client, waiting, pending) {
+    const next = /* @__PURE__ */ new Map();
+    await Promise.all(
+      waiting.map(async (t) => {
+        const count = pending.get(t.threadId) ?? 0;
+        if (count === 0) return;
+        const key = `${count}:${t.updatedAt ?? ""}`;
+        const known = requests.get(t.threadId);
+        if (known?.key === key) return void next.set(t.threadId, known);
+        try {
+          const listed = pendingRequestsFrom({ requests: await client.pendingRequests(t.threadId) });
+          const first = listed?.[0];
+          const request = !listed ? known?.request ?? null : first ? { kind: "question", request: first } : { kind: "approval" };
+          next.set(t.threadId, { key: listed ? key : "", request });
+        } catch (error62) {
+          if (error62 instanceof T3Unauthorized || error62 instanceof T3Unreachable) throw error62;
+          log(`demande du thread ${t.threadId} : ${String(error62)}`);
+          next.set(t.threadId, { key: "", request: known?.request ?? null });
+        }
+      })
+    );
+    requests = next;
+  }
+  async function findExchanges(client, threads) {
+    const next = /* @__PURE__ */ new Map();
+    const changed = [];
+    for (const t of threads) {
+      if (!knownAgents.has(t.threadId)) continue;
+      const current = { updatedAt: t.updatedAt ?? null, itemCount: t.itemCount ?? null };
+      next.set(t.threadId, current);
+      const before = timelines.get(t.threadId);
+      if (!before || before.updatedAt === current.updatedAt || before.itemCount === null) continue;
+      if (current.itemCount !== null && current.itemCount <= before.itemCount) continue;
+      const added = current.itemCount === null ? null : current.itemCount - before.itemCount;
+      changed.push({ threadId: t.threadId, after: before.itemCount - 1, added });
+    }
+    timelines = next;
+    const reads = await Promise.allSettled(
+      changed.map(({ threadId, after, added }) => readSince(client, threadId, after, added))
+    );
+    reads.forEach((read, i) => {
+      const toThreadId = changed[i].threadId;
+      if (read.status === "rejected") {
+        if (read.reason instanceof T3Unauthorized || read.reason instanceof T3Unreachable) {
+          throw read.reason;
+        }
+        return log(`\xE9changes du thread ${toThreadId} : ${String(read.reason)}`);
+      }
+      for (const item2 of read.value) {
+        const from = item2.senderThreadId;
+        if (item2.type !== "user_message" || item2.createdBy !== "agent" || !from) continue;
+        if (from === toThreadId || !knownAgents.has(from)) continue;
+        send({ type: "agents.exchange", fromThreadId: from, toThreadId });
+      }
+    });
+  }
   function agentsOf(threads, pending) {
     const subagents = /* @__PURE__ */ new Map();
     for (const t of threads) {
@@ -24983,7 +25276,7 @@ function startRelay(options) {
         projectId: t.projectId ?? null,
         projectName: t.projectId ? projects?.names.get(t.projectId) ?? null : null,
         status: katherStatusOf(t.status, pendingCount),
-        pendingRequest: pendingCount > 0,
+        request: pendingCount > 0 ? requests.get(t.threadId)?.request ?? null : null,
         subagents: subagents.get(t.threadId) ?? { active: 0, total: 0 },
         link: t.link ?? null
       };
@@ -25032,7 +25325,9 @@ function startRelay(options) {
         projects = { at: now(), names: await t3.projectNames() };
       }
       const client = t3;
-      const waiting = threads.filter((t) => knownAgents.has(t.threadId) && t.status === "waiting");
+      const waiting = threads.filter(
+        (t) => knownAgents.has(t.threadId) && (t.status === "waiting" || t.status === "running")
+      );
       const details = await Promise.allSettled(
         waiting.map((t) => client.readThread(t.threadId, { limit: 1, maxCharsPerItem: 1 }))
       );
@@ -25050,8 +25345,10 @@ function startRelay(options) {
         pending.set(t.threadId, lastPending.get(t.threadId) ?? 0);
       });
       lastPending = pending;
+      await readRequests(client, waiting, pending);
       setAuth(expiryState());
       publish(agentsOf(threads, pending));
+      await findExchanges(client, threads);
       for (const threadId of [...watched.keys()]) await sendThread(threadId);
     } catch (error62) {
       if (error62 instanceof T3Unauthorized) setAuth("expired");
@@ -25277,7 +25574,10 @@ function serviceDefinition(options) {
       ].join("\n"),
       install: [
         ["systemctl", "--user", "daemon-reload"],
-        ["systemctl", "--user", "enable", "--now", SERVICE_NAME]
+        ["systemctl", "--user", "enable", SERVICE_NAME],
+        // `restart` démarre un service arrêté et relance un service en cours : une mise à jour
+        // (`npx kather-relay@latest install-service`) repart sur la nouvelle copie.
+        ["systemctl", "--user", "restart", SERVICE_NAME]
       ],
       uninstall: [["systemctl", "--user", "disable", "--now", SERVICE_NAME]]
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kather-relay",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Le Relais de Kather : fait apparaître les Agents de ton T3 Code dans ton Espace Kather.",
   "license": "MIT",
   "homepage": "https://kather.katalyx.fr",