@leadbay/mcp 0.38.2 → 0.39.1

package/dist/bin.js

@@ -1369,12 +1369,12 @@ var init_ws_client = __esm({
           this.pingTimer = setInterval(() => this.sendPing(), PING_INTERVAL_MS);
         });
         ws.addEventListener("message", (ev) => {
-          const text2 = typeof ev.data === "string" ? ev.data : String(ev.data ?? "");
-          if (!text2)
+          const text3 = typeof ev.data === "string" ? ev.data : String(ev.data ?? "");
+          if (!text3)
             return;
           let msg;
           try {
-            msg = JSON.parse(text2);
+            msg = JSON.parse(text3);
           } catch {
             this.logger?.warn?.("notifications.ws non_json_frame");
             return;
@@ -2843,7 +2843,7 @@ measured:
    \`employees_max: number\`. FLAT numbers \u2014 nested \`employees: {min, max}\`
    exists only in RESULT payloads. \`example_lead.employees\` does not filter.
    \`locations\` take city/state/region names ("Dallas, TX", "\xCEle-de-France");
-   a country name is refused in code \u2014 whole-country intent = omit it.
+   never a country: this workspace's own is dropped, any other is refused.
 7. **Prefer \`example_lead\` over \`query\`.** Query matches topic *vocabulary*:
    "gyms that need durable flooring" surfaced flooring VENDORS, 0 delivered.
    Use \`query\` only for signal an example can't express.
@@ -3913,8 +3913,31 @@ server-side: past the 30-min wall clock a job reads \`completed_partial\`
 delivered leads via leadbay_qualify_leads \`prior_deliveries\`). A 404 means
 unknown job or another org's job.
 
+\`compact: true\` (pass it whenever \`next_poll\` carries it) returns the rows of
+a free identity pass, 100 at a time from \`offset\`, instead of leads.
+
 ---
 
+## RENDERING \u2014 identity pass (\`rows[]\`)
+
+\`rows[]\` replaces \`leads[]\`: one row per company, in the user's order. One
+table: **Company** (\`input\`, plus \`name\` when it differs) \xB7 **Website** \xB7
+**LinkedIn**. Skipped rows stay in it: \`not_in_universe\` \u2192 "not in Leadbay",
+\`low_confidence_identity\` \u2192 "several matches \u2014 add a city or website".
+
+Then ONE coverage line from \`summary\`: found \`resolved\` of \`rows_total\` \xB7
+\`with_website\` with a website \xB7 \`with_linkedin\` with a LinkedIn \xB7
+\`ambiguous\` unclear \xB7 \`not_found\` not found. When most rows lack what the
+user asked for, that line is the answer: say so, and do not look the
+missing ones up one by one.
+
+Done job with \`next_poll.offset\`: say "showing N of \`rows_total\`" and offer
+the rest via \`leadbay_lead_job_status(job_id, compact: true, offset)\`.
+
+\`file\` set (local install only): every row is saved there as a CSV. Give the
+user that path.
+
+
 ## RENDERING \u2014 delivery table + honest funnel line
 
 Render delivered leads (\`leads[]\`, i.e. items with status \`delivered\` or
@@ -5157,13 +5180,14 @@ This tool MUTATES state. The caller (agent or human-in-the-loop) is responsible
 `;
     leadbay_qualify_leads = `## WHEN TO USE
 
-Trigger phrases: "qualify these companies", "vet this list", "which of these fit our ICP", "score these websites / accounts", "get me the right contact at these companies", "re-qualify what you delivered last week".
+Trigger phrases: "for each of these companies, give me the website / LinkedIn", "qualify these companies", "vet this list", "which of these fit our ICP", "score these websites / accounts", "get me the right contact at these companies", "re-qualify what you delivered last week".
 
 Do NOT use for: "find me new leads / companies that <profile>" \u2192 \`leadbay_find_new_leads\`; "qualify the top N of my lens batch" \u2192 \`leadbay_bulk_qualify_leads\`; "import this CSV file" \u2192 \`leadbay_import_leads\`; "tell me about <one company> in depth" \u2192 \`leadbay_research_lead_by_name_fuzzy\`; "add emails to the contacts I selected" \u2192 \`leadbay_enrich_titles\`.
 
 Prefer when: the user points at SPECIFIC companies (ids, websites, names, a pasted list, "what you found yesterday") and wants fit verdicts and/or the right person to talk to.
 
 Examples that SHOULD invoke this tool:
+- "For each of these 300 brokers, give me the website and LinkedIn, nothing else."
 - "Here are 60 restaurant websites from my Austin sweep \u2014 which fit, and who's the owner?"
 - "Re-qualify last week's delivery and get phone numbers for the good ones."
 - "Vet these 12 accounts from my spreadsheet against our criteria."
@@ -5175,7 +5199,8 @@ Examples that should NOT invoke this tool (sound similar, route elsewhere):
 
 ## RENDER (quick)
 
-3-col table for delivered items (fit bar + company / why-fits \u226420 words /
+Identity pass (\`rows[]\`): one table Company / Website / LinkedIn, then the
+coverage line. Otherwise a 3-col table for delivered items (fit bar + company / why-fits \u226420 words /
 contact + channels) in returned order, then a compact Ref \u2192 Outcome table
 for skipped refs (not_in_universe, low_confidence_identity, ... in plain
 words), then the honest funnel line. Full algorithm below.
@@ -5190,6 +5215,14 @@ when asked \u2014 enriched with verified channels. Answers arrive per-item from
 job; this tool polls up to \`wait_seconds\` (default 45) and hands off to
 \`leadbay_lead_job_status\` when the batch needs longer.
 
+**A list of companies is ONE call, never a loop** of
+\`leadbay_research_lead_by_name_fuzzy\`: "for each of these companies give me
+X", a pasted list, a file. Identity only (in Leadbay or not, website,
+LinkedIn) \u2192 \`qualify: false\`: free, no \`confirm\`, returns \`rows[]\` and
+coverage counts. A fit question over the list ("which of these do
+factoring") keeps \`qualify: true\` and its quote. Over 500: one call per 500,
+each with its own \`request_id\`.
+
 **Refs are flexible; outcomes are per-item.** \`lead_refs\` accepts any mix of
 \`lead_id\`, \`website\`, \`name\`(+\`location\`), or a stable \`contact_id\` from a
 prior result (enrichment then targets exactly that person, never a re-match).
@@ -5226,6 +5259,26 @@ Retry-After beyond \u2014 wait, don't hammer), 30-min job wall clock.
 
 ---
 
+## RENDERING \u2014 identity pass (\`rows[]\`)
+
+\`rows[]\` replaces \`leads[]\`: one row per company, in the user's order. One
+table: **Company** (\`input\`, plus \`name\` when it differs) \xB7 **Website** \xB7
+**LinkedIn**. Skipped rows stay in it: \`not_in_universe\` \u2192 "not in Leadbay",
+\`low_confidence_identity\` \u2192 "several matches \u2014 add a city or website".
+
+Then ONE coverage line from \`summary\`: found \`resolved\` of \`rows_total\` \xB7
+\`with_website\` with a website \xB7 \`with_linkedin\` with a LinkedIn \xB7
+\`ambiguous\` unclear \xB7 \`not_found\` not found. When most rows lack what the
+user asked for, that line is the answer: say so, and do not look the
+missing ones up one by one.
+
+Done job with \`next_poll.offset\`: say "showing N of \`rows_total\`" and offer
+the rest via \`leadbay_lead_job_status(job_id, compact: true, offset)\`.
+
+\`file\` set (local install only): every row is saved there as a CSV. Give the
+user that path.
+
+
 ## RENDERING \u2014 delivery table + honest funnel line
 
 Render delivered leads (\`leads[]\`, i.e. items with status \`delivered\` or
@@ -5380,6 +5433,8 @@ Pick the 2-3 options that match what actually happened:
 | Items skipped \`low_confidence_identity\` | "Pick the right match" (show \`resolution.alternatives\`) | leadbay_qualify_leads with the chosen lead_id |
 | Contacts delivered without channels | "Get verified emails/phones for the keepers (uses quota \u2014 say so first)" | leadbay_qualify_leads(lead_refs with contact_id, channels) |
 | Disqualified with evidence | "Review why \u2014 adjust qualification questions if the criteria are off" | leadbay_get_qualification_questions |
+| Identity pass, list over 500 | "Run the next 500" | leadbay_qualify_leads(next 500, qualify: false) |
+| Identity pass, \`summary.without_website\` > 0. LAST option, never run unasked | "N have no website in Leadbay. Web research can look for one. It uses your plan's quota and may find none." | leadbay_qualify_leads(lead_refs: [{lead_id}] of rows without website, qualify: true) \u2192 quote first, confirm on the user's yes |
 `;
     leadbay_qualify_status = `Retrieve the current state of a bulk_qualify_leads or import_and_qualify launch. Which ids to pass depends on which tool launched it, because only one of them creates a qualification job on the backend:
 
@@ -5858,9 +5913,9 @@ out?"\`
 
 Trigger phrases: "look up <Company>", "research <Company>", "what do we know about <Company>".
 
-Do NOT use for: "picked row with leadId" \u2192 \`leadbay_research_lead_by_id\`; "draft outreach for <Contact>" \u2192 \`leadbay_prepare_outreach\`.
+Do NOT use for: "picked row with leadId" \u2192 \`leadbay_research_lead_by_id\`; "draft outreach for <Contact>" \u2192 \`leadbay_prepare_outreach\`; "for each of these companies\u2026" \u2192 \`leadbay_qualify_leads\`.
 
-Prefer when: a company name or domain in prose, no Leadbay id yet \u2014 always pass \`website\` if a domain was mentioned
+Prefer when: ONE company name or domain in prose, no Leadbay id yet \u2014 always pass \`website\` if a domain was mentioned
 
 Examples that SHOULD invoke this tool:
 - "Look up Acme Corp for me."
@@ -5870,7 +5925,7 @@ Examples that SHOULD invoke this tool:
 Examples that should NOT invoke this tool (sound similar, route elsewhere):
 - "Tell me about that lead I just picked."
 - "Draft outreach to Acme's CTO."
-- "Show me today's leads."
+- "Websites and LinkedIn for these 200 companies."
 
 ---
 
@@ -5884,15 +5939,13 @@ list" into an answer. With only a contact email, pass \`email\`: the company
 domain is derived from it, consumer mailboxes ignored.
 
 When the registry cannot pick one company it returns \`{resolution:
-"ambiguous", query, candidates:[{leadId, name, website, location, \u2026}]}\`
-instead of a card. Ask which one; never guess from \`score\`.
+"ambiguous", query, candidates:[\u2026]}\` instead of a card. Ask which one; never
+guess from \`score\`.
 
 \`LEAD_NOT_FOUND\` is not a dead end: its hint names the field that would have
 found it \u2014 \`website\` or \`registry_number\`, both params. Ask for it and call
 again. Do not offer an import before asking.
 
-Offer \`_meta.match_candidates\` when present.
-
 ---
 
 ## RENDERING \u2014 single-record research card, mode-adaptive
@@ -7199,7 +7252,7 @@ measured:
    \`employees_max: number\`. FLAT numbers \u2014 nested \`employees: {min, max}\`
    exists only in RESULT payloads. \`example_lead.employees\` does not filter.
    \`locations\` take city/state/region names ("Dallas, TX", "\xCEle-de-France");
-   a country name is refused in code \u2014 whole-country intent = omit it.
+   never a country: this workspace's own is dropped, any other is refused.
 7. **Prefer \`example_lead\` over \`query\`.** Query matches topic *vocabulary*:
    "gyms that need durable flooring" surfaced flooring VENDORS, 0 delivered.
    Use \`query\` only for signal an example can't express.
@@ -7665,12 +7718,28 @@ var init_list_lenses = __esm({
   }
 });
 
+// ../core/dist/interactions.js
+function reportLeadInteractions(client, lensId, leadIds, types, logger) {
+  if (leadIds.length === 0 || types.length === 0)
+    return;
+  const events = leadIds.flatMap((leadId) => types.map((type) => ({ type, lead_id: leadId, lens_id: String(lensId) })));
+  void client.request("POST", "/interactions", events).catch((err) => {
+    logger?.warn?.(`interactions: ${types.join("+")} for ${leadIds.length} lead(s) not recorded: ${err?.message ?? err?.code ?? err}`);
+  });
+}
+var init_interactions = __esm({
+  "../core/dist/interactions.js"() {
+    "use strict";
+  }
+});
+
 // ../core/dist/tools/discover-leads.js
 var discoverLeads;
 var init_discover_leads = __esm({
   "../core/dist/tools/discover-leads.js"() {
     "use strict";
     init_tool_descriptions_generated();
+    init_interactions();
     discoverLeads = {
       name: "leadbay_discover_leads",
       annotations: {
@@ -7699,11 +7768,12 @@ var init_discover_leads = __esm({
         },
         additionalProperties: false
       },
-      execute: async (client, params) => {
+      execute: async (client, params, ctx) => {
         const lensId = params.lensId ?? await client.resolveDefaultLens();
         const page = params.page ?? 0;
         const count = Math.min(params.count ?? 20, 50);
         const res = await client.request("GET", `/lenses/${lensId}/leads/wishlist?count=${count}&page=${page}&contacts=true`);
+        reportLeadInteractions(client, lensId, res.items.map((lead) => lead.id), ["LEAD_SEEN"], ctx?.logger);
         const totalPages = res.pagination?.pages ?? 0;
         const currentPage = res.pagination?.page ?? page;
         const hasMore = currentPage < totalPages - 1;
@@ -7752,6 +7822,7 @@ var init_get_lead_profile = __esm({
   "../core/dist/tools/get-lead-profile.js"() {
     "use strict";
     init_tool_descriptions_generated();
+    init_interactions();
     getLeadProfile = {
       name: "leadbay_get_lead_profile",
       annotations: {
@@ -7799,13 +7870,9 @@ var init_get_lead_profile = __esm({
         },
         required: ["lead", "contacts"]
       },
-      execute: async (client, params) => {
+      execute: async (client, params, ctx) => {
         const lensId = params.lensId ?? await client.resolveDefaultLens();
-        void client.request("POST", "/interactions", [
-          { type: "LEAD_SEEN", leadId: params.leadId, lensId: String(lensId) },
-          { type: "LEAD_CLICKED", leadId: params.leadId, lensId: String(lensId) }
-        ]).catch(() => {
-        });
+        reportLeadInteractions(client, lensId, [params.leadId], ["LEAD_SEEN", "LEAD_CLICKED"], ctx?.logger);
         const [leadResult, qualResult, contactsResult, paidContactsResult, webFetchResult] = await Promise.allSettled([
           client.request("GET", `/lenses/${lensId}/leads/${params.leadId}`),
           client.request("GET", `/leads/${params.leadId}/ai_agent_responses`),
@@ -14238,6 +14305,7 @@ var init_pull_leads = __esm({
   "../core/dist/composite/pull-leads.js"() {
     "use strict";
     init_lead_order();
+    init_interactions();
     init_empty_lens_reason();
     init_tool_descriptions_generated();
     pullLeads = {
@@ -14376,6 +14444,9 @@ var init_pull_leads = __esm({
           return resolvedOrder.error;
         const orderQs = resolvedOrder.order ? `&order=${encodeURIComponent(resolvedOrder.order)}` : "";
         const res = await client.request("GET", `/lenses/${lensId}/leads/wishlist?count=${count}&page=${page}&contacts=true${orderQs}`);
+        if (params._reportSeen !== false) {
+          reportLeadInteractions(client, lensId, res.items.map((lead) => lead.id), ["LEAD_SEEN"], ctx?.logger);
+        }
         const summaries = await Promise.all(res.items.map(async (lead) => {
           try {
             const r = await client.request("GET", `/leads/${lead.id}/ai_agent_responses`);
@@ -14469,12 +14540,12 @@ var init_pull_leads = __esm({
 });
 
 // ../core/dist/composite/_geo-helpers.js
-function expandAlias(text2) {
-  const key = text2.trim().toLowerCase();
-  return CITY_ALIASES[key] ?? text2;
+function expandAlias(text3) {
+  const key = text3.trim().toLowerCase();
+  return CITY_ALIASES[key] ?? text3;
 }
-function scoreMatch(text2, match) {
-  const t = text2.trim().toLowerCase();
+function scoreMatch(text3, match) {
+  const t = text3.trim().toLowerCase();
   const n = match.name.trim().toLowerCase();
   if (n === t)
     return 1;
@@ -14497,8 +14568,8 @@ async function resolveLocations(client, texts) {
   const resolved = [...direct];
   const ambiguities = [];
   for (const originalText of free) {
-    const text2 = expandAlias(originalText);
-    const path = `/geo/search?q=${encodeURIComponent(text2)}`;
+    const text3 = expandAlias(originalText);
+    const path = `/geo/search?q=${encodeURIComponent(text3)}`;
     let response;
     try {
       response = await client.request("GET", path);
@@ -14537,7 +14608,7 @@ async function resolveLocations(client, texts) {
       name: r.name,
       country: r.country,
       level: r.level,
-      score: scoreMatch(text2, r)
+      score: scoreMatch(text3, r)
     })).sort((a, b) => {
       if (b.score !== a.score)
         return b.score - a.score;
@@ -14953,6 +15024,7 @@ var init_tour_plan = __esm({
     "use strict";
     init_pull_followups();
     init_pull_leads();
+    init_interactions();
     init_country_guard();
     init_tool_descriptions_generated();
     DEFAULT_FOLLOWUPS_COUNT = 6;
@@ -15088,7 +15160,7 @@ var init_tour_plan = __esm({
             city_id: params.city_id,
             count: followupsCount
           }, ctx),
-          pullLeads.execute(client, { count: DISCOVER_OVER_PULL }, ctx)
+          pullLeads.execute(client, { count: DISCOVER_OVER_PULL, _reportSeen: false }, ctx)
         ]);
         if (followupsResult.status === "fulfilled") {
           const r = followupsResult.value;
@@ -15124,6 +15196,10 @@ var init_tour_plan = __esm({
         }
         const filtered = rawDiscover.filter((l) => cityMatches(l, params.city));
         const discoverLeads2 = filtered.slice(0, discoverCount);
+        const pulledLensId = leadsResult.status === "fulfilled" ? leadsResult.value?.lens?.id : null;
+        if (pulledLensId != null) {
+          reportLeadInteractions(client, pulledLensId, discoverLeads2.map((l) => l.id), ["LEAD_SEEN"], ctx?.logger);
+        }
         const filterNote = params.city ? `Matched ${filtered.length}/${rawDiscover.length} Discover leads to '${params.city}'; returning top ${discoverLeads2.length}.` : `No city filter applied; returning top ${discoverLeads2.length} Discover leads.`;
         return {
           city: params.city ?? null,
@@ -15807,9 +15883,9 @@ ${firm.short_description}`);
       out.push(`### ${sec.section_emoji ?? ""} ${label}`.trim());
       const entries = Array.isArray(sec.entries) ? sec.entries : [];
       for (const e of entries.slice(0, 5)) {
-        const text2 = e.text ?? e.summary ?? JSON.stringify(e).slice(0, 200);
+        const text3 = e.text ?? e.summary ?? JSON.stringify(e).slice(0, 200);
         const hot = e.hot === true ? " \u{1F525}" : "";
-        out.push(`- ${text2}${hot}`);
+        out.push(`- ${text3}${hot}`);
       }
       if (entries.length > 5)
         out.push(`- _${entries.length - 5} more \u2026_`);
@@ -15890,6 +15966,7 @@ var init_research_lead_by_id = __esm({
   "../core/dist/composite/research-lead-by-id.js"() {
     "use strict";
     init_web_fetch_helpers();
+    init_interactions();
     init_tool_descriptions_generated();
     researchLeadById = {
       name: "leadbay_research_lead_by_id",
@@ -16134,11 +16211,7 @@ var init_research_lead_by_id = __esm({
         }
         const lensId = params.lensId ?? await client.resolveDefaultLens();
         const leadId = params.leadId;
-        void client.request("POST", "/interactions", [
-          { type: "LEAD_SEEN", leadId, lensId: String(lensId) },
-          { type: "LEAD_CLICKED", leadId, lensId: String(lensId) }
-        ]).catch(() => {
-        });
+        reportLeadInteractions(client, lensId, [leadId], ["LEAD_SEEN", "LEAD_CLICKED"], _ctx?.logger);
         const [profileR, qualR, contactsR, webFetchR, activitiesR, orgContactsR] = await Promise.allSettled([
           client.request("GET", `/lenses/${lensId}/leads/${leadId}`),
           client.request("GET", `/leads/${leadId}/ai_agent_responses`),
@@ -17181,6 +17254,7 @@ var init_get_lead_custom_fields = __esm({
   "../core/dist/composite/get-lead-custom-fields.js"() {
     "use strict";
     init_tool_descriptions_generated();
+    init_interactions();
     getLeadCustomFields = {
       name: "leadbay_get_lead_custom_fields",
       annotations: {
@@ -17224,11 +17298,7 @@ var init_get_lead_custom_fields = __esm({
       },
       execute: async (client, params, ctx) => {
         const lensId = params.lensId ?? await client.resolveDefaultLens();
-        void client.request("POST", "/interactions", [
-          { type: "LEAD_SEEN", leadId: params.leadId, lensId: String(lensId) },
-          { type: "LEAD_CLICKED", leadId: params.leadId, lensId: String(lensId) }
-        ]).catch(() => {
-        });
+        reportLeadInteractions(client, lensId, [params.leadId], ["LEAD_SEEN", "LEAD_CLICKED"], ctx?.logger);
         const lead = await client.request("GET", `/lenses/${lensId}/leads/${params.leadId}`);
         const entries = lead.custom_fields ?? [];
         const needsCatalog = entries.some((e) => !e?.field?.name);
@@ -20702,8 +20772,8 @@ function tokens(s) {
     return [];
   return s.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter(Boolean);
 }
-function bestMatches(text2, taxonomy) {
-  const want = new Set(tokens(text2));
+function bestMatches(text3, taxonomy) {
+  const want = new Set(tokens(text3));
   if (want.size === 0)
     return [];
   const ranked = taxonomy.map((s) => {
@@ -20732,12 +20802,12 @@ async function resolveSectors(client, texts, ctx) {
   }
   const resolved = [...direct];
   const ambiguities = [];
-  for (const text2 of free) {
-    const matches = bestMatches(text2, taxonomy);
+  for (const text3 of free) {
+    const matches = bestMatches(text3, taxonomy);
     if (matches.length === 1 || matches.length >= 2 && matches[0].score >= 0.66 && matches[0].score - matches[1].score >= 0.34) {
       resolved.push(matches[0].id);
     } else {
-      ambiguities.push({ sector_text: text2, matches });
+      ambiguities.push({ sector_text: text3, matches });
     }
   }
   return { resolved, ambiguities };
@@ -22066,6 +22136,7 @@ var init_find_new_leads = __esm({
   "../core/dist/composite/find-new-leads.js"() {
     "use strict";
     init_mcp_job_helpers();
+    init_country_guard();
     init_tool_descriptions_generated();
     DEFAULT_WAIT_SECONDS = 45;
     findNewLeads = {
@@ -22190,6 +22261,21 @@ var init_find_new_leads = __esm({
           "channels",
           "exclude_lead_ids"
         ]);
+        const homeCountry = detectCountryLocations(params.filters?.locations, "filters.locations", client.region).filter((hit) => hit.kind === "home_country");
+        let countryNote;
+        if (homeCountry.length > 0) {
+          const dropped = new Set(homeCountry.map((hit) => hit.value));
+          const raw = params.filters.locations;
+          const rest = (Array.isArray(raw) ? raw : [raw]).filter((v) => !dropped.has(v));
+          params = {
+            ...params,
+            filters: { ...params.filters, locations: rest.length > 0 ? rest : void 0 }
+          };
+          const removed = [...dropped].map((v) => `"${v}"`).join(", ");
+          countryNote = {
+            note: rest.length > 0 ? `Removed ${removed} from filters.locations: a country is never a location filter. The search covers ${rest.map((v) => `"${v}"`).join(", ")} only.` : `Removed ${removed} from filters.locations: this workspace holds ${homeCountry[0].country} companies only, so the search already covers all of it.`
+          };
+        }
         rejectCountryLocations(params.filters?.locations, client.region);
         rejectMalformedExclusions(params.exclude_lead_ids);
         rejectOversizedExclusions(params.exclude_lead_ids);
@@ -22267,6 +22353,7 @@ var init_find_new_leads = __esm({
           return {
             dry_run: true,
             ...forecast,
+            ...countryNote,
             region: client.region
           };
         }
@@ -22287,6 +22374,7 @@ var init_find_new_leads = __esm({
             estimated_cost: forecast?.estimated_cost ?? null,
             items_requested: forecast?.items_requested ?? null,
             hint: vetoed ? "confirm:false vetoed the run \u2014 nothing was submitted. Re-call with confirm:true to proceed, or drop qualify/channels for a free search." : "Tell the user what will run and that it uses their plan's quota (no amounts, no money), get an explicit go-ahead, then re-call with confirm:true. For a free search instead: omit qualify and channels.",
+            ...countryNote,
             region: client.region
           };
         }
@@ -22341,6 +22429,7 @@ var init_find_new_leads = __esm({
             since: snapshot.next_since ?? null,
             suggested_wait_seconds: done ? 0 : 60
           },
+          ...countryNote,
           region: client.region
         };
       }
@@ -22348,6 +22437,144 @@ var init_find_new_leads = __esm({
   }
 });
 
+// ../core/dist/composite/_identity-rows.js
+function text(v) {
+  return typeof v === "string" && v.trim() ? v.trim() : null;
+}
+function toRow(item) {
+  const asked = item.ref?.requested_as ?? {};
+  const row = {
+    input_indexes: item.ref?.input_indexes ?? null,
+    input: text(asked.name) ?? text(asked.website) ?? text(asked.lead_id) ?? text(asked.contact_id),
+    status: item.status
+  };
+  if (item.status_reason)
+    row.status_reason = item.status_reason;
+  const lead = item.lead;
+  if (!lead)
+    return row;
+  const company = lead.company ?? {};
+  row.lead_id = lead.lead_id ?? item.ref?.lead_id ?? void 0;
+  row.name = company.name;
+  row.website = text(company.website);
+  row.linkedin = text(company.socials?.linkedin);
+  return row;
+}
+function identityRows(items) {
+  const first = (i) => {
+    const idx = i.ref?.input_indexes;
+    return Array.isArray(idx) && idx.length > 0 ? Math.min(...idx) : Number.MAX_SAFE_INTEGER;
+  };
+  return [...items].sort((a, b) => first(a) - first(b) || a.seq - b.seq).map(toRow);
+}
+function identityCoverage(rows) {
+  let resolved = 0;
+  let ambiguous = 0;
+  let notFound = 0;
+  let otherSkipped = 0;
+  let withWebsite = 0;
+  let withLinkedin = 0;
+  for (const r of rows) {
+    if (r.status !== "skipped") {
+      resolved += 1;
+      if (r.website)
+        withWebsite += 1;
+      if (r.linkedin)
+        withLinkedin += 1;
+    } else if (r.status_reason === "low_confidence_identity")
+      ambiguous += 1;
+    else if (r.status_reason === "not_in_universe")
+      notFound += 1;
+    else
+      otherSkipped += 1;
+  }
+  return {
+    resolved,
+    ambiguous,
+    not_found: notFound,
+    other_skipped: otherSkipped,
+    with_website: withWebsite,
+    with_linkedin: withLinkedin,
+    without_website: resolved - withWebsite
+  };
+}
+function identityCsv(rows) {
+  return synthesizeCsv(CSV_HEADER, rows.map((r) => ({
+    row: (r.input_indexes ?? []).map((i) => i + 1).join(";"),
+    input: r.input ?? "",
+    status: r.status,
+    reason: r.status_reason ?? "",
+    company: r.name ?? "",
+    website: r.website ?? "",
+    linkedin: r.linkedin ?? "",
+    lead_id: r.lead_id ?? ""
+  })));
+}
+async function saveIdentityFile(ctx, jobId, snapshot, items) {
+  if (!ctx?.saveFile)
+    return {};
+  if (!TERMINAL_JOB_STATES.has(snapshot.job.state))
+    return {};
+  if (snapshot.items_truncated || items.length === 0)
+    return {};
+  try {
+    const name = `leadbay-companies-${jobId.slice(0, 8)}.csv`;
+    return { file: await ctx.saveFile(name, identityCsv(identityRows(items))) };
+  } catch (e) {
+    return { file_error: e instanceof Error ? e.message : String(e) };
+  }
+}
+function readOffset(v) {
+  const n = typeof v === "string" ? Number(v) : v;
+  return typeof n === "number" && Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
+}
+function identityAnswer(jobId, snapshot, items, offset) {
+  const all = identityRows(items);
+  const rows = all.slice(offset, offset + IDENTITY_ROWS_PER_RESULT);
+  const end = offset + rows.length;
+  const done = TERMINAL_JOB_STATES.has(snapshot.job.state);
+  const truncated = snapshot.items_truncated ?? false;
+  const nextOffset = !done || truncated ? 0 : end < all.length ? end : null;
+  return {
+    summary: {
+      ...identityCoverage(all),
+      stop_reason: snapshot.funnel?.stop_reason ?? null
+    },
+    rows,
+    rows_total: all.length,
+    rows_offset: offset,
+    items_truncated: truncated,
+    scope_notes: snapshot.explain?.scope_notes ?? [],
+    still_running: !done,
+    next_poll: nextOffset === null ? null : {
+      tool: "leadbay_lead_job_status",
+      job_id: jobId,
+      compact: true,
+      offset: nextOffset,
+      suggested_wait_seconds: done ? 0 : 60
+    }
+  };
+}
+var IDENTITY_ROWS_PER_RESULT, CSV_HEADER;
+var init_identity_rows = __esm({
+  "../core/dist/composite/_identity-rows.js"() {
+    "use strict";
+    init_mcp_job_helpers();
+    init_import_leads();
+    IDENTITY_ROWS_PER_RESULT = 100;
+    CSV_HEADER = [
+      "row",
+      "input",
+      "status",
+      "reason",
+      "company",
+      "website",
+      "linkedin",
+      "lead_id"
+    ];
+  }
+});
+
 // ../core/dist/composite/qualify-leads.js
 function normalizeLeadRefs(refs) {
   if (!Array.isArray(refs))
@@ -22388,7 +22615,7 @@ function rejectMalformedLeadRefs(refs) {
     hint: "Each ref is an object whose fields are STRINGS \u2014 {lead_id} | {website} | {name, location?} | {contact_id}. A bare string is accepted and reshaped; null, numbers, arrays and non-string field values are not. Fix or drop those entries and re-call."
   };
 }
-function text(value) {
+function text2(value) {
   if (typeof value !== "string")
     return null;
   const v = value.trim().toLowerCase();
@@ -22396,7 +22623,7 @@ function text(value) {
 }
 function derivedRequestId(params) {
   const refs = canonicalSet((params.lead_refs ?? []).map((r) => {
-    const website = text(r.website);
+    const website = text2(r.website);
     return [
       // UUIDs are case-insensitive to the backend, so an uppercase id and
       // its lowercase form are the same lead and must share a key.
@@ -22407,8 +22634,8 @@ function derivedRequestId(params) {
       // AND to one key. Fall back to the trimmed/lowercased raw value when
       // it is not domain-shaped, rather than dropping the field.
       website ? normalizeDomain(website) ?? website : null,
-      text(r.name),
-      text(r.location)
+      text2(r.name),
+      text2(r.location)
     ];
   }));
   const shape = {
@@ -22452,6 +22679,7 @@ var init_qualify_leads = __esm({
     "use strict";
     init_mcp_job_helpers();
     init_import_leads();
+    init_identity_rows();
     init_tool_descriptions_generated();
     DEFAULT_WAIT_SECONDS2 = 45;
     LEAD_REF_FIELDS = [
@@ -22569,6 +22797,7 @@ var init_qualify_leads = __esm({
         const buysChannels = (params.channels?.length ?? 0) > 0;
         const buysQualification = qualify !== false;
         const isPaid = buysQualification || buysChannels;
+        const identityOnly = !isPaid && (params.contact_titles?.length ?? 0) === 0 && params.prior_deliveries == null;
         const vetoed = confirm === false;
         const consented = !vetoed && confirm === true;
         const requestId = presentRequestId(params.request_id) ?? (isPaid ? derivedRequestId(params) : void 0);
@@ -22617,6 +22846,25 @@ var init_qualify_leads = __esm({
         const done = TERMINAL_JOB_STATES.has(snapshot.job.state);
         const indexed = submit.duplicate ?? false ? remapInputIndexes(snapshot.items, params.lead_refs) : { items: snapshot.items, remapped: true };
         const view = { ...snapshot, items: indexed.items };
+        if (identityOnly) {
+          const answer = identityAnswer(submit.job_id, snapshot, view.items, 0);
+          return {
+            job_id: submit.job_id,
+            request_id: requestId ?? null,
+            duplicate_submit: submit.duplicate ?? false,
+            state: snapshot.job.state,
+            done,
+            ...answer,
+            summary: {
+              refs_submitted: params.lead_refs?.length ?? 0,
+              items_requested: submit.items_requested,
+              ...answer.summary
+            },
+            input_indexes_remapped: submit.duplicate ?? false ? indexed.remapped : null,
+            ...await saveIdentityFile(ctx, submit.job_id, snapshot, view.items),
+            region: client.region
+          };
+        }
         return {
           job_id: submit.job_id,
           // Echo the key actually sent, so a retry can reuse it verbatim.
@@ -22685,6 +22933,7 @@ var init_lead_job_status = __esm({
   "../core/dist/composite/lead-job-status.js"() {
     "use strict";
     init_mcp_job_helpers();
+    init_identity_rows();
     init_tool_descriptions_generated();
     leadJobStatus = {
       name: "leadbay_lead_job_status",
@@ -22714,6 +22963,14 @@ var init_lead_job_status = __esm({
           wait_seconds: {
             type: "number",
             description: "0 (default) = instant snapshot. >0 = keep polling up to this many seconds until the job is terminal \u2014 use ~60 when the user asked to wait for results."
+          },
+          compact: {
+            type: "boolean",
+            description: "true = one row per company (name, website, LinkedIn) in the order of the user's list, plus coverage counts, instead of full leads. Pass it when next_poll carries it (a leadbay_qualify_leads identity pass). Reads the whole job; since is ignored."
+          },
+          offset: {
+            type: "number",
+            description: "With compact: the first row to return (default 0). Each result carries at most 100 rows; take the next value from next_poll.offset."
           }
         },
         required: ["job_id"],
@@ -22721,8 +22978,19 @@ var init_lead_job_status = __esm({
       },
       execute: async (client, params, ctx) => {
         const waitSeconds = clampWaitSeconds(params.wait_seconds, 0);
-        const snapshot = waitSeconds > 0 ? await waitForJob(client, params.job_id, waitSeconds, ctx, void 0, params.since, params.limit) : await collectJobSnapshot(client, params.job_id, params.since, params.limit, ctx?.signal);
+        const compact = params.compact === true || params.compact === "true";
+        const since = compact ? void 0 : params.since;
+        const snapshot = waitSeconds > 0 ? await waitForJob(client, params.job_id, waitSeconds, ctx, void 0, since, params.limit) : await collectJobSnapshot(client, params.job_id, since, params.limit, ctx?.signal);
         const done = TERMINAL_JOB_STATES.has(snapshot.job.state);
+        if (compact) {
+          return {
+            job_id: params.job_id,
+            state: snapshot.job.state,
+            done,
+            ...identityAnswer(params.job_id, snapshot, snapshot.items, readOffset(params.offset)),
+            region: client.region
+          };
+        }
         const { leads, skipped } = splitItems(snapshot);
         return {
           job_id: params.job_id,
@@ -24164,8 +24432,8 @@ var init_send_feedback = __esm({
         }
       },
       execute: async (client, params, ctx) => {
-        const text2 = typeof params.message === "string" ? params.message.trim() : "";
-        if (!text2) {
+        const text3 = typeof params.message === "string" ? params.message.trim() : "";
+        if (!text3) {
           return {
             error: true,
             code: "BAD_INPUT",
@@ -24173,7 +24441,7 @@ var init_send_feedback = __esm({
             hint: "Ask the user what they'd like to tell the Leadbay team, then call again with their words in `message`."
           };
         }
-        const message = text2.length > MESSAGE_MAX2 ? `${text2.slice(0, MESSAGE_MAX2 - 1)}\u2026` : text2;
+        const message = text3.length > MESSAGE_MAX2 ? `${text3.slice(0, MESSAGE_MAX2 - 1)}\u2026` : text3;
         if (!ctx?.sendFeedback) {
           return {
             sent: false,
@@ -24774,7 +25042,7 @@ var init_dist = __esm({
 init_dist();
 import { realpathSync } from "fs";
 import { fileURLToPath } from "url";
-import { basename } from "path";
+import { basename as basename2 } from "path";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // src/server.ts
@@ -27678,8 +27946,8 @@ var PROMPT_CATALOG_BULLETS = {
 };
 
 // src/prompts.ts
-function userMessage(text2) {
-  return { role: "user", content: { type: "text", text: text2 } };
+function userMessage(text3) {
+  return { role: "user", content: { type: "text", text: text3 } };
 }
 function substitutePlaceholders(body, substitutions) {
   let out = body;
@@ -29378,6 +29646,7 @@ ${url}
         // RAW value: the friction redaction above is an ANALYTICS control, and
         // must not change in-process tool behaviour.
         triggered_by: rawTriggeredBy,
+        saveFile: opts.saveFile,
         // Route leadbay_send_feedback to Sentry's feedback inbox (same place
         // the web app's form lands). NOOP_TELEMETRY returns false, so the
         // tool reports honestly when telemetry is off.
@@ -29620,11 +29889,24 @@ ${url}
   return server;
 }
 
+// src/local-files.ts
+import { existsSync as existsSync2 } from "fs";
+import { writeFile } from "fs/promises";
+import { homedir } from "os";
+import { basename, join as join2 } from "path";
+async function saveToDownloads(name, content, home = homedir()) {
+  const downloads = join2(home, "Downloads");
+  const dir = existsSync2(downloads) ? downloads : home;
+  const path = join2(dir, basename(name));
+  await writeFile(path, content, "utf8");
+  return path;
+}
+
 // installer/install-shared.ts
 import { spawn } from "child_process";
-import { existsSync as existsSync2, readFileSync as readFileSync2, readdirSync as readdirSync2 } from "fs";
-import { join as join2 } from "path";
-import { homedir } from "os";
+import { existsSync as existsSync3, readFileSync as readFileSync2, readdirSync as readdirSync2 } from "fs";
+import { join as join3 } from "path";
+import { homedir as homedir2 } from "os";
 var HOSTED_MCP_URL_CHATGPT = "https://mcp.leadbay.app/chatgpt/mcp";
 function formatInstallOsLabel(platform = process.platform, arch = process.arch) {
   const name = platform === "darwin" ? "macOS" : platform === "win32" ? "Windows" : platform === "linux" ? "Linux" : platform;
@@ -29632,15 +29914,15 @@ function formatInstallOsLabel(platform = process.platform, arch = process.arch)
 }
 function detectClaudeDesktopMode(claudeSupportDir) {
   const markers = [];
-  const legacy = existsSync2(join2(claudeSupportDir, "claude_desktop_config.json"));
-  if (existsSync2(join2(claudeSupportDir, "Claude Extensions"))) {
+  const legacy = existsSync3(join3(claudeSupportDir, "claude_desktop_config.json"));
+  if (existsSync3(join3(claudeSupportDir, "Claude Extensions"))) {
     markers.push("Claude Extensions/");
   }
-  if (existsSync2(join2(claudeSupportDir, "extensions-installations.json"))) {
+  if (existsSync3(join3(claudeSupportDir, "extensions-installations.json"))) {
     markers.push("extensions-installations.json");
   }
-  const cfgPath = join2(claudeSupportDir, "config.json");
-  if (existsSync2(cfgPath)) {
+  const cfgPath = join3(claudeSupportDir, "config.json");
+  if (existsSync3(cfgPath)) {
     try {
       const raw = readFileSync2(cfgPath, "utf8");
       const parsed = JSON.parse(raw);
@@ -29680,8 +29962,8 @@ async function windowsStoreAppInstalled(packageName, appName) {
   });
 }
 function isClaudeStorePackagePresent(localAppData) {
-  const packagesDir = join2(localAppData, "Packages");
-  if (!existsSync2(packagesDir)) return false;
+  const packagesDir = join3(localAppData, "Packages");
+  if (!existsSync3(packagesDir)) return false;
   try {
     return readdirSync2(packagesDir).some((name) => /^Claude_/i.test(name));
   } catch {
@@ -29690,7 +29972,7 @@ function isClaudeStorePackagePresent(localAppData) {
 }
 async function isClaudeDesktopInstalled(home) {
   if (process.platform === "darwin") {
-    return existsSync2("/Applications/Claude.app") || existsSync2(home + "/Applications/Claude.app");
+    return existsSync3("/Applications/Claude.app") || existsSync3(home + "/Applications/Claude.app");
   }
   if (process.platform === "win32") {
     const local = process.env.LOCALAPPDATA ?? home + "/AppData/Local";
@@ -29701,18 +29983,18 @@ async function isClaudeDesktopInstalled(home) {
       local + "/Claude/Claude.exe",
       programFiles ? programFiles + "/Claude/Claude.exe" : null,
       programFilesX86 ? programFilesX86 + "/Claude/Claude.exe" : null
-    ].some((candidate) => candidate !== null && existsSync2(candidate));
+    ].some((candidate) => candidate !== null && existsSync3(candidate));
     if (exeInstalled) return true;
     if (isClaudeStorePackagePresent(local)) return true;
     return await windowsStoreAppInstalled("AnthropicPBC.Claude", "Claude");
   }
   const desktopBin = await findOnPath("claude-desktop");
   if (desktopBin) return true;
-  return existsSync2(home + "/.local/share/applications/claude-desktop.desktop") || existsSync2("/usr/share/applications/claude-desktop.desktop") || existsSync2("/opt/Claude/Claude") || existsSync2("/opt/Claude/claude") || existsSync2("/opt/claude/claude");
+  return existsSync3(home + "/.local/share/applications/claude-desktop.desktop") || existsSync3("/usr/share/applications/claude-desktop.desktop") || existsSync3("/opt/Claude/Claude") || existsSync3("/opt/Claude/claude") || existsSync3("/opt/claude/claude");
 }
 async function isChatGptDesktopInstalled(home) {
   if (process.platform === "darwin") {
-    return existsSync2("/Applications/ChatGPT.app") || existsSync2(home + "/Applications/ChatGPT.app");
+    return existsSync3("/Applications/ChatGPT.app") || existsSync3(home + "/Applications/ChatGPT.app");
   }
   if (process.platform === "win32") {
     const local = process.env.LOCALAPPDATA ?? home + "/AppData/Local";
@@ -29725,7 +30007,7 @@ async function isChatGptDesktopInstalled(home) {
       programFiles ? programFiles + "/ChatGPT/ChatGPT.exe" : null,
       programFilesX86 ? programFilesX86 + "/OpenAI/ChatGPT/ChatGPT.exe" : null,
       programFilesX86 ? programFilesX86 + "/ChatGPT/ChatGPT.exe" : null
-    ].some((candidate) => candidate !== null && existsSync2(candidate));
+    ].some((candidate) => candidate !== null && existsSync3(candidate));
     return exeInstalled || await windowsStoreAppInstalled("OpenAI.ChatGPT-Desktop", "ChatGPT");
   }
   return false;
@@ -29733,16 +30015,16 @@ async function isChatGptDesktopInstalled(home) {
 async function isCursorInstalled(home) {
   const cursorBin = await findOnPath("cursor");
   if (cursorBin) return true;
-  if (process.platform === "darwin") return existsSync2("/Applications/Cursor.app");
+  if (process.platform === "darwin") return existsSync3("/Applications/Cursor.app");
   if (process.platform === "win32") {
     const local = process.env.LOCALAPPDATA ?? `${home}\\AppData\\Local`;
-    return existsSync2(`${local}\\Programs\\Cursor\\Cursor.exe`);
+    return existsSync3(`${local}\\Programs\\Cursor\\Cursor.exe`);
   }
-  return existsSync2("/usr/share/applications/cursor.desktop") || existsSync2("/opt/Cursor/cursor");
+  return existsSync3("/usr/share/applications/cursor.desktop") || existsSync3("/opt/Cursor/cursor");
 }
 async function detectClients() {
   const out = [];
-  const home = homedir();
+  const home = homedir2();
   const claudeBin = await findOnPath("claude");
   if (claudeBin) {
     out.push({ id: "claude-code", label: "Claude Code", detail: `${claudeBin} mcp add ...` });
@@ -29761,7 +30043,7 @@ async function detectClients() {
     out.push({
       id: "cursor",
       label: "Cursor",
-      detail: existsSync2(cursorPath) ? cursorPath : `${cursorPath} (will be created)`,
+      detail: existsSync3(cursorPath) ? cursorPath : `${cursorPath} (will be created)`,
       configPath: cursorPath
     });
   }
@@ -29850,11 +30132,11 @@ async function uninstallFromClaudeCode() {
 // installer/install-json-config.ts
 async function installInJsonConfig(configPath, token, region, includeWrite, telemetryEnabled, localBinPath) {
   try {
-    const { readFileSync: readFileSync3, writeFileSync, existsSync: existsSync4, mkdirSync, statSync } = await import("fs");
+    const { readFileSync: readFileSync3, writeFileSync, existsSync: existsSync5, mkdirSync, statSync } = await import("fs");
     const { dirname: dirname2 } = await import("path");
     let parsed = {};
     let preserved = {};
-    const existed = existsSync4(configPath);
+    const existed = existsSync5(configPath);
     if (existed) {
       const raw = readFileSync3(configPath, "utf8");
       try {
@@ -29904,8 +30186,8 @@ function stripJsonMcpEntry(existing) {
 }
 async function uninstallFromJsonConfig(configPath) {
   try {
-    const { existsSync: existsSync4, readFileSync: readFileSync3, writeFileSync } = await import("fs");
-    if (!existsSync4(configPath)) return { ok: true, message: "config not found \u2014 nothing to do" };
+    const { existsSync: existsSync5, readFileSync: readFileSync3, writeFileSync } = await import("fs");
+    if (!existsSync5(configPath)) return { ok: true, message: "config not found \u2014 nothing to do" };
     const existing = readFileSync3(configPath, "utf8");
     const { content, changed } = stripJsonMcpEntry(existing);
     if (!changed) return { ok: true, message: "leadbay entry not present" };
@@ -29988,10 +30270,10 @@ function stripShellExportBlock(existing) {
 }
 async function installInCodexConfig(configPath, includeWrite, telemetryEnabled, localBinPath) {
   try {
-    const { readFileSync: readFileSync3, writeFileSync, existsSync: existsSync4, mkdirSync, statSync, renameSync, chmodSync } = await import("fs");
+    const { readFileSync: readFileSync3, writeFileSync, existsSync: existsSync5, mkdirSync, statSync, renameSync, chmodSync } = await import("fs");
     const { dirname: dirname2 } = await import("path");
     let existing = "";
-    const existed = existsSync4(configPath);
+    const existed = existsSync5(configPath);
     if (existed) {
       existing = readFileSync3(configPath, "utf8");
     } else {
@@ -30037,15 +30319,15 @@ async function appendShellExports(token, region, includeWrite, telemetryEnabled)
       }
       return { ok: true, message: "env exported with setx; restart Codex/terminal" };
     }
-    const { existsSync: existsSync4, readFileSync: readFileSync3, writeFileSync, renameSync } = await import("fs");
+    const { existsSync: existsSync5, readFileSync: readFileSync3, writeFileSync, renameSync } = await import("fs");
     const os = await import("os");
     const home = os.homedir();
-    const preferred = [`${home}/.zshrc`, `${home}/.bashrc`].filter((path) => existsSync4(path));
+    const preferred = [`${home}/.zshrc`, `${home}/.bashrc`].filter((path) => existsSync5(path));
     const paths = preferred.length ? preferred : [`${home}/.profile`];
     const block = buildShellExportBlock(token, region, includeWrite, telemetryEnabled);
     const updated = [];
     for (const path of paths) {
-      const existing = existsSync4(path) ? readFileSync3(path, "utf8") : "";
+      const existing = existsSync5(path) ? readFileSync3(path, "utf8") : "";
       const merged = mergeShellExportBlock(existing, block);
       if (!merged.changed) continue;
       const tmp = `${path}.leadbay.tmp`;
@@ -30063,8 +30345,8 @@ async function appendShellExports(token, region, includeWrite, telemetryEnabled)
 }
 async function uninstallFromCodexConfig(configPath) {
   try {
-    const { existsSync: existsSync4, readFileSync: readFileSync3, writeFileSync } = await import("fs");
-    if (!existsSync4(configPath)) return { ok: true, message: "config not found \u2014 nothing to do" };
+    const { existsSync: existsSync5, readFileSync: readFileSync3, writeFileSync } = await import("fs");
+    if (!existsSync5(configPath)) return { ok: true, message: "config not found \u2014 nothing to do" };
     const existing = readFileSync3(configPath, "utf8");
     const { content, changed } = stripCodexBlock(existing);
     if (!changed) return { ok: true, message: "leadbay block not present" };
@@ -30076,11 +30358,11 @@ async function uninstallFromCodexConfig(configPath) {
 }
 async function uninstallShellExports() {
   try {
-    const { existsSync: existsSync4, readFileSync: readFileSync3, writeFileSync, renameSync } = await import("fs");
+    const { existsSync: existsSync5, readFileSync: readFileSync3, writeFileSync, renameSync } = await import("fs");
     const os = await import("os");
     const home = os.homedir();
     const candidates = [`${home}/.zshrc`, `${home}/.bashrc`, `${home}/.profile`].filter(
-      (p) => existsSync4(p)
+      (p) => existsSync5(p)
     );
     const updated = [];
     for (const p of candidates) {
@@ -30105,17 +30387,17 @@ async function uninstallShellExports() {
 var DXT_EXTENSION_ID = "local.dxt.leadbay.leadbay";
 async function removeDxtExtension(claudeSupportDir) {
   try {
-    const { existsSync: existsSync4, readFileSync: readFileSync3, writeFileSync, rmSync } = await import("fs");
-    const { join: join3 } = await import("path");
-    const extensionDir = join3(claudeSupportDir, "Claude Extensions", DXT_EXTENSION_ID);
-    const registryPath = join3(claudeSupportDir, "extensions-installations.json");
+    const { existsSync: existsSync5, readFileSync: readFileSync3, writeFileSync, rmSync } = await import("fs");
+    const { join: join4 } = await import("path");
+    const extensionDir = join4(claudeSupportDir, "Claude Extensions", DXT_EXTENSION_ID);
+    const registryPath = join4(claudeSupportDir, "extensions-installations.json");
     let removedDir = false;
     let removedEntry = false;
-    if (existsSync4(extensionDir)) {
+    if (existsSync5(extensionDir)) {
       rmSync(extensionDir, { recursive: true, force: true });
       removedDir = true;
     }
-    if (existsSync4(registryPath)) {
+    if (existsSync5(registryPath)) {
       try {
         const raw = readFileSync3(registryPath, "utf8");
         const parsed = JSON.parse(raw);
@@ -30142,8 +30424,8 @@ async function removeDxtExtension(claudeSupportDir) {
 }
 
 // installer/install-wizard.ts
-function ansi(text2, code, enabled) {
-  return enabled ? `\x1B[${code}m${text2}\x1B[0m` : text2;
+function ansi(text3, code, enabled) {
+  return enabled ? `\x1B[${code}m${text3}\x1B[0m` : text3;
 }
 function parseInstallSelection(input, clientCount) {
   const normalized = input.trim().toLowerCase();
@@ -30323,7 +30605,7 @@ import {
 } from "fs/promises";
 import { constants as fsConstants } from "fs";
 import { dirname, resolve as resolvePath } from "path";
-import { homedir as homedir2 } from "os";
+import { homedir as homedir3 } from "os";
 function emptyState() {
   return {
     last_check_time: 0,
@@ -30359,7 +30641,7 @@ var UpdateStateStore = class {
   }
   validatePath(p) {
     if (this.allowUnsafePath) return;
-    const home = resolvePath(homedir2());
+    const home = resolvePath(homedir3());
     if (p !== home && !p.startsWith(home + "/") && !p.startsWith(home + "\\")) {
       throw new Error(
         `UpdateStateStore: path ${p} is outside $HOME (${home}). Set LEADBAY_UPDATE_STATE_PATH_UNSAFE=1 to override.`
@@ -30487,7 +30769,7 @@ async function openTmpFileExclusive(path) {
 async function createDefaultUpdateStateStore(opts = {}) {
   const env = opts.env ?? process.env;
   const allowUnsafePath = env.LEADBAY_UPDATE_STATE_PATH_UNSAFE === "1";
-  const path = env.LEADBAY_UPDATE_STATE_PATH ?? resolvePath(homedir2(), ".leadbay", "update-state.json");
+  const path = env.LEADBAY_UPDATE_STATE_PATH ?? resolvePath(homedir3(), ".leadbay", "update-state.json");
   try {
     const store = new UpdateStateStore({
       backend: "file",
@@ -30511,7 +30793,7 @@ import { createHash as createHash5, randomBytes } from "crypto";
 import { createServer } from "http";
 import { request as httpsRequestRaw } from "https";
 import { spawn as spawn3 } from "child_process";
-import { readdirSync as readdirSync3, existsSync as existsSync3 } from "fs";
+import { readdirSync as readdirSync3, existsSync as existsSync4 } from "fs";
 var LEADBAY_LOOPBACK_PORTS = [51789, 51790, 51791, 51792];
 var BrowserOpenFailedError = class extends Error {
   authorizeUrl;
@@ -30844,11 +31126,11 @@ function browserLaunchEnv(debug) {
   const env = { ...process.env };
   if (process.platform !== "linux") return env;
   let runtimeDir = env.XDG_RUNTIME_DIR;
-  if (!runtimeDir || !existsSync3(runtimeDir)) {
+  if (!runtimeDir || !existsSync4(runtimeDir)) {
     try {
       const uid = process.getuid?.();
       const candidate = uid !== void 0 ? `/run/user/${uid}` : void 0;
-      if (candidate && existsSync3(candidate)) {
+      if (candidate && existsSync4(candidate)) {
         runtimeDir = candidate;
         env.XDG_RUNTIME_DIR = candidate;
         debug?.(`browserLaunchEnv: injected XDG_RUNTIME_DIR=${candidate}`);
@@ -30868,7 +31150,7 @@ function browserLaunchEnv(debug) {
   }
   if (!env.DBUS_SESSION_BUS_ADDRESS && runtimeDir) {
     const busPath = `${runtimeDir}/bus`;
-    if (existsSync3(busPath)) {
+    if (existsSync4(busPath)) {
       env.DBUS_SESSION_BUS_ADDRESS = `unix:path=${busPath}`;
       debug?.(`browserLaunchEnv: injected DBUS_SESSION_BUS_ADDRESS=unix:path=${busPath}`);
     }
@@ -30891,7 +31173,7 @@ function browserLaunchEnv(debug) {
         );
         if (cookie) xauth = `${runtimeDir}/${cookie}`;
       }
-      if (!xauth && env.HOME && existsSync3(`${env.HOME}/.Xauthority`)) {
+      if (!xauth && env.HOME && existsSync4(`${env.HOME}/.Xauthority`)) {
         xauth = `${env.HOME}/.Xauthority`;
       }
       if (xauth) {
@@ -31054,7 +31336,7 @@ var OAUTH_BASE_URLS = {
     fr: "https://staging.api.leadbay.app"
   }
 };
-var VERSION = "0.38.2";
+var VERSION = "0.39.1";
 var HELP = `
 leadbay-mcp ${VERSION} \u2014 Leadbay Model Context Protocol server
 
@@ -31154,9 +31436,9 @@ function exitWithTokenError() {
 function hydrateEnvFromCredentialsFile() {
   if (process.env.LEADBAY_TOKEN) return false;
   try {
-    const { existsSync: existsSync4, readFileSync: readFileSync3 } = require_("node:fs");
+    const { existsSync: existsSync5, readFileSync: readFileSync3 } = require_("node:fs");
     const { path } = resolveOAuthBootstrapCredentialsPath();
-    if (!existsSync4(path)) return false;
+    if (!existsSync5(path)) return false;
     const parsed = JSON.parse(readFileSync3(path, "utf8"));
     const env = parsed?.mcpServers?.leadbay?.env;
     if (!env || typeof env !== "object") return false;
@@ -31177,9 +31459,9 @@ function hydrateEnvFromCredentialsFile() {
 function resolveOAuthBootstrapCredentialsPath() {
   const resolved = resolveDefaultCredentialsPath();
   if (process.env.LEADBAY_OAUTH_STAGING !== "1") return resolved;
-  const { dirname: dirname2, join: join3 } = require_("node:path");
+  const { dirname: dirname2, join: join4 } = require_("node:path");
   return {
-    path: join3(dirname2(resolved.path), "credentials.staging.json"),
+    path: join4(dirname2(resolved.path), "credentials.staging.json"),
     legacy: resolved.legacy
   };
 }
@@ -31189,20 +31471,20 @@ var bootstrapFailureMessage;
 function bootstrapDebug(msg) {
   try {
     const { appendFileSync, mkdirSync } = require_("node:fs");
-    const { join: join3 } = require_("node:path");
-    const { homedir: homedir3 } = require_("node:os");
-    const dir = join3(homedir3(), ".leadbay");
+    const { join: join4 } = require_("node:path");
+    const { homedir: homedir4 } = require_("node:os");
+    const dir = join4(homedir4(), ".leadbay");
     mkdirSync(dir, { recursive: true });
     const ts = (/* @__PURE__ */ new Date()).toISOString();
-    appendFileSync(join3(dir, "oauth-bootstrap-debug.log"), `${ts} [pid ${process.pid}] ${msg}
+    appendFileSync(join4(dir, "oauth-bootstrap-debug.log"), `${ts} [pid ${process.pid}] ${msg}
 `);
   } catch {
   }
 }
 function oauthClientCachePath() {
-  const { join: join3 } = require_("node:path");
-  const { homedir: homedir3 } = require_("node:os");
-  return join3(homedir3(), ".leadbay", "oauth-client.json");
+  const { join: join4 } = require_("node:path");
+  const { homedir: homedir4 } = require_("node:os");
+  return join4(homedir4(), ".leadbay", "oauth-client.json");
 }
 function getCachedOAuthClientId(authServerBaseUrl, port) {
   try {
@@ -31529,8 +31811,8 @@ function parseFlag(args, name) {
 function hasFlag(args, name) {
   return args.some((a) => a === `--${name}`);
 }
-function ansi2(text2, code, enabled) {
-  return enabled ? `\x1B[${code}m${text2}\x1B[0m` : text2;
+function ansi2(text3, code, enabled) {
+  return enabled ? `\x1B[${code}m${text3}\x1B[0m` : text3;
 }
 function isInteractiveInstall() {
   return process.stdin.isTTY === true && process.stdout.isTTY === true;
@@ -31750,8 +32032,8 @@ Restart your MCP client to pick up the new server.
     usingLegacyPath = resolved.legacy;
   }
   try {
-    const { existsSync: existsSync4, readFileSync: readFileSync3 } = await import("fs");
-    if (existsSync4(targetPath) && !force) {
+    const { existsSync: existsSync5, readFileSync: readFileSync3 } = await import("fs");
+    if (existsSync5(targetPath) && !force) {
       let existing;
       try {
         existing = JSON.parse(readFileSync3(targetPath, "utf8"));
@@ -32279,6 +32561,9 @@ async function main() {
     version: VERSION,
     telemetry,
     updateStateStore,
+    // This process runs on the user's machine, so a tool can save a file
+    // they will find. The hosted server (http-server.ts) does not pass this.
+    saveFile: saveToDownloads,
     // Non-blocking OAuth bootstrap gate. Read per tool call: once the
     // background flow lands the token (client.isAuthenticated → true) this
     // reports done and tools execute. While waiting it surfaces the live
@@ -32361,7 +32646,7 @@ var isEntrypoint = (() => {
   try {
     const entry = process.argv[1];
     if (!entry) return false;
-    const entryName = basename(entry).toLowerCase();
+    const entryName = basename2(entry).toLowerCase();
     if (entryName !== "bin.js" && entryName !== "leadbay-mcp" && entryName !== "index.js") return false;
     const self = fileURLToPath(import.meta.url);
     return realpathSync(self) === realpathSync(entry);