@stage-labs/metro 0.1.0-beta.205 → 0.1.0-beta.207

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage-labs/metro",
-  "version": "0.1.0-beta.205",
+  "version": "0.1.0-beta.207",
   "description": "The metro command line: run your agent on this machine, relaying its chat channels and connectors to Claude Code.",
   "license": "MIT",
   "repository": {

package/runtime/marketplace/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "metro",
-  "version": "0.1.0-beta.205",
+  "version": "0.1.0-beta.207",
   "description": "Metro for Claude Code, installed by the metro daemon on this machine: every connector the agent holds as its own MCP server relayed through the daemon, the orchestrator-only guard on the main thread, and the standing rules loaded at each session start. No vendor credential ever sits in a config file.",
   "author": {
     "name": "Bonustrack",

package/runtime/node_modules/@metro-labs/daemon/src/agents/sender-cards.ts

@@ -11,6 +11,7 @@ export interface SenderCard {
   id: string;
   name?: string;
   handle?: string;
+  avatar?: string;
 }
 
 export interface SenderCardDeps {
@@ -23,15 +24,22 @@ const LOOKUP_MS = 8_000;
 
 const filled = (value: unknown): string | undefined => (typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined);
 
+const AVATAR_DATA_MAX = 100_000;
+
+const shownAvatar = (avatar: string): boolean =>
+  avatar.startsWith('https://') || (avatar.startsWith('data:image/') && avatar.length <= AVATAR_DATA_MAX);
+
 function cardOf(id: string, profile: unknown, seenName: string | undefined): SenderCard {
   const p = isRecord(profile) ? profile : {};
   const display = filled(p.display_name);
   const handle = filled(p.name);
   const name = display ?? seenName ?? handle;
+  const avatar = filled(p.avatar);
   return {
     id,
     ...(name === undefined ? {} : { name }),
     ...(handle === undefined || handle === name ? {} : { handle }),
+    ...(avatar !== undefined && shownAvatar(avatar) ? { avatar } : {}),
   };
 }
 

package/runtime/node_modules/@metro-labs/telegram-bot/src/profile.ts

@@ -9,7 +9,7 @@ import {
 } from '@metro-labs/core/stations/profile';
 import { makeProfileCache, nonEmpty, type SenderProfile } from '@metro-labs/core/stations/sender-profile';
 import { TrainError } from '@metro-labs/core/train-error';
-import { accountFor, tg } from './accounts.js';
+import { accountFor, accounts, tg } from './accounts.js';
 import { respond } from '@metro-labs/core/stations/station-runtime';
 
 async function setPhoto(accountId: string, avatar: ProfileAvatar): Promise<void> {
@@ -39,6 +39,24 @@ interface TgChat {
   first_name?: unknown;
   last_name?: unknown;
   bio?: unknown;
+  photo?: { small_file_id?: unknown };
+}
+
+const PHOTO_MAX = 64 * 1024;
+
+async function photoData(accountId: string, fileId: unknown): Promise<string | undefined> {
+  if (typeof fileId !== 'string' || fileId === '') return undefined;
+  try {
+    const file = await tg<{ file_path?: string }>(accountId, 'getFile', { file_id: fileId }, 10_000);
+    const acct = accounts.get(accountId);
+    if (acct === undefined || typeof file.file_path !== 'string') return undefined;
+    const res = await fetch(`${acct.fileApi}/${file.file_path}`, { signal: AbortSignal.timeout(10_000) });
+    if (!res.ok) return undefined;
+    const bytes = Buffer.from(await res.arrayBuffer());
+    return bytes.length === 0 || bytes.length > PHOTO_MAX ? undefined : `data:image/jpeg;base64,${bytes.toString('base64')}`;
+  } catch {
+    return undefined;
+  }
 }
 
 const senders = makeProfileCache<SenderProfile>(
@@ -47,11 +65,13 @@ const senders = makeProfileCache<SenderProfile>(
     const chat = await tg<TgChat>(accountId, 'getChat', { chat_id: Number(user) }, 10_000);
     const handle = nonEmpty(chat.username);
     const display = nonEmpty([chat.first_name, chat.last_name].filter((part) => typeof part === 'string').join(' '));
+    const avatar = await photoData(accountId, chat.photo?.small_file_id);
     return {
       id: user,
       ...(handle === undefined ? {} : { name: `@${handle}` }),
       ...(display === undefined ? {} : { display_name: display }),
       ...(nonEmpty(chat.bio) === undefined ? {} : { about: nonEmpty(chat.bio) }),
+      ...(avatar === undefined ? {} : { avatar }),
     };
   },
   { onError: (key, err) => process.stderr.write(`telegram-bot: could not read the profile of ${key}: ${err instanceof Error ? err.message : String(err)}\n`) },

package/runtime/node_modules/@metro-labs/whatsapp/src/client.ts

@@ -17,7 +17,7 @@ import type { ProfileChange } from '@metro-labs/core/stations/profile';
 import { makeProfileCache, nonEmpty, type SenderProfile } from '@metro-labs/core/stations/sender-profile';
 import { toInbound, toReaction, type ReactionEvent, type SelfRef } from './parse.js';
 import { baileysLogger } from './logger.js';
-import { makeNameBook, phoneOf, type NameBook } from './names.js';
+import { makeNameBook, nameFiles, noteContact, phoneOf, type NameBook } from './names.js';
 import { useAccountAuthState } from './auth-state.js';
 import { knownKey, makeKeyCache, targetKey, type KeyCache } from './keys.js';
 import { makeOutbox, type Outbox } from './outbox.js';
@@ -102,7 +102,14 @@ function bindInbound(st: State, sock: WASocket): void {
     }
   });
   sock.ev.on('contacts.upsert', (contacts) => {
-    for (const c of contacts) st.names.note(c.id, c.name ?? c.notify);
+    for (const c of contacts) noteContact(st.names, c);
+  });
+  sock.ev.on('contacts.update', (contacts) => {
+    for (const c of contacts) noteContact(st.names, c);
+  });
+  sock.ev.on('messaging-history.set', ({ contacts, messages }) => {
+    for (const c of contacts) noteContact(st.names, c);
+    for (const m of messages) if (m.key.fromMe !== true) st.names.note(m.key.participant ?? m.key.remoteJid, m.pushName);
   });
   sock.ev.on('messages.reaction', (events: ReactionEvent[]) => {
     if (!st.handlers) return;
@@ -301,7 +308,7 @@ export function createClient(account: WhatsAppAccount): WAClient {
     keys: makeKeyCache(),
     outbox: makeOutbox(),
     acks: makeAckWatch(),
-    names: makeNameBook(),
+    names: makeNameBook(nameFiles.path(account.id)),
   };
   resetGate(st);
   const senders = makeProfileCache<SenderProfile>((jid) => readProfile(st, jid), {

package/runtime/node_modules/@metro-labs/whatsapp/src/names.ts

@@ -1,27 +1,74 @@
+import { readFileSync } from 'node:fs';
+import { accountFiles } from '@metro-labs/core/stations/account-files';
+import { writeSecure } from '@metro-labs/core/secure-fs';
+import { isRecord } from '@metro-labs/core/is-record';
+import { errMsg } from '@metro-labs/core/log';
+
 const MAX_NAMES = 2000;
+const SAVE_DELAY_MS = 2000;
+
+export const nameFiles = accountFiles('WHATSAPP_TOKEN_DIR', 'whatsapp-names-');
 
 export interface NameBook {
   note(jid: string | null | undefined, name: string | null | undefined): void;
   get(jid: string): string | undefined;
 }
 
-export function makeNameBook(): NameBook {
-  const names = new Map<string, string>();
+function loaded(file: string | undefined): Map<string, string> {
+  if (file === undefined) return new Map();
+  try {
+    const raw: unknown = JSON.parse(readFileSync(file, 'utf8'));
+    if (!isRecord(raw)) return new Map();
+    return new Map(Object.entries(raw).filter((e): e is [string, string] => typeof e[1] === 'string' && e[1] !== ''));
+  } catch {
+    return new Map();
+  }
+}
+
+export function makeNameBook(file?: string): NameBook {
+  const names = loaded(file);
+  let timer: ReturnType<typeof setTimeout> | null = null;
+  const save = (): void => {
+    timer = null;
+    if (file === undefined) return;
+    try {
+      writeSecure(file, JSON.stringify(Object.fromEntries(names)));
+    } catch (err) {
+      process.stderr.write(`whatsapp: could not save the names: ${errMsg(err)}\n`);
+    }
+  };
   return {
     note(jid, name) {
       const clean = name?.trim() ?? '';
-      if (!jid || clean === '') return;
+      if (!jid || clean === '' || names.get(jid) === clean) return;
       names.delete(jid);
       names.set(jid, clean);
       if (names.size > MAX_NAMES) {
         const oldest = names.keys().next().value;
         if (oldest !== undefined) names.delete(oldest);
       }
+      if (file !== undefined && timer === null) {
+        timer = setTimeout(save, SAVE_DELAY_MS);
+        timer.unref();
+      }
     },
     get: (jid) => names.get(jid),
   };
 }
 
+export interface ContactNames {
+  id?: string | null;
+  lid?: string | null;
+  phoneNumber?: string | null;
+  name?: string | null;
+  notify?: string | null;
+}
+
+export function noteContact(book: NameBook, c: ContactNames): void {
+  const name = c.name ?? c.notify;
+  for (const jid of [c.id, c.lid, c.phoneNumber]) book.note(jid, name);
+}
+
 export const phoneOf = (jid: string | null | undefined): string | undefined => {
   const digits = /^(\d{6,})(?::\d+)?@s\.whatsapp\.net$/.exec(jid ?? '')?.[1];
   return digits === undefined ? undefined : `+${digits}`;

package/runtime/node_modules/@metro-labs/whatsapp/src/station.ts

@@ -1,6 +1,7 @@
 import type { Station, Verb } from '@metro-labs/core/stations/types';
 import { PROFILE_FIELDS, type ProfileField } from '@metro-labs/core/stations/profile';
 import { tokenFiles } from './token-store.js';
+import { nameFiles } from './names.js';
 
 export const whatsappStation: Station = {
   name: 'whatsapp',
@@ -19,7 +20,13 @@ export const whatsappStation: Station = {
   profileFields: new Set<ProfileField>(PROFILE_FIELDS),
   readsProfiles: true,
   resolvesSenders: true,
-  forget: tokenFiles.forget,
-  forgetExcept: tokenFiles.forgetExcept,
+  forget: (accountId) => {
+    tokenFiles.forget(accountId);
+    nameFiles.forget(accountId);
+  },
+  forgetExcept: (kept) => {
+    tokenFiles.forgetExcept(kept);
+    nameFiles.forgetExcept(kept);
+  },
   tools: [],
 };

package/runtime/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.1.0-beta.205"
+  "version": "0.1.0-beta.207"
 }