@apex-inc/mcp-server 0.13.0 → 0.14.0

package/dist/tools.js

@@ -2919,12 +2919,12 @@ Events fired through this tool carry a stable synthetic visitorId (mcp-agent-*,
         },
     },
     add_journey_branch: {
-        description: `${APEX} — Insert a CONDITIONAL content branch before the exit: evaluate one condition and send a different communication to each side. Use this for true content branching (e.g. "cart value > $100 → VIP email, else standard email"). For the simpler "skip the next send if they already converted" case, use add_journey_exit instead. The condition is an attribute test (fieldPath + operator + value) or an event test (event_fired / event_not_fired within a window).`,
+        description: `${APEX} — Insert a CONDITIONAL content branch before the exit: evaluate one condition and send a different communication to each side. Use this for true content branching (e.g. "cart value > $100 → VIP email, else standard email"). For the simpler "skip the next send if they already converted" case, use add_journey_exit instead. The condition is an attribute test (field_path + operator + value) or an event test (event_fired / event_not_fired within a window).`,
         schema: z.object({
             journeyId: z.string(),
             condition: z.object({
                 kind: z.enum(["attribute", "event_fired", "event_not_fired"]),
-                fieldPath: z.string().optional().describe("attribute only: dotted path, e.g. 'cart.valueCents' or 'plan'."),
+                field_path: z.string().optional().describe("attribute only: dotted path, e.g. 'cart.valueCents' or 'plan'."),
                 operator: z
                     .enum(["equals", "not_equals", "greater_than", "less_than", "in", "exists", "not_exists"])
                     .optional()
@@ -2933,8 +2933,8 @@ Events fired through this tool carry a stable synthetic visitorId (mcp-agent-*,
                     .union([z.string(), z.number(), z.boolean(), z.array(z.union([z.string(), z.number(), z.boolean()]))])
                     .optional()
                     .describe("attribute only: the comparison value (omit for exists/not_exists)."),
-                eventName: z.string().optional().describe("event only: the canonical event, e.g. 'purchase'."),
-                windowDays: z.number().optional().describe("event only: look-back window in days (omit = ever)."),
+                event_name: z.string().optional().describe("event only: the canonical event, e.g. 'purchase'."),
+                window_days: z.number().optional().describe("event only: look-back window in days (omit = ever)."),
             }),
             whenTrueCommId: z.string().describe("Communication to send when the condition matches."),
             whenFalseCommId: z.string().optional().describe("Communication to send when it doesn't match (omit to just continue to exit)."),
@@ -2946,24 +2946,24 @@ Events fired through this tool carry a stable synthetic visitorId (mcp-agent-*,
                 // Build the predicate leaf (AudiencePredicate is a bare leaf here).
                 let predicate;
                 if (c.kind === "attribute") {
-                    if (!c.fieldPath || !c.operator) {
-                        return { content: [{ type: "text", text: `${APEX} An attribute condition needs fieldPath and operator.` }], isError: true };
+                    if (!c.field_path || !c.operator) {
+                        return { content: [{ type: "text", text: `${APEX} An attribute condition needs field_path and operator.` }], isError: true };
                     }
                     predicate = {
                         kind: "attribute",
-                        fieldPath: c.fieldPath,
+                        fieldPath: c.field_path,
                         operator: c.operator,
                         ...(c.value !== undefined ? { value: c.value } : {}),
                     };
                 }
                 else {
-                    if (!c.eventName) {
-                        return { content: [{ type: "text", text: `${APEX} An event condition needs eventName.` }], isError: true };
+                    if (!c.event_name) {
+                        return { content: [{ type: "text", text: `${APEX} An event condition needs event_name.` }], isError: true };
                     }
                     predicate = {
                         kind: c.kind,
-                        eventName: c.eventName,
-                        window: c.windowDays ? { type: "last_n_days", days: c.windowDays } : { type: "ever" },
+                        eventName: c.event_name,
+                        window: c.window_days ? { type: "last_n_days", days: c.window_days } : { type: "ever" },
                     };
                 }
                 const j = await apiGet(`/api/journeys/${encodeURIComponent(args.journeyId)}`);
@@ -3081,15 +3081,10 @@ Events fired through this tool carry a stable synthetic visitorId (mcp-agent-*,
     get_journey: {
         description: `${APEX} — Read the full configuration for a single journey, including steps, goal event, attribution window, and exit rules. Use after list_journeys to inspect a journey's wiring before recommending edits.`,
         schema: z.object({
-            journeyId: z.string().optional().describe("Journey id returned from list_journeys."),
-            journey_id: z.string().optional().describe("Deprecated alias for journeyId."),
+            journeyId: z.string().describe("Journey id returned from list_journeys."),
         }),
-        handler: async ({ journeyId, journey_id }) => {
-            const jid = journeyId ?? journey_id;
-            if (!jid) {
-                return { content: [{ type: "text", text: `${APEX} journeyId is required.` }], isError: true };
-            }
-            const journey = await apiGet(`/api/journeys/${encodeURIComponent(jid)}`);
+        handler: async ({ journeyId }) => {
+            const journey = await apiGet(`/api/journeys/${encodeURIComponent(journeyId)}`);
             return {
                 content: [
                     {
@@ -3103,15 +3098,10 @@ Events fired through this tool carry a stable synthetic visitorId (mcp-agent-*,
     list_journey_exits: {
         description: `${APEX} — Just the exit-rules block of one journey. Cheaper than get_journey for audit loops that only need to know "does this journey suppress purchase / unsubscribe?".`,
         schema: z.object({
-            journeyId: z.string().optional(),
-            journey_id: z.string().optional().describe("Deprecated alias for journeyId."),
+            journeyId: z.string(),
         }),
-        handler: async ({ journeyId, journey_id }) => {
-            const jid = journeyId ?? journey_id;
-            if (!jid) {
-                return { content: [{ type: "text", text: `${APEX} journeyId is required.` }], isError: true };
-            }
-            const body = await apiGet(`/api/journeys/${encodeURIComponent(jid)}/exit-rules`);
+        handler: async ({ journeyId }) => {
+            const body = await apiGet(`/api/journeys/${encodeURIComponent(journeyId)}/exit-rules`);
             return {
                 content: [
                     {
@@ -3125,21 +3115,16 @@ Events fired through this tool carry a stable synthetic visitorId (mcp-agent-*,
     add_journey_exit: {
         description: `${APEX} — Append a new exit rule to a journey's draft. Rule fires when the chosen trigger contract's event lands on a contact with an in-flight execution — Apex stops the execution and skips any pending sends. Re-publish required for the rule to take effect on live runs.`,
         schema: z.object({
-            journeyId: z.string().optional(),
-            journey_id: z.string().optional().describe("Deprecated alias for journeyId."),
-            trigger_contract_id: z
+            journeyId: z.string(),
+            triggerContractId: z
                 .string()
                 .describe("Trigger-contract id, e.g. trig-in-app-purchase"),
             label: z.string().optional(),
             enabled: z.boolean().optional().default(true),
         }),
-        handler: async ({ journeyId, journey_id, trigger_contract_id, label, enabled, }) => {
-            const jid = journeyId ?? journey_id;
-            if (!jid) {
-                return { content: [{ type: "text", text: `${APEX} journeyId is required.` }], isError: true };
-            }
-            const body = await apiPost(`/api/journeys/${encodeURIComponent(jid)}/exit-rules`, {
-                triggerContractId: trigger_contract_id,
+        handler: async ({ journeyId, triggerContractId, label, enabled, }) => {
+            const body = await apiPost(`/api/journeys/${encodeURIComponent(journeyId)}/exit-rules`, {
+                triggerContractId,
                 ...(label !== undefined && { label }),
                 enabled: enabled !== false,
             });
@@ -3156,21 +3141,16 @@ Events fired through this tool carry a stable synthetic visitorId (mcp-agent-*,
     remove_journey_exit: {
         description: `${APEX} — Remove an exit rule from a journey's draft. Re-publish required for the change to apply to live runs.`,
         schema: z.object({
-            journeyId: z.string().optional(),
-            journey_id: z.string().optional().describe("Deprecated alias for journeyId."),
-            rule_id: z.string(),
+            journeyId: z.string(),
+            ruleId: z.string(),
         }),
-        handler: async ({ journeyId, journey_id, rule_id, }) => {
-            const jid = journeyId ?? journey_id;
-            if (!jid) {
-                return { content: [{ type: "text", text: `${APEX} journeyId is required.` }], isError: true };
-            }
-            await apiDelete(`/api/journeys/${encodeURIComponent(jid)}/exit-rules/${encodeURIComponent(rule_id)}`);
+        handler: async ({ journeyId, ruleId, }) => {
+            await apiDelete(`/api/journeys/${encodeURIComponent(journeyId)}/exit-rules/${encodeURIComponent(ruleId)}`);
             return {
                 content: [
                     {
                         type: "text",
-                        text: `Removed exit rule ${rule_id} from journey ${jid}.`,
+                        text: `Removed exit rule ${ruleId} from journey ${journeyId}.`,
                     },
                 ],
             };