@vellumai/assistant 0.3.0

package/src/config/bundled-skills/messaging/TOOLS.json

@@ -0,0 +1,357 @@
+{
+  "version": 1,
+  "tools": [
+    {
+      "name": "messaging_auth_test",
+      "description": "Verify that a messaging platform is connected and show account info.",
+      "category": "messaging",
+      "risk": "low",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "platform": { "type": "string", "description": "Platform to test (e.g. \"slack\", \"gmail\"). Auto-detected if only one is connected." }
+        }
+      },
+      "executor": "tools/messaging-auth-test.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "messaging_list_conversations",
+      "description": "List channels, inboxes, DMs, or groups with unread counts.",
+      "category": "messaging",
+      "risk": "low",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "platform": { "type": "string", "description": "Platform (e.g. \"slack\", \"gmail\"). Auto-detected if only one is connected." },
+          "types": {
+            "type": "array",
+            "items": { "type": "string", "enum": ["channel", "dm", "group", "inbox"] },
+            "description": "Filter by conversation type"
+          },
+          "limit": { "type": "number", "description": "Maximum number of conversations to return (default 200)" }
+        }
+      },
+      "executor": "tools/messaging-list-conversations.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "messaging_read",
+      "description": "Read message history from a conversation. Optionally read a specific thread.",
+      "category": "messaging",
+      "risk": "low",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "platform": { "type": "string", "description": "Platform (e.g. \"slack\", \"gmail\"). Auto-detected if only one is connected." },
+          "conversation_id": { "type": "string", "description": "Conversation/channel/label ID to read from" },
+          "thread_id": { "type": "string", "description": "Thread ID to read replies from (optional)" },
+          "limit": { "type": "number", "description": "Maximum number of messages to return (default 50)" }
+        },
+        "required": ["conversation_id"]
+      },
+      "executor": "tools/messaging-read.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "messaging_search",
+      "description": "Search messages across a platform using its native query syntax.",
+      "category": "messaging",
+      "risk": "low",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "platform": { "type": "string", "description": "Platform (e.g. \"slack\", \"gmail\"). Auto-detected if only one is connected." },
+          "query": { "type": "string", "description": "Search query using the platform's native syntax" },
+          "max_results": { "type": "number", "description": "Maximum number of results to return (default 20)" }
+        },
+        "required": ["query"]
+      },
+      "executor": "tools/messaging-search.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "messaging_send",
+      "description": "Send a message on a platform. This is a high-risk action that always requires user approval. Include a confidence score (0-1).",
+      "category": "messaging",
+      "risk": "high",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "platform": { "type": "string", "description": "Platform (e.g. \"slack\", \"gmail\"). Auto-detected if only one is connected." },
+          "conversation_id": { "type": "string", "description": "Channel ID, email address, or conversation ID to send to" },
+          "text": { "type": "string", "description": "Message text to send" },
+          "subject": { "type": "string", "description": "Email subject line (Gmail only)" },
+          "in_reply_to": { "type": "string", "description": "Message-ID header for replies (Gmail only)" },
+          "confidence": { "type": "number", "description": "Confidence score (0-1) for this action" }
+        },
+        "required": ["conversation_id", "text", "confidence"]
+      },
+      "executor": "tools/messaging-send.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "messaging_reply",
+      "description": "Reply in a thread. Medium-risk action. Include a confidence score (0-1).",
+      "category": "messaging",
+      "risk": "medium",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "platform": { "type": "string", "description": "Platform (e.g. \"slack\", \"gmail\"). Auto-detected if only one is connected." },
+          "conversation_id": { "type": "string", "description": "Channel ID or conversation ID" },
+          "thread_id": { "type": "string", "description": "Thread ID to reply to" },
+          "text": { "type": "string", "description": "Reply text" },
+          "confidence": { "type": "number", "description": "Confidence score (0-1) for this action" }
+        },
+        "required": ["conversation_id", "thread_id", "text", "confidence"]
+      },
+      "executor": "tools/messaging-reply.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "messaging_mark_read",
+      "description": "Mark a conversation or message as read.",
+      "category": "messaging",
+      "risk": "low",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "platform": { "type": "string", "description": "Platform (e.g. \"slack\", \"gmail\"). Auto-detected if only one is connected." },
+          "conversation_id": { "type": "string", "description": "Conversation/channel ID" },
+          "message_id": { "type": "string", "description": "Specific message ID to mark as read (optional)" }
+        },
+        "required": ["conversation_id"]
+      },
+      "executor": "tools/messaging-mark-read.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "slack_add_reaction",
+      "description": "Add an emoji reaction to a Slack message. Include a confidence score (0-1).",
+      "category": "messaging",
+      "risk": "medium",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "channel": { "type": "string", "description": "Slack channel ID" },
+          "timestamp": { "type": "string", "description": "Message timestamp (ts)" },
+          "emoji": { "type": "string", "description": "Emoji name without colons (e.g. \"thumbsup\")" },
+          "confidence": { "type": "number", "description": "Confidence score (0-1) for this action" }
+        },
+        "required": ["channel", "timestamp", "emoji", "confidence"]
+      },
+      "executor": "tools/slack-add-reaction.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "slack_leave_channel",
+      "description": "Leave a Slack channel. Include a confidence score (0-1).",
+      "category": "messaging",
+      "risk": "medium",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "channel": { "type": "string", "description": "Slack channel ID to leave" },
+          "confidence": { "type": "number", "description": "Confidence score (0-1) for this action" }
+        },
+        "required": ["channel", "confidence"]
+      },
+      "executor": "tools/slack-leave-channel.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "messaging_analyze_activity",
+      "description": "Analyze channel or conversation activity levels. Groups conversations as high/medium/low/dead activity.",
+      "category": "messaging",
+      "risk": "low",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "platform": { "type": "string", "description": "Platform (e.g. \"slack\", \"gmail\"). Auto-detected if only one is connected." }
+        }
+      },
+      "executor": "tools/messaging-analyze-activity.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "messaging_analyze_style",
+      "description": "Analyze sent messages to extract personal writing style patterns. Saves style characteristics to memory for personalized drafting. Run once to enable style-aware message composition.",
+      "category": "messaging",
+      "risk": "low",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "platform": { "type": "string", "description": "Platform (e.g. \"slack\", \"gmail\"). Auto-detected if only one is connected." },
+          "max_messages": { "type": "number", "description": "Max sent messages to analyze (default 50, max 100)" },
+          "query_filter": { "type": "string", "description": "Optional search filter (e.g. 'to:alice@example.com' for Gmail, 'from:@me' for Slack)" }
+        }
+      },
+      "executor": "tools/messaging-analyze-style.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "messaging_draft",
+      "description": "Create, list, or delete local drafts for any platform.",
+      "category": "messaging",
+      "risk": "low",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "action": { "type": "string", "enum": ["create", "list", "delete"], "description": "Draft operation" },
+          "platform": { "type": "string", "description": "Platform (e.g. \"slack\", \"gmail\"). Required for create/list." },
+          "conversation_id": { "type": "string", "description": "Target conversation/channel ID (for create)" },
+          "text": { "type": "string", "description": "Draft text (for create)" },
+          "thread_id": { "type": "string", "description": "Thread ID (for create, optional)" },
+          "subject": { "type": "string", "description": "Email subject (for create, Gmail only)" },
+          "draft_id": { "type": "string", "description": "Draft ID (for delete)" }
+        },
+        "required": ["action"]
+      },
+      "executor": "tools/messaging-draft.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "gmail_archive",
+      "description": "Archive a Gmail message (remove from inbox). Include a confidence score (0-1).",
+      "category": "messaging",
+      "risk": "medium",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "message_id": { "type": "string", "description": "Gmail message ID to archive" },
+          "confidence": { "type": "number", "description": "Confidence score (0-1) for this action" }
+        },
+        "required": ["message_id", "confidence"]
+      },
+      "executor": "tools/gmail-archive.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "gmail_batch_archive",
+      "description": "Archive multiple Gmail messages at once. Include a confidence score (0-1).",
+      "category": "messaging",
+      "risk": "medium",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "message_ids": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Gmail message IDs to archive"
+          },
+          "confidence": { "type": "number", "description": "Confidence score (0-1) for this action" }
+        },
+        "required": ["message_ids", "confidence"]
+      },
+      "executor": "tools/gmail-batch-archive.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "gmail_label",
+      "description": "Add or remove labels on a Gmail message. Include a confidence score (0-1).",
+      "category": "messaging",
+      "risk": "medium",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "message_id": { "type": "string", "description": "Gmail message ID" },
+          "add_label_ids": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Label IDs to add"
+          },
+          "remove_label_ids": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Label IDs to remove"
+          },
+          "confidence": { "type": "number", "description": "Confidence score (0-1) for this action" }
+        },
+        "required": ["message_id", "confidence"]
+      },
+      "executor": "tools/gmail-label.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "gmail_batch_label",
+      "description": "Add or remove labels on multiple Gmail messages. Include a confidence score (0-1).",
+      "category": "messaging",
+      "risk": "medium",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "message_ids": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Gmail message IDs"
+          },
+          "add_label_ids": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Label IDs to add"
+          },
+          "remove_label_ids": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Label IDs to remove"
+          },
+          "confidence": { "type": "number", "description": "Confidence score (0-1) for this action" }
+        },
+        "required": ["message_ids", "confidence"]
+      },
+      "executor": "tools/gmail-batch-label.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "gmail_trash",
+      "description": "Move a Gmail message to trash. Include a confidence score (0-1).",
+      "category": "messaging",
+      "risk": "medium",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "message_id": { "type": "string", "description": "Gmail message ID to trash" },
+          "confidence": { "type": "number", "description": "Confidence score (0-1) for this action" }
+        },
+        "required": ["message_id", "confidence"]
+      },
+      "executor": "tools/gmail-trash.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "gmail_unsubscribe",
+      "description": "Unsubscribe from a mailing list by following the List-Unsubscribe header. Include a confidence score (0-1).",
+      "category": "messaging",
+      "risk": "medium",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "message_id": { "type": "string", "description": "A Gmail message ID from the mailing list to unsubscribe from" },
+          "confidence": { "type": "number", "description": "Confidence score (0-1) for this action" }
+        },
+        "required": ["message_id", "confidence"]
+      },
+      "executor": "tools/gmail-unsubscribe.ts",
+      "execution_target": "host"
+    },
+    {
+      "name": "gmail_draft",
+      "description": "Create a draft email in Gmail. The draft will appear in Gmail Drafts for user review.",
+      "category": "messaging",
+      "risk": "low",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "to": { "type": "string", "description": "Recipient email address" },
+          "subject": { "type": "string", "description": "Email subject line" },
+          "body": { "type": "string", "description": "Email body (plain text)" },
+          "in_reply_to": { "type": "string", "description": "Message-ID header of the email being replied to" }
+        },
+        "required": ["to", "subject", "body"]
+      },
+      "executor": "tools/gmail-draft.ts",
+      "execution_target": "host"
+    }
+  ]
+}

package/src/config/bundled-skills/messaging/tools/gmail-archive.ts

@@ -0,0 +1,23 @@
+import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
+import { withValidToken } from '../../../../security/token-manager.js';
+import { getMessagingProvider } from '../../../../messaging/registry.js';
+import { modifyMessage } from '../../../../messaging/providers/gmail/client.js';
+import { ok, err } from './shared.js';
+
+export async function run(input: Record<string, unknown>, _context: ToolContext): Promise<ToolExecutionResult> {
+  const messageId = input.message_id as string;
+
+  if (!messageId) {
+    return err('message_id is required.');
+  }
+
+  try {
+    const provider = getMessagingProvider('gmail');
+    return withValidToken(provider.credentialService, async (token) => {
+      await modifyMessage(token, messageId, { removeLabelIds: ['INBOX'] });
+      return ok('Message archived.');
+    });
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}

package/src/config/bundled-skills/messaging/tools/gmail-batch-archive.ts

@@ -0,0 +1,23 @@
+import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
+import { withValidToken } from '../../../../security/token-manager.js';
+import { getMessagingProvider } from '../../../../messaging/registry.js';
+import { batchModifyMessages } from '../../../../messaging/providers/gmail/client.js';
+import { ok, err } from './shared.js';
+
+export async function run(input: Record<string, unknown>, _context: ToolContext): Promise<ToolExecutionResult> {
+  const messageIds = input.message_ids as string[];
+
+  if (!messageIds?.length) {
+    return err('message_ids is required and must not be empty.');
+  }
+
+  try {
+    const provider = getMessagingProvider('gmail');
+    return withValidToken(provider.credentialService, async (token) => {
+      await batchModifyMessages(token, messageIds, { removeLabelIds: ['INBOX'] });
+      return ok(`Archived ${messageIds.length} message(s).`);
+    });
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}

package/src/config/bundled-skills/messaging/tools/gmail-batch-label.ts

@@ -0,0 +1,25 @@
+import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
+import { withValidToken } from '../../../../security/token-manager.js';
+import { getMessagingProvider } from '../../../../messaging/registry.js';
+import { batchModifyMessages } from '../../../../messaging/providers/gmail/client.js';
+import { ok, err } from './shared.js';
+
+export async function run(input: Record<string, unknown>, _context: ToolContext): Promise<ToolExecutionResult> {
+  const messageIds = input.message_ids as string[];
+  const addLabelIds = input.add_label_ids as string[] | undefined;
+  const removeLabelIds = input.remove_label_ids as string[] | undefined;
+
+  if (!messageIds?.length) {
+    return err('message_ids is required and must not be empty.');
+  }
+
+  try {
+    const provider = getMessagingProvider('gmail');
+    return withValidToken(provider.credentialService, async (token) => {
+      await batchModifyMessages(token, messageIds, { addLabelIds, removeLabelIds });
+      return ok(`Labels updated on ${messageIds.length} message(s).`);
+    });
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}

package/src/config/bundled-skills/messaging/tools/gmail-draft.ts

@@ -0,0 +1,26 @@
+import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
+import { withValidToken } from '../../../../security/token-manager.js';
+import { getMessagingProvider } from '../../../../messaging/registry.js';
+import { createDraft } from '../../../../messaging/providers/gmail/client.js';
+import { ok, err } from './shared.js';
+
+export async function run(input: Record<string, unknown>, _context: ToolContext): Promise<ToolExecutionResult> {
+  const to = input.to as string;
+  const subject = input.subject as string;
+  const body = input.body as string;
+  const inReplyTo = input.in_reply_to as string | undefined;
+
+  if (!to) return err('to is required.');
+  if (!subject) return err('subject is required.');
+  if (!body) return err('body is required.');
+
+  try {
+    const provider = getMessagingProvider('gmail');
+    return withValidToken(provider.credentialService, async (token) => {
+      const draft = await createDraft(token, to, subject, body, inReplyTo);
+      return ok(`Draft created (ID: ${draft.id}). It will appear in your Gmail Drafts.`);
+    });
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}

package/src/config/bundled-skills/messaging/tools/gmail-label.ts

@@ -0,0 +1,25 @@
+import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
+import { withValidToken } from '../../../../security/token-manager.js';
+import { getMessagingProvider } from '../../../../messaging/registry.js';
+import { modifyMessage } from '../../../../messaging/providers/gmail/client.js';
+import { ok, err } from './shared.js';
+
+export async function run(input: Record<string, unknown>, _context: ToolContext): Promise<ToolExecutionResult> {
+  const messageId = input.message_id as string;
+  const addLabelIds = input.add_label_ids as string[] | undefined;
+  const removeLabelIds = input.remove_label_ids as string[] | undefined;
+
+  if (!messageId) {
+    return err('message_id is required.');
+  }
+
+  try {
+    const provider = getMessagingProvider('gmail');
+    return withValidToken(provider.credentialService, async (token) => {
+      await modifyMessage(token, messageId, { addLabelIds, removeLabelIds });
+      return ok('Labels updated.');
+    });
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}

package/src/config/bundled-skills/messaging/tools/gmail-trash.ts

@@ -0,0 +1,23 @@
+import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
+import { withValidToken } from '../../../../security/token-manager.js';
+import { getMessagingProvider } from '../../../../messaging/registry.js';
+import { trashMessage } from '../../../../messaging/providers/gmail/client.js';
+import { ok, err } from './shared.js';
+
+export async function run(input: Record<string, unknown>, _context: ToolContext): Promise<ToolExecutionResult> {
+  const messageId = input.message_id as string;
+
+  if (!messageId) {
+    return err('message_id is required.');
+  }
+
+  try {
+    const provider = getMessagingProvider('gmail');
+    return withValidToken(provider.credentialService, async (token) => {
+      await trashMessage(token, messageId);
+      return ok('Message moved to trash.');
+    });
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}

package/src/config/bundled-skills/messaging/tools/gmail-unsubscribe.ts

@@ -0,0 +1,84 @@
+import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
+import { withValidToken } from '../../../../security/token-manager.js';
+import { getMessagingProvider } from '../../../../messaging/registry.js';
+import { getMessage, sendMessage } from '../../../../messaging/providers/gmail/client.js';
+import { isPrivateOrLocalHost, resolveHostAddresses, resolveRequestAddress } from '../../../../tools/network/url-safety.js';
+import { ok, err, pinnedHttpsRequest } from './shared.js';
+
+export async function run(input: Record<string, unknown>, _context: ToolContext): Promise<ToolExecutionResult> {
+  const messageId = input.message_id as string;
+
+  if (!messageId) {
+    return err('message_id is required.');
+  }
+
+  try {
+    const provider = getMessagingProvider('gmail');
+    return withValidToken(provider.credentialService, async (token) => {
+      const message = await getMessage(token, messageId, 'metadata', ['List-Unsubscribe', 'List-Unsubscribe-Post']);
+      const headers = message.payload?.headers ?? [];
+      const unsubHeader = headers.find((h) => h.name.toLowerCase() === 'list-unsubscribe')?.value;
+
+      if (!unsubHeader) {
+        return err('No List-Unsubscribe header found. Manual unsubscribe may be required.');
+      }
+
+      const httpsMatch = unsubHeader.match(/<(https:\/\/[^>]+)>/);
+      const mailtoMatch = unsubHeader.match(/<mailto:([^>]+)>/);
+      const postHeader = headers.find((h) => h.name.toLowerCase() === 'list-unsubscribe-post')?.value;
+
+      if (httpsMatch) {
+        const url = httpsMatch[1];
+        let parsed: URL;
+        let validatedAddresses: string[];
+        try {
+          parsed = new URL(url);
+          if (parsed.protocol !== 'https:') {
+            return err('Unsubscribe URL must use HTTPS.');
+          }
+          if (isPrivateOrLocalHost(parsed.hostname)) {
+            return err('Unsubscribe URL points to a private or local address.');
+          }
+          const { addresses, blockedAddress } = await resolveRequestAddress(parsed.hostname, resolveHostAddresses, false);
+          if (blockedAddress) {
+            return err('Unsubscribe URL resolves to a private or local address.');
+          }
+          if (addresses.length === 0) {
+            return err('Unable to resolve unsubscribe URL hostname.');
+          }
+          validatedAddresses = addresses;
+        } catch {
+          return err('Invalid unsubscribe URL.');
+        }
+
+        const method = postHeader ? 'POST' : 'GET';
+        const reqOpts = postHeader
+          ? { method: 'POST' as const, headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body: postHeader }
+          : undefined;
+
+        let lastStatus = 0;
+        for (const address of validatedAddresses) {
+          try {
+            lastStatus = await pinnedHttpsRequest(parsed, address, reqOpts);
+            if (lastStatus >= 200 && lastStatus < 400) {
+              return ok(`Successfully unsubscribed via HTTPS ${method}.`);
+            }
+          } catch {
+            continue;
+          }
+        }
+        return err(`Unsubscribe request failed: ${lastStatus}`);
+      }
+
+      if (mailtoMatch) {
+        const mailtoAddr = mailtoMatch[1].split('?')[0];
+        await sendMessage(token, mailtoAddr, 'Unsubscribe', 'Unsubscribe');
+        return ok(`Unsubscribe email sent to ${mailtoAddr}.`);
+      }
+
+      return err('No supported unsubscribe method found (requires https: or mailto: URL).');
+    });
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}

package/src/config/bundled-skills/messaging/tools/messaging-analyze-activity.ts

@@ -0,0 +1,18 @@
+import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
+import { classifyActivity } from '../../../../messaging/activity-analyzer.js';
+import { resolveProvider, withProviderToken, ok, err } from './shared.js';
+
+export async function run(input: Record<string, unknown>, _context: ToolContext): Promise<ToolExecutionResult> {
+  const platform = input.platform as string | undefined;
+
+  try {
+    const provider = resolveProvider(platform);
+    return withProviderToken(provider, async (token) => {
+      const conversations = await provider.listConversations(token);
+      const summary = classifyActivity(conversations, provider.id);
+      return ok(JSON.stringify(summary, null, 2));
+    });
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}