@setluca/mcp 0.1.1 → 0.2.0

package/dist/operations/groups/broadcasts.js

@@ -0,0 +1,106 @@
+import { op } from "../registry.js";
+export const broadcastsOperations = [
+    op({
+        id: "broadcasts.list",
+        title: "List broadcasts",
+        description: "List broadcasts. Query supports limit, cursor, and status.",
+    }),
+    op({
+        id: "broadcasts.get",
+        title: "Get a broadcast",
+        description: "Get broadcast detail.",
+        redactedFields: [
+            "recipients[].messageBody",
+            "sampleMessages[].body",
+            "segmentSnapshot.excludedRecipients[].displayName",
+            "segmentSnapshot.leads[].customFields",
+            "segmentSnapshot.leads[].displayName",
+        ],
+    }),
+    op({
+        id: "broadcasts.create",
+        title: "Create a broadcast",
+        description: "Create a broadcast draft. Body requires campaignId and name.",
+        redactedFields: [
+            "recipients[].messageBody",
+            "sampleMessages[].body",
+            "segmentSnapshot.excludedRecipients[].displayName",
+            "segmentSnapshot.leads[].customFields",
+            "segmentSnapshot.leads[].displayName",
+        ],
+    }),
+    op({
+        id: "broadcasts.preview",
+        title: "Preview a broadcast",
+        description: "Refresh broadcast recipient and sample-message preview.",
+        redactedFields: [
+            "recipients[].messageBody",
+            "sampleMessages[].body",
+            "segmentSnapshot.excludedRecipients[].displayName",
+            "segmentSnapshot.leads[].customFields",
+            "segmentSnapshot.leads[].displayName",
+        ],
+    }),
+    op({
+        id: "broadcasts.approve",
+        title: "Approve a broadcast",
+        description: "Approve a safe broadcast draft and snapshot recipients.",
+        redactedFields: [
+            "recipients[].messageBody",
+            "sampleMessages[].body",
+            "segmentSnapshot.excludedRecipients[].displayName",
+            "segmentSnapshot.leads[].customFields",
+            "segmentSnapshot.leads[].displayName",
+        ],
+    }),
+    op({
+        id: "broadcasts.launch",
+        title: "Launch a broadcast",
+        confirmRequired: true,
+        description: "Launch an approved broadcast. Sends messages to live leads.",
+        redactedFields: [
+            "recipients[].messageBody",
+            "sampleMessages[].body",
+            "segmentSnapshot.excludedRecipients[].displayName",
+            "segmentSnapshot.leads[].customFields",
+            "segmentSnapshot.leads[].displayName",
+        ],
+    }),
+    op({
+        id: "broadcasts.pause",
+        title: "Pause a broadcast",
+        description: "Pause a running broadcast with an optional operator reason.",
+        redactedFields: [
+            "recipients[].messageBody",
+            "sampleMessages[].body",
+            "segmentSnapshot.excludedRecipients[].displayName",
+            "segmentSnapshot.leads[].customFields",
+            "segmentSnapshot.leads[].displayName",
+        ],
+    }),
+    op({
+        id: "broadcasts.retry",
+        title: "Retry a broadcast's failed sends",
+        confirmRequired: true,
+        description: "Retry failed broadcast recipients after operator review. Re-sends messages to leads.",
+        redactedFields: [
+            "recipients[].messageBody",
+            "sampleMessages[].body",
+            "segmentSnapshot.excludedRecipients[].displayName",
+            "segmentSnapshot.leads[].customFields",
+            "segmentSnapshot.leads[].displayName",
+        ],
+    }),
+    op({
+        id: "broadcasts.cancel",
+        title: "Cancel a broadcast",
+        description: "Cancel a draft, approved, running, paused, or failed broadcast.",
+        redactedFields: [
+            "recipients[].messageBody",
+            "sampleMessages[].body",
+            "segmentSnapshot.excludedRecipients[].displayName",
+            "segmentSnapshot.leads[].customFields",
+            "segmentSnapshot.leads[].displayName",
+        ],
+    }),
+];

package/dist/operations/groups/cadences.js

@@ -0,0 +1,14 @@
+import { op } from "../registry.js";
+export const cadencesOperations = [
+    op({
+        id: "cadences.rescueStart",
+        title: "Start a silent-lead rescue",
+        confirmRequired: true,
+        description: "Enroll silent leads into the multi-day rescue cadence. Starts outbound touches to real leads.",
+    }),
+    op({
+        id: "cadences.pause",
+        title: "Pause a lead's cadence",
+        description: "Pause (cancel) a lead's running rescue cadence with an optional reason.",
+    }),
+];

package/dist/operations/groups/callEvents.js

@@ -0,0 +1,131 @@
+import { op } from "../registry.js";
+export const callEventsOperations = [
+    op({
+        id: "callEvents.needingFeedback",
+        title: "List calls still needing a report",
+        description: "List calls whose time has passed that still need the coach to say what happened. The post-call work queue.",
+        redactedFields: [
+            "callEvents[].coachNotes",
+            "callEvents[].crmSyncError",
+            "callEvents[].feedbackFields.followUpNote",
+            "callEvents[].feedbackFields.surprise",
+            "callEvents[].leadName",
+            "callEvents[].summary",
+            "callEvents[].summaryStructured",
+        ],
+    }),
+    op({
+        id: "callEvents.get",
+        title: "Get a call event",
+        description: "Read one call event: outcome, rating, summary, and CRM sync state.",
+        redactedFields: [
+            "callEvent.coachNotes",
+            "callEvent.crmSyncError",
+            "callEvent.feedbackFields.followUpNote",
+            "callEvent.feedbackFields.surprise",
+            "callEvent.leadName",
+            "callEvent.summary",
+            "callEvent.summaryStructured",
+        ],
+    }),
+    op({
+        id: "callEvents.byBooking",
+        title: "Get a booking's call event",
+        description: "Find the call event attached to a booking. A booking whose call hasn't happened yet returns 404, which is normal.",
+        redactedFields: [
+            "callEvent.coachNotes",
+            "callEvent.crmSyncError",
+            "callEvent.feedbackFields.followUpNote",
+            "callEvent.feedbackFields.surprise",
+            "callEvent.leadName",
+            "callEvent.summary",
+            "callEvent.summaryStructured",
+        ],
+    }),
+    op({
+        id: "callEvents.byLead",
+        title: "List a lead's call events",
+        description: "Read a lead's full call history, oldest first, so a second or third call reads in sequence.",
+        redactedFields: [
+            "callEvents[].coachNotes",
+            "callEvents[].crmSyncError",
+            "callEvents[].feedbackFields.followUpNote",
+            "callEvents[].feedbackFields.surprise",
+            "callEvents[].leadName",
+            "callEvents[].summary",
+            "callEvents[].summaryStructured",
+        ],
+    }),
+    op({
+        id: "callEvents.feedback",
+        title: "Report how a call went",
+        untrustedContent: true,
+        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.",
+        redactedFields: [
+            "callEvent.coachNotes",
+            "callEvent.crmSyncError",
+            "callEvent.feedbackFields.followUpNote",
+            "callEvent.feedbackFields.surprise",
+            "callEvent.leadName",
+            "callEvent.summary",
+            "callEvent.summaryStructured",
+        ],
+    }),
+    op({
+        id: "callEvents.summary.generate",
+        title: "Generate a call summary",
+        untrustedContent: true,
+        description: "Queue a fresh summary and return straight away. Poll the call event for the result.",
+    }),
+    op({
+        id: "callEvents.summary.replace",
+        title: "Replace a call summary",
+        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.",
+        redactedFields: [
+            "callEvent.coachNotes",
+            "callEvent.crmSyncError",
+            "callEvent.feedbackFields.followUpNote",
+            "callEvent.feedbackFields.surprise",
+            "callEvent.leadName",
+            "callEvent.summary",
+            "callEvent.summaryStructured",
+        ],
+    }),
+    op({
+        id: "callEvents.pushToCrm",
+        title: "Push a call to the CRM",
+        untrustedContent: true,
+        description: "Send the current summary to the CRM now, without waiting out the review window. Re-pushing updates the existing note.",
+    }),
+    op({
+        id: "callEvents.undoOutcome",
+        title: "Undo a call's outcome",
+        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.",
+        redactedFields: [
+            "callEvent.coachNotes",
+            "callEvent.crmSyncError",
+            "callEvent.feedbackFields.followUpNote",
+            "callEvent.feedbackFields.surprise",
+            "callEvent.leadName",
+            "callEvent.summary",
+            "callEvent.summaryStructured",
+        ],
+    }),
+    op({
+        id: "callEvents.backfill",
+        title: "Backfill a booking's call event",
+        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.",
+        redactedFields: [
+            "callEvent.coachNotes",
+            "callEvent.crmSyncError",
+            "callEvent.feedbackFields.followUpNote",
+            "callEvent.feedbackFields.surprise",
+            "callEvent.leadName",
+            "callEvent.summary",
+            "callEvent.summaryStructured",
+        ],
+    }),
+];

package/dist/operations/groups/campaigns.js

@@ -0,0 +1,132 @@
+import { op } from "../registry.js";
+export const campaignsOperations = [
+    op({
+        id: "campaigns.list",
+        title: "List campaigns",
+        description: "List campaigns. Query supports limit, cursor, and status.",
+    }),
+    op({
+        id: "campaigns.get",
+        title: "Get a campaign",
+        description: "Get campaign draft and latest published version.",
+    }),
+    op({
+        id: "campaigns.create",
+        title: "Create a campaign",
+        description: "Create a campaign draft. Body requires name and may include graph.",
+    }),
+    op({
+        id: "campaigns.generate",
+        title: "Generate a campaign draft",
+        description: "Generate a safe AI campaign plan without creating or publishing it.",
+    }),
+    op({
+        id: "campaigns.draft.update",
+        title: "Edit a campaign draft",
+        description: "Autosave a campaign draft.",
+        // The route requires an idempotency key; without this the tool never sends
+        // one and every call is rejected (the dead-tool the drift guard now flags).
+    }),
+    op({
+        id: "campaigns.enrollments.list",
+        title: "List a campaign's enrollments",
+        description: "List campaign enrollments.",
+        redactedFields: ["enrollments[].context"],
+    }),
+    op({
+        id: "campaigns.enroll",
+        title: "Enroll leads in a campaign",
+        confirmRequired: true,
+        description: "Enroll a lead in the latest published campaign version. Triggers the live campaign's automation for that lead.",
+    }),
+    op({
+        id: "campaigns.analytics",
+        title: "Read a campaign's results",
+        description: "Read campaign attribution and performance analytics.",
+    }),
+    op({
+        id: "campaigns.providerCapabilities",
+        title: "Check what a campaign's channel supports",
+        description: "Evaluate provider capability blockers for a campaign draft.",
+    }),
+    op({
+        id: "campaigns.commentEvents.list",
+        title: "List campaign comment events",
+        description: "List matched, suppressed, blocked, and replayed comment automation events.",
+        // Each event carries verbatim external-commenter text (`body`,
+        // `commenterDisplayName`), so this read must be framed untrusted even
+        // though the campaigns group is not blanket-untrusted.
+        untrustedContent: true,
+        redactedFields: [
+            "events[].aiClassification",
+            "events[].body",
+            "events[].commenterDisplayName",
+            "events[].matchExplanation",
+            "events[].matchResult",
+            "events[].providerSnapshot",
+            "events[].safetyNotes",
+            "events[].sourceMetadata",
+        ],
+    }),
+    op({
+        id: "campaigns.simulations.list",
+        title: "List a campaign's simulations",
+        description: "List persisted campaign simulation runs.",
+    }),
+    op({
+        id: "campaigns.simulations.create",
+        title: "Simulate a campaign",
+        description: "Run a persisted dry-run simulation without sending messages.",
+        redactedFields: [
+            "generatedDrafts[]",
+            "input.lead",
+            "trace[].generatedDraft",
+        ],
+    }),
+    op({
+        id: "campaigns.simulations.get",
+        title: "Get a campaign simulation",
+        description: "Get a campaign simulation run with trace.",
+        redactedFields: [
+            "generatedDrafts[]",
+            "input.lead",
+            "trace[].generatedDraft",
+        ],
+    }),
+    op({
+        id: "campaigns.commentSimulationSuite.run",
+        title: "Run the comment automation suite",
+        redactedFields: [
+            "simulations[].generatedDrafts[]",
+            "simulations[].trace[].generatedDraft",
+        ],
+        description: "Run the Instagram comment-to-DM simulation suite against a campaign. Any campaign that uses comment automation has to pass it before it can publish, so run this before reaching for publish.",
+    }),
+    op({
+        id: "campaigns.publish",
+        title: "Publish a campaign",
+        confirmRequired: true,
+        description: "Freeze the draft as a new immutable version and point new enrollments at it. Published versions never change, and enrollments against a live campaign reach real leads. Publish is blocked when the target provider cannot do something the campaign needs, so read the provider capabilities first.",
+    }),
+    op({
+        id: "campaigns.setStatus",
+        title: "Pause, resume, or archive a campaign",
+        description: "Pause, resume, or archive a campaign. A transition that does not make sense for the campaign's current state is rejected rather than forced through.",
+    }),
+    op({
+        id: "campaigns.duplicate",
+        title: "Duplicate a campaign",
+        description: "Copy a campaign into a fresh unpublished draft and leave the original alone. Use it to change a live campaign without touching what is currently running.",
+    }),
+    op({
+        id: "campaigns.versions.list",
+        title: "List campaign versions",
+        description: "List a campaign's published version history. Published versions cannot change, so this is the record of what actually ran rather than what the draft says today.",
+    }),
+    op({
+        id: "campaigns.enrollments.timeline",
+        title: "Read an enrollment timeline",
+        redactedFields: ["enrollment.context"],
+        description: "Read every step one enrollment has been through: what got sent, when, and how the lead responded.",
+    }),
+];

package/dist/operations/groups/capabilities.js

@@ -0,0 +1,8 @@
+import { op } from "../registry.js";
+export const capabilitiesOperations = [
+    op({
+        id: "capabilities.get",
+        title: "What this workspace supports",
+        description: "Describe Luca's public API capabilities, scopes, and boundaries.",
+    }),
+];

package/dist/operations/groups/coach.js

@@ -0,0 +1,43 @@
+import { op } from "../registry.js";
+export const coachOperations = [
+    op({
+        id: "coach.profile",
+        title: "Read the coach's profile",
+        description: "Read the coach's account record: name, timezone, business hours, and tone slider. Use it to know when the coach is reachable and how formal they want to sound.",
+    }),
+    op({
+        id: "coach.niche",
+        title: "Read the coach's niche",
+        description: "Read the coach's canonical niche, the cohort key their benchmarks are compared against.",
+    }),
+    op({
+        id: "coach.nicheProfile",
+        title: "Read the coach's niche profile",
+        description: "Read the coach's offer, audience, price range, promised outcomes, disqualifiers, and FAQs. This is the context that decides whether a lead is a fit.",
+    }),
+    op({
+        id: "coach.objectionPlaybook",
+        title: "Read the coach's objection playbook",
+        description: "Read how the coach wants each objection type handled — price, timing, trust, fit — before drafting a reply to one.",
+    }),
+    op({
+        id: "coach.postCallSettings",
+        title: "Read the post-call settings",
+        description: "Read the coach's post-call preferences: what gets summarized, what gets pushed to the CRM, and what the coach fills in themselves.",
+    }),
+    op({
+        id: "coach.postCallCrmMapping",
+        title: "Read the post-call CRM mapping",
+        description: "Read which CRM field each post-call value writes to. Check this before a CRM push to know what will land where.",
+    }),
+    op({
+        id: "coach.postCallDealSync",
+        title: "Read the post-call deal sync settings",
+        description: "Read the CRM pipeline and the stage each call outcome moves a deal to.",
+    }),
+    op({
+        id: "coach.auditLog",
+        title: "Read the audit log",
+        description: "Read the coach-visible audit trail, newest first, filterable by actor type, action, action prefix, or target. It is the one read that spans every domain, so use it to check what a previous run actually did instead of replaying each list route.",
+    }),
+];

package/dist/operations/groups/conversations.js

@@ -0,0 +1,48 @@
+import { op } from "../registry.js";
+export const conversationsOperations = [
+    op({
+        id: "conversations.list",
+        title: "List conversations",
+        description: "List recent conversations. Query supports limit, cursor, channel, and q.",
+        redactedFields: [
+            "conversations[].lastMessagePreview",
+            "conversations[].leadDisplayName",
+        ],
+    }),
+    op({
+        id: "conversations.get",
+        title: "Get a conversation",
+        description: "Get a conversation with messages and lead context.",
+        redactedFields: [
+            "conversation.qualificationProgress",
+            "copilotContext.leadDisplayName",
+            "lead.customFields",
+            "lead.displayName",
+            "lead.externalUserId",
+            "messages[].body",
+            "messages[].media",
+            "messages[].mediaUrls",
+            "messages[].rawPayload",
+            "pendingReview.criticIssues",
+            "pendingReview.draftBody",
+            "pendingReview.qualification",
+        ],
+    }),
+    op({
+        id: "conversations.messages",
+        title: "Read a conversation's messages",
+        description: "Page backward through a thread's older messages, for threads longer than the window the conversation read returns.",
+        redactedFields: [
+            "messages[].body",
+            "messages[].media",
+            "messages[].mediaUrls",
+            "messages[].rawPayload",
+        ],
+    }),
+    op({
+        id: "conversations.send",
+        title: "Send a message to a lead",
+        confirmRequired: true,
+        description: "Send a message to the lead on their channel right away. This is the one conversation tool that reaches a real person without a reviewer seeing the message first, which is why it needs an explicit confirm. Prefer drafting into the review queue unless the coach has asked for this message to go out now.",
+    }),
+];

package/dist/operations/groups/insights.js

@@ -0,0 +1,33 @@
+import { op } from "../registry.js";
+export const insightsOperations = [
+    op({
+        id: "insights.unreadCount",
+        title: "Count unread insights",
+        description: "How many insights the coach has not read yet. Cheap enough to poll before pulling the whole feed.",
+    }),
+    op({
+        id: "insights.markRead",
+        title: "Mark an insight read",
+        description: "Mark one insight read, so it stops coming back at the top of the feed.",
+    }),
+    op({
+        id: "insights.dismiss",
+        title: "Dismiss an insight",
+        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",
+        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",
+        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.",
+    }),
+    op({
+        id: "insights.settings.update",
+        title: "Update alert delivery settings",
+        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

@@ -0,0 +1,80 @@
+import { op } from "../registry.js";
+export const integrationsOperations = [
+    op({
+        id: "integrations.connectors.list",
+        title: "List available connectors",
+        description: "List Zapier, Make, and CRM provider capabilities.",
+    }),
+    op({
+        id: "integrations.crm.oauthUrl",
+        title: "Start a CRM connection",
+        description: "Create a CRM provider OAuth URL.",
+    }),
+    op({
+        id: "integrations.crm.oauthCallback",
+        title: "Finish a CRM connection",
+        description: "Exchange a CRM OAuth code and store encrypted credentials.",
+    }),
+    op({
+        id: "integrations.crm.connections.list",
+        title: "List CRM connections",
+        description: "List CRM connections.",
+    }),
+    op({
+        id: "integrations.crm.connections.create",
+        title: "Create a CRM connection",
+        description: "Create or update a workspace-scoped CRM connection.",
+    }),
+    op({
+        id: "integrations.crm.connections.schema",
+        title: "Read a CRM's field schema",
+        description: "Discover CRM provider schema.",
+        redactedFields: ["sampleRecords"],
+    }),
+    op({
+        id: "integrations.crm.connections.health",
+        title: "Check a CRM connection's health",
+        description: "Probe CRM provider health.",
+    }),
+    op({
+        id: "integrations.crm.connections.webhooksSetup",
+        title: "Set up a CRM's webhooks",
+        description: "Configure CRM provider webhook status.",
+    }),
+    op({
+        id: "integrations.crm.webhooks.record",
+        title: "Record a CRM webhook",
+        description: "Record an inbound CRM provider webhook event. Idempotent on the provider's event id, so a redelivery is recorded once.",
+    }),
+    op({
+        id: "integrations.crm.mappings.suggest",
+        title: "Suggest CRM field mappings",
+        description: "Suggest CRM field mappings.",
+    }),
+    op({
+        id: "integrations.crm.mappings.confirm",
+        title: "Confirm CRM field mappings",
+        description: "Confirm CRM field mappings.",
+    }),
+    op({
+        id: "integrations.crm.syncRuns.list",
+        title: "List CRM sync runs",
+        description: "List CRM sync history.",
+        redactedFields: [
+            "syncRuns[].appliedMutations[].fields",
+            "syncRuns[].plannedMutations[].fields",
+        ],
+    }),
+    op({
+        id: "integrations.crm.syncRuns.create",
+        title: "Start a CRM sync",
+        description: "Create a CRM dry-run or live sync run.",
+        redactedFields: ["appliedMutations[].fields", "plannedMutations[].fields"],
+    }),
+    op({
+        id: "integrations.events.list",
+        title: "List integration events",
+        description: "List integration event log.",
+        redactedFields: ["events[].payload"],
+    }),
+];

package/dist/operations/groups/knowledge.js

@@ -0,0 +1,34 @@
+import { op } from "../registry.js";
+export const knowledgeOperations = [
+    op({
+        id: "knowledge.suggestions",
+        title: "List knowledge suggestions",
+        description: "List profile changes proposed from the coach's own knowledge sources, each with the excerpt it was drawn from and the value it would replace.",
+    }),
+    op({
+        id: "knowledge.approveSuggestion",
+        title: "Approve a knowledge suggestion",
+        confirmRequired: true,
+        description: "Approve a profile suggestion and write it into the coach's profile. Every later draft reads the result, so check the excerpt supports the change before approving.",
+    }),
+    op({
+        id: "knowledge.rejectSuggestion",
+        title: "Reject a knowledge suggestion",
+        description: "Reject a profile suggestion so it stops being offered. The profile is left as it stands.",
+    }),
+    op({
+        id: "knowledge.sources.list",
+        title: "List knowledge sources",
+        description: "List the content sources the coach has connected \u2014 Notion, Google Docs, a website, an Instagram bio \u2014 with the sync state of each one. Connecting a new source is app-only; this lists what is already there.",
+    }),
+    op({
+        id: "knowledge.sources.sync",
+        title: "Re-sync a knowledge source",
+        description: "Queue a re-read of one knowledge source now rather than waiting for its next scheduled sync. It returns as soon as the job is queued, so any new suggestions appear on a later read.",
+    }),
+    op({
+        id: "knowledge.sources.disconnect",
+        title: "Disconnect a knowledge source",
+        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.",
+    }),
+];