@agenticmail/enterprise 0.5.170 → 0.5.172

package/dist/runtime-OF4ISGPR.js

@@ -0,0 +1,49 @@
+import {
+  AgentRuntime,
+  EmailChannel,
+  FollowUpScheduler,
+  SessionManager,
+  SubAgentManager,
+  ToolRegistry,
+  callLLM,
+  createAgentRuntime,
+  createNoopHooks,
+  createRuntimeHooks,
+  estimateMessageTokens,
+  estimateTokens,
+  executeTool,
+  runAgentLoop,
+  toolsToDefinitions
+} from "./chunk-XY3B3MYT.js";
+import "./chunk-AQH4DFYV.js";
+import "./chunk-JLSQOQ5L.js";
+import {
+  PROVIDER_REGISTRY,
+  listAllProviders,
+  resolveApiKeyForProvider,
+  resolveProvider
+} from "./chunk-67KZYSLU.js";
+import "./chunk-NRF3YRF7.js";
+import "./chunk-TYW5XTOW.js";
+import "./chunk-KFQGP6VL.js";
+export {
+  AgentRuntime,
+  EmailChannel,
+  FollowUpScheduler,
+  PROVIDER_REGISTRY,
+  SessionManager,
+  SubAgentManager,
+  ToolRegistry,
+  callLLM,
+  createAgentRuntime,
+  createNoopHooks,
+  createRuntimeHooks,
+  estimateMessageTokens,
+  estimateTokens,
+  executeTool,
+  listAllProviders,
+  resolveApiKeyForProvider,
+  resolveProvider,
+  runAgentLoop,
+  toolsToDefinitions
+};

package/dist/server-UWD5SXCF.js

@@ -0,0 +1,12 @@
+import {
+  createServer
+} from "./chunk-TX2QYPQN.js";
+import "./chunk-3SMTCIR4.js";
+import "./chunk-JLSQOQ5L.js";
+import "./chunk-RO537U6H.js";
+import "./chunk-DRXMYYKN.js";
+import "./chunk-67KZYSLU.js";
+import "./chunk-KFQGP6VL.js";
+export {
+  createServer
+};

package/dist/setup-3ASZ4FJ5.js

@@ -0,0 +1,20 @@
+import {
+  promptCompanyInfo,
+  promptDatabase,
+  promptDeployment,
+  promptDomain,
+  promptRegistration,
+  provision,
+  runSetupWizard
+} from "./chunk-LSANOO23.js";
+import "./chunk-MHIFVS5L.js";
+import "./chunk-KFQGP6VL.js";
+export {
+  promptCompanyInfo,
+  promptDatabase,
+  promptDeployment,
+  promptDomain,
+  promptRegistration,
+  provision,
+  runSetupWizard
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/enterprise",
-  "version": "0.5.170",
+  "version": "0.5.172",
   "description": "AgenticMail Enterprise — cloud-hosted AI agent identity, email, auth & compliance for organizations",
   "type": "module",
   "bin": {

package/src/agent-tools/tools/google/chat.ts

@@ -0,0 +1,393 @@
+/**
+ * Google Chat API Tools
+ *
+ * Lets agents participate in Google Chat spaces — list spaces, read messages,
+ * send messages, create spaces, manage memberships.
+ * Uses Google Chat API v1.
+ *
+ * Required OAuth scope: https://www.googleapis.com/auth/chat.spaces
+ *   https://www.googleapis.com/auth/chat.messages
+ *   https://www.googleapis.com/auth/chat.memberships
+ */
+
+import type { AnyAgentTool, ToolCreationOptions } from '../../types.js';
+import type { GoogleToolsConfig } from './index.js';
+import { jsonResult, errorResult } from '../../common.js';
+
+// ─── Helper ─────────────────────────────────────────────
+
+async function chatApi(token: string, path: string, opts?: { method?: string; body?: any; query?: Record<string, string> }): Promise<any> {
+  const url = new URL(`https://chat.googleapis.com/v1${path}`);
+  if (opts?.query) for (const [k, v] of Object.entries(opts.query)) url.searchParams.set(k, v);
+  const res = await fetch(url.toString(), {
+    method: opts?.method || 'GET',
+    headers: {
+      Authorization: `Bearer ${token}`,
+      ...(opts?.body ? { 'Content-Type': 'application/json' } : {}),
+    },
+    ...(opts?.body ? { body: JSON.stringify(opts.body) } : {}),
+  });
+  if (!res.ok) {
+    const errText = await res.text();
+    throw new Error(`Google Chat API ${res.status}: ${errText}`);
+  }
+  if (res.status === 204) return {};
+  return res.json();
+}
+
+// ─── Tool Definitions ───────────────────────────────────
+
+export function createGoogleChatTools(config: GoogleToolsConfig, _options?: ToolCreationOptions): AnyAgentTool[] {
+  const tp = config.tokenProvider;
+
+  return [
+    // ─── List Spaces ────────────────────────────────────
+    {
+      name: 'google_chat_list_spaces',
+      description: 'List Google Chat spaces (rooms, DMs, group conversations) the agent has access to. Returns space names, display names, and types.',
+      category: 'communication' as const,
+      parameters: {
+        type: 'object' as const,
+        properties: {
+          pageSize: { type: 'string', description: 'Max results (default: 20, max: 1000)' },
+          filter: { type: 'string', description: 'Filter string, e.g. "spaceType = SPACE" for named spaces only' },
+        },
+        required: [],
+      },
+      async execute(_id: string, input: any) {
+        try {
+          const token = await tp.getAccessToken();
+          const query: Record<string, string> = {};
+          if (input.pageSize) query.pageSize = input.pageSize;
+          if (input.filter) query.filter = input.filter;
+          const result = await chatApi(token, '/spaces', { query });
+          const spaces = (result.spaces || []).map((s: any) => ({
+            name: s.name,
+            displayName: s.displayName,
+            type: s.spaceType || s.type,
+            threaded: s.threaded,
+            singleUserBotDm: s.singleUserBotDm,
+          }));
+          return jsonResult({ spaces, count: spaces.length });
+        } catch (e: any) { return errorResult(e.message); }
+      },
+    },
+
+    // ─── Get Space Details ──────────────────────────────
+    {
+      name: 'google_chat_get_space',
+      description: 'Get details about a specific Google Chat space by its resource name (e.g. "spaces/AAAA...").',
+      category: 'communication' as const,
+      parameters: {
+        type: 'object' as const,
+        properties: {
+          spaceName: { type: 'string', description: 'Space resource name (e.g. "spaces/AAAAxyz...")' },
+        },
+        required: ['spaceName'],
+      },
+      async execute(_id: string, input: any) {
+        try {
+          const token = await tp.getAccessToken();
+          const result = await chatApi(token, `/${input.spaceName}`);
+          return jsonResult(result);
+        } catch (e: any) { return errorResult(e.message); }
+      },
+    },
+
+    // ─── List Messages in Space ─────────────────────────
+    {
+      name: 'google_chat_list_messages',
+      description: 'List recent messages in a Google Chat space. Returns message text, sender, and timestamps.',
+      category: 'communication' as const,
+      parameters: {
+        type: 'object' as const,
+        properties: {
+          spaceName: { type: 'string', description: 'Space resource name (e.g. "spaces/AAAAxyz...")' },
+          pageSize: { type: 'string', description: 'Max messages to return (default: 25, max: 1000)' },
+          orderBy: { type: 'string', description: '"createTime asc" or "createTime desc" (default: desc)' },
+          filter: { type: 'string', description: 'Filter, e.g. \'createTime > "2024-01-01T00:00:00Z"\'' },
+          showDeleted: { type: 'string', description: '"true" to include deleted messages' },
+        },
+        required: ['spaceName'],
+      },
+      async execute(_id: string, input: any) {
+        try {
+          const token = await tp.getAccessToken();
+          const query: Record<string, string> = {};
+          if (input.pageSize) query.pageSize = input.pageSize;
+          if (input.orderBy) query.orderBy = input.orderBy;
+          if (input.filter) query.filter = input.filter;
+          if (input.showDeleted === 'true') query.showDeleted = 'true';
+          const result = await chatApi(token, `/${input.spaceName}/messages`, { query });
+          const messages = (result.messages || []).map((m: any) => ({
+            name: m.name,
+            sender: m.sender?.displayName || m.sender?.name || 'unknown',
+            senderType: m.sender?.type,
+            text: m.text || m.formattedText || '',
+            createTime: m.createTime,
+            threadName: m.thread?.name,
+            attachments: (m.attachment || []).length,
+          }));
+          return jsonResult({ messages, count: messages.length });
+        } catch (e: any) { return errorResult(e.message); }
+      },
+    },
+
+    // ─── Send Message ───────────────────────────────────
+    {
+      name: 'google_chat_send_message',
+      description: 'Send a message to a Google Chat space. Supports plain text and cards.',
+      category: 'communication' as const,
+      parameters: {
+        type: 'object' as const,
+        properties: {
+          spaceName: { type: 'string', description: 'Space resource name (e.g. "spaces/AAAAxyz...")' },
+          text: { type: 'string', description: 'Message text (supports Chat markdown)' },
+          threadKey: { type: 'string', description: 'Thread key to reply in a specific thread' },
+          threadName: { type: 'string', description: 'Thread resource name to reply to an existing thread' },
+        },
+        required: ['spaceName', 'text'],
+      },
+      async execute(_id: string, input: any) {
+        try {
+          const token = await tp.getAccessToken();
+          const body: any = { text: input.text };
+          if (input.threadName || input.threadKey) {
+            body.thread = {};
+            if (input.threadName) body.thread.name = input.threadName;
+            if (input.threadKey) body.thread.threadKey = input.threadKey;
+          }
+          const query: Record<string, string> = {};
+          if (input.threadKey) query.messageReplyOption = 'REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD';
+          const result = await chatApi(token, `/${input.spaceName}/messages`, { method: 'POST', body, query });
+          return jsonResult({ sent: true, messageName: result.name, createTime: result.createTime });
+        } catch (e: any) { return errorResult(e.message); }
+      },
+    },
+
+    // ─── Update Message ─────────────────────────────────
+    {
+      name: 'google_chat_update_message',
+      description: 'Update (edit) an existing message in Google Chat.',
+      category: 'communication' as const,
+      parameters: {
+        type: 'object' as const,
+        properties: {
+          messageName: { type: 'string', description: 'Message resource name (e.g. "spaces/AAAA.../messages/BBBB...")' },
+          text: { type: 'string', description: 'New message text' },
+        },
+        required: ['messageName', 'text'],
+      },
+      async execute(_id: string, input: any) {
+        try {
+          const token = await tp.getAccessToken();
+          const result = await chatApi(token, `/${input.messageName}`, {
+            method: 'PATCH',
+            body: { text: input.text },
+            query: { updateMask: 'text' },
+          });
+          return jsonResult({ updated: true, messageName: result.name });
+        } catch (e: any) { return errorResult(e.message); }
+      },
+    },
+
+    // ─── Delete Message ─────────────────────────────────
+    {
+      name: 'google_chat_delete_message',
+      description: 'Delete a message in Google Chat.',
+      category: 'communication' as const,
+      parameters: {
+        type: 'object' as const,
+        properties: {
+          messageName: { type: 'string', description: 'Message resource name to delete' },
+        },
+        required: ['messageName'],
+      },
+      async execute(_id: string, input: any) {
+        try {
+          const token = await tp.getAccessToken();
+          await chatApi(token, `/${input.messageName}`, { method: 'DELETE' });
+          return jsonResult({ deleted: true });
+        } catch (e: any) { return errorResult(e.message); }
+      },
+    },
+
+    // ─── List Members ───────────────────────────────────
+    {
+      name: 'google_chat_list_members',
+      description: 'List members of a Google Chat space. Shows who is in a room/conversation.',
+      category: 'communication' as const,
+      parameters: {
+        type: 'object' as const,
+        properties: {
+          spaceName: { type: 'string', description: 'Space resource name' },
+          pageSize: { type: 'string', description: 'Max results (default: 100)' },
+          filter: { type: 'string', description: 'Filter, e.g. \'role = "ROLE_MANAGER"\'' },
+        },
+        required: ['spaceName'],
+      },
+      async execute(_id: string, input: any) {
+        try {
+          const token = await tp.getAccessToken();
+          const query: Record<string, string> = {};
+          if (input.pageSize) query.pageSize = input.pageSize;
+          if (input.filter) query.filter = input.filter;
+          const result = await chatApi(token, `/${input.spaceName}/members`, { query });
+          const members = (result.memberships || []).map((m: any) => ({
+            name: m.name,
+            role: m.role,
+            memberType: m.member?.type,
+            displayName: m.member?.displayName,
+            email: m.member?.domainId || '',
+            state: m.state,
+          }));
+          return jsonResult({ members, count: members.length });
+        } catch (e: any) { return errorResult(e.message); }
+      },
+    },
+
+    // ─── Create Space ───────────────────────────────────
+    {
+      name: 'google_chat_create_space',
+      description: 'Create a new Google Chat space (room). Can set display name, description, and type.',
+      category: 'communication' as const,
+      parameters: {
+        type: 'object' as const,
+        properties: {
+          displayName: { type: 'string', description: 'Space display name' },
+          description: { type: 'string', description: 'Space description' },
+          spaceType: { type: 'string', description: '"SPACE" for named space (default), "GROUP_CHAT" for group DM' },
+          externalUserAllowed: { type: 'string', description: '"true" to allow external users' },
+        },
+        required: ['displayName'],
+      },
+      async execute(_id: string, input: any) {
+        try {
+          const token = await tp.getAccessToken();
+          const body: any = {
+            displayName: input.displayName,
+            spaceType: input.spaceType || 'SPACE',
+          };
+          if (input.description) body.spaceDetails = { description: input.description };
+          if (input.externalUserAllowed === 'true') body.externalUserAllowed = true;
+          const result = await chatApi(token, '/spaces', { method: 'POST', body });
+          return jsonResult({ created: true, spaceName: result.name, displayName: result.displayName });
+        } catch (e: any) { return errorResult(e.message); }
+      },
+    },
+
+    // ─── Add Member to Space ────────────────────────────
+    {
+      name: 'google_chat_add_member',
+      description: 'Add a user to a Google Chat space by their email address.',
+      category: 'communication' as const,
+      parameters: {
+        type: 'object' as const,
+        properties: {
+          spaceName: { type: 'string', description: 'Space resource name' },
+          email: { type: 'string', description: 'Email address of user to add' },
+        },
+        required: ['spaceName', 'email'],
+      },
+      async execute(_id: string, input: any) {
+        try {
+          const token = await tp.getAccessToken();
+          const body = {
+            member: {
+              name: `users/${input.email}`,
+              type: 'HUMAN',
+            },
+          };
+          const result = await chatApi(token, `/${input.spaceName}/members`, { method: 'POST', body });
+          return jsonResult({ added: true, membershipName: result.name });
+        } catch (e: any) { return errorResult(e.message); }
+      },
+    },
+
+    // ─── Search Messages ────────────────────────────────
+    {
+      name: 'google_chat_search',
+      description: 'Search for messages across all spaces the agent has access to. Use for finding specific conversations or information.',
+      category: 'communication' as const,
+      parameters: {
+        type: 'object' as const,
+        properties: {
+          query: { type: 'string', description: 'Search query text' },
+          spaceName: { type: 'string', description: 'Limit search to a specific space (optional)' },
+          pageSize: { type: 'string', description: 'Max results (default: 10)' },
+        },
+        required: ['query'],
+      },
+      async execute(_id: string, input: any) {
+        try {
+          const token = await tp.getAccessToken();
+          // Use list messages with filter for text matching within a space
+          if (input.spaceName) {
+            const query: Record<string, string> = {
+              pageSize: input.pageSize || '10',
+              filter: `text : "${input.query}"`,
+              orderBy: 'createTime desc',
+            };
+            const result = await chatApi(token, `/${input.spaceName}/messages`, { query });
+            const messages = (result.messages || []).map((m: any) => ({
+              name: m.name,
+              sender: m.sender?.displayName || 'unknown',
+              text: m.text || '',
+              createTime: m.createTime,
+              space: m.space?.displayName,
+            }));
+            return jsonResult({ messages, count: messages.length });
+          }
+          // Without space, list spaces and search each (limited)
+          const spacesResult = await chatApi(token, '/spaces', { query: { pageSize: '20' } });
+          const allMessages: any[] = [];
+          const queryLower = input.query.toLowerCase();
+          for (const space of (spacesResult.spaces || []).slice(0, 5)) {
+            try {
+              const msgs = await chatApi(token, `/${space.name}/messages`, {
+                query: { pageSize: '20', orderBy: 'createTime desc' },
+              });
+              for (const m of (msgs.messages || [])) {
+                if ((m.text || '').toLowerCase().includes(queryLower)) {
+                  allMessages.push({
+                    name: m.name,
+                    sender: m.sender?.displayName || 'unknown',
+                    text: m.text,
+                    createTime: m.createTime,
+                    space: space.displayName,
+                  });
+                }
+              }
+            } catch { /* skip inaccessible spaces */ }
+          }
+          return jsonResult({ messages: allMessages.slice(0, parseInt(input.pageSize) || 10), count: allMessages.length });
+        } catch (e: any) { return errorResult(e.message); }
+      },
+    },
+
+    // ─── Create Reaction ────────────────────────────────
+    {
+      name: 'google_chat_react',
+      description: 'Add an emoji reaction to a message in Google Chat.',
+      category: 'communication' as const,
+      parameters: {
+        type: 'object' as const,
+        properties: {
+          messageName: { type: 'string', description: 'Message resource name' },
+          emoji: { type: 'string', description: 'Unicode emoji character (e.g. "👍", "❤️", "✅")' },
+        },
+        required: ['messageName', 'emoji'],
+      },
+      async execute(_id: string, input: any) {
+        try {
+          const token = await tp.getAccessToken();
+          const result = await chatApi(token, `/${input.messageName}/reactions`, {
+            method: 'POST',
+            body: { emoji: { unicode: input.emoji } },
+          });
+          return jsonResult({ reacted: true, reactionName: result.name });
+        } catch (e: any) { return errorResult(e.message); }
+      },
+    },
+  ];
+}