@sellable/mcp 0.1.107 → 0.1.109

package/dist/server.js

@@ -29,6 +29,7 @@ import { getSender, listSenders, senderToolDefinitions, } from "./tools/senders.
 import { attachRecommendedSequence, attachSequence, createWorkflowTable, sequencerToolDefinitions, } from "./tools/sequencer.js";
 import { listTables, tableToolDefinitions } from "./tools/tables.js";
 import { handleVerifyTableRow, verifyRowToolDefinitions, } from "./tools/verify-row.js";
+import { sanitizeWatchUrlsForMcpResult } from "./tools/watch-url-security.js";
 import { addTeammate, createWorkspace, getActiveWorkspace, listWorkspaces, setActiveWorkspace, workspaceToolDefinitions, } from "./tools/workspaces.js";
 import { checkForUpdates, logUpdateNotice } from "./update-check.js";
 const server = new Server({
@@ -473,11 +474,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }
+        const safeResult = sanitizeWatchUrlsForMcpResult(result);
         return {
             content: [
                 {
                     type: "text",
-                    text: JSON.stringify(result),
+                    text: JSON.stringify(safeResult),
                 },
             ],
         };

package/dist/tools/campaigns.d.ts

@@ -1,3 +1,4 @@
+import { getConfig } from "../auth.js";
 import { type InteractionMode } from "./interaction-mode.js";
 import type { CampaignOfferNavigation } from "./navigation.js";
 declare const LEAD_SOURCE_PROVIDERS: {
@@ -7,6 +8,7 @@ declare const LEAD_SOURCE_PROVIDERS: {
     readonly SIGNAL_DISCOVERY: "signal-discovery";
 };
 type LeadSourceProvider = (typeof LEAD_SOURCE_PROVIDERS)[keyof typeof LEAD_SOURCE_PROVIDERS];
+export declare function buildWatchUrl(config: Pick<ReturnType<typeof getConfig>, "apiUrl" | "activeWorkspaceId" | "workspaceId">, path: string): string;
 export interface Campaign {
     id: string;
     name: string;

package/dist/tools/campaigns.js

@@ -19,12 +19,12 @@ function normalizeLeadSourceProvider(input) {
         ? input
         : null;
 }
-function buildWatchUrl(config, redirect) {
+export function buildWatchUrl(config, path) {
     const workspaceId = config.activeWorkspaceId || config.workspaceId;
     const workspaceParam = workspaceId
-        ? `&workspaceId=${encodeURIComponent(workspaceId)}`
+        ? `${path.includes("?") ? "&" : "?"}workspaceId=${encodeURIComponent(workspaceId)}`
         : "";
-    return `${config.apiUrl}/auth/continue?token=${config.token}&redirect=${redirect}${workspaceParam}`;
+    return `${config.apiUrl}${path}${workspaceParam}`;
 }
 function isLinkedInProfileUrl(input) {
     try {
@@ -334,9 +334,7 @@ export async function getCampaign(campaignId) {
         api.get(`/api/v3/mcp/campaigns/${campaignId}`),
         fetchCampaignRubrics(campaignId).catch(() => null),
     ]);
-    // Build watch URL with auto-auth token
-    const redirect = encodeURIComponent(`/campaign-builder/${campaignId}?mode=claude`);
-    const watchUrl = buildWatchUrl(config, redirect);
+    const watchUrl = buildWatchUrl(config, `/campaign-builder/${campaignId}?mode=claude`);
     // Merge rubrics into campaignOffer
     const rubrics = (rubricsResult?.rubrics || []).map((r) => ({
         id: r.id || "",
@@ -591,8 +589,7 @@ export async function createCampaign(input) {
     // Idempotent resume path
     if (input.campaignId) {
         const existing = await api.get(`/api/v2/campaign-offers/${input.campaignId}`);
-        const redirect = encodeURIComponent(`/campaign-builder/${existing.id}?mode=claude`);
-        const watchUrl = buildWatchUrl(config, redirect);
+        const watchUrl = buildWatchUrl(config, `/campaign-builder/${existing.id}?mode=claude`);
         const hasCreateFields = input.name ||
             input.clientProspectId ||
             input.offerPositioning !== undefined ||
@@ -710,9 +707,7 @@ export async function createCampaign(input) {
         },
     };
     const result = await api.post(`/api/v2/campaign-offers`, formattedInput);
-    // Build watch URL for Claude Code to share with user
-    const redirect = encodeURIComponent(`/campaign-builder/${result.id}?mode=claude`);
-    const watchUrl = buildWatchUrl(config, redirect);
+    const watchUrl = buildWatchUrl(config, `/campaign-builder/${result.id}?mode=claude`);
     // Serialize to only essential fields for context efficiency
     return {
         id: result.id,

package/dist/tools/sequencer.js

@@ -66,7 +66,9 @@ export const sequencerToolDefinitions = [
         description: "Attach the tier-recommended sequence template to a campaign. " +
             "Delegates template selection to the backend's existing tier-aware selector " +
             "(selectTemplateForTiers), which picks `If Open Profile -> INMAIL_OPEN, else INVITE` " +
-            "for premium/Sales Nav senders and `INVITE -> accepted -> DM` otherwise. " +
+            "for Sales Nav/Recruiter senders and `INVITE -> accepted -> DM` for Basic, Premium, or mixed sender sets. " +
+            "Paid InMail Campaign is not auto-selected because it can spend InMail credits; " +
+            "use attach_sequence with an explicit paid-InMail template only after the user opts in. " +
             "Prefer this over attach_sequence during the create-campaign-v2 autonomous tail — " +
             "it removes the risk of hand-authoring an invalid template mid-long-context. " +
             "Use attach_sequence directly only when the caller needs a custom non-recommended cadence.",

package/dist/tools/watch-url-security.d.ts

@@ -0,0 +1 @@
+export declare function sanitizeWatchUrlsForMcpResult<T>(value: T): T;

package/dist/tools/watch-url-security.js

@@ -0,0 +1,36 @@
+function sanitizeWatchUrlValue(value) {
+    try {
+        const url = new URL(value);
+        if (url.pathname !== "/auth/continue")
+            return value;
+        const redirect = url.searchParams.get("redirect");
+        if (!redirect || !redirect.startsWith("/campaign-builder/")) {
+            return value;
+        }
+        const safeUrl = new URL(redirect, url.origin);
+        const workspaceId = url.searchParams.get("workspaceId");
+        if (workspaceId && !safeUrl.searchParams.has("workspaceId")) {
+            safeUrl.searchParams.set("workspaceId", workspaceId);
+        }
+        return safeUrl.toString();
+    }
+    catch {
+        return value;
+    }
+}
+export function sanitizeWatchUrlsForMcpResult(value) {
+    if (!value || typeof value !== "object")
+        return value;
+    if (Array.isArray(value)) {
+        return value.map((item) => sanitizeWatchUrlsForMcpResult(item));
+    }
+    const input = value;
+    const output = {};
+    for (const [key, nestedValue] of Object.entries(input)) {
+        output[key] =
+            key === "watchUrl" && typeof nestedValue === "string"
+                ? sanitizeWatchUrlValue(nestedValue)
+                : sanitizeWatchUrlsForMcpResult(nestedValue);
+    }
+    return output;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/mcp",
-  "version": "0.1.107",
+  "version": "0.1.109",
   "type": "module",
   "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
   "main": "dist/index.js",

package/skills/create-campaign-v2/core/flow.v2.json

@@ -2192,6 +2192,7 @@
           "requiredVisibleContent": [
             "connect or select a LinkedIn sender",
             "Slack reply review",
+            "Sales Nav vs Premium sequence recommendation, with Paid InMail Campaign only on explicit opt-in",
             "nothing starts until the user confirms launch"
           ],
           "onNoAvailableSender": "surface settings link and wait for sender_connection_required",

package/skills/create-campaign-v2/references/final-handoff-contract.md

@@ -45,9 +45,12 @@ order (all before waiting for the user):
 currentStep: "sequence" })` to attach the sender via the v3 senders route and
    move the watch link to Sequence.
 8. Call `attach_recommended_sequence({ campaignId, currentStep: "send" })` to
-   bind the tier-aware recommended sequence. If that response does not persist
-   `currentStep: "send"`, call `update_campaign({ campaignId, currentStep:
-"send" })`.
+   bind the tier-aware recommended sequence. Explain the sequence choice in the
+   handoff: Sales Nav/Recruiter senders get the Sales Nav Open Profile
+   strategy, Basic/Premium/mixed senders get the Premium invite-to-DM strategy,
+   and Paid InMail Campaign is only an explicit paid-InMail opt-in because it
+   can spend InMail credits. If that response does not persist `currentStep:
+"send"`, call `update_campaign({ campaignId, currentStep: "send" })`.
 9. Re-surface the `watchUrl` using the exact block in
    `references/watch-link-handoff.md`.
 10. Surface the `handoff.orientation` string from `auto-execute.yaml`

package/skills/create-campaign-v2/references/watch-link-handoff.md

@@ -11,11 +11,12 @@ gating, and handoff read campaign state first.
 
 ## Plumbing Reuse
 
-`create_campaign` already returns a signed `watchUrl` on the response
+`create_campaign` already returns a safe app `watchUrl` on the response
 (`CampaignDetail.watchUrl` in `mcp/sellable/src/tools/campaigns.ts`). V2 does
 NOT mint a new token, does NOT call a different route, and does NOT construct
 the URL locally. Capture whatever `watchUrl` the existing tool returns and
-surface it verbatim.
+surface it verbatim. The URL must never include a raw API token, `auth/continue`
+token exchange URL, magic-link secret, or other bearer credential.
 
 ## Shell-First Link
 
@@ -80,18 +81,20 @@ Do not spam the link between internal tool calls.
 On resume:
 
 1. Load the `CampaignOffer` for the campaign being resumed.
-2. Recover the signed link through the existing resume path
+2. Recover the safe app link through the existing resume path
    (`create_campaign({ campaignId })` when available).
 3. Inspect `currentStep` and print a short orientation for where the user will
    land now.
 4. Print the recovered `watchUrl`.
 
-The re-surface must use the signed `watchUrl` from the tool response, not a
+The re-surface must use the safe `watchUrl` from the tool response, not a
 cached or reconstructed URL.
 
 ## Hard Rules
 
 - Never fabricate or reconstruct the URL locally.
+- Never print a URL containing `token=`, `/auth/continue`, a magic-link secret,
+  or any other bearer credential.
 - Missing `watchUrl` is an error, not a silent skip.
 - The first watch link must be shown only after the v1 brief is on the campaign.
 - A watch link is not approval to import, attach sequence, or start.

package/skills/create-campaign-v2-tail/SKILL.md

@@ -459,7 +459,11 @@ Shape:
 currentStep: "sequence" })` to attach the sender through the v3 senders
    route and orient the watch link to Sequence.
 8. Call `attach_recommended_sequence({ campaignId, currentStep: "send" })`
-   (bind the tier-recommended sequence to the campaign). If the tool response
+   (bind the tier-recommended sequence to the campaign). Explain the sequence
+   choice plainly: Sales Nav/Recruiter senders get the Sales Nav Open Profile
+   strategy, Basic/Premium/mixed senders get the Premium invite-to-DM strategy,
+   and Paid InMail Campaign is available only as an explicit paid-InMail
+   opt-in because it can spend InMail credits. If the tool response
    does not persist `currentStep: "send"`, call
    `update_campaign({ campaignId, currentStep: "send" })`.
 9. Re-surface the `watchUrl` using `references/watch-link-handoff.md`.