@leadbay/mcp 0.38.2 → 0.39.0

package/dist/http-server.js

@@ -2912,8 +2912,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;
@@ -5791,7 +5791,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.
@@ -6861,8 +6861,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
@@ -8105,13 +8128,14 @@ This tool MUTATES state. The caller (agent or human-in-the-loop) is responsible
 `;
 var 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."
@@ -8123,7 +8147,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.
@@ -8138,6 +8163,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).
@@ -8174,6 +8207,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
@@ -8328,6 +8381,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 |
 `;
 var 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:
 
@@ -8806,9 +8861,9 @@ var leadbay_research_lead_by_name_fuzzy = `## WHEN TO USE
 
 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."
@@ -8818,7 +8873,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."
 
 ---
 
@@ -8832,15 +8887,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
@@ -10147,7 +10200,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.
@@ -16931,12 +16984,12 @@ var CITY_ALIASES = {
   vegas: "Las Vegas",
   nola: "New Orleans"
 };
-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;
@@ -16959,8 +17012,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);
@@ -16999,7 +17052,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;
@@ -18165,9 +18218,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_`);
@@ -22904,8 +22957,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) => {
@@ -22934,12 +22987,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 };
@@ -24356,6 +24409,21 @@ var findNewLeads = {
       "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);
@@ -24433,6 +24501,7 @@ var findNewLeads = {
       return {
         dry_run: true,
         ...forecast,
+        ...countryNote,
         region: client.region
       };
     }
@@ -24453,6 +24522,7 @@ var findNewLeads = {
         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
       };
     }
@@ -24507,11 +24577,142 @@ var findNewLeads = {
         since: snapshot.next_since ?? null,
         suggested_wait_seconds: done ? 0 : 60
       },
+      ...countryNote,
       region: client.region
     };
   }
 };
 
+// ../core/dist/composite/_identity-rows.js
+var IDENTITY_ROWS_PER_RESULT = 100;
+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
+  };
+}
+var CSV_HEADER = [
+  "row",
+  "input",
+  "status",
+  "reason",
+  "company",
+  "website",
+  "linkedin",
+  "lead_id"
+];
+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
+    }
+  };
+}
+
 // ../core/dist/composite/qualify-leads.js
 var DEFAULT_WAIT_SECONDS2 = 45;
 function normalizeLeadRefs(refs) {
@@ -24560,7 +24761,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();
@@ -24568,7 +24769,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.
@@ -24579,8 +24780,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 = {
@@ -24726,6 +24927,7 @@ var qualifyLeads = {
     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);
@@ -24774,6 +24976,25 @@ var qualifyLeads = {
     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.
@@ -24863,6 +25084,14 @@ var leadJobStatus = {
       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"],
@@ -24870,8 +25099,19 @@ var leadJobStatus = {
   },
   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,
@@ -26251,8 +26491,8 @@ var sendFeedback = {
     }
   },
   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",
@@ -26260,7 +26500,7 @@ var sendFeedback = {
         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,
@@ -27951,6 +28191,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.
@@ -28372,7 +28613,7 @@ function parseWriteEnv(env = process.env) {
 }
 
 // src/http-server.ts
-var VERSION = true ? "0.38.2" : "0.0.0-dev";
+var VERSION = true ? "0.39.0" : "0.0.0-dev";
 var PORT = Number(process.env.PORT ?? 8080);
 var HOST = process.env.HOST ?? "0.0.0.0";
 var logger = {

package/dist/installer-electron.js

@@ -1805,7 +1805,7 @@ var init_installer_gui = __esm({
     init_install_dxt();
     init_install_shared();
     init_oauth();
-    VERSION = true ? "0.38.2" : "0.0.0-dev";
+    VERSION = true ? "0.39.0" : "0.0.0-dev";
     MESSAGES = {
       en: {
         installer: {

package/dist/installer-gui.js

@@ -1068,7 +1068,7 @@ async function oauthLogin(opts) {
 }
 
 // installer/installer-gui.ts
-var VERSION = true ? "0.38.2" : "0.0.0-dev";
+var VERSION = true ? "0.39.0" : "0.0.0-dev";
 var MESSAGES = {
   en: {
     installer: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leadbay/mcp",
-  "version": "0.38.2",
+  "version": "0.39.0",
   "mcpName": "io.github.leadbay/leadbay-mcp",
   "description": "Model Context Protocol (MCP) server for Leadbay — AI lead discovery, qualification, and enrichment for Claude Desktop, Cursor, and Claude Code.",
   "type": "module",