@sellable/mcp 0.1.190 → 0.1.191

package/dist/tools/campaign-processing.js

@@ -1,304 +0,0 @@
-import { getApi } from "../api.js";
-import { resolveWaitTimeout } from "./readiness.js";
-const DEFAULT_TIMEOUT_MS = 90000;
-const DEFAULT_INTERVAL_MS = 2000;
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function stableHash(value) {
-    const text = JSON.stringify(value, Object.keys(value).sort());
-    let hash = 2166136261;
-    for (let index = 0; index < text.length; index += 1) {
-        hash ^= text.charCodeAt(index);
-        hash = Math.imul(hash, 16777619);
-    }
-    return (hash >>> 0).toString(16).padStart(8, "0");
-}
-async function postCampaignProcessing(body) {
-    const api = getApi();
-    return api.post("/api/v3/mcp/campaign-processing", body);
-}
-async function resolveSchema(input) {
-    return postCampaignProcessing({
-        action: "schema",
-        campaignId: input.campaignId,
-        tableId: input.tableId,
-    });
-}
-export const campaignProcessingToolDefinitions = [
-    {
-        name: "get_campaign_table_schema",
-        description: "Return compact semantic campaign-table schema: column roles, row count, review-batch metadata, and current approved brief hash. Use for debugging or recovery, not normal queueing.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                campaignId: { type: "string" },
-                tableId: { type: "string" },
-            },
-            additionalProperties: false,
-        },
-    },
-    {
-        name: "select_campaign_cells",
-        description: "Dry-run semantic campaign-cell selection. Returns compact counts and a tiny sample, never bulky row data. Use before queue_campaign_cells only when debugging or explaining a recovery action.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                campaignId: { type: "string" },
-                tableId: { type: "string" },
-                columnRole: {
-                    type: "string",
-                    enum: [
-                        "enrich",
-                        "passesRubric",
-                        "icpScore",
-                        "generateMessage",
-                        "approved",
-                    ],
-                },
-                rowSelector: {
-                    type: "object",
-                    properties: {
-                        type: {
-                            type: "string",
-                            enum: [
-                                "reviewBatch",
-                                "rowIds",
-                                "passedRows",
-                                "needsGeneratedMessage",
-                                "staleGeneratedMessages",
-                            ],
-                        },
-                        basisHash: { type: "string" },
-                        rowIds: { type: "array", items: { type: "string" } },
-                        limit: { type: "number" },
-                    },
-                    required: ["type"],
-                    additionalProperties: false,
-                },
-                limit: { type: "number" },
-            },
-            required: ["columnRole", "rowSelector"],
-            additionalProperties: false,
-        },
-    },
-    {
-        name: "queue_campaign_cells",
-        description: "Resolve and queue campaign cells by semantic role and row selector. Normal create-campaign tail should use this instead of fetching rows only to discover cell IDs. Use forceRerun:true for message-template revisions.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                campaignId: { type: "string" },
-                tableId: { type: "string" },
-                columnRole: {
-                    type: "string",
-                    enum: ["enrich", "generateMessage", "approved"],
-                },
-                rowSelector: {
-                    type: "object",
-                    properties: {
-                        type: {
-                            type: "string",
-                            enum: [
-                                "reviewBatch",
-                                "rowIds",
-                                "passedRows",
-                                "needsGeneratedMessage",
-                                "staleGeneratedMessages",
-                            ],
-                        },
-                        basisHash: { type: "string" },
-                        rowIds: { type: "array", items: { type: "string" } },
-                        limit: { type: "number" },
-                    },
-                    required: ["type"],
-                    additionalProperties: false,
-                },
-                forceRerun: { type: "boolean" },
-                limit: { type: "number" },
-                reason: { type: "string" },
-            },
-            required: ["columnRole", "rowSelector"],
-            additionalProperties: false,
-        },
-    },
-    {
-        name: "wait_for_campaign_processing",
-        description: "Stats-only campaign processing wait. Use for fit/message readiness instead of wait_for_rubric_results when waiting on campaign-table processing. Generated messages are counted separately from rubric passes; current template revision is enforced through messageDraftBasis.approvedBriefHash.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                campaignId: { type: "string" },
-                tableId: { type: "string" },
-                minPassedCount: { type: "number" },
-                minGeneratedMessages: { type: "number" },
-                templateRevision: {
-                    type: "string",
-                    description: '"current" (default when minGeneratedMessages is set) or an explicit current approved brief hash.',
-                },
-                timeoutMs: { type: "number" },
-                intervalMs: { type: "number" },
-            },
-            additionalProperties: false,
-        },
-    },
-    {
-        name: "revise_message_template_and_rerun",
-        description: "Update the approved message template in the campaign brief, mark prior generated messages stale, reset unsent approvals, and force-rerun Generate Message cells. Does not directly overwrite row message cells.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                campaignId: { type: "string" },
-                tableId: { type: "string" },
-                templateMarkdown: { type: "string" },
-                approvedMessageTemplate: { type: "string" },
-                rowSelector: {
-                    type: "object",
-                    properties: {
-                        type: {
-                            type: "string",
-                            enum: [
-                                "passedRows",
-                                "needsGeneratedMessage",
-                                "staleGeneratedMessages",
-                                "rowIds",
-                            ],
-                        },
-                        rowIds: { type: "array", items: { type: "string" } },
-                        limit: { type: "number" },
-                    },
-                    required: ["type"],
-                    additionalProperties: false,
-                },
-                limit: { type: "number" },
-            },
-            required: ["campaignId"],
-            additionalProperties: false,
-        },
-    },
-];
-export async function getCampaignTableSchema(input) {
-    return resolveSchema(input);
-}
-export async function selectCampaignCells(input) {
-    return postCampaignProcessing({
-        action: "select",
-        ...input,
-    });
-}
-export async function queueCampaignCells(input) {
-    return postCampaignProcessing({
-        action: "queue",
-        ...input,
-    });
-}
-export async function reviseMessageTemplateAndRerun(input) {
-    return postCampaignProcessing({
-        action: "reviseTemplateAndRerun",
-        ...input,
-    });
-}
-export async function waitForCampaignProcessing(input) {
-    const api = getApi();
-    const schema = await resolveSchema(input);
-    const { effectiveTimeoutMs, guardApplied, requestedTimeoutMs } = resolveWaitTimeout(input.timeoutMs ?? DEFAULT_TIMEOUT_MS);
-    const intervalMs = Math.max(500, input.intervalMs ?? DEFAULT_INTERVAL_MS);
-    const minPassedCount = typeof input.minPassedCount === "number" &&
-        Number.isFinite(input.minPassedCount)
-        ? Math.max(1, Math.floor(input.minPassedCount))
-        : null;
-    const minGeneratedMessages = typeof input.minGeneratedMessages === "number" &&
-        Number.isFinite(input.minGeneratedMessages)
-        ? Math.max(1, Math.floor(input.minGeneratedMessages))
-        : null;
-    const templateRevision = input.templateRevision ?? (minGeneratedMessages !== null ? "current" : null);
-    const pollKey = stableHash({
-        tableId: schema.tableId,
-        minPassedCount,
-        minGeneratedMessages,
-        templateRevision,
-    });
-    const start = Date.now();
-    let attempts = 0;
-    let lastStats = null;
-    while (Date.now() - start <= effectiveTimeoutMs) {
-        attempts += 1;
-        const stats = await api.get(`/api/v3/workflow-tables/${schema.tableId}/stats`);
-        lastStats = stats;
-        const currentRevisionHash = stats.currentTemplateRevisionHash ?? null;
-        if (templateRevision &&
-            templateRevision !== "current" &&
-            currentRevisionHash &&
-            templateRevision !== currentRevisionHash) {
-            return {
-                ready: false,
-                reason: "template_revision_mismatch",
-                attempts,
-                elapsedMs: Date.now() - start,
-                tableId: schema.tableId,
-                pollKey,
-                requestedTemplateRevision: templateRevision,
-                currentTemplateRevisionHash: currentRevisionHash,
-                guidance: "The requested templateRevision is not current. Re-read campaign state or wait using templateRevision:'current'.",
-                stats,
-            };
-        }
-        const passed = stats.passRate?.passed ?? 0;
-        const generated = templateRevision === "current" || templateRevision !== null
-            ? (stats.currentRevisionGeneratedMessagesCount ?? 0)
-            : (stats.generatedMessagesCount ?? stats.messagesCount ?? 0);
-        const passFloorMet = minPassedCount === null || passed >= minPassedCount;
-        const generatedFloorMet = minGeneratedMessages === null || generated >= minGeneratedMessages;
-        if (passFloorMet && generatedFloorMet) {
-            return {
-                ready: true,
-                attempts,
-                elapsedMs: Date.now() - start,
-                tableId: schema.tableId,
-                pollKey,
-                floors: {
-                    minPassedCount,
-                    minGeneratedMessages,
-                    templateRevision,
-                },
-                result: {
-                    passedCount: passed,
-                    generatedMessagesCount: stats.generatedMessagesCount ?? stats.messagesCount ?? 0,
-                    currentRevisionGeneratedMessagesCount: stats.currentRevisionGeneratedMessagesCount ?? 0,
-                    staleGeneratedMessagesCount: stats.staleGeneratedMessagesCount ?? 0,
-                    generatedWithoutPassCount: stats.generatedWithoutPassCount ?? 0,
-                    currentTemplateRevisionHash: currentRevisionHash,
-                },
-                stats,
-            };
-        }
-        await sleep(intervalMs);
-    }
-    const passed = lastStats?.passRate?.passed ?? 0;
-    return {
-        ready: false,
-        reason: guardApplied ? "tool_timeout_guard" : "timeout",
-        attempts,
-        elapsedMs: Date.now() - start,
-        tableId: schema.tableId,
-        pollKey,
-        warning: guardApplied
-            ? `Stopped after ${effectiveTimeoutMs}ms to avoid host tool timeout (requested ${requestedTimeoutMs}ms).`
-            : undefined,
-        partialResult: {
-            passedCount: passed,
-            generatedMessagesCount: lastStats?.generatedMessagesCount ?? lastStats?.messagesCount ?? 0,
-            currentRevisionGeneratedMessagesCount: lastStats?.currentRevisionGeneratedMessagesCount ?? 0,
-            staleGeneratedMessagesCount: lastStats?.staleGeneratedMessagesCount ?? 0,
-            generatedWithoutPassCount: lastStats?.generatedWithoutPassCount ?? 0,
-            currentTemplateRevisionHash: lastStats?.currentTemplateRevisionHash ??
-                schema.currentApprovedBriefHash,
-            passFloorMet: minPassedCount === null || passed >= minPassedCount,
-            generatedFloorMet: minGeneratedMessages === null ||
-                (lastStats?.currentRevisionGeneratedMessagesCount ?? 0) >=
-                    minGeneratedMessages,
-        },
-        guidance: "Do not repoll with identical arguments after this timeout. Use the partial diagnostics to revise filters/messages, queue missing work, or surface the blocked sample state.",
-        stats: lastStats,
-    };
-}

package/skills/generate-messages-compact/SKILL.md

@@ -1,100 +0,0 @@
----
-name: generate-messages-compact
-description: Compact required Message Draft Builder prompt for create-campaign-v2; load lazy references only for examples, critique, or revision.
-visibility: internal
----
-
-# Generate Messages Compact
-
-Use this prompt for create-campaign-v2 Message Draft Builder. It replaces the
-old normal-path requirement to load the full long-form `generate-messages`
-prompt before writing a reusable template. The full prompt remains available for
-legacy dry-mode validation and deep debugging.
-
-## Mode
-
-Draft one reusable first-message template for a live campaign after:
-
-- `confirm_lead_list` copied a non-empty source into the campaign table
-- the first review batch exists in campaign state
-- the parent recorded the filter choice
-
-This is not the product Generate Message cell path. Do not write row messages,
-queue cells, update the campaign brief, attach sequence, or launch.
-
-## Source Of Truth
-
-Use only live campaign inputs supplied by the parent or scoped MCP tools:
-
-- `campaignId`
-- campaign revision or `updatedAt`
-- campaign brief content and brief hash
-- selected source decision and `selectedLeadListId`
-- `workflowTableId`
-- review-batch row ids/hash and compact sample rows
-- filter choice and saved rubric summary when available
-- explicit user/operator message direction
-
-Reject as `blocked` or `stale` if campaign id, selected list, table id, brief
-hash, or review-batch basis do not match. Do not reconstruct state from local
-markdown/json files, database reads, or stale tool output.
-
-## Required Output
-
-Return compact structured output to the parent:
-
-- `templateRecommendation`: tokenized first-send template
-- `tokenFillRules`: safe fill rules, fallbacks, and unsupported fills
-- `renderedSample`: one good passing-row example
-- `omitSample`: one example where weak personalization is omitted
-- `concerns`: quality risks or blockers
-- `status`: `ready`, `blocked`, `retry-needed`, or `stale`
-- `basisStatus`, `basisToken`, `outputAt`, `outputHash`
-
-The parent owns approval and `update_campaign_brief`.
-
-## Drafting Rules
-
-- Keep it clear, concrete, and product-specific.
-- Use simple language and short lines.
-- Default to one blank line per sentence in the body.
-- Explain what the product is before what it does.
-- Use proof only when the campaign brief provides it.
-- Use the sender's voice, not third-person notes about the sender.
-- Use supported tokens such as `{{first_name}}` only.
-- Prefer omitting weak personalization over forcing a creepy line.
-- Do not claim the prospect needs outbound, automation, AI, or the product.
-- Do not claim private intent from a reaction/comment.
-- Do not write "saw you engaging", "clearly focused", or similar certainty.
-- Do not include bracketed instructions in the outbound message body.
-- Do not include sequence, follow-up, post-accept DM, launch, or sender setup.
-
-Engagement-source personalization is allowed only when it is cautious and
-self-aware, for example: `you might not remember the thread, but I found you
-through a [topic] discussion and your [role/company context] looked close to
-[problem]`. Otherwise omit the source signal and start from role, company,
-problem, or product relevance.
-
-## Quality Gate
-
-Before returning `ready`, verify:
-
-- first name and company/person match
-- tokens have deterministic fallbacks
-- proof claims are in the brief or omitted
-- the prospect angle follows from role/source context
-- unsupported claims are removed
-- the template is usable for the whole review batch, not only one row
-- at least one rendered example reads like a message a real sender would send
-
-## Lazy References
-
-Load `references/examples-critique-revision.md` only when:
-
-- the parent explicitly asks for a critique pass
-- the first draft fails the quality gate
-- the user asks to revise the message template
-- you need more examples to resolve a close call
-
-Do not load the old full `generate-messages` prompt in the normal create-campaign
-path unless the parent asks for legacy dry-mode validation or deep debugging.

package/skills/generate-messages-compact/references/examples-critique-revision.md

@@ -1,37 +0,0 @@
-# Examples, Critique, And Revision
-
-Load this only when the compact prompt is insufficient.
-
-## Good Pattern
-
-```text
-Hey {{first_name}},
-
-You might not remember the thread, but I found you through a Claude GTM
-discussion and your founder/operator background looked close enough to send this.
-
-I am building Sellable so Claude Code can run LinkedIn outbound without
-stitching together Clay, Apollo, HeyReach, and spreadsheets.
-
-It finds people from live LinkedIn signals.
-
-It filters for fit.
-
-It writes the sequence and keeps the campaign moving from chat.
-
-Open to seeing what this would look like for your own outbound workflow?
-```
-
-## Bad Patterns To Block
-
-- "Saw you engaging with Debbie's post, so AI-GTM is clearly on your mind."
-- "You need help with outbound."
-- "I noticed you are struggling with..."
-- "[PERSONALIZATION_LINE]"
-- "Christian's approach is..."
-
-## Revision Rule
-
-When the user asks to change the message after generation, update the approved
-template in the campaign brief and rerun Generate Message cells. Do not directly
-overwrite generated row messages.