@volter/teams 0.1.74 → 0.1.76

package/browser-channel.d.ts

@@ -54,7 +54,8 @@ export declare class TurnDeliveryUnconfirmedError extends Error {
 /**
  * One line typed into the channel's session as its user's own turn; rejects when the machine refuses the stream.
  * `turnKey`: one per typed line, reused on retry, so the machine types the line once.
- * Receipt waits time out after thirty seconds. Cancellation stops waiting; it
+ * Receipt waits time out after thirty seconds and retain at most 256 KB of UTF-8 text.
+ * Cancellation stops waiting; it
  * does not undo delivery. After acceptance, a lost, invalid or cancelled receipt
  * rejects with TurnDeliveryUnconfirmedError. Reuse the same key when retrying it.
  */

package/browser-channel.mjs

@@ -185,7 +185,7 @@ export async function sendBrowserTurn(channel, text, { turnKey, signal } = {}) {
   signal?.throwIfAborted();
   const stream = await channel.open('mail', { request: { op: 'turn', text, ...(turnKey ? { turn_key: String(turnKey) } : {}) } });
   return new Promise((resolve, reject) => {
-    let answer = '', settled = false;
+    let answer = '', bytes = 0, settled = false;
     const cleanup = () => { clearTimeout(timer); stream.off('data', data); stream.off('close', closed); signal?.removeEventListener('abort', cancelled); };
     const fail = error => {
       if (settled) return;
@@ -196,7 +196,13 @@ export async function sendBrowserTurn(channel, text, { turnKey, signal } = {}) {
     };
     const cancelled = () => fail(new TurnDeliveryUnconfirmedError('Turn delivery wait cancelled'));
     const timer = setTimeout(() => fail(new TurnDeliveryUnconfirmedError('Turn delivery acknowledgement timed out')), 30_000);
-    const data = chunk => { answer += chunk; if (answer.length > 256_000) fail(new TurnDeliveryUnconfirmedError('Turn delivery receipt too large')); };
+    const data = chunk => {
+      if (typeof chunk !== 'string') { fail(new TurnDeliveryUnconfirmedError('Invalid turn delivery receipt frame')); return; }
+      if (chunk.length > 256_000 - bytes) { fail(new TurnDeliveryUnconfirmedError('Turn delivery receipt too large')); return; }
+      bytes += encoder.encode(chunk).byteLength;
+      if (bytes > 256_000) { fail(new TurnDeliveryUnconfirmedError('Turn delivery receipt too large')); return; }
+      answer += chunk;
+    };
     const closed = reason => {
       if (settled) return;
       settled = true; cleanup();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/teams",
-  "version": "0.1.74",
+  "version": "0.1.76",
   "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.mjs

@@ -142,6 +142,19 @@ export const personImage = (seed = '') => seed ? `https://brand.volter.ai/runner
 /** 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`;
 
+// Older history lacks actor metadata but still carries its envelope name.
+// Use native addressing only for a harness label, never as display text or as
+// evidence that a generated operator mailbox is the voice of this session.
+function mailIdentity(address, suppliedName) {
+  const native = /^sc:([^:]+):([^:]+):(.+)$/.exec(address || '');
+  const label = ({ 'claude-code': 'Claude Code', codex: 'Codex', gemini: 'Gemini', goose: 'Goose', grok: 'Grok', opencode: 'OpenCode', pi: 'Pi', operator: 'Automation', board: 'Board', pane: 'Terminal' })[native?.[2]] || 'Another session';
+  let name = typeof suppliedName === 'string' ? suppliedName.trim() : '';
+  if (native && name.endsWith(`@${native[1]}`)) name = name.slice(0, -native[1].length - 1);
+  if (!name || name === address || name.startsWith('sc:') || /^(?:(?:codex|claude-code|claude|gemini|pi|goose|grok|opencode|supercode-voice)-)?[0-9a-f]{8,}(?:-[0-9a-f]+)*$/i.test(name)) name = label;
+  return { name, kind: native && !['operator', 'board', 'pane'].includes(native[2]) ? 'agent' : 'automation' };
+}
+const automationImage = seed => `https://brand.volter.ai/bot/svg?seed=${encodeURIComponent(seed || 'mail')}&size=24&radius=4`;
+
 /**
  * Who wrote each entry of a projected transcript (supercode-ui's entries), from the messages' own annotations:
  * this session's turns are its agent's (`agentName`); a peer session's message is that session's, its envelope kept
@@ -182,10 +195,10 @@ export function withPeople(transcript, messages, { agentName = null, sessionId =
       // is this session's own front, not another agent with a generated id.
       const ownVoice = peer.via === 'voice';
       const seed = ownVoice ? sessionId : peer.address.startsWith('sc:') ? peer.address : peer.name;
-      const native = /^sc:[^:]+:([^:]+):.+$/.exec(peer.address);
-      const harnessName = ({ 'claude-code': 'Claude Code', codex: 'Codex', gemini: 'Gemini', goose: 'Goose', grok: 'Grok', opencode: 'OpenCode', pi: 'Pi', operator: 'Automation', board: 'Board', pane: 'Terminal' })[native?.[1]] || 'Another session';
-      const name = ownVoice && agentName ? agentName : peer.name === peer.address ? harnessName : peer.name, picture = agent(seed);
-      return { ...entry, text: peer.body, mail: { id: peer.id || entry.id, from: name, to: agentName || 'This session', direction: 'in', image: picture, ...(peer.subject ? { subject: peer.subject } : {}), ...(ownVoice ? { via: 'voice' } : {}), ...(peer.inReplyTo ? { inReplyTo: peer.inReplyTo } : {}) }, actor: { id: seed, name, image: picture, kind: 'agent' }, context: [{ id: `${entry.id}:envelope`, kind: 'envelope', label: 'Delivered by supercode', detail: entry.text }] };
+      const identity = mailIdentity(peer.address, peer.name);
+      const name = ownVoice && agentName ? agentName : identity.name;
+      const picture = ownVoice || identity.kind === 'agent' ? agent(seed) : automationImage(seed);
+      return { ...entry, text: peer.body, mail: { id: peer.id || entry.id, from: name, to: agentName || 'This session', direction: 'in', image: picture, ...(peer.subject ? { subject: peer.subject } : {}), ...(ownVoice ? { via: 'voice' } : {}), ...(peer.inReplyTo ? { inReplyTo: peer.inReplyTo } : {}) }, actor: { id: seed, name, image: picture, ...(ownVoice || identity.kind === 'agent' ? { kind: 'agent' } : {}) }, context: [{ id: `${entry.id}:envelope`, kind: 'envelope', label: 'Delivered by supercode', detail: entry.text }] };
     }
     const name = metadata.source_name || null;
     const seed = name ? (metadata.source_principal_id || name) : '';
@@ -213,11 +226,16 @@ export function withMail(transcript, rows, { agentName = 'This session', agentId
   let earliest = Infinity;
   for (const entry of transcript) if (Number.isFinite(entry.ts)) earliest = Math.min(earliest, entry.ts);
   if (earliest !== Infinity) rows = rows.filter(row => row.at >= earliest);
-  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: 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`,
-      subject: row.subject || undefined, via: row.fromActor?.via, direction: row.direction, inReplyTo: row.inReplyTo } }));
+  const nameOf = (actor, address, suppliedName, self = false) => actor?.self || self ? agentName : mailIdentity(actor?.id || address, actor?.name || suppliedName).name;
+  const mail = rows.map(row => {
+    const own = row.fromActor ? row.fromActor.self : row.direction === 'out';
+    const kind = row.fromActor?.kind || (own ? 'agent' : mailIdentity(row.from, row.fromName).kind);
+    const seed = own ? agentId : row.fromActor?.id || row.from;
+    return { id: `mail:${row.id}`, role: 'notice', text: row.text, ts: row.at, truncated: false,
+      mail: { id: row.id, from: nameOf(row.fromActor, row.from, row.fromName, own), to: nameOf(row.toActor, row.to, '', !row.toActor && row.direction === 'in'),
+        image: kind === 'agent' ? picture(seed) : kind === 'person' ? personImage(seed) : automationImage(seed),
+        subject: row.subject || undefined, via: row.fromActor?.via, direction: row.direction, inReplyTo: row.inReplyTo } };
+  });
   // Some native envelopes use a shortened ID. It identifies a copy only if
   // there is exactly one matching full ID; ambiguity must not erase native mail.
   const fullIds = new Set(rows.map(row => row.id));