@sellable/mcp 0.1.220 → 0.1.221

package/dist/tools/leads.js

@@ -197,6 +197,25 @@ const prospeoCompanyAttributesSchema = {
         mobileapps: { type: ["boolean", "null"] },
         onlinereviews: { type: ["boolean", "null"] },
         pricing: { type: ["boolean", "null"] },
+        uses_ai: { type: ["boolean", "null"] },
+        has_api: { type: ["boolean", "null"] },
+        has_chrome_extension: { type: ["boolean", "null"] },
+        has_sso: { type: ["boolean", "null"] },
+        has_uptime_guarantee: { type: ["boolean", "null"] },
+        has_open_source: { type: ["boolean", "null"] },
+        has_marketplace: { type: ["boolean", "null"] },
+        has_blog: { type: ["boolean", "null"] },
+        has_podcast: { type: ["boolean", "null"] },
+        has_community_forum: { type: ["boolean", "null"] },
+        has_knowledge_base: { type: ["boolean", "null"] },
+        has_academy: { type: ["boolean", "null"] },
+        has_affiliate_program: { type: ["boolean", "null"] },
+        has_esg_reports: { type: ["boolean", "null"] },
+        has_physical_offices: { type: ["boolean", "null"] },
+        is_venture_backed: { type: ["boolean", "null"] },
+        is_publicly_traded: { type: ["boolean", "null"] },
+        has_soc2: { type: ["boolean", "null"] },
+        data_residency: { type: "string", enum: ["EU"] },
     },
 };
 const prospeoCompanyRevenueSchema = {
@@ -236,6 +255,206 @@ const prospeoCompanyHeadcountByDepartmentSchema = {
         max: { type: "number" },
     },
 };
+const prospeoCompanyLookalikeSchema = {
+    type: "object",
+    description: 'Prospeo company lookalike filter. company_oids must be Prospeo company IDs from seed resolution/search. minimum_tier must serialize as "T1", "T2", or "T3"; public API rows do not expose row-level tier/score/reason.',
+    properties: {
+        company_oids: { type: "array", items: { type: "string" } },
+        minimum_tier: { type: "string", enum: ["T1", "T2", "T3"] },
+        match_all: { type: "boolean" },
+        same_language: { type: "boolean" },
+    },
+    required: ["company_oids"],
+};
+const prospeoCompanyNewsSchema = {
+    type: "object",
+    description: "Company news filters by keyword, category, and timeframe.",
+    properties: {
+        keywords: { type: "array", items: { type: "string" } },
+        categories: {
+            type: "array",
+            items: {
+                type: "string",
+                enum: [
+                    "Funding & Investment",
+                    "Mergers & Acquisitions",
+                    "Product Launch",
+                    "Partnership",
+                    "Expansion",
+                    "Layoffs & Restructuring",
+                    "IPO",
+                    "Leadership Change",
+                    "Legal & Regulatory",
+                    "Awards & Recognition",
+                ],
+            },
+        },
+        timeframe_days: { type: "number", enum: [60, 90, 180, 365] },
+    },
+};
+const prospeoCompanyAwardsSchema = {
+    type: "object",
+    description: 'Company awards filter. match_mode only supports "CONTAINS".',
+    properties: {
+        include: { type: "array", items: { type: "string" } },
+        exclude: { type: "array", items: { type: "string" } },
+        match_mode: { type: "string", enum: ["CONTAINS"] },
+    },
+};
+const prospeoCompanyWebsiteSearchSchema = {
+    type: "object",
+    description: "Company website search filter for pricing, docs, security, comparison, status, careers, and page-keyword signals.",
+    properties: {
+        include_keywords: { type: "array", items: { type: "string" } },
+        exclude_keywords: { type: "array", items: { type: "string" } },
+        url_contains: { type: "array", items: { type: "string" } },
+        has_persona_pages: { type: "boolean" },
+        has_industry_pages: { type: "boolean" },
+        has_solution_pages: { type: "boolean" },
+        has_careers_page: { type: "boolean" },
+        has_status_page: { type: "boolean" },
+        has_sla_page: { type: "boolean" },
+        has_developer_docs_page: { type: "boolean" },
+        has_investor_page: { type: "boolean" },
+        has_security_page: { type: "boolean" },
+        has_comparison_pages: { type: "boolean" },
+    },
+};
+const prospeoCompanyProductsServicesSchema = {
+    type: "object",
+    description: "Company products/services filters.",
+    properties: {
+        products_include: { type: "array", items: { type: "string" } },
+        products_exclude: { type: "array", items: { type: "string" } },
+        products_match_all: { type: "boolean" },
+        service_tags_include: { type: "array", items: { type: "string" } },
+        service_tags_exclude: { type: "array", items: { type: "string" } },
+        service_tags_match_all: { type: "boolean" },
+    },
+};
+const prospeoCompanySimpleIncludeExcludeSchema = {
+    type: "object",
+    properties: {
+        include: { type: "array", items: { type: "string" } },
+        exclude: { type: "array", items: { type: "string" } },
+    },
+};
+const prospeoCompanyIncludeOnlySchema = {
+    type: "object",
+    properties: {
+        include: { type: "array", items: { type: "string" } },
+    },
+};
+const prospeoCompanyGoogleDiscoverySchema = {
+    type: "object",
+    description: "Company Google discovery filters.",
+    properties: {
+        seo_keywords: { type: "array", items: { type: "string" } },
+    },
+};
+const prospeoCompanyHeadcountByLocationSchema = {
+    type: "object",
+    description: "Company headcount by location filter.",
+    properties: {
+        entries: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    country: { type: "string" },
+                    state: { type: "string" },
+                    city: { type: "string" },
+                    min_headcount: { type: "number" },
+                    max_headcount: { type: "number" },
+                },
+                required: ["country"],
+            },
+        },
+    },
+    required: ["entries"],
+};
+const prospeoCompanyIcpSchema = {
+    type: "object",
+    description: "Structured company ICP filter.",
+    properties: {
+        titles_include: { type: "array", items: { type: "string" } },
+        titles_exclude: { type: "array", items: { type: "string" } },
+        departments: {
+            type: "object",
+            properties: {
+                include: { type: "array", items: { type: "string" } },
+                other: { type: "array", items: { type: "string" } },
+                match_mode: { type: "string", enum: ["ANY", "ALL"] },
+            },
+        },
+        company_sizes: {
+            type: "array",
+            items: {
+                type: "string",
+                enum: ["micro", "smb", "midmarket", "enterprise", "large_enterprise"],
+            },
+        },
+        industries: { type: "array", items: { type: "string" } },
+        geographic_markets: { type: "array", items: { type: "string" } },
+        geographic_scope: { type: "string" },
+    },
+};
+const prospeoCompanyWebsiteTrafficSchema = {
+    type: "object",
+    description: "Experimental website traffic filter. Availability may vary by Prospeo account/API policy.",
+    properties: {
+        min_monthly_visits: { type: "number" },
+        max_monthly_visits: { type: "number" },
+        visit_change: { type: "string", enum: ["increased", "decreased", "stable"] },
+        top_countries: { type: "array", items: { type: "string" } },
+        min_country_percentage: { type: "number" },
+        max_country_percentage: { type: "number" },
+    },
+};
+const prospeoCompanyKeyExecsSchema = {
+    type: "object",
+    description: "Experimental key executive change filter. Availability may vary by Prospeo account/API policy.",
+    properties: {
+        event_types: {
+            type: "array",
+            items: {
+                type: "string",
+                enum: [
+                    "CEO Appointed",
+                    "CFO Appointed",
+                    "CTO Appointed",
+                    "CMO Appointed",
+                    "CRO Appointed",
+                    "COO Appointed",
+                    "VP of Sales Appointed",
+                    "VP of Marketing Appointed",
+                    "VP of Product Appointed",
+                ],
+            },
+        },
+        timeframe_days: { type: "number", enum: [90, 180, 365] },
+    },
+};
+const prospeoCompanyAccountWorkflowGuidance = `Company account workflow: search_prospeo_companies -> confirm_prospeo_company_accounts -> search_prospeo. Example: find companies like Red Rover that use AI and have an API:
+search_prospeo_companies({
+  "seedDomains": ["tryredrover.com"],
+  "filters": {
+    "company_lookalike": { "company_oids": ["cmp_red_rover"], "minimum_tier": "T1" },
+    "company_attributes": { "uses_ai": true, "has_api": true, "pricing": true },
+    "company_website_search": {
+      "include_keywords": ["pricing"],
+      "has_developer_docs_page": true,
+      "has_security_page": true
+    }
+  }
+})
+For accounts in the news: { "company_news": { "categories": ["Funding & Investment"], "timeframe_days": 90 } }.
+For awards: { "company_awards": { "include": ["G2"], "match_mode": "CONTAINS" } }.
+For website traffic: { "company_website_traffic": { "min_monthly_visits": 50000 } }.
+For products/services, integrations, key customers, and Google discovery use "company_products_services", "company_integrations", "company_key_customers", and "company_google_discovery".
+For headcount by location: { "company_headcount_by_location": { "entries": [{ "country": "United States", "city": "Austin", "min_headcount": 10 }] } }.
+For structured ICP: { "company_icp": { "titles_include": ["Head of RevOps"], "company_sizes": ["midmarket"], "departments": { "include": ["Sales"], "match_mode": "ANY" } } }.
+company_intent is unsupported; support-channel AI Attribute guesses like phone/email/chat/ticket/social are not exposed. public API rows do not include lookalike tier/score/reason.`;
 function loadSignalDiscoveryConfig() {
     if (!existsSync(signalProviderConfigPath)) {
         return defaultSignalDiscoveryConfig;
@@ -1200,9 +1419,139 @@ export const leadToolDefinitions = [
             required: [],
         },
     },
+    {
+        name: "search_prospeo_companies",
+        description: 'Search Prospeo for company/account results through the public /search-company lane. Requires get_provider_prompt({ provider: "prospeo" }) first. Use this first for company lookalike/account asks such as "find companies like Red Rover that use AI and have an API", "find founders at companies like our best customers", or "find accounts in the news about funding or partnerships". Results are accounts, not finished people leads. Review the returned accounts with the user, then call confirm_prospeo_company_accounts with the companySearchToken to create a domainFilterId before using search_prospeo for people at those accounts. Supports company lookalike, confirmed AI Attributes including pricing, company news, awards, website search, products/services, integrations, key customers, operating languages, Google discovery, headcount by location, structured company ICP, and experimental website traffic/key executive filters. company_intent and support-channel guesses like phone/email/chat/ticket/social are unsupported. Public API rows do not include lookalike tier/score/reason. ' +
+            prospeoCompanyAccountWorkflowGuidance,
+        inputSchema: {
+            type: "object",
+            properties: {
+                campaignOfferId: {
+                    type: "string",
+                    description: "Campaign offer ID to associate the account discovery with.",
+                },
+                seedCompanies: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Company names to resolve into Prospeo company IDs before applying company_lookalike.",
+                },
+                seedDomains: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Company domains to resolve into Prospeo company IDs before applying company_lookalike.",
+                },
+                filters: {
+                    type: "object",
+                    description: 'Company/account filters. For lookalikes, use company_lookalike.company_oids when you already have Prospeo IDs; otherwise pass seedCompanies/seedDomains and the backend resolves IDs. minimum_tier must be "T1", "T2", or "T3". Do not use company_intent.',
+                    properties: {
+                        company_industry: prospeoFilterValueSchema,
+                        company_technology: prospeoFilterValueSchema,
+                        company_email_provider: { type: "array", items: { type: "string" } },
+                        company_naics: prospeoFilterValueSchema,
+                        company_sics: prospeoFilterValueSchema,
+                        company_headcount_range: {
+                            type: "array",
+                            items: { type: "string" },
+                        },
+                        company_headcount_custom: prospeoRangeFilterSchema,
+                        company_location_search: prospeoFilterValueSchema,
+                        company_type: { type: "string" },
+                        company_funding: prospeoFundingFilterSchema,
+                        company_keywords: prospeoCompanyKeywordsSchema,
+                        company_attributes: prospeoCompanyAttributesSchema,
+                        company_lookalike: prospeoCompanyLookalikeSchema,
+                        company_news: prospeoCompanyNewsSchema,
+                        company_awards: prospeoCompanyAwardsSchema,
+                        company_website_search: prospeoCompanyWebsiteSearchSchema,
+                        company_products_services: prospeoCompanyProductsServicesSchema,
+                        company_integrations: prospeoCompanySimpleIncludeExcludeSchema,
+                        company_key_customers: prospeoCompanyIncludeOnlySchema,
+                        company_operating_languages: prospeoCompanyIncludeOnlySchema,
+                        company_google_discovery: prospeoCompanyGoogleDiscoverySchema,
+                        company_headcount_by_location: prospeoCompanyHeadcountByLocationSchema,
+                        company_icp: prospeoCompanyIcpSchema,
+                        company_website_traffic: prospeoCompanyWebsiteTrafficSchema,
+                        company_key_execs: prospeoCompanyKeyExecsSchema,
+                        company_revenue: prospeoCompanyRevenueSchema,
+                        company_founded: prospeoCompanyFoundedSchema,
+                        company_headcount_growth: prospeoCompanyHeadcountGrowthSchema,
+                        company_job_posting_hiring_for: {
+                            type: "array",
+                            items: { type: "string" },
+                        },
+                        company_job_posting_quantity: prospeoRangeFilterSchema,
+                        company_headcount_by_department: {
+                            type: "array",
+                            items: prospeoCompanyHeadcountByDepartmentSchema,
+                        },
+                    },
+                },
+                limit: {
+                    type: "number",
+                    description: "Max compact account rows to return (default 25, max 100).",
+                },
+                page: {
+                    type: "number",
+                    description: "Page number (default 1).",
+                },
+                sort: {
+                    type: "string",
+                    description: "Optional requested sort label. Backend may ignore unsupported sort modes.",
+                },
+                previewOnly: {
+                    type: "boolean",
+                    description: "Optional hint that this is only account discovery; results are accounts either way.",
+                },
+                currentStep: {
+                    type: ["string", "null"],
+                    description: "Headless workflow step ID.",
+                },
+                confirmed: {
+                    type: "boolean",
+                    description: "Set true after user approval when interaction mode requires confirmation for search.",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "confirm_prospeo_company_accounts",
+        description: "Convert approved Prospeo company account results into a domainFilterId for a follow-on search_prospeo people search. Requires the signed companySearchToken returned by search_prospeo_companies and selectedCompanyIds from that token. Do not submit raw account rows or raw domains as Prospeo-sourced provenance. This does not create people leads directly; it creates the generated-account equivalent of save_domain_filters and returns the next recommended search_prospeo call.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                campaignOfferId: {
+                    type: "string",
+                    description: "Campaign offer ID. Must match the token campaign when the token is campaign-scoped.",
+                },
+                companySearchToken: {
+                    type: "string",
+                    description: "Signed token returned by search_prospeo_companies. Required.",
+                },
+                selectedCompanyIds: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Prospeo company IDs selected from the token-bound account results.",
+                },
+                name: {
+                    type: "string",
+                    description: "Optional saved domain filter name.",
+                },
+                currentStep: {
+                    type: ["string", "null"],
+                    description: "Headless workflow step ID.",
+                },
+                confirmed: {
+                    type: "boolean",
+                    description: "Set true after user approval when interaction mode requires confirmation.",
+                },
+            },
+            required: ["companySearchToken", "selectedCompanyIds"],
+        },
+    },
     {
         name: "search_prospeo",
-        description: 'Search Prospeo for people using filters and optional domainFilterId. Requires get_provider_prompt({ provider: "prospeo" }) first. Use Prospeo first for hiring-led targeting because it supports company_job_posting_hiring_for and company_job_posting_quantity; Sales Nav does not filter companies by hiring role. When targeting known accounts, call load_csv_domains for CSV-on-disk workflows or save_domain_filters for pasted/raw domain lists, then pass domainFilterId. Raw domain inputs and company-name targeting are NOT supported in this MCP tool. Strategy: start with 2-3 high-signal filters (title/seniority + industry or domainFilterId + headcount), add job-posting filters for hiring-led campaigns, then tighten one filter at a time. For security, AppSec, SOC, RevOps, Demand Gen, and similar function-specific lanes, do not widen with bare seniority labels like "Head" or "Director" alone; pair them with explicit function-title keywords and inspect the sample for off-function `Head of X` leakage. Prefer person location over company HQ unless HQ is explicitly needed. `campaignOfferId` routing rule: OMIT campaignOfferId ONLY in pre-mint Phase 84 `find leads` discovery mode (validating ICP before the commit gate). In every other context — post-mint lead additions, operator-driven searches on a live campaign, any search where the intent is to persist results to a specific campaign — you MUST pass campaignOfferId so the search shows up in that campaign\'s Contact Search panel. Post-mint create-campaign-v2 watch runs MUST pass currentStep: "prospeo". Omitting campaignOfferId post-mint orphans the search from the UI. Returns normalized results with pagination.',
+        description: 'Search Prospeo for people using filters and optional domainFilterId. Requires get_provider_prompt({ provider: "prospeo" }) first. Use Prospeo first for hiring-led targeting because it supports company_job_posting_hiring_for and company_job_posting_quantity; Sales Nav does not filter companies by hiring role. When targeting known accounts, call load_csv_domains for CSV-on-disk workflows or save_domain_filters for pasted/raw domain lists, then pass domainFilterId. For company lookalike/account asks, call search_prospeo_companies first, review accounts, then confirm_prospeo_company_accounts to create a domainFilterId before using search_prospeo for people. Raw domain inputs and company-name targeting are NOT supported in this MCP tool. Strategy: start with 2-3 high-signal filters (title/seniority + industry or domainFilterId + headcount), add job-posting filters for hiring-led campaigns, then tighten one filter at a time. For security, AppSec, SOC, RevOps, Demand Gen, and similar function-specific lanes, do not widen with bare seniority labels like "Head" or "Director" alone; pair them with explicit function-title keywords and inspect the sample for off-function `Head of X` leakage. Prefer person location over company HQ unless HQ is explicitly needed. `campaignOfferId` routing rule: OMIT campaignOfferId ONLY in pre-mint Phase 84 `find leads` discovery mode (validating ICP before the commit gate). In every other context — post-mint lead additions, operator-driven searches on a live campaign, any search where the intent is to persist results to a specific campaign — you MUST pass campaignOfferId so the search shows up in that campaign\'s Contact Search panel. Post-mint create-campaign-v2 watch runs MUST pass currentStep: "prospeo". Omitting campaignOfferId post-mint orphans the search from the UI. Returns normalized results with pagination.',
         inputSchema: {
             type: "object",
             properties: {
@@ -1263,6 +1612,19 @@ export const leadToolDefinitions = [
                         },
                         company_keywords: prospeoCompanyKeywordsSchema,
                         company_attributes: prospeoCompanyAttributesSchema,
+                        company_lookalike: prospeoCompanyLookalikeSchema,
+                        company_news: prospeoCompanyNewsSchema,
+                        company_awards: prospeoCompanyAwardsSchema,
+                        company_website_search: prospeoCompanyWebsiteSearchSchema,
+                        company_products_services: prospeoCompanyProductsServicesSchema,
+                        company_integrations: prospeoCompanySimpleIncludeExcludeSchema,
+                        company_key_customers: prospeoCompanyIncludeOnlySchema,
+                        company_operating_languages: prospeoCompanyIncludeOnlySchema,
+                        company_google_discovery: prospeoCompanyGoogleDiscoverySchema,
+                        company_headcount_by_location: prospeoCompanyHeadcountByLocationSchema,
+                        company_icp: prospeoCompanyIcpSchema,
+                        company_website_traffic: prospeoCompanyWebsiteTrafficSchema,
+                        company_key_execs: prospeoCompanyKeyExecsSchema,
                         company_revenue: prospeoCompanyRevenueSchema,
                         company_founded: prospeoCompanyFoundedSchema,
                         company_headcount_growth: prospeoCompanyHeadcountGrowthSchema,
@@ -1903,6 +2265,150 @@ function normalizeSalesNavFilters(filters) {
         }
     });
 }
+export async function searchProspeoCompanies(input) {
+    if (input?.campaignOfferId) {
+        assertInteractionApproval({
+            campaignId: input.campaignOfferId,
+            action: "provider-search",
+            confirmed: input.confirmed,
+        });
+    }
+    assertProviderPromptLoaded({
+        provider: "prospeo",
+        campaignOfferId: input?.campaignOfferId,
+    });
+    const api = getApi();
+    const response = await api.post("/api/v3/prospeo/company-search", removeUndefinedValues({
+        campaignOfferId: input?.campaignOfferId,
+        seedCompanies: input?.seedCompanies,
+        seedDomains: input?.seedDomains,
+        filters: input?.filters ?? {},
+        limit: input?.limit,
+        page: input?.page,
+        sort: input?.sort,
+    }));
+    return compactProspeoCompanySearchResponse(response);
+}
+export async function confirmProspeoCompanyAccounts(input) {
+    if (!input?.companySearchToken) {
+        throw new Error("confirm_prospeo_company_accounts requires companySearchToken from search_prospeo_companies.");
+    }
+    if (!input.selectedCompanyIds || input.selectedCompanyIds.length === 0) {
+        throw new Error("confirm_prospeo_company_accounts requires selectedCompanyIds from search_prospeo_companies results.");
+    }
+    const rawInput = input;
+    if ("accounts" in rawInput || "domains" in rawInput) {
+        throw new Error("confirm_prospeo_company_accounts does not accept raw account rows or domains. Use companySearchToken and selectedCompanyIds.");
+    }
+    if (input?.campaignOfferId) {
+        assertInteractionApproval({
+            campaignId: input.campaignOfferId,
+            action: "provider-search",
+            confirmed: input.confirmed,
+        });
+    }
+    assertProviderPromptLoaded({
+        provider: "prospeo",
+        campaignOfferId: input?.campaignOfferId,
+    });
+    const api = getApi();
+    const response = await api.post("/api/v3/prospeo/company-search/confirm-domain-filter", removeUndefinedValues({
+        campaignOfferId: input?.campaignOfferId,
+        companySearchToken: input.companySearchToken,
+        selectedCompanyIds: input.selectedCompanyIds,
+        name: input.name,
+    }));
+    return compactProspeoCompanyAccountConfirmationResponse(response);
+}
+function removeUndefinedValues(input) {
+    return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined));
+}
+function compactProspeoCompanySearchResponse(response) {
+    if (!response || typeof response !== "object") {
+        return response;
+    }
+    const accountResults = Array.isArray(response.accounts)
+        ? response.accounts
+        : [];
+    const sampleResults = accountResults
+        .slice(0, 10)
+        .map(compactProspeoCompanyAccount);
+    return {
+        success: response.success ?? true,
+        totalCount: typeof response.totalCount === "number"
+            ? response.totalCount
+            : accountResults.length,
+        currentPage: response.currentPage ?? null,
+        totalPages: response.totalPages ?? null,
+        accounts: {
+            count: accountResults.length,
+            sampleCount: sampleResults.length,
+            results: sampleResults,
+        },
+        seedProvenance: response.seedProvenance ?? {
+            resolved: [],
+            unresolved: [],
+            ambiguous: [],
+        },
+        requestedFilters: response.normalizedFilters ?? response.filters ?? {},
+        warnings: Array.isArray(response.warnings) ? response.warnings : [],
+        companySearchToken: response.companySearchToken ?? null,
+        nextStep: "Review accounts, then call confirm_prospeo_company_accounts with companySearchToken and selectedCompanyIds. These accounts are not people leads yet.",
+    };
+}
+function compactProspeoCompanyAccount(account) {
+    const compact = {
+        companyId: account?.companyId ?? account?.company_id ?? null,
+        name: account?.name ?? null,
+        domain: account?.domain ?? null,
+        website: account?.website ?? null,
+        industry: account?.industry ?? null,
+        employeeCount: typeof account?.employeeCount === "number"
+            ? account.employeeCount
+            : typeof account?.employee_count === "number"
+                ? account.employee_count
+                : null,
+        employeeRange: account?.employeeRange ?? account?.employee_range ?? null,
+        sourceRank: typeof account?.sourceRank === "number"
+            ? account.sourceRank
+            : typeof account?.rank === "number"
+                ? account.rank
+                : null,
+    };
+    if (account?.seedMatch !== undefined) {
+        compact.seedMatch = account.seedMatch;
+    }
+    if (account?.provenance !== undefined) {
+        compact.provenance = account.provenance;
+    }
+    return compact;
+}
+function compactProspeoCompanyAccountConfirmationResponse(response) {
+    if (!response || typeof response !== "object") {
+        return response;
+    }
+    return {
+        success: response.success ?? true,
+        domainFilterId: response.domainFilterId ?? null,
+        includedDomainCount: response.includedDomainCount ?? null,
+        skippedDomainCount: response.skippedDomainCount ?? null,
+        includeDomains: Array.isArray(response.includeDomains)
+            ? response.includeDomains
+            : [],
+        skippedAccounts: Array.isArray(response.skippedAccounts)
+            ? response.skippedAccounts
+            : [],
+        provenance: response.provenance ?? null,
+        nextSearchProspeoCall: {
+            tool: "search_prospeo",
+            args: response.nextSearchProspeoCall ?? {
+                campaignOfferId: response.campaignOfferId,
+                domainFilterId: response.domainFilterId,
+                filters: { max_person_per_company: 1 },
+            },
+        },
+    };
+}
 export async function searchProspeo(input) {
     if (input?.campaignOfferId) {
         assertInteractionApproval({
@@ -1918,13 +2424,13 @@ export async function searchProspeo(input) {
     const api = getApi();
     const rawInput = input;
     if ("domains" in rawInput) {
-        throw new Error("search_prospeo does not accept raw domains. Use save_domain_filters and pass domainFilterId.");
+        throw new Error("search_prospeo does not accept raw domains. Use load_csv_domains or save_domain_filters for known domain lists. For generated company/account lookalikes, use search_prospeo_companies, then confirm_prospeo_company_accounts, then pass the returned domainFilterId.");
     }
     const nestedCompany = input?.filters
         ?.company;
     if (nestedCompany?.websites !== undefined ||
         nestedCompany?.names !== undefined) {
-        throw new Error("search_prospeo does not accept filters.company.websites or filters.company.names. Resolve names to domains, then use save_domain_filters and pass domainFilterId.");
+        throw new Error("search_prospeo does not accept filters.company.websites or filters.company.names. For known accounts, resolve names/domains into a domainFilterId with load_csv_domains or save_domain_filters. For company/account lookalikes, use search_prospeo_companies first, then confirm_prospeo_company_accounts.");
     }
     const response = await api.post(`/api/v3/prospeo/search`, input);
     return compactProspeoSearchResponse(response);