@plosson/agentio 0.5.15 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plosson/agentio",
-  "version": "0.5.15",
+  "version": "0.6.0",
   "description": "CLI for LLM agents to interact with communication and tracking services",
   "type": "module",
   "license": "MIT",

package/src/auth/oauth.ts

@@ -15,6 +15,7 @@ const GCHAT_SCOPES = [
   'https://www.googleapis.com/auth/chat.messages.readonly',   // read messages (get operations)
   'https://www.googleapis.com/auth/chat.spaces.readonly',     // read space info and list
   'https://www.googleapis.com/auth/chat.memberships.readonly', // read space members
+  'https://www.googleapis.com/auth/directory.readonly',        // resolve user IDs to names/emails via People API
   'https://www.googleapis.com/auth/userinfo.email',           // get user email for profile naming
 ];
 

package/src/services/gchat/client.ts

@@ -15,8 +15,14 @@ import type {
   GChatSpace,
 } from '../../types/gchat';
 
+interface ResolvedUser {
+  displayName: string;
+  email?: string;
+}
+
 export class GChatClient implements ServiceClient {
   private credentials: GChatCredentials;
+  private userCache = new Map<string, ResolvedUser>();
 
   constructor(credentials: GChatCredentials) {
     this.credentials = credentials;
@@ -223,6 +229,11 @@ export class GChatClient implements ServiceClient {
       });
 
       const messages = response.data.messages || [];
+
+      // Resolve unique sender IDs to display names via People API
+      const senderIds = [...new Set(messages.map(m => m.sender?.name).filter(Boolean))] as string[];
+      await this.resolveUsers(senderIds, auth);
+
       return messages.map((msg: chat_v1.Schema$Message) => {
         const gchatMsg: GChatMessage = {
           name: msg.name || '',
@@ -231,12 +242,7 @@ export class GChatClient implements ServiceClient {
           updateTime: (msg as Record<string, unknown>).lastUpdateTime as string || new Date().toISOString(),
         };
         if (msg.text) gchatMsg.text = msg.text;
-        if (msg.sender?.name) {
-          gchatMsg.sender = {
-            name: msg.sender.name,
-            displayName: msg.sender.displayName || msg.sender.name,
-          };
-        }
+        gchatMsg.sender = this.enrichSender(msg);
         if (msg.thread?.name) {
           gchatMsg.thread = {
             name: msg.thread.name,
@@ -270,6 +276,12 @@ export class GChatClient implements ServiceClient {
       }
 
       const msg = response.data as chat_v1.Schema$Message;
+
+      // Resolve sender
+      if (msg.sender?.name) {
+        await this.resolveUsers([msg.sender.name], auth);
+      }
+
       const gchatMsg: GChatMessage = {
         name: msg.name || '',
         createTime: msg.createTime || new Date().toISOString(),
@@ -277,12 +289,7 @@ export class GChatClient implements ServiceClient {
         updateTime: (msg as Record<string, unknown>).lastUpdateTime as string || new Date().toISOString(),
       };
       if (msg.text) gchatMsg.text = msg.text;
-      if (msg.sender?.name) {
-        gchatMsg.sender = {
-          name: msg.sender.name,
-          displayName: msg.sender.displayName || msg.sender.name,
-        };
-      }
+      gchatMsg.sender = this.enrichSender(msg);
       if (msg.thread?.name) {
         gchatMsg.thread = {
           name: msg.thread.name,
@@ -306,15 +313,29 @@ export class GChatClient implements ServiceClient {
     const chat = gchat({ version: 'v1', auth: auth as any });
 
     try {
-      const response = await chat.spaces.list({});
-
-      const spaces = response.data.spaces || [];
-      return spaces.map((space: chat_v1.Schema$Space) => ({
-        name: space.name || '',
-        displayName: space.displayName || 'Unnamed',
-        type: (space.type as 'ROOM' | 'DM') || 'ROOM',
-        description: space.spaceDetails?.description || undefined,
-      }));
+      const allSpaces: GChatSpace[] = [];
+      let pageToken: string | undefined;
+
+      do {
+        const response = await chat.spaces.list({
+          pageSize: 100,
+          pageToken,
+        });
+
+        const spaces = response.data.spaces || [];
+        for (const space of spaces) {
+          allSpaces.push({
+            name: space.name || '',
+            displayName: space.displayName || 'Unnamed',
+            type: (space.type as 'ROOM' | 'DM') || 'ROOM',
+            description: space.spaceDetails?.description || undefined,
+          });
+        }
+
+        pageToken = response.data.nextPageToken || undefined;
+      } while (pageToken);
+
+      return allSpaces;
     } catch (err) {
       const code = this.getErrorCode(err);
       const message = this.getErrorMessage(err);
@@ -326,6 +347,45 @@ export class GChatClient implements ServiceClient {
     }
   }
 
+  private async resolveUsers(userIds: string[], auth: OAuth2Client): Promise<void> {
+    const unknown = userIds.filter(id => !this.userCache.has(id));
+    if (unknown.length === 0) return;
+
+    const token = await auth.getAccessToken();
+    if (!token.token) return;
+
+    // Resolve users in parallel via People API
+    await Promise.all(unknown.map(async (userId) => {
+      try {
+        // userId is like "users/123456", extract the numeric part
+        const personId = userId.replace('users/', '');
+        const res = await fetch(
+          `https://people.googleapis.com/v1/people/${personId}?personFields=names,emailAddresses`,
+          { headers: { Authorization: `Bearer ${token.token}` } }
+        );
+        if (!res.ok) return;
+        const data = await res.json() as Record<string, any>;
+        const name = data.names?.[0]?.displayName;
+        const email = data.emailAddresses?.[0]?.value;
+        if (name) {
+          this.userCache.set(userId, { displayName: name, email });
+        }
+      } catch {
+        // Silently skip unresolvable users
+      }
+    }));
+  }
+
+  private enrichSender(msg: chat_v1.Schema$Message): GChatMessage['sender'] {
+    if (!msg.sender?.name) return undefined;
+    const cached = this.userCache.get(msg.sender.name);
+    return {
+      name: msg.sender.name,
+      displayName: cached?.displayName || msg.sender.displayName || msg.sender.name,
+      email: cached?.email,
+    };
+  }
+
   private getErrorCode(err: unknown): ErrorCode {
     if (err && typeof err === 'object') {
       const error = err as Record<string, unknown>;

package/src/types/gchat.ts

@@ -1,6 +1,7 @@
 export interface GChatSender {
   name: string;
   displayName: string;
+  email?: string;
   avatarUrl?: string;
 }
 

package/src/utils/output.ts

@@ -132,7 +132,10 @@ export function printGChatMessageList(messages: GChatMessage[]): void {
     const msg = messages[i];
     console.log(`[${i + 1}] ${msg.name}`);
     if (msg.sender) {
-      console.log(`    From: ${msg.sender.displayName || 'Unknown'}`);
+      const from = msg.sender.email
+        ? `${msg.sender.displayName} <${msg.sender.email}>`
+        : msg.sender.displayName || 'Unknown';
+      console.log(`    From: ${from}`);
     }
     if (msg.text) {
       const snippet = msg.text.length > 100 ? msg.text.substring(0, 100) + '...' : msg.text;
@@ -146,7 +149,10 @@ export function printGChatMessageList(messages: GChatMessage[]): void {
 export function printGChatMessage(msg: GChatMessage): void {
   console.log(`ID: ${msg.name}`);
   if (msg.sender) {
-    console.log(`From: ${msg.sender.displayName || 'Unknown'}`);
+    const from = msg.sender.email
+      ? `${msg.sender.displayName} <${msg.sender.email}>`
+      : msg.sender.displayName || 'Unknown';
+    console.log(`From: ${from}`);
   }
   console.log(`Date: ${msg.createTime}`);
   if (msg.thread) {