@coldiq/mcp 0.5.3 → 0.5.4

package/dist/tools/extract-post-engagement.d.ts

@@ -4,18 +4,11 @@ export declare const extractPostEngagementDescription: string;
 export declare const extractPostEngagementSchema: {
     post_url: z.ZodString;
     type: z.ZodDefault<z.ZodEnum<["comments", "reactions", "both"]>>;
-    include_replies: z.ZodOptional<z.ZodBoolean>;
 };
 export declare function extractPostEngagementHandler(input: Record<string, unknown>): Promise<{
     content: {
         type: "text";
         text: string;
     }[];
-    isError: boolean;
-} | {
-    content: {
-        type: "text";
-        text: string;
-    }[];
 }>;
 //# sourceMappingURL=extract-post-engagement.d.ts.map

package/dist/tools/extract-post-engagement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract-post-engagement.d.ts","sourceRoot":"","sources":["../../src/tools/extract-post-engagement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,yBAAyB,4BAA4B,CAAA;AAElE,eAAO,MAAM,gCAAgC,QAGmG,CAAA;AAEhJ,eAAO,MAAM,2BAA2B;;;;CAavC,CAAA;AAqBD,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;GA0FhF"}
+{"version":3,"file":"extract-post-engagement.d.ts","sourceRoot":"","sources":["../../src/tools/extract-post-engagement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,yBAAyB,4BAA4B,CAAA;AAElE,eAAO,MAAM,gCAAgC,QAIoO,CAAA;AAEjR,eAAO,MAAM,2BAA2B;;;CAavC,CAAA;AAmLD,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;GAqIhF"}

package/dist/tools/extract-post-engagement.js

@@ -3,7 +3,8 @@ import { callApi } from '../client.js';
 export const extractPostEngagementName = 'extract_post_engagement';
 export const extractPostEngagementDescription = 'Extract the people who engaged with a LinkedIn post — commenters and/or reactors — as a deduplicated list of contacts (name, profile URL, headline). ' +
     'Use this for social-signal prospecting: pull everyone who engaged with a viral post, then chain the results into enrich_person / find_email to get roles and work emails. ' +
-    'Runs an async extraction job (typically ~30–120s) and returns once the people are ready. Pricing is returned in the response credit headers.';
+    'Runs an async extraction job (typically 1–3 minutes; longer for posts with 1000+ interactions) and returns every extracted person once ready. ' +
+    'If the primary source fails or its account is out of credits, automatically retries on a second provider and says so in `_meta.provider` — those records carry name/profile URL/headline only, so enrich them before use. Pricing is returned in the response credit headers.';
 export const extractPostEngagementSchema = {
     post_url: z
         .string()
@@ -13,14 +14,132 @@ export const extractPostEngagementSchema = {
         .enum(['comments', 'reactions', 'both'])
         .default('both')
         .describe('Which engagement to extract: "comments" (people who commented), "reactions" (people who reacted), or "both" (default — deduplicated across both).'),
-    include_replies: z
-        .boolean()
-        .optional()
-        .describe('When extracting comments, also include people who replied to comments. Defaults to true upstream.'),
+    // `include_replies` was removed: this tool returns a DEDUPLICATED contact list,
+    // where a person is one entry regardless of whether they commented or replied,
+    // so the flag never changed the result. Use GET /v1/jungler/workbooks/{id}/comments
+    // to work with individual comments and their reply metadata.
 };
+// One page covers most posts; the loop below still walks the rest when it doesn't.
+const CONTACTS_PAGE_SIZE = 500;
+// Backstop so a mis-paginating upstream can't spin this tool forever.
+const MAX_CONTACT_PAGES = 20;
+/**
+ * True unless the contact demonstrably engaged with nothing.
+ *
+ * The workbook always collects the post itself, so the post's AUTHOR comes back
+ * as a contact with `stats: {comments: 0, reactions: 0}` even when nobody
+ * engaged. This tool promises the people who engaged, so a zero/zero contact is
+ * not one of them. Anything without usable stats is kept — never drop a contact
+ * on ambiguity.
+ */
+function engaged(contact) {
+    if (!contact || typeof contact !== 'object')
+        return true;
+    const stats = contact.stats;
+    if (!stats || typeof stats !== 'object')
+        return true;
+    const { comments, reactions } = stats;
+    if (typeof comments !== 'number' || typeof reactions !== 'number')
+        return true;
+    return comments > 0 || reactions > 0;
+}
+/** Read one page of the contacts envelope, tolerating a bare-array response. */
+function readContactsPage(data) {
+    if (Array.isArray(data))
+        return { items: data, pages: 1 };
+    if (data && typeof data === 'object') {
+        const obj = data;
+        if (Array.isArray(obj.items)) {
+            return {
+                items: obj.items,
+                total: typeof obj.total === 'number' ? obj.total : undefined,
+                pages: typeof obj.pages === 'number' ? obj.pages : undefined,
+            };
+        }
+    }
+    return { items: [], pages: 1 };
+}
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+// ── Fallback provider ───────────────────────────────────────────────────────
+//
+// Jungler is the primary: it charges a flat rate per post regardless of size and
+// returns enriched contacts (work email, company domain, title, seniority). Lima
+// Data costs the same per post but returns profile URLs only, so it needs a
+// separate enrichment pass — hence second, not first.
+//
+// We reach for it ONLY when Jungler failed for a reason that is ours, not the
+// post's: a failed run, or an upstream account out of credits. A genuinely empty
+// post must NOT fall through — Lima would return empty too, for another charge.
+// Same env knobs as the primary poll, so a caller (or a test) can tighten both.
+const fallbackPollMs = () => parseInt(process.env.COLDIQ_ENGAGEMENT_POLL_MS ?? '5000', 10);
+const fallbackTimeoutMs = () => parseInt(process.env.COLDIQ_ENGAGEMENT_FALLBACK_TIMEOUT_MS ?? '240000', 10);
+/** Flatten Lima's `{commenters:{comments:[{actor}]}, reactors:{reactions:[{actor}]}}` into contacts. */
+function limaEngagersToPeople(data, type) {
+    if (!data || typeof data !== 'object')
+        return [];
+    const d = data;
+    const rows = [];
+    if (type !== 'reactions') {
+        for (const c of d.commenters?.comments ?? [])
+            rows.push({ ...c, engagement: 'COMMENT' });
+    }
+    if (type !== 'comments') {
+        for (const r of d.reactors?.reactions ?? [])
+            rows.push({ ...r, engagement: 'REACTION' });
+    }
+    // Deduplicate by profile URL: someone who both commented and reacted is one person.
+    const byProfile = new Map();
+    for (const row of rows) {
+        const actor = (row.actor ?? {});
+        const key = String(actor.profile_url ?? actor.name ?? Math.random());
+        const existing = byProfile.get(key);
+        if (existing) {
+            const seen = existing.engagement_types;
+            if (!seen.includes(row.engagement))
+                seen.push(row.engagement);
+            continue;
+        }
+        byProfile.set(key, {
+            name: actor.name ?? null,
+            profile_url: actor.profile_url ?? null,
+            description: actor.headline ?? null,
+            profile_image_url: actor.image_url ?? null,
+            engagement_types: [row.engagement],
+        });
+    }
+    return [...byProfile.values()];
+}
+async function extractViaLimaData(postUrl, type) {
+    const submit = await callApi('POST', '/limadata/batch/post-engagements', { urls: [postUrl] });
+    if (!submit.ok) {
+        return { ok: false, error: extractErrorMessage(submit.data) ?? `Fallback provider failed to start (status ${submit.status})` };
+    }
+    const batchId = submit.data.batch_id;
+    if (batchId === undefined)
+        return { ok: false, error: 'Fallback provider did not return a batch id' };
+    const creditsCharged = Number(submit.headers['x-coldiq-credits-charged']);
+    const timeoutMs = fallbackTimeoutMs();
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        await sleep(fallbackPollMs());
+        const poll = await callApi('POST', '/limadata/batch/results', { batch_id: String(batchId) });
+        if (!poll.ok)
+            continue;
+        const body = poll.data;
+        const item = body.items?.[0];
+        if (!item || String(item.status).toLowerCase() !== 'completed')
+            continue;
+        return {
+            ok: true,
+            people: limaEngagersToPeople(item.data, type),
+            creditsCharged: Number.isFinite(creditsCharged) ? creditsCharged : undefined,
+            batchId,
+        };
+    }
+    return { ok: false, error: `Fallback provider did not finish within ${Math.round(timeoutMs / 1000)}s`, batchId };
+}
 function errorResult(error, extra) {
     return {
         content: [{ type: 'text', text: JSON.stringify({ error, ...extra }) }],
@@ -34,10 +153,43 @@ function extractErrorMessage(data) {
     }
     return undefined;
 }
+/**
+ * Try the fallback provider after the primary failed; if it also fails, report
+ * the ORIGINAL failure (that is the one the caller can act on) with the
+ * fallback's outcome attached.
+ *
+ * Set COLDIQ_ENGAGEMENT_FALLBACK=0 to disable — the fallback is a second billable
+ * provider, so anyone running to a strict budget must be able to opt out.
+ */
+async function fallbackOr(postUrl, type, primaryError, extra) {
+    if (process.env.COLDIQ_ENGAGEMENT_FALLBACK === '0') {
+        return errorResult(primaryError, { post_url: postUrl, ...extra });
+    }
+    const fb = await extractViaLimaData(postUrl, type);
+    if (!fb.ok) {
+        return errorResult(primaryError, { post_url: postUrl, ...extra, fallback_error: fb.error });
+    }
+    const meta = { provider: 'limadata', primary_error: primaryError };
+    if (fb.creditsCharged !== undefined)
+        meta.credits_charged = fb.creditsCharged;
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    data: { post_url: postUrl, type, people: fb.people, count: fb.people.length },
+                    // Say plainly that these records are thinner than the primary's, so the
+                    // caller knows to run enrichment before treating them as contacts.
+                    _meta: {
+                        ...meta,
+                        note: 'Served by the fallback provider after the primary failed. These records carry name, profile URL and headline only — no work email or company data. Run enrich_person / find_email on them if you need contact details.',
+                    },
+                }),
+            }],
+    };
+}
 export async function extractPostEngagementHandler(input) {
     const postUrl = input.post_url;
     const type = input.type ?? 'both';
-    const includeReplies = input.include_replies;
     const dataTypes = type === 'comments' ? ['comment'] : type === 'reactions' ? ['reaction'] : ['comment', 'reaction'];
     // Step 1 — create the extraction task. Billing happens here.
     const createRes = await callApi('POST', '/jungler/workbooks', {
@@ -45,20 +197,26 @@ export async function extractPostEngagementHandler(input) {
         data_types: dataTypes,
     });
     if (!createRes.ok) {
-        return errorResult(extractErrorMessage(createRes.data) ?? `Failed to start extraction (status ${createRes.status})`);
+        return fallbackOr(postUrl, type, extractErrorMessage(createRes.data) ?? `Failed to start extraction (status ${createRes.status})`);
     }
     const createData = createRes.data;
     const taskId = createData.task_id;
     if (!taskId) {
-        return errorResult('Extraction job did not return a task id');
+        return fallbackOr(postUrl, type, 'Extraction job did not return a task id');
     }
+    // Kept so a timeout can still hand the caller a way to collect what they paid
+    // for — the workbook stays readable upstream for 12 hours.
+    const createWorkbookId = createData.workbook_id;
     // Credit headers are emitted on the create call (the only billed step).
     const creditsCharged = Number(createRes.headers['x-coldiq-credits-charged']);
     const creditsRemaining = Number(createRes.headers['x-coldiq-credits-remaining']);
     // Step 2 — poll task status until it resolves. The status endpoint is free, so
     // polling does not bill; only the create call above charged credits.
-    const pollIntervalMs = parseInt(process.env.COLDIQ_ENGAGEMENT_POLL_MS ?? '2000', 10);
-    const timeoutMs = parseInt(process.env.COLDIQ_ENGAGEMENT_TIMEOUT_MS ?? '180000', 10);
+    // Upstream quotes 1-3 minutes and explicitly warns that large posts (1000+
+    // interactions) take longer — which is exactly the viral post this tool is for.
+    // A 180s deadline cut those off mid-extraction and reported a bogus timeout.
+    const pollIntervalMs = parseInt(process.env.COLDIQ_ENGAGEMENT_POLL_MS ?? '5000', 10);
+    const timeoutMs = parseInt(process.env.COLDIQ_ENGAGEMENT_TIMEOUT_MS ?? '600000', 10);
     const maxPollErrors = 3;
     const deadline = Date.now() + timeoutMs;
     let workbookId;
@@ -74,41 +232,67 @@ export async function extractPostEngagementHandler(input) {
             continue;
         }
         consecutivePollErrors = 0;
-        const status = statusRes.data.status;
+        const statusData = statusRes.data;
+        const status = statusData.status;
         if (status === 'success') {
-            workbookId = statusRes.data.workbook_id;
+            // A credits-exhausted run is terminal but collected little or nothing
+            // because OUR provider account ran dry — the caller's request is sound, so
+            // route it to the fallback rather than handing back a hollow result. This
+            // charge is refunded server-side.
+            if (statusData.credits_exhausted) {
+                return fallbackOr(postUrl, type, 'Engagement extraction stopped early — the data provider account is out of credits (this request was refunded)', { task_id: taskId });
+            }
+            workbookId = statusData.workbook_id;
             break;
         }
         if (status === 'failure') {
-            return errorResult('Engagement extraction failed upstream — the post may be private, deleted, or have no engagement', { post_url: postUrl });
+            // The status route refunds the create charge when a run reaches failure,
+            // so the user is made whole — say so rather than leaving them to wonder.
+            return fallbackOr(postUrl, type, 'Engagement extraction failed upstream — the post may be private, deleted, or have no engagement. The credits for this task have been refunded.', { task_id: taskId });
         }
     }
     if (!workbookId) {
-        return errorResult(`Engagement extraction did not complete within ${Math.round(timeoutMs / 1000)}s — try again shortly`, { post_url: postUrl });
+        // Giving up here does NOT cancel the run, and the create call was already
+        // billed. Never drop that on the floor: hand back the ids so the caller can
+        // collect the results (upstream keeps the workbook for 12 hours) instead of
+        // paying again for a re-run that is probably still in flight.
+        return errorResult(`Engagement extraction is still running after ${Math.round(timeoutMs / 1000)}s. It has NOT been cancelled and no re-run is needed — poll GET /v1/jungler/tasks/${taskId}/status until it reports success, then fetch the people from GET /v1/jungler/workbooks/${createWorkbookId ?? '{workbook_id}'}/contacts. Results stay available for 12 hours after the task was created.`, { post_url: postUrl, task_id: taskId, workbook_id: createWorkbookId, status: 'running' });
     }
     // Step 3 — fetch the deduplicated people. activity_filter narrows to commenters
     // or reactors; omitted for "both" so the upstream returns all unique contacts.
-    const queryParams = {};
+    // Contacts are paginated, and a viral post — the case this tool exists for —
+    // routinely exceeds one page, so walk every page rather than truncating to the
+    // first. Reads are free, so pagination costs the caller nothing.
+    const queryParams = { page_size: String(CONTACTS_PAGE_SIZE) };
     if (type === 'comments')
         queryParams.activity_filter = 'commenters';
     else if (type === 'reactions')
         queryParams.activity_filter = 'reactors';
-    if (includeReplies !== undefined)
-        queryParams.include_replies = String(includeReplies);
-    const contactsRes = await callApi('GET', `/jungler/workbooks/${workbookId}/contacts`, undefined, Object.keys(queryParams).length > 0 ? queryParams : undefined);
-    if (!contactsRes.ok) {
-        return errorResult(extractErrorMessage(contactsRes.data) ?? 'Failed to fetch extracted people', { post_url: postUrl });
+    const people = [];
+    let totalContacts;
+    for (let page = 1; page <= MAX_CONTACT_PAGES; page++) {
+        const contactsRes = await callApi('GET', `/jungler/workbooks/${workbookId}/contacts`, undefined, { ...queryParams, page: String(page) });
+        if (!contactsRes.ok) {
+            return errorResult(extractErrorMessage(contactsRes.data) ?? 'Failed to fetch extracted people', { post_url: postUrl, task_id: taskId, workbook_id: workbookId });
+        }
+        const { items, total, pages } = readContactsPage(contactsRes.data);
+        people.push(...items.filter(engaged));
+        totalContacts = total;
+        if (items.length === 0 || (pages !== undefined && page >= pages))
+            break;
     }
     const meta = {};
     if (Number.isFinite(creditsCharged))
         meta.credits_charged = creditsCharged;
     if (Number.isFinite(creditsRemaining))
         meta.credits_remaining = creditsRemaining;
+    if (totalContacts !== undefined && totalContacts > people.length)
+        meta.truncated_from = totalContacts;
     return {
         content: [{
                 type: 'text',
                 text: JSON.stringify({
-                    data: { post_url: postUrl, type, people: contactsRes.data },
+                    data: { post_url: postUrl, type, people, count: people.length },
                     _meta: meta,
                 }),
             }],

package/dist/tools/extract-post-engagement.js.map

@@ -1 +1 @@
-{"version":3,"file":"extract-post-engagement.js","sourceRoot":"","sources":["../../src/tools/extract-post-engagement.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extract-post-engagement.js","sourceRoot":"","sources":["../../src/tools/extract-post-engagement.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coldiq/mcp",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/src/tools/extract-post-engagement.ts

@@ -6,7 +6,8 @@ export const extractPostEngagementName = 'extract_post_engagement'
 export const extractPostEngagementDescription =
   'Extract the people who engaged with a LinkedIn post — commenters and/or reactors — as a deduplicated list of contacts (name, profile URL, headline). ' +
   'Use this for social-signal prospecting: pull everyone who engaged with a viral post, then chain the results into enrich_person / find_email to get roles and work emails. ' +
-  'Runs an async extraction job (typically ~30–120s) and returns once the people are ready. Pricing is returned in the response credit headers.'
+  'Runs an async extraction job (typically 1–3 minutes; longer for posts with 1000+ interactions) and returns every extracted person once ready. ' +
+  'If the primary source fails or its account is out of credits, automatically retries on a second provider and says so in `_meta.provider` — those records carry name/profile URL/headline only, so enrich them before use. Pricing is returned in the response credit headers.'
 
 export const extractPostEngagementSchema = {
   post_url: z
@@ -17,16 +18,133 @@ export const extractPostEngagementSchema = {
     .enum(['comments', 'reactions', 'both'])
     .default('both')
     .describe('Which engagement to extract: "comments" (people who commented), "reactions" (people who reacted), or "both" (default — deduplicated across both).'),
-  include_replies: z
-    .boolean()
-    .optional()
-    .describe('When extracting comments, also include people who replied to comments. Defaults to true upstream.'),
+  // `include_replies` was removed: this tool returns a DEDUPLICATED contact list,
+  // where a person is one entry regardless of whether they commented or replied,
+  // so the flag never changed the result. Use GET /v1/jungler/workbooks/{id}/comments
+  // to work with individual comments and their reply metadata.
+}
+
+// One page covers most posts; the loop below still walks the rest when it doesn't.
+const CONTACTS_PAGE_SIZE = 500
+// Backstop so a mis-paginating upstream can't spin this tool forever.
+const MAX_CONTACT_PAGES = 20
+
+/**
+ * True unless the contact demonstrably engaged with nothing.
+ *
+ * The workbook always collects the post itself, so the post's AUTHOR comes back
+ * as a contact with `stats: {comments: 0, reactions: 0}` even when nobody
+ * engaged. This tool promises the people who engaged, so a zero/zero contact is
+ * not one of them. Anything without usable stats is kept — never drop a contact
+ * on ambiguity.
+ */
+function engaged(contact: unknown): boolean {
+  if (!contact || typeof contact !== 'object') return true
+  const stats = (contact as { stats?: unknown }).stats
+  if (!stats || typeof stats !== 'object') return true
+  const { comments, reactions } = stats as { comments?: unknown; reactions?: unknown }
+  if (typeof comments !== 'number' || typeof reactions !== 'number') return true
+  return comments > 0 || reactions > 0
+}
+
+/** Read one page of the contacts envelope, tolerating a bare-array response. */
+function readContactsPage(data: unknown): { items: unknown[]; total?: number; pages?: number } {
+  if (Array.isArray(data)) return { items: data, pages: 1 }
+  if (data && typeof data === 'object') {
+    const obj = data as { items?: unknown; total?: unknown; pages?: unknown }
+    if (Array.isArray(obj.items)) {
+      return {
+        items: obj.items,
+        total: typeof obj.total === 'number' ? obj.total : undefined,
+        pages: typeof obj.pages === 'number' ? obj.pages : undefined,
+      }
+    }
+  }
+  return { items: [], pages: 1 }
 }
 
 function sleep(ms: number): Promise<void> {
   return new Promise((resolve) => setTimeout(resolve, ms))
 }
 
+// ── Fallback provider ───────────────────────────────────────────────────────
+//
+// Jungler is the primary: it charges a flat rate per post regardless of size and
+// returns enriched contacts (work email, company domain, title, seniority). Lima
+// Data costs the same per post but returns profile URLs only, so it needs a
+// separate enrichment pass — hence second, not first.
+//
+// We reach for it ONLY when Jungler failed for a reason that is ours, not the
+// post's: a failed run, or an upstream account out of credits. A genuinely empty
+// post must NOT fall through — Lima would return empty too, for another charge.
+// Same env knobs as the primary poll, so a caller (or a test) can tighten both.
+const fallbackPollMs = () => parseInt(process.env.COLDIQ_ENGAGEMENT_POLL_MS ?? '5000', 10)
+const fallbackTimeoutMs = () => parseInt(process.env.COLDIQ_ENGAGEMENT_FALLBACK_TIMEOUT_MS ?? '240000', 10)
+
+/** Flatten Lima's `{commenters:{comments:[{actor}]}, reactors:{reactions:[{actor}]}}` into contacts. */
+function limaEngagersToPeople(data: unknown, type: 'comments' | 'reactions' | 'both'): unknown[] {
+  if (!data || typeof data !== 'object') return []
+  const d = data as {
+    commenters?: { comments?: unknown[] }
+    reactors?: { reactions?: unknown[] }
+  }
+  const rows: Array<{ actor?: unknown; engagement: string }> = []
+  if (type !== 'reactions') {
+    for (const c of d.commenters?.comments ?? []) rows.push({ ...(c as object), engagement: 'COMMENT' } as never)
+  }
+  if (type !== 'comments') {
+    for (const r of d.reactors?.reactions ?? []) rows.push({ ...(r as object), engagement: 'REACTION' } as never)
+  }
+  // Deduplicate by profile URL: someone who both commented and reacted is one person.
+  const byProfile = new Map<string, Record<string, unknown>>()
+  for (const row of rows) {
+    const actor = (row.actor ?? {}) as Record<string, unknown>
+    const key = String(actor.profile_url ?? actor.name ?? Math.random())
+    const existing = byProfile.get(key)
+    if (existing) {
+      const seen = existing.engagement_types as string[]
+      if (!seen.includes(row.engagement)) seen.push(row.engagement)
+      continue
+    }
+    byProfile.set(key, {
+      name: actor.name ?? null,
+      profile_url: actor.profile_url ?? null,
+      description: actor.headline ?? null,
+      profile_image_url: actor.image_url ?? null,
+      engagement_types: [row.engagement],
+    })
+  }
+  return [...byProfile.values()]
+}
+
+async function extractViaLimaData(postUrl: string, type: 'comments' | 'reactions' | 'both') {
+  const submit = await callApi('POST', '/limadata/batch/post-engagements', { urls: [postUrl] })
+  if (!submit.ok) {
+    return { ok: false as const, error: extractErrorMessage(submit.data) ?? `Fallback provider failed to start (status ${submit.status})` }
+  }
+  const batchId = (submit.data as { batch_id?: number | string }).batch_id
+  if (batchId === undefined) return { ok: false as const, error: 'Fallback provider did not return a batch id' }
+
+  const creditsCharged = Number(submit.headers['x-coldiq-credits-charged'])
+  const timeoutMs = fallbackTimeoutMs()
+  const deadline = Date.now() + timeoutMs
+  while (Date.now() < deadline) {
+    await sleep(fallbackPollMs())
+    const poll = await callApi('POST', '/limadata/batch/results', { batch_id: String(batchId) })
+    if (!poll.ok) continue
+    const body = poll.data as { items?: Array<{ status?: string; data?: unknown }> }
+    const item = body.items?.[0]
+    if (!item || String(item.status).toLowerCase() !== 'completed') continue
+    return {
+      ok: true as const,
+      people: limaEngagersToPeople(item.data, type),
+      creditsCharged: Number.isFinite(creditsCharged) ? creditsCharged : undefined,
+      batchId,
+    }
+  }
+  return { ok: false as const, error: `Fallback provider did not finish within ${Math.round(timeoutMs / 1000)}s`, batchId }
+}
+
 function errorResult(error: string, extra?: Record<string, unknown>) {
   return {
     content: [{ type: 'text' as const, text: JSON.stringify({ error, ...extra }) }],
@@ -42,11 +160,50 @@ function extractErrorMessage(data: unknown): string | undefined {
   return undefined
 }
 
+/**
+ * Try the fallback provider after the primary failed; if it also fails, report
+ * the ORIGINAL failure (that is the one the caller can act on) with the
+ * fallback's outcome attached.
+ *
+ * Set COLDIQ_ENGAGEMENT_FALLBACK=0 to disable — the fallback is a second billable
+ * provider, so anyone running to a strict budget must be able to opt out.
+ */
+async function fallbackOr(
+  postUrl: string,
+  type: 'comments' | 'reactions' | 'both',
+  primaryError: string,
+  extra?: Record<string, unknown>,
+) {
+  if (process.env.COLDIQ_ENGAGEMENT_FALLBACK === '0') {
+    return errorResult(primaryError, { post_url: postUrl, ...extra })
+  }
+
+  const fb = await extractViaLimaData(postUrl, type)
+  if (!fb.ok) {
+    return errorResult(primaryError, { post_url: postUrl, ...extra, fallback_error: fb.error })
+  }
+
+  const meta: Record<string, unknown> = { provider: 'limadata', primary_error: primaryError }
+  if (fb.creditsCharged !== undefined) meta.credits_charged = fb.creditsCharged
+  return {
+    content: [{
+      type: 'text' as const,
+      text: JSON.stringify({
+        data: { post_url: postUrl, type, people: fb.people, count: fb.people.length },
+        // Say plainly that these records are thinner than the primary's, so the
+        // caller knows to run enrichment before treating them as contacts.
+        _meta: {
+          ...meta,
+          note: 'Served by the fallback provider after the primary failed. These records carry name, profile URL and headline only — no work email or company data. Run enrich_person / find_email on them if you need contact details.',
+        },
+      }),
+    }],
+  }
+}
+
 export async function extractPostEngagementHandler(input: Record<string, unknown>) {
   const postUrl = input.post_url as string
   const type = (input.type as 'comments' | 'reactions' | 'both' | undefined) ?? 'both'
-  const includeReplies = input.include_replies as boolean | undefined
-
   const dataTypes =
     type === 'comments' ? ['comment'] : type === 'reactions' ? ['reaction'] : ['comment', 'reaction']
 
@@ -56,21 +213,30 @@ export async function extractPostEngagementHandler(input: Record<string, unknown
     data_types: dataTypes,
   })
   if (!createRes.ok) {
-    return errorResult(extractErrorMessage(createRes.data) ?? `Failed to start extraction (status ${createRes.status})`)
+    return fallbackOr(
+      postUrl, type,
+      extractErrorMessage(createRes.data) ?? `Failed to start extraction (status ${createRes.status})`,
+    )
   }
-  const createData = createRes.data as { task_id?: string }
+  const createData = createRes.data as { task_id?: string; workbook_id?: string }
   const taskId = createData.task_id
   if (!taskId) {
-    return errorResult('Extraction job did not return a task id')
+    return fallbackOr(postUrl, type, 'Extraction job did not return a task id')
   }
+  // Kept so a timeout can still hand the caller a way to collect what they paid
+  // for — the workbook stays readable upstream for 12 hours.
+  const createWorkbookId = createData.workbook_id
   // Credit headers are emitted on the create call (the only billed step).
   const creditsCharged = Number(createRes.headers['x-coldiq-credits-charged'])
   const creditsRemaining = Number(createRes.headers['x-coldiq-credits-remaining'])
 
   // Step 2 — poll task status until it resolves. The status endpoint is free, so
   // polling does not bill; only the create call above charged credits.
-  const pollIntervalMs = parseInt(process.env.COLDIQ_ENGAGEMENT_POLL_MS ?? '2000', 10)
-  const timeoutMs = parseInt(process.env.COLDIQ_ENGAGEMENT_TIMEOUT_MS ?? '180000', 10)
+  // Upstream quotes 1-3 minutes and explicitly warns that large posts (1000+
+  // interactions) take longer — which is exactly the viral post this tool is for.
+  // A 180s deadline cut those off mid-extraction and reported a bogus timeout.
+  const pollIntervalMs = parseInt(process.env.COLDIQ_ENGAGEMENT_POLL_MS ?? '5000', 10)
+  const timeoutMs = parseInt(process.env.COLDIQ_ENGAGEMENT_TIMEOUT_MS ?? '600000', 10)
   const maxPollErrors = 3
   const deadline = Date.now() + timeoutMs
 
@@ -88,46 +254,82 @@ export async function extractPostEngagementHandler(input: Record<string, unknown
       continue
     }
     consecutivePollErrors = 0
-    const status = (statusRes.data as { status?: string; workbook_id?: string }).status
+    const statusData = statusRes.data as { status?: string; workbook_id?: string; credits_exhausted?: boolean }
+    const status = statusData.status
     if (status === 'success') {
-      workbookId = (statusRes.data as { workbook_id?: string }).workbook_id
+      // A credits-exhausted run is terminal but collected little or nothing
+      // because OUR provider account ran dry — the caller's request is sound, so
+      // route it to the fallback rather than handing back a hollow result. This
+      // charge is refunded server-side.
+      if (statusData.credits_exhausted) {
+        return fallbackOr(
+          postUrl, type,
+          'Engagement extraction stopped early — the data provider account is out of credits (this request was refunded)',
+          { task_id: taskId },
+        )
+      }
+      workbookId = statusData.workbook_id
       break
     }
     if (status === 'failure') {
-      return errorResult('Engagement extraction failed upstream — the post may be private, deleted, or have no engagement', { post_url: postUrl })
+      // The status route refunds the create charge when a run reaches failure,
+      // so the user is made whole — say so rather than leaving them to wonder.
+      return fallbackOr(
+        postUrl, type,
+        'Engagement extraction failed upstream — the post may be private, deleted, or have no engagement. The credits for this task have been refunded.',
+        { task_id: taskId },
+      )
     }
   }
 
   if (!workbookId) {
-    return errorResult(`Engagement extraction did not complete within ${Math.round(timeoutMs / 1000)}s — try again shortly`, { post_url: postUrl })
+    // Giving up here does NOT cancel the run, and the create call was already
+    // billed. Never drop that on the floor: hand back the ids so the caller can
+    // collect the results (upstream keeps the workbook for 12 hours) instead of
+    // paying again for a re-run that is probably still in flight.
+    return errorResult(
+      `Engagement extraction is still running after ${Math.round(timeoutMs / 1000)}s. It has NOT been cancelled and no re-run is needed — poll GET /v1/jungler/tasks/${taskId}/status until it reports success, then fetch the people from GET /v1/jungler/workbooks/${createWorkbookId ?? '{workbook_id}'}/contacts. Results stay available for 12 hours after the task was created.`,
+      { post_url: postUrl, task_id: taskId, workbook_id: createWorkbookId, status: 'running' },
+    )
   }
 
   // Step 3 — fetch the deduplicated people. activity_filter narrows to commenters
   // or reactors; omitted for "both" so the upstream returns all unique contacts.
-  const queryParams: Record<string, string> = {}
+  // Contacts are paginated, and a viral post — the case this tool exists for —
+  // routinely exceeds one page, so walk every page rather than truncating to the
+  // first. Reads are free, so pagination costs the caller nothing.
+  const queryParams: Record<string, string> = { page_size: String(CONTACTS_PAGE_SIZE) }
   if (type === 'comments') queryParams.activity_filter = 'commenters'
   else if (type === 'reactions') queryParams.activity_filter = 'reactors'
-  if (includeReplies !== undefined) queryParams.include_replies = String(includeReplies)
 
-  const contactsRes = await callApi(
-    'GET',
-    `/jungler/workbooks/${workbookId}/contacts`,
-    undefined,
-    Object.keys(queryParams).length > 0 ? queryParams : undefined,
-  )
-  if (!contactsRes.ok) {
-    return errorResult(extractErrorMessage(contactsRes.data) ?? 'Failed to fetch extracted people', { post_url: postUrl })
+  const people: unknown[] = []
+  let totalContacts: number | undefined
+  for (let page = 1; page <= MAX_CONTACT_PAGES; page++) {
+    const contactsRes = await callApi(
+      'GET',
+      `/jungler/workbooks/${workbookId}/contacts`,
+      undefined,
+      { ...queryParams, page: String(page) },
+    )
+    if (!contactsRes.ok) {
+      return errorResult(extractErrorMessage(contactsRes.data) ?? 'Failed to fetch extracted people', { post_url: postUrl, task_id: taskId, workbook_id: workbookId })
+    }
+    const { items, total, pages } = readContactsPage(contactsRes.data)
+    people.push(...items.filter(engaged))
+    totalContacts = total
+    if (items.length === 0 || (pages !== undefined && page >= pages)) break
   }
 
   const meta: Record<string, unknown> = {}
   if (Number.isFinite(creditsCharged)) meta.credits_charged = creditsCharged
   if (Number.isFinite(creditsRemaining)) meta.credits_remaining = creditsRemaining
+  if (totalContacts !== undefined && totalContacts > people.length) meta.truncated_from = totalContacts
 
   return {
     content: [{
       type: 'text' as const,
       text: JSON.stringify({
-        data: { post_url: postUrl, type, people: contactsRes.data },
+        data: { post_url: postUrl, type, people, count: people.length },
         _meta: meta,
       }),
     }],

package/tests/tools/extract-post-engagement.test.ts

@@ -26,9 +26,9 @@ describe('extract_post_engagement handler', () => {
     const people = [{ name: 'Alex Vacca', profile_url: 'https://www.linkedin.com/in/alexvacca' }]
     globalThis.fetch = vi.fn(async (url: string | URL) => {
       const u = url.toString()
-      if (u.includes('/jungler/workbooks/wb_1/contacts')) return res(people)
+      if (u.includes('/jungler/workbooks/wb_1/contacts')) return res({ items: people, total: 1, page: 1, pages: 1 })
       if (u.includes('/jungler/tasks/task_1/status')) return res({ task_id: 'task_1', status: 'success', workbook_id: 'wb_1' })
-      if (u.includes('/jungler/workbooks')) return res({ task_id: 'task_1', status: 'PENDING' }, 200, { 'x-coldiq-credits-charged': '10', 'x-coldiq-credits-remaining': '90' })
+      if (u.includes('/jungler/workbooks')) return res({ task_id: 'task_1', status: 'PENDING', workbook_id: 'wb_1' }, 200, { 'x-coldiq-credits-charged': '10', 'x-coldiq-credits-remaining': '90' })
       throw new Error(`unexpected url ${u}`)
     }) as typeof fetch
 
@@ -36,15 +36,80 @@ describe('extract_post_engagement handler', () => {
     const parsed = JSON.parse(result.content[0].text)
     expect(result.isError).toBeUndefined()
     expect(parsed.data.people).toEqual(people)
+    expect(parsed.data.count).toBe(1)
     expect(parsed.data.type).toBe('both')
     expect(parsed._meta.credits_charged).toBe(10)
   })
 
+  it('walks every contacts page — a viral post exceeds one page', async () => {
+    const pageOf = (n: number) => Array.from({ length: n }, (_, i) => ({ name: `Person ${i}` }))
+    const seenPages: string[] = []
+    globalThis.fetch = vi.fn(async (url: string | URL) => {
+      const u = url.toString()
+      if (u.includes('/contacts')) {
+        const page = new URL(u).searchParams.get('page') ?? '1'
+        seenPages.push(page)
+        return res({ items: pageOf(page === '1' ? 500 : 103), total: 603, page: Number(page), pages: 2 })
+      }
+      if (u.includes('/jungler/tasks/task_1/status')) return res({ task_id: 'task_1', status: 'success', workbook_id: 'wb_1' })
+      if (u.includes('/jungler/workbooks')) return res({ task_id: 'task_1', status: 'PENDING', workbook_id: 'wb_1' })
+      throw new Error(`unexpected url ${u}`)
+    }) as typeof fetch
+
+    const result = await extractPostEngagementHandler({ post_url: POST_URL, type: 'both' })
+    const parsed = JSON.parse(result.content[0].text)
+    expect(seenPages).toEqual(['1', '2'])
+    expect(parsed.data.count).toBe(603)
+    expect(parsed._meta.truncated_from).toBeUndefined()
+  })
+
+  it('drops the post author, who is collected with zero engagement and never engaged', async () => {
+    // The workbook always collects the post itself, so its author comes back as a
+    // contact with stats 0/0. This tool promises the people who ENGAGED.
+    globalThis.fetch = vi.fn(async (url: string | URL) => {
+      const u = url.toString()
+      if (u.includes('/contacts')) return res({
+        items: [
+          { name: 'Michel Lieben', stats: { comments: 0, reactions: 0 } },
+          { name: 'Jane Smith', stats: { comments: 2, reactions: 1 } },
+          { name: 'No Stats Person' },
+        ],
+        total: 3, page: 1, pages: 1,
+      })
+      if (u.includes('/jungler/tasks/task_1/status')) return res({ task_id: 'task_1', status: 'success', workbook_id: 'wb_1' })
+      if (u.includes('/jungler/workbooks')) return res({ task_id: 'task_1', status: 'PENDING', workbook_id: 'wb_1' })
+      throw new Error(`unexpected url ${u}`)
+    }) as typeof fetch
+
+    const parsed = JSON.parse((await extractPostEngagementHandler({ post_url: POST_URL, type: 'both' })).content[0].text)
+    // Unknown stats are kept — never drop a contact on ambiguity.
+    expect(parsed.data.people.map((p: { name: string }) => p.name)).toEqual(['Jane Smith', 'No Stats Person'])
+  })
+
+  it('reports the task and workbook ids instead of losing the paid run when polling times out', async () => {
+    vi.stubEnv('COLDIQ_ENGAGEMENT_TIMEOUT_MS', '30')
+    globalThis.fetch = vi.fn(async (url: string | URL) => {
+      const u = url.toString()
+      // Never terminal — the caller must still be able to collect what they paid for.
+      if (u.includes('/jungler/tasks/task_1/status')) return res({ task_id: 'task_1', status: 'started' })
+      if (u.includes('/jungler/workbooks')) return res({ task_id: 'task_1', status: 'PENDING', workbook_id: 'wb_1' })
+      throw new Error(`unexpected url ${u}`)
+    }) as typeof fetch
+
+    const result = await extractPostEngagementHandler({ post_url: POST_URL, type: 'both' })
+    const parsed = JSON.parse(result.content[0].text)
+    expect(result.isError).toBe(true)
+    expect(parsed.task_id).toBe('task_1')
+    expect(parsed.workbook_id).toBe('wb_1')
+    expect(parsed.error).toMatch(/still running/i)
+    expect(parsed.error).toMatch(/NOT been cancelled/i)
+  })
+
   it('passes activity_filter=commenters when type=comments', async () => {
     let contactsUrl = ''
     globalThis.fetch = vi.fn(async (url: string | URL) => {
       const u = url.toString()
-      if (u.includes('/jungler/workbooks/wb_1/contacts')) { contactsUrl = u; return res([]) }
+      if (u.includes('/jungler/workbooks/wb_1/contacts')) { contactsUrl = u; return res({ items: [], total: 0, pages: 0 }) }
       if (u.includes('/jungler/tasks/task_1/status')) return res({ task_id: 'task_1', status: 'success', workbook_id: 'wb_1' })
       if (u.includes('/jungler/workbooks')) return res({ task_id: 'task_1', status: 'PENDING' })
       throw new Error(`unexpected url ${u}`)
@@ -67,6 +132,105 @@ describe('extract_post_engagement handler', () => {
     expect(JSON.parse(result.content[0].text).error).toMatch(/extraction failed/i)
   })
 
+  // ── Fallback to the second provider ──────────────────────────────────────
+  //
+  // Only for failures that are OURS (dead run, our provider account out of
+  // credits) — never for a post that genuinely has no engagement, which would
+  // buy an empty second result.
+  const LIMA_PAYLOAD = {
+    items: [{
+      status: 'Completed',
+      data: {
+        post_url: POST_URL,
+        commenters: { comments: [{ actor: { name: 'Jane Smith', profile_url: 'https://linkedin.com/in/jane', headline: 'VP Eng' } }] },
+        reactors: {
+          reactions: [
+            { actor: { name: 'Bob Johnson', profile_url: 'https://linkedin.com/in/bob', headline: 'Sales' } },
+            // Same person also reacted — must collapse to one contact.
+            { actor: { name: 'Jane Smith', profile_url: 'https://linkedin.com/in/jane', headline: 'VP Eng' } },
+          ],
+        },
+      },
+    }],
+  }
+
+  function stubExhaustedThenLima(limaOk = true) {
+    globalThis.fetch = vi.fn(async (url: string | URL) => {
+      const u = url.toString()
+      if (u.includes('/limadata/batch/post-engagements')) {
+        return limaOk ? res({ batch_id: 99 }, 200, { 'x-coldiq-credits-charged': '35' }) : res({ error: 'lima down' }, 502)
+      }
+      if (u.includes('/limadata/batch/results')) return res(LIMA_PAYLOAD)
+      if (u.includes('/jungler/tasks/task_1/status')) return res({ task_id: 'task_1', status: 'success', credits_exhausted: true })
+      if (u.includes('/jungler/workbooks')) return res({ task_id: 'task_1', status: 'PENDING', workbook_id: 'wb_1' })
+      throw new Error(`unexpected url ${u}`)
+    }) as typeof fetch
+  }
+
+  it('falls back to the second provider when our provider account is out of credits', async () => {
+    stubExhaustedThenLima()
+    const result = await extractPostEngagementHandler({ post_url: POST_URL, type: 'both' })
+    const parsed = JSON.parse(result.content[0].text)
+
+    expect(result.isError).toBeUndefined()
+    expect(parsed._meta.provider).toBe('limadata')
+    expect(parsed._meta.credits_charged).toBe(35)
+    // Jane commented AND reacted — one contact, both engagement types.
+    expect(parsed.data.count).toBe(2)
+    const jane = parsed.data.people.find((p: { name: string }) => p.name === 'Jane Smith')
+    expect(jane.engagement_types.sort()).toEqual(['COMMENT', 'REACTION'])
+    expect(jane.profile_url).toBe('https://linkedin.com/in/jane')
+    // The caller must know these records are thinner than the primary's.
+    expect(parsed._meta.note).toMatch(/no work email/i)
+  })
+
+  it('honours type=comments when falling back', async () => {
+    stubExhaustedThenLima()
+    const parsed = JSON.parse((await extractPostEngagementHandler({ post_url: POST_URL, type: 'comments' })).content[0].text)
+    expect(parsed.data.people.map((p: { name: string }) => p.name)).toEqual(['Jane Smith'])
+  })
+
+  it('reports the ORIGINAL failure when the fallback also fails', async () => {
+    stubExhaustedThenLima(false)
+    const result = await extractPostEngagementHandler({ post_url: POST_URL, type: 'both' })
+    const parsed = JSON.parse(result.content[0].text)
+    expect(result.isError).toBe(true)
+    expect(parsed.error).toMatch(/out of credits/i)
+    expect(parsed.fallback_error).toBeTruthy()
+  })
+
+  it('does not spend on a fallback when it is switched off', async () => {
+    vi.stubEnv('COLDIQ_ENGAGEMENT_FALLBACK', '0')
+    let limaCalled = false
+    globalThis.fetch = vi.fn(async (url: string | URL) => {
+      const u = url.toString()
+      if (u.includes('/limadata')) { limaCalled = true; return res({}) }
+      if (u.includes('/jungler/tasks/task_1/status')) return res({ task_id: 'task_1', status: 'success', credits_exhausted: true })
+      if (u.includes('/jungler/workbooks')) return res({ task_id: 'task_1', status: 'PENDING', workbook_id: 'wb_1' })
+      throw new Error(`unexpected url ${u}`)
+    }) as typeof fetch
+
+    const result = await extractPostEngagementHandler({ post_url: POST_URL, type: 'both' })
+    expect(result.isError).toBe(true)
+    expect(limaCalled).toBe(false)
+  })
+
+  it('does NOT fall back for a genuinely empty post — that would buy a second empty result', async () => {
+    let limaCalled = false
+    globalThis.fetch = vi.fn(async (url: string | URL) => {
+      const u = url.toString()
+      if (u.includes('/limadata')) { limaCalled = true; return res({}) }
+      if (u.includes('/contacts')) return res({ items: [], total: 0, pages: 0 })
+      if (u.includes('/jungler/tasks/task_1/status')) return res({ task_id: 'task_1', status: 'success', workbook_id: 'wb_1' })
+      if (u.includes('/jungler/workbooks')) return res({ task_id: 'task_1', status: 'PENDING', workbook_id: 'wb_1' })
+      throw new Error(`unexpected url ${u}`)
+    }) as typeof fetch
+
+    const parsed = JSON.parse((await extractPostEngagementHandler({ post_url: POST_URL, type: 'both' })).content[0].text)
+    expect(limaCalled).toBe(false)
+    expect(parsed.data.count).toBe(0)
+  })
+
   it('surfaces the create error when the job cannot start', async () => {
     globalThis.fetch = vi.fn(async () => res({ error: 'Invalid LinkedIn post URL' }, 400)) as typeof fetch
     const result = await extractPostEngagementHandler({ post_url: POST_URL, type: 'both' })