@sellable/mcp 0.1.557 → 0.1.558

package/dist/tools/provider-preflight.js

@@ -1,84 +1,10 @@
-import { getApi } from "../api.js";
-import { getConfig } from "../auth.js";
-export const FIND_LEADS_WORKFLOW_VERSION = "find-leads-v1";
-function diagnostic(code, message, nextAction) {
-    return { ok: false, code, message, nextAction, resumable: true };
-}
-export async function preflightFindLeadsProvider(input) {
-    if (input.workflowVersion !== FIND_LEADS_WORKFLOW_VERSION) {
-        return diagnostic("find_leads_mcp_runtime_outdated", `Find Leads requires ${FIND_LEADS_WORKFLOW_VERSION}; received ${input.workflowVersion}.`, "update the Sellable MCP/plugin, restart the MCP server, and retry Find Leads.");
-    }
-    let workspaceId = null;
-    try {
-        const config = getConfig();
-        workspaceId = config.activeWorkspaceId || config.workspaceId || null;
-    }
-    catch {
-        return diagnostic("find_leads_auth_required", "Sellable authentication is required before Find Leads can start.", "Run the Sellable first-run login flow, then retry bootstrap_find_leads.");
-    }
-    if (!workspaceId) {
-        return diagnostic("find_leads_workspace_required", "Find Leads needs an active request-scoped workspace.", "Run list_workspaces, set_active_workspace, and retry.");
-    }
-    if (input.providerFacts && !input.providerFacts.configured) {
-        const code = input.provider === "sales-nav"
-            ? "find_leads_sales_nav_unavailable"
-            : input.provider === "prospeo"
-                ? "find_leads_prospeo_unavailable"
-                : "find_leads_signal_capacity_unavailable";
-        const nextAction = input.provider === "sales-nav"
-            ? "Connect a LinkedIn account with an active Sales Navigator search session, then retry preflight."
-            : input.provider === "prospeo"
-                ? "Configure Prospeo and ensure enough credits are available, then retry preflight."
-                : "Wait for Signal Discovery capacity or choose another provider, then retry preflight.";
-        return diagnostic(code, input.providerFacts.reason || `${input.provider} is not ready`, nextAction);
-    }
-    if (!Number.isInteger(input.runVersion) || (input.runVersion ?? -1) < 0) {
-        return diagnostic("find_leads_run_version_required", "A current durable run version is required to persist provider preflight.", "Call get_find_leads_run, then retry preflight with the returned version.");
-    }
-    const receipt = {
-        workflowVersion: FIND_LEADS_WORKFLOW_VERSION,
-        promptHash: input.promptHash || `builtin:${FIND_LEADS_WORKFLOW_VERSION}:${input.provider}`,
-        provider: input.provider,
-        checkedAt: new Date().toISOString(),
-    };
-    const response = await getApi().patch(`/api/v3/find-leads/runs/${encodeURIComponent(input.runId)}`, {
-        action: "record_receipt",
-        version: input.runVersion,
-        kind: "provider_prompt",
-        provider: input.provider.replace(/-/g, "_"),
-        receipt,
-    }, { workspaceId });
-    markProviderPromptLoaded({
-        provider: input.provider,
-        findLeadsRunId: input.runId,
-    });
-    return { ok: true, provider: input.provider, receipt, run: response };
-}
-export const findLeadsProviderPreflightToolDefinitions = [
-    {
-        name: "preflight_find_leads_provider",
-        description: "Persist the selected provider prompt/version receipt and return actionable setup diagnostics before any provider call.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                runId: { type: "string" },
-                runVersion: { type: "number" },
-                provider: { type: "string", enum: ["sales-nav", "prospeo", "signal-discovery"] },
-                workflowVersion: { type: "string" },
-                promptHash: { type: "string" },
-            },
-            required: ["runId", "runVersion", "provider", "workflowVersion"],
-            additionalProperties: false,
-        },
-    },
-];
 const providerPromptLoadedState = new Map();
-function scopedKey(provider, campaignOfferId, findLeadsRunId) {
-    return `${campaignOfferId ? `campaign:${campaignOfferId}` : findLeadsRunId ? `run:${findLeadsRunId}` : "provider:*"}::${provider}`;
+function scopedKey(provider, campaignOfferId) {
+    return `${campaignOfferId ?? "*"}::${provider}`;
 }
-function resolveLoadedState(provider, campaignOfferId, findLeadsRunId) {
-    if (campaignOfferId || findLeadsRunId) {
-        return (providerPromptLoadedState.get(scopedKey(provider, campaignOfferId, findLeadsRunId)) ??
+function resolveLoadedState(provider, campaignOfferId) {
+    if (campaignOfferId) {
+        return (providerPromptLoadedState.get(scopedKey(provider, campaignOfferId)) ??
             null);
     }
     const providerScoped = providerPromptLoadedState.get(scopedKey(provider));
@@ -88,45 +14,32 @@ export function markProviderPromptLoaded(params) {
     const entry = {
         provider: params.provider,
         campaignOfferId: params.campaignOfferId ?? null,
-        findLeadsRunId: params.findLeadsRunId ?? null,
         loadedAt: new Date().toISOString(),
     };
-    providerPromptLoadedState.set(scopedKey(params.provider, params.campaignOfferId, params.findLeadsRunId), entry);
+    providerPromptLoadedState.set(scopedKey(params.provider, params.campaignOfferId), entry);
     return {
         ...entry,
-        scope: entry.campaignOfferId
-            ? "campaign"
-            : entry.findLeadsRunId
-                ? "find-leads-run"
-                : "provider",
+        scope: entry.campaignOfferId ? "campaign" : "provider",
     };
 }
 export function assertProviderPromptLoaded(params) {
-    const loadedState = resolveLoadedState(params.provider, params.campaignOfferId, params.findLeadsRunId);
+    const loadedState = resolveLoadedState(params.provider, params.campaignOfferId);
     if (loadedState) {
         return {
             ok: true,
             provider: params.provider,
             campaignOfferId: params.campaignOfferId ?? null,
-            findLeadsRunId: params.findLeadsRunId ?? null,
             loadedAt: loadedState.loadedAt,
-            scope: loadedState.campaignOfferId
-                ? "campaign"
-                : loadedState.findLeadsRunId
-                    ? "find-leads-run"
-                    : "provider",
+            scope: loadedState.campaignOfferId ? "campaign" : "provider",
         };
     }
     const scopeText = params.campaignOfferId
         ? `campaign ${params.campaignOfferId}`
-        : params.findLeadsRunId
-            ? `Find Leads run ${params.findLeadsRunId}`
-            : "this provider session";
+        : "this run";
     const blockingMessage = `Provider prompt preflight missing for ${params.provider} (${scopeText}).`;
     const diagnostics = {
         provider: params.provider,
         campaignOfferId: params.campaignOfferId ?? null,
-        findLeadsRunId: params.findLeadsRunId ?? null,
         safeToProceed: false,
         blockingErrors: [
             `${blockingMessage} Call get_provider_prompt({ provider: "${params.provider}"${params.campaignOfferId

package/dist/tools/readiness.d.ts

@@ -8,7 +8,6 @@ type WaitForCampaignTableReadyInput = {
 type WaitForLeadListReadyInput = {
     leadListId?: string;
     campaignOfferId?: string;
-    findLeadsRunId?: string;
     workspaceId?: string;
     provider?: "apollo" | "sales-nav" | "prospeo" | "signal-discovery" | "csv-linkedin";
     jobId?: string;
@@ -53,7 +52,6 @@ export declare const readinessToolDefinitions: ({
             };
             leadListId?: undefined;
             campaignOfferId?: undefined;
-            findLeadsRunId?: undefined;
             workspaceId?: undefined;
             provider?: undefined;
             jobId?: undefined;
@@ -77,10 +75,6 @@ export declare const readinessToolDefinitions: ({
                 type: string;
                 description: string;
             };
-            findLeadsRunId: {
-                type: string;
-                description: string;
-            };
             workspaceId: {
                 type: string;
                 description: string;
@@ -284,76 +278,18 @@ export declare function waitForCampaignTableReady(input: WaitForCampaignTableRea
     warning: string | undefined;
 }>;
 export declare function waitForLeadListReady(input: WaitForLeadListReadyInput): Promise<{
-    ready: boolean;
-    reason: string;
-    runId: string;
-    leadListId: string;
-    attempts: number;
-    elapsedMs: number;
-    provider?: undefined;
-    jobId?: undefined;
-    status?: undefined;
-    rowCount?: undefined;
-    counts?: undefined;
-    retryable?: undefined;
-    warning?: undefined;
-    targetLeadCount?: undefined;
-    error?: undefined;
-    sourceShortfall?: undefined;
-    materializing?: undefined;
-} | {
-    ready: boolean;
-    reason: string | undefined;
-    runId: any;
-    leadListId: any;
-    provider: string | null;
-    jobId: any;
-    status: any;
-    rowCount: number;
-    counts: any;
-    retryable: any;
-    attempts: number;
-    elapsedMs: number;
-    warning?: undefined;
-    targetLeadCount?: undefined;
-    error?: undefined;
-    sourceShortfall?: undefined;
-    materializing?: undefined;
-} | {
-    ready: boolean;
-    reason: string;
-    runId: string;
-    leadListId: any;
-    provider: string | null;
-    jobId: any;
-    status: any;
-    rowCount: number;
-    retryable: boolean;
-    attempts: number;
-    elapsedMs: number;
-    warning: string | undefined;
-    counts?: undefined;
-    targetLeadCount?: undefined;
-    error?: undefined;
-    sourceShortfall?: undefined;
-    materializing?: undefined;
-} | {
     ready: boolean;
     reason: string;
     attempts: number;
     elapsedMs: number;
     leadListId: null;
-    runId?: undefined;
     provider?: undefined;
-    jobId?: undefined;
-    status?: undefined;
     rowCount?: undefined;
-    counts?: undefined;
-    retryable?: undefined;
-    warning?: undefined;
+    status?: undefined;
     targetLeadCount?: undefined;
     error?: undefined;
     sourceShortfall?: undefined;
+    warning?: undefined;
     materializing?: undefined;
 } | {
     ready: boolean;
@@ -365,13 +301,9 @@ export declare function waitForLeadListReady(input: WaitForLeadListReadyInput):
     rowCount: number;
     status: string;
     targetLeadCount: number | undefined;
-    runId?: undefined;
-    jobId?: undefined;
-    counts?: undefined;
-    retryable?: undefined;
-    warning?: undefined;
     error?: undefined;
     sourceShortfall?: undefined;
+    warning?: undefined;
     materializing?: undefined;
 } | {
     ready: boolean;
@@ -384,12 +316,8 @@ export declare function waitForLeadListReady(input: WaitForLeadListReadyInput):
     status: string | null;
     targetLeadCount: number | undefined;
     error: string;
-    runId?: undefined;
-    jobId?: undefined;
-    counts?: undefined;
-    retryable?: undefined;
-    warning?: undefined;
     sourceShortfall?: undefined;
+    warning?: undefined;
     materializing?: undefined;
 } | {
     ready: boolean;
@@ -402,12 +330,8 @@ export declare function waitForLeadListReady(input: WaitForLeadListReadyInput):
     status: string;
     targetLeadCount: number | undefined;
     error: string | null;
-    runId?: undefined;
-    jobId?: undefined;
-    counts?: undefined;
-    retryable?: undefined;
-    warning?: undefined;
     sourceShortfall?: undefined;
+    warning?: undefined;
     materializing?: undefined;
 } | {
     ready: boolean;
@@ -421,10 +345,6 @@ export declare function waitForLeadListReady(input: WaitForLeadListReadyInput):
     sourceShortfall: boolean;
     warning: string | undefined;
     reason?: undefined;
-    runId?: undefined;
-    jobId?: undefined;
-    counts?: undefined;
-    retryable?: undefined;
     error?: undefined;
     materializing?: undefined;
 } | {
@@ -440,10 +360,6 @@ export declare function waitForLeadListReady(input: WaitForLeadListReadyInput):
     materializing: boolean | undefined;
     warning: string | undefined;
     error: string | undefined;
-    runId?: undefined;
-    jobId?: undefined;
-    counts?: undefined;
-    retryable?: undefined;
     sourceShortfall?: undefined;
 }>;
 export {};

package/dist/tools/readiness.js

@@ -109,10 +109,6 @@ export const readinessToolDefinitions = [
                     type: "string",
                     description: "Campaign offer ID (used to resolve selectedLeadListId if leadListId is missing).",
                 },
-                findLeadsRunId: {
-                    type: "string",
-                    description: "Durable campaignless run/list ID. When present, poll the authoritative run snapshot instead of campaign/table config.",
-                },
                 workspaceId: {
                     type: "string",
                     description: "Explicit request-scoped workspace id for scheduled/yolo refill automation.",
@@ -208,68 +204,6 @@ export async function waitForLeadListReady(input) {
     const intervalMs = Math.max(500, input.intervalMs ?? DEFAULT_INTERVAL_MS);
     const requireRows = input.requireRows !== false;
     const requireComplete = input.requireComplete !== false;
-    if (input.findLeadsRunId) {
-        if (input.campaignOfferId || (input.leadListId && input.leadListId !== input.findLeadsRunId)) {
-            return {
-                ready: false,
-                reason: "find_leads_target_mismatch",
-                runId: input.findLeadsRunId,
-                leadListId: input.leadListId ?? input.findLeadsRunId,
-                attempts: 0,
-                elapsedMs: 0,
-            };
-        }
-        const startedAt = Date.now();
-        let attempts = 0;
-        let snapshot = null;
-        while (Date.now() - startedAt <= effectiveTimeoutMs) {
-            attempts += 1;
-            snapshot = await apiGet(`/api/v3/find-leads/runs/${encodeURIComponent(input.findLeadsRunId)}`);
-            const status = String(snapshot.status ?? "").toLowerCase();
-            const terminal = snapshot.terminal === true ||
-                ["ready", "completed", "empty", "failed", "cancelled"].includes(status);
-            if (terminal) {
-                const rowCount = Number(snapshot.counts?.rows ?? snapshot.rowCount ?? snapshot.counts?.materialized ?? 0);
-                const failed = status === "failed";
-                const cancelled = status === "cancelled" || snapshot.cancelled === true;
-                return {
-                    ready: !failed && !cancelled,
-                    reason: failed ? "import_failed" : cancelled ? "cancelled" : undefined,
-                    runId: snapshot.runId ?? input.findLeadsRunId,
-                    leadListId: snapshot.leadListId ?? input.findLeadsRunId,
-                    provider: String(snapshot.provider ?? "").replaceAll("_", "-") || null,
-                    jobId: snapshot.importJobId ?? null,
-                    status: snapshot.status,
-                    rowCount,
-                    counts: snapshot.counts ?? { rows: rowCount },
-                    retryable: snapshot.retryable ?? false,
-                    attempts,
-                    elapsedMs: Date.now() - startedAt,
-                };
-            }
-            if (Date.now() - startedAt >= effectiveTimeoutMs)
-                break;
-            await sleep(intervalMs);
-        }
-        return {
-            ready: false,
-            reason: guardApplied ? "tool_timeout_guard" : "timeout",
-            runId: input.findLeadsRunId,
-            leadListId: snapshot?.leadListId ?? input.findLeadsRunId,
-            provider: snapshot?.provider
-                ? String(snapshot.provider).replaceAll("_", "-")
-                : null,
-            jobId: snapshot?.importJobId ?? null,
-            status: snapshot?.status,
-            rowCount: Number(snapshot?.counts?.rows ?? snapshot?.rowCount ?? 0),
-            retryable: true,
-            attempts,
-            elapsedMs: Date.now() - startedAt,
-            warning: guardApplied
-                ? `Stopped after ${effectiveTimeoutMs}ms to avoid host tool timeout (requested ${requestedTimeoutMs}ms). Re-run wait_for_lead_list_ready with the same findLeadsRunId.`
-                : undefined,
-        };
-    }
     let leadListId = input.leadListId;
     let provider = input.provider;
     let targetLeadCount = input.targetLeadCount;

package/dist/tools/refill-executors.d.ts

@@ -1,4 +1,5 @@
 import { searchSignals } from "./leads.js";
+import { type SchedulerExpectedTargetInput } from "./scheduler-run.js";
 export type RefillSendsApprovalMode = "approve" | "mark_ready";
 export type PaidInmailRefreshAction = {
     senderId: string;
@@ -134,6 +135,43 @@ export declare function sleep(ms: number): Promise<unknown>;
 export declare function recordValue(value: unknown): Record<string, unknown> | null;
 export declare function stringValue(value: unknown): string | null;
 export declare function numberValue(value: unknown): number | null;
+export type SchedulerChangedCount = {
+    campaignId: string;
+    tableId: string;
+    actionType: string;
+    count: number;
+};
+export type SchedulerChangedCounts = {
+    complete: true;
+    truncated: false;
+    total: number;
+    byCampaignTableActionType: SchedulerChangedCount[];
+    byCampaignTableActionTypeSender: Array<SchedulerChangedCount & {
+        senderId: string;
+    }>;
+};
+export declare function normalizeSchedulerChangedCounts(value: unknown): SchedulerChangedCounts | null;
+export declare function normalizeSchedulerPrimitiveResult(value: unknown, expected?: {
+    expectedTargets: SchedulerExpectedTargetInput[];
+    expectedTargetsHash: string;
+    maxPlacements: number;
+}): {
+    status: "scheduler_receipt_incomplete";
+    schedulerStatus: string;
+    receipt: {} | null;
+    retryAfterMs: number | null;
+    changedCounts: null;
+    auditComplete: false;
+    blocker: "scheduler_receipt_incomplete";
+} | {
+    status: string;
+    receipt: {} | null;
+    retryAfterMs: number | null;
+    changedCounts: SchedulerChangedCounts;
+    auditComplete: true;
+    schedulerStatus?: undefined;
+    blocker?: undefined;
+};
 export declare function stringArray(value: unknown): string[];
 export declare function prepareRowSelectorValue(value: unknown): PrepareRowSelector | undefined;
 export declare function uniqueStrings(values: Array<string | null | undefined>): string[];