@sellable/mcp 0.1.555 → 0.1.557

package/dist/tools/provider-preflight.js

@@ -1,10 +1,84 @@
+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) {
-    return `${campaignOfferId ?? "*"}::${provider}`;
+function scopedKey(provider, campaignOfferId, findLeadsRunId) {
+    return `${campaignOfferId ? `campaign:${campaignOfferId}` : findLeadsRunId ? `run:${findLeadsRunId}` : "provider:*"}::${provider}`;
 }
-function resolveLoadedState(provider, campaignOfferId) {
-    if (campaignOfferId) {
-        return (providerPromptLoadedState.get(scopedKey(provider, campaignOfferId)) ??
+function resolveLoadedState(provider, campaignOfferId, findLeadsRunId) {
+    if (campaignOfferId || findLeadsRunId) {
+        return (providerPromptLoadedState.get(scopedKey(provider, campaignOfferId, findLeadsRunId)) ??
             null);
     }
     const providerScoped = providerPromptLoadedState.get(scopedKey(provider));
@@ -14,32 +88,45 @@ 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), entry);
+    providerPromptLoadedState.set(scopedKey(params.provider, params.campaignOfferId, params.findLeadsRunId), entry);
     return {
         ...entry,
-        scope: entry.campaignOfferId ? "campaign" : "provider",
+        scope: entry.campaignOfferId
+            ? "campaign"
+            : entry.findLeadsRunId
+                ? "find-leads-run"
+                : "provider",
     };
 }
 export function assertProviderPromptLoaded(params) {
-    const loadedState = resolveLoadedState(params.provider, params.campaignOfferId);
+    const loadedState = resolveLoadedState(params.provider, params.campaignOfferId, params.findLeadsRunId);
     if (loadedState) {
         return {
             ok: true,
             provider: params.provider,
             campaignOfferId: params.campaignOfferId ?? null,
+            findLeadsRunId: params.findLeadsRunId ?? null,
             loadedAt: loadedState.loadedAt,
-            scope: loadedState.campaignOfferId ? "campaign" : "provider",
+            scope: loadedState.campaignOfferId
+                ? "campaign"
+                : loadedState.findLeadsRunId
+                    ? "find-leads-run"
+                    : "provider",
         };
     }
     const scopeText = params.campaignOfferId
         ? `campaign ${params.campaignOfferId}`
-        : "this run";
+        : params.findLeadsRunId
+            ? `Find Leads run ${params.findLeadsRunId}`
+            : "this provider session";
     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,6 +8,7 @@ type WaitForCampaignTableReadyInput = {
 type WaitForLeadListReadyInput = {
     leadListId?: string;
     campaignOfferId?: string;
+    findLeadsRunId?: string;
     workspaceId?: string;
     provider?: "apollo" | "sales-nav" | "prospeo" | "signal-discovery" | "csv-linkedin";
     jobId?: string;
@@ -52,6 +53,7 @@ export declare const readinessToolDefinitions: ({
             };
             leadListId?: undefined;
             campaignOfferId?: undefined;
+            findLeadsRunId?: undefined;
             workspaceId?: undefined;
             provider?: undefined;
             jobId?: undefined;
@@ -75,6 +77,10 @@ export declare const readinessToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            findLeadsRunId: {
+                type: string;
+                description: string;
+            };
             workspaceId: {
                 type: string;
                 description: string;
@@ -280,16 +286,74 @@ export declare function waitForCampaignTableReady(input: WaitForCampaignTableRea
 export declare function waitForLeadListReady(input: WaitForLeadListReadyInput): Promise<{
     ready: boolean;
     reason: string;
+    runId: string;
+    leadListId: string;
     attempts: number;
     elapsedMs: number;
-    leadListId: null;
     provider?: undefined;
-    rowCount?: 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;
+    targetLeadCount?: undefined;
+    error?: undefined;
+    sourceShortfall?: undefined;
     materializing?: undefined;
 } | {
     ready: boolean;
@@ -301,9 +365,13 @@ 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;
@@ -316,8 +384,12 @@ export declare function waitForLeadListReady(input: WaitForLeadListReadyInput):
     status: string | null;
     targetLeadCount: number | undefined;
     error: string;
-    sourceShortfall?: undefined;
+    runId?: undefined;
+    jobId?: undefined;
+    counts?: undefined;
+    retryable?: undefined;
     warning?: undefined;
+    sourceShortfall?: undefined;
     materializing?: undefined;
 } | {
     ready: boolean;
@@ -330,8 +402,12 @@ export declare function waitForLeadListReady(input: WaitForLeadListReadyInput):
     status: string;
     targetLeadCount: number | undefined;
     error: string | null;
-    sourceShortfall?: undefined;
+    runId?: undefined;
+    jobId?: undefined;
+    counts?: undefined;
+    retryable?: undefined;
     warning?: undefined;
+    sourceShortfall?: undefined;
     materializing?: undefined;
 } | {
     ready: boolean;
@@ -345,6 +421,10 @@ 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;
 } | {
@@ -360,6 +440,10 @@ 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,6 +109,10 @@ 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.",
@@ -204,6 +208,68 @@ 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,5 +1,4 @@
 import { searchSignals } from "./leads.js";
-import { type SchedulerExpectedTargetInput } from "./scheduler-run.js";
 export type RefillSendsApprovalMode = "approve" | "mark_ready";
 export type PaidInmailRefreshAction = {
     senderId: string;
@@ -135,43 +134,6 @@ 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[];