@sellable/mcp 0.1.31 → 0.1.33

package/dist/auth.d.ts

@@ -44,6 +44,31 @@ export declare function updateActiveWorkspace(params: {
     workspaceId: string;
     workspaceName?: string | null;
 }): void;
+/**
+ * Write a fresh Sellable config to disk in the canonical flat shape.
+ *
+ * Used by the FTUX `wait_for_cli_login` MCP tool after a successful magic-link
+ * sign-in. Composes `getConfigPath()` + `writeRawConfigFile()` and writes the
+ * same on-disk shape that `packages/sellable-install/bin/sellable-install.mjs`
+ * `writeAuth(opts)` produces, and that the auth resolution chain in
+ * `getConfig()` reads.
+ *
+ * Field set is intentionally minimal — `{ token, activeWorkspaceId,
+ * activeWorkspaceName?, apiUrl }` — matching the legacy flat format. Do NOT
+ * introduce new fields here; that's a config-shape migration, not this helper's
+ * job.
+ *
+ * Because `DISABLE_CONFIG_CACHE = true`, the next `getConfig()` call sees the
+ * new config without an MCP server restart.
+ */
+export declare function writeNewConfig(opts: {
+    token: string;
+    activeWorkspaceId: string;
+    activeWorkspaceName?: string;
+    apiUrl: string;
+}): {
+    configPath: string;
+};
 export declare function getEngageState(): {
     activeWorkspaceId: string | null;
     state: EngageWorkspaceState | null;

package/dist/auth.js

@@ -178,6 +178,36 @@ function writeRawConfigFile(configPath, raw) {
     fs.writeFileSync(configPath, JSON.stringify(raw, null, 2) + "\n");
     cachedConfig = null;
 }
+/**
+ * Write a fresh Sellable config to disk in the canonical flat shape.
+ *
+ * Used by the FTUX `wait_for_cli_login` MCP tool after a successful magic-link
+ * sign-in. Composes `getConfigPath()` + `writeRawConfigFile()` and writes the
+ * same on-disk shape that `packages/sellable-install/bin/sellable-install.mjs`
+ * `writeAuth(opts)` produces, and that the auth resolution chain in
+ * `getConfig()` reads.
+ *
+ * Field set is intentionally minimal — `{ token, activeWorkspaceId,
+ * activeWorkspaceName?, apiUrl }` — matching the legacy flat format. Do NOT
+ * introduce new fields here; that's a config-shape migration, not this helper's
+ * job.
+ *
+ * Because `DISABLE_CONFIG_CACHE = true`, the next `getConfig()` call sees the
+ * new config without an MCP server restart.
+ */
+export function writeNewConfig(opts) {
+    const configPath = getConfigPath();
+    const raw = {
+        token: opts.token,
+        activeWorkspaceId: opts.activeWorkspaceId,
+        apiUrl: opts.apiUrl,
+    };
+    if (opts.activeWorkspaceName) {
+        raw.activeWorkspaceName = opts.activeWorkspaceName;
+    }
+    writeRawConfigFile(configPath, raw);
+    return { configPath };
+}
 function getActiveEnvConfigRef(raw) {
     if (raw?.activeEnv && raw?.environments) {
         const envName = raw.activeEnv;

package/dist/server.js

@@ -5,8 +5,9 @@ import { getSkillByName, listSkills } from "./skills.js";
 import { authToolDefinitions, getAuthStatus } from "./tools/auth.js";
 import { blueprintCommitToolDefinitions, handleAddColumn, handleCommitBlueprint, } from "./tools/blueprint-commit.js";
 import { bootstrapCreateCampaign, bootstrapToolDefinitions, } from "./tools/bootstrap.js";
-import { campaignToolDefinitions, createCampaign, enrichSender, getCampaign, getCampaignMessagesPreview, getCampaigns, pauseCampaign, startCampaign, updateCampaign, updateCampaignBrief, } from "./tools/campaigns.js";
+import { campaignToolDefinitions, createCampaign, getCampaign, getCampaignMessagesPreview, getCampaigns, pauseCampaign, startCampaign, updateCampaign, updateCampaignBrief, } from "./tools/campaigns.js";
 import { cellToolDefinitions, queueCells, updateCell } from "./tools/cells.js";
+import { handleStartCliLogin, handleWaitForCliLogin, startCliLoginToolDef, waitForCliLoginToolDef, } from "./tools/cli-login.js";
 import { contextToolDefinitions, getCampaignContext, hydrateCampaignContextFromCampaign, markCampaignContextDirty, } from "./tools/context.js";
 import { addToCommentCampaign, addToConnectionCampaign, addToInmailCampaign, directCampaignToolDefinitions, getEngagedPosts, getOrCreateDirectCampaignTable, pauseDirectCampaign, startDirectCampaign, } from "./tools/direct-campaigns.js";
 import { bootstrapEngage, bootstrapEngageMulti, engageBootstrapToolDefinitions, } from "./tools/engage-bootstrap.js";
@@ -42,6 +43,8 @@ const server = new Server({
 const allTools = [
     ...campaignToolDefinitions,
     ...authToolDefinitions,
+    startCliLoginToolDef,
+    waitForCliLoginToolDef,
     ...bootstrapToolDefinitions,
     ...engageBootstrapToolDefinitions,
     ...engageDiscoveryToolDefinitions,
@@ -108,6 +111,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "get_auth_status":
                 result = await getAuthStatus();
                 break;
+            case "start_cli_login":
+                result = await handleStartCliLogin(args);
+                break;
+            case "wait_for_cli_login":
+                result = await handleWaitForCliLogin(args);
+                break;
             case "bootstrap_engage":
                 result = await bootstrapEngage(args);
                 break;
@@ -168,9 +177,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "add_teammate":
                 result = await addTeammate(args);
                 break;
-            case "enrich_sender":
-                result = await enrichSender(args?.linkedinUrl, args?.companyDomain, args?.forceRefresh);
-                break;
             case "get_campaigns":
                 result = await getCampaigns(args?.limit);
                 break;
@@ -406,7 +412,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 result = await fetchLinkedInPosts(args?.linkedinUrl, args?.limit);
                 break;
             case "fetch_linkedin_profile":
-                result = await fetchLinkedInProfile(args?.linkedinUrl);
+                result = await fetchLinkedInProfile(args?.linkedinUrl, {
+                    full: args?.full === true,
+                });
                 break;
             case "fetch_company":
                 result = await fetchCompany(args?.companyUrl);

package/dist/tools/auth.d.ts

@@ -18,6 +18,14 @@ export type AuthStatus = {
         message: string;
         guidance: string;
     };
+    /**
+     * Verbatim instruction for the AGENT (not the user) when auth is missing.
+     * The agent MUST follow this verbatim and MUST NOT show error.guidance to
+     * the user — that's a non-interactive fallback. This field is the single
+     * source of truth for the FTUX magic-link flow so even a stale skill copy
+     * does the right thing.
+     */
+    agentInstruction?: string;
 };
 export declare const authToolDefinitions: {
     name: string;

package/dist/tools/auth.js

@@ -22,7 +22,7 @@ function appendUpdateNotice(notice, update) {
 export const authToolDefinitions = [
     {
         name: "get_auth_status",
-        description: "Verify Sellable authentication early. Call this before any campaign work. Also performs a cached Sellable package update check. Returns ok=false with clear guidance when the token is missing, revoked, or the active workspace is not set. IMPORTANT: When auth succeeds, ALWAYS tell the user the _userNotice message so they know which workspace is active and whether an update is available.",
+        description: "Verify Sellable authentication early. Call this before any campaign work. Also performs a cached Sellable package update check. Returns ok=false with clear guidance when the token is missing, revoked, or the active workspace is not set. IMPORTANT: When auth succeeds, ALWAYS tell the user the _userNotice message so they know which workspace is active and whether an update is available. CRITICAL: When auth FAILS with a missing/invalid token (error.type is 'config' or 'auth'), the response includes an `agentInstruction` field with the verbatim FTUX magic-link signup flow. Follow agentInstruction VERBATIM. Do NOT show the user error.guidance — that's a fallback for non-interactive contexts only.",
         inputSchema: {
             type: "object",
             properties: {},
@@ -110,6 +110,23 @@ export async function getAuthStatus() {
         };
     }
     catch (error) {
+        // FTUX directive: when the user is not yet signed in, tell the AGENT
+        // (not the user) to run the magic-link CLI handoff verbatim. Treat this
+        // as the single source of truth so even a stale skill does the right
+        // thing instead of dumping the technical fallback guidance.
+        const ftuxAgentInstruction = "AGENT INSTRUCTION (verbatim, do not paraphrase, do not show the user `error.guidance`): " +
+            "The user has not signed in to Sellable yet. Run the magic-link CLI handoff. " +
+            "1) Say to the user verbatim: `Welcome to Sellable. What's your email?` " +
+            "2) Wait for the user to type their email in normal chat (do NOT use AskUserQuestion / request_user_input). " +
+            "3) Call `mcp__sellable__start_cli_login({ email })` with that email. " +
+            "4) On `ok: true`, say verbatim (substituting the email exactly as typed): " +
+            "`Magic link sent to {email}. Click it from your inbox — I'll wait. " +
+            "(If your team already has a Sellable workspace, ask an admin to invite you instead — that gets you straight into their data.)` " +
+            "5) Call `mcp__sellable__wait_for_cli_login({ sessionId })` using the sessionId returned by start_cli_login. " +
+            "6) If the result is `error.type === 'tool_timeout_guard'`, IMMEDIATELY re-call wait_for_cli_login with the SAME sessionId — do not narrate, do not call start_cli_login again. Loop until you get a different result. " +
+            "7) On `ok: true`, the user is signed in and `~/.sellable/config.json` has been written. Branch on `isReturningUser`: " +
+            "if true, say `You're in — using your {activeWorkspaceName} workspace.\\n\\nNow — paste the LinkedIn profile URL of the person you want to send from.`; " +
+            "if false, say `Welcome to Sellable — created {activeWorkspaceName} for you.\\n\\nNow — paste the LinkedIn profile URL of the person you want to send from.`";
         if (error instanceof SellableApiError && error.isAuthError) {
             return {
                 ...base,
@@ -120,6 +137,7 @@ export async function getAuthStatus() {
                     guidance: error.guidance ||
                         `Update ${configPath} with a valid token, then retry get_auth_status.`,
                 },
+                agentInstruction: ftuxAgentInstruction,
             };
         }
         const message = error instanceof Error ? error.message : String(error);
@@ -136,6 +154,7 @@ export async function getAuthStatus() {
                 message,
                 guidance,
             },
+            agentInstruction: isConfigError ? ftuxAgentInstruction : undefined,
         };
     }
 }

package/dist/tools/campaigns.d.ts

@@ -117,6 +117,7 @@ export interface CreateCampaignInput {
     campaignId?: string;
     name?: string;
     clientProspectId?: string;
+    senderLinkedinUrl?: string;
     offerPositioning?: unknown;
     campaignBrief?: string;
     messageGenerationMode?: "template" | "ai-generated";
@@ -140,48 +141,6 @@ export interface UpdateCampaignInput {
     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: {
@@ -191,9 +150,6 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
-            linkedinUrl?: undefined;
-            companyDomain?: undefined;
-            forceRefresh?: undefined;
             campaignId?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -201,6 +157,7 @@ export declare const campaignToolDefinitions: ({
             filters?: undefined;
             name?: undefined;
             clientProspectId?: undefined;
+            senderLinkedinUrl?: undefined;
             offerPositioning?: undefined;
             campaignBrief?: undefined;
             messageGenerationMode?: undefined;
@@ -227,9 +184,6 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
-            linkedinUrl?: undefined;
-            companyDomain?: undefined;
-            forceRefresh?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -237,6 +191,7 @@ export declare const campaignToolDefinitions: ({
             filters?: undefined;
             name?: undefined;
             clientProspectId?: undefined;
+            senderLinkedinUrl?: undefined;
             offerPositioning?: undefined;
             campaignBrief?: undefined;
             messageGenerationMode?: undefined;
@@ -310,12 +265,10 @@ export declare const campaignToolDefinitions: ({
                     additionalProperties: boolean;
                 };
             };
-            linkedinUrl?: undefined;
-            companyDomain?: undefined;
-            forceRefresh?: undefined;
             limit?: undefined;
             name?: undefined;
             clientProspectId?: undefined;
+            senderLinkedinUrl?: undefined;
             offerPositioning?: undefined;
             campaignBrief?: undefined;
             messageGenerationMode?: undefined;
@@ -350,6 +303,10 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
+            senderLinkedinUrl: {
+                type: string;
+                description: string;
+            };
             offerPositioning: {
                 type: string;
                 description: string;
@@ -387,9 +344,6 @@ export declare const campaignToolDefinitions: ({
                 };
                 description: string;
             };
-            linkedinUrl?: undefined;
-            companyDomain?: undefined;
-            forceRefresh?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -462,9 +416,6 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
-            linkedinUrl?: undefined;
-            companyDomain?: undefined;
-            forceRefresh?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -472,6 +423,7 @@ export declare const campaignToolDefinitions: ({
             filters?: undefined;
             name?: undefined;
             clientProspectId?: undefined;
+            senderLinkedinUrl?: undefined;
             messageGenerationMode?: undefined;
         };
         required: string[];
@@ -491,9 +443,6 @@ export declare const campaignToolDefinitions: ({
                 type: string;
                 description: string;
             };
-            linkedinUrl?: undefined;
-            companyDomain?: undefined;
-            forceRefresh?: undefined;
             limit?: undefined;
             tableId?: undefined;
             leadLimit?: undefined;
@@ -501,6 +450,7 @@ export declare const campaignToolDefinitions: ({
             filters?: undefined;
             name?: undefined;
             clientProspectId?: undefined;
+            senderLinkedinUrl?: undefined;
             offerPositioning?: undefined;
             messageGenerationMode?: undefined;
             currentStep?: undefined;
@@ -549,41 +499,4 @@ export declare function updateCampaignBrief(campaignId: string, campaignBrief: s
     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 {};

package/dist/tools/campaigns.js

@@ -1,6 +1,6 @@
 import { getApi } from "../api.js";
 import { getConfig } from "../auth.js";
-import { assertCreateCampaignPromptLoaded, assertNetNewCreateCampaignResearchReady, markSenderEnrichmentObserved, } from "./flow-preflight.js";
+import { assertCreateCampaignPromptLoaded, assertNetNewCreateCampaignResearchReady, } from "./flow-preflight.js";
 import { setCampaignInteractionMode, } from "./interaction-mode.js";
 import { fetchCampaignRubrics } from "./processing.js";
 const LEAD_SOURCE_PROVIDERS = {
@@ -27,28 +27,6 @@ function buildWatchUrl(config, redirect) {
     return `${config.apiUrl}/auth/continue?token=${config.token}&redirect=${redirect}${workspaceParam}`;
 }
 export const campaignToolDefinitions = [
-    {
-        name: "enrich_sender",
-        description: "Enrich a LinkedIn profile to get the clientProspectId needed for create_campaign. Fast return (~5-8s) with background enrichment. Call this first with the sender's LinkedIn URL before creating a campaign.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                linkedinUrl: {
-                    type: "string",
-                    description: "Full LinkedIn profile URL (e.g., https://linkedin.com/in/username)",
-                },
-                companyDomain: {
-                    type: "string",
-                    description: "Optional company domain to use instead of resolving from profile",
-                },
-                forceRefresh: {
-                    type: "boolean",
-                    description: "Skip cache and fetch fresh LinkedIn data. Use when you need the latest profile info.",
-                },
-            },
-            required: ["linkedinUrl"],
-        },
-    },
     {
         name: "get_campaigns",
         description: "List campaigns for the authenticated user. Returns id, name, createdAt. Ordered by most recent first.",
@@ -145,7 +123,7 @@ export const campaignToolDefinitions = [
     },
     {
         name: "create_campaign",
-        description: 'Create a new campaign offer OR resume an existing one. Low-level write tool: load create-campaign workflow instructions first via get_subskill_prompt({ subskillName: "create-campaign" }) (or bootstrap_create_campaign + nextStep). If campaignId is provided, this tool returns the watchUrl + state for that campaign instead of creating a new campaign.',
+        description: 'Create a new campaign offer OR resume an existing one. Low-level write tool: load create-campaign workflow instructions first via get_subskill_prompt({ subskillName: "create-campaign" }) (or bootstrap_create_campaign + nextStep). If campaignId is provided, this tool returns the watchUrl + state for that campaign instead of creating a new campaign.\n\nINPUTS:\n- `clientProspectId` is REQUIRED for net-new campaigns. It is the EnrichedProspect row ID for the campaign sender (used by ICP scoring, message generation, brief rendering — every downstream consumer reads sender context from `campaign.clientProspect`).\n- To obtain a `clientProspectId`, run the sender-enrichment flow first: this materializes an EnrichedProspect row from the sender\'s LinkedIn profile URL and returns its ID.\n- `senderLinkedinUrl` may be passed as informational metadata but is NOT a substitute for `clientProspectId` — the API will reject the create if `clientProspectId` is missing.\n\nPREREQUISITES:\n- The /research-sender skill must have been run for this sender (produces enrichment data and the EnrichedProspect row whose ID is `clientProspectId`).',
         inputSchema: {
             type: "object",
             properties: {
@@ -159,7 +137,13 @@ export const campaignToolDefinitions = [
                 },
                 clientProspectId: {
                     type: "string",
-                    description: "Enriched client prospect ID",
+                    description: "REQUIRED for net-new campaigns. EnrichedProspect row ID for the campaign sender. Produced by the sender-enrichment flow (research-sender). The API will reject the create with a 400 if this is missing.",
+                },
+                // `senderLinkedinUrl` (not `linkedinUrl`) to disambiguate from
+                // prospect-side `linkedinUrl` fields used in other tools (research-prospect etc.).
+                senderLinkedinUrl: {
+                    type: "string",
+                    description: "Optional informational metadata: the sender's LinkedIn profile URL. NOT a substitute for clientProspectId — to materialize a prospect from a URL, run the sender-enrichment flow first.",
                 },
                 offerPositioning: {
                     type: "object",
@@ -611,21 +595,34 @@ export async function createCampaign(input) {
     const missing = [];
     if (!input.name)
         missing.push("name");
-    if (!input.clientProspectId)
-        missing.push("clientProspectId");
     if (!input.campaignBrief)
         missing.push("campaignBrief");
+    // clientProspectId is required for net-new campaigns. Every downstream
+    // consumer (ICP scoring, message generation, brief rendering) reads sender
+    // context from `campaign.clientProspect`. senderLinkedinUrl is informational
+    // metadata only — it is NOT a substitute and the API will reject the create
+    // if clientProspectId is missing.
+    if (!input.clientProspectId) {
+        missing.push("clientProspectId");
+    }
+    // Cheap URL sanity check on senderLinkedinUrl when supplied.
+    if (input.senderLinkedinUrl &&
+        typeof input.senderLinkedinUrl === "string" &&
+        !input.senderLinkedinUrl.includes("linkedin.com")) {
+        throw new Error("VALIDATION_ERROR: senderLinkedinUrl must be a LinkedIn URL (must contain 'linkedin.com'). Got: " +
+            input.senderLinkedinUrl);
+    }
     if (missing.length > 0) {
         throw new Error("VALIDATION_ERROR: create_campaign requires either campaignId (resume) " +
             `or all create fields. Missing: ${missing.join(", ")}.\n\n` +
             "Remediation:\n" +
             '- For full workflow, call get_subskill_prompt({ subskillName: "create-campaign" }) and follow it.\n' +
-            '- For net-new campaign creation, call enrich_sender first, then call get_subskill_prompt({ subskillName: "research-sender" }), run sender research, call complete_sender_research(...), and only then call create_campaign.\n' +
+            "- For net-new campaign creation: run the `research-sender` flow first to materialize an EnrichedProspect for the sender from their LinkedIn profile URL, then pass the resulting prospect ID as `clientProspectId`. The campaign sender context (used by ICP scoring, message generation, brief rendering) is read from `campaign.clientProspect`, so this row must exist before the campaign is minted.\n" +
             "- For resume, call create_campaign with campaignId only.");
     }
     assertNetNewCreateCampaignResearchReady();
     const name = input.name;
-    const clientProspectId = input.clientProspectId;
+    const clientProspectId = input.clientProspectId ?? null;
     const campaignBrief = input.campaignBrief;
     // Validate required campaignBrief - must be non-empty markdown
     // Normalize escaped newlines - MCP tool calls pass literal "\n" text (backslash + n)
@@ -680,6 +677,9 @@ export async function createCampaign(input) {
         ...apiInput,
         name,
         clientProspectId,
+        // Forward senderLinkedinUrl alongside clientProspectId. Downstream API may
+        // ignore it for now; future phase wires it.
+        senderLinkedinUrl: input.senderLinkedinUrl ?? null,
         offerPositioning,
         ...(input.leadSourceProvider !== undefined
             ? { leadSourceProvider: normalizedLeadSourceProvider }
@@ -769,124 +769,3 @@ export async function updateCampaignBrief(campaignId, campaignBrief) {
     const api = getApi();
     return api.patch(`/api/v3/mcp/campaigns/${campaignId}`, { campaignBrief });
 }
-export async function enrichSender(linkedinUrl, companyDomain, forceRefresh) {
-    const api = getApi();
-    const result = await api.post(`/api/v4/enrich-prospect`, {
-        linkedinUrl,
-        companyDomain,
-        force: forceRefresh,
-    });
-    markSenderEnrichmentObserved({
-        enrichmentStatus: result.enrichmentStatus,
-        caseStudies: result.caseStudies,
-        proof: result.reviews,
-    });
-    // Serialize to compact digests — strip raw blobs to save context tokens
-    const personData = (result.personData || {});
-    const companyData = (result.companyData || {});
-    const positioning = (result.positioning || {});
-    const caseStudies = result.caseStudies;
-    const reviews = result.reviews;
-    const base = {
-        clientProspectId: result.id,
-        sender: {
-            fullName: personData.fullName || "",
-            headline: personData.headline,
-            title: personData.currentPosition?.title,
-            company: personData.currentPosition?.company?.name,
-        },
-        companyDomain: result.companyDomain,
-        enrichmentStatus: result.enrichmentStatus,
-    };
-    if (result.enrichmentStatus !== "complete")
-        return base;
-    // Build compact companySnapshot
-    base.companySnapshot = {
-        name: companyData.name || "",
-        domain: companyData.domain || result.companyDomain,
-        industry: companyData.industry,
-        employeeRange: companyData.employeeRange,
-        description: companyData.description,
-        linkedinUrl: companyData.linkedinUrl,
-    };
-    // Build compact senderBackground
-    const experience = personData.experience || [];
-    base.senderBackground = {
-        experience: experience.slice(0, 4).map((exp) => ({
-            title: exp.title || "",
-            company: exp.companyName || exp.company || "",
-            duration: exp.duration,
-        })),
-        education: personData.education?.[0]?.schoolName,
-        followerCount: personData.followerCount,
-        connectionCount: personData.connectionCount,
-    };
-    // Build compact proofDigest from caseStudies + reviews + positioning
-    let caseStudyCount = 0;
-    let caseStudySummary = null;
-    if (caseStudies) {
-        try {
-            const parsed = JSON.parse(caseStudies);
-            const studies = parsed.caseStudies || [];
-            caseStudyCount = studies.length;
-            caseStudySummary = parsed.summary || null;
-        }
-        catch {
-            // ignore parse errors
-        }
-    }
-    let reviewHighlight = null;
-    if (reviews) {
-        try {
-            const parsed = JSON.parse(reviews);
-            // Cross-check review sites against confirmed company domain
-            const sites = (parsed.reviewSites || []);
-            const relevantSites = sites.filter((s) => {
-                const url = s.url || "";
-                const domain = result.companyDomain.replace(/^www\./, "");
-                const companyName = (companyData.name || "").toLowerCase();
-                return (url.includes(domain) ||
-                    url.includes(companyName.replace(/\s+/g, "-")) ||
-                    url.includes(companyName.replace(/\s+/g, "")));
-            });
-            if (relevantSites.length > 0) {
-                reviewHighlight = relevantSites
-                    .map((s) => `${s.platform}: ${s.reviewCount || "reviews found"} (${s.url})`)
-                    .join("; ");
-            }
-            // Fall back to summary if no site-level match but summary exists
-            if (!reviewHighlight && parsed.summary) {
-                reviewHighlight = parsed.summary;
-            }
-        }
-        catch {
-            // ignore parse errors
-        }
-    }
-    let positioningOneLiner = null;
-    let keyDifferentiators = [];
-    if (positioning) {
-        try {
-            const desc = typeof positioning === "string" ? JSON.parse(positioning) : positioning;
-            const descObj = typeof desc.description === "string"
-                ? JSON.parse(desc.description)
-                : desc.description || {};
-            positioningOneLiner =
-                descObj.UniqueValueProposition ||
-                    descObj.ExamplePositioningStatement ||
-                    null;
-            keyDifferentiators = descObj.keyDifferentiators || [];
-        }
-        catch {
-            // ignore parse errors
-        }
-    }
-    base.proofDigest = {
-        caseStudyCount,
-        caseStudySummary,
-        reviewHighlight,
-        positioningOneLiner,
-        keyDifferentiators,
-    };
-    return base;
-}