Clarify sendAt behavior in create_campaign tool

Author: gmethvin

TOOLS.md

@@ -11,7 +11,7 @@
 - **activate_triggered_campaign** ✏️✉️: Activate a triggered campaign (requires API triggered campaign activation enabled)
 - **archive_campaigns** ✏️: Archive one or more campaigns. Scheduled/recurring campaigns will be cancelled, running campaigns will be aborted.
 - **cancel_campaign** ✏️: Cancel a scheduled or recurring campaign
-- **create_campaign** ✏️✉️: Create a new blast or triggered campaign from an existing template. If listIds are provided, the campaign will be a blast campaign, otherwise it will be a triggered campaign. Blast campaigns will be sent immediately if sendAt is not provided.
+- **create_campaign** ✏️✉️: Create a new blast or triggered campaign from an existing template. If listIds are provided, the campaign will be a blast campaign; it is created in Ready state and will be sent at the given sendAt time, which is required. If listIds are not provided, the campaign will be a triggered campaign in Ready state that must be activated before it can send.
 - **deactivate_triggered_campaign** ✏️: Deactivate a triggered campaign (requires API triggered campaign deactivation enabled)
 - **get_campaign**: Get detailed information about a specific campaign
 - **get_campaign_metrics**: Get campaign performance metrics

package.json

@@ -75,7 +75,7 @@
   },
   "dependencies": {
     "@alcyone-labs/zod-to-json-schema": "4.0.10",
-    "@iterable/api": "0.6.0",
+    "@iterable/api": "0.6.1",
     "@modelcontextprotocol/sdk": "1.18.1",
     "@primno/dpapi": "2.0.1",
     "@types/json-schema": "7.0.15",

pnpm-lock.yaml

@@ -117,7 +117,7 @@ export const SEND_TOOLS: Set<string> = new Set([
   "send_campaign",
   "trigger_campaign",
   "schedule_campaign",
-  // Creating a blast campaign can send immediately if sendAt not provided
+  // Creating a blast campaign schedules a send (sendAt is required when listIds is provided)
   "create_campaign",
   // Triggered campaigns can cause sends upon activation; block unless explicitly allowed
   "activate_triggered_campaign",

src/tool-filter.ts

@@ -47,7 +47,7 @@ export function createCampaignTools(client: IterableClient): Tool[] {
     createTool({
       name: "create_campaign",
       description:
-        "Create a new blast or triggered campaign from an existing template. If listIds are provided, the campaign will be a blast campaign, otherwise it will be a triggered campaign. Blast campaigns will be sent immediately if sendAt is not provided.",
+        "Create a new blast or triggered campaign from an existing template. If listIds are provided, the campaign will be a blast campaign; it is created in Ready state and will be sent at the given sendAt time, which is required. If listIds are not provided, the campaign will be a triggered campaign in Ready state that must be activated before it can send.",
       schema: CreateCampaignParamsSchema,
       execute: (params) => client.createCampaign(params),
     }),