@apex-inc/mcp-server 0.39.0 → 0.41.0

package/dist/tools/ad-platforms.d.ts

@@ -0,0 +1,240 @@
+/**
+ * Ad platforms: the buyer lists Apex keeps on Meta, Google and LinkedIn, and
+ * the shop's own events it sends them. Same routes as Attribution → Ad
+ * platforms.
+ * A held-back list that belongs to an Ad holdout is the experiment's; these
+ * tools leave it alone and point at the experiment.
+ */
+import { z } from "zod";
+declare const SEND_MEANINGS: readonly ["purchase", "lead", "signup", "subscription", "add_to_cart", "something_else"];
+declare const LIST_GOALS: readonly ["win_back", "stop_paying", "interested", "lookalike"];
+export declare const adPlatformTools: {
+    list_audiences: {
+        description: string;
+        schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        handler: () => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    update_audience: {
+        description: string;
+        schema: z.ZodObject<{
+            audience_id: z.ZodString;
+            platforms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            holdout_percent: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<5>, z.ZodLiteral<10>, z.ZodLiteral<20>]>>;
+            confirm_delete: z.ZodOptional<z.ZodLiteral<true>>;
+        }, "strip", z.ZodTypeAny, {
+            audience_id: string;
+            platforms?: string[] | undefined;
+            holdout_percent?: 0 | 5 | 10 | 20 | undefined;
+            confirm_delete?: true | undefined;
+        }, {
+            audience_id: string;
+            platforms?: string[] | undefined;
+            holdout_percent?: 0 | 5 | 10 | 20 | undefined;
+            confirm_delete?: true | undefined;
+        }>;
+        handler: (args: {
+            audience_id: string;
+            platforms?: string[];
+            holdout_percent?: 0 | 5 | 10 | 20;
+            confirm_delete?: true;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    remove_audience: {
+        description: string;
+        schema: z.ZodObject<{
+            audience_id: z.ZodString;
+            confirm: z.ZodLiteral<true>;
+        }, "strip", z.ZodTypeAny, {
+            audience_id: string;
+            confirm: true;
+        }, {
+            audience_id: string;
+            confirm: true;
+        }>;
+        handler: (args: {
+            audience_id: string;
+            confirm: true;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    list_audience_removals: {
+        description: string;
+        schema: z.ZodObject<{
+            audience_id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            audience_id?: string | undefined;
+        }, {
+            audience_id?: string | undefined;
+        }>;
+        handler: (args: {
+            audience_id?: string;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    retry_audience_removals: {
+        description: string;
+        schema: z.ZodObject<{
+            audience_id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            audience_id: string;
+        }, {
+            audience_id: string;
+        }>;
+        handler: (args: {
+            audience_id: string;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    list_audience_goals: {
+        description: string;
+        schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        handler: () => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    add_audience: {
+        description: string;
+        schema: z.ZodObject<{
+            goal: z.ZodEnum<["win_back", "stop_paying", "interested", "lookalike"]>;
+            platforms: z.ZodOptional<z.ZodArray<z.ZodEnum<["meta-ads", "google-ads", "linkedin-ads"]>, "many">>;
+            name: z.ZodOptional<z.ZodString>;
+            send_now: z.ZodOptional<z.ZodBoolean>;
+            confirm: z.ZodLiteral<true>;
+        }, "strip", z.ZodTypeAny, {
+            goal: "win_back" | "stop_paying" | "interested" | "lookalike";
+            confirm: true;
+            name?: string | undefined;
+            platforms?: ("meta-ads" | "google-ads" | "linkedin-ads")[] | undefined;
+            send_now?: boolean | undefined;
+        }, {
+            goal: "win_back" | "stop_paying" | "interested" | "lookalike";
+            confirm: true;
+            name?: string | undefined;
+            platforms?: ("meta-ads" | "google-ads" | "linkedin-ads")[] | undefined;
+            send_now?: boolean | undefined;
+        }>;
+        handler: (args: {
+            goal: (typeof LIST_GOALS)[number];
+            platforms?: string[];
+            name?: string;
+            send_now?: boolean;
+            confirm: true;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    preview_ad_platform_send: {
+        description: string;
+        schema: z.ZodObject<{
+            event_name: z.ZodString;
+            meaning: z.ZodEnum<["purchase", "lead", "signup", "subscription", "add_to_cart", "something_else"]>;
+        }, "strip", z.ZodTypeAny, {
+            event_name: string;
+            meaning: "purchase" | "subscription" | "lead" | "signup" | "add_to_cart" | "something_else";
+        }, {
+            event_name: string;
+            meaning: "purchase" | "subscription" | "lead" | "signup" | "add_to_cart" | "something_else";
+        }>;
+        handler: (args: {
+            event_name: string;
+            meaning: (typeof SEND_MEANINGS)[number];
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    list_ad_platform_sends: {
+        description: string;
+        schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        handler: () => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    add_ad_platform_send: {
+        description: string;
+        schema: z.ZodObject<{
+            event_name: z.ZodString;
+            meaning: z.ZodEnum<["purchase", "lead", "signup", "subscription", "add_to_cart", "something_else"]>;
+            send_value: z.ZodOptional<z.ZodBoolean>;
+            name: z.ZodOptional<z.ZodString>;
+            confirm: z.ZodLiteral<true>;
+        }, "strip", z.ZodTypeAny, {
+            event_name: string;
+            confirm: true;
+            meaning: "purchase" | "subscription" | "lead" | "signup" | "add_to_cart" | "something_else";
+            name?: string | undefined;
+            send_value?: boolean | undefined;
+        }, {
+            event_name: string;
+            confirm: true;
+            meaning: "purchase" | "subscription" | "lead" | "signup" | "add_to_cart" | "something_else";
+            name?: string | undefined;
+            send_value?: boolean | undefined;
+        }>;
+        handler: (args: {
+            event_name: string;
+            meaning: (typeof SEND_MEANINGS)[number];
+            send_value?: boolean;
+            name?: string;
+            confirm: true;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+    remove_ad_platform_send: {
+        description: string;
+        schema: z.ZodObject<{
+            send_id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            send_id: string;
+        }, {
+            send_id: string;
+        }>;
+        handler: (args: {
+            send_id: string;
+        }) => Promise<{
+            content: {
+                type: "text";
+                text: string;
+            }[];
+        }>;
+    };
+};
+export {};
+//# sourceMappingURL=ad-platforms.d.ts.map

package/dist/tools/ad-platforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ad-platforms.d.ts","sourceRoot":"","sources":["../../src/tools/ad-platforms.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,QAAA,MAAM,aAAa,0FAA2F,CAAC;AAK/G,QAAA,MAAM,UAAU,iEAAkE,CAAC;AA8DnF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAoDF;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;YACrB,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;YAClC,cAAc,CAAC,EAAE,IAAI,CAAC;SACvB;;;;;;;;;;;;;;;;;;;wBAgEqB;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,IAAI,CAAA;SAAE;;;;;;;;;;;;;;;;wBAwBtC;YAAE,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;wBAexB;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAuCvB;YACpB,IAAI,EAAE,CAAC,OAAO,UAAU,EAAE,MAAM,CAAC,CAAC;YAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;YACrB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,OAAO,EAAE,IAAI,CAAC;SACf;;;;;;;;;;;;;;;;;;;wBA6CqB;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,CAAC,OAAO,aAAa,EAAE,MAAM,CAAC,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA6B/D;YACpB,UAAU,EAAE,MAAM,CAAC;YACnB,OAAO,EAAE,CAAC,OAAO,aAAa,EAAE,MAAM,CAAC,CAAC;YACxC,UAAU,CAAC,EAAE,OAAO,CAAC;YACrB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,OAAO,EAAE,IAAI,CAAC;SACf;;;;;;;;;;;;;;;;wBAgBqB;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE;;;;;;;CAO5C,CAAC"}

package/dist/tools/ad-platforms.js

@@ -0,0 +1,294 @@
+/**
+ * Ad platforms: the buyer lists Apex keeps on Meta, Google and LinkedIn, and
+ * the shop's own events it sends them. Same routes as Attribution → Ad
+ * platforms.
+ * A held-back list that belongs to an Ad holdout is the experiment's; these
+ * tools leave it alone and point at the experiment.
+ */
+import { z } from "zod";
+import { apiDeleteJson, apiGet, apiPatch, apiPost } from "../api-client.js";
+import { resolveMeasurementNetwork } from "../setup-catchup-tools.js";
+import { APEX } from "../tool-shared.js";
+const SEND_MEANINGS = ["purchase", "lead", "signup", "subscription", "add_to_cart", "something_else"];
+/** The platforms that take lists today. */
+const LIST_PLATFORMS = ["meta-ads", "google-ads", "linkedin-ads"];
+const LIST_GOALS = ["win_back", "stop_paying", "interested", "lookalike"];
+function jsonResult(data, error = null) {
+    return { content: [{ type: "text", text: JSON.stringify({ data, error }, null, 2) }] };
+}
+function reachedPlatforms(a) {
+    return Object.entries(a.destinations ?? {})
+        .filter(([, d]) => Boolean(d?.platformAudienceId))
+        .map(([network]) => network);
+}
+async function loadList(id) {
+    try {
+        const res = await apiGet(`/api/audience-activations/${encodeURIComponent(id)}`);
+        return res.data ?? null;
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes("404"))
+            return null;
+        throw err;
+    }
+}
+function removalRow(r) {
+    return {
+        audience_id: r.activationId,
+        platform: r.network,
+        owed: r.owed,
+        stopped_retrying: r.stuck,
+        why: r.blockReason === "credentials_pending"
+            ? "not_connected"
+            : r.blockReason === "not_implemented" || r.blockReason === "no_adapter"
+                ? "platform_cant_remove_yet"
+                : "platform_refused",
+        platform_said: r.message ?? null,
+    };
+}
+const HOLDOUT_OWNED = "This held-back list belongs to an Ad holdout experiment. Stop or archive the experiment (pause_experiment / archive_experiment) and Apex takes the list down with it.";
+export const adPlatformTools = {
+    list_audiences: {
+        description: `${APEX} — List the buyer lists Apex keeps on the shop's ad platforms: which segment each is built from, which platforms it goes to, which platforms it actually reached, and how many people it holds back. Same as Attribution → Ad platforms → Who sees your ads.`,
+        schema: z.object({}),
+        handler: async () => {
+            const [lists, segments] = await Promise.all([
+                apiGet("/api/audience-activations"),
+                apiGet("/api/segments?scope=workspace").catch(() => ({
+                    data: [],
+                })),
+            ]);
+            const names = new Map((segments.data ?? []).map((s) => [s.id, s.name]));
+            const data = (lists.data ?? [])
+                .filter((a) => !a.archivedAt)
+                .map((a) => ({
+                audience_id: a.id,
+                segment: names.get(a.segmentId) ?? a.segmentId,
+                kind: a.kind,
+                goal: a.goal ?? null,
+                platforms: a.platformTargets,
+                reached: reachedPlatforms(a),
+                holdout_percent: a.holdoutPercent ?? 0,
+                created_at: a.createdAt,
+            }));
+            return jsonResult(data);
+        },
+    },
+    update_audience: {
+        description: `${APEX} — Change where a buyer list goes, or how many of its people Apex holds back from the ads. holdout_percent 0 stops holding anyone back. Dropping a platform the list already reached deletes the list on that platform, which cannot be undone, and any ad set using it loses it: ask the shop first and pass confirm_delete only after they said yes. Without it, Apex changes nothing and says which platforms would lose the list. Held-back lists that belong to an Ad holdout can't be changed here.`,
+        schema: z.object({
+            audience_id: z.string().describe("From list_audiences."),
+            platforms: z
+                .array(z.string())
+                .min(1)
+                .optional()
+                .describe("Every platform the list should go to: meta-ads, google-ads, linkedin-ads (or meta / google / linkedin)."),
+            holdout_percent: z
+                .union([z.literal(0), z.literal(5), z.literal(10), z.literal(20)])
+                .optional()
+                .describe("Share of the list's people kept out of the ads: 0, 5, 10 or 20, the same choices as the list card. 0 stops holding anyone back."),
+            confirm_delete: z
+                .literal(true)
+                .optional()
+                .describe("Only after the shop said yes to deleting the list on every platform it already reached that platforms leaves out."),
+        }),
+        handler: async (args) => {
+            if (args.platforms === undefined && args.holdout_percent === undefined) {
+                return jsonResult(null, "Pass platforms, holdout_percent, or both.");
+            }
+            const list = await loadList(args.audience_id);
+            if (!list)
+                return jsonResult(null, "No buyer list with that id in this workspace. Use list_audiences.");
+            if (list.kind === "holdout")
+                return jsonResult(null, HOLDOUT_OWNED);
+            const body = {};
+            let dropped = [];
+            if (args.platforms) {
+                const platforms = [...new Set(args.platforms.map(resolveMeasurementNetwork))];
+                const unknown = platforms.filter((p) => !LIST_PLATFORMS.includes(p));
+                if (unknown.length > 0) {
+                    return jsonResult(null, `Lists go to ${LIST_PLATFORMS.join(", ")} only. Not a list platform: ${unknown.join(", ")}.`);
+                }
+                body.platformTargets = platforms;
+                dropped = reachedPlatforms(list).filter((p) => !platforms.includes(p));
+            }
+            if (dropped.length > 0 && args.confirm_delete !== true) {
+                return jsonResult({ audience_id: args.audience_id, would_delete_from: dropped }, `The list is already on ${dropped.join(", ")}. Leaving it out deletes the list there, and ad sets using it lose it. Nothing changed. Ask the shop, then pass confirm_delete: true.`);
+            }
+            if (args.holdout_percent !== undefined)
+                body.holdoutPercent = args.holdout_percent;
+            const removedFrom = [];
+            const refused = [];
+            for (const network of dropped) {
+                const off = await apiDeleteJson(`/api/audience-activations/${encodeURIComponent(args.audience_id)}/platforms/${encodeURIComponent(network)}`);
+                if (off.data?.failed)
+                    refused.push({ network, reason: off.data.failed });
+                else
+                    removedFrom.push(network);
+            }
+            const res = await apiPatch(`/api/audience-activations/${encodeURIComponent(args.audience_id)}`, body);
+            return jsonResult({
+                audience_id: args.audience_id,
+                platforms: res.data?.platformTargets,
+                holdout_percent: res.data?.holdoutPercent ?? 0,
+                ...(dropped.length > 0 ? { removed_from: removedFrom, refused } : {}),
+            }, refused.length > 0
+                ? `Apex stopped sending the list to ${refused.map((f) => f.network).join(", ")}, but the platform didn't delete it. The shop should delete it there by hand.`
+                : null);
+        },
+    },
+    remove_audience: {
+        description: `${APEX} — Take a buyer list off every ad platform it reached and stop sending it. Deleting it on a platform cannot be undone, and an ad set that used it stops using it. Ask the shop first; pass confirm only after they said yes. Reports any platform that refused, so the shop can delete it there by hand.`,
+        schema: z.object({
+            audience_id: z.string().describe("From list_audiences."),
+            confirm: z.literal(true).describe("Only after the shop said yes to removing this list from every platform."),
+        }),
+        handler: async (args) => {
+            if (args.confirm !== true)
+                return jsonResult(null, "Ask the shop first, then pass confirm: true.");
+            const list = await loadList(args.audience_id);
+            if (!list)
+                return jsonResult(null, "No buyer list with that id in this workspace. Use list_audiences.");
+            if (list.kind === "holdout")
+                return jsonResult(null, HOLDOUT_OWNED);
+            const res = await apiDeleteJson(`/api/audience-activations/${encodeURIComponent(args.audience_id)}?from_platforms=true`);
+            const failed = res.data?.failed ?? [];
+            return jsonResult({ audience_id: args.audience_id, removed_from: res.data?.deleted ?? [], refused: failed }, failed.length > 0
+                ? `Apex stopped sending the list, but ${failed.map((f) => f.network).join(", ")} didn't delete it. The shop should delete it there by hand.`
+                : null);
+        },
+    },
+    list_audience_removals: {
+        description: `${APEX} — People who asked to be deleted or opted out of ads but are still on one of the shop's buyer lists, because the platform refused or couldn't be reached when Apex took them off. One row per list and platform: \`owed\` (still on it), \`stopped_retrying\` (Apex retries every day for 30 days, then stops and waits for the shop), \`why\` (not_connected, platform_cant_remove_yet, or platform_refused) and \`platform_said\`. Empty means nobody is owed. Pass audience_id for one list, or nothing for every list. Same as the amber line on the list card.`,
+        schema: z.object({
+            audience_id: z.string().optional().describe("From list_audiences. Leave out for every list."),
+        }),
+        handler: async (args) => {
+            const res = args.audience_id
+                ? await apiGet(`/api/audience-activations/${encodeURIComponent(args.audience_id)}/removals`)
+                : await apiGet("/api/audiences/sync");
+            return jsonResult((res.data?.removals ?? []).map(removalRow));
+        },
+    },
+    retry_audience_removals: {
+        description: `${APEX} — Try again now to take the people who asked to be deleted or opted out off one buyer list, including the ones Apex stopped retrying after 30 days. Use it after the shop reconnects a platform or fixes what the platform refused (see list_audience_removals). Returns how many Apex tried, how many came off, and what is still owed. Admin-only.`,
+        schema: z.object({
+            audience_id: z.string().describe("From list_audiences or list_audience_removals."),
+        }),
+        handler: async (args) => {
+            const res = await apiPost(`/api/audience-activations/${encodeURIComponent(args.audience_id)}/removals`, {});
+            if (!res.data)
+                return jsonResult(null, res.error ?? "Apex couldn't try again.");
+            const still = res.data.removals.map(removalRow);
+            return jsonResult({ audience_id: args.audience_id, tried: res.data.retried, removed: res.data.succeeded, still_owed: still }, still.length > 0 ? "Some people are still on the list. Tell the shop what each platform said." : null);
+        },
+    },
+    list_audience_goals: {
+        description: `${APEX} — The four things a buyer list can be for, and whether this shop can make each one now. win_back shows ads to people who bought but not within the shop's kind-of-business window (\`window_days\`); stop_paying leaves everyone who ever bought out of ads meant for new people; interested shows ads to people who added to cart or started checkout in the last 30 days and never bought (\`locked\` until those events arrive); lookalike gives Meta everyone who bought with what each spent, for a value-based lookalike (Meta only). Each goal returns \`networks\` (where its list can go right now) and \`lists\` (lists the shop already made for it). When a goal already has a list, ask whether the shop wants another before adding one.`,
+        schema: z.object({}),
+        handler: async () => {
+            const res = await apiGet("/api/ad-platforms/lists");
+            return jsonResult(res.data ?? null);
+        },
+    },
+    add_audience: {
+        description: `${APEX} — Make a buyer list from a goal (see list_audience_goals) and send it. Apex saves the goal's rule as a segment named after the list, which the shop can change in Segments, makes the list on it, and sends it to each platform; it updates every day after. Nobody is held back. Call list_audience_goals first, tell the shop who goes on the list and where it goes, and pass confirm: true only after they say yes. Refused when the goal is locked, or when none of the platforms can take the list. Admin-only.`,
+        schema: z.object({
+            goal: z.enum(LIST_GOALS).describe("win_back, stop_paying, interested or lookalike."),
+            platforms: z
+                .array(z.enum(LIST_PLATFORMS))
+                .min(1)
+                .optional()
+                .describe("Where it goes. Defaults to every platform the goal's list can go to now."),
+            name: z.string().min(1).max(120).optional().describe("The list's name. Defaults to the goal's list name."),
+            send_now: z
+                .boolean()
+                .optional()
+                .describe("Send it right away. Defaults to true; false waits for the daily update."),
+            confirm: z.literal(true).describe("The shop heard who goes and where, and said yes."),
+        }),
+        handler: async (args) => {
+            const made = await apiPost("/api/ad-platforms/lists", {
+                goal: args.goal,
+                ...(args.platforms ? { platforms: args.platforms } : {}),
+                ...(args.name ? { name: args.name } : {}),
+            });
+            if (!made.data)
+                return jsonResult(null, made.error ?? "Apex couldn't make the list.");
+            const { list, segment } = made.data;
+            let sent = [];
+            if (args.send_now !== false) {
+                const sync = await apiPost("/api/audiences/sync", { activationId: list.id }).catch(() => null);
+                sent = (sync?.data?.runs ?? []).map((r) => ({
+                    platform: r.network,
+                    status: r.status,
+                    people_added: r.addedCount ?? 0,
+                    message: r.message ?? null,
+                }));
+            }
+            return jsonResult({
+                audience_id: list.id,
+                goal: args.goal,
+                segment: segment.name,
+                segment_id: segment.id,
+                kind: list.kind,
+                platforms: list.platformTargets,
+                sent,
+            });
+        },
+    },
+    preview_ad_platform_send: {
+        description: `${APEX} — Before sending one of the shop's events to its ad platforms, see what each platform would hear. Pass the event as the shop sends it and what it means. Returns each platform's state: sends (hears \`word\` right away), apex_makes (hears it once Apex makes the conversion there), no_word (the platform has nothing for this meaning, so it is not sent), not_connected, not_agreed (the shop hasn't agreed to send sales there yet), other_source (the shop set another tool to send that platform's conversions), held (the shop asked Apex not to send people to any ad platform), coming_soon, or turned_off. \`without_consent_answer\` says whether an event that carries no consent answer goes out (sent) or not (not_sent); when it's not_sent, tell the shop only events with a yes go. Also returns \`estimate\`: how often the event happened in the last 30 days, the sends a month that bills (one per event, however many platforms hear it), the shop's free sends and use this month, and the monthly cost at its price (null when Apex couldn't count; only people Apex knows are sent, so the real number can be lower). Saves and sends nothing. Show the shop the result before anything starts sending.`,
+        schema: z.object({
+            event_name: z.string().min(1).describe("The event exactly as the shop sends it, e.g. trial_started."),
+            meaning: z
+                .enum(SEND_MEANINGS)
+                .describe("What the event means: purchase, lead, signup, subscription, add_to_cart, or something_else when none fit."),
+        }),
+        handler: async (args) => {
+            const params = new URLSearchParams({ event_name: args.event_name, meaning: args.meaning });
+            const res = await apiGet(`/api/ad-platforms/sends/preview?${params.toString()}`);
+            return jsonResult(res.data ?? null);
+        },
+    },
+    list_ad_platform_sends: {
+        description: `${APEX} — The shop's own events Apex sends to its ad platforms, with what each one means and what each platform hears (same states as preview_ad_platform_send). Sales, signups and leads Apex already knows about go out on their own and are not listed here.`,
+        schema: z.object({}),
+        handler: async () => {
+            const res = await apiGet("/api/ad-platforms/sends");
+            return jsonResult(res.data ?? []);
+        },
+    },
+    add_ad_platform_send: {
+        description: `${APEX} — Start sending one of the shop's events to its ad platforms. Call preview_ad_platform_send first and show the shop what each platform would hear, the 30-day count and the monthly cost; pass confirm: true only after the shop says yes. Saved on the shop's Conversion for that event (created when there isn't one). Only platforms the shop has connected and agreed to send to hear it; this tool never agrees for the shop. For something_else, Apex makes the conversion on Meta so campaigns can optimize for it; the result's \`made\` lists where it did and \`couldnt_make\` says why a platform refused (the send still goes). Refused when the event already means something else on Conversions, when Apex already sends it as a sale, or when no platform can hear it yet. Admin-only.`,
+        schema: z.object({
+            event_name: z.string().min(1).describe("The event exactly as the shop sends it, e.g. trial_started."),
+            meaning: z
+                .enum(SEND_MEANINGS)
+                .describe("What the event means: purchase, lead, signup, subscription, add_to_cart, or something_else when none fit."),
+            send_value: z.boolean().optional().describe("Send the event's amount when it has one. Defaults to true."),
+            name: z.string().optional().describe("Name for a new Conversion. Defaults to the event name in words."),
+            confirm: z.literal(true).describe("The shop saw the preview and said yes."),
+        }),
+        handler: async (args) => {
+            const res = await apiPost("/api/ad-platforms/sends", {
+                event_name: args.event_name,
+                meaning: args.meaning,
+                ...(args.send_value === undefined ? {} : { send_value: args.send_value }),
+                ...(args.name ? { name: args.name } : {}),
+            });
+            return jsonResult(res.data ?? null);
+        },
+    },
+    remove_ad_platform_send: {
+        description: `${APEX} — Stop sending one of the shop's events to its ad platforms. The Conversion stays, so experiments and goals that count it are untouched, and what the platforms already heard stays with them. Pass the id from list_ad_platform_sends. Admin-only.`,
+        schema: z.object({
+            send_id: z.string().min(1).describe("The send's id from list_ad_platform_sends."),
+        }),
+        handler: async (args) => {
+            const res = await apiDeleteJson(`/api/ad-platforms/sends/${encodeURIComponent(args.send_id)}`);
+            return jsonResult(res.data ?? null);
+        },
+    },
+};
+//# sourceMappingURL=ad-platforms.js.map

package/dist/tools/ad-platforms.js.map

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

package/dist/tools/adoption.d.ts

@@ -117,6 +117,16 @@ export declare const adoptionTools: {
             enrollMode: z.ZodOptional<z.ZodEnum<["all", "future"]>>;
             finishWhen: z.ZodOptional<z.ZodEnum<["this_person", "anyone_here"]>>;
             nudgeJourneyId: z.ZodOptional<z.ZodString>;
+            nudgeClocks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                hours: z.ZodOptional<z.ZodNumber>;
+                days: z.ZodOptional<z.ZodNumber>;
+            }, "strict", z.ZodTypeAny, {
+                days?: number | undefined;
+                hours?: number | undefined;
+            }, {
+                days?: number | undefined;
+                hours?: number | undefined;
+            }>, "many">>;
             confirmLiveMilestone: z.ZodOptional<z.ZodBoolean>;
         }, "strip", z.ZodTypeAny, {
             milestoneId: string;
@@ -137,6 +147,10 @@ export declare const adoptionTools: {
             gapDays?: number | undefined;
             gapHours?: number | undefined;
             gapKind?: "days_since_signup" | "event_not_fired" | undefined;
+            nudgeClocks?: {
+                days?: number | undefined;
+                hours?: number | undefined;
+            }[] | undefined;
             confirmLiveMilestone?: boolean | undefined;
         }, {
             milestoneId: string;
@@ -157,11 +171,19 @@ export declare const adoptionTools: {
             gapDays?: number | undefined;
             gapHours?: number | undefined;
             gapKind?: "days_since_signup" | "event_not_fired" | undefined;
+            nudgeClocks?: {
+                days?: number | undefined;
+                hours?: number | undefined;
+            }[] | undefined;
             confirmLiveMilestone?: boolean | undefined;
         }>;
         handler: (args: AdoptionWriteArgs & {
             milestoneId: string;
             confirmLiveMilestone?: boolean;
+            nudgeClocks?: Array<{
+                hours?: number;
+                days?: number;
+            }>;
         }) => Promise<{
             content: {
                 type: "text";
@@ -307,7 +329,7 @@ export declare const adoptionTools: {
             label: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             milestoneId: string;
-            state: "not_yet" | "done";
+            state: "done" | "not_yet";
             label?: string | undefined;
             url?: string | undefined;
             imageBase64?: string | undefined;
@@ -315,7 +337,7 @@ export declare const adoptionTools: {
             format?: "png" | "jpeg" | undefined;
         }, {
             milestoneId: string;
-            state: "not_yet" | "done";
+            state: "done" | "not_yet";
             label?: string | undefined;
             url?: string | undefined;
             imageBase64?: string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"adoption.d.ts","sourceRoot":"","sources":["../../src/tools/adoption.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAMhC,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;mCAmBW;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA+BlC,iBAAiB,GAAG;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqDtE,iBAAiB,GAAG;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;SAAE;;;;;;;;;;;;;;;;;;;0DAgDhF;YACD,WAAW,EAAE,MAAM,CAAC;YACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;SAChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA8CqB,iBAAiB,GAAG;YACxC,IAAI,EAAE,MAAM,CAAC;YACb,UAAU,EAAE,MAAM,CAAC;YACnB,eAAe,EAAE,OAAO,GAAG,OAAO,CAAC;YACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;YACrD,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,WAAW,CAAC,EAAE,KAAK,CAAC;gBAAE,KAAK,CAAC,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SACxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAiGqB;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;YAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;YAC3C,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;YACxB,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA2CqB;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB;;;;;;;;;;;;;;;;;;;;;;;mCAiEgC;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;kCAkBxB;YAAE,UAAU,EAAE,MAAM,EAAE,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;kCA6BxB;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;mCAsBrB;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAmClC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE;;;;;;;CAU/E,CAAC"}
+{"version":3,"file":"adoption.d.ts","sourceRoot":"","sources":["../../src/tools/adoption.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAMhC,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;mCAmBW;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA+BlC,iBAAiB,GAAG;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA+DtE,iBAAiB,GAAG;YACxB,WAAW,EAAE,MAAM,CAAC;YACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;YAC/B,WAAW,CAAC,EAAE,KAAK,CAAC;gBAAE,KAAK,CAAC,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SACxD;;;;;;;;;;;;;;;;;;;0DA4DA;YACD,WAAW,EAAE,MAAM,CAAC;YACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;SAChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA8CqB,iBAAiB,GAAG;YACxC,IAAI,EAAE,MAAM,CAAC;YACb,UAAU,EAAE,MAAM,CAAC;YACnB,eAAe,EAAE,OAAO,GAAG,OAAO,CAAC;YACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;YACrD,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,WAAW,CAAC,EAAE,KAAK,CAAC;gBAAE,KAAK,CAAC,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SACxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAiGqB;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;YAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;YAC3C,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;YACxB,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA2CqB;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB;;;;;;;;;;;;;;;;;;;;;;;mCAiEgC;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;kCAkBxB;YAAE,UAAU,EAAE,MAAM,EAAE,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;kCA6BxB;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;mCAsBrB;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAmClC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE;;;;;;;CAU/E,CAAC"}