@indemn/cli 1.7.8 → 1.7.9

package/dist/sdk/campaigns.d.ts

@@ -1,13 +1,29 @@
 import type { IndemnClient } from './client.js';
+export type CampaignStatus = 'draft' | 'running' | 'paused' | 'archived';
+/** A touchpoint in a campaign's draft, found by its key. */
+export type Touchpoint = {
+    key: string;
+} & Record<string, unknown>;
+type Draft = {
+    audience?: unknown;
+    touchpoints?: Touchpoint[];
+    escalation_policy?: unknown;
+    channel_policy?: unknown;
+};
+type Envelope = {
+    total?: number;
+    items?: Array<Record<string, unknown>>;
+};
 /**
- * Campaigns, READ-ONLY by design, through copilot's proxy to the campaigns
- * service. The CLI never publishes a campaign, sends a communication or
- * triggers a book sync; those act on real customers.
+ * Campaigns through copilot's proxy to the campaigns service: reads, and
+ * writes to configuration only (WRITABLE). The CLI never sends a
+ * communication, runs a book sync or deletes; those act on real customers.
  */
 export declare class CampaignsSDK {
     private client;
     constructor(client: IndemnClient);
     private read;
+    private write;
     list(filter?: {
         status?: string;
         solutionId?: string;
@@ -31,5 +47,68 @@ export declare class CampaignsSDK {
     /** A template; with versions: true, its versions (where subject and body live). */
     template(id: string, versions?: boolean): Promise<unknown>;
     templateSkills(solutionId?: string): Promise<unknown>;
+    templateSkill(id: string): Promise<{
+        name?: string;
+        instructions?: string;
+    }>;
+    books(filter?: {
+        solutionId?: string;
+        limit?: number;
+    }): Promise<Envelope>;
+    book(id: string): Promise<{
+        name?: string;
+    }>;
+    createCampaign(input: {
+        solution_id: string;
+        book_id: string;
+        name: string;
+        campaign_type: string;
+        entry?: string;
+        closes?: string;
+    }): Promise<{
+        id: string;
+    }>;
+    /** Change parts of the draft; the rest of it (its touchpoints among it) stays as it is. */
+    updateDraft(id: string, parts: Omit<Draft, 'touchpoints'>): Promise<Draft>;
+    /** Add a touchpoint, or change the one with its key (only the fields given). A new one drafts unless told to
+     *  send; a template given without a version is pinned to its latest. */
+    setTouchpoint(id: string, touchpoint: Touchpoint): Promise<Draft>;
+    publish(id: string, changeSummary?: string): Promise<unknown>;
+    setStatus(id: string, status: CampaignStatus): Promise<unknown>;
+    createTemplate(input: Record<string, unknown> & {
+        uses_variables?: string[];
+    }): Promise<unknown>;
+    private latestTemplateVersion;
+    /** A new version of the template: its latest one with the changes given. */
+    updateTemplate(id: string, changes: Record<string, unknown> & {
+        uses_variables?: string[];
+    }): Promise<unknown>;
+    createTemplateSkill(input: {
+        solution_id?: string;
+        key: string;
+        name: string;
+        instructions: string;
+    }): Promise<unknown>;
+    updateTemplateSkill(id: string, changes: {
+        name?: string;
+        instructions?: string;
+    }): Promise<unknown>;
+    createBook(input: {
+        solution_id: string;
+        name: string;
+        schema_id?: string;
+        source?: unknown;
+    }): Promise<{
+        id: string;
+    }>;
+    /** Change the parts of a book that are given, each its own call in the service. Keys are the book's schema
+     *  keys; identity keys change only while the book has no records. */
+    updateBook(id: string, changes: {
+        source?: unknown;
+        field_map?: unknown[];
+        identity_keys?: string[];
+        display?: unknown;
+    }): Promise<unknown>;
 }
+export {};
 //# sourceMappingURL=campaigns.d.ts.map

package/dist/sdk/campaigns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"campaigns.d.ts","sourceRoot":"","sources":["../../src/sdk/campaigns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAehD;;;;GAIG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;YAE1B,IAAI;IAKlB,IAAI,CAAC,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAO1I,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjC,2FAA2F;IAC3F,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,kBAAkB,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlH,SAAS,CAAC,MAAM,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAOjI,mFAAmF;IACnF,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxD,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGtD"}
+{"version":3,"file":"campaigns.d.ts","sourceRoot":"","sources":["../../src/sdk/campaigns.ts"],"names":[],"mappings":"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"}

package/dist/sdk/campaigns.js

@@ -1,5 +1,5 @@
 import { CliError, EXIT } from '../core/runtime.js';
-/** Paths of the campaigns service the CLI may read. Everything else, and every write, is refused. */
+/** Paths of the campaigns service the CLI may read. Everything else is refused. */
 const READABLE = [
     /^\/campaigns$/,
     /^\/campaigns\/[\w-]+$/,
@@ -9,11 +9,34 @@ const READABLE = [
     /^\/templates\/[\w-]+\/versions$/,
     /^\/template-skills$/,
     /^\/template-skills\/[\w-]+$/,
+    /^\/books$/,
+    /^\/books\/[\w-]+$/,
 ];
+/** What the CLI may change: campaigns and their drafts (touchpoints live there), publish and status, templates
+ *  (each change a new version), template skills and books. Never sending or resolving anything, book runs,
+ *  uploads, test ticks or enrollments, and no deletes: those act on real customers or cannot be undone. */
+const WRITABLE = [
+    ['POST', /^\/campaigns$/],
+    ['PUT', /^\/campaigns\/[\w-]+\/draft$/],
+    ['POST', /^\/campaigns\/[\w-]+\/(publish|status)$/],
+    ['POST', /^\/templates$/],
+    ['POST', /^\/templates\/[\w-]+\/versions$/],
+    ['POST', /^\/template-skills$/],
+    ['PUT', /^\/template-skills\/[\w-]+$/],
+    ['POST', /^\/books$/],
+    ['PATCH', /^\/books\/[\w-]+\/source$/],
+    ['PUT', /^\/books\/[\w-]+\/(field-map|identity-keys|display)$/],
+];
+// A template version is whole: a change starts from the latest version's content.
+const TEMPLATE_CONTENT = ['subject', 'body', 'html', 'uses_variables', 'selection_tags', 'skills', 'batch_row'];
+const given = (o) => Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined));
+// Templates declare the variables they read as {key, required, example}; given as keys, a key the template already
+// declares keeps its entry.
+const declare = (keys, current = []) => keys?.map((key) => current.find((v) => v.key === key) ?? { key });
 /**
- * Campaigns, READ-ONLY by design, through copilot's proxy to the campaigns
- * service. The CLI never publishes a campaign, sends a communication or
- * triggers a book sync; those act on real customers.
+ * Campaigns through copilot's proxy to the campaigns service: reads, and
+ * writes to configuration only (WRITABLE). The CLI never sends a
+ * communication, runs a book sync or deletes; those act on real customers.
  */
 export class CampaignsSDK {
     client;
@@ -25,6 +48,11 @@ export class CampaignsSDK {
             throw new CliError(`Campaigns path ${path} is not readable from the CLI.`, EXIT.NEEDS_INPUT);
         return this.client.copilotGet(`/organization/:org_id/campaigns-service${path}`, query);
     }
+    async write(method, path, body) {
+        if (!WRITABLE.some(([m, r]) => m === method && r.test(path)))
+            throw new CliError(`Campaigns ${method} ${path} is not allowed from the CLI.`, EXIT.NEEDS_INPUT);
+        return this.client.copilotRequestRaw(method, `/organization/:org_id/campaigns-service${path}`, body);
+    }
     list(filter = {}) {
         const q = { limit: String(Math.min(filter.limit ?? 50, 500)), skip: String(filter.skip ?? 0) };
         if (filter.status)
@@ -55,5 +83,79 @@ export class CampaignsSDK {
     templateSkills(solutionId) {
         return this.read('/template-skills', solutionId ? { solution_id: solutionId } : undefined);
     }
+    templateSkill(id) {
+        return this.read(`/template-skills/${id}`);
+    }
+    books(filter = {}) {
+        const q = { limit: String(Math.min(filter.limit ?? 50, 200)) }; // the service allows 200
+        if (filter.solutionId)
+            q.solution_id = filter.solutionId;
+        return this.read('/books', q);
+    }
+    book(id) {
+        return this.read(`/books/${id}`);
+    }
+    createCampaign(input) {
+        return this.write('POST', '/campaigns', given(input));
+    }
+    /** Change parts of the draft; the rest of it (its touchpoints among it) stays as it is. */
+    async updateDraft(id, parts) {
+        const { draft } = await this.read(`/campaigns/${id}`);
+        return this.write('PUT', `/campaigns/${id}/draft`, { ...draft, ...given(parts) });
+    }
+    /** Add a touchpoint, or change the one with its key (only the fields given). A new one drafts unless told to
+     *  send; a template given without a version is pinned to its latest. */
+    async setTouchpoint(id, touchpoint) {
+        const { draft } = await this.read(`/campaigns/${id}`);
+        const current = draft?.touchpoints ?? [];
+        const existing = current.find((t) => t.key === touchpoint.key);
+        const tp = { ...(existing ?? { terminal_action: 'draft' }), ...given(touchpoint), key: touchpoint.key };
+        if (typeof touchpoint.template_id === 'string' && touchpoint.template_version_n === undefined) {
+            tp.template_version_n = Number((await this.latestTemplateVersion(touchpoint.template_id))?.version_n ?? 1);
+        }
+        const touchpoints = existing ? current.map((t) => (t.key === tp.key ? tp : t)) : [...current, tp];
+        return this.write('PUT', `/campaigns/${id}/draft`, { ...draft, touchpoints });
+    }
+    publish(id, changeSummary) {
+        return this.write('POST', `/campaigns/${id}/publish`, { change_summary: changeSummary ?? '' });
+    }
+    setStatus(id, status) {
+        return this.write('POST', `/campaigns/${id}/status`, { status });
+    }
+    createTemplate(input) {
+        return this.write('POST', '/templates', given({ ...input, uses_variables: declare(input.uses_variables) }));
+    }
+    async latestTemplateVersion(id) {
+        return (await this.read(`/templates/${id}/versions`)).items?.[0]; // newest first
+    }
+    /** A new version of the template: its latest one with the changes given. */
+    async updateTemplate(id, changes) {
+        const latest = (await this.latestTemplateVersion(id)) ?? {};
+        const kept = Object.fromEntries(TEMPLATE_CONTENT.filter((k) => k in latest).map((k) => [k, latest[k]]));
+        return this.write('POST', `/templates/${id}/versions`, { ...kept, ...given({ ...changes, uses_variables: declare(changes.uses_variables, latest.uses_variables) }) });
+    }
+    createTemplateSkill(input) {
+        return this.write('POST', '/template-skills', input);
+    }
+    async updateTemplateSkill(id, changes) {
+        const skill = await this.templateSkill(id);
+        return this.write('PUT', `/template-skills/${id}`, { name: skill.name, instructions: skill.instructions, ...given(changes) });
+    }
+    createBook(input) {
+        return this.write('POST', '/books', given(input));
+    }
+    /** Change the parts of a book that are given, each its own call in the service. Keys are the book's schema
+     *  keys; identity keys change only while the book has no records. */
+    async updateBook(id, changes) {
+        if (changes.source !== undefined)
+            await this.write('PATCH', `/books/${id}/source`, { source: changes.source });
+        if (changes.field_map !== undefined)
+            await this.write('PUT', `/books/${id}/field-map`, { field_map: changes.field_map });
+        if (changes.identity_keys !== undefined)
+            await this.write('PUT', `/books/${id}/identity-keys`, { identity_keys: changes.identity_keys });
+        if (changes.display !== undefined)
+            await this.write('PUT', `/books/${id}/display`, { display: changes.display });
+        return this.book(id);
+    }
 }
 //# sourceMappingURL=campaigns.js.map

package/dist/sdk/campaigns.js.map

@@ -1 +1 @@
-{"version":3,"file":"campaigns.js","sourceRoot":"","sources":["../../src/sdk/campaigns.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEpD,qGAAqG;AACrG,MAAM,QAAQ,GAAG;IACf,eAAe;IACf,uBAAuB;IACvB,oEAAoE;IACpE,eAAe;IACf,uBAAuB;IACvB,iCAAiC;IACjC,qBAAqB;IACrB,6BAA6B;CAC9B,CAAC;AAEF;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACH;IAApB,YAAoB,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;IAAG,CAAC;IAEpC,KAAK,CAAC,IAAI,CAAI,IAAY,EAAE,KAA8B;QAChE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,IAAI,gCAAgC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACtI,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAI,0CAA0C,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,CAAC,SAAkF,EAAE;QACvF,MAAM,CAAC,GAA2B,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC;QACvH,IAAI,MAAM,CAAC,MAAM;YAAE,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5C,IAAI,MAAM,CAAC,UAAU;YAAE,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;QACzD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,2FAA2F;IAC3F,MAAM,CAAC,EAAU,EAAE,IAA6D,EAAE,IAAa;QAC7F,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1F,CAAC;IAED,SAAS,CAAC,SAAoE,EAAE;QAC9E,MAAM,CAAC,GAA2B,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;QACvF,IAAI,MAAM,CAAC,OAAO;YAAE,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/C,IAAI,MAAM,CAAC,UAAU;YAAE,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;QACzD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,mFAAmF;IACnF,QAAQ,CAAC,EAAU,EAAE,QAAQ,GAAG,KAAK;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,cAAc,CAAC,UAAmB;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7F,CAAC;CACF"}
+{"version":3,"file":"campaigns.js","sourceRoot":"","sources":["../../src/sdk/campaigns.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indemn/cli",
-  "version": "1.7.8",
+  "version": "1.7.9",
   "description": "CLI, MCP server, and plugin for managing Indemn AI agents",
   "type": "module",
   "main": "./dist/sdk/index.js",

package/src/mcp/tool-meta.ts

@@ -29,6 +29,17 @@ const write = (title: string, extra: Partial<ToolAnnotations> = {}): ToolMeta =>
   annotations: { title, readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false, ...extra },
 });
 
+/** The parts a call changes, in words: "audience, channel policy". */
+const parts = (a: Record<string, unknown>, keys: string[]) => keys.filter((k) => a[k] !== undefined && a[k] !== '').map((k) => k.replace(/_/g, ' ')).join(', ');
+
+/** A book change with its new values, so the person sees what they approve: "field map to Company → account.name". */
+const bookChanges = (a: Record<string, any>) => [
+  a.source !== undefined && `source to ${a.source?.kind ?? JSON.stringify(a.source)}`,
+  Array.isArray(a.field_map) && `field map to ${a.field_map.map((m: { source_path?: string; schema_key?: string }) => `${m.source_path} → ${m.schema_key}`).join(', ')}`,
+  Array.isArray(a.identity_keys) && `identity keys to ${a.identity_keys.join(', ')}`,
+  a.display && `display to ${['primary', 'secondary'].filter((k) => Array.isArray(a.display[k])).map((k) => `${k} ${a.display[k].join(', ')}`).join('; ')}`,
+].filter(Boolean).join('; ');
+
 /** Overwrites or removes something that cannot be restored from the tool itself. */
 const destroy = (title: string, extra: Partial<ToolAnnotations> = {}): ToolMeta => ({
   title,
@@ -217,8 +228,44 @@ export const TOOL_META: Record<string, ToolMeta> = {
   // Billing (read-only)
   get_billing: read('Billing status, invoices, usage or plans'),
 
-  // Campaigns (read-only)
-  get_campaigns: read('Read campaigns and templates'),
+  // Campaigns: each change is approved on a card; nothing here sends a message, and nothing deletes.
+  get_campaigns: read('Read campaigns, templates and books'),
+  save_campaign: {
+    ...write('Create or change campaign'), guard: true,
+    describe: (a) => a.campaign_id
+      ? `This will change the ${parts(a, ['audience', 'escalation_policy', 'channel_policy'])} in the draft of campaign ${a.campaign_id} (it takes effect when the campaign is published).`
+      : `This will create campaign "${a.name}" as a draft; it sends nothing until it is published and started.`,
+  },
+  set_touchpoint: {
+    ...write('Add or change touchpoint', { idempotentHint: true }), guard: true,
+    describe: (a) => `This will add or change touchpoint "${a.key}" in the draft of campaign ${a.campaign_id}${a.channel ? ` (${a.channel})` : ''}${a.terminal_action === 'send' ? '. It is set to SEND to customers directly once the campaign is published and running' : ''}.`,
+  },
+  publish_campaign: { ...write('Publish campaign'), guard: true, describe: (a) => `This will publish the draft of campaign ${a.campaign_id} as its next version; if it is running, it uses it from its next run.` },
+  set_campaign_status: {
+    ...write('Start, pause or archive campaign'), guard: true,
+    describe: (a) => a.status === 'running'
+      ? `This will START campaign ${a.campaign_id}: it enrols the matching records of its book and runs its touchpoints (touchpoints set to send reach real customers).`
+      : a.status === 'archived' ? `This will archive campaign ${a.campaign_id} for good: it cannot be started again.`
+      : `This will pause campaign ${a.campaign_id}: its touchpoints stop until it is started again.`,
+  },
+  save_campaign_template: {
+    ...write('Create or change campaign template'), guard: true,
+    describe: (a) => a.template_id
+      ? `This will save a new version of template ${a.template_id} (${parts(a, ['subject', 'body', 'html', 'uses_variables', 'skills', 'selection_tags'])}); touchpoints keep the version they are set to until it is set again.`
+      : `This will create ${a.channel} template "${a.name}".`,
+  },
+  save_template_skill: {
+    ...write('Create or change template skill'), guard: true,
+    describe: (a) => a.template_skill_id
+      ? `This will change template skill ${a.template_skill_id} (${parts(a, ['name', 'instructions'])}); templates using it write with it from their campaigns' next run.`
+      : `This will create template skill "${a.name}".`,
+  },
+  save_book: {
+    ...write('Create or change book'), guard: true,
+    describe: (a) => a.book_id
+      ? `This will change book ${a.book_id}: ${bookChanges(a)}.`
+      : `This will create book "${a.name}" for this solution.`,
+  },
 
   // V2 platform and Jarvis (Darwin)
   platform_list: read('List V2 platform items'),

package/src/mcp/tools.ts

@@ -13,7 +13,7 @@ import { DistributionSDK } from '../sdk/distribution.js';
 import { AnalyticsSDK, AuditSDK, OrgSettingsSDK } from '../sdk/analytics.js';
 import { TicketsSDK } from '../sdk/tickets.js';
 import { BillingSDK } from '../sdk/billing.js';
-import { CampaignsSDK } from '../sdk/campaigns.js';
+import { CampaignsSDK, type Touchpoint } from '../sdk/campaigns.js';
 import { PlatformSDK } from '../sdk/platform.js';
 import { jarvisChat } from '../sdk/jarvis-chat.js';
 import { applyConfigChange, describePlan, liveText, mayBeLive, modelArg, planConfigChange, type ConfigChange } from '../sdk/config-change.js';
@@ -168,6 +168,11 @@ const skillDefinition = z.preprocess(parseJsonText, z.object({
   }).passthrough()).optional(),
 }).passthrough());
 
+// Campaigns are on for an org only when Indemn has turned Solutions on: the dashboard hides them otherwise, and the
+// campaigns service does not check it, so these tools ask first (before any approval card).
+const CAMPAIGN_TOOLS = new Set(['get_campaigns', 'save_campaign', 'set_touchpoint', 'publish_campaign', 'set_campaign_status', 'save_campaign_template', 'save_template_skill', 'save_book']);
+const SOLUTIONS_OFF = 'Campaigns are off for this organization: Solutions is not turned on (the dashboard hides campaigns too). Indemn staff can turn it on with set_org_admin_settings (solutions: true); anyone else asks the Indemn team to turn it on.';
+
 export function registerTools(server: McpServer, client: IndemnClient): Registry {
   // Role awareness: the folder's linked org (or INDEMN_ORG_ID) narrows what counts; otherwise any org.
   const orgInView = () => process.env.INDEMN_ORG_ID || client.getLink()?.org_id || undefined;
@@ -177,6 +182,10 @@ export function registerTools(server: McpServer, client: IndemnClient): Registry
       visible: (name) => usableSomewhere(name, currentAccess(client), orgInView()),
       // Refuse early only when the saved access still says no after asking again (it may be stale).
       deny: async (name, orgId) => {
+        if (CAMPAIGN_TOOLS.has(name) && orgId) {
+          const on = await client.copilotGet<{ enableSolutions?: boolean }>(`/organization/${orgId}/configurations`).then((c) => c?.enableSolutions === true, () => false);
+          if (!on) return SOLUTIONS_OFF;
+        }
         if (!orgDenial(name, currentAccess(client), orgId)) return null;
         return orgDenial(name, await refreshAccess(client), orgId);
       },
@@ -219,7 +228,12 @@ export function registerTools(server: McpServer, client: IndemnClient): Registry
         add(args.ticket_id, null, (id) => tickets.get(id).then((t) => { const x = t as { ticket_ref?: string; title?: string }; return label([x.ticket_ref, x.title].filter(Boolean).join(' ')); })),
         add(args.rule_id, null, (id) => tickets.listRules({ includeTrashed: true }).then((rules) => label((rules as Array<{ _id?: string; id?: string; name?: string }>).find((r) => (r._id ?? r.id) === id)?.name))),
         add(args.distribution_id, null, (id) => distribution.list().then((d) => { const p = (d.paths ?? []).find((x) => x.id === id); return label(p ? `${p.path_name ?? ''} (${p.host_name ?? '*'}${p.path_expression ?? ''})`.trim() : undefined); })),
-        add(args.template_id, null, (id) => distribution.listTemplates().then((ts) => label((ts as Array<{ _id?: string; name?: string }>).find((t) => t._id === id)?.name))),
+        // A website template, else a campaign template.
+        add(args.template_id, null, (id) => distribution.listTemplates().then((ts) => label((ts as Array<{ _id?: string; name?: string }>).find((t) => t._id === id)?.name))
+          .then((l) => l.name ? l : new CampaignsSDK(client).template(id).then((t) => label((t as { name?: unknown }).name), () => l))),
+        add(args.campaign_id, 'campaign', (id) => new CampaignsSDK(client).get(id) as Promise<{ name?: unknown }>),
+        add(args.book_id, 'book', (id) => new CampaignsSDK(client).book(id)),
+        add(args.template_skill_id, 'template skill', (id) => new CampaignsSDK(client).templateSkill(id)),
         add(args.owner_id, null, (id) => orgs.listMembers().then((ms) => { const m = ms.find((x) => x.user_id === id); return label(m?.name ?? m?.email); })),
         agentId && typeof args.function_id === 'string' ? add(args.parameter_id, null, (id) => skillOf(agentId, String(args.function_id)).then((s) => functions.listParameters(agentId, s._id)).then((ps) => label(ps.find((p) => p._id === id)?.name))) : undefined,
         add(orgId, null, (id) => client.copilotGet<{ organization?: { name?: string } }>(`/organization/${id}`).then((r) => r.organization)),
@@ -1860,10 +1874,10 @@ export function registerTools(server: McpServer, client: IndemnClient): Registry
 
   reg.tool(
     'get_campaigns',
-    'Read-only campaigns: list, one campaign (campaign_id), its counts / forecast / next-touchpoints / versions, templates, one template (template_id, versions: true for subject and body), or template skills.',
+    'Read campaigns: list, one campaign (campaign_id, with its draft and touchpoints), its counts / forecast / next-touchpoints / versions, templates, one template (template_id, versions: true for subject and body), template skills, books, or one book (book_id).',
     {
-      what: z.enum(['list', 'campaign', 'counts', 'forecast', 'next-touchpoints', 'versions', 'templates', 'template', 'template-skills']),
-      campaign_id: z.string().optional(), template_id: z.string().optional(), versions: z.boolean().optional(),
+      what: z.enum(['list', 'campaign', 'counts', 'forecast', 'next-touchpoints', 'versions', 'templates', 'template', 'template-skills', 'books', 'book']),
+      campaign_id: z.string().optional(), template_id: z.string().optional(), book_id: z.string().optional(), versions: z.boolean().optional(),
       status: z.string().optional(), solution_id: z.string().optional(), channel: z.string().optional(),
       days: z.number().int().min(1).max(365).optional(), limit: z.number().int().min(1).max(500).optional(),
     },
@@ -1877,12 +1891,155 @@ export function registerTools(server: McpServer, client: IndemnClient): Registry
           case 'templates': return success(await c.templates({ channel: args.channel, solutionId: args.solution_id, limit: args.limit }));
           case 'template': return success(await c.template(need(args.template_id, 'template_id'), Boolean(args.versions)));
           case 'template-skills': return success(await c.templateSkills(args.solution_id));
+          case 'books': return success(await c.books({ solutionId: args.solution_id, limit: args.limit }));
+          case 'book': return success(await c.book(need(args.book_id, 'book_id')));
           default: return success(await c.detail(need(args.campaign_id, 'campaign_id'), args.what, args.days));
         }
       } catch (err) { return error(err); }
     },
   );
 
+  // Campaigns configuration: every change is approved on a card. Nothing here sends a message, runs a book sync or
+  // deletes (CampaignsSDK WRITABLE); a campaign ends archived. A save_* tool given an id changes that item, else creates.
+  const campaigns = new CampaignsSDK(client);
+  type CampaignArgs = Record<string, any>;
+  // Only the tool's own arguments reach the service: not confirm/org_id, and not the "" or null a model fills unused
+  // fields with (an empty value never blanks a saved field).
+  const own = (args: CampaignArgs): CampaignArgs => Object.fromEntries(Object.entries(args).filter(([k, v]) => k !== 'confirm' && k !== 'org_id' && v !== '' && v !== null));
+  const lacking = (a: CampaignArgs, keys: string[]) => keys.filter((k) => a[k] === undefined);
+  // `problem` is checked before the card: a call that cannot work is answered at once, without asking or sending.
+  const campaignTool = (name: string, description: string, shape: Record<string, z.ZodTypeAny>, run: (a: CampaignArgs) => Promise<unknown>, problem: (a: CampaignArgs) => string | null = () => null) =>
+    reg.tool(name, description, shape, async (args) => {
+      try {
+        const a = own(args);
+        const p = problem(a);
+        if (p) throw new Error(p);
+        return success(await run(a));
+      } catch (err) { return error(err); }
+    }, { guardWhen: async (args) => problem(own(args)) === null });
+  // A create and then a change: if the change is refused, the item exists, so it is changed with its id next time.
+  const thenChange = async (what: string, made: { id: string }, change: () => Promise<unknown>) => {
+    try { return await change(); } catch (err) { throw new Error(`The ${what} was created (id ${made.id}), but ${err instanceof Error ? err.message : String(err)}. Change it with its id; do not create it again.`); }
+  };
+  const rule = (what: string) => jsonObject().describe(`${what}: a rule as an object or JSON text, e.g. {"all":[{"field":"status","op":"eq","value":"active"},{"field":"derived.days_out","op":"lte","value":60}]}. Ops: eq ne lt lte gt gte in nin exists missing contains; all / any / not combine rules.`);
+  const DRAFT_PARTS = ['audience', 'escalation_policy', 'channel_policy'];
+
+  campaignTool(
+    'save_campaign',
+    "Create a campaign (no campaign_id) as a draft for a solution's book, or change a campaign's draft: its audience (which records belong) and escalation and channel policies; what is not given stays. Touchpoints are set with set_touchpoint. Nothing is sent until the campaign is published (publish_campaign) and started (set_campaign_status running). Find the solution with list_solutions and its book with get_campaigns (what: books).",
+    {
+      campaign_id: z.string().optional().describe('The campaign to change; leave out to create one'),
+      solution_id: z.string().optional(), book_id: z.string().optional(), name: z.string().optional(),
+      campaign_type: z.string().optional().describe('To create: e.g. renewal, outreach'),
+      entry: z.enum(['rolling', 'cohort']).optional().describe('To create: rolling (records join as they match, the default) or cohort (a fixed set, with closes)'),
+      closes: z.string().optional().describe('To create a cohort campaign: ISO date it closes'),
+      audience: rule('Which records belong').optional(),
+      escalation_policy: jsonObject().optional().describe('e.g. {"after":{"touches_exhausted":true},"on_hard_failure":"escalate_immediately","then":"create_work_item","assign_to":null}'),
+      channel_policy: jsonObject().optional().describe('e.g. {"quiet_hours":null,"max_per_record_per_window":null}'),
+    },
+    async ({ campaign_id, audience, escalation_policy, channel_policy, ...create }) => {
+      const parts = { audience, escalation_policy, channel_policy };
+      if (campaign_id) return campaigns.updateDraft(campaign_id, parts);
+      const made = await campaigns.createCampaign(create as Parameters<CampaignsSDK['createCampaign']>[0]);
+      return DRAFT_PARTS.some((k) => (parts as CampaignArgs)[k] !== undefined) ? thenChange('campaign', made, async () => ({ ...made, draft: await campaigns.updateDraft(made.id, parts) })) : made;
+    },
+    (a) => a.campaign_id
+      ? (DRAFT_PARTS.some((k) => a[k] !== undefined) ? null : 'Nothing to change: give audience, escalation_policy or channel_policy (a campaign is not renamed here).')
+      : (lacking(a, ['solution_id', 'book_id', 'name', 'campaign_type']).length ? `To create a campaign also give ${lacking(a, ['solution_id', 'book_id', 'name', 'campaign_type']).join(', ')}; to change one, give its campaign_id.` : null),
+  );
+
+  campaignTool(
+    'set_touchpoint',
+    "Add a touchpoint to a campaign's draft, or change the one with the same key (only the fields given change). when is a trigger rule: days before the due date ({\"field\":\"derived.days_out\",\"op\":\"lte\",\"value\":45}), a day of the month (calendar.day_of_month), days without a reply (silence.days) or an inbound intent (intent). terminal_action draft (the default) prepares the message for a person to review; send sends it to the customer, so use send only when the person asks for it. A template given without a version is pinned to its latest.",
+    {
+      campaign_id: z.string(),
+      key: z.string().trim().min(1).describe('Unique in the campaign, e.g. t2_reminder_45'),
+      when: rule('When it fires').optional(),
+      channel: z.enum(['email', 'voice', 'sms']).optional(),
+      terminal_action: z.enum(['draft', 'send']).optional(),
+      order: z.number().int().optional(),
+      template_id: z.string().optional(), template_version_n: z.number().int().optional(),
+      grouping: jsonObject().optional().describe('e.g. {"key":"insured_account","recipient":"resolved"} (key: record, insured_account or fixed_recipient)'),
+      required_variables: jsonArray(z.string()).optional(),
+    },
+    async ({ campaign_id, ...touchpoint }) => campaigns.setTouchpoint(campaign_id, touchpoint as Touchpoint),
+  );
+
+  campaignTool(
+    'publish_campaign',
+    "Publish a campaign's draft as its next version (refused, with every problem listed, while it has no audience or touchpoint). A running campaign uses the new version from its next run.",
+    { campaign_id: z.string(), change_summary: z.string().optional() },
+    async (a) => campaigns.publish(a.campaign_id, a.change_summary),
+  );
+
+  campaignTool(
+    'set_campaign_status',
+    'Start (running), pause (paused) or archive (archived, for good) a campaign. Starting needs a published version; it then enrols the matching records of its book and runs its touchpoints. Campaigns are never deleted: asked to delete one, offer to archive it and say it is archived, not deleted.',
+    { campaign_id: z.string(), status: z.enum(['running', 'paused', 'archived']) },
+    async (a) => campaigns.setStatus(a.campaign_id, a.status),
+  );
+
+  const TEMPLATE_PARTS = ['subject', 'body', 'html', 'uses_variables', 'skills', 'selection_tags'];
+  campaignTool(
+    'save_campaign_template',
+    'Create a campaign message template (no template_id), or change one: a change is saved as its new version, made from the latest one with the fields given. Touchpoints keep the version they are set to until set_touchpoint sets the template again.',
+    {
+      template_id: z.string().optional().describe('The template to change; leave out to create one'),
+      solution_id: z.string().optional(), name: z.string().optional(), channel: z.enum(['email', 'voice', 'sms']).optional(),
+      subject: z.string().optional().describe('Email subject. Placeholders: {{ record.<book field> }}, e.g. {{ record.policy.number }}, or contact.*, campaign.*, enrollment.*'),
+      body: z.string().optional().describe('Message text, with placeholders as in subject'),
+      html: z.string().optional(),
+      uses_variables: jsonArray(z.string()).optional().describe('Every placeholder key the template uses, e.g. ["record.policy.number","contact.first_name"] (the service refuses an undeclared one)'),
+      skills: jsonObject().optional(), selection_tags: jsonObject().optional(),
+      change_summary: z.string().optional(),
+    },
+    async ({ template_id, solution_id, name, channel, ...content }) => template_id
+      ? campaigns.updateTemplate(template_id, content)
+      : campaigns.createTemplate({ solution_id, name, channel, ...content }),
+    (a) => a.template_id
+      ? (TEMPLATE_PARTS.some((k) => a[k] !== undefined) ? null : `Nothing to change: give ${TEMPLATE_PARTS.join(', ')}.`)
+      : (lacking(a, ['solution_id', 'name', 'channel', 'body']).length ? `To create a template also give ${lacking(a, ['solution_id', 'name', 'channel', 'body']).join(', ')}; to change one, give its template_id.` : null),
+  );
+
+  campaignTool(
+    'save_template_skill',
+    "Create a template skill (no template_skill_id): writing instructions a template uses when its message is composed. Or change one's name or instructions; templates using it write with the new text from their campaigns' next run, with no publish.",
+    {
+      template_skill_id: z.string().optional().describe('The skill to change; leave out to create one'),
+      solution_id: z.string().optional(), key: z.string().optional().describe('To create: unique in the solution, e.g. friendly_tone'),
+      name: z.string().optional(), instructions: z.string().optional(),
+    },
+    async ({ template_skill_id, solution_id, key, name, instructions }) => template_skill_id
+      ? campaigns.updateTemplateSkill(template_skill_id, { name, instructions })
+      : campaigns.createTemplateSkill({ solution_id, key, name, instructions }),
+    (a) => a.template_skill_id
+      ? (a.name !== undefined || a.instructions !== undefined ? null : 'Nothing to change: give name or instructions.')
+      : (lacking(a, ['solution_id', 'key', 'name', 'instructions']).length ? `To create a template skill also give ${lacking(a, ['solution_id', 'key', 'name', 'instructions']).join(', ')}; to change one, give its template_skill_id.` : null),
+  );
+
+  const BOOK_PARTS = ['source', 'field_map', 'identity_keys', 'display'];
+  campaignTool(
+    'save_book',
+    "Create a solution's book, the records a campaign works from (no book_id; a solution has one book, so look with get_campaigns what: books first). Or change a book's source, field map (which source column fills which field), identity keys (what makes a record unique; only while it has no records) or display (fields shown for a record); each part given replaces the book's. Keys are the book's schema keys, e.g. policy.number, insured.name.",
+    {
+      book_id: z.string().optional().describe('The book to change; leave out to create one'),
+      solution_id: z.string().optional(), name: z.string().optional(),
+      schema_id: z.string().optional().describe("To create: the entity schema; left out, the solution type's default fields"),
+      source: jsonObject().optional().describe('{"kind":"upload"} (records uploaded as CSV in the dashboard) or {"kind":"connection","integration_id":"…"}'),
+      field_map: jsonArray(jsonObject()).optional().describe('e.g. [{"schema_key":"policy.number","source_path":"Policy #"}]'),
+      identity_keys: jsonArray(z.string()).optional().describe('e.g. ["policy.number"]'),
+      display: jsonObject().optional().describe('e.g. {"primary":["policy.number"],"secondary":["insured.name"]}'),
+    },
+    async ({ book_id, solution_id, name, schema_id, source, ...parts }) => {
+      if (book_id) return campaigns.updateBook(book_id, { source, ...parts });
+      const made = await campaigns.createBook({ solution_id, name, schema_id, source });
+      return Object.keys(parts).length ? thenChange('book', made, () => campaigns.updateBook(made.id, parts)) : made;
+    },
+    (a) => a.book_id
+      ? (BOOK_PARTS.some((k) => a[k] !== undefined) ? null : `Nothing to change: give ${BOOK_PARTS.join(', ')}.`)
+      : (lacking(a, ['solution_id', 'name']).length ? `To create a book also give ${lacking(a, ['solution_id', 'name']).join(', ')}; to change one, give its book_id.` : null),
+  );
+
   const platform = new PlatformSDK(client);
   const platformResource = z.enum(['agents', 'templates', 'components', 'connectors', 'connector-bindings', 'scenarios']);