@coldiq/mcp 0.1.0

package/dist/tools/enrich-person.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-person.js","sourceRoot":"","sources":["../../src/tools/enrich-person.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAA;AAE/C,MAAM,CAAC,MAAM,uBAAuB,GAClC,gEAAgE;IAChE,2FAA2F;IAC3F,2EAA2E,CAAA;AAE7E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yEAAyE,CAAC;IACxH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC;IAC/G,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAC/D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACtF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;IAC1G,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mGAAmG,CAAC;IACvJ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CAC/E,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAA8B;IACtE,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,eAAe,EAAE,KAAK,CAAC,CAAA;IAChE,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACvG,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;AACxF,CAAC"}

package/dist/tools/fetch-page-content.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const fetchPageContentName = "fetch_page_content";
+export declare const fetchPageContentDescription: string;
+export declare const fetchPageContentSchema: {
+    urls: z.ZodArray<z.ZodString, "many">;
+    include_text: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    include_summary: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+};
+export declare function fetchPageContentHandler(input: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=fetch-page-content.d.ts.map

package/dist/tools/fetch-page-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-page-content.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-page-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,oBAAoB,uBAAuB,CAAA;AAExD,eAAO,MAAM,2BAA2B,QAIH,CAAA;AAErC,eAAO,MAAM,sBAAsB;;;;CAgBlC,CAAA;AAED,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAM3E"}

package/dist/tools/fetch-page-content.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { executeWithFallback, isExecutionError } from '../executor.js';
+export const fetchPageContentName = 'fetch_page_content';
+export const fetchPageContentDescription = 'Fetch the full text content of one or more web pages given their URLs. ' +
+    'Returns extracted page text suitable for RAG, summarisation, or fact extraction. ' +
+    'Use search_web first to discover URLs, then use this tool to fetch their full text. ' +
+    'Costs 1 credit per URL submitted.';
+export const fetchPageContentSchema = {
+    urls: z
+        .array(z.string().url())
+        .min(1)
+        .max(10)
+        .describe('URLs to fetch content from (1–10 URLs per call).'),
+    include_text: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Extract and return full page text (default: true).'),
+    include_summary: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Generate a summary for each page in addition to the text (default: false).'),
+};
+export async function fetchPageContentHandler(input) {
+    const result = await executeWithFallback('fetch_page_content', input);
+    if (isExecutionError(result)) {
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], isError: true };
+    }
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+}
+//# sourceMappingURL=fetch-page-content.js.map

package/dist/tools/fetch-page-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-page-content.js","sourceRoot":"","sources":["../../src/tools/fetch-page-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtE,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAA;AAExD,MAAM,CAAC,MAAM,2BAA2B,GACtC,yEAAyE;IACzE,mFAAmF;IACnF,sFAAsF;IACtF,mCAAmC,CAAA;AAErC,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;SACvB,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,YAAY,EAAE,CAAC;SACZ,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,oDAAoD,CAAC;IACjE,eAAe,EAAE,CAAC;SACf,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,4EAA4E,CAAC;CAC1F,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAA8B;IAC1E,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAA;IACrE,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACvG,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;AACxF,CAAC"}

package/dist/tools/find-email.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export declare const findEmailName = "find_email";
+export declare const findEmailDescription = "Find a person's professional email given their name and company. Tries multiple providers in sequence until an email is found (waterfall). Returns the email and which provider found it.";
+export declare const findEmailSchema: {
+    first_name: z.ZodOptional<z.ZodString>;
+    last_name: z.ZodOptional<z.ZodString>;
+    domain: z.ZodOptional<z.ZodString>;
+    company_name: z.ZodOptional<z.ZodString>;
+    linkedin_url: z.ZodOptional<z.ZodString>;
+};
+export declare function findEmailHandler(input: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=find-email.d.ts.map

package/dist/tools/find-email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-email.d.ts","sourceRoot":"","sources":["../../src/tools/find-email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,aAAa,eAAe,CAAA;AAEzC,eAAO,MAAM,oBAAoB,8LAC4J,CAAA;AAE7L,eAAO,MAAM,eAAe;;;;;;CAM3B,CAAA;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAMpE"}

package/dist/tools/find-email.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { executeWaterfall, isExecutionError } from '../executor.js';
+export const findEmailName = 'find_email';
+export const findEmailDescription = "Find a person's professional email given their name and company. Tries multiple providers in sequence until an email is found (waterfall). Returns the email and which provider found it.";
+export const findEmailSchema = {
+    first_name: z.string().optional().describe('First name of the person'),
+    last_name: z.string().optional().describe('Last name of the person'),
+    domain: z.string().optional().describe('Company domain (e.g. "stripe.com")'),
+    company_name: z.string().optional().describe('Company name — alternative to domain'),
+    linkedin_url: z.string().optional().describe('LinkedIn profile URL — alternative to name+domain'),
+};
+export async function findEmailHandler(input) {
+    const result = await executeWaterfall('find_email', input);
+    if (isExecutionError(result)) {
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], isError: true };
+    }
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+}
+//# sourceMappingURL=find-email.js.map

package/dist/tools/find-email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-email.js","sourceRoot":"","sources":["../../src/tools/find-email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEnE,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAA;AAEzC,MAAM,CAAC,MAAM,oBAAoB,GAC/B,2LAA2L,CAAA;AAE7L,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACtE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACpE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC5E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACpF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;CAClG,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAA8B;IACnE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAA;IAC1D,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACvG,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;AACxF,CAAC"}

package/dist/tools/find-emails.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+export declare const findEmailsName = "find_emails";
+export declare const findEmailsDescription: string;
+export declare const findEmailsSchema: {
+    people: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        first_name: z.ZodOptional<z.ZodString>;
+        last_name: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        linkedin_url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        linkedin_url?: string | undefined;
+        domain?: string | undefined;
+        first_name?: string | undefined;
+        last_name?: string | undefined;
+    }, {
+        id: string;
+        linkedin_url?: string | undefined;
+        domain?: string | undefined;
+        first_name?: string | undefined;
+        last_name?: string | undefined;
+    }>, "many">;
+};
+export declare function findEmailsHandler(input: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=find-emails.d.ts.map

package/dist/tools/find-emails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-emails.d.ts","sourceRoot":"","sources":["../../src/tools/find-emails.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,cAAc,gBAAgB,CAAA;AAE3C,eAAO,MAAM,qBAAqB,QAOiF,CAAA;AAEnH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;CAc5B,CAAA;AAwBD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;GAyIrE"}

package/dist/tools/find-emails.js

@@ -0,0 +1,146 @@
+import { z } from 'zod';
+import { callApi } from '../client.js';
+export const findEmailsName = 'find_emails';
+export const findEmailsDescription = 'Find professional emails for multiple people in one batch. ' +
+    'Uses bulk enrichment first, then a secondary provider for misses, then ' +
+    'two additional providers in parallel for any remaining misses. ' +
+    'Much faster than calling find_email one-by-one. Max 50 people per call. ' +
+    'Each person needs a unique id to match results back. ' +
+    'Always pass first_name, last_name, and domain — they are the primary enrichment signal. ' +
+    'Also pass linkedin_url when available, but never rely on it alone as some providers cannot resolve vanity URLs.';
+export const findEmailsSchema = {
+    people: z
+        .array(z.object({
+        id: z.string().describe("Unique identifier to match results back (e.g. person's name or a slug)"),
+        first_name: z.string().optional().describe('First name'),
+        last_name: z.string().optional().describe('Last name'),
+        domain: z.string().optional().describe('Company domain (e.g. "stripe.com")'),
+        linkedin_url: z.string().optional().describe('LinkedIn profile URL — pass when available but always include name+domain too'),
+    }))
+        .min(1)
+        .max(50)
+        .describe('People to find emails for (max 50)'),
+};
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function missesOf(people, results) {
+    return people.filter((p) => !results.find((r) => r.id === p.id)?.email);
+}
+export async function findEmailsHandler(input) {
+    const people = input.people;
+    const results = people.map((p) => ({ id: p.id, email: null, provider: null }));
+    // Step 1: Prospeo bulk — 1 call for all people
+    const bulkBody = {
+        data: people.map((p) => p.linkedin_url
+            ? { identifier: p.id, linkedin_url: p.linkedin_url }
+            : { identifier: p.id, first_name: p.first_name, last_name: p.last_name, company_name: p.domain }),
+    };
+    const bulkRes = await callApi('POST', '/prospeo/bulk-enrich-person', bulkBody);
+    if (bulkRes.ok) {
+        const data = bulkRes.data;
+        for (const item of data.results ?? []) {
+            const email = item.person?.email?.email;
+            if (typeof email === 'string' && email.includes('@')) {
+                const hit = results.find((r) => r.id === item.identifier);
+                if (hit) {
+                    hit.email = email;
+                    hit.provider = 'prospeo';
+                }
+            }
+        }
+    }
+    // Step 2: FullEnrich batch for Prospeo misses (async, better European coverage)
+    const afterProspeo = missesOf(people, results);
+    if (afterProspeo.length > 0) {
+        const feBody = {
+            name: 'mcp-enrich-batch',
+            data: afterProspeo.map((p) => ({
+                first_name: p.first_name,
+                last_name: p.last_name,
+                domain: p.domain,
+                ...(p.linkedin_url ? { linkedin_url: p.linkedin_url } : {}),
+                enrich_fields: ['contact.emails'],
+            })),
+        };
+        const feCreateRes = await callApi('POST', '/fullenrich/contact/enrich/bulk', feBody);
+        if (feCreateRes.ok) {
+            const enrichmentId = feCreateRes.data.enrichment_id;
+            if (enrichmentId) {
+                const deadline = Date.now() + 90_000;
+                while (Date.now() < deadline) {
+                    await sleep(5000);
+                    const pollRes = await callApi('GET', `/fullenrich/contact/enrich/bulk/${enrichmentId}`);
+                    if (!pollRes.ok)
+                        continue;
+                    const pd = pollRes.data;
+                    const status = pd.status;
+                    if (status === 'DONE' || status === 'FAILED') {
+                        if (status === 'DONE') {
+                            const feItems = pd.data;
+                            if (Array.isArray(feItems)) {
+                                feItems.forEach((item, idx) => {
+                                    const person = afterProspeo[idx];
+                                    const hit = results.find((r) => r.id === person?.id);
+                                    if (!hit || hit.email)
+                                        return;
+                                    const emails = item.emails;
+                                    if (Array.isArray(emails) && emails.length > 0 && typeof emails[0] === 'string' && emails[0].includes('@')) {
+                                        hit.email = emails[0];
+                                        hit.provider = 'fullenrich';
+                                    }
+                                });
+                            }
+                        }
+                        break;
+                    }
+                }
+            }
+        }
+    }
+    // Step 3: parallel fallback for remaining misses — FindyMail then IcyPeas per person
+    const afterFullEnrich = missesOf(people, results);
+    await Promise.all(afterFullEnrich.map(async (person) => {
+        const hit = results.find((r) => r.id === person.id);
+        const fullName = [person.first_name, person.last_name].filter(Boolean).join(' ');
+        const fmRes = await callApi('POST', '/findymail/search/name', {
+            name: fullName,
+            domain: person.domain,
+        });
+        if (fmRes.ok) {
+            const d = fmRes.data;
+            if (typeof d.email === 'string' && d.email.includes('@')) {
+                hit.email = d.email;
+                hit.provider = 'findymail';
+                return;
+            }
+        }
+        const icyRes = await callApi('POST', '/icypeas/email-search', {
+            firstname: person.first_name,
+            lastname: person.last_name,
+            domainOrCompany: person.domain,
+        });
+        if (icyRes.ok) {
+            const d = icyRes.data;
+            const email = typeof d.email === 'string' && d.email.includes('@')
+                ? d.email
+                : Array.isArray(d.emails) && typeof d.emails[0] === 'string' && d.emails[0].includes('@')
+                    ? d.emails[0]
+                    : null;
+            if (email) {
+                hit.email = email;
+                hit.provider = 'icypeas';
+            }
+        }
+    }));
+    const found = results.filter((r) => r.email !== null).length;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({ data: { results, found, total: people.length } }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=find-emails.js.map

package/dist/tools/find-emails.js.map

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

package/dist/tools/find-influencers.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export declare const findInfluencersName = "find_influencers";
+export declare const findInfluencersDescription = "Discover and find influencers/creators on Instagram, YouTube, TikTok, Twitch, Twitter, and OnlyFans via 2 providers (Influencers Club Similar, Influencers Club Discovery). Routes by input: handle set \u2192 lookalike search (influencers_similar) runs first; no handle \u2192 keyword/filter discovery. Filters: location, gender, type (creator/business), AI natural language search, sort. Cost: 1 credit per result returned.";
+export declare const findInfluencersSchema: {
+    platform: z.ZodEnum<["instagram", "youtube", "tiktok", "twitch", "twitter", "onlyfans"]>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    sort_by: z.ZodOptional<z.ZodEnum<["relevancy", "number_of_followers", "engagement_rate"]>>;
+    sort_order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
+    ai_search: z.ZodOptional<z.ZodString>;
+    location: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    gender: z.ZodOptional<z.ZodEnum<["male", "female"]>>;
+    type: z.ZodOptional<z.ZodEnum<["creator", "business"]>>;
+    handle: z.ZodOptional<z.ZodString>;
+};
+export declare function findInfluencersHandler(input: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=find-influencers.d.ts.map

package/dist/tools/find-influencers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-influencers.d.ts","sourceRoot":"","sources":["../../src/tools/find-influencers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,mBAAmB,qBAAqB,CAAA;AAErD,eAAO,MAAM,0BAA0B,2aACyX,CAAA;AAEha,eAAO,MAAM,qBAAqB;;;;;;;;;;;CAiBjC,CAAA;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAM1E"}

package/dist/tools/find-influencers.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { executeWithFallback, isExecutionError } from '../executor.js';
+export const findInfluencersName = 'find_influencers';
+export const findInfluencersDescription = 'Discover and find influencers/creators on Instagram, YouTube, TikTok, Twitch, Twitter, and OnlyFans via 2 providers (Influencers Club Similar, Influencers Club Discovery). Routes by input: handle set → lookalike search (influencers_similar) runs first; no handle → keyword/filter discovery. Filters: location, gender, type (creator/business), AI natural language search, sort. Cost: 1 credit per result returned.';
+export const findInfluencersSchema = {
+    platform: z.enum(['instagram', 'youtube', 'tiktok', 'twitch', 'twitter', 'onlyfans'])
+        .describe('Target platform.'),
+    limit: z.number().int().min(1).max(100).default(25)
+        .describe('Max creators to return (1–100). 1 credit per result.'),
+    page: z.number().int().min(1).default(1).optional()
+        .describe('Page number for pagination.'),
+    sort_by: z.enum(['relevancy', 'number_of_followers', 'engagement_rate']).optional(),
+    sort_order: z.enum(['asc', 'desc']).optional(),
+    ai_search: z.string().optional()
+        .describe('Natural language query e.g. "fitness influencers in NYC who post about nutrition".'),
+    location: z.array(z.string()).optional()
+        .describe('Country or city names e.g. ["United States", "New York"].'),
+    gender: z.enum(['male', 'female']).optional(),
+    type: z.enum(['creator', 'business']).optional(),
+    handle: z.string().optional()
+        .describe('Find creators similar to this handle. Routes to lookalike search. No @ prefix.'),
+};
+export async function findInfluencersHandler(input) {
+    const result = await executeWithFallback('find_influencers', input);
+    if (isExecutionError(result)) {
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], isError: true };
+    }
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+}
+//# sourceMappingURL=find-influencers.js.map

package/dist/tools/find-influencers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-influencers.js","sourceRoot":"","sources":["../../src/tools/find-influencers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAA;AAErD,MAAM,CAAC,MAAM,0BAA0B,GACrC,8ZAA8Z,CAAA;AAEha,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;SAClF,QAAQ,CAAC,kBAAkB,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;SAChD,QAAQ,CAAC,sDAAsD,CAAC;IACnE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SAChD,QAAQ,CAAC,6BAA6B,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,qBAAqB,EAAE,iBAAiB,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnF,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,QAAQ,CAAC,oFAAoF,CAAC;IACjG,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;SACrC,QAAQ,CAAC,2DAA2D,CAAC;IACxE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC1B,QAAQ,CAAC,gFAAgF,CAAC;CAC9F,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAA8B;IACzE,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAA;IACnE,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACvG,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;AACxF,CAAC"}

package/dist/tools/find-people.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export declare const findPeopleName = "find_people";
+export declare const findPeopleDescription: string;
+export declare const findPeopleSchema: {
+    company_linkedin_urls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    company_domains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    job_titles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    seniorities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    locations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+export declare function findPeopleHandler(input: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=find-people.d.ts.map

package/dist/tools/find-people.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-people.d.ts","sourceRoot":"","sources":["../../src/tools/find-people.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,eAAO,MAAM,cAAc,gBAAgB,CAAA;AAE3C,eAAO,MAAM,qBAAqB,QAS0B,CAAA;AAE5D,eAAO,MAAM,gBAAgB;;;;;;;;CAQ5B,CAAA;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAwCrE"}

package/dist/tools/find-people.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { executeWithFallback, isExecutionError } from '../executor.js';
+import { callApi } from '../client.js';
+import { getProviders } from '../registry.js';
+export const findPeopleName = 'find_people';
+export const findPeopleDescription = 'Find people at specific companies by job title. ' +
+    'Use this — never search_web — to find contacts, executives, or LinkedIn profiles at known companies. ' +
+    'Do not fall back to search_web when results look uncertain or LinkedIn URLs seem wrong — trust what this tool returns. ' +
+    'ALWAYS pass all companies in a single call — never loop and call once per company. ' +
+    'Set limit = (desired results per company) × (number of companies). ' +
+    'Prefer company_linkedin_urls when available — they make the search faster. Only pass company_domains when you have no LinkedIn URLs. ' +
+    'Pass job_titles EXACTLY as stated — never expand or generate variants (e.g. do NOT turn "CEO" into ["CEO", "Chief Executive Officer", "Founder"]). LeadsFactory handles fuzzy title matching internally; adding variants wastes personas and degrades results. ' +
+    'Do NOT pass seniorities unless explicitly asked — job titles alone produce better results. ' +
+    'Returns names, titles, LinkedIn URLs. Default limit: 25.';
+export const findPeopleSchema = {
+    company_linkedin_urls: z.array(z.string()).optional().describe('Company LinkedIn URLs (preferred over domains when available, e.g. ["https://linkedin.com/company/microsoft"])'),
+    company_domains: z.array(z.string()).optional().describe('Company domains to search (e.g. ["microsoft.com", "google.com"]). Use only when LinkedIn URLs are not available.'),
+    job_titles: z.array(z.string()).optional().describe('Target job titles (e.g. ["CEO", "VP of Sales"])'),
+    seniorities: z.array(z.string()).optional().describe('Seniority levels (e.g. ["c_suite", "vp", "director"])'),
+    locations: z.array(z.string()).optional().describe('Person or company locations'),
+    keywords: z.array(z.string()).optional().describe('Free-text keyword search terms (e.g. ["growth", "AI"])'),
+    limit: z.number().min(1).max(500).default(25).describe('Max results across all companies combined (default: 25, max: 500). For multiple companies multiply: e.g. 10 companies × 5 each = 50.'),
+};
+export async function findPeopleHandler(input) {
+    const result = await executeWithFallback('find_people', input);
+    if (isExecutionError(result)) {
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], isError: true };
+    }
+    // Gap-fill: if LeadsFactory missed some domains, try Apollo for those.
+    // Only runs when domains were the input — if we sent LinkedIn URLs, no_results_domains
+    // is unreliable (LF may resolve arbitrary domains from URLs, e.g. linkedin.com itself).
+    const inputHadDomains = Array.isArray(input.company_domains) && input.company_domains.length > 0;
+    const inputHadLinkedInUrls = Array.isArray(input.company_linkedin_urls) && input.company_linkedin_urls.length > 0;
+    if (result._meta.provider === 'leadsfactory' && inputHadDomains && !inputHadLinkedInUrls) {
+        const data = result.data;
+        const missedDomains = data.no_results_domains ?? [];
+        if (missedDomains.length > 0) {
+            const apollo = getProviders('find_people').find((p) => p.id === 'apollo');
+            if (apollo) {
+                const gapInput = { ...input, company_domains: missedDomains, company_linkedin_urls: undefined };
+                const payload = apollo.mapParams(gapInput);
+                const apolloRes = await callApi(apollo.method, apollo.endpoint, payload.body, payload.queryParams);
+                if (apolloRes.ok && apollo.hasResult(apolloRes.data)) {
+                    const merged = {
+                        ...data,
+                        gap_fill: {
+                            provider: 'apollo',
+                            domains: missedDomains,
+                            ...apolloRes.data,
+                        },
+                    };
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify({ ...result, data: merged }, null, 2) }],
+                    };
+                }
+            }
+        }
+    }
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+}
+//# sourceMappingURL=find-people.js.map

package/dist/tools/find-people.js.map

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

package/dist/tools/find-phone.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export declare const findPhoneName = "find_phone";
+export declare const findPhoneDescription = "Find a direct phone number for a person. Accepts a LinkedIn URL, or first+last name with company domain/name. Phone lookups are expensive (10+ credits) \u2014 use only when specifically needed.";
+export declare const findPhoneSchema: {
+    linkedin_url: z.ZodOptional<z.ZodString>;
+    first_name: z.ZodOptional<z.ZodString>;
+    last_name: z.ZodOptional<z.ZodString>;
+    company_domain: z.ZodOptional<z.ZodString>;
+    company_name: z.ZodOptional<z.ZodString>;
+};
+export declare function findPhoneHandler(input: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=find-phone.d.ts.map

package/dist/tools/find-phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-phone.d.ts","sourceRoot":"","sources":["../../src/tools/find-phone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,aAAa,eAAe,CAAA;AAEzC,eAAO,MAAM,oBAAoB,sMAC+J,CAAA;AAEhM,eAAO,MAAM,eAAe;;;;;;CAM3B,CAAA;AAwBD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAcpE"}

package/dist/tools/find-phone.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { executeWithFallback, isExecutionError } from '../executor.js';
+export const findPhoneName = 'find_phone';
+export const findPhoneDescription = 'Find a direct phone number for a person. Accepts a LinkedIn URL, or first+last name with company domain/name. Phone lookups are expensive (10+ credits) — use only when specifically needed.';
+export const findPhoneSchema = {
+    linkedin_url: z.string().url().optional().describe('LinkedIn profile URL'),
+    first_name: z.string().optional().describe('First name (required when no LinkedIn URL)'),
+    last_name: z.string().optional().describe('Last name (required when no LinkedIn URL)'),
+    company_domain: z.string().optional().describe('Company domain, e.g. coldiq.com'),
+    company_name: z.string().optional().describe('Company name (alternative to company_domain)'),
+};
+const inputSchema = z
+    .object({
+    linkedin_url: z.string().url().optional(),
+    first_name: z.string().optional(),
+    last_name: z.string().optional(),
+    company_domain: z.string().optional(),
+    company_name: z.string().optional(),
+})
+    .superRefine((val, ctx) => {
+    const hasLinkedIn = typeof val.linkedin_url === 'string' && val.linkedin_url.length > 0;
+    const hasName = typeof val.first_name === 'string' && val.first_name.length > 0 &&
+        typeof val.last_name === 'string' && val.last_name.length > 0;
+    const hasCompany = (typeof val.company_domain === 'string' && val.company_domain.length > 0) ||
+        (typeof val.company_name === 'string' && val.company_name.length > 0);
+    if (!hasLinkedIn && !(hasName && hasCompany)) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'Provide either linkedin_url or both first_name+last_name and company_domain/company_name',
+        });
+    }
+});
+export async function findPhoneHandler(input) {
+    const validation = inputSchema.safeParse(input);
+    if (!validation.success) {
+        const msg = validation.error.issues.map((i) => i.message).join('; ');
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: msg }, null, 2) }],
+            isError: true,
+        };
+    }
+    const result = await executeWithFallback('find_phone', input);
+    if (isExecutionError(result)) {
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], isError: true };
+    }
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+}
+//# sourceMappingURL=find-phone.js.map

package/dist/tools/find-phone.js.map

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

package/dist/tools/find-signals.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export declare const findSignalsName = "find_signals";
+export declare const findSignalsDescription: string;
+export declare const findSignalsSchema: {
+    signal_type: z.ZodEnum<["funding", "acquisition", "hiring", "job_change", "news", "intent", "startup_post"]>;
+    companies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    domains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    since: z.ZodOptional<z.ZodString>;
+    industries: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    countries: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+export declare function findSignalsHandler(input: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=find-signals.d.ts.map

package/dist/tools/find-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-signals.d.ts","sourceRoot":"","sources":["../../src/tools/find-signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,eAAe,iBAAiB,CAAA;AAE7C,eAAO,MAAM,sBAAsB,QAM+G,CAAA;AAElJ,eAAO,MAAM,iBAAiB;;;;;;;;CAoC7B,CAAA;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAyCtE"}