@coldiq/mcp 0.5.2 → 0.5.4

package/dist/tools/call-endpoint.d.ts

@@ -4,6 +4,7 @@ export declare const callEndpointDescription: string;
 export declare const callEndpointSchema: {
     api: z.ZodString;
     path: z.ZodString;
+    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 };
 export declare function callEndpointHandler(input: Record<string, unknown>): Promise<{

package/dist/tools/call-endpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"call-endpoint.d.ts","sourceRoot":"","sources":["../../src/tools/call-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,gBAAgB,kBAAkB,CAAA;AAE/C,eAAO,MAAM,uBAAuB,QAKgB,CAAA;AAEpD,eAAO,MAAM,kBAAkB;;;;CAO9B,CAAA;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GASvE"}
+{"version":3,"file":"call-endpoint.d.ts","sourceRoot":"","sources":["../../src/tools/call-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,gBAAgB,kBAAkB,CAAA;AAE/C,eAAO,MAAM,uBAAuB,QAKgB,CAAA;AAEpD,eAAO,MAAM,kBAAkB;;;;;CAS9B,CAAA;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GASvE"}

package/dist/tools/call-endpoint.js

@@ -9,13 +9,15 @@ export const callEndpointDescription = 'Call any ColdIQ marketplace endpoint dir
 export const callEndpointSchema = {
     api: z.string().describe('Provider key from search_endpoints / get_endpoint_details, e.g. "coldiq".'),
     path: z.string().describe('Endpoint path without the /v1 prefix, e.g. "/limadata/prospect/people/filter".'),
+    method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']).optional()
+        .describe('HTTP method from search_endpoints. Set this when one path supports more than one method.'),
     params: z
         .record(z.unknown())
         .optional()
         .describe('Provider-native request params (request body fields, plus any path/query params), as shown in get_endpoint_details.'),
 };
 export async function callEndpointHandler(input) {
-    const res = await callApi('POST', '/endpoints/use', { api: input.api, path: input.path, params: input.params });
+    const res = await callApi('POST', '/endpoints/use', { api: input.api, path: input.path, method: input.method, params: input.params });
     if (!res.ok) {
         return {
             content: [{ type: 'text', text: JSON.stringify({ error: 'Endpoint call failed', status: res.status, data: res.data }) }],

package/dist/tools/call-endpoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"call-endpoint.js","sourceRoot":"","sources":["../../src/tools/call-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAA;AAE/C,MAAM,CAAC,MAAM,uBAAuB,GAClC,yGAAyG;IACzG,mGAAmG;IACnG,6FAA6F;IAC7F,0GAA0G;IAC1G,kDAAkD,CAAA;AAEpD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2EAA2E,CAAC;IACrG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IAC3G,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CAAC,qHAAqH,CAAC;CACnI,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAA8B;IACtE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IAC/G,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACjI,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;AACjF,CAAC"}
+{"version":3,"file":"call-endpoint.js","sourceRoot":"","sources":["../../src/tools/call-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAA;AAE/C,MAAM,CAAC,MAAM,uBAAuB,GAClC,yGAAyG;IACzG,mGAAmG;IACnG,6FAA6F;IAC7F,0GAA0G;IAC1G,kDAAkD,CAAA;AAEpD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2EAA2E,CAAC;IACrG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IAC3G,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;SACjE,QAAQ,CAAC,0FAA0F,CAAC;IACvG,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CAAC,qHAAqH,CAAC;CACnI,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAA8B;IACtE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IACrI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACjI,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;AACjF,CAAC"}

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/dist/tools/get-endpoint-details.d.ts

@@ -4,6 +4,7 @@ export declare const getEndpointDetailsDescription: string;
 export declare const getEndpointDetailsSchema: {
     api: z.ZodString;
     path: z.ZodString;
+    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
 };
 export declare function getEndpointDetailsHandler(input: Record<string, unknown>): Promise<{
     content: {

package/dist/tools/get-endpoint-details.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-endpoint-details.d.ts","sourceRoot":"","sources":["../../src/tools/get-endpoint-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,sBAAsB,yBAAyB,CAAA;AAE5D,eAAO,MAAM,6BAA6B,QAGV,CAAA;AAEhC,eAAO,MAAM,wBAAwB;;;CAGpC,CAAA;AAED,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAS7E"}
+{"version":3,"file":"get-endpoint-details.d.ts","sourceRoot":"","sources":["../../src/tools/get-endpoint-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,sBAAsB,yBAAyB,CAAA;AAE5D,eAAO,MAAM,6BAA6B,QAGV,CAAA;AAEhC,eAAO,MAAM,wBAAwB;;;;CAKpC,CAAA;AAED,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAS7E"}

package/dist/tools/get-endpoint-details.js

@@ -7,9 +7,11 @@ export const getEndpointDetailsDescription = 'Get the real request schema, param
 export const getEndpointDetailsSchema = {
     api: z.string().describe('Provider key from search_endpoints, e.g. "coldiq" (Lima Data), "apollo", or "exa".'),
     path: z.string().describe('Endpoint path without the /v1 prefix, e.g. "/limadata/prospect/people/filter".'),
+    method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']).optional()
+        .describe('HTTP method from search_endpoints. Set this when one path supports more than one method.'),
 };
 export async function getEndpointDetailsHandler(input) {
-    const res = await callApi('POST', '/endpoints/details', { api: input.api, path: input.path });
+    const res = await callApi('POST', '/endpoints/details', { api: input.api, path: input.path, method: input.method });
     if (!res.ok) {
         return {
             content: [{ type: 'text', text: JSON.stringify({ error: 'Endpoint not found or details unavailable', status: res.status, data: res.data }) }],

package/dist/tools/get-endpoint-details.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-endpoint-details.js","sourceRoot":"","sources":["../../src/tools/get-endpoint-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAA;AAE5D,MAAM,CAAC,MAAM,6BAA6B,GACxC,6GAA6G;IAC7G,uGAAuG;IACvG,8BAA8B,CAAA;AAEhC,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oFAAoF,CAAC;IAC9G,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;CAC5G,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,KAA8B;IAC5E,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IAC7F,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACtJ,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;AACjF,CAAC"}
+{"version":3,"file":"get-endpoint-details.js","sourceRoot":"","sources":["../../src/tools/get-endpoint-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAA;AAE5D,MAAM,CAAC,MAAM,6BAA6B,GACxC,6GAA6G;IAC7G,uGAAuG;IACvG,8BAA8B,CAAA;AAEhC,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oFAAoF,CAAC;IAC9G,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;IAC3G,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;SACjE,QAAQ,CAAC,0FAA0F,CAAC;CACxG,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,KAA8B;IAC5E,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IACnH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACtJ,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;AACjF,CAAC"}

package/dist/tools/search-web.d.ts

@@ -5,7 +5,7 @@ export declare const searchWebSchema: {
     query: z.ZodString;
     num_results: z.ZodDefault<z.ZodNumber>;
     country: z.ZodOptional<z.ZodString>;
-    search_type: z.ZodDefault<z.ZodEnum<["general", "neural"]>>;
+    search_type: z.ZodDefault<z.ZodEnum<["general", "neural", "deep", "deep-reasoning"]>>;
     use_providers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 };
 export declare function searchWebHandler(input: Record<string, unknown>): Promise<{

package/dist/tools/search-web.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { callVerb } from '../verb-client.js';
 import { getProvidersForCapability } from '../utils/provider-resolver.js';
 export const searchWebName = 'search_web';
-export const searchWebDescription = 'Search the web for market research, company news, or general lookups. Supports Google search (default) and neural/semantic search via Exa. ' +
+export const searchWebDescription = 'Search the web for market research, company news, or general lookups. Supports Google search (default), Exa auto through the neural compatibility alias, and Exa deep modes. ' +
     'NEVER use this to find, verify, or look up people, contacts, LinkedIn profiles, or executives — even as a fallback when find_people returns uncertain results. ' +
     'find_people is the only tool for people lookups; do not supplement or replace it with web search. ' +
     'ColdIQ automatically picks the best provider — pass use_providers only if you need a specific tool.';
@@ -10,7 +10,7 @@ export const searchWebSchema = {
     query: z.string().describe('Search query'),
     num_results: z.number().min(1).max(100).default(10).describe('Number of results (default: 10, max: 100)'),
     country: z.string().optional().describe('Country code for geo-targeting (e.g. "us", "fr")'),
-    search_type: z.enum(['general', 'neural']).default('general').describe('"general" for Google search (default), "neural" for semantic search via Exa'),
+    search_type: z.enum(['general', 'neural', 'deep', 'deep-reasoning']).default('general').describe('"general" for the default web search, "neural" for Exa auto compatibility, or an Exa deep mode'),
     use_providers: z.array(z.string()).optional().describe(`Optional ordered list of providers to use. Leave empty to let ColdIQ automatically pick the best tool for your inputs — recommended for most use cases. Available providers: ${getProvidersForCapability('search_web').join(', ')}. Provider names are matched fuzzily, so minor typos are tolerated.`),
 };
 export async function searchWebHandler(input) {

package/dist/tools/search-web.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-web.js","sourceRoot":"","sources":["../../src/tools/search-web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAA;AAEzE,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAA;AAEzC,MAAM,CAAC,MAAM,oBAAoB,GAC/B,6IAA6I;IAC7I,iKAAiK;IACjK,oGAAoG;IACpG,qGAAqG,CAAA;AAEvG,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACzG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC3F,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,6EAA6E,CAAC;IACrJ,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gLAAgL,yBAAyB,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,qEAAqE,CAAC;CAChW,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAA8B;IACnE,OAAO,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;AACvC,CAAC"}
+{"version":3,"file":"search-web.js","sourceRoot":"","sources":["../../src/tools/search-web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAA;AAEzE,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAA;AAEzC,MAAM,CAAC,MAAM,oBAAoB,GAC/B,+KAA+K;IAC/K,iKAAiK;IACjK,oGAAoG;IACpG,qGAAqG,CAAA;AAEvG,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACzG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC3F,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,gGAAgG,CAAC;IAClM,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gLAAgL,yBAAyB,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,qEAAqE,CAAC;CAChW,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAA8B;IACnE,OAAO,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;AACvC,CAAC"}

package/package.json

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

package/src/executor.ts

@@ -261,7 +261,7 @@ export async function executeWithFallback(
 
   let allProviders =
     capability === 'search_web'
-      ? getSearchWebProviders(input.search_type === 'neural')
+      ? getSearchWebProviders(input.search_type !== undefined && input.search_type !== 'general')
       : getProviders(capability)
 
   // When the caller pinned specific providers, filter to those in order.

package/src/registry.ts

@@ -71,6 +71,27 @@ function isNonEmptyArray(v: unknown): boolean {
   return Array.isArray(v) && v.length > 0
 }
 
+// Keep this standalone-package mirror in sync with
+// src/providers/icypeas/reverse-email-classify.ts.
+function isIcypeasReverseEmailFound(body: unknown): boolean {
+  if (!body || typeof body !== 'object' || Array.isArray(body)) return false
+  const response = body as Record<string, unknown>
+  const status = typeof response.status === 'string' ? response.status : ''
+  if (status !== 'FOUND' && status !== 'DEBITED') return false
+  if (response.success !== true || typeof response.results !== 'string') return false
+
+  try {
+    const url = new URL(response.results)
+    const hostname = url.hostname.toLowerCase()
+    const isLinkedInHost = hostname === 'linkedin.com' || hostname.endsWith('.linkedin.com')
+    return (url.protocol === 'http:' || url.protocol === 'https:')
+      && isLinkedInHost
+      && url.pathname.startsWith('/in/')
+  } catch {
+    return false
+  }
+}
+
 // TheirStack attaches a per-job `company_object` whose enrichment arrays dominate the
 // payload (e.g. ~1,600-element technology_slugs/technology_names, plus long_description) —
 // tens of KB per job. Drop these heavy fields while keeping company identity (name, domain,
@@ -2295,7 +2316,9 @@ const searchWebProviders: ProviderEntry[] = [
       body: {
         query: input.query,
         numResults: input.num_results ?? 10,
-        type: input.search_type === 'neural' ? 'neural' : 'auto',
+        type: input.search_type === 'deep' || input.search_type === 'deep-reasoning'
+          ? input.search_type
+          : 'auto',
       },
     }),
     hasResult: (data) => {
@@ -3410,10 +3433,7 @@ const enrichPersonProviders: ProviderEntry[] = [
     priority: 11,
     isApplicable: (input) => typeof input.email === 'string' && (input.email as string).includes('@'),
     mapParams: (input) => ({ body: { email: input.email } }),
-    hasResult: (data) => {
-      const d = data as Record<string, unknown>
-      return isNonEmptyArray(d.profiles) || (d.success === true && !!d.data)
-    },
+    hasResult: isIcypeasReverseEmailFound,
   },
   {
     id: 'pdl-person-identify',

package/src/tools/call-endpoint.ts

@@ -13,6 +13,8 @@ export const callEndpointDescription =
 export const callEndpointSchema = {
   api: z.string().describe('Provider key from search_endpoints / get_endpoint_details, e.g. "coldiq".'),
   path: z.string().describe('Endpoint path without the /v1 prefix, e.g. "/limadata/prospect/people/filter".'),
+  method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']).optional()
+    .describe('HTTP method from search_endpoints. Set this when one path supports more than one method.'),
   params: z
     .record(z.unknown())
     .optional()
@@ -20,7 +22,7 @@ export const callEndpointSchema = {
 }
 
 export async function callEndpointHandler(input: Record<string, unknown>) {
-  const res = await callApi('POST', '/endpoints/use', { api: input.api, path: input.path, params: input.params })
+  const res = await callApi('POST', '/endpoints/use', { api: input.api, path: input.path, method: input.method, params: input.params })
   if (!res.ok) {
     return {
       content: [{ type: 'text' as const, text: JSON.stringify({ error: 'Endpoint call failed', status: res.status, data: res.data }) }],