@sendinel/mcp-server 1.0.146 → 1.0.148

package/build/tools/delivery-ops.js

@@ -13,7 +13,7 @@ function asRecord(value) {
 }
 function v1ErrorMessage(value) {
     const body = asRecord(value);
-    return asRecord(body.error).message ?? body.error ?? value;
+    return dbToolError(asRecord(body.error)).error ?? body.error ?? value;
 }
 async function resolveNameservers(domain) {
     const labels = domain.toLowerCase().split('.').filter(Boolean);
@@ -81,7 +81,7 @@ export function registerDeliveryOpsTools(server) {
             .eq('project_id', getProjectId())
             .order('date', { ascending: true });
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         return j({ blackout_dates: data ?? [] });
     });
     server.registerTool('add_blackout_date', {
@@ -111,7 +111,7 @@ export function registerDeliveryOpsTools(server) {
             .select('id, date, reason, created_at')
             .single();
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         return j({ blackout_date: data });
     });
     server.registerTool('remove_blackout_date', {
@@ -133,7 +133,7 @@ export function registerDeliveryOpsTools(server) {
             .eq('id', id)
             .eq('project_id', getProjectId());
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         if (!count)
             return j({ error: 'Blackout date not found', code: 'NOT_FOUND' });
         return j({ removed: true, id });
@@ -199,14 +199,14 @@ export function registerDeliveryOpsTools(server) {
                 .eq('id', domain_id)
                 .maybeSingle();
             if (error)
-                return j({ error: error.message });
+                return j(dbToolError(error));
             if (!data)
                 return j({ error: 'Domain not found after verification', code: 'NOT_FOUND' });
             return j({ domain_id, checked_live: true, status: data.status, verified_at: data.verified_at,
                 readiness: computeDomainReadiness(data) });
         }
         catch (error) {
-            return j({ error: error instanceof Error ? error.message : 'Domain recheck failed' });
+            return j({ error: error instanceof Error ? dbToolError(error).error : 'Domain recheck failed' });
         }
     }));
     server.registerTool('dnsbl_check', {
@@ -229,14 +229,14 @@ export function registerDeliveryOpsTools(server) {
             .eq('project_id', projectId)
             .maybeSingle();
         if (siteErr || !site)
-            return j({ error: siteErr?.message ?? 'Site not found', code: 'NOT_FOUND' });
+            return j({ error: (siteErr ? dbToolError(siteErr).error : undefined) ?? 'Site not found', code: 'NOT_FOUND' });
         const { data, error } = await db().from('dnsbl_snapshots')
             .select('domain, zone, listed, response_code, checked_at')
             .eq('site_id', siteId)
             .order('checked_at', { ascending: false })
             .limit(60);
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         const latestByZone = new Map();
         for (const row of data ?? []) {
             if (!latestByZone.has(row.zone))
@@ -282,7 +282,7 @@ export function registerDeliveryOpsTools(server) {
                 .maybeSingle(),
         ]);
         if (siteErr || !site)
-            return j({ error: siteErr?.message ?? 'Site not found', code: 'NOT_FOUND' });
+            return j({ error: (siteErr ? dbToolError(siteErr).error : undefined) ?? 'Site not found', code: 'NOT_FOUND' });
         const complaintRate = Number(metrics?.complaint_rate ?? 0);
         const draft = [
             `Subject: Delisting request for ${site.sending_domain} from ${zone}`,
@@ -339,7 +339,7 @@ export function registerDeliveryOpsTools(server) {
             query = query.eq('job_name', job_name);
         const { data, error } = await query;
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         const failed = (data ?? []).filter((row) => row.status === 'failed');
         return j({ runs: data ?? [], recent_failures: failed.length, total: data?.length ?? 0 });
     });
@@ -365,9 +365,9 @@ export function registerDeliveryOpsTools(server) {
             db().from('send_dlq').select('id', { count: 'exact' }).eq('project_id', projectId).eq('resolved', false),
         ]);
         if (queueErr)
-            return j({ error: queueErr.message });
+            return j(dbToolError(queueErr));
         if (dlqErr)
-            return j({ error: dlqErr.message });
+            return j(dbToolError(dlqErr));
         const counts = {};
         for (const row of queueRows ?? []) {
             counts[row.status] = (counts[row.status] ?? 0) + 1;
@@ -405,7 +405,7 @@ export function registerDeliveryOpsTools(server) {
             query = query.eq('resolved', false);
         const { data, error } = await query;
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         return j({ dlq: data ?? [], count: data?.length ?? 0 });
     });
     server.registerTool('get_enrollment_dlq', {
@@ -435,7 +435,7 @@ export function registerDeliveryOpsTools(server) {
             query = query.eq('resolved', false);
         const { data, error } = await query;
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         return j({ dlq: data ?? [], count: data?.length ?? 0 });
     });
     server.registerTool('get_send_queue_rows', {
@@ -465,7 +465,7 @@ export function registerDeliveryOpsTools(server) {
             return j({ rows, count: rows.length });
         }
         catch (error) {
-            return j({ error: error instanceof Error ? error.message : 'Queue query failed' });
+            return j({ error: error instanceof Error ? dbToolError(error).error : 'Queue query failed' });
         }
     });
     server.registerTool('retry_send_queue_rows', {
@@ -499,7 +499,7 @@ export function registerDeliveryOpsTools(server) {
             return j({ retried_count: retriedCount });
         }
         catch (error) {
-            return j({ error: error instanceof Error ? error.message : 'Queue retry failed' });
+            return j({ error: error instanceof Error ? dbToolError(error).error : 'Queue retry failed' });
         }
     });
     server.registerTool('cancel_send_queue_rows', {
@@ -533,7 +533,7 @@ export function registerDeliveryOpsTools(server) {
             return j({ cancelled_count: cancelledCount });
         }
         catch (error) {
-            return j({ error: error instanceof Error ? error.message : 'Queue cancellation failed' });
+            return j({ error: error instanceof Error ? dbToolError(error).error : 'Queue cancellation failed' });
         }
     });
     server.registerTool('replay_enrollment_dlq_rows', {
@@ -575,7 +575,7 @@ export function registerDeliveryOpsTools(server) {
                 });
             }
             catch (error) {
-                return j({ error: error instanceof Error ? error.message : 'Replay preview failed' });
+                return j({ error: error instanceof Error ? dbToolError(error).error : 'Replay preview failed' });
             }
         }
         try {
@@ -599,7 +599,7 @@ export function registerDeliveryOpsTools(server) {
             return j({ ok: true, replayed_count: replayedCount, skipped_count: skippedCount });
         }
         catch (error) {
-            return j({ error: error instanceof Error ? error.message : 'Replay failed' });
+            return j({ error: error instanceof Error ? dbToolError(error).error : 'Replay failed' });
         }
     }));
     server.registerTool('get_scoring_rules', {
@@ -619,7 +619,7 @@ export function registerDeliveryOpsTools(server) {
             .eq('project_id', projectId)
             .maybeSingle();
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         return j({ rules: data });
     });
     server.registerTool('update_scoring_rules', {
@@ -656,7 +656,7 @@ export function registerDeliveryOpsTools(server) {
             .select('*')
             .single();
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         return j({ rules: data, ok: true });
     });
     server.registerTool('explain_contact_score', {
@@ -688,7 +688,7 @@ export function registerDeliveryOpsTools(server) {
             db().from('scoring_rules').select('*').eq('project_id', projectId).maybeSingle(),
         ]);
         if (contactErr || !contact)
-            return j({ error: contactErr?.message ?? 'Contact not found', code: 'NOT_FOUND' });
+            return j({ error: (contactErr ? dbToolError(contactErr).error : undefined) ?? 'Contact not found', code: 'NOT_FOUND' });
         const effectiveRules = rules ?? {
             click_weight: 5,
             open_weight: 2,
@@ -782,7 +782,7 @@ export function registerDeliveryOpsTools(server) {
                 .order('id', { ascending: true })
                 .range(from, from + size - 1);
             if (error)
-                return j({ error: error.message });
+                return j(dbToolError(error));
             rows.push(...(data ?? []));
             if ((data?.length ?? 0) < size)
                 break;
@@ -817,7 +817,7 @@ export function registerDeliveryOpsTools(server) {
                 .eq('project_id', projectId)
                 .maybeSingle();
             if (siteError)
-                return j({ error: siteError.message });
+                return j(dbToolError(siteError));
             if (!site)
                 return j({ error: 'Site not found', code: 'NOT_FOUND' });
             if (!site.domain_id)
@@ -826,7 +826,7 @@ export function registerDeliveryOpsTools(server) {
         }
         const { data, error } = await domainQuery;
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         if (!data)
             return j({ error: 'Domain query returned no result' });
         return j({ domains: data.map((domain) => ({
@@ -856,7 +856,7 @@ export function registerDeliveryOpsTools(server) {
             .eq('project_id', projectId)
             .maybeSingle();
         if (siteErr || !site)
-            return j({ error: siteErr?.message ?? 'Site not found', code: 'NOT_FOUND' });
+            return j({ error: (siteErr ? dbToolError(siteErr).error : undefined) ?? 'Site not found', code: 'NOT_FOUND' });
         const dnsRecords = [
             { type: 'TXT', name: domain, value: 'v=spf1 include:amazonses.com ~all' },
             { type: 'TXT', name: `_dmarc.${domain}`, value: 'v=DMARC1; p=none; rua=mailto:dmarc@sendinel.ai' },
@@ -866,13 +866,13 @@ export function registerDeliveryOpsTools(server) {
             .select('id, name, provider, region, status, dns_records, created_at')
             .single();
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         const { error: linkErr } = await db().from('sites')
             .update({ domain_id: created.id, sending_domain: domain, updated_at: new Date().toISOString() })
             .eq('id', site_id)
             .eq('project_id', projectId);
         if (linkErr)
-            return j({ error: linkErr.message });
+            return j(dbToolError(linkErr));
         return j({ ok: true, site_id: site.id, domain: created });
     });
     server.registerTool('get_dmarc_status', {
@@ -894,7 +894,7 @@ export function registerDeliveryOpsTools(server) {
         const { data: sites, error: siteError } = await db().schema('email').from('sites')
             .select('id, sending_domain').eq('active', true).eq('project_id', projectId).order('name');
         if (siteError)
-            return j({ error: siteError.message });
+            return j(dbToolError(siteError));
         const selectedSite = site_id ? (sites ?? []).find((site) => site.id === site_id) : null;
         if (site_id && !selectedSite)
             return j({ error: 'site_id is not a valid site for this project', status: 400 });
@@ -943,7 +943,7 @@ export function registerDeliveryOpsTools(server) {
             });
         }
         catch (error) {
-            return j({ error: error instanceof Error ? error.message : 'DMARC status query failed' });
+            return j({ error: error instanceof Error ? dbToolError(error).error : 'DMARC status query failed' });
         }
     });
     server.registerTool('list_dmarc_reports', {
@@ -1082,7 +1082,7 @@ export function registerDeliveryOpsTools(server) {
             .eq('project_id', projectId)
             .maybeSingle();
         if (siteErr || !site)
-            return j({ error: siteErr?.message ?? 'Site not found', code: 'NOT_FOUND' });
+            return j({ error: (siteErr ? dbToolError(siteErr).error : undefined) ?? 'Site not found', code: 'NOT_FOUND' });
         const expiresAt = new Date(Date.now() + ttlHours * 3600 * 1000).toISOString();
         const { data: metrics } = await db()
             .from('tenant_email_metrics')
@@ -1101,7 +1101,7 @@ export function registerDeliveryOpsTools(server) {
             details: { reason, expires_at: expiresAt },
         });
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         return j({
             ok: true,
             site_id: siteId,

package/build/tools/drafts.js

@@ -3,6 +3,7 @@ import { db } from '../db.js';
 import { getProjectId } from '../project.js';
 import { checkPlanLimit } from '../plan-limits.js';
 import { recordBrandAssetUsage } from '../lib/brand-asset-usage.js';
+import { dbToolError } from '../lib/db-error.js';
 export function registerDraftTools(server) {
     server.registerTool('create_draft', {
         title: 'Create Draft',
@@ -34,7 +35,7 @@ export function registerDraftTools(server) {
             .select()
             .single();
         if (error)
-            return { content: [{ type: 'text', text: `Error: ${error.message}` }] };
+            return { content: [{ type: 'text', text: `Error: ${dbToolError(error).error}` }] };
         await recordBrandAssetUsage({
             client: db(),
             projectId: getProjectId(),
@@ -74,7 +75,7 @@ export function registerDraftTools(server) {
             q = q.eq('site_id', site_id);
         const { data, error } = await q;
         if (error)
-            return { content: [{ type: 'text', text: `Error: ${error.message}` }] };
+            return { content: [{ type: 'text', text: `Error: ${dbToolError(error).error}` }] };
         return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
     });
     server.registerTool('get_draft', {
@@ -97,7 +98,7 @@ export function registerDraftTools(server) {
             .eq('project_id', getProjectId())
             .maybeSingle();
         if (error)
-            return { content: [{ type: 'text', text: `Error: ${error.message}` }] };
+            return { content: [{ type: 'text', text: `Error: ${dbToolError(error).error}` }] };
         if (!data)
             return { content: [{ type: 'text', text: JSON.stringify({ error: 'Draft not found', code: 'NOT_FOUND' }, null, 2) }] };
         return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
@@ -134,7 +135,7 @@ export function registerDraftTools(server) {
             .eq('project_id', projectId)
             .maybeSingle();
         if (draftError)
-            return { content: [{ type: 'text', text: `Error: ${draftError.message}` }] };
+            return { content: [{ type: 'text', text: `Error: ${dbToolError(draftError).error}` }] };
         if (!draft)
             return { content: [{ type: 'text', text: JSON.stringify({ error: 'Draft not found', code: 'NOT_FOUND' }, null, 2) }] };
         const { data: site, error: siteError } = await db()
@@ -144,7 +145,7 @@ export function registerDraftTools(server) {
             .eq('project_id', projectId)
             .maybeSingle();
         if (siteError)
-            return { content: [{ type: 'text', text: `Error: ${siteError.message}` }] };
+            return { content: [{ type: 'text', text: `Error: ${dbToolError(siteError).error}` }] };
         if (!site)
             return { content: [{ type: 'text', text: 'Draft site not found for this project.' }] };
         const insert = {
@@ -169,7 +170,7 @@ export function registerDraftTools(server) {
             .select()
             .single();
         if (campaignError)
-            return { content: [{ type: 'text', text: `Failed to create campaign: ${campaignError.message}` }] };
+            return { content: [{ type: 'text', text: `Failed to create campaign: ${dbToolError(campaignError).error}` }] };
         const { data: step, error: stepError } = await db()
             .from('campaign_steps')
             .insert({
@@ -184,7 +185,7 @@ export function registerDraftTools(server) {
             .select()
             .single();
         if (stepError)
-            return { content: [{ type: 'text', text: `Campaign created (${campaign.id}) but failed to create step: ${stepError.message}` }] };
+            return { content: [{ type: 'text', text: `Campaign created (${campaign.id}) but failed to create step: ${dbToolError(stepError).error}` }] };
         await recordBrandAssetUsage({
             client: db(),
             projectId,
@@ -231,7 +232,7 @@ export function registerDraftTools(server) {
             .select()
             .single();
         if (error)
-            return { content: [{ type: 'text', text: `Error: ${error.message}` }] };
+            return { content: [{ type: 'text', text: `Error: ${dbToolError(error).error}` }] };
         if (!data)
             return { content: [{ type: 'text', text: 'Draft not found or not in pending status.' }] };
         return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
@@ -259,7 +260,7 @@ export function registerDraftTools(server) {
             .select()
             .single();
         if (error)
-            return { content: [{ type: 'text', text: `Error: ${error.message}` }] };
+            return { content: [{ type: 'text', text: `Error: ${dbToolError(error).error}` }] };
         if (!data)
             return { content: [{ type: 'text', text: 'Draft not found or not in pending status.' }] };
         return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };

package/build/tools/forms.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { db } from '../db.js';
 import { getProjectId } from '../project.js';
 import { assertHttpUrl } from '../lib/url-validation.js';
+import { dbToolError } from '../lib/db-error.js';
 const j = (data) => ({ content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] });
 export function registerFormTools(server) {
     server.registerTool('list_forms', {
@@ -20,7 +21,7 @@ export function registerFormTools(server) {
             query = query.eq('site_id', site_id);
         const { data, error } = await query;
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         return j({ forms: (data ?? []).map((form) => ({ ...form, field_count: Array.isArray(form.fields) ? form.fields.length : 0, submission_count: form.submissions ?? 0 })) });
     });
     server.registerTool('get_form_stats', {
@@ -37,7 +38,7 @@ export function registerFormTools(server) {
         const projectId = getProjectId();
         const { data: form, error: formError } = await db().from('signup_forms').select('id, submissions').eq('id', form_id).eq('project_id', projectId).maybeSingle();
         if (formError)
-            return j({ error: formError.message });
+            return j(dbToolError(formError));
         if (!form)
             return j({ error: 'Form not found', code: 'NOT_FOUND' });
         const since = new Date(Date.now() - 7 * 86400000).toISOString();
@@ -48,7 +49,7 @@ export function registerFormTools(server) {
             .eq('metadata->>form_id', form_id)
             .gte('created_at', since);
         if (eventsError)
-            return j({ error: eventsError.message });
+            return j(dbToolError(eventsError));
         return j({ submissions_total: form.submissions ?? 0, submissions_7d: sevenDay ?? 0, top_sources: [], conversion_rate: null });
     });
     server.registerTool('create_form', {
@@ -101,7 +102,7 @@ export function registerFormTools(server) {
         if (error?.code === '23505')
             return j({ error: 'slug already exists', code: 'conflict' });
         if (error)
-            return j({ error: error.message, code: 'INTERNAL_ERROR' });
+            return j({ ...dbToolError(error), code: 'INTERNAL_ERROR' });
         return j({ form: data });
     });
 }

package/build/tools/gdpr.js

@@ -3,6 +3,7 @@ import { db } from '../db.js';
 import { getProjectId } from '../project.js';
 import { logAudit } from '../audit.js';
 import { assertChannelCanExecute, currentChannelContext, requestApproval, checkApproval } from '../lib/action-approvals.js';
+import { dbToolError } from '../lib/db-error.js';
 const txt = (text) => ({ content: [{ type: 'text', text }] });
 const j = (data) => txt(JSON.stringify(data, null, 2));
 export function registerGdprTools(server) {
@@ -51,7 +52,7 @@ export function registerGdprTools(server) {
             p_deleted_by: 'mcp',
         });
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         logAudit({ action: 'contact.gdpr_deleted', resourceType: 'contact', resourceId: contact_id, details: { reason, result: data } });
         return j(data);
     });
@@ -74,7 +75,7 @@ export function registerGdprTools(server) {
             .order('created_at', { ascending: false })
             .limit(limit ?? 50);
         if (error)
-            return { content: [{ type: 'text', text: `Error: ${error.message}` }] };
+            return { content: [{ type: 'text', text: `Error: ${dbToolError(error).error}` }] };
         return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
     });
     server.registerTool('list_ccpa_requests', {
@@ -108,7 +109,7 @@ export function registerGdprTools(server) {
             .order('created_at', { ascending: false })
             .limit(limit ?? 50);
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         return j({ requests: data ?? [], count: data?.length ?? 0 });
     });
     server.registerTool('action_ccpa_request', {
@@ -135,7 +136,7 @@ export function registerGdprTools(server) {
             .eq('regulation', 'ccpa')
             .maybeSingle();
         if (fetchErr)
-            return txt(`Error: ${fetchErr.message}`);
+            return txt(`Error: ${dbToolError(fetchErr).error}`);
         if (!request)
             return txt('CCPA request not found or does not belong to this project.');
         if (request.status === 'completed' || request.status === 'expired') {
@@ -160,7 +161,7 @@ export function registerGdprTools(server) {
                 .select('id, email, status, verified_at')
                 .maybeSingle();
             if (error)
-                return txt(`Error: ${error.message}`);
+                return txt(`Error: ${dbToolError(error).error}`);
             if (!data)
                 return txt('Request changed or expired before it could be verified. Refresh the queue and try again.');
             void logAudit({
@@ -203,7 +204,7 @@ export function registerGdprTools(server) {
                 .eq('email', request.email)
                 .maybeSingle();
             if (contactErr)
-                return txt(`Error: ${contactErr.message}`);
+                return txt(`Error: ${dbToolError(contactErr).error}`);
             if (contact) {
                 const { error: deleteErr } = await db().rpc('delete_contact_gdpr', {
                     p_contact_id: contact.id,
@@ -211,7 +212,7 @@ export function registerGdprTools(server) {
                     p_deleted_by: 'mcp_ccpa_action',
                 });
                 if (deleteErr)
-                    return txt(`Deletion failed: ${deleteErr.message}`);
+                    return txt(`Deletion failed: ${dbToolError(deleteErr).error}`);
             }
             const completedAt = new Date().toISOString();
             const { data, error } = await db()
@@ -229,7 +230,7 @@ export function registerGdprTools(server) {
                 .select('id, email, status, completed_at')
                 .maybeSingle();
             if (error)
-                return txt(`Error: ${error.message}`);
+                return txt(`Error: ${dbToolError(error).error}`);
             if (!data)
                 return txt('Request changed before it could be completed. Refresh the queue before retrying.');
             void logAudit({
@@ -251,7 +252,7 @@ export function registerGdprTools(server) {
             .select('id, email, status, completed_at')
             .maybeSingle();
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         if (!data)
             return txt('Request changed before it could be completed. Refresh the queue before retrying.');
         void logAudit({

package/build/tools/landing-pages.js

@@ -74,7 +74,7 @@ export function registerLandingPageTools(server) {
             query = query.eq('site_id', site_id);
         const { data, error } = await query.order('created_at', { ascending: false });
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         return j({ pages: data ?? [] });
     });
     server.registerTool('get_landing_page', {
@@ -90,7 +90,7 @@ export function registerLandingPageTools(server) {
             .eq('id', page_id)
             .maybeSingle();
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         if (!data)
             return j({ error: 'Landing page not found', code: 'NOT_FOUND' });
         return j(data);
@@ -274,7 +274,7 @@ export function registerLandingPageTools(server) {
             .eq('id', page_id)
             .eq('project_id', projectId);
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         await logAudit({ action: 'landing_page.deleted', resourceType: 'landing_page', resourceId: page_id });
         return j({ deleted: true });
     }));