@volter/teams 0.1.48 → 0.1.50

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

@@ -86,8 +86,8 @@ export function peerMessage(text) {
   return { id: own.id || outer.id || null, name: own['from-name'] || outer['from-name'] || own.from || outer.from || 'Another session', address: own.from || outer.from || '', body };
 }
 
-/** A person's picture: the brand's person placeholder, seeded; an empty seed is its one standard anonymous face. */
-export const personImage = (seed = '') => `https://brand.volter.ai/runner/svg?seed=${encodeURIComponent(seed)}&size=36&radius=18`;
+/** A known person's picture; an unnamed sender gets the neutral brand user icon. */
+export const personImage = (seed = '') => seed ? `https://brand.volter.ai/runner/svg?seed=${encodeURIComponent(seed)}&size=36&radius=18` : 'https://brand.volter.ai/icon/user-round/svg?size=24';
 /** An agent's picture (this session's own, a peer session's): the brand's agent mark, a rounded square, never a face. */
 export const agentImage = (seed) => `https://brand.volter.ai/agent/svg?seed=${encodeURIComponent(seed)}&size=36&radius=7`;
 
@@ -124,13 +124,15 @@ export function withPeople(transcript, messages, { agentName = null, sessionId =
     const metadata = byTime.get(entry.ts) ?? {};
     const name = metadata.source_name || null;
     const seed = name ? (metadata.source_principal_id || name) : '';
-    return { ...entry, actor: { ...(seed ? { id: seed } : {}), name: name ?? 'Someone in the session', image: person(seed), kind: 'person' } };
+    const via = typeof metadata.source_via === 'string' ? metadata.source_via.trim() : '';
+    const source = ({ room: 'Room', app: 'App', terminal: 'Terminal', api: 'API' })[via] || via || 'Session';
+    return { ...entry, actor: { ...(seed ? { id: seed } : {}), name: name ?? 'Anonymous', anonymous: !name, source, image: person(seed), kind: 'person' } };
   });
   let last = null;
   return people.map((entry) => {
     if (!entry.actor) return entry;
-    const author = `${entry.actor.kind ?? ''}:${entry.actor.name ?? entry.role}`;
-    const continued = last !== null && last.author === author && Number.isFinite(entry.ts) && Number.isFinite(last.ts) && entry.ts - last.ts < 5 * 60_000;
+    const author = `${entry.actor.kind ?? ''}:${entry.actor.id ?? entry.actor.name ?? entry.role}:${entry.actor.source ?? ''}`;
+    const continued = !entry.actor.anonymous && last !== null && last.author === author && Number.isFinite(entry.ts) && Number.isFinite(last.ts) && entry.ts - last.ts < 5 * 60_000;
     last = { author, ts: entry.ts };
     const timeLabel = Number.isFinite(entry.ts) ? new Date(entry.ts).toLocaleTimeString(locale, { hour: 'numeric', minute: '2-digit' }) : undefined;
     return { ...entry, actor: { ...entry.actor, ...(continued ? { continued: true } : {}), ...(timeLabel ? { timeLabel } : {}) } };
@@ -140,14 +142,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)) {