dtc-mcp 0.2.0 → 1.0.0

package/dist/tools/execute_code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute_code.js","sourceRoot":"","sources":["../../src/tools/execute_code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,MAAM,SAAS,GAAG;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACvB,uZAAuZ,CACxZ;CACF,CAAC;AAEF,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BnB,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,IAAI,CACT,cAAc,EACd,WAAW,EACX,SAAS,EACT;QACE,KAAK,EAAE,0BAA0B;QACjC,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,IAAI;KACpB,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACvC,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAErD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CACzB;YACE,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YACpE,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG,CAAC,MAAM,CAAC,YAAY;gBACrB,CAAC,CAAC;oBACE,YAAY,EAAE,IAAI;oBAClB,gBAAgB,EACd,8SAA8S;iBACjT;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,EACD,IAAI,EACJ,CAAC,CACF,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACjC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE;SACpB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/{platforms/shopify/tools.d.ts → tools/read_doc.d.ts}

@@ -1,2 +1,2 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerShopifyTools(server: McpServer): void;
+export declare function registerReadDoc(server: McpServer): void;

package/dist/tools/read_doc.js

@@ -0,0 +1,70 @@
+import { z } from "zod";
+import { readById, listPaths } from "../docs/search.js";
+const readDocShape = {
+    path: z
+        .string()
+        .optional()
+        .describe("Exact chunk ID to fetch (e.g. 'klaviyo.reporting.campaignValues', 'guide.output-discipline'). Omit to list all available paths."),
+    platform: z
+        .enum(["klaviyo", "shopify", "guide"])
+        .optional()
+        .describe("When listing (no `path`), filter to one platform's docs only."),
+};
+const description = `
+Fetch a specific SDK docs chunk by exact path, or list all available paths when called with no args.
+
+Use this instead of search_docs when you already know the chunk ID — it's cheaper and more deterministic.
+Common patterns:
+  • read_doc({}) → list every chunk ID with one-line summaries (use this once at the start of a session to map the SDK surface)
+  • read_doc({ path: "klaviyo.reporting.campaignValues" }) → fetch one method's full doc (signature + JSDoc + example) verbatim
+  • read_doc({ platform: "shopify" }) → list only Shopify chunk IDs
+
+This adopts the "filesystem-as-API" pattern from Anthropic's Code Execution with MCP research: LLMs are faster and more accurate when they can read a typed-source-of-truth doc page directly, rather than re-searching for it on every code generation.
+`.trim();
+export function registerReadDoc(server) {
+    server.tool("read_doc", description, readDocShape, {
+        title: "Read SDK doc by path",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    }, async ({ path, platform }) => {
+        if (path) {
+            const { version, found, chunk } = await readById(path);
+            const text = JSON.stringify({
+                docsVersion: version,
+                found,
+                chunk: chunk
+                    ? {
+                        id: chunk.id,
+                        title: chunk.title,
+                        platform: chunk.platform,
+                        category: chunk.category,
+                        summary: chunk.summary,
+                        content: chunk.content,
+                        tags: chunk.tags,
+                    }
+                    : null,
+                ...(found
+                    ? {}
+                    : {
+                        hint: "Path not found. Use read_doc({}) to list all paths, or search_docs to find by query.",
+                    }),
+            }, null, 2);
+            return {
+                content: [{ type: "text", text }],
+                isError: !found,
+            };
+        }
+        const { version, count, paths } = await listPaths({ platform });
+        const text = JSON.stringify({
+            docsVersion: version,
+            count,
+            paths,
+        }, null, 2);
+        return {
+            content: [{ type: "text", text }],
+        };
+    });
+}
+//# sourceMappingURL=read_doc.js.map

package/dist/tools/read_doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read_doc.js","sourceRoot":"","sources":["../../src/tools/read_doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,YAAY,GAAG;IACnB,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iIAAiI,CAClI;IACH,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;SACrC,QAAQ,EAAE;SACV,QAAQ,CACP,+DAA+D,CAChE;CACJ,CAAC;AAEF,MAAM,WAAW,GAAG;;;;;;;;;;CAUnB,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,IAAI,CACT,UAAU,EACV,WAAW,EACX,YAAY,EACZ;QACE,KAAK,EAAE,sBAAsB;QAC7B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACrB,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC3B,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YACvD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CACzB;gBACE,WAAW,EAAE,OAAO;gBACpB,KAAK;gBACL,KAAK,EAAE,KAAK;oBACV,CAAC,CAAC;wBACE,EAAE,EAAE,KAAK,CAAC,EAAE;wBACZ,KAAK,EAAE,KAAK,CAAC,KAAK;wBAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;qBACjB;oBACH,CAAC,CAAC,IAAI;gBACR,GAAG,CAAC,KAAK;oBACP,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC;wBACE,IAAI,EAAE,sFAAsF;qBAC7F,CAAC;aACP,EACD,IAAI,EACJ,CAAC,CACF,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACjC,OAAO,EAAE,CAAC,KAAK;aAChB,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CACzB;YACE,WAAW,EAAE,OAAO;YACpB,KAAK;YACL,KAAK;SACN,EACD,IAAI,EACJ,CAAC,CACF,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAClC,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/search_docs.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSearchDocs(server: McpServer): void;

package/dist/tools/search_docs.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { search } from "../docs/search.js";
+const searchShape = {
+    query: z.string().describe("Natural-language or keyword query. Examples: 'list campaigns', 'shopifyql sales last 30 days', 'flow reporting', 'get conversion metric id'."),
+    platform: z
+        .enum(["klaviyo", "shopify"])
+        .optional()
+        .describe("Filter to one platform's docs."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(20)
+        .optional()
+        .describe("Max results to return (default 5)."),
+};
+const description = `
+Search the bundled SDK reference docs for Klaviyo and Shopify methods exposed inside the
+execute_code sandbox. Returns ranked markdown chunks: method signatures, parameter
+descriptions, and runnable code examples.
+
+Use this BEFORE writing code in execute_code — the SDK surface is constrained to
+registered methods (escape hatches are 'klaviyo.get/post/paginate' and 'shopify.gql/ql').
+
+The docs index is refreshed daily from a CDN-backed source repo, so new Klaviyo/Shopify
+API revisions land without requiring a new MCP release.
+`.trim();
+export function registerSearchDocs(server) {
+    server.tool("search_docs", description, searchShape, {
+        title: "Search SDK docs",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    }, async ({ query, platform, limit }) => {
+        const { version, hits } = await search(query, { platform, limit });
+        const text = JSON.stringify({
+            query,
+            docsVersion: version,
+            hits: hits.map((h) => ({
+                id: h.id,
+                title: h.title,
+                platform: h.platform,
+                category: h.category,
+                summary: h.summary,
+                content: h.content,
+                score: Math.round(h.score * 100) / 100,
+            })),
+        }, null, 2);
+        return {
+            content: [{ type: "text", text }],
+        };
+    });
+}
+//# sourceMappingURL=search_docs.js.map

package/dist/tools/search_docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_docs.js","sourceRoot":"","sources":["../../src/tools/search_docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACxB,8IAA8I,CAC/I;IACD,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;SAC5B,QAAQ,EAAE;SACV,QAAQ,CAAC,gCAAgC,CAAC;IAC7C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;CAClD,CAAC;AAEF,MAAM,WAAW,GAAG;;;;;;;;;;CAUnB,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,IAAI,CACT,aAAa,EACb,WAAW,EACX,WAAW,EACX;QACE,KAAK,EAAE,iBAAiB;QACxB,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACrB,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QACnC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CACzB;YACE,KAAK;YACL,WAAW,EAAE,OAAO;YACpB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACrB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG;aACvC,CAAC,CAAC;SACJ,EACD,IAAI,EACJ,CAAC,CACF,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAClC,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dtc-mcp",
-  "version": "0.2.0",
-  "description": "Context-optimized MCP server for DTC e-commerce brands (Klaviyo + Shopify). 80% less context usage than raw API wrappers.",
+  "version": "1.0.0",
+  "description": "Code-execution MCP server for Klaviyo + Shopify analytics. The LLM writes TypeScript against typed SDKs in a stateful V8 sandbox — three composable tools instead of dozens.",
   "type": "module",
   "bin": {
     "dtc-mcp": "dist/index.js"
@@ -13,7 +13,11 @@
     "start": "node dist/index.js",
     "test": "vitest run",
     "test:watch": "vitest",
-    "inspect": "npx @modelcontextprotocol/inspector dist/index.js"
+    "inspect": "npx @modelcontextprotocol/inspector dist/index.js",
+    "codegen:klaviyo": "tsx tools/codegen/klaviyo.ts",
+    "codegen:shopify": "tsx tools/codegen/shopify.ts",
+    "codegen:docs": "tsx tools/codegen/docs.ts",
+    "codegen": "npm run codegen:klaviyo && npm run codegen:shopify && npm run codegen:docs"
   },
   "keywords": [
     "mcp",
@@ -21,8 +25,10 @@
     "shopify",
     "dtc",
     "ecommerce",
-    "analytics",
-    "context-optimized"
+    "code-execution",
+    "sandbox",
+    "stainless",
+    "code-mode"
   ],
   "author": "Rafael Sztutman",
   "license": "MIT",
@@ -36,6 +42,7 @@
   },
   "files": [
     "dist",
+    "data",
     "README.md",
     "LICENSE"
   ],
@@ -45,10 +52,14 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.0",
     "dotenv": "^17.3.1",
+    "isolated-vm": "^6.1.2",
+    "minisearch": "^7.1.0",
+    "sucrase": "^3.35.0",
     "zod": "^3.23.8"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "tsx": "^4.19.0",
     "typescript": "^5.5.0",
     "vitest": "^2.0.0"
   }

package/dist/cross-platform/correlator.d.ts

@@ -1,10 +0,0 @@
-import type { RevenueAttribution, Dashboard } from "../shared/types.js";
-/**
- * Compare Klaviyo attributed revenue vs Shopify total revenue.
- */
-export declare function computeRevenueAttribution(days: number): Promise<RevenueAttribution>;
-/**
- * Orchestrate a complete DTC health dashboard.
- * Uses cached results from sub-queries to minimize API calls.
- */
-export declare function computeDashboard(days: number): Promise<Dashboard>;

package/dist/cross-platform/correlator.js

@@ -1,166 +0,0 @@
-import { isShopifyConfigured } from "../config.js";
-import { getCampaignReport, getFlowReport } from "../platforms/klaviyo/client.js";
-import { getAggregatedSales } from "../platforms/shopify/client.js";
-/**
- * Compare Klaviyo attributed revenue vs Shopify total revenue.
- */
-export async function computeRevenueAttribution(days) {
-    // Fetch Klaviyo campaign + flow revenue (uses cached reporting data)
-    const [campaignRows, flowRows] = await Promise.all([
-        getCampaignReport(days),
-        getFlowReport(days),
-    ]);
-    // Sum campaign revenue
-    let campaignRevenue = 0;
-    const campaignRevenueMap = new Map();
-    for (const row of campaignRows) {
-        const revenue = row.statistics.conversion_value ?? 0;
-        const id = String(row.groupings.campaign_id ?? "unknown");
-        campaignRevenue += revenue;
-        const existing = campaignRevenueMap.get(id);
-        if (existing) {
-            existing.revenue += revenue;
-        }
-        else {
-            campaignRevenueMap.set(id, { name: id, revenue });
-        }
-    }
-    // Sum flow revenue
-    let flowRevenue = 0;
-    const flowRevenueMap = new Map();
-    for (const row of flowRows) {
-        const revenue = row.statistics.conversion_value ?? 0;
-        const id = String(row.groupings.flow_id ?? "unknown");
-        flowRevenue += revenue;
-        const existing = flowRevenueMap.get(id);
-        if (existing) {
-            existing.revenue += revenue;
-        }
-        else {
-            flowRevenueMap.set(id, { name: id, revenue });
-        }
-    }
-    const emailTotalRevenue = campaignRevenue + flowRevenue;
-    // Get Shopify total revenue
-    let totalRevenue = emailTotalRevenue;
-    if (isShopifyConfigured()) {
-        try {
-            const sales = await getAggregatedSales(days);
-            totalRevenue = sales.netRevenue || emailTotalRevenue;
-        }
-        catch {
-            // Shopify unavailable — use email revenue as total
-        }
-    }
-    const emailPct = totalRevenue > 0
-        ? Math.round((emailTotalRevenue / totalRevenue) * 10000) / 100
-        : 0;
-    const topCampaigns = Array.from(campaignRevenueMap.values())
-        .sort((a, b) => b.revenue - a.revenue)
-        .slice(0, 5);
-    const topFlows = Array.from(flowRevenueMap.values())
-        .sort((a, b) => b.revenue - a.revenue)
-        .slice(0, 5);
-    return {
-        period_days: days,
-        total_revenue: Math.round(totalRevenue * 100) / 100,
-        email_campaign_revenue: Math.round(campaignRevenue * 100) / 100,
-        flow_revenue: Math.round(flowRevenue * 100) / 100,
-        email_total_revenue: Math.round(emailTotalRevenue * 100) / 100,
-        email_pct_of_total: emailPct,
-        flow_vs_campaign_split: {
-            campaign_pct: emailTotalRevenue > 0
-                ? Math.round((campaignRevenue / emailTotalRevenue) * 10000) / 100
-                : 0,
-            flow_pct: emailTotalRevenue > 0
-                ? Math.round((flowRevenue / emailTotalRevenue) * 10000) / 100
-                : 0,
-        },
-        top_revenue_campaigns: topCampaigns,
-        top_revenue_flows: topFlows,
-        note: "Revenue attribution uses Klaviyo's send-date model. Actual overlap with Shopify revenue may vary.",
-    };
-}
-/**
- * Orchestrate a complete DTC health dashboard.
- * Uses cached results from sub-queries to minimize API calls.
- */
-export async function computeDashboard(days) {
-    // Run Klaviyo queries in parallel (these hit cache if recent calls were made)
-    const [campaignRows, flowRows] = await Promise.all([
-        getCampaignReport(days),
-        getFlowReport(days),
-    ]);
-    // Sum email revenue
-    let campaignRevenue = 0;
-    const topCampaigns = [];
-    const campaignMap = new Map();
-    for (const row of campaignRows) {
-        const id = String(row.groupings.campaign_id ?? "");
-        const existing = campaignMap.get(id) ?? { revenue: 0, opens: 0, recipients: 0 };
-        existing.revenue += row.statistics.conversion_value ?? 0;
-        existing.opens += row.statistics.opens_unique ?? row.statistics.opens ?? 0;
-        existing.recipients += row.statistics.recipients ?? 0;
-        campaignMap.set(id, existing);
-        campaignRevenue += row.statistics.conversion_value ?? 0;
-    }
-    for (const [name, stats] of campaignMap.entries()) {
-        topCampaigns.push({
-            name,
-            revenue: Math.round(stats.revenue * 100) / 100,
-            open_rate: stats.recipients > 0
-                ? Math.round((stats.opens / stats.recipients) * 10000) / 10000
-                : 0,
-        });
-    }
-    topCampaigns.sort((a, b) => b.revenue - a.revenue);
-    let flowRevenue = 0;
-    const topFlows = [];
-    const flowMap = new Map();
-    for (const row of flowRows) {
-        const id = String(row.groupings.flow_id ?? "");
-        flowMap.set(id, (flowMap.get(id) ?? 0) + (row.statistics.conversion_value ?? 0));
-        flowRevenue += row.statistics.conversion_value ?? 0;
-    }
-    for (const [name, revenue] of flowMap.entries()) {
-        topFlows.push({ name, revenue: Math.round(revenue * 100) / 100 });
-    }
-    topFlows.sort((a, b) => b.revenue - a.revenue);
-    const emailRevenue = campaignRevenue + flowRevenue;
-    // Shopify sales
-    let shopifyRevenue = emailRevenue;
-    let orderCount = 0;
-    let aov = 0;
-    if (isShopifyConfigured()) {
-        try {
-            const sales = await getAggregatedSales(days);
-            shopifyRevenue = sales.netRevenue || emailRevenue;
-            orderCount = sales.orderCount;
-            aov = orderCount > 0 ? Math.round((shopifyRevenue / orderCount) * 100) / 100 : 0;
-        }
-        catch {
-            // Shopify unavailable
-        }
-    }
-    return {
-        period_days: days,
-        sales: {
-            revenue: Math.round(shopifyRevenue * 100) / 100,
-            orders: orderCount,
-            aov,
-        },
-        email: {
-            email_revenue: Math.round(emailRevenue * 100) / 100,
-            email_pct_of_total: shopifyRevenue > 0
-                ? Math.round((emailRevenue / shopifyRevenue) * 10000) / 100
-                : 0,
-            top_campaigns: topCampaigns.slice(0, 5),
-            top_flows: topFlows.slice(0, 5),
-        },
-        subscribers: {
-            total: 0, // Would require a separate API call — omit to save rate limits
-            list_count: 0,
-        },
-    };
-}
-//# sourceMappingURL=correlator.js.map

package/dist/cross-platform/correlator.js.map

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

package/dist/cross-platform/tools.d.ts

@@ -1,2 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerCrossPlatformTools(server: McpServer): void;

package/dist/cross-platform/tools.js

@@ -1,30 +0,0 @@
-import { z } from "zod";
-import { computeRevenueAttribution, computeDashboard } from "./correlator.js";
-import { formatError, toolResult } from "../shared/errors.js";
-export function registerCrossPlatformTools(server) {
-    // ---- Tool 15: Email Revenue Attribution ----
-    server.tool("dtc_email_revenue_attribution", "Email/SMS revenue vs total Shopify revenue. Shows email marketing contribution.", {
-        days: z.number().min(1).max(365).default(30),
-    }, async ({ days }) => {
-        try {
-            const result = await computeRevenueAttribution(days);
-            return toolResult(result);
-        }
-        catch (error) {
-            return formatError(error);
-        }
-    });
-    // ---- Tool 16: DTC Dashboard ----
-    server.tool("dtc_dashboard", "Complete DTC health dashboard: sales + email + subscriber metrics in one call.", {
-        days: z.number().min(7).max(90).default(30),
-    }, async ({ days }) => {
-        try {
-            const result = await computeDashboard(days);
-            return toolResult(result);
-        }
-        catch (error) {
-            return formatError(error);
-        }
-    });
-}
-//# sourceMappingURL=tools.js.map

package/dist/cross-platform/tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/cross-platform/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE9D,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,+CAA+C;IAC/C,MAAM,CAAC,IAAI,CACT,+BAA+B,EAC/B,iFAAiF,EACjF;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;KAC7C,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,IAAI,CAAC,CAAC;YACrD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,mCAAmC;IACnC,MAAM,CAAC,IAAI,CACT,eAAe,EACf,gFAAgF,EAChF;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;KAC5C,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/platforms/klaviyo/client.d.ts

@@ -1,91 +0,0 @@
-import type { RateLimitTier } from "../../shared/types.js";
-/**
- * GET request to Klaviyo API with rate limiting and sparse fieldsets.
- */
-export declare function klaviyoGet(path: string, params?: Record<string, string>, tier?: RateLimitTier): Promise<{
-    data: Array<{
-        id: string;
-        attributes: Record<string, unknown>;
-        relationships?: Record<string, unknown>;
-    }>;
-    links?: {
-        self?: string;
-        next?: string;
-        prev?: string;
-    };
-    included?: Array<{
-        id: string;
-        type: string;
-        attributes: Record<string, unknown>;
-    }>;
-}>;
-/**
- * POST request to Klaviyo API (primarily for reporting endpoints).
- * Results are cached with 10-minute TTL for reporting tier.
- */
-export declare function klaviyoPost(path: string, body: Record<string, unknown>, tier?: RateLimitTier): Promise<{
-    results: Array<{
-        groupings: Record<string, unknown>;
-        statistics: Record<string, number>;
-    }>;
-}>;
-/**
- * Auto-paginate a Klaviyo GET endpoint.
- * Returns all items up to maxPages pages.
- */
-export declare function klaviyoPaginateAll(path: string, params?: Record<string, string>, maxPages?: number, tier?: RateLimitTier): Promise<Array<{
-    id: string;
-    attributes: Record<string, unknown>;
-    relationships?: Record<string, unknown>;
-}>>;
-/**
- * Fetch a single page with an opaque cursor.
- * Used by tools that expose pagination to the LLM.
- */
-export declare function klaviyoGetPage(path: string, params: Record<string, string>, cursor?: string, tier?: RateLimitTier): Promise<{
-    data: Array<{
-        id: string;
-        attributes: Record<string, unknown>;
-        relationships?: Record<string, unknown>;
-    }>;
-    links?: {
-        self?: string;
-        next?: string;
-        prev?: string;
-    };
-    included?: Array<{
-        id: string;
-        type: string;
-        attributes: Record<string, unknown>;
-    }>;
-}>;
-/**
- * Get the "Placed Order" metric ID for use in reporting requests.
- * Cached for server lifetime.
- *
- * Discovery strategy (name is not filterable in 2026-01-15 revision):
- * 1. Check KLAVIYO_CONVERSION_METRIC_ID env var
- * 2. Fetch all metrics, search by exact name ("Placed Order", etc.)
- * 3. Fuzzy fallback excluding refund/cancel metrics
- */
-export declare function getConversionMetricId(): Promise<string>;
-/**
- * Build timeframe object for Klaviyo reporting API.
- */
-export declare function buildTimeframe(days: number): Record<string, unknown>;
-/**
- * Fetch campaign reporting data.
- * Uses reporting tier rate limiting and caching.
- */
-export declare function getCampaignReport(days: number, campaignIds?: string[]): Promise<Array<{
-    groupings: Record<string, unknown>;
-    statistics: Record<string, number>;
-}>>;
-/**
- * Fetch flow reporting data.
- * Uses reporting tier rate limiting and caching.
- */
-export declare function getFlowReport(days: number, flowIds?: string[]): Promise<Array<{
-    groupings: Record<string, unknown>;
-    statistics: Record<string, number>;
-}>>;