@setluca/mcp 0.4.0 → 0.5.1

package/dist/generated/route-catalog.js

@@ -141,6 +141,30 @@ export const ROUTE_CATALOG = {
         ],
         "idempotencyRequired": true
     },
+    "leads.drafting.pause": {
+        "method": "POST",
+        "path": "/api/leads/{id}/drafting/pause",
+        "scopes": [
+            "leads:write"
+        ],
+        "idempotencyRequired": true
+    },
+    "leads.drafting.resume": {
+        "method": "POST",
+        "path": "/api/leads/{id}/drafting/resume",
+        "scopes": [
+            "leads:write"
+        ],
+        "idempotencyRequired": true
+    },
+    "conversations.send_status": {
+        "method": "GET",
+        "path": "/api/conversations/{id}/send-status",
+        "scopes": [
+            "conversations:read"
+        ],
+        "idempotencyRequired": false
+    },
     "conversations.summary": {
         "method": "GET",
         "path": "/api/conversations/summary",
@@ -197,6 +221,30 @@ export const ROUTE_CATALOG = {
         ],
         "idempotencyRequired": true
     },
+    "conversations.reply_failure_retry": {
+        "method": "POST",
+        "path": "/api/conversations/{id}/reply-failures/{failureId}/retry",
+        "scopes": [
+            "conversations:write"
+        ],
+        "idempotencyRequired": false
+    },
+    "conversations.reply_failure_dismiss": {
+        "method": "POST",
+        "path": "/api/conversations/{id}/reply-failures/{failureId}/dismiss",
+        "scopes": [
+            "conversations:write"
+        ],
+        "idempotencyRequired": false
+    },
+    "conversations.media_retry": {
+        "method": "POST",
+        "path": "/api/conversations/{id}/messages/{messageId}/media/{mediaId}/retry",
+        "scopes": [
+            "conversations:write"
+        ],
+        "idempotencyRequired": true
+    },
     "reviewQueue.composer": {
         "method": "GET",
         "path": "/api/review-queue/{id}/composer",
@@ -229,6 +277,22 @@ export const ROUTE_CATALOG = {
         ],
         "idempotencyRequired": true
     },
+    "reviewQueue.bulkApprove": {
+        "method": "POST",
+        "path": "/api/review-queue/bulk-approve",
+        "scopes": [
+            "review_queue:write"
+        ],
+        "idempotencyRequired": true
+    },
+    "reviewQueue.bulkReject": {
+        "method": "POST",
+        "path": "/api/review-queue/bulk-reject",
+        "scopes": [
+            "review_queue:write"
+        ],
+        "idempotencyRequired": true
+    },
     "reviewQueue.media.retry": {
         "method": "POST",
         "path": "/api/review-queue/{id}/media/{mediaId}/retry",
@@ -261,6 +325,30 @@ export const ROUTE_CATALOG = {
         ],
         "idempotencyRequired": false
     },
+    "reviewQueue.summary": {
+        "method": "GET",
+        "path": "/api/review-queue/summary",
+        "scopes": [
+            "review_queue:read"
+        ],
+        "idempotencyRequired": false
+    },
+    "reviewQueue.changes": {
+        "method": "GET",
+        "path": "/api/review-queue/changes",
+        "scopes": [
+            "review_queue:read"
+        ],
+        "idempotencyRequired": false
+    },
+    "reviewQueue.drafting": {
+        "method": "GET",
+        "path": "/api/review-queue/drafting",
+        "scopes": [
+            "review_queue:read"
+        ],
+        "idempotencyRequired": false
+    },
     "reviewQueue.objectionVariant": {
         "method": "POST",
         "path": "/api/review-queue/{id}/objection-variant",
@@ -269,6 +357,38 @@ export const ROUTE_CATALOG = {
         ],
         "idempotencyRequired": true
     },
+    "reviewQueue.drafting.cancel": {
+        "method": "POST",
+        "path": "/api/review-queue/drafting/{turnId}/cancel",
+        "scopes": [
+            "review_queue:write"
+        ],
+        "idempotencyRequired": true
+    },
+    "reviewQueue.drafting.retry": {
+        "method": "POST",
+        "path": "/api/review-queue/drafting/{turnId}/retry",
+        "scopes": [
+            "review_queue:write"
+        ],
+        "idempotencyRequired": true
+    },
+    "reviewQueue.drafting.dismiss": {
+        "method": "POST",
+        "path": "/api/review-queue/drafting/{turnId}/dismiss",
+        "scopes": [
+            "review_queue:write"
+        ],
+        "idempotencyRequired": true
+    },
+    "reviewQueue.regenerate": {
+        "method": "POST",
+        "path": "/api/review-queue/{id}/regenerate",
+        "scopes": [
+            "review_queue:write"
+        ],
+        "idempotencyRequired": true
+    },
     "bookings.list": {
         "method": "GET",
         "path": "/api/bookings",
@@ -381,6 +501,22 @@ export const ROUTE_CATALOG = {
         ],
         "idempotencyRequired": false
     },
+    "bookings.recovery.get": {
+        "method": "GET",
+        "path": "/api/bookings/{id}/recovery",
+        "scopes": [
+            "bookings:read"
+        ],
+        "idempotencyRequired": false
+    },
+    "bookings.recovery.stop": {
+        "method": "POST",
+        "path": "/api/bookings/{id}/recovery/stop",
+        "scopes": [
+            "bookings:write"
+        ],
+        "idempotencyRequired": true
+    },
     "bookings.outcome.get": {
         "method": "GET",
         "path": "/api/bookings/{id}/outcome",
@@ -421,6 +557,22 @@ export const ROUTE_CATALOG = {
         ],
         "idempotencyRequired": true
     },
+    "bookings.providerRequests.create": {
+        "method": "POST",
+        "path": "/api/bookings/provider-requests",
+        "scopes": [
+            "bookings:write"
+        ],
+        "idempotencyRequired": true
+    },
+    "bookings.providerRequests.get": {
+        "method": "GET",
+        "path": "/api/bookings/provider-requests/{id}",
+        "scopes": [
+            "bookings:read"
+        ],
+        "idempotencyRequired": false
+    },
     "bookings.outcome.record": {
         "method": "POST",
         "path": "/api/bookings/{id}/outcome",
@@ -981,6 +1133,14 @@ export const ROUTE_CATALOG = {
         ],
         "idempotencyRequired": false
     },
+    "integrations.crm.connections.disconnect": {
+        "method": "POST",
+        "path": "/api/integrations/crm/connections/{id}/disconnect",
+        "scopes": [
+            "integrations:write"
+        ],
+        "idempotencyRequired": true
+    },
     "integrations.crm.connections.health": {
         "method": "POST",
         "path": "/api/integrations/crm/connections/{id}/health",
@@ -1181,6 +1341,14 @@ export const ROUTE_CATALOG = {
         ],
         "idempotencyRequired": false
     },
+    "channels.set_ai_dm_auto_send": {
+        "method": "PATCH",
+        "path": "/api/channels/{id}/auto-send",
+        "scopes": [
+            "channels:write"
+        ],
+        "idempotencyRequired": true
+    },
     "reports.morning": {
         "method": "GET",
         "path": "/api/reports/morning",

package/dist/landing.js

@@ -0,0 +1,97 @@
+/**
+ * The page a person gets when they open the server in a browser.
+ *
+ * Links to `https://mcp.setluca.com/mcp` used to answer a browser with the
+ * OAuth 401, so crawlers marked every one of them broken. MCP clients never
+ * see this page: they POST, ask for `text/event-stream`, or carry a bearer
+ * token, and each of those still reaches the MCP handler and its challenge.
+ */
+/** Where a person learns how to connect an assistant. */
+const CONNECT_GUIDE_URL = "https://setluca.com/connect";
+/**
+ * A browser or link checker asking for a page: a GET or HEAD that accepts
+ * HTML, does not ask for an event stream, and carries no credentials. The
+ * branch is kept this narrow because handing an HTML 200 to an MCP client
+ * would break its connection. No MCP client sends HEAD.
+ */
+function isBrowserPageRequest(request) {
+    const pageMethod = request.method === "GET" || request.method === "HEAD";
+    if (!pageMethod || request.headers.has("authorization")) {
+        return false;
+    }
+    const accept = request.headers.get("accept") ?? "";
+    return accept.includes("text/html") && !accept.includes("text/event-stream");
+}
+function page(origin, mcpPath, intro) {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="robots" content="noindex">
+  <title>SetLuca MCP server</title>
+  <link rel="icon" href="/favicon.ico" sizes="any">
+  <link rel="icon" href="/favicon.svg" type="image/svg+xml">
+  <link rel="apple-touch-icon" href="/apple-touch-icon.png">
+  <style>
+    body {
+      font-family: system-ui, -apple-system, sans-serif;
+      max-width: 600px;
+      margin: 60px auto;
+      padding: 0 20px;
+      line-height: 1.6;
+      color: #1f2937;
+      background: #fcfbf9;
+    }
+    a { color: #1d4ed8; }
+    code {
+      background: #f3f4f6;
+      padding: 2px 6px;
+      border-radius: 3px;
+      font-size: 0.9em;
+    }
+  </style>
+</head>
+<body>
+  <h1>SetLuca MCP server</h1>
+  <p>${intro}</p>
+  <p>To connect Claude, ChatGPT, Cursor, or another MCP client, follow the <a href="${CONNECT_GUIDE_URL}">connection guide</a>.</p>
+  <ul>
+    <li><a href="${CONNECT_GUIDE_URL}">Connect your AI assistant</a></li>
+    <li><a href="https://setluca.com">SetLuca</a></li>
+    <li><a href="https://github.com/setluca/luca-mcp">Source on GitHub: setluca/luca-mcp</a></li>
+    <li><a href="${origin}/.well-known/mcp/server-card.json">MCP server card</a></li>
+  </ul>
+  <p>MCP endpoint: <code>${origin}${mcpPath}</code></p>
+</body>
+</html>`;
+}
+const ROOT_INTRO = "This server connects AI assistants to SetLuca over the Model Context Protocol (MCP).";
+const MCP_INTRO = "This is the Model Context Protocol (MCP) endpoint for SetLuca. It answers MCP clients and AI assistants, not web browsers.";
+/** The opening line of the page at `pathname`, absent for any other path. */
+function introFor(pathname, mcpPath) {
+    if (pathname === "/") {
+        return ROOT_INTRO;
+    }
+    return pathname === mcpPath ? MCP_INTRO : undefined;
+}
+/**
+ * The landing page for a browser opening `/` or the MCP path, or `undefined`
+ * for every other request, which the caller routes as before.
+ */
+export function browserLandingPage(request, mcpPath) {
+    const url = new URL(request.url);
+    const intro = introFor(url.pathname, mcpPath);
+    if (intro === undefined || !isBrowserPageRequest(request)) {
+        return undefined;
+    }
+    const body = request.method === "HEAD" ? null : page(url.origin, mcpPath, intro);
+    return new Response(body, {
+        headers: {
+            "content-type": "text/html; charset=utf-8",
+            // The same URL answers MCP clients with a 401, so a cache must not hand
+            // this page to a request with other headers.
+            vary: "Accept, Authorization",
+        },
+    });
+}

package/dist/operations/groups/bookings.js

@@ -169,6 +169,7 @@ export const bookingsOperations = [
     op({
         id: "bookings.guestLinks.revoke",
         title: "Revoke a booking's guest links",
+        idempotent: true,
         mutatesExisting: true,
         description: "Kill every outstanding guest link on a booking at once.",
     }),
@@ -197,11 +198,13 @@ export const bookingsOperations = [
     op({
         id: "bookings.types.delete",
         title: "Delete a booking type",
+        idempotent: true,
         description: "Remove a booking type and get back the types that are left. Calls already booked against it are not cancelled.",
     }),
     op({
         id: "bookings.types.schedule.replace",
         title: "Replace a booking type schedule",
+        idempotent: true,
         mutatesExisting: true,
         description: "Replace a booking type's schedule outright. Send every rule and override you want to keep \u2014 anything left out is dropped, which is also how you clear a day. Read the current schedule first unless you mean to start over.",
     }),
@@ -213,12 +216,14 @@ export const bookingsOperations = [
     op({
         id: "bookings.types.attendees.remove",
         title: "Remove a booking type attendee",
+        idempotent: true,
         mutatesExisting: true,
         description: "Remove a standing attendee from one booking type and get back the ones that are left. Calls already booked keep the invitees they were created with.",
     }),
     op({
         id: "bookings.calendars.select",
         title: "Select a booking calendar",
+        idempotent: true,
         mutatesExisting: true,
         // Selection checks that the calendar exists in the connected Google account.
         openWorld: true,
@@ -227,7 +232,33 @@ export const bookingsOperations = [
     op({
         id: "bookings.calendars.remove",
         title: "Remove a booking calendar",
+        idempotent: true,
         mutatesExisting: true,
         description: "Stop using a calendar for conflict checks or as the booking destination. The calendar itself is left alone in Google; only Luca's selection changes.",
     }),
+    op({
+        id: "bookings.recovery.get",
+        title: "Read a no-show recovery",
+        description: "Read a booking's no-show recovery: whether it is active, paused for review, stopped, or done, which follow-up is next, and when the last one went out.",
+    }),
+    op({
+        id: "bookings.recovery.stop",
+        title: "Stop a no-show recovery",
+        idempotent: true,
+        mutatesExisting: true,
+        description: "Stop a booking's no-show recovery so no further follow-up is scheduled. A follow-up already being sent may still arrive. Send recovery.id as recoveryCaseId and recovery.outcomeVersion from luca_bookings_recovery_get; a recovery that changed since that read returns 409 booking_recovery_changed.",
+    }),
+    op({
+        id: "bookings.providerRequests.create",
+        title: "Book a call on the coach's calendar",
+        // Creates the event on the coach's calendar provider and invites the lead.
+        openWorld: true,
+        confirm: "always",
+        description: "Book one exact slot from luca_bookings_managed_availability on the coach's Calendly, Cal.com, or Google Calendar, which sends the invite to the lead's email; the lead also gets Luca's booking confirmation. Pass the slot's id, startsAt, endsAt, and timezone as returned by a read of exactly that slot's window, since a slot id is tied to the window it was read in. The answer is usually pending while the provider confirms; read it again with luca_bookings_provider_requests_get. A slot taken in the meantime returns 409 slot_unavailable.",
+    }),
+    op({
+        id: "bookings.providerRequests.get",
+        title: "Check a calendar booking",
+        description: "Read where a calendar booking request stands. pending_provider turns into confirmed, handoff_required, or failed once the provider answers, and a confirmed request carries the booking id and meeting link.",
+    }),
 ];

package/dist/operations/groups/broadcasts.js

@@ -51,6 +51,9 @@ export const broadcastsOperations = [
     op({
         id: "broadcasts.pause",
         title: "Pause a broadcast",
+        idempotent: true,
+        // Sends broadcast.paused to the coach's webhook subscribers.
+        openWorld: true,
         mutatesExisting: true,
         // Recipient snapshot, see the note above this list.
         untrustedContent: true,
@@ -69,6 +72,7 @@ export const broadcastsOperations = [
     op({
         id: "broadcasts.cancel",
         title: "Cancel a broadcast",
+        idempotent: true,
         mutatesExisting: true,
         // Recipient snapshot, see the note above this list.
         untrustedContent: true,

package/dist/operations/groups/cadences.js

@@ -10,6 +10,7 @@ export const cadencesOperations = [
     op({
         id: "cadences.pause",
         title: "Pause a lead's cadence",
+        idempotent: true,
         mutatesExisting: true,
         description: "Pause (cancel) a lead's running rescue cadence with an optional reason.",
     }),

package/dist/operations/groups/callEvents.js

@@ -37,11 +37,16 @@ export const callEventsOperations = [
             applies: (input) => isNoShowReport(input.body),
             description: "outcome is no_show (can start recovery messaging)",
         },
-        description: "File the coach's report on how a call went. A completed or no_show outcome also records booking attendance, and a completed call queues its summary.",
+        // The API refuses a no_show from a key below queue_ops, so the tool states
+        // the tier that can file every report it accepts.
+        capability: "queue_ops",
+        description: "File the coach's report on how a call went. A completed or no_show outcome also records booking attendance, and a completed call queues its summary. A no_show can start recovery messages to the lead, so it needs the queue_ops grant and confirm: true.",
     }),
     op({
         id: "callEvents.summary.generate",
         title: "Generate a call summary",
+        // The summary is pushed to the coach's connected CRM after its review window.
+        openWorld: true,
         mutatesExisting: true,
         untrustedContent: true,
         description: "Queue a fresh summary and return straight away. Poll the call event for the result.",
@@ -51,6 +56,9 @@ export const callEventsOperations = [
         title: "Replace a call summary",
         openWorld: true,
         confirm: "always",
+        // The API asks full of a key for this route, since the summary is pushed
+        // to the connected CRM.
+        capability: "full",
         mutatesExisting: true,
         untrustedContent: true,
         description: "Replace the generated summary with the coach's own wording and push it. A summary already in the CRM updates that same note.",
@@ -60,6 +68,8 @@ export const callEventsOperations = [
         title: "Push a call to the CRM",
         openWorld: true,
         confirm: "always",
+        // The API asks full of a key for a write into the connected CRM.
+        capability: "full",
         mutatesExisting: true,
         untrustedContent: true,
         description: "Send the current summary to the CRM now, without waiting out the review window. Re-pushing updates the existing note.",
@@ -67,6 +77,7 @@ export const callEventsOperations = [
     op({
         id: "callEvents.undoOutcome",
         title: "Undo a call's outcome",
+        idempotent: true,
         mutatesExisting: true,
         untrustedContent: true,
         description: "Clear a mistaken attendance mark and put the call back in the queue. The window is 48 hours from when the outcome was set.",
@@ -74,6 +85,9 @@ export const callEventsOperations = [
     op({
         id: "callEvents.backfill",
         title: "Backfill a booking's call event",
+        idempotent: true,
+        // The summary it queues later syncs to the coach's connected CRM.
+        openWorld: true,
         untrustedContent: true,
         description: "Create a call event for a booking that predates automatic creation, then queue its summary. Safe to call twice: an existing call event comes back as is.",
     }),

package/dist/operations/groups/channels.js

@@ -1,3 +1,4 @@
+import { isJsonObject } from "../../serialization.js";
 import { op } from "../registry.js";
 export const channelsOperations = [
     op({
@@ -20,4 +21,16 @@ export const channelsOperations = [
         title: "Get a channel account",
         description: "Read one channel account: status, health, cleanup state after a disconnect, and the actions the coach can take on it. Older rows stay readable by ID.",
     }),
+    op({
+        id: "channels.set_ai_dm_auto_send",
+        title: "Turn auto-send on or off for a channel",
+        // Turning it on lets Luca's replies reach leads without review, on this
+        // account and on every other account whose own switch is on.
+        openWorld: true,
+        confirm: {
+            applies: (input) => isJsonObject(input.body) && input.body.enabled === true,
+            description: "enabled is true (lets Luca's replies reach leads without review)",
+        },
+        description: "Turn Luca's DM auto-send on or off for one channel account. Off puts every Luca draft on that account in the review queue. On lets drafts that pass Luca's safety checks send without review, and also turns on the workspace switch, so every other account with its own switch on starts sending too. Campaign sends follow their own policy. WhatsApp and disconnected accounts answer 404.",
+    }),
 ];

package/dist/operations/groups/conversations.js

@@ -34,4 +34,38 @@ export const conversationsOperations = [
         confirm: "always",
         description: "Retry only the parts of a partially sent message that are known not to have reached the provider.",
     }),
+    op({
+        id: "conversations.send_status",
+        // Answers with a status and an id only; no lead-authored text.
+        untrustedContent: false,
+        title: "Check whether a reply was accepted",
+        description: "Look up a manual reply by the idempotency key it was sent with, to learn whether the API accepted it for sending before you send it again. accepted means it is queued to go out, not that it was delivered; not_found means no accepted send exists under that key.",
+    }),
+    op({
+        id: "conversations.reply_failure_retry",
+        // Answers with ids and status flags only; no lead-authored text.
+        untrustedContent: false,
+        title: "Resend a failed reply",
+        openWorld: true,
+        mutatesExisting: true,
+        confirm: "always",
+        description: "Send a reply the coach wrote that failed to go out, under the key it first went out with, so the lead never gets it twice. Only a failure that is safe to repeat can be retried. Sends a real message.",
+    }),
+    op({
+        id: "conversations.reply_failure_dismiss",
+        idempotent: true,
+        // Answers with a flag only; no lead-authored text.
+        untrustedContent: false,
+        title: "Dismiss a failed reply",
+        mutatesExisting: true,
+        description: "Close a failed reply the coach has given up on, so it leaves the thread on every device. Sends nothing. Dismissing twice changes nothing.",
+    }),
+    op({
+        id: "conversations.media_retry",
+        // Answers with a job id and state only; no lead-authored text.
+        untrustedContent: false,
+        title: "Retry a voice-note transcription",
+        mutatesExisting: true,
+        description: "Queue another transcription attempt for a voice note in this conversation. Only re-transcribes; never drafts or sends. A refusal says why: a retry is already running, the limit is reached, or the audio is gone.",
+    }),
 ];

package/dist/operations/groups/insights.js

@@ -8,30 +8,33 @@ export const insightsOperations = [
     op({
         id: "insights.markRead",
         title: "Mark an insight read",
+        idempotent: true,
         mutatesExisting: true,
         description: "Mark one insight read, so it stops coming back at the top of the feed.",
     }),
     op({
         id: "insights.dismiss",
         title: "Dismiss an insight",
+        idempotent: true,
         mutatesExisting: true,
         description: "Dismiss one insight the coach does not want to act on. Use this rather than leaving it unread forever.",
     }),
     op({
         id: "insights.markActioned",
         title: "Mark an insight actioned",
+        idempotent: true,
         mutatesExisting: true,
         description: "Record that the thing an insight asked for was actually done. Use it after doing the work, not instead of it.",
     }),
     op({
         id: "insights.settings.get",
         title: "Read alert delivery settings",
-        readOnly: false,
-        description: "Read which insight alerts reach the coach and how. The row is created with defaults on the first read, so this never 404s. Check it before concluding a quiet feed means nothing is happening \u2014 it may just be muted.",
+        description: "Read which insight alerts reach the coach and how. Before the coach changes anything this returns the defaults, so it never 404s. Check it before concluding a quiet feed means nothing is happening, since alerts may be muted.",
     }),
     op({
         id: "insights.settings.update",
         title: "Update alert delivery settings",
+        idempotent: true,
         mutatesExisting: true,
         description: "Merge-patch the coach's alert-delivery settings. Send only what you are changing; anything left out keeps its current value.",
     }),

package/dist/operations/groups/integrations.js

@@ -20,12 +20,16 @@ export const integrationsOperations = [
     op({
         id: "integrations.crm.connections.create",
         title: "Create a CRM connection",
+        idempotent: true,
         mutatesExisting: true,
         description: "Create or update a workspace-scoped CRM connection.",
     }),
     op({
         id: "integrations.crm.connections.schema",
         title: "Read a CRM's field schema",
+        // Refreshes Luca's cached copy of the CRM schema, the same copy every time.
+        readOnly: false,
+        idempotent: true,
         openWorld: true,
         // sampleRecords are literal contact and deal rows from the coach's CRM, which leads and other people filled in.
         untrustedContent: true,
@@ -48,11 +52,13 @@ export const integrationsOperations = [
     op({
         id: "integrations.crm.mappings.suggest",
         title: "Suggest CRM field mappings",
+        idempotent: true,
         description: "Suggest CRM field mappings.",
     }),
     op({
         id: "integrations.crm.mappings.confirm",
         title: "Confirm CRM field mappings",
+        idempotent: true,
         mutatesExisting: true,
         description: "Confirm CRM field mappings.",
     }),
@@ -65,12 +71,10 @@ export const integrationsOperations = [
     }),
     op({
         id: "integrations.crm.syncRuns.create",
-        title: "Start a CRM sync",
-        openWorld: true,
-        confirm: "always",
+        title: "Preview a CRM sync",
         // Mutations carry CRM record values: names, emails, notes.
         untrustedContent: true,
-        description: "Create a CRM dry-run or live sync run.",
+        description: "Record a dry-run preview of the changes a CRM sync would make, as a new sync run. Nothing is written to the CRM: the API refuses a live sync.",
     }),
     op({
         id: "integrations.events.list",
@@ -79,4 +83,13 @@ export const integrationsOperations = [
         untrustedContent: true,
         description: "List integration event log.",
     }),
+    op({
+        id: "integrations.crm.connections.disconnect",
+        title: "Disconnect a CRM",
+        idempotent: true,
+        mutatesExisting: true,
+        // Stops every sync with that CRM until the coach signs in to it again.
+        confirm: "always",
+        description: "Disable a CRM connection and clear the credentials Luca holds, which stops every sync with that CRM until the coach connects it again. Saved mappings and event history stay. It does not revoke access on the CRM's side.",
+    }),
 ];

package/dist/operations/groups/knowledge.js

@@ -15,6 +15,7 @@ export const knowledgeOperations = [
     op({
         id: "knowledge.rejectSuggestion",
         title: "Reject a knowledge suggestion",
+        idempotent: true,
         mutatesExisting: true,
         description: "Reject a profile suggestion so it stops being offered. The profile is left as it stands.",
     }),
@@ -33,6 +34,7 @@ export const knowledgeOperations = [
     op({
         id: "knowledge.sources.disconnect",
         title: "Disconnect a knowledge source",
+        idempotent: true,
         mutatesExisting: true,
         description: "Delete a knowledge source. Its pending suggestions go with it; values the coach already approved stay in the profile, because approving copies them there.",
     }),