@setluca/mcp 0.5.0 → 0.5.2

package/dist/http.js

@@ -171,13 +171,13 @@ function sendOnce(config, input, requestIdempotencyKey, fetchImpl) {
             const now = yield* Clock.currentTimeMillis;
             const waitMs = retryAfterMs(response, now);
             const text = yield* readText.pipe(Effect.orElseSucceed(() => ""));
-            return yield* Effect.fail(new LucaHttpError({
+            return yield* new LucaHttpError({
                 status: response.status,
                 statusText: response.statusText,
                 body: yield* errorBody(text),
                 ...optionalField("requestId", response.headers.get("x-request-id")),
                 ...optionalField("retryAfterMs", waitMs),
-            }));
+            });
         }
         const text = yield* readText;
         // An empty body is not a decode failure. Several endpoints answer with

package/dist/oauth-resolver.js

@@ -38,7 +38,7 @@ function resolvePayload(response) {
     return Effect.tryPromise({
         try: () => response.json(),
         catch: unavailable("Token verification returned non-JSON content"),
-    }).pipe(Effect.flatMap((body) => decodeResolvePayload(body).pipe(Effect.mapError(unavailable("Token verification returned an unexpected body")))), Effect.map(Option.some));
+    }).pipe(Effect.flatMap((body) => decodeResolvePayload(body).pipe(Effect.mapError(unavailable("Token verification returned an unexpected body")))), Effect.asSome);
 }
 /**
  * One authenticated call to POST /oauth/resolve, answered with the config for

package/dist/operations/groups/bookings.js

@@ -115,7 +115,7 @@ export const bookingsOperations = [
         mutatesExisting: true,
         // Moves the call on the provider calendar and re-arms the lead's reminder.
         confirm: "always",
-        description: "Reschedule or update booking status.",
+        description: "Reschedule or update booking status. A Google Calendar or Cal.com booking changes on that calendar too, and the calendar can email the lead about it.",
         // Each booking carries a cancellation reason the invitee may have written.
         untrustedContent: true,
     }),
@@ -126,7 +126,7 @@ export const bookingsOperations = [
         mutatesExisting: true,
         // Cancels a real call on the lead's and the coach's calendars.
         confirm: "always",
-        description: "Cancel a booking.",
+        description: "Cancel a booking. A Google Calendar or Cal.com booking is cancelled on that calendar too, and the calendar can email the lead about it.",
         // Each booking carries a cancellation reason the invitee may have written.
         untrustedContent: true,
     }),
@@ -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,6 +232,7 @@ 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.",
     }),
@@ -238,6 +244,7 @@ export const bookingsOperations = [
     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.",
     }),

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

@@ -45,6 +45,8 @@ export const callEventsOperations = [
     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.",
@@ -75,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.",
@@ -82,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/campaigns.js

@@ -19,7 +19,7 @@ export const campaignsOperations = [
     op({
         id: "campaigns.generate",
         title: "Generate a campaign draft",
-        description: "Generate a safe AI campaign plan without creating or publishing it.",
+        description: "Build a campaign plan from a brief with fixed rules, not an AI model. Nothing is created or published: create the draft from the plan, review it, and publish it yourself.",
     }),
     op({
         id: "campaigns.draft.update",

package/dist/operations/groups/conversations.js

@@ -53,6 +53,7 @@ export const conversationsOperations = [
     }),
     op({
         id: "conversations.reply_failure_dismiss",
+        idempotent: true,
         // Answers with a flag only; no lead-authored text.
         untrustedContent: false,
         title: "Dismiss a failed reply",
@@ -65,6 +66,8 @@ export const conversationsOperations = [
         untrustedContent: false,
         title: "Retry a voice-note transcription",
         mutatesExisting: true,
+        // The retried job sends the voice note to OpenRouter's speech-to-text.
+        openWorld: 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,18 +8,21 @@ 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.",
     }),
@@ -31,6 +34,7 @@ export const insightsOperations = [
     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",
@@ -82,6 +86,7 @@ export const integrationsOperations = [
     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",

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.",
     }),

package/dist/operations/groups/leads.js

@@ -18,13 +18,18 @@ export const leadsOperations = [
     op({
         id: "leads.create",
         title: "Create or upsert a lead",
+        // Sends lead.created to the coach's webhook subscribers.
+        openWorld: true,
         mutatesExisting: true,
         description: "Create or upsert a lead identity. Body requires channel and externalUserId.",
     }),
     op({
         id: "leads.update",
         title: "Update a lead",
-        description: "Update a lead's display name, stage, score, tags, or custom fields.",
+        // Sends lead.updated to the coach's webhook subscribers, and a tag change
+        // can resume a campaign step that messages the lead.
+        openWorld: true,
+        description: "Update a lead's display name, stage, tags, or custom fields. Tags are replaced as a whole list.",
     }),
     op({
         id: "leads.fieldDefinitions.list",
@@ -33,6 +38,7 @@ export const leadsOperations = [
     }),
     op({
         id: "leads.fieldDefinitions.upsert",
+        idempotent: true,
         // Echoes the coach's own field definition back.
         untrustedContent: false,
         title: "Define a custom lead field",
@@ -42,6 +48,8 @@ export const leadsOperations = [
     op({
         id: "leads.importPreview",
         title: "Preview a lead import",
+        // A POST only so the CSV fits in a body. It checks the mapping and saves nothing.
+        readOnly: true,
         description: "Preview a mapped CSV lead import before applying it.",
     }),
     op({
@@ -55,6 +63,8 @@ export const leadsOperations = [
     op({
         id: "leads.identities.attach",
         title: "Attach a channel identity to a lead",
+        // Sends lead.updated to the coach's webhook subscribers.
+        openWorld: true,
         mutatesExisting: true,
         description: "Attach a verified or claimed identity to a lead.",
     }),
@@ -71,6 +81,7 @@ export const leadsOperations = [
     }),
     op({
         id: "leads.consents.revoke",
+        idempotent: true,
         // Echoes the consent record the coach revoked.
         untrustedContent: false,
         title: "Revoke a lead's consent",
@@ -88,10 +99,17 @@ export const leadsOperations = [
         id: "leads.draft",
         title: "Draft a reply to a lead",
         untrustedContent: true,
-        description: "Draft a reply for a lead, written the way the coach writes, and put it in the review queue for the coach to approve. It never sends, whatever the channel's auto-send setting. Optional guidance steers tone or content.",
+        // Drafting again replaces the lead's pending on-demand draft, as
+        // reviewQueue.regenerate replaces a queued one.
+        mutatesExisting: true,
+        // The drafter sends the conversation to OpenRouter's language model, the
+        // same reach that makes a transcription retry open-world.
+        openWorld: true,
+        description: "Draft a reply for a lead, written the way the coach writes, and put it in the review queue for the coach to approve. Drafting again replaces this lead's earlier unapproved draft from this tool. It never sends, whatever the channel's auto-send setting. Optional guidance steers tone or content.",
     }),
     op({
         id: "leads.notes.delete",
+        idempotent: true,
         // Answers with ids and status flags only; no lead-authored text.
         untrustedContent: false,
         title: "Delete a lead note",

package/dist/operations/groups/learning.js

@@ -27,6 +27,7 @@ export const learningOperations = [
     }),
     op({
         id: "learning.proposals.dismiss",
+        idempotent: true,
         // Answers with ids and status flags only; no lead-authored text.
         untrustedContent: false,
         title: "Dismiss a learning proposal",

package/dist/operations/groups/memory.js

@@ -16,6 +16,7 @@ export const memoryOperations = [
     }),
     op({
         id: "memory.setArchived",
+        idempotent: true,
         // Answers with ids and status flags only; no lead-authored text.
         untrustedContent: false,
         title: "Archive or restore memories",

package/dist/operations/groups/reviewQueue.js

@@ -22,6 +22,8 @@ export const reviewQueueOperations = [
     }),
     op({
         id: "reviewQueue.reject",
+        // Sends review.rejected to the coach's webhook subscribers.
+        openWorld: true,
         // Answers with ids and status flags only; no lead-authored text.
         untrustedContent: false,
         title: "Reject a queued draft",
@@ -42,6 +44,9 @@ export const reviewQueueOperations = [
         untrustedContent: false,
         title: "Retry a draft's failed media",
         mutatesExisting: true,
+        // The same transcription job as conversations.media_retry, so the voice
+        // note goes to OpenRouter's speech-to-text.
+        openWorld: true,
         description: "Retry a failed voice-note transcription so the draft can be reviewed. Only re-transcribes; never redrafts or sends.",
     }),
     op({
@@ -54,7 +59,6 @@ export const reviewQueueOperations = [
         // Answers with ids and status flags only; no lead-authored text.
         untrustedContent: false,
         title: "Record an objection variant choice",
-        mutatesExisting: true,
         description: "Record which objection-specialist variant was picked for one queued draft. It is how the objection tests learn which handling works, so record the variant the coach actually chose.",
     }),
     op({
@@ -76,6 +80,7 @@ export const reviewQueueOperations = [
     }),
     op({
         id: "reviewQueue.drafting.cancel",
+        idempotent: true,
         // Answers with a turn id and state only; no lead-authored text.
         untrustedContent: false,
         title: "Cancel a draft in progress",
@@ -95,6 +100,7 @@ export const reviewQueueOperations = [
     }),
     op({
         id: "reviewQueue.drafting.dismiss",
+        idempotent: true,
         // Answers with no body.
         untrustedContent: false,
         title: "Dismiss a stopped draft",
@@ -124,6 +130,9 @@ export const reviewQueueOperations = [
     }),
     op({
         id: "reviewQueue.bulkReject",
+        idempotent: true,
+        // Sends review.rejected for each draft to the coach's webhook subscribers.
+        openWorld: true,
         // Answers with one outcome per id; no lead-authored text.
         untrustedContent: false,
         title: "Reject several drafts",

package/dist/operations/groups/webhooks.js

@@ -29,6 +29,7 @@ export const webhooksOperations = [
     op({
         id: "webhooks.subscriptions.delete",
         title: "Delete a webhook subscription",
+        idempotent: true,
         // Deleting by id is naturally idempotent (the route matches its policy
         // entry, which carries no requireIdempotency), so no Idempotency-Key is
         // sent and it stays out of the confirm-gated tier that re-triggers live

package/dist/operations/registry.js

@@ -286,6 +286,7 @@ export function op(input) {
     const pageContract = pageContractFor(method, path);
     const group = operationGroupForId(input.id);
     const untrustedContent = input.untrustedContent ?? HashSet.has(UNTRUSTED_CONTENT_GROUPS, group);
+    const readOnly = input.readOnly ?? method === "GET";
     const operation = {
         id: input.id,
         group,
@@ -295,7 +296,8 @@ export function op(input) {
         path,
         scopes,
         mutatesExisting: mutatesExistingRoute,
-        readOnly: input.readOnly ?? method === "GET",
+        readOnly,
+        idempotent: input.idempotent ?? readOnly,
         idempotencyRequired,
         ...optionalField("confirm", input.confirm),
         openWorld: input.openWorld ?? false,

package/dist/pagination.js

@@ -19,6 +19,30 @@ const isCursor = Schema.is(NonEmptyString);
 function pageItems(page, itemsKey) {
     return Option.getOrElse(decodeItems(page[itemsKey]), () => []);
 }
+const hasStringId = Schema.is(Schema.Struct({ id: Schema.String }));
+/**
+ * A reader for the ids of the first `limit` records on a page of `operation`,
+ * for a caller that fans out over what a list route returned. The records sit
+ * under the field the route's page contract names: `items` on the review
+ * queue, `campaigns` on a campaign page. A page without that array, or a record
+ * without a string id, contributes nothing, and the caller still has the page.
+ *
+ * Throws when `operation` is not a list route. Naming one is a wiring mistake,
+ * and an empty id list is exactly how it would stay hidden.
+ */
+export function recordIdsOf(operation) {
+    const itemsKey = operation.pageContract?.itemsKey;
+    if (itemsKey === undefined) {
+        // oxlint-disable-next-line effect/avoid-untagged-errors -- raw failure on an invariant or interop path; not a caller-recoverable domain failure
+        throw new Error(`${operation.id} carries no list of records to read ids from`);
+    }
+    return (page, limit) => isJsonObject(page)
+        ? pageItems(page, itemsKey)
+            .slice(0, limit)
+            .filter(hasStringId)
+            .map((record) => record.id)
+        : [];
+}
 /**
  * The page as something the walk can merge, or nothing when the body is not an
  * object or does not carry the array the route's page shape names. Merging a
@@ -104,7 +128,7 @@ function walkPages(walk, ref) {
             // list would read as "page 3 is down", and only a failed tool result
             // carries the challenge that sends the client back through sign-in.
             if (Result.isFailure(page) && isAuthorizationFailure(page.failure)) {
-                return yield* Effect.fail(page.failure);
+                return yield* page.failure;
             }
             yield* Ref.set(ref, Result.match(page, {
                 onFailure: (error) => failedPage(state, formatError(error)),

package/dist/remote.js

@@ -11,7 +11,7 @@ import { bearerChallenge } from "./oauth-challenge.js";
 import { logAgentSurfaceEvent } from "./observability.js";
 import { optionalField } from "./optional-field.js";
 import { RATE_LIMIT_WINDOW_MS, createLocalRateLimits, } from "./rate-limit.js";
-import { OAUTH_DEFAULT_SCOPE } from "./scopes.js";
+import { OAUTH_CHALLENGE_SCOPE } from "./scopes.js";
 import { toJsonPayload } from "./serialization.js";
 import { createLucaServer } from "./server.js";
 import { sha256Hex } from "./token-verification.js";
@@ -81,13 +81,14 @@ const throttleAnonymous = (request, rateLimits) => consume(rateLimits.perAnonymo
 /**
  * A 401 with the RFC 6750 challenge. `resource_metadata` points OAuth clients
  * at the RFC 9728 document that names the authorization server. Only a request
- * with no token also gets the `scope` hint: a client whose token was refused
+ * with no token also gets the `scope` hint, which names every scope so the
+ * coach can choose on the consent screen: a client whose token was refused
  * must refresh it, not ask for a different scope.
  */
 function unauthorized(detail, resourceMetadataUrl, error) {
     const challenge = bearerChallenge({
         resourceMetadataUrl,
-        ...(error === undefined ? { scope: OAUTH_DEFAULT_SCOPE } : { error }),
+        ...(error === undefined ? { scope: OAUTH_CHALLENGE_SCOPE } : { error }),
     });
     return jsonResponse(401, { error: "unauthorized", detail }, { "www-authenticate": challenge });
 }

package/dist/scopes.js

@@ -40,6 +40,20 @@ export const LUCA_OAUTH_SCOPES = [
 export const LUCA_RESOURCE_SCOPES = Arr.filter(LUCA_OAUTH_SCOPES, (scope) => scope !== "offline_access");
 /** Least-privilege default for a new OAuth connection. */
 export const OAUTH_DEFAULT_SCOPE = "luca:read luca:draft";
+/**
+ * The scope a 401 challenge asks for: every scope this resource accepts, plus
+ * `offline_access`. Claude and ChatGPT request exactly what the challenge
+ * names, and the consent screen offers only what was requested, so naming less
+ * would leave a coach no way to let an assistant send or book. The screen
+ * still starts at {@link OAUTH_DEFAULT_SCOPE}: read is locked on, draft starts
+ * on, and every higher scope starts unchecked for the coach to tick.
+ *
+ * `offline_access` is here for the refresh token. The authorization server
+ * issues one only when the grant carries it, and a client asks for no more
+ * than the challenge names, so without it every connection lapses when its
+ * one-hour access token does.
+ */
+export const OAUTH_CHALLENGE_SCOPE = LUCA_OAUTH_SCOPES.join(" ");
 const READ_TIER_SCOPES = [
     "analytics:read",
     "bookings:read",

package/dist/server.js

@@ -25,12 +25,30 @@ import { fromOperation, fromTaskTool, operationProgram, registerTool, } from "./
 import { TOOLSETS } from "./toolsets.js";
 import { LUCA_MCP_VERSION } from "./version.js";
 const LucaLive = LucaApiLive.pipe(Layer.provide(LucaConfigLive));
+/**
+ * SetLuca's icons, for the Worker's server card. They stay out of
+ * {@link LUCA_SERVER_INFO}: claude.ai abandons a session whose `initialize`
+ * answer carries `serverInfo.icons`, at any protocol version
+ * (anthropics/claude-ai-mcp#474, open). The directories take their icon from
+ * the listing upload, not the handshake, so leaving them out costs nothing.
+ */
+export const LUCA_SERVER_ICONS = [
+    {
+        src: "https://setluca.com/favicon.svg?v=wordmark-1",
+        mimeType: "image/svg+xml",
+    },
+    {
+        src: "https://setluca.com/android-chrome-512x512.png?v=wordmark-1",
+        mimeType: "image/png",
+        sizes: ["512x512"],
+    },
+];
 /**
  * How this server identifies itself to a client. Protocol revision 2026-07-28
- * carries a title, description, website, and icons alongside the name and
- * version, and a client renders those in its server list instead of the bare
- * package name. The Worker's server card is built from the same values, so
- * the two descriptions of this server cannot drift apart.
+ * carries a title, description, and website alongside the name and version,
+ * and a client renders those in its server list instead of the bare package
+ * name. The Worker's server card is built from the same values, so the two
+ * descriptions of this server cannot drift apart.
  */
 export const LUCA_SERVER_INFO = {
     name: "luca-mcp",
@@ -40,17 +58,6 @@ export const LUCA_SERVER_INFO = {
     // live and says which one is not.
     description: "SetLuca runs DM sales for coaches, creators, and experts. Work with leads, conversations, drafted replies, campaigns, broadcasts, and booked calls on Telegram, Instagram, and Messenger. WhatsApp is coming soon.",
     websiteUrl: "https://setluca.com",
-    icons: [
-        {
-            src: "https://setluca.com/favicon.svg?v=wordmark-1",
-            mimeType: "image/svg+xml",
-        },
-        {
-            src: "https://setluca.com/android-chrome-512x512.png?v=wordmark-1",
-            mimeType: "image/png",
-            sizes: ["512x512"],
-        },
-    ],
 };
 /**
  * What a client hands its model at connection time: where to start and which

package/dist/task-tools/analytics.js

@@ -6,10 +6,13 @@ import * as Result from "effect/Result";
 import * as Schema from "effect/Schema";
 import { formatError } from "../errors.js";
 import { NonEmptyString, WORKSPACE_INPUT_FIELDS } from "../fields.js";
+import { operationById } from "../operations.js";
 import { optionalField } from "../optional-field.js";
-import { failureAsField, listingIds, numberInput, operationResult, resultOrError, sectionResult, taskTool, } from "./runtime.js";
+import { recordIdsOf } from "../pagination.js";
+import { failureAsField, numberInput, operationResult, resultOrError, sectionResult, taskTool, } from "./runtime.js";
 const DEFAULT_CAMPAIGN_LIMIT = 5;
 const CAMPAIGN_BROADCAST_LIMIT = 10;
+const campaignIds = recordIdsOf(operationById("campaigns.list"));
 const ANALYTICS_PERIOD_VALUES = [
     "this_week",
     "this_month",
@@ -130,7 +133,7 @@ function analyticsFanOut(call, period, reads) {
  * {@link failureAsField}.
  */
 function campaignAnalytics(call, page, limit) {
-    return Effect.forEach(listingIds(page, limit), (id) => failureAsField("analyticsError", call("campaigns.analytics", { pathParams: { id } })).pipe(Effect.map((analytics) => [id, analytics])), 
+    return Effect.forEach(campaignIds(page, limit), (id) => failureAsField("analyticsError", call("campaigns.analytics", { pathParams: { id } })).pipe(Effect.map((analytics) => [id, analytics])), 
     // Effect.forEach also defaults to concurrency 1. The limit caps this at 5
     // independent per-campaign lookups, so unbounded is fine.
     { concurrency: "unbounded" }).pipe(Effect.map(R.fromEntries));

package/dist/task-tools/bookings.js

@@ -239,7 +239,7 @@ const DEFAULT_GUEST_LINK_HOURS = 168;
 const rescheduleCall = taskTool({
     name: "luca_reschedule_call",
     title: "Move a call to a new time",
-    description: 'Move a booked call to a new time and hand back a fresh reschedule link for the lead. Checks the new slot is open first, against the schedule of its booking type when it has one, and returns the open slots instead of moving the call when it is taken. A call with an idempotencyKey skips that check so a retry gets the original result back. A manual booking moves in Luca only. A Cal.com or Google Calendar booking moves on that calendar too. A Calendly, GoHighLevel or iClosed booking is refused so the coach can move it with the provider, and so is a provider booking with no calendar event, such as one recorded with luca_bookings_create. Moving the call re-arms the lead\'s reminder for the new time, so pass confirm: true only after the coach approves the move. Example: call with { bookingId, slotAt: "2026-07-16T15:00:00Z", confirm: true } after the lead asked to push the call. No message about the move is sent: send the lead the link yourself, or draft the message through the review queue.',
+    description: "Move a booked call to a new time and hand back a fresh reschedule link for the lead. Checks the new slot is open first, against the schedule of its booking type when it has one, and returns the open slots instead of moving the call when it is taken. A call with an idempotencyKey skips that check so a retry gets the original result back. A manual booking moves in SetLuca only. A Cal.com or Google Calendar booking moves on that calendar too, but only once the provider confirms: until then the booking's operation.state reads pending_provider and it keeps its old time, so read the booking again before telling the coach the call moved. A Calendly, GoHighLevel or iClosed booking is refused so the coach can move it with the provider, and so is a provider booking with no calendar event, such as one recorded with luca_bookings_create. Moving the call re-arms the lead's reminder for the new time, so pass confirm: true only after the coach approves the move. Example: call with { bookingId, slotAt: \"2026-07-16T15:00:00Z\", confirm: true } after the lead asked to push the call. SetLuca sends the lead no DM about the move, but a Google Calendar booking's calendar emails the lead the updated invite, and Cal.com may too. Send the lead the link yourself, or draft the message through the review queue.",
     inputSchema: {
         ...WORKSPACE_INPUT_FIELDS,
         bookingId: NonEmptyString.annotate({ description: "The booking to move." }),
@@ -282,7 +282,7 @@ const rescheduleCall = taskTool({
                 ...window,
                 bookingTypeId,
                 timezone: "UTC",
-            }).pipe(Effect.map(Option.some)),
+            }).pipe(Effect.asSome),
         })));
         if (Option.isSome(open) &&
             !open.value.some((candidate) => sameInstant(candidate, slotAt))) {