@sellable/mcp 0.1.571 → 0.1.573-phase102.202607122257

package/dist/server.js

@@ -11,7 +11,7 @@ import { fillCampaignHorizon } from "./tools/campaign-horizon-fill.js";
 import { cancelPrepareCampaignMessages, getPrepareCampaignMessagesStatus, startPrepareCampaignMessages, } from "./tools/campaign-message-preparation.js";
 import { getCampaignTableSchema, queueCampaignCells, recordCampaignReviewBatch, reviseMessageTemplateAndRerun, selectCampaignCells, waitForCampaignProcessing, } from "./tools/campaign-processing.js";
 import { getCampaignRefillState } from "./tools/campaign-refill-state.js";
-import { archiveCampaign, createCampaign, duplicateCampaign, getCampaign, getCampaignMessagesPreview, getCampaigns, pauseCampaign, startCampaign, updateCampaign, updateCampaignBrief, } from "./tools/campaigns.js";
+import { archiveCampaign, createCampaign, duplicateCampaign, getCampaign, getCampaignMessagesPreview, getCampaigns, pauseCampaign, startCampaign, updateCampaign, updateCampaignBrief, validateCampaign1KickoffHandoff, } from "./tools/campaigns.js";
 import { queueCells, updateCell } from "./tools/cells.js";
 import { handleStartCliLogin, handleWaitForCliLogin, } from "./tools/cli-login.js";
 import { handleDeleteColumn } from "./tools/column-delete.js";
@@ -334,6 +334,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 if (result?.id)
                     markCampaignContextDirty(result.id, "create_campaign");
                 break;
+            case "validate_campaign1_kickoff_handoff":
+                result = validateCampaign1KickoffHandoff(args);
+                break;
             case "update_campaign":
                 result = await updateCampaign(args?.campaignId, args);
                 if (result?._campaign?.id) {

package/dist/tools/campaigns.d.ts

@@ -1,6 +1,7 @@
 import { getConfig } from "../auth.js";
 import { type InteractionMode } from "./interaction-mode.js";
 import type { CampaignOfferNavigation } from "./navigation.js";
+import { type Campaign1KickoffHandoffInput, type Campaign1KickoffHandoffValidationResult } from "../utils/campaign1KickoffHandoff.js";
 declare const LEAD_SOURCE_PROVIDERS: {
     readonly APOLLO: "apollo-ai";
     readonly SALES_NAV: "sales-nav";
@@ -153,6 +154,101 @@ export interface UpdateCampaignInput {
     rubric?: unknown[];
 }
 export declare const campaignToolDefinitions: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        additionalProperties: boolean;
+        properties: {
+            handoffMarkdown: {
+                type: string;
+                minLength: number;
+                description: string;
+            };
+            binding: {
+                type: string;
+                additionalProperties: boolean;
+                properties: {
+                    clientName: {
+                        type: string;
+                        minLength: number;
+                    };
+                    engagementId: {
+                        type: string;
+                        minLength: number;
+                    };
+                    workspaceId: {
+                        type: string;
+                        minLength: number;
+                    };
+                    senderId: {
+                        type: string;
+                        minLength: number;
+                    };
+                };
+                required: string[];
+            };
+            expected: {
+                type: string;
+                additionalProperties: boolean;
+                properties: {
+                    clientName: {
+                        type: string;
+                        minLength: number;
+                    };
+                    engagementId: {
+                        type: string;
+                        minLength: number;
+                    };
+                    workspaceId: {
+                        type: string;
+                        minLength: number;
+                    };
+                    senderId: {
+                        type: string;
+                        minLength: number;
+                    };
+                    senderName: {
+                        type: string;
+                        minLength: number;
+                    };
+                    pageRevision: {
+                        type: string;
+                        minLength: number;
+                    };
+                };
+                required: string[];
+            };
+            campaignId?: undefined;
+            name?: undefined;
+            limit?: undefined;
+            tableId?: undefined;
+            leadLimit?: undefined;
+            page?: undefined;
+            filters?: undefined;
+            clientProspectId?: undefined;
+            senderLinkedinUrl?: undefined;
+            offerPositioning?: undefined;
+            campaignBrief?: undefined;
+            messageGenerationMode?: undefined;
+            currentStep?: undefined;
+            watchNarration?: undefined;
+            leadSourceType?: undefined;
+            leadSourceProvider?: undefined;
+            selectedLeadListId?: undefined;
+            senderIds?: undefined;
+            currentStepTransition?: undefined;
+            clearCurrentStepIfMatches?: undefined;
+            interactionMode?: undefined;
+            enableICPFilters?: undefined;
+            useMessagingTemplate?: undefined;
+            rubric?: undefined;
+            flowVersion?: undefined;
+            workspaceId?: undefined;
+        };
+        required: string[];
+    };
+} | {
     name: string;
     description: string;
     inputSchema: {
@@ -162,6 +258,9 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             name?: undefined;
             limit?: undefined;
             tableId?: undefined;
@@ -206,6 +305,9 @@ export declare const campaignToolDefinitions: ({
                 maxLength: number;
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -244,6 +346,9 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             campaignId?: undefined;
             name?: undefined;
             tableId?: undefined;
@@ -283,6 +388,9 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             name?: undefined;
             limit?: undefined;
             tableId?: undefined;
@@ -369,6 +477,9 @@ export declare const campaignToolDefinitions: ({
                     additionalProperties: boolean;
                 };
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             name?: undefined;
             limit?: undefined;
             clientProspectId?: undefined;
@@ -573,6 +684,9 @@ export declare const campaignToolDefinitions: ({
                 };
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -787,6 +901,9 @@ export declare const campaignToolDefinitions: ({
                 enum: string[];
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -814,6 +931,9 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             name?: undefined;
             limit?: undefined;
             tableId?: undefined;
@@ -856,6 +976,9 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             name?: undefined;
             limit?: undefined;
             tableId?: undefined;
@@ -885,6 +1008,7 @@ export declare const campaignToolDefinitions: ({
         additionalProperties?: undefined;
     };
 })[];
+export declare function validateCampaign1KickoffHandoff(input: Campaign1KickoffHandoffInput): Campaign1KickoffHandoffValidationResult;
 export declare function getCampaigns(limit?: number): Promise<Campaign[]>;
 export declare function getCampaign(campaignId: string): Promise<CampaignDetail>;
 export declare function getCampaignMessagesPreview(input: CampaignMessagesPreviewInput): Promise<CampaignMessagesPreviewResult>;

package/dist/tools/campaigns.js

@@ -4,6 +4,7 @@ import { assertCreateCampaignPromptLoaded, assertNetNewCreateCampaignResearchRea
 import { setCampaignInteractionMode, } from "./interaction-mode.js";
 import { isLinkedInProfileInput, normalizeLinkedInProfileInput, } from "./linkedin-url.js";
 import { fetchCampaignRubrics } from "./processing.js";
+import { parseCampaign1KickoffHandoff, } from "../utils/campaign1KickoffHandoff.js";
 const LEAD_SOURCE_PROVIDERS = {
     APOLLO: "apollo-ai",
     SALES_NAV: "sales-nav",
@@ -189,6 +190,53 @@ function assertBriefHandoffWatchUrl(watchUrl, campaignId) {
         "with create_campaign({ campaignId }) or get_campaign before asking for approval.");
 }
 export const campaignToolDefinitions = [
+    {
+        name: "validate_campaign1_kickoff_handoff",
+        description: "Read-only validation for exact inline sellable.kickoff.campaign1.v1 Markdown plus its Admin result binding. Returns sufficient Campaign 1 intake and campaign-brief Markdown without reading a URL, creating a campaign, sourcing/importing leads, or advancing approval gates.",
+        inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                handoffMarkdown: {
+                    type: "string",
+                    minLength: 1,
+                    description: "Exact inline Markdown returned by admin_onboarding_call finalize. URL-only input is not accepted.",
+                },
+                binding: {
+                    type: "object",
+                    additionalProperties: false,
+                    properties: {
+                        clientName: { type: "string", minLength: 1 },
+                        engagementId: { type: "string", minLength: 1 },
+                        workspaceId: { type: "string", minLength: 1 },
+                        senderId: { type: "string", minLength: 1 },
+                    },
+                    required: ["clientName", "engagementId", "workspaceId", "senderId"],
+                },
+                expected: {
+                    type: "object",
+                    additionalProperties: false,
+                    properties: {
+                        clientName: { type: "string", minLength: 1 },
+                        engagementId: { type: "string", minLength: 1 },
+                        workspaceId: { type: "string", minLength: 1 },
+                        senderId: { type: "string", minLength: 1 },
+                        senderName: { type: "string", minLength: 1 },
+                        pageRevision: { type: "string", minLength: 1 },
+                    },
+                    required: [
+                        "clientName",
+                        "engagementId",
+                        "workspaceId",
+                        "senderId",
+                        "senderName",
+                        "pageRevision",
+                    ],
+                },
+            },
+            required: ["handoffMarkdown", "binding", "expected"],
+        },
+    },
     {
         name: "archive_campaign",
         description: "Archive a campaign through Sellable's product archive endpoint. This is an explicit cleanup/archive action, is idempotent, and may unschedule pending cells owned by that campaign table. Do not use from refill/setup commands unless the user explicitly asked to archive exact campaign ids.",
@@ -527,6 +575,9 @@ export const campaignToolDefinitions = [
         },
     },
 ];
+export function validateCampaign1KickoffHandoff(input) {
+    return parseCampaign1KickoffHandoff(input);
+}
 export async function getCampaigns(limit) {
     const api = getApi();
     const params = limit ? `?limit=${limit}` : "";

package/dist/tools/registry.d.ts

@@ -1085,6 +1085,101 @@ export declare const allTools: ({
         };
         required: string[];
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        additionalProperties: boolean;
+        properties: {
+            handoffMarkdown: {
+                type: string;
+                minLength: number;
+                description: string;
+            };
+            binding: {
+                type: string;
+                additionalProperties: boolean;
+                properties: {
+                    clientName: {
+                        type: string;
+                        minLength: number;
+                    };
+                    engagementId: {
+                        type: string;
+                        minLength: number;
+                    };
+                    workspaceId: {
+                        type: string;
+                        minLength: number;
+                    };
+                    senderId: {
+                        type: string;
+                        minLength: number;
+                    };
+                };
+                required: string[];
+            };
+            expected: {
+                type: string;
+                additionalProperties: boolean;
+                properties: {
+                    clientName: {
+                        type: string;
+                        minLength: number;
+                    };
+                    engagementId: {
+                        type: string;
+                        minLength: number;
+                    };
+                    workspaceId: {
+                        type: string;
+                        minLength: number;
+                    };
+                    senderId: {
+                        type: string;
+                        minLength: number;
+                    };
+                    senderName: {
+                        type: string;
+                        minLength: number;
+                    };
+                    pageRevision: {
+                        type: string;
+                        minLength: number;
+                    };
+                };
+                required: string[];
+            };
+            campaignId?: undefined;
+            name?: undefined;
+            limit?: undefined;
+            tableId?: undefined;
+            leadLimit?: undefined;
+            page?: undefined;
+            filters?: undefined;
+            clientProspectId?: undefined;
+            senderLinkedinUrl?: undefined;
+            offerPositioning?: undefined;
+            campaignBrief?: undefined;
+            messageGenerationMode?: undefined;
+            currentStep?: undefined;
+            watchNarration?: undefined;
+            leadSourceType?: undefined;
+            leadSourceProvider?: undefined;
+            selectedLeadListId?: undefined;
+            senderIds?: undefined;
+            currentStepTransition?: undefined;
+            clearCurrentStepIfMatches?: undefined;
+            interactionMode?: undefined;
+            enableICPFilters?: undefined;
+            useMessagingTemplate?: undefined;
+            rubric?: undefined;
+            flowVersion?: undefined;
+            workspaceId?: undefined;
+        };
+        required: string[];
+    };
 } | {
     name: string;
     description: string;
@@ -1095,6 +1190,9 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             name?: undefined;
             limit?: undefined;
             tableId?: undefined;
@@ -1139,6 +1237,9 @@ export declare const allTools: ({
                 maxLength: number;
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -1177,6 +1278,9 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             campaignId?: undefined;
             name?: undefined;
             tableId?: undefined;
@@ -1216,6 +1320,9 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             name?: undefined;
             limit?: undefined;
             tableId?: undefined;
@@ -1302,6 +1409,9 @@ export declare const allTools: ({
                     additionalProperties: boolean;
                 };
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             name?: undefined;
             limit?: undefined;
             clientProspectId?: undefined;
@@ -1506,6 +1616,9 @@ export declare const allTools: ({
                 };
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -1720,6 +1833,9 @@ export declare const allTools: ({
                 enum: string[];
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -1747,6 +1863,9 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             name?: undefined;
             limit?: undefined;
             tableId?: undefined;
@@ -1789,6 +1908,9 @@ export declare const allTools: ({
                 type: string;
                 description: string;
             };
+            handoffMarkdown?: undefined;
+            binding?: undefined;
+            expected?: undefined;
             name?: undefined;
             limit?: undefined;
             tableId?: undefined;

package/dist/utils/campaign1KickoffHandoff.d.ts

@@ -0,0 +1,76 @@
+export declare const CAMPAIGN_1_KICKOFF_SCHEMA_ID: "sellable.kickoff.campaign1.v1";
+export declare const CAMPAIGN_1_KICKOFF_LABELS: readonly ["Client", "Page revision", "Readiness", "Campaign name", "Campaign objective", "Sender", "Sender public URL", "Product", "Value", "Pain", "Outcome", "Proof", "Prohibited claims", "Target companies", "Buyer roles", "Anti-buyers", "Exclusions", "Geography", "DNC dependency", "Dream account", "Ideal buyer", "Why it fits", "Lookalike 1", "Lookalike 2", "Lookalike 3", "LinkedIn topics", "LinkedIn conversations", "LinkedIn creators", "LinkedIn posts", "Participant behavior", "Offer", "CTA", "Message direction", "Voice constraints", "Sender credibility", "Representative sample plan", "Launch operator", "Activation", "Outstanding blockers"];
+export type Campaign1KickoffLabel = (typeof CAMPAIGN_1_KICKOFF_LABELS)[number];
+export type Campaign1KickoffBinding = {
+    clientName: string;
+    engagementId: string;
+    workspaceId: string;
+    senderId: string;
+};
+export type Campaign1KickoffExpectedBinding = Campaign1KickoffBinding & {
+    pageRevision: string;
+    senderName: string;
+};
+export type Campaign1KickoffHandoffInput = {
+    handoffMarkdown: string;
+    binding: Campaign1KickoffBinding;
+    expected: Campaign1KickoffExpectedBinding;
+};
+export type Campaign1KickoffSignalDiscovery = {
+    topics: string;
+    conversations: string;
+    creators: string;
+    posts: string;
+    participantBehavior: string;
+};
+export type Campaign1KickoffIntake = {
+    client: string;
+    pageRevision: string;
+    campaignName: string;
+    campaignObjective: string;
+    sender: {
+        name: string;
+        publicUrl: string;
+    };
+    product: string;
+    value: string;
+    pain: string;
+    outcome: string;
+    proof: string;
+    prohibitedClaims: string;
+    targetCompanies: string;
+    buyerRoles: string;
+    antiBuyers: string;
+    exclusions: string;
+    geography: string;
+    dncDependency: string;
+    dreamAccount: string;
+    idealBuyer: string;
+    whyItFits: string;
+    lookalikes: readonly [string, string, string];
+    signalDiscovery: Campaign1KickoffSignalDiscovery;
+    offer: string;
+    cta: string;
+    messageDirection: string;
+    voiceConstraints: string;
+    senderCredibility: string;
+    representativeSamplePlan: string;
+    launchOperator: string;
+    activation: string;
+    outstandingBlockers: string;
+};
+export type Campaign1KickoffHandoffErrorCode = "missing_handoff" | "duplicate_handoff" | "unsupported_schema" | "malformed_handoff" | "unexpected_field" | "missing_required_value" | "stale_revision" | "handoff_not_ready" | "binding_mismatch";
+export type Campaign1KickoffHandoffValidationResult = {
+    ok: true;
+    schemaVersion: typeof CAMPAIGN_1_KICKOFF_SCHEMA_ID;
+    handoffMarkdown: string;
+    binding: Campaign1KickoffBinding;
+    intake: Campaign1KickoffIntake;
+    campaignBriefMarkdown: string;
+    sourceSeeds: readonly [];
+} | {
+    ok: false;
+    code: Campaign1KickoffHandoffErrorCode;
+    message: string;
+};
+export declare function parseCampaign1KickoffHandoff(input: Campaign1KickoffHandoffInput): Campaign1KickoffHandoffValidationResult;