@rcs-campaigns/agent-toolkit 0.1.10 → 0.1.11

package/dist/cli.js

@@ -107,7 +107,7 @@ Surveys:
   ${BIN} survey send <id> [--to +1555... ...] [--audience <audienceId> ...]
   ${BIN} survey send-test <id> --to +1555...
   ${BIN} survey sends <id>
-  ${BIN} survey results <id>
+  ${BIN} survey results <id> [--campaign <campaignId>]
 
 Everything else, straight from the tool catalog (scope shown after each):
 ${(0, cliDispatch_1.catalogUsage)(BIN)}
@@ -339,10 +339,12 @@ async function run() {
                         path: `/surveys/${enc(id)}/sends`
                     }));
                 case 'results':
-                    requireArg(id, 'survey results <id>');
+                    requireArg(id, 'survey results <id> [--campaign <campaignId>]');
                     return print(await client.call({
                         method: 'GET',
-                        path: `/surveys/${enc(id)}/results`
+                        path: `/surveys/${enc(id)}/results`,
+                        // One send's results (the campaignId `survey send` returns).
+                        query: { campaignId: str(argv.flags.campaign) }
                     }));
                 default:
                     // `survey render|clone|delete` and anything the catalog grows later.

package/dist/cliDispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cliDispatch.d.ts","sourceRoot":"","sources":["../src/cliDispatch.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAyBpD;AAED;;;;GAIG;AACH,eAAO,MAAM,OAAO,aAyBlB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwB1C,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAElD;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAG7C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EAAE,GACd;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAa7C;AAED,yEAAyE;AACzE,wBAAgB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CA4B7D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,EAAE,UAAU,EAChB,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAuC,GAClE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAiDrB;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,SAAQ,GAAG,MAAM,CAc5D;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,GAAG,SAAQ,GAAG,MAAM,CAIhD"}
+{"version":3,"file":"cliDispatch.d.ts","sourceRoot":"","sources":["../src/cliDispatch.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAyBpD;AAED;;;;GAIG;AACH,eAAO,MAAM,OAAO,aAyBlB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmC1C,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAElD;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAG7C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EAAE,GACd;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAa7C;AAED,yEAAyE;AACzE,wBAAgB,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CA4B7D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,EAAE,UAAU,EAChB,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAuC,GAClE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAiDrB;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,SAAQ,GAAG,MAAM,CAc5D;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,GAAG,SAAQ,GAAG,MAAM,CAIhD"}

package/dist/cliDispatch.js

@@ -110,6 +110,8 @@ exports.ALIASES = {
     'audience contacts': 'list_audience_contacts',
     'audience create': 'create_audience',
     'audience import': 'import_contacts',
+    'audience update': 'update_audience',
+    'audience remove': 'remove_audience_contacts',
     'audience delete': 'delete_audience',
     contacts: 'list_contacts',
     'contact get': 'get_contact',
@@ -127,7 +129,16 @@ exports.ALIASES = {
     'template delete': 'delete_template',
     'survey render': 'render_survey',
     'survey clone': 'clone_survey',
-    'survey delete': 'delete_survey'
+    'survey delete': 'delete_survey',
+    campaigns: 'list_campaigns',
+    analytics: 'get_campaign_analytics',
+    groups: 'list_campaign_groups',
+    'group get': 'get_campaign_group',
+    'group create': 'create_campaign_group',
+    'group update': 'update_campaign_group',
+    'group delete': 'delete_campaign_group',
+    'group add': 'add_campaigns_to_group',
+    'group remove': 'remove_campaigns_from_group'
 };
 /** The `:param` names in a tool's route, in the order the route names them. */
 function pathParams(tool) {

package/dist/mcp.js

@@ -31,7 +31,6 @@ const PROTOCOL_VERSION = '2024-11-05';
  * "RCS-first" in its own tool list, contradicting the docs that sent it here.
  * Same catalog, same gateway — only the words the model reads differ.
  */
-const SKIN = (0, client_1.detectSkin)();
 const { product: PRODUCT, channel: CHANNEL, slug: SLUG } = (0, client_1.skinLabels)((0, client_1.detectBrand)());
 const SERVER_INFO = { name: SLUG, version: (0, client_1.readVersion)() };
 /**
@@ -48,7 +47,7 @@ const INSTRUCTIONS = [
     '  search_templates → clone_template (into your org) → render_template (preview)',
     '  → submit_template (provider approval) → send_message.',
     'Surveys mirror it: search_surveys/create_survey → submit_survey → send_survey →',
-    'get_results.',
+    'get_results (pass the campaignId send_survey returns for that send only).',
     '',
     `IMPORTANT — rich ${CHANNEL} requires approval. A freshly created or cloned`,
     'template delivers as SMS fallback ONLY until it is submitted AND',

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAoB,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5E,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;OAYG;IACH,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IAC1B,4EAA4E;IAC5E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;IACF,qEAAqE;IACrE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,WAAW,CAAC;CACvD;AAmBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,mBAAmB,8QA+BtB,CAAC;AAEX,eAAO,MAAM,KAAK,EAAE,OAAO,EA4uC1B,CAAC;AAEF,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE1D;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAKrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,cAAc,CAAC,EAAE,OAAO,GACvB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAcrB"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAoB,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5E,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;OAYG;IACH,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IAC1B,4EAA4E;IAC5E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;IACF,qEAAqE;IACrE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,WAAW,CAAC;CACvD;AAmBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,mBAAmB,8QA+BtB,CAAC;AAEX,eAAO,MAAM,KAAK,EAAE,OAAO,EAgjD1B,CAAC;AAEF,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE1D;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAKrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,cAAc,CAAC,EAAE,OAAO,GACvB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAcrB"}

package/dist/tools.js

@@ -101,7 +101,7 @@ exports.TOOLS = [
     },
     {
         name: 'search_templates',
-        description: 'Search the published RCS template marketplace. Returns normalized listings (id, name, rating, cloneCount, categoryKeys).',
+        description: 'Search the published template MARKETPLACE (templates from every org, to clone). Returns normalized listings (id, name, rating, cloneCount, categoryKeys). For your OWN templates use list_templates.',
         scope: 'campaigns:read',
         method: 'GET',
         path: '/templates',
@@ -136,6 +136,41 @@ exports.TOOLS = [
             }
         })
     },
+    {
+        name: 'list_templates',
+        description: "List YOUR org's own message templates (not the marketplace), newest first, with channel and provider approval status (APPROVED / PENDING / REJECTED / NOT_SUBMITTED) and any rejection reason. Filter by text, channel or approvalStatus. Archived templates only with includeArchived.",
+        scope: 'campaigns:read',
+        method: 'GET',
+        path: '/my-templates',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                q: { type: 'string', description: 'Free-text search over name + description.' },
+                channel: { type: 'string', enum: ['RCS', 'WHATSAPP', 'SMS'] },
+                approvalStatus: {
+                    type: 'string',
+                    enum: ['APPROVED', 'PENDING', 'REJECTED', 'NOT_SUBMITTED'],
+                    description: 'Only templates in this provider approval state.'
+                },
+                includeArchived: { type: 'boolean', default: false },
+                page: { type: 'number', minimum: 1 },
+                pageSize: { type: 'number', minimum: 1, maximum: 100 }
+            },
+            additionalProperties: false
+        },
+        toRequest: (a) => ({
+            method: 'GET',
+            path: '/my-templates',
+            query: {
+                q: a.q,
+                channel: a.channel,
+                approvalStatus: a.approvalStatus,
+                includeArchived: a.includeArchived,
+                page: a.page,
+                pageSize: a.pageSize
+            }
+        })
+    },
     {
         name: 'get_template',
         description: 'Fetch one template by id (a published marketplace listing or one your org owns).',
@@ -523,7 +558,7 @@ exports.TOOLS = [
     },
     {
         name: 'send_survey',
-        description: 'Send a survey to explicit E.164 numbers (the CRM-triggered single-customer send) and/or saved audiences. Flips the survey ACTIVE. Bills your org. Returns { recipients, sent }.',
+        description: 'Send a survey to explicit E.164 numbers (the CRM-triggered single-customer send) and/or saved audiences. Flips the survey ACTIVE. Bills your org. Returns { recipients, sent }. Every send is a campaign (WhatsApp sends the approved Flow, RCS the question-by-question run) and also returns campaignId and queued: sending: true means the rest is still going out in the background (do not send again), and halted / heldByAllowance / groundStopped say why a send stopped short.',
         scope: 'surveys:send',
         method: 'POST',
         path: '/surveys/:id/send',
@@ -630,19 +665,26 @@ exports.TOOLS = [
     },
     {
         name: 'get_results',
-        description: 'Read a survey’s aggregated results: per-question option counts / rating averages / text samples + completion totals (multi-part questions aggregate per part; free-text answers are auto-translated to English).',
+        description: 'Read a survey’s aggregated results: per-question option counts / rating averages / text samples + completion totals (multi-part questions aggregate per part; free-text answers are auto-translated to English). Pass campaignId (returned by send_survey, or a SURVEY campaign’s id from list_campaigns) for that one send’s results; without it the totals span the whole survey, test sends and every campaign included.',
         scope: 'results:read',
         method: 'GET',
         path: '/surveys/:id/results',
         inputSchema: {
             type: 'object',
-            properties: { id: { type: 'string' } },
+            properties: {
+                id: { type: 'string' },
+                campaignId: {
+                    type: 'string',
+                    description: 'Only the responses answered from this survey campaign (24-hex id). A campaign that is not this survey’s is a 404.'
+                }
+            },
             required: ['id'],
             additionalProperties: false
         },
         toRequest: (a) => ({
             method: 'GET',
-            path: `/surveys/${encodeURIComponent(a.id)}/results`
+            path: `/surveys/${encodeURIComponent(a.id)}/results`,
+            query: { campaignId: a.campaignId }
         })
     },
     {
@@ -930,6 +972,54 @@ exports.TOOLS = [
             body: { contacts: a.contacts }
         })
     },
+    {
+        name: 'update_audience',
+        description: 'Rename an audience or change its description (null or an empty string clears it). Only the fields you pass change; its contacts are untouched.',
+        scope: 'audiences:write',
+        method: 'PATCH',
+        path: '/audiences/:id',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string' },
+                name: { type: 'string', minLength: 1, maxLength: 120 },
+                description: { type: ['string', 'null'], maxLength: 500 }
+            },
+            required: ['id'],
+            additionalProperties: false
+        },
+        toRequest: (a) => ({
+            method: 'PATCH',
+            path: `/audiences/${encodeURIComponent(a.id)}`,
+            body: { name: a.name, description: a.description }
+        })
+    },
+    {
+        name: 'remove_audience_contacts',
+        description: "Take people off an audience, by each row's `id` from list_audience_contacts (its `contactId` works too). This is not an opt-out: the person, their message history and their other audiences are untouched, and ids not in the audience are ignored. Returns the audience with its new contactCount and how many were removed.",
+        scope: 'audiences:write',
+        method: 'POST',
+        path: '/audiences/:id/contacts/remove',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string' },
+                contactIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 1,
+                    maxItems: 500
+                }
+            },
+            required: ['id', 'contactIds'],
+            additionalProperties: false
+        },
+        toRequest: (a) => ({
+            method: 'POST',
+            path: `/audiences/${encodeURIComponent(a.id)}/contacts/remove`,
+            body: { contactIds: a.contactIds }
+        })
+    },
     {
         name: 'delete_audience',
         description: 'Delete an audience and all of its contacts (org-scoped, irreversible).',
@@ -1293,6 +1383,227 @@ exports.TOOLS = [
                 tags: a.tags
             }
         })
+    },
+    // ── Campaign reads (the Messages list + the Analytics page, aggregate only) ──
+    {
+        name: 'list_campaigns',
+        description: "List YOUR org's campaigns (broadcasts), newest first, with status (DRAFT / SCHEDULED / SENDING / SENT / FAILED / CANCELLED), channel, the template sent, audience count, schedule (scheduledAt in the campaign's own timezone) and the delivery funnel (total, delivered, read, failed, fellBackToSms, clicked). Archived campaigns are hidden. Read-only: creating, scheduling or sending a campaign happens in the web app.",
+        scope: 'campaigns:read',
+        method: 'GET',
+        path: '/campaigns',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                q: { type: 'string', maxLength: 120, description: 'Free-text search over the campaign name.' },
+                status: {
+                    type: 'string',
+                    enum: ['DRAFT', 'SCHEDULED', 'SENDING', 'SENT', 'FAILED', 'CANCELLED']
+                },
+                channel: { type: 'string', enum: ['RCS', 'WHATSAPP'] },
+                page: { type: 'number', minimum: 1 },
+                pageSize: { type: 'number', minimum: 1, maximum: 100 }
+            },
+            additionalProperties: false
+        },
+        toRequest: (a) => ({
+            method: 'GET',
+            path: '/campaigns',
+            query: {
+                q: a.q,
+                status: a.status,
+                channel: a.channel,
+                page: a.page,
+                pageSize: a.pageSize
+            }
+        })
+    },
+    {
+        name: 'get_campaign_analytics',
+        description: "Campaign analytics, the same figures as the web app's Analytics page: totals and rates (delivered, read, clicked, failed, fell back to SMS) over the last N days (default 30, max 365), a daily series (UTC days; hourly for a 1-day window), failure classes by provider error code, after-delivery outcomes (replied, opportunity, not interested) and a per-campaign table. Pass broadcastId (a list_campaigns id) to narrow every figure to one campaign over its own lifetime. Aggregate only — no phone numbers or message text.",
+        scope: 'campaigns:read',
+        method: 'GET',
+        path: '/analytics',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                channel: {
+                    type: 'string',
+                    enum: ['RCS', 'WHATSAPP'],
+                    description: 'Only this channel. Omit for every campaign.'
+                },
+                days: { type: 'number', minimum: 1, maximum: 365 },
+                broadcastId: { type: 'string', description: 'One campaign (its list_campaigns id).' }
+            },
+            additionalProperties: false
+        },
+        toRequest: (a) => ({
+            method: 'GET',
+            path: '/analytics',
+            query: { channel: a.channel, days: a.days, broadcastId: a.broadcastId }
+        })
+    },
+    // ── Campaign groups (named sets of campaigns — bookkeeping, never a send) ──
+    {
+        name: 'list_campaign_groups',
+        description: "List YOUR org's campaign groups — named sets of campaigns filed together (an event, a launch, a quarter) — most recently changed first, each with its member campaign ids, campaign count and combined delivery funnel (every member's funnel added together, from cached figures). Pass broadcastId (a list_campaigns id) for only the groups that campaign is in.",
+        scope: 'campaigns:read',
+        method: 'GET',
+        path: '/campaign-groups',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                broadcastId: {
+                    type: 'string',
+                    description: 'Only the groups this campaign (a list_campaigns id) is in.'
+                }
+            },
+            additionalProperties: false
+        },
+        toRequest: (a) => ({
+            method: 'GET',
+            path: '/campaign-groups',
+            query: { broadcastId: a.broadcastId }
+        })
+    },
+    {
+        name: 'get_campaign_group',
+        description: 'One campaign group: its member campaigns (status, channel, schedule and each funnel, refreshed when stale) and their combined funnel. Campaigns deleted since they were filed are left out.',
+        scope: 'campaigns:read',
+        method: 'GET',
+        path: '/campaign-groups/:id',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string' } },
+            required: ['id'],
+            additionalProperties: false
+        },
+        toRequest: (a) => ({
+            method: 'GET',
+            path: `/campaign-groups/${encodeURIComponent(a.id)}`
+        })
+    },
+    {
+        name: 'create_campaign_group',
+        description: 'Create a campaign group, optionally filing campaigns (list_campaigns ids) in it at once. Names are unique per org, ignoring case and spacing. A group never changes who a campaign reaches or when it sends; a campaign may be in several groups.',
+        scope: 'campaigns:write',
+        method: 'POST',
+        path: '/campaign-groups',
+        successStatus: 201,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', minLength: 1, maxLength: 120 },
+                description: { type: 'string', maxLength: 500 },
+                broadcastIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    maxItems: 500,
+                    description: 'Campaigns (list_campaigns ids) to start the group with.'
+                }
+            },
+            required: ['name'],
+            additionalProperties: false
+        },
+        toRequest: (a) => ({
+            method: 'POST',
+            path: '/campaign-groups',
+            body: {
+                name: a.name,
+                description: a.description,
+                broadcastIds: a.broadcastIds
+            }
+        })
+    },
+    {
+        name: 'update_campaign_group',
+        description: "Rename a campaign group or change its description (null clears it). Only the fields you pass change; use add_campaigns_to_group / remove_campaigns_from_group to change its campaigns.",
+        scope: 'campaigns:write',
+        method: 'PATCH',
+        path: '/campaign-groups/:id',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string' },
+                name: { type: 'string', minLength: 1, maxLength: 120 },
+                description: { type: ['string', 'null'], maxLength: 500 }
+            },
+            required: ['id'],
+            additionalProperties: false
+        },
+        toRequest: (a) => ({
+            method: 'PATCH',
+            path: `/campaign-groups/${encodeURIComponent(a.id)}`,
+            body: { name: a.name, description: a.description }
+        })
+    },
+    {
+        name: 'delete_campaign_group',
+        description: 'Delete a campaign group. Only the group goes: its campaigns, their recipients and their results are untouched.',
+        scope: 'campaigns:write',
+        method: 'DELETE',
+        path: '/campaign-groups/:id',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string' } },
+            required: ['id'],
+            additionalProperties: false
+        },
+        toRequest: (a) => ({
+            method: 'DELETE',
+            path: `/campaign-groups/${encodeURIComponent(a.id)}`
+        })
+    },
+    {
+        name: 'add_campaigns_to_group',
+        description: 'File campaigns (list_campaigns ids) in a campaign group. Idempotent: a campaign already in the group stays where it is. Returns the group with its campaigns.',
+        scope: 'campaigns:write',
+        method: 'POST',
+        path: '/campaign-groups/:id/campaigns',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string' },
+                broadcastIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 1,
+                    maxItems: 500
+                }
+            },
+            required: ['id', 'broadcastIds'],
+            additionalProperties: false
+        },
+        toRequest: (a) => ({
+            method: 'POST',
+            path: `/campaign-groups/${encodeURIComponent(a.id)}/campaigns`,
+            body: { broadcastIds: a.broadcastIds }
+        })
+    },
+    {
+        name: 'remove_campaigns_from_group',
+        description: 'Take campaigns out of a campaign group. The campaigns themselves are untouched; ids not in the group are ignored. Returns the group with its campaigns.',
+        scope: 'campaigns:write',
+        method: 'POST',
+        path: '/campaign-groups/:id/campaigns/remove',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string' },
+                broadcastIds: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 1,
+                    maxItems: 500
+                }
+            },
+            required: ['id', 'broadcastIds'],
+            additionalProperties: false
+        },
+        toRequest: (a) => ({
+            method: 'POST',
+            path: `/campaign-groups/${encodeURIComponent(a.id)}/campaigns/remove`,
+            body: { broadcastIds: a.broadcastIds }
+        })
     }
 ];
 /** Look up a tool by name. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rcs-campaigns/agent-toolkit",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "mcpName": "com.rcs-campaigns/campaigns",
   "description": "Agent skins for the RCS Campaigns gateway: an MCP server (rcs-mcp / wa-mcp) and a CLI (rcs / wa) over one shared client.",
   "license": "UNLICENSED",
@@ -63,7 +63,7 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit --incremental --tsBuildInfoFile node_modules/.cache/tsc/typecheck.tsbuildinfo",
     "test": "vitest run",
     "test:watch": "vitest"
   }