@step-func-emailer/mcp 0.2.0

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+export interface McpConfig {
+    region: string;
+    tableName: string;
+    eventsTableName: string;
+    templateBucketName: string;
+}
+export declare function resolveConfig(): McpConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AA8BD,wBAAgB,aAAa,IAAI,SAAS,CAgBzC"}

package/dist/config.js

@@ -0,0 +1,83 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConfig = resolveConfig;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+function findProjectRoot() {
+    let dir = __dirname;
+    for (let i = 0; i < 10; i++) {
+        if (fs.existsSync(path.join(dir, ".env")))
+            return dir;
+        if (fs.existsSync(path.join(dir, "pnpm-workspace.yaml")))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return process.cwd();
+}
+function loadEnvFile() {
+    const envPath = path.join(findProjectRoot(), ".env");
+    if (!fs.existsSync(envPath))
+        return;
+    for (const line of fs.readFileSync(envPath, "utf-8").split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const idx = trimmed.indexOf("=");
+        if (idx === -1)
+            continue;
+        const key = trimmed.slice(0, idx);
+        const value = trimmed.slice(idx + 1);
+        if (!(key in process.env)) {
+            process.env[key] = value;
+        }
+    }
+}
+function resolveConfig() {
+    loadEnvFile();
+    const region = process.env.REGION ?? process.env.AWS_REGION ?? "us-east-1";
+    const tableName = process.env.TABLE_NAME;
+    const eventsTableName = process.env.EVENTS_TABLE_NAME;
+    const templateBucketName = process.env.TEMPLATE_BUCKET_NAME;
+    if (!tableName || !eventsTableName || !templateBucketName) {
+        throw new Error("Missing required env vars: TABLE_NAME, EVENTS_TABLE_NAME, TEMPLATE_BUCKET_NAME. " +
+            "Ensure .env exists in the repo root or set them in the environment.");
+    }
+    return { region, tableName, eventsTableName, templateBucketName };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,sCAgBC;AAtDD,4CAA8B;AAC9B,gDAAkC;AASlC,SAAS,eAAe;IACtB,IAAI,GAAG,GAAG,SAAS,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QACtD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QACrE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO;IACpC,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACjE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,SAAS;QACzB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAgB,aAAa;IAC3B,WAAW,EAAE,CAAC;IAEd,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,WAAW,CAAC;IAC3E,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACzC,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACtD,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAE5D,IAAI,CAAC,SAAS,IAAI,CAAC,eAAe,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CACb,kFAAkF;YAChF,qEAAqE,CACxE,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAC;AACpE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const package_json_1 = require("../package.json");
+const config_js_1 = require("./config.js");
+const subscribers_js_1 = require("./tools/subscribers.js");
+const suppression_js_1 = require("./tools/suppression.js");
+const engagement_js_1 = require("./tools/engagement.js");
+const templates_js_1 = require("./tools/templates.js");
+const system_js_1 = require("./tools/system.js");
+const config = (0, config_js_1.resolveConfig)();
+const server = new mcp_js_1.McpServer({
+    name: "step-func-emailer",
+    version: package_json_1.version,
+});
+// ── Subscriber management ──────────────────────────────────────────────────
+server.registerTool("get_subscriber", {
+    description: "Get subscriber profile, active executions, and recent send log",
+    inputSchema: { email: zod_1.z.string().email() },
+}, async ({ email }) => ({
+    content: [{ type: "text", text: JSON.stringify(await (0, subscribers_js_1.getSubscriber)(config, email), null, 2) }],
+}));
+server.registerTool("list_subscribers", {
+    description: "List subscriber profiles, optionally filtered by status",
+    inputSchema: {
+        status: zod_1.z.enum(["active", "unsubscribed", "suppressed", "all"]).optional().default("all"),
+        limit: zod_1.z.number().int().min(1).max(100).optional().default(20),
+    },
+}, async ({ status, limit }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, subscribers_js_1.listSubscribers)(config, status, limit), null, 2),
+        },
+    ],
+}));
+server.registerTool("update_subscriber", {
+    description: "Update attribute values on a subscriber profile",
+    inputSchema: {
+        email: zod_1.z.string().email(),
+        attributes: zod_1.z.record(zod_1.z.unknown()),
+    },
+}, async ({ email, attributes }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, subscribers_js_1.updateSubscriber)(config, email, attributes), null, 2),
+        },
+    ],
+}));
+server.registerTool("delete_subscriber", {
+    description: "Remove all records for a subscriber across both tables",
+    inputSchema: { email: zod_1.z.string().email() },
+}, async ({ email }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, subscribers_js_1.deleteSubscriber)(config, email), null, 2),
+        },
+    ],
+}));
+server.registerTool("unsubscribe_subscriber", {
+    description: "Set subscriber as unsubscribed and stop all active executions",
+    inputSchema: { email: zod_1.z.string().email() },
+}, async ({ email }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, subscribers_js_1.unsubscribeSubscriber)(config, email), null, 2),
+        },
+    ],
+}));
+server.registerTool("resubscribe_subscriber", {
+    description: "Clear unsubscribe flag on a subscriber",
+    inputSchema: { email: zod_1.z.string().email() },
+}, async ({ email }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, subscribers_js_1.resubscribeSubscriber)(config, email), null, 2),
+        },
+    ],
+}));
+// ── Suppression management ─────────────────────────────────────────────────
+server.registerTool("list_suppressed", {
+    description: "List suppressed subscribers",
+    inputSchema: {
+        limit: zod_1.z.number().int().min(1).max(100).optional().default(20),
+    },
+}, async ({ limit }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, suppression_js_1.listSuppressed)(config, limit), null, 2),
+        },
+    ],
+}));
+server.registerTool("remove_suppression", {
+    description: "Remove suppression record and clear suppressed flag on profile",
+    inputSchema: { email: zod_1.z.string().email() },
+}, async ({ email }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, suppression_js_1.removeSuppression)(config, email), null, 2),
+        },
+    ],
+}));
+// ── Engagement ─────────────────────────────────────────────────────────────
+server.registerTool("get_subscriber_events", {
+    description: "Get engagement events for one subscriber",
+    inputSchema: {
+        email: zod_1.z.string().email(),
+        eventType: zod_1.z.enum(["delivery", "open", "click", "bounce", "complaint"]).optional(),
+        startDate: zod_1.z.string().optional().describe("ISO 8601 date"),
+        endDate: zod_1.z.string().optional().describe("ISO 8601 date"),
+        limit: zod_1.z.number().int().min(1).max(100).optional().default(20),
+    },
+}, async ({ email, eventType, startDate, endDate, limit }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, engagement_js_1.getSubscriberEvents)(config, email, eventType, startDate, endDate, limit), null, 2),
+        },
+    ],
+}));
+server.registerTool("get_template_events", {
+    description: "Get engagement events across all subscribers for a template",
+    inputSchema: {
+        templateKey: zod_1.z.string(),
+        eventType: zod_1.z.enum(["delivery", "open", "click", "bounce", "complaint"]).optional(),
+        startDate: zod_1.z.string().optional().describe("ISO 8601 date"),
+        endDate: zod_1.z.string().optional().describe("ISO 8601 date"),
+        limit: zod_1.z.number().int().min(1).max(100).optional().default(20),
+    },
+}, async ({ templateKey, eventType, startDate, endDate, limit }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, engagement_js_1.getTemplateEvents)(config, templateKey, eventType, startDate, endDate, limit), null, 2),
+        },
+    ],
+}));
+server.registerTool("get_sequence_events", {
+    description: "Get engagement events for all templates in a sequence",
+    inputSchema: {
+        sequenceId: zod_1.z.string(),
+        eventType: zod_1.z.enum(["delivery", "open", "click", "bounce", "complaint"]).optional(),
+        startDate: zod_1.z.string().optional().describe("ISO 8601 date"),
+        endDate: zod_1.z.string().optional().describe("ISO 8601 date"),
+        limit: zod_1.z.number().int().min(1).max(100).optional().default(20),
+    },
+}, async ({ sequenceId, eventType, startDate, endDate, limit }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, engagement_js_1.getSequenceEvents)(config, sequenceId, eventType, startDate, endDate, limit), null, 2),
+        },
+    ],
+}));
+// ── Templates ──────────────────────────────────────────────────────────────
+server.registerTool("list_templates", {
+    description: "List template keys in S3",
+    inputSchema: {
+        prefix: zod_1.z.string().optional(),
+    },
+}, async ({ prefix }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, templates_js_1.listTemplates)(config, prefix), null, 2),
+        },
+    ],
+}));
+server.registerTool("preview_template", {
+    description: "Render a template with a subscriber's data",
+    inputSchema: {
+        templateKey: zod_1.z.string(),
+        email: zod_1.z.string().email(),
+    },
+}, async ({ templateKey, email }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, templates_js_1.previewTemplate)(config, templateKey, email), null, 2),
+        },
+    ],
+}));
+server.registerTool("validate_template", {
+    description: "Check Liquid syntax of a template",
+    inputSchema: { templateKey: zod_1.z.string() },
+}, async ({ templateKey }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, templates_js_1.validateTemplate)(config, templateKey), null, 2),
+        },
+    ],
+}));
+// ── System health ──────────────────────────────────────────────────────────
+server.registerTool("get_failed_executions", {
+    description: "Get recent Step Functions execution failures",
+    inputSchema: {
+        stateMachineArn: zod_1.z.string().describe("ARN of the state machine to check"),
+        startDate: zod_1.z.string().optional().describe("ISO 8601 date"),
+        limit: zod_1.z.number().int().min(1).max(100).optional().default(20),
+    },
+}, async ({ stateMachineArn, startDate, limit }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, system_js_1.getFailedExecutions)(config, stateMachineArn, startDate, limit), null, 2),
+        },
+    ],
+}));
+server.registerTool("get_delivery_stats", {
+    description: "Get aggregate event counts in a period",
+    inputSchema: {
+        startDate: zod_1.z.string().describe("ISO 8601 date"),
+        endDate: zod_1.z.string().describe("ISO 8601 date"),
+    },
+}, async ({ startDate, endDate }) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(await (0, system_js_1.getDeliveryStats)(config, startDate, endDate), null, 2),
+        },
+    ],
+}));
+// ── Start server ───────────────────────────────────────────────────────────
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/engagement.d.ts

@@ -0,0 +1,5 @@
+import type { McpConfig } from "../config.js";
+export declare function getSubscriberEvents(config: McpConfig, email: string, eventType: string | undefined, startDate: string | undefined, endDate: string | undefined, limit: number): Promise<Record<string, any>[]>;
+export declare function getTemplateEvents(config: McpConfig, templateKey: string, eventType: string | undefined, startDate: string | undefined, endDate: string | undefined, limit: number): Promise<Record<string, any>[]>;
+export declare function getSequenceEvents(config: McpConfig, sequenceId: string, eventType: string | undefined, startDate: string | undefined, endDate: string | undefined, limit: number): Promise<Record<string, any>[]>;
+//# sourceMappingURL=engagement.d.ts.map

package/dist/tools/engagement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.d.ts","sourceRoot":"","sources":["../../src/tools/engagement.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AA4B9C,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,kCA8Bd;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,kCA8Bd;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,kCAkCd"}

package/dist/tools/engagement.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSubscriberEvents = getSubscriberEvents;
+exports.getTemplateEvents = getTemplateEvents;
+exports.getSequenceEvents = getSequenceEvents;
+const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
+const util_dynamodb_1 = require("@aws-sdk/util-dynamodb");
+const shared_1 = require("@step-func-emailer/shared");
+let dynamo;
+function getDynamo(region) {
+    if (!dynamo)
+        dynamo = new client_dynamodb_1.DynamoDBClient({ region });
+    return dynamo;
+}
+function buildSkRange(startDate, endDate) {
+    if (startDate && endDate) {
+        return {
+            expression: "SK BETWEEN :skStart AND :skEnd",
+            values: {
+                ":skStart": `${shared_1.EVT_SK_PREFIX}${startDate}`,
+                ":skEnd": `${shared_1.EVT_SK_PREFIX}${endDate}~`,
+            },
+        };
+    }
+    return {
+        expression: "begins_with(SK, :skPrefix)",
+        values: { ":skPrefix": shared_1.EVT_SK_PREFIX },
+    };
+}
+async function getSubscriberEvents(config, email, eventType, startDate, endDate, limit) {
+    const db = getDynamo(config.region);
+    const pk = (0, shared_1.subscriberPK)(email);
+    const skRange = buildSkRange(startDate, endDate);
+    const filterParts = [];
+    const filterValues = {};
+    if (eventType) {
+        filterParts.push("eventType = :eventType");
+        filterValues[":eventType"] = eventType;
+    }
+    const result = await db.send(new client_dynamodb_1.QueryCommand({
+        TableName: config.eventsTableName,
+        KeyConditionExpression: `PK = :pk AND ${skRange.expression}`,
+        ...(filterParts.length > 0 ? { FilterExpression: filterParts.join(" AND ") } : {}),
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)({
+            ":pk": pk,
+            ...skRange.values,
+            ...filterValues,
+        }),
+        ScanIndexForward: false,
+        Limit: Math.min(limit, 100),
+    }));
+    return (result.Items ?? []).map((i) => (0, util_dynamodb_1.unmarshall)(i));
+}
+async function getTemplateEvents(config, templateKey, eventType, startDate, endDate, limit) {
+    const db = getDynamo(config.region);
+    const skRange = buildSkRange(startDate, endDate);
+    const filterParts = [];
+    const filterValues = {};
+    if (eventType) {
+        filterParts.push("eventType = :eventType");
+        filterValues[":eventType"] = eventType;
+    }
+    const result = await db.send(new client_dynamodb_1.QueryCommand({
+        TableName: config.eventsTableName,
+        IndexName: shared_1.TEMPLATE_INDEX,
+        KeyConditionExpression: `templateKey = :tk AND ${skRange.expression}`,
+        ...(filterParts.length > 0 ? { FilterExpression: filterParts.join(" AND ") } : {}),
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)({
+            ":tk": templateKey,
+            ...skRange.values,
+            ...filterValues,
+        }),
+        ScanIndexForward: false,
+        Limit: Math.min(limit, 100),
+    }));
+    return (result.Items ?? []).map((i) => (0, util_dynamodb_1.unmarshall)(i));
+}
+async function getSequenceEvents(config, sequenceId, eventType, startDate, endDate, limit) {
+    const db = getDynamo(config.region);
+    // No GSI on sequenceId, so we scan with filter
+    const filterParts = ["sequenceId = :seqId"];
+    const filterValues = { ":seqId": sequenceId };
+    if (eventType) {
+        filterParts.push("eventType = :eventType");
+        filterValues[":eventType"] = eventType;
+    }
+    if (startDate) {
+        filterParts.push("SK >= :skStart");
+        filterValues[":skStart"] = `${shared_1.EVT_SK_PREFIX}${startDate}`;
+    }
+    if (endDate) {
+        filterParts.push("SK <= :skEnd");
+        filterValues[":skEnd"] = `${shared_1.EVT_SK_PREFIX}${endDate}~`;
+    }
+    const result = await db.send(new client_dynamodb_1.ScanCommand({
+        TableName: config.eventsTableName,
+        FilterExpression: filterParts.join(" AND "),
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)(filterValues),
+        Limit: Math.min(limit, 100) * 10,
+    }));
+    return (result.Items ?? [])
+        .map((i) => (0, util_dynamodb_1.unmarshall)(i))
+        .sort((a, b) => b.SK.localeCompare(a.SK))
+        .slice(0, limit);
+}
+//# sourceMappingURL=engagement.js.map

package/dist/tools/engagement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.js","sourceRoot":"","sources":["../../src/tools/engagement.ts"],"names":[],"mappings":"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"}

package/dist/tools/subscribers.d.ts

@@ -0,0 +1,23 @@
+import type { McpConfig } from "../config.js";
+export declare function getSubscriber(config: McpConfig, email: string): Promise<{
+    profile: Record<string, any> | null;
+    executions: Record<string, any>[];
+    sendLog: Record<string, any>[];
+    suppression: Record<string, any> | null;
+}>;
+export declare function listSubscribers(config: McpConfig, status: string | undefined, limit: number): Promise<Record<string, any>[]>;
+export declare function updateSubscriber(config: McpConfig, email: string, attributes: Record<string, unknown>): Promise<{
+    updated: boolean;
+}>;
+export declare function deleteSubscriber(config: McpConfig, email: string): Promise<{
+    deleted: boolean;
+    itemCount: number;
+}>;
+export declare function unsubscribeSubscriber(config: McpConfig, email: string): Promise<{
+    unsubscribed: boolean;
+    executionsStopped: number;
+}>;
+export declare function resubscribeSubscriber(config: McpConfig, email: string): Promise<{
+    resubscribed: boolean;
+}>;
+//# sourceMappingURL=subscribers.d.ts.map

package/dist/tools/subscribers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.d.ts","sourceRoot":"","sources":["../../src/tools/subscribers.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAe9C,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM;;;;;GAuBnE;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,kCAgCd;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;GA4BpC;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM;;;GA8CtE;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM;;;GAmD3E;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM;;GAiB3E"}

package/dist/tools/subscribers.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSubscriber = getSubscriber;
+exports.listSubscribers = listSubscribers;
+exports.updateSubscriber = updateSubscriber;
+exports.deleteSubscriber = deleteSubscriber;
+exports.unsubscribeSubscriber = unsubscribeSubscriber;
+exports.resubscribeSubscriber = resubscribeSubscriber;
+const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
+const util_dynamodb_1 = require("@aws-sdk/util-dynamodb");
+const client_sfn_1 = require("@aws-sdk/client-sfn");
+const shared_1 = require("@step-func-emailer/shared");
+let dynamo;
+let sfn;
+function getDynamo(region) {
+    if (!dynamo)
+        dynamo = new client_dynamodb_1.DynamoDBClient({ region });
+    return dynamo;
+}
+function getSfn(region) {
+    if (!sfn)
+        sfn = new client_sfn_1.SFNClient({ region });
+    return sfn;
+}
+async function getSubscriber(config, email) {
+    const db = getDynamo(config.region);
+    const pk = (0, shared_1.subscriberPK)(email);
+    // Get all items for this subscriber in one query
+    const result = await db.send(new client_dynamodb_1.QueryCommand({
+        TableName: config.tableName,
+        KeyConditionExpression: "PK = :pk",
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)({ ":pk": pk }),
+    }));
+    const items = (result.Items ?? []).map((i) => (0, util_dynamodb_1.unmarshall)(i));
+    const profile = items.find((i) => i.SK === shared_1.PROFILE_SK) ?? null;
+    const executions = items.filter((i) => i.SK.startsWith(shared_1.EXEC_SK_PREFIX));
+    const sendLog = items
+        .filter((i) => i.SK.startsWith(shared_1.SENT_SK_PREFIX))
+        .sort((a, b) => b.SK.localeCompare(a.SK))
+        .slice(0, 20);
+    const suppression = items.find((i) => i.SK === shared_1.SUPPRESSION_SK) ?? null;
+    return { profile, executions, sendLog, suppression };
+}
+async function listSubscribers(config, status, limit) {
+    const db = getDynamo(config.region);
+    let filterExpression;
+    const expressionValues = {
+        ":sk": shared_1.PROFILE_SK,
+    };
+    if (status === "active") {
+        filterExpression = "SK = :sk AND unsubscribed = :false AND suppressed = :false";
+        expressionValues[":false"] = false;
+    }
+    else if (status === "unsubscribed") {
+        filterExpression = "SK = :sk AND unsubscribed = :true";
+        expressionValues[":true"] = true;
+    }
+    else if (status === "suppressed") {
+        filterExpression = "SK = :sk AND suppressed = :true";
+        expressionValues[":true"] = true;
+    }
+    else {
+        filterExpression = "SK = :sk";
+    }
+    const result = await db.send(new client_dynamodb_1.ScanCommand({
+        TableName: config.tableName,
+        FilterExpression: filterExpression,
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)(expressionValues),
+        Limit: Math.min(limit, 100) * 10, // overscan since filter is post-scan
+    }));
+    return (result.Items ?? []).map((i) => (0, util_dynamodb_1.unmarshall)(i)).slice(0, limit);
+}
+async function updateSubscriber(config, email, attributes) {
+    const db = getDynamo(config.region);
+    const parts = [];
+    const values = {
+        ":now": new Date().toISOString(),
+    };
+    const names = {};
+    for (const [key, value] of Object.entries(attributes)) {
+        parts.push(`#attr_${key} = :attr_${key}`);
+        names[`#attr_${key}`] = key;
+        values[`:attr_${key}`] = value;
+    }
+    await db.send(new client_dynamodb_1.UpdateItemCommand({
+        TableName: config.tableName,
+        Key: (0, util_dynamodb_1.marshall)({ PK: (0, shared_1.subscriberPK)(email), SK: shared_1.PROFILE_SK }),
+        UpdateExpression: `SET ${parts.join(", ")}, updatedAt = :now`,
+        ExpressionAttributeNames: names,
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)(values),
+        ConditionExpression: "attribute_exists(PK)",
+    }));
+    return { updated: true };
+}
+async function deleteSubscriber(config, email) {
+    const db = getDynamo(config.region);
+    const pk = (0, shared_1.subscriberPK)(email);
+    // Delete from main table
+    const mainItems = await db.send(new client_dynamodb_1.QueryCommand({
+        TableName: config.tableName,
+        KeyConditionExpression: "PK = :pk",
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)({ ":pk": pk }),
+        ProjectionExpression: "PK, SK",
+    }));
+    // Delete from events table
+    const eventItems = await db.send(new client_dynamodb_1.QueryCommand({
+        TableName: config.eventsTableName,
+        KeyConditionExpression: "PK = :pk",
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)({ ":pk": pk }),
+        ProjectionExpression: "PK, SK",
+    }));
+    const allDeletes = [
+        ...(mainItems.Items ?? []).map((item) => ({
+            tableName: config.tableName,
+            key: item,
+        })),
+        ...(eventItems.Items ?? []).map((item) => ({
+            tableName: config.eventsTableName,
+            key: item,
+        })),
+    ];
+    // Delete items individually (simpler and avoids BatchWrite type complexity)
+    for (const item of allDeletes) {
+        await db.send(new client_dynamodb_1.DeleteItemCommand({
+            TableName: item.tableName,
+            Key: item.key,
+        }));
+    }
+    return { deleted: true, itemCount: allDeletes.length };
+}
+async function unsubscribeSubscriber(config, email) {
+    const db = getDynamo(config.region);
+    const sfnClient = getSfn(config.region);
+    const pk = (0, shared_1.subscriberPK)(email);
+    // Set unsubscribed flag
+    await db.send(new client_dynamodb_1.UpdateItemCommand({
+        TableName: config.tableName,
+        Key: (0, util_dynamodb_1.marshall)({ PK: pk, SK: shared_1.PROFILE_SK }),
+        UpdateExpression: "SET unsubscribed = :val, updatedAt = :now",
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)({
+            ":val": true,
+            ":now": new Date().toISOString(),
+        }),
+    }));
+    // Stop all active executions
+    const execResult = await db.send(new client_dynamodb_1.QueryCommand({
+        TableName: config.tableName,
+        KeyConditionExpression: "PK = :pk AND begins_with(SK, :prefix)",
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)({
+            ":pk": pk,
+            ":prefix": shared_1.EXEC_SK_PREFIX,
+        }),
+    }));
+    const executions = (execResult.Items ?? []).map((i) => (0, util_dynamodb_1.unmarshall)(i));
+    for (const exec of executions) {
+        try {
+            await sfnClient.send(new client_sfn_1.StopExecutionCommand({
+                executionArn: exec.executionArn,
+                cause: "Subscriber unsubscribed via MCP",
+            }));
+        }
+        catch {
+            // Execution may already be stopped
+        }
+        await db.send(new client_dynamodb_1.DeleteItemCommand({
+            TableName: config.tableName,
+            Key: (0, util_dynamodb_1.marshall)({ PK: pk, SK: exec.SK }),
+        }));
+    }
+    return { unsubscribed: true, executionsStopped: executions.length };
+}
+async function resubscribeSubscriber(config, email) {
+    const db = getDynamo(config.region);
+    await db.send(new client_dynamodb_1.UpdateItemCommand({
+        TableName: config.tableName,
+        Key: (0, util_dynamodb_1.marshall)({ PK: (0, shared_1.subscriberPK)(email), SK: shared_1.PROFILE_SK }),
+        UpdateExpression: "SET unsubscribed = :val, updatedAt = :now",
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)({
+            ":val": false,
+            ":now": new Date().toISOString(),
+        }),
+        ConditionExpression: "attribute_exists(PK)",
+    }));
+    return { resubscribed: true };
+}
+//# sourceMappingURL=subscribers.js.map

package/dist/tools/subscribers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.js","sourceRoot":"","sources":["../../src/tools/subscribers.ts"],"names":[],"mappings":"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"}

package/dist/tools/suppression.d.ts

@@ -0,0 +1,6 @@
+import type { McpConfig } from "../config.js";
+export declare function listSuppressed(config: McpConfig, limit: number): Promise<Record<string, any>[]>;
+export declare function removeSuppression(config: McpConfig, email: string): Promise<{
+    removed: boolean;
+}>;
+//# sourceMappingURL=suppression.d.ts.map

package/dist/tools/suppression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppression.d.ts","sourceRoot":"","sources":["../../src/tools/suppression.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAS9C,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kCAapE;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM;;GA0BvE"}

package/dist/tools/suppression.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listSuppressed = listSuppressed;
+exports.removeSuppression = removeSuppression;
+const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
+const util_dynamodb_1 = require("@aws-sdk/util-dynamodb");
+const shared_1 = require("@step-func-emailer/shared");
+let dynamo;
+function getDynamo(region) {
+    if (!dynamo)
+        dynamo = new client_dynamodb_1.DynamoDBClient({ region });
+    return dynamo;
+}
+async function listSuppressed(config, limit) {
+    const db = getDynamo(config.region);
+    const result = await db.send(new client_dynamodb_1.ScanCommand({
+        TableName: config.tableName,
+        FilterExpression: "SK = :sk",
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)({ ":sk": shared_1.SUPPRESSION_SK }),
+        Limit: Math.min(limit, 100) * 10,
+    }));
+    return (result.Items ?? []).map((i) => (0, util_dynamodb_1.unmarshall)(i)).slice(0, limit);
+}
+async function removeSuppression(config, email) {
+    const db = getDynamo(config.region);
+    const pk = (0, shared_1.subscriberPK)(email);
+    // Delete suppression record
+    await db.send(new client_dynamodb_1.DeleteItemCommand({
+        TableName: config.tableName,
+        Key: (0, util_dynamodb_1.marshall)({ PK: pk, SK: shared_1.SUPPRESSION_SK }),
+    }));
+    // Clear suppressed flag on profile
+    await db.send(new client_dynamodb_1.UpdateItemCommand({
+        TableName: config.tableName,
+        Key: (0, util_dynamodb_1.marshall)({ PK: pk, SK: shared_1.PROFILE_SK }),
+        UpdateExpression: "SET suppressed = :val, updatedAt = :now",
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)({
+            ":val": false,
+            ":now": new Date().toISOString(),
+        }),
+    }));
+    return { removed: true };
+}
+//# sourceMappingURL=suppression.js.map

package/dist/tools/suppression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppression.js","sourceRoot":"","sources":["../../src/tools/suppression.ts"],"names":[],"mappings":";;AAiBA,wCAaC;AAED,8CA0BC;AA1DD,8DAKkC;AAClC,0DAA8D;AAC9D,sDAAqF;AAGrF,IAAI,MAAsB,CAAC;AAE3B,SAAS,SAAS,CAAC,MAAc;IAC/B,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,IAAI,gCAAc,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC;AAChB,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,MAAiB,EAAE,KAAa;IACnE,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEpC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAC1B,IAAI,6BAAW,CAAC;QACd,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,gBAAgB,EAAE,UAAU;QAC5B,yBAAyB,EAAE,IAAA,wBAAQ,EAAC,EAAE,KAAK,EAAE,uBAAc,EAAE,CAAC;QAC9D,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE;KACjC,CAAC,CACH,CAAC;IAEF,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,0BAAU,EAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACxE,CAAC;AAEM,KAAK,UAAU,iBAAiB,CAAC,MAAiB,EAAE,KAAa;IACtE,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,IAAA,qBAAY,EAAC,KAAK,CAAC,CAAC;IAE/B,4BAA4B;IAC5B,MAAM,EAAE,CAAC,IAAI,CACX,IAAI,mCAAiB,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,EAAE,IAAA,wBAAQ,EAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,uBAAc,EAAE,CAAC;KAC9C,CAAC,CACH,CAAC;IAEF,mCAAmC;IACnC,MAAM,EAAE,CAAC,IAAI,CACX,IAAI,mCAAiB,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,EAAE,IAAA,wBAAQ,EAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,mBAAU,EAAE,CAAC;QACzC,gBAAgB,EAAE,yCAAyC;QAC3D,yBAAyB,EAAE,IAAA,wBAAQ,EAAC;YAClC,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACjC,CAAC;KACH,CAAC,CACH,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/tools/system.d.ts

@@ -0,0 +1,20 @@
+import { ExecutionStatus } from "@aws-sdk/client-sfn";
+import type { McpConfig } from "../config.js";
+export declare function getFailedExecutions(config: McpConfig, stateMachineArn: string | undefined, startDate: string | undefined, limit: number): Promise<{
+    executionArn: string | undefined;
+    name: string | undefined;
+    startDate: string | undefined;
+    stopDate: string | undefined;
+    status: ExecutionStatus | undefined;
+}[] | {
+    error: string;
+}>;
+export declare function getDeliveryStats(config: McpConfig, startDate: string, endDate: string): Promise<{
+    period: {
+        startDate: string;
+        endDate: string;
+    };
+    counts: Record<string, number>;
+    total: number;
+}>;
+//# sourceMappingURL=system.d.ts.map

package/dist/tools/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAIxF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAe9C,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,MAAM;;;;;;;;GA8Bd;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;;;;GAiC3F"}

package/dist/tools/system.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFailedExecutions = getFailedExecutions;
+exports.getDeliveryStats = getDeliveryStats;
+const client_sfn_1 = require("@aws-sdk/client-sfn");
+const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
+const util_dynamodb_1 = require("@aws-sdk/util-dynamodb");
+const shared_1 = require("@step-func-emailer/shared");
+let sfn;
+let dynamo;
+function getSfn(region) {
+    if (!sfn)
+        sfn = new client_sfn_1.SFNClient({ region });
+    return sfn;
+}
+function getDynamo(region) {
+    if (!dynamo)
+        dynamo = new client_dynamodb_1.DynamoDBClient({ region });
+    return dynamo;
+}
+async function getFailedExecutions(config, stateMachineArn, startDate, limit) {
+    if (!stateMachineArn) {
+        return {
+            error: "stateMachineArn is required. Pass the ARN of the state machine to check.",
+        };
+    }
+    const sfnClient = getSfn(config.region);
+    const result = await sfnClient.send(new client_sfn_1.ListExecutionsCommand({
+        stateMachineArn,
+        statusFilter: client_sfn_1.ExecutionStatus.FAILED,
+        maxResults: Math.min(limit, 100),
+    }));
+    return (result.executions ?? [])
+        .filter((e) => {
+        if (!startDate)
+            return true;
+        return e.startDate && e.startDate >= new Date(startDate);
+    })
+        .map((e) => ({
+        executionArn: e.executionArn,
+        name: e.name,
+        startDate: e.startDate?.toISOString(),
+        stopDate: e.stopDate?.toISOString(),
+        status: e.status,
+    }));
+}
+async function getDeliveryStats(config, startDate, endDate) {
+    const db = getDynamo(config.region);
+    const result = await db.send(new client_dynamodb_1.ScanCommand({
+        TableName: config.eventsTableName,
+        FilterExpression: "SK BETWEEN :skStart AND :skEnd",
+        ExpressionAttributeValues: (0, util_dynamodb_1.marshall)({
+            ":skStart": `${shared_1.EVT_SK_PREFIX}${startDate}`,
+            ":skEnd": `${shared_1.EVT_SK_PREFIX}${endDate}~`,
+        }),
+    }));
+    const items = (result.Items ?? []).map((i) => (0, util_dynamodb_1.unmarshall)(i));
+    const counts = {
+        delivery: 0,
+        open: 0,
+        click: 0,
+        bounce: 0,
+        complaint: 0,
+    };
+    for (const item of items) {
+        const eventType = item.eventType;
+        if (eventType in counts)
+            counts[eventType]++;
+    }
+    return {
+        period: { startDate, endDate },
+        counts,
+        total: items.length,
+    };
+}
+//# sourceMappingURL=system.js.map

package/dist/tools/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":";;AAmBA,kDAkCC;AAED,4CAiCC;AAxFD,oDAAwF;AACxF,8DAAuE;AACvE,0DAA8D;AAC9D,sDAA0D;AAG1D,IAAI,GAAc,CAAC;AACnB,IAAI,MAAsB,CAAC;AAE3B,SAAS,MAAM,CAAC,MAAc;IAC5B,IAAI,CAAC,GAAG;QAAE,GAAG,GAAG,IAAI,sBAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,SAAS,CAAC,MAAc;IAC/B,IAAI,CAAC,MAAM;QAAE,MAAM,GAAG,IAAI,gCAAc,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC;AAChB,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACvC,MAAiB,EACjB,eAAmC,EACnC,SAA6B,EAC7B,KAAa;IAEb,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO;YACL,KAAK,EAAE,0EAA0E;SAClF,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAExC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CACjC,IAAI,kCAAqB,CAAC;QACxB,eAAe;QACf,YAAY,EAAE,4BAAe,CAAC,MAAM;QACpC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC;KACjC,CAAC,CACH,CAAC;IAEF,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;SAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACZ,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5B,OAAO,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE;QACrC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE;QACnC,MAAM,EAAE,CAAC,CAAC,MAAM;KACjB,CAAC,CAAC,CAAC;AACR,CAAC;AAEM,KAAK,UAAU,gBAAgB,CAAC,MAAiB,EAAE,SAAiB,EAAE,OAAe;IAC1F,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEpC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAC1B,IAAI,6BAAW,CAAC;QACd,SAAS,EAAE,MAAM,CAAC,eAAe;QACjC,gBAAgB,EAAE,gCAAgC;QAClD,yBAAyB,EAAE,IAAA,wBAAQ,EAAC;YAClC,UAAU,EAAE,GAAG,sBAAa,GAAG,SAAS,EAAE;YAC1C,QAAQ,EAAE,GAAG,sBAAa,GAAG,OAAO,GAAG;SACxC,CAAC;KACH,CAAC,CACH,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,0BAAU,EAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,MAAM,GAA2B;QACrC,QAAQ,EAAE,CAAC;QACX,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;QACT,SAAS,EAAE,CAAC;KACb,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAmB,CAAC;QAC3C,IAAI,SAAS,IAAI,MAAM;YAAE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;IAC/C,CAAC;IAED,OAAO;QACL,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE;QAC9B,MAAM;QACN,KAAK,EAAE,KAAK,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC"}

package/dist/tools/templates.d.ts

@@ -0,0 +1,23 @@
+import type { McpConfig } from "../config.js";
+export declare function listTemplates(config: McpConfig, prefix?: string): Promise<{
+    key: string | undefined;
+    size: number | undefined;
+    lastModified: string | undefined;
+}[]>;
+export declare function previewTemplate(config: McpConfig, templateKey: string, email: string): Promise<{
+    error: string;
+    html?: undefined;
+} | {
+    html: any;
+    error?: undefined;
+}>;
+export declare function validateTemplate(config: McpConfig, templateKey: string): Promise<{
+    valid: boolean;
+    templateKey: string;
+    error?: undefined;
+} | {
+    valid: boolean;
+    templateKey: string;
+    error: string;
+}>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/tools/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/tools/templates.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAgB9C,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM;;;;KAerE;AAgBD,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;;;GA4C1F;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM;;;;;;;;GAa5E"}

package/dist/tools/templates.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listTemplates = listTemplates;
+exports.previewTemplate = previewTemplate;
+exports.validateTemplate = validateTemplate;
+const client_s3_1 = require("@aws-sdk/client-s3");
+const liquidjs_1 = require("liquidjs");
+const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
+const util_dynamodb_1 = require("@aws-sdk/util-dynamodb");
+const shared_1 = require("@step-func-emailer/shared");
+let s3;
+let dynamo;
+const liquid = new liquidjs_1.Liquid();
+function getS3(region) {
+    if (!s3)
+        s3 = new client_s3_1.S3Client({ region });
+    return s3;
+}
+function getDynamo(region) {
+    if (!dynamo)
+        dynamo = new client_dynamodb_1.DynamoDBClient({ region });
+    return dynamo;
+}
+async function listTemplates(config, prefix) {
+    const s3Client = getS3(config.region);
+    const result = await s3Client.send(new client_s3_1.ListObjectsV2Command({
+        Bucket: config.templateBucketName,
+        Prefix: prefix,
+    }));
+    return (result.Contents ?? []).map((obj) => ({
+        key: obj.Key,
+        size: obj.Size,
+        lastModified: obj.LastModified?.toISOString(),
+    }));
+}
+async function fetchTemplate(config, templateKey) {
+    const s3Client = getS3(config.region);
+    const key = templateKey.endsWith(".html") ? templateKey : `${templateKey}.html`;
+    const result = await s3Client.send(new client_s3_1.GetObjectCommand({
+        Bucket: config.templateBucketName,
+        Key: key,
+    }));
+    return (await result.Body?.transformToString()) ?? "";
+}
+async function previewTemplate(config, templateKey, email) {
+    const db = getDynamo(config.region);
+    // Get subscriber profile for template variables
+    const profileResult = await db.send(new client_dynamodb_1.GetItemCommand({
+        TableName: config.tableName,
+        Key: (0, util_dynamodb_1.marshall)({ PK: (0, shared_1.subscriberPK)(email), SK: shared_1.PROFILE_SK }),
+    }));
+    const profile = profileResult.Item ? (0, util_dynamodb_1.unmarshall)(profileResult.Item) : null;
+    if (!profile) {
+        return { error: `Subscriber ${email} not found` };
+    }
+    const html = await fetchTemplate(config, templateKey);
+    const SYSTEM_KEYS = new Set([
+        "PK",
+        "SK",
+        "email",
+        "firstName",
+        "unsubscribed",
+        "suppressed",
+        "createdAt",
+        "updatedAt",
+    ]);
+    const profileAttrs = {};
+    for (const [key, value] of Object.entries(profile)) {
+        if (!SYSTEM_KEYS.has(key)) {
+            profileAttrs[key] = value;
+        }
+    }
+    const rendered = await liquid.parseAndRender(html, {
+        email: profile.email,
+        firstName: profile.firstName,
+        ...profileAttrs,
+        unsubscribeUrl: "https://example.com/unsubscribe?token=preview",
+        currentYear: new Date().getFullYear(),
+    });
+    return { html: rendered };
+}
+async function validateTemplate(config, templateKey) {
+    const html = await fetchTemplate(config, templateKey);
+    try {
+        await liquid.parse(html);
+        return { valid: true, templateKey };
+    }
+    catch (err) {
+        return {
+            valid: false,
+            templateKey,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+//# sourceMappingURL=templates.js.map

package/dist/tools/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/tools/templates.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@step-func-emailer/mcp",
+  "version": "0.2.0",
+  "description": "MCP server for step-func-emailer — subscriber management, engagement analytics, and system health",
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mdwt/step-func-emailer.git",
+    "directory": "packages/mcp"
+  },
+  "bin": {
+    "step-func-emailer-mcp": "dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@aws-sdk/client-dynamodb": "^3.1009.0",
+    "@aws-sdk/client-s3": "^3.1009.0",
+    "@aws-sdk/client-sfn": "^3.1009.0",
+    "@aws-sdk/util-dynamodb": "^3.996.2",
+    "liquidjs": "^10.25.0",
+    "zod": "^3.25.67",
+    "@step-func-emailer/shared": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "lint": "eslint src"
+  }
+}