@vantageos/vantage-crm-mcp 0.1.0

package/dist/convex/crm/deals.js

@@ -0,0 +1,481 @@
+"use strict";
+/**
+ * convex/crm/deals.ts
+ *
+ * V0.1.0 — Extended from T3 stub.
+ * Functions: createDeal, updateDeal, moveStage, getDeal, listDeals,
+ *            archiveDeal, restoreDeal, deleteDeal (admin only).
+ * OQ-2: probability auto-set from workspace.pipelineStages at moveStage.
+ * OQ-4: soft delete + 30j grace for hard delete.
+ * Every mutation creates audit_log entry.
+ *
+ * Ref: vantage-crm-spec-2026-05-20.md §2 + §5 OQ-2/OQ-4
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forecast = exports.summary = exports.deleteDeal = exports.restoreDeal = exports.remove = exports.archiveDeal = exports.list = exports.listDeals = exports.moveStage = exports.update = exports.updateDeal = exports.get = exports.getDeal = exports.create = exports.createDeal = void 0;
+const server_1 = require("../_generated/server");
+const values_1 = require("convex/values");
+const workspace_1 = require("../lib/workspace");
+const auditLog_1 = require("../lib/auditLog");
+const rbac_1 = require("../lib/rbac");
+const _helpers_1 = require("./_helpers");
+// ---------------------------------------------------------------------------
+// Internal: resolve pipeline stage probability (OQ-2)
+// ---------------------------------------------------------------------------
+async function resolveStageProbability(ctx, workspaceId, stageName) {
+    const workspace = await ctx.db.get(workspaceId);
+    if (!workspace?.pipelineStages || workspace.pipelineStages.length === 0)
+        return undefined;
+    const stageConfig = workspace.pipelineStages.find((s) => s.name === stageName || s.id === stageName);
+    return stageConfig?.probability;
+}
+async function validateStage(ctx, workspaceId, stageName) {
+    const workspace = await ctx.db.get(workspaceId);
+    if (!workspace?.pipelineStages || workspace.pipelineStages.length === 0)
+        return;
+    const validStages = workspace.pipelineStages.map((s) => s.name);
+    if (!validStages.includes(stageName)) {
+        throw new Error(`Invalid stage "${stageName}". Valid stages: ${validStages.join(', ')}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// createDeal
+// ---------------------------------------------------------------------------
+exports.createDeal = (0, server_1.mutation)({
+    args: {
+        workspaceId: values_1.v.id('workspaces'),
+        title: values_1.v.string(),
+        stage: values_1.v.string(),
+        contactId: values_1.v.optional(values_1.v.id('contacts')),
+        companyId: values_1.v.optional(values_1.v.id('companies')),
+        value: values_1.v.optional(values_1.v.number()),
+        probability: values_1.v.optional(values_1.v.number()),
+        currency: values_1.v.optional(values_1.v.string()),
+        expectedCloseDate: values_1.v.optional(values_1.v.number()),
+        description: values_1.v.optional(values_1.v.string()),
+        tags: values_1.v.optional(values_1.v.array(values_1.v.string())),
+        notes: values_1.v.optional(values_1.v.string()),
+        source: values_1.v.optional(values_1.v.string()),
+        customFields: values_1.v.optional(values_1.v.record(values_1.v.string(), values_1.v.any())),
+        actorId: values_1.v.optional(values_1.v.string()),
+    },
+    returns: values_1.v.id('deals'),
+    handler: async (ctx, args) => {
+        const { clerkId, canWrite, actor } = await (0, workspace_1.assertWorkspaceAccess)(ctx, args.workspaceId, args.actorId);
+        if (!canWrite)
+            throw new Error('Insufficient permissions');
+        await validateStage(ctx, args.workspaceId, args.stage);
+        // OQ-2: auto-set probability from pipeline config if not provided
+        const autoProbability = args.probability ?? (await resolveStageProbability(ctx, args.workspaceId, args.stage));
+        let companyName;
+        let contactName;
+        if (args.companyId) {
+            const company = await ctx.db.get(args.companyId);
+            companyName = company?.name;
+        }
+        if (args.contactId) {
+            const contact = await ctx.db.get(args.contactId);
+            contactName = contact ? `${contact.firstName} ${contact.lastName}` : undefined;
+        }
+        const searchableText = (0, _helpers_1.buildDealSearchText)({ title: args.title }, companyName, contactName);
+        const now = Date.now();
+        const dealId = await ctx.db.insert('deals', {
+            title: args.title,
+            stage: args.stage,
+            contactId: args.contactId,
+            companyId: args.companyId,
+            value: args.value,
+            probability: autoProbability,
+            currency: args.currency,
+            expectedCloseDate: args.expectedCloseDate,
+            description: args.description,
+            tags: args.tags,
+            notes: args.notes,
+            source: args.source,
+            customFields: args.customFields,
+            workspaceId: args.workspaceId,
+            ownerId: clerkId,
+            stageChangedAt: now,
+            searchableText,
+            createdAt: now,
+            updatedAt: now,
+        });
+        await ctx.db.insert('audit_log', {
+            workspaceId: args.workspaceId,
+            actorId: actor.actorId,
+            actorType: actor.auditActorType,
+            entityType: 'deal',
+            entityId: dealId,
+            action: 'create',
+            timestamp: Date.now(),
+        });
+        return dealId;
+    },
+});
+// Backward-compatible alias
+exports.create = exports.createDeal;
+// ---------------------------------------------------------------------------
+// getDeal / get
+// ---------------------------------------------------------------------------
+exports.getDeal = (0, server_1.query)({
+    args: {
+        dealId: values_1.v.id('deals'),
+    },
+    returns: values_1.v.union(values_1.v.null(), values_1.v.any()),
+    handler: async (ctx, args) => {
+        const deal = await ctx.db.get(args.dealId);
+        if (!deal)
+            return null;
+        await (0, workspace_1.validateWorkspaceAccess)(ctx, deal.workspaceId);
+        let contact = null;
+        if (deal.contactId)
+            contact = await ctx.db.get(deal.contactId);
+        let company = null;
+        if (deal.companyId)
+            company = await ctx.db.get(deal.companyId);
+        return { ...deal, contact, company };
+    },
+});
+exports.get = exports.getDeal;
+// ---------------------------------------------------------------------------
+// updateDeal / update
+// ---------------------------------------------------------------------------
+exports.updateDeal = (0, server_1.mutation)({
+    args: {
+        dealId: values_1.v.id('deals'),
+        title: values_1.v.optional(values_1.v.string()),
+        stage: values_1.v.optional(values_1.v.string()),
+        contactId: values_1.v.optional(values_1.v.id('contacts')),
+        companyId: values_1.v.optional(values_1.v.id('companies')),
+        value: values_1.v.optional(values_1.v.number()),
+        probability: values_1.v.optional(values_1.v.number()),
+        currency: values_1.v.optional(values_1.v.string()),
+        expectedCloseDate: values_1.v.optional(values_1.v.number()),
+        description: values_1.v.optional(values_1.v.string()),
+        tags: values_1.v.optional(values_1.v.array(values_1.v.string())),
+        notes: values_1.v.optional(values_1.v.string()),
+        source: values_1.v.optional(values_1.v.string()),
+        lostReason: values_1.v.optional(values_1.v.string()),
+        actualCloseDate: values_1.v.optional(values_1.v.number()),
+        customFields: values_1.v.optional(values_1.v.record(values_1.v.string(), values_1.v.any())),
+        actorId: values_1.v.optional(values_1.v.string()),
+    },
+    returns: values_1.v.id('deals'),
+    handler: async (ctx, args) => {
+        const deal = await ctx.db.get(args.dealId);
+        if (!deal)
+            throw new Error('Deal not found');
+        const { canWrite, actor } = await (0, workspace_1.assertWorkspaceAccess)(ctx, deal.workspaceId, args.actorId);
+        if (!canWrite)
+            throw new Error('Insufficient permissions');
+        const { dealId, actorId: _actorId, ...updates } = args;
+        if (updates.stage) {
+            await validateStage(ctx, deal.workspaceId, updates.stage);
+            // OQ-2: auto-set probability when stage changes
+            if (updates.probability === undefined) {
+                updates.probability = await resolveStageProbability(ctx, deal.workspaceId, updates.stage);
+            }
+        }
+        const title = updates.title ?? deal.title;
+        let companyName;
+        let contactName;
+        const companyId = updates.companyId ?? deal.companyId;
+        if (companyId) {
+            const company = await ctx.db.get(companyId);
+            companyName = company?.name;
+        }
+        const contactId = updates.contactId ?? deal.contactId;
+        if (contactId) {
+            const contact = await ctx.db.get(contactId);
+            contactName = contact ? `${contact.firstName} ${contact.lastName}` : undefined;
+        }
+        const searchableText = (0, _helpers_1.buildDealSearchText)({ title }, companyName, contactName);
+        const beforeRecord = { ...deal };
+        await ctx.db.patch(dealId, {
+            ...updates,
+            searchableText,
+            updatedAt: Date.now(),
+        });
+        const afterRecord = (await ctx.db.get(dealId)) ?? {};
+        const fieldChanges = (0, auditLog_1.diffRecords)(beforeRecord, afterRecord);
+        await ctx.db.insert('audit_log', {
+            workspaceId: deal.workspaceId,
+            actorId: actor.actorId,
+            actorType: actor.auditActorType,
+            entityType: 'deal',
+            entityId: dealId,
+            action: 'update',
+            fieldChanges: fieldChanges.length > 0 ? fieldChanges : undefined,
+            timestamp: Date.now(),
+        });
+        return dealId;
+    },
+});
+exports.update = exports.updateDeal;
+// ---------------------------------------------------------------------------
+// moveStage (OQ-2: auto-set probability)
+// ---------------------------------------------------------------------------
+exports.moveStage = (0, server_1.mutation)({
+    args: {
+        dealId: values_1.v.id('deals'),
+        newStage: values_1.v.string(),
+        reason: values_1.v.optional(values_1.v.string()),
+        actorId: values_1.v.optional(values_1.v.string()),
+    },
+    returns: values_1.v.id('deals'),
+    handler: async (ctx, args) => {
+        const deal = await ctx.db.get(args.dealId);
+        if (!deal)
+            throw new Error('Deal not found');
+        const { clerkId, canWrite, actor } = await (0, workspace_1.assertWorkspaceAccess)(ctx, deal.workspaceId, args.actorId);
+        if (!canWrite)
+            throw new Error('Insufficient permissions');
+        await validateStage(ctx, deal.workspaceId, args.newStage);
+        // OQ-2: auto-set probability from pipeline stage config
+        const autoProbability = await resolveStageProbability(ctx, deal.workspaceId, args.newStage);
+        const oldStage = deal.stage;
+        const now = Date.now();
+        const patchData = {
+            stage: args.newStage,
+            stageChangedAt: now,
+            updatedAt: now,
+        };
+        if (autoProbability !== undefined) {
+            patchData.probability = autoProbability;
+        }
+        if (args.newStage.toLowerCase().includes('lost')) {
+            patchData.lostReason = args.reason ?? 'No reason provided';
+        }
+        await ctx.db.patch(args.dealId, patchData);
+        // Create stage-change activity (audit trail)
+        await ctx.db.insert('activities', {
+            type: 'stage-change',
+            subject: `Stage changed: ${oldStage} → ${args.newStage}`,
+            description: `${oldStage} → ${args.newStage}${args.reason ? ` (${args.reason})` : ''}`,
+            dealId: args.dealId,
+            contactId: deal.contactId,
+            companyId: deal.companyId,
+            workspaceId: deal.workspaceId,
+            ownerId: clerkId,
+            actorType: actor.auditActorType,
+            actorId: actor.actorId,
+            occurredAt: now,
+            createdAt: now,
+            updatedAt: now,
+        });
+        await ctx.db.insert('audit_log', {
+            workspaceId: deal.workspaceId,
+            actorId: actor.actorId,
+            actorType: actor.auditActorType,
+            entityType: 'deal',
+            entityId: args.dealId,
+            action: 'stage-change',
+            fieldChanges: [
+                { fieldName: 'stage', oldValue: oldStage, newValue: args.newStage },
+                ...(autoProbability !== undefined
+                    ? [
+                        {
+                            fieldName: 'probability',
+                            oldValue: deal.probability ?? null,
+                            newValue: autoProbability,
+                        },
+                    ]
+                    : []),
+            ],
+            timestamp: Date.now(),
+        });
+        return args.dealId;
+    },
+});
+// ---------------------------------------------------------------------------
+// listDeals / list
+// ---------------------------------------------------------------------------
+exports.listDeals = (0, server_1.query)({
+    args: {
+        workspaceId: values_1.v.id('workspaces'),
+        stage: values_1.v.optional(values_1.v.string()),
+        ownerId: values_1.v.optional(values_1.v.string()),
+        includeArchived: values_1.v.optional(values_1.v.boolean()),
+        limit: values_1.v.optional(values_1.v.number()),
+    },
+    returns: values_1.v.array(values_1.v.any()),
+    handler: async (ctx, args) => {
+        await (0, workspace_1.validateWorkspaceAccess)(ctx, args.workspaceId);
+        const limit = args.limit ?? 50;
+        let deals;
+        if (args.stage) {
+            deals = await ctx.db
+                .query('deals')
+                .withIndex('by_workspace_stage', (q) => q.eq('workspaceId', args.workspaceId).eq('stage', args.stage))
+                .order('desc')
+                .take(limit + 1);
+        }
+        else {
+            deals = await ctx.db
+                .query('deals')
+                .withIndex('by_workspace', (q) => q.eq('workspaceId', args.workspaceId))
+                .order('desc')
+                .take(limit + 1);
+        }
+        let filtered = args.includeArchived ? deals : deals.filter((d) => d.isArchived !== true);
+        if (args.ownerId) {
+            filtered = filtered.filter((d) => d.ownerId === args.ownerId);
+        }
+        return filtered.slice(0, limit);
+    },
+});
+exports.list = exports.listDeals;
+// ---------------------------------------------------------------------------
+// archiveDeal (OQ-4 soft delete)
+// ---------------------------------------------------------------------------
+exports.archiveDeal = (0, server_1.mutation)({
+    args: {
+        dealId: values_1.v.id('deals'),
+        actorId: values_1.v.optional(values_1.v.string()),
+    },
+    returns: values_1.v.id('deals'),
+    handler: async (ctx, args) => {
+        const deal = await ctx.db.get(args.dealId);
+        if (!deal)
+            throw new Error('Deal not found');
+        const { canWrite, actor } = await (0, workspace_1.assertWorkspaceAccess)(ctx, deal.workspaceId, args.actorId);
+        if (!canWrite)
+            throw new Error('Insufficient permissions');
+        if (deal.isArchived)
+            throw new Error('Deal is already archived');
+        const now = Date.now();
+        return (0, auditLog_1.withAuditLog)(ctx, {
+            workspaceId: deal.workspaceId,
+            actorId: actor.actorId,
+            actorType: actor.auditActorType,
+            entityType: 'deal',
+            entityId: args.dealId,
+            action: 'archive',
+        }, async () => {
+            await ctx.db.patch(args.dealId, {
+                isArchived: true,
+                archivedAt: now,
+                updatedAt: now,
+            });
+            return args.dealId;
+        });
+    },
+});
+// Backward-compatible alias
+exports.remove = exports.archiveDeal;
+// ---------------------------------------------------------------------------
+// restoreDeal
+// ---------------------------------------------------------------------------
+exports.restoreDeal = (0, server_1.mutation)({
+    args: {
+        dealId: values_1.v.id('deals'),
+        actorId: values_1.v.optional(values_1.v.string()),
+    },
+    returns: values_1.v.id('deals'),
+    handler: async (ctx, args) => {
+        const deal = await ctx.db.get(args.dealId);
+        if (!deal)
+            throw new Error('Deal not found');
+        const { canWrite, actor } = await (0, workspace_1.assertWorkspaceAccess)(ctx, deal.workspaceId, args.actorId);
+        if (!canWrite)
+            throw new Error('Insufficient permissions');
+        if (!deal.isArchived)
+            throw new Error('Deal is not archived');
+        return (0, auditLog_1.withAuditLog)(ctx, {
+            workspaceId: deal.workspaceId,
+            actorId: actor.actorId,
+            actorType: actor.auditActorType,
+            entityType: 'deal',
+            entityId: args.dealId,
+            action: 'restore',
+        }, async () => {
+            await ctx.db.patch(args.dealId, {
+                isArchived: false,
+                archivedAt: undefined,
+                updatedAt: Date.now(),
+            });
+            return args.dealId;
+        });
+    },
+});
+// ---------------------------------------------------------------------------
+// deleteDeal — ADMIN SCOPE ONLY (hard delete, OQ-4: 30j grace)
+// ---------------------------------------------------------------------------
+exports.deleteDeal = (0, server_1.mutation)({
+    args: {
+        dealId: values_1.v.id('deals'),
+    },
+    returns: values_1.v.id('deals'),
+    handler: async (ctx, args) => {
+        const deal = await ctx.db.get(args.dealId);
+        if (!deal)
+            throw new Error('Deal not found');
+        const { role, actor } = await (0, workspace_1.assertWorkspaceAccess)(ctx, deal.workspaceId);
+        await (0, rbac_1.assertAdminScope)(ctx, role);
+        if (!deal.isArchived) {
+            throw new Error('Deal must be archived before hard delete');
+        }
+        const archivedAt = deal.archivedAt ?? 0;
+        const gracePeriodMs = 30 * 24 * 60 * 60 * 1000;
+        if (Date.now() - archivedAt < gracePeriodMs) {
+            const daysLeft = Math.ceil((gracePeriodMs - (Date.now() - archivedAt)) / (24 * 60 * 60 * 1000));
+            throw new Error(`Deal cannot be hard deleted yet. ${daysLeft} day(s) remaining in grace period.`);
+        }
+        await ctx.db.insert('audit_log', {
+            workspaceId: deal.workspaceId,
+            actorId: actor.actorId,
+            actorType: actor.auditActorType,
+            entityType: 'deal',
+            entityId: args.dealId,
+            action: 'delete',
+            timestamp: Date.now(),
+        });
+        await ctx.db.delete(args.dealId);
+        return args.dealId;
+    },
+});
+// ---------------------------------------------------------------------------
+// summary + forecast — preserved from T3
+// ---------------------------------------------------------------------------
+exports.summary = (0, server_1.query)({
+    args: { dealId: values_1.v.id('deals') },
+    returns: values_1.v.union(values_1.v.null(), values_1.v.any()),
+    handler: async (ctx, args) => {
+        const deal = await ctx.db.get(args.dealId);
+        if (!deal)
+            return null;
+        await (0, workspace_1.validateWorkspaceAccess)(ctx, deal.workspaceId);
+        let contact = null;
+        if (deal.contactId)
+            contact = await ctx.db.get(deal.contactId);
+        let company = null;
+        if (deal.companyId)
+            company = await ctx.db.get(deal.companyId);
+        const activities = await ctx.db
+            .query('activities')
+            .withIndex('by_deal', (q) => q.eq('dealId', args.dealId))
+            .order('desc')
+            .take(50);
+        return { ...deal, contact, company, activities };
+    },
+});
+exports.forecast = (0, server_1.query)({
+    args: { workspaceId: values_1.v.id('workspaces') },
+    returns: values_1.v.any(),
+    handler: async (ctx, args) => {
+        await (0, workspace_1.validateWorkspaceAccess)(ctx, args.workspaceId);
+        const deals = await ctx.db
+            .query('deals')
+            .withIndex('by_workspace', (q) => q.eq('workspaceId', args.workspaceId))
+            .take(1000);
+        const activeDeals = deals.filter((d) => d.isArchived !== true &&
+            !d.stage.toLowerCase().includes('lost') &&
+            !d.stage.toLowerCase().includes('closed-lost'));
+        const weightedTotal = activeDeals.reduce((sum, d) => {
+            const value = d.value ?? 0;
+            const probability = d.probability ?? 0;
+            return sum + (value * probability) / 100;
+        }, 0);
+        return { totalWeightedValue: weightedTotal, dealCount: activeDeals.length };
+    },
+});

package/dist/convex/crm/emailActions.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * CRM Email Actions — Draft & Send
+ *
+ * Server-side email actions for the AI tool layer.
+ * email_draft: generates email content using AI + contact context
+ * email_send: sends via Composio Gmail API, logs activity
+ *
+ * These are Convex mutations/queries used by the AI tools in crm-tools.ts.
+ * The actual Composio calls happen in the Next.js layer (lib/integrations/gmail-sync.ts).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findContactByEmail = exports.getContactContext = exports.logSentEmail = void 0;
+const server_1 = require("../_generated/server");
+const values_1 = require("convex/values");
+const workspace_1 = require("../lib/workspace");
+// =============================================================================
+// LOG SENT EMAIL AS ACTIVITY
+// =============================================================================
+/**
+ * Log a sent email as an activity linked to contact/company/deal.
+ * Called after successful email send from the AI tool layer.
+ */
+exports.logSentEmail = (0, server_1.mutation)({
+    args: {
+        workspaceId: values_1.v.id('workspaces'),
+        to: values_1.v.string(),
+        subject: values_1.v.string(),
+        body: values_1.v.string(),
+        contactId: values_1.v.optional(values_1.v.id('contacts')),
+        companyId: values_1.v.optional(values_1.v.id('companies')),
+        dealId: values_1.v.optional(values_1.v.id('deals')),
+    },
+    handler: async (ctx, args) => {
+        const { clerkId, canWrite } = await (0, workspace_1.validateWorkspaceAccess)(ctx, args.workspaceId);
+        if (!canWrite)
+            throw new Error('Insufficient permissions');
+        const now = Date.now();
+        // Create activity of type 'email'
+        const activityId = await ctx.db.insert('activities', {
+            type: 'email-sent',
+            subject: `Sent: ${args.subject}`,
+            description: `To: ${args.to}\n\n${args.body.substring(0, 2000)}`,
+            contactId: args.contactId,
+            companyId: args.companyId,
+            dealId: args.dealId,
+            actorType: 'agent',
+            actorId: 'agent:ai',
+            workspaceId: args.workspaceId,
+            ownerId: clerkId,
+            occurredAt: now,
+            createdAt: now,
+            updatedAt: now,
+        });
+        // Update lastActivityAt on deal if linked
+        if (args.dealId) {
+            await ctx.db.patch(args.dealId, {
+                lastActivityAt: now,
+                updatedAt: now,
+            });
+        }
+        // Update lastContactedAt on contact if linked
+        if (args.contactId) {
+            await ctx.db.patch(args.contactId, {
+                lastContactedAt: now,
+                updatedAt: now,
+            });
+        }
+        return activityId;
+    },
+});
+// =============================================================================
+// GET CONTACT CONTEXT (for AI email drafting)
+// =============================================================================
+/**
+ * Fetch contact details + recent activities + recent emails for AI context.
+ * Used by email_draft tool to generate contextual emails.
+ */
+exports.getContactContext = (0, server_1.query)({
+    args: {
+        workspaceId: values_1.v.id('workspaces'),
+        contactId: values_1.v.id('contacts'),
+    },
+    handler: async (ctx, args) => {
+        await (0, workspace_1.validateWorkspaceAccess)(ctx, args.workspaceId);
+        const contact = await ctx.db.get(args.contactId);
+        if (!contact || contact.workspaceId !== args.workspaceId) {
+            return null;
+        }
+        // Get company if linked
+        let company = null;
+        if (contact.companyId) {
+            company = await ctx.db.get(contact.companyId);
+        }
+        // Get recent activities
+        const activities = await ctx.db
+            .query('activities')
+            .withIndex('by_contact', (q) => q.eq('contactId', args.contactId))
+            .order('desc')
+            .take(5);
+        // Get recent emails
+        const emails = await ctx.db
+            .query('emailSync')
+            .withIndex('by_contact', (q) => q.eq('contactId', args.contactId))
+            .order('desc')
+            .take(5);
+        return {
+            contact: {
+                id: contact._id,
+                firstName: contact.firstName,
+                lastName: contact.lastName,
+                email: contact.email,
+                phone: contact.phone,
+                jobTitle: contact.jobTitle,
+                type: contact.type,
+                notes: contact.notes,
+            },
+            company: company
+                ? {
+                    id: company._id,
+                    name: company.name,
+                    domain: company.domain,
+                    industry: company.industry,
+                }
+                : null,
+            recentActivities: activities.map((a) => ({
+                type: a.type,
+                subject: a.subject,
+                occurredAt: a.occurredAt,
+            })),
+            recentEmails: emails.map((e) => ({
+                subject: e.subject,
+                from: e.from,
+                snippet: e.snippet,
+                sentAt: e.sentAt,
+            })),
+        };
+    },
+});
+// =============================================================================
+// FIND CONTACT BY EMAIL (for auto-linking in send flow)
+// =============================================================================
+exports.findContactByEmail = (0, server_1.query)({
+    args: {
+        workspaceId: values_1.v.id('workspaces'),
+        email: values_1.v.string(),
+    },
+    handler: async (ctx, args) => {
+        await (0, workspace_1.validateWorkspaceAccess)(ctx, args.workspaceId);
+        const emailLower = args.email.toLowerCase();
+        const contact = await ctx.db
+            .query('contacts')
+            .withIndex('by_workspace', (q) => q.eq('workspaceId', args.workspaceId))
+            .filter((q) => q.eq(q.field('email'), emailLower))
+            .first();
+        return contact;
+    },
+});