@sellable/mcp 0.1.0

package/dist/tools/campaigns.d.ts

@@ -0,0 +1,589 @@
+import { type InteractionMode } from "./interaction-mode.js";
+import type { CampaignOfferNavigation } from "./navigation.js";
+declare const LEAD_SOURCE_PROVIDERS: {
+    readonly APOLLO: "apollo-ai";
+    readonly SALES_NAV: "sales-nav";
+    readonly PROSPEO: "prospeo";
+    readonly SIGNAL_DISCOVERY: "signal-discovery";
+};
+type LeadSourceProvider = (typeof LEAD_SOURCE_PROVIDERS)[keyof typeof LEAD_SOURCE_PROVIDERS];
+export interface Campaign {
+    id: string;
+    name: string;
+    createdAt: string;
+}
+export interface LeadScoringRubricItem {
+    id: string;
+    checkName: string;
+    description: string;
+    criterion: string;
+    reason: string;
+    useCheckForScoring: boolean;
+    isRequiredCheck: boolean;
+    allowPartialCredit: boolean;
+    strictMatching: boolean;
+}
+export interface CampaignDetail {
+    campaignOffer: {
+        id: string;
+        name: string;
+        positioningData?: {
+            offer?: string;
+            targetAudience?: string;
+            painPoints?: string[];
+            benefits?: string[];
+            proofPoints?: string[];
+            callToAction?: string;
+        };
+        senderInfo?: {
+            name: string;
+            company: string;
+            title: string;
+            linkedinProfileUrl: string;
+            bio?: string;
+        };
+        leadScoringRubrics: LeadScoringRubricItem[];
+    };
+    campaignBrief: string | null;
+    workflowTableId: string | null;
+    stats: {
+        total: number;
+        pending: number;
+        approved: number;
+        sent: number;
+    };
+    watchUrl: string;
+}
+export interface CampaignMessagesPreviewInput {
+    campaignId: string;
+    tableId?: string;
+    leadLimit?: number;
+    page?: number;
+    filters?: CampaignMessagesPreviewFilter[];
+}
+export type CampaignMessagesPreviewFilterValue = string | number | boolean | Array<string | number | boolean>;
+export interface CampaignMessagesPreviewFilter {
+    column: string;
+    op: string;
+    value?: CampaignMessagesPreviewFilterValue;
+    caseSensitive?: boolean;
+}
+export interface CampaignMessagesPreviewRow {
+    index: number;
+    rowId: string;
+    name: string;
+    title: string;
+    company: string;
+    linkedinUrl: string | null;
+    messagePreview: string | null;
+    messageCellId: string | null;
+    hasMessage: boolean;
+    approveCellId: string | null;
+    isApproved: boolean;
+}
+export interface CampaignMessagesPreviewResult {
+    campaignId: string;
+    tableId: string;
+    stats: {
+        totalRows: number;
+        enrichedCount: number;
+        needsEnrichCount: number;
+        messagesCount: number;
+        approvedCount: number;
+        needsApprovalCount: number;
+        processingCount: number;
+    } | null;
+    meta: {
+        columns: Array<{
+            id: string;
+            name: string;
+            columnType: string;
+        }>;
+        keyColumns: {
+            nameColumnId: string | null;
+            titleColumnId: string | null;
+            companyColumnId: string | null;
+            linkedinUrlColumnId: string | null;
+            messageColumnId: string | null;
+            approveColumnId: string | null;
+        };
+    };
+    leads: {
+        limit: number;
+        rows: CampaignMessagesPreviewRow[];
+    };
+}
+export interface CreateCampaignInput {
+    campaignId?: string;
+    name?: string;
+    clientProspectId?: string;
+    offerPositioning?: unknown;
+    campaignBrief?: string;
+    messageGenerationMode?: "template" | "ai-generated";
+    currentStep?: string | null;
+    leadSourceType?: string | null;
+    leadSourceProvider?: LeadSourceProvider | "apollo" | null;
+    selectedLeadListId?: string | null;
+    senderIds?: string[];
+}
+export interface UpdateCampaignInput {
+    offerPositioning?: unknown;
+    campaignBrief?: unknown;
+    leadSourceType?: string | null;
+    leadSourceProvider?: LeadSourceProvider | "apollo" | null;
+    selectedLeadListId?: string | null;
+    currentStep?: string | null;
+    interactionMode?: InteractionMode;
+    enableICPFilters?: boolean | null;
+    useMessagingTemplate?: boolean | null;
+    senderIds?: string[];
+    rubric?: unknown[];
+}
+export declare const campaignToolDefinitions: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            linkedinUrl: {
+                type: string;
+                description: string;
+            };
+            companyDomain: {
+                type: string;
+                description: string;
+            };
+            forceRefresh: {
+                type: string;
+                description: string;
+            };
+            limit?: undefined;
+            campaignId?: undefined;
+            tableId?: undefined;
+            leadLimit?: undefined;
+            page?: undefined;
+            filters?: undefined;
+            name?: undefined;
+            clientProspectId?: undefined;
+            offerPositioning?: undefined;
+            campaignBrief?: undefined;
+            messageGenerationMode?: undefined;
+            currentStep?: undefined;
+            leadSourceType?: undefined;
+            leadSourceProvider?: undefined;
+            selectedLeadListId?: undefined;
+            senderIds?: undefined;
+            interactionMode?: undefined;
+            enableICPFilters?: undefined;
+            useMessagingTemplate?: undefined;
+            rubric?: undefined;
+        };
+        required: string[];
+        additionalProperties?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            limit: {
+                type: string;
+                description: string;
+            };
+            linkedinUrl?: undefined;
+            companyDomain?: undefined;
+            forceRefresh?: undefined;
+            campaignId?: undefined;
+            tableId?: undefined;
+            leadLimit?: undefined;
+            page?: undefined;
+            filters?: undefined;
+            name?: undefined;
+            clientProspectId?: undefined;
+            offerPositioning?: undefined;
+            campaignBrief?: undefined;
+            messageGenerationMode?: undefined;
+            currentStep?: undefined;
+            leadSourceType?: undefined;
+            leadSourceProvider?: undefined;
+            selectedLeadListId?: undefined;
+            senderIds?: undefined;
+            interactionMode?: undefined;
+            enableICPFilters?: undefined;
+            useMessagingTemplate?: undefined;
+            rubric?: undefined;
+        };
+        required: never[];
+        additionalProperties?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            campaignId: {
+                type: string;
+                description: string;
+            };
+            linkedinUrl?: undefined;
+            companyDomain?: undefined;
+            forceRefresh?: undefined;
+            limit?: undefined;
+            tableId?: undefined;
+            leadLimit?: undefined;
+            page?: undefined;
+            filters?: undefined;
+            name?: undefined;
+            clientProspectId?: undefined;
+            offerPositioning?: undefined;
+            campaignBrief?: undefined;
+            messageGenerationMode?: undefined;
+            currentStep?: undefined;
+            leadSourceType?: undefined;
+            leadSourceProvider?: undefined;
+            selectedLeadListId?: undefined;
+            senderIds?: undefined;
+            interactionMode?: undefined;
+            enableICPFilters?: undefined;
+            useMessagingTemplate?: undefined;
+            rubric?: undefined;
+        };
+        required: string[];
+        additionalProperties?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            campaignId: {
+                type: string;
+                description: string;
+            };
+            tableId: {
+                type: string;
+                description: string;
+            };
+            leadLimit: {
+                type: string;
+                description: string;
+            };
+            page: {
+                type: string;
+                description: string;
+            };
+            filters: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        column: {
+                            type: string;
+                            description: string;
+                        };
+                        op: {
+                            type: string;
+                            description: string;
+                        };
+                        value: {
+                            oneOf: ({
+                                type: string;
+                                items?: undefined;
+                            } | {
+                                type: string;
+                                items: {
+                                    oneOf: {
+                                        type: string;
+                                    }[];
+                                };
+                            })[];
+                        };
+                        caseSensitive: {
+                            type: string;
+                        };
+                    };
+                    required: string[];
+                    additionalProperties: boolean;
+                };
+            };
+            linkedinUrl?: undefined;
+            companyDomain?: undefined;
+            forceRefresh?: undefined;
+            limit?: undefined;
+            name?: undefined;
+            clientProspectId?: undefined;
+            offerPositioning?: undefined;
+            campaignBrief?: undefined;
+            messageGenerationMode?: undefined;
+            currentStep?: undefined;
+            leadSourceType?: undefined;
+            leadSourceProvider?: undefined;
+            selectedLeadListId?: undefined;
+            senderIds?: undefined;
+            interactionMode?: undefined;
+            enableICPFilters?: undefined;
+            useMessagingTemplate?: undefined;
+            rubric?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            campaignId: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            clientProspectId: {
+                type: string;
+                description: string;
+            };
+            offerPositioning: {
+                type: string;
+                description: string;
+            };
+            campaignBrief: {
+                type: string;
+                description: string;
+            };
+            messageGenerationMode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            currentStep: {
+                type: string[];
+                description: string;
+            };
+            leadSourceType: {
+                type: string[];
+                description: string;
+            };
+            leadSourceProvider: {
+                type: string[];
+                enum: ("signal-discovery" | "sales-nav" | "prospeo" | "apollo-ai" | null)[];
+                description: string;
+            };
+            selectedLeadListId: {
+                type: string[];
+                description: string;
+            };
+            senderIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            linkedinUrl?: undefined;
+            companyDomain?: undefined;
+            forceRefresh?: undefined;
+            limit?: undefined;
+            tableId?: undefined;
+            leadLimit?: undefined;
+            page?: undefined;
+            filters?: undefined;
+            interactionMode?: undefined;
+            enableICPFilters?: undefined;
+            useMessagingTemplate?: undefined;
+            rubric?: undefined;
+        };
+        required: never[];
+        additionalProperties?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            campaignId: {
+                type: string;
+                description: string;
+            };
+            offerPositioning: {
+                type: string;
+                description: string;
+            };
+            campaignBrief: {
+                description: string;
+                type?: undefined;
+            };
+            leadSourceType: {
+                type: string[];
+                description: string;
+            };
+            leadSourceProvider: {
+                type: string[];
+                enum: ("signal-discovery" | "sales-nav" | "prospeo" | "apollo-ai" | null)[];
+                description: string;
+            };
+            selectedLeadListId: {
+                type: string[];
+                description: string;
+            };
+            currentStep: {
+                type: string[];
+                description: string;
+            };
+            interactionMode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            enableICPFilters: {
+                type: string[];
+                description: string;
+            };
+            useMessagingTemplate: {
+                type: string[];
+                description: string;
+            };
+            senderIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            rubric: {
+                type: string;
+                description: string;
+            };
+            linkedinUrl?: undefined;
+            companyDomain?: undefined;
+            forceRefresh?: undefined;
+            limit?: undefined;
+            tableId?: undefined;
+            leadLimit?: undefined;
+            page?: undefined;
+            filters?: undefined;
+            name?: undefined;
+            clientProspectId?: undefined;
+            messageGenerationMode?: undefined;
+        };
+        required: string[];
+        additionalProperties?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            campaignId: {
+                type: string;
+                description: string;
+            };
+            campaignBrief: {
+                type: string;
+                description: string;
+            };
+            linkedinUrl?: undefined;
+            companyDomain?: undefined;
+            forceRefresh?: undefined;
+            limit?: undefined;
+            tableId?: undefined;
+            leadLimit?: undefined;
+            page?: undefined;
+            filters?: undefined;
+            name?: undefined;
+            clientProspectId?: undefined;
+            offerPositioning?: undefined;
+            messageGenerationMode?: undefined;
+            currentStep?: undefined;
+            leadSourceType?: undefined;
+            leadSourceProvider?: undefined;
+            selectedLeadListId?: undefined;
+            senderIds?: undefined;
+            interactionMode?: undefined;
+            enableICPFilters?: undefined;
+            useMessagingTemplate?: undefined;
+            rubric?: undefined;
+        };
+        required: string[];
+        additionalProperties?: undefined;
+    };
+})[];
+export declare function getCampaigns(limit?: number): Promise<Campaign[]>;
+export declare function getCampaign(campaignId: string): Promise<CampaignDetail>;
+export declare function getCampaignMessagesPreview(input: CampaignMessagesPreviewInput): Promise<CampaignMessagesPreviewResult>;
+export interface CreateCampaignResult {
+    id: string;
+    name: string;
+    createdAt: string;
+    currentStep: string | null;
+    watchUrl: string;
+    resumed?: boolean;
+    warning?: string;
+}
+export declare function createCampaign(input: CreateCampaignInput): Promise<CreateCampaignResult>;
+export interface UpdateCampaignResult {
+    id: string;
+    name: string;
+    currentStep: string | null;
+    updatedAt: string;
+    navigation?: unknown;
+    _campaign?: CampaignOfferNavigation;
+}
+export declare function updateCampaign(campaignId: string, input: UpdateCampaignInput): Promise<UpdateCampaignResult>;
+export declare function startCampaign(campaignId: string): Promise<{
+    success: boolean;
+}>;
+export declare function pauseCampaign(campaignId: string): Promise<{
+    success: boolean;
+}>;
+export declare function updateCampaignBrief(campaignId: string, campaignBrief: string): Promise<{
+    success: boolean;
+    campaignBrief: string;
+}>;
+export interface EnrichSenderResult {
+    clientProspectId: string;
+    sender: {
+        fullName: string;
+        headline?: string;
+        title?: string;
+        company?: string;
+    };
+    companyDomain: string;
+    enrichmentStatus: "partial" | "complete";
+    companySnapshot?: {
+        name: string;
+        domain: string;
+        industry?: string;
+        employeeRange?: string;
+        description?: string;
+        linkedinUrl?: string;
+    } | null;
+    senderBackground?: {
+        experience: {
+            title: string;
+            company: string;
+            duration?: string;
+        }[];
+        education?: string;
+        followerCount?: number;
+        connectionCount?: number;
+    } | null;
+    proofDigest?: {
+        caseStudyCount: number;
+        caseStudySummary: string | null;
+        reviewHighlight: string | null;
+        positioningOneLiner: string | null;
+        keyDifferentiators: string[];
+    } | null;
+}
+export declare function enrichSender(linkedinUrl: string, companyDomain?: string, forceRefresh?: boolean): Promise<EnrichSenderResult>;
+export {};