@volter/teams 0.1.48 → 0.1.49

package/browser-channel.d.ts

@@ -55,6 +55,12 @@ export function sendBrowserTurn(channel: BrowserChannel, text: string, options?:
 export interface MailHistoryEntry {
   id: string; from: string; fromName: string; to: string; text: string; at: number;
   direction: 'in' | 'out'; inReplyTo: string | null; delivery: string;
+  fromActor?: MailActor; toActor?: MailActor;
+}
+/** The existing native identity resolved by supercode, not the return mailbox. */
+export interface MailActor {
+  id: string; name: string; kind: 'agent' | 'automation' | 'person'; self: boolean; via?: 'voice';
+  session?: { machine: string; harness: string; id: string };
 }
 /** Read mailbox history without marking messages read. Requires observe on the bound session. */
 export function readBrowserMail(channel: BrowserChannel): Promise<MailHistoryEntry[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/teams",
-  "version": "0.1.48",
+  "version": "0.1.49",
   "type": "module",
   "description": "Volter Teams, the neutral team plane: machine identity and daemon core, the local door and server link, admission from machine grants, product doors, and the Teams server's neutral routes (company RFC 0008).",
   "license": "MIT",

package/session-follow.d.ts

@@ -34,7 +34,7 @@ export function followTeamSession(options: FollowTeamSessionOptions): { stop():
 export function peerMessage(text: string): { name: string; address: string; body: string } | null;
 
 /** Overlay actual envelopes, deduplicating copies already delivered into the native transcript. */
-export function withMail<Entry extends { id: string; ts: number | null; mail?: { id: string } }>(transcript: Entry[], rows: import('./browser-channel.js').MailHistoryEntry[], options?: { agentName?: string }): Array<Entry | { id: string; role: 'notice'; text: string; ts: number; truncated: boolean; mail: { id: string; from: string; to: string; direction: 'in' | 'out'; inReplyTo?: string | null } }>;
+export function withMail<Entry extends { id: string; ts: number | null; mail?: { id: string } }>(transcript: Entry[], rows: import('./browser-channel.js').MailHistoryEntry[], options?: { agentName?: string; agentId?: string; agentImage?(seed: string): string }): Array<Entry | { id: string; role: 'notice'; text: string; ts: number; truncated: boolean; mail: { id: string; from: string; to: string; direction: 'in' | 'out'; inReplyTo?: string | null; image?: string; via?: 'voice' } }>;
 
 export function personImage(seed?: string): string;
 export function agentImage(seed: string): string;

package/session-follow.mjs

@@ -140,14 +140,16 @@ export function withPeople(transcript, messages, { agentName = null, sessionId =
 /** Overlay real mail on the native transcript without rewriting native messages.
  * Stable envelope IDs deduplicate harness-delivered copies. Neither rendering
  * nor expanding an envelope changes its mailbox state. */
-export function withMail(transcript, rows, { agentName = 'This session' } = {}) {
+export function withMail(transcript, rows, { agentName = 'This session', agentId = '', agentImage: picture = agentImage } = {}) {
   // An older mailbox must not jump ahead of the page of history being viewed.
   // Its envelopes become visible when the person loads that earlier history.
   const times = transcript.map(entry => entry.ts).filter(Number.isFinite);
   if (times.length) rows = rows.filter(row => row.at >= Math.min(...times));
+  const nameOf = actor => actor?.self ? agentName : actor?.name || 'Unknown sender';
   const mail = rows.map(row => ({ id: `mail:${row.id}`, role: 'notice', text: row.text, ts: row.at, truncated: false,
-    mail: { id: row.id, from: row.fromName || row.from, to: row.direction === 'in' ? agentName : row.to,
-      direction: row.direction, inReplyTo: row.inReplyTo } }));
+    mail: { id: row.id, from: nameOf(row.fromActor), to: row.toActor ? nameOf(row.toActor) : row.direction === 'in' ? agentName : 'Another session',
+      image: row.fromActor?.kind === 'agent' ? picture(row.fromActor.self ? agentId : row.fromActor.id) : `https://brand.volter.ai/bot/svg?seed=${encodeURIComponent(row.fromActor?.id || row.from)}&size=24&radius=4`,
+      via: row.fromActor?.via, direction: row.direction, inReplyTo: row.inReplyTo } }));
   const result = transcript.filter(entry => !entry.mail || !rows.some(row => row.id === entry.mail.id || row.id.startsWith(entry.mail.id)));
   // Keep native tool/result ordering intact (some native entries have no time).
   for (const entry of mail.sort((a, b) => a.ts - b.ts)) {