@sendinel/mcp-server 1.0.209 → 1.0.211

package/README.md

@@ -18,7 +18,7 @@ preserves REST outcomes, and redacts failures. See the
 [event-triggered campaign guide](../../docs/event-triggered-campaigns.md) for
 inputs, idempotency, subscription requirements, and conditional step examples.
 
-Sendinel currently exposes 35 tool groups and 349 tools (gateway mode exposes 4 meta-tools, sharing how_to with full mode). These counts are checked against the tool registry in CI, so this table matches what ships.
+Sendinel currently exposes 35 tool groups and 352 tools (gateway mode exposes 4 meta-tools, sharing how_to with full mode). These counts are checked against the tool registry in CI, so this table matches what ships.
 
 | Group | Count | Purpose |
 |-------|-------|---------|
@@ -48,7 +48,7 @@ Sendinel currently exposes 35 tool groups and 349 tools (gateway mode exposes 4
 | `org` | 24 | Team members, plan usage/limits, audit log, model registry, white-label, support tickets, outbound digest, provider switching |
 | `segments` | 6 | Audience builder: create, edit, natural-language generation, preview |
 | `short-links` | 3 | Short links, click stats, QR codes |
-| `signatures` | 4 | Sending signature blocks |
+| `signatures` | 7 | Sending signature blocks |
 | `sites` | 7 | Site, sender, and brand voice management |
 | `skills` | 3 | Operator skills catalog |
 | `sms` | 7 | SMS send, log, consent, inbound |

package/build/lib/action-approvals.js

@@ -365,7 +365,11 @@ export async function requestApproval(action, params, apiKeyId, channelContext,
     const detailSummary = buildApprovalSummary(action, frozenParams, display);
     const preview = buildApprovalPreview({ action, params: frozenParams, summary: detailSummary,
         ...(display && 'recipient_count' in display ? { recipientCount: display.recipient_count } : {}) });
-    const summary = `${preview.plain_summary.split('\n')[0]}\n${detailSummary}`;
+    const consequence = preview.plain_summary.split('\n')[0];
+    // Named snapshot summaries already include the consequence from the preview builder.
+    const summary = detailSummary.split('\n')[0] === consequence
+        ? detailSummary
+        : `${consequence}\n${detailSummary}`;
     const { data, error } = await approvalStore()
         .from('action_approvals')
         .insert({

package/build/lib/how-to-recipes.js

@@ -8,6 +8,20 @@ const projectRule = 'On hosted /mcp, pass project_id on each call. It is require
 const previewRule = 'preview_email uses the real send renderer with sample contact data. send_test_email with dry_run:true uses the real renderer without sending or needing approval, including in standard mode. Stdio requires SENDINEL_API_KEY.';
 const sender = { n: 1, tool: 'get_sites', args_example: {}, note: 'Choose the intended sender from the returned array; do not assume the first sender is correct. Replace example content and addresses with the user’s own choices.' };
 export const HOW_TO_RECIPES = [
+    {
+        id: 'brand-kit-signature', title: 'Preview and save a brand-kit email signature',
+        when_to_use: 'Set up or edit a signature footer for future AI-generated drafts using stored brand details.',
+        synonyms: ['signature', 'footer', 'email signature', 'brand kit signature'],
+        requires: { scopes: ['write'], tester_ok: false },
+        steps: [sender,
+            { n: 2, tool: 'get_effective_signature', args_example: { site_id: from(1, '0.id') }, note: 'Read the current saved default or brand-kit fallback; no write.' },
+            { n: 3, tool: 'generate_signature_from_brand_kit', args_example: { site_id: from(1, '0.id') }, note: 'Read a proposal; inspect omitted fields instead of inventing missing data.' },
+            { n: 4, tool: 'preview_signature', args_example: { site_id: from(1, '0.id'), html: from(3, 'html') }, note: 'Review the proposal and warnings. Fields can be supplied instead of HTML for simple edits.' },
+            { n: 5, tool: 'create_signature', args_example: { site_id: from(1, '0.id'), name: 'Brand signature', html: from(4, 'html'), is_default: true }, note: 'Only when asked to save. For an existing signature use update_signature with its id, html and is_default:true instead.' },
+        ],
+        gotchas: [projectRule, 'Only future AI-generated drafts use this default. No sending, existing campaign/template changes, postal address duplication, or bulk saving. Read and preview tools write nothing.'],
+        done_when: 'The preview is reviewed and, if requested, the selected site has the intended saved default.',
+    },
     {
         id: 'event-driven-billing-mail-end-to-end', title: 'Event-driven billing mail end to end',
         when_to_use: 'Build and verify event-driven billing, dunning, payment failed or trial ending transactional mail, then request human approval for activation.',

package/build/tools/campaigns.js

@@ -1586,8 +1586,8 @@ export function registerCampaignTools(server) {
                 message: executed.grouped && executed.alreadySent
                     ? `${executed.enrolled} ${payload.send_at ? `scheduled at ${payload.send_at}` : 'sent now'}; ${executed.alreadySent} skipped because they already received it.`
                     : payload.send_at
-                        ? `Scheduled: "${payload.subject}" goes to ${executed.enrolled} people at ${payload.send_at}.`
-                        : `Sending: "${payload.subject}" is going to ${executed.enrolled} people now. Delivery happens over the next few minutes; check the campaign for results.`,
+                        ? `Scheduled: "${payload.subject}" goes to ${executed.enrolled} ${executed.enrolled === 1 ? 'person' : 'people'} at ${payload.send_at}.`
+                        : `Sending: "${payload.subject}" is going to ${executed.enrolled} ${executed.enrolled === 1 ? 'person' : 'people'} now. Delivery happens over the next few minutes; check the campaign for results.`,
             });
         }
         // ── Call 2: execute exactly the approved, frozen payload. Nothing else is trusted. ──

package/build/tools/signatures.js

@@ -5,10 +5,61 @@ import { db } from '../db.js';
 import { getProjectId } from '../project.js';
 import { logAudit } from '../audit.js';
 import { dbToolError, deleteBlockedToolResult } from '../lib/db-error.js';
+import { buildBrandKitSignature, getEffectiveSignature, previewSignature } from '@sendinel/domain';
 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';
 export function registerSignatureTools(server) {
+    const fields = z.object({
+        display_name: z.string().optional(), tagline: z.string().optional(), logo_url: z.string().optional(),
+        website_url: z.string().optional(), from_name: z.string().optional(), from_email: z.string().optional(),
+        accent_color: z.string().optional(), font_family: z.string().optional(),
+    });
+    const readHandler = (name) => async (input) => {
+        const projectId = getProjectId();
+        const client = db();
+        const scoped = typeof client.schema === 'function' ? client.schema('email') : client;
+        const { data: site, error: siteError } = await scoped.from('sites')
+            .select('id, name, from_name, from_email, website_url').eq('id', input.site_id).eq('project_id', projectId).maybeSingle();
+        if (siteError)
+            return j(dbToolError(siteError));
+        if (!site)
+            return j({ error: 'Site not found', code: 'NOT_FOUND' });
+        if (name === 'preview_signature' && (input.html !== undefined || input.fields !== undefined)) {
+            if (input.html !== undefined && input.fields !== undefined)
+                return j({ error: 'Supply html or fields, not both', code: 'validation_failed' });
+            return j(previewSignature(input));
+        }
+        const { data: project, error: projectError } = await scoped.from('projects').select('brand_settings').eq('id', projectId).maybeSingle();
+        if (projectError)
+            return j(dbToolError(projectError));
+        if (!project)
+            return j({ error: 'Project not found', code: 'NOT_FOUND' });
+        const brandInput = { site, brandSettings: project.brand_settings };
+        if (name === 'generate_signature_from_brand_kit')
+            return j(buildBrandKitSignature(brandInput));
+        const { data: savedDefault, error: signatureError } = await scoped.from('signature_blocks').select('html')
+            .eq('project_id', projectId).eq('site_id', input.site_id).eq('is_default', true).maybeSingle();
+        if (signatureError)
+            return j(dbToolError(signatureError));
+        const effective = getEffectiveSignature({ ...brandInput, savedDefault });
+        return j(name === 'preview_signature' ? { ...effective, ...previewSignature({ html: effective.html }) } : effective);
+    };
+    server.registerTool('get_effective_signature', {
+        title: 'Get Effective Signature', annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        description: 'Read the saved default signature or deterministic brand-kit fallback for future AI drafts. Writes nothing.',
+        inputSchema: { site_id: z.string().uuid() },
+    }, readHandler('get_effective_signature'));
+    server.registerTool('generate_signature_from_brand_kit', {
+        title: 'Generate Signature from Brand Kit', annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        description: 'Propose an email-safe signature from stored brand settings. Missing fields are omitted and listed. Writes nothing; save via create_signature or update_signature.',
+        inputSchema: { site_id: z.string().uuid() },
+    }, readHandler('generate_signature_from_brand_kit'));
+    server.registerTool('preview_signature', {
+        title: 'Preview Signature', annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        description: 'Preview a signature candidate (HTML or fields), or the effective signature when neither is supplied. Returns final HTML and email-safety warnings. Writes nothing.',
+        inputSchema: { site_id: z.string().uuid(), html: z.string().optional(), fields: fields.optional() },
+    }, readHandler('preview_signature'));
     server.registerTool('list_signatures', {
         title: 'List Signatures',
         annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendinel/mcp-server",
-  "version": "1.0.209",
+  "version": "1.0.211",
   "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",