@sendinel/mcp-server 1.0.145 → 1.0.147

package/build/tools/short-links.js

@@ -3,6 +3,7 @@ import { z } from 'zod';
 import { db } from '../db.js';
 import { getProjectId } from '../project.js';
 import { assertHttpUrl, RESERVED_LINK_SLUGS } from '../lib/url-validation.js';
+import { dbToolError } from '../lib/db-error.js';
 const txt = (text) => ({ content: [{ type: 'text', text }] });
 const j = (data) => txt(JSON.stringify(data, null, 2));
 const VANITY_SLUG_RE = /^[a-zA-Z0-9-]{3,40}$/;
@@ -41,12 +42,12 @@ export function registerShortLinkTools(server) {
             destination = assertHttpUrl(destination_url);
         }
         catch (err) {
-            return j({ error: err instanceof Error ? err.message : 'Invalid destination URL', code: 'validation_failed' });
+            return j({ error: err instanceof Error ? dbToolError(err).error : 'Invalid destination URL', code: 'validation_failed' });
         }
         if (campaign_id) {
             const { data: campaign, error } = await db().from('campaigns').select('id').eq('id', campaign_id).eq('project_id', projectId).maybeSingle();
             if (error)
-                return j({ error: error.message, code: 'INTERNAL_ERROR' });
+                return j({ ...dbToolError(error), code: 'INTERNAL_ERROR' });
             if (!campaign)
                 return j({ error: 'Campaign not found in this project', code: 'not_found' });
         }
@@ -81,7 +82,7 @@ export function registerShortLinkTools(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({ short_link: data, short_url: `${appBaseUrl()}/s/${data.slug}` });
     });
     server.registerTool('get_short_link_stats', {
@@ -103,7 +104,7 @@ export function registerShortLinkTools(server) {
             .eq('project_id', projectId)
             .maybeSingle();
         if (linkError)
-            return j({ error: linkError.message });
+            return j(dbToolError(linkError));
         if (!link)
             return j({ error: 'Short link not found', code: 'not_found' });
         const { data: clicks, error: clickError } = await db()
@@ -113,7 +114,7 @@ export function registerShortLinkTools(server) {
             .order('clicked_at', { ascending: false })
             .limit(500);
         if (clickError)
-            return j({ error: clickError.message });
+            return j(dbToolError(clickError));
         const uniqueClicks = new Set((clicks ?? []).map((click) => click.ip_hash).filter(Boolean)).size;
         return j({
             short_link: link,
@@ -146,7 +147,7 @@ export function registerShortLinkTools(server) {
             normalizedUrl = assertHttpUrl(url);
         }
         catch (err) {
-            return j({ error: err instanceof Error ? err.message : 'Invalid QR URL', code: 'validation_failed' });
+            return j({ error: err instanceof Error ? dbToolError(err).error : 'Invalid QR URL', code: 'validation_failed' });
         }
         const dataUri = await QRCode.toDataURL(normalizedUrl, {
             type: 'image/png',

package/build/tools/signatures.js

@@ -3,6 +3,7 @@ import { z } from 'zod';
 import { db } from '../db.js';
 import { getProjectId } from '../project.js';
 import { logAudit } from '../audit.js';
+import { dbToolError } from '../lib/db-error.js';
 const txt = (text) => ({ content: [{ type: 'text', text }] });
 const j = (data) => txt(JSON.stringify(data, null, 2));
 const COLUMNS = 'id, site_id, name, html, is_default, created_at, updated_at';
@@ -23,7 +24,7 @@ export function registerSignatureTools(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({ signatures: data ?? [], count: data?.length ?? 0 });
     });
     server.registerTool('create_signature', {
@@ -45,7 +46,7 @@ export function registerSignatureTools(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 (is_default) {
@@ -55,7 +56,7 @@ export function registerSignatureTools(server) {
                 .eq('project_id', projectId)
                 .eq('site_id', site_id);
             if (clearError)
-                return j({ error: clearError.message });
+                return j(dbToolError(clearError));
         }
         const { data, error } = await db()
             .from('signature_blocks')
@@ -69,7 +70,7 @@ export function registerSignatureTools(server) {
             .select(COLUMNS)
             .single();
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         await logAudit({
             action: 'signature.created',
             resourceType: 'signature',
@@ -97,7 +98,7 @@ export function registerSignatureTools(server) {
             .eq('project_id', projectId)
             .maybeSingle();
         if (existingError)
-            return j({ error: existingError.message });
+            return j(dbToolError(existingError));
         if (!existing)
             return j({ error: 'Signature not found', code: 'NOT_FOUND' });
         if (is_default) {
@@ -108,7 +109,7 @@ export function registerSignatureTools(server) {
                 .eq('site_id', existing.site_id)
                 .neq('id', id);
             if (clearError)
-                return j({ error: clearError.message });
+                return j(dbToolError(clearError));
         }
         const updates = { updated_at: new Date().toISOString() };
         if (name !== undefined)
@@ -125,7 +126,7 @@ export function registerSignatureTools(server) {
             .select(COLUMNS)
             .single();
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         await logAudit({
             action: 'signature.updated',
             resourceType: 'signature',
@@ -148,7 +149,7 @@ export function registerSignatureTools(server) {
             .eq('project_id', projectId)
             .maybeSingle();
         if (existingError)
-            return j({ error: existingError.message });
+            return j(dbToolError(existingError));
         if (!existing)
             return j({ error: 'Signature not found', code: 'NOT_FOUND' });
         const { error } = await db()
@@ -157,7 +158,7 @@ export function registerSignatureTools(server) {
             .eq('id', id)
             .eq('project_id', projectId);
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         await logAudit({
             action: 'signature.deleted',
             resourceType: 'signature',

package/build/tools/sites.js

@@ -4,6 +4,7 @@ import { logAudit } from '../audit.js';
 import { db } from '../db.js';
 import { getProjectId } from '../project.js';
 import { checkPlanLimit } from '../plan-limits.js';
+import { dbToolError } from '../lib/db-error.js';
 const txt = (text) => ({ content: [{ type: 'text', text }] });
 const j = (data) => txt(JSON.stringify(data, null, 2));
 const LOCAL_PART_RE = /^[a-z0-9._-]+$/;
@@ -17,7 +18,7 @@ async function resolveSenderDomain(input) {
             .eq('id', input.domain_id)
             .maybeSingle();
         if (error)
-            return { error: error.message };
+            return { ...dbToolError(error) };
         if (!domain?.id || !domain.name)
             return { error: 'Domain not found.' };
         const localPart = input.local_part?.trim().toLowerCase();
@@ -44,7 +45,7 @@ async function resolveSenderDomain(input) {
         .eq('name', sendingDomain)
         .maybeSingle();
     if (existingError)
-        return { error: existingError.message };
+        return { ...dbToolError(existingError) };
     if (existing?.id) {
         return {
             domain_id: String(existing.id),
@@ -59,7 +60,7 @@ async function resolveSenderDomain(input) {
         .select('id, name')
         .single();
     if (createError)
-        return { error: createError.message };
+        return { ...dbToolError(createError) };
     return {
         domain_id: String(created.id),
         sending_domain: sendingDomain,
@@ -102,7 +103,7 @@ async function createSender({ name, slug, domain_id, local_part, sending_domain,
         .select()
         .single();
     if (error)
-        return txt(`Error: ${error.message}`);
+        return txt(`Error: ${dbToolError(error).error}`);
     return j(data);
 }
 export function registerSiteTools(server) {
@@ -126,7 +127,7 @@ export function registerSiteTools(server) {
             .eq('id', site_id)
             .maybeSingle();
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         if (!data)
             return j({ error: 'Site not found', code: 'NOT_FOUND' });
         return j(data);
@@ -153,7 +154,7 @@ export function registerSiteTools(server) {
             .select('id, name, brand_voice, updated_at')
             .single();
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         return j(data);
     });
     server.registerTool('create_site', {
@@ -232,7 +233,7 @@ export function registerSiteTools(server) {
                 .eq('project_id', projectId)
                 .maybeSingle();
             if (error)
-                return txt(`Error: ${error.message}`);
+                return txt(`Error: ${dbToolError(error).error}`);
             if (!current)
                 return j({ error: 'Site not found', code: 'NOT_FOUND' });
             previousTemplate = current.unsub_footer_template;
@@ -249,7 +250,7 @@ export function registerSiteTools(server) {
             query = query.eq('unsub_footer_template', previousTemplate);
         const { data, error } = await query.select().maybeSingle();
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         if (!data)
             return j({ error: 'Site not found or footer changed during update. Read the site and retry.', code: 'SITE_CHANGED_OR_NOT_FOUND' });
         await logAudit({

package/build/tools/sms.js

@@ -5,6 +5,7 @@ import { z } from 'zod';
 import { decrypt } from '../crypto.js';
 import { adminDb, db } from '../db.js';
 import { getProjectId } from '../project.js';
+import { dbToolError } from '../lib/db-error.js';
 const txt = (text) => ({ content: [{ type: 'text', text }] });
 const j = (data) => txt(JSON.stringify(data, null, 2));
 const GSM_BASIC = "@£$¥èéùìòÇ\nØø\rÅåΔ_ΦΓΛΩΠΨΣΘΞ !\"#¤%&'()*+,-./0123456789:;<=>?¡ABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÑܧ¿abcdefghijklmnopqrstuvwxyzäöñüà";
@@ -244,7 +245,7 @@ export function registerSmsTools(server) {
             query = query.eq('status', status);
         const { data, error } = await query;
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         return j({ rows: data ?? [] });
     });
     server.registerTool('list_sms_inbound', {
@@ -271,7 +272,7 @@ export function registerSmsTools(server) {
             query = query.eq('interpreted_as', interpreted_as);
         const { data, error } = await query;
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         return j({ rows: data ?? [] });
     });
     server.registerTool('get_sms_provider_status', {
@@ -291,7 +292,7 @@ export function registerSmsTools(server) {
             db().from('sms_log').select('status, created_at').eq('project_id', projectId).order('created_at', { ascending: false }).limit(50),
         ]);
         if (recent.error)
-            return j({ error: recent.error.message });
+            return j(dbToolError(recent.error));
         const rows = recent.data ?? [];
         const failures = rows.filter((row) => row.status === 'failed' || row.status === 'undelivered').length;
         return j({
@@ -330,7 +331,7 @@ export function registerSmsTools(server) {
             .eq('id', contact_id)
             .maybeSingle();
         if (contactError)
-            return j({ error: contactError.message });
+            return j(dbToolError(contactError));
         if (!contact?.phone_e164)
             return j({ error: 'Contact not found or missing phone number', code: 'NOT_FOUND' });
         const now = new Date().toISOString();
@@ -339,7 +340,7 @@ export function registerSmsTools(server) {
             : { sms_opt_in_status: 'opted_in', sms_opt_in_at: now, sms_opt_out_at: null };
         const { error: updateError } = await db().from('subscribers').update(patch).eq('project_id', projectId).eq('id', contact_id);
         if (updateError)
-            return j({ error: updateError.message });
+            return j(dbToolError(updateError));
         const { error: consentError } = await db().from('consent_events').insert({
             org_id: orgId,
             project_id: projectId,
@@ -352,7 +353,7 @@ export function registerSmsTools(server) {
             metadata: {},
         });
         if (consentError)
-            return j({ error: consentError.message });
+            return j(dbToolError(consentError));
         if (status === 'opt_out') {
             const { error: suppressionError } = await db().from('suppressions').upsert({
                 org_id: orgId,
@@ -362,12 +363,12 @@ export function registerSmsTools(server) {
                 reason: reason ?? 'manual_opt_out',
             }, { onConflict: 'project_id,channel,phone_e164' });
             if (suppressionError)
-                return j({ error: suppressionError.message });
+                return j(dbToolError(suppressionError));
         }
         else {
             const { error: suppressionError } = await db().from('suppressions').delete().eq('project_id', projectId).eq('channel', 'sms').eq('phone_e164', contact.phone_e164);
             if (suppressionError)
-                return j({ error: suppressionError.message });
+                return j(dbToolError(suppressionError));
         }
         return j({ ok: true, contact_id, phone_e164: contact.phone_e164, status });
     }));
@@ -432,7 +433,7 @@ export function registerSmsTools(server) {
             .select('id, name, type, status, channel, site_id, send_at')
             .single();
         if (campaignError || !campaign)
-            return j({ error: campaignError?.message ?? 'Failed to create campaign' });
+            return j({ error: (campaignError ? dbToolError(campaignError).error : undefined) ?? 'Failed to create campaign' });
         const { data: step, error: stepError } = await db()
             .from('campaign_steps')
             .insert({
@@ -449,7 +450,7 @@ export function registerSmsTools(server) {
             .select('id, step_order, channel')
             .single();
         if (stepError)
-            return j({ error: stepError.message, campaign });
+            return j({ ...dbToolError(stepError), campaign });
         return j({
             ok: true,
             campaign,
@@ -484,7 +485,7 @@ export function registerSmsTools(server) {
         if (contact_id && !targetNumber) {
             const { data: contact, error: contactError } = await db().from('subscribers').select('phone_e164').eq('project_id', projectId).eq('id', contact_id).maybeSingle();
             if (contactError)
-                return j({ error: contactError.message });
+                return j(dbToolError(contactError));
             targetNumber = contact?.phone_e164 ?? null;
         }
         if (!targetNumber)
@@ -516,7 +517,7 @@ export function registerSmsTools(server) {
             .select('id')
             .single();
         if (logError || !logRow)
-            return j({ error: logError?.message ?? 'Failed to create sms_log row' });
+            return j({ error: (logError ? dbToolError(logError).error : undefined) ?? 'Failed to create sms_log row' });
         const sendResult = await sendViaProvider(gate.provider.provider, gate.provider.credentials_enc, gate.provider.default_from_number, gate.normalizedPhone, body, `${process.env.NEXT_PUBLIC_APP_URL ?? 'http://localhost:3000'}/api/sms/inbound/${gate.provider.provider}`, trackingToken);
         const { error: updateError } = await db()
             .from('sms_log')
@@ -530,7 +531,7 @@ export function registerSmsTools(server) {
         })
             .eq('id', logRow.id);
         if (updateError)
-            return j({ error: updateError.message });
+            return j(dbToolError(updateError));
         return j({
             ok: true,
             sms_log_id: logRow.id,

package/build/tools/social-posts.js

@@ -11,6 +11,7 @@ import { buildSocialSystemPrompt, buildSocialUserPrompt, parseSocialResponse, se
 import { fireWebhookEvent } from '../lib/webhook-events.js';
 import { resolveSurveyShortLink } from '../lib/survey-link-resolver.js';
 import { registerSocialReplyTools } from './social-replies.js';
+import { dbToolError } from '../lib/db-error.js';
 const txt = (text) => ({ content: [{ type: 'text', text }] });
 const j = (data) => txt(JSON.stringify(data, null, 2));
 const socialPlatforms = ['instagram', 'linkedin', 'twitter', 'facebook', 'tiktok', 'youtube', 'pinterest', 'uploadpost', 'other'];
@@ -213,7 +214,7 @@ export function registerSocialPostTools(server) {
             .eq('id', projectId)
             .maybeSingle();
         if (projectError)
-            return txt(`Error: ${projectError.message}`);
+            return txt(`Error: ${dbToolError(projectError).error}`);
         if (!project?.org_id)
             return txt('Error: Project organization not found.');
         const { data, error } = await db()
@@ -222,7 +223,7 @@ export function registerSocialPostTools(server) {
             .eq('org_id', project.org_id)
             .order('platform', { ascending: true });
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         const connections = (data ?? [])
             .map((row) => selectFields(row, SOCIAL_CONNECTION_COLUMNS));
         if (connections.length === 0) {
@@ -261,7 +262,7 @@ export function registerSocialPostTools(server) {
             query = query.eq('social_post_id', social_post_id);
         const { data, error } = await query;
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         const engagements = (data ?? [])
             .map((row) => selectFields(row, SOCIAL_ENGAGEMENT_LIST_COLUMNS));
         if (engagements.length === 0) {
@@ -287,7 +288,7 @@ export function registerSocialPostTools(server) {
             .eq('id', engagement_id)
             .maybeSingle();
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         if (!data)
             return j({ error: 'Social engagement not found', code: 'NOT_FOUND' });
         return j(selectFields(data, SOCIAL_ENGAGEMENT_DETAIL_COLUMNS));
@@ -321,7 +322,7 @@ export function registerSocialPostTools(server) {
             query = query.contains('platforms', [platform]);
         const { data, error } = await query;
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         return j({ posts: data ?? [] });
     });
     server.registerTool('get_social_post', {
@@ -342,7 +343,7 @@ export function registerSocialPostTools(server) {
             .eq('id', post_id)
             .maybeSingle();
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         if (!data)
             return j({ error: 'Social post not found', code: 'NOT_FOUND' });
         return j(data);
@@ -368,7 +369,7 @@ export function registerSocialPostTools(server) {
             db().from('projects').select('org_id').eq('id', projectId).maybeSingle(),
         ]);
         if (campaignError)
-            return txt(`Error: ${campaignError.message}`);
+            return txt(`Error: ${dbToolError(campaignError).error}`);
         if (!campaign)
             return j({ error: 'Campaign not found', code: 'NOT_FOUND' });
         const [{ data: site }, { data: projectSettingsRow }] = await Promise.all([
@@ -482,7 +483,7 @@ export function registerSocialPostTools(server) {
             await requireProjectCampaign(email_campaign_id);
         }
         catch (err) {
-            return txt(`Error: ${err instanceof Error ? err.message : 'Invalid linked resource'}`);
+            return txt(`Error: ${err instanceof Error ? dbToolError(err).error : 'Invalid linked resource'}`);
         }
         let scheduledAt;
         try {
@@ -491,14 +492,14 @@ export function registerSocialPostTools(server) {
                 return txt('Choose either a scheduled time or queue delivery, not both.');
         }
         catch (err) {
-            return txt(`Error: ${err instanceof Error ? err.message : 'Invalid schedule'}`);
+            return txt(`Error: ${err instanceof Error ? dbToolError(err).error : 'Invalid schedule'}`);
         }
         let metadata;
         try {
             metadata = linkedInCompanyCrosspostMetadata(linkedin_company_crosspost, linkedin_company_page_id, platforms);
         }
         catch (err) {
-            return txt(`Error: ${err instanceof Error ? err.message : 'Invalid LinkedIn cross-post settings'}`);
+            return txt(`Error: ${err instanceof Error ? dbToolError(err).error : 'Invalid LinkedIn cross-post settings'}`);
         }
         let resolvedDestinationUrl = destination_url;
         if (survey_id) {
@@ -530,7 +531,7 @@ export function registerSocialPostTools(server) {
                 .select('id')
                 .single();
             if (campaignError)
-                return txt(`Error: ${campaignError.message}`);
+                return txt(`Error: ${dbToolError(campaignError).error}`);
             socialCampaignId = socialCampaign.id;
         }
         const status = statusFromSchedule(scheduledAt, Boolean(queue_requested));
@@ -558,7 +559,7 @@ export function registerSocialPostTools(server) {
             .select()
             .single();
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         fireWebhookEvent('social.post.created', { social_post_id: data.id, title: data.title, status: data.status, platforms: data.platforms }, projectId).catch(() => { });
         if (status === 'scheduled' || status === 'queued') {
             fireWebhookEvent('social.post.scheduled', { social_post_id: data.id, title: data.title, status: data.status, scheduled_at: data.scheduled_at, platforms: data.platforms }, projectId).catch(() => { });
@@ -614,7 +615,7 @@ export function registerSocialPostTools(server) {
             .select()
             .single();
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         fireWebhookEvent('social.post.updated', { social_post_id: data.id, title: data.title, status: data.status, fields: Object.keys(updates) }, getProjectId()).catch(() => { });
         if (data.status === 'published')
             fireWebhookEvent('social.post.published', { social_post_id: data.id, title: data.title, platforms: data.platforms, published_at: data.published_at }, getProjectId()).catch(() => { });
@@ -641,7 +642,7 @@ export function registerSocialPostTools(server) {
             .select()
             .single();
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         fireWebhookEvent('social.post.archived', { social_post_id: data.id, title: data.title }, getProjectId()).catch(() => { });
         return j(data);
     }));
@@ -682,7 +683,7 @@ export function registerSocialPostTools(server) {
         };
         const { data, error } = await db().from('social_campaigns').insert(insert).select().single();
         if (error)
-            return txt(`Error: ${error.message}`);
+            return txt(`Error: ${dbToolError(error).error}`);
         return j({ id: data.id, tracked_url: data.tracked_url, campaign: data });
     });
     server.registerTool('schedule_social_post', {
@@ -715,7 +716,7 @@ export function registerSocialPostTools(server) {
             .eq('id', p.campaign_id)
             .maybeSingle();
         if (campaignError)
-            return txt(`Error: ${campaignError.message}`);
+            return txt(`Error: ${dbToolError(campaignError).error}`);
         if (!campaign)
             return j({ error: 'Campaign not found', code: 'NOT_FOUND' });
         const { data: project, error: projectError } = await admin
@@ -724,7 +725,7 @@ export function registerSocialPostTools(server) {
             .eq('id', campaign.project_id)
             .maybeSingle();
         if (projectError)
-            return txt(`Error: ${projectError.message}`);
+            return txt(`Error: ${dbToolError(projectError).error}`);
         if (!project?.org_id)
             return j({ error: 'Project not found', code: 'NOT_FOUND' });
         const mockProfile = configuredSandboxSocialProfile(project, campaign.platform);
@@ -737,7 +738,7 @@ export function registerSocialPostTools(server) {
                 .eq('platform', p.publisher)
                 .maybeSingle();
         if (connectionError)
-            return txt(`Error: ${connectionError.message}`);
+            return txt(`Error: ${dbToolError(connectionError).error}`);
         if (!mockProfile && !connection?.encrypted_access_token) {
             return j({ error: `No ${p.publisher} connection found. Connect it in Settings -> Integrations.`, code: 'NO_CONNECTION' });
         }
@@ -767,7 +768,7 @@ export function registerSocialPostTools(server) {
                 .eq('project_id', projectId)
                 .eq('id', p.campaign_id);
             if (updateError)
-                return txt(`Error: ${updateError.message}`);
+                return txt(`Error: ${dbToolError(updateError).error}`);
             return j({ success: true, publisherPostId: result.publisherPostId, publish_status: publishStatus, post_url: result.postUrl ?? null });
         }
         catch (err) {

package/build/tools/social-replies.js

@@ -6,6 +6,7 @@ import { db, requestContext } from '../db.js';
 import { getProjectId } from '../project.js';
 import { getAnthropicModelId } from '../anthropic-model.js';
 import { buildVoicePrompt } from '../lib/voice.js';
+import { dbToolError } from '../lib/db-error.js';
 const j = (value) => ({ content: [{ type: 'text', text: JSON.stringify(value) }] });
 const replyText = z.string().min(1).max(1250).refine((value) => Boolean(value.trim()), 'Write a reply first.');
 const postTypes = /^(?:urn:li:(?:activity|share|ugcPost):\d+)$/;
@@ -15,7 +16,7 @@ async function pageEngagement(id) {
         .eq('project_id', getProjectId()).eq('platform', 'linkedin').eq('id', id)
         .not('page_id', 'is', null).maybeSingle();
     if (error)
-        throw new Error(error.message);
+        throw error;
     if (!data)
         throw new Error('This Page comment was not found in the current project.');
     return data;
@@ -64,7 +65,7 @@ async function proposePersonal(kind, target, text, memberId) {
         comment_urn: commentUrn, reply_text: text, status: 'pending',
     }).select('id, status').single();
     if (error)
-        return j({ error: `Could not save the proposal: ${error.message}` });
+        return j({ error: `Could not save the proposal: ${dbToolError(error).error}` });
     return j({ card_id: data.id, status: data.status, approve_link: `${(process.env.NEXT_PUBLIC_APP_URL ?? process.env.SENDINEL_APP_URL ?? process.env.APP_URL ?? 'https://sendinel.ai').replace(/\/$/, '')}/dashboard/linkedin-proposals?proposal=${data.id}`, message: 'Waiting for the target member to Accept, Edit, or Skip. Nothing was posted.' });
 }
 /** These agent tools only read comments or create proposals; no provider posting call is reachable. */
@@ -87,7 +88,7 @@ export function registerSocialReplyTools(server) {
         else if (status && status !== 'all')
             query = query.eq('reply_status', status);
         const { data, error } = await query;
-        return error ? j({ error: error.message }) : j({ comments: data ?? [] });
+        return error ? j(dbToolError(error)) : j({ comments: data ?? [] });
     });
     server.registerTool('draft_social_reply', {
         title: 'Draft LinkedIn Page Reply', description: 'Draft a Page reply in brand voice for human review; never posts.',
@@ -98,7 +99,7 @@ export function registerSocialReplyTools(server) {
             const engagement = await pageEngagement(engagement_id);
             const { data: project, error } = await db().from('projects').select('brand_settings').eq('id', getProjectId()).maybeSingle();
             if (error)
-                throw new Error(error.message);
+                throw error;
             const { data: sites } = await db().from('sites').select('brand_voice').eq('project_id', getProjectId()).limit(1);
             if (!process.env.ANTHROPIC_API_KEY)
                 return j({ error: 'AI drafting is unavailable.' });
@@ -134,7 +135,7 @@ export function registerSocialReplyTools(server) {
             .or('reply_status.is.null,reply_status.in.(pending,failed,skipped)')
             .select('id, reply_status');
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         if (!data?.length)
             return j({ error: 'This reply is already posting or posted.' });
         return j({ card_id: engagement_id, status: 'pending', approve_link: `${(process.env.NEXT_PUBLIC_APP_URL ?? process.env.SENDINEL_APP_URL ?? process.env.APP_URL ?? 'https://sendinel.ai').replace(/\/$/, '')}/dashboard?page=social&tab=inbox&reply_id=${engagement_id}`, message: 'Waiting for a person to Accept, Edit, or Skip. Nothing was posted.' });
@@ -260,7 +261,7 @@ export function registerSocialReplyTools(server) {
             status: 'pending',
         }).select('id, status').single();
         if (insertError || !proposal)
-            return j({ error: `Could not save the proposal: ${insertError?.message ?? 'unknown'}` });
+            return j({ error: `Could not save the proposal: ${(insertError ? dbToolError(insertError).error : undefined) ?? 'unknown'}` });
         return j({
             card_id: proposal.id,
             status: proposal.status,

package/build/tools/surveys.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { db } from '../db.js';
 import { getProjectId } from '../project.js';
+import { dbToolError } from '../lib/db-error.js';
 const txt = (text) => ({ content: [{ type: 'text', text }] });
 const j = (data) => txt(JSON.stringify(data, null, 2));
 const QUESTION_SCHEMA = z.object({
@@ -98,11 +99,11 @@ export function registerSurveyTools(server) {
             .select()
             .single();
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         const responseUrl = `${appBaseUrl()}/api/surveys/respond?survey_id=${survey.id}`;
         const { data: slugData, error: slugError } = await db().rpc('next_short_link_slug');
         if (slugError || !slugData)
-            return j({ survey, response_url: responseUrl, short_link: null, warning: slugError?.message ?? 'short link slug unavailable' });
+            return j({ survey, response_url: responseUrl, short_link: null, warning: (slugError ? dbToolError(slugError).error : undefined) ?? 'short link slug unavailable' });
         const { data: shortLink, error: linkError } = await db()
             .from('short_links')
             .insert({
@@ -123,7 +124,7 @@ export function registerSurveyTools(server) {
             response_url: responseUrl,
             short_link: shortLink ?? null,
             short_url: shortLink?.slug ? `${appBaseUrl()}/s/${shortLink.slug}` : null,
-            ...(linkError ? { warning: linkError.message } : {}),
+            ...(linkError ? { warning: dbToolError(linkError).error } : {}),
         });
     });
     server.registerTool('list_surveys', {
@@ -146,7 +147,7 @@ export function registerSurveyTools(server) {
             query = query.eq('status', status);
         const { data, error } = await query;
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         return j({ surveys: data ?? [], count: data?.length ?? 0 });
     });
     server.registerTool('get_survey', {
@@ -163,7 +164,7 @@ export function registerSurveyTools(server) {
         const projectId = getProjectId();
         const { data: survey, error } = await db().from('surveys').select('*').eq('id', survey_id).eq('project_id', projectId).maybeSingle();
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         if (!survey)
             return j({ error: 'Survey not found', code: 'NOT_FOUND' });
         const { data: shortLink } = survey.short_link_id
@@ -185,12 +186,12 @@ export function registerSurveyTools(server) {
         const projectId = getProjectId();
         const { data: survey, error: surveyError } = await db().from('surveys').select('id, title, questions').eq('id', survey_id).eq('project_id', projectId).maybeSingle();
         if (surveyError)
-            return j({ error: surveyError.message });
+            return j(dbToolError(surveyError));
         if (!survey)
             return j({ error: 'Survey not found', code: 'NOT_FOUND' });
         const { data: responses, error: responseError } = await db().from('survey_responses').select('id, answers, submitted_at').eq('survey_id', survey_id).eq('project_id', projectId).order('submitted_at', { ascending: false });
         if (responseError)
-            return j({ error: responseError.message });
+            return j(dbToolError(responseError));
         const questions = normalizeQuestions((survey.questions ?? []));
         return j({
             survey_id,
@@ -224,7 +225,7 @@ export function registerSurveyTools(server) {
             if (candidate === undefined) {
                 const { data: existing, error } = await db().from('surveys').select('questions').eq('id', survey_id).eq('project_id', projectId).maybeSingle();
                 if (error)
-                    return j({ error: error.message, code: 'INTERNAL_ERROR' });
+                    return j({ ...dbToolError(error), code: 'INTERNAL_ERROR' });
                 if (!existing)
                     return j({ error: 'Survey not found', code: 'not_found' });
                 candidate = existing.questions;
@@ -251,7 +252,7 @@ export function registerSurveyTools(server) {
             .select()
             .maybeSingle();
         if (error)
-            return j({ error: error.message });
+            return j(dbToolError(error));
         if (!data)
             return j({ error: 'Survey not found', code: 'NOT_FOUND' });
         return j({ survey: data, ok: true });