@sendinel/mcp-server 1.0.217 → 1.0.219

package/build/lib/db-error.d.ts

@@ -63,10 +63,14 @@ export declare function formatZodError(error: z.ZodError | {
         [key: string]: any;
     }>;
 }): string;
-/** Machine-code classification for api_usage only. Never rewrite response codes.
+/** Machine-code classification shared by tool results and api_usage. Never rewrite legacy codes.
  * Keys are case-insensitive; every supported legacy spelling is listed explicitly.
  * Existing usage-only policy classes remain supported alongside the six tool classes. */
 export declare const API_USAGE_ERROR_CODE_MAP: Readonly<Record<string, string>>;
+/** One classifier for the additive response class and hosted usage tracking. */
+export declare function classifyMachineCode(code: string): string | null;
+/** Classify a failed body, preserving any explicitly supplied error_code. */
+export declare function toolErrorClass(body: Record<string, unknown>): unknown;
 type ToolResult = {
     content: Array<{
         type: string;

package/build/lib/db-error.js

@@ -99,7 +99,7 @@ export function formatZodError(error) {
     }
     return messages.join(' ');
 }
-/** Machine-code classification for api_usage only. Never rewrite response codes.
+/** Machine-code classification shared by tool results and api_usage. Never rewrite legacy codes.
  * Keys are case-insensitive; every supported legacy spelling is listed explicitly.
  * Existing usage-only policy classes remain supported alongside the six tool classes. */
 export const API_USAGE_ERROR_CODE_MAP = {
@@ -111,6 +111,7 @@ export const API_USAGE_ERROR_CODE_MAP = {
     'bad_request': 'validation_failed',
     'campaigns_required': 'validation_failed',
     'content_required': 'validation_failed',
+    'content_not_ready': 'validation_failed',
     'empty_audience': 'validation_failed',
     'empty_body': 'validation_failed',
     'empty_cohort': 'validation_failed',
@@ -146,6 +147,7 @@ export const API_USAGE_ERROR_CODE_MAP = {
     'validation_failed': 'validation_failed',
     'approval_not_cancellable': 'conflict',
     'approval_not_pending': 'conflict',
+    'already_sent_to_audience': 'conflict',
     'human_decision_required': 'forbidden',
     '23505': 'conflict',
     'conflict': 'conflict',
@@ -209,10 +211,32 @@ export const API_USAGE_ERROR_CODE_MAP = {
     'step_create_failed': 'internal_error',
     'step_lookup_failed': 'internal_error',
     'survey_link_not_ready': 'internal_error',
+    'project_connector_unavailable': 'internal_error',
     'sandbox_blocked': 'sandbox_blocked',
     'send_allowlist_refused': 'send_allowlist_refused',
     'rate_limited': 'rate_limited',
 };
+/** One classifier for the additive response class and hosted usage tracking. */
+export function classifyMachineCode(code) {
+    const lower = code.toLowerCase().trim();
+    if (Object.hasOwn(API_USAGE_ERROR_CODE_MAP, lower))
+        return API_USAGE_ERROR_CODE_MAP[lower];
+    if (lower.endsWith('_not_found'))
+        return 'not_found';
+    if (lower.endsWith('_conflict'))
+        return 'conflict';
+    if (lower.endsWith('_limit_reached') || lower.endsWith('_limit'))
+        return 'plan_limit';
+    return null;
+}
+/** Classify a failed body, preserving any explicitly supplied error_code. */
+export function toolErrorClass(body) {
+    if ('error_code' in body)
+        return body.error_code;
+    if (typeof body.code !== 'string')
+        return 'internal_error';
+    return classifyMachineCode(body.code);
+}
 /** Add a stable class to refusals without dropping existing fields or success data. */
 export function codedToolResult(result) {
     let failed = result.isError === true;
@@ -242,18 +266,21 @@ export function codedToolResult(result) {
             return block;
         failed = true;
         // An existing code is a frozen client surface, even when it is unfamiliar.
-        if ('code' in body)
-            return block;
+        if ('code' in body) {
+            if ('error_code' in body)
+                return block;
+            return { ...block, text: JSON.stringify({ ...body, error_code: toolErrorClass(body) }, null, block.text.includes('\n') ? 2 : undefined) };
+        }
         const nestedCode = body.error && typeof body.error === 'object' ? body.error.code : undefined;
         const nestedClass = typeof nestedCode === 'string' ? nestedCode.toLowerCase() : undefined;
         const code = textCode ?? (TOOL_ERROR_CODES.includes(nestedClass) ? nestedClass
             : (body.status === 404 ? 'not_found'
                 : body.status === 409 ? 'conflict' : body.status === 422 ? 'validation_failed'
                     : body.status === 401 || body.status === 403 ? 'forbidden' : 'internal_error'));
-        return { ...block, text: JSON.stringify({ ...body, code }, null, block.text.includes('\n') ? 2 : undefined) };
+        return { ...block, text: JSON.stringify({ ...body, code, error_code: toolErrorClass({ ...body, code }) }, null, block.text.includes('\n') ? 2 : undefined) };
     });
     if (failed && !content.some(block => block.type === 'text')) {
-        content.push({ type: 'text', text: JSON.stringify(mapDbError(undefined)) });
+        content.push({ type: 'text', text: JSON.stringify({ ...mapDbError(undefined), error_code: toolErrorClass(mapDbError(undefined)) }) });
     }
     return failed ? { ...result, isError: true, content } : result;
 }
@@ -266,7 +293,7 @@ export function withToolErrors(handler) {
         catch (error) {
             if (error instanceof McpError && error.code === ErrorCode.UrlElicitationRequired)
                 throw error;
-            return dbErrorResult(error);
+            return codedToolResult(dbErrorResult(error));
         }
     };
 }

package/build/tools/campaigns.js

@@ -2722,7 +2722,7 @@ Do not include body_html in your response; Sendinel renders body_html from block
             idempotentHint: false,
             openWorldHint: true,
         },
-        description: 'Send a test email to a specified address using the site\'s configured provider. Content from step_id, draft_id, or raw subject/body_html uses the real send renderer. Optional dry_run previews without sending; suppressed recipients are refused. Logged as test, not counted in campaign metrics.',
+        description: 'Send a test email to a specified address using the site\'s configured provider. Content from step_id, draft_id, or raw subject/body_html uses the real send renderer. Optional dry_run previews without sending and includes unresolved_merge_tags (tags with no recipient value and no fallback, with subject/html/text locations); suppressed recipients are refused. Logged as test, not counted in campaign metrics.',
         inputSchema: {
             approval_id: z.string().uuid().optional().describe('Get this by calling once without it, then have a human approve the returned approve_url. Re-call with only approval_id to run the action.'),
             to_email: z.string().email().describe('Email address to send the test to'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendinel/mcp-server",
-  "version": "1.0.217",
+  "version": "1.0.219",
   "description": "AI-controlled email operations control plane for campaigns, contacts, segments, analytics, and multi-provider sending via MCP.",
   "mcpName": "ai.sendinel/mcp-server",
   "type": "module",