@nylas/helix-mcp-server 0.1.0

package/dist/server.js

@@ -0,0 +1,323 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { emailTools } from './tools/email.js';
+import { calendarTools } from './tools/calendar.js';
+import { contactsTools } from './tools/contacts.js';
+import { identityTools } from './tools/identity.js';
+import { shapeToolResponse } from './shape-response.js';
+const DETAIL_DEFAULTS = {
+    minimal: { jsonIndent: 0, includeAttribution: false, defaultBodyLimit: 500 },
+    standard: { jsonIndent: 2, includeAttribution: true, defaultBodyLimit: 2000 },
+    full: { jsonIndent: 2, includeAttribution: true, defaultBodyLimit: 0 },
+};
+/**
+ * Create an MCP server with AI identity tools registered.
+ * The server is stateless — context is provided per-request via the API client.
+ * Tools are filtered by enabledTools and responses shaped by responseDetail.
+ */
+export function createMcpServer(getContext) {
+    const server = new McpServer({
+        name: 'nylas-ai-identity',
+        version: '0.0.1',
+    });
+    const allTools = [
+        ...emailTools,
+        ...calendarTools,
+        ...contactsTools,
+        ...identityTools,
+    ];
+    // Register each tool with the MCP server
+    for (const tool of allTools) {
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        }, async (args) => {
+            const ctx = await getContext();
+            // Filter by enabled tool categories
+            const enabledTools = ctx.tokenOptimization?.enabledTools;
+            if (enabledTools && !enabledTools.includes(tool.category)) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'tool_disabled',
+                                message: `The '${tool.category}' tool category is disabled. Enable it at helix.nylas.com/identity.`,
+                            }),
+                        }],
+                };
+            }
+            // Check scopes
+            for (const scope of tool.requiredScopes) {
+                if (!ctx.scopes.includes(scope)) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: 'insufficient_scope',
+                                    message: `This action requires the '${scope}' scope.`,
+                                    hint: 'Re-authorize with the required scope at https://helix.nylas.com/identity',
+                                }),
+                            }],
+                    };
+                }
+            }
+            // Execute tool and audit
+            const toolStart = Date.now();
+            const result = await executeTool(tool.name, args, ctx);
+            const toolDuration = Date.now() - toolStart;
+            if (ctx.logToolCall) {
+                ctx.logToolCall(tool.name, args, toolDuration).catch(() => { });
+            }
+            // Apply response shaping based on token optimization settings
+            const detail = ctx.tokenOptimization?.responseDetail ?? 'standard';
+            const detailConfig = DETAIL_DEFAULTS[detail];
+            const bodyLimit = ctx.tokenOptimization?.maxBodyLength ?? detailConfig.defaultBodyLimit;
+            const bodyFormat = ctx.tokenOptimization?.bodyFormat ?? 'text';
+            let response = shapeToolResponse(tool.name, result, { detail, bodyLimit, bodyFormat });
+            if (detailConfig.includeAttribution && typeof response === 'object' && response !== null) {
+                response = {
+                    ...response,
+                    _attribution: {
+                        label: 'Powered by Helix',
+                        source: 'helix.nylas.com',
+                        version: '0.1.0',
+                    },
+                };
+            }
+            return {
+                content: [{ type: 'text', text: JSON.stringify(response, null, detailConfig.jsonIndent) }],
+            };
+        });
+    }
+    // Register resources
+    server.resource('identity-profile', 'identity://profile', async () => {
+        const ctx = await getContext();
+        return {
+            contents: [{
+                    uri: 'identity://profile',
+                    mimeType: 'application/json',
+                    text: JSON.stringify({
+                        userId: ctx.userId,
+                        grantId: ctx.grantId,
+                        scopes: ctx.scopes,
+                    }),
+                }],
+        };
+    });
+    return server;
+}
+/**
+ * Resolve the best grantId for a capability, falling back to primary.
+ */
+async function resolveGrant(ctx, capability) {
+    if (ctx.resolveGrantId)
+        return ctx.resolveGrantId(capability);
+    return ctx.grantId;
+}
+/**
+ * Execute a tool against the Nylas API.
+ * Routes tool calls to the appropriate Nylas endpoint.
+ * Each tool resolves the best grant for its required capability.
+ */
+async function executeTool(toolName, args, ctx) {
+    const nylasUrl = ctx.nylasApiUrl;
+    const headers = {
+        Authorization: `Bearer ${ctx.nylasApiKey}`,
+        'Content-Type': 'application/json',
+    };
+    switch (toolName) {
+        case 'email_search': {
+            const grantId = await resolveGrant(ctx, 'email.read');
+            const params = new URLSearchParams();
+            if (args.query)
+                params.set('search_query_native', String(args.query));
+            if (args.from)
+                params.set('from', String(args.from));
+            if (args.to)
+                params.set('to', String(args.to));
+            if (args.subject)
+                params.set('subject', String(args.subject));
+            if (args.unread !== undefined)
+                params.set('unread', String(args.unread));
+            params.set('limit', String(args.limit ?? 10));
+            const res = await fetch(`${nylasUrl}/v3/grants/${grantId}/messages?${params}`, { headers });
+            return res.json();
+        }
+        case 'email_read': {
+            const grantId = await resolveGrant(ctx, 'email.read');
+            const res = await fetch(`${nylasUrl}/v3/grants/${grantId}/messages/${args.message_id}`, { headers });
+            return res.json();
+        }
+        case 'email_send': {
+            const grantId = await resolveGrant(ctx, 'email.send');
+            const sendPayload = {
+                to: args.to,
+                subject: args.subject,
+                body: args.body,
+                reply_to_message_id: args.reply_to_message_id,
+            };
+            const sendSummary = `Send email to ${Array.isArray(args.to) ? args.to.map((r) => r.email).join(', ') : args.to}: ${args.subject ?? '(no subject)'}`;
+            if (ctx.checkApproval) {
+                const approval = await ctx.checkApproval('send_email', sendPayload, sendSummary);
+                if (!approval.approved) {
+                    return {
+                        status: 'pending_approval',
+                        pendingActionId: approval.pendingActionId,
+                        summary: sendSummary,
+                        hint: 'Approve at helix.nylas.com/now',
+                    };
+                }
+            }
+            const res = await fetch(`${nylasUrl}/v3/grants/${grantId}/messages/send`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(sendPayload),
+            });
+            const sendResult = await res.json();
+            if (ctx.logAction) {
+                await ctx.logAction('send_email', 'mcp_tool', sendSummary, 'success');
+            }
+            return sendResult;
+        }
+        case 'email_reply': {
+            const grantId = await resolveGrant(ctx, 'email.send');
+            // Get the thread to find the latest message
+            const threadRes = await fetch(`${nylasUrl}/v3/grants/${grantId}/threads/${args.thread_id}`, { headers });
+            const thread = (await threadRes.json());
+            const lastMessageId = thread.data.message_ids[thread.data.message_ids.length - 1];
+            const replyPayload = {
+                body: args.body,
+                reply_to_message_id: lastMessageId,
+            };
+            const replySummary = `Reply to thread ${args.thread_id}`;
+            if (ctx.checkApproval) {
+                const approval = await ctx.checkApproval('send_email', replyPayload, replySummary);
+                if (!approval.approved) {
+                    return {
+                        status: 'pending_approval',
+                        pendingActionId: approval.pendingActionId,
+                        summary: replySummary,
+                        hint: 'Approve at helix.nylas.com/now',
+                    };
+                }
+            }
+            const res = await fetch(`${nylasUrl}/v3/grants/${grantId}/messages/send`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(replyPayload),
+            });
+            const replyResult = await res.json();
+            if (ctx.logAction) {
+                await ctx.logAction('send_email', 'mcp_tool', replySummary, 'success');
+            }
+            return replyResult;
+        }
+        case 'calendar_events': {
+            const grantId = await resolveGrant(ctx, 'calendar.read');
+            const params = new URLSearchParams();
+            params.set('calendar_id', String(args.calendar_id ?? 'primary'));
+            params.set('limit', String(args.limit ?? 25));
+            if (args.start)
+                params.set('start', String(Math.floor(new Date(String(args.start)).getTime() / 1000)));
+            if (args.end)
+                params.set('end', String(Math.floor(new Date(String(args.end)).getTime() / 1000)));
+            const res = await fetch(`${nylasUrl}/v3/grants/${grantId}/events?${params}`, { headers });
+            return res.json();
+        }
+        case 'calendar_event_create': {
+            const grantId = await resolveGrant(ctx, 'calendar.write');
+            const eventPayload = {
+                title: args.title,
+                when: {
+                    start_time: Math.floor(new Date(String(args.start_time)).getTime() / 1000),
+                    end_time: Math.floor(new Date(String(args.end_time)).getTime() / 1000),
+                },
+                description: args.description,
+                location: args.location,
+                participants: args.participants,
+                calendar_id: args.calendar_id ?? 'primary',
+            };
+            const eventSummary = `Create event: ${args.title ?? '(untitled)'}`;
+            if (ctx.checkApproval) {
+                const approval = await ctx.checkApproval('create_event', eventPayload, eventSummary);
+                if (!approval.approved) {
+                    return {
+                        status: 'pending_approval',
+                        pendingActionId: approval.pendingActionId,
+                        summary: eventSummary,
+                        hint: 'Approve at helix.nylas.com/now',
+                    };
+                }
+            }
+            const res = await fetch(`${nylasUrl}/v3/grants/${grantId}/events`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(eventPayload),
+            });
+            const eventResult = await res.json();
+            if (ctx.logAction) {
+                await ctx.logAction('create_event', 'mcp_tool', eventSummary, 'success');
+            }
+            return eventResult;
+        }
+        case 'calendar_availability': {
+            const grantId = await resolveGrant(ctx, 'calendar.read');
+            const res = await fetch(`${nylasUrl}/v3/grants/${grantId}/calendars/free-busy`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({
+                    emails: args.emails,
+                    start_time: Math.floor(new Date(String(args.start)).getTime() / 1000),
+                    end_time: Math.floor(new Date(String(args.end)).getTime() / 1000),
+                }),
+            });
+            return res.json();
+        }
+        case 'contact_search': {
+            const grantId = await resolveGrant(ctx, 'contacts.read');
+            const params = new URLSearchParams();
+            params.set('limit', String(args.limit ?? 10));
+            if (args.query)
+                params.set('email', String(args.query));
+            const res = await fetch(`${nylasUrl}/v3/grants/${grantId}/contacts?${params}`, { headers });
+            return res.json();
+        }
+        case 'contact_get': {
+            const grantId = await resolveGrant(ctx, 'contacts.read');
+            const res = await fetch(`${nylasUrl}/v3/grants/${grantId}/contacts/${args.contact_id}`, { headers });
+            return res.json();
+        }
+        case 'identity_get_context': {
+            return {
+                userId: ctx.userId,
+                scopes: ctx.scopes,
+                displayName: ctx.identity?.displayName ?? null,
+                tone: ctx.identity?.tone ?? 'professional',
+                verbosity: ctx.identity?.verbosity ?? 'balanced',
+                customInstructions: ctx.identity?.customInstructions ?? null,
+                approvalPolicy: ctx.identity?.approvalPolicy ?? 'always',
+                capabilities: ctx.identity?.capabilities ?? ctx.scopes,
+                templateId: ctx.identity?.templateId ?? null,
+                hint: 'Use email_search or calendar_events to get specific data. Respect the approval policy and tone settings above when taking actions.',
+            };
+        }
+        case 'meta_whoami': {
+            return {
+                userId: ctx.userId,
+                grantId: ctx.grantId,
+                scopes: ctx.scopes,
+                server: 'nylas-ai-identity',
+                version: '0.1.0',
+                attribution: {
+                    label: 'Powered by Helix',
+                    poweredBy: 'Nylas',
+                    product: 'Helix',
+                    url: 'https://helix.nylas.com',
+                },
+                templateId: ctx.identity?.templateId ?? null,
+            };
+        }
+        default:
+            return { error: 'unknown_tool', message: `Tool '${toolName}' not found` };
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/shape-response.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Response shaping for MCP token optimization.
+ *
+ * Reduces token cost by stripping unnecessary fields and truncating
+ * large text content based on the user's configured response detail level.
+ */
+export type ResponseDetail = 'minimal' | 'standard' | 'full';
+export type BodyFormat = 'html' | 'text' | 'markdown';
+export interface ShapeConfig {
+    detail: ResponseDetail;
+    bodyLimit: number;
+    bodyFormat: BodyFormat;
+}
+/**
+ * Shape a tool response to reduce token usage.
+ * `full` detail passes through unchanged.
+ */
+export declare function shapeToolResponse(toolName: string, response: unknown, config: ShapeConfig): unknown;
+//# sourceMappingURL=shape-response.d.ts.map

package/dist/shape-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-response.d.ts","sourceRoot":"","sources":["../src/shape-response.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAA;AAC5D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAA;AAErD,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,cAAc,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,UAAU,CAAA;CACtB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,WAAW,GACjB,OAAO,CAkBT"}

package/dist/shape-response.js

@@ -0,0 +1,172 @@
+/**
+ * Response shaping for MCP token optimization.
+ *
+ * Reduces token cost by stripping unnecessary fields and truncating
+ * large text content based on the user's configured response detail level.
+ */
+import { htmlToMarkdown } from './html-to-markdown.js';
+/**
+ * Shape a tool response to reduce token usage.
+ * `full` detail passes through unchanged.
+ */
+export function shapeToolResponse(toolName, response, config) {
+    if (config.detail === 'full')
+        return response;
+    if (!response || typeof response !== 'object')
+        return response;
+    const obj = response;
+    // Nylas API responses wrap data in { request_id, data }
+    // For minimal, strip request_id to save tokens
+    const hasData = 'data' in obj;
+    if (!hasData)
+        return response;
+    const shaped = shapeByTool(toolName, obj.data, config);
+    if (config.detail === 'minimal') {
+        return { data: shaped };
+    }
+    // standard: keep request_id
+    return { ...obj, data: shaped };
+}
+function shapeByTool(toolName, data, config) {
+    switch (toolName) {
+        case 'email_search':
+            return shapeArray(data, (m) => shapeMessage(m, config, true));
+        case 'email_read':
+            return shapeMessage(data, config, false);
+        case 'calendar_events':
+            return shapeArray(data, (e) => shapeEvent(e, config));
+        case 'calendar_event_create':
+            return shapeEvent(data, config);
+        case 'contact_search':
+            return shapeArray(data, (c) => shapeContact(c, config));
+        case 'contact_get':
+            return shapeContact(data, config);
+        default:
+            return data;
+    }
+}
+function shapeArray(data, fn) {
+    if (!Array.isArray(data))
+        return data;
+    return data.map((item) => item && typeof item === 'object' ? fn(item) : item);
+}
+function shapeMessage(data, config, isList) {
+    if (!data || typeof data !== 'object')
+        return data;
+    const msg = data;
+    if (config.detail === 'minimal') {
+        const slim = {
+            id: msg.id,
+            subject: msg.subject,
+            from: shapeParticipants(msg.from),
+            date: msg.date,
+            unread: msg.unread,
+        };
+        if (isList) {
+            slim.snippet = truncate(String(msg.snippet ?? ''), 120);
+        }
+        else {
+            slim.to = shapeParticipants(msg.to);
+            slim.body = truncate(formatBody(String(msg.body ?? ''), config.bodyFormat), config.bodyLimit);
+            slim.thread_id = msg.thread_id;
+        }
+        return stripNulls(slim);
+    }
+    // standard / full: keep most fields, apply body format and truncation
+    const result = { ...msg };
+    if (result.body && typeof result.body === 'string') {
+        let formatted = formatBody(result.body, config.bodyFormat);
+        if (config.bodyLimit > 0) {
+            formatted = truncate(formatted, config.bodyLimit);
+        }
+        result.body = formatted;
+    }
+    // Strip heavyweight fields that LLMs rarely need
+    delete result.headers;
+    delete result.raw_mime;
+    return stripNulls(result);
+}
+function shapeEvent(data, config) {
+    if (!data || typeof data !== 'object')
+        return data;
+    const evt = data;
+    if (config.detail === 'minimal') {
+        const slim = {
+            id: evt.id,
+            title: evt.title,
+            when: evt.when,
+            status: evt.status,
+            busy: evt.busy,
+        };
+        if (evt.participants) {
+            slim.participants = shapeParticipants(evt.participants);
+        }
+        if (evt.location)
+            slim.location = evt.location;
+        return stripNulls(slim);
+    }
+    // standard: keep fields, truncate description
+    const result = { ...evt };
+    if (result.description && typeof result.description === 'string' && config.bodyLimit > 0) {
+        result.description = truncate(result.description, config.bodyLimit);
+    }
+    return stripNulls(result);
+}
+function shapeContact(data, config) {
+    if (!data || typeof data !== 'object')
+        return data;
+    const contact = data;
+    if (config.detail === 'minimal') {
+        return stripNulls({
+            id: contact.id,
+            given_name: contact.given_name,
+            surname: contact.surname,
+            emails: contact.emails,
+            company_name: contact.company_name,
+        });
+    }
+    return stripNulls(contact);
+}
+/**
+ * Reduce participant arrays to just email+name (strip status, comment, etc.)
+ */
+function shapeParticipants(data) {
+    if (!Array.isArray(data))
+        return data;
+    return data.map((p) => {
+        if (!p || typeof p !== 'object')
+            return p;
+        const { email, name } = p;
+        return name ? { email, name } : { email };
+    });
+}
+/** Convert email body to the requested output format. */
+function formatBody(body, format) {
+    switch (format) {
+        case 'markdown':
+            return htmlToMarkdown(body);
+        case 'text':
+            return stripHtml(body);
+        case 'html':
+        default:
+            return body;
+    }
+}
+function truncate(str, limit) {
+    if (limit <= 0 || str.length <= limit)
+        return str;
+    return `${str.slice(0, limit)}…`;
+}
+function stripHtml(html) {
+    return html.replace(/<[^>]+>/g, '').replace(/&nbsp;/g, ' ').replace(/\s+/g, ' ').trim();
+}
+function stripNulls(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value != null && value !== '') {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=shape-response.js.map

package/dist/shape-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-response.js","sourceRoot":"","sources":["../src/shape-response.ts"],"names":[],"mappings":"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"}

package/dist/tools/calendar.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from './types.js';
+export declare const calendarTools: ToolDefinition[];
+//# sourceMappingURL=calendar.d.ts.map

package/dist/tools/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/tools/calendar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,eAAO,MAAM,aAAa,EAAE,cAAc,EA8CzC,CAAA"}

package/dist/tools/calendar.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+export const calendarTools = [
+    {
+        name: 'calendar_events',
+        description: "List the user's calendar events within a date range. Defaults to today if no range specified.",
+        inputSchema: z.object({
+            start: z.string().optional().describe('Start of range in ISO-8601 format (defaults to now)'),
+            end: z.string().optional().describe('End of range in ISO-8601 format (defaults to end of today)'),
+            calendar_id: z.string().optional().describe('Specific calendar ID (defaults to primary)'),
+            limit: z.number().min(1).max(50).default(25).describe('Maximum events to return'),
+        }),
+        requiredScopes: ['calendar.read'],
+        category: 'calendar',
+    },
+    {
+        name: 'calendar_event_create',
+        description: "Create a new calendar event. Subject to the user's approval policy.",
+        inputSchema: z.object({
+            title: z.string().describe('Event title'),
+            start_time: z.string().describe('Start time in ISO-8601 format'),
+            end_time: z.string().describe('End time in ISO-8601 format'),
+            description: z.string().optional().describe('Event description'),
+            location: z.string().optional().describe('Event location'),
+            participants: z.array(z.object({
+                email: z.string().email(),
+                name: z.string().optional(),
+            })).optional().describe('Event participants to invite'),
+            calendar_id: z.string().optional().describe('Calendar ID (defaults to primary)'),
+        }),
+        requiredScopes: ['calendar.write'],
+        category: 'calendar',
+    },
+    {
+        name: 'calendar_availability',
+        description: 'Check availability / free-busy times across one or more people for scheduling.',
+        inputSchema: z.object({
+            emails: z.array(z.string().email()).min(1).describe('Email addresses to check availability for'),
+            start: z.string().describe('Start of search window in ISO-8601'),
+            end: z.string().describe('End of search window in ISO-8601'),
+            duration_minutes: z.number().min(5).max(480).optional().describe('Desired meeting duration in minutes'),
+        }),
+        requiredScopes: ['calendar.read'],
+        category: 'calendar',
+    },
+];
+//# sourceMappingURL=calendar.js.map

package/dist/tools/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../src/tools/calendar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC9C;QACC,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACV,+FAA+F;QAChG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;YAC5F,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;YACjG,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACzF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;SACjF,CAAC;QACF,cAAc,EAAE,CAAC,eAAe,CAAC;QACjC,QAAQ,EAAE,UAAU;KACpB;IACD;QACC,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACV,qEAAqE;QACtE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;YACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YAChE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YAC5D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAChE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAC1D,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;gBACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC3B,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YACvD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;SAChF,CAAC;QACF,cAAc,EAAE,CAAC,gBAAgB,CAAC;QAClC,QAAQ,EAAE,UAAU;KACpB;IACD;QACC,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACV,gFAAgF;QACjF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YAChG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YAChE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YAC5D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;SACvG,CAAC;QACF,cAAc,EAAE,CAAC,eAAe,CAAC;QACjC,QAAQ,EAAE,UAAU;KACpB;CACD,CAAA"}

package/dist/tools/contacts.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from './types.js';
+export declare const contactsTools: ToolDefinition[];
+//# sourceMappingURL=contacts.d.ts.map

package/dist/tools/contacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/tools/contacts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,eAAO,MAAM,aAAa,EAAE,cAAc,EAqBzC,CAAA"}

package/dist/tools/contacts.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export const contactsTools = [
+    {
+        name: 'contact_search',
+        description: "Search the user's contacts by name, email, company, or job title.",
+        inputSchema: z.object({
+            query: z.string().describe('Search query (name, email, or company)'),
+            limit: z.number().min(1).max(50).default(10).describe('Maximum results'),
+        }),
+        requiredScopes: ['contacts.read'],
+        category: 'contacts',
+    },
+    {
+        name: 'contact_get',
+        description: 'Get full details for a specific contact by ID.',
+        inputSchema: z.object({
+            contact_id: z.string().describe('The contact ID'),
+        }),
+        requiredScopes: ['contacts.read'],
+        category: 'contacts',
+    },
+];
+//# sourceMappingURL=contacts.js.map

package/dist/tools/contacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.js","sourceRoot":"","sources":["../../src/tools/contacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC9C;QACC,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACV,mEAAmE;QACpE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YACpE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;SACxE,CAAC;QACF,cAAc,EAAE,CAAC,eAAe,CAAC;QACjC,QAAQ,EAAE,UAAU;KACpB;IACD;QACC,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,gDAAgD;QAC7D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;SACjD,CAAC;QACF,cAAc,EAAE,CAAC,eAAe,CAAC;QACjC,QAAQ,EAAE,UAAU;KACpB;CACD,CAAA"}

package/dist/tools/email.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from './types.js';
+export declare const emailTools: ToolDefinition[];
+//# sourceMappingURL=email.d.ts.map