@sellable/mcp 0.1.0

package/dist/tools/direct-campaigns.d.ts

@@ -0,0 +1,240 @@
+export type AddToInmailCampaignInput = {
+    senderId: string;
+    leads: Array<{
+        linkedinUrl: string;
+        subject: string;
+        message: string;
+    }>;
+    skipDuplicates?: boolean;
+};
+export type AddToConnectionCampaignInput = {
+    senderId: string;
+    leads: Array<{
+        linkedinUrl: string;
+        message: string;
+    }>;
+    skipDuplicates?: boolean;
+};
+export type AddToCommentCampaignInput = {
+    senderId: string;
+    posts: Array<{
+        postUrl: string;
+        comment: string;
+        reactionType?: string;
+    }>;
+    skipDuplicates?: boolean;
+};
+export type DirectCampaignControlInput = {
+    senderId: string;
+    type: "inmail_campaign" | "connection_campaign" | "comment_campaign";
+};
+export type DirectCampaignAddRowsResponse = {
+    tableId: string;
+    inserted: number;
+    skipped: number;
+    rowIds: string[];
+};
+export type StartDirectCampaignResponse = {
+    success: boolean;
+    tableId: string;
+    campaignStatus: string;
+    resumed: boolean;
+};
+export type PauseDirectCampaignResponse = {
+    success: boolean;
+    tableId: string;
+    campaignStatus: string;
+};
+export type GetOrCreateDirectCampaignTableResponse = {
+    tableId: string;
+    tableName: string;
+    campaignOfferId?: string | null;
+    created: boolean;
+};
+export type GetEngagedPostsInput = {
+    senderId: string;
+};
+export type GetEngagedPostsResponse = {
+    postUrls: string[];
+};
+export declare const directCampaignToolDefinitions: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            senderId: {
+                type: string;
+                description: string;
+            };
+            leads: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        linkedinUrl: {
+                            type: string;
+                        };
+                        subject: {
+                            type: string;
+                        };
+                        message: {
+                            type: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+            skipDuplicates: {
+                type: string;
+                description: string;
+            };
+            posts?: undefined;
+            type?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            senderId: {
+                type: string;
+                description: string;
+            };
+            leads: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        linkedinUrl: {
+                            type: string;
+                        };
+                        message: {
+                            type: string;
+                        };
+                        subject?: undefined;
+                    };
+                    required: string[];
+                };
+            };
+            skipDuplicates: {
+                type: string;
+                description: string;
+            };
+            posts?: undefined;
+            type?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            senderId: {
+                type: string;
+                description: string;
+            };
+            posts: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        postUrl: {
+                            type: string;
+                        };
+                        comment: {
+                            type: string;
+                        };
+                        reactionType: {
+                            type: string;
+                            description: string;
+                            enum: string[];
+                        };
+                    };
+                    required: string[];
+                };
+            };
+            skipDuplicates: {
+                type: string;
+                description: string;
+            };
+            leads?: undefined;
+            type?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            senderId: {
+                type: string;
+                description?: undefined;
+            };
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            leads?: undefined;
+            skipDuplicates?: undefined;
+            posts?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            senderId: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            leads?: undefined;
+            skipDuplicates?: undefined;
+            posts?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            senderId: {
+                type: string;
+                description: string;
+            };
+            leads?: undefined;
+            skipDuplicates?: undefined;
+            posts?: undefined;
+            type?: undefined;
+        };
+        required: string[];
+    };
+})[];
+export declare function addToInmailCampaign(input: AddToInmailCampaignInput): Promise<DirectCampaignAddRowsResponse>;
+export declare function addToConnectionCampaign(input: AddToConnectionCampaignInput): Promise<DirectCampaignAddRowsResponse>;
+export declare function addToCommentCampaign(input: AddToCommentCampaignInput): Promise<DirectCampaignAddRowsResponse>;
+export declare function startDirectCampaign(input: DirectCampaignControlInput): Promise<StartDirectCampaignResponse>;
+export declare function pauseDirectCampaign(input: DirectCampaignControlInput): Promise<PauseDirectCampaignResponse>;
+export declare function getOrCreateDirectCampaignTable(input: DirectCampaignControlInput): Promise<GetOrCreateDirectCampaignTableResponse>;
+export declare function getEngagedPosts(input: GetEngagedPostsInput): Promise<GetEngagedPostsResponse>;

package/dist/tools/direct-campaigns.js

@@ -0,0 +1,250 @@
+import { getApi } from "../api.js";
+/**
+ * Sanitize a comment/message before saving to campaign table.
+ * Removes LLM giveaways (em-dashes, smart quotes, etc.) and normalizes text.
+ * Mirrors the logic from src/lib/utils/sanitizeText.ts (sanitizeTextForSequence).
+ */
+function sanitizeForCampaign(text) {
+    if (typeof text !== "string")
+        return text;
+    return (text
+        // Convert literal \n strings to actual newlines
+        .replace(/\\n/g, "\n")
+        // Remove problematic control characters (preserve \n and \r)
+        .replace(/[\u0000-\u0009\u000B\u000C\u000E-\u001F]/g, "")
+        // Replace smart/curly apostrophes with standard apostrophe
+        .replace(/[\u2018\u2019]/g, "'")
+        // Replace smart/curly quotes with standard quotes
+        .replace(/[\u201C\u201D]/g, '"')
+        // Replace em-dashes with " - "
+        .replace(/[\u2014]/g, " - ")
+        // Replace en-dashes with "-"
+        .replace(/[\u2013]/g, "-")
+        // Remove other problematic unicode
+        .replace(/[\u2028\u2029\uFEFF]/g, " ")
+        // Remove bullet characters that LLMs like to insert
+        .replace(/[•◦▪▸►]/g, "-")
+        // Collapse multiple spaces into one
+        .replace(/ {2,}/g, " ")
+        // Trim leading/trailing whitespace per line
+        .replace(/^[ \t]+|[ \t]+$/gm, "")
+        // Normalize unicode to composed form
+        .normalize("NFC")
+        .trim());
+}
+export const directCampaignToolDefinitions = [
+    {
+        name: "add_to_inmail_campaign",
+        description: "Add leads to a sender's InMail direct campaign table (dedupes by default). Auto-creates the table if missing.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                senderId: { type: "string", description: "Outbound sender ID" },
+                leads: {
+                    type: "array",
+                    description: "Leads to add (LinkedIn URL + subject + message)",
+                    items: {
+                        type: "object",
+                        properties: {
+                            linkedinUrl: { type: "string" },
+                            subject: { type: "string" },
+                            message: { type: "string" },
+                        },
+                        required: ["linkedinUrl", "subject", "message"],
+                    },
+                },
+                skipDuplicates: {
+                    type: "boolean",
+                    description: "Skip rows already in table (default true)",
+                },
+            },
+            required: ["senderId", "leads"],
+        },
+    },
+    {
+        name: "add_to_connection_campaign",
+        description: "Add leads to a sender's Connection direct campaign table (dedupes by default). Auto-creates the table if missing.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                senderId: { type: "string", description: "Outbound sender ID" },
+                leads: {
+                    type: "array",
+                    description: "Leads to add (LinkedIn URL + message)",
+                    items: {
+                        type: "object",
+                        properties: {
+                            linkedinUrl: { type: "string" },
+                            message: { type: "string" },
+                        },
+                        required: ["linkedinUrl", "message"],
+                    },
+                },
+                skipDuplicates: {
+                    type: "boolean",
+                    description: "Skip rows already in table (default true)",
+                },
+            },
+            required: ["senderId", "leads"],
+        },
+    },
+    {
+        name: "add_to_comment_campaign",
+        description: "Add posts to a sender's Comment direct campaign table (dedupes by default). Auto-creates the table if missing.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                senderId: { type: "string", description: "Outbound sender ID" },
+                posts: {
+                    type: "array",
+                    description: "Posts to add (Post URL + comment)",
+                    items: {
+                        type: "object",
+                        properties: {
+                            postUrl: { type: "string" },
+                            comment: { type: "string" },
+                            reactionType: {
+                                type: "string",
+                                description: "Reaction type: like (default), celebrate, support, love, insightful, funny",
+                                enum: [
+                                    "like",
+                                    "celebrate",
+                                    "support",
+                                    "love",
+                                    "insightful",
+                                    "funny",
+                                ],
+                            },
+                        },
+                        required: ["postUrl", "comment"],
+                    },
+                },
+                skipDuplicates: {
+                    type: "boolean",
+                    description: "Skip rows already in table (default true)",
+                },
+            },
+            required: ["senderId", "posts"],
+        },
+    },
+    {
+        name: "start_direct_campaign",
+        description: "Start a direct campaign for a sender (sets status to ACTIVE).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                senderId: { type: "string" },
+                type: {
+                    type: "string",
+                    enum: ["inmail_campaign", "connection_campaign", "comment_campaign"],
+                    description: "Direct campaign type",
+                },
+            },
+            required: ["senderId", "type"],
+        },
+    },
+    {
+        name: "pause_direct_campaign",
+        description: "Pause a direct campaign for a sender (sets status to PAUSED).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                senderId: { type: "string" },
+                type: {
+                    type: "string",
+                    enum: ["inmail_campaign", "connection_campaign", "comment_campaign"],
+                    description: "Direct campaign type",
+                },
+            },
+            required: ["senderId", "type"],
+        },
+    },
+    {
+        name: "get_or_create_direct_campaign_table",
+        description: "Get or create the direct campaign workflow table for a sender and type (comment_campaign, inmail_campaign, connection_campaign). Returns the tableId and whether it was created.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                senderId: { type: "string", description: "Outbound sender ID" },
+                type: {
+                    type: "string",
+                    enum: ["inmail_campaign", "connection_campaign", "comment_campaign"],
+                    description: "Direct campaign type",
+                },
+            },
+            required: ["senderId", "type"],
+        },
+    },
+    {
+        name: "get_engaged_posts",
+        description: "Get all post URLs a sender has already engaged with or has scheduled, so you can avoid duplicates when drafting new comments.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                senderId: { type: "string", description: "Outbound sender ID" },
+            },
+            required: ["senderId"],
+        },
+    },
+];
+export async function addToInmailCampaign(input) {
+    const api = getApi();
+    const { senderId, skipDuplicates } = input;
+    const rows = input.leads.map((l) => ({
+        ...l,
+        subject: sanitizeForCampaign(l.subject),
+        message: sanitizeForCampaign(l.message),
+    }));
+    return api.post("/api/v3/direct-campaigns/inmail_campaign/rows", {
+        senderId,
+        rows,
+        skipDuplicates,
+    });
+}
+export async function addToConnectionCampaign(input) {
+    const api = getApi();
+    const { senderId, skipDuplicates } = input;
+    const rows = input.leads.map((l) => ({
+        ...l,
+        message: sanitizeForCampaign(l.message),
+    }));
+    return api.post("/api/v3/direct-campaigns/connection_campaign/rows", {
+        senderId,
+        rows,
+        skipDuplicates,
+    });
+}
+export async function addToCommentCampaign(input) {
+    const api = getApi();
+    const { senderId, skipDuplicates } = input;
+    const rows = input.posts.map((p) => ({
+        ...p,
+        comment: sanitizeForCampaign(p.comment),
+    }));
+    return api.post("/api/v3/direct-campaigns/comment_campaign/rows", {
+        senderId,
+        rows,
+        skipDuplicates,
+    });
+}
+export async function startDirectCampaign(input) {
+    const api = getApi();
+    return api.post(`/api/v3/direct-campaigns/${input.type}/start`, {
+        senderId: input.senderId,
+    });
+}
+export async function pauseDirectCampaign(input) {
+    const api = getApi();
+    return api.post(`/api/v3/direct-campaigns/${input.type}/pause`, {
+        senderId: input.senderId,
+    });
+}
+export async function getOrCreateDirectCampaignTable(input) {
+    const api = getApi();
+    return api.get(`/api/v3/direct-campaigns/${input.type}?senderId=${encodeURIComponent(input.senderId)}`);
+}
+export async function getEngagedPosts(input) {
+    const api = getApi();
+    const senderId = input.senderId;
+    return api.get(`/api/v3/direct-campaigns/comment_campaign/engaged-posts?senderId=${encodeURIComponent(senderId)}`);
+}

package/dist/tools/engage-bootstrap.d.ts

@@ -0,0 +1,94 @@
+import { getAuthStatus } from "./auth.js";
+export type BootstrapEngageInput = {
+    senderId?: string;
+};
+export type BootstrapEngageSender = {
+    id: string;
+    displayName: string;
+    linkedinProfileUrl: string | null;
+};
+export type BootstrapEngageResult = {
+    ok: false;
+    authStatus: Awaited<ReturnType<typeof getAuthStatus>>;
+} | {
+    ok: true;
+    authStatus: Awaited<ReturnType<typeof getAuthStatus>>;
+    needsUserChoice: true;
+    reason: "no_senders" | "multiple_senders" | "unknown_sender";
+    senders: BootstrapEngageSender[];
+    addSenderPath: "/outbound/senders";
+} | {
+    ok: true;
+    authStatus: Awaited<ReturnType<typeof getAuthStatus>>;
+    needsUserChoice: false;
+    selected: {
+        senderId: string;
+        senderDisplayName: string;
+        senderLinkedinProfileUrl: string | null;
+        commentCampaignTableId: string;
+        tableCreated: boolean;
+        engagedPostUrls: string[];
+    };
+};
+export type BootstrapEngageMultiInput = {
+    senderIds?: string[];
+    allSenders?: boolean;
+};
+export type BootstrapEngageMultiSenderResult = {
+    senderId: string;
+    senderDisplayName: string;
+    senderLinkedinProfileUrl: string | null;
+    commentCampaignTableId: string;
+    tableCreated: boolean;
+    engagedPostUrls: string[];
+    hasConfig: boolean;
+};
+export type BootstrapEngageMultiResult = {
+    ok: false;
+    error: string;
+} | {
+    ok: true;
+    senders: BootstrapEngageMultiSenderResult[];
+    globalEngagedPostUrls: string[];
+};
+export declare const engageBootstrapToolDefinitions: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            senderId: {
+                type: string;
+                description: string;
+            };
+            senderIds?: undefined;
+            allSenders?: undefined;
+        };
+        required: never[];
+        additionalProperties: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            senderIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            allSenders: {
+                type: string;
+                description: string;
+            };
+            senderId?: undefined;
+        };
+        required: never[];
+        additionalProperties: boolean;
+    };
+})[];
+export declare function bootstrapEngage(input?: BootstrapEngageInput): Promise<BootstrapEngageResult>;
+export declare function bootstrapEngageMulti(input?: BootstrapEngageMultiInput): Promise<BootstrapEngageMultiResult>;